@basou/core 0.45.0 → 0.46.0

package/dist/index.d.ts

@@ -823,6 +823,21 @@ type StopHookEvaluation = ({
  * before, so consumers that read only the capture signal are unaffected.
  */
 declare function evaluateStopHook(input: StopHookEvaluationInput): StopHookEvaluation;
+/**
+ * When the session this transcript belongs to started: the timestamp of its
+ * first record that carries a parseable one.
+ *
+ * Used to date what the session is HOLDING. Anything the session read at start
+ * — its instruction files, the protocols rendered into them — is the version
+ * that existed at this instant, so a managed block whose stamp says it changed
+ * after it is newer than the copy in that session's context.
+ *
+ * Not every record carries a timestamp (a leading `summary` record does not),
+ * so this scans forward rather than reading `records[0]` and giving up.
+ * `undefined` means the transcript never said, and callers then say nothing
+ * rather than guess a start.
+ */
+declare function transcriptStartedAt(records: ClaudeTranscriptRecord[]): string | undefined;
 
 /** Alias kept for API symmetry with the claude-code adapter's `CommandLookup`. */
 type CodexCommandLookup = CommandLookup;
@@ -2703,12 +2718,24 @@ type ViewStrings = {
         /**
          * Same heading, but a task file could not be read on THIS pass, so its
          * status is unknown and "none in flight" would be an assertion the
-         * renderer cannot support. Says what it can see and stops. Reading the
-         * tasks directory can rebuild the index without the unreadable file, in
-         * which case a later render does not attempt it and this line gives way
-         * to its sibling -- the line reports a pass, not a standing condition.
+         * renderer cannot support. Says what it can see and stops.
+         *
+         * A standing condition, not a one-pass report: it holds every render until
+         * the file is repaired or removed. It used to give way to its sibling on
+         * the second render, because rebuilding the task index dropped the file it
+         * could not parse and nothing enumerated it again.
          */
         tasksUnreadable: string;
+        /**
+         * Appended under a NON-empty in-flight list when some task file could not
+         * be read.
+         *
+         * The list above it is true and incomplete at the same time, and a reader
+         * has no way to tell from a heading count that anything is missing. The
+         * zero case already says so; saying nothing here would make "unreadable" a
+         * fact basou reports only when it happens to have nothing else to report.
+         */
+        tasksUnreadableAlongside: (n: number) => string;
         pendingApprovalsHeading: (n: number) => string;
         suspectSessionsHeading: (n: number) => string;
         openTracksHeading: (n: number) => string;
@@ -3687,9 +3714,15 @@ declare function writeTaskFile(paths: BasouPaths, taskId: string, doc: TaskDocum
  * the caller's `options.onSkip` hook in {@link loadTaskEntries} so list
  * commands can show a warning row.
  *
- * Returns ids in ULID-ascending order (filename sort matches ULID order).
+ * Ids come back in ULID-ascending order: the disk scan sorts by filename,
+ * which matches ULID order, and {@link rebuildTaskIndex} sorts what it writes,
+ * so an index basou wrote is already in that order. An index edited by hand
+ * into some other order is returned in it — no caller depends on the order,
+ * and re-sorting a trusted cache would hide that it was used.
+ *
  * Empty directory or ENOENT → `[]`. Other I/O failures throw
- * `"Failed to enumerate tasks"`.
+ * `"Failed to enumerate tasks"`, unless a valid index is available to answer
+ * from instead.
  */
 declare function enumerateTaskIds(paths: BasouPaths): Promise<string[]>;
 /**
@@ -3900,7 +3933,8 @@ type ReconcileFailure = {
     phase: TaskWriteAfterEventPhase | null;
 };
 /**
- * Batch audit result. Order follows `enumerateTaskIds(paths)` (ULID-ascending).
+ * Batch audit result. Order follows `enumerateTaskIds(paths)`, which is
+ * ULID-ascending for any index basou wrote and for every disk scan.
  * `scanned` is the number of readable task.md files processed (= excludes
  * malformed task.md from the count so an integrity-broken file does not
  * pad the total).
@@ -4689,14 +4723,13 @@ type OrientationSummary = {
      *  zero in-flight count distinguish "all closed" from "never used here".
      *  See {@link anyTaskEverRecorded}: a live count is NOT this. */
     anyTaskEverRecorded: boolean;
-    /** Task files THIS pass tried and failed to read, so their status is
-     *  unknown. A zero in-flight count is only a claim about the files that
-     *  parsed: with one of these present, "none in flight" is not something the
-     *  renderer can say. Reported to the caller through `onTaskSkip` as well,
-     *  but that goes to stderr and the body travels on its own (hooks ship the
-     *  body alone). Not a standing count: enumerating tasks can rebuild the
-     *  index without the unreadable file, after which later passes do not
-     *  attempt it and this reads zero while the file is still on disk. */
+    /** How many task files this render could not read.
+     *
+     * A standing count: the task index is reconciled against the tasks directory
+     * on every enumeration, so a file that cannot be parsed keeps being attempted
+     * — and keeps being counted — until it is repaired or removed. It used to
+     * read zero from the second render on, because rebuilding the index dropped
+     * the file and nothing enumerated it again. */
     unreadableTaskCount: number;
     /** Tasks whose status is `planned` ("where am I heading"). */
     plannedTasks: PlannedTask[];
@@ -5953,6 +5986,120 @@ type WorkspaceViewPlan = {
  */
 declare function planWorkspaceView(facts: ViewRepoFact[], existing?: ExistingViewLink[], rosterNames?: string[]): WorkspaceViewPlan;
 
+/** Prefix of the token embedded in a delivery; the content digest follows it. */
+declare const PROTOCOL_UPDATE_TOKEN_PREFIX = "basou:protocol-updated";
+/** What the block records about itself. */
+type ProtocolStamp = {
+    /** When the block's rendered protocol text last CHANGED (ISO 8601, UTC). */
+    changedAt: string;
+    /** Truncated digest of that rendered text. */
+    contentHash: string;
+};
+/** Truncated digest of the block's rendered protocol text. */
+declare function protocolBlockHash(sections: string): string;
+/**
+ * The delivery's dedupe token for a given block state.
+ *
+ * It carries the content digest rather than being a bare literal, so "already
+ * delivered" means "already delivered THIS text". A second update inside one
+ * session — usually the correction of the first, after watching an agent
+ * misapply it — is a different digest and still lands. A bare literal would
+ * make the one edit most worth delivering the one guaranteed not to arrive.
+ */
+declare function protocolUpdateToken(contentHash: string): string;
+/**
+ * Render the stamp line.
+ *
+ * Nothing operator-authored goes on it — only a timestamp and a digest — so a
+ * source path or a protocol body containing a space, a quote, or a `-->` cannot
+ * break the line it is rendered into.
+ */
+declare function renderProtocolStamp(stamp: ProtocolStamp): string;
+/**
+ * Find and parse the stamp line in a rendered block body.
+ *
+ * Returns `null` when the block carries no readable stamp — a block rendered by
+ * a basou older than this feature, a hand-deleted stamp, a mangled one. A null
+ * means "cannot tell", and every caller treats it as "say nothing": the point
+ * of the feature is to speak only when basou actually knows something changed.
+ */
+declare function parseProtocolStamp(blockBody: string): ProtocolStamp | null;
+/**
+ * Build the stamp for the block about to be written: keep the previous
+ * `changedAt` when the rendered text is unchanged, and set it to `now`
+ * otherwise.
+ *
+ * `sections` is the rendered protocol text exactly as it will appear under the
+ * stamp — the same bytes a session reads and the same bytes a delivery carries.
+ * Hashing anything else (the raw source files, say) would let bytes no session
+ * ever sees move the stamp, and basou would then tell a session that text it
+ * already holds supersedes what it already holds.
+ *
+ * `changedAt` is forced strictly forward when the text did change. Wall-clock
+ * time can move backwards — an NTP correction, a laptop waking in another
+ * timezone — and a stamp dated before the session start would drop the delivery
+ * for the rest of that session, silently and permanently.
+ */
+declare function carryForwardProtocolStamp(input: {
+    sections: string;
+    previous: ProtocolStamp | null;
+    now: string;
+}): ProtocolStamp;
+/**
+ * The rendered protocol text inside a block: everything below the stamp line.
+ *
+ * Anchored on the stamp rather than on "skip the leading comments" so a
+ * protocol whose own body opens with an HTML comment keeps it. Returns `null`
+ * when there is no stamp line to anchor on, and an empty string when the block
+ * holds a stamp and nothing else.
+ *
+ * Takes a block BODY, but stops at a closing marker line if one is present, so
+ * handing it a whole file yields the same answer instead of a digest that
+ * silently includes the marker and matches nothing.
+ */
+declare function protocolSectionsFrom(blockBody: string): string | null;
+/**
+ * The rendered protocol text inside a block written before stamps existed:
+ * everything below the managed note.
+ *
+ * Only for reading the block an upgrade is about to replace. Knowing what that
+ * block held is what lets an upgrade stay silent — if the text is the same, no
+ * running session is owed anything, and dating the new stamp at `now` would
+ * announce a change to every session on the machine the first time the new
+ * basou syncs. Less precise than the stamped path (a protocol body opening
+ * with its own HTML comment loses that line here), which is why it is confined
+ * to blocks that carry no stamp: a wrong answer costs one redundant delivery,
+ * never a wrong one.
+ */
+declare function unstampedProtocolSectionsFrom(blockBody: string): string;
+/**
+ * Whether a session that started at `sessionStartedAt` is holding an older copy
+ * of the block than the one the stamp describes.
+ *
+ * A change dated at or before the start is one the session already read. An
+ * unparseable start yields `false` rather than "everything": without a session
+ * start there is no "after".
+ */
+declare function isProtocolUpdateDue(input: {
+    stamp: ProtocolStamp;
+    sessionStartedAt: string;
+}): boolean;
+/**
+ * The text handed to the running session: the protocols themselves, not a
+ * pointer to them.
+ *
+ * basou cannot observe whether an agent re-read a file, so a notice saying "go
+ * and re-read" would put the one step that decides the outcome outside what
+ * basou can see. Carrying the text makes the delivery and the reading the same
+ * act. It does not make the ADOPTION observable — nothing basou can do would —
+ * but it removes the step that was avoidably invisible.
+ *
+ * The complete current set is sent, not a diff, so the lead line's claim is
+ * exactly true: after this, the set below is the whole of the standing
+ * protocols, and anything read at session start that is absent here is gone.
+ */
+declare function renderProtocolUpdate(sections: string, stamp: ProtocolStamp): string;
+
 /**
  * `schema_version` of each on-disk format, keyed by artifact basename.
  *
@@ -7508,4 +7655,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, 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, 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, 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, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseBuildStamp, parseDuration, parseMarkers, parseReviewRecordInput, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, presetStrings, readAllEvents, readManifest, readMarkdownFile, readObservedDuration, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeSessionStartHook, 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, 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 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 };