@openrig/cli 0.3.0 → 0.3.2

package/dist/lib/scope/types.d.ts

@@ -0,0 +1,61 @@
+/** Scope tiers. v0 ships `mission` + `slice`; `project` and `sub-slice`
+ *  exist in the grammar but have no CLI verbs yet. */
+export type ScopeTier = "project" | "mission" | "slice" | "sub-slice";
+/** Stable reference ID parts. `OPR.0.3.2.12` → project="OPR",
+ *  version="0.3.2", n=12. Escape-band non-release missions look like
+ *  `OPR.99.0.1` → version="99.0.1", n=undefined. */
+export interface DotId {
+    project: string;
+    version: string;
+    n?: number;
+    m?: number;
+}
+export interface MissionInfo {
+    /** Mission folder name (e.g., "release-0.3.2", "backlog"). */
+    name: string;
+    /** Absolute path to the mission folder. */
+    absPath: string;
+    /** Path to the mission's README.md, if present. */
+    readmePath: string | null;
+    /** Parsed frontmatter from the README. */
+    frontmatter: Record<string, unknown>;
+    /** Minted dot-ID for this mission (read from frontmatter if present,
+     *  otherwise inferred from the folder name pattern). */
+    id: string | null;
+    activeSliceCount: number;
+    closedSliceCount: number;
+}
+export interface SliceInfo {
+    name: string;
+    absPath: string;
+    readmePath: string | null;
+    frontmatter: Record<string, unknown>;
+    /** "NN-slug" → NN. */
+    nn: number | null;
+    /** "NN-slug" → slug. */
+    slug: string | null;
+    missionName: string;
+    /** Minted dot-ID, parent.NN form. */
+    id: string | null;
+    /** Frontmatter `status` field, lowercased. */
+    status: string | null;
+}
+/** 3-part error shape per `building-agent-software` skill §3.6. */
+export declare class ScopeCliError extends Error {
+    readonly fact: string;
+    readonly consequence: string;
+    readonly action: string;
+    constructor(opts: {
+        fact: string;
+        consequence: string;
+        action: string;
+    });
+}
+export type SliceState = "active" | "closed" | "shipped" | "all";
+export type SliceTemplateKind = "placeholder" | "bug-fix" | "backlog-deprecation" | "backlog-tech-debt" | "release-feature" | "research";
+export declare const SLICE_TEMPLATE_KINDS: ReadonlyArray<SliceTemplateKind>;
+export type MissionTemplateKind = "placeholder" | "release";
+export declare const MISSION_TEMPLATE_KINDS: ReadonlyArray<MissionTemplateKind>;
+export type CloseReason = "wontfix" | "deferred" | "superseded" | "stale";
+export declare const CLOSE_REASONS: ReadonlyArray<CloseReason>;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/scope/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/scope/types.ts"],"names":[],"mappings":"AAOA;sDACsD;AACtD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAEtE;;oDAEoD;AACpD,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;4DACwD;IACxD,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,sBAAsB;IACtB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,mEAAmE;AACnE,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAOxE;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AACjE,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,SAAS,GACT,qBAAqB,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,UAAU,CAAC;AACf,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,iBAAiB,CAOjE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,SAAS,CAAC;AAC5D,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,mBAAmB,CAGrE,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAC1E,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,WAAW,CAKpD,CAAC"}

package/dist/lib/scope/types.js

@@ -0,0 +1,38 @@
+// release-0.3.2 slice 12 — scope CLI primitive types.
+//
+// Aligned with the substrate convention at
+// `openrig-work/conventions/scope-and-versioning/README.md` (stage:
+// provisional, authored 2026-05-15). The CLI mints stable dot-IDs
+// into created mission/slice frontmatter per §1 of that convention.
+/** 3-part error shape per `building-agent-software` skill §3.6. */
+export class ScopeCliError extends Error {
+    fact;
+    consequence;
+    action;
+    constructor(opts) {
+        super(`${opts.fact}\n${opts.consequence}\n${opts.action}`);
+        this.name = "ScopeCliError";
+        this.fact = opts.fact;
+        this.consequence = opts.consequence;
+        this.action = opts.action;
+    }
+}
+export const SLICE_TEMPLATE_KINDS = [
+    "placeholder",
+    "bug-fix",
+    "backlog-deprecation",
+    "backlog-tech-debt",
+    "release-feature",
+    "research",
+];
+export const MISSION_TEMPLATE_KINDS = [
+    "placeholder",
+    "release",
+];
+export const CLOSE_REASONS = [
+    "wontfix",
+    "deferred",
+    "superseded",
+    "stale",
+];
+//# sourceMappingURL=types.js.map

package/dist/lib/scope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/scope/types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,2CAA2C;AAC3C,oEAAoE;AACpE,kEAAkE;AAClE,oEAAoE;AAgDpE,mEAAmE;AACnE,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,MAAM,CAAS;IACxB,YAAY,IAA2D;QACrE,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;CACF;AAUD,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,aAAa;IACb,SAAS;IACT,qBAAqB;IACrB,mBAAmB;IACnB,iBAAiB;IACjB,UAAU;CACX,CAAC;AAGF,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE,aAAa;IACb,SAAS;CACV,CAAC;AAGF,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,SAAS;IACT,UAAU;IACV,YAAY;IACZ,OAAO;CACR,CAAC"}

package/dist/lib/scope-templates/backlog-deprecation.md

@@ -0,0 +1,26 @@
+---
+id: {{id}}
+slice: {{slice_number}}-{{slug}}
+mission: {{mission}}
+status: placeholder
+stage: wip
+created: {{created_date}}
+---
+
+# Slice {{slice_number}} — {{title}}
+
+## Target
+
+[What is being deprecated]
+
+## Current state
+
+[How it works today; what depends on it]
+
+## Migration
+
+[Path off the deprecated thing]
+
+## Removal
+
+[When/how the deprecated thing gets deleted]

package/dist/lib/scope-templates/backlog-tech-debt.md

@@ -0,0 +1,22 @@
+---
+id: {{id}}
+slice: {{slice_number}}-{{slug}}
+mission: {{mission}}
+status: placeholder
+stage: wip
+created: {{created_date}}
+---
+
+# Slice {{slice_number}} — {{title}}
+
+## Current state
+
+[How the code/system looks today]
+
+## Cost
+
+[What this debt costs us — surface friction, bug class, perf, etc]
+
+## Proposal
+
+[How to pay it down]

package/dist/lib/scope-templates/bug-fix.md

@@ -0,0 +1,30 @@
+---
+id: {{id}}
+slice: {{slice_number}}-{{slug}}
+mission: {{mission}}
+status: placeholder
+stage: wip
+created: {{created_date}}
+---
+
+# Slice {{slice_number}} — {{title}}
+
+## Repro
+
+[Steps to reproduce]
+
+## Expected
+
+[Expected behavior]
+
+## Actual
+
+[Actual behavior]
+
+## Impact
+
+[Who is affected; severity]
+
+## Fix proposal
+
+[Optional: thinking on the fix]

package/dist/lib/scope-templates/mission-notes.md

@@ -0,0 +1,97 @@
+---
+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.)

package/dist/lib/scope-templates/mission-placeholder.md

@@ -0,0 +1,20 @@
+---
+id: {{id}}
+mission: {{mission}}
+stage: wip
+created: {{created_date}}
+---
+
+# Mission — {{title}}
+
+## Purpose
+
+[Why this mission exists and what success looks like]
+
+## Slices
+
+[List notable slices and their state]
+
+## Status
+
+[Where the mission is right now]

package/dist/lib/scope-templates/mission-release.md

@@ -0,0 +1,25 @@
+---
+id: {{id}}
+mission: {{mission}}
+release: {{release_version}}
+stage: wip
+created: {{created_date}}
+---
+
+# Release {{release_version}} — {{title}}
+
+## Theme
+
+[What this release is about — the coherent bet]
+
+## Scope
+
+[What ships in v{{release_version}} vs what waits]
+
+## Slices
+
+[Ordering + dependencies; PROGRESS.md tracks state]
+
+## Acceptance
+
+[Release-level done definition]

package/dist/lib/scope-templates/placeholder.md

@@ -0,0 +1,30 @@
+---
+id: {{id}}
+slice: {{slice_number}}-{{slug}}
+mission: {{mission}}
+status: placeholder
+stage: wip
+created: {{created_date}}
+---
+
+# Slice {{slice_number}} — {{title}}
+
+## Goal
+
+[1-2 sentence goal.]
+
+## Source material
+
+- [Paths or refs]
+
+## Status
+
+- TODO: [next steps]
+
+## Dependencies
+
+- [Cross-slice / cross-release]
+
+## Acceptance
+
+- [3-5 bullets]

package/dist/lib/scope-templates/release-feature.md

@@ -0,0 +1,26 @@
+---
+id: {{id}}
+slice: {{slice_number}}-{{slug}}
+mission: {{mission}}
+status: placeholder
+stage: wip
+created: {{created_date}}
+---
+
+# Slice {{slice_number}} — {{title}}
+
+## Goal
+
+[What this feature ships and why now]
+
+## Scope
+
+[In / out for v0]
+
+## Acceptance
+
+- [3-5 bullets]
+
+## Risks
+
+[Known unknowns]

package/dist/lib/scope-templates/research.md

@@ -0,0 +1,22 @@
+---
+id: {{id}}
+slice: {{slice_number}}-{{slug}}
+mission: {{mission}}
+status: placeholder
+stage: wip
+created: {{created_date}}
+---
+
+# Slice {{slice_number}} — {{title}}
+
+## Question
+
+[The thing we are trying to learn]
+
+## Source
+
+[Where the answer is most likely to come from]
+
+## Findings
+
+[Captured as work progresses]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrig/cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "Local control plane for multi-agent coding topologies",
   "keywords": [
@@ -35,7 +35,7 @@
     "scripts"
   ],
   "scripts": {
-    "build": "tsc && chmod +x dist/bin-wrapper.js && mkdir -p dist/schemas && cp src/schemas/*.json dist/schemas/",
+    "build": "tsc && chmod +x dist/bin-wrapper.js && mkdir -p dist/schemas && cp src/schemas/*.json dist/schemas/ && mkdir -p dist/lib/scope-templates && cp src/lib/scope-templates/*.md dist/lib/scope-templates/",
     "postinstall": "node scripts/check-abi.mjs",
     "prepublishOnly": "bash ../../scripts/build-package.sh",
     "test": "vitest run",