agentera 3.0.0-dev.5 → 3.0.0-dev.6

package/dist/cli/capabilityContext/closeout.js

@@ -0,0 +1,230 @@
+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";
+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", "agentera docs --format json", "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", "agentera docs --format json", "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) {
+    const info = schemas.todo ?? { path: "TODO.md", record: undefined, schema: {}, fields: {} };
+    const exists = fs.existsSync(artifactPath(info, "todo"));
+    return {
+        status: exists ? "available" : "unavailable",
+        source_provenance: sourceProvenance("todo", "agentera todo --format json"),
+        open_count: todoItems.length,
+        items: todoItems,
+        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", "agentera docs --format json", "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", "agentera docs --format json", "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 dokumentera --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("hej", "agentera hej --format json", "bundle.status"),
+        },
+        caveats,
+    };
+}
+export function dokumenteraCloseoutContext(capability, schemas, plan, progress, todoItems, docs, profile, bundle) {
+    if (capability !== "dokumentera")
+        return null;
+    const capabilityContract = capabilityContext(capability) ?? {};
+    const artifactMappings = closeoutArtifactMappings(docs);
+    const versionPolicy = closeoutVersionPolicy(docs);
+    const todoBlockers = closeoutTodoBlockers(schemas, todoItems);
+    const changelogBoundary = closeoutChangelogBoundary(schemas, plan);
+    const progressEvidence = progressVerificationSummary(progress);
+    const benchmarkEvidence = closeoutBenchmarkEvidence(docs);
+    const releaseBoundary = closeoutReleaseBoundary(changelogBoundary, bundle);
+    const reviewPressure = decisionReviewPressure(schemas);
+    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 !== "review_required",
+    };
+    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 !== "loaded")
+        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([
+        "agentera todo --format json",
+        "agentera docs --format json",
+        "agentera progress --format json",
+        "agentera query changelog --format json",
+        "agentera query --list-artifacts --format json",
+        ...(capabilityContract.cli_fallback ?? []),
+    ]);
+    return {
+        capability: "dokumentera",
+        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 hej 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":["../../../src/cli/capabilityContext/closeout.ts"],"names":[],"mappings":"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"}

package/dist/cli/capabilityContext/contract.js

@@ -0,0 +1,186 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadYamlMapping } from "../../core/yaml.js";
+import { activeAppModel, discoverSchemasDir } from "../appContext.js";
+import { capabilityStartupCommand } from "../../capabilities/index.js";
+import { PLANERA_COMPLETED_PLAN_ARCHIVE_CONFIRMATION, PLANERA_INSTRUCTIONS_AUTHORITY_EXCEPTIONS, PLANERA_PLANNING_LEVELS, PLANERA_RAW_PLAN_ACCESS_ALLOWED_FOR, PLANERA_STARTUP_CONTRACT_VERSION, PLANERA_STEP_VERBS, STARTUP_ENVELOPE_STATE_FAMILIES, STATE_FAMILY_FALLBACK_COMMANDS, } from "./types.js";
+import { CAPABILITY_INSTRUCTIONS, capabilityInstructionModulePath } from "../../capabilities/index.js";
+import { isFile, pyRepr, appendUnique } from "./shared.js";
+export function capabilityInstructionContractPath() {
+    const model = activeAppModel();
+    const active = path.join(String(model.authoritativeRoot ?? model.activeBundleRoot), "references", "cli", "capability-instruction-contract.yaml");
+    if (isFile(active))
+        return active;
+    return path.join(path.resolve(discoverSchemasDir(), "..", "..", "..", ".."), "references", "cli", "capability-instruction-contract.yaml");
+}
+export function capabilityInstructionContract() {
+    const p = capabilityInstructionContractPath();
+    if (!isFile(p))
+        return {};
+    try {
+        return loadYamlMapping(fs.readFileSync(p, "utf8"));
+    }
+    catch (exc) {
+        process.stderr.write(`warning: failed to load capability instruction contract: ${exc.message}\n`);
+        return {};
+    }
+}
+export function capabilityInstructionTarget(capability) {
+    const module = capabilityInstructionModulePath(capability);
+    const prose = CAPABILITY_INSTRUCTIONS[capability] ?? null;
+    return {
+        module,
+        exists: prose !== null && prose.length > 0,
+        runtime_path: module,
+        prose_present: prose !== null,
+        prose_length: prose === null ? 0 : prose.length,
+    };
+}
+export function firstInvocationReadMetadata(capability) {
+    const authority = capabilityInstructionContract();
+    const firstRead = authority.first_invocation_read && typeof authority.first_invocation_read === "object" ? authority.first_invocation_read : {};
+    const allowedValues = firstRead.allowed_values && typeof firstRead.allowed_values === "object" ? firstRead.allowed_values : {};
+    const value = "prime_context";
+    const valueContract = (allowedValues[value] ?? {});
+    return {
+        field: "first_invocation_read",
+        value,
+        allowed_values: Object.keys(allowedValues),
+        default_rule: firstRead.default_rule ?? firstRead.default_future_rule ?? null,
+        module_target: capabilityInstructionTarget(capability),
+        startup_command: capabilityStartupCommand(capability),
+        obligation_summary: valueContract.obligation ?? `shell out to ${capabilityStartupCommand(capability)}`,
+        meaning: valueContract.meaning ?? null,
+        runtime_enforcement: true,
+        provenance: {
+            authority_path: "references/cli/capability-instruction-contract.yaml",
+            authority_status: authority.status ?? null,
+            decision: authority.decision ?? null,
+            source_field: "first_invocation_read.allowed_values",
+        },
+    };
+}
+export function planeraStartupContract() {
+    return {
+        schemaVersion: PLANERA_STARTUP_CONTRACT_VERSION,
+        status: "implemented_compact_normal_startup_contract",
+        canonical_surface: "agentera prime --context planera --format json",
+        bounded: true,
+        instructions_runtime_read_required: false,
+        instructions_authority: {
+            normal_startup: "Use this compact context for normal Planera execution startup; " +
+                "shell out to `agentera prime --context planera --format json` for the full Planera prose.",
+            read_planera_instructions_when: PLANERA_INSTRUCTIONS_AUTHORITY_EXCEPTIONS,
+        },
+        planning: {
+            levels: PLANERA_PLANNING_LEVELS,
+            step_marker_format: "── step N/6: verb",
+            required_steps: PLANERA_STEP_VERBS,
+            full_plan_review_required: true,
+            pre_write_self_audit_required: true,
+            max_full_plan_tasks: 8,
+        },
+        cli_first_orientation: {
+            use_startup_state_first: true,
+            current_plan_command: "agentera plan --format json",
+            complete_plan_contract_key: "source_contract.complete_for_plan_artifact",
+            fallback_policy: "Use CLI-provided fallback commands for missing or incomplete state families " +
+                "before any last-resort raw artifact read.",
+        },
+        artifact_access_boundaries: {
+            skip_raw_plan_artifact_when: "`agentera plan --format json` reports source_contract.complete_for_plan_artifact=true " +
+                "during normal read-only startup or evaluation.",
+            raw_plan_artifact_allowed_for: PLANERA_RAW_PLAN_ACCESS_ALLOWED_FOR,
+            completed_plan_archive_confirmation: PLANERA_COMPLETED_PLAN_ARCHIVE_CONFIRMATION,
+            artifact_mapping_source: "agentera docs/query artifact mapping before writes or closeout",
+        },
+        handoff_expectations: [
+            "skip level suggests ⧉ realisera and waits for confirmation unless the user already asked to implement now",
+            "single-task plans suggest ⧉ realisera and wait for confirmation",
+            "full plans suggest ⎈ orkestrera and wait for confirmation",
+        ],
+        unsupported_command_boundary: {
+            capability_cli_commands_added: true,
+            forbidden_examples: [],
+            route_boundary: "Use `/agentera plan` for routing, `agentera plan` for plan state, " +
+                "and `agentera planera` for capability routing guidance only.",
+        },
+        seam_decision: {
+            selected: "prime --context",
+            not_changed: [
+                { surface: "agentera schema --format json", reason: "runtime/schema command discovery, not capability workflow startup context" },
+                { surface: "dispatcher guidance", reason: "route and CLI-state separation guidance, not a bounded Planera workflow payload" },
+            ],
+        },
+    };
+}
+export function capabilityArtifactInventory(capability) {
+    const inventory = { read_needs: [], write_targets: [] };
+    const capabilityDir = path.join(String(activeAppModel().skillRoot), "capabilities", capability);
+    const p = path.join(capabilityDir, "schemas", "artifacts.yaml");
+    if (!isFile(p))
+        return [inventory, `No capability artifact schema found for ${capability}.`];
+    let data;
+    try {
+        data = loadYamlMapping(fs.readFileSync(p, "utf8"));
+    }
+    catch (exc) {
+        return [inventory, `Capability artifact schema for ${capability} could not be read: ${exc.message}`];
+    }
+    const artifacts = data.ARTIFACTS;
+    if (!artifacts || typeof artifacts !== "object" || Array.isArray(artifacts)) {
+        return [inventory, `Capability artifact schema for ${capability} has no ARTIFACTS mapping.`];
+    }
+    const errors = [];
+    for (const [key, entry] of Object.entries(artifacts)) {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            errors.push(`entry ${key} is not a mapping`);
+            continue;
+        }
+        const e = entry;
+        const artifactId = String(e.artifact_id ?? "").trim();
+        const localRole = String(e.local_role ?? "").trim();
+        if (!artifactId) {
+            errors.push(`entry ${key} is missing artifact_id`);
+            continue;
+        }
+        if (localRole === "consumes")
+            appendUnique(inventory.read_needs, artifactId);
+        else if (localRole === "produces")
+            appendUnique(inventory.write_targets, artifactId);
+        else if (localRole === "produces_and_consumes") {
+            appendUnique(inventory.read_needs, artifactId);
+            appendUnique(inventory.write_targets, artifactId);
+        }
+        else
+            errors.push(`entry ${key} has unsupported local_role ${pyRepr(localRole)}`);
+    }
+    const error = errors.length > 0 ? `Capability artifact schema for ${capability} has invalid ARTIFACTS entries: ${errors.join("; ")}.` : null;
+    return [inventory, error];
+}
+export function capabilityContext(capability) {
+    if (!capability)
+        return null;
+    const [inventory, error] = capabilityArtifactInventory(capability);
+    const needs = inventory.read_needs;
+    const writeTargets = inventory.write_targets;
+    const missing = needs.filter((name) => !STARTUP_ENVELOPE_STATE_FAMILIES.has(name));
+    const cliFallback = missing.filter((name) => name in STATE_FAMILY_FALLBACK_COMMANDS).map((name) => STATE_FAMILY_FALLBACK_COMMANDS[name]);
+    const context = {
+        capability,
+        first_invocation_read: firstInvocationReadMetadata(capability),
+        declared_state_needs: needs,
+        declared_write_targets: writeTargets,
+        artifact_inventory: inventory,
+        included_state_families: needs.filter((name) => STARTUP_ENVELOPE_STATE_FAMILIES.has(name)),
+        missing_state_families: missing,
+        cli_fallback: cliFallback,
+        raw_artifact_read_policy: "Use the included state families from this prime --context response first. " +
+            "If needed families are missing or CLI state is incomplete, run the CLI fallback commands before raw file access.",
+        schema_error: error,
+    };
+    if (capability === "planera")
+        context.startup_contract = planeraStartupContract();
+    return context;
+}
+//# sourceMappingURL=contract.js.map

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

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