@adammcarter/use-cases 0.1.0

package/packages/core/dist/showcase/jsonlLedger.js

@@ -0,0 +1,50 @@
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fsyncBestEffortForTemp } from "../durableWrite.js";
+export function showcaseRunsRoot(context) {
+    return join(context.data_root, "showcase-runs");
+}
+export function showcaseRunDir(context, runId) {
+    return join(showcaseRunsRoot(context), runId);
+}
+export function showcaseLedgerPath(context, runId) {
+    return join(showcaseRunDir(context, runId), "events.jsonl");
+}
+export function readShowcaseEvents(context, runId) {
+    const path = showcaseLedgerPath(context, runId);
+    if (!existsSync(path)) {
+        return { complete: false, events: [] };
+    }
+    const lines = readFileSync(path, "utf8").split("\n");
+    const events = [];
+    let complete = true;
+    for (const [index, line] of lines.entries()) {
+        if (!line.trim()) {
+            continue;
+        }
+        try {
+            events.push(JSON.parse(line));
+        }
+        catch {
+            if (index === lines.length - 1) {
+                complete = false;
+                continue;
+            }
+            return { complete: false, events };
+        }
+    }
+    return { complete, events };
+}
+export function appendShowcaseEventLine(context, event) {
+    const path = showcaseLedgerPath(context, event.run_id);
+    mkdirSync(dirname(path), { recursive: true });
+    const fd = openSync(path, "a");
+    try {
+        writeSync(fd, `${JSON.stringify(event)}\n`);
+        fsyncBestEffortForTemp(fd, path);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=jsonlLedger.js.map

package/packages/core/dist/showcase/jsonlLedger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlLedger.js","sourceRoot":"","sources":["../../src/showcase/jsonlLedger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,MAAM,UAAU,gBAAgB,CAAC,OAAiC;IAChE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAiC,EAAE,KAAa;IAC7E,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAiC,EAAE,KAAa;IACjF,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAiC,EAAE,KAAa;IAIjF,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,QAAQ,GAAG,KAAK,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAiC,EAAE,KAAoB;IAC7F,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,sBAAsB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC"}

package/packages/core/dist/showcase/planBinding.d.ts

@@ -0,0 +1,5 @@
+import { type PresentationPlan } from "../presentation/index.js";
+export declare const PLACEHOLDER_HASH = "sha256:0000000000000000000000000000000000000000000000000000000000000000";
+export declare function loadPresentationPlanFile(path: string): PresentationPlan;
+export declare function assertPresentationPlanHash(plan: PresentationPlan): void;
+//# sourceMappingURL=planBinding.d.ts.map

package/packages/core/dist/showcase/planBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planBinding.d.ts","sourceRoot":"","sources":["../../src/showcase/planBinding.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,eAAO,MAAM,gBAAgB,4EAA4E,CAAC;AAE1G,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAavE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAOvE"}

package/packages/core/dist/showcase/planBinding.js

@@ -0,0 +1,33 @@
+import { readFileSync } from "node:fs";
+import { computePresentationPlanHash } from "../presentation/index.js";
+import { UseCasesPluginError } from "../errors.js";
+export const PLACEHOLDER_HASH = "sha256:0000000000000000000000000000000000000000000000000000000000000000";
+export function loadPresentationPlanFile(path) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new UseCasesPluginError(`Presentation plan file could not be read: ${error instanceof Error ? error.message : String(error)}`, "showcase_plan_file_unreadable");
+    }
+    assertPresentationPlanShape(parsed);
+    assertPresentationPlanHash(parsed);
+    return parsed;
+}
+export function assertPresentationPlanHash(plan) {
+    if (plan.plan_content_hash === PLACEHOLDER_HASH) {
+        throw new UseCasesPluginError("Plan content hash must not be a placeholder.", "showcase_plan_placeholder_hash");
+    }
+    if (computePresentationPlanHash(plan) !== plan.plan_content_hash) {
+        throw new UseCasesPluginError("Plan content hash does not match plan body.", "showcase_plan_hash_mismatch");
+    }
+}
+function assertPresentationPlanShape(value) {
+    if (!isRecord(value) || value.schema_version !== 1 || typeof value.plan_content_hash !== "string") {
+        throw new UseCasesPluginError("Presentation plan file is not a v1 plan.", "showcase_plan_file_invalid");
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=planBinding.js.map

package/packages/core/dist/showcase/planBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planBinding.js","sourceRoot":"","sources":["../../src/showcase/planBinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAyB,MAAM,0BAA0B,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,yEAAyE,CAAC;AAE1G,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAmB,CAC3B,6CAA6C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACrG,+BAA+B,CAChC,CAAC;IACJ,CAAC;IACD,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAsB;IAC/D,IAAI,IAAI,CAAC,iBAAiB,KAAK,gBAAgB,EAAE,CAAC;QAChD,MAAM,IAAI,mBAAmB,CAAC,8CAA8C,EAAE,gCAAgC,CAAC,CAAC;IAClH,CAAC;IACD,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjE,MAAM,IAAI,mBAAmB,CAAC,6CAA6C,EAAE,6BAA6B,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QAClG,MAAM,IAAI,mBAAmB,CAAC,0CAA0C,EAAE,4BAA4B,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/packages/core/dist/showcase/replayRun.d.ts

@@ -0,0 +1,5 @@
+import type { ShowcaseEvent, ShowcaseRunStatus } from "./types.js";
+import type { ShowcaseRunOptions } from "./types.js";
+export declare function replayShowcaseRun(options: ShowcaseRunOptions): ShowcaseRunStatus;
+export declare function replayShowcaseEvents(runId: string, events: ShowcaseEvent[], ledgerComplete?: boolean): ShowcaseRunStatus;
+//# sourceMappingURL=replayRun.d.ts.map

package/packages/core/dist/showcase/replayRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayRun.d.ts","sourceRoot":"","sources":["../../src/showcase/replayRun.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAsB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAGhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,cAAc,UAAO,GAAG,iBAAiB,CAiKrH"}

package/packages/core/dist/showcase/replayRun.js

@@ -0,0 +1,199 @@
+import { readShowcaseEvents } from "./jsonlLedger.js";
+import { isTrustedUserDecisionEvent } from "./approvalAuthority.js";
+export function replayShowcaseRun(options) {
+    const read = readShowcaseEvents(options.context, options.runId);
+    return replayShowcaseEvents(options.runId, read.events, read.complete);
+}
+export function replayShowcaseEvents(runId, events, ledgerComplete = true) {
+    const ordered = events.slice().sort((left, right) => left.sequence - right.sequence);
+    const start = ordered.find((event) => event.event_type === "run_started");
+    const plan = start?.payload.plan;
+    const items = (plan?.selected_items ?? []).map((item) => initialItem(item.plan_item_id));
+    const byItem = new Map(items.map((item) => [item.plan_item_id, item]));
+    const unresolvedFailures = new Set();
+    const verdictEventToItem = new Map();
+    let hasPerformedEvent = false;
+    let paused = false;
+    let aborted = false;
+    let finished = false;
+    let approvalState = userApprovalRequired(plan) ? "pending" : "not_required";
+    let outcomeAffectingEventAfterApproval = false;
+    let approvedSequence = 0;
+    const ignoredApprovalEvents = [];
+    for (const event of ordered) {
+        if (event.event_type !== "run_started" && (event.event_type === "action_recorded" || event.event_type === "observation_recorded")) {
+            hasPerformedEvent = true;
+        }
+        if (approvedSequence > 0 && event.sequence > approvedSequence && affectsApproval(event)) {
+            outcomeAffectingEventAfterApproval = true;
+        }
+        if (event.event_type === "observation_recorded") {
+            const item = byItem.get(String(event.payload.plan_item_id));
+            if (item) {
+                item.latest_observation_event_id = event.event_id;
+            }
+        }
+        if (event.event_type === "verdict_recorded") {
+            const item = byItem.get(String(event.payload.plan_item_id));
+            if (item) {
+                item.verdict = event.payload.verdict;
+                item.latest_verdict_event_id = event.event_id;
+                verdictEventToItem.set(event.event_id, item.plan_item_id);
+                item.item_currency = "current";
+                item.verification_state = item.verdict === "pass" ? "requirements_met" : "requirements_unmet";
+                if (isFailureVerdict(item.verdict)) {
+                    unresolvedFailures.add(event.event_id);
+                }
+            }
+        }
+        if (event.event_type === "failure_decision_recorded") {
+            const verdictEventId = String(event.payload.verdict_event_id);
+            unresolvedFailures.delete(verdictEventId);
+            const planItemId = verdictEventToItem.get(verdictEventId);
+            const item = planItemId ? byItem.get(planItemId) : undefined;
+            if (item && event.payload.decision === "waive_with_reason") {
+                item.verdict = "waived";
+                item.verification_state = "not_required";
+            }
+            if (event.payload.decision === "pause_to_fix") {
+                paused = true;
+            }
+            if (event.payload.decision === "abort") {
+                aborted = true;
+            }
+        }
+        if (event.event_type === "verdict_corrected") {
+            const item = byItem.get(String(event.payload.plan_item_id));
+            if (item) {
+                const targetEventId = String(event.payload.target_event_id);
+                unresolvedFailures.delete(targetEventId);
+                item.verdict = event.payload.corrected_verdict;
+                item.latest_verdict_event_id = event.event_id;
+                verdictEventToItem.set(event.event_id, item.plan_item_id);
+                item.item_currency = "corrected";
+                item.verification_state = item.verdict === "pass" ? "requirements_met" : "requirements_unmet";
+                if (isFailureVerdict(item.verdict)) {
+                    unresolvedFailures.add(event.event_id);
+                }
+            }
+        }
+        if (event.event_type === "epoch_started") {
+            for (const planItemId of event.payload.stale_item_ids ?? []) {
+                const item = byItem.get(planItemId);
+                if (item) {
+                    item.item_currency = "stale_due_to_epoch_change";
+                    item.verification_state = "stale";
+                }
+            }
+        }
+        if (event.event_type === "run_paused") {
+            paused = true;
+        }
+        if (event.event_type === "run_resumed") {
+            paused = false;
+        }
+        if (event.event_type === "run_finished") {
+            finished = true;
+        }
+        if (event.event_type === "approval_recorded") {
+            if (isTrustedUserDecisionEvent(event)) {
+                approvalState = event.payload.decision === "approved_with_known_gaps" ? "approved_with_known_gaps" : "approved";
+                approvedSequence = event.sequence;
+            }
+            else {
+                ignoredApprovalEvents.push(event.event_id);
+            }
+        }
+        if (event.event_type === "approval_rejected") {
+            if (isTrustedUserDecisionEvent(event)) {
+                approvalState = "rejected";
+                approvedSequence = event.sequence;
+            }
+            else {
+                ignoredApprovalEvents.push(event.event_id);
+            }
+        }
+    }
+    if (outcomeAffectingEventAfterApproval) {
+        approvalState = "stale_due_to_run_change";
+    }
+    const unresolvedFailureCount = unresolvedFailures.size;
+    const anyStale = items.some((item) => item.item_currency === "stale_due_to_epoch_change");
+    const anyFail = items.some((item) => item.verdict === "fail");
+    const anyBlocked = items.some((item) => item.verdict === "blocked");
+    const anyWaived = items.some((item) => item.verdict === "waived");
+    const allPassed = items.length > 0 && items.every((item) => item.verdict === "pass");
+    const executionStatus = !hasPerformedEvent
+        ? "prepared_not_performed"
+        : aborted
+            ? "aborted"
+            : finished && !anyStale
+                ? "completed"
+                : paused
+                    ? "paused"
+                    : "running";
+    const runOutcome = !hasPerformedEvent
+        ? "prepared_not_performed"
+        : aborted
+            ? "aborted"
+            : anyStale
+                ? "incomplete"
+                : anyBlocked
+                    ? "blocked"
+                    : anyFail
+                        ? "failed"
+                        : anyWaived
+                            ? "passed_with_waivers"
+                            : allPassed
+                                ? "passed"
+                                : "incomplete";
+    const knownGaps = hasPerformedEvent
+        ? (plan?.known_gaps ?? []).filter((gap) => gap.code !== "prepared_not_performed")
+        : plan?.known_gaps ?? [];
+    return {
+        schema_version: 1,
+        run_id: runId,
+        complete: ledgerComplete,
+        execution_status: ledgerComplete ? executionStatus : "incomplete",
+        run_outcome: ledgerComplete ? runOutcome : "incomplete",
+        approval_state: approvalState,
+        unresolved_failure_count: unresolvedFailureCount,
+        items,
+        known_gaps: knownGaps,
+        diagnostic_summary: ignoredApprovalEvents.length > 0 ? { ignored_approval_events: ignoredApprovalEvents } : {}
+    };
+}
+function initialItem(planItemId) {
+    return {
+        plan_item_id: planItemId,
+        verdict: "none",
+        item_currency: "unknown",
+        verification_state: "requirements_unmet",
+        latest_observation_event_id: null,
+        latest_verdict_event_id: null
+    };
+}
+function userApprovalRequired(plan) {
+    return (plan?.selected_items ?? []).some((item) => item.approval_policy_snapshot.mode === "predefined" &&
+        Array.isArray(item.approval_policy_snapshot.requirements) &&
+        item.approval_policy_snapshot.requirements.some((requirement) => requirement.approver_type === "user"));
+}
+function affectsApproval(event) {
+    return [
+        "observation_recorded",
+        "verdict_recorded",
+        "failure_decision_recorded",
+        "epoch_started",
+        "carry_forward_recorded",
+        "run_finished",
+        "observation_corrected",
+        "verdict_corrected",
+        "failure_decision_corrected",
+        "carry_forward_corrected",
+        "finish_corrected"
+    ].includes(event.event_type);
+}
+function isFailureVerdict(verdict) {
+    return verdict === "fail" || verdict === "blocked";
+}
+//# sourceMappingURL=replayRun.js.map

package/packages/core/dist/showcase/replayRun.js.map

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

package/packages/core/dist/showcase/results.d.ts

@@ -0,0 +1,3 @@
+import type { ShowcaseAppendResult } from "./types.js";
+export declare function toShowcaseAppendResult(result: ShowcaseAppendResult): ShowcaseAppendResult;
+//# sourceMappingURL=results.d.ts.map

package/packages/core/dist/showcase/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/showcase/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAEzF"}

package/packages/core/dist/showcase/results.js

@@ -0,0 +1,4 @@
+export function toShowcaseAppendResult(result) {
+    return result;
+}
+//# sourceMappingURL=results.js.map

package/packages/core/dist/showcase/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/showcase/results.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,MAA4B;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/packages/core/dist/showcase/revisionEpochs.d.ts

@@ -0,0 +1,2 @@
+export { appendShowcaseEpoch } from "./appendShowcaseEvent.js";
+//# sourceMappingURL=revisionEpochs.d.ts.map

package/packages/core/dist/showcase/revisionEpochs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisionEpochs.d.ts","sourceRoot":"","sources":["../../src/showcase/revisionEpochs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/packages/core/dist/showcase/revisionEpochs.js

@@ -0,0 +1,2 @@
+export { appendShowcaseEpoch } from "./appendShowcaseEvent.js";
+//# sourceMappingURL=revisionEpochs.js.map

package/packages/core/dist/showcase/revisionEpochs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revisionEpochs.js","sourceRoot":"","sources":["../../src/showcase/revisionEpochs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/packages/core/dist/showcase/startRun.d.ts

@@ -0,0 +1,2 @@
+export { startShowcaseRun } from "./appendShowcaseEvent.js";
+//# sourceMappingURL=startRun.d.ts.map

package/packages/core/dist/showcase/startRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startRun.d.ts","sourceRoot":"","sources":["../../src/showcase/startRun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/packages/core/dist/showcase/startRun.js

@@ -0,0 +1,2 @@
+export { startShowcaseRun } from "./appendShowcaseEvent.js";
+//# sourceMappingURL=startRun.js.map

package/packages/core/dist/showcase/startRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startRun.js","sourceRoot":"","sources":["../../src/showcase/startRun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/packages/core/dist/showcase/types.d.ts

@@ -0,0 +1,66 @@
+import type { ResolvedWorkspaceContext } from "../roots.js";
+import type { HostSurface } from "../useCases/types.js";
+import type { PresentationPlan } from "../presentation/types.js";
+export type ShowcaseActorType = "user" | "agent" | "script" | "system";
+export type ShowcaseControlMode = "agent_led" | "user_led" | "script_led" | "mixed";
+export type ShowcaseVerdict = "pass" | "partial" | "fail" | "waived" | "blocked";
+export type ShowcaseEventType = "run_started" | "action_recorded" | "observation_recorded" | "verdict_recorded" | "failure_decision_recorded" | "run_paused" | "run_resumed" | "epoch_started" | "carry_forward_recorded" | "run_finished" | "approval_recorded" | "approval_rejected" | "approval_retracted" | "observation_corrected" | "verdict_corrected" | "failure_decision_corrected" | "carry_forward_corrected" | "finish_corrected";
+export type ShowcaseEvent = {
+    schema_version: 1;
+    event_type: ShowcaseEventType;
+    event_id: string;
+    run_id: string;
+    aggregate_id: string;
+    sequence: number;
+    recorded_at: string;
+    actor_type: ShowcaseActorType;
+    host_surface: HostSurface;
+    idempotency_key: string;
+    intent_digest: string;
+    payload: Record<string, unknown>;
+};
+export type ShowcaseItemStatus = {
+    plan_item_id: string;
+    verdict: ShowcaseVerdict | "none";
+    item_currency: "current" | "stale_due_to_epoch_change" | "carried_forward" | "corrected" | "unknown";
+    verification_state: "not_required" | "requirements_unmet" | "requirements_met" | "stale" | "unknown_due_to_integrity";
+    latest_observation_event_id: string | null;
+    latest_verdict_event_id: string | null;
+};
+export type ShowcaseRunStatus = {
+    schema_version: 1;
+    run_id: string;
+    complete: boolean;
+    execution_status: "prepared_not_performed" | "running" | "paused" | "completed" | "aborted" | "incomplete";
+    run_outcome: "prepared_not_performed" | "passed" | "passed_with_waivers" | "partial" | "failed" | "blocked" | "aborted" | "incomplete";
+    approval_state: "not_required" | "resolution_required" | "pending" | "approved" | "rejected" | "approved_with_known_gaps" | "stale_due_to_run_change";
+    unresolved_failure_count: number;
+    items: ShowcaseItemStatus[];
+    known_gaps: Record<string, unknown>[];
+    diagnostic_summary: Record<string, unknown>;
+};
+export type ShowcaseAppendResult = {
+    schema_version: 1;
+    run_id: string;
+    appended_event_ids: string[];
+    event: ShowcaseEvent;
+    status: ShowcaseRunStatus;
+};
+export type ShowcaseRunOptions = {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+};
+export type ShowcaseStartOptions = {
+    context: ResolvedWorkspaceContext;
+    plan: PresentationPlan;
+    controlMode: ShowcaseControlMode;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+    knownGapAcknowledgement?: {
+        acknowledged: true;
+        gaps: string[];
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/showcase/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/showcase/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AACpF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjF,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,2BAA2B,GAC3B,YAAY,GACZ,aAAa,GACb,eAAe,GACf,wBAAwB,GACxB,cAAc,GACd,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,uBAAuB,GACvB,mBAAmB,GACnB,4BAA4B,GAC5B,yBAAyB,GACzB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE,WAAW,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC;IAClC,aAAa,EAAE,SAAS,GAAG,2BAA2B,GAAG,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAAC;IACrG,kBAAkB,EAAE,cAAc,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,OAAO,GAAG,0BAA0B,CAAC;IACtH,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,CAAC,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,wBAAwB,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;IAC3G,WAAW,EAAE,wBAAwB,GAAG,QAAQ,GAAG,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACvI,cAAc,EACV,cAAc,GACd,qBAAqB,GACrB,SAAS,GACT,UAAU,GACV,UAAU,GACV,0BAA0B,GAC1B,yBAAyB,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,CAAC,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,wBAAwB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,wBAAwB,CAAC;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE;QAAE,YAAY,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClE,CAAC"}

package/packages/core/dist/showcase/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/showcase/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/showcase/types.ts"],"names":[],"mappings":""}

package/packages/core/dist/skills/canonicalSkills.d.ts

@@ -0,0 +1,3 @@
+export declare const CANONICAL_SKILLS: readonly ["use-cases", "showcase", "walkthrough", "migration"];
+export type CanonicalSkill = (typeof CANONICAL_SKILLS)[number];
+//# sourceMappingURL=canonicalSkills.d.ts.map

package/packages/core/dist/skills/canonicalSkills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalSkills.d.ts","sourceRoot":"","sources":["../../src/skills/canonicalSkills.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,gEAAiE,CAAC;AAE/F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/packages/core/dist/skills/canonicalSkills.js

@@ -0,0 +1,7 @@
+// The canonical skills the plugin ships. SINGLE SOURCE OF TRUTH: host projection
+// (hosts/projectHostFiles), skill-asset validation (skills/validateSkillAssets),
+// and the activation decision tree all read this one list — so a newly added
+// skill can never be silently dropped from one surface. (The `migration` skill
+// once was: host projection hard-coded a 3-item list that omitted it.)
+export const CANONICAL_SKILLS = ["use-cases", "showcase", "walkthrough", "migration"];
+//# sourceMappingURL=canonicalSkills.js.map

package/packages/core/dist/skills/canonicalSkills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalSkills.js","sourceRoot":"","sources":["../../src/skills/canonicalSkills.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,iFAAiF;AACjF,6EAA6E;AAC7E,+EAA+E;AAC/E,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,CAAU,CAAC"}

package/packages/core/dist/skills/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./canonicalSkills.js";
+export * from "./validateSkillAssets.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}

package/packages/core/dist/skills/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./canonicalSkills.js";
+export * from "./validateSkillAssets.js";
+//# sourceMappingURL=index.js.map

package/packages/core/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}

package/packages/core/dist/skills/types.d.ts

@@ -0,0 +1,26 @@
+import type { Diagnostic } from "../schema/index.js";
+export type SkillAssetSummary = {
+    name: string;
+    path: string;
+    description: string;
+    complete: boolean;
+};
+export type SkillCommandReference = {
+    command: string;
+    source_path: string;
+};
+export type SkillBootstrapSummary = {
+    path: string;
+    complete: boolean;
+    sections: string[];
+};
+export type SkillAssetValidationResult = {
+    schema_version: 1;
+    complete: boolean;
+    skill_count: number;
+    skills: SkillAssetSummary[];
+    bootstrap: SkillBootstrapSummary;
+    command_references: SkillCommandReference[];
+    diagnostics: Diagnostic[];
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,cAAc,EAAE,CAAC,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,SAAS,EAAE,qBAAqB,CAAC;IACjC,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC"}

package/packages/core/dist/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":""}

package/packages/core/dist/skills/validateSkillAssets.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedWorkspaceContext } from "../roots.js";
+import type { SkillAssetValidationResult } from "./types.js";
+export declare function validateSkillAssets(options: {
+    context: ResolvedWorkspaceContext;
+}): SkillAssetValidationResult;
+//# sourceMappingURL=validateSkillAssets.d.ts.map

package/packages/core/dist/skills/validateSkillAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSkillAssets.d.ts","sourceRoot":"","sources":["../../src/skills/validateSkillAssets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAqB,0BAA0B,EAAyB,MAAM,YAAY,CAAC;AA6EvG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,wBAAwB,CAAA;CAAE,GAAG,0BAA0B,CA6G9G"}