@basou/core 0.15.0 → 0.17.0

package/dist/index.d.ts

@@ -1573,6 +1573,19 @@ type SessionEntry = {
     session: Session;
     suspect: boolean;
     suspectReason: SuspectReason | null;
+    /**
+     * The trail store this entry was read from. Its `sessions` directory locates
+     * the session's `events.jsonl`, so a federated caller can replay events from
+     * the store the session actually lives in (not the local store). For a plain
+     * local load this is the `paths` passed to {@link loadSessionEntries}.
+     */
+    sourceRoot: BasouPaths;
+    /**
+     * Federation host label from the registry (`~/.basou/hosts.yaml`), or `null`
+     * for the local store. Surfaced by orientation so a merged, multi-host view
+     * can attribute the latest session / decision / next-step to its host.
+     */
+    host: string | null;
 };
 /**
  * Per-session degradation reason emitted by {@link loadSessionEntries.onSkip}.
@@ -1595,6 +1608,28 @@ type LoadSessionEntriesOptions = {
     onWarning?: (warning: ReplayWarning, sessionId: string) => void;
     onSkip?: (sessionId: string, reason: SessionSkipReason) => void;
 };
+/**
+ * A trail store to read in a federated load, tagged with its host label.
+ * `host: null` denotes the local store; a non-null label comes from the host
+ * registry (`~/.basou/hosts.yaml`). `paths` is where that store is reachable
+ * as a local path on this machine (an SSHFS mount, an rsync mirror, etc.) —
+ * basou itself never performs any network I/O to obtain it.
+ */
+type FederatedRoot = {
+    paths: BasouPaths;
+    host: string | null;
+};
+type LoadFederatedOptions = LoadSessionEntriesOptions & {
+    /**
+     * Called when a NON-local root cannot be enumerated (present-but-unreadable
+     * mount, permission error). That root is skipped best-effort so the local
+     * store and other roots still load. The local root (`host: null`) is never
+     * degraded here — its errors propagate, preserving single-store behaviour.
+     * (An absent root path is not an error: {@link enumerateSessionDirs} returns
+     * `[]` on ENOENT, so a dropped mount is simply an empty host.)
+     */
+    onRootUnavailable?: (host: string, error: unknown) => void;
+};
 /**
  * List session directory names under `paths.sessions`, ULID ascending.
  *
@@ -1668,20 +1703,18 @@ declare function classifySuspect(paths: BasouPaths, sessionId: string, session:
     suspect: boolean;
     suspectReason: SuspectReason | null;
 }>;
+declare function loadSessionEntries(paths: BasouPaths, options: LoadSessionEntriesOptions): Promise<SessionEntry[]>;
 /**
- * High-level helper that enumerates session dirs, reads each `session.yaml`,
- * and classifies suspect for `running` sessions in one pass.
- *
- * Per-session degradations are surfaced via `options.onSkip`:
- * - `session_yaml_missing` (ENOENT) and `session_yaml_invalid` (parse or
- *   schema violation): the entry is omitted from the result.
- * - `events_jsonl_unreadable`: the entry is still pushed with `suspect=false`
- *   so callers can render the session row plus a CLI-side warning.
- *
- * `options.now` is taken once and threaded into every {@link classifySuspect}
- * call so age comparisons are consistent across sessions.
+ * Federated load across multiple trail stores. Each root's sessions are tagged
+ * with that root's host label and `sourceRoot`, so a caller replays events from
+ * the store the session lives in. De-duped by `sessionId` (a per-host random
+ * ULID), then by `source.external_id` when present — first occurrence wins, so
+ * pass the local root FIRST to keep it authoritative (e.g. over a re-imported
+ * copy of the same vendor session on another host). A non-local root that
+ * cannot be enumerated is reported via `onRootUnavailable` and skipped; the
+ * local root's errors propagate, matching {@link loadSessionEntries}.
  */
-declare function loadSessionEntries(paths: BasouPaths, options: LoadSessionEntriesOptions): Promise<SessionEntry[]>;
+declare function loadFederatedSessionEntries(roots: ReadonlyArray<FederatedRoot>, options: LoadFederatedOptions): Promise<SessionEntry[]>;
 
 type DecisionsRendererInput = {
     paths: BasouPaths;
@@ -3128,6 +3161,71 @@ type SanitizeRelatedFilesResult = {
  */
 declare function sanitizeRelatedFiles(paths: ReadonlyArray<string>, opts: SanitizePathOptions): SanitizeRelatedFilesResult;
 
+/**
+ * Cross-project boundary classification: split a session's `related_files`
+ * into those that resolve INSIDE the project's declared `source_roots` and
+ * those that confidently resolve OUTSIDE all of them.
+ *
+ * Why this exists: the claude-code adapter records every file a transcript
+ * edited, regardless of where the file lives. A session is attributed to a
+ * project by its recorded cwd (the import-time cwd guard), but a session that
+ * legitimately belongs to project A can still have edited files under an
+ * unrelated repo B. Those B paths then surface in `basou orient`'s "recent
+ * files" and can mislead a resuming agent into continuing the wrong project's
+ * work. This helper is the read-only primitive both the import warning and the
+ * orientation advisory use to flag that boundary crossing — it never mutates
+ * the trail.
+ *
+ * Resolution is realpath-aware so a file recorded through a workspace-view
+ * symlink (e.g. `~/projects/foo-workspace/foo -> ../foo`) is NOT mis-flagged as
+ * out-of-root. The bias is deliberately toward NOT crying wolf: a path is only
+ * reported out-of-root when it confidently resolves outside every source root.
+ * Anything that cannot be resolved with confidence stays classified in-root.
+ */
+/**
+ * The agent's / basou's own tooling directories. Edits here (plans, memory,
+ * the trail store itself) are routine infrastructure, not another project's
+ * work, so callers pass these as `extraInRoot` to keep them out of the
+ * cross-project out-of-root flag.
+ */
+declare const AGENT_INFRA_DIRS: readonly string[];
+/** Result of {@link classifyFilesBySourceRoot}: a partition of the input. */
+type SourceRootScope = {
+    /** Entries (verbatim, as passed in) that resolve under a source root, or that could not be resolved with confidence. */
+    inRoot: string[];
+    /** Entries (verbatim) that confidently resolve outside every source root. */
+    outOfRoot: string[];
+};
+/**
+ * Partition `files` into in-root / out-of-root against the project's
+ * `source_roots`.
+ *
+ * - `sourceRoots` are the manifest's `import.source_roots` (relative to
+ *   `masterRoot`). An absent/empty list means "the whole repo root" — matching
+ *   the effective-source-roots rule elsewhere — so a solo project never reports
+ *   anything out-of-root.
+ * - `masterRoot` is the absolute repository root the source roots resolve
+ *   against (the parent of `.basou`).
+ *
+ * Returns `{ inRoot, outOfRoot }` preserving the original entry strings. Empty
+ * input or zero resolvable roots yields everything in-root (no false alarms).
+ */
+declare function classifyFilesBySourceRoot(input: {
+    files: readonly string[];
+    workingDirectory: string;
+    sourceRoots: readonly string[] | null | undefined;
+    masterRoot: string;
+    /**
+     * Extra directories (absolute or `~`-prefixed) that also count as in-root.
+     * Callers pass the agent's own tooling dirs (`~/.claude`, `~/.codex`,
+     * `~/.basou`) so routine plan / memory / store edits are NOT flagged as
+     * another project's work — they are infrastructure, not a cross-project
+     * crossing. Resolved against the home directory, not `masterRoot`.
+     */
+    extraInRoot?: readonly string[];
+    homedir?: string;
+}): Promise<SourceRootScope>;
+
 /** Input contract for {@link renderOrientation} and {@link summarizeOrientation}. */
 type OrientationRendererInput = {
     paths: BasouPaths;
@@ -3155,6 +3253,19 @@ type OrientationRendererInput = {
      * reads as a verdict for a supervisor, not developer diagnostics.
      */
     verbose?: boolean;
+    /**
+     * Additional trail stores to MERGE into this orientation, each a local path
+     * (an SSHFS mount / rsync mirror of another host's `.basou`) tagged with a
+     * host label. Absent / empty = local-only (byte-identical to before). basou
+     * performs no network I/O; the operator's existing tooling places these paths.
+     */
+    federatedRoots?: FederatedRoot[];
+    /**
+     * Called when a federated (non-local) host root is present but cannot be
+     * enumerated (e.g. an unreadable mount). That host is skipped; the local
+     * store and other hosts still render. An absent root path is silently empty.
+     */
+    onHostUnavailable?: (host: string, error: unknown) => void;
 };
 type OrientationRendererResult = {
     /** Generated body. orientation.md is overwritten whole (no markers, gitignored). */
@@ -3171,11 +3282,13 @@ type DecisionRecord = {
     title: string;
     occurredAt: string;
     sessionId: string;
+    host: string | null;
 };
 type NoteRecord = {
     body: string;
     sessionId: string;
     occurredAt: string;
+    host: string | null;
 };
 type PendingApproval = {
     id: string;
@@ -3200,11 +3313,13 @@ type SuspectSession = {
     sessionId: string;
     status: string;
     reason: SuspectReason | null;
+    host: string | null;
 };
 type LatestSession = {
     sessionId: string;
     label: string | null;
     status: string;
+    host: string | null;
 };
 type SourceCount = {
     kind: string;
@@ -3238,10 +3353,19 @@ type OrientationSummary = {
      * step / handoff ("次の起点") surfaced in the forward section; null when none.
      */
     latestNote: NoteRecord | null;
-    /** related_files of the latest session, deduped + sorted + capped at the display limit. */
+    /**
+     * related_files of the latest session, deduped + sorted + capped at the
+     * display limit. `outOfRoot` lists the entries (over the FULL deduped set,
+     * not just `displayed`) that resolve OUTSIDE the project's `source_roots` — a
+     * cross-project boundary crossing worth flagging so a resuming agent does not
+     * mistake another repo's edits for this project's work. Empty unless the
+     * latest session is local (a federated host's source_roots are not loaded
+     * here) and confidently has out-of-root edits.
+     */
     relatedFiles: {
         displayed: string[];
         overflow: number;
+        outOfRoot: string[];
     };
     /** Tasks whose status is `planned` or `in_progress`. */
     inFlightTasks: InFlightTask[];
@@ -3249,6 +3373,12 @@ type OrientationSummary = {
     plannedTasks: PlannedTask[];
     pendingApprovals: PendingApproval[];
     suspects: SuspectSession[];
+    /**
+     * Distinct non-local host labels present in the merged set (sorted). Empty
+     * for a local-only orientation. Lets a consumer render the multi-host banner
+     * and the local-only-freshness caveat without re-deriving from sessions.
+     */
+    hosts: string[];
     freshness: {
         /** started_at of the newest non-archived session, or null when none captured. */
         newestStartedAt: string | null;
@@ -5324,4 +5454,4 @@ declare function overwriteYamlFile(filePath: string, value: unknown): Promise<vo
  */
 declare const BASOU_CORE_VERSION = "0.1.0";
 
-export { ACTIVE_GAP_CAP_MS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_VERSION, type BasouPaths, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, 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 FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type 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 ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildStatusSnapshot, chainEvents, chainRawJsonLines, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, finalizeSessionYaml, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };
+export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_VERSION, type BasouPaths, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type 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 ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildStatusSnapshot, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, finalizeSessionYaml, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };