agentera 3.0.0-dev.5 → 3.0.0-dev.7

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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"}

package/dist/cli/capabilityContext/slim.js

@@ -0,0 +1,108 @@
+import { asList } from "../stateQuery.js";
+export function compactTaskSummaryForSlim(task) {
+    if (!task || typeof task !== "object" || Array.isArray(task))
+        return task;
+    return {
+        number: task.number ?? null,
+        name: task.name ?? null,
+        status: task.status ?? null,
+        depends_on: task.depends_on ?? null,
+        acceptance_count: task.acceptance_summary && typeof task.acceptance_summary === "object" ? task.acceptance_summary.count ?? null : null,
+        evidence_count: task.evidence_summary && typeof task.evidence_summary === "object" ? task.evidence_summary.count ?? null : null,
+        blocked_reasons: task.blocked_reasons ?? null,
+    };
+}
+export function compactProgressVerification(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const out = {};
+    for (const key of [
+        "status", "source_provenance", "cycle", "verified_present",
+        "non_empty_evidence_present", "non_empty_evidence_fields", "latest_progress_verification_pointer", "caveats",
+    ]) {
+        if (key in value)
+            out[key] = value[key];
+    }
+    return out;
+}
+export function slimOrchestrationContext(value) {
+    const compact = { ...value };
+    const taskQueue = value.task_queue && typeof value.task_queue === "object" && !Array.isArray(value.task_queue) ? value.task_queue : {};
+    compact.task_queue = {
+        total: taskQueue.total ?? null,
+        dependency_ready_tasks: asList(taskQueue.dependency_ready_tasks).map((t) => compactTaskSummaryForSlim(t)),
+        blocked_tasks: asList(taskQueue.blocked_tasks).map((t) => compactTaskSummaryForSlim(t)),
+    };
+    compact.progress_verification = compactProgressVerification(value.progress_verification);
+    compact.task_summaries = asList(value.task_summaries).map((t) => compactTaskSummaryForSlim(t));
+    return compact;
+}
+export function truncateContextText(value, maxChars = 240) {
+    if (typeof value !== "string" || value.length <= maxChars)
+        return value;
+    return value.slice(0, maxChars - 1).replace(/\s+$/, "") + "\u2026";
+}
+export function compactItemsState(value, maxItems = 3, maxChars = 180) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const compact = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (!["items", "attributed_items", "summary"].includes(key))
+            compact[key] = item;
+    }
+    const items = value.items;
+    if (Array.isArray(items)) {
+        compact.item_count = items.length;
+        compact.items = items.slice(0, maxItems).map((item) => item && typeof item === "object" && !Array.isArray(item)
+            ? Object.fromEntries(Object.entries(item).map(([k, v]) => [k, truncateContextText(v, maxChars)]))
+            : truncateContextText(item, maxChars));
+        compact.truncated_item_count = Math.max(items.length - maxItems, 0);
+    }
+    const attributed = value.attributed_items;
+    if (Array.isArray(attributed))
+        compact.attributed_item_count = attributed.length;
+    if (typeof value.summary === "string") {
+        compact.summary_present = true;
+        compact.summary_excerpt = truncateContextText(value.summary, maxChars);
+    }
+    return compact;
+}
+export function compactVersionChecks(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const compact = {};
+    for (const key of ["status", "allowed_status_values", "source_provenance", "caveats"]) {
+        if (key in value)
+            compact[key] = value[key];
+    }
+    const checks = value.checks;
+    if (Array.isArray(checks)) {
+        compact.checks = checks.map((check) => {
+            const out = {};
+            for (const key of ["name", "status", "refresh_performed", "remote_checks_performed", "registry_checks_performed"]) {
+                if (check && typeof check === "object" && !Array.isArray(check) && key in check) {
+                    const c = check;
+                    out[key] = c[key];
+                }
+            }
+            return out;
+        });
+    }
+    return compact;
+}
+export function slimEvidenceContext(value) {
+    const compact = { ...value };
+    compact.residual_risks = compactItemsState(value.residual_risks, 15, 180);
+    compact.todo_state = compactItemsState(value.todo_state, 3, 180);
+    compact.progress_verification = compactProgressVerification(value.progress_verification);
+    compact.version_checks = compactVersionChecks(value.version_checks);
+    return compact;
+}
+export function slimCloseoutContext(value) {
+    const compact = { ...value };
+    compact.benchmark_evidence = compactItemsState(value.benchmark_evidence, 0, 220);
+    compact.todo_blockers = compactItemsState(value.todo_blockers, 3, 160);
+    compact.progress_evidence = compactProgressVerification(value.progress_evidence);
+    return compact;
+}
+//# sourceMappingURL=slim.js.map

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

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

package/dist/cli/capabilityContext/startup.js

@@ -0,0 +1,213 @@
+import { publicDoctorStatus } from "../../upgrade/doctor.js";
+import { CAPABILITY_INSTRUCTIONS } from "../../capabilities/index.js";
+import { asList } from "../stateQuery.js";
+import { capabilityContext } from "./contract.js";
+import { bespokeCapabilityContexts, slimBespokeContext } from "./bespoke.js";
+import { capabilityContextAppSummary, capabilityContextProfileSummary, docsConventions, fallbackStatePointer, hasRecordedValue, sourceProvenance, taskRef, } from "./shared.js";
+export function slimPlanState(plan) {
+    const firstPending = plan.first_pending;
+    return {
+        exists: Boolean(plan.exists),
+        status: plan.status ?? null,
+        title: plan.title ?? null,
+        complete: plan.complete ?? null,
+        total: plan.total ?? null,
+        first_pending: firstPending && typeof firstPending === "object" && !Array.isArray(firstPending) ? taskRef(firstPending) : null,
+        source_provenance: sourceProvenance("plan", "agentera plan --format json"),
+    };
+}
+export function slimDocsState(docs) {
+    const conventions = docsConventions(docs);
+    return {
+        exists: Boolean(docs.exists),
+        status: docs.status ?? null,
+        mapping_entries: docs.mapping_entries ?? asList(docs.mapping).length,
+        version_policy: {
+            version_files: asList(conventions.version_files),
+            semver_policy: conventions.semver_policy && typeof conventions.semver_policy === "object" && !Array.isArray(conventions.semver_policy) ? conventions.semver_policy : {},
+        },
+        source_provenance: sourceProvenance("docs", "agentera docs --format json", "summary"),
+    };
+}
+export function slimProgressState(progress) {
+    const latest = progress.latest && typeof progress.latest === "object" && !Array.isArray(progress.latest) ? progress.latest : {};
+    const latestCycle = {};
+    for (const key of ["number", "timestamp", "type", "phase"]) {
+        if (latest[key] !== null && latest[key] !== undefined && latest[key] !== "")
+            latestCycle[key] = latest[key];
+    }
+    return {
+        exists: Boolean(progress.exists),
+        status: progress.status ?? null,
+        latest_cycle: latestCycle,
+        verified_present: hasRecordedValue(latest.verified),
+        source_provenance: sourceProvenance("progress", "agentera progress --format json"),
+    };
+}
+export function slimHealthState(health) {
+    return {
+        exists: Boolean(health.exists),
+        number: health.number ?? null,
+        grade: health.grade ?? null,
+        trajectory: health.trajectory ?? null,
+        worst: health.worst ?? null,
+        degrading: Boolean(health.degrading),
+        source_provenance: sourceProvenance("health", "agentera health --format json"),
+    };
+}
+export function slimTodoState(todoItems) {
+    const severityCounts = {};
+    for (const item of todoItems) {
+        const severity = String(item.severity ?? "normal");
+        severityCounts[severity] = (severityCounts[severity] ?? 0) + 1;
+    }
+    return {
+        open_count: todoItems.length,
+        severity_counts: severityCounts,
+        source_provenance: sourceProvenance("todo", "agentera todo --format json"),
+    };
+}
+export function genericSlimStartupContext(capability, context, plan, docs, progress, health, todoItems, profile) {
+    const decisionsPointer = fallbackStatePointer("decisions", "agentera state decisions --format json");
+    const docsState = slimDocsState(docs);
+    const profileState = capabilityContextProfileSummary(profile);
+    if (capability === "vision") {
+        return {
+            vision_startup_context: {
+                vision: fallbackStatePointer("vision", "agentera state query vision --format json"),
+                docs_mapping: docsState,
+                progress: slimProgressState(progress),
+                health: slimHealthState(health),
+                todo: slimTodoState(todoItems),
+                decisions: decisionsPointer,
+                design: fallbackStatePointer("design", "agentera state query design --format json"),
+                profile: profileState,
+            },
+        };
+    }
+    if (capability === "discuss") {
+        return {
+            deliberation_context: {
+                decisions: decisionsPointer,
+                vision: fallbackStatePointer("vision", "agentera state query vision --format json"),
+                objective: fallbackStatePointer("objective", "agentera state objective --format json"),
+                todo: slimTodoState(todoItems),
+                docs_mapping: docsState,
+                profile: profileState,
+                protected_write_boundaries: ["vision", "todo", "objective"],
+            },
+        };
+    }
+    if (capability === "research") {
+        return {
+            research_context: {
+                profile: profileState,
+                vision: fallbackStatePointer("vision", "agentera state query vision --format json"),
+                write_boundaries: ["todo", "vision"],
+            },
+        };
+    }
+    if (capability === "plan") {
+        return {
+            planning_context: {
+                startup_contract: context.startup_contract ?? null,
+                plan: slimPlanState(plan),
+                docs: docsState,
+                health: slimHealthState(health),
+                todo: slimTodoState(todoItems),
+                progress: slimProgressState(progress),
+                decisions: decisionsPointer,
+                profile: profileState,
+            },
+        };
+    }
+    if (capability === "profile") {
+        return {
+            profile_context: { profile: profileState, decisions: decisionsPointer, raw_profile_body_emitted: false },
+        };
+    }
+    if (capability === "design") {
+        return {
+            design_context: {
+                design: fallbackStatePointer("design", "agentera state query design --format json"),
+                vision: fallbackStatePointer("vision", "agentera state query vision --format json"),
+                progress: slimProgressState(progress),
+                todo: slimTodoState(todoItems),
+                docs_mapping: docsState,
+                profile: profileState,
+            },
+        };
+    }
+    return {};
+}
+export function slimCapabilityContext(capability, mode, appHome, bundle, profile, plan, docs, progress, health, todoItems, bespokeContexts) {
+    const context = capabilityContext(capability) ?? {
+        capability,
+        declared_state_needs: [],
+        declared_write_targets: [],
+        artifact_inventory: { read_needs: [], write_targets: [] },
+        included_state_families: [],
+        missing_state_families: [],
+        cli_fallback: [],
+        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: `No capability context found for ${capability}.`,
+    };
+    const contextPayload = { capability, schema_error: context.schema_error ?? null };
+    Object.assign(contextPayload, genericSlimStartupContext(capability, context, plan, docs, progress, health, todoItems, profile));
+    const firstRead = context.first_invocation_read;
+    if (firstRead !== null && firstRead !== undefined)
+        contextPayload.first_invocation_read = firstRead;
+    // bespoke contexts are all null for the six non-bespoke capabilities.
+    if (bespokeContexts) {
+        for (const [name, value] of Object.entries(bespokeContexts)) {
+            if (value !== null && value !== undefined)
+                contextPayload[name] = slimBespokeContext(name, value);
+        }
+    }
+    const prose = CAPABILITY_INSTRUCTIONS[capability] ?? null;
+    return {
+        schemaVersion: "agentera.capabilityContext.v1",
+        capability,
+        mode,
+        app: capabilityContextAppSummary(appHome, bundle),
+        profile: capabilityContextProfileSummary(profile),
+        state: {
+            declared_read_needs: context.declared_state_needs ?? [],
+            declared_write_targets: context.declared_write_targets ?? [],
+            artifact_inventory: context.artifact_inventory ?? { read_needs: [], write_targets: [] },
+            included: context.included_state_families ?? [],
+            missing: context.missing_state_families ?? [],
+            fallback_commands: context.cli_fallback ?? [],
+            schema_error: context.schema_error ?? null,
+        },
+        context: contextPayload,
+        prose: prose ?? "",
+        raw_artifact_read_policy: context.raw_artifact_read_policy ?? null,
+    };
+}
+export function orientationAppHome(bundle) {
+    return {
+        status: bundle.status,
+        home: bundle.appHome,
+        source: bundle.appHomeSource,
+        managed_app_root: bundle.managedAppRoot,
+        user_data_root: bundle.userDataRoot,
+    };
+}
+export function buildPrimeCapabilityContextPayload(state, capabilityName, command = "prime") {
+    // cast: orientation state is assembled from parsed .agentera artifacts; slim/bespoke
+    // builders consume JsonObject shapes for these state families.
+    const stateDict = state;
+    const bundlePublic = publicDoctorStatus(state.app);
+    const appHome = orientationAppHome(stateDict.app);
+    const bespoke = bespokeCapabilityContexts(capabilityName, stateDict);
+    return {
+        command,
+        status: "ok",
+        capability_context: slimCapabilityContext(capabilityName, state.mode, appHome, 
+        // cast: bundlePublic is a distilled app-bundle status (interface) consumed as JsonObject by slim context
+        bundlePublic, stateDict.profile_dict, stateDict.plan, stateDict.docs, stateDict.progress, stateDict.health, state.todo_items, bespoke),
+    };
+}
+//# sourceMappingURL=startup.js.map

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

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

package/dist/cli/capabilityContext/types.js

@@ -0,0 +1,40 @@
+import { CAPABILITY_INSTRUCTIONS } from "../../capabilities/index.js";
+export const CAPABILITY_NAMES = Object.keys(CAPABILITY_INSTRUCTIONS);
+export const STATE_FAMILY_FALLBACK_COMMANDS = {
+    plan: "agentera state plan --format json",
+    docs: "agentera state docs --format json",
+    progress: "agentera state progress --format json",
+    health: "agentera state health --format json",
+    todo: "agentera state todo --format json",
+    decisions: "agentera state decisions --format json",
+    changelog: "agentera state query changelog --format json",
+    objective: "agentera state objective --format json",
+    experiments: "agentera state experiments --format json",
+};
+export const STARTUP_ENVELOPE_STATE_FAMILIES = new Set([
+    "plan", "docs", "progress", "health", "todo", "objective", "benchmark_context",
+]);
+export const PLAN_STARTUP_CONTRACT_VERSION = "agentera.planeraStartup.v1";
+export const PLAN_PLANNING_LEVELS = ["skip", "light", "full"];
+export const PLAN_STEP_VERBS = ["orient", "specify", "review", "audit", "write", "handoff"];
+export const PLAN_INSTRUCTIONS_AUTHORITY_EXCEPTIONS = [
+    "editing Plan behavior or instructions",
+    "resolving contradiction or ambiguity in compact context",
+    "validating detailed behavior not covered by compact context",
+    "investigating benchmark or read-trigger evidence",
+];
+export const PLAN_RAW_PLAN_ACCESS_ALLOWED_FOR = [
+    "writing a new plan",
+    "archiving a completed plan",
+    "artifact validation",
+    "corruption diagnostics",
+    "unavailable or incomplete CLI state after CLI fallbacks",
+];
+export const PLAN_COMPLETED_PLAN_ARCHIVE_CONFIRMATION = {
+    direct_plan_invocation: "Archiving an already completed existing plan before writing its replacement is implicit " +
+        "in the direct Plan invocation and does not require a separate pre-write confirmation.",
+    human_initiated_plan_write: "Plan approval is still required before writing a human-initiated replacement plan.",
+    active_or_incomplete_plan: "Replacing, discarding, or archiving an active or incomplete plan is not implicit; " +
+        "ask for explicit confirmation before the write.",
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/capabilityContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAItE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,8BAA8B,GAA2B;IACpE,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,mCAAmC;IACzC,QAAQ,EAAE,uCAAuC;IACjD,MAAM,EAAE,qCAAqC;IAC7C,IAAI,EAAE,mCAAmC;IACzC,SAAS,EAAE,wCAAwC;IACnD,SAAS,EAAE,8CAA8C;IACzD,SAAS,EAAE,wCAAwC;IACnD,WAAW,EAAE,0CAA0C;CACxD,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB;CAC/E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,4BAA4B,CAAC;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,sCAAsC,GAAG;IACpD,uCAAuC;IACvC,yDAAyD;IACzD,6DAA6D;IAC7D,kDAAkD;CACnD,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,oBAAoB;IACpB,4BAA4B;IAC5B,qBAAqB;IACrB,wBAAwB;IACxB,yDAAyD;CAC1D,CAAC;AACF,MAAM,CAAC,MAAM,wCAAwC,GAAG;IACtD,sBAAsB,EACpB,0FAA0F;QAC1F,uFAAuF;IACzF,0BAA0B,EAAE,oFAAoF;IAChH,yBAAyB,EACvB,oFAAoF;QACpF,iDAAiD;CACpD,CAAC"}