@openrig/cli 0.2.0 → 0.3.1

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

@@ -0,0 +1,252 @@
+// 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 { GETTING_STARTED_NARRATIVE } from "./getting-started-narrative.js";
+const DEFAULT_MISSIONS = [
+    {
+        id: "getting-started",
+        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",
+                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",
+                title: "Inspect Project Evidence",
+                status: "draft",
+                objective: "Open Project, Queue, Story, and Tests to inspect the evidence created by the first conveyor run.",
+            },
+        ],
+    },
+];
+export function workspaceScaffoldDirs() {
+    return [
+        "missions",
+        "artifacts",
+        "evidence",
+        "progress",
+        "field-notes",
+        "specs",
+        "dogfood-evidence",
+        ...DEFAULT_MISSIONS.flatMap((mission) => [
+            `missions/${mission.id}`,
+            `missions/${mission.id}/slices`,
+            ...mission.slices.map((slice) => `missions/${mission.id}/slices/${slice.id}`),
+        ]),
+    ];
+}
+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";
+        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":
+            return "# evidence\n\nHuman-readable verification notes live here. Use this for compact proof summaries that are not tied to a screenshot or video packet.\n";
+        case "progress":
+            return "# progress\n\nPROGRESS.md tree. OpenRig's Progress browse view scans this directory recursively for PROGRESS.md files and renders them as a hierarchical tree.\n";
+        case "field-notes":
+            return "# field-notes\n\nOperator field notes. Free-form markdown notes from your daily work. OpenRig surfaces these alongside missions and slices for context.\n";
+        case "specs":
+            return "# specs\n\nWorkspace specs (rig specs / agent specs / workflow specs / context packs / skills). OpenRig's Library browses this directory alongside bundled specs.\n";
+        case "dogfood-evidence":
+            return "# dogfood-evidence\n\nProof packets live here. Each proof packet folder is matched to a Project slice by folder-name tokens and may contain markdown, screenshots, videos, traces, and other verification artifacts.\n";
+        default:
+            return `# ${subdir}\n`;
+    }
+}
+const WORKSPACE_README = `# OpenRig Workspace
+
+This workspace is file-backed. The Project UI mirrors this structure:
+
+- \`missions/<mission-id>\` becomes a Project mission.
+- \`missions/<mission-id>/slices/<slice-id>\` becomes a Project slice.
+- Queue items should mention or tag the mission id and slice id so Project can attach live work to the right slice.
+- \`artifacts/\` is for work products that a slice needs to keep.
+- \`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.
+`;
+const STEERING_PLACEHOLDER = `---
+title: Priority Stack
+status: placeholder
+---
+
+# OpenRig Priority Stack
+
+This file is a placeholder created by \`rig config init-workspace\`. Edit it
+to record your top priorities. OpenRig's Steering surface reads this file
+alongside your Project workspace.
+
+## Top 3
+
+1. Run the \`conveyor\` starter rig.
+2. Move one packet through \`basic-loop\` or \`conveyor\`.
+3. Inspect the Project, Queue, Story, and Tests surfaces.
+
+## In Motion
+
+(Active slices land here as you push them through the priority rail.)
+
+## Loop State
+
+(Health gates + loop diagnostics land here.)
+`;
+function missionReadme(mission) {
+    return `---
+title: ${mission.title}
+status: ${mission.status}
+mission: ${mission.id}
+---
+
+# ${mission.title}
+
+${mission.objective}
+
+## Slices
+
+${mission.slices.map((slice) => `- [${slice.title}](slices/${slice.id}/README.md)`).join("\n")}
+`;
+}
+function missionProgress(mission) {
+    return `---
+title: ${mission.title} Progress
+status: ${mission.status}
+mission: ${mission.id}
+---
+
+# ${mission.title} Progress
+
+- [ ] Keep mission README current.
+- [ ] Keep active slices queue-backed with mission and slice ids.
+`;
+}
+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 `---
+title: ${slice.title}
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+${narrative.readme}`;
+    }
+    return `---
+title: ${slice.title}
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+# ${slice.title}
+
+${slice.objective}
+
+## Queue Mapping
+
+Queue items for this slice should mention or tag:
+
+- mission: \`${mission.id}\`
+- slice: \`${slice.id}\`
+
+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}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+# ${slice.title} Progress
+
+- [ ] Define the next concrete packet.
+- [ ] Attach queue work to this slice id.
+- [ ] Capture proof or notes before closing.
+`;
+}
+function slicePrd(mission, slice) {
+    return `---
+title: ${slice.title} Implementation Notes
+status: ${slice.status}
+mission: ${mission.id}
+rail-item: ${mission.id}
+slice: ${slice.id}
+---
+
+# ${slice.title} Implementation Notes
+
+## Goal
+
+${slice.objective}
+
+## Acceptance
+
+- [ ] The work is visible in the Project slice.
+- [ ] Queue items include enough body or tag context to link back to \`${slice.id}\`.
+- [ ] Any proof artifacts are referenced from the slice before closure.
+`;
+}
+export function workspaceScaffoldFiles() {
+    const files = [
+        { relPath: "README.md", content: WORKSPACE_README },
+        { relPath: "STEERING.md", content: STEERING_PLACEHOLDER },
+        { relPath: "missions/README.md", content: subdirReadmeContent("missions") },
+        { relPath: "artifacts/README.md", content: subdirReadmeContent("artifacts") },
+        { relPath: "evidence/README.md", content: subdirReadmeContent("evidence") },
+        { relPath: "progress/README.md", content: subdirReadmeContent("progress") },
+        { relPath: "field-notes/README.md", content: subdirReadmeContent("field-notes") },
+        { relPath: "specs/README.md", content: subdirReadmeContent("specs") },
+        { 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) });
+        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;
+}
+//# sourceMappingURL=default-workspace-scaffold.js.map

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

@@ -0,0 +1 @@
+{"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/frontmatter-validator.d.ts

@@ -0,0 +1,40 @@
+import type { WorkspaceKind } from "../types.js";
+export type FrontmatterGapKind = "missing-required-field" | "unrecognized-status-value" | "parse-error" | "missing-frontmatter";
+export interface FrontmatterGap {
+    filePath: string;
+    /** Path relative to the validation root, for stable cross-machine output. */
+    relativePath: string;
+    kind: FrontmatterGapKind;
+    /** Field name when kind === "missing-required-field" or
+     *  "unrecognized-status-value"; null otherwise. */
+    field: string | null;
+    message: string;
+    /** Workspace kind the file was validated against (e.g. "knowledge"). */
+    workspaceKind: WorkspaceKind | null;
+}
+export interface FrontmatterValidationReport {
+    root: string;
+    /** Workspace kind applied to all files under this root. v0: caller picks
+     *  one root + one kind per invocation. */
+    workspaceKind: WorkspaceKind | null;
+    totalFiles: number;
+    filesWithFrontmatter: number;
+    gapCount: number;
+    gaps: FrontmatterGap[];
+}
+export interface ValidateOpts {
+    root: string;
+    workspaceKind?: WorkspaceKind;
+    /** When true, recurse into subdirectories. Defaults to true. */
+    recursive?: boolean;
+    /** When true, validate every .md file even if frontmatter is absent
+     *  (records a `missing-frontmatter` gap). Defaults to false — files
+     *  without `---` are skipped silently (treated as informal notes). */
+    requireFrontmatter?: boolean;
+    /** Hard cap on files walked. Defaults to 10000. Prevents accidental
+     *  multi-GB walks from runaway invocations. */
+    maxFiles?: number;
+}
+/** Run the frontmatter validator. */
+export declare function validateWorkspaceFrontmatter(opts: ValidateOpts): FrontmatterValidationReport;
+//# sourceMappingURL=frontmatter-validator.d.ts.map

package/daemon/dist/domain/workspace/frontmatter-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-validator.d.ts","sourceRoot":"","sources":["../../../src/domain/workspace/frontmatter-validator.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,2BAA2B,GAC3B,aAAa,GACb,qBAAqB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,kBAAkB,CAAC;IACzB;uDACmD;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb;8CAC0C;IAC1C,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,EAAE,CAAC;CACxB;AAaD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;0EAEsE;IACtE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;mDAC+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,YAAY,GAAG,2BAA2B,CAqD5F"}

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