@openrig/cli 0.5.0 → 0.5.1

package/node_modules/@openrig/daemon/dist/domain/workspace/frontmatter-validator.js

@@ -0,0 +1,185 @@
+// PL-007 Workspace Primitive v0 — frontmatter validator (advisory).
+//
+// Walks a workspace root, parses each .md file's YAML frontmatter
+// (delimited by `---` lines at the start of file), and validates per-kind
+// required fields. Outputs a structured gap report:
+//
+//   - missing-required-field
+//   - unrecognized-status-value
+//   - parse-error  (frontmatter present but malformed)
+//   - missing-frontmatter (no frontmatter delimiter found)
+//
+// Advisory only — never modifies files. curate-steward consumes the
+// gap report as hygiene input. The validator is deliberately minimal at
+// v0 (per PL-007 PRD); broken-cross-reference / non-conforming-structure
+// rules are deferred to v1+.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { WORKSPACE_KINDS } from "../types.js";
+const VALID_STATUS_VALUES = new Set(["active", "draft", "archived", "superseded"]);
+/** Per-kind required frontmatter fields. v0 minimum baseline (advisory). */
+const REQUIRED_FIELDS_BY_KIND = {
+    user: ["doc"],
+    project: ["doc"],
+    knowledge: ["doc", "status", "created", "owner"],
+    lab: ["doc", "status", "created", "owner"],
+    delivery: ["doc", "status", "created", "owner"],
+};
+/** Run the frontmatter validator. */
+export function validateWorkspaceFrontmatter(opts) {
+    const root = path.resolve(opts.root);
+    const recursive = opts.recursive ?? true;
+    const requireFrontmatter = opts.requireFrontmatter ?? false;
+    const maxFiles = opts.maxFiles ?? 10000;
+    const kind = isValidKind(opts.workspaceKind) ? opts.workspaceKind : null;
+    const gaps = [];
+    let totalFiles = 0;
+    let filesWithFrontmatter = 0;
+    const walk = (dir) => {
+        if (totalFiles >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (totalFiles >= maxFiles)
+                return;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!recursive)
+                    continue;
+                // Skip noise dirs that aren't canon: node_modules, .git, .worktrees,
+                // dist/build artifacts. Authors writing canon don't put these here.
+                if (entry.name === "node_modules" ||
+                    entry.name === ".git" ||
+                    entry.name === ".worktrees" ||
+                    entry.name === "dist" ||
+                    entry.name === "build")
+                    continue;
+                walk(full);
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            totalFiles++;
+            const result = validateFile(full, root, kind, requireFrontmatter);
+            if (result.hasFrontmatter)
+                filesWithFrontmatter++;
+            gaps.push(...result.gaps);
+        }
+    };
+    walk(root);
+    return {
+        root,
+        workspaceKind: kind,
+        totalFiles,
+        filesWithFrontmatter,
+        gapCount: gaps.length,
+        gaps,
+    };
+}
+function isValidKind(k) {
+    return typeof k === "string" && WORKSPACE_KINDS.includes(k);
+}
+function validateFile(filePath, root, kind, requireFrontmatter) {
+    const relativePath = path.relative(root, filePath);
+    const out = { hasFrontmatter: false, gaps: [] };
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return out;
+    }
+    const fm = extractFrontmatter(raw);
+    if (!fm.found) {
+        if (requireFrontmatter) {
+            out.gaps.push({
+                filePath,
+                relativePath,
+                kind: "missing-frontmatter",
+                field: null,
+                message: "no frontmatter delimiter (---) found at start of file",
+                workspaceKind: kind,
+            });
+        }
+        return out;
+    }
+    out.hasFrontmatter = true;
+    let parsed;
+    try {
+        parsed = parseYaml(fm.body);
+    }
+    catch (err) {
+        out.gaps.push({
+            filePath,
+            relativePath,
+            kind: "parse-error",
+            field: null,
+            message: err instanceof Error ? err.message : "YAML parse error",
+            workspaceKind: kind,
+        });
+        return out;
+    }
+    if (!parsed || typeof parsed !== "object") {
+        out.gaps.push({
+            filePath,
+            relativePath,
+            kind: "parse-error",
+            field: null,
+            message: "frontmatter is not a YAML object",
+            workspaceKind: kind,
+        });
+        return out;
+    }
+    if (kind) {
+        const required = REQUIRED_FIELDS_BY_KIND[kind];
+        for (const field of required) {
+            if (!(field in parsed) || parsed[field] === null || parsed[field] === undefined || parsed[field] === "") {
+                out.gaps.push({
+                    filePath,
+                    relativePath,
+                    kind: "missing-required-field",
+                    field,
+                    message: `${kind} canon requires "${field}" frontmatter field`,
+                    workspaceKind: kind,
+                });
+            }
+        }
+        // status enum check (only when status is present + a string)
+        if (typeof parsed["status"] === "string" && !VALID_STATUS_VALUES.has(parsed["status"])) {
+            out.gaps.push({
+                filePath,
+                relativePath,
+                kind: "unrecognized-status-value",
+                field: "status",
+                message: `status "${parsed["status"]}" is not one of: ${[...VALID_STATUS_VALUES].join(", ")}`,
+                workspaceKind: kind,
+            });
+        }
+    }
+    return out;
+}
+/** Extract YAML frontmatter delimited by `---` lines. The opening `---`
+ *  must be on the first line. Returns the frontmatter body (between the
+ *  delimiters) when found. */
+function extractFrontmatter(raw) {
+    if (!raw.startsWith("---"))
+        return { found: false, body: "" };
+    // Find the closing delimiter, allowing both LF and CRLF line endings.
+    const lines = raw.split(/\r?\n/);
+    if (lines[0].trim() !== "---")
+        return { found: false, body: "" };
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+            return { found: true, body: lines.slice(1, i).join("\n") };
+        }
+    }
+    return { found: false, body: "" };
+}
+//# sourceMappingURL=frontmatter-validator.js.map

package/node_modules/@openrig/daemon/dist/domain/workspace/frontmatter-validator.js.map

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

package/node_modules/@openrig/daemon/dist/domain/workspace/getting-started-narrative.d.ts

@@ -0,0 +1,15 @@
+export declare const FIRST_CONVEYOR_RUN_README = "# First Conveyor Run\n\nWelcome to OpenRig. This is the first slice in your getting-started mission. It exists to teach you what a **conveyor run** is + how OpenRig moves work through a multi-agent topology.\n\n## What a conveyor run is\n\nA **conveyor** is OpenRig's central work-movement primitive. One conveyor run = one complete flow of work through your topology:\n\n1. **Slice declared** \u2014 operator (you) or an agent declares a slice with intent + acceptance criteria\n2. **Work routed** \u2014 orchestrator picks the slice up + routes it to the right agent\n3. **Agents collaborate** \u2014 work moves agent-to-agent via durable handoffs (queue items)\n4. **Evidence accumulates** \u2014 each step leaves a trail: commits, files, proof packets, screenshots\n5. **Slice closes** \u2014 acceptance criteria met; orchestrator routes the result back\n\nYou're looking at a mocked conveyor run RIGHT NOW. The other tabs (Story / Progress / Artifacts / Tests / Queue / Topology) each show a different slice of this same run.\n\n## Walking the tabs\n\n- **Overview** (you're here) \u2014 read what a slice intends + how to use the rest of the tabs\n- **Story** \u2014 narrative timeline of what happened, beat by beat\n- **Progress** \u2014 acceptance checklist; what's done, what's pending\n- **Artifacts** \u2014 files produced, commits, proof packets \u2014 the durable evidence trail\n- **Tests** \u2014 pass/fail summaries + screenshots + verification proof\n- **Queue** \u2014 operational qitems showing how work moved between agents\n- **Topology** \u2014 the rig graph; which agents touched this slice + which edges fired\n\n## Click through\n\nTry them in order. Each tab teaches itself.\n";
+export declare const FIRST_CONVEYOR_RUN_TIMELINE = "# Story \u2014 First Conveyor Run\n\n## 2026-04-15 09:00 \u2014 Slice declared\n\nOperator request: \"Build a CLI tool that lints todo lists.\" Slice declared in `getting-started/slices/first-conveyor-run/`. Acceptance: `tdl lint <file>` exits non-zero on malformed entries.\n\n## 09:02 \u2014 Orchestrator routes\n\n`orch-lead@getting-started` picks up the slice. Routes to `driver@getting-started` via `rig queue handoff`. Driver receives nudge; opens IMPL-PRD; reads acceptance.\n\n## 09:05 \u2014 Driver picks up\n\nDriver claims qitem. Reads slice scope. Surveys existing tdl repo (this is a worked example \u2014 imagine the repo is real). Plans: parse YAML; validate entries; exit code per finding.\n\n## 09:30 \u2014 First commit\n\n`feat(lint): parse + validate todo entries` \u2014 driver commits 4 files. Stream event emitted; visible in Artifacts tab.\n\n## 10:15 \u2014 Driver hands to reviewer\n\nAcceptance met locally. Driver hands off to `reviewer@getting-started`. Reviewer opens diff; reads tests.\n\n## 10:25 \u2014 Reviewer flags concern\n\n\"Edge case: what about UTF-8 entries with combining characters?\" Hands back to driver as `concerning`.\n\n## 10:40 \u2014 Driver addresses\n\nDriver fixes UTF-8 handling. Re-runs tests; all pass. Hands back.\n\n## 11:00 \u2014 Reviewer accepts\n\n`accept` decision; closes qitem with `closure-reason: handed_off_to orch-lead`. Conveyor proceeds.\n\n## 11:05 \u2014 Slice ships\n\nOrchestrator merges. Proof packet generated. Slice marked SHIPPED.\n\n---\n\n**What you just read**: one conveyor run from declaration to ship. ~2 hours wall-clock; 3 agents involved; 1 handoff with concern + remediation; 5 stream events; 1 proof packet.\n\nThe Story tab shows this kind of narrative for any real slice. Driver-authored `timeline.md` files live in each slice folder; this is yours to read + your operator's to update as work moves.\n";
+export declare const FIRST_CONVEYOR_RUN_PROGRESS = "---\ntitle: First Conveyor Run Progress\nstatus: active\nmission: getting-started\nrail-item: getting-started\nslice: first-conveyor-run\n---\n\n# Progress \u2014 First Conveyor Run\n\n## Acceptance criteria\n\n- [x] Parse YAML todo entries\n- [x] Validate per-entry shape (id, title, status, due-date)\n- [x] Exit non-zero on malformed entries\n- [x] Handle UTF-8 entries with combining characters\n- [x] Tests pass (12/12)\n- [x] Reviewer accepts\n- [x] Slice merged\n\n## Status: SHIPPED\n\nThis was a mocked conveyor run \u2014 no real code was produced. But the Progress tab works the same way for real work: as acceptance criteria are met, boxes get checked; the operator can scan at a glance whether the slice is on track.\n\n## How the Progress tab works\n\nThe tab renders the slice's `PROGRESS.md` markdown file. Driver updates it as work progresses. Operator scans it during walks. Founder reviews at slice closure.\n\nTry writing one for a real slice you start. It's just markdown; live updates appear here.\n";
+export declare const INSPECT_PROJECT_EVIDENCE_README = "# Inspect Project Evidence\n\nThe previous slice (First Conveyor Run) showed you what a conveyor run looks like as it happens. This slice teaches you how to inspect the evidence after a run completes.\n\n## Why inspect evidence?\n\nIn OpenRig, agents work autonomously. The operator (you) doesn't watch every keystroke. Instead, the operator:\n\n1. Declares slices with clear acceptance\n2. Routes them to agents\n3. Inspects evidence when slices close\n\nThe Artifacts + Tests + Queue + Topology tabs are your inspection surface. They show you what happened, with enough detail to:\n\n- Verify the acceptance was actually met\n- Spot subtle issues a passing test might miss\n- Build trust in the agents over time\n\n## Walking the tabs\n\n- **Overview** \u2014 you're here; learn what to look for\n- **Story** \u2014 read the narrative of what happened (high-level)\n- **Progress** \u2014 acceptance status at a glance\n- **Artifacts** \u2014 the durable evidence: files, commits, proof packets. **THIS IS THE TAB YOU LEARN MOST FROM.**\n- **Tests** \u2014 pass/fail + screenshots + verification proof\n- **Queue** \u2014 who handed what to whom (audit trail of decisions)\n- **Topology** \u2014 which agents touched this; which edges fired\n\n## Key inspection skills\n\nWhen walking a finished slice:\n\n1. **Read the Story** for context \u2014 what was the operator trying to do?\n2. **Check Progress** \u2014 did acceptance actually pass? Any TODO boxes?\n3. **Open Artifacts \u2192 Files** \u2014 sample-read 2-3 files; does the code match what the Story claimed?\n4. **Open Tests \u2192 Proof packets** \u2014 do screenshots actually show what was claimed?\n5. **Read Queue** \u2014 were there concerning decisions? Hand-offs to escalation?\n6. **Skim Topology** \u2014 were unexpected agents involved?\n\nTrust comes from repeated successful inspections, not from a single proof packet.\n";
+export declare const INSPECT_PROJECT_EVIDENCE_TIMELINE = "# Story \u2014 Inspect Project Evidence\n\nThis slice mirrors the previous one (First Conveyor Run). The same agents shipped the same work. But this view is from the inspector's angle, not the runner's.\n\n## 11:10 \u2014 Operator opens project\n\nOperator (you, in the real world) opens `/project/slice/first-conveyor-run` after the slice ships. First read: the Progress tab. All boxes checked.\n\n## 11:12 \u2014 Read Story\n\nOperator reads the Story narrative. Notices the reviewer's UTF-8 concern + driver's remediation. Confidence-building: there was friction, friction was caught, friction was addressed.\n\n## 11:15 \u2014 Open Artifacts\n\nOperator clicks Artifacts. Sees 4 commits, 5 files, 1 proof packet, 2 screenshots. Opens commit `feat(lint): parse + validate todo entries`. Reads the diff.\n\n## 11:18 \u2014 Read tests\n\nOperator opens Tests tab. 12/12 passing. Opens the proof packet \u2014 screenshot shows CLI output `Error: malformed entry at line 3`. Visually verifies the acceptance was met.\n\n## 11:22 \u2014 Skim Queue\n\nOperator scrolls Queue. 4 qitems in chronological order. Sees the `concerning` decision + subsequent `accept`. Confidence reinforced.\n\n## 11:25 \u2014 Mark complete\n\nOperator marks slice acceptance complete. Closes the inspection.\n\n---\n\n**What you just read**: a clean inspection in ~15 minutes. Operator builds trust through the evidence trail. This is the OpenRig usage pattern at scale: declare \u2192 route \u2192 inspect.\n";
+export declare const INSPECT_PROJECT_EVIDENCE_PROGRESS = "---\ntitle: Inspect Project Evidence Progress\nstatus: active\nmission: getting-started\nrail-item: getting-started\nslice: inspect-project-evidence\n---\n\n# Progress \u2014 Inspect Project Evidence\n\n## Inspection checklist\n\n- [x] Read Story (context: what was being done)\n- [x] Check Progress (acceptance status)\n- [x] Sample-read Artifacts files\n- [x] Verify Tests proof packets visually\n- [x] Skim Queue for concerning decisions\n- [x] Skim Topology for unexpected agents\n\n## Status: COMPLETE\n\nThis was a mocked inspection \u2014 a worked example of the inspection workflow.\n\n## How to apply this\n\nFor any real slice that ships in YOUR project: open the slice page, walk the tabs in this order, check each box mentally. Over time you'll develop instincts for what passes the smell test vs what needs deeper investigation.\n";
+/** Slice id → narrative content map. Scaffold callers use this to
+ *  override the boilerplate sliceReadme / sliceProgress for the two
+ *  getting-started slices. Other slices keep the boilerplate. */
+export declare const GETTING_STARTED_NARRATIVE: Record<string, {
+    readme: string;
+    timeline: string;
+    progress: string;
+}>;
+//# sourceMappingURL=getting-started-narrative.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/workspace/getting-started-narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getting-started-narrative.d.ts","sourceRoot":"","sources":["../../../src/domain/workspace/getting-started-narrative.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,yBAAyB,4qDA6BrC,CAAC;AAEF,eAAO,MAAM,2BAA2B,22DA2CvC,CAAC;AAEF,eAAO,MAAM,2BAA2B,kgCA6BvC,CAAC;AAEF,eAAO,MAAM,+BAA+B,62DAwC3C,CAAC;AAEF,eAAO,MAAM,iCAAiC,k9CA+B7C,CAAC;AAEF,eAAO,MAAM,iCAAiC,g1BA0B7C,CAAC;AAEF;;iEAEiE;AACjE,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,MAAM,EACN;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAYvD,CAAC"}

package/node_modules/@openrig/daemon/dist/domain/workspace/getting-started-narrative.js

@@ -0,0 +1,237 @@
+// V0.3.1 slice 21 onboarding-conveyor.
+//
+// Narrative tab content for the getting-started mission's two slices.
+// The scaffold writes these as README.md / timeline.md / PROGRESS.md
+// inside each slice folder so a new operator's fresh install ships
+// with a click-through-to-learn experience: opening each tab teaches
+// both (a) what a conveyor run is and (b) what each Project tab does.
+//
+// PARITY CONTRACT with CLI:
+// `packages/cli/src/commands/config-init-workspace.ts` duplicates the
+// same narrative inline because cli + daemon don't cross-import today.
+// `packages/daemon/test/getting-started-narrative-parity.test.ts`
+// asserts byte-identical content with the CLI counterpart so drift
+// fails CI. If you update this content, update the CLI mirror in
+// lockstep.
+//
+// Content authored from the slice 21 onboarding-conveyor IMPLEMENTATION-PRD (Appendix A) in the substrate openrig-work tree.
+export const FIRST_CONVEYOR_RUN_README = `# First Conveyor Run
+
+Welcome to OpenRig. This is the first slice in your getting-started mission. It exists to teach you what a **conveyor run** is + how OpenRig moves work through a multi-agent topology.
+
+## What a conveyor run is
+
+A **conveyor** is OpenRig's central work-movement primitive. One conveyor run = one complete flow of work through your topology:
+
+1. **Slice declared** — operator (you) or an agent declares a slice with intent + acceptance criteria
+2. **Work routed** — orchestrator picks the slice up + routes it to the right agent
+3. **Agents collaborate** — work moves agent-to-agent via durable handoffs (queue items)
+4. **Evidence accumulates** — each step leaves a trail: commits, files, proof packets, screenshots
+5. **Slice closes** — acceptance criteria met; orchestrator routes the result back
+
+You're looking at a mocked conveyor run RIGHT NOW. The other tabs (Story / Progress / Artifacts / Tests / Queue / Topology) each show a different slice of this same run.
+
+## Walking the tabs
+
+- **Overview** (you're here) — read what a slice intends + how to use the rest of the tabs
+- **Story** — narrative timeline of what happened, beat by beat
+- **Progress** — acceptance checklist; what's done, what's pending
+- **Artifacts** — files produced, commits, proof packets — the durable evidence trail
+- **Tests** — pass/fail summaries + screenshots + verification proof
+- **Queue** — operational qitems showing how work moved between agents
+- **Topology** — the rig graph; which agents touched this slice + which edges fired
+
+## Click through
+
+Try them in order. Each tab teaches itself.
+`;
+export const FIRST_CONVEYOR_RUN_TIMELINE = `# Story — First Conveyor Run
+
+## 2026-04-15 09:00 — Slice declared
+
+Operator request: "Build a CLI tool that lints todo lists." Slice declared in \`getting-started/slices/first-conveyor-run/\`. Acceptance: \`tdl lint <file>\` exits non-zero on malformed entries.
+
+## 09:02 — Orchestrator routes
+
+\`orch-lead@getting-started\` picks up the slice. Routes to \`driver@getting-started\` via \`rig queue handoff\`. Driver receives nudge; opens IMPL-PRD; reads acceptance.
+
+## 09:05 — Driver picks up
+
+Driver claims qitem. Reads slice scope. Surveys existing tdl repo (this is a worked example — imagine the repo is real). Plans: parse YAML; validate entries; exit code per finding.
+
+## 09:30 — First commit
+
+\`feat(lint): parse + validate todo entries\` — driver commits 4 files. Stream event emitted; visible in Artifacts tab.
+
+## 10:15 — Driver hands to reviewer
+
+Acceptance met locally. Driver hands off to \`reviewer@getting-started\`. Reviewer opens diff; reads tests.
+
+## 10:25 — Reviewer flags concern
+
+"Edge case: what about UTF-8 entries with combining characters?" Hands back to driver as \`concerning\`.
+
+## 10:40 — Driver addresses
+
+Driver fixes UTF-8 handling. Re-runs tests; all pass. Hands back.
+
+## 11:00 — Reviewer accepts
+
+\`accept\` decision; closes qitem with \`closure-reason: handed_off_to orch-lead\`. Conveyor proceeds.
+
+## 11:05 — Slice ships
+
+Orchestrator merges. Proof packet generated. Slice marked SHIPPED.
+
+---
+
+**What you just read**: one conveyor run from declaration to ship. ~2 hours wall-clock; 3 agents involved; 1 handoff with concern + remediation; 5 stream events; 1 proof packet.
+
+The Story tab shows this kind of narrative for any real slice. Driver-authored \`timeline.md\` files live in each slice folder; this is yours to read + your operator's to update as work moves.
+`;
+export const FIRST_CONVEYOR_RUN_PROGRESS = `---
+title: First Conveyor Run Progress
+status: active
+mission: getting-started
+rail-item: getting-started
+slice: first-conveyor-run
+---
+
+# Progress — First Conveyor Run
+
+## Acceptance criteria
+
+- [x] Parse YAML todo entries
+- [x] Validate per-entry shape (id, title, status, due-date)
+- [x] Exit non-zero on malformed entries
+- [x] Handle UTF-8 entries with combining characters
+- [x] Tests pass (12/12)
+- [x] Reviewer accepts
+- [x] Slice merged
+
+## Status: SHIPPED
+
+This was a mocked conveyor run — no real code was produced. But the Progress tab works the same way for real work: as acceptance criteria are met, boxes get checked; the operator can scan at a glance whether the slice is on track.
+
+## How the Progress tab works
+
+The tab renders the slice's \`PROGRESS.md\` markdown file. Driver updates it as work progresses. Operator scans it during walks. Founder reviews at slice closure.
+
+Try writing one for a real slice you start. It's just markdown; live updates appear here.
+`;
+export const INSPECT_PROJECT_EVIDENCE_README = `# Inspect Project Evidence
+
+The previous slice (First Conveyor Run) showed you what a conveyor run looks like as it happens. This slice teaches you how to inspect the evidence after a run completes.
+
+## Why inspect evidence?
+
+In OpenRig, agents work autonomously. The operator (you) doesn't watch every keystroke. Instead, the operator:
+
+1. Declares slices with clear acceptance
+2. Routes them to agents
+3. Inspects evidence when slices close
+
+The Artifacts + Tests + Queue + Topology tabs are your inspection surface. They show you what happened, with enough detail to:
+
+- Verify the acceptance was actually met
+- Spot subtle issues a passing test might miss
+- Build trust in the agents over time
+
+## Walking the tabs
+
+- **Overview** — you're here; learn what to look for
+- **Story** — read the narrative of what happened (high-level)
+- **Progress** — acceptance status at a glance
+- **Artifacts** — the durable evidence: files, commits, proof packets. **THIS IS THE TAB YOU LEARN MOST FROM.**
+- **Tests** — pass/fail + screenshots + verification proof
+- **Queue** — who handed what to whom (audit trail of decisions)
+- **Topology** — which agents touched this; which edges fired
+
+## Key inspection skills
+
+When walking a finished slice:
+
+1. **Read the Story** for context — what was the operator trying to do?
+2. **Check Progress** — did acceptance actually pass? Any TODO boxes?
+3. **Open Artifacts → Files** — sample-read 2-3 files; does the code match what the Story claimed?
+4. **Open Tests → Proof packets** — do screenshots actually show what was claimed?
+5. **Read Queue** — were there concerning decisions? Hand-offs to escalation?
+6. **Skim Topology** — were unexpected agents involved?
+
+Trust comes from repeated successful inspections, not from a single proof packet.
+`;
+export const INSPECT_PROJECT_EVIDENCE_TIMELINE = `# Story — Inspect Project Evidence
+
+This slice mirrors the previous one (First Conveyor Run). The same agents shipped the same work. But this view is from the inspector's angle, not the runner's.
+
+## 11:10 — Operator opens project
+
+Operator (you, in the real world) opens \`/project/slice/first-conveyor-run\` after the slice ships. First read: the Progress tab. All boxes checked.
+
+## 11:12 — Read Story
+
+Operator reads the Story narrative. Notices the reviewer's UTF-8 concern + driver's remediation. Confidence-building: there was friction, friction was caught, friction was addressed.
+
+## 11:15 — Open Artifacts
+
+Operator clicks Artifacts. Sees 4 commits, 5 files, 1 proof packet, 2 screenshots. Opens commit \`feat(lint): parse + validate todo entries\`. Reads the diff.
+
+## 11:18 — Read tests
+
+Operator opens Tests tab. 12/12 passing. Opens the proof packet — screenshot shows CLI output \`Error: malformed entry at line 3\`. Visually verifies the acceptance was met.
+
+## 11:22 — Skim Queue
+
+Operator scrolls Queue. 4 qitems in chronological order. Sees the \`concerning\` decision + subsequent \`accept\`. Confidence reinforced.
+
+## 11:25 — Mark complete
+
+Operator marks slice acceptance complete. Closes the inspection.
+
+---
+
+**What you just read**: a clean inspection in ~15 minutes. Operator builds trust through the evidence trail. This is the OpenRig usage pattern at scale: declare → route → inspect.
+`;
+export const INSPECT_PROJECT_EVIDENCE_PROGRESS = `---
+title: Inspect Project Evidence Progress
+status: active
+mission: getting-started
+rail-item: getting-started
+slice: inspect-project-evidence
+---
+
+# Progress — Inspect Project Evidence
+
+## Inspection checklist
+
+- [x] Read Story (context: what was being done)
+- [x] Check Progress (acceptance status)
+- [x] Sample-read Artifacts files
+- [x] Verify Tests proof packets visually
+- [x] Skim Queue for concerning decisions
+- [x] Skim Topology for unexpected agents
+
+## Status: COMPLETE
+
+This was a mocked inspection — a worked example of the inspection workflow.
+
+## How to apply this
+
+For any real slice that ships in YOUR project: open the slice page, walk the tabs in this order, check each box mentally. Over time you'll develop instincts for what passes the smell test vs what needs deeper investigation.
+`;
+/** Slice id → narrative content map. Scaffold callers use this to
+ *  override the boilerplate sliceReadme / sliceProgress for the two
+ *  getting-started slices. Other slices keep the boilerplate. */
+export const GETTING_STARTED_NARRATIVE = {
+    "first-conveyor-run": {
+        readme: FIRST_CONVEYOR_RUN_README,
+        timeline: FIRST_CONVEYOR_RUN_TIMELINE,
+        progress: FIRST_CONVEYOR_RUN_PROGRESS,
+    },
+    "inspect-project-evidence": {
+        readme: INSPECT_PROJECT_EVIDENCE_README,
+        timeline: INSPECT_PROJECT_EVIDENCE_TIMELINE,
+        progress: INSPECT_PROJECT_EVIDENCE_PROGRESS,
+    },
+};
+//# sourceMappingURL=getting-started-narrative.js.map

package/node_modules/@openrig/daemon/dist/domain/workspace/getting-started-narrative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getting-started-narrative.js","sourceRoot":"","sources":["../../../src/domain/workspace/getting-started-narrative.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,sEAAsE;AACtE,qEAAqE;AACrE,mEAAmE;AACnE,qEAAqE;AACrE,sEAAsE;AACtE,EAAE;AACF,4BAA4B;AAC5B,sEAAsE;AACtE,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,iEAAiE;AACjE,YAAY;AACZ,EAAE;AACF,6HAA6H;AAE7H,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BxC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C1C,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B1C,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC9C,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BhD,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BhD,CAAC;AAEF;;iEAEiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAGlC;IACF,oBAAoB,EAAE;QACpB,MAAM,EAAE,yBAAyB;QACjC,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,2BAA2B;KACtC;IACD,0BAA0B,EAAE;QAC1B,MAAM,EAAE,+BAA+B;QACvC,QAAQ,EAAE,iCAAiC;QAC3C,QAAQ,EAAE,iCAAiC;KAC5C;CACF,CAAC"}