@adammcarter/use-cases 0.1.0

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

@@ -0,0 +1,116 @@
+import type { ResolvedWorkspaceContext } from "../roots.js";
+import type { HostSurface } from "../useCases/types.js";
+import { type TrustedApprovalAuthority } from "./approvalAuthority.js";
+import type { ShowcaseActorType, ShowcaseAppendResult, ShowcaseStartOptions, ShowcaseVerdict } from "./types.js";
+export declare function startShowcaseRun(options: ShowcaseStartOptions): ShowcaseAppendResult;
+export declare function appendShowcaseObservation(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    planItemId: string;
+    text: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function appendShowcaseAction(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    planItemId: string;
+    action: Record<string, unknown>;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function appendShowcaseVerdict(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    planItemId: string;
+    verdict: ShowcaseVerdict;
+    observationEventIds: string[];
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function appendShowcaseFailureDecision(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    verdictEventId: string;
+    decision: "continue" | "pause_to_fix" | "waive_with_reason" | "abort";
+    reason: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function pauseShowcaseRun(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    reason: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function resumeShowcaseRun(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    reason: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function appendShowcaseEpoch(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    reason: "workspace_changed";
+    staleItemIds: string[];
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function finishShowcaseRun(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+export declare function appendShowcaseApproval(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    decision: "approved" | "approved_with_known_gaps";
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    statement: string;
+    idempotencyKey: string;
+    recordedAt?: string;
+    authority?: TrustedApprovalAuthority;
+}): ShowcaseAppendResult;
+export declare function rejectShowcaseApproval(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    statement: string;
+    idempotencyKey: string;
+    recordedAt?: string;
+    authority?: TrustedApprovalAuthority;
+}): ShowcaseAppendResult;
+export declare function correctShowcaseVerdict(options: {
+    context: ResolvedWorkspaceContext;
+    runId: string;
+    targetEventId: string;
+    correctedVerdict: ShowcaseVerdict;
+    reason: string;
+    actorType: ShowcaseActorType;
+    hostSurface: HostSurface;
+    idempotencyKey: string;
+    recordedAt?: string;
+}): ShowcaseAppendResult;
+//# sourceMappingURL=appendShowcaseEvent.d.ts.map

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

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

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

@@ -0,0 +1,353 @@
+import { existsSync } from "node:fs";
+import { computeSemanticHash } from "../schema/index.js";
+import { redactSecrets } from "../redact.js";
+import { UseCasesPluginError } from "../errors.js";
+import { appendShowcaseEventLine, readShowcaseEvents, showcaseLedgerPath } from "./jsonlLedger.js";
+import { replayShowcaseEvents, replayShowcaseRun } from "./replayRun.js";
+import { requireTrustedUserApprovalAuthority } from "./approvalAuthority.js";
+import { assertPresentationPlanHash } from "./planBinding.js";
+export function startShowcaseRun(options) {
+    assertPresentationPlanHash(options.plan);
+    if (options.plan.integrity_acknowledgement_required && !options.knownGapAcknowledgement?.acknowledged) {
+        throw new UseCasesPluginError("Partial plan requires known-gap acknowledgement.", "showcase_known_gap_ack_required");
+    }
+    const runId = runIdFrom(options.idempotencyKey, options.recordedAt);
+    const ledgerPath = showcaseLedgerPath(options.context, runId);
+    const payload = {
+        plan: options.plan,
+        plan_content_hash: options.plan.plan_content_hash,
+        control_mode: options.controlMode,
+        initial_epoch_id: "epoch.1",
+        known_gap_acknowledgement: options.knownGapAcknowledgement ?? null
+    };
+    const existing = readShowcaseEvents(options.context, runId);
+    if (!existing.complete && existsSync(ledgerPath)) {
+        throw new UseCasesPluginError("Refusing to start against damaged showcase history.", "showcase_ledger_damaged");
+    }
+    const existingEvent = existing.events.find((event) => event.idempotency_key === options.idempotencyKey);
+    const intentDigest = intentDigestFor("run_started", payload, options.actorType, options.hostSurface);
+    if (existingEvent) {
+        if (existingEvent.intent_digest === intentDigest) {
+            return appendResult(options.context, existingEvent);
+        }
+        throw new UseCasesPluginError("Idempotency key was reused with different intent.", "showcase_idempotency_conflict");
+    }
+    if (existing.events.length > 0) {
+        throw new UseCasesPluginError("Showcase run id already exists.", "showcase_run_id_conflict");
+    }
+    const event = makeEvent({
+        context: options.context,
+        runId,
+        eventType: "run_started",
+        sequence: 1,
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload
+    });
+    appendShowcaseEventLine(options.context, event);
+    return appendResult(options.context, event);
+}
+export function appendShowcaseObservation(options) {
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "observation_recorded",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            plan_item_id: options.planItemId,
+            epoch_id: "epoch.1",
+            // Redact at the point of persistence so the durable ledger never holds a
+            // leaked secret. The intent digest is computed over this payload, so it
+            // agrees with the redacted stored form.
+            observation: redactSecrets(options.text)
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function appendShowcaseAction(options) {
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "action_recorded",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            plan_item_id: options.planItemId,
+            epoch_id: "epoch.1",
+            action: options.action
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function appendShowcaseVerdict(options) {
+    const read = readShowcaseEvents(options.context, options.runId);
+    const observations = new Set(read.events
+        .filter((event) => event.event_type === "observation_recorded" && event.payload.plan_item_id === options.planItemId)
+        .map((event) => event.event_id));
+    if (!options.observationEventIds.some((eventId) => observations.has(eventId))) {
+        throw new UseCasesPluginError("Verdict requires a prior observation.", "showcase_verdict_requires_observation");
+    }
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "verdict_recorded",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            plan_item_id: options.planItemId,
+            epoch_id: "epoch.1",
+            observation_event_ids: options.observationEventIds,
+            verdict: options.verdict,
+            verifier: { type: options.actorType }
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function appendShowcaseFailureDecision(options) {
+    const read = readShowcaseEvents(options.context, options.runId);
+    const target = read.events.find((event) => event.event_id === options.verdictEventId);
+    if (!target || (target.event_type !== "verdict_recorded" && target.event_type !== "verdict_corrected")) {
+        throw new UseCasesPluginError("Failure decision target must be a verdict event.", "showcase_invalid_failure_decision_target");
+    }
+    const targetVerdict = target.event_type === "verdict_recorded" ? target.payload.verdict : target.payload.corrected_verdict;
+    if (targetVerdict !== "fail" && targetVerdict !== "blocked") {
+        throw new UseCasesPluginError("Failure decision target must be a failed or blocked verdict.", "showcase_invalid_failure_decision_target");
+    }
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "failure_decision_recorded",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            verdict_event_id: options.verdictEventId,
+            decision: options.decision,
+            reason: options.reason
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function pauseShowcaseRun(options) {
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "run_paused",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            reason: options.reason
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function resumeShowcaseRun(options) {
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "run_resumed",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            reason: options.reason
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function appendShowcaseEpoch(options) {
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "epoch_started",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            previous_epoch_id: "epoch.1",
+            epoch_id: "epoch.2",
+            reason: options.reason,
+            stale_item_ids: options.staleItemIds,
+            staling_strategy: "all_prior_verdicts"
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function finishShowcaseRun(options) {
+    const status = replayShowcaseRun({ context: options.context, runId: options.runId });
+    if (status.unresolved_failure_count > 0) {
+        throw new UseCasesPluginError("Cannot finish until each failed or blocked verdict has a failure decision.", "showcase_failure_decision_required");
+    }
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "run_finished",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            requested_finish: true
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function appendShowcaseApproval(options) {
+    const read = readShowcaseEvents(options.context, options.runId);
+    const start = read.events.find((event) => event.event_type === "run_started");
+    const plan = start?.payload.plan;
+    requireTrustedUserApprovalAuthority({
+        actorType: options.actorType,
+        authority: options.authority,
+        userApprovalRequired: planRequiresUserApproval(plan)
+    });
+    const finish = read.events.slice().reverse().find((event) => event.event_type === "run_finished");
+    if (!finish) {
+        throw new UseCasesPluginError("User approval requires a finished showcase run.", "showcase.finish_required_for_approval");
+    }
+    const status = replayShowcaseRun({ context: options.context, runId: options.runId });
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "approval_recorded",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            decision: options.decision,
+            approver: { type: options.actorType },
+            capture_method: options.actorType === "user" ? "trusted_user_interactive_cli" : "command_handler",
+            approval_statement: options.statement,
+            scope: {
+                plan_content_hash: plan?.plan_content_hash ?? "",
+                finish_event_id: finish.event_id,
+                run_outcome: status.run_outcome,
+                known_gap_count: status.known_gaps.length
+            }
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function rejectShowcaseApproval(options) {
+    const read = readShowcaseEvents(options.context, options.runId);
+    const start = read.events.find((event) => event.event_type === "run_started");
+    const plan = start?.payload.plan;
+    requireTrustedUserApprovalAuthority({
+        actorType: options.actorType,
+        authority: options.authority,
+        userApprovalRequired: planRequiresUserApproval(plan)
+    });
+    const finish = read.events.slice().reverse().find((event) => event.event_type === "run_finished");
+    if (!finish) {
+        throw new UseCasesPluginError("User rejection requires a finished showcase run.", "showcase.finish_required_for_approval");
+    }
+    const status = replayShowcaseRun({ context: options.context, runId: options.runId });
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "approval_rejected",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            decision: "rejected",
+            approver: { type: options.actorType },
+            capture_method: options.actorType === "user" ? "trusted_user_interactive_cli" : "command_handler",
+            rejection_statement: options.statement,
+            scope: {
+                plan_content_hash: plan?.plan_content_hash ?? "",
+                finish_event_id: finish.event_id,
+                run_outcome: status.run_outcome,
+                known_gap_count: status.known_gaps.length
+            }
+        }
+    });
+    return appendResult(options.context, event);
+}
+export function correctShowcaseVerdict(options) {
+    const read = readShowcaseEvents(options.context, options.runId);
+    const target = read.events.find((event) => event.event_id === options.targetEventId);
+    if (!target || target.event_type !== "verdict_recorded") {
+        throw new UseCasesPluginError("Correction target must be a verdict event.", "showcase_invalid_correction_target");
+    }
+    const event = appendEvent(options.context, options.runId, {
+        eventType: "verdict_corrected",
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: {
+            target_event_id: options.targetEventId,
+            plan_item_id: target.payload.plan_item_id,
+            corrected_verdict: options.correctedVerdict,
+            reason: options.reason
+        }
+    });
+    return appendResult(options.context, event);
+}
+function appendEvent(context, runId, options) {
+    const read = readShowcaseEvents(context, runId);
+    if (!read.complete) {
+        throw new UseCasesPluginError("Refusing to append to damaged showcase history.", "showcase_ledger_damaged");
+    }
+    const existing = read.events.find((event) => event.idempotency_key === options.idempotencyKey);
+    const intentDigest = intentDigestFor(options.eventType, options.payload, options.actorType, options.hostSurface);
+    if (existing) {
+        if (existing.intent_digest === intentDigest) {
+            return existing;
+        }
+        throw new UseCasesPluginError("Idempotency key was reused with different intent.", "showcase_idempotency_conflict");
+    }
+    const event = makeEvent({
+        context,
+        runId,
+        eventType: options.eventType,
+        sequence: read.events.length + 1,
+        actorType: options.actorType,
+        hostSurface: options.hostSurface,
+        idempotencyKey: options.idempotencyKey,
+        recordedAt: options.recordedAt,
+        payload: options.payload
+    });
+    appendShowcaseEventLine(context, event);
+    return event;
+}
+function makeEvent(options) {
+    const recordedAt = options.recordedAt ?? new Date().toISOString();
+    const eventId = `evt.${options.runId}.${options.sequence}`;
+    return {
+        schema_version: 1,
+        event_type: options.eventType,
+        event_id: eventId,
+        run_id: options.runId,
+        aggregate_id: options.runId,
+        sequence: options.sequence,
+        recorded_at: recordedAt,
+        actor_type: options.actorType,
+        host_surface: options.hostSurface,
+        idempotency_key: options.idempotencyKey,
+        intent_digest: intentDigestFor(options.eventType, options.payload, options.actorType, options.hostSurface),
+        payload: options.payload
+    };
+}
+function appendResult(context, event) {
+    return {
+        schema_version: 1,
+        run_id: event.run_id,
+        appended_event_ids: [event.event_id],
+        event,
+        status: replayShowcaseEvents(event.run_id, readShowcaseEvents(context, event.run_id).events)
+    };
+}
+function runIdFrom(idempotencyKey, recordedAt) {
+    const base = sanitizeId(idempotencyKey || recordedAt || new Date().toISOString());
+    return `run.${base}`;
+}
+function sanitizeId(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "showcase";
+}
+function intentDigestFor(eventType, payload, actorType, hostSurface) {
+    return computeSemanticHash({ eventType, payload, actorType, hostSurface });
+}
+function planRequiresUserApproval(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"));
+}
+//# sourceMappingURL=appendShowcaseEvent.js.map

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,19 @@
+import type { ShowcaseActorType, ShowcaseEvent } from "./types.js";
+export type TrustedApprovalAuthority = {
+    kind: "trusted_interactive_cli";
+    stdinIsTty: boolean;
+    confirmed: boolean;
+} | {
+    kind: "trusted_host_token";
+    token: string;
+    verified: boolean;
+} | {
+    kind: "untrusted_automation";
+};
+export declare function requireTrustedUserApprovalAuthority(input: {
+    actorType: ShowcaseActorType;
+    authority?: TrustedApprovalAuthority;
+    userApprovalRequired: boolean;
+}): void;
+export declare function isTrustedUserDecisionEvent(event: ShowcaseEvent): boolean;
+//# sourceMappingURL=approvalAuthority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approvalAuthority.d.ts","sourceRoot":"","sources":["../../src/showcase/approvalAuthority.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAErC,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,oBAAoB,EAAE,OAAO,CAAC;CAC/B,GAAG,IAAI,CAcP;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAcxE"}

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

@@ -0,0 +1,46 @@
+import { UseCasesPluginError } from "../errors.js";
+export function requireTrustedUserApprovalAuthority(input) {
+    if (input.actorType !== "user") {
+        if (input.userApprovalRequired) {
+            throw new UseCasesPluginError("Agent cannot record user-required approval.", "showcase.user_required_approval");
+        }
+        return;
+    }
+    if (!isTrustedAuthority(input.authority)) {
+        throw new UseCasesPluginError("User approval requires a trusted interactive user confirmation path.", "showcase.trusted_user_confirmation_required");
+    }
+}
+export function isTrustedUserDecisionEvent(event) {
+    if (event.actor_type !== "user") {
+        return true;
+    }
+    if (event.payload.capture_method !== "trusted_user_interactive_cli") {
+        return false;
+    }
+    if (event.event_type === "approval_recorded") {
+        return hasFinishBoundScope(event.payload.scope);
+    }
+    if (event.event_type === "approval_rejected") {
+        return hasFinishBoundScope(event.payload.scope);
+    }
+    return true;
+}
+function isTrustedAuthority(authority) {
+    if (!authority) {
+        return false;
+    }
+    if (authority.kind === "trusted_interactive_cli") {
+        return authority.stdinIsTty && authority.confirmed;
+    }
+    if (authority.kind === "trusted_host_token") {
+        return authority.verified;
+    }
+    return false;
+}
+function hasFinishBoundScope(value) {
+    return isRecord(value) && typeof value.finish_event_id === "string" && value.finish_event_id.length > 0;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=approvalAuthority.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approvalAuthority.js","sourceRoot":"","sources":["../../src/showcase/approvalAuthority.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,UAAU,mCAAmC,CAAC,KAInD;IACC,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;YAC/B,MAAM,IAAI,mBAAmB,CAAC,6CAA6C,EAAE,iCAAiC,CAAC,CAAC;QAClH,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,mBAAmB,CAC3B,sEAAsE,EACtE,6CAA6C,CAC9C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAoB;IAC7D,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,KAAK,8BAA8B,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;QAC7C,OAAO,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;QAC7C,OAAO,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,SAA+C;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,SAAS,CAAC;IACrD,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1G,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/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./types.js";
+export * from "./jsonlLedger.js";
+export * from "./replayRun.js";
+export * from "./appendShowcaseEvent.js";
+export * from "./approvalAuthority.js";
+export * from "./planBinding.js";
+export * from "./startRun.js";
+export * from "./approval.js";
+export * from "./revisionEpochs.js";
+export * from "./results.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/showcase/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,11 @@
+export * from "./types.js";
+export * from "./jsonlLedger.js";
+export * from "./replayRun.js";
+export * from "./appendShowcaseEvent.js";
+export * from "./approvalAuthority.js";
+export * from "./planBinding.js";
+export * from "./startRun.js";
+export * from "./approval.js";
+export * from "./revisionEpochs.js";
+export * from "./results.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/showcase/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { ResolvedWorkspaceContext } from "../roots.js";
+import type { ShowcaseEvent } from "./types.js";
+export declare function showcaseRunsRoot(context: ResolvedWorkspaceContext): string;
+export declare function showcaseRunDir(context: ResolvedWorkspaceContext, runId: string): string;
+export declare function showcaseLedgerPath(context: ResolvedWorkspaceContext, runId: string): string;
+export declare function readShowcaseEvents(context: ResolvedWorkspaceContext, runId: string): {
+    complete: boolean;
+    events: ShowcaseEvent[];
+};
+export declare function appendShowcaseEventLine(context: ResolvedWorkspaceContext, event: ShowcaseEvent): void;
+//# sourceMappingURL=jsonlLedger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlLedger.d.ts","sourceRoot":"","sources":["../../src/showcase/jsonlLedger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAE1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,MAAM,GAAG;IACpF,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAuBA;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAUrG"}