agentera 3.0.0-dev.7 → 3.0.0-dev.72

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

@@ -3,69 +3,91 @@ 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 { selectStatusReadiness, statePresence, } from "../../orientation.js";
 import { buildOrientationAttention } from "../../orientation/attention.js";
 import { corpusCoverageSummary } from "../../orientation/corpusCoverage.js";
-import { statusBundleStatus } from "./bundleStatus.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";
+import { acquireProfile } from "../../profileAcquisition.js";
+import { fullEntityUpgradeCommand, fullEntityUpgradePreviewCommand } from "../../../upgrade/upgradeCommands.js";
+import { classifyEntityCutoverProject } from "../../../state/entityMigrationPreview.js";
+import { preCutoverCommand } from "../../preCutoverCommand.js";
+const EMPTY_SCHEMAS = Object.freeze({});
+function stateCutover(project, sourceRoot) {
+    try {
+        const projectState = classifyEntityCutoverProject(project, sourceRoot);
+        if (projectState === "v3") {
+            return { status: "complete", project_state: "v3", recovery_command: null };
+        }
+        if (projectState === "fresh_uninitialized") {
+            return { status: "fresh_uninitialized", project_state: projectState, recovery_command: null };
+        }
+        return {
+            status: "required",
+            project_state: projectState,
+            recovery_command: projectState === "legacy" ? fullEntityUpgradeCommand(project) : fullEntityUpgradePreviewCommand(project),
+        };
+    }
+    catch {
+        return { status: "invalid_lifecycle", project_state: "invalid_lifecycle", recovery_command: preCutoverCommand("check validate state --format json") };
+    }
+}
 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);
+    const project = path.resolve(opts.projectRoot ?? 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(process.cwd(), ".agentera")).some((f) => f.endsWith(".yaml"));
+        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 acquiredProfile = acquireProfile(schemasDir, env);
+    const profile = acquiredProfile.profilePath ?? "";
+    const profileStatus = acquiredProfile.validity.status;
+    const profileDict = {
+        status: profileStatus,
+        validity: acquiredProfile.validity,
+        freshness: acquiredProfile.freshness,
+    };
+    if (acquiredProfile.validity.status === "valid" && acquiredProfile.freshness.state !== "unknown") {
+        profileDict.days_since_generated = acquiredProfile.freshness.days_since_generated ?? undefined;
+        profileDict.stale = acquiredProfile.freshness.state === "stale";
+        profileDict.stale_threshold_days = acquiredProfile.freshness.stale_threshold_days;
+        if (acquiredProfile.freshness.generated_date)
+            profileDict.generated_date = acquiredProfile.freshness.generated_date;
+        if (acquiredProfile.freshness.validated_date)
+            profileDict.validated_date = acquiredProfile.freshness.validated_date;
     }
-    const v1Artifacts = detectV1ArtifactPairs(process.cwd());
+    const boundedSignals = profileSignalsStatus(env, process.platform);
+    const { tiers_dir: _tiersDir, signal_path: _signalPath, ...publicBoundedSignals } = boundedSignals;
+    profileDict.bounded_signals = publicBoundedSignals;
+    const v1Artifacts = detectV1ArtifactPairs(project);
     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 entity = collectEntityOrientation(project, sourceRoot);
+    const cutover = stateCutover(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 = loadTodoItems(schemas);
-    const counts = issueCounts(todoItems);
-    const decision = decisionFollowUp(schemas);
-    const decisionAttention = decisionReviewAttention(schemas);
+    const todoItems = entity.todoItems;
+    const counts = entity.todoCounts;
+    const decision = entity.decision;
+    const decisionAttention = entity.decisionAttention;
     const corpusCoverage = corpusCoverageSummary(env, process.platform);
-    const project = process.cwd();
+    const sharedSkill = diagnoseCanonicalSkill(home);
     const projectIntegration = summarizeProjectIntegration({
         project,
         sourceRoot,
@@ -73,29 +95,33 @@ export function collectOrientationState(opts) {
         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 = projectIntegration.recommendation === "upgrade"
+    const readiness = selectStatusReadiness(plan, health, objective, todoItems, decision, savedContext, entity.todoReadiness);
+    const reconciliationReadiness = entity.todoReconciliation?.status === "action_required"
         ? withRecommended(readiness, {
-            object: projectIntegration.pending_artifacts > 0
-                ? "Upgrade Agentera artifacts"
-                : projectIntegration.pending_runtime > 0
-                    ? "Upgrade Agentera runtime wiring"
-                    : "Upgrade Agentera",
+            object: entity.todoReconciliation.state === "unsafe_inactive" ? "Correct unsafe TODO ownership" : entity.todoReconciliation.state === "inactive" ? "Activate TODO reconciliation" : "Repair TODO reconciliation",
+            capability: "build",
+            reason: entity.todoReconciliation.recovery_command,
+            phase: entity.todoReconciliation.state === "unsafe_inactive" ? "build" : entity.todoReconciliation.state === "invalid_lifecycle" ? "audit" : "build",
+        })
+        : readiness;
+    const nextAction = cutover.status === "required" || cutover.status === "invalid_lifecycle"
+        ? withRecommended(readiness, {
+            object: "Complete Agentera entity-state cutover",
             capability: "status",
-            reason: projectIntegration.message,
+            reason: `Status startup is blocked until entity-state cutover completes. Exact recovery: ${cutover.recovery_command}`,
             phase: "build",
         })
-        : projectIntegration.major_boundary_block
-            ? withRecommended(readiness, {
-                object: "Await v3 successor announcement",
-                capability: "status",
-                reason: projectIntegration.major_boundary_block,
-                phase: "audit",
-            })
-            : readiness;
+        : selectProjectIntegrationNextAction(reconciliationReadiness, projectIntegration);
     const attention = buildOrientationAttention({
+        project_root: project,
         schemas_dir: schemasDir,
         schemas,
         app: bundle,
@@ -105,6 +131,8 @@ export function collectOrientationState(opts) {
         profile,
         v1_migration: v1Migration,
         project_integration: projectIntegration,
+        state_cutover: cutover,
+        shared_skill: sharedSkill,
         plan,
         docs,
         progress,
@@ -113,12 +141,18 @@ export function collectOrientationState(opts) {
         state_presence: presence,
         corpus_coverage: corpusCoverage,
         todo_items: todoItems,
+        todo_detail: entity.todoDetail,
+        todo_reconciliation: entity.todoReconciliation,
         counts,
         decision_attention: decisionAttention,
+        glossary_caveat_attention: entity.glossaryCaveatAttention,
+        glossary_caveat_attention_policy: entity.glossaryCaveatAttentionPolicy,
         next_action: nextAction,
         attention: [],
+        history,
     });
     return {
+        project_root: project,
         schemas_dir: schemasDir,
         schemas,
         app: bundle,
@@ -128,6 +162,8 @@ export function collectOrientationState(opts) {
         profile,
         v1_migration: v1Migration,
         project_integration: projectIntegration,
+        state_cutover: cutover,
+        shared_skill: sharedSkill,
         plan,
         docs,
         progress,
@@ -136,10 +172,15 @@ export function collectOrientationState(opts) {
         state_presence: presence,
         corpus_coverage: corpusCoverage,
         todo_items: todoItems,
+        todo_detail: entity.todoDetail,
+        todo_reconciliation: entity.todoReconciliation,
         counts,
         decision_attention: decisionAttention,
+        glossary_caveat_attention: entity.glossaryCaveatAttention,
+        glossary_caveat_attention_policy: entity.glossaryCaveatAttentionPolicy,
         next_action: nextAction,
         attention,
+        history,
     };
 }
 /** Promote `newRecommended` to position 1, demoting the prior recommendation
@@ -147,10 +188,32 @@ export function collectOrientationState(opts) {
  *  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