@basou/core 0.48.1 → 0.50.0

package/dist/index.d.ts

@@ -52,10 +52,17 @@ declare function summarizeAdapterOutput(_stream: "stdout" | "stderr", _raw: stri
  * merge/removal logic stays deterministic and unit-testable.
  *
  * settings.json holds many unrelated keys (permissions, model, other hooks);
- * these functions clone the input and touch ONLY the `hooks.Stop` entry that
- * basou owns, preserving everything else byte-for-byte through the round-trip.
+ * these functions clone the input and touch ONLY the `hooks.Stop` and
+ * `hooks.SessionStart` entries that basou owns, preserving everything else
+ * byte-for-byte through the round-trip.
+ *
+ * The SessionStart command, matcher and timeout are the Codex twin's
+ * (`../codex/hooks-json.ts`): both tools run the same `basou hook session-start`
+ * and apply the matcher to the same session sources (startup / resume / clear /
+ * compact), so one decision about when the position is worth its bytes serves
+ * both.
  */
-/** Seconds before Claude Code kills the hook process. Matches the documented orient (SessionStart) hook. */
+/** Seconds before Claude Code kills the Stop hook process. */
 declare const STOP_HOOK_TIMEOUT_SECONDS = 20;
 declare function isBasouStopHookCommand(command: string): boolean;
 type BuildStopHookCommandOptions = {
@@ -105,6 +112,84 @@ declare function upsertStopHook(settings: unknown, command: string): StopHookUps
 declare function removeStopHook(settings: unknown): StopHookRemoval;
 /** Return the installed basou Stop hook command, or null if none is registered. */
 declare function findBasouStopHookCommand(settings: unknown): string | null;
+/** Whether a command is basou's `hook session-start`, exactly as basou writes it. */
+declare function isClaudeSessionStartHookCommand(command: string): boolean;
+/**
+ * Whether a command is the documented hand-registered `basou orient` — basou's
+ * own reference told Claude Code users to register exactly this before
+ * `basou hook install` could, so an install that ignored it would put the
+ * position into every session twice. It counts as basou's ONLY inside
+ * `hooks.SessionStart`; anywhere else it is somebody's script.
+ */
+declare function isBasouOrientSessionStartCommand(command: string): boolean;
+/** Which of basou's two SessionStart forms a command is, if either. */
+type ClaudeSessionStartHookKind = "session-start" | "orient";
+type ClaudeSessionStartHookUpsert = {
+    settings: ClaudeSettings;
+    /**
+     * `installed` = a new group was appended; `updated` = an existing
+     * `hook session-start` entry was rewritten or a duplicate removed;
+     * `replaced` = a hand-registered `basou orient` was rewritten into
+     * `hook session-start`; `unchanged` = already canonical, nothing touched.
+     */
+    action: "installed" | "updated" | "replaced" | "unchanged";
+};
+type ClaudeSessionStartHookRemoval = {
+    settings: ClaudeSettings;
+    action: "removed" | "absent";
+};
+/**
+ * Register (or upgrade in place) basou's SessionStart hook in Claude Code's
+ * settings. The hook prints the workspace's position into the new session's
+ * context, and records the git baseline the Stop hook measures the session's
+ * file changes against — without it, a session's shell edits are invisible.
+ *
+ * - EVERY basou entry — `hook session-start`, or the hand-registered
+ *   `basou orient` — is rewritten IN PLACE to the canonical command + timeout.
+ *   Its group's matcher is left as it is: the matcher is when the hook fires,
+ *   and the person who wrote it may have chosen it. Only a new install brings
+ *   basou's own matcher, in a group of its own. Same rule as the Codex twin.
+ * - A later entry is removed as a duplicate only when an earlier one fires
+ *   under the SAME matcher. Entries under different matchers are kept even if
+ *   they overlap: collapsing them would silently narrow when the hook fires
+ *   (`startup` and `resume|clear` are not duplicates). Overlap that survives is
+ *   reported by {@link findClaudeSessionStartHooks}, not resolved by guessing.
+ * - Foreign hooks, other events and other keys are untouched.
+ */
+declare function upsertClaudeSessionStartHook(settings: unknown, command: string): ClaudeSessionStartHookUpsert;
+/**
+ * Remove every basou-owned SessionStart entry — `hook session-start` and the
+ * hand-registered `basou orient` alike, since install treats both as basou's.
+ * A group emptied by the removal is dropped; a now-empty `hooks.SessionStart`
+ * / `hooks` container is deleted. Foreign hooks and other keys are preserved.
+ */
+declare function removeClaudeSessionStartHook(settings: unknown): ClaudeSessionStartHookRemoval;
+/** One basou-owned SessionStart entry in Claude Code's settings. */
+type ClaudeSessionStartHookLocation = {
+    command: string;
+    kind: ClaudeSessionStartHookKind;
+    /** The matcher of the group it sits in (undefined = fires on every source). */
+    matcher: string | undefined;
+};
+/**
+ * Every basou-owned SessionStart entry, in file order. More than one survives
+ * an install only under different matchers — which is exactly the case a
+ * reader needs to see, since overlapping matchers put the position in twice.
+ */
+declare function findClaudeSessionStartHooks(settings: unknown): ClaudeSessionStartHookLocation[];
+/** Whether `hooks.SessionStart` exists but cannot be read as a list of groups. */
+declare function isClaudeSessionStartMalformed(settings: unknown): boolean;
+/**
+ * What a SessionStart command that runs basou but is NOT one of the two
+ * recognized shapes appears to run: `orient` or `hook session-start`, inside a
+ * longer command (a `cd` first, an `&&` chain, node options, `npx`). Install
+ * leaves those exactly as written; this lets it and `status` say so.
+ */
+type ClaudeUnrecognizedSessionStart = {
+    command: string;
+    runs: ClaudeSessionStartHookKind;
+};
+declare function findUnrecognizedSessionStart(settings: unknown): ClaudeUnrecognizedSessionStart[];
 
 /**
  * `schema_version` stamped on NEWLY WRITTEN `.basou/manifest.yaml`.
@@ -655,6 +740,174 @@ type SessionImportPayload = z.infer<typeof SessionImportPayloadSchema>;
 /** Inferred runtime type for {@link SessionInnerImportSchema}. */
 type SessionInnerImportInput = z.infer<typeof SessionInnerImportSchema>;
 
+/**
+ * Status classification used by the `file_changed` event schema. Limited to
+ * the four classes that simple-git's `git diff --name-status` reliably
+ * surfaces; copy / unmerged / typechange entries are intentionally dropped
+ * to keep the event payload shape narrow.
+ */
+type FileChangeStatus = "added" | "modified" | "deleted" | "renamed";
+/**
+ * Single file-level change observed between two refs. `old_path` is set
+ * only for `renamed` entries (the previous path of the file).
+ */
+type FileChange = {
+    path: string;
+    old_path?: string;
+    status: FileChangeStatus;
+};
+/**
+ * Result of {@link getDiff}. The `changed_files` array is in git's natural
+ * `--name-status` order; callers requiring deterministic ordering should
+ * sort by `path` themselves.
+ */
+type DiffResult = {
+    changed_files: FileChange[];
+};
+/**
+ * Compute the file-level diff between two git refs.
+ *
+ * Returns a list of changed file paths classified by status (added /
+ * modified / deleted / renamed). Diff content is intentionally NOT
+ * returned — `file_changed` events record paths only, and raw diff bodies
+ * are excluded so the trace cannot inadvertently leak source code that may
+ * be sensitive. Use `git show <ref>` to obtain the underlying diff.
+ *
+ * Pathless contract: every thrown message is a fixed string from the set
+ * {`Not a git repository`, `Git executable not found in PATH. Install git
+ * first.`, `Invalid ref`, `Failed to compute git diff`}; native errors are
+ * preserved on `Error.cause`.
+ *
+ * Special cases:
+ * - `baseRef === headRef` short-circuits to an empty result
+ * - copy / unmerged / typechange / unknown status codes are skipped
+ *
+ * @param repoRoot absolute path to the git repository root
+ * @param baseRef base ref (e.g. session-start HEAD sha)
+ * @param headRef head ref (e.g. session-end HEAD sha)
+ */
+declare function getDiff(repoRoot: string, baseRef: string, headRef: string): Promise<DiffResult>;
+/**
+ * Files that differ between `baseRef` and the WORKING TREE — committed and
+ * uncommitted alike, in one question to git.
+ *
+ * This is the net change a session produced, which is not the same as the
+ * union of "what it committed" and "what it left dirty": a file created and
+ * then committed, then modified again, is one `added` entry relative to the
+ * base, not an `added` plus a `modified`. Asking git for the net directly is
+ * what keeps the two halves from having to be reconciled by hand.
+ *
+ * Untracked files are NOT included — `git diff` never reports them — so a
+ * caller that wants them unions this with {@link getWorkingTreeChanges}.
+ *
+ * {@link getDiff} does NOT set `core.quotePath=false` and still returns git's
+ * quoted rendering for a non-ASCII path. That is a separate defect on a
+ * shipped path (`basou run` / `exec` write those paths into `file_changed`
+ * events) and is deliberately not changed here.
+ *
+ * Pathless contract and error vocabulary are identical to {@link getDiff}.
+ *
+ * @param repoRoot absolute path to the git repository root
+ * @param baseRef the ref the session started from (e.g. its session-start HEAD)
+ */
+declare function getChangesSince(repoRoot: string, baseRef: string): Promise<FileChange[]>;
+
+/**
+ * On-disk shape of a session observation. Deliberately NOT one of the durable
+ * schemas under `schemas/`: an observation is working state that exists only
+ * between a session's start and the import that consumes it, never a
+ * provenance record. The record is the `file_changed` event the import writes;
+ * this file is the scratch the hooks accumulate it in, and a reader that
+ * cannot parse it must be able to drop it and lose nothing but one session's
+ * file list. That is why the version below is checked but unversioned in the
+ * repository's schema-artifact machinery, and why every read path returns
+ * `null` instead of throwing.
+ *
+ * Nothing deletes these files. An age-based sweep was written and removed
+ * before shipping: an observation that has not been imported yet is the ONLY
+ * record of what its session changed — the vendor log cannot reproduce it —
+ * so deleting one on a timer discards evidence to save a kilobyte. What a
+ * retention rule should key on (imported? superseded? the session ended?) is a
+ * decision, and an unbounded directory of small files is the honest state to
+ * leave it in until that decision is made.
+ */
+declare const SESSION_OBSERVATION_SCHEMA_VERSION: "0.1.0";
+declare const ObservedFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    change_type: z.ZodEnum<{
+        added: "added";
+        modified: "modified";
+        deleted: "deleted";
+        renamed: "renamed";
+    }>;
+    old_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ObservedRepoSchema: z.ZodObject<{
+    path: z.ZodString;
+    base_head: z.ZodNullable<z.ZodString>;
+    base_dirty: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        change_type: z.ZodEnum<{
+            added: "added";
+            modified: "modified";
+            deleted: "deleted";
+            renamed: "renamed";
+        }>;
+        old_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const SessionObservationSchema: z.ZodObject<{
+    schema_version: z.ZodString;
+    external_id: z.ZodString;
+    started_at: z.ZodString;
+    updated_at: z.ZodString;
+    repos: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        base_head: z.ZodNullable<z.ZodString>;
+        base_dirty: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            change_type: z.ZodEnum<{
+                added: "added";
+                modified: "modified";
+                deleted: "deleted";
+                renamed: "renamed";
+            }>;
+            old_path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** A file this session changed, as observed through git. */
+type ObservedFile = z.infer<typeof ObservedFileSchema>;
+/** Per-repository half of a {@link SessionObservation}. */
+type ObservedRepo = z.infer<typeof ObservedRepoSchema>;
+/** What the hooks accumulated for one vendor session, keyed by its external id. */
+type SessionObservation = z.infer<typeof SessionObservationSchema>;
+/**
+ * Path of the observation file for `externalId`, or `null` when the id could
+ * address something other than a file in `observationsDir`.
+ */
+declare function sessionObservationPath(observationsDir: string, externalId: string): string | null;
+/**
+ * Read one observation. Returns `null` for every failure mode — absent,
+ * unreadable, malformed, or written by a future version — because a caller
+ * that cannot read the scratch must fall back to "no observation", never to an
+ * error that would break a hook or an import.
+ */
+declare function readSessionObservation(observationsDir: string, externalId: string): Promise<SessionObservation | null>;
+/**
+ * Write one observation atomically. The caller owns the decision to write; a
+ * failure propagates so the hook wrapper can swallow it in one place.
+ */
+declare function writeSessionObservation(observationsDir: string, observation: SessionObservation): Promise<void>;
+/**
+ * Flatten an observation into the file list an importer consumes: repository
+ * order, then path order, with duplicates across repositories impossible
+ * because the paths are absolute.
+ */
+declare function observedFilesOf(observation: SessionObservation): ObservedFile[];
+
 /**
  * The `source` string stamped on every event derived from a Claude Code
  * native transcript, and the matching session `source.kind`.
@@ -687,6 +940,26 @@ type ClaudeTranscriptToPayloadOptions = {
      * matches the imported content. Omitted => the field is not recorded.
      */
     sourceSizeBytes?: number;
+    /**
+     * Files this session changed, observed through git while it ran (see
+     * `session/observe.ts`). A transcript can only report an edit made with an
+     * editing TOOL; work done through the shell — a heredoc, a `sed -i`, a
+     * script — leaves no `file_path` anywhere in it, so a session that edits
+     * that way reads as having touched nothing. These observations join
+     * `related_files`.
+     *
+     * They do NOT become events. An observation is a SNAPSHOT that each pass
+     * recomputes — a file changed and then reverted leaves it — while the event
+     * stream is append-only and a re-import preserves every event it did not
+     * derive itself. Writing snapshots into it would duplicate them on every
+     * re-import of a growing transcript and leave events contradicting the
+     * session record rebuilt beside them. `related_files` is rebuilt from this
+     * derivation each time, which is the same shape the observation has.
+     *
+     * An OPTION rather than something read here: this function is pure, and the
+     * observation lives on disk beside the store.
+     */
+    observedFiles?: ReadonlyArray<ObservedFile>;
 };
 /**
  * Transform a Claude Code native transcript into a Basou
@@ -1146,6 +1419,20 @@ type BasouPaths = {
     };
     readonly locks: string;
     readonly logs: string;
+    /**
+     * Per-session git observations: what each vendor session changed on disk,
+     * accumulated by the hooks while it runs and consumed by the import that
+     * merges it into the session's related files. Working state, not a record —
+     * see `session/observation.ts`.
+     *
+     * Lives UNDER `tmp/` on purpose. `basou init` only appends its ignore block
+     * when the file carries no basou block yet, so a store initialized before
+     * this directory existed never learns to ignore a new top-level entry — and
+     * these files carry absolute machine paths. `.basou/tmp/` is in every
+     * generation of that block, so the placement is what keeps them out of git
+     * rather than an upgrade step nobody runs.
+     */
+    readonly observations: string;
     readonly raw: string;
     readonly tmp: string;
     readonly files: {
@@ -3273,54 +3560,6 @@ type ChainVerdict = {
  */
 declare function verifyEventsChain(paths: BasouPaths, sessionId: string): Promise<ChainVerdict>;
 
-/**
- * Status classification used by the `file_changed` event schema. Limited to
- * the four classes that simple-git's `git diff --name-status` reliably
- * surfaces; copy / unmerged / typechange entries are intentionally dropped
- * to keep the event payload shape narrow.
- */
-type FileChangeStatus = "added" | "modified" | "deleted" | "renamed";
-/**
- * Single file-level change observed between two refs. `old_path` is set
- * only for `renamed` entries (the previous path of the file).
- */
-type FileChange = {
-    path: string;
-    old_path?: string;
-    status: FileChangeStatus;
-};
-/**
- * Result of {@link getDiff}. The `changed_files` array is in git's natural
- * `--name-status` order; callers requiring deterministic ordering should
- * sort by `path` themselves.
- */
-type DiffResult = {
-    changed_files: FileChange[];
-};
-/**
- * Compute the file-level diff between two git refs.
- *
- * Returns a list of changed file paths classified by status (added /
- * modified / deleted / renamed). Diff content is intentionally NOT
- * returned — `file_changed` events record paths only, and raw diff bodies
- * are excluded so the trace cannot inadvertently leak source code that may
- * be sensitive. Use `git show <ref>` to obtain the underlying diff.
- *
- * Pathless contract: every thrown message is a fixed string from the set
- * {`Not a git repository`, `Git executable not found in PATH. Install git
- * first.`, `Invalid ref`, `Failed to compute git diff`}; native errors are
- * preserved on `Error.cause`.
- *
- * Special cases:
- * - `baseRef === headRef` short-circuits to an empty result
- * - copy / unmerged / typechange / unknown status codes are skipped
- *
- * @param repoRoot absolute path to the git repository root
- * @param baseRef base ref (e.g. session-start HEAD sha)
- * @param headRef head ref (e.g. session-end HEAD sha)
- */
-declare function getDiff(repoRoot: string, baseRef: string, headRef: string): Promise<DiffResult>;
-
 /**
  * Build a {@link SimpleGit} instance bound to `repoRoot`. Production callers
  * use this single helper so any future tightening (additional safety opts,
@@ -3413,6 +3652,43 @@ declare function tryRemoteUrl(repositoryRoot: string): Promise<string | undefine
  */
 declare function getSnapshot(repositoryRoot: string): Promise<GitSnapshot>;
 
+/**
+ * Files that differ from `HEAD` in the working tree right now — the half of a
+ * session's work that {@link getDiff} cannot see, because it has not been
+ * committed yet.
+ *
+ * A session is observed from two angles that must be UNIONED, not chosen
+ * between: `getDiff(baseHead, HEAD)` covers what the session committed, and
+ * this covers what it left uncommitted. Either alone reports a session that
+ * ends mid-change (or one that commits everything) as having touched nothing.
+ *
+ * Ignored files are excluded — git's own `status` omits them, which is what
+ * makes this safe to run over a repository with a build tree: `dist/` and
+ * friends are ignored by the repository's own rules, so they never enter a
+ * session's file list.
+ *
+ * Conflicted entries are skipped, matching {@link getDiff}'s treatment of the
+ * `U` status code: the `file_changed` status enum has no class for them.
+ *
+ * Pathless contract: every thrown message is a fixed string from the set
+ * {`Not a git repository`, `Git executable not found in PATH. Install git
+ * first.`, `Failed to read git status`}; native errors are preserved on
+ * `Error.cause`.
+ *
+ * @param repoRoot absolute path to the git repository root
+ */
+declare function getWorkingTreeChanges(repoRoot: string): Promise<FileChange[]>;
+/**
+ * `HEAD`'s commit sha, or `null` when the repository has no commits yet (an
+ * unborn branch — a `git init` nobody has committed into). The null case is a
+ * legitimate state for a young repository, not a failure, so it is a value
+ * rather than a throw; a caller then has only the working tree to observe.
+ *
+ * Throws the same fixed strings as {@link getWorkingTreeChanges} when the path
+ * is not a repository or git is missing.
+ */
+declare function readHeadSha(repoRoot: string): Promise<string | null>;
+
 /**
  * Allowed ID type prefixes for Basou entities.
  *
@@ -7196,6 +7472,63 @@ declare class ChildProcessRunner implements ProcessRunner {
     run(command: string, args: readonly string[], options: RunOptions): Promise<RunResult>;
 }
 
+/**
+ * Which repositories a session's file changes are looked for in: the roster
+ * the workspace declares, resolved against the store's own root.
+ *
+ * `repos` (not `import.source_roots`) is the roster: source roots also carry
+ * non-git entries such as the workspace view, and a view is a directory of
+ * symlinks with no git of its own. A workspace that declares no roster is
+ * observed in its own repository only.
+ */
+declare function observedRepoRoots(root: string, manifest: Manifest): string[];
+/** Inputs shared by the two observation passes. */
+type ObserveSessionInput = {
+    /** `.basou/observations` of the workspace the session belongs to. */
+    observationsDir: string;
+    /** Absolute git repository roots to observe. */
+    repoRoots: readonly string[];
+    /** The vendor's session id (Claude Code's `session_id`). */
+    externalId: string;
+    /** Timestamp to stamp the observation with. */
+    nowIso: string;
+};
+/**
+ * Record where each repository stood when the session started, so a later pass
+ * can ask git what changed since. Without this, "what did this session change"
+ * has no base to be measured from, and the only remaining answer would be a
+ * time window over commits — which attributes by proximity rather than by
+ * observation, and this product has already rejected that once.
+ *
+ * Re-entrant by design: a SessionStart that fires again for the SAME session id
+ * (a resume, a compaction) must NOT re-baseline, or every commit the session
+ * has already made would drop out of its own record. An existing observation is
+ * therefore left exactly as it is.
+ *
+ * Returns the observation in force after the call, or `null` when nothing could
+ * be observed (no repository among `repoRoots` was readable).
+ */
+declare function recordSessionBaseline(input: ObserveSessionInput): Promise<SessionObservation | null>;
+/**
+ * Recompute what the session has changed so far, against the baseline recorded
+ * at its start, and persist the result.
+ *
+ * A FULL recomputation, not an accumulation: `git diff <base>` already answers
+ * "net change since the session started" for tracked files, committed or not,
+ * so there is nothing to merge across turns and no way for the two halves to
+ * disagree. A file that was changed and then reverted correctly disappears.
+ *
+ * Per repository, a failure keeps that repository's PREVIOUS file list rather
+ * than clearing it: the common cause is a base commit that no longer resolves
+ * (a rebase, a reset), and forgetting what was already observed would be a
+ * silent loss where a stale list is merely old.
+ *
+ * Returns `null` when the session has no baseline — it started before the hook
+ * was installed, or outside a registered workspace — because inventing one now
+ * would measure from the middle of the work.
+ */
+declare function observeSessionChanges(input: Omit<ObserveSessionInput, "repoRoots">): Promise<SessionObservation | null>;
+
 type AppendBasouGitignoreResult = {
     /** True if the block was appended (or the file was newly created). */
     readonly appended: boolean;
@@ -7665,4 +7998,4 @@ declare function overwriteYamlFile(filePath: string, value: unknown): Promise<vo
  */
 declare const BASOU_CORE_VERSION = "0.1.0";
 
-export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, APPROVAL_SCHEMA_VERSION, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AnchorStarterInput, type AnchorStarterRepo, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_BUILD, BASOU_CORE_VERSION, type BasouPaths, type BuildStamp, type BuildStopHookCommandOptions, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeSettings, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexCommandLookup, type CodexHooksFile, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DECISION_GAPS_EPOCH, DEFAULT_STOP_HOOK_MIN_EDITS, type DayWorkStats, type DecisionGap, type DecisionGapsExcluded, type DecisionGapsIncomplete, type DecisionGapsInput, type DecisionGapsScope, type DecisionGapsSummary, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, EVENT_SCHEMA_VERSION, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type IncompleteWiring, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSIONS, type JsonSchemaArtifact, LOCAL_CLI_EVENT_SOURCE, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, MANIFEST_SCHEMA_VERSION, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type MissingCanonical, type NoteAddedEvent, ORIENTATION_END, ORIENTATION_START, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, PROTOCOL_UPDATE_TOKEN_PREFIX, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type PresetStrings, type ProcessRunner, type ProtocolStamp, type PublishKind, type PublishTarget, REVIEW_RECORD_NO_INPUT_HINT, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type RepoInstructions, type RepoLanguage, type RepoPathProblem, type RepoPresetFacts, type RepoPresetPlan, type RepoSymlinkFacts, type RepoSymlinkPlan, type RepoVisibility, type RepoWiringFacts, type ReportApprovalItem, type ReportData, type ReportDecisionItem, type ReportRendererInput, type ReportRendererResult, type ReportSessionItem, type ReportTaskItem, type RetrofitAction, type RetrofitAgentsState, type RetrofitFacts, type RetrofitPlan, type RetrofitReason, type ReviewBlocked, type ReviewFinding, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type ReviewGateResult, type ReviewGateSilentReason, type ReviewRecordBlockedInput, type ReviewRecordFindingInput, type ReviewRecordInput, type ReviewRecordedEvent, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, SESSION_IMPORT_SCHEMA_VERSION, SESSION_SCHEMA_VERSION, SESSION_START_HOOK_CONTEXT_LIMIT, SESSION_START_HOOK_MATCHER, SESSION_START_HOOK_STATUS_MESSAGE, SESSION_START_HOOK_TIMEOUT_SECONDS, STOP_HOOK_TIMEOUT_SECONDS, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type SelfReportedReview, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartHookLocation, type SessionStartHookRemoval, type SessionStartHookUpsert, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type StopHookEvaluation, type StopHookEvaluationInput, type StopHookRemoval, type StopHookSilentReason, type StopHookUpsert, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, TASK_SCHEMA_VERSION, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UnattachedSelfReports, type UnbindableRepo, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLanguage, type ViewLinkState, type ViewPresetInput, type ViewPresetRepo, type ViewRepoFact, type ViewStrayUnknown, type ViewStrings, type ViewWiringFacts, type WiringCollision, type WiringConflict, type WiringDriftSummary, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, ZERO_DURATION_RETIRED_SINCE, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildReviewRecordLabel, buildReviewRecordedEvent, buildSessionStartHookCommand, buildStatusSnapshot, buildStopHookCommand, carryForwardProtocolStamp, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexAdapterMetadata, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findBasouSessionStartHook, findBasouStopHookCommand, findDecisionGaps, findErrorCode, findReviewGaps, findUnbindableRepos, formatDurationMs, genesisHash, getDiff, getSnapshot, hasRetiredZeroDuration, importSessionFromJson, inspectChainTail, instructionMode, isBasouSessionStartHookCommand, isBasouStopHookCommand, isGitNotFound, isImportDerivedSource, isLazyExpired, isProtocolUpdateDue, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseBuildStamp, parseDuration, parseMarkers, parseProtocolStamp, parseReviewRecordInput, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, presetStrings, protocolBlockHash, protocolSectionsFrom, protocolUpdateToken, readAllEvents, readManifest, readMarkdownFile, readObservedDuration, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeSessionStartHook, removeStopHook, renderAnchorStarter, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderProtocolStamp, renderProtocolUpdate, renderReport, renderViewPresetBlock, renderWithMarkers, replayEvents, resolveAnchorContentLanguage, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveCodexCommand, resolveRepoContentLanguage, resolveRepoRoot, resolveRepositoryRoot, resolveSessionId, resolveTaskId, resolveViewLanguage, resolveViewLanguageFromPaths, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, seedMarkers, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, summarizeWiringDrift, transcriptStartedAt, tryRemoteUrl, ulid, unknownManifestKeys, unstampedProtocolSectionsFrom, updateTaskStatusWithEvent, upsertSessionStartHook, upsertStopHook, verifyEventsChain, viewStrings, writeEventsBulk, writeManifest, writeMarkdownFile, writeObservedDuration, writeStatus, writeTaskFile, writeYamlFile };
+export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, APPROVAL_SCHEMA_VERSION, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AnchorStarterInput, type AnchorStarterRepo, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_BUILD, BASOU_CORE_VERSION, type BasouPaths, type BuildStamp, type BuildStopHookCommandOptions, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeSessionStartHookKind, type ClaudeSessionStartHookLocation, type ClaudeSessionStartHookRemoval, type ClaudeSessionStartHookUpsert, type ClaudeSettings, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type ClaudeUnrecognizedSessionStart, type CodexCommandLookup, type CodexHooksFile, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DECISION_GAPS_EPOCH, DEFAULT_STOP_HOOK_MIN_EDITS, type DayWorkStats, type DecisionGap, type DecisionGapsExcluded, type DecisionGapsIncomplete, type DecisionGapsInput, type DecisionGapsScope, type DecisionGapsSummary, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, EVENT_SCHEMA_VERSION, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type IncompleteWiring, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSIONS, type JsonSchemaArtifact, LOCAL_CLI_EVENT_SOURCE, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, MANIFEST_SCHEMA_VERSION, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type MissingCanonical, type NoteAddedEvent, ORIENTATION_END, ORIENTATION_START, type ObserveSessionInput, type ObservedFile, type ObservedRepo, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, PROTOCOL_UPDATE_TOKEN_PREFIX, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type PresetStrings, type ProcessRunner, type ProtocolStamp, type PublishKind, type PublishTarget, REVIEW_RECORD_NO_INPUT_HINT, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type RepoInstructions, type RepoLanguage, type RepoPathProblem, type RepoPresetFacts, type RepoPresetPlan, type RepoSymlinkFacts, type RepoSymlinkPlan, type RepoVisibility, type RepoWiringFacts, type ReportApprovalItem, type ReportData, type ReportDecisionItem, type ReportRendererInput, type ReportRendererResult, type ReportSessionItem, type ReportTaskItem, type RetrofitAction, type RetrofitAgentsState, type RetrofitFacts, type RetrofitPlan, type RetrofitReason, type ReviewBlocked, type ReviewFinding, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type ReviewGateResult, type ReviewGateSilentReason, type ReviewRecordBlockedInput, type ReviewRecordFindingInput, type ReviewRecordInput, type ReviewRecordedEvent, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, SESSION_IMPORT_SCHEMA_VERSION, SESSION_OBSERVATION_SCHEMA_VERSION, SESSION_SCHEMA_VERSION, SESSION_START_HOOK_CONTEXT_LIMIT, SESSION_START_HOOK_MATCHER, SESSION_START_HOOK_STATUS_MESSAGE, SESSION_START_HOOK_TIMEOUT_SECONDS, STOP_HOOK_TIMEOUT_SECONDS, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type SelfReportedReview, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, type SessionObservation, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartHookLocation, type SessionStartHookRemoval, type SessionStartHookUpsert, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type StopHookEvaluation, type StopHookEvaluationInput, type StopHookRemoval, type StopHookSilentReason, type StopHookUpsert, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, TASK_SCHEMA_VERSION, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UnattachedSelfReports, type UnbindableRepo, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLanguage, type ViewLinkState, type ViewPresetInput, type ViewPresetRepo, type ViewRepoFact, type ViewStrayUnknown, type ViewStrings, type ViewWiringFacts, type WiringCollision, type WiringConflict, type WiringDriftSummary, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, ZERO_DURATION_RETIRED_SINCE, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildReviewRecordLabel, buildReviewRecordedEvent, buildSessionStartHookCommand, buildStatusSnapshot, buildStopHookCommand, carryForwardProtocolStamp, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexAdapterMetadata, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findBasouSessionStartHook, findBasouStopHookCommand, findClaudeSessionStartHooks, findDecisionGaps, findErrorCode, findReviewGaps, findUnbindableRepos, findUnrecognizedSessionStart, formatDurationMs, genesisHash, getChangesSince, getDiff, getSnapshot, getWorkingTreeChanges, hasRetiredZeroDuration, importSessionFromJson, inspectChainTail, instructionMode, isBasouOrientSessionStartCommand, isBasouSessionStartHookCommand, isBasouStopHookCommand, isClaudeSessionStartHookCommand, isClaudeSessionStartMalformed, isGitNotFound, isImportDerivedSource, isLazyExpired, isProtocolUpdateDue, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, observeSessionChanges, observedFilesOf, observedRepoRoots, overwriteYamlFile, parseBuildStamp, parseDuration, parseMarkers, parseProtocolStamp, parseReviewRecordInput, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, presetStrings, protocolBlockHash, protocolSectionsFrom, protocolUpdateToken, readAllEvents, readHeadSha, readManifest, readMarkdownFile, readObservedDuration, readSessionObservation, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, recordSessionBaseline, refreshTaskLinkedSessions, reimportPreservingId, removeClaudeSessionStartHook, removeMarkerSection, removeSessionStartHook, removeStopHook, renderAnchorStarter, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderProtocolStamp, renderProtocolUpdate, renderReport, renderViewPresetBlock, renderWithMarkers, replayEvents, resolveAnchorContentLanguage, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveCodexCommand, resolveRepoContentLanguage, resolveRepoRoot, resolveRepositoryRoot, resolveSessionId, resolveTaskId, resolveViewLanguage, resolveViewLanguageFromPaths, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, seedMarkers, serializeEventLine, serializeJsonSchema, sessionObservationPath, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, summarizeWiringDrift, transcriptStartedAt, tryRemoteUrl, ulid, unknownManifestKeys, unstampedProtocolSectionsFrom, updateTaskStatusWithEvent, upsertClaudeSessionStartHook, upsertSessionStartHook, upsertStopHook, verifyEventsChain, viewStrings, writeEventsBulk, writeManifest, writeMarkdownFile, writeObservedDuration, writeSessionObservation, writeStatus, writeTaskFile, writeYamlFile };