@openrig/cli 0.1.12 → 0.3.0

package/daemon/dist/domain/workflow-types.d.ts.map

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

package/daemon/dist/domain/workflow-types.js

@@ -0,0 +1,11 @@
+// PL-004 Phase D: Workflow Runtime shared types.
+//
+// Reverse-engineered from POC `workflow-runtime-v0/lib/workflow-runtime.rb`
+// and POC fixture YAMLs (`workflow-runtime-v0/tests/fixtures/*.yaml`).
+//
+// Phase D scope is the v1 minimum: spec parsing, instance creation,
+// step projection, append-only step trail. Multi-hop chaining +
+// gate-return-sweep + complex routing tables are graduations
+// (per PRD § Risks "Workflow runtime over-engineered").
+export {};
+//# sourceMappingURL=workflow-types.js.map

package/daemon/dist/domain/workflow-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-types.js","sourceRoot":"","sources":["../../src/domain/workflow-types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,EAAE;AACF,oEAAoE;AACpE,gEAAgE;AAChE,6DAA6D;AAC7D,wDAAwD"}

package/daemon/dist/domain/workflow-validator.d.ts

@@ -0,0 +1,31 @@
+import type { WorkflowSpec } from "./workflow-types.js";
+export interface ValidationIssue {
+    code: string;
+    /** Plain-English what + why + what-to-do. */
+    message: string;
+    /** Field path (e.g., "workflow.steps[1].actor_role"). */
+    field?: string;
+    /** Severity: error blocks; warning is informational. */
+    severity: "error" | "warning";
+}
+export interface ValidationResult {
+    ok: boolean;
+    issues: ValidationIssue[];
+    summary: {
+        workflowId: string;
+        workflowVersion: string;
+        targetRig: string | null;
+        entryRole: string | null;
+        stepCount: number;
+    };
+}
+export interface SeatLivenessCheckFn {
+    (sessionRef: string): {
+        alive: boolean;
+        reason?: string;
+    };
+}
+export declare class WorkflowValidator {
+    validate(spec: WorkflowSpec, seatLivenessCheck?: SeatLivenessCheckFn): ValidationResult;
+}
+//# sourceMappingURL=workflow-validator.d.ts.map

package/daemon/dist/domain/workflow-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-validator.d.ts","sourceRoot":"","sources":["../../src/domain/workflow-validator.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,qBAAa,iBAAiB;IAC5B,QAAQ,CACN,IAAI,EAAE,YAAY,EAClB,iBAAiB,CAAC,EAAE,mBAAmB,GACtC,gBAAgB;CAkGpB"}

package/daemon/dist/domain/workflow-validator.js

@@ -0,0 +1,115 @@
+// PL-004 Phase D: workflow validator.
+//
+// Validates a workflow spec against:
+//   - Role resolution: every step's actor_role must reference a role
+//     declared in `roles`.
+//   - Entry resolution: workflow.entry.role (if present) must reference
+//     a declared role.
+//   - Exit consistency: every step's allowed_exits[] must be a subset of
+//     workflow.invariants.allowed_exits[] (if invariants present).
+//   - Step ID uniqueness.
+//
+// Seat-liveness checks are an optional v1 graduation; PRD § L4 calls
+// for them but the v1 minimum can ship without them. The validator
+// exposes a `seatLivenessCheck` callback so callers (CLI / route)
+// can inject a liveness probe; absence skips the check.
+//
+// Returns a structured ValidationResult — per PRD § Honest error
+// reporting "what failed + why it matters + what to do".
+export class WorkflowValidator {
+    validate(spec, seatLivenessCheck) {
+        const issues = [];
+        const declaredRoles = new Set(Object.keys(spec.roles ?? {}));
+        if (spec.entry?.role && !declaredRoles.has(spec.entry.role)) {
+            issues.push({
+                code: "entry_role_not_declared",
+                message: `entry role "${spec.entry.role}" is not declared in workflow.roles. Add the role to workflow.roles or change the entry to a declared role.`,
+                field: "workflow.entry.role",
+                severity: "error",
+            });
+        }
+        const seenStepIds = new Set();
+        const allowedExitsInvariant = spec.invariants?.allowed_exits;
+        spec.steps.forEach((step, idx) => {
+            const fieldBase = `workflow.steps[${idx}]`;
+            if (!step.id) {
+                issues.push({
+                    code: "step_id_missing",
+                    message: `step at ${fieldBase} is missing an id. Every step must have a stable id used to reference it from next_hop hints and step trails.`,
+                    field: `${fieldBase}.id`,
+                    severity: "error",
+                });
+                return;
+            }
+            if (seenStepIds.has(step.id)) {
+                issues.push({
+                    code: "step_id_duplicate",
+                    message: `duplicate step id "${step.id}" at ${fieldBase}. Step ids must be unique within a workflow.`,
+                    field: `${fieldBase}.id`,
+                    severity: "error",
+                });
+            }
+            seenStepIds.add(step.id);
+            if (!step.actor_role) {
+                issues.push({
+                    code: "step_actor_role_missing",
+                    message: `step "${step.id}" is missing actor_role. Declare which role drives this step so the projector can derive the next-step owner.`,
+                    field: `${fieldBase}.actor_role`,
+                    severity: "error",
+                });
+            }
+            else if (!declaredRoles.has(step.actor_role)) {
+                issues.push({
+                    code: "step_actor_role_not_declared",
+                    message: `step "${step.id}" references role "${step.actor_role}" which is not declared in workflow.roles. Add the role to workflow.roles or change the step.`,
+                    field: `${fieldBase}.actor_role`,
+                    severity: "error",
+                });
+            }
+            if (step.allowed_exits && allowedExitsInvariant) {
+                for (const exit of step.allowed_exits) {
+                    if (!allowedExitsInvariant.includes(exit)) {
+                        issues.push({
+                            code: "step_exit_not_allowed",
+                            message: `step "${step.id}" allows exit "${exit}" which is not in workflow.invariants.allowed_exits. Either remove the exit from the step or extend the invariant.`,
+                            field: `${fieldBase}.allowed_exits`,
+                            severity: "error",
+                        });
+                    }
+                }
+            }
+        });
+        if (seatLivenessCheck) {
+            // Probe each role's preferred_targets[]. A role with no live
+            // preferred target produces a warning (not an error) — agents
+            // can still be resolved at runtime via runtime-adapter / claim.
+            for (const [roleName, role] of Object.entries(spec.roles ?? {})) {
+                const targets = role?.preferred_targets ?? [];
+                if (targets.length === 0)
+                    continue;
+                const liveAny = targets.some((t) => seatLivenessCheck(t).alive);
+                if (!liveAny) {
+                    issues.push({
+                        code: "role_no_live_preferred_target",
+                        message: `role "${roleName}" has preferred_targets ${JSON.stringify(targets)} but none are live. The instance may stall at the first step requiring this role; ensure at least one target is up before instantiating, or rely on dynamic resolution at runtime.`,
+                        field: `workflow.roles.${roleName}.preferred_targets`,
+                        severity: "warning",
+                    });
+                }
+            }
+        }
+        const errors = issues.filter((i) => i.severity === "error");
+        return {
+            ok: errors.length === 0,
+            issues,
+            summary: {
+                workflowId: spec.id,
+                workflowVersion: spec.version,
+                targetRig: spec.target?.rig ?? null,
+                entryRole: spec.entry?.role ?? null,
+                stepCount: spec.steps.length,
+            },
+        };
+    }
+}
+//# sourceMappingURL=workflow-validator.js.map

package/daemon/dist/domain/workflow-validator.js.map

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

package/daemon/dist/domain/workspace/default-workspace-scaffold.d.ts

@@ -0,0 +1,6 @@
+export declare function workspaceScaffoldDirs(): string[];
+export declare function workspaceScaffoldFiles(): Array<{
+    relPath: string;
+    content: string;
+}>;
+//# sourceMappingURL=default-workspace-scaffold.d.ts.map

package/daemon/dist/domain/workspace/default-workspace-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-workspace-scaffold.d.ts","sourceRoot":"","sources":["../../../src/domain/workspace/default-workspace-scaffold.ts"],"names":[],"mappings":"AAsCA,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAehD;AA8JD,wBAAgB,sBAAsB,IAAI,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BpF"}

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

@@ -0,0 +1,207 @@
+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) {
+    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.
+`;
+}
+function sliceProgress(mission, slice) {
+    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) });
+        }
+    }
+    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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"}