@basou/core 0.35.0 → 0.36.0

package/dist/index.d.ts

@@ -579,6 +579,9 @@ declare const SessionImportPayloadSchema: z.ZodObject<{
         type: z.ZodLiteral<"review_recorded">;
         reviewer: z.ZodString;
         target: z.ZodString;
+        repos: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        repos_resolved: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        commits: z.ZodOptional<z.ZodArray<z.ZodString>>;
         verdict: z.ZodOptional<z.ZodEnum<{
             pass: "pass";
             "needs-attention": "needs-attention";
@@ -857,11 +860,20 @@ type CodexRolloutToPayloadOptions = {
  * provenance-level events from the rollout's message-level records:
  *
  * - `session_started` / `session_ended` from the first / last timestamped record.
- * - `command_executed` from each `exec_command` function call, recorded as
- *   `bash -c "<cmd>"`. The shell line and working directory come from the
- *   call's JSON `arguments` (`{ cmd, workdir }`); the exit code and duration
- *   are parsed from the paired `function_call_output` (matched by `call_id`),
- *   whose text carries `Process exited with code N` and `Wall time: X seconds`.
+ * - `command_executed` from each shell execution, recorded as `bash -c "<cmd>"`.
+ *   Codex has written these two different ways, and BOTH are read (an operator's
+ *   `~/.codex/sessions` holds a mix across a CLI upgrade):
+ *     - one `function_call` named `exec_command` per command, with JSON
+ *       `arguments` (`{ cmd, workdir }`) and a `function_call_output` whose text
+ *       carries `Process exited with code N` / `Wall time: X seconds`;
+ *     - a scripted `custom_tool_call` (see
+ *       {@link readExecCommandsFromScript}) whose `input` is a JS program that
+ *       calls `tools.exec_command({ cmd, workdir })` — possibly several times in
+ *       one call — and whose output reports only `Wall time X seconds` for the
+ *       whole script, with no per-command exit code.
+ *   Reading only the first shape made every session recorded by a CLI that had
+ *   moved to the second derive ZERO commands, so the whole session was dropped
+ *   as "no actions" — capture went silently blind rather than degrading.
  *
  * Per-session `metrics` are also derived: token totals from the cumulative
  * `token_count` events; active time from the real `task_started` ->
@@ -1316,6 +1328,9 @@ declare const ReviewRecordedEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"review_recorded">;
     reviewer: z.ZodString;
     target: z.ZodString;
+    repos: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    repos_resolved: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    commits: z.ZodOptional<z.ZodArray<z.ZodString>>;
     verdict: z.ZodOptional<z.ZodEnum<{
         pass: "pass";
         "needs-attention": "needs-attention";
@@ -1605,6 +1620,9 @@ declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"review_recorded">;
     reviewer: z.ZodString;
     target: z.ZodString;
+    repos: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    repos_resolved: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    commits: z.ZodOptional<z.ZodArray<z.ZodString>>;
     verdict: z.ZodOptional<z.ZodEnum<{
         pass: "pass";
         "needs-attention": "needs-attention";
@@ -5974,6 +5992,14 @@ declare function renderReport(input: ReportRendererInput): Promise<ReportRendere
  *  - `unknown`       the repo or time could not be derived; abstain rather than
  *                    guess (an abstention is never counted as a clear).
  *
+ * A `review_recorded` event (written by `basou review record`) is a SELF-REPORT:
+ * the agent's own claim that a review ran, with nothing corroborating it. Such a
+ * record is bound to a unit by the repo paths it names and surfaced as a label,
+ * but it NEVER changes that unit's verdict — a gap stays a gap, a candidate
+ * stays a candidate — otherwise an empty record would become a way to make the
+ * gap count go down, the same weakness the Stop-gate has. It re-labels; it does
+ * not clear.
+ *
  * It reads only captured provenance and writes nothing.
  */
 type ReviewGapVerdict = "omission" | "near_unbound" | "candidate" | "unknown";
@@ -5986,6 +6012,28 @@ type CitedReview = {
     files: string[];
     endedAt: string | null;
 };
+/**
+ * A `review_recorded` self-report bound to a unit by the repo paths it named.
+ * Carries no corroboration: it is what the agent said it did, not what the
+ * capture observed.
+ */
+type SelfReportedReview = {
+    sessionId: string;
+    eventId: string;
+    reviewer: string;
+    target: string;
+    recordedAt: string;
+    /** Commit SHAs the record claimed to cover; display only, never a binding key. */
+    commits: string[];
+    /**
+     * The record was written after this unit's first commit, so it cannot have
+     * gated the work. Surfaced rather than hidden — a claim made after the fact is
+     * still the operator's own note about what happened, and the label can never
+     * reduce the gap count — but kept distinguishable, because when a record was
+     * written is part of what the operator is judging.
+     */
+    recordedAfterCommit: boolean;
+};
 /** One unit of work (a committing session's commits in one repo) and its verdict. */
 type ReviewGapUnit = {
     repo: string;
@@ -5997,6 +6045,33 @@ type ReviewGapUnit = {
     verdict: ReviewGapVerdict;
     /** For `candidate` / `near_unbound`: the review sessions considered. */
     reviews: CitedReview[];
+    /**
+     * `review_recorded` self-reports naming this repo in the window. Present on
+     * every repo-keyed unit; it re-labels the unit and NEVER alters `verdict`, so
+     * a self-reported gap is still a gap.
+     */
+    selfReports: SelfReportedReview[];
+};
+/** Recorded reviews that reached no unit of work, broken down by cause. */
+type UnattachedSelfReports = {
+    total: number;
+    /** The record named no repository at all. */
+    noRepos: number;
+    /**
+     * At least one repository it named could not be verified as a repo root on
+     * this machine. ANY unverifiable entry puts the record here, even alongside
+     * one that resolved: a half-checkable claim is refused whole, so that
+     * everything that does get paired was checkable in full.
+     */
+    unresolvableRepo: number;
+    /** It named a resolvable repository, but no unit of work fell in the window. */
+    noMatchingUnit: number;
+    /**
+     * Work WAS captured in the window, but the unit's own repository path could
+     * not be verified, so the pairing could not be checked either way. Distinct
+     * from {@link noMatchingUnit}, which would deny that the work exists.
+     */
+    unverifiableUnit: number;
 };
 type ReviewGapRepoSummary = {
     repo: string;
@@ -6005,6 +6080,8 @@ type ReviewGapRepoSummary = {
     nearUnboundUnits: number;
     candidateUnits: number;
     unknownUnits: number;
+    /** Of the units with no bound trail, how many carry a self-report only. */
+    selfReportedGapUnits: number;
 };
 type ReviewGapsSummary = {
     generatedAt: string;
@@ -6018,6 +6095,30 @@ type ReviewGapsSummary = {
     candidates: ReviewGapUnit[];
     /** Units whose repo/time could not be derived from the captured command; abstained, not cleared. */
     unknowns: ReviewGapUnit[];
+    /**
+     * Recorded reviews that changed nothing in this report — the answer to "I ran
+     * `basou review record` and the omission is still there". Reported with the
+     * reason for each, because basou must not assert a cause it has not
+     * established; "no `repos` field" and "a `repos` that does not resolve" are
+     * different mistakes with different fixes.
+     *
+     * Unlike {@link unknowns} this is NOT suppressed under a `--repo` scope, and
+     * attachment is computed against every unit rather than the scoped ones. It is
+     * a caveat about the tool's own input handling, not repo-dimensioned data, and
+     * a completeness caveat that disappears under a filter is how silence starts
+     * looking like success again — the very failure this surfacer exists to catch.
+     */
+    unattachedSelfReports: UnattachedSelfReports;
+    /**
+     * How many (record, unit) pairings fell inside a unit's window but could not
+     * be checked, because that unit's own repository path was never verified.
+     *
+     * Counted per PAIRING, not per record, and reported even when the record
+     * attached to some other unit: {@link unattachedSelfReports} only speaks for
+     * records that changed nothing at all, so a record that landed once and was
+     * refused elsewhere would otherwise leave the refusal invisible.
+     */
+    refusedPairings: number;
     /** Newest captured commit considered; commits not yet imported are invisible. */
     newestCommitAt: string | null;
 };
@@ -6048,6 +6149,38 @@ type ReviewGapsSummary = {
  * process lifetime.
  */
 declare function normalizeRepoPath(p: string | null | undefined): string | null;
+/** Why a hand-typed repository path cannot become a binding key. */
+type RepoPathProblem = "relative" | "absent" | "not_a_repo_root";
+/** A `repos` entry that cannot bind, and why. */
+type UnbindableRepo = {
+    repo: string;
+    index: number;
+    problem: RepoPathProblem;
+};
+/**
+ * Strict repo-root resolution for HAND-TYPED input (a record's `repos`), as
+ * opposed to {@link normalizeRepoPath}, which reads paths basou itself captured.
+ *
+ * The difference is the string fallback. `normalizeRepoPath` keeps one for
+ * captured data: a historical `cd` target whose repo has since moved is still
+ * the best key available, and refusing it would lose an observation basou
+ * genuinely made. Typed input has no such claim on the benefit of the doubt — a
+ * relative path, a typo, or a subdirectory would mint a key that no commit can
+ * ever match, and the record would then be accepted, stored, and silently
+ * unbindable forever. So this verifies against the disk and returns null
+ * otherwise.
+ *
+ * The asymmetry runs the safe way: everything this accepts, `normalizeRepoPath`
+ * resolves to the same key, so a record the writer took is a record the reader
+ * can bind.
+ */
+declare function resolveRepoRoot(p: string | null | undefined): string | null;
+/**
+ * The `repos` entries that could never bind to a unit of work, for the writer to
+ * reject before the record is stored. Sharing {@link classifyRepoPath} with the
+ * reader is the point: the writer must not accept a path the reader cannot use.
+ */
+declare function findUnbindableRepos(repos: readonly string[]): UnbindableRepo[];
 /**
  * Short repo key (the final path segment) for DISPLAY and `--scope` matching.
  * Binding uses {@link normalizeRepoPath} to avoid basename collisions; this is
@@ -6094,6 +6227,19 @@ type ReviewRecordInput = {
     reviewer: string;
     /** What was reviewed (e.g. "working-tree", a git ref, "PR #145"). Required. */
     target: string;
+    /**
+     * Repository paths the review examined. Optional, but it is the ONLY thing
+     * that can bind this record to the reviewed repo: the record lands in an
+     * ad-hoc session whose location is the planning repo it was written from, not
+     * the repo under review. Without it `review-gaps` cannot associate the record
+     * with a unit of work.
+     */
+    repos?: string[];
+    /**
+     * Commit SHAs the review examined. Optional; recorded as the reviewer's own
+     * claim about coverage.
+     */
+    commits?: string[];
     /** Overall outcome. Optional. */
     verdict?: "pass" | "needs-attention" | "fail";
     /** Findings surfaced by the review. Optional. */
@@ -6124,6 +6270,13 @@ declare function buildReviewRecordedEvent(input: {
     sessionId: PrefixedId<"ses">;
     occurredAt: string;
     review: ReviewRecordInput;
+    /**
+     * The canonical repository roots `review.repos` resolved to on this machine.
+     * A CALLER-DERIVED value, not part of the piped input: what a path resolves to
+     * is something basou observes, and the whole point of keeping it is that the
+     * author's spelling may be a symlink whose target changes later.
+     */
+    reposResolved?: string[];
 }): Event;
 /** Ad-hoc session label for a recorded review: `Ad-hoc review: <reviewer> -> <target>`. */
 declare function buildReviewRecordLabel(review: ReviewRecordInput): string;
@@ -6713,4 +6866,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 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_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 IncompleteWiring, 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 MissingCanonical, 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 PresetStrings, 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 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, 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, presetStrings, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeStopHook, renderAnchorStarter, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderViewPresetBlock, renderWithMarkers, replayEvents, resolveAnchorContentLanguage, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveCodexCommand, resolveRepoContentLanguage, resolveRepositoryRoot, resolveSessionId, resolveTaskId, resolveViewLanguage, resolveViewLanguageFromPaths, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, seedMarkers, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, summarizeWiringDrift, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, upsertStopHook, verifyEventsChain, viewStrings, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };
+export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, 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_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 IncompleteWiring, 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 MissingCanonical, 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 PresetStrings, 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 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, 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 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 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, 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, findUnbindableRepos, 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, presetStrings, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeStopHook, renderAnchorStarter, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, 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, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, upsertStopHook, verifyEventsChain, viewStrings, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };