agentera 3.0.0-dev.2 → 3.0.0-dev.21

package/dist/cli/orientation/attention.js

@@ -0,0 +1,163 @@
+import { projectIntegrationAttention } from "../../upgrade/projectIntegration.js";
+import { isV2ManagedInstallAtAppHome } from "../../upgrade/coexistenceProbe.js";
+import { corpusCoverageAttention } from "./corpusCoverage.js";
+import { firstPresent } from "../stateQuery.js";
+import { TODO_SEVERITY_ORDER } from "../todoSeverity.js";
+const MAX_LIFECYCLE_ATTENTION_ROWS = 2;
+const MAX_LIFECYCLE_RUNTIME_NAMES = 3;
+const MAX_MANUAL_PROCEDURE_WORDS = 12;
+const DOCTOR_DIAGNOSTICS_COMMAND = "agentera doctor --format json";
+function lifecycleRuntimeNames(snapshot, actions) {
+    const namesById = new Map(snapshot.runtimes.map((runtime) => [runtime.runtimeId, runtime.displayName]));
+    const runtimeIds = [...new Set(actions.flatMap((action) => action.runtimeIds))];
+    const names = runtimeIds.map((runtimeId) => namesById.get(runtimeId) ?? runtimeId);
+    const visible = names.slice(0, MAX_LIFECYCLE_RUNTIME_NAMES);
+    const omitted = names.length - visible.length;
+    return omitted > 0 ? `${visible.join(", ")}, +${omitted} more runtimes` : visible.join(", ");
+}
+function actionClassSummary(actions) {
+    const counts = new Map();
+    for (const action of actions)
+        counts.set(action.actionClass, (counts.get(action.actionClass) ?? 0) + 1);
+    return [...counts.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([actionClass, count]) => `${count} ${actionClass}`)
+        .join(", ");
+}
+function boundProcedure(text) {
+    const words = text.trim().split(/\s+/).filter(Boolean);
+    if (words.length <= MAX_MANUAL_PROCEDURE_WORDS)
+        return words.join(" ");
+    return `${words.slice(0, MAX_MANUAL_PROCEDURE_WORDS - 1).join(" ")}…`;
+}
+function firstManualProcedure(actions) {
+    const procedures = [
+        ...new Set(actions
+            .filter((action) => action.actionClass === "manual_verification")
+            .sort((left, right) => {
+            const leftHasCommand = left.manual?.command !== null && left.manual?.command !== undefined;
+            const rightHasCommand = right.manual?.command !== null && right.manual?.command !== undefined;
+            return Number(rightHasCommand) - Number(leftHasCommand);
+        })
+            .map((action) => {
+            const manual = action.manual;
+            if (!manual)
+                return boundProcedure(action.reason);
+            const command = Array.isArray(manual.command) ? manual.command.join(" ") : manual.command;
+            const instruction = boundProcedure(manual.instruction);
+            return command ? `${command}: ${instruction}` : instruction;
+        })
+            .filter((procedure) => procedure.trim().length > 0)),
+    ];
+    return procedures[0] ?? null;
+}
+function combinedLifecycleAttentionRow(state, snapshot, repairable, blockers) {
+    const actions = [...repairable, ...blockers];
+    const classes = [
+        ...(repairable.length > 0 ? ["repairable_owned"] : []),
+        ...[...new Set(blockers.map((action) => action.actionClass))].sort(),
+    ].join("+");
+    const preview = repairable.length > 0 && state.project_integration.dry_run_command
+        ? ` | preview=\`${state.project_integration.dry_run_command}\``
+        : "";
+    const procedure = firstManualProcedure(blockers);
+    const procedureText = procedure ? ` | procedure=${procedure}` : "";
+    const doctorText = blockers.some((action) => action.actionClass === "unobservable_gap")
+        ? ` | doctor=\`${DOCTOR_DIAGNOSTICS_COMMAND}\``
+        : "";
+    return (`${blockers.length > 0 ? "degraded" : "normal"}: lifecycle action_class=${classes} | ` +
+        `runtimes=${lifecycleRuntimeNames(snapshot, actions)} | actions=${actionClassSummary(actions)}` +
+        `${preview}${procedureText}${doctorText}`);
+}
+function lifecycleAttentionRows(state, maxRows = MAX_LIFECYCLE_ATTENTION_ROWS) {
+    const snapshot = state.runtime_lifecycle_snapshot;
+    if (!snapshot || snapshot.actions.length === 0)
+        return [];
+    const repairable = snapshot.actions.filter((action) => action.actionClass === "repairable_owned");
+    const blockers = snapshot.actions.filter((action) => action.actionClass !== "repairable_owned");
+    const rows = [];
+    if (maxRows === 1) {
+        return [combinedLifecycleAttentionRow(state, snapshot, repairable, blockers)];
+    }
+    if (repairable.length > 0) {
+        const preview = state.project_integration.dry_run_command;
+        rows.push(`normal: lifecycle action_class=repairable_owned | runtimes=${lifecycleRuntimeNames(snapshot, repairable)} | ` +
+            `actions=${repairable.length} | preview=${preview ? `\`${preview}\`` : "unavailable"}`);
+    }
+    if (blockers.length > 0 && rows.length < MAX_LIFECYCLE_ATTENTION_ROWS) {
+        const classes = [...new Set(blockers.map((action) => action.actionClass))].sort().join("+");
+        const procedure = firstManualProcedure(blockers);
+        const procedureText = procedure ? ` | procedure=${procedure}` : "";
+        const doctorText = blockers.some((action) => action.actionClass === "unobservable_gap")
+            ? ` | doctor=\`${DOCTOR_DIAGNOSTICS_COMMAND}\``
+            : "";
+        rows.push(`degraded: lifecycle action_class=${classes} | runtimes=${lifecycleRuntimeNames(snapshot, blockers)} | ` +
+            `actions=${actionClassSummary(blockers)}${procedureText}${doctorText}`);
+    }
+    return rows.slice(0, maxRows);
+}
+export function buildOrientationAttention(state) {
+    const { profile_status: profileStatus, profile, profile_dict: profileDict, v1_migration: v1Migration, project_integration: projectIntegration, health, plan, decision_attention: decisionAttention, corpus_coverage: corpusCoverage, todo_items: todoItems, } = state;
+    const attention = [];
+    if (isV2ManagedInstallAtAppHome(state.app.appHome)) {
+        attention.push(`normal: v2/v3 coexistence at ${state.app.appHome}; pick one line: complete v3 migration, uninstall v3, or stay on v2`);
+    }
+    const skillDivergenceSignals = (state.app.signals ?? []).filter((s) => s.kind === "skill_root_divergence");
+    for (const signal of skillDivergenceSignals) {
+        attention.push(`degraded: skill-root divergence — ${signal.message ?? "a recognized skill root is below expected"}; run \`npx -y agentera@next upgrade --dry-run --channel development\` to preview repair (D78)`);
+    }
+    const integrationAttention = projectIntegrationAttention(projectIntegration);
+    const lifecycleActions = state.runtime_lifecycle_snapshot?.actions ?? [];
+    const hasLifecycleActions = lifecycleActions.length > 0;
+    const hasAppIntegration = (projectIntegration.phases?.app.counts.total ?? 0) > 0;
+    const includeIntegrationAttention = Boolean(integrationAttention && (!hasLifecycleActions || hasAppIntegration));
+    if (includeIntegrationAttention && integrationAttention) {
+        attention.push(integrationAttention);
+    }
+    attention.push(...lifecycleAttentionRows(state, includeIntegrationAttention ? 1 : MAX_LIFECYCLE_ATTENTION_ROWS));
+    const coverageAttention = corpusCoverageAttention(corpusCoverage);
+    if (coverageAttention) {
+        attention.push(coverageAttention);
+    }
+    if (v1Migration.detected && projectIntegration.recommendation !== "upgrade") {
+        attention.push(`degraded: v1 artifacts detected; preview \`${v1Migration.dry_run_command}\`; files=${v1Migration.affected_files.join(", ")}`);
+    }
+    if (profileStatus === "not found") {
+        attention.push(`degraded: PROFILE.md not found at ${profile}; suggest running profile to generate PROFILE.md`);
+    }
+    else if (profileDict.stale) {
+        const daysSince = profileDict.days_since_generated ?? "?";
+        const staleDays = profileDict.stale_threshold_days ?? "?";
+        attention.push(`normal: profile stale (${daysSince} days since last refresh; ` +
+            `threshold=${staleDays}); suggest running profile 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: 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 audit`);
+    }
+    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 attention;
+}
+//# sourceMappingURL=attention.js.map

package/dist/cli/orientation/attention.js.map

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

package/dist/cli/orientation/corpusCoverage.js

@@ -0,0 +1,71 @@
+import fs from "node:fs";
+import { corpusTooLargeReason } from "../../analytics/usageStats.js";
+import { statsCorpusPath } from "../commands/report.js";
+function emptyCoverageSummary(path, status) {
+    return {
+        path,
+        status,
+        available_runtimes: [],
+        selected_runtimes: [],
+        available_but_not_selected: [],
+    };
+}
+function parseCoverageGap(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const item = value;
+    const runtime = item.runtime;
+    const reason = item.reason;
+    if (typeof runtime !== "string" || typeof reason !== "string")
+        return null;
+    const gap = { runtime, reason };
+    if (typeof item.store_path === "string")
+        gap.store_path = item.store_path;
+    return gap;
+}
+export function corpusCoverageSummary(env = process.env, platform = process.platform) {
+    const corpusPath = statsCorpusPath(env, platform);
+    if (!fs.existsSync(corpusPath))
+        return emptyCoverageSummary(corpusPath, "missing");
+    const tooLarge = corpusTooLargeReason(corpusPath);
+    if (tooLarge)
+        return emptyCoverageSummary(corpusPath, "too_large");
+    let data;
+    try {
+        data = JSON.parse(fs.readFileSync(corpusPath, "utf8"));
+    }
+    catch {
+        return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    const metadata = data && typeof data === "object" && !Array.isArray(data) && "metadata" in data
+        ? data.metadata
+        : null;
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+        return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    const md = metadata;
+    const availableRuntimes = Array.isArray(md.available_runtimes)
+        ? md.available_runtimes.filter((item) => typeof item === "string")
+        : [];
+    const selectedRuntimes = Array.isArray(md.selected_runtimes)
+        ? md.selected_runtimes.filter((item) => typeof item === "string")
+        : [];
+    const skipped = Array.isArray(md.available_but_not_selected)
+        ? md.available_but_not_selected.map(parseCoverageGap).filter((item) => item !== null)
+        : [];
+    return {
+        path: corpusPath,
+        status: "loaded",
+        available_runtimes: availableRuntimes,
+        selected_runtimes: selectedRuntimes,
+        available_but_not_selected: skipped,
+    };
+}
+export function corpusCoverageAttention(summary) {
+    if (summary.available_but_not_selected.length === 0)
+        return null;
+    const skipped = summary.available_but_not_selected.map((item) => `${item.runtime} (${item.reason})`).join(", ");
+    return (`flagged: corpus coverage loss (EX2): available runtimes skipped (${skipped}); ` +
+        "suggest running profile stats refresh without --no-* flags");
+}
+//# sourceMappingURL=corpusCoverage.js.map

package/dist/cli/orientation/corpusCoverage.js.map

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