agentera 3.0.0-dev.4 → 3.0.0-dev.41

package/dist/cli/capabilityContext/bespoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bespoke.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/capabilityContext/bespoke.ts"],"names":[],"mappings":"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"}

package/dist/cli/capabilityContext/build.js

@@ -0,0 +1,244 @@
+import { asList } from "../stateQuery.js";
+import { capabilityContext } from "./contract.js";
+import { sourceProvenance, uniqueList, hasRecordedValue, taskRef } from "./shared.js";
+import { closeoutChangelogBoundary, orchestrationTaskSummary, planContextField, buildArtifactUpdateRequirements, buildPlanCompletionSweep, buildScopeBoundary, selectEvidenceTarget, taskByRef, } from "./planState.js";
+import { progressVerificationSummary } from "./progress.js";
+import { STATE_FAMILY_FALLBACK_COMMANDS, STATE_FAMILY_LIST_COMMANDS } from "./types.js";
+import { planLifecycleState } from "../planLifecycleState.js";
+import { discoverProjectVerification } from "./projectVerification.js";
+const TRANSIENT_BUILD_INPUT_COMMAND = "agentera prime --context build --input <file|-> --format json";
+const TRANSIENT_BUILD_STDIN_COMMAND = "agentera prime --context build --input - --format json";
+function transientSourceProvenance(request, field) {
+    return {
+        source_family: "transient_build_execution_request",
+        command: TRANSIENT_BUILD_INPUT_COMMAND,
+        field,
+        schema_version: request.schema_version,
+        source_kind: request.source.kind,
+        persisted: false,
+    };
+}
+export function buildExecutionContext(capability, schemas, plan, progress, health, todoItems, docs, profile, bundle, projectRoot, buildRequest = null) {
+    if (capability !== "build")
+        return null;
+    const capabilityContract = capabilityContext(capability) ?? {};
+    const lifecycle = planLifecycleState(plan);
+    const tasks = lifecycle.current_plan_degraded === true
+        ? []
+        : asList(plan.tasks).filter((t) => t && typeof t === "object" && !Array.isArray(t));
+    const target = selectEvidenceTarget(plan);
+    const selected = taskByRef(plan, (target && typeof target === "object" ? target.task : null));
+    const acceptance = buildRequest?.acceptance
+        ?? (selected && typeof selected === "object" ? asList(selected.acceptance) : []);
+    const progressVerification = progressVerificationSummary(progress);
+    const changelogBoundary = closeoutChangelogBoundary(projectRoot, plan);
+    const sweep = buildPlanCompletionSweep(plan);
+    const archiveOnly = Boolean(plan.exists) && plan.active === false;
+    let mode;
+    if (plan.active === true && plan.complete_plan)
+        mode = "completed_plan_sweep";
+    else if (buildRequest !== null && plan.active !== true)
+        mode = "no_plan";
+    else if (archiveOnly)
+        mode = "archive_only_history";
+    else if (!plan.exists || tasks.length === 0)
+        mode = "no_plan";
+    else if (target.status === "selected" && selected !== null)
+        mode = "plan_driven";
+    else
+        mode = "blocked_or_dependency_unready";
+    let stateCaveats = [];
+    let fallbackCommands = [];
+    for (const family of (capabilityContract.missing_state_families ?? [])) {
+        stateCaveats.push(`${family} state is not included in prime --context startup context.`);
+    }
+    fallbackCommands.push(...(capabilityContract.cli_fallback ?? []));
+    if (lifecycle.status === "degraded") {
+        stateCaveats.push(...(lifecycle.caveats ?? []));
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.plan);
+    }
+    if (mode === "blocked_or_dependency_unready") {
+        stateCaveats.push("No dependency-ready pending plan task is available in CLI plan state.");
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.plan);
+    }
+    if (mode === "plan_driven" && acceptance.length === 0) {
+        stateCaveats.push("Selected Build task has no acceptance criteria in CLI plan state.");
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.plan);
+    }
+    if (!progress.exists) {
+        stateCaveats.push("progress state is unavailable; progress logging context is incomplete.");
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.progress);
+    }
+    if (!health.exists) {
+        stateCaveats.push("health state is unavailable or incomplete.");
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.health);
+    }
+    if (!docs.exists) {
+        stateCaveats.push("docs mapping state is unavailable or incomplete.");
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.docs);
+    }
+    if (todoItems.length === 0) {
+        stateCaveats.push("todo state has no open entries in prime --context response; absence may mean none open or unavailable.");
+        fallbackCommands.push(STATE_FAMILY_FALLBACK_COMMANDS.todo);
+    }
+    if (changelogBoundary.status !== "available") {
+        stateCaveats.push(...(changelogBoundary.caveats ?? []));
+        fallbackCommands.push("agentera state query changelog --format json");
+    }
+    if (profile.status !== "valid") {
+        stateCaveats.push("profile-derived state is unavailable in prime --context response.");
+    }
+    else if (profile.stale === true) {
+        stateCaveats.push("profile-derived state is stale; this is a caveat, not approval to refresh profile state.");
+    }
+    if (bundle.status !== "up_to_date") {
+        stateCaveats.push("Agentera app files are not up to date; this is a caveat, not approval to repair or update app files.");
+    }
+    const scopeBoundary = buildRequest === null
+        ? buildScopeBoundary(plan, selected)
+        : {
+            artifact_families: ["progress", "todo", "docs", "health", "changelog", "decisions", "vision", "profile", "design"],
+            explicit_scope: buildRequest.scope,
+            source_scope: {
+                status: "unspecified",
+                explicit_paths: [],
+                policy: "The transient scope defines work intent only; no source-file allowlist or exclusion is inferred from its text.",
+            },
+            source_provenance: transientSourceProvenance(buildRequest, "scope"),
+        };
+    const sourceScope = scopeBoundary.source_scope && typeof scopeBoundary.source_scope === "object" && !Array.isArray(scopeBoundary.source_scope)
+        ? scopeBoundary.source_scope
+        : {};
+    if (sourceScope.status === "unspecified") {
+        stateCaveats.push("source-file scope is unspecified; no allowed or prohibited source paths were inferred.");
+    }
+    const noCurrentPlan = plan.active !== true && lifecycle.status !== "degraded";
+    if (noCurrentPlan) {
+        fallbackCommands = fallbackCommands.filter((command) => command !== STATE_FAMILY_FALLBACK_COMMANDS.plan);
+        if (buildRequest === null) {
+            stateCaveats.push("Explicit no-plan scope and acceptance are required before Build can execute without a current plan.");
+            fallbackCommands.push(TRANSIENT_BUILD_STDIN_COMMAND);
+        }
+    }
+    fallbackCommands = uniqueList(fallbackCommands);
+    stateCaveats = uniqueList(stateCaveats);
+    const requiredState = {
+        work_selection: mode === "plan_driven" || mode === "completed_plan_sweep" || buildRequest !== null,
+        acceptance_criteria: mode === "completed_plan_sweep" || acceptance.length > 0,
+        artifact_update_requirements: Boolean(docs.exists),
+        progress_logging_requirements: progressVerification.status === "available" || (progressVerification.caveats ?? []).length > 0,
+        changelog_boundary: changelogBoundary.status === "available",
+        scope_boundary: true,
+        safety_boundaries: true,
+        plan_state_healthy: lifecycle.status !== "degraded",
+    };
+    const missingRequired = Object.entries(requiredState).filter(([, present]) => !present).map(([name]) => name);
+    const caveated = stateCaveats.length > 0;
+    const complete = (mode === "plan_driven" || mode === "completed_plan_sweep" || buildRequest !== null)
+        && missingRequired.length === 0;
+    const workSelection = buildRequest === null
+        ? {
+            status: target.status,
+            selection_reason: target.selection_reason,
+            task: selected && typeof selected === "object" ? taskRef(selected) : null,
+            source_provenance: target.source_provenance,
+            caveats: target.caveats ?? [],
+        }
+        : {
+            status: "selected",
+            selection_reason: "explicit_no_plan_scope",
+            task: null,
+            scope: buildRequest.scope,
+            source_provenance: transientSourceProvenance(buildRequest, "scope"),
+            caveats: [],
+        };
+    const artifactUpdateRequirements = buildArtifactUpdateRequirements(plan, docs);
+    if (buildRequest !== null) {
+        artifactUpdateRequirements.required_families = ["progress", "todo", "changelog"];
+        artifactUpdateRequirements.plan_status_update_required = false;
+        artifactUpdateRequirements.policy = "Transient no-plan work does not create, mutate, or require plan state.";
+    }
+    return {
+        capability: "build",
+        mode,
+        work_selection: workSelection,
+        plan_task: selected && typeof selected === "object" ? orchestrationTaskSummary(selected) : null,
+        acceptance_criteria: {
+            status: acceptance.length > 0 ? "available" : "incomplete",
+            items: acceptance,
+            count: acceptance.length,
+            source_provenance: buildRequest === null
+                ? sourceProvenance("plan", STATE_FAMILY_FALLBACK_COMMANDS.plan, "entries.acceptance")
+                : transientSourceProvenance(buildRequest, "acceptance"),
+        },
+        constraints: {
+            plan_constraints_present: buildRequest === null && hasRecordedValue(planContextField(plan, "constraints")),
+            plan_constraints_summary: buildRequest === null
+                ? "Plan constraints are represented here as structured safety and fallback policy; run the plan CLI fallback only if full wording is needed."
+                : "Transient no-plan input supplies scope and acceptance only; no plan constraints are inferred.",
+            protected_actions: [
+                "no profile refresh",
+                "no installed app refresh",
+                "no vision edit",
+                "no objective-state edit",
+                "no dispatch without explicit cycle execution",
+                "no commit/push/tag/publication without explicit approval",
+            ],
+            unsupported_cli_command_policy: "Do not introduce capability-name or slash-alias CLI commands for Build.",
+            source_provenance: buildRequest === null
+                ? sourceProvenance("plan", STATE_FAMILY_FALLBACK_COMMANDS.plan, "summary.constraints")
+                : transientSourceProvenance(buildRequest, "scope"),
+        },
+        scope_boundary: scopeBoundary,
+        verification_expectations: {
+            latest_progress_verification: progressVerification,
+            ...discoverProjectVerification(projectRoot),
+        },
+        artifact_update_requirements: artifactUpdateRequirements,
+        progress_logging_requirements: {
+            append_cycle: buildRequest !== null || !archiveOnly,
+            verified_field_mandatory: true,
+            latest_progress_verification_pointer: progressVerification.latest_progress_verification_pointer ?? null,
+            source_provenance: sourceProvenance("progress", STATE_FAMILY_LIST_COMMANDS.progress),
+        },
+        changelog_boundary: changelogBoundary,
+        git_boundary: {
+            remote_push_allowed: false,
+            commit_allowed_only_with_explicit_user_request: true,
+            tag_or_publication_allowed: false,
+            source_provenance: sourceProvenance("execution_context", "agentera prime --context build --format json", "git_boundary"),
+        },
+        plan_completion_sweep: sweep,
+        plan_lifecycle_state: lifecycle,
+        state_family_caveats: stateCaveats,
+        fallback_commands: fallbackCommands,
+        source_contract: {
+            complete_for_execution_context: complete,
+            caveated,
+            raw_artifact_reads_required: false,
+            raw_artifact_read_policy: "Use this execution_context and included status state first. Run listed routine/query CLI fallback commands " +
+                "for missing or incomplete execution state; raw artifact reads are last-resort diagnostics, not normal Build startup behavior.",
+            included_state_families: capabilityContract.included_state_families ?? [],
+            missing_state_families: capabilityContract.missing_state_families ?? [],
+            required_execution_state: requiredState,
+            missing_required_execution_state: missingRequired,
+            fallback_commands: fallbackCommands,
+            caveats: stateCaveats,
+            owns: [
+                "selected work item",
+                "task details and acceptance criteria",
+                "constraints and safety boundaries",
+                "verification expectations",
+                "artifact update requirements",
+                "progress logging requirements",
+                "changelog boundary",
+                "scope boundary",
+                "read-only plan completion sweep metadata",
+                "truthful completeness metadata",
+                "plan lifecycle state",
+            ],
+            deferred: [],
+        },
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/cli/capabilityContext/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/capabilityContext/build.ts"],"names":[],"mappings":"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"}

package/dist/cli/capabilityContext/closeout.js

@@ -0,0 +1,235 @@
+import fs from "node:fs";
+import { execFileSync } from "node:child_process";
+import { artifactPath } from "../appContext.js";
+import { asList } from "../stateQuery.js";
+import { capabilityContext } from "./contract.js";
+import { docsConventions, sourceProvenance, uniqueList } from "./shared.js";
+import { closeoutChangelogBoundary } from "./planState.js";
+import { progressVerificationSummary } from "./progress.js";
+import { decisionReviewPressure } from "./evidence.js";
+import { STATE_FAMILY_FALLBACK_COMMANDS } from "./types.js";
+export function closeoutArtifactMappings(docs) {
+    const mapping = asList(docs.mapping);
+    const ok = Boolean(docs.exists) && mapping.length > 0;
+    return {
+        status: ok ? "available" : "unavailable",
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.mapping"),
+        entries: mapping,
+        mapping_entries: mapping.length,
+        caveats: ok ? [] : ["Docs artifact mappings are unavailable or empty in CLI docs state."],
+    };
+}
+export function closeoutVersionPolicy(docs) {
+    const conventions = docsConventions(docs);
+    const semverPolicy = conventions.semver_policy && typeof conventions.semver_policy === "object" && !Array.isArray(conventions.semver_policy) ? conventions.semver_policy : {};
+    const versionFiles = asList(conventions.version_files);
+    const registry = conventions.version_files_registry ?? null;
+    const available = Object.keys(semverPolicy).length > 0;
+    return {
+        status: available ? "available" : "unavailable",
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.conventions"),
+        version_files: versionFiles,
+        version_files_registry: registry,
+        semver_policy: semverPolicy,
+        caveats: available ? [] : ["Docs version policy is unavailable in CLI docs state."],
+    };
+}
+export function closeoutTodoBlockers(schemas, todoItems, selectedTargetVersion = null) {
+    const info = schemas.todo ?? { path: "TODO.md", record: undefined, schema: {}, fields: {} };
+    const exists = fs.existsSync(artifactPath(info, "todo"));
+    const blockers = selectedTargetVersion === null
+        ? []
+        : todoItems.filter((item) => item.status === "open" && item.release_blocker === true && item.target_version === selectedTargetVersion);
+    return {
+        status: exists ? "available" : "unavailable",
+        source_provenance: sourceProvenance("todo", STATE_FAMILY_FALLBACK_COMMANDS.todo),
+        selected_target_version: selectedTargetVersion,
+        open_count: blockers.length,
+        items: blockers,
+        caveats: exists ? [] : ["TODO state is unavailable in CLI state."],
+    };
+}
+export function closeoutBenchmarkEvidence(docs) {
+    const coverage = docs.coverage && typeof docs.coverage === "object" && !Array.isArray(docs.coverage) ? docs.coverage : {};
+    const testsSummary = String(coverage.tests ?? "").trim();
+    if (testsSummary && testsSummary.toLowerCase().includes("benchmark")) {
+        return {
+            status: "available",
+            source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.coverage.tests"),
+            summary_present: true,
+            non_empty_evidence_present: true,
+            history_scope: "cli_visible_summary",
+            user_local_benchmark_reads_required: false,
+            summary: testsSummary,
+            caveats: [],
+        };
+    }
+    return {
+        status: "unavailable",
+        source_provenance: sourceProvenance("docs", STATE_FAMILY_FALLBACK_COMMANDS.docs, "summary.coverage.tests"),
+        summary_present: false,
+        non_empty_evidence_present: false,
+        history_scope: "not_exposed_by_supported_cli_state",
+        user_local_benchmark_reads_required: false,
+        summary: null,
+        caveats: ["Supported CLI/state summaries do not expose benchmark evidence; do not read user-local benchmark files for normal closeout."],
+    };
+}
+export function localGitTagEvidence(targetVersion) {
+    const tag = targetVersion ? `v${targetVersion}` : null;
+    const source = { source_family: "local_git", command: "git tag --list <target-tag>", remote: false };
+    if (!tag) {
+        return { status: "unavailable", tag: null, source_provenance: source, object_type: null, caveats: ["No selected target version is available for local tag evidence."] };
+    }
+    let stdout;
+    try {
+        stdout = execFileSync("git", ["tag", "--list", tag], { cwd: process.cwd(), encoding: "utf8", timeout: 2000 });
+    }
+    catch (exc) {
+        const e = exc;
+        if (typeof e.status === "number" && e.status !== 0) {
+            return { status: "unavailable", tag, source_provenance: source, object_type: null, caveats: ["Local git tag evidence is unavailable because this project is not a git worktree."] };
+        }
+        return { status: "unavailable", tag, source_provenance: source, object_type: null, caveats: [`Local git tag evidence is unavailable: ${exc.message}`] };
+    }
+    if (!stdout.split(/\r\n|\r|\n/).includes(tag)) {
+        return { status: "absent", tag, source_provenance: source, object_type: null, caveats: [`Local tag ${tag} is not present.`] };
+    }
+    let objectType = null;
+    try {
+        const out = execFileSync("git", ["cat-file", "-t", tag], { cwd: process.cwd(), encoding: "utf8", timeout: 2000 });
+        objectType = out.trim() || null;
+    }
+    catch {
+        objectType = null;
+    }
+    return {
+        status: "available",
+        tag,
+        source_provenance: source,
+        object_type: objectType,
+        caveats: objectType ? [] : [`Local tag ${tag} exists but object type could not be verified.`],
+    };
+}
+export function closeoutReleaseBoundary(changelogBoundary, bundle) {
+    const targetVersion = changelogBoundary.selected_target_version;
+    const localTag = localGitTagEvidence(targetVersion ? String(targetVersion) : null);
+    const metadataRecorded = Boolean(changelogBoundary.selected_target_recorded);
+    const caveats = [...(changelogBoundary.caveats ?? []), ...(localTag.caveats ?? [])];
+    if (!metadataRecorded && localTag.status !== "available") {
+        caveats.push("No local closeout metadata or local tag evidence is recorded for the selected target.");
+    }
+    return {
+        status: changelogBoundary.boundary_present ? "available" : "incomplete",
+        selected_target_version: targetVersion ?? null,
+        boundary: changelogBoundary.boundary ?? null,
+        local_metadata_evidence: {
+            status: metadataRecorded ? "recorded" : "not_recorded",
+            source_provenance: changelogBoundary.source_provenance ?? null,
+            field: "changelog_boundary.selected_target_recorded",
+        },
+        local_tag_evidence: localTag,
+        publication_evidence: {
+            package_publication: "not_recorded_in_cli_state",
+            remote_push: "not_recorded_in_cli_state",
+            remote_checks_performed: false,
+            registry_checks_performed: false,
+            source_provenance: sourceProvenance("closeout_context", "agentera prime --context document --format json", "release_boundary.publication_evidence"),
+            caveats: ["Closeout context does not contact remotes or package registries."],
+        },
+        app_refresh_evidence: {
+            installed_app_status: bundle.status ?? null,
+            refresh: "not_recorded_in_cli_state",
+            approval_recorded: false,
+            source_provenance: sourceProvenance("status", "agentera prime --format json", "app.status"),
+        },
+        caveats,
+    };
+}
+export function documentCloseoutContext(capability, schemas, plan, progress, todoItems, docs, profile, bundle, decisionHistory, projectRoot) {
+    if (capability !== "document")
+        return null;
+    const capabilityContract = capabilityContext(capability) ?? {};
+    const artifactMappings = closeoutArtifactMappings(docs);
+    const versionPolicy = closeoutVersionPolicy(docs);
+    const changelogBoundary = closeoutChangelogBoundary(projectRoot, plan);
+    const todoBlockers = closeoutTodoBlockers(schemas, todoItems, typeof changelogBoundary.selected_target_version === "string" ? changelogBoundary.selected_target_version : null);
+    const progressEvidence = progressVerificationSummary(progress);
+    const benchmarkEvidence = closeoutBenchmarkEvidence(docs);
+    const releaseBoundary = closeoutReleaseBoundary(changelogBoundary, bundle);
+    const reviewPressure = decisionReviewPressure(decisionHistory);
+    const requiredState = {
+        artifact_mappings: artifactMappings.status === "available",
+        version_policy: versionPolicy.status === "available",
+        todo_blockers: todoBlockers.status === "available",
+        changelog_boundary: Boolean(changelogBoundary.boundary_present),
+        progress_evidence: progressEvidence.status === "available",
+        benchmark_evidence_or_caveat: benchmarkEvidence.status === "available" || (benchmarkEvidence.caveats ?? []).length > 0,
+        decision_review_pressure: reviewPressure.status === "available",
+    };
+    const missingRequired = Object.entries(requiredState).filter(([, present]) => !present).map(([k]) => k);
+    let stateCaveats = [];
+    for (const family of (capabilityContract.missing_state_families ?? [])) {
+        stateCaveats.push(`${family} state is not included in prime --context startup context.`);
+    }
+    for (const component of [artifactMappings, versionPolicy, todoBlockers, changelogBoundary, releaseBoundary, progressEvidence, benchmarkEvidence, reviewPressure]) {
+        stateCaveats.push(...(component.caveats ?? []));
+    }
+    if (bundle.status !== "up_to_date")
+        stateCaveats.push("Agentera app files are not up to date; this is a caveat, not approval to repair or update app files.");
+    if (profile.status !== "valid")
+        stateCaveats.push("profile-derived state is unavailable in prime --context response.");
+    else if (profile.stale === true)
+        stateCaveats.push("profile-derived state is stale; this is a caveat, not approval to refresh profile state.");
+    stateCaveats = uniqueList(stateCaveats);
+    const fallbackCommands = uniqueList([
+        STATE_FAMILY_FALLBACK_COMMANDS.todo,
+        STATE_FAMILY_FALLBACK_COMMANDS.docs,
+        STATE_FAMILY_FALLBACK_COMMANDS.progress,
+        "agentera state query changelog --format json",
+        "agentera state query --list-artifacts --format json",
+        ...(capabilityContract.cli_fallback ?? []),
+    ]);
+    return {
+        capability: "document",
+        artifact_mappings: artifactMappings,
+        version_policy: versionPolicy,
+        todo_blockers: todoBlockers,
+        changelog_boundary: changelogBoundary,
+        release_boundary: releaseBoundary,
+        progress_evidence: progressEvidence,
+        benchmark_evidence: benchmarkEvidence,
+        decision_review_pressure: reviewPressure,
+        state_family_caveats: stateCaveats,
+        fallback_commands: fallbackCommands,
+        source_contract: {
+            complete_for_closeout_context: missingRequired.length === 0,
+            caveated: stateCaveats.length > 0,
+            raw_artifact_reads_required: false,
+            raw_artifact_read_policy: "Use this closeout_context and included status state first. Run listed routine/query CLI fallback commands " +
+                "for missing or incomplete closeout state; raw artifact reads are last-resort diagnostics, not normal closeout behavior.",
+            included_state_families: capabilityContract.included_state_families ?? [],
+            missing_state_families: capabilityContract.missing_state_families ?? [],
+            closeout_state_families: ["docs", "todo", "changelog", "progress", "benchmark_evidence", "decisions"],
+            required_closeout_state: requiredState,
+            missing_required_closeout_state: missingRequired,
+            fallback_commands: fallbackCommands,
+            caveats: stateCaveats,
+            owns: [
+                "artifact mappings",
+                "version policy",
+                "TODO blockers",
+                "changelog or no-release boundary",
+                "local metadata/tag versus publication boundary",
+                "latest progress evidence",
+                "benchmark evidence pointer or unavailable caveat",
+                "protected decision review pressure",
+                "provenance pointers and non-empty evidence flags",
+                "fallback commands",
+                "raw-read policy",
+                "truthful completeness flag",
+            ],
+        },
+    };
+}
+//# sourceMappingURL=closeout.js.map

package/dist/cli/capabilityContext/closeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closeout.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/capabilityContext/closeout.ts"],"names":[],"mappings":"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"}