session

type ConflictError struct {
	// Path is the file whose region could not be resolved.
	Path string
	// Reason is the resolve status that triggered the conflict ("conflict" or
	// "ambiguous"), or a wrapped resolver error message.
	Reason string
}

type Plan struct {
	// Intent is the WAL intent recorded by Prepare (already persisted): originals
	// for restore-on-failure plus the expected per-file hashes.
	Intent wal.Intent
	// Edits are the region-anchored edits this plan will apply, in input order.
	Edits []region.Edit
	// Anchors maps each file path to the per-file drift gate it was prepared
	// against (SPEC §8.1).
	Anchors map[string]region.FileAnchor
}

type Session struct {
	// Parser reparses live and staged bytes (drift relocation + parse assertion).
	Parser parser.ParserPort
	// Hasher computes the raw and normalized hashes recorded into the WAL intent
	// and the post-edit hashes returned in each EditResult.
	Hasher hashing.Hasher
	// Formatter, when non-nil, rewrites staged bytes before linting/parsing.
	Formatter format.Formatter
	// Linter, when non-nil, validates staged bytes; a lint failure blocks Prepare.
	Linter format.Linter
	// Lang, when set (non-LangUnknown), forces that language for every file;
	// when LangUnknown (the zero value) each file's language is auto-detected
	// from its path via parser.LangForPath. It is an optional per-session
	// override, letting an agent IDE edit a mixed-language tree without a single
	// session-wide language.
	Lang parser.Lang
	// WALDir is the directory holding this session's write-ahead log.
	WALDir string
	// contains filtered or unexported fields
}