agentera 3.0.0-dev.3 → 3.0.0-dev.30

package/dist/cli/commands/prime/collectOrientationState.js

@@ -0,0 +1,180 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { detectV1ArtifactPairs } from "../../../upgrade/migrateArtifactsV2ToV3.js";
+import { summarizeProjectIntegration } from "../../../upgrade/projectIntegration.js";
+import { checkProfileStaleness, parseProfileHeaderDates, registryArtifactPath, selectStatusReadiness, statePresence, } from "../../orientation.js";
+import { buildOrientationAttention } from "../../orientation/attention.js";
+import { corpusCoverageSummary } from "../../orientation/corpusCoverage.js";
+import { profileSignalsStatus } from "../../../analytics/profileSignals.js";
+import { statusBundleContext } from "./bundleStatus.js";
+import { v1MigrationSummary } from "./v1Migration.js";
+import { diagnoseCanonicalSkill } from "../../../setup/sharedSkill.js";
+import { collectEntityOrientation } from "./collectEntityOrientation.js";
+const EMPTY_SCHEMAS = Object.freeze({});
+export function collectOrientationState(opts) {
+    const env = opts.env ?? process.env;
+    const home = opts.home ? opts.home : os.homedir();
+    const project = process.cwd();
+    const { bundle, channel, install, successorAnnounced } = statusBundleContext(opts);
+    const sourceRoot = bundle.sourceRoot;
+    const schemasDir = path.join(sourceRoot, "skills", "agentera", "schemas", "artifacts");
+    const schemas = EMPTY_SCHEMAS;
+    let savedContext = false;
+    try {
+        savedContext = fs.readdirSync(path.join(project, ".agentera")).some((f) => f.endsWith(".yaml"));
+    }
+    catch {
+        savedContext = false;
+    }
+    const mode = savedContext ? "returning" : "fresh";
+    const profile = registryArtifactPath("profile", schemasDir, env);
+    const profileExists = fs.existsSync(profile);
+    const profileStatus = profileExists ? "loaded" : "not found";
+    const profileStaleness = profileExists ? checkProfileStaleness(profile, env) : null;
+    const profileDict = { status: profileStatus, path: profile };
+    if (profileStatus === "not found")
+        profileDict.suggested_action = "Run profile 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 (profileExists) {
+            try {
+                const headerDates = parseProfileHeaderDates(fs.readFileSync(profile, "utf8"));
+                if (headerDates.generatedDate)
+                    profileDict.generated_date = headerDates.generatedDate;
+                if (headerDates.validatedDate)
+                    profileDict.validated_date = headerDates.validatedDate;
+            }
+            catch {
+                // profile metadata is optional for prime output
+            }
+        }
+        if (isStale)
+            profileDict.suggested_action = "Run profile to refresh PROFILE.md";
+    }
+    const boundedSignals = profileSignalsStatus(env, process.platform);
+    profileDict.bounded_signals = boundedSignals;
+    const v1Artifacts = detectV1ArtifactPairs(project);
+    const v1Migration = v1MigrationSummary(v1Artifacts, { sourceRoot, home, env });
+    const entity = collectEntityOrientation(project, sourceRoot);
+    const plan = entity.plan;
+    const docs = entity.docs;
+    const progress = entity.progress;
+    const health = entity.health;
+    const history = entity.history;
+    const objective = entity.objective;
+    const presence = statePresence(plan, docs, progress, health, objective);
+    const todoItems = entity.todoItems;
+    const counts = entity.todoCounts;
+    const decision = entity.decision;
+    const decisionAttention = entity.decisionAttention;
+    const corpusCoverage = corpusCoverageSummary(env, process.platform);
+    const sharedSkill = diagnoseCanonicalSkill(home);
+    const projectIntegration = summarizeProjectIntegration({
+        project,
+        sourceRoot,
+        home,
+        env,
+        installRoot: String(bundle.appHome),
+        bundleStatus: String(bundle.status),
+        retryCommand: bundle.retryCommand,
+        crossMajorBoundaryDetected: bundle.crossMajorBoundaryDetected ?? false,
+        channel: bundle.updateChannel ?? null,
+        resolvedChannel: channel,
+        installClassification: install,
+        successorAnnounced,
+        precomputedV1Artifacts: v1Artifacts,
+    });
+    const readiness = selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext);
+    const nextAction = selectProjectIntegrationNextAction(readiness, projectIntegration);
+    const attention = buildOrientationAttention({
+        schemas_dir: schemasDir,
+        schemas,
+        app: bundle,
+        mode,
+        profile_dict: profileDict,
+        profile_status: profileStatus,
+        profile,
+        v1_migration: v1Migration,
+        project_integration: projectIntegration,
+        shared_skill: sharedSkill,
+        plan,
+        docs,
+        progress,
+        health,
+        objective,
+        state_presence: presence,
+        corpus_coverage: corpusCoverage,
+        todo_items: todoItems,
+        todo_detail: entity.todoDetail,
+        counts,
+        decision_attention: decisionAttention,
+        next_action: nextAction,
+        attention: [],
+        history,
+    });
+    return {
+        schemas_dir: schemasDir,
+        schemas,
+        app: bundle,
+        mode,
+        profile_dict: profileDict,
+        profile_status: profileStatus,
+        profile,
+        v1_migration: v1Migration,
+        project_integration: projectIntegration,
+        shared_skill: sharedSkill,
+        plan,
+        docs,
+        progress,
+        health,
+        objective,
+        state_presence: presence,
+        corpus_coverage: corpusCoverage,
+        todo_items: todoItems,
+        todo_detail: entity.todoDetail,
+        counts,
+        decision_attention: decisionAttention,
+        next_action: nextAction,
+        attention,
+        history,
+    };
+}
+/** Promote `newRecommended` to position 1, demoting the prior recommendation
+ *  (and its alternatives) into `alternatives`. Used when a project-integration
+ *  override (upgrade, major-boundary block) takes precedence over the
+ *  state-derived cascade; the demoted candidates remain visible as what to do
+ *  once the override is resolved. */
+export function selectProjectIntegrationNextAction(readiness, projectIntegration) {
+    if (projectIntegration.recommendation === "upgrade") {
+        return withRecommended(readiness, {
+            object: projectIntegration.pending_artifacts > 0
+                ? "Upgrade Agentera artifacts"
+                : "Upgrade Agentera",
+            capability: "status",
+            reason: projectIntegration.dry_run_command
+                ? `${projectIntegration.message} Exact preview: ${projectIntegration.dry_run_command}`
+                : projectIntegration.message,
+            phase: "build",
+        });
+    }
+    if (projectIntegration.major_boundary_block) {
+        return withRecommended(readiness, {
+            object: "Await v3 successor announcement",
+            capability: "status",
+            reason: projectIntegration.major_boundary_block,
+            phase: "audit",
+        });
+    }
+    return readiness;
+}
+function withRecommended(hint, newRecommended) {
+    return {
+        recommended: newRecommended,
+        alternatives: [hint.recommended, ...hint.alternatives],
+    };
+}
+//# sourceMappingURL=collectOrientationState.js.map

package/dist/cli/commands/prime/collectOrientationState.js.map

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

package/dist/cli/commands/prime/orientationOutput.js

@@ -0,0 +1,350 @@
+import { publicDoctorStatus } from "../../../upgrade/doctor.js";
+import { projectInstallTrack } from "../../../upgrade/compatibility.js";
+import { formatNextAction, startupPlanSummary } from "../../orientation.js";
+import { requestedFields, REQUIRED_SPARSE_CONTEXT_FIELDS, PRIME_STRUCTURED_FIELDS, availablePrimeFields } from "../../stateQuery.js";
+import { emitStructured } from "../../structured.js";
+import { startupCompletenessContract } from "../../startupCompletenessContract.js";
+import { stateWriterContract } from "../../../state/write/operations.js";
+import { briefOrientationPayload, briefUtf8Bytes, PRIME_BRIEF_MAX_UTF8_BYTES } from "./briefOrientation.js";
+export { startupCompletenessContract } from "../../startupCompletenessContract.js";
+export { briefOrientationPayload, PRIME_BRIEF_MAX_UTF8_BYTES } from "./briefOrientation.js";
+/** Authority for the complete status startup capsule, including instructions. */
+export const PRIME_STATUS_CONTEXT_MAX_UTF8_BYTES = 25000;
+/** Project a single {@link NextAction} to its JSON record shape. */
+function nextActionEntry(action) {
+    return { object: action.object, capability: action.capability, reason: action.reason, phase: action.phase };
+}
+/** Ranked state-readiness hint for the prime JSON `next_action` field (D76).
+ *  The recommended entry is flattened to top-level `object`/`capability`/
+ *  `reason`/`phase` so consumers reading `next_action.object` keep working,
+ *  and `alternatives` carries the cascade branches the early-return model
+ *  would have skipped, each with the same `{object, capability, reason, phase}`
+ *  shape. */
+function nextActionPayload(state) {
+    const { recommended, alternatives } = state.next_action;
+    return {
+        ...nextActionEntry(recommended),
+        alternatives: alternatives.map(nextActionEntry),
+    };
+}
+const STATUS_STRUCTURED_FIELDS = PRIME_STRUCTURED_FIELDS;
+const ISSUES_FIELD_DEPRECATION_MESSAGE = "Deprecation: prime JSON field 'issues' is deprecated; use 'todo'. The 'issues' field will be removed at the 3.0.0 stable cut.\n";
+/** Top-level conditional fields whose default/inactive payload is omitted from
+ *  the default bare briefing so startup does not carry default-only adjective
+ *  noise. They remain declared in PRIME_STRUCTURED_FIELDS (selectable via
+ *  `--fields` and advertised in `source_contract.fields`) and are recovered
+ *  through `state_presence` (missing-vs-empty semantics) plus a named
+ *  authoritative command. The full payload kept by `buildOrientationJsonPayload`
+ *  still populates them, so explicit `--fields <name>` selection, the text
+ *  briefing, and downstream state consumers are unaffected. See
+ *  references/cli/prime-consumer-compatibility.yaml
+ *  default_emission_omission_contract for the published contract. */
+const OMITTABLE_DEFAULT_CONDITIONAL_TOP_FIELDS = [
+    "v1_migration",
+    "docs",
+    "objective",
+];
+/** Whether a conditional top-level field carries present/active payload (not the
+ *  default-only state that should be omitted from the default briefing). The
+ *  activity predicate mirrors each summary's "default" branch so absence stays
+ *  non-ambiguous: a survivor key is present exactly when the field is active. */
+function isConditionalFieldPresent(field, payload) {
+    const value = payload[field];
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value !== "object" || Array.isArray(value))
+        return true;
+    const obj = value;
+    // v1_migration: present when v1 artifacts are detected (detected !== true is
+    // the default state; recover via `agentera upgrade --dry-run`).
+    if (field === "v1_migration")
+        return obj.detected === true;
+    // docs: present when a docs mapping artifact exists (exists !== true is the
+    // absent state; recover via `agentera state docs`).
+    if (field === "docs")
+        return obj.exists === true;
+    // objective: present when an objective is active (active !== true is the
+    // none-active state; state_presence.active.objective disambiguates).
+    if (field === "objective")
+        return obj.active === true;
+    return true;
+}
+/** Return a default-briefing copy of `payload` with inactive conditional
+ *  top-level fields removed. Required fields and `state_presence` (the
+ *  missing-vs-empty authority) are always retained. Used only by the default
+ *  bare emission path; explicit `--fields` selection keeps the full payload. */
+function omitInactiveConditionalDefaults(payload) {
+    const out = {};
+    for (const [key, value] of Object.entries(payload)) {
+        if (OMITTABLE_DEFAULT_CONDITIONAL_TOP_FIELDS.includes(key) &&
+            !isConditionalFieldPresent(key, payload)) {
+            continue;
+        }
+        out[key] = value;
+    }
+    return out;
+}
+function shouldEmitIssuesDeprecation(requested, payload) {
+    if (!("issues" in payload))
+        return false;
+    if (requested.length === 0)
+        return true;
+    return requested.includes("issues");
+}
+function emitIssuesFieldDeprecationWarning(requested, payload, err) {
+    if (shouldEmitIssuesDeprecation(requested, payload)) {
+        err(ISSUES_FIELD_DEPRECATION_MESSAGE);
+    }
+}
+function orientationAppHome(bundle) {
+    return {
+        install_track: projectInstallTrack(bundle.installKind),
+        status: bundle.status,
+        home: bundle.appHome,
+        source: bundle.appHomeSource,
+        managed_app_root: bundle.managedAppRoot,
+        user_data_root: bundle.userDataRoot,
+    };
+}
+function capabilityContextPointer(requiredBeforeRendering = true) {
+    return {
+        capability: "status",
+        fetch_command: "agentera prime --context status --format json",
+        required_before_rendering: requiredBeforeRendering,
+        note: requiredBeforeRendering
+            ? "Dashboard rendering instructions (template, field rules, exit marker) are owned by the status capability. Run the fetch_command before rendering."
+            : "Includes dashboard instructions and bounded state; no second prime call.",
+    };
+}
+export function buildOrientationJsonPayload(state, command, options = {}) {
+    const bundle = state.app;
+    const schemasDir = state.schemas_dir;
+    const bundlePublic = publicDoctorStatus(bundle);
+    const appHome = orientationAppHome(bundle);
+    const bespoke = {
+        orchestration_context: null,
+        closeout_context: null,
+        evidence_context: null,
+        benchmark_context: null,
+        execution_context: null,
+    };
+    const render = command === "status"
+        ? "caller-owned README-style prime orientation dashboard"
+        : "caller-owned README-style prime orientation dashboard";
+    const access = command === "status"
+        ? "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime"
+        : "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,
+        app: bundlePublic,
+        mode: state.mode,
+        profile: state.profile_dict,
+        v1_migration: state.v1_migration,
+        shared_skill: state.shared_skill,
+        project_integration: state.project_integration,
+        health: state.health,
+        todo: { ...state.counts, detail: state.todo_detail },
+        issues: state.counts,
+        plan: startupPlanSummary(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,
+        history: state.history,
+        next_action: nextActionPayload(state),
+        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: STATUS_STRUCTURED_FIELDS,
+            render,
+            access,
+            empty_state: "fresh: summaries absent; zero issues",
+            capability_startup: startupCompletenessContract({ profileStatus: state.profile_status }),
+            capability_context: capabilityContextPointer(options.capabilityContextRequiredBeforeRendering ?? true),
+            artifact_writes: stateWriterContract(),
+        },
+    };
+}
+/**
+ * The status capability consumes the same bounded decision-brief projection as
+ * bare prime. Keeping the projection here prevents a second status summary
+ * implementation from drifting from the public prime contract.
+ */
+export function buildStatusContextState(state, command = "prime", options = {}) {
+    const projected = briefOrientationPayload(omitInactiveConditionalDefaults(buildOrientationJsonPayload(state, command, { capabilityContextRequiredBeforeRendering: false })), {
+        budgetBytes: options.budgetBytes ?? PRIME_BRIEF_MAX_UTF8_BYTES,
+        degradedMode: options.degradedMode,
+    });
+    // The canonical brief contains compatibility and source metadata useful to
+    // bare-prime consumers. History/source and null bespoke pointers are not
+    // dashboard or routing inputs. Omit only those redundant leaves after
+    // applying the shared brief projection, leaving every field named by the
+    // status instructions and its recovery catalog intact.
+    for (const field of [
+        "app_home",
+        "history",
+        "issues",
+        "source",
+        "orchestration_context",
+        "closeout_context",
+        "evidence_context",
+        "benchmark_context",
+        "execution_context",
+    ]) {
+        delete projected[field];
+    }
+    return projected;
+}
+export function emitPrime(command, payload, format, fieldsArg, out, err, options = {}) {
+    const requested = requestedFields(fieldsArg);
+    // The default bare briefing first omits inactive conditional top-level fields
+    // (v1_migration/docs/objective when default) so startup does not carry
+    // default-only payload, then — for the bare default only — projects the full
+    // payload to a bounded decision brief (Plan Task 3). Explicit `--fields`
+    // selection and `--context` use their governed payloads. Dashboard history is
+    // already projected at collection time so ordinary list detail is not copied
+    // into startup (see default_emission_omission_contract + brief_omission_contract).
+    const conditional = requested.length === 0 && options.bareBrief ? omitInactiveConditionalDefaults(payload) : payload;
+    const effectivePayload = requested.length === 0 && options.bareBrief
+        ? briefOrientationPayload(conditional, { budgetBytes: options.briefBudgetBytes })
+        : conditional;
+    emitIssuesFieldDeprecationWarning(requested, effectivePayload, err);
+    if (requested.length === 0) {
+        if (format === "json" && options.maxUtf8Bytes !== undefined) {
+            const bytes = briefUtf8Bytes(effectivePayload);
+            if (bytes > options.maxUtf8Bytes) {
+                err(`Error: ${command} JSON output is ${bytes} UTF-8 bytes, over the ${options.maxUtf8Bytes}-byte startup budget; use the named recovery commands in the projected output contract.\n`);
+                return 1;
+            }
+        }
+        emitStructured(effectivePayload, 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];
+    }
+    if (format === "json" && options.maxUtf8Bytes !== undefined) {
+        const bytes = briefUtf8Bytes(selected);
+        if (bytes > options.maxUtf8Bytes) {
+            err(`Error: ${command} JSON output is ${bytes} UTF-8 bytes, over the ${options.maxUtf8Bytes}-byte startup budget; use the named recovery commands in the projected output contract.\n`);
+            return 1;
+        }
+    }
+    emitStructured(selected, format, out);
+    return 0;
+}
+export function printOrientationTextBriefing(state, command, out) {
+    const bundle = state.app;
+    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" : "prime orientation dashboard";
+    out(`agentera ${command}\n`);
+    out(`app_home: install_track=${projectInstallTrack(bundle.installKind)} | 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_artifacts=${projectIntegration.pending_artifacts}\n`);
+    if (projectIntegration.recommendation === "upgrade" && projectIntegration.message) {
+        out(`project_integration_message: ${projectIntegration.message}\n`);
+    }
+    out(`shared_skill: status=${String(state.shared_skill.status)} | path=${String(state.shared_skill.path)}\n`);
+    out(`profile: ${profileStatus} | path=${profile}\n`);
+    if (health.exists && health.id) {
+        const worst = health.worst;
+        const worstText = worst ? `${worst[0]}:${worst[1]}` : "none";
+        out(`health: id=${health.id} | artifact=${health.artifact ?? "health"} | grade=${health.grade || "unknown"} | ` +
+            `trajectory=${health.trajectory || "unknown"} | worst=${worstText}\n`);
+    }
+    if (health.degraded_history) {
+        const degraded = health.degraded_history;
+        out(`health: degraded_history | summaries=${String(degraded.summary_count ?? 0)} | returned=${String(degraded.returned_count ?? 0)} | omitted=${String(degraded.omitted_count ?? 0)} | ` +
+            `detail=summary-only | recovery=agentera state health list --limit 20 --format json\n`);
+    }
+    const latestProgress = state.progress.latest;
+    if (latestProgress) {
+        out(`progress: id=${String(latestProgress.id ?? "unknown")} | artifact=${String(latestProgress.artifact ?? "progress")} | ` +
+            `what=${String(latestProgress.what ?? "unknown")}\n`);
+    }
+    if (state.progress.degraded_history) {
+        const degraded = state.progress.degraded_history;
+        out(`progress: degraded_history | summaries=${String(degraded.summary_count ?? 0)} | returned=${String(degraded.returned_count ?? 0)} | omitted=${String(degraded.omitted_count ?? 0)} | ` +
+            `detail=summary-only | recovery=agentera state progress list --limit 20 --format json\n`);
+    }
+    const decisionHistory = state.history.decisions?.degraded_history;
+    if (decisionHistory) {
+        out(`decisions: degraded_history | summaries=${String(decisionHistory.summary_count ?? 0)} | returned=${String(decisionHistory.returned_count ?? 0)} | omitted=${String(decisionHistory.omitted_count ?? 0)} | ` +
+            `detail=summary-only | recovery=agentera state decisions list --limit 20 --format json\n`);
+    }
+    out(`todo: 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.recommended)}\n`);
+    for (const alt of nextAction.alternatives) {
+        out(`- alt: ${formatNextAction(alt)}\n`);
+    }
+    out("source_contract:\n");
+    out(`- fields=${PRIME_STRUCTURED_FIELDS.join(", ")}\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({ profileStatus: state.profile_status });
+    out(`- capability_startup_complete=${String(startup.complete_for_capability_startup).toLowerCase()}\n`);
+    out(`- capability_context: fetch rendering instructions via \`agentera prime --context status --format json\`\n`);
+    out("- artifact_writes: discover via `agentera schema --format json` or `agentera state <artifact> explain --format json`\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`);
+}
+//# sourceMappingURL=orientationOutput.js.map

package/dist/cli/commands/prime/orientationOutput.js.map

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

package/dist/cli/commands/prime/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/commands/prime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/prime/types.ts"],"names":[],"mappings":""}

package/dist/cli/commands/prime/v1Migration.js

@@ -0,0 +1,39 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveInvokedUpdateChannel } from "../../../upgrade/channels.js";
+import { buildUpgradeCommands } from "../../../upgrade/upgradeCommands.js";
+export function isLocalCheckout(root) {
+    return ["skills/agentera/SKILL.md", "registry.json"].every((rel) => fs.existsSync(path.join(root, rel)));
+}
+export 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;
+}
+//# sourceMappingURL=v1Migration.js.map

package/dist/cli/commands/prime/v1Migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1Migration.js","sourceRoot":"","sources":["../../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/prime/v1Migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAI3E,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACjE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAqB,EACrB,IAAoD;IAEpD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,2BAA2B,CAAC;QAC1C,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,oBAAoB,CAAC;YACnB,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;YACtB,WAAW,EAAE,IAAI;YACjB,OAAO;YACP,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,UAAU,EAAE,IAAI;SACjB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,OAAO,GAAuB;QAClC,QAAQ;QACR,cAAc,EAAE,WAAW;QAC3B,eAAe,EAAE,IAAI,EAAE,aAAa,IAAI,IAAI;QAC5C,aAAa,EAAE,IAAI,EAAE,YAAY,IAAI,IAAI;QACzC,qBAAqB,EAAE,QAAQ;QAC/B,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC;IACF,IAAI,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,qBAAqB,GAAG,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC;QAC5D,OAAO,CAAC,mBAAmB,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}