agentera 0.0.0 → 3.0.0-dev.0

package/dist/upgrade/upgradeOrchestrator.js

@@ -0,0 +1,280 @@
+import os from "node:os";
+import { expanduser, resolvePath } from "../core/paths.js";
+import { resolveDoctorInstallRoot, resolveSourceRootStrict } from "./appModel.js";
+import { MAJOR_BOUNDARY_ITEM_TAG, STATUS_APPLIED, STATUS_MANUAL_REVIEW_NEEDED, STATUS_NO_CHANGES_NEEDED, STATUS_READY_TO_APPLY, UPGRADE_PREVIEW_SCHEMA, classifyInstall, crossMajorBoundaryApplies, previewCrossMajorGuard, shouldIncludeCrossMajorPlanItems, } from "./compatibility.js";
+import { resolveUpdateChannel } from "./channels.js";
+import { buildUpgradeCommands } from "./upgradeCommands.js";
+import { MIGRATION_STATUSES, applyMigrationPhases, dryRunMigration, } from "./migrateArtifactsV2ToV3.js";
+const DEFAULT_PHASES = ["detect", "artifacts", "runtime", "cleanup"];
+const MIGRATION_ONLY_PHASES = ["artifacts", "runtime", "cleanup"];
+function emptySummary() {
+    return { pending: 0, applied: 0, noop: 0, blocked: 0, failed: 0, skipped: 0 };
+}
+function aggregateSummary(phases) {
+    const summary = emptySummary();
+    for (const phase of phases) {
+        for (const status of MIGRATION_STATUSES) {
+            summary[status] += phase.summary[status];
+        }
+    }
+    return summary;
+}
+function workflowStatus(summary) {
+    if (summary.blocked > 0)
+        return "blocked";
+    if (summary.failed > 0)
+        return "failed";
+    if (summary.pending > 0)
+        return "pending";
+    if (summary.applied > 0)
+        return "applied";
+    if (summary.skipped > 0 && summary.noop === 0 && summary.applied === 0)
+        return "skipped";
+    return "noop";
+}
+function lifecycleStatusFromWorkflow(workflow, mode) {
+    switch (workflow) {
+        case "pending":
+            return STATUS_READY_TO_APPLY;
+        case "applied":
+            return STATUS_APPLIED;
+        case "noop":
+        case "skipped":
+            return STATUS_NO_CHANGES_NEEDED;
+        case "blocked":
+        case "failed":
+            return STATUS_MANUAL_REVIEW_NEEDED;
+        default:
+            return mode === "apply" ? STATUS_APPLIED : STATUS_NO_CHANGES_NEEDED;
+    }
+}
+function selectedPhases(only) {
+    if (!only || only.length === 0) {
+        return new Set(DEFAULT_PHASES);
+    }
+    const selected = new Set(["detect"]);
+    for (const name of only) {
+        if (MIGRATION_ONLY_PHASES.includes(name)) {
+            selected.add(name);
+        }
+    }
+    return selected;
+}
+function summarizeOrchestratorPhase(name, items, message = "") {
+    const summary = emptySummary();
+    for (const item of items) {
+        summary[item.status] += 1;
+    }
+    let status;
+    if (summary.blocked > 0)
+        status = "blocked";
+    else if (summary.failed > 0)
+        status = "failed";
+    else if (summary.pending > 0)
+        status = "pending";
+    else if (summary.applied > 0)
+        status = "applied";
+    else if (summary.skipped > 0 && summary.noop === 0 && summary.applied === 0)
+        status = "skipped";
+    else
+        status = "noop";
+    return { name, status, summary, items, message };
+}
+function buildDetectPhase(install, crossMajorBoundary, explicitMajorOptIn, channel) {
+    const items = [
+        {
+            status: "noop",
+            action: "detect-install",
+            message: `detected ${install.kind.replace(/_/g, " ")} layout`,
+        },
+    ];
+    if (crossMajorBoundary && !shouldIncludeCrossMajorPlanItems(channel, explicitMajorOptIn)) {
+        items.push({
+            status: "blocked",
+            action: "major-boundary",
+            message: "v2→v3 migration requires explicit opt-in: rerun with --target-major 3 on a 3.x development-channel CLI after preview",
+        });
+    }
+    return summarizeOrchestratorPhase("detect", items);
+}
+function migrationPhaseToOrchestrator(phase) {
+    return {
+        name: phase.name,
+        status: phase.status,
+        summary: phase.summary,
+        items: phase.items,
+        message: phase.message,
+    };
+}
+export function buildUpgradePlan(args) {
+    const sourceRoot = resolveSourceRootStrict();
+    const home = resolvePath(expanduser(args.home ?? os.homedir()));
+    const env = { ...process.env, HOME: home };
+    const project = resolvePath(expanduser(args.project ?? process.cwd()));
+    const [installRoot] = resolveDoctorInstallRoot(args.installRoot ?? null, { home, sourceRoot });
+    const channel = resolveUpdateChannel({
+        channel: args.channel ?? null,
+        env,
+        home,
+        sourceRoot,
+    });
+    const install = classifyInstall({ appHome: installRoot, sourceRoot });
+    const targetMajor = args.targetMajor ?? null;
+    const explicitMajorOptIn = targetMajor === 3;
+    const crossMajorBoundary = crossMajorBoundaryApplies(install, sourceRoot);
+    const phaseFilter = selectedPhases(args.only);
+    const runMigration = crossMajorBoundary && shouldIncludeCrossMajorPlanItems(channel, explicitMajorOptIn);
+    const phases = [];
+    if (phaseFilter.has("detect")) {
+        phases.push(buildDetectPhase(install, crossMajorBoundary, explicitMajorOptIn, channel));
+    }
+    let migrationPreview = runMigration
+        ? dryRunMigration({ appHome: installRoot, project, home, force: args.force })
+        : null;
+    if (args.yes && migrationPreview) {
+        migrationPreview = applyMigrationPhases({ appHome: installRoot, project, home, force: args.force }, migrationPreview, args.only && args.only.length > 0 ? args.only : MIGRATION_ONLY_PHASES);
+    }
+    if (migrationPreview) {
+        if (phaseFilter.has("artifacts")) {
+            phases.push(migrationPhaseToOrchestrator(migrationPreview.artifacts));
+        }
+        if (phaseFilter.has("runtime")) {
+            phases.push(migrationPhaseToOrchestrator(migrationPreview.runtime));
+        }
+        if (phaseFilter.has("cleanup")) {
+            phases.push(migrationPhaseToOrchestrator(migrationPreview.cleanup));
+        }
+    }
+    else if (crossMajorBoundary) {
+        const guard = previewCrossMajorGuard({
+            appHome: installRoot,
+            sourceRoot,
+            channel: args.channel ?? null,
+            env,
+            home,
+            targetMajor,
+        });
+        for (const guardPhase of guard.phases) {
+            if (guardPhase.name === "detect" || !phaseFilter.has(guardPhase.name)) {
+                continue;
+            }
+            const items = guardPhase.items.map((item) => ({
+                status: "blocked",
+                action: item.verb,
+                message: `${item.name} requires explicit major opt-in (--target-major 3)`,
+            }));
+            phases.push({
+                name: guardPhase.name,
+                status: items.length > 0 ? "blocked" : "noop",
+                summary: { ...emptySummary(), blocked: items.length },
+                items,
+                message: "",
+            });
+        }
+    }
+    const summary = aggregateSummary(phases);
+    const status = workflowStatus(summary);
+    const mode = args.yes ? "apply" : "plan";
+    const lifecycleStatus = lifecycleStatusFromWorkflow(status, mode);
+    const blocked = status === "blocked" || status === "failed";
+    const commands = buildUpgradeCommands({
+        project,
+        installRoot,
+        channel,
+        targetMajor: explicitMajorOptIn ? 3 : null,
+        only: args.only,
+    });
+    return {
+        schemaVersion: UPGRADE_PREVIEW_SCHEMA,
+        mode,
+        status,
+        lifecycleStatus,
+        channel,
+        install,
+        targetMajor,
+        crossMajorBoundary,
+        project,
+        appHome: installRoot,
+        home,
+        phases,
+        summary,
+        dryRunCommand: blocked || lifecycleStatus === STATUS_NO_CHANGES_NEEDED ? null : commands.dryRunCommand,
+        applyCommand: blocked || lifecycleStatus === STATUS_NO_CHANGES_NEEDED ? null : commands.applyCommand,
+    };
+}
+export function validateUpgradeApply(args, plan) {
+    if (args.yes && args.dryRun) {
+        return "--yes and --dry-run are mutually exclusive";
+    }
+    if (!args.yes) {
+        return null;
+    }
+    if (plan.crossMajorBoundary && plan.targetMajor !== 3) {
+        return ("cross-major v2→v3 migration requires a preview first: run the same command with --dry-run, " +
+            "then apply with --yes and --target-major 3");
+    }
+    if (plan.crossMajorBoundary &&
+        plan.targetMajor === 3 &&
+        !shouldIncludeCrossMajorPlanItems(plan.channel, true)) {
+        return "cross-major v2→v3 migration requires a 3.x development-channel CLI; stable channel cannot apply v3 migration";
+    }
+    return null;
+}
+export function renderUpgradePlan(plan) {
+    const lines = [
+        "Agentera upgrade",
+        `lifecycle status: ${plan.lifecycleStatus.replace(/_/g, " ")}`,
+        `mode: ${plan.mode === "plan" ? "preview only; no files were changed" : "applying approved changes"}`,
+        `project: ${plan.project}`,
+        `Agentera directory: ${plan.appHome}`,
+        `channel: ${plan.channel.channel} (distribution major ${plan.channel.distributionMajor})`,
+    ];
+    if (plan.crossMajorBoundary) {
+        lines.push("cross-major boundary: yes");
+        if (plan.targetMajor !== null) {
+            lines.push(`target major: ${plan.targetMajor}`);
+        }
+    }
+    for (const phase of plan.phases) {
+        lines.push("");
+        lines.push(`${phase.name}:`);
+        if (phase.message && phase.items.length === 0) {
+            lines.push(`  ${phase.status}: ${phase.message}`);
+        }
+        for (const item of phase.items) {
+            lines.push(`  - ${item.status}: ${item.action}`);
+            if (item.message) {
+                lines.push(`    ${item.message}`);
+            }
+        }
+    }
+    if (plan.mode === "plan" && plan.summary.pending > 0 && plan.applyCommand) {
+        lines.push("");
+        lines.push(`Next: if this preview looks right, apply with: ${plan.applyCommand}`);
+    }
+    return lines.join("\n") + "\n";
+}
+export function upgradeExitCode(plan) {
+    if (plan.summary.blocked > 0 || plan.summary.failed > 0) {
+        return 1;
+    }
+    if (plan.mode === "plan" && plan.summary.pending > 0) {
+        return 1;
+    }
+    return 0;
+}
+export function sortKeysDeep(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortKeysDeep);
+    }
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const key of Object.keys(value).sort()) {
+            out[key] = sortKeysDeep(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+export { MAJOR_BOUNDARY_ITEM_TAG };
+//# sourceMappingURL=upgradeOrchestrator.js.map

package/dist/upgrade/upgradeOrchestrator.js.map

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

package/dist/validate/appHomeContract.js

@@ -0,0 +1,150 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Validate user-facing app-home terminology for release readiness. Faithful TS
+ * port of the text-surface scanning in scripts/validate_app_home_contract.py.
+ *
+ * The CLI-surface scanning (running agentera help/output commands) is wired in
+ * Phase 7 via the `cliInvoker` option once the TS CLI commands exist.
+ */
+export const TEXT_SURFACES = [
+    "README.md",
+    "UPGRADE.md",
+    "references/cli/vocabulary.md",
+    "plugin.json",
+    ".github/plugin/plugin.json",
+    ".codex-plugin/plugin.json",
+    ".opencode/plugins/agentera.js",
+    "skills/agentera/SKILL.md",
+    "skills/agentera/capabilities/hej/instructions.md",
+    "skills/agentera/references/contract.md",
+];
+export const CLI_HELP_COMMANDS = [
+    ["--help"],
+    ["hej", "--help"],
+    ["doctor", "--help"],
+    ["upgrade", "--help"],
+];
+export const CLI_OUTPUT_COMMANDS = [
+    ["hej"],
+    ["hej", "--format", "json"],
+    ["doctor", "--json"],
+    ["upgrade", "--only", "bundle", "--dry-run"],
+    ["upgrade", "--only", "bundle", "--dry-run", "--json"],
+    ["upgrade", "--only", "runtime", "--runtime", "claude", "--dry-run"],
+];
+const FORBIDDEN = [
+    [/\bbundle[- ]root\b/i, "bundle-root wording"],
+    [/\blive bundle\b/i, "live-bundle wording"],
+    [/\bdurable bundle\b.*\bAGENTERA_HOME\b/i, "durable bundle named as AGENTERA_HOME"],
+    [/\bAGENTERA_HOME\b.*\bdurable bundle\b/i, "AGENTERA_HOME named as durable bundle"],
+    [/\bAGENTERA_HOME\b.*\binstall root\b/i, "AGENTERA_HOME named as install root"],
+    [/\binstall root\b.*\bAGENTERA_HOME\b/i, "install root named as AGENTERA_HOME"],
+    [/\bdefault durable root\b/i, "default durable root wording"],
+];
+const RECOVERY_FORBIDDEN = [
+    [/\bAgentera-managed\b/i, "jargon in recovery wording"],
+    [/\bunmanaged (?:user-owned )?directory\b/i, "jargon in recovery wording"],
+    [/\bdeprecated default\b/i, "jargon in recovery wording"],
+    [/\bplatform app-home recovery\b/i, "jargon in recovery wording"],
+    [/\bdry-run preview\b/i, "jargon in recovery wording"],
+    [/\bbundle install\b/i, "jargon in recovery wording"],
+    [/\bmanaged app refresh\b/i, "jargon in recovery wording"],
+    [/\binstalled Agentera app is stale\b/i, "jargon in recovery wording"],
+    [/\bdurable Agentera bundle\b/i, "jargon in recovery wording"],
+    [/\bapp home exists but is not\b/i, "jargon in recovery wording"],
+    [/\buse --force only after reviewing\b/i, "jargon in recovery wording"],
+    [/\bUse platform home\b/i, "jargon in recovery wording"],
+    [/\bForce deprecated home\b/i, "jargon in recovery wording"],
+];
+const INSTALL_ROOT_LABEL_RE = /\binstall root:/i;
+export function isPlainLanguageRuleLine(line) {
+    const lowered = line.toLowerCase();
+    return [
+        "never ask the user",
+        "bad labels",
+        "avoid these prompt labels",
+        "jargon in recovery wording",
+    ].some((marker) => lowered.includes(marker));
+}
+/** Mirror Python str.splitlines(): split on line boundaries, no trailing empty. */
+function splitLines(text) {
+    const parts = text.split(/\r\n|\r|\n/);
+    if (parts.length > 0 && parts[parts.length - 1] === "" && /[\r\n]$/.test(text)) {
+        parts.pop();
+    }
+    return parts;
+}
+export function checkText(surface, text) {
+    const errors = [];
+    splitLines(text).forEach((line, idx) => {
+        const number = idx + 1;
+        for (const [pattern, reason] of FORBIDDEN) {
+            if (pattern.test(line)) {
+                errors.push(`${surface}:${number}: ${reason}: ${line.trim()}`);
+            }
+        }
+        if (!isPlainLanguageRuleLine(line)) {
+            for (const [pattern, reason] of RECOVERY_FORBIDDEN) {
+                if (pattern.test(line)) {
+                    errors.push(`${surface}:${number}: ${reason}: ${line.trim()}`);
+                }
+            }
+        }
+        if (surface.startsWith("agentera ")) {
+            if (INSTALL_ROOT_LABEL_RE.test(line)) {
+                errors.push(`${surface}:${number}: CLI output names app home as install root: ${line.trim()}`);
+            }
+            if (line.includes("installRoot")) {
+                errors.push(`${surface}:${number}: public JSON exposes installRoot instead of appHome: ${line.trim()}`);
+            }
+        }
+    });
+    return errors;
+}
+function readSurface(root, relative) {
+    const p = path.join(root, relative);
+    if (!fs.existsSync(p) || !fs.statSync(p).isFile()) {
+        return null;
+    }
+    return [relative, fs.readFileSync(p, "utf8")];
+}
+/**
+ * Run the help/output CLI surfaces through the provided invoker, returning
+ * (label, combined-output) tuples mirroring the Python helper.
+ */
+export function cliSurfaces(root, invoke, tmpProject) {
+    const surfaces = [];
+    const helpEnv = { ...process.env, AGENTERA_HOME: root };
+    for (const args of CLI_HELP_COMMANDS) {
+        const result = invoke(args, { cwd: root, env: helpEnv });
+        const label = "agentera " + args.join(" ");
+        surfaces.push([label, result.stdout + result.stderr]);
+        if (result.status !== 0) {
+            surfaces.push([label, `help command exited ${result.status}`]);
+        }
+    }
+    const outEnv = { ...process.env, AGENTERA_HOME: root, AGENTERA_BOOTSTRAP_SOURCE_ROOT: root };
+    for (const args of CLI_OUTPUT_COMMANDS) {
+        const result = invoke(args, { cwd: tmpProject, env: outEnv });
+        surfaces.push(["agentera " + args.join(" "), result.stdout + result.stderr]);
+    }
+    return surfaces;
+}
+export function validate(root, opts = {}) {
+    const errors = [];
+    for (const relative of TEXT_SURFACES) {
+        const surface = readSurface(root, relative);
+        if (surface === null) {
+            continue;
+        }
+        errors.push(...checkText(surface[0], surface[1]));
+    }
+    if (opts.cliInvoker && opts.tmpProject) {
+        for (const [surface, text] of cliSurfaces(root, opts.cliInvoker, opts.tmpProject)) {
+            errors.push(...checkText(surface, text));
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=appHomeContract.js.map

package/dist/validate/appHomeContract.js.map

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