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

package/dist/cli/migrationRequired.js

@@ -0,0 +1,87 @@
+import fs from "node:fs";
+import path from "node:path";
+import { emitStructured } from "./structured.js";
+import { detectStateMode } from "../state/stateMode.js";
+import { fullEntityUpgradeCommand } from "../upgrade/upgradeCommands.js";
+function value(argv, flag) {
+    const equals = argv.find((arg) => typeof arg === "string" && arg.startsWith(`${flag}=`));
+    if (equals)
+        return equals.slice(flag.length + 1);
+    const index = argv.indexOf(flag);
+    return index >= 0 ? argv[index + 1] : undefined;
+}
+export function requestedMigrationFailureFormat(argv) {
+    const format = value(argv, "--format");
+    return format === "json" || format === "yaml" ? format : "text";
+}
+/** Marker-absent projects expose only the forward upgrade and static discovery. */
+export function requiresCompletedEntityCutover(argv) {
+    const [command, subcommand, verb] = argv;
+    if (["--version", "version", "app-home", "doctor", "schema", "route", "upgrade"].includes(command))
+        return false;
+    if (command === "prime" && argv.includes("--guidance"))
+        return false;
+    if (command === "query")
+        return !argv.includes("--list-artifacts");
+    if (command === "state" && subcommand === "query" && argv.includes("--list-artifacts"))
+        return false;
+    if (command === "state" && subcommand === "migrate" && verb === "entities" && argv.includes("--dry-run"))
+        return false;
+    if (command === "state" && verb === "explain")
+        return false;
+    return true;
+}
+export function migrationProject(argv, fallback = process.cwd()) {
+    const explicit = value(argv, "--project");
+    if (explicit)
+        return path.resolve(explicit);
+    let candidate = path.resolve(fallback);
+    while (true) {
+        if (fs.existsSync(path.join(candidate, ".agentera", "state-mode.yaml")))
+            return candidate;
+        const parent = path.dirname(candidate);
+        if (parent === candidate)
+            return path.resolve(fallback);
+        candidate = parent;
+    }
+}
+/** Read-only cutover gate. It only inspects the durable marker and emits a failure. */
+export function enforceCompletedEntityCutover(projectRoot, format, io = {}) {
+    const project = path.resolve(projectRoot);
+    let mode;
+    try {
+        mode = detectStateMode(project);
+    }
+    catch (error) {
+        const recovery = "Restore the exact durable migration marker, then run agentera check validate state --format json.";
+        const envelope = {
+            schemaVersion: "agentera.stateFailure.v1",
+            status: "fail",
+            error: { class: "invalid_state_marker", message: error.message, project, recovery },
+        };
+        if (format === "json" || format === "yaml")
+            emitStructured(envelope, format, io.out ?? ((text) => process.stdout.write(text)));
+        else
+            (io.err ?? ((text) => process.stderr.write(text)))(`Error: ${envelope.error.message}\nRecovery: ${recovery}\n`);
+        return 1;
+    }
+    if (mode === "entities")
+        return null;
+    const recovery = fullEntityUpgradeCommand(project);
+    const envelope = {
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: "migration_required",
+            message: "This command requires the completed entity-state cutover; legacy aggregates remain migration input only.",
+            project,
+            recovery,
+        },
+    };
+    if (format === "json" || format === "yaml")
+        emitStructured(envelope, format, io.out ?? ((text) => process.stdout.write(text)));
+    else
+        (io.err ?? ((text) => process.stderr.write(text)))(`Error: ${envelope.error.message}\nRecovery: ${recovery}\n`);
+    return 1;
+}
+//# sourceMappingURL=migrationRequired.js.map

package/dist/cli/migrationRequired.js.map

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

package/dist/cli/orientation/attention.js

@@ -0,0 +1,67 @@
+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";
+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 hasAppIntegration = (projectIntegration.phases?.app.counts.total ?? 0) > 0;
+    const includeIntegrationAttention = Boolean(integrationAttention && hasAppIntegration);
+    if (includeIntegrationAttention && integrationAttention) {
+        attention.push(integrationAttention);
+    }
+    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 auditId = health.id ?? "unknown";
+        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 health audit ${auditId}; ` +
+            `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":["../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/orientation/attention.ts"],"names":[],"mappings":"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"}

package/dist/cli/orientation/corpusCoverage.js

@@ -0,0 +1,103 @@
+import fs from "node:fs";
+import { corpusTooLargeReason } from "../../analytics/usageStats.js";
+import { statsCorpusPath } from "../commands/report.js";
+import { tiersDirForCorpusPath, assessTiers, readBoundedMetadata, } from "../../analytics/extractCorpus/index.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);
+    const tiersDir = tiersDirForCorpusPath(corpusPath);
+    const assessment = assessTiers(tiersDir, corpusPath);
+    // Bounded tier coverage: when tiers are published, the manifest's coverage
+    // envelope truthfully reports the audit's available/selected/skipped runtimes
+    // without reading full evidence. The signal tier (bounded) remains usable even
+    // when a full-evidence shard is oversized, per the authority contract.
+    if (assessment.state !== "legacy" && assessment.state !== "missing") {
+        const meta = readBoundedMetadata(tiersDir);
+        const envelope = meta.corpusMetadata?.coverage_envelope;
+        if (meta.signal && envelope) {
+            return {
+                path: corpusPath,
+                tier_path: tiersDir,
+                status: "loaded",
+                tier_state: assessment.state,
+                available_runtimes: [...envelope.available_runtimes],
+                selected_runtimes: [...envelope.selected_runtimes],
+                available_but_not_selected: envelope.available_but_not_selected.map((g) => ({
+                    runtime: g.runtime,
+                    reason: g.reason,
+                    ...(typeof g.store_path === "string" ? { store_path: g.store_path } : {}),
+                })),
+            };
+        }
+        if (assessment.state === "oversized")
+            return emptyCoverageSummary(corpusPath, "too_large");
+        if (assessment.state === "corrupt")
+            return emptyCoverageSummary(corpusPath, "unreadable");
+    }
+    // Legacy monolithic envelope: small state preserved for compatibility.
+    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",
+        tier_state: "legacy",
+        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":["../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/orientation/corpusCoverage.ts"],"names":[],"mappings":"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"}