@adammcarter/use-cases 0.1.0

package/packages/core/dist/presentation/renderCard.js

@@ -0,0 +1,129 @@
+import { defaultFormatForDeliveryKind, FORMAT_META } from "./presentationFormat.js";
+/** Thrown when a render would let the header verb lie. */
+export class HonestyRuleError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "HonestyRuleError";
+    }
+}
+const MARK_PASS = "\u2713"; // check mark
+const MARK_FAIL = "\u2717"; // ballot x
+const DOT = "\u00b7"; // middle dot
+/**
+ * Render the fixed, scannable card for a plan item. Pure and deterministic.
+ * Enforces the render-time honesty rule: the emoji + verb is a promise that
+ * cannot be broken (a failed live test cannot become an explanation; a `pass`
+ * checkmark needs real recorded evidence; an "Over to you" prompt can only be
+ * answered by a human).
+ *
+ * Trust boundary: this is a pure function over the supplied `result`. It cannot
+ * see a result that the caller withholds (a recorded live failure rendered with
+ * no result reads as pending), and it trusts `answeredByHuman` as supplied. The
+ * upstream guarantee -- that a result/answer is bound to a real recorded,
+ * human-origin run event -- is enforced by the evidence/showcase ledger and the
+ * deferred per-claim evidence-verifier contract (see the spec), not here.
+ */
+export function renderCard(item, result) {
+    // Defensive: external plan files may omit the field even though selection
+    // always emits it. Fall back to the delivery_kind projection rather than
+    // indexing FORMAT_META with undefined.
+    const format = item.presentation_format ?? defaultFormatForDeliveryKind(item.delivery_kind);
+    enforceHonesty(item, format, result);
+    const meta = FORMAT_META[format];
+    const header = `${meta.emoji} ${meta.verb}: ${item.use_case_id}  ${DOT}  ${meta.descriptor}`;
+    return `${header}\n\n${renderBody(item, format, result)}`;
+}
+function enforceHonesty(item, format, result) {
+    if (!result) {
+        return;
+    }
+    // A non-live narrated format cannot re-render a live pass/fail result.
+    if (format !== "testing" && format !== "comparing" && format !== "user_led" && result.status) {
+        throw new HonestyRuleError(`A live result cannot be re-rendered under the ${FORMAT_META[format].verb} format.`, "live_result_not_renderable");
+    }
+    // Over to you can only be answered by a human-origin event.
+    if (format === "user_led" && result.answeredByHuman !== true) {
+        throw new HonestyRuleError("Over to you stays open until a human answers; an agent cannot fill it.", "user_led_requires_human_answer");
+    }
+    // A pass checkmark must correspond to a real recorded result: the evidence id
+    // must be present AND a member of the item's active evidence. With no recorded
+    // evidence a pass cannot be claimed (no escape hatch for the unrecorded case).
+    if ((format === "testing" || format === "comparing") && result.status === "pass") {
+        const active = item.evidence_summary?.active_evidence_ids ?? [];
+        const backed = Boolean(result.evidenceId) && active.includes(result.evidenceId);
+        if (!backed) {
+            throw new HonestyRuleError("A pass checkmark requires a real recorded result, never agent prose alone.", "pass_requires_recorded_evidence");
+        }
+    }
+}
+function renderBody(item, format, result) {
+    switch (format) {
+        case "testing":
+            return renderTesting(item, result);
+        case "comparing":
+            return renderComparing(item, result);
+        case "inspecting":
+            return renderInspecting(item);
+        case "reviewing":
+            return renderReviewing(item);
+        case "user_led":
+            return renderUserLed(item, result);
+        case "explaining":
+            return renderExplaining(item);
+    }
+}
+function renderTesting(item, result) {
+    return [
+        `Run:     ${joinSteps(item.resolved_steps)}`,
+        `Expect:  ${joinSteps(item.expected_observations)}`,
+        `Got:     ${gotLine(result)}`
+    ].join("\n");
+}
+function renderComparing(item, result) {
+    const bad = item.resolved_steps[0] ?? "(blocked case)";
+    const good = item.resolved_steps[1] ?? "(allowed case)";
+    const suffix = result?.got ? `    -> ${result.got}` : "";
+    return [
+        `${MARK_FAIL}  ${bad}    -> should be blocked${suffix}`,
+        `${MARK_PASS}  ${good}    -> should work${suffix}`
+    ].join("\n");
+}
+function renderInspecting(item) {
+    return [
+        `In:    ${item.resolved_steps[0] ?? "(the real artifact)"}`,
+        `Look:  ${item.expected_observations[0] ?? "(the part that matters)"}`
+    ].join("\n");
+}
+function renderReviewing(item) {
+    const from = item.evidence_summary?.basis ?? "(earlier run)";
+    return [
+        `From:   ${from}`,
+        `Shows:  ${joinSteps(item.expected_observations)}    (not re-run now)`
+    ].join("\n");
+}
+function renderUserLed(item, result) {
+    const steps = item.resolved_steps.length > 0
+        ? item.resolved_steps.map((step, index) => `${index + 1}.  ${step}`)
+        : ["1.  (follow the steps with the agent)"];
+    const confirm = result?.answeredByHuman === true ? "Confirm:  yes" : "Confirm:  yes / no";
+    return `${steps.join("\n")}\n\n${confirm}`;
+}
+function renderExplaining(item) {
+    const text = item.expected_observations.length > 0
+        ? joinSteps(item.expected_observations)
+        : joinSteps(item.resolved_steps);
+    return `${text}\n\n(not run -- explanation only)`;
+}
+function gotLine(result) {
+    if (!result || !result.status) {
+        return "(pending)";
+    }
+    const mark = result.status === "pass" ? MARK_PASS : MARK_FAIL;
+    return `${result.got ?? ""} ${mark}`.trim();
+}
+function joinSteps(values) {
+    return values.length > 0 ? values.join("; ") : "(none)";
+}
+//# sourceMappingURL=renderCard.js.map

package/packages/core/dist/presentation/renderCard.js.map

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

package/packages/core/dist/presentation/scoring.d.ts

@@ -0,0 +1,10 @@
+import type { LoadedUseCase, PresentationCandidate, PresentationMode, SelectionProfile } from "./types.js";
+export declare const SHOWCASE_PROFILE: SelectionProfile;
+export declare const WALKTHROUGH_PROFILE: SelectionProfile;
+export declare function scoreUseCase(item: LoadedUseCase, mode: PresentationMode, changed: boolean): PresentationCandidate["scoreComponents"];
+export declare function compareCandidates(left: PresentationCandidate, right: PresentationCandidate): number;
+export declare function scoreReasons(item: LoadedUseCase, changed: boolean, mode: PresentationMode): {
+    codes: string[];
+    reasons: string[];
+};
+//# sourceMappingURL=scoring.d.ts.map

package/packages/core/dist/presentation/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/presentation/scoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3G,eAAO,MAAM,gBAAgB,EAAE,gBAM9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC;AA+BF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,CAQpI;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAYnG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG;IAC3F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAkBA"}

package/packages/core/dist/presentation/scoring.js

@@ -0,0 +1,82 @@
+export const SHOWCASE_PROFILE = {
+    id: "showcase-v1",
+    mode: "showcase",
+    defaultTimeboxSeconds: 600,
+    defaultMaxItems: 5,
+    fallbackEstimateSeconds: 120
+};
+export const WALKTHROUGH_PROFILE = {
+    id: "walkthrough-v1",
+    mode: "walkthrough",
+    defaultTimeboxSeconds: 1800,
+    defaultMaxItems: 12,
+    fallbackEstimateSeconds: 180
+};
+const VALUE_RANK = {
+    critical: 400,
+    core: 300,
+    supporting: 200,
+    long_tail: 100
+};
+const SHOWCASE_JOURNEY_RANK = {
+    golden: 50,
+    alternate: 40,
+    edge: 30,
+    negative: 20,
+    failure: 10
+};
+const WALKTHROUGH_JOURNEY_RANK = {
+    golden: 50,
+    alternate: 45,
+    edge: 45,
+    negative: 45,
+    failure: 45
+};
+const FREQUENCY_RANK = {
+    common: 30,
+    occasional: 20,
+    rare: 10
+};
+export function scoreUseCase(item, mode, changed) {
+    const journeyRank = mode === "showcase" ? SHOWCASE_JOURNEY_RANK : WALKTHROUGH_JOURNEY_RANK;
+    return {
+        changed: changed ? 1_000 : 0,
+        value: VALUE_RANK[item.value.value_tier],
+        journey: journeyRank[item.value.journey_role],
+        frequency: FREQUENCY_RANK[item.value.usage_frequency]
+    };
+}
+export function compareCandidates(left, right) {
+    for (const key of ["changed", "value", "journey", "frequency"]) {
+        const diff = right.scoreComponents[key] - left.scoreComponents[key];
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    const featureDiff = left.useCase.feature.id.localeCompare(right.useCase.feature.id);
+    if (featureDiff !== 0) {
+        return featureDiff;
+    }
+    return left.useCase.value.id.localeCompare(right.useCase.value.id);
+}
+export function scoreReasons(item, changed, mode) {
+    const codes = [];
+    const reasons = [];
+    if (changed) {
+        codes.push("changed_source");
+        reasons.push("Matched an explicitly changed source path.");
+    }
+    codes.push(`value_${item.value.value_tier}`);
+    reasons.push(`${sentenceCase(item.value.value_tier)} value use case.`);
+    codes.push(`journey_${item.value.journey_role}`);
+    reasons.push(mode === "showcase" && item.value.journey_role === "golden"
+        ? "Golden path is preferred for a high-level showcase."
+        : `${sentenceCase(item.value.journey_role)} journey coverage.`);
+    codes.push(`frequency_${item.value.usage_frequency}`);
+    reasons.push(`${sentenceCase(item.value.usage_frequency)} usage frequency.`);
+    return { codes, reasons };
+}
+function sentenceCase(value) {
+    return value.replaceAll("_", " ").replace(/^\w/, (first) => first.toUpperCase());
+}
+//# sourceMappingURL=scoring.js.map

package/packages/core/dist/presentation/scoring.js.map

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

package/packages/core/dist/presentation/selectPlan.d.ts

@@ -0,0 +1,4 @@
+import type { PresentationPlan, PresentationPlanResult, PresentationPlanSelectionOptions, SelectionProfile } from "./types.js";
+export declare function selectPlan(options: PresentationPlanSelectionOptions, profile: SelectionProfile): PresentationPlanResult;
+export declare function computePresentationPlanHash(plan: PresentationPlan): string;
+//# sourceMappingURL=selectPlan.d.ts.map

package/packages/core/dist/presentation/selectPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectPlan.d.ts","sourceRoot":"","sources":["../../src/presentation/selectPlan.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,gCAAgC,EAChC,gBAAgB,EACjB,MAAM,YAAY,CAAC;AASpB,wBAAgB,UAAU,CACxB,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,gBAAgB,GACxB,sBAAsB,CA2GxB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAQ1E"}

package/packages/core/dist/presentation/selectPlan.js

@@ -0,0 +1,122 @@
+import { computeSemanticHash } from "../schema/index.js";
+import { compareCandidates } from "./scoring.js";
+import { buildCandidates, exclusionFor, summarizeCandidates } from "./candidates.js";
+import { orderWalkthrough } from "./ordering.js";
+import { selectWithinLimits } from "./selection.js";
+import { planGaps, sectionsFor, toPlanItem } from "./items.js";
+import { evidenceDigest, matrixDigest, planId, workflowSnapshot } from "./snapshot.js";
+import { normalizePaths } from "./planHelpers.js";
+const ZERO_HASH = "sha256:0000000000000000000000000000000000000000000000000000000000000000";
+const FRESHNESS_POLICY = {
+    id: "default-v1",
+    digest: computeSemanticHash({ semanticHashMismatch: "needs_review" }),
+    semanticHashMismatch: "needs_review"
+};
+export function selectPlan(options, profile) {
+    const generatedAt = options.request.generatedAt ?? new Date().toISOString();
+    const freshnessEvaluatedAt = options.request.freshnessEvaluatedAt ?? generatedAt;
+    const hostSurface = options.request.hostSurface ?? "unknown";
+    const timeboxSeconds = options.request.timeboxSeconds || profile.defaultTimeboxSeconds;
+    const maxItems = options.request.maxItems ?? profile.defaultMaxItems;
+    const inputIntegrity = {
+        matrix: options.matrix.integrity.state,
+        evidence: options.evidence.integrity.state
+    };
+    const incompleteInput = !options.matrix.complete || !options.evidence.complete;
+    const candidates = buildCandidates(options, profile, hostSurface);
+    const eligible = candidates.filter((candidate) => candidate.eligible);
+    if (options.request.strict && incompleteInput) {
+        return {
+            schema_version: 1,
+            outcome: "integrity_blocked",
+            plan: null,
+            candidate_summary: summarizeCandidates(candidates, []),
+            input_integrity: inputIntegrity
+        };
+    }
+    if (eligible.length === 0) {
+        return {
+            schema_version: 1,
+            outcome: "no_eligible_items",
+            plan: null,
+            candidate_summary: summarizeCandidates(candidates, []),
+            input_integrity: inputIntegrity
+        };
+    }
+    const ordered = profile.mode === "walkthrough" ? orderWalkthrough(eligible) : eligible.slice().sort(compareCandidates);
+    const selected = selectWithinLimits(ordered, profile.fallbackEstimateSeconds, maxItems, timeboxSeconds);
+    const selectedSet = new Set(selected.map((candidate) => candidate.useCase.value.id));
+    const selectedItems = selected.map((candidate) => toPlanItem(candidate, options.evidence, profile, hostSurface));
+    const exclusions = candidates
+        .filter((candidate) => !selectedSet.has(candidate.useCase.value.id))
+        .map((candidate) => candidate.exclusion ?? exclusionFor(candidate, "max_items"));
+    const knownGaps = planGaps(incompleteInput);
+    const readiness = incompleteInput
+        ? "partial_due_to_integrity"
+        : selectedItems.some((item) => item.known_gaps.some((gap) => gap.severity !== "info"))
+            ? "ready_with_evidence_gaps"
+            : "ready";
+    const planWithoutHash = {
+        schema_version: 1,
+        plan_id: planId(profile.mode, generatedAt),
+        plan_content_hash: ZERO_HASH,
+        generated_at: generatedAt,
+        mode: profile.mode,
+        complete: !incompleteInput,
+        prepared_not_performed: true,
+        readiness,
+        integrity_acknowledgement_required: incompleteInput,
+        selection_method: "deterministic",
+        selection_profile: {
+            id: profile.id,
+            version: 1,
+            digest: computeSemanticHash(profile)
+        },
+        input_snapshot: {
+            matrix_digest: matrixDigest(options),
+            evidence_basis_digest: evidenceDigest(options.evidence, selectedItems.map((item) => item.use_case_id)),
+            changed_paths: normalizePaths(options.request.changedPaths ?? []),
+            freshness_policy: {
+                id: FRESHNESS_POLICY.id,
+                digest: FRESHNESS_POLICY.digest,
+                evaluated_at: freshnessEvaluatedAt
+            },
+            host_surface: hostSurface,
+            workflow: workflowSnapshot(options)
+        },
+        workspace_snapshot: {
+            repository_id: "unknown",
+            vcs: "unknown",
+            head_revision: "unknown",
+            dirty: false,
+            working_tree_digest: ZERO_HASH,
+            component_id: options.context.component_id,
+            captured_at: freshnessEvaluatedAt
+        },
+        environment_expectations: {
+            host_surfaces: [hostSurface]
+        },
+        audience: options.request.audience,
+        timebox_seconds: timeboxSeconds,
+        sections: sectionsFor(profile.mode, selectedItems),
+        selected_items: selectedItems,
+        exclusions,
+        known_gaps: knownGaps
+    };
+    const plan = {
+        ...planWithoutHash,
+        plan_content_hash: computePresentationPlanHash(planWithoutHash)
+    };
+    return {
+        schema_version: 1,
+        outcome: "generated",
+        plan,
+        candidate_summary: summarizeCandidates(candidates, selected),
+        input_integrity: inputIntegrity
+    };
+}
+export function computePresentationPlanHash(plan) {
+    const { plan_id: _planId, generated_at: _generatedAt, plan_content_hash: _planContentHash, ...stable } = plan;
+    return computeSemanticHash(stable);
+}
+//# sourceMappingURL=selectPlan.js.map

package/packages/core/dist/presentation/selectPlan.js.map

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

package/packages/core/dist/presentation/selectShowcasePlan.d.ts

@@ -0,0 +1,3 @@
+import type { PresentationPlanResult, PresentationPlanSelectionOptions } from "./types.js";
+export declare function selectShowcasePlan(options: PresentationPlanSelectionOptions): PresentationPlanResult;
+//# sourceMappingURL=selectShowcasePlan.d.ts.map

package/packages/core/dist/presentation/selectShowcasePlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectShowcasePlan.d.ts","sourceRoot":"","sources":["../../src/presentation/selectShowcasePlan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAE3F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gCAAgC,GAAG,sBAAsB,CAEpG"}

package/packages/core/dist/presentation/selectShowcasePlan.js

@@ -0,0 +1,6 @@
+import { selectPlan } from "./selectPlan.js";
+import { SHOWCASE_PROFILE } from "./scoring.js";
+export function selectShowcasePlan(options) {
+    return selectPlan(options, SHOWCASE_PROFILE);
+}
+//# sourceMappingURL=selectShowcasePlan.js.map

package/packages/core/dist/presentation/selectShowcasePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectShowcasePlan.js","sourceRoot":"","sources":["../../src/presentation/selectShowcasePlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,UAAU,kBAAkB,CAAC,OAAyC;IAC1E,OAAO,UAAU,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC/C,CAAC"}

package/packages/core/dist/presentation/selectWalkthroughPlan.d.ts

@@ -0,0 +1,3 @@
+import type { PresentationPlanResult, PresentationPlanSelectionOptions } from "./types.js";
+export declare function selectWalkthroughPlan(options: PresentationPlanSelectionOptions): PresentationPlanResult;
+//# sourceMappingURL=selectWalkthroughPlan.d.ts.map

package/packages/core/dist/presentation/selectWalkthroughPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectWalkthroughPlan.d.ts","sourceRoot":"","sources":["../../src/presentation/selectWalkthroughPlan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAE3F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gCAAgC,GAAG,sBAAsB,CAEvG"}

package/packages/core/dist/presentation/selectWalkthroughPlan.js

@@ -0,0 +1,6 @@
+import { selectPlan } from "./selectPlan.js";
+import { WALKTHROUGH_PROFILE } from "./scoring.js";
+export function selectWalkthroughPlan(options) {
+    return selectPlan(options, WALKTHROUGH_PROFILE);
+}
+//# sourceMappingURL=selectWalkthroughPlan.js.map

package/packages/core/dist/presentation/selectWalkthroughPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectWalkthroughPlan.js","sourceRoot":"","sources":["../../src/presentation/selectWalkthroughPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,UAAU,qBAAqB,CAAC,OAAyC;IAC7E,OAAO,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;AAClD,CAAC"}

package/packages/core/dist/presentation/selection.d.ts

@@ -0,0 +1,7 @@
+import type { PresentationCandidate } from "./types.js";
+/**
+ * Selection within limits: walk the ordered candidates and take items until the
+ * item cap or the timebox (using a flat per-item estimate) is reached.
+ */
+export declare function selectWithinLimits(ordered: PresentationCandidate[], estimatedSeconds: number, maxItems: number, timeboxSeconds: number): PresentationCandidate[];
+//# sourceMappingURL=selection.d.ts.map

package/packages/core/dist/presentation/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/presentation/selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;GAGG;AAEH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,qBAAqB,EAAE,EAChC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,qBAAqB,EAAE,CAczB"}

package/packages/core/dist/presentation/selection.js

@@ -0,0 +1,20 @@
+/**
+ * Selection within limits: walk the ordered candidates and take items until the
+ * item cap or the timebox (using a flat per-item estimate) is reached.
+ */
+export function selectWithinLimits(ordered, estimatedSeconds, maxItems, timeboxSeconds) {
+    const selected = [];
+    let usedSeconds = 0;
+    for (const candidate of ordered) {
+        if (selected.length >= maxItems) {
+            break;
+        }
+        if (usedSeconds + estimatedSeconds > timeboxSeconds) {
+            break;
+        }
+        selected.push(candidate);
+        usedSeconds += estimatedSeconds;
+    }
+    return selected;
+}
+//# sourceMappingURL=selection.js.map

package/packages/core/dist/presentation/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/presentation/selection.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,gBAAwB,EACxB,QAAgB,EAChB,cAAsB;IAEtB,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM;QACR,CAAC;QACD,IAAI,WAAW,GAAG,gBAAgB,GAAG,cAAc,EAAE,CAAC;YACpD,MAAM;QACR,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,WAAW,IAAI,gBAAgB,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/packages/core/dist/presentation/snapshot.d.ts

@@ -0,0 +1,12 @@
+import type { EvidenceSnapshot } from "../evidence/types.js";
+import type { PresentationPlan, PresentationPlanSelectionOptions } from "./types.js";
+/**
+ * Input / workspace snapshot construction: the deterministic digests and
+ * workflow snapshot that pin a plan to the inputs it was generated from, plus
+ * the plan id derivation.
+ */
+export declare function matrixDigest(options: PresentationPlanSelectionOptions): string;
+export declare function evidenceDigest(evidence: EvidenceSnapshot, useCaseIds: string[]): string;
+export declare function workflowSnapshot(options: PresentationPlanSelectionOptions): PresentationPlan["input_snapshot"]["workflow"];
+export declare function planId(mode: "showcase" | "walkthrough", generatedAt: string): string;
+//# sourceMappingURL=snapshot.d.ts.map

package/packages/core/dist/presentation/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/presentation/snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAErF;;;;GAIG;AAEH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gCAAgC,GAAG,MAAM,CAU9E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBvF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gCAAgC,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAY1H;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpF"}

package/packages/core/dist/presentation/snapshot.js

@@ -0,0 +1,53 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { computeSemanticHash } from "../schema/index.js";
+/**
+ * Input / workspace snapshot construction: the deterministic digests and
+ * workflow snapshot that pin a plan to the inputs it was generated from, plus
+ * the plan id derivation.
+ */
+export function matrixDigest(options) {
+    return computeSemanticHash({
+        complete: options.matrix.complete,
+        integrity: options.matrix.integrity,
+        use_cases: options.matrix.addressableUseCases.map((item) => ({
+            id: item.value.id,
+            semantic_hash: item.semanticHash,
+            source_path: item.source.path
+        }))
+    });
+}
+export function evidenceDigest(evidence, useCaseIds) {
+    const ids = new Set(useCaseIds);
+    const aggregates = evidence.aggregates
+        .filter((aggregate) => aggregate.targetLinks.some((target) => ids.has(target.use_case_id)))
+        .map((aggregate) => ({
+        evidence_id: aggregate.evidenceId,
+        status: aggregate.status,
+        event_ids: aggregate.eventIds,
+        target_links: aggregate.targetLinks,
+        freshness_inputs: aggregate.freshnessInputs
+    }));
+    return computeSemanticHash({
+        complete: evidence.complete,
+        integrity: evidence.integrity,
+        aggregates
+    });
+}
+export function workflowSnapshot(options) {
+    const configPath = join(options.context.workspace_root, "use-cases.yml");
+    if (!existsSync(configPath)) {
+        return { effective_mode: "continuous", source: "default", advisory: true };
+    }
+    const source = readFileSync(configPath, "utf8");
+    const effectiveMode = source.match(/^default_workflow_mode:\s*([a-z_]+)/m)?.[1] ?? "continuous";
+    return {
+        effective_mode: effectiveMode,
+        source: source.match(/^default_workflow_mode:/m) ? "workspace_config" : "default",
+        advisory: true
+    };
+}
+export function planId(mode, generatedAt) {
+    return `plan.${mode}.${generatedAt.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "")}`;
+}
+//# sourceMappingURL=snapshot.js.map

package/packages/core/dist/presentation/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/presentation/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzD;;;;GAIG;AAEH,MAAM,UAAU,YAAY,CAAC,OAAyC;IACpE,OAAO,mBAAmB,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;QACjC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;QACnC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3D,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;YACjB,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;SAC9B,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA0B,EAAE,UAAoB;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU;SACnC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;SAC1F,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnB,WAAW,EAAE,SAAS,CAAC,UAAU;QACjC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,SAAS,EAAE,SAAS,CAAC,QAAQ;QAC7B,YAAY,EAAE,SAAS,CAAC,WAAW;QACnC,gBAAgB,EAAE,SAAS,CAAC,eAAe;KAC5C,CAAC,CAAC,CAAC;IACN,OAAO,mBAAmB,CAAC;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAyC;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IACzE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7E,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;IAChG,OAAO;QACL,cAAc,EAAE,aAAa;QAC7B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;QACjF,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAgC,EAAE,WAAmB;IAC1E,OAAO,QAAQ,IAAI,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC;AACzG,CAAC"}