@basou/core 0.31.0 → 0.33.0

package/dist/index.d.ts

@@ -1747,6 +1747,141 @@ declare function replayEvents(sessionDir: string, options?: ReplayOptions): Asyn
  */
 declare function readAllEvents(sessionDir: string, options?: ReplayOptions): Promise<Event[]>;
 
+/**
+ * The language of the GENERATED-VIEW chrome (headings, labels, verdict prose)
+ * in handoff.md / orientation.md / decisions.md / report output.
+ *
+ * This is deliberately narrower than the manifest's repo `language` axis
+ * (`en | ja | en+ja`): a generated view has exactly one chrome language, so
+ * `en+ja` resolves to `en`. User data (decision titles, notes, labels, file
+ * paths) always passes through verbatim — only the tool-generated strings are
+ * localized, which is exactly the split this type exists to keep honest.
+ */
+type ViewLanguage = "en" | "ja";
+/**
+ * Resolve the generated-view language from a manifest: the workspace speaks
+ * the language of its ANCHOR repo (the `repos[]` entry whose path is `.`).
+ *
+ * Rules (fixed by design):
+ * - anchor declares `ja`            -> `ja`
+ * - anchor declares `en` / `en+ja`  -> `en` (a bilingual surface renders one
+ *   chrome; en is the shared floor)
+ * - no roster / no anchor entry / no declared language -> `en` (the default
+ *   for basou's English-first OSS surface)
+ *
+ * Binding the view to the anchor's language is a deliberate, documented
+ * coupling: the anchor is the planning/trail home the views live in, so its
+ * declared audience is the views' audience. Other repos' languages do not
+ * participate.
+ */
+declare function resolveViewLanguage(manifest: Pick<Manifest, "repos"> | null): ViewLanguage;
+/**
+ * Manifest-reading convenience for the renderers: resolve the view language
+ * for a workspace, defaulting to `en` when the manifest is missing or
+ * unreadable (mirrors the orientation renderer's tolerant source_roots read —
+ * a broken manifest must never break a view render).
+ */
+declare function resolveViewLanguageFromPaths(paths: BasouPaths): Promise<ViewLanguage>;
+/**
+ * Every localized string the four view renderers emit, grouped per renderer
+ * with a small `common` set for lines that are byte-identical across views.
+ * Parameterized lines are functions so the two languages can order their
+ * parts naturally.
+ *
+ * This module is the SINGLE home for generated-view Japanese (the E-5
+ * language-lint allowlist points here, not at the renderers), so "user data
+ * language" and "tool chrome language" can never blur together again.
+ */
+type ViewStrings = {
+    /** Localized relative age for prose lines, e.g. "3日4時間前" / "3d 4h ago". */
+    relativeAge: (startedAt: string | null, now: Date) => string;
+    common: {
+        /** "最終 session" — the latest live session pointer. */
+        lastSessionLabel: string;
+        /** "直近の判断" — the latest recorded decision pointer. */
+        latestDecisionLabel: string;
+        /** "直近の変更ファイル" — the latest session's related files. */
+        recentFilesLabel: string;
+        /** "理由" — a track's rationale label. */
+        trackWhyLabel: string;
+        /** Note that the latest decision comes from a different session. */
+        decisionOtherSessionNote: (shortSessionId: string) => string;
+    };
+    orientation: {
+        headingWhere: string;
+        headingRecent: (sessionCount: number) => string;
+        headingInFlight: string;
+        headingForward: string;
+        headingCurrency: string;
+        inFlightTasksHeading: (n: number) => string;
+        pendingApprovalsHeading: (n: number) => string;
+        suspectSessionsHeading: (n: number) => string;
+        openTracksHeading: (n: number) => string;
+        /** Stale-decision honesty note under 直近の判断. */
+        decisionStaleNote: (activityAge: string) => string;
+        outOfRootWarning: (count: number, files: string) => string;
+        recentEmpty: string;
+        recentDecisionsLabel: string;
+        recentNextStepLabel: string;
+        recentChangedLabel: string;
+        trackCloseInstruction: string;
+        nextStepRecordedLabel: (age: string) => string;
+        noteStaleNote: (activityAge: string) => string;
+        fallbackStaleDirection: string;
+        fallbackStaleReferenceLabel: string;
+        trackNudge: string;
+        federatedFreshnessNote: string;
+        bannerUnverifiable: (n: number) => string;
+        bannerStale: (parts: string) => string;
+        partNew: (n: number) => string;
+        partUpdated: (n: number) => string;
+        partsJoiner: string;
+        verdictUnverifiable: (n: number) => [string, string];
+        verdictStale: (parts: string) => [string, string];
+        verdictUpdatedOnly: (n: number) => [string, string];
+        verdictSuspectsAlso: (n: number) => string;
+        verdictEmpty: [string, string];
+        verdictUnprobed: (rel: string, tool: string) => [string, string];
+        verdictCurrent: (rel: string, tool: string, hasHosts: boolean) => string;
+        verdictSuspectsCaveat: (n: number) => string;
+        verdictScopeDisclaimer: string;
+        toolTerminal: string;
+        toolHuman: string;
+        toolImport: string;
+        toolUnknown: string;
+    };
+    handoff: {
+        headingCurrentState: string;
+        headingRecentFiles: string;
+        headingLatestDecision: string;
+        headingOpenTracks: string;
+        headingUnresolved: string;
+        headingReadNext: string;
+        headingNextWork: string;
+        headingSessions: string;
+        lastTaskLabel: string;
+        decisionStaleNote: string;
+        trackCloseInstruction: string;
+    };
+    decisions: {
+        dateLabel: string;
+        trackKindLine: string;
+        decisionLabel: string;
+    };
+    report: {
+        headingSummary: string;
+        headingVolume: string;
+        headingDecisions: string;
+        headingApprovals: string;
+        headingTasks: string;
+        headingChangedFiles: string;
+        headingSessions: string;
+        headingIntegrity: string;
+    };
+};
+/** Look up the string table for a resolved view language. */
+declare function viewStrings(language: ViewLanguage): ViewStrings;
+
 /** Session lifecycle states. */
 declare const SessionStatusSchema: z.ZodEnum<{
     initialized: "initialized";
@@ -2077,6 +2212,12 @@ type DecisionsRendererInput = {
     nowIso: string;
     onWarning?: (warning: ReplayWarning, sessionId: string) => void;
     onSessionSkip?: (sessionId: string, reason: SessionSkipReason) => void;
+    /**
+     * Generated-view chrome language. Omitted (the normal path) = resolved from
+     * the manifest's anchor repo via {@link resolveViewLanguageFromPaths}; the
+     * override exists for tests and programmatic callers that already resolved it.
+     */
+    language?: ViewLanguage;
 };
 type DecisionsRendererResult = {
     /** Generated body WITHOUT BASOU:GENERATED markers. */
@@ -3343,6 +3484,12 @@ type HandoffRendererInput = {
     onTaskSkip?: (taskId: string, reason: TaskSkipReason) => void;
     /** Maximum related_files entries to display before `... +N more`. Default 20. */
     relatedFilesLimit?: number;
+    /**
+     * Generated-view chrome language. Omitted (the normal path) = resolved from
+     * the manifest's anchor repo via {@link resolveViewLanguageFromPaths}; the
+     * override exists for tests and programmatic callers that already resolved it.
+     */
+    language?: ViewLanguage;
 };
 type HandoffRendererResult = {
     /** Generated body WITHOUT BASOU:GENERATED markers (markdown-store wraps them). */
@@ -3353,7 +3500,7 @@ type HandoffRendererResult = {
     suspectCount: number;
     /** Total number of task.md files successfully loaded. */
     taskCount: number;
-    /** Tasks whose status is `planned` or `in_progress` (= shown in 次に実行すべき作業). */
+    /** Tasks whose status is `planned` or `in_progress` (= shown in the next-work section). */
     pendingTaskCount: number;
 };
 /**
@@ -3363,16 +3510,16 @@ type HandoffRendererResult = {
  * {@link loadSessionEntries} / {@link enumerateApprovals}). It assembles the
  * the spec's `handoff.md` sections in order:
  *
- * 1. `現在の状態`: latest live session (status not archived, source not import).
- * 2. `直近の変更ファイル`: the most recent session's `related_files`, dedup +
+ * 1. Current state: latest live session (status not archived, source not import).
+ * 2. Recently changed files: the most recent session's `related_files`, dedup +
  *    sorted asc + truncated to `relatedFilesLimit` (default 20).
- * 3. `直近の判断`: latest `decision_recorded` event (chronological).
- * 4. `未決事項`: pending-approval count + suspect-session count.
- * 5. `次に読むべきファイル`: `.basou/decisions.md` + top-3 related files
+ * 3. Latest decision: latest `decision_recorded` event (chronological).
+ * 4. Unresolved items: pending-approval count + suspect-session count.
+ * 5. Files to read next: `.basou/decisions.md` + top-3 related files
  *    (the same `displayedFiles` source is intentionally reused in two
  *    sections — overview vs. resume context).
- * 6. `次に実行すべき作業`: placeholder until task events land.
- * 7. `セッション一覧`: all sessions newest first with inline suspect labels.
+ * 6. Work to do next: placeholder until task events land.
+ * 7. Sessions: all sessions newest first with inline suspect labels.
  *
  * Session enumeration goes through {@link loadSessionEntries} so the set of
  * sessions whose `decision_recorded` events we replay matches the
@@ -3595,7 +3742,7 @@ type OrientationRendererInput = {
     /**
      * Result of a read-only dry-run staleness probe (sessions a `basou refresh`
      * would add or update), computed by the CLI which holds the import context.
-     * Drives the plain "これは最新か" verdict. `null` / omitted = not probed, so
+     * Drives the plain "is this current" verdict. `null` / omitted = not probed, so
      * the verdict says it cannot confirm freshness rather than claiming current.
      */
     staleness?: {
@@ -3609,6 +3756,12 @@ type OrientationRendererInput = {
      * reads as a verdict for a supervisor, not developer diagnostics.
      */
     verbose?: boolean;
+    /**
+     * Generated-view chrome language. Omitted (the normal path) = resolved from
+     * the manifest's anchor repo via {@link resolveViewLanguageFromPaths}; the
+     * override exists for tests and programmatic callers that already resolved it.
+     */
+    language?: ViewLanguage;
     /**
      * 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
@@ -3664,8 +3817,8 @@ type NoteRecord = {
     host: string | null;
 };
 /**
- * One recent session condensed to its direction signal, for the "最近の流れ"
- * (recent direction) section. Across the last N non-archived sessions
+ * One recent session condensed to its direction signal, for the "recent
+ * direction" section. Across the last N non-archived sessions
  * (newest first), this surfaces the ARC of recent intent — the decision titles
  * and next-step notes recorded in EACH session — rather than orientation's
  * single latest decision/note, which can be stale or missing. When a session
@@ -3748,7 +3901,7 @@ type OrientationSummary = {
     decisionCount: number;
     /**
      * Open (non-voided) `kind: "track"` decisions — strategic, unfinished
-     * directions that the forward section ("どこへ向かう") resurfaces every session
+     * directions that the forward section ("where you are heading") resurfaces every session
      * until they are closed with `decision void` / supersede. Newest first. This
      * is the intent-continuity layer: distinct from the single latest decision
      * (point-in-time) and the recorded next step (`note`), an open track keeps
@@ -3758,12 +3911,12 @@ type OrientationSummary = {
     openTracks: TrackRecord[];
     /**
      * Most recent `note_added` over non-archived sessions — the recorded next
-     * step / handoff ("次の起点") surfaced in the forward section; null when none.
+     * step / handoff ("next step") surfaced in the forward section; null when none.
      */
     latestNote: NoteRecord | null;
     /**
      * The last N non-archived sessions (newest first) condensed to their direction
-     * signal — the "最近の流れ" (recent direction) arc. Distinct from the single
+     * signal — the "recent direction" arc. Distinct from the single
      * latest decision/note: it shows the trajectory of intent across recent
      * sessions, and falls back to each session's changed files when no decision or
      * note was captured, so a resuming agent has grounding even when explicit
@@ -3844,6 +3997,62 @@ declare function summarizeOrientation(input: OrientationRendererInput): Promise<
  */
 declare function renderOrientation(input: OrientationRendererInput): Promise<OrientationRendererResult>;
 
+/**
+ * The anchor (planning master) repo's own AGENTS.md STARTER. Unlike a repo's
+ * preset block or the workspace view's canonical — both marker-managed regions
+ * that `basou project preset` keeps in sync — the anchor's own AGENTS.md is
+ * HAND-MAINTAINED by design (preset deliberately skips the anchor, and its
+ * canonical lives at the anchor root, never under `agents/`). A greenfield
+ * bring-up (`basou project new` → declare → `basou project derive`) therefore
+ * leaves the planning master with no conventions doc at all, while every project
+ * onboarded the older way carries one from the start.
+ *
+ * This renders a MINIMAL starter so a greenfield anchor is not empty: identity,
+ * commit-routing, per-repo AGENTS.md pointers, a pointer to the workspace view
+ * for the LIVE roster, and TODO stubs for the policy basou cannot derive
+ * (product facts, phase, secrets, language policy). It is meant to be written
+ * ONCE if the file is absent and NEVER touched again (create-only, no
+ * BASOU:GENERATED markers) — the operator owns and hand-maintains it thereafter,
+ * preserving the anchor's hands-off design.
+ *
+ * It deliberately does NOT embed a roster snapshot table: a manifest-derived
+ * table frozen into a markerless, never-resynced file would drift silently the
+ * moment a repo is added / renamed / archived, with no staleness signal for a
+ * reader (or an agent) that trusts it. The live roster lives in the workspace
+ * view's own generated AGENTS.md, which stays in sync; the anchor points there.
+ *
+ * Pure and deterministic: it renders markdown from the declared fields only, so
+ * the output is a function of the manifest snapshot at seed time. It embeds no
+ * operator-specific string beyond the declared repo names / project name.
+ */
+/** One roster repo referenced by the anchor starter's per-repo pointers. */
+type AnchorStarterRepo = {
+    /** The repo's display name (its on-disk basename). */
+    name: string;
+    /** True when this repo IS the anchor (the planning master itself; excluded from the pointers). */
+    anchor?: boolean | undefined;
+};
+/** The declared fields the anchor starter is rendered from. */
+type AnchorStarterInput = {
+    /** The anchor repo's display name (its on-disk basename) — names the file heading. */
+    anchorName: string;
+    /** `manifest.project.name`, when declared — used in the identity line. */
+    projectName?: string | undefined;
+    /** The workspace view's directory basename, when the project has a view. */
+    viewName?: string | undefined;
+    /** The declared roster (the anchor included), in declared order. */
+    repos: AnchorStarterRepo[];
+};
+/**
+ * Render the anchor's starter AGENTS.md (a full file, NOT a marker block). The
+ * manifest-derived parts (identity, per-repo pointers) are filled from the
+ * declaration; everything basou cannot know (product facts, phase, secrets,
+ * language policy) is left as an explicit `<!-- TODO -->` for the operator. The
+ * live roster is NOT snapshotted here — the file points at the workspace view's
+ * generated AGENTS.md for it. Returns the file content WITH a trailing newline.
+ */
+declare function renderAnchorStarter(input: AnchorStarterInput): string;
+
 /**
  * Project roster drift (the "saddle" model). A project's repos are DECLARED
  * once in the manifest's `repos` list; the capture config (`source_roots`) must
@@ -4184,6 +4393,48 @@ declare function isRenderable(repo: PresetRepo): boolean;
  * writer adds the surrounding structure.
  */
 declare function renderPresetBlock(repo: PresetRepo): string;
+/** One repo aggregated by the view, rendered with its short visibility / language. */
+type ViewPresetRepo = {
+    name: string;
+    visibility?: RepoVisibility | undefined;
+    language?: RepoLanguage | undefined;
+    /**
+     * True when the repo declares `instructions: self` (it owns its AGENTS.md;
+     * basou stays hands-off). Rendered in the instruction-ownership column so an
+     * agent reading the view knows which AGENTS.md files are generated and which
+     * are hand-maintained. Absent => the default `hub` (basou-generated).
+     */
+    self?: boolean | undefined;
+    /**
+     * True when this repo IS the project anchor (the planning master). Its own
+     * AGENTS.md is hand-maintained at the anchor root — basou never generates it
+     * (preset skips it), so the instruction column must NOT claim `hub`. Takes
+     * precedence over `self` in the label.
+     */
+    anchor?: boolean | undefined;
+};
+/** The declared fields the view preset block is rendered from. */
+type ViewPresetInput = {
+    /**
+     * The view directory's basename — names the view's own canonical
+     * (`agents/<viewName>/AGENTS.md`) in the block's self-description, so a reader
+     * of the generated file learns where its editable source of truth lives.
+     */
+    viewName: string;
+    repos: ViewPresetRepo[];
+};
+/**
+ * Render the workspace-view instruction-file preset block (the content between
+ * the BASOU:GENERATED markers in the view's own canonical). Like
+ * {@link renderPresetBlock} it is deterministic and OSS-generic: it derives
+ * entirely from the declared roster (repo names come from the manifest, no
+ * operator-specific string is embedded), so re-running on an unchanged manifest
+ * produces byte-identical output. The repos are listed in the order supplied.
+ * An empty roster still renders cleanly (a header-only table, empty lists).
+ * Returns the block WITHOUT a trailing newline; the marker writer adds the
+ * surrounding structure.
+ */
+declare function renderViewPresetBlock(input: ViewPresetInput): string;
 /**
  * The canonical's marker state as parsed by the caller (mirrors
  * `markdown-store`'s `MarkerSection.kind`). `ok` means exactly one well-ordered
@@ -4257,6 +4508,13 @@ type PresetMarkerConflict = {
 type PresetCollision = {
     canonicalName: string;
     repos: string[];
+    /**
+     * True when the shared canonical is the WORKSPACE VIEW's own
+     * (`agents/<viewName>/AGENTS.md`): the listed repo(s) collide with the view,
+     * not (only) with each other, so neither the repo side nor the view side is
+     * generated. Absent for a plain repo↔repo collision.
+     */
+    view?: boolean;
 };
 type PresetPlanSummary = {
     /** Repos whose canonical's generated region will be created/updated (only those with work). */
@@ -4301,8 +4559,15 @@ type PresetPlanSummary = {
  * - Two DISTINCT repos resolving to the same canonical name are a
  *   {@link PresetCollision} and neither is generated (silent clobbering of one
  *   canonical is surfaced, not actioned).
- */
-declare function summarizePresetPlan(facts: RepoPresetFacts[]): PresetPlanSummary;
+ * - When the caller passes `opts.viewCanonicalName` (the workspace view's own
+ *   canonical name), a repo whose canonical name equals it is ALSO a collision
+ *   (flagged `view: true`) and is suppressed — the repo and the view would
+ *   otherwise write over one shared `agents/<name>/AGENTS.md`. Without the
+ *   option the behavior is unchanged.
+ */
+declare function summarizePresetPlan(facts: RepoPresetFacts[], opts?: {
+    viewCanonicalName?: string;
+}): PresetPlanSummary;
 
 /**
  * Rename (re-path) a repo in a project's declared roster. When a repo's
@@ -4423,6 +4688,13 @@ type RetrofitReason =
  | "blocked"
 /** refuse: the destination canonical already exists (relocating would clobber it). */
  | "canonical-exists"
+/**
+ * refuse: the repo's canonical name equals the workspace view's, so
+ * `agents/<name>/AGENTS.md` would be owned by BOTH — relocating the repo's
+ * file into it (and later generating the view block over it) would corrupt
+ * one with the other. The operator renames the view directory or the repo.
+ */
+ | "view-collision"
 /** skip: AGENTS.md is already a symlink (likely already wired — idempotent). */
  | "already-symlink"
 /** skip: there is no AGENTS.md to relocate. */
@@ -4445,6 +4717,13 @@ type RetrofitFacts = {
     reachable: boolean;
     /** The repo basename used for the anchor canonical `agents/<canonicalName>/AGENTS.md`. */
     canonicalName: string;
+    /**
+     * The workspace view's own canonical name (`agents/<viewCanonicalName>/AGENTS.md`),
+     * when a view is declared. A repo whose `canonicalName` equals it shares ONE
+     * canonical file with the view, so the relocate is refused (`view-collision`).
+     * Absent (no view declared) => no collision possible.
+     */
+    viewCanonicalName?: string | undefined;
     /** On-disk state of the repo's own `AGENTS.md`. */
     agentsState: RetrofitAgentsState;
     /** True when the destination canonical already exists (moving would clobber it). */
@@ -4475,9 +4754,11 @@ type RetrofitPlan = {
  * apply: undeclared → anchor → self → unreachable → uninspectable AGENTS.md. Then
  * the idempotent skips (already a symlink, or absent — nothing to move). Only a
  * genuine regular-file AGENTS.md reaches the relocate decision, and even then a
- * pre-existing destination canonical refuses (relocating would clobber it).
- * `regularSpokes` is echoed in every outcome (it is advisory, relevant whenever a
- * relocate or skip leaves the operator to tidy the spokes).
+ * canonical name shared with the workspace view refuses (`view-collision` — the
+ * relocate would land in the view's own canonical) and a pre-existing destination
+ * canonical refuses (relocating would clobber it). `regularSpokes` is echoed in
+ * every outcome (it is advisory, relevant whenever a relocate or skip leaves the
+ * operator to tidy the spokes).
  */
 declare function classifyRetrofit(facts: RetrofitFacts): RetrofitPlan;
 
@@ -4536,8 +4817,13 @@ type RepoSymlinkFacts = {
     /** Roster repo path (relative to the manifest root). */
     path: string;
     /**
-     * True when this repo IS the project anchor (it owns the canonical sources, so
-     * it never links to itself). An anchor entry is skipped entirely.
+     * True when this repo IS the project anchor (it hosts the OTHER repos' hub
+     * canonicals under `agents/`, so it is excluded from canonical-collision
+     * detection — it owns those, never links to them). Its OWN AGENTS.md is a
+     * regular committed file at the anchor root, the same shape as a `self` repo:
+     * only its CLAUDE.md / Copilot spokes are generated, and only once that root
+     * AGENTS.md exists (`canonicalPresent`). An anchor whose AGENTS.md is absent is
+     * left alone (not reported missing) until it is seeded.
      */
     isAnchor: boolean;
     /**
@@ -4567,7 +4853,7 @@ type RepoSymlinkFacts = {
      * caller for reachable, canonical-present repos; undefined otherwise.
      */
     canonicalName?: string;
-    /** Per instruction-file facts (empty when anchor / unreachable / canonical absent). */
+    /** Per instruction-file facts (empty when an un-seeded anchor / unreachable / canonical absent). */
     files: InstructionSymlinkFact[];
 };
 /** The instruction-file symlinks to CREATE in one repo (only the `missing` ones). */
@@ -4628,12 +4914,18 @@ type SymlinkPlanSummary = {
 };
 /**
  * Compute the {@link SymlinkPlanSummary} from per-repo facts. For each declared,
- * non-anchor, reachable repo whose canonical exists: a `missing` link becomes a
- * create, a `mismatch`/`occupied`/`blocked` link becomes a {@link SymlinkConflict}
- * (never a create — we do not overwrite), and a `correct` link is a no-op. The
- * anchor is skipped (it owns the canonical), an absent canonical is reported as
- * `missingCanonical` (no links planned, since the hub would dangle), and an
- * unresolvable repo as `unreachable`.
+ * reachable repo whose canonical exists: a `missing` link becomes a create, a
+ * `mismatch`/`occupied`/`blocked` link becomes a {@link SymlinkConflict} (never a
+ * create — we do not overwrite), and a `correct` link is a no-op. An absent
+ * canonical is reported as `missingCanonical` (no links planned, since the hub
+ * would dangle), and an unresolvable repo as `unreachable`.
+ *
+ * The anchor is a special case: it hosts the other repos' hub canonicals (so it
+ * is excluded from collision detection — it owns those), but its OWN AGENTS.md is
+ * a root committed file (self-style), so its CLAUDE.md / Copilot spokes ARE wired
+ * — once that root AGENTS.md exists. An anchor whose AGENTS.md is absent is left
+ * alone (not reported as missing): the seed step / operator creates it, then a
+ * re-run wires the spokes.
  *
  * Robustness:
  * - Facts are deduped by normalized path (first wins), so a repo listed twice in
@@ -4739,6 +5031,124 @@ type WiringSummary = {
  */
 declare function summarizeWiring(facts: RepoWiringFacts[]): WiringSummary;
 
+/**
+ * Wiring drift for `basou project check`: given the gathered instruction-file
+ * facts for every declared repo AND the workspace view, classify what is DRIFTED
+ * from basou's native hub-and-spoke topology — an ABSENT instruction canonical
+ * (AGENTS.md), an incompletely wired repo/view, an existing file/link that is not
+ * what basou would wire, a canonical-name collision, or an unreachable repo.
+ *
+ * The motivating gap: `project check` compared only the roster against the
+ * capture config (`source_roots`) and did no filesystem probe, so a MISSING
+ * instruction canonical — most sharply the workspace view's own AGENTS.md — went
+ * unnoticed until an operator eyeballed it. This makes `check` surface that class
+ * as drift, leading with canonical absence (the missing-AGENTS.md case).
+ *
+ * Pure: it composes {@link summarizeSymlinkPlan} (which already judges the repo
+ * side) with the view's gathered facts and re-frames both as read-only drift. The
+ * realpath / symlink reading that produces the facts is the caller's job (the CLI
+ * reuses the same gatherers `project symlinks` uses), so this stays testable
+ * without disk I/O.
+ */
+
+/**
+ * The workspace view's gathered instruction facts, structurally identical to the
+ * CLI's `ViewSymlinksOutcome` so the CLI passes its gathered value straight
+ * through. `no-view` = no `workspace.view` declared; `collision` = the view name
+ * clashes with a roster repo's canonical; `missing-canonical` = the view's own
+ * canonical (`agents/<viewName>/AGENTS.md`) is absent (the my-favorites case);
+ * `gathered` = the canonical exists and each spoke's on-disk state was inspected.
+ */
+type ViewWiringFacts = {
+    kind: "no-view";
+} | {
+    kind: "collision";
+    viewName: string;
+    repoPath: string;
+} | {
+    kind: "missing-canonical";
+    viewName: string;
+} | {
+    kind: "gathered";
+    viewName: string;
+    files: InstructionSymlinkFact[];
+};
+/**
+ * An absent instruction canonical (AGENTS.md) — the primary drift this surfaces.
+ * `repo-hub`: a `hub` repo's anchor canonical (`agents/<repo>/AGENTS.md`) is
+ * missing; `repo-self`: a `self` repo's own committed AGENTS.md is missing;
+ * `view`: the workspace view's canonical (`agents/<viewName>/AGENTS.md`) is
+ * missing. `name` is the repo's roster path (repo targets) or the view name.
+ */
+type MissingCanonical = {
+    target: "repo-hub" | "repo-self" | "view";
+    name: string;
+};
+/** A repo or the view whose canonical exists but whose spoke links are not all wired. */
+type IncompleteWiring = {
+    target: "repo" | "view";
+    /** Repo roster path, or the view name. */
+    path: string;
+    /** Instruction files still missing their link (e.g. "AGENTS.md", "CLAUDE.md"). */
+    files: string[];
+};
+/** An existing file/link that is not what basou would wire — surfaced, never touched. */
+type WiringConflict = {
+    target: "repo" | "view";
+    /** Repo roster path, or the view name. */
+    path: string;
+    file: string;
+    reason: "mismatch" | "occupied" | "blocked";
+    /** The conflicting link's current target, present only when `reason` is `mismatch`. */
+    actualTarget?: string;
+};
+/** Distinct repos (or view↔repo) resolving to the same `agents/<canonicalName>/AGENTS.md`. */
+type WiringCollision = {
+    canonicalName: string;
+    /** The colliding roster repo paths. */
+    repos: string[];
+    /** True when the workspace view is one side of the collision. */
+    view?: boolean;
+};
+type WiringDriftSummary = {
+    /** Absent instruction canonicals (repo hub, repo self, or view) — the headline gap. */
+    missingCanonicals: MissingCanonical[];
+    /** Repos/view whose canonical exists but whose spoke links are not fully wired. */
+    incompleteWiring: IncompleteWiring[];
+    /** Existing links that are not what basou would wire (left untouched). */
+    conflicts: WiringConflict[];
+    /** Ambiguous canonical-name collisions (repo↔repo or view↔repo). */
+    collisions: WiringCollision[];
+    /**
+     * Declared repos not present on this machine (unresolvable / not a usable git
+     * repo). ADVISORY: expected on a partial checkout (a workspace declares N repos;
+     * a given machine has a subset cloned), so it is reported but does NOT fail
+     * `ok` — otherwise `check` would read chronically dirty on every partial
+     * checkout and drown the actionable drift it exists to surface.
+     */
+    unreachable: string[];
+    /**
+     * True when there is no ACTIONABLE drift: no missing canonical, no incomplete
+     * wiring, no conflict, no collision. `unreachable` is deliberately excluded (it
+     * is advisory — see above), so a partial checkout with otherwise-correct wiring
+     * is `ok`. A missing view/repo AGENTS.md, a mismatched link, or a collision all
+     * deny `ok`.
+     */
+    ok: boolean;
+};
+/**
+ * Compute the {@link WiringDriftSummary} from the per-repo instruction facts and
+ * the view's gathered facts. The repo side is delegated to
+ * {@link summarizeSymlinkPlan} (so its dedup, collision, and canonical-absence
+ * judgments are reused verbatim) and re-labelled as drift; the view side is folded
+ * in from {@link ViewWiringFacts}. Leads with `missingCanonicals` because an absent
+ * AGENTS.md is the drift the caller most needs to see.
+ */
+declare function summarizeWiringDrift(input: {
+    repos: RepoSymlinkFacts[];
+    view: ViewWiringFacts;
+}): WiringDriftSummary;
+
 /**
  * Plan the symlinks a project's throwaway "view" needs (the generation step
  * after the instruction-file symlinks in the "saddle" model). When a project
@@ -4762,7 +5172,12 @@ declare function summarizeWiring(facts: RepoWiringFacts[]): WiringSummary;
  * Pruning stray entries already in the view IS now in scope (see `toPrune` /
  * `strayUnknown` and {@link ExistingViewLink}): the ownership model that tells an
  * orphaned repo link from the view's own instruction files / local state lives
- * here. Still NOT in scope: generating the view's own instruction files.
+ * here. Generating the view's OWN instruction files (its AGENTS.md canonical and
+ * the CLAUDE.md / Copilot spokes) is handled by `project preset` / `project
+ * symlinks`, which treat the view as a second instruction target — this planner's
+ * job stays the repo-aggregation symlinks and their strays. The prune ownership
+ * model here (which excludes the view's own top-level instruction-file symlinks
+ * from stray detection) is what keeps those generated files safe from pruning.
  */
 /**
  * The on-disk state of one repo's view symlink. `correct` = the expected link
@@ -5287,6 +5702,12 @@ type ReportRendererInput = {
     onWarning?: (warning: ReplayWarning, sessionId: string) => void;
     onSessionSkip?: (sessionId: string, reason: SessionSkipReason) => void;
     onTaskSkip?: (taskId: string, reason: TaskSkipReason) => void;
+    /**
+     * Generated-view chrome language. Omitted (the normal path) = resolved from
+     * the manifest's anchor repo via {@link resolveViewLanguageFromPaths}; the
+     * override exists for tests and programmatic callers that already resolved it.
+     */
+    language?: ViewLanguage;
 };
 type ReportSessionItem = {
     id: string;
@@ -5911,6 +6332,27 @@ declare function parseMarkers(content: string, markers?: Markers): MarkerSection
  * so the error message is informative without leaking an absolute path.
  */
 declare function renderWithMarkers(existing: string | null, generated: string, fileLabel: string, markers?: Markers): string;
+/**
+ * Seed a marker region into a file, migrating a markerless (hand-authored) file
+ * IN PLACE instead of refusing it the way {@link renderWithMarkers} does. Used by
+ * `project retrofit` to auto-migrate an existing prose canonical: the generated
+ * block is prepended and every byte of the existing content is preserved.
+ *
+ * - `existing === null` (no file yet): identical to `renderWithMarkers(null, …)`
+ *   — a fresh `<START>\n<generated>\n<END>\n` block.
+ * - existing parses to `ok`: delegated to {@link renderWithMarkers} — the marked
+ *   region is replaced, everything before START / after END is kept.
+ * - `no_markers` (including a 0-byte / empty-string file): the block is PREPENDED
+ *   (`<START>\n<generated><END>\n\n<existing>`) so the hand-authored prose is kept
+ *   verbatim after one blank-line separator. A leading UTF-8 BOM is re-placed at
+ *   the FILE head (before the seeded block), never left mid-file — matching
+ *   {@link parseMarkers}' BOM tolerance. A leading YAML frontmatter (`---`) is
+ *   NOT special-cased: the block is prepended above it (a known limitation).
+ * - any malformed result (`missing_start` / `missing_end` / `multiple_pairs` /
+ *   `wrong_order`): throws a pathless error referencing `fileLabel`, exactly like
+ *   {@link renderWithMarkers} (a broken marker pair must never be silently rewritten).
+ */
+declare function seedMarkers(existing: string | null, generated: string, fileLabel: string, markers?: Markers): string;
 /**
  * Remove a marker region from `existing`, returning the body without the block.
  *
@@ -6148,4 +6590,4 @@ declare function overwriteYamlFile(filePath: string, value: unknown): Promise<vo
  */
 declare const BASOU_CORE_VERSION = "0.1.0";
 
-export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_VERSION, type BasouPaths, type BuildStopHookCommandOptions, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeSettings, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexCommandLookup, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DEFAULT_STOP_HOOK_MIN_EDITS, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type NoteAddedEvent, ORIENTATION_END, ORIENTATION_START, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, REVIEW_RECORD_NO_INPUT_HINT, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type RepoInstructions, type RepoLanguage, type RepoPresetFacts, type RepoPresetPlan, type RepoSymlinkFacts, type RepoSymlinkPlan, type RepoVisibility, type RepoWiringFacts, type ReportApprovalItem, type ReportData, type ReportDecisionItem, type ReportRendererInput, type ReportRendererResult, type ReportSessionItem, type ReportTaskItem, type RetrofitAction, type RetrofitAgentsState, type RetrofitFacts, type RetrofitPlan, type RetrofitReason, type ReviewBlocked, type ReviewFinding, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type ReviewGateResult, type ReviewGateSilentReason, type ReviewRecordBlockedInput, type ReviewRecordFindingInput, type ReviewRecordInput, type ReviewRecordedEvent, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STOP_HOOK_TIMEOUT_SECONDS, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type StopHookEvaluation, type StopHookEvaluationInput, type StopHookRemoval, type StopHookSilentReason, type StopHookUpsert, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLinkState, type ViewRepoFact, type ViewStrayUnknown, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildReviewRecordLabel, buildReviewRecordedEvent, buildStatusSnapshot, buildStopHookCommand, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexAdapterMetadata, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findBasouStopHookCommand, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, instructionMode, isBasouStopHookCommand, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, parseReviewRecordInput, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeStopHook, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveCodexCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, upsertStopHook, verifyEventsChain, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };
+export { ACTIVE_GAP_CAP_MS, AGENT_INFRA_DIRS, type ActiveTimeBasis, type AdapterOutputEvent, type AdoptCandidate, type AdoptCandidateKind, type AnchorStarterInput, type AnchorStarterRepo, type AppendBasouGitignoreOptions, type AppendBasouGitignoreResult, type AppendEventToExistingInput, type AppendEventToExistingResult, type Approval, type ApprovalApprovedEvent, type ApprovalExpiredEvent, ApprovalIdSchema, type ApprovalLocation, type ApprovalRejectedEvent, type ApprovalRequestedEvent, ApprovalSchema, type ApprovalStatus, ApprovalStatusSchema, type ArchivePlan, type ArchiveTaskInput, type ArchiveTaskResult, type AttachTaskInput, type AttachUpdateTaskStatusInput, type AttachableStatus, BASOU_CORE_VERSION, type BasouPaths, type BuildStopHookCommandOptions, type BulkChainResult, CLAUDE_IMPORT_SOURCE, CODEX_IMPORT_SOURCE, type CaptureMode, type ChainBreakReason, type ChainTailState, type ChainVerdict, type ChainVerdictStatus, type ChainedEvents, ChildProcessRunner, type CitedReview, type ClaudeSettings, type ClaudeTranscriptRecord, type ClaudeTranscriptToPayloadOptions, type CodexCommandLookup, type CodexRolloutRecord, type CodexRolloutToPayloadOptions, type CommandExecutedEvent, type CommandLookup, type CreateAdHocSessionInput, type CreateAdHocSessionResult, type CreateAdHocTaskInput, type CreateManifestInput, type CreateTaskInput, type CreateTaskResult, DEFAULT_STOP_HOOK_MIN_EDITS, type DayWorkStats, DecisionIdSchema, type DecisionRecordedEvent, type DecisionsRendererInput, type DecisionsRendererResult, type DeleteTaskInput, type DeleteTaskResult, type DiffResult, type EditTaskInput, type EditTaskResult, type Event, EventIdSchema, EventSchema, EventSourceSchema, type ExistingViewLink, FailedToFinalizeError, type FederatedRoot, type FileChange, type FileChangeStatus, type FileChangedEvent, GENERATED_END, GENERATED_START, type GitSnapshot, type GitSnapshotEvent, type GitignorePlanSummary, type HandoffRendererInput, type HandoffRendererResult, ID_PREFIXES, type IdPrefix, type ImportSessionOptions, type ImportSessionResult, type IncompleteWiring, type InstructionFileFact, type InstructionSymlinkFact, type InstructionSymlinkState, IsoTimestampSchema, JSON_SCHEMA_VERSION, type JsonSchemaArtifact, type LoadFederatedOptions, type LoadSessionEntriesOptions, type LoadTaskEntriesOptions, type LoadedApproval, type LockHandle, type LockScope, type Manifest, ManifestSchema, type MarkerSection, type Markers, type MeasureAvailability, type MissingCanonical, type NoteAddedEvent, ORIENTATION_END, ORIENTATION_START, type OrientationRendererInput, type OrientationRendererResult, type OrientationSummary, PROTOCOL_END, PROTOCOL_START, type PrefixedId, type PresetAction, type PresetCollision, type PresetMarkerConflict, type PresetMarkerKind, type PresetPlanSummary, type PresetRepo, type ProcessRunner, type PublishKind, type PublishTarget, REVIEW_RECORD_NO_INPUT_HINT, type RechainOptions, type RechainResult, type ReconcileAllResult, type ReconcileAllTasksInput, type ReconcileAllTasksOptions, type ReconcileFailure, type ReconcileResult, type ReconcileTaskInput, type RefreshLinkageInput, type RefreshLinkageResult, type ReimportOptions, type ReimportResult, type RenamePlan, type ReplayOptions, type ReplayWarning, type RepoEntry, type RepoGitignoreFacts, type RepoGitignorePlan, type RepoInstructions, type RepoLanguage, type RepoPresetFacts, type RepoPresetPlan, type RepoSymlinkFacts, type RepoSymlinkPlan, type RepoVisibility, type RepoWiringFacts, type ReportApprovalItem, type ReportData, type ReportDecisionItem, type ReportRendererInput, type ReportRendererResult, type ReportSessionItem, type ReportTaskItem, type RetrofitAction, type RetrofitAgentsState, type RetrofitFacts, type RetrofitPlan, type RetrofitReason, type ReviewBlocked, type ReviewFinding, type ReviewGapRepoSummary, type ReviewGapUnit, type ReviewGapVerdict, type ReviewGapsInput, type ReviewGapsSummary, type ReviewGateResult, type ReviewGateSilentReason, type ReviewRecordBlockedInput, type ReviewRecordFindingInput, type ReviewRecordInput, type ReviewRecordedEvent, type RiskLevel, RiskLevelSchema, type RosterAdoptionPlan, type RosterDriftSummary, type RunOptions, type RunResult, STOP_HOOK_TIMEOUT_SECONDS, STUCK_THRESHOLD_MS, type SanitizePathOptions, type SanitizeRelatedFilesResult, SchemaVersionSchema, type Session, type SessionEndedEvent, type SessionEntry, SessionIdSchema, type SessionImportPayload, SessionImportPayloadSchema, type SessionInnerImportInput, SessionInnerImportSchema, type SessionIntegrity, SessionIntegritySchema, type SessionMetrics, SessionMetricsSchema, SessionSchema, type SessionSkipReason, type SessionSourceKind, SessionSourceKindSchema, type SessionStartedEvent, type SessionStatus, type SessionStatusChangedEvent, SessionStatusSchema, type SessionWorkStats, type SourceRootScope, type SourceRootsReconcile, type SourceWorkStats, type StatusCount, StatusSchema, type StatusSnapshot, type StopHookEvaluation, type StopHookEvaluationInput, type StopHookRemoval, type StopHookSilentReason, type StopHookUpsert, type SuspectReason, type SymlinkCollision, type SymlinkConflict, type SymlinkPlanSummary, type Task, type TaskArchivedEvent, type TaskCreatedEvent, type TaskDeletedEvent, type TaskDocument, TaskIdSchema, type TaskLinkageRefreshedEvent, type TaskReconciledEvent, TaskSchema, type TaskSkipReason, type TaskStatus, type TaskStatusChangedEvent, type TaskStatusCount, TaskStatusSchema, TaskWriteAfterEventError, type TaskWriteAfterEventPhase, type TokenTotals, type UpdateAdHocTaskStatusInput, type UpdateTaskStatusInput, type UpdateTaskStatusResult, type ViewCollision, type ViewConflict, type ViewLanguage, type ViewLinkState, type ViewPresetInput, type ViewPresetRepo, type ViewRepoFact, type ViewStrayUnknown, type ViewStrings, type ViewWiringFacts, type WiringCollision, type WiringConflict, type WiringDriftSummary, type WiringRisk, type WiringSummary, type WorkStatsInput, type WorkStatsResult, type WorkStatsTotals, WorkspaceIdSchema, type WorkspaceViewPlan, type WriteEventsBulkOptions, type WriteTaskFileMode, acquireLock, appendBasouGitignore, appendChainedEvent, appendChainedEventLocked, appendEvent, appendEventToExistingSession, archiveTask, assertBasouRootSafe, basouPaths, buildJsonSchemas, buildReviewRecordLabel, buildReviewRecordedEvent, buildStatusSnapshot, buildStopHookCommand, chainEvents, chainRawJsonLines, classifyFilesBySourceRoot, classifyRetrofit, classifySuspect, claudeCodeAdapterMetadata, claudeTranscriptToImportPayload, codexAdapterMetadata, codexRolloutToImportPayload, computeWorkStats, createAdHocSessionWithEvent, createManifest, createTaskWithEvent, deleteTask, editTask, ensureBasouDirectory, enumerateApprovals, enumerateArchivedTaskIds, enumerateSessionDirs, enumerateTaskIds, evaluateStopHook, finalizeSessionYaml, findBasouStopHookCommand, findErrorCode, findReviewGaps, formatDurationMs, genesisHash, getDiff, getSnapshot, importSessionFromJson, inspectChainTail, instructionMode, isBasouStopHookCommand, isGitNotFound, isImportDerivedSource, isLazyExpired, isRenderable, isValidPrefixedId, lineHash, linkYamlFile, loadApproval, loadFederatedSessionEntries, loadSessionEntries, loadTaskEntries, normalizeRepoKey, normalizeRepoPath, overwriteYamlFile, parseDuration, parseMarkers, parseReviewRecordInput, pathBasename, planArchive, planGitignore, planRename, planRosterAdoption, planWorkspaceView, prefixedUlid, readAllEvents, readManifest, readMarkdownFile, readSessionYaml, readStatus, readTaskFile, readTaskFileWithArchiveFallback, readYamlFile, rechainSessionInPlace, reconcileAllTasks, reconcileSourceRoots, reconcileTask, refreshTaskLinkedSessions, reimportPreservingId, removeMarkerSection, removeStopHook, renderAnchorStarter, renderDecisions, renderHandoff, renderOrientation, renderPresetBlock, renderReport, renderViewPresetBlock, renderWithMarkers, replayEvents, resolveBasouRepositoryRoot, resolveClaudeCodeCommand, resolveCodexCommand, resolveRepositoryRoot, resolveSessionId, resolveTaskId, resolveViewLanguage, resolveViewLanguageFromPaths, safeSimpleGit, sanitizePath, sanitizeRelatedFiles, sanitizeWorkingDirectory, seedMarkers, serializeEventLine, serializeJsonSchema, sessionWorkStatsFromEvents, summarizeAdapterOutput, summarizeOrientation, summarizePresetPlan, summarizeRosterDrift, summarizeSymlinkPlan, summarizeWiring, summarizeWiringDrift, tryRemoteUrl, ulid, unknownManifestKeys, updateTaskStatusWithEvent, upsertStopHook, verifyEventsChain, viewStrings, writeEventsBulk, writeManifest, writeMarkdownFile, writeStatus, writeTaskFile, writeYamlFile };