@basou/core 0.41.0 → 0.42.0

package/dist/index.d.ts

@@ -271,6 +271,16 @@ declare const SessionInnerImportSchema: z.ZodObject<{
  * --format json`. The top level is `.strict()`; unknown keys at the outer
  * envelope are rejected.
  */
+/**
+ * The only import envelope version the importer accepts. The published JSON
+ * Schema pins it as a `const` and the runtime gate compares against it, so the
+ * portable contract and the implementation cannot drift: a third party who
+ * validates a payload against the published artifact gets the same answer the
+ * importer will give, instead of passing validation and being rejected at run
+ * time. Unrelated to the events INSIDE the envelope, which carry their own
+ * `schema_version` and are at 0.2.0.
+ */
+declare const SESSION_IMPORT_SCHEMA_VERSION: "0.1.0";
 declare const SessionImportPayloadSchema: z.ZodObject<{
     schema_version: z.ZodString;
     session: z.ZodObject<{
@@ -425,7 +435,7 @@ declare const SessionImportPayloadSchema: z.ZodObject<{
         exit_code: z.ZodNullable<z.ZodNumber>;
         signal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         received_signal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        duration_ms: z.ZodNumber;
+        duration_ms: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         schema_version: z.ZodString;
         id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -681,7 +691,8 @@ type ClaudeTranscriptToPayloadOptions = {
  *   decisions.md / orientation's latest-decision surface).
  *
  * Exit codes and per-command durations are not present in the transcript, so
- * `command_executed.exit_code` is `null` and `duration_ms` is `0`.
+ * `command_executed.exit_code` and `duration_ms` are both `null` — basou
+ * observed neither.
  *
  * Returns `null` when the transcript has no timestamped records, or no
  * observable command / file / decision action — such sessions carry no
@@ -1165,6 +1176,25 @@ declare function enumerateApprovals(paths: BasouPaths): Promise<{
  */
 declare function isLazyExpired(approval: Approval, now: Date): boolean;
 
+/**
+ * `schema_version` stamped on NEWLY WRITTEN events. Bumped to 0.2.0 when
+ * `command_executed.duration_ms` became nullable, which widened the field's
+ * domain and so is a breaking change to the format.
+ *
+ * The bump does not change what any value already on disk means: `0` meant "not
+ * observed" before and still does. What changes is that a writer now says so
+ * with `null` instead of storing the floor, and never writes `0` at all. So the
+ * read rule needs no version branch (it lives in `observed-duration.ts` as
+ * `readObservedDuration`), and the
+ * version is a statement about validation, not about interpretation.
+ *
+ * Reading is unaffected — {@link SchemaVersionSchema} accepts any 0.x.y — so
+ * events already on disk keep validating, and are not rewritten in place (a
+ * session IS re-derived, and restamped, when its source log grows). Only EVENTS
+ * carry this version: the other `.basou/` documents did not change, so their
+ * `schema_version` stays 0.1.0.
+ */
+declare const EVENT_SCHEMA_VERSION: "0.2.0";
 declare const SessionStartedEventSchema: z.ZodObject<{
     schema_version: z.ZodString;
     id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -1265,7 +1295,7 @@ declare const CommandExecutedEventSchema: z.ZodObject<{
     exit_code: z.ZodNullable<z.ZodNumber>;
     signal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     received_signal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    duration_ms: z.ZodNumber;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 declare const GitSnapshotEventSchema: z.ZodObject<{
     schema_version: z.ZodString;
@@ -1575,7 +1605,7 @@ declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     exit_code: z.ZodNullable<z.ZodNumber>;
     signal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     received_signal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    duration_ms: z.ZodNumber;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     schema_version: z.ZodString;
     id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -1823,6 +1853,12 @@ type AdapterOutputEvent = z.infer<typeof AdapterOutputEventSchema>;
  * the unterminated tail parsed as a complete event. The line is dropped
  * instead of yielded so consumers cannot accidentally observe a
  * partially-written record.
+ *
+ * `retired_zero_duration` is ADVISORY: the line is valid and IS yielded. It
+ * reports a `command_executed` carrying `duration_ms: 0` on an event version
+ * whose writers never produce one, which no basou writer can create (they are
+ * guarded) but a third party using this package's writers, or another host
+ * reached through the federation reader, could. See `hasRetiredZeroDuration`.
  */
 type ReplayWarning = {
     kind: "partial_trailing_line";
@@ -1835,6 +1871,9 @@ type ReplayWarning = {
     kind: "schema_violation";
     line: number;
     cause: unknown;
+} | {
+    kind: "retired_zero_duration";
+    line: number;
 };
 type ReplayOptions = {
     /**
@@ -5590,11 +5629,31 @@ type WorkspaceViewPlan = {
 declare function planWorkspaceView(facts: ViewRepoFact[], existing?: ExistingViewLink[], rosterNames?: string[]): WorkspaceViewPlan;
 
 /**
- * Schema version of the on-disk Basou v0.1 formats these JSON Schemas describe.
- * It tracks {@link SchemaVersionSchema} (the `schema_version` field), NOT the
- * npm package version, so the `$id` URLs stay stable while the package moves.
- */
-declare const JSON_SCHEMA_VERSION = "0.1.0";
+ * `schema_version` of each on-disk format, keyed by artifact basename.
+ *
+ * Per document, not workspace-wide: the formats version independently, so one
+ * of them changing must not move the `$id` of the others. It tracks
+ * {@link SchemaVersionSchema} (the `schema_version` field a writer stamps on
+ * that document), NOT the npm package version, so a document's `$id` stays
+ * stable while the package moves.
+ *
+ * The version a document is listed under is the version its WRITERS stamp, so
+ * the published `$id` and the `schema_version` inside the same artifact always
+ * agree. `session-import` is the case worth naming: its envelope still stamps
+ * (and its importer still requires) `0.1.0`, while the events it carries are
+ * individually versioned and now include `0.2.0` ones — so the envelope's bytes
+ * changed without the envelope's own format changing.
+ */
+declare const JSON_SCHEMA_VERSIONS: {
+    readonly manifest: "0.1.0";
+    readonly session: "0.1.0";
+    readonly event: "0.2.0";
+    readonly task: "0.1.0";
+    readonly approval: "0.1.0";
+    readonly status: "0.1.0";
+    readonly "task-index": "0.1.0";
+    readonly "session-import": "0.1.0";
+};
 /** One emitted JSON Schema artifact. */
 type JsonSchemaArtifact = {
     /** Artifact basename without extension (e.g. `session`). */
@@ -5606,8 +5665,9 @@ type JsonSchemaArtifact = {
  * Build the published JSON Schema artifacts from the canonical Zod schemas.
  *
  * Pure: no disk or environment access. Each artifact is `z.toJSONSchema` of the
- * document schema, re-headed with a stable `$id` / `title` / `description` (the
- * draft `$schema` from zod is preserved). This is the single generator used by
+ * document schema, re-headed with an `$id` carrying that document's own
+ * {@link JSON_SCHEMA_VERSIONS} entry, plus `title` / `description` (the draft
+ * `$schema` from zod is preserved). This is the single generator used by
  * both the `gen:schemas` script (which writes the committed files) and the
  * drift-guard test (which asserts the committed files still match), so the two
  * can never disagree.
@@ -5629,6 +5689,83 @@ declare function buildJsonSchemas(): JsonSchemaArtifact[];
  * compare byte-for-byte. */
 declare function serializeJsonSchema(schema: Record<string, unknown>): string;
 
+/**
+ * The duration a `command_executed` event actually OBSERVED, in milliseconds,
+ * or `null` when it observed none.
+ *
+ * This is the single implementation of the read rule stated in
+ * `docs/spec/schemas.md` §7.3. Every reader of `duration_ms` goes through it
+ * instead of reading the field directly, so the rule cannot hold in one surface
+ * and lapse in another.
+ *
+ * The rule needs no `schema_version` branch, because `0` means the same thing
+ * on every version:
+ *
+ * - Under `0.1.0` the field could not be null, so a writer with nothing to
+ *   report stored `0` as the floor. Every command imported from a Claude Code
+ *   transcript, which carries no timing at all, was written that way.
+ * - From `0.2.0` a writer records `null` instead and never writes `0` (see
+ *   {@link writeObservedDuration} and {@link hasRetiredZeroDuration}), so the
+ *   value survives only on events already on disk. Those are not rewritten in
+ *   place — that would break the tamper-evidence chain — though a session whose
+ *   source log grows is re-derived, which restamps its events at the current
+ *   version. A session whose source is gone keeps its 0.1.0 lines indefinitely.
+ * - A `0` from any other writer is read the same way. A spawned process cannot
+ *   have run in under half a millisecond: `fork` + `exec` alone costs more, and
+ *   `Math.round` collapses anything below that anyway. So `0` is not a
+ *   duration a command can have had, whoever wrote it.
+ */
+declare function readObservedDuration(ev: CommandExecutedEvent): number | null;
+/**
+ * A measured duration as it should be WRITTEN: the measurement itself, or
+ * `null` when there was nothing to observe.
+ *
+ * The counterpart of {@link readObservedDuration}, so the two halves of the
+ * convention live side by side.
+ *
+ * A non-positive measurement is not an observation of a command. A spawn costs
+ * real time — measured on one host, 40 of 40 `/usr/bin/true` spawns took over
+ * 0.5ms (minimum 0.75ms, median 0.83ms) — and basou's own live capture times it
+ * on a monotonic sub-millisecond clock, so a real spawn rounds to at least 1ms.
+ * A zero or negative value therefore means the measurement itself is not
+ * usable, not that the command ran instantly, and basou reports no duration it
+ * cannot back.
+ *
+ * This depends on the caller measuring at sub-millisecond resolution. Taking
+ * the difference of two whole-millisecond wall-clock readings does NOT
+ * qualify: a 0.8ms spawn lands on 0 or 1 depending only on where in the
+ * millisecond it started, and 5 of those same 40 runs came out 0 that way —
+ * which this function would then report as unobserved. `ChildProcessRunner`
+ * measures with {@link performance.now} for exactly that reason.
+ *
+ * The paths where nothing was timed at all (a spawn that failed before the
+ * child ran, a run interrupted early) write null directly and do not come
+ * through here.
+ */
+declare function writeObservedDuration(measuredMs: number | null): number | null;
+/**
+ * Event `schema_version` from which writers stopped emitting
+ * `command_executed.duration_ms: 0` and record `null` instead.
+ */
+declare const ZERO_DURATION_RETIRED_SINCE: "0.2.0";
+/**
+ * Whether this event carries a `duration_ms` of `0` that its OWN version says
+ * no writer should have produced.
+ *
+ * This is NOT the read rule. {@link readObservedDuration} treats `0` as
+ * unobserved on every version and needs no version branch; this is a
+ * data-quality check on top of it, and it is the only thing that makes the
+ * 0.2.0 bump verifiable. Without it the invariant "a 0.2.0 writer never emits
+ * 0" is a promise no code checks: the schema still accepts `0` (0.1.0 events
+ * carrying it are on disk and must keep validating), so a future code path, or
+ * a third party using this package's writers, could put one there and the read
+ * rule would silently reinterpret it.
+ *
+ * A `0` on a pre-0.2.0 event is expected and not flagged: that was the floor a
+ * writer stored when it had nothing to report.
+ */
+declare function hasRetiredZeroDuration(ev: Event): boolean;
+
 /**
  * The `.basou` on-disk format version, of the form `MAJOR.MINOR.PATCH`.
  *
@@ -5745,8 +5882,18 @@ type MeasureAvailability = {
     /** Always true (started_at + now bound the span). */
     span: boolean;
     /**
-     * `commandTimeMs` reflects real shell time. False for `claude-code-import`,
-     * whose transcript carries no per-command duration (recorded as 0).
+     * `commandTimeMs` rests on at least one real observation: this session
+     * observed a duration for at least one command, or its whole event stream was
+     * read and shows it ran no commands (0ms is then the truth). False when it
+     * ran commands and none was timed, and false when the stream was incomplete —
+     * unreadable, or with lines dropped as malformed / schema-invalid — since
+     * "ran no commands" is then unbacked.
+     *
+     * True does NOT mean every command was timed. When only some were,
+     * `commandTimeMs` is a FLOOR and this flag does not say so — one boolean
+     * cannot carry "all", "some" and "none". Measured 2026-09-10: 292 of 818
+     * importable codex rollouts are partly timed, at 15.1% of commands overall.
+     * Compare `commandCount` if the difference matters to the caller.
      */
     commandTime: boolean;
     /** At least one active interval could be measured (stored or event-derived). */
@@ -5824,7 +5971,8 @@ type SourceWorkStats = {
     decisionCount: number;
     eventCount: number;
     tokens: TokenTotals;
-    /** Every session of this kind reports real command time. */
+    /** Every session of this kind has a real `commandTimeMs` (see
+     * {@link MeasureAvailability.commandTime}); one untimed session clears it. */
     commandTimeReliable: boolean;
     /** At least one session of this kind captured token totals. */
     tokensAvailable: boolean;
@@ -5882,7 +6030,8 @@ type WorkStatsTotals = {
     decisionCount: number;
     eventCount: number;
     tokens: TokenTotals;
-    /** No `claude-code-import` sessions present, so command time is workspace-wide real. */
+    /** Every session's `commandTimeMs` is a real measurement, so the workspace
+     * total is too (see {@link MeasureAvailability.commandTime}). */
     commandTimeReliable: boolean;
     tokensAvailable: boolean;
     /** At least one session captured model compute time (`machine_active_time_ms`). */
@@ -5919,8 +6068,9 @@ type WorkStatsResult = {
  *   produced few tool calls is still counted; idle gaps over `ACTIVE_GAP_CAP_MS`
  *   (5 min) are not credited. Live sessions and pre-v2 imports lack that signal
  *   and fall back to the action-event stream (`activeTimeBasis: "events"`).
- * - `sessionSpanMs` overcounts (includes idle) and `commandTimeMs` is
- *   shell-execution only (0 for `claude-code-import`); both are kept as context.
+ * - `sessionSpanMs` overcounts (includes idle) and `commandTimeMs` counts only
+ *   the shell time a source actually reported (nothing for `claude-code-import`,
+ *   whose transcript carries no timing); both are kept as context.
  *
  * The per-day view buckets the union intervals by `timeZone` (logs are UTC, so
  * a billing day needs an explicit zone). A union interval crossing local
@@ -5936,7 +6086,14 @@ declare function computeWorkStats(input: WorkStatsInput): Promise<WorkStatsResul
  * and exported so a single-session surface (e.g. `basou session show`) can
  * reuse the exact same measures the workspace aggregator produces.
  */
-declare function sessionWorkStatsFromEvents(sessionId: string, inner: Session["session"], events: ReadonlyArray<Event>, now: Date, eventsUnreadable?: boolean): SessionWorkStats;
+declare function sessionWorkStatsFromEvents(sessionId: string, inner: Session["session"], events: ReadonlyArray<Event>, now: Date, eventsUnreadable?: boolean, 
+/**
+ * A line of `events.jsonl` was read but could not be used (malformed JSON or
+ * a schema violation), so the stream is incomplete in a way replay cannot
+ * see. A half-flushed trailing line does not count: that is the normal tail
+ * of a live session.
+ */
+eventsLostLines?: number): SessionWorkStats;
 
 type ReportRendererInput = {
     paths: BasouPaths;
@@ -6478,6 +6635,16 @@ type RunResult = {
     readonly started_at: string;
     /** ISO 8601 timestamp captured on the `close` event. */
     readonly ended_at: string;
+    /**
+     * Elapsed time on a monotonic sub-millisecond clock, rounded to whole
+     * milliseconds — NOT `ended_at - started_at`, and not required to equal it:
+     * those two are whole-millisecond wall-clock captures, and measured, 7 of 40
+     * `/usr/bin/true` runs disagreed with their difference. The monotonic basis
+     * is what keeps a sub-millisecond spawn from rounding to `0`, which callers
+     * record as "no duration observed". One consequence on macOS: this clock
+     * does not advance across a system sleep, so a command spanning a suspend
+     * reports less than the wall interval it covered.
+     */
     readonly duration_ms: number;
     readonly pid: number | null;
 };
@@ -6985,4 +7152,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 CodexHooksFile, 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, 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, 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, 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, findErrorCode, findReviewGaps, findUnbindableRepos, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, instructionMode, isBasouSessionStartHookCommand, 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, 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, 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 CodexHooksFile, 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, 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, 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, SESSION_IMPORT_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, 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, 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, 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 };