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

package/dist/cli/commands/prime.js

@@ -1,552 +1,55 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
 import { PRIME_BLOB } from "../prime-blob.js";
-import { buildDoctorStatus, publicDoctorStatus } from "../../upgrade/doctor.js";
-import { loadSuiteVersion, resolveDoctorInstallRoot, resolvePlatformAppHome, resolveSourceRootStrict } from "../../upgrade/appModel.js";
-import { resolveInvokedUpdateChannel } from "../../upgrade/channels.js";
-import { isNpxBundleRoot } from "../../core/sourceRoot.js";
-import { buildUpgradeCommands } from "../../upgrade/upgradeCommands.js";
-import { projectIntegrationAttention, summarizeProjectIntegration, } from "../../upgrade/projectIntegration.js";
-import { discoverSchemasDir, loadSchemas } from "../appContext.js";
-import { activeObjectiveSummary, checkProfileraStaleness, decisionFollowUp, decisionReviewAttention, docsSummary, formatNextAction, healthSummary, issueCounts, loadTodoItems, planSummary, progressSummary, registryArtifactPath, selectHejNextAction, statePresence, } from "../orientation.js";
-import { firstPresent, requestedFields, REQUIRED_SPARSE_CONTEXT_FIELDS } from "../stateQuery.js";
-import { BESPOKE_CONTEXT_CAPABILITIES, buildPrimeCapabilityContextPayload, validatePrimeCapability } from "../capabilityContext.js";
-import { emitStructured } from "../structured.js";
-const STARTUP_COMPLETENESS_MISSING_STATE = [];
-const STARTUP_AVAILABLE_STATE_FIELDS = [
-    "app_home", "mode", "profile", "v1_migration", "health", "issues", "plan", "docs", "progress",
-    "objective", "state_presence", "project_integration", "attention", "decision_attention", "next_action",
-    "orchestration_context", "closeout_context", "evidence_context", "benchmark_context", "execution_context",
-];
-const STARTUP_COMPLETENESS_CONFIDENCE_CAVEATS = [
-    "representative benchmark evidence exists, but claude-code and github-copilot coverage is degraded by schema divergence",
-    "Inspektera evidence context uses existing hej, plan, progress, docs, health, TODO, and decisions state outputs",
-];
-const STARTUP_COMPLETENESS_CLI_FALLBACK = [
-    "agentera plan --format json",
-    "agentera docs --format json",
-    "agentera progress --format json",
-];
-const V1_ARTIFACT_PAIRS = [
-    [".agentera/PROGRESS.md", ".agentera/progress.yaml"],
-    [".agentera/PLAN.md", ".agentera/plan.yaml"],
-    [".agentera/DECISIONS.md", ".agentera/decisions.yaml"],
-    [".agentera/HEALTH.md", ".agentera/health.yaml"],
-    [".agentera/DOCS.md", ".agentera/docs.yaml"],
-    ["VISION.md", ".agentera/vision.yaml"],
-];
-function startupCompletenessContract() {
-    const complete = STARTUP_COMPLETENESS_MISSING_STATE.length === 0;
-    return {
-        complete_for_capability_startup: complete,
-        raw_artifact_reads_required: false,
-        raw_artifact_read_policy: "Do not read raw artifacts when complete_for_capability_startup is true. " +
-            "When incomplete, try cli_fallback first; raw artifact reads are only a last-resort fallback.",
-        available_state: STARTUP_AVAILABLE_STATE_FIELDS,
-        missing_state: STARTUP_COMPLETENESS_MISSING_STATE,
-        confidence_caveats: STARTUP_COMPLETENESS_CONFIDENCE_CAVEATS,
-        cli_fallback: STARTUP_COMPLETENESS_CLI_FALLBACK,
-    };
-}
-function isLocalCheckout(root) {
-    return ["skills/agentera/SKILL.md", "registry.json"].every((rel) => fs.existsSync(path.join(root, rel)));
-}
-function detectV1Artifacts() {
-    const root = process.cwd();
-    const found = [];
-    for (const [md, yaml] of V1_ARTIFACT_PAIRS) {
-        if (fs.existsSync(path.join(root, md)) && !fs.existsSync(path.join(root, yaml)))
-            found.push(md);
-    }
-    return found;
-}
-function v1MigrationSummary(v1Artifacts, opts) {
-    const detected = v1Artifacts.length > 0;
-    const channel = resolveInvokedUpdateChannel({
-        channel: null,
-        sourceRoot: opts.sourceRoot,
-        home: opts.home,
-        env: opts.env,
-    });
-    const cmds = detected
-        ? buildUpgradeCommands({
-            project: process.cwd(),
-            installRoot: null,
-            channel,
-            only: ["artifacts"],
-            cwdDefault: true,
-        })
-        : null;
-    const summary = {
-        detected,
-        affected_files: v1Artifacts,
-        dry_run_command: cmds?.dryRunCommand ?? null,
-        apply_command: cmds?.applyCommand ?? null,
-        requires_confirmation: detected,
-        update_channel: channel.channel,
-    };
-    if (detected && isLocalCheckout(process.cwd())) {
-        summary.local_dry_run_command = cmds?.dryRunCommand ?? null;
-        summary.local_apply_command = cmds?.applyCommand ?? null;
-    }
-    return summary;
-}
-function frontmatterVersion(p) {
-    let lines;
-    try {
-        if (!fs.statSync(p).isFile())
-            return null;
-        lines = fs.readFileSync(p, "utf8").split(/\r\n|\r|\n/);
-    }
-    catch {
-        return null;
-    }
-    if (lines.length === 0 || lines[0].trim() !== "---")
-        return null;
-    for (const line of lines.slice(1)) {
-        const stripped = line.trim();
-        if (stripped === "---")
-            return null;
-        if (stripped.startsWith("version:")) {
-            const version = stripped.split(":", 2)[1].trim().replace(/^["']|["']$/g, "");
-            return version || null;
-        }
-    }
-    return null;
-}
-function versionKey(version) {
-    if (!version)
-        return [];
-    const parts = [];
-    for (const item of version.split(/[.+_-]/)) {
-        if (/^\d+$/.test(item))
-            parts.push(parseInt(item, 10));
-        else
-            break;
-    }
-    return parts;
-}
-function versionKeyGe(a, b) {
-    const n = Math.max(a.length, b.length);
-    for (let i = 0; i < n; i++) {
-        const ai = a[i] ?? 0;
-        const bi = b[i] ?? 0;
-        if (ai !== bi)
-            return ai > bi;
-    }
-    return true;
-}
-function visibleSkillVersion(home, env) {
-    const candidates = [];
-    if (env.AGENTERA_VISIBLE_SKILL_ROOT)
-        candidates.push(env.AGENTERA_VISIBLE_SKILL_ROOT);
-    candidates.push(path.join(home, ".agents", "skills", "agentera"));
-    candidates.push(path.join(home, ".config", "opencode", "skills", "agentera"));
-    const versions = [];
-    for (const root of candidates) {
-        const version = frontmatterVersion(path.join(root, "SKILL.md"));
-        if (version)
-            versions.push([versionKey(version), version, root]);
-    }
-    if (versions.length === 0)
-        return [null, null];
-    versions.sort((a, b) => (versionKeyGe(a[0], b[0]) ? -1 : 1));
-    return [versions[0][1], versions[0][2]];
-}
-function hejExpectedVersion(opts, sourceRoot, home, env) {
-    if (opts.expectedVersion)
-        return [opts.expectedVersion, "--expected-version"];
-    if (env.AGENTERA_EXPECTED_VERSION)
-        return [env.AGENTERA_EXPECTED_VERSION, "AGENTERA_EXPECTED_VERSION"];
-    const sourceVersion = loadSuiteVersion(sourceRoot);
-    const [visibleVersion, visibleSource] = visibleSkillVersion(home, env);
-    if (visibleVersion && versionKeyGe(versionKey(visibleVersion), versionKey(sourceVersion))) {
-        return [visibleVersion, visibleSource || "visible skill"];
-    }
-    return [sourceVersion, "source registry"];
-}
-function hejBundleStatus(opts) {
-    const env = opts.env ?? process.env;
-    const home = opts.home ? opts.home : os.homedir();
-    const sourceRoot = resolveSourceRootStrict(env);
-    const [installRoot, rootSource] = resolveDoctorInstallRoot(opts.installRoot ?? null, {
-        home,
-        env,
-        sourceRoot,
-    });
-    const [expected, expectedSource] = hejExpectedVersion(opts, sourceRoot, home, env);
-    const status = buildDoctorStatus(installRoot, {
-        rootSource,
-        sourceRoot,
-        home,
-        project: process.cwd(),
-        expectedVersion: expected,
-        expectedCommands: ["prime"],
-        probeCli: false,
-    });
-    status.expectedVersionSource = expectedSource;
-    if (isNpxBundleRoot(sourceRoot)) {
-        const platformRoot = resolvePlatformAppHome(home, env);
-        const platformStatus = buildDoctorStatus(platformRoot, {
-            rootSource: "default",
-            sourceRoot,
-            home,
-            project: process.cwd(),
-            expectedVersion: expected,
-            expectedCommands: ["prime"],
-            probeCli: false,
-            skipNpxBundleShortCircuit: true,
-            env,
+import { buildPrimeCapabilityContextPayload, validatePrimeCapability } from "../capabilityContext.js";
+import { collectOrientationState } from "./prime/collectOrientationState.js";
+import { buildOrientationJsonPayload, buildStatusContextState, emitPrime, PRIME_BRIEF_MAX_UTF8_BYTES, PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES, printOrientationTextBriefing, } from "./prime/orientationOutput.js";
+import { briefUtf8Bytes } from "./prime/briefOrientation.js";
+import { startupSurfaceBudget } from "../../state/retrievalAuthority.js";
+import { emitInvalidInput } from "../errors.js";
+import { BuildExecutionRequestError, loadBuildExecutionRequest, } from "./prime/buildExecutionRequest.js";
+export { collectOrientationState } from "./prime/collectOrientationState.js";
+export function buildStatusCapabilityContextPayload(state, command = "prime") {
+    const payload = buildPrimeCapabilityContextPayload(state, "status", command);
+    return finalizeStatusCapabilityContextPayload(payload, state, command);
+}
+export function finalizeStatusCapabilityContextPayload(payload, state, command = "prime") {
+    const capabilityContext = payload.capability_context;
+    const context = capabilityContext.context;
+    // status_context carries the dashboard state, so only remove generic rich
+    // copies already projected there. Contract-owned startup metadata remains.
+    delete capabilityContext.app;
+    delete capabilityContext.profile;
+    const startupState = capabilityContext.state;
+    delete startupState.write_contract;
+    delete startupState.retrieval_contract;
+    delete context.history;
+    // status_context already carries the canonical bounded plan projection.
+    delete context.plan;
+    let statusBudget = PRIME_BRIEF_MAX_UTF8_BYTES;
+    let previousStatusBytes = Number.POSITIVE_INFINITY;
+    while (true) {
+        context.status_context = buildStatusContextState(state, command, {
+            budgetBytes: statusBudget,
+            degradedMode: "status_routing",
         });
-        status.platformAppHome = {
-            path: platformRoot,
-            status: platformStatus.status,
-            rootStatus: platformStatus.rootStatus,
-            dryRunCommand: platformStatus.dryRunCommand,
-            applyCommand: platformStatus.applyCommand,
-        };
-        status.cliBundle = {
-            path: sourceRoot,
-            status: status.status,
-            rootStatus: status.rootStatus,
-        };
-    }
-    return status;
-}
-function crossMajorAppHomeAttention(bundle, opts) {
-    const devChannel = resolveInvokedUpdateChannel({
-        channel: "development",
-        sourceRoot: opts.sourceRoot,
-        home: opts.home,
-        env: opts.env,
-    });
-    const cmds = buildUpgradeCommands({
-        project: process.cwd(),
-        installRoot: bundle.appHome,
-        channel: devChannel,
-        cwdDefault: true,
-    });
-    return (`degraded: v2 managed app-home on 3.x CLI requires v2→v3 migration (irreversible); preview ` +
-        `preview \`${cmds.dryRunCommand}\`; app_home=${bundle.appHome}`);
-}
-function appStatusAttention(bundle) {
-    if (bundle.status === "outdated") {
-        return (`normal: app files outdated; run agentera upgrade (preview: ` +
-            `\`${bundle.dryRunCommand}\`); app_home=${bundle.appHome}`);
-    }
-    if (bundle.dryRunCommand) {
-        const label = String(bundle.status).replace(/_/g, " ");
-        return `degraded: app ${label}; preview \`${bundle.dryRunCommand}\`; app_home=${bundle.appHome}`;
-    }
-    return (`critical: app ${String(bundle.status).replace(/_/g, " ")}; fix AGENTERA_HOME or choose a managed app home; ` +
-        `app_home=${bundle.appHome}`);
-}
-const TODO_SEVERITY_ORDER = {
-    critical: 0, degraded: 1, warning: 1, normal: 2, info: 3, annoying: 3,
-};
-export function collectOrientationState(opts) {
-    const env = opts.env ?? process.env;
-    const home = opts.home ? opts.home : os.homedir();
-    const sourceRoot = resolveSourceRootStrict(env);
-    const schemasDir = discoverSchemasDir();
-    const schemas = loadSchemas(schemasDir);
-    const bundle = hejBundleStatus(opts);
-    let savedContext = false;
-    try {
-        savedContext = fs.readdirSync(path.join(process.cwd(), ".agentera")).some((f) => f.endsWith(".yaml"));
-    }
-    catch {
-        savedContext = false;
-    }
-    const mode = savedContext ? "returning" : "fresh";
-    const profile = registryArtifactPath("profile", schemasDir);
-    const profileExists = fs.existsSync(profile);
-    const profileStatus = profileExists ? "loaded" : "not found";
-    const profileStaleness = profileExists ? checkProfileraStaleness(profile, env) : null;
-    const profileDict = { status: profileStatus, path: profile };
-    if (profileStatus === "not found")
-        profileDict.suggested_action = "Run profilera to generate PROFILE.md";
-    if (profileStaleness !== null) {
-        const [isStale, daysSince, staleDays] = profileStaleness;
-        profileDict.days_since_generated = daysSince;
-        profileDict.stale = isStale;
-        profileDict.stale_threshold_days = staleDays;
-        if (isStale)
-            profileDict.suggested_action = "Run profilera to refresh PROFILE.md";
-    }
-    const v1Artifacts = detectV1Artifacts();
-    const v1Migration = v1MigrationSummary(v1Artifacts, { sourceRoot, home, env });
-    const plan = planSummary(schemas);
-    const docs = docsSummary(schemas);
-    const progress = progressSummary(schemas);
-    const health = healthSummary(schemas, env);
-    const objective = activeObjectiveSummary();
-    const presence = statePresence(plan, docs, progress, health, objective);
-    const todoItems = loadTodoItems(schemas);
-    const counts = issueCounts(todoItems);
-    const decision = decisionFollowUp(schemas);
-    const decisionAttention = decisionReviewAttention(schemas);
-    const project = process.cwd();
-    const projectIntegration = summarizeProjectIntegration({
-        project,
-        sourceRoot,
-        home,
-        env,
-        installRoot: String(bundle.appHome),
-        bundleStatus: String(bundle.status),
-        crossMajorBoundary: Boolean(bundle.crossMajorBoundary),
-    });
-    const integrationAttention = projectIntegrationAttention(projectIntegration);
-    const defaultNextAction = selectHejNextAction(plan, health, objective, todoItems, decision, savedContext);
-    const nextAction = projectIntegration.recommendation === "upgrade"
-        ? {
-            object: projectIntegration.pending_artifacts > 0
-                ? "Upgrade Agentera artifacts"
-                : projectIntegration.pending_runtime > 0
-                    ? "Upgrade Agentera runtime wiring"
-                    : "Upgrade Agentera",
-            capability: "hej",
-            reason: projectIntegration.message,
+        if (briefUtf8Bytes(payload) <= PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES)
+            break;
+        const statusBytes = briefUtf8Bytes(context.status_context);
+        if (statusBytes >= previousStatusBytes) {
+            throw new Error("status context budget projection did not decrease toward the complete capsule budget");
         }
-        : defaultNextAction;
-    const attention = [];
-    if (integrationAttention) {
-        attention.push(integrationAttention);
-    }
-    else if (bundle.crossMajorBoundary) {
-        attention.push(crossMajorAppHomeAttention(bundle, { sourceRoot, home, env }));
-    }
-    else if (bundle.status !== "up_to_date") {
-        attention.push(appStatusAttention(bundle));
-    }
-    if (v1Migration.detected && projectIntegration.recommendation !== "upgrade") {
-        attention.push(`degraded: v1 artifacts detected; preview \`${v1Migration.dry_run_command}\`; files=${v1Artifacts.join(", ")}`);
-    }
-    if (profileStatus === "not found") {
-        attention.push(`degraded: PROFILE.md not found at ${profile}; suggest running profilera to generate PROFILE.md`);
-    }
-    else if (profileStaleness !== null && profileStaleness[0]) {
-        const [, daysSince, staleDays] = profileStaleness;
-        attention.push(`normal: profilera profile stale (${daysSince} days since generated; ` +
-            `threshold=${staleDays}); suggest running profilera to refresh PROFILE.md`);
-    }
-    if (health.stale) {
-        const auditNumber = health.number ?? "?";
-        const daysSince = health.days_since_audit ?? "?";
-        const thresholdDays = health.stale_threshold_days ?? "?";
-        const thresholdCycles = health.stale_threshold_cycles ?? "?";
-        let attentionText = `normal: inspektera audit stale (${daysSince} days since Audit ${auditNumber}; ` +
-            `threshold days=${thresholdDays}, cycles=${thresholdCycles}`;
-        const cyclesSince = health.cycles_since_audit;
-        if (cyclesSince !== null && cyclesSince !== undefined)
-            attentionText += `; ${cyclesSince} cycles since audit`;
-        attention.push(`${attentionText}); suggest running inspektera`);
-    }
-    if (health.degrading) {
-        const worst = health.worst;
-        attention.push(worst ? `critical: health needs attention (${worst[0]}:${worst[1]})` : "critical: health is degrading");
-    }
-    const pending = plan.first_pending;
-    if (pending && typeof pending === "object" && !Array.isArray(pending)) {
-        const title = firstPresent(pending, ["name", "title"], "pending task");
-        attention.push(`normal: PLAN Task ${pending.number ?? "?"}: ${title}`);
-    }
-    if (decisionAttention !== null)
-        attention.push(String(decisionAttention.attention));
-    if (!(pending && typeof pending === "object" && !Array.isArray(pending)) && todoItems.length > 0) {
-        const firstTodo = [...todoItems].sort((a, b) => (TODO_SEVERITY_ORDER[a.severity] ?? 2) - (TODO_SEVERITY_ORDER[b.severity] ?? 2))[0];
-        attention.push(`${firstTodo.severity}: TODO: ${firstTodo.text}`);
-    }
-    return {
-        schemas_dir: schemasDir,
-        schemas,
-        bundle,
-        mode,
-        profile_dict: profileDict,
-        profile_status: profileStatus,
-        profile,
-        v1_migration: v1Migration,
-        project_integration: projectIntegration,
-        plan,
-        docs,
-        progress,
-        health,
-        objective,
-        state_presence: presence,
-        todo_items: todoItems,
-        counts,
-        decision_attention: decisionAttention,
-        next_action: nextAction,
-        attention,
-    };
-}
-function printOrientationTextBriefing(state, command, out) {
-    const bundle = state.bundle;
-    const mode = state.mode;
-    const profileStatus = state.profile_status;
-    const profile = state.profile;
-    const health = state.health;
-    const counts = state.counts;
-    const plan = state.plan;
-    const objective = state.objective;
-    const presence = state.state_presence;
-    const attention = state.attention;
-    const nextAction = state.next_action;
-    const dashboardLabel = command === "prime" ? "prime orientation dashboard" : "hej dashboard";
-    out(`agentera ${command}\n`);
-    out(`app_home: status=${bundle.status} | home=${bundle.appHome} | ` +
-        `source=${bundle.appHomeSource} | managed_app=${bundle.managedAppRoot} | user_data=${bundle.userDataRoot} | expected=${bundle.expectedVersion} | ` +
-        `expected_source=${bundle.expectedVersionSource ?? "-"} | current=${bundle.markerVersion || "-"}\n`);
-    out(`mode: ${mode}\n`);
-    const projectIntegration = state.project_integration;
-    out(`project_integration: recommendation=${projectIntegration.recommendation} | ` +
-        `channel=${projectIntegration.update_channel} | pending_runtime=${projectIntegration.pending_runtime}\n`);
-    if (projectIntegration.recommendation === "upgrade" && projectIntegration.message) {
-        out(`project_integration_message: ${projectIntegration.message}\n`);
-    }
-    out(`profile: ${profileStatus} | path=${profile}\n`);
-    if (health.exists) {
-        const worst = health.worst;
-        const worstText = worst ? `${worst[0]}:${worst[1]}` : "none";
-        out(`health: audit=${health.number} | grade=${health.grade || "unknown"} | ` +
-            `trajectory=${health.trajectory || "unknown"} | worst=${worstText}\n`);
-    }
-    out(`issues: critical=${counts.critical} | degraded=${counts.degraded} | normal=${counts.normal} | annoying=${counts.annoying}\n`);
-    if (!presence.any_active) {
-        const missing = Object.keys(presence.absence).sort().join(", ") || "none";
-        out(`state: no active plan or objective | missing=${missing}\n`);
-    }
-    if (plan.exists && !plan.complete_plan) {
-        out(`plan: status=${plan.status || "unknown"} | progress=${plan.complete ?? 0}/${plan.total ?? 0}\n`);
-    }
-    if (objective.active) {
-        const target = objective.target ? ` | target=${objective.target}` : "";
-        out(`objective: active | name=${objective.name} | metric=${objective.metric}${target}\n`);
-    }
-    else if (objective.exists) {
-        out(`objective: none active | closed=${objective.closed_count ?? 0}\n`);
-    }
-    else {
-        out("objective: none active\n");
-    }
-    if (attention.length > 0) {
-        out("attention:\n");
-        for (const item of attention.slice(0, 6))
-            out(`- ${item}\n`);
-    }
-    out("next_action:\n");
-    out(`- ${formatNextAction(nextAction)}\n`);
-    out("source_contract:\n");
-    out("- fields=app_home,mode,profile,v1_migration,project_integration,health,issues,plan,docs,progress,objective,state_presence,attention,decision_attention,next_action,orchestration_context,closeout_context,evidence_context,benchmark_context,execution_context\n");
-    out(`- render=caller-owned README-style ${dashboardLabel}\n`);
-    out("- access=single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls\n");
-    const startup = startupCompletenessContract();
-    out(`- capability_startup_complete=${String(startup.complete_for_capability_startup).toLowerCase()}\n`);
-    out(`- raw_artifact_reads_required=${String(startup.raw_artifact_reads_required).toLowerCase()}; policy=${startup.raw_artifact_read_policy}\n`);
-    const missingState = startup.missing_state.join("; ") || "none";
-    out(`- missing_state=${missingState}\n`);
-    out(`- confidence_caveats=${startup.confidence_caveats.join("; ")}\n`);
-    out(`- cli_fallback=${startup.cli_fallback.join("; ")}\n`);
-}
-const HEJ_STRUCTURED_FIELDS = [
-    "command", "status", "app_home", "bundle", "mode", "profile", "v1_migration", "health",
-    "issues", "plan", "docs", "progress", "objective", "state_presence", "project_integration", "attention",
-    "decision_attention", "next_action", "orchestration_context", "closeout_context",
-    "evidence_context", "benchmark_context", "execution_context", "source", "source_contract",
-];
-function orientationAppHome(bundle) {
-    return {
-        status: bundle.status,
-        home: bundle.appHome,
-        source: bundle.appHomeSource,
-        managed_app_root: bundle.managedAppRoot,
-        user_data_root: bundle.userDataRoot,
-    };
-}
-function buildOrientationJsonPayload(state, command, capabilityName = null) {
-    const bundle = state.bundle;
-    const schemasDir = state.schemas_dir;
-    const bundlePublic = publicDoctorStatus(bundle);
-    const appHome = orientationAppHome(bundle);
-    // For capabilityName === null (default + dashboard), all bespoke contexts are null.
-    const bespoke = {
-        orchestration_context: null,
-        closeout_context: null,
-        evidence_context: null,
-        benchmark_context: null,
-        execution_context: null,
-    };
-    const render = command === "hej"
-        ? "caller-owned README-style hej dashboard"
-        : "caller-owned README-style prime orientation dashboard";
-    const access = command === "hej"
-        ? "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal hej"
-        : "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime";
-    return {
-        command,
-        status: "ok",
-        app_home: appHome,
-        bundle: bundlePublic,
-        mode: state.mode,
-        profile: state.profile_dict,
-        v1_migration: state.v1_migration,
-        project_integration: state.project_integration,
-        health: state.health,
-        issues: state.counts,
-        plan: state.plan,
-        docs: state.docs,
-        progress: state.progress,
-        objective: state.objective,
-        state_presence: state.state_presence,
-        attention: state.attention.slice(0, 6),
-        decision_attention: state.decision_attention,
-        next_action: state.next_action,
-        orchestration_context: bespoke.orchestration_context,
-        closeout_context: bespoke.closeout_context,
-        evidence_context: bespoke.evidence_context,
-        benchmark_context: bespoke.benchmark_context,
-        execution_context: bespoke.execution_context,
-        source: {
-            schemas_dir: schemasDir,
-            project: process.cwd(),
-            artifacts_present: state.mode === "returning",
-        },
-        source_contract: {
-            fields: HEJ_STRUCTURED_FIELDS,
-            render,
-            access,
-            empty_state: "fresh mode with missing artifact summaries and zero issue counts",
-            capability_startup: startupCompletenessContract(),
-            capability_context: capabilityName ? null : null,
-        },
-    };
-}
-function availablePrimeFields(command) {
-    if (command === "prime")
-        return [...HEJ_STRUCTURED_FIELDS, "capability_context"];
-    return HEJ_STRUCTURED_FIELDS;
-}
-function emitPrime(command, payload, format, fieldsArg, out, err) {
-    const requested = requestedFields(fieldsArg);
-    if (requested.length === 0) {
-        emitStructured(payload, format, out);
-        return 0;
-    }
-    const available = availablePrimeFields(command);
-    const unsupported = requested.filter((f) => !available.includes(f));
-    if (unsupported.length > 0) {
-        err(`Error: unsupported field '${unsupported[0]}' for ${command}. Available fields: ${available.join(", ")}\n`);
-        return 1;
-    }
-    const selected = {};
-    for (const field of [...REQUIRED_SPARSE_CONTEXT_FIELDS, ...requested]) {
-        if (field in payload && !(field in selected))
-            selected[field] = payload[field];
-    }
-    emitStructured(selected, format, out);
-    return 0;
-}
+        previousStatusBytes = statusBytes;
+        // One byte below the actual serialized projection forces the next bounded
+        // form. Unlike subtracting the outer overage, this transition is monotonic
+        // even when the current projection still sits below its prior allowance.
+        statusBudget = statusBytes - 1;
+    }
+    return payload;
+}
+/**
+ * prime orientation command. Port of scripts/agentera cmd_prime / cmd_status.
+ * The text briefing (default), --guidance, --dashboard, --context, and
+ * --format json paths are all wired.
+ */
 export function cmdPrime(args, io = {}) {
     const out = io.out ?? ((t) => process.stdout.write(t));
     const err = io.err ?? ((t) => process.stderr.write(t));
@@ -554,6 +57,16 @@ export function cmdPrime(args, io = {}) {
     const capability = args.context ?? null;
     const dashboard = Boolean(args.dashboard || args.orientation);
     const guidance = Boolean(args.guidance);
+    const input = args.input ?? null;
+    const inputErrorFormat = args.format === "json" || args.format === "yaml" ? args.format : "text";
+    const rejectInput = (body) => emitInvalidInput(io, { format: inputErrorFormat, body });
+    if (input !== null && (capability !== "build" || dashboard || guidance)) {
+        return rejectInput({
+            class: "unsupported_target",
+            message: "--input is valid only with prime --context build",
+            syntax: "agentera prime --context build --input <file|-> --format json",
+        });
+    }
     if (capability !== null && dashboard) {
         err("Error: prime --context and prime --dashboard/--orientation are mutually exclusive\n");
         return 2;
@@ -571,7 +84,12 @@ export function cmdPrime(args, io = {}) {
         return 0;
     }
     const format = args.format ?? "text";
-    const collectOpts = { home: args.home, installRoot: args.installRoot, expectedVersion: args.expectedVersion };
+    const collectOpts = {
+        projectRoot: args.projectRoot,
+        home: args.home,
+        installRoot: args.installRoot,
+        expectedVersion: args.expectedVersion,
+    };
     if (capability !== null) {
         try {
             validatePrimeCapability(capability);
@@ -584,13 +102,31 @@ export function cmdPrime(args, io = {}) {
             err("Error: prime --context requires --format json\n");
             return 2;
         }
-        if (BESPOKE_CONTEXT_CAPABILITIES.has(capability)) {
-            err("agentera: prime --context for this capability is not yet ported (pending its bespoke context)\n");
-            return 1;
+        let buildRequest = null;
+        if (input !== null) {
+            try {
+                buildRequest = loadBuildExecutionRequest(input, io.stdin);
+            }
+            catch (error) {
+                if (error instanceof BuildExecutionRequestError)
+                    return rejectInput(error.body);
+                return rejectInput({ class: "invalid_format", message: "Build execution request input could not be read" });
+            }
         }
         const state = collectOrientationState(collectOpts);
-        const payload = buildPrimeCapabilityContextPayload(state, capability, command);
-        return emitPrime(command, payload, format, args.fields, out, err);
+        if (buildRequest !== null && state.plan.active === true) {
+            return rejectInput({
+                class: "conflict",
+                message: "Transient no-plan Build input conflicts with the current plan-owned execution context",
+                recovery: "Run Build without --input for the current plan, or close/archive that plan before retrying; no state was changed.",
+            });
+        }
+        const payload = capability === "status"
+            ? buildStatusCapabilityContextPayload(state, command)
+            : buildPrimeCapabilityContextPayload(state, capability, command, buildRequest);
+        return emitPrime(command, payload, format, args.fields, out, err, {
+            maxUtf8Bytes: capability === "status" ? PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES : undefined,
+        });
     }
     if (dashboard) {
         if (format === "text") {
@@ -598,13 +134,17 @@ export function cmdPrime(args, io = {}) {
             return 2;
         }
         const state = collectOrientationState(collectOpts);
-        const payload = buildOrientationJsonPayload(state, command, null);
-        return emitPrime(command, payload, format, args.fields, out, err);
+        const payload = buildOrientationJsonPayload(state, command);
+        return emitPrime(command, payload, format, args.fields, out, err, {
+            maxUtf8Bytes: startupSurfaceBudget("prime_dashboard"),
+        });
     }
     const state = collectOrientationState(collectOpts);
     if (format !== "text") {
-        const payload = buildOrientationJsonPayload(state, command, null);
-        return emitPrime(command, payload, format, args.fields, out, err);
+        const payload = buildOrientationJsonPayload(state, command);
+        // Bare default: project to the bounded decision brief (prime-briefing,
+        // 12000-byte budget). Explicit `--fields` selection keeps full payload.
+        return emitPrime(command, payload, format, args.fields, out, err, { bareBrief: true });
     }
     printOrientationTextBriefing(state, command, out);
     return 0;