agentera 3.0.0-dev.2 → 3.0.0-dev.21

package/dist/cli/capabilityContext/planState.js

@@ -0,0 +1,279 @@
+import fs from "node:fs";
+import { asList } from "../stateQuery.js";
+import { artifactPath } from "../appContext.js";
+import { sourceMetadata } from "../stateQuery.js";
+import { entryStatus, sourceProvenance, taskRef, hasRecordedValue, } from "./shared.js";
+export function orchestrationTaskSummary(task) {
+    const evidence = task.evidence;
+    const evidenceItems = Array.isArray(evidence) ? evidence : evidence === null || evidence === undefined || evidence === "" ? [] : [evidence];
+    return {
+        ...taskRef(task),
+        depends_on: planDependsOnList(task),
+        acceptance_summary: { count: asList(task.acceptance).length, items: asList(task.acceptance) },
+        evidence_summary: { count: evidenceItems.length, items: evidenceItems },
+        evaluation_state: task.evaluation ?? null,
+    };
+}
+/** Coerce plan task numbers and depends_on refs to comparable lookup keys (int/string/object forms). */
+export function planTaskRefKeys(value) {
+    if (value === null || value === undefined)
+        return [];
+    if (typeof value === "object" && !Array.isArray(value)) {
+        const entry = value;
+        const nested = entry.number ?? entry.task_number ?? entry.id;
+        return nested === null || nested === undefined ? [] : planTaskRefKeys(nested);
+    }
+    const text = String(value).trim();
+    if (!text)
+        return [];
+    const keys = new Set([text]);
+    const numeric = Number(text);
+    if (Number.isFinite(numeric) && Number.isInteger(numeric))
+        keys.add(String(numeric));
+    return [...keys];
+}
+export function formatPlanTaskDepRef(dep) {
+    const keys = planTaskRefKeys(dep);
+    return keys.length > 0 ? keys[0] : String(dep);
+}
+export function planDependsOnList(task) {
+    const raw = task.depends_on;
+    if (Array.isArray(raw))
+        return raw;
+    if (raw === null || raw === undefined || raw === "")
+        return [];
+    return [raw];
+}
+export function indexPlanTasksByNumber(tasks) {
+    const taskByNumber = {};
+    for (const task of tasks) {
+        if (task.number === null || task.number === undefined)
+            continue;
+        for (const key of planTaskRefKeys(task.number))
+            taskByNumber[key] = task;
+    }
+    return taskByNumber;
+}
+export function resolvePlanTaskByRef(taskByNumber, dep) {
+    for (const key of planTaskRefKeys(dep)) {
+        const hit = taskByNumber[key];
+        if (hit !== undefined)
+            return hit;
+    }
+    return undefined;
+}
+export const DONE_STATUSES_ORCH = new Set(["complete", "completed", "closed", "done", "resolved", "retired"]);
+export const BLOCKED_STATUSES_ORCH = new Set(["blocked", "stuck"]);
+export const TARGET_VERSION_RE = /\b\d+\.\d+\.\d+\b/;
+export function dependencyReadyTasks(tasks) {
+    const taskByNumber = indexPlanTasksByNumber(tasks);
+    const ready = [];
+    for (const task of tasks) {
+        const status = entryStatus(task, "pending");
+        if (status !== "pending")
+            continue;
+        let blocked = false;
+        for (const dep of planDependsOnList(task)) {
+            const dependency = resolvePlanTaskByRef(taskByNumber, dep);
+            if (dependency === undefined || !DONE_STATUSES_ORCH.has(entryStatus(dependency, "pending"))) {
+                blocked = true;
+                break;
+            }
+        }
+        if (!blocked)
+            ready.push(task);
+    }
+    return ready;
+}
+export function selectEvidenceTarget(plan) {
+    const tasks = asList(plan.tasks).filter((t) => t && typeof t === "object" && !Array.isArray(t));
+    const noTarget = {
+        status: "no_target",
+        target_type: "repository",
+        task: null,
+        selection_reason: "no_plan_task_target",
+        source_provenance: sourceProvenance("plan", "agentera plan --format json", "entries"),
+        caveats: ["No plan task target was selected; evaluate repository-level evidence only."],
+    };
+    if (!plan.exists || tasks.length === 0)
+        return noTarget;
+    const inProgress = tasks.find((task) => entryStatus(task, "pending") === "in_progress");
+    if (inProgress) {
+        return {
+            status: "selected",
+            target_type: "plan_task",
+            task: taskRef(inProgress),
+            selection_reason: "in_progress_task",
+            source_provenance: sourceProvenance("plan", "agentera plan --format json", "entries.status"),
+            caveats: [],
+        };
+    }
+    const ready = dependencyReadyTasks(tasks);
+    if (ready.length > 0) {
+        return {
+            status: "selected",
+            target_type: "plan_task",
+            task: taskRef(ready[0]),
+            selection_reason: "first_dependency_ready_pending_task",
+            source_provenance: sourceProvenance("plan", "agentera plan --format json", "entries.depends_on"),
+            caveats: [],
+        };
+    }
+    const completedWithEvidence = [...tasks].reverse().find((task) => DONE_STATUSES_ORCH.has(entryStatus(task, "pending")) && hasRecordedValue(task.evidence));
+    if (completedWithEvidence) {
+        return {
+            status: "selected",
+            target_type: "plan_task",
+            task: taskRef(completedWithEvidence),
+            selection_reason: "latest_completed_task_with_evidence",
+            source_provenance: sourceProvenance("plan", "agentera plan --format json", "entries.evidence"),
+            caveats: [],
+        };
+    }
+    return noTarget;
+}
+export function taskByRef(plan, ref) {
+    if (!ref)
+        return null;
+    for (const task of asList(plan.tasks)) {
+        if (task && typeof task === "object" && !Array.isArray(task) && task.number === ref.number)
+            return task;
+    }
+    return null;
+}
+export function planContextField(plan, field) {
+    const summary = plan.summary && typeof plan.summary === "object" && !Array.isArray(plan.summary) ? plan.summary : {};
+    return field in summary ? summary[field] : plan[field];
+}
+export function buildScopeBoundary(plan, selected) {
+    const explicitPaths = [];
+    const scopeField = planContextField(plan, "scope");
+    const sources = [selected ?? {}, scopeField && typeof scopeField === "object" ? scopeField : {}];
+    for (const source of sources) {
+        if (!source || typeof source !== "object" || Array.isArray(source))
+            continue;
+        for (const key of ["source_files", "files", "paths"]) {
+            for (const value of asList(source[key])) {
+                const text = String(value).trim();
+                if (text && !explicitPaths.includes(text))
+                    explicitPaths.push(text);
+            }
+        }
+    }
+    return {
+        artifact_families: ["plan", "progress", "todo", "docs", "health", "changelog", "decisions", "vision", "profile", "design"],
+        source_scope: {
+            status: explicitPaths.length > 0 ? "explicit" : "unspecified",
+            explicit_paths: explicitPaths,
+            policy: "Do not infer source-file allowlists or exclusions from task text; use only explicit plan/source-contract paths.",
+        },
+    };
+}
+export function buildArtifactUpdateRequirements(plan, docs) {
+    const mapping = asList(docs.mapping);
+    const mapped = mapping.filter((e) => e && typeof e === "object" && e.artifact).map((e) => e.artifact);
+    const archiveOnly = Boolean(plan.exists) && plan.active === false;
+    return {
+        required_families: archiveOnly ? [] : ["plan", "progress", "todo", "changelog"],
+        protected_families: ["vision", "objective", "profile", "installed_app"],
+        docs_mapping_available: Boolean(docs.exists && mapping.length > 0),
+        mapped_artifacts: mapped,
+        plan_status_update_required: plan.active === true,
+        policy: archiveOnly
+            ? "Archived plan history is non-executable and requires no execution artifact updates."
+            : "Update execution artifacts during the cycle; do not mutate protected state without explicit approval.",
+        source_provenance: sourceProvenance("docs", "agentera docs --format json", "summary.mapping"),
+    };
+}
+export function buildPlanCompletionSweep(plan) {
+    const complete = plan.active === true && Boolean(plan.complete_plan);
+    return {
+        status: complete ? "eligible" : "not_eligible",
+        mutation_allowed: false,
+        required_updates: complete ? ["progress aggregate cycle", "changelog plan-level entries", "TODO milestone advance", "health cross-reference"] : [],
+        archive_candidate: complete ? "active plan archive path is generated only during Build sweep execution" : null,
+        caveats: complete
+            ? []
+            : plan.active === false && plan.exists
+                ? ["Archived plan history is non-executable and cannot trigger a completion sweep."]
+                : ["Plan completion sweep is not eligible until every plan task is complete."],
+        source_provenance: sourceProvenance("plan", "agentera plan --format json", "summary.status"),
+    };
+}
+export function selectedTargetVersion(plan) {
+    const textParts = [String(plan.title ?? "")];
+    const firstPending = plan.first_pending;
+    if (firstPending && typeof firstPending === "object" && !Array.isArray(firstPending)) {
+        for (const key of ["name", "title"])
+            textParts.push(String(firstPending[key] ?? ""));
+    }
+    for (const task of asList(plan.tasks)) {
+        if (task && typeof task === "object" && !Array.isArray(task)) {
+            for (const key of ["name", "title"])
+                textParts.push(String(task[key] ?? ""));
+        }
+    }
+    const match = TARGET_VERSION_RE.exec(textParts.join("\n"));
+    return match ? match[0] : null;
+}
+export function changelogRecordsTarget(text, targetVersion) {
+    if (!targetVersion)
+        return false;
+    const escaped = targetVersion.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const re = new RegExp(`(?<![\\d.])${escaped}(?![\\d.+-])`);
+    return text.split(/\r\n|\r|\n/).some((line) => re.test(line));
+}
+export function closeoutChangelogBoundary(schemas, plan) {
+    const info = schemas.changelog ?? { path: "CHANGELOG.md", record: undefined, schema: {}, fields: {} };
+    const p = artifactPath(info, "changelog");
+    const source = sourceMetadata("changelog", p);
+    const targetVersion = selectedTargetVersion(plan);
+    const unavailable = (caveat) => ({
+        status: "unavailable",
+        source,
+        source_provenance: sourceProvenance("changelog", "agentera query changelog --format json"),
+        selected_target_version: targetVersion,
+        selected_target_recorded: false,
+        unreleased_present: false,
+        latest_release_heading: null,
+        boundary_present: false,
+        boundary: null,
+        caveats: [caveat],
+    });
+    if (!fs.existsSync(p))
+        return unavailable("CHANGELOG state is unavailable in CLI state.");
+    let text;
+    try {
+        text = fs.readFileSync(p, "utf8");
+    }
+    catch (exc) {
+        return unavailable(`CHANGELOG state could not be read by the CLI: ${exc.message}`);
+    }
+    const headings = text.split(/\r\n|\r|\n/).filter((line) => line.startsWith("## ")).map((line) => line.trim());
+    const unreleased = headings.find((h) => h.toLowerCase().includes("unreleased")) ?? null;
+    const latestRelease = headings.find((h) => !h.toLowerCase().includes("unreleased")) ?? null;
+    const selectedRecorded = changelogRecordsTarget(text, targetVersion);
+    const caveats = [];
+    if (headings.length === 0)
+        caveats.push("CHANGELOG state has no release headings.");
+    if (targetVersion && !selectedRecorded)
+        caveats.push(`CHANGELOG state has no ${targetVersion} closeout entry yet.`);
+    const boundary = unreleased || latestRelease;
+    return {
+        status: headings.length > 0 ? "available" : "incomplete",
+        source,
+        source_provenance: {
+            ...sourceProvenance("changelog", "agentera query changelog --format json", "release_headings"),
+            internal_source: "CLI-resolved CHANGELOG.md heading scan",
+        },
+        selected_target_version: targetVersion,
+        selected_target_recorded: selectedRecorded,
+        unreleased_present: unreleased !== null,
+        latest_release_heading: latestRelease,
+        boundary_present: boundary !== null,
+        boundary,
+        release_state: selectedRecorded ? "selected_target_recorded" : "no_selected_target_closeout_entry",
+        caveats,
+    };
+}
+//# sourceMappingURL=planState.js.map

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

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

package/dist/cli/capabilityContext/progress.js

@@ -0,0 +1,143 @@
+import { evaluatorHandoffOutputRequirements, loadEvaluatorHandoffContract, } from "../../registries/evaluatorHandoffContract.js";
+import { capabilityInstructionContractPath } from "./contract.js";
+import { hasRecordedValue, isFile, taskRef } from "./shared.js";
+import { STATE_FAMILY_LIST_COMMANDS } from "./types.js";
+export function progressVerificationSummary(progress) {
+    const source = { source_family: "progress", command: STATE_FAMILY_LIST_COMMANDS.progress };
+    if (!progress.exists) {
+        return {
+            status: "unavailable",
+            source_provenance: source,
+            cycle: null,
+            verified_present: false,
+            non_empty_evidence_present: false,
+            non_empty_evidence_fields: [],
+            verified: null,
+            verification_summary: null,
+            latest_progress_verification_pointer: null,
+            caveats: ["No progress cycles are recorded in CLI progress state."],
+        };
+    }
+    const latest = progress.latest && typeof progress.latest === "object" && !Array.isArray(progress.latest) ? progress.latest : {};
+    const verified = latest.verified;
+    const latestVerification = progress.latest_verification && typeof progress.latest_verification === "object" && !Array.isArray(progress.latest_verification)
+        ? progress.latest_verification
+        : {};
+    const projectedVerifiedPresent = latest.verified_present === true || latestVerification.present === true;
+    const verifiedPresent = hasRecordedValue(verified) || projectedVerifiedPresent;
+    const cycle = {};
+    for (const key of ["number", "timestamp", "type", "phase"]) {
+        if (latest[key] !== null && latest[key] !== undefined && latest[key] !== "")
+            cycle[key] = latest[key];
+    }
+    const pointer = { ...source, cycle_number: latest.number ?? null, field: "verified" };
+    const caveats = verifiedPresent ? [] : ["Latest progress cycle has no non-empty verified evidence."];
+    const evidenceFields = verifiedPresent ? ["verified"] : [];
+    return {
+        status: "available",
+        source_provenance: source,
+        cycle,
+        verified_present: verifiedPresent,
+        non_empty_evidence_present: verifiedPresent,
+        non_empty_evidence_fields: evidenceFields,
+        verified: hasRecordedValue(verified) ? verified : null,
+        verification_summary: hasRecordedValue(verified) ? verified : projectedVerifiedPresent ? { present: true } : null,
+        latest_progress_verification_pointer: pointer,
+        caveats,
+    };
+}
+export function retryState(selected = null, tasks = []) {
+    const task = selected ??
+        tasks.find((candidate) => {
+            const evaluation = candidate.evaluation;
+            return Boolean(evaluation && typeof evaluation === "object" && !Array.isArray(evaluation));
+        }) ??
+        null;
+    const evaluation = task && task.evaluation_state && typeof task.evaluation_state === "object" && !Array.isArray(task.evaluation_state)
+        ? task.evaluation_state
+        : task && task.evaluation && typeof task.evaluation === "object" && !Array.isArray(task.evaluation)
+            ? task.evaluation
+            : null;
+    const source = {
+        source_family: "plan",
+        command: "agentera state plan record-evaluation --task N --attempt-id ID --verdict {pass,fail}",
+    };
+    if (evaluation) {
+        const attemptCount = Number(evaluation.attempt_count ?? 0);
+        const failureCount = Number(evaluation.failure_count ?? 0);
+        const exhausted = failureCount >= 2;
+        return {
+            status: exhausted ? "exhausted" : "recorded",
+            task: taskRef(task),
+            attempt_count: Number.isInteger(attemptCount) ? attemptCount : null,
+            failure_count: Number.isInteger(failureCount) ? failureCount : null,
+            retry_budget: 2,
+            last_verdict: evaluation.last_verdict ?? null,
+            failure_evidence: evaluation.last_failure_evidence ?? null,
+            provenance: evaluation.provenance ?? null,
+            source_provenance: source,
+            caveats: exhausted ? ["Evaluation retry budget is exhausted; the task is blocked."] : [],
+        };
+    }
+    return {
+        status: "not_recorded",
+        task: task ? taskRef(task) : null,
+        attempt_count: 0,
+        failure_count: 0,
+        retry_budget: 2,
+        last_verdict: null,
+        failure_evidence: null,
+        provenance: null,
+        source_provenance: source,
+        caveats: [],
+    };
+}
+export function evaluatorHandoffOutputRequirementsFromContract() {
+    const contractPath = capabilityInstructionContractPath();
+    if (!isFile(contractPath))
+        return {};
+    try {
+        const contract = loadEvaluatorHandoffContract(contractPath);
+        // cast: contract loaded from parsed capability-instruction-contract.yaml; registry returns Record<string,unknown>
+        return evaluatorHandoffOutputRequirements(contract);
+    }
+    catch {
+        return {};
+    }
+}
+export function evaluatorHandoff(selected, progressVerification, retry, stateCaveats) {
+    const caveats = [...stateCaveats, ...(progressVerification.caveats ?? []), ...(retry.caveats ?? [])];
+    const outputRequirements = evaluatorHandoffOutputRequirementsFromContract();
+    if (selected === null) {
+        caveats.push("No dependency-ready task is selected for evaluator handoff.");
+        return {
+            status: "unavailable",
+            task: null,
+            acceptance_criteria: [],
+            evidence_requirements: [],
+            latest_progress_verification_pointer: progressVerification.latest_progress_verification_pointer ?? null,
+            evaluation_caveats: caveats,
+            output_requirements: outputRequirements,
+        };
+    }
+    const evidenceSummary = selected.evidence_summary && typeof selected.evidence_summary === "object" && !Array.isArray(selected.evidence_summary)
+        ? selected.evidence_summary
+        : null;
+    const evidenceRequirements = (evidenceSummary?.items ?? []);
+    if (evidenceRequirements.length === 0) {
+        caveats.push("Selected task has no explicit evidence requirements recorded in plan state.");
+    }
+    const acceptanceSummary = selected.acceptance_summary && typeof selected.acceptance_summary === "object" && !Array.isArray(selected.acceptance_summary)
+        ? selected.acceptance_summary
+        : null;
+    return {
+        status: "ready",
+        task: taskRef(selected),
+        acceptance_criteria: acceptanceSummary?.items ?? [],
+        evidence_requirements: evidenceRequirements,
+        latest_progress_verification_pointer: progressVerification.latest_progress_verification_pointer ?? null,
+        evaluation_caveats: caveats,
+        output_requirements: outputRequirements,
+    };
+}
+//# sourceMappingURL=progress.js.map

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

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

package/dist/cli/capabilityContext/shared.js

@@ -0,0 +1,94 @@
+import fs from "node:fs";
+import { firstPresent } from "../stateQuery.js";
+import { CAPABILITY_NAMES } from "./types.js";
+export { CAPABILITY_NAMES };
+export function isFile(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function entryStatus(entry, def = "open") {
+    const raw = "status" in entry ? entry.status : def;
+    return String(raw || def).toLowerCase();
+}
+export function pyRepr(value) {
+    return value.includes("'") && !value.includes('"') ? `"${value}"` : `'${value}'`;
+}
+export function validatePrimeCapability(capability) {
+    if (!CAPABILITY_NAMES.includes(capability)) {
+        const valid = CAPABILITY_NAMES.join(", ");
+        throw new Error(`unsupported capability ${pyRepr(capability)}; valid capabilities: ${valid}. ` +
+            "Example: agentera prime --context plan --format json");
+    }
+}
+export function appendUnique(items, value) {
+    if (value && !items.includes(value))
+        items.push(value);
+}
+export function taskRef(task) {
+    return { number: task.number ?? null, name: firstPresent(task, ["name", "title"], ""), status: entryStatus(task, "pending") };
+}
+export function sourceProvenance(sourceFamily, command, field = null) {
+    const provenance = { source_family: sourceFamily, command };
+    if (field)
+        provenance.field = field;
+    return provenance;
+}
+export function docsConventions(docs) {
+    const conventions = docs.conventions;
+    return conventions && typeof conventions === "object" && !Array.isArray(conventions) ? conventions : {};
+}
+export function hasRecordedValue(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === "string")
+        return value.trim().length > 0;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === "object")
+        return Object.keys(value).length > 0;
+    return true;
+}
+export function fallbackStatePointer(artifactId, command) {
+    return { status: "fallback_only", artifact_id: artifactId, fallback_command: command, raw_artifact_reads_required: false };
+}
+export function capabilityContextAppSummary(appHome, bundle) {
+    const caveats = [];
+    if (appHome.status !== "up_to_date") {
+        caveats.push("Agentera app files are not up to date; this is a caveat, not approval to repair or update app files.");
+    }
+    return {
+        status: appHome.status,
+        home: appHome.home,
+        source: appHome.source,
+        managed_app_root: appHome.managed_app_root,
+        user_data_root: appHome.user_data_root,
+        expected_version: bundle.expectedVersion,
+        caveats,
+    };
+}
+export function capabilityContextProfileSummary(profile) {
+    const caveats = [];
+    if (profile.status !== "loaded")
+        caveats.push("profile-derived state is unavailable in prime --context response.");
+    else if (profile.stale === true)
+        caveats.push("profile-derived state is stale; this is a caveat, not approval to refresh profile state.");
+    const summary = {};
+    for (const key of ["status", "path", "stale", "days_since_generated", "stale_threshold_days", "suggested_action"]) {
+        if (key in profile)
+            summary[key] = profile[key];
+    }
+    summary.caveats = caveats;
+    return summary;
+}
+export function uniqueList(items) {
+    const out = [];
+    for (const item of items)
+        if (!out.includes(item))
+            out.push(item);
+    return out;
+}
+//# sourceMappingURL=shared.js.map

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

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