agentera 3.0.0-dev.6 → 3.0.0-dev.8

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

@@ -0,0 +1,140 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { buildDoctorStatus } from "../../../upgrade/doctor.js";
+import { doctorRoots, loadSuiteVersion, resolveDoctorInstallRoot, resolveSourceRootStrict } from "../../../upgrade/appModel.js";
+import { isNpxBundleRoot } from "../../../core/sourceRoot.js";
+import { resolveInvokedUpdateChannel } from "../../../upgrade/channels.js";
+import { classifyResolvedRoot } from "../../../state/installRoot.js";
+import { resolveLatestOnChannel } from "../../../upgrade/versionResolution.js";
+import { resolveNpxPlatformStatus } from "../../../upgrade/npxPlatformStatus.js";
+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, installRoot, sourceRoot) {
+    const candidates = [];
+    if (env.AGENTERA_VISIBLE_SKILL_ROOT)
+        candidates.push(env.AGENTERA_VISIBLE_SKILL_ROOT);
+    candidates.push(path.join(installRoot, "skills", "agentera"));
+    candidates.push(path.join(sourceRoot, "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 statusExpectedVersion(opts, sourceRoot, home, env, installRoot, channel) {
+    if (opts.expectedVersion)
+        return [opts.expectedVersion, "--expected-version"];
+    if (env.AGENTERA_EXPECTED_VERSION)
+        return [env.AGENTERA_EXPECTED_VERSION, "AGENTERA_EXPECTED_VERSION"];
+    if (channel.channel === "stable") {
+        const roots = doctorRoots(installRoot);
+        const classification = classifyResolvedRoot(roots.activeBundleRoot, { source: "explicit" });
+        if (classification.current_version) {
+            return [classification.current_version, "installed app registry"];
+        }
+        return [resolveLatestOnChannel(channel, sourceRoot), "stable channel catalog"];
+    }
+    const sourceVersion = loadSuiteVersion(sourceRoot);
+    const [visibleVersion, visibleSource] = visibleSkillVersion(home, env, installRoot, sourceRoot);
+    if (visibleVersion && versionKeyGe(versionKey(visibleVersion), versionKey(sourceVersion))) {
+        return [visibleVersion, visibleSource || "visible skill"];
+    }
+    return [sourceVersion, "source registry"];
+}
+export function statusBundleStatus(opts) {
+    const env = opts.env ?? process.env;
+    const home = opts.home ? opts.home : os.homedir();
+    const sourceRoot = resolveSourceRootStrict(env);
+    const channel = resolveInvokedUpdateChannel({ env, home, sourceRoot });
+    const [installRoot, rootSource] = resolveDoctorInstallRoot(opts.installRoot ?? null, {
+        home,
+        env,
+        sourceRoot,
+    });
+    const [expected, expectedSource] = statusExpectedVersion(opts, sourceRoot, home, env, installRoot, channel);
+    const status = buildDoctorStatus(installRoot, {
+        rootSource,
+        sourceRoot,
+        home,
+        project: process.cwd(),
+        expectedVersion: expected,
+        expectedCommands: ["prime"],
+        channel: channel.channel,
+        env,
+    });
+    status.expectedVersionSource = expectedSource;
+    if (isNpxBundleRoot(sourceRoot)) {
+        const { platformRoot, platformStatus } = resolveNpxPlatformStatus({
+            home,
+            sourceRoot,
+            project: process.cwd(),
+            expectedVersion: expected,
+            expectedCommands: ["prime"],
+            env,
+        });
+        status.platformAppHome = {
+            path: platformRoot,
+            status: platformStatus.status,
+            rootStatus: platformStatus.rootStatus,
+            dryRunCommand: platformStatus.dryRunCommand,
+            applyCommand: platformStatus.applyCommand,
+        };
+        status.cliApp = {
+            path: sourceRoot,
+            status: status.status,
+            rootStatus: status.rootStatus,
+        };
+    }
+    return status;
+}
+//# sourceMappingURL=bundleStatus.js.map

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

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

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

@@ -0,0 +1,156 @@
+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 { resolveSourceRootStrict } from "../../../upgrade/appModel.js";
+import { discoverSchemasDir, loadSchemas } from "../../appContext.js";
+import { activeObjectiveSummary, checkProfileStaleness, decisionFollowUp, decisionReviewAttention, docsSummary, healthSummary, issueCounts, loadTodoItems, parseProfileHeaderDates, planSummary, progressSummary, registryArtifactPath, selectStatusReadiness, statePresence, } from "../../orientation.js";
+import { buildOrientationAttention } from "../../orientation/attention.js";
+import { corpusCoverageSummary } from "../../orientation/corpusCoverage.js";
+import { statusBundleStatus } from "./bundleStatus.js";
+import { v1MigrationSummary } from "./v1Migration.js";
+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 = statusBundleStatus(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, 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 v1Artifacts = detectV1ArtifactPairs(process.cwd());
+    const v1Migration = v1MigrationSummary(v1Artifacts, { sourceRoot, home, env });
+    const plan = planSummary(schemas);
+    const docs = docsSummary(schemas, { profileStatus });
+    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 corpusCoverage = corpusCoverageSummary(env, process.platform);
+    const project = process.cwd();
+    const projectIntegration = summarizeProjectIntegration({
+        project,
+        sourceRoot,
+        home,
+        env,
+        installRoot: String(bundle.appHome),
+        bundleStatus: String(bundle.status),
+        crossMajorBoundaryDetected: bundle.crossMajorBoundaryDetected ?? false,
+    });
+    const readiness = selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext);
+    const nextAction = projectIntegration.recommendation === "upgrade"
+        ? withRecommended(readiness, {
+            object: projectIntegration.pending_artifacts > 0
+                ? "Upgrade Agentera artifacts"
+                : projectIntegration.pending_runtime > 0
+                    ? "Upgrade Agentera runtime wiring"
+                    : "Upgrade Agentera",
+            capability: "status",
+            reason: projectIntegration.message,
+            phase: "build",
+        })
+        : projectIntegration.major_boundary_block
+            ? withRecommended(readiness, {
+                object: "Await v3 successor announcement",
+                capability: "status",
+                reason: projectIntegration.major_boundary_block,
+                phase: "audit",
+            })
+            : readiness;
+    const attention = buildOrientationAttention({
+        schemas_dir: schemasDir,
+        schemas,
+        app: bundle,
+        mode,
+        profile_dict: profileDict,
+        profile_status: profileStatus,
+        profile,
+        v1_migration: v1Migration,
+        project_integration: projectIntegration,
+        plan,
+        docs,
+        progress,
+        health,
+        objective,
+        state_presence: presence,
+        corpus_coverage: corpusCoverage,
+        todo_items: todoItems,
+        counts,
+        decision_attention: decisionAttention,
+        next_action: nextAction,
+        attention: [],
+    });
+    return {
+        schemas_dir: schemasDir,
+        schemas,
+        app: bundle,
+        mode,
+        profile_dict: profileDict,
+        profile_status: profileStatus,
+        profile,
+        v1_migration: v1Migration,
+        project_integration: projectIntegration,
+        plan,
+        docs,
+        progress,
+        health,
+        objective,
+        state_presence: presence,
+        corpus_coverage: corpusCoverage,
+        todo_items: todoItems,
+        counts,
+        decision_attention: decisionAttention,
+        next_action: nextAction,
+        attention,
+    };
+}
+/** 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. */
+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":["../../../../src/cli/commands/prime/collectOrientationState.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,210 @@
+import { publicDoctorStatus } from "../../../upgrade/doctor.js";
+import { projectInstallTrack } from "../../../upgrade/compatibility.js";
+import { formatNextAction } from "../../orientation.js";
+import { requestedFields, REQUIRED_SPARSE_CONTEXT_FIELDS } from "../../stateQuery.js";
+import { emitStructured } from "../../structured.js";
+import { startupCompletenessContract } from "../../startupCompletenessContract.js";
+export { startupCompletenessContract } from "../../startupCompletenessContract.js";
+/** 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 = [
+    "command", "status", "app_home", "app", "mode", "profile", "v1_migration", "health",
+    "todo", "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",
+];
+/** Deprecated JSON field selectors kept for pre-3.0.0 consumers; not listed in source_contract.fields. */
+const DEPRECATED_PRIME_FIELD_ALIASES = ["issues"];
+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";
+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,
+    };
+}
+export function buildOrientationJsonPayload(state, command) {
+    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,
+        project_integration: state.project_integration,
+        health: state.health,
+        todo: state.counts,
+        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: 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 mode with missing artifact summaries and zero issue counts",
+            capability_startup: startupCompletenessContract({ profileStatus: state.profile_status }),
+            capability_context: null,
+        },
+    };
+}
+function availablePrimeFields(command) {
+    const base = command === "prime" ? [...STATUS_STRUCTURED_FIELDS, "capability_context"] : STATUS_STRUCTURED_FIELDS;
+    return [...base, ...DEPRECATED_PRIME_FIELD_ALIASES];
+}
+export function emitPrime(command, payload, format, fieldsArg, out, err) {
+    const requested = requestedFields(fieldsArg);
+    emitIssuesFieldDeprecationWarning(requested, payload, err);
+    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;
+}
+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_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(`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=app_home,mode,profile,v1_migration,project_integration,health,todo,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({ profileStatus: state.profile_status });
+    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`);
+}
+//# sourceMappingURL=orientationOutput.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orientationOutput.js","sourceRoot":"","sources":["../../../../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":["../../../../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":["../../../../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"}