@basou/core 0.28.0 → 0.30.0

package/dist/index.d.ts

@@ -2,6 +2,13 @@ import { z } from 'zod';
 import { SimpleGit } from 'simple-git';
 import { ChildProcess } from 'node:child_process';
 
+/**
+ * Predicate deciding whether a candidate executable is reachable on PATH.
+ * Exposed as a parameter on the per-tool `resolve*Command` helpers so tests can
+ * substitute a deterministic mock; production callers rely on {@link isOnPath}.
+ */
+type CommandLookup = (command: string) => Promise<boolean>;
+
 /**
  * Static metadata identifying the claude-code adapter as the session source.
  * Consumed by the CLI orchestration when populating `session.yaml.source`
@@ -13,13 +20,6 @@ declare const claudeCodeAdapterMetadata: {
     readonly kind: "claude-code-adapter";
     readonly version: "0.1.0";
 };
-/**
- * Lookup predicate used by {@link resolveClaudeCodeCommand} to decide
- * whether a candidate executable is reachable on PATH. Exposed as a
- * parameter so tests can substitute a deterministic mock; production
- * callers should omit it and rely on the default `which`-based lookup.
- */
-type CommandLookup = (command: string) => Promise<boolean>;
 /**
  * Resolve the Claude Code CLI executable name. Tries `claude-code` first
  * and falls back to `claude`; the first candidate found on PATH wins.
@@ -45,6 +45,67 @@ declare function resolveClaudeCodeCommand(lookup?: CommandLookup): Promise<{
  */
 declare function summarizeAdapterOutput(_stream: "stdout" | "stderr", _raw: string): string;
 
+/**
+ * Pure transforms for registering / removing basou's Stop hook inside a parsed
+ * Claude Code settings.json object. No disk or environment access: the CLI reads
+ * and writes the file, parses the JSON, and passes the object here so the
+ * 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.
+ */
+/** Seconds before Claude Code kills the hook process. Matches the documented orient (SessionStart) hook. */
+declare const STOP_HOOK_TIMEOUT_SECONDS = 20;
+declare function isBasouStopHookCommand(command: string): boolean;
+type BuildStopHookCommandOptions = {
+    /** Absolute path to the CLI entry to invoke (the running dist/index.js). */
+    cliEntry: string;
+    /** Register the blocking (opt-in enforcement) form. */
+    block?: boolean;
+    /** Enable the opt-in review gate (adds `--require-review`). */
+    requireReview?: boolean;
+    /** Override the file-edit threshold passed to `hook stop`. */
+    minEdits?: number;
+};
+/**
+ * Build the shell command basou registers as a Stop hook. Uses the node path
+ * (not the `basou` alias, which is often absent from a non-interactive hook's
+ * PATH) and a `2>/dev/null || true` wrapper so a stale/incorrect dist path or
+ * any crash fails open — no per-turn error noise. The wrapper is safe for the
+ * blocking form because that emits `decision:"block"` on stdout with exit 0;
+ * `|| true` would defeat an exit-2 block but leaves the JSON form intact.
+ *
+ * The entry path is shell-quoted so a home/project directory containing spaces
+ * or shell metacharacters still invokes correctly (an unquoted path with a
+ * space would split into the wrong argv and the hook would silently no-op).
+ */
+declare function buildStopHookCommand(options: BuildStopHookCommandOptions): string;
+type ClaudeSettings = Record<string, unknown>;
+type StopHookUpsert = {
+    settings: ClaudeSettings;
+    /** `installed` = a new entry was appended; `updated` = an existing basou entry was rewritten; `unchanged` = already canonical. */
+    action: "installed" | "updated" | "unchanged";
+};
+type StopHookRemoval = {
+    settings: ClaudeSettings;
+    action: "removed" | "absent";
+};
+/**
+ * Register (or upgrade in place) basou's Stop hook. Idempotent: an existing
+ * basou Stop hook is rewritten to the canonical command + timeout; a foreign
+ * Stop hook or any other settings key is left untouched.
+ */
+declare function upsertStopHook(settings: unknown, command: string): StopHookUpsert;
+/**
+ * Remove every basou-owned Stop hook. A group emptied by the removal is dropped;
+ * a now-empty `hooks.Stop` / `hooks` container is deleted so the file does not
+ * accumulate empty scaffolding. Foreign hooks and other keys are preserved.
+ */
+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;
+
 /**
  * Schema for `.basou/manifest.yaml`. The minimal manifest carries
  * schema_version, basou_version, workspace metadata, project info, enabled
@@ -160,6 +221,7 @@ declare const SessionInnerImportSchema: z.ZodObject<{
             "claude-code-adapter": "claude-code-adapter";
             import: "import";
             "claude-code-import": "claude-code-import";
+            "codex-adapter": "codex-adapter";
             "codex-import": "codex-import";
             human: "human";
             terminal: "terminal";
@@ -225,6 +287,7 @@ declare const SessionImportPayloadSchema: z.ZodObject<{
                 "claude-code-adapter": "claude-code-adapter";
                 import: "import";
                 "claude-code-import": "claude-code-import";
+                "codex-adapter": "codex-adapter";
                 "codex-import": "codex-import";
                 human: "human";
                 terminal: "terminal";
@@ -507,6 +570,39 @@ declare const SessionImportPayloadSchema: z.ZodObject<{
             note: "note";
             next_step: "next_step";
         }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        schema_version: z.ZodLiteral<"0.1.0">;
+        id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
+        session_id: z.ZodString & z.ZodType<`ses_${string}`, string, z.core.$ZodTypeInternals<`ses_${string}`, string>>;
+        occurred_at: z.ZodString;
+        source: z.ZodString;
+        prev_hash: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"review_recorded">;
+        reviewer: z.ZodString;
+        target: z.ZodString;
+        verdict: z.ZodOptional<z.ZodEnum<{
+            pass: "pass";
+            "needs-attention": "needs-attention";
+            fail: "fail";
+        }>>;
+        findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            severity: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            location: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        blocked: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            reason: z.ZodEnum<{
+                "spec-deviation": "spec-deviation";
+                "design-reversal": "design-reversal";
+            }>;
+            why: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         schema_version: z.ZodLiteral<"0.1.0">;
         id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -623,6 +719,31 @@ type StopHookEvaluationInput = {
 };
 /** Why the hook stayed silent (useful for tests and `--json` introspection). */
 type StopHookSilentReason = "stop_hook_active" | "not_substantive" | "already_captured";
+/**
+ * Why the review gate stayed silent. The gate fires only when a SHIP act, a
+ * substantive-code edit, and the ABSENCE of a review record all hold; each
+ * reason names the first of those three that did not.
+ *  - `stop_hook_active`: loop guard — a continuation turn never fires.
+ *  - `no_ship_act`: nothing was shipped this turn (review is a pre-ship act, so
+ *    a turn that did not push / open / merge owes no review).
+ *  - `not_substantive_code`: shipped, but fewer than `minEdits` file edits.
+ *  - `already_reviewed`: a `basou review record` ran this session.
+ */
+type ReviewGateSilentReason = "stop_hook_active" | "no_ship_act" | "not_substantive_code" | "already_reviewed";
+/**
+ * The review gate's verdict, computed INDEPENDENTLY of the capture gate in the
+ * same transcript pass: a session can have captured its decisions yet still owe
+ * a review (it shipped code without recording one), and vice versa. Returned
+ * alongside the capture verdict; no caller renders it yet — a follow-on slice
+ * will have the CLI compose it with the capture signal into the nudge / block.
+ */
+type ReviewGateResult = {
+    fires: false;
+    reason: ReviewGateSilentReason;
+} | {
+    fires: true;
+    additionalContext: string;
+};
 type StopHookCounts = {
     /** Bash tool uses (informational — does NOT drive the trigger). */
     commandCount: number;
@@ -634,9 +755,11 @@ type StopHookCounts = {
 type StopHookEvaluation = ({
     kind: "silent";
     reason: StopHookSilentReason;
+    review: ReviewGateResult;
 } & StopHookCounts) | ({
     kind: "nudge";
     additionalContext: string;
+    review: ReviewGateResult;
 } & StopHookCounts);
 /**
  * Decide whether a finished turn warrants a non-blocking capture nudge.
@@ -658,9 +781,42 @@ type StopHookEvaluation = ({
  *  - no capture verb (`basou decision capture` / `decision record` / `note`)
  *    was run this session, so a session that already recorded its intent is
  *    left alone.
+ *
+ * It ALSO computes a second, independent verdict: the {@link ReviewGateResult}
+ * (whether a substantive-code session shipped — push / PR / merge — without
+ * recording a review). The two are computed in one transcript pass and returned
+ * together; the CLI composes them. The review verdict is purely additive here —
+ * the capture `kind` / `additionalContext` / `reason` are byte-identical to
+ * before, so consumers that read only the capture signal are unaffected.
  */
 declare function evaluateStopHook(input: StopHookEvaluationInput): StopHookEvaluation;
 
+/** Alias kept for API symmetry with the claude-code adapter's `CommandLookup`. */
+type CodexCommandLookup = CommandLookup;
+/**
+ * Static metadata identifying a live `basou run codex` session source. The twin
+ * of {@link import("../claude-code/claude-code-adapter.js").claudeCodeAdapterMetadata};
+ * `kind` is part of the wire format defined by the session schema
+ * (`SessionSourceKindSchema`), so do not change it without a coordinated schema
+ * migration. Distinct from `codex-import` (the after-the-fact rollout importer).
+ */
+declare const codexAdapterMetadata: {
+    readonly kind: "codex-adapter";
+    readonly version: "0.1.0";
+};
+/**
+ * Resolve the Codex CLI executable name. Only `codex` is a candidate (unlike
+ * claude-code's `claude-code`/`claude` pair, Codex ships a single binary name).
+ *
+ * Throws a fixed-message Error when it is not reachable, so callers can present
+ * a single user-facing prompt to install the CLI.
+ *
+ * @throws Error("Codex CLI not found in PATH. Install codex first.")
+ */
+declare function resolveCodexCommand(lookup?: CommandLookup): Promise<{
+    command: string;
+}>;
+
 /**
  * The `source` string stamped on every event derived from an OpenAI Codex
  * native rollout log, and the matching session `source.kind`.
@@ -1133,6 +1289,58 @@ declare const NoteAddedEventSchema: z.ZodObject<{
         next_step: "next_step";
     }>>;
 }, z.core.$strip>;
+declare const ReviewFindingSchema: z.ZodObject<{
+    title: z.ZodString;
+    severity: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    location: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ReviewBlockedSchema: z.ZodObject<{
+    title: z.ZodString;
+    reason: z.ZodEnum<{
+        "spec-deviation": "spec-deviation";
+        "design-reversal": "design-reversal";
+    }>;
+    why: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ReviewRecordedEventSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"0.1.0">;
+    id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
+    session_id: z.ZodString & z.ZodType<`ses_${string}`, string, z.core.$ZodTypeInternals<`ses_${string}`, string>>;
+    occurred_at: z.ZodString;
+    source: z.ZodString;
+    prev_hash: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"review_recorded">;
+    reviewer: z.ZodString;
+    target: z.ZodString;
+    verdict: z.ZodOptional<z.ZodEnum<{
+        pass: "pass";
+        "needs-attention": "needs-attention";
+        fail: "fail";
+    }>>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        severity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        location: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    blocked: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        reason: z.ZodEnum<{
+            "spec-deviation": "spec-deviation";
+            "design-reversal": "design-reversal";
+        }>;
+        why: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 declare const AdapterOutputEventSchema: z.ZodObject<{
     schema_version: z.ZodLiteral<"0.1.0">;
     id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -1388,6 +1596,39 @@ declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         note: "note";
         next_step: "next_step";
     }>>;
+}, z.core.$strip>, z.ZodObject<{
+    schema_version: z.ZodLiteral<"0.1.0">;
+    id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
+    session_id: z.ZodString & z.ZodType<`ses_${string}`, string, z.core.$ZodTypeInternals<`ses_${string}`, string>>;
+    occurred_at: z.ZodString;
+    source: z.ZodString;
+    prev_hash: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"review_recorded">;
+    reviewer: z.ZodString;
+    target: z.ZodString;
+    verdict: z.ZodOptional<z.ZodEnum<{
+        pass: "pass";
+        "needs-attention": "needs-attention";
+        fail: "fail";
+    }>>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        severity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        location: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    blocked: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        reason: z.ZodEnum<{
+            "spec-deviation": "spec-deviation";
+            "design-reversal": "design-reversal";
+        }>;
+        why: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     schema_version: z.ZodLiteral<"0.1.0">;
     id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -1442,6 +1683,12 @@ type TaskDeletedEvent = z.infer<typeof TaskDeletedEventSchema>;
 type TaskArchivedEvent = z.infer<typeof TaskArchivedEventSchema>;
 /** Narrowed runtime type for the `note_added` event variant. */
 type NoteAddedEvent = z.infer<typeof NoteAddedEventSchema>;
+/** Narrowed runtime type for the `review_recorded` event variant. */
+type ReviewRecordedEvent = z.infer<typeof ReviewRecordedEventSchema>;
+/** One finding surfaced by a `review_recorded` event. */
+type ReviewFinding = z.infer<typeof ReviewFindingSchema>;
+/** One blocked finding (spec-deviation / design-reversal) of a `review_recorded` event. */
+type ReviewBlocked = z.infer<typeof ReviewBlockedSchema>;
 /** Narrowed runtime type for the `adapter_output` event variant (.strict()). */
 type AdapterOutputEvent = z.infer<typeof AdapterOutputEventSchema>;
 
@@ -1520,6 +1767,7 @@ type SessionStatus = z.infer<typeof SessionStatusSchema>;
  * - `claude-code-adapter` — a live `basou run claude-code` process wrap.
  * - `claude-code-import` — derived after the fact from a Claude Code native
  *   transcript (`~/.claude/projects/*.jsonl`) by `basou import claude-code`.
+ * - `codex-adapter` — a live `basou run codex` process wrap.
  * - `codex-import` — derived after the fact from an OpenAI Codex native
  *   rollout log (date-partitioned `~/.codex/sessions`) by `basou import codex`.
  * - `import` — a round-trip of a Basou-format export (`basou session import`).
@@ -1529,6 +1777,7 @@ declare const SessionSourceKindSchema: z.ZodEnum<{
     "claude-code-adapter": "claude-code-adapter";
     import: "import";
     "claude-code-import": "claude-code-import";
+    "codex-adapter": "codex-adapter";
     "codex-import": "codex-import";
     human: "human";
     terminal: "terminal";
@@ -1613,6 +1862,7 @@ declare const SessionSchema: z.ZodObject<{
                 "claude-code-adapter": "claude-code-adapter";
                 import: "import";
                 "claude-code-import": "claude-code-import";
+                "codex-adapter": "codex-adapter";
                 "codex-import": "codex-import";
                 human: "human";
                 terminal: "terminal";
@@ -5266,6 +5516,63 @@ type ReviewGapsInput = {
  */
 declare function findReviewGaps(input: ReviewGapsInput): Promise<ReviewGapsSummary>;
 
+/**
+ * The deterministic writer for `basou review record` — the twin of
+ * `basou decision capture`. The in-loop agent runs a review (with a
+ * vendor-specific command), then pipes a JSON object describing what ran;
+ * basou parses + validates it here and writes a `review_recorded` event,
+ * with NO runtime LLM. Keeping parse + build in core (rather than the CLI,
+ * where `decision capture` happens to live) makes the writer unit-testable
+ * on its own and reusable by the read-only `review-gaps` surfacer.
+ *
+ * This is a self-report: basou records that a review happened; it does not
+ * verify the review actually executed. Cryptographic enforcement is the
+ * bridle's (mcp-bridle) concern — core stays read-only/advisory.
+ */
+/** A finding in the review record input (the on-wire `findings[]` shape). */
+type ReviewRecordFindingInput = ReviewFinding;
+/** A blocked finding in the review record input (the on-wire `blocked[]` shape). */
+type ReviewRecordBlockedInput = ReviewBlocked;
+/** A parsed + validated review record: required minimum + optional rich fields. */
+type ReviewRecordInput = {
+    /** What/who reviewed (e.g. "codex", a model name, "self"). Required. */
+    reviewer: string;
+    /** What was reviewed (e.g. "working-tree", a git ref, "PR #145"). Required. */
+    target: string;
+    /** Overall outcome. Optional. */
+    verdict?: "pass" | "needs-attention" | "fail";
+    /** Findings surfaced by the review. Optional. */
+    findings?: ReviewRecordFindingInput[];
+    /**
+     * Findings blocked as spec-deviation / design-reversal. Optional, but an
+     * explicit empty array is encouraged — it records "I blocked nothing" as the
+     * adversarial-review protocol requires.
+     */
+    blocked?: ReviewRecordBlockedInput[];
+};
+/** Actionable hint shown when nothing is piped in. */
+declare const REVIEW_RECORD_NO_INPUT_HINT = "No input: pipe a JSON object describing the review to stdin or pass --file <path>.";
+/**
+ * Parse + validate the review record input — a SINGLE JSON object (one
+ * invocation = one review), unlike `decision capture`'s array. Errors name the
+ * offending field (e.g. `findings[2].severity must be ...`) so the in-loop
+ * agent can self-correct without guessing. Pure: no disk/environment access.
+ */
+declare function parseReviewRecordInput(raw: string): ReviewRecordInput;
+/**
+ * Build the `review_recorded` event from a validated input. Mirrors
+ * `buildDecisionEvent`: optional fields are spread only when present so an
+ * event with just the required minimum round-trips byte-identically.
+ */
+declare function buildReviewRecordedEvent(input: {
+    eventId: PrefixedId<"evt">;
+    sessionId: PrefixedId<"ses">;
+    occurredAt: string;
+    review: ReviewRecordInput;
+}): Event;
+/** Ad-hoc session label for a recorded review: `Ad-hoc review: <reviewer> -> <target>`. */
+declare function buildReviewRecordLabel(review: ReviewRecordInput): string;
+
 /**
  * Internal abstraction over child-process execution.
  *
@@ -5509,6 +5816,10 @@ declare const GENERATED_END = "<!-- BASOU:GENERATED:END -->";
 declare const PROTOCOL_START = "<!-- BASOU:PROTOCOLS:START -->";
 /** Marker line that ends a managed protocol block. */
 declare const PROTOCOL_END = "<!-- BASOU:PROTOCOLS:END -->";
+/** Marker line that begins a managed orientation block in a vendor context face (e.g. ~/.codex/AGENTS.md). */
+declare const ORIENTATION_START = "<!-- BASOU:ORIENTATION:START -->";
+/** Marker line that ends a managed orientation block. */
+declare const ORIENTATION_END = "<!-- BASOU:ORIENTATION:END -->";
 /** A start/end marker pair. Both lines are matched whole-line, exact. */
 type Markers = {
     start: string;
@@ -5827,4 +6138,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, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, 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_VERSION, type BasouPaths, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DEFAULT_STOP_HOOK_MIN_EDITS, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, 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 InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, 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 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 ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, 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 SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type StopHookEvaluation, type StopHookEvaluationInput, type StopHookSilentReason, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, 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 UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildStatusSnapshot, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, instructionMode, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };
+export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, 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_VERSION, type BasouPaths, 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 CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DEFAULT_STOP_HOOK_MIN_EDITS, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, 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 InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, ORIENTATION_END, ORIENTATION_START, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, 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 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, STOP_HOOK_TIMEOUT_SECONDS, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, 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 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, 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 UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildReviewRecordLabel, buildReviewRecordedEvent, buildStatusSnapshot, buildStopHookCommand, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexAdapterMetadata, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findBasouStopHookCommand, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, instructionMode, isBasouStopHookCommand, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, parseReviewRecordInput, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeStopHook, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveCodexCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, upsertStopHook, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };