@openrig/cli 0.3.4 → 0.4.1

package/daemon/dist/domain/scope/scope-audit.js

@@ -0,0 +1,191 @@
+import * as YAML from "yaml";
+import { isMissionDotId, isSliceDotId } from "./dot-id.js";
+const MISSION_BRIEF_HEADERS = ["What & why", "Building", "Progress", "Proven", "Needs you", "Pointers"];
+function childPath(parent, child) {
+    return parent.endsWith("/") ? `${parent}${child}` : `${parent}/${child}`;
+}
+function missionBriefFix() {
+    return "Create/populate MISSION_BRIEF.md using the slice-16 schema: # <Mission name> — Brief, then ## What & why, ## Building, ## Progress, ## Proven, ## Needs you, ## Pointers.";
+}
+function missionBriefConforms(content) {
+    const lines = content.split(/\r?\n/);
+    const title = lines.find((line) => /^#\s+/.test(line) && !/^##\s+/.test(line))?.trim() ?? "";
+    if (!/^#\s+.+\s+—\s+Brief\s*$/.test(title))
+        return false;
+    const h2s = lines
+        .map((line) => /^##\s+(.+?)\s*$/.exec(line)?.[1]?.trim() ?? null)
+        .filter((header) => header !== null);
+    if (h2s.length < MISSION_BRIEF_HEADERS.length)
+        return false;
+    return MISSION_BRIEF_HEADERS.every((header, idx) => h2s[idx] === header);
+}
+function parseStatusFromFrontmatter(raw) {
+    if (raw === null)
+        return null;
+    try {
+        const parsed = YAML.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const status = parsed.status;
+            return typeof status === "string" ? status : null;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function statusRequiresProof(status) {
+    if (!status)
+        return false;
+    const normalized = status.toLowerCase().trim();
+    return normalized.includes("done")
+        || normalized.includes("ship")
+        || normalized.includes("close")
+        || normalized.includes("proven")
+        || normalized.includes("promoted");
+}
+export function classifyScopeItem(input) {
+    const findings = [];
+    let frontmatterError = null;
+    let railStatus;
+    // Rail status
+    if (input.readmeOnlyMarker) {
+        railStatus = "readme-only";
+    }
+    else if (input.progressFileExists) {
+        railStatus = "present";
+    }
+    else {
+        railStatus = "missing";
+        findings.push({
+            kind: "missing_progress",
+            severity: input.isActiveRelease ? "high" : "low",
+            path: input.path,
+            message: `${input.level} has no PROGRESS.md and no readme-only marker`,
+            remediation: `Run: rig scope ${input.level} create (scaffolds PROGRESS.md) or add progress_rail: readme-only to README frontmatter`,
+        });
+    }
+    // Frontmatter classification (strict parse, NOT parseYamlSafely)
+    if (input.readmeFrontmatterRaw === null) {
+        findings.push({
+            kind: "missing_id",
+            severity: input.isActiveRelease ? "high" : "low",
+            path: input.path,
+            message: `README has no frontmatter (no id can be extracted)`,
+            remediation: "Add YAML frontmatter with an id: field to the README",
+        });
+    }
+    else {
+        let parsed = null;
+        let parseError = null;
+        try {
+            parsed = YAML.parse(input.readmeFrontmatterRaw);
+        }
+        catch (err) {
+            parseError = err instanceof Error ? err.message : String(err);
+        }
+        const hasIdLine = /^id\s*:/m.test(input.readmeFrontmatterRaw);
+        if (parseError) {
+            frontmatterError = parseError;
+            railStatus = "malformed";
+            if (hasIdLine) {
+                findings.push({
+                    kind: "registration_ghost",
+                    severity: input.isActiveRelease ? "high" : "low",
+                    path: input.path,
+                    message: `README has an id: line but frontmatter fails to parse (registration ghost): ${parseError}`,
+                    remediation: "Fix the YAML frontmatter syntax error so the id can be read",
+                });
+            }
+            else {
+                findings.push({
+                    kind: "registration_ghost",
+                    severity: input.isActiveRelease ? "high" : "low",
+                    path: input.path,
+                    message: `README frontmatter fails to parse: ${parseError}`,
+                    remediation: "Fix the YAML frontmatter syntax error",
+                });
+            }
+        }
+        else {
+            const fm = parsed && typeof parsed === "object" && !Array.isArray(parsed)
+                ? parsed
+                : {};
+            const id = typeof fm.id === "string" ? fm.id : null;
+            if (!id) {
+                findings.push({
+                    kind: "missing_id",
+                    severity: input.isActiveRelease ? "high" : "low",
+                    path: input.path,
+                    message: `README frontmatter has no id field`,
+                    remediation: "Add an id: field to the README frontmatter matching the scope dot-ID convention",
+                });
+            }
+            else {
+                const validator = input.level === "mission" ? isMissionDotId : isSliceDotId;
+                if (!validator(id)) {
+                    findings.push({
+                        kind: "id_convention_violation",
+                        severity: input.isActiveRelease ? "high" : "info",
+                        path: input.path,
+                        message: `id "${id}" does not match the ${input.level} dot-ID convention`,
+                        remediation: `Use a valid ${input.level} dot-ID format`,
+                    });
+                }
+            }
+        }
+    }
+    if (input.level === "mission") {
+        const briefPath = input.missionBriefPath ?? childPath(input.path, "MISSION_BRIEF.md");
+        if (input.missionBriefExists === false) {
+            findings.push({
+                kind: "missing_mission_brief",
+                severity: "medium",
+                path: briefPath,
+                message: "Mission has no root MISSION_BRIEF.md, so the Steering tab human-facing brief degrades.",
+                remediation: missionBriefFix(),
+            });
+        }
+        else if (input.missionBriefExists === true
+            && typeof input.missionBriefContent === "string"
+            && !missionBriefConforms(input.missionBriefContent)) {
+            findings.push({
+                kind: "malformed_mission_brief",
+                severity: "medium",
+                path: briefPath,
+                message: "MISSION_BRIEF.md does not match the canonical MISSION_BRIEF.md section order.",
+                remediation: missionBriefFix(),
+            });
+        }
+        if (input.missionNotesExists === false) {
+            const notesPath = input.missionNotesPath ?? childPath(input.path, "MISSION_NOTES.md");
+            findings.push({
+                kind: "missing_mission_notes",
+                severity: "low",
+                path: notesPath,
+                message: "Mission has no MISSION_NOTES.md continuity file.",
+                remediation: "Add MISSION_NOTES.md at the mission root and populate it per the mission-notes convention.",
+            });
+        }
+    }
+    if (input.level === "slice") {
+        const status = input.sliceStatus ?? parseStatusFromFrontmatter(input.readmeFrontmatterRaw);
+        const hasProofPacket = input.hasProofPacket === true;
+        const hasRootProof = input.proofFileExists === true
+            && input.proofDirExists === true
+            && input.proofDirHasEntries === true;
+        const isProven = statusRequiresProof(status) || hasProofPacket;
+        if (isProven && !hasRootProof) {
+            const proofPath = input.proofFilePath ?? childPath(input.path, "PROOF.md");
+            findings.push({
+                kind: "missing_proof",
+                severity: "medium",
+                path: proofPath,
+                message: "Slice is done/proven but does not have complete root PROOF.md plus populated proof/ artifacts.",
+                remediation: "Add PROOF.md at the slice root and put verification artifacts under proof/ per the slice-closeout SOP.",
+            });
+        }
+    }
+    return { railStatus, findings, frontmatterError };
+}
+//# sourceMappingURL=scope-audit.js.map

package/daemon/dist/domain/scope/scope-audit.js.map

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

package/daemon/dist/domain/scope/types.d.ts

@@ -0,0 +1,67 @@
+/** 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>;
+/** OPR.0.4.1.6 — the scope-and-versioning §2 epistemic-maturity `stage` enum
+ *  (4 rungs + 2 exits). The ONLY valid stage values; invented values
+ *  (shape/shaped/draft) are rejected. `superseded` must name its successor;
+ *  `retired` means do-not-use. */
+export type Stage = "wip" | "provisional" | "established" | "canonical" | "superseded" | "retired";
+export declare const STAGE_VALUES: ReadonlyArray<Stage>;
+//# sourceMappingURL=types.d.ts.map

package/daemon/dist/domain/scope/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/domain/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;AAEF;;;kCAGkC;AAClC,MAAM,MAAM,KAAK,GACb,KAAK,GACL,aAAa,GACb,aAAa,GACb,WAAW,GACX,YAAY,GACZ,SAAS,CAAC;AACd,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,KAAK,CAO7C,CAAC"}

package/daemon/dist/domain/scope/types.js

@@ -0,0 +1,46 @@
+// 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",
+];
+export const STAGE_VALUES = [
+    "wip",
+    "provisional",
+    "established",
+    "canonical",
+    "superseded",
+    "retired",
+];
+//# sourceMappingURL=types.js.map

package/daemon/dist/domain/scope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/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;AAaF,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,KAAK;IACL,aAAa;IACb,aAAa;IACb,WAAW;IACX,YAAY;IACZ,SAAS;CACV,CAAC"}

package/daemon/dist/domain/seat-attention-reconciler.d.ts

@@ -1,3 +1,4 @@
+import type Database from "better-sqlite3";
 import type { SessionRegistry } from "./session-registry.js";
 import type { EventBus } from "./event-bus.js";
 import type { AgentActivityStore } from "./agent-activity-store.js";
@@ -15,6 +16,14 @@ export interface ClearAttentionResult {
     reason?: string;
     detail?: string;
     previousError?: string | null;
+    clearedClasses?: ("startup_status" | "restore_outcome")[];
+    derivedEvidence?: {
+        source: string;
+        kind?: string;
+        state?: string;
+        reason?: string;
+        runtimeCwdVerified: boolean;
+    };
 }
 export interface SendVerifyFn {
     (sessionName: string, text: string, opts?: {
@@ -41,6 +50,7 @@ interface ClearAttentionDeps {
     agentActivityStore: AgentActivityStore;
     sendVerify?: SendVerifyFn;
     capture?: CaptureFn;
+    db?: Database.Database;
 }
 export declare class SeatAttentionReconciler {
     private deps;
@@ -48,7 +58,9 @@ export declare class SeatAttentionReconciler {
     clearAttention(sessionName: string, opts?: {
         reason?: string;
     }): Promise<ClearAttentionResult>;
+    private performEvidenceClear;
     private findLatestSessionByName;
+    private getDerivedAttentionOutcome;
 }
 export {};
 //# sourceMappingURL=seat-attention-reconciler.d.ts.map

package/daemon/dist/domain/seat-attention-reconciler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seat-attention-reconciler.d.ts","sourceRoot":"","sources":["../../src/domain/seat-attention-reconciler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,kBAAkB,GAAG,6BAA6B,GAAG,SAAS,CAAC;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,UAAU,GAAG,sBAAsB,CAAC;IAChD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClI;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnI;AAED,UAAU,kBAAkB;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAID,qBAAa,uBAAuB;IAClC,OAAO,CAAC,IAAI,CAAqB;gBAErB,IAAI,EAAE,kBAAkB;IAI9B,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,OAAO,CAAC,oBAAoB,CAAC;IAmJhC,OAAO,CAAC,uBAAuB;CA0ChC"}
+{"version":3,"file":"seat-attention-reconciler.d.ts","sourceRoot":"","sources":["../../src/domain/seat-attention-reconciler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,kBAAkB,GAAG,6BAA6B,GAAG,SAAS,CAAC;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,UAAU,GAAG,sBAAsB,CAAC;IAChD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,gBAAgB,GAAG,iBAAiB,CAAC,EAAE,CAAC;IAC1D,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,OAAO,CAAA;KAAE,CAAC;CACnH;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClI;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnI;AAED,UAAU,kBAAkB;IAC1B,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;CACxB;AAID,qBAAa,uBAAuB;IAClC,OAAO,CAAC,IAAI,CAAqB;gBAErB,IAAI,EAAE,kBAAkB;IAI9B,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,OAAO,CAAC,oBAAoB,CAAC;IAuGhC,OAAO,CAAC,oBAAoB;IAqD5B,OAAO,CAAC,uBAAuB;IA8C/B,OAAO,CAAC,0BAA0B;CA0BnC"}

package/daemon/dist/domain/seat-attention-reconciler.js

@@ -13,24 +13,42 @@ export class SeatAttentionReconciler {
         if (!session) {
             return { ok: false, code: "not_in_attention", detail: `Session '${sessionName}' not found` };
         }
-        if (session.startupStatus !== "attention_required" && session.startupStatus !== "failed") {
-            return { ok: false, code: "not_in_attention", detail: `Session startup_status is '${session.startupStatus}', not attention_required/failed` };
+        const startupClassActive = session.startupStatus === "attention_required" || session.startupStatus === "failed";
+        const derivedOutcome = this.getDerivedAttentionOutcome(session);
+        if (!startupClassActive && !!!derivedOutcome) {
+            return { ok: false, code: "not_in_attention", detail: `Session startup_status is '${session.startupStatus}' and restoreOutcome is not attention/failed — not in attention` };
         }
         const previousError = session.latestError ?? null;
         // Operator attestation override (--reason).
         if (opts?.reason) {
-            sessionRegistry.updateStartupStatus(session.id, "ready", new Date().toISOString());
-            eventBus.emit({
-                type: "seat.attention_cleared",
-                rigId: session.rigId,
-                nodeId: session.nodeId,
-                sessionName,
-                from: session.startupStatus,
-                to: "ready",
-                clearedBy: "operator_attestation",
-                reason: opts.reason,
-                previousError,
-            });
+            const clearedClasses = [];
+            if (startupClassActive) {
+                sessionRegistry.updateStartupStatus(session.id, "ready", new Date().toISOString());
+                eventBus.emit({
+                    type: "seat.attention_cleared",
+                    rigId: session.rigId,
+                    nodeId: session.nodeId,
+                    sessionName,
+                    from: session.startupStatus,
+                    to: "ready",
+                    clearedBy: "operator_attestation",
+                    reason: opts.reason,
+                    previousError,
+                });
+                clearedClasses.push("startup_status");
+            }
+            if (derivedOutcome) {
+                eventBus.emit({
+                    type: "restore.outcome_reconciled",
+                    rigId: session.rigId,
+                    nodeId: session.nodeId,
+                    attemptId: 0,
+                    from: derivedOutcome,
+                    to: "operator_recovered",
+                    evidence: { source: "operator_attestation", reason: opts.reason, runtimeCwdVerified: false },
+                });
+                clearedClasses.push("restore_outcome");
+            }
             return {
                 ok: true,
                 code: "cleared",
@@ -39,6 +57,8 @@ export class SeatAttentionReconciler {
                 clearedBy: "operator_attestation",
                 reason: opts.reason,
                 previousError,
+                clearedClasses,
+                derivedEvidence: derivedOutcome ? { source: "operator_attestation", reason: opts.reason, runtimeCwdVerified: false } : undefined,
             };
         }
         // Evidence-gated clear.
@@ -47,27 +67,8 @@ export class SeatAttentionReconciler {
             sessionName,
         });
         if (activity && activity.stale !== true && POSITIVE_STATES.has(activity.state)) {
-            sessionRegistry.updateStartupStatus(session.id, "ready", new Date().toISOString());
-            eventBus.emit({
-                type: "seat.attention_cleared",
-                rigId: session.rigId,
-                nodeId: session.nodeId,
-                sessionName,
-                from: session.startupStatus,
-                to: "ready",
-                clearedBy: "evidence",
-                evidence: { kind: "fresh_activity", state: activity.state, reason: activity.reason },
-                previousError,
-            });
-            return {
-                ok: true,
-                code: "cleared",
-                from: session.startupStatus,
-                to: "ready",
-                clearedBy: "evidence",
-                evidence: { kind: "fresh_activity", state: activity.state, reason: activity.reason },
-                previousError,
-            };
+            const evidence = { kind: "fresh_activity", state: activity.state, reason: activity.reason };
+            return this.performEvidenceClear(session, sessionName, startupClassActive, derivedOutcome, evidence, previousError);
         }
         // Second evidence path: active send-verify round-trip.
         if (this.deps.sendVerify) {
@@ -75,67 +76,21 @@ export class SeatAttentionReconciler {
                 const probeText = `# OpenRig attention-clear liveness probe ${Date.now()}`;
                 const sendResult = await this.deps.sendVerify(sessionName, probeText, { verify: true });
                 if (sendResult.ok && (sendResult.outcome === "delivered" || sendResult.verified === true)) {
-                    sessionRegistry.updateStartupStatus(session.id, "ready", new Date().toISOString());
-                    eventBus.emit({
-                        type: "seat.attention_cleared",
-                        rigId: session.rigId,
-                        nodeId: session.nodeId,
-                        sessionName,
-                        from: session.startupStatus,
-                        to: "ready",
-                        clearedBy: "evidence",
-                        evidence: { kind: "send_verify_roundtrip", state: sendResult.outcome ?? "delivered" },
-                        previousError,
-                    });
-                    return {
-                        ok: true,
-                        code: "cleared",
-                        from: session.startupStatus,
-                        to: "ready",
-                        clearedBy: "evidence",
-                        evidence: { kind: "send_verify_roundtrip", state: sendResult.outcome ?? "delivered" },
-                        previousError,
-                    };
+                    const evidence = { kind: "send_verify_roundtrip", state: sendResult.outcome ?? "delivered" };
+                    return this.performEvidenceClear(session, sessionName, startupClassActive, derivedOutcome, evidence, previousError);
                 }
-                // rendered-unconfirmed: text landed but verify raced a TUI redraw.
-                // Attempt capture-confirmation if capture dep is available.
                 if (sendResult.ok && sendResult.outcome === "rendered-unconfirmed" && this.deps.capture) {
                     try {
                         const captureResult = await this.deps.capture(sessionName, { lines: 50 });
                         if (captureResult.ok && captureResult.content && captureResult.content.includes(probeText)) {
-                            sessionRegistry.updateStartupStatus(session.id, "ready", new Date().toISOString());
-                            eventBus.emit({
-                                type: "seat.attention_cleared",
-                                rigId: session.rigId,
-                                nodeId: session.nodeId,
-                                sessionName,
-                                from: session.startupStatus,
-                                to: "ready",
-                                clearedBy: "evidence",
-                                evidence: { kind: "send_verify_capture_confirmed", state: "rendered-unconfirmed" },
-                                previousError,
-                            });
-                            return {
-                                ok: true,
-                                code: "cleared",
-                                from: session.startupStatus,
-                                to: "ready",
-                                clearedBy: "evidence",
-                                evidence: { kind: "send_verify_capture_confirmed", state: "rendered-unconfirmed" },
-                                previousError,
-                            };
+                            const evidence = { kind: "send_verify_capture_confirmed", state: "rendered-unconfirmed" };
+                            return this.performEvidenceClear(session, sessionName, startupClassActive, derivedOutcome, evidence, previousError);
                         }
                     }
-                    catch {
-                        // Capture failed — transport error. Do not clear on capture failure.
-                    }
+                    catch { /* Capture failed */ }
                 }
-                // No capture dep, or capture didn't confirm: could-not-confirm, NOT dead.
-                // failed: transport did not land. Neither clears.
-            }
-            catch {
-                // Send failed — transport error. Do not clear.
             }
+            catch { /* Send failed */ }
         }
         return {
             ok: false,
@@ -145,8 +100,50 @@ export class SeatAttentionReconciler {
                 : "No recent agent activity found; send-verify also not confirmed",
         };
     }
+    performEvidenceClear(session, sessionName, startupClassActive, derivedOutcome, evidence, previousError) {
+        const { sessionRegistry, eventBus } = this.deps;
+        const clearedClasses = [];
+        if (startupClassActive) {
+            sessionRegistry.updateStartupStatus(session.id, "ready", new Date().toISOString());
+            eventBus.emit({
+                type: "seat.attention_cleared",
+                rigId: session.rigId,
+                nodeId: session.nodeId,
+                sessionName,
+                from: session.startupStatus,
+                to: "ready",
+                clearedBy: "evidence",
+                evidence,
+                previousError,
+            });
+            clearedClasses.push("startup_status");
+        }
+        if (derivedOutcome) {
+            eventBus.emit({
+                type: "restore.outcome_reconciled",
+                rigId: session.rigId,
+                nodeId: session.nodeId,
+                attemptId: 0,
+                from: derivedOutcome,
+                to: "operator_recovered",
+                evidence: { source: "clear_attention_evidence", kind: evidence.kind, state: evidence.state, runtimeCwdVerified: false },
+            });
+            clearedClasses.push("restore_outcome");
+        }
+        return {
+            ok: true,
+            code: "cleared",
+            from: session.startupStatus,
+            to: "ready",
+            clearedBy: "evidence",
+            evidence,
+            previousError,
+            clearedClasses,
+            derivedEvidence: derivedOutcome ? { source: "clear_attention_evidence", kind: evidence.kind, state: evidence.state, runtimeCwdVerified: false } : undefined,
+        };
+    }
     findLatestSessionByName(sessionName) {
-        const row = this.deps.sessionRegistry.db.prepare(`SELECT s.id, s.node_id, n.rig_id, s.startup_status,
+        const row = this.deps.sessionRegistry.db.prepare(`SELECT s.id, s.node_id, n.rig_id, s.startup_status, s.status,
               (SELECT e.payload FROM events e WHERE e.node_id = s.node_id AND e.type IN ('node.startup_attention_required','node.startup_failed') ORDER BY e.seq DESC LIMIT 1) as latest_error_payload
        FROM sessions s
        JOIN nodes n ON n.id = s.node_id
@@ -169,8 +166,39 @@ export class SeatAttentionReconciler {
             nodeId: row.node_id,
             rigId: row.rig_id,
             startupStatus: row.startup_status ?? "pending",
+            sessionStatus: row.status ?? "unknown",
             latestError,
         };
     }
+    getDerivedAttentionOutcome(session) {
+        if (!this.deps.db)
+            return null;
+        const rows = this.deps.db.prepare("SELECT type, payload FROM events WHERE rig_id = ? AND type IN ('restore.completed', 'restore.subset_completed', 'restore.outcome_reconciled') ORDER BY seq DESC").all(session.rigId);
+        for (const row of rows) {
+            try {
+                if (row.type === "restore.outcome_reconciled") {
+                    const ev = JSON.parse(row.payload);
+                    if (ev.nodeId !== session.nodeId)
+                        continue;
+                    return ev.to === "operator_recovered" ? null : "attention_required";
+                }
+                const ev = JSON.parse(row.payload);
+                const n = ev.result.nodes.find((nd) => nd.nodeId === session.nodeId);
+                if (!n)
+                    continue;
+                // Mirror deriveNodeLifecycleState: attention_required regardless of
+                // sessionStatus; failed only when sessionStatus=running.
+                if (n.status === "attention_required")
+                    return "attention_required";
+                if (n.status === "failed" && session.sessionStatus === "running")
+                    return "failed";
+                return null;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
 }
 //# sourceMappingURL=seat-attention-reconciler.js.map