@openrig/cli 0.3.0 → 0.3.2

package/daemon/dist/domain/workspace/default-workspace-scaffold.js

@@ -1,18 +1,32 @@
+// V0.3.1 slice 21 onboarding-conveyor: rich narrative content for the
+// getting-started mission's two slices (the click-through-to-learn
+// teaching surface).
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { GETTING_STARTED_NARRATIVE } from "./getting-started-narrative.js";
+// Release-0.3.2 slice 01 (OPR.0.3.2.1) — seeded missions/slices now
+// carry §1 dot-IDs in frontmatter so the scaffold coheres with
+// `conventions/scope-and-versioning`. `getting-started` is a
+// non-release mission → escape band `OPR.99.0.1`; its slices fan out
+// as `OPR.99.0.1.<n>` (numbers monotonic, never reused).
 const DEFAULT_MISSIONS = [
     {
         id: "getting-started",
+        dotId: "OPR.99.0.1",
         title: "Getting Started",
         status: "active",
         objective: "Launch the conveyor starter and learn how OpenRig moves work through queue-backed slices.",
         slices: [
             {
                 id: "first-conveyor-run",
+                dotId: "OPR.99.0.1.1",
                 title: "First Conveyor Run",
                 status: "active",
                 objective: "Move one small packet through intake, planning, build, review, and close on the conveyor starter.",
             },
             {
                 id: "inspect-project-evidence",
+                dotId: "OPR.99.0.1.2",
                 title: "Inspect Project Evidence",
                 status: "draft",
                 objective: "Open Project, Queue, Story, and Tests to inspect the evidence created by the first conveyor run.",
@@ -39,7 +53,7 @@ export function workspaceScaffoldDirs() {
 function subdirReadmeContent(subdir) {
     switch (subdir) {
         case "missions":
-            return "# missions\n\nProject missions live here. Each mission folder maps to one Project mission in the UI and owns a `slices/` child folder.\n\nExpected shape:\n\n```text\nmissions/<mission-id>/README.md\nmissions/<mission-id>/PROGRESS.md\nmissions/<mission-id>/slices/<slice-id>/README.md\n```\n";
+            return "# missions\n\nProject missions live here. Each mission folder maps to one Project mission in the UI and owns a `slices/` child folder.\n\nExpected shape:\n\n```text\nmissions/<mission-name>/README.md\nmissions/<mission-name>/PROGRESS.md\nmissions/<mission-name>/slices/<slice-name>/README.md\n```\n\nEvery mission and slice README carries a stable dot-ID in its frontmatter (`id: OPR.<ver>[.<n>]`) per the scope-and-versioning convention. Use `rig scope mission create <name>` and `rig scope slice create <mission> <slug>` to mint conformant artifacts; the CLI handles the dot-ID + auto-numbering for you. The folder name is the operator-facing slug; the `id:` is the stable handle that survives renames.\n";
         case "artifacts":
             return "# artifacts\n\nWork products live here: plans, drafts, generated outputs, and other files that a slice may reference before closure.\n";
         case "evidence":
@@ -67,7 +81,7 @@ This workspace is file-backed. The Project UI mirrors this structure:
 - \`evidence/\` is for proof notes and verification summaries.
 - \`dogfood-evidence/<proof-packet-id>\` becomes Tests proof when the packet id contains the slice id tokens.
 
-Use stable kebab-case ids for mission and slice folders. Keep slice ids unique inside the workspace.
+Use stable kebab-case names for mission and slice folders. Every mission/slice README also carries a stable dot-ID in its frontmatter (\`id: OPR.<ver>[.<n>]\`) per the \`scope-and-versioning\` convention; mint conformant artifacts via \`rig scope mission create <name>\` and \`rig scope slice create <mission> <slug>\`. Folder names are operator-facing slugs; the \`id:\` is the rename-proof handle.
 `;
 const STEERING_PLACEHOLDER = `---
 title: Priority Stack
@@ -96,6 +110,7 @@ alongside your Project workspace.
 `;
 function missionReadme(mission) {
     return `---
+id: ${mission.dotId}
 title: ${mission.title}
 status: ${mission.status}
 mission: ${mission.id}
@@ -124,7 +139,24 @@ mission: ${mission.id}
 `;
 }
 function sliceReadme(mission, slice) {
+    // V0.3.1 slice 21: getting-started slices ship rich narrative
+    // content that teaches both "what a conveyor is" and "what each
+    // tab does". Other slices keep the boilerplate.
+    const narrative = GETTING_STARTED_NARRATIVE[slice.id];
+    if (narrative) {
+        return `---
+id: ${slice.dotId}
+title: ${slice.title}
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+${narrative.readme}`;
+    }
     return `---
+id: ${slice.dotId}
 title: ${slice.title}
 status: ${slice.status}
 mission: ${mission.id}
@@ -146,7 +178,23 @@ Queue items for this slice should mention or tag:
 This lets Project attach queue activity to the slice story, queue, tests, and topology tabs.
 `;
 }
+/** V0.3.1 slice 21: getting-started slices emit a timeline.md that
+ *  the slice Story tab renders via the slice-06 useSliceTimelineMarkdown
+ *  hook. Returns null when no narrative is defined for the slice id
+ *  (default mission slices don't ship a timeline). */
+function sliceTimeline(mission, slice) {
+    const narrative = GETTING_STARTED_NARRATIVE[slice.id];
+    if (!narrative)
+        return null;
+    return narrative.timeline;
+}
 function sliceProgress(mission, slice) {
+    // V0.3.1 slice 21: getting-started slices ship the worked-example
+    // PROGRESS narrative (acceptance criteria for a mocked conveyor run
+    // / inspection); other slices keep the boilerplate.
+    const narrative = GETTING_STARTED_NARRATIVE[slice.id];
+    if (narrative)
+        return narrative.progress;
     return `---
 title: ${slice.title} Progress
 status: ${slice.status}
@@ -184,6 +232,134 @@ ${slice.objective}
 - [ ] Any proof artifacts are referenced from the slice before closure.
 `;
 }
+// FR-5e A1 (daemon-side symmetry) — MISSION_NOTES template +
+// rendering for the daemon's `/api/config/init-workspace` route so
+// UI-driven init lands the same scaffold as CLI-driven init. The
+// template content is duplicated here from
+// packages/cli/src/lib/scope-templates/mission-notes.md to keep the
+// daemon side dependency-free of the cli package; a parity test in
+// getting-started-narrative-parity.test.ts asserts CLI + daemon emit
+// byte-identical MISSION_NOTES content given the same opts. Same
+// env-var-pivot pattern the CLI surface honors:
+// OPENRIG_MISSION_NOTES_TEMPLATE_PATH > built-in.
+const MISSION_NOTES_BUILT_IN = `---
+mission: {{mission_id}}
+name: {{mission_name}}
+status: active
+authored: {{created_date}}
+last-updated: {{created_date}}
+---
+
+# Mission Notes — {{mission_name}}
+
+> Read the frontmatter \`last-updated\` first. If stale relative to runtime,
+> treat this file as \`provisional\` and re-verify before relying on it.
+> Pointer-first by design — index durable canonical artifacts; don't duplicate
+> them (duplication is the stale-breadcrumb failure mode this convention
+> exists to kill).
+
+## §1. Top-of-mind context
+
+(Current most-load-bearing state — gates, open scope-decisions, in-flight
+surprises. Updated by anyone when material changes. Keep to 5-15 lines.)
+
+## §2. Active workstreams + drivers + tips
+
+(Per-workstream rows. THIS SECTION IS THE MISSION CODEMAP. Each row:
+state / driver / branch+tip-SHA / latest blocker or ACK.)
+
+- (workstream-id) — state — driver — tip-SHA — blocker/ACK
+
+## §3. Open scope-decisions
+
+(Labeled gates the operator owns. Per gate: where the gate is, what's needed,
+who routed.)
+
+- OQ-1: (decision needed) — gate at <artifact-path> — surfaced by <seat>
+
+## §4. Slice inventory
+
+(Full table of slices on this mission.)
+
+| # | slice | state | driver | blocker |
+|---|---|---|---|---|
+
+## §5. Pending dispatches
+
+(Next-go items waiting on driver availability or convergence. Immediately-ready
+set, not full backlog.)
+
+## §6. Ledgers
+
+(Mission-specific shared ledgers: release version + tag, SC counts, cumulative
+deltas, etc.)
+
+## §7. Banked memories that apply here
+
+(Bulleted: banked-feedback / banked-project memories load-bearing on restore
+for this mission. Ones learned during this mission go into the same list.)
+
+## §8. Convention pointers
+
+(Which banked conventions this mission inherits. Cross-reference each by path.
+This section is the principles/conventions inheritance surface for the mission.)
+
+- \`conventions/mission-notes/README.md\` — this convention (apply on every restore)
+
+## §9. Reconstruction protocol
+
+(Commands to run after compaction or for onboarding. Refresh as the mission's
+restore-needs evolve.)
+
+1. \`rig whoami --json\` — confirm seat identity
+2. Read this file's §1 + your §A-§X section + this §9
+3. Read \`missions/{{mission_id}}/README.md\` for mission scope
+4. Read \`missions/{{mission_id}}/PROGRESS.md\` for delivery state
+5. \`rig queue list --destination <your-session>\` — your durable inbox
+6. State "restored from {{mission_id}}; resumed at <action>" before acting
+
+## §10. What NOT to reconstruct
+
+(Explicit pruning — completed slices / merged commits / closed ACK packets are
+recoverable on demand and don't need to be in working memory. Name them to
+free attention.)
+
+## §A. <first-seat>@<rig> notes
+
+(First seat's notes. Pattern: append cont.N entries with date + state of the
+world from this seat's perspective. Latest = truth. Other seats READ but
+don't modify.)
+
+DONE {{created_date}} (cont.0 — mission scaffolded):
+- Mission scaffolded via \`rig scope mission create\`. Template applied; this
+  file is the seed state. First substantive cont.1 entry follows when work
+  begins.
+
+## §B / §C / ... — per-seat sections
+
+(Each additional seat adds an h2 ## §X section under their own header as they
+join. Section pattern matches §A.)
+`;
+function applyMissionNotesPlaceholders(content, opts) {
+    return content
+        .replace(/\{\{mission_id\}\}/g, opts.mission_id)
+        .replace(/\{\{mission_name\}\}/g, opts.mission_name)
+        .replace(/\{\{created_date\}\}/g, opts.created_date);
+}
+export function renderDaemonMissionNotes(opts) {
+    const envValue = process.env.OPENRIG_MISSION_NOTES_TEMPLATE_PATH;
+    if (envValue && envValue.trim().length > 0) {
+        const absPath = path.resolve(envValue.trim());
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`OPENRIG_MISSION_NOTES_TEMPLATE_PATH points at "${envValue}", which does not exist. ` +
+                "MISSION_NOTES.md not scaffolded. Set it to an absolute path to a readable template file, " +
+                "or unset it to use the built-in bundled fallback.");
+        }
+        const raw = fs.readFileSync(absPath, "utf8");
+        return applyMissionNotesPlaceholders(raw, opts);
+    }
+    return applyMissionNotesPlaceholders(MISSION_NOTES_BUILT_IN, opts);
+}
 export function workspaceScaffoldFiles() {
     const files = [
         { relPath: "README.md", content: WORKSPACE_README },
@@ -197,9 +373,31 @@ export function workspaceScaffoldFiles() {
         { relPath: "dogfood-evidence/README.md", content: subdirReadmeContent("dogfood-evidence") },
     ];
     for (const mission of DEFAULT_MISSIONS) {
-        files.push({ relPath: `missions/${mission.id}/README.md`, content: missionReadme(mission) }, { relPath: `missions/${mission.id}/PROGRESS.md`, content: missionProgress(mission) });
+        files.push({ relPath: `missions/${mission.id}/README.md`, content: missionReadme(mission) }, { relPath: `missions/${mission.id}/PROGRESS.md`, content: missionProgress(mission) }, 
+        // FR-5e A1 (daemon-side symmetry) — match CLI scaffold so UI-init
+        // produces a workspace that passes doctor check #7. The template
+        // resolution + env-var-pivot mirrors the CLI surface;
+        // getting-started-narrative-parity.test.ts asserts byte-identity.
+        {
+            relPath: `missions/${mission.id}/MISSION_NOTES.md`,
+            content: renderDaemonMissionNotes({
+                mission_id: mission.dotId,
+                mission_name: mission.title,
+                created_date: new Date().toISOString().slice(0, 10),
+            }),
+        });
         for (const slice of mission.slices) {
             files.push({ relPath: `missions/${mission.id}/slices/${slice.id}/README.md`, content: sliceReadme(mission, slice) }, { relPath: `missions/${mission.id}/slices/${slice.id}/PROGRESS.md`, content: sliceProgress(mission, slice) }, { relPath: `missions/${mission.id}/slices/${slice.id}/IMPLEMENTATION-PRD.md`, content: slicePrd(mission, slice) });
+            // V0.3.1 slice 21: getting-started slices ship a timeline.md
+            // so the Story tab renders the worked-example narrative via
+            // slice-06's useSliceTimelineMarkdown hook.
+            const timeline = sliceTimeline(mission, slice);
+            if (timeline) {
+                files.push({
+                    relPath: `missions/${mission.id}/slices/${slice.id}/timeline.md`,
+                    content: timeline,
+                });
+            }
         }
     }
     return files;

package/daemon/dist/domain/workspace/default-workspace-scaffold.js.map

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

package/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/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/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/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"}