@adammcarter/use-cases 0.1.0

package/packages/core/dist/package/inspectPackage.js

@@ -0,0 +1,371 @@
+import { spawnSync } from "node:child_process";
+import { accessSync, constants, existsSync, mkdtempSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { diagnostic } from "../schema/index.js";
+const REQUIRED_PACKAGE_PATHS = [
+    ".agents/skills/use-cases/SKILL.md",
+    ".agents/skills/showcase/SKILL.md",
+    ".agents/skills/walkthrough/SKILL.md",
+    ".codex-plugin/plugin.json",
+    ".claude-plugin/plugin.json",
+    ".mcp.json",
+    "bootstrap/use-cases.md",
+    "docs/release.md",
+    "docs/security.md",
+    "hosts/codex.yml",
+    "packages/cli/dist/index.js",
+    "packages/cli/package.json",
+    "packages/core/dist/index.js",
+    "packages/core/dist/schemas/v1/use-case-file.schema.json",
+    "packages/core/package.json",
+    "packages/mcp/dist/index.js",
+    "packages/mcp/package.json",
+    "plugin.json",
+    "README.md",
+    "CHANGELOG.md",
+    "schemas/v1/use-case-file.schema.json",
+    "use-cases/showcase/live.yml"
+];
+const FORBIDDEN_PACKAGE_SEGMENTS = [
+    ".DS_Store",
+    ".copy-schemas.lock",
+    "node_modules",
+    "coverage",
+    "tests",
+    "src"
+];
+// `src`/`tests` are forbidden for the repo's OWN payload (the published plugin
+// must ship built artifacts, never TypeScript sources or the test suite), but
+// they are legitimate CONTENT of the example PROJECTS under examples/ — e.g.
+// examples/python-pytest ships a real src/ + tests/ layout that an adopter copies
+// (the python.pytest verifier preset mandates the tests/ path). Permit only these
+// two segments, and only beneath examples/; every other forbidden segment
+// (node_modules, coverage, .DS_Store, …) stays forbidden everywhere.
+const EXAMPLE_CONTENT_SEGMENTS = new Set(["src", "tests"]);
+const FORBIDDEN_TEXT_PATTERNS = [
+    { id: "local_user_path", pattern: /\/Users\/admin\b/ },
+    { id: "mac_temp_path", pattern: /\/var\/folders\/|\/private\/var\/folders\// },
+    { id: "openai_key", pattern: /sk-[A-Za-z0-9_-]{20,}/ },
+    { id: "github_token", pattern: /gh[pousr]_[A-Za-z0-9_]{20,}/ },
+    { id: "private_key", pattern: /BEGIN (?:OPENSSH|RSA|EC|DSA) PRIVATE KEY/ }
+];
+export function inspectPackageArtifact(options) {
+    const prepared = prepareInspectionTarget(options.target);
+    const skipInstalledDependencies = prepared.inspectionTarget.kind === "installed_root";
+    const entries = listPackageEntries(prepared.root, { skipNodeModules: skipInstalledDependencies });
+    const requiredPaths = REQUIRED_PACKAGE_PATHS.map((path) => ({
+        path,
+        status: existsSync(join(prepared.root, path)) ? "present" : "missing"
+    }));
+    const manifestReferences = packageManifestReferences(prepared.root);
+    const binEntrypoints = packageBinEntrypoints(prepared.root);
+    const filesAllowlist = packageFilesAllowlist(prepared.root);
+    const forbiddenPaths = packageForbiddenPaths(entries, filesAllowlist.files);
+    const forbiddenText = scanForbiddenText(prepared.root, { skipNodeModules: skipInstalledDependencies });
+    const installedSmoke = prepared.inspectionTarget.kind === "installed_root"
+        ? runInstalledPackageSmoke({ installedRoot: prepared.root })
+        : undefined;
+    const diagnostics = [
+        ...requiredPaths
+            .filter((item) => item.status === "missing")
+            .map((item) => diagnostic("package.required_path_missing", `Missing package path '${item.path}'.`, item.path)),
+        ...manifestReferences
+            .filter((item) => item.status !== "resolved")
+            .map((item) => diagnostic("package.manifest_reference_unresolved", `Manifest reference '${item.target}' from '${item.from}' is not resolved.`, item.target)),
+        ...binEntrypoints
+            .filter((item) => item.status !== "present")
+            .map((item) => diagnostic("package.bin_missing", `Package bin '${item.name}' does not resolve to '${item.path}'.`, item.path)),
+        ...binEntrypoints
+            .filter((item) => item.status === "present" && !item.executable)
+            .map((item) => diagnostic("package.bin_not_executable", `Package bin '${item.name}' is not executable.`, item.path)),
+        ...binEntrypoints
+            .filter((item) => item.status === "present" && !item.shebang)
+            .map((item) => diagnostic("package.bin_shebang_missing", `Package bin '${item.name}' is missing a node shebang.`, item.path)),
+        ...filesAllowlist.diagnostics,
+        ...forbiddenPaths.map((path) => diagnostic("package.forbidden_path", `Forbidden package path '${path}' is present or allowlisted.`, path)),
+        ...forbiddenText.map((hit) => diagnostic("package.forbidden_text", `Forbidden text pattern '${hit.pattern}' found in '${hit.path}'.`, hit.path)),
+        ...smokeDiagnostics(installedSmoke)
+    ];
+    return {
+        schema_version: 1,
+        complete: diagnostics.length === 0,
+        inspection_target: prepared.inspectionTarget,
+        package_entries: entries,
+        required_paths: requiredPaths,
+        manifest_references: manifestReferences,
+        bin_entrypoints: binEntrypoints,
+        files_allowlist: filesAllowlist.files,
+        forbidden_paths: forbiddenPaths,
+        forbidden_text: forbiddenText,
+        ...(installedSmoke ? { installed_smoke: installedSmoke } : {}),
+        diagnostics
+    };
+}
+export function runInstalledPackageSmoke(options) {
+    const cliPath = join(options.installedRoot, "packages/cli/dist/index.js");
+    const mcpPath = join(options.installedRoot, "packages/mcp/dist/index.js");
+    const cli = spawnSync(process.execPath, [cliPath, "schema", "list", "--json"], {
+        cwd: options.installedRoot,
+        encoding: "utf8",
+        timeout: 10_000
+    });
+    const mcpInput = [
+        JSON.stringify({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+                protocolVersion: "2024-11-05",
+                capabilities: {},
+                clientInfo: { name: "package-doctor", version: "0.0.0" }
+            }
+        }),
+        JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/list", params: {} }),
+        ""
+    ].join("\n");
+    const mcp = spawnSync(process.execPath, [mcpPath], {
+        cwd: options.installedRoot,
+        input: mcpInput,
+        encoding: "utf8",
+        timeout: 10_000
+    });
+    return {
+        cli: smokeCheck(`${process.execPath} ${cliPath} schema list --json`, cli, cli.status === 0 && cli.stdout.includes("schema.list")),
+        mcp: smokeCheck(`${process.execPath} ${mcpPath}`, mcp, mcp.status === 0 && mcp.stdout.includes("tools") && mcp.stdout.includes("matrix_validate"))
+    };
+}
+function prepareInspectionTarget(target) {
+    if (target.kind === "installed_root") {
+        return {
+            root: resolve(target.path),
+            inspectionTarget: { kind: "installed_root", path: resolve(target.path) }
+        };
+    }
+    if (target.kind === "tarball") {
+        const tarball = resolve(target.path);
+        return {
+            root: extractTarball(tarball),
+            inspectionTarget: { kind: "tarball", path: tarball }
+        };
+    }
+    const workspace = resolve(target.path);
+    if (target.build) {
+        requireCommandSuccess(spawnSync("corepack", ["pnpm", "build"], {
+            cwd: workspace,
+            encoding: "utf8",
+            env: { ...process.env, COREPACK_ENABLE_DOWNLOAD_PROMPT: "0" }
+        }), "corepack pnpm build");
+    }
+    const packDir = mkdtempSync(join(tmpdir(), "use-cases-doctor-pack-"));
+    const pack = spawnSync("corepack", ["pnpm", "pack", "--json", "--pack-destination", packDir], {
+        cwd: workspace,
+        encoding: "utf8",
+        env: { ...process.env, COREPACK_ENABLE_DOWNLOAD_PROMPT: "0" }
+    });
+    requireCommandSuccess(pack, "corepack pnpm pack --json");
+    const payload = JSON.parse(pack.stdout);
+    return {
+        root: extractTarball(payload.filename),
+        inspectionTarget: { kind: "tarball", path: payload.filename, source_workspace: workspace }
+    };
+}
+function listPackageEntries(root, options) {
+    return listFiles(root, options).map((path) => normalizePackagePath(relative(root, path))).sort();
+}
+function extractTarball(tarball) {
+    const extractDir = mkdtempSync(join(tmpdir(), "use-cases-doctor-extract-"));
+    const result = spawnSync("tar", ["-xzf", tarball, "-C", extractDir], { encoding: "utf8" });
+    requireCommandSuccess(result, `tar -xzf ${tarball}`);
+    const packageRoot = join(extractDir, "package");
+    if (!existsSync(packageRoot)) {
+        throw new Error(`Package tarball did not contain a package/ root: ${tarball}`);
+    }
+    return packageRoot;
+}
+function packageManifestReferences(root) {
+    const references = [];
+    for (const from of [".codex-plugin/plugin.json", ".claude-plugin/plugin.json", "plugin.json"]) {
+        const manifestPath = join(root, from);
+        if (!existsSync(manifestPath)) {
+            continue;
+        }
+        const manifest = readJson(manifestPath);
+        if (manifest.mcpServers) {
+            references.push(...manifestMcpReferences(root, from, manifest.mcpServers));
+        }
+    }
+    const mcpPath = join(root, ".mcp.json");
+    if (existsSync(mcpPath)) {
+        const mcp = readJson(mcpPath);
+        const server = mcp.mcpServers?.["use-cases"];
+        const target = resolvePackagedReference(root, ".mcp.json", server?.args?.[0] ?? "");
+        references.push({
+            from: ".mcp.json",
+            target,
+            status: target && existsSync(join(root, target)) ? "resolved" : "missing"
+        });
+    }
+    return references;
+}
+function manifestMcpReferences(root, from, value) {
+    if (typeof value === "string") {
+        const target = resolvePackagedReference(root, from, value);
+        return [{
+                from,
+                target,
+                status: target && existsSync(join(root, target)) ? "resolved" : "missing"
+            }];
+    }
+    return Object.values(value).flatMap((server) => {
+        const arg = server.args?.[0];
+        if (!arg || !arg.startsWith(".")) {
+            return [];
+        }
+        const target = resolvePackagedReference(root, from, arg);
+        return [{
+                from,
+                target,
+                status: target && existsSync(join(root, target)) ? "resolved" : "missing"
+            }];
+    });
+}
+function resolvePackagedReference(root, from, value) {
+    const candidates = [
+        normalizePackagePath(value),
+        normalizePackagePath(join(dirname(from), value))
+    ].filter((candidate) => candidate && !candidate.startsWith("../") && candidate !== "..");
+    return candidates.find((candidate) => existsSync(join(root, candidate))) ?? candidates[0] ?? "";
+}
+function packageBinEntrypoints(root) {
+    return ["packages/cli/package.json", "packages/mcp/package.json"].flatMap((manifestPath) => {
+        const packageJson = readJson(join(root, manifestPath));
+        return Object.entries(packageJson.bin ?? {}).map(([name, value]) => {
+            const path = normalizePackagePath(join(dirname(manifestPath), value));
+            const fullPath = join(root, path);
+            return {
+                name,
+                path,
+                status: existsSync(fullPath) ? "present" : "missing",
+                executable: hasExecutableBit(fullPath),
+                shebang: hasNodeShebang(fullPath)
+            };
+        });
+    });
+}
+function packageFilesAllowlist(root) {
+    const packageJson = readJson(join(root, "package.json"));
+    if (!Array.isArray(packageJson.files) || !packageJson.files.every((item) => typeof item === "string")) {
+        return {
+            files: [],
+            diagnostics: [diagnostic("package.files_allowlist_missing", "package.json must declare a files allowlist.", "package.json")]
+        };
+    }
+    return {
+        files: packageJson.files.map((item) => normalizePackagePath(item)),
+        diagnostics: []
+    };
+}
+function packageForbiddenPaths(entries, filesAllowlist) {
+    const forbidden = new Set();
+    for (const value of [...entries, ...filesAllowlist]) {
+        if (containsForbiddenSegment(value)) {
+            forbidden.add(value);
+        }
+    }
+    return Array.from(forbidden).sort();
+}
+function scanForbiddenText(root, options) {
+    const hits = [];
+    for (const file of listFiles(root, options)) {
+        if (!isTextFile(file)) {
+            continue;
+        }
+        const rel = normalizePackagePath(relative(root, file));
+        const text = readFileSync(file, "utf8");
+        for (const forbidden of FORBIDDEN_TEXT_PATTERNS) {
+            if (forbidden.pattern.test(text)) {
+                hits.push({ path: rel, pattern: forbidden.id });
+            }
+        }
+    }
+    return hits;
+}
+function listFiles(root, options) {
+    const stat = statSync(root);
+    if (!stat.isDirectory()) {
+        return [root];
+    }
+    return readdirSync(root).flatMap((entry) => {
+        if (options.skipNodeModules && entry === "node_modules") {
+            return [];
+        }
+        return listFiles(join(root, entry), options);
+    });
+}
+function isTextFile(path) {
+    return /\.(?:cjs|js|json|map|md|mjs|txt|yml|yaml)$/.test(basename(path));
+}
+function containsForbiddenSegment(path) {
+    const parts = path.split(/[\\/]/);
+    const underExamples = parts.includes("examples");
+    return FORBIDDEN_PACKAGE_SEGMENTS.some((segment) => {
+        if (underExamples && EXAMPLE_CONTENT_SEGMENTS.has(segment)) {
+            return false;
+        }
+        return parts.includes(segment);
+    });
+}
+function normalizePackagePath(path) {
+    return path.replaceAll("\\", "/").replace(/^\.\//, "");
+}
+function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+function hasExecutableBit(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function hasNodeShebang(path) {
+    if (!existsSync(path)) {
+        return false;
+    }
+    return readFileSync(path, "utf8").startsWith("#!/usr/bin/env node");
+}
+function smokeCheck(command, result, passed) {
+    return {
+        status: passed ? "passed" : "failed",
+        command,
+        exit_code: result.status ?? null,
+        stdout: trimOutput(result.stdout),
+        stderr: trimOutput(result.stderr)
+    };
+}
+function smokeDiagnostics(smoke) {
+    if (!smoke) {
+        return [];
+    }
+    return Object.entries(smoke)
+        .filter(([, check]) => check.status !== "passed")
+        .map(([name, check]) => diagnostic("package.installed_smoke_failed", `Installed ${name} smoke failed.`, check.command));
+}
+function trimOutput(value) {
+    const text = typeof value === "string" ? value : value?.toString("utf8");
+    const trimmed = text?.trim();
+    return trimmed ? trimmed.slice(0, 2_000) : undefined;
+}
+function requireCommandSuccess(result, command) {
+    if (result.status !== 0) {
+        throw new Error([
+            `${command} failed with status ${result.status}`,
+            `stdout:\n${trimOutput(result.stdout) ?? ""}`,
+            `stderr:\n${trimOutput(result.stderr) ?? ""}`
+        ].join("\n"));
+    }
+}
+//# sourceMappingURL=inspectPackage.js.map

package/packages/core/dist/package/inspectPackage.js.map

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

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

@@ -0,0 +1,13 @@
+import type { HostSurface, LoadedUseCase } from "../useCases/types.js";
+import type { CandidateSummary, PresentationCandidate, PresentationPlanExclusion, PresentationPlanSelectionOptions, SelectionProfile } from "./types.js";
+/**
+ * Candidate building & eligibility: turning addressable use cases into scored
+ * presentation candidates, deciding which are eligible, and summarising the
+ * considered/excluded set. Exclusion construction lives here too, since it is a
+ * candidate concern.
+ */
+export declare function buildCandidates(options: PresentationPlanSelectionOptions, profile: SelectionProfile, hostSurface: HostSurface): PresentationCandidate[];
+export declare function summarizeCandidates(candidates: PresentationCandidate[], selected: PresentationCandidate[]): CandidateSummary;
+export declare function exclusionFor(candidate: PresentationCandidate, reasonCode: string): PresentationPlanExclusion;
+export declare function exclusionForUseCase(useCase: LoadedUseCase, reasonCode: string, reason: string, blocking: boolean): PresentationPlanExclusion;
+//# sourceMappingURL=candidates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../src/presentation/candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAa,MAAM,sBAAsB,CAAC;AAGlF,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,gCAAgC,EAChC,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AAEH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,WAAW,GACvB,qBAAqB,EAAE,CAqBzB;AAsBD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,GAAG,gBAAgB,CAU5H;AAUD,wBAAgB,YAAY,CAAC,SAAS,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,GAAG,yBAAyB,CAS5G;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,GAChB,yBAAyB,CAO3B"}

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

@@ -0,0 +1,86 @@
+import { scoreReasons, scoreUseCase } from "./scoring.js";
+import { expectedObservations, normalizePath, normalizePaths, resolvedSteps } from "./planHelpers.js";
+/**
+ * Candidate building & eligibility: turning addressable use cases into scored
+ * presentation candidates, deciding which are eligible, and summarising the
+ * considered/excluded set. Exclusion construction lives here too, since it is a
+ * candidate concern.
+ */
+export function buildCandidates(options, profile, hostSurface) {
+    const requestedUseCaseIds = new Set(options.request.requestedUseCaseIds ?? []);
+    return options.matrix.addressableUseCases.map((useCase) => {
+        const changed = matchesChangedPath(useCase, options.request.changedPaths ?? []);
+        const hardExclusion = hardEligibilityExclusion(useCase, hostSurface);
+        const requestExclusion = requestedUseCaseIds.size > 0 && !requestedUseCaseIds.has(useCase.value.id)
+            ? exclusionForUseCase(useCase, "not_requested", "Use case was not requested for this plan.", false)
+            : undefined;
+        const scoreComponents = scoreUseCase(useCase, profile.mode, changed);
+        const reasons = scoreReasons(useCase, changed, profile.mode);
+        return {
+            useCase,
+            eligible: !hardExclusion && !requestExclusion,
+            exclusion: hardExclusion ?? requestExclusion,
+            changed,
+            scoreComponents,
+            reasonCodes: reasons.codes,
+            reasons: reasons.reasons
+        };
+    });
+}
+function hardEligibilityExclusion(useCase, hostSurface) {
+    if (useCase.value.lifecycle !== "active") {
+        return exclusionForUseCase(useCase, "lifecycle", "Only active use cases are eligible by default.", true);
+    }
+    if (!hostMatches(useCase.value, hostSurface)) {
+        return exclusionForUseCase(useCase, "host_surface", `Use case is not supported on ${hostSurface}.`, true);
+    }
+    if (resolvedSteps(useCase).length === 0 || expectedObservations(useCase).length === 0) {
+        return exclusionForUseCase(useCase, "not_runnable", "Use case lacks runnable steps or expected observations.", true);
+    }
+    return undefined;
+}
+function hostMatches(useCase, hostSurface) {
+    if (hostSurface === "unknown" || !useCase.host_applicability?.length) {
+        return true;
+    }
+    return useCase.host_applicability.some((item) => item.host_surface === hostSurface && item.supported);
+}
+export function summarizeCandidates(candidates, selected) {
+    const selectedIds = new Set(selected.map((candidate) => candidate.useCase.value.id));
+    const exclusions = candidates.filter((candidate) => !selectedIds.has(candidate.useCase.value.id));
+    return {
+        considered: candidates.length,
+        eligible: candidates.filter((candidate) => candidate.eligible).length,
+        selected: selected.length,
+        excluded: exclusions.length,
+        excluded_by_reason: countByReason(exclusions.map((candidate) => candidate.exclusion?.reason_code ?? "max_items"))
+    };
+}
+function countByReason(reasons) {
+    const counts = {};
+    for (const reason of reasons) {
+        counts[reason] = (counts[reason] ?? 0) + 1;
+    }
+    return counts;
+}
+export function exclusionFor(candidate, reasonCode) {
+    return exclusionForUseCase(candidate.useCase, reasonCode, reasonCode === "timebox"
+        ? "Higher-priority items consumed the available timebox."
+        : "Higher-priority items consumed the available item cap.", false);
+}
+export function exclusionForUseCase(useCase, reasonCode, reason, blocking) {
+    return {
+        use_case_id: useCase.value.id,
+        reason_code: reasonCode,
+        reason,
+        blocking
+    };
+}
+function matchesChangedPath(useCase, changedPaths) {
+    if (changedPaths.length === 0) {
+        return false;
+    }
+    const changed = new Set(normalizePaths(changedPaths));
+    return (useCase.value.source_refs ?? []).some((sourceRef) => sourceRef.kind === "file" && changed.has(normalizePath(sourceRef.path)));
+}
+//# sourceMappingURL=candidates.js.map

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

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

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

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./presentationFormat.js";
+export * from "./renderCard.js";
+export * from "./scoring.js";
+export * from "./selectPlan.js";
+export * from "./selectShowcasePlan.js";
+export * from "./selectWalkthroughPlan.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

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

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./presentationFormat.js";
+export * from "./renderCard.js";
+export * from "./scoring.js";
+export * from "./selectPlan.js";
+export * from "./selectShowcasePlan.js";
+export * from "./selectWalkthroughPlan.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { EvidenceSnapshot } from "../evidence/types.js";
+import type { HostSurface } from "../useCases/types.js";
+import type { PlanGap, PresentationCandidate, PresentationPlanItem, SelectionProfile } from "./types.js";
+/**
+ * Item transforms & plan-content assembly: turning a selected candidate into a
+ * fully-resolved plan item (delivery kind, presentation format, required
+ * evidence, evidence/freshness summaries, gaps) plus the per-mode section and
+ * plan-level gap construction that depend on the resolved items.
+ */
+export declare function toPlanItem(candidate: PresentationCandidate, evidence: EvidenceSnapshot, profile: SelectionProfile, _hostSurface: HostSurface): PresentationPlanItem;
+export declare function planGaps(incompleteInput: boolean): PlanGap[];
+export declare function sectionsFor(mode: "showcase" | "walkthrough", selectedItems: PresentationPlanItem[]): {
+    section_id: string;
+    title: string;
+    purpose: string;
+    item_ids: string[];
+}[];
+//# sourceMappingURL=items.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/presentation/items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,sBAAsB,CAAC;AASvE,OAAO,KAAK,EACV,OAAO,EACP,qBAAqB,EACrB,oBAAoB,EAEpB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AAEH,wBAAgB,UAAU,CACxB,SAAS,EAAE,qBAAqB,EAChC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,WAAW,GACxB,oBAAoB,CAkDtB;AAqJD,wBAAgB,QAAQ,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,EAAE,CAgB5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE;;;;;IA2BlG"}