@openrig/cli 0.5.2 → 0.5.4

package/daemon/dist/domain/context-packs/probe-eval-bridge.d.ts

@@ -0,0 +1,34 @@
+import type { ContextPackManifest } from "./context-pack-types.js";
+/** A plain eval-case object in the harness's declarative format. The harness's
+ *  validateEvalCase is the authority on this shape; the bridge emits data. */
+export type CompiledEvalCaseData = Record<string, unknown>;
+/**
+ * Compile every probed atom of a manifest into behavior-category eval-case
+ * data. Atoms without probes are skipped (a probe is acceptance evidence,
+ * not an obligation). Case ids are namespaced by the pack ref so cases from
+ * multiple packs never collide in one harness run.
+ *
+ * The mapping, field by field:
+ *   id               <- <packRef>/<atomId>
+ *   name             <- the probe's expect (the observable-behavior contract
+ *                       IS the case's human name — what a grader reads first)
+ *   category         <- "behavior"
+ *   prompt           <- probe.prompt (the natural prompt, mini-req 2)
+ *   expectedPatterns <- probe.expectedPatterns (the deterministic door leg;
+ *                       validated compilable at manifest ingest)
+ *   rubric           <- probe.rubric, else the expect prose (the judged leg
+ *                       always has at least the behavior contract to judge by)
+ */
+export interface CompiledProbeCases {
+    cases: CompiledEvalCaseData[];
+    /** Probes that could not become harness cases, WITH reasons — a bound the
+     *  caller must surface (no silent caps): a probe without expectedPatterns
+     *  has no deterministic-door leg, and the bridge refuses both to fabricate
+     *  a pattern from prose and to lose the atom silently. */
+    skipped: Array<{
+        atomId: string;
+        reason: string;
+    }>;
+}
+export declare function compileAtomProbesToEvalCases(manifest: ContextPackManifest, packRef: string): CompiledProbeCases;
+//# sourceMappingURL=probe-eval-bridge.d.ts.map

package/daemon/dist/domain/context-packs/probe-eval-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-eval-bridge.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/probe-eval-bridge.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;8EAC8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B;;;8DAG0D;IAC1D,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAsB/G"}

package/daemon/dist/domain/context-packs/probe-eval-bridge.js

@@ -0,0 +1,38 @@
+// OPR.0.5.3.5 Q3 harness bridge (mini-req 8, amended per desk ruling 9103302d):
+// slice-05's behavior probes execute in the SAME live-model eval harness as
+// slice-07's selection/loading cases, as the "behavior" case CATEGORY — one
+// harness, one runner, one grading door; two runners would fork the eval
+// convention itself (the drift class this release keeps killing).
+//
+// This bridge is DATA-SHAPED on purpose: it compiles atom probes (mini-req 1
+// metadata) into plain eval-case objects that the harness validates through
+// ITS OWN schema at load time — exactly how the authored YAML cases travel.
+// No import from the harness's modules, so the product side and the
+// test-system side stay decoupled by data (the schema's own stated design:
+// "no cross-package TS import"), and the one-harness property is preserved
+// by construction rather than by discipline.
+export function compileAtomProbesToEvalCases(manifest, packRef) {
+    const cases = [];
+    const skipped = [];
+    for (const atom of manifest.atoms ?? []) {
+        if (!atom.probe)
+            continue;
+        if (!atom.probe.expectedPatterns || atom.probe.expectedPatterns.length === 0) {
+            skipped.push({
+                atomId: atom.id,
+                reason: "probe has no expectedPatterns — the harness's deterministic door requires at least one compilable pattern; author them on the atom's probe",
+            });
+            continue;
+        }
+        cases.push({
+            id: `${packRef}/${atom.id}`,
+            name: atom.probe.expect,
+            category: "behavior",
+            prompt: atom.probe.prompt,
+            expectedPatterns: atom.probe.expectedPatterns,
+            rubric: atom.probe.rubric ?? atom.probe.expect,
+        });
+    }
+    return { cases, skipped };
+}
+//# sourceMappingURL=probe-eval-bridge.js.map

package/daemon/dist/domain/context-packs/probe-eval-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-eval-bridge.js","sourceRoot":"","sources":["../../../src/domain/context-packs/probe-eval-bridge.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,oEAAoE;AACpE,2EAA2E;AAC3E,2EAA2E;AAC3E,6CAA6C;AAkC7C,MAAM,UAAU,4BAA4B,CAAC,QAA6B,EAAE,OAAe;IACzF,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,OAAO,GAAkC,EAAE,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,SAAS;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,MAAM,EAAE,4IAA4I;aACrJ,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACvB,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACzB,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB;YAC7C,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/daemon/dist/domain/context-packs/profile-composer.d.ts

@@ -0,0 +1,49 @@
+import type { ContextPackAtom } from "./context-pack-types.js";
+export declare class ProfileComposeError extends Error {
+    constructor(message: string);
+}
+export type ComposeSituation = "fresh" | "handover" | "post-compaction";
+export type ComposeRuntime = "claude" | "codex";
+export type SourceKind = "library" | "seat" | "mission";
+export interface ComposeInput {
+    /** The one atom graph (possibly gathered across sources by the caller). */
+    atoms: ContextPackAtom[];
+    situation: ComposeSituation;
+    runtime: ComposeRuntime;
+    /** Fail-loud file reader keyed by the address's pre-`#` ref. */
+    readFile: (ref: string) => string;
+    /** The situation's token budget (D2 targets); omitted = no budget check. */
+    budgetTokens?: number;
+    /** Source labelling per atom (Q2-Amendment 1); defaults to "library". */
+    sourceKindFor?: (atom: ContextPackAtom) => SourceKind;
+}
+export interface ComposedPiece {
+    atomId: string;
+    address: string;
+    sourceKind: SourceKind;
+    order: number;
+    priority: ContextPackAtom["priority"];
+    /** The resolved bytes: the addressed span (Q1 full-span rule) or the whole file. */
+    text: string;
+    estimatedTokens: number;
+}
+export interface ComposedProfile {
+    situation: ComposeSituation;
+    runtime: ComposeRuntime;
+    pieces: ComposedPiece[];
+    totalEstimatedTokens: number;
+    /** Present ONLY when the budget binds: the report, never a truncation. */
+    budget?: {
+        limitTokens: number;
+        overageTokens: number;
+        /** What to drop FIRST, in drop order: optional, then recommended, then core;
+         *  larger pieces first within a tier (the biggest cheap win leads). */
+        dropCandidates: Array<{
+            atomId: string;
+            priority: ContextPackAtom["priority"];
+            estimatedTokens: number;
+        }>;
+    };
+}
+export declare function composeProfile(input: ComposeInput): ComposedProfile;
+//# sourceMappingURL=profile-composer.d.ts.map

package/daemon/dist/domain/context-packs/profile-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-composer.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/profile-composer.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,iBAAiB,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,gEAAgE;IAChE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,UAAU,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB;+EACuE;QACvE,cAAc,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3G,CAAC;CACH;AAgBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAsFnE"}

package/daemon/dist/domain/context-packs/profile-composer.js

@@ -0,0 +1,125 @@
+// OPR.0.5.3.5 Atom 3 — the composition algebra (locked SPEC, founder refinement):
+//
+//   FRESH           = the base walk (atoms tagged fresh)
+//   HANDOVER        = FRESH + the handover material (atoms tagged handover)
+//   POST-COMPACTION = the tagged subset of fresh + the handover material
+//
+// Every profile is CLOSED over requires (a subset profile must close — intake rule);
+// the runtime filter runs per mini-req 3 (claude and codex are never assumed to have
+// lost the same dimensions, so they compose different profiles from the SAME graph);
+// each piece resolves through the Atom-1 address machinery and carries a per-piece
+// SOURCE LABEL (Q2-Amendment 1: composition is multi-source by contract — library /
+// seat tree / mission tree — and every assembled piece names its source; the caller's
+// resolver decides the kind, this module labels). Budgets are evaluated AT COMPOSE
+// and on overage REPORT the amount and the priority-ordered drop candidates —
+// composition never silently truncates (mini-req 9; D2: budgets flag for review,
+// never silently govern).
+//
+// PURE by contract, like the manifest parser: file text arrives through the caller's
+// readFile so the same algebra serves library packs today and configured tree roots
+// (seat/mission sources) when the wiring atom lands. Every failure is LOUD and names
+// the atom — a compose stops rather than thinning the walk (the Q1 rationale).
+import { estimateTokensFromBytes } from "./token-estimate.js";
+import { AddressResolutionError, parseAddress, resolveAddress } from "../markdown-address.js";
+export class ProfileComposeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProfileComposeError";
+    }
+}
+/** Which situation tags select atoms for a profile, per the locked algebra. */
+function selectionTags(situation) {
+    switch (situation) {
+        case "fresh":
+            return ["fresh"];
+        case "handover":
+            return ["fresh", "handover"];
+        case "post-compaction":
+            return ["post-compaction", "handover"];
+    }
+}
+const DROP_ORDER = { optional: 0, recommended: 1, core: 2 };
+export function composeProfile(input) {
+    const { atoms, situation, runtime, readFile, budgetTokens, sourceKindFor } = input;
+    const byId = new Map(atoms.map((a) => [a.id, a]));
+    // 1. SELECT by situation tag, then filter by runtime (an "any" atom serves both).
+    const tags = selectionTags(situation);
+    const runtimeFits = (a) => a.runtime === "any" || a.runtime === runtime;
+    const selected = new Map();
+    for (const a of atoms) {
+        if (a.situations.some((s) => tags.includes(s)) && runtimeFits(a))
+            selected.set(a.id, a);
+    }
+    // 2. CLOSE over requires: a required atom joins the profile even when untagged.
+    //    A dependency that exists but is excluded by the RUNTIME filter is a broken
+    //    graph for this runtime — fail loud, never a quietly thinner walk.
+    const queue = [...selected.keys()];
+    while (queue.length > 0) {
+        const id = queue.pop();
+        for (const req of selected.get(id)?.requires ?? byId.get(id)?.requires ?? []) {
+            if (selected.has(req))
+                continue;
+            const dep = byId.get(req);
+            if (!dep) {
+                throw new ProfileComposeError(`atom '${id}' requires '${req}', which is not in the graph — the ${situation} profile cannot close.`);
+            }
+            if (!runtimeFits(dep)) {
+                throw new ProfileComposeError(`atom '${id}' requires '${req}', but '${req}' is declared runtime=${dep.runtime} and this compose targets runtime=${runtime} — ` +
+                    `the closure would silently thin the ${situation} walk; fix the graph (retag '${req}' or drop the edge).`);
+            }
+            selected.set(req, dep);
+            queue.push(req);
+        }
+    }
+    // 3. ORDER the walk (stable: order, then id — absorption depends on sequence).
+    const walk = [...selected.values()].sort((x, y) => x.order - y.order || x.id.localeCompare(y.id));
+    // 4. RESOLVE every piece through the one address machinery; label its source.
+    const pieces = walk.map((a) => {
+        const { ref, headerPath } = parseAddress(a.address);
+        let fileText;
+        try {
+            fileText = readFile(ref);
+        }
+        catch (err) {
+            throw new ProfileComposeError(`atom '${a.id}' (${a.address}): source file '${ref}' is unreadable — ${err.message}`);
+        }
+        let text;
+        if (headerPath.length === 0) {
+            text = fileText;
+        }
+        else {
+            try {
+                text = resolveAddress(fileText, headerPath).text;
+            }
+            catch (err) {
+                if (err instanceof AddressResolutionError) {
+                    throw new ProfileComposeError(`atom '${a.id}' (${a.address}): ${err.message}`);
+                }
+                throw err;
+            }
+        }
+        return {
+            atomId: a.id,
+            address: a.address,
+            sourceKind: sourceKindFor?.(a) ?? "library",
+            order: a.order,
+            priority: a.priority,
+            text,
+            estimatedTokens: estimateTokensFromBytes(Buffer.byteLength(text, "utf-8")),
+        };
+    });
+    const totalEstimatedTokens = pieces.reduce((sum, p) => sum + p.estimatedTokens, 0);
+    // 5. BUDGET report (mini-req 9): flag, never govern — all pieces stay.
+    let budget;
+    if (budgetTokens !== undefined && totalEstimatedTokens > budgetTokens) {
+        budget = {
+            limitTokens: budgetTokens,
+            overageTokens: totalEstimatedTokens - budgetTokens,
+            dropCandidates: [...pieces]
+                .sort((x, y) => DROP_ORDER[x.priority] - DROP_ORDER[y.priority] || y.estimatedTokens - x.estimatedTokens || x.atomId.localeCompare(y.atomId))
+                .map((p) => ({ atomId: p.atomId, priority: p.priority, estimatedTokens: p.estimatedTokens })),
+        };
+    }
+    return { situation, runtime, pieces, totalEstimatedTokens, ...(budget !== undefined ? { budget } : {}) };
+}
+//# sourceMappingURL=profile-composer.js.map

package/daemon/dist/domain/context-packs/profile-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-composer.js","sourceRoot":"","sources":["../../../src/domain/context-packs/profile-composer.ts"],"names":[],"mappings":"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"}

package/daemon/dist/domain/context-packs/profile-source-resolver.d.ts

@@ -0,0 +1,53 @@
+import type { SourceKind } from "./profile-composer.js";
+export declare class SourceResolutionError extends Error {
+    constructor(message: string);
+}
+declare const TREE_KINDS: readonly ["seat", "mission"];
+export type TreeKind = (typeof TREE_KINDS)[number];
+export interface ParsedSourceRef {
+    kind: SourceKind;
+    /** Relative path under the pack dir (library) or the kind's configured root. */
+    rel: string;
+}
+/** Split a pre-`#` ref into its resolver kind + relative path. Fail-loud on an
+ *  unknown prefix or a traversal-shaped path — a clean refusal, never an escape
+ *  (the r2-B3 precedent from the trace verb). */
+export declare function parseSourceRef(ref: string): ParsedSourceRef;
+export interface ProfileSourceRoots {
+    /** The seat's tree directory (recap + lore beside LEARNED) — from config. */
+    seat?: string;
+    /** The mission's tree directory — from config. */
+    mission?: string;
+}
+/** Byte-provenance record for one successful read (r1 rider 1 via 4a's review):
+ *  the label must be CHECKABLE, not merely asserted — with a symlink in play a
+ *  source label is accurate about the REF and wrong about the BYTES, and that
+ *  bites on benign symlinks, not just hostile ones. */
+export interface SourceReadRecord {
+    ref: string;
+    kind: SourceKind;
+    /** The root the read was granted against. */
+    base: string;
+    /** base + rel, before symlink resolution. */
+    nominalPath: string;
+    /** Where the BYTES actually came from (realpath after the successful read). */
+    realPath: string;
+    /** True when realPath sits outside base. Computed via path.relative — never a
+     *  bare string prefix (r1: `startsWith` says /seat-evil is inside /seat). */
+    escapesRoot: boolean;
+}
+/** Build the composer's fail-loud readFile over the pack dir + configured tree
+ *  roots. Every failure names the source kind and what was being resolved —
+ *  a missing root is a MISSING CONFIG error, never a silent empty; a DANGLING
+ *  symlink is its own named failure (a realistic corpus state, not a generic
+ *  unreadable). Each successful read reports byte provenance via onRead. */
+export declare function makeProfileReadFile(opts: {
+    packDir: string;
+    roots: ProfileSourceRoots;
+    onRead?: (record: SourceReadRecord) => void;
+}): (ref: string) => string;
+/** The composer's per-piece source label (Q2-Amendment 1: every assembled piece
+ *  is labeled with its source), derived from the atom's full address. */
+export declare function sourceKindForAddress(address: string): SourceKind;
+export {};
+//# sourceMappingURL=profile-source-resolver.d.ts.map

package/daemon/dist/domain/context-packs/profile-source-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-source-resolver.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/profile-source-resolver.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,QAAA,MAAM,UAAU,8BAA+B,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;iDAEiD;AACjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA0B3D;AAED,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;uDAGuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB;iFAC6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;4EAI4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC7C,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CA8D1B;AAED;yEACyE;AACzE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAEhE"}

package/daemon/dist/domain/context-packs/profile-source-resolver.js

@@ -0,0 +1,129 @@
+// OPR.0.5.3.5 Atom 4a — the two pre-`#` resolvers behind ONE grammar.
+//
+// Q2-Amendment 1 (locked), the desk's grammar ruling verbatim: non-library sources
+// are addressable with the SAME `#H2-slug/H3-slug` grammar; only the pre-`#`
+// resolver differs — a library ref resolves through the library (here: the pack's
+// own directory), a tree path resolves from CONFIGURED roots — and both resolve
+// FAIL-LOUD. One grammar held in memory, two resolvers behind it, no second
+// addressing convention. The kind prefix is the entire pre-`#` dialect:
+//
+//   walk.md#welcome              -> library (the pack's declared files)
+//   seat:RECAP.md#decisions      -> the seat tree (recap + lore live beside LEARNED)
+//   mission:NOTES.md#watch-items -> the mission tree
+//
+// Roots arrive from CONFIG through the caller (CE-v2 03-tree-addressability: an
+// addressing verb resolves tree paths from config, never literals — this module
+// holds no path literal and refuses to guess a missing root). Composability comes
+// from ADDRESSING, not homing: nothing must be copied into the library to compose
+// (a profile that copies seat or mission content into the library is a defect —
+// Q2-Amendment 1(c)).
+import { lstatSync, readFileSync, realpathSync } from "node:fs";
+import { isAbsolute, join, normalize, relative, sep } from "node:path";
+import { parseAddress } from "../markdown-address.js";
+export class SourceResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SourceResolutionError";
+    }
+}
+const TREE_KINDS = ["seat", "mission"];
+/** Split a pre-`#` ref into its resolver kind + relative path. Fail-loud on an
+ *  unknown prefix or a traversal-shaped path — a clean refusal, never an escape
+ *  (the r2-B3 precedent from the trace verb). */
+export function parseSourceRef(ref) {
+    const colon = ref.indexOf(":");
+    let kind = "library";
+    let rel = ref;
+    if (colon >= 0) {
+        const prefix = ref.slice(0, colon);
+        if (!TREE_KINDS.includes(prefix)) {
+            throw new SourceResolutionError(`source ref '${ref}' has unknown kind prefix '${prefix}' — the pre-'#' dialect is bare (library), ${TREE_KINDS.map((k) => `'${k}:'`).join(" or ")}.`);
+        }
+        kind = prefix;
+        rel = ref.slice(colon + 1);
+    }
+    if (rel.length === 0) {
+        throw new SourceResolutionError(`source ref '${ref}' has an empty path after its kind prefix.`);
+    }
+    const unsafe = isAbsolute(rel) ||
+        rel.split(/[\\/]/).some((segment) => segment === ".." || segment === "");
+    if (unsafe) {
+        throw new SourceResolutionError(`source ref '${ref}' is traversal-shaped (absolute path, '..' or empty segment) — refs stay inside their source root.`);
+    }
+    return { kind, rel };
+}
+/** Build the composer's fail-loud readFile over the pack dir + configured tree
+ *  roots. Every failure names the source kind and what was being resolved —
+ *  a missing root is a MISSING CONFIG error, never a silent empty; a DANGLING
+ *  symlink is its own named failure (a realistic corpus state, not a generic
+ *  unreadable). Each successful read reports byte provenance via onRead. */
+export function makeProfileReadFile(opts) {
+    return (ref) => {
+        const { kind, rel } = parseSourceRef(ref);
+        let base;
+        if (kind === "library") {
+            base = opts.packDir;
+        }
+        else {
+            const configured = opts.roots[kind];
+            if (!configured) {
+                throw new SourceResolutionError(`source ref '${ref}' needs the ${kind} tree root, which is not configured for this compose — ` +
+                    `tree paths resolve from config, never literals; supply the ${kind} root or drop the ${kind}-homed atom.`);
+            }
+            base = configured;
+        }
+        const abs = normalize(join(base, rel));
+        let text;
+        try {
+            text = readFileSync(abs, "utf-8");
+        }
+        catch (err) {
+            // Name the dangling-symlink state precisely: the path EXISTS as a link
+            // but its target does not — a generic "unreadable" would send an author
+            // hunting for a file that is right there in their listing.
+            let dangling = false;
+            try {
+                lstatSync(abs);
+                dangling = true;
+            }
+            catch {
+                /* genuinely absent */
+            }
+            throw new SourceResolutionError(dangling
+                ? `source ref '${ref}' (${kind}) is a DANGLING symlink: ${abs} exists but its target does not — ${err.message}`
+                : `source ref '${ref}' (${kind}) did not resolve: ${abs} is unreadable — ${err.message}`);
+        }
+        // Provenance AFTER the successful read (r1: realpath on a missing file
+        // throws, and that throw must never garble the honest read error above).
+        if (opts.onRead) {
+            let realPath = abs;
+            try {
+                realPath = realpathSync(abs);
+            }
+            catch {
+                /* raced away post-read; nominal stands as the best truth available */
+            }
+            let realBase = base;
+            try {
+                realBase = realpathSync(base);
+            }
+            catch {
+                /* root itself unresolvable; compare against the nominal base */
+            }
+            const relFromBase = relative(realBase, realPath);
+            // SEGMENT comparison, never a prefix test on a path-shaped string (r1
+            // round-3 F1: a file legitimately NAMED '..hidden-notes.md' inside the
+            // root satisfied startsWith('..') — the identical class as
+            // startsWith(base) saying /seat-evil is inside /seat, one level in).
+            const escapesRoot = relFromBase === ".." || relFromBase.startsWith(`..${sep}`) || isAbsolute(relFromBase);
+            opts.onRead({ ref, kind, base, nominalPath: abs, realPath, escapesRoot });
+        }
+        return text;
+    };
+}
+/** The composer's per-piece source label (Q2-Amendment 1: every assembled piece
+ *  is labeled with its source), derived from the atom's full address. */
+export function sourceKindForAddress(address) {
+    return parseSourceRef(parseAddress(address).ref).kind;
+}
+//# sourceMappingURL=profile-source-resolver.js.map

package/daemon/dist/domain/context-packs/profile-source-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-source-resolver.js","sourceRoot":"","sources":["../../../src/domain/context-packs/profile-source-resolver.ts"],"names":[],"mappings":"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"}

package/daemon/dist/domain/context-packs/seat-recap-store.d.ts

@@ -0,0 +1,48 @@
+export declare const RECAP_FILENAME = "RECAP.md";
+export declare class RecapWriteError extends Error {
+    constructor(message: string);
+}
+export interface RecapChainEntry {
+    /** Absolute path of the superseded recap. */
+    path: string;
+    /** The supersession timestamp encoded in the filename (ms epoch). */
+    supersededAtMs: number;
+    /** Same-millisecond disambiguator (1 for the bare name, 2+ for -N suffixes). */
+    sequence: number;
+}
+/** Write the seat's current recap, superseding any existing one into the
+ *  chain. The gate is ADDRESSABILITY only — never prose shape. */
+export declare function writeSeatRecap(opts: {
+    seatDir: string;
+    content: string;
+    now?: () => number;
+}): void;
+/** The superseded chain, oldest first. Empty when no recap was ever superseded. */
+export declare function listRecapChain(seatDir: string): RecapChainEntry[];
+export type RecapContractFinding = {
+    kind: "no-decisions-section";
+} | {
+    kind: "nonstandard-unverified-marker";
+    line: number;
+};
+/** The authoring contract's CHECKABLE subset (Q2): decisions-with-rationale has
+ *  a structural proxy (a decisions-titled section exists); the UNVERIFIED
+ *  marker has a canonical grammar (`UNVERIFIED:` uppercase) that must stay
+ *  findable — a variant marker hides exactly the fact it exists to flag.
+ *  Advisory: findings, never throws. */
+export declare function validateRecapContract(content: string): RecapContractFinding[];
+/** BUILD FOLLOW-UP (r1 verdict bb00e850; row 17015088) — the authored-recap
+ *  pointer resolution, ONE-HOMED here beside the store it reads, parsing the
+ *  seat ref through the CANONICAL parseSessionName (first-@ split, the
+ *  documented greedy-rig ruling) — never a second parser. Safety floor
+ *  preserved: an unresolved or non-canonical ref fails with a LABELED reason
+ *  carrying what was tried; fuzzy-matching another seat's directory would hand
+ *  a successor a DIFFERENT occupant's decisions, which is strictly worse than
+ *  honest absence. */
+export declare function resolveAuthoredRecapPointer(seatRef: string, topologyRoot: string): {
+    address: string;
+    chainLength: number;
+} | {
+    absentReason: string;
+};
+//# sourceMappingURL=seat-recap-store.d.ts.map

package/daemon/dist/domain/context-packs/seat-recap-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-recap-store.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/seat-recap-store.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,cAAc,aAAa,CAAC;AAGzC,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;kEACkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,IAAI,CA4BnG;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAiBjE;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,+BAA+B,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D;;;;wCAIwC;AACxC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAa7E;AAED;;;;;;;sBAOsB;AACtB,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAUrE"}