@openrig/cli 0.2.0 → 0.3.1

package/daemon/dist/domain/skill-library-discovery.d.ts

@@ -0,0 +1,68 @@
+import type { AllowlistRoot } from "./files/path-safety.js";
+export type LibrarySkillSource = "workspace" | "openrig-managed";
+export interface LibrarySkillFile {
+    /** Filename only (no directory prefix). */
+    name: string;
+    /** Path relative to the skill folder root (e.g., "SKILL.md" or "examples/basic.md"). */
+    path: string;
+    /** File size in bytes. */
+    size: number;
+    /** Last-modified ISO timestamp. */
+    mtime: string;
+}
+export interface LibrarySkill {
+    /**
+     * Stable id including source + relative path within the source tree.
+     * Examples:
+     *   "openrig-managed:claude-compact-in-place" (flat skill at shared root)
+     *   "openrig-managed:core/openrig-user" (nested skill inside category)
+     *   "workspace:.openrig/skills/operator-skill" (workspace skill)
+     * Stable across daemon restarts as long as the disk layout is unchanged.
+     */
+    id: string;
+    /** Leaf skill folder name (e.g., "openrig-user"). */
+    name: string;
+    source: LibrarySkillSource;
+    /** Top-level markdown files in the skill folder (SKILL.md first if present). */
+    files: LibrarySkillFile[];
+    /** Absolute filesystem path to the skill folder. Slice 29 HG-4: surfaced
+     *  in the public response so operators see where the daemon reads each
+     *  skill from. The routes layer also uses this for the
+     *  /api/skills/:id/files/{list,read} endpoints. */
+    absolutePath: string;
+}
+/** Public response shape — preserves absolutePath for operator visibility
+ *  (slice 29 HG-4 file-path discoverability). */
+export type LibrarySkillPublic = LibrarySkill;
+export interface SkillLibraryDiscoveryOpts {
+    /**
+     * Absolute path to the daemon-installed shared-skills directory
+     * (typically `<daemon-install>/specs/agents/shared/skills`).
+     * Resolved by startup.ts via import.meta.url + relative resolve.
+     */
+    sharedSkillsDir: string;
+    /**
+     * Workspace allowlist roots (operator-declared via OPENRIG_FILES_ALLOWLIST).
+     * Workspace skills live at `<allowlist-root>/.openrig/skills/<skill-name>/`.
+     * Empty array → no workspace-source skills discovered (managed-only mode).
+     */
+    filesAllowlist: AllowlistRoot[];
+}
+export declare class SkillLibraryDiscoveryService {
+    private readonly opts;
+    constructor(opts: SkillLibraryDiscoveryOpts);
+    /**
+     * Returns the consolidated list of OpenRig-managed + workspace skills.
+     * Sources scanned:
+     *   - opts.sharedSkillsDir (daemon-known absolute path; openrig-managed)
+     *   - <opts.filesAllowlist root>/.openrig/skills/ for each root (workspace)
+     * Dedupe rule: managed wins over workspace when (source-key-collision).
+     * v0 collision shape is unusual; defensive only.
+     */
+    listLibrarySkills(): LibrarySkill[];
+    /** Lookup a single skill by its stable id. */
+    getSkill(id: string): LibrarySkill | null;
+    /** Public-facing list (strips absolutePath from each entry). */
+    listLibrarySkillsPublic(): LibrarySkillPublic[];
+}
+//# sourceMappingURL=skill-library-discovery.d.ts.map

package/daemon/dist/domain/skill-library-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-library-discovery.d.ts","sourceRoot":"","sources":["../../src/domain/skill-library-discovery.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,iBAAiB,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,gFAAgF;IAChF,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B;;;uDAGmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;iDACiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE9C,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAuFD,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,yBAAyB;IAE5D;;;;;;;OAOG;IACH,iBAAiB,IAAI,YAAY,EAAE;IAuCnC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIzC,gEAAgE;IAChE,uBAAuB,IAAI,kBAAkB,EAAE;CAGhD"}

package/daemon/dist/domain/skill-library-discovery.js

@@ -0,0 +1,144 @@
+// Slice 28 Checkpoint C-3 — SkillLibraryDiscoveryService.
+//
+// SC-29 EXCEPTION #11 (slice 28 library-explorer-finishing) — cumulative scope.
+// C-1 (plugin endpoints) declared #11 verbatim at routes/plugins.ts header.
+// This file extends the slice 28 surface with skill-library discovery to
+// close HG-5 / HG-7 / HG-8 / HG-9 cascade on the founder-walk VM (QA verdict
+// qitem-20260513045711-39ccfdf3): the operator's allowlist does not include
+// the daemon's source tree, so the prior /api/files-based useLibrarySkills
+// 3-path probe could not reach `packages/daemon/specs/agents/shared/skills`.
+//
+// Daemon-owned discovery: resolves shared-skills directory via the daemon's
+// install location (import.meta.url + ../specs/agents/shared/skills) +
+// optional workspace allowlist roots for user-defined skills at
+// `.openrig/skills/`. UI consumes /api/skills/library directly (1 fetch
+// replaces N-fetch probe). Symmetric with the plugin pattern from C-1.
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+const MAX_NESTING_DEPTH = 1;
+function isDir(absolutePath) {
+    try {
+        return statSync(absolutePath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function safeReaddir(absolutePath) {
+    try {
+        return readdirSync(absolutePath);
+    }
+    catch {
+        return [];
+    }
+}
+function collectMarkdownFiles(absoluteDir) {
+    const entries = [];
+    for (const name of safeReaddir(absoluteDir)) {
+        if (!/\.(md|mdx)$/i.test(name))
+            continue;
+        const fullPath = join(absoluteDir, name);
+        try {
+            const stat = statSync(fullPath);
+            if (!stat.isFile())
+                continue;
+            entries.push({
+                name,
+                path: name,
+                size: stat.size,
+                mtime: stat.mtime.toISOString(),
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return entries.sort((a, b) => {
+        if (a.name.toLowerCase() === "skill.md")
+            return -1;
+        if (b.name.toLowerCase() === "skill.md")
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+}
+/**
+ * Recursive skill discovery: walks a base directory and emits a LibrarySkill
+ * for every subdirectory that contains markdown files. Categories
+ * (subdirs without markdown but containing more subdirs) recurse one level
+ * up to MAX_NESTING_DEPTH (matches the on-disk shape of the shared-skills
+ * tree: flat skill folders + one level of category nesting like core/,
+ * pm/, pods/, process/).
+ *
+ * `idPrefix` is prepended to each emitted skill id (e.g., "openrig-managed:");
+ * `relativeId` accumulates the path-within-source for stable id construction.
+ */
+function collectSkillsRecursive(absoluteDir, source, idPrefix, relativeId, depth) {
+    const out = [];
+    for (const childName of safeReaddir(absoluteDir)) {
+        const childAbsolute = join(absoluteDir, childName);
+        if (!isDir(childAbsolute))
+            continue;
+        const childRelativeId = relativeId ? `${relativeId}/${childName}` : childName;
+        const files = collectMarkdownFiles(childAbsolute);
+        if (files.length > 0) {
+            // Leaf — this dir is a skill folder.
+            out.push({
+                id: `${idPrefix}${childRelativeId}`,
+                name: childName,
+                source,
+                files,
+                absolutePath: childAbsolute,
+            });
+        }
+        else if (depth < MAX_NESTING_DEPTH) {
+            // Category — recurse one level deeper.
+            out.push(...collectSkillsRecursive(childAbsolute, source, idPrefix, childRelativeId, depth + 1));
+        }
+        // else: empty leaf (no markdown, can't recurse further) — skip.
+    }
+    return out;
+}
+export class SkillLibraryDiscoveryService {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * Returns the consolidated list of OpenRig-managed + workspace skills.
+     * Sources scanned:
+     *   - opts.sharedSkillsDir (daemon-known absolute path; openrig-managed)
+     *   - <opts.filesAllowlist root>/.openrig/skills/ for each root (workspace)
+     * Dedupe rule: managed wins over workspace when (source-key-collision).
+     * v0 collision shape is unusual; defensive only.
+     */
+    listLibrarySkills() {
+        const all = [];
+        if (existsSync(this.opts.sharedSkillsDir)) {
+            all.push(...collectSkillsRecursive(this.opts.sharedSkillsDir, "openrig-managed", "openrig-managed:", "", 0));
+        }
+        for (const root of this.opts.filesAllowlist) {
+            const workspaceSkillsDir = join(root.canonicalPath, ".openrig", "skills");
+            if (!existsSync(workspaceSkillsDir))
+                continue;
+            // Workspace skills are identified by .openrig/skills/<name>/ paths.
+            // Skills under workspace allowlist roots are scanned at depth-0 only
+            // (workspace skill folders historically live flat, no category
+            // structure — but we recurse for consistency).
+            all.push(...collectSkillsRecursive(workspaceSkillsDir, "workspace", `workspace:${root.name}:`, "", 0));
+        }
+        return all.sort((a, b) => {
+            if (a.source !== b.source)
+                return a.source === "workspace" ? -1 : 1;
+            return a.name.localeCompare(b.name);
+        });
+    }
+    /** Lookup a single skill by its stable id. */
+    getSkill(id) {
+        return this.listLibrarySkills().find((s) => s.id === id) ?? null;
+    }
+    /** Public-facing list (strips absolutePath from each entry). */
+    listLibrarySkillsPublic() {
+        return this.listLibrarySkills();
+    }
+}
+//# sourceMappingURL=skill-library-discovery.js.map

package/daemon/dist/domain/skill-library-discovery.js.map

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

package/daemon/dist/domain/slices/slice-detail-projector.d.ts

@@ -0,0 +1,182 @@
+import type Database from "better-sqlite3";
+import type { SliceIndexer, SliceRecord, SliceProofPacket } from "./slice-indexer.js";
+import type { WorkflowSpecCache } from "../workflow-spec-cache.js";
+import { type SpecGraphPayload, type PhaseDefinition, type CurrentStepPayload } from "../workflow/slice-workflow-projection.js";
+export interface StoryEvent {
+    ts: string;
+    /** Spec-defined step.id when the event traces back through a workflow
+     *  step trail; null when the event is untagged (no trail mapping or
+     *  the slice has no bound workflow_instance). v1 removed the v0
+     *  hardcoded legacy phase enum. */
+    phase: string | null;
+    kind: string;
+    actorSession: string | null;
+    qitemId: string | null;
+    summary: string;
+    detail: Record<string, unknown> | null;
+}
+export interface AcceptanceItem {
+    text: string;
+    done: boolean;
+    source: {
+        file: string;
+        line: number;
+    };
+}
+export interface AcceptancePayload {
+    totalItems: number;
+    doneItems: number;
+    percentage: number;
+    items: AcceptanceItem[];
+    closureCallout: string | null;
+    /** v1 dimension #3: bound workflow_instance's current step + the
+     *  spec-declared allowed next steps. Null when the slice has no
+     *  bound instance (UI falls back to PROGRESS.md checkbox view only). */
+    currentStep: CurrentStepPayload | null;
+}
+export interface DecisionRow {
+    actionId: string;
+    ts: string;
+    actor: string;
+    verb: string;
+    qitemId: string;
+    reason: string | null;
+    beforeState: string | null;
+    afterState: string | null;
+}
+export interface DocsTreeEntry {
+    name: string;
+    type: "file" | "dir";
+    size: number | null;
+    mtime: string | null;
+    /** Relative path under the slice folder. */
+    relPath: string;
+}
+export interface ProofPacketRendered {
+    dirName: string;
+    /** Headline markdown file (latest mtime). */
+    primaryMarkdown: {
+        relPath: string;
+        content: string;
+    } | null;
+    /** All other markdown files in the proof packet directory (latest-first). */
+    additionalMarkdown: Array<{
+        relPath: string;
+        content: string;
+    }>;
+    /** Screenshot relative paths suitable for /api/slices/:name/proof-asset/<path> serving. */
+    screenshots: string[];
+    /** Video relative paths suitable for the <video> player. */
+    videos: string[];
+    /** Trace zip relative paths (download links only — not auto-rendered). */
+    traces: string[];
+    /** Heuristic pass/fail badge derived from primary markdown content. */
+    passFailBadge: "pass" | "fail" | "partial" | "unknown";
+}
+export interface TopologyRigEntry {
+    rigId: string;
+    rigName: string;
+    sessionNames: string[];
+}
+export interface TopologyPayload {
+    affectedRigs: TopologyRigEntry[];
+    /** Total unique seats touching the slice across all rigs. */
+    totalSeats: number;
+    /** v1 dimension #1: workflow_spec graph (nodes + edges) when the
+     *  slice is bound to a workflow_instance. Null when unbound (UI falls
+     *  back to the v0 per-rig session listing). */
+    specGraph: SpecGraphPayload | null;
+}
+export interface WorkflowBindingPayload {
+    instanceId: string;
+    workflowName: string;
+    workflowVersion: string;
+    status: string;
+    currentStepId: string | null;
+    currentFrontier: string[];
+    hopCount: number;
+    createdAt: string;
+    completedAt: string | null;
+    /** Other workflow_instances also touching this slice's qitem set;
+     *  v1 picks the most recent as the primary binding (per PRD), and
+     *  exposes the rest here so the UI can render a "+N more" indicator. */
+    additionalInstanceIds: string[];
+}
+export interface SliceDetailPayload {
+    name: string;
+    missionId: string | null;
+    slicePath: string;
+    displayName: string;
+    railItem: string | null;
+    status: string;
+    rawStatus: string | null;
+    qitemIds: string[];
+    commitRefs: string[];
+    lastActivityAt: string | null;
+    /** v1: bound workflow_instance metadata (most-recent if multiple),
+     *  null when no workflow_instance touches this slice's qitems. */
+    workflowBinding: WorkflowBindingPayload | null;
+    story: {
+        events: StoryEvent[];
+        /** v1 dimension #2: spec-declared phase definitions when bound;
+         *  null when unbound (UI falls back to ungrouped chronological). */
+        phaseDefinitions: PhaseDefinition[] | null;
+    };
+    acceptance: AcceptancePayload;
+    decisions: {
+        rows: DecisionRow[];
+    };
+    docs: {
+        tree: DocsTreeEntry[];
+    };
+    tests: {
+        proofPackets: ProofPacketRendered[];
+        aggregate: {
+            passCount: number;
+            failCount: number;
+        };
+    };
+    topology: TopologyPayload;
+}
+export interface SliceDetailProjectorOpts {
+    db: Database.Database;
+    indexer: SliceIndexer;
+    /** v1: optional WorkflowSpecCache used to resolve the bound
+     *  workflow_instance's spec for spec-graph + phase + current-step
+     *  projection. When omitted, the projector silently degrades to v0
+     *  behavior (everything renders as before; v1 fields are null). */
+    workflowSpecCache?: WorkflowSpecCache;
+}
+export declare class SliceDetailProjector {
+    private readonly db;
+    private readonly indexer;
+    private readonly workflowSpecCache;
+    constructor(opts: SliceDetailProjectorOpts);
+    project(slice: SliceRecord): SliceDetailPayload;
+    private tryGetSpec;
+    /**
+     * Builds a qitem_id → step_id map by reading the bound instance's
+     * workflow_step_trails. Each trail row's prior_qitem_id maps to the
+     * step that closed (`step_id`), and next_qitem_id maps to the
+     * subsequent step's first packet. Used by buildStory to tag each
+     * StoryEvent with the spec-defined phase the qitem traces back to.
+     */
+    private buildTrailQitemToStepMap;
+    private buildStory;
+    private buildAcceptance;
+    private buildDecisions;
+    private buildDocsTree;
+    /** Read a single doc file from the slice folder for the Docs tab. Returns null if missing or outside the slice folder. */
+    readDoc(sliceName: string, relPath: string): string | null;
+    private buildTests;
+    /**
+     * Read a proof-packet asset (markdown content or check existence of binary
+     * files like screenshots/videos). Path-traversal guarded by absPath prefix
+     * check.
+     */
+    readProofAsset(proofPacket: SliceProofPacket, relPath: string): string | null;
+    /** Returns the absolute on-disk path of a proof asset for binary serving. Path-traversal guarded. */
+    resolveProofAssetPath(proofPacket: SliceProofPacket, relPath: string): string | null;
+    private buildTopology;
+}
+//# sourceMappingURL=slice-detail-projector.d.ts.map

package/daemon/dist/domain/slices/slice-detail-projector.d.ts.map

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