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

package/dist/runtime/retiredRuntimeCleanup.js

@@ -0,0 +1,238 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadYamlMapping } from "../core/yaml.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { LIFECYCLE_OPERATION_CONTRACT_RELATIVE_PATH, LIFECYCLE_MANUAL_REVIEW_GUIDANCE, applyLifecycleOperations, createLifecycleOwnershipManifest, emptyLifecycleOwnershipLedger, planLifecycleOperations, validateLifecycleOwnershipLedger, } from "./lifecycleOperations.js";
+import { LIFECYCLE_AUTHORITY_RELATIVE_PATH, RETIRED_RUNTIME_CLEANUP_CONTRACT_RELATIVE_PATH, } from "./lifecycleAuthority.js";
+function isMapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function stringList(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : [];
+}
+export function validateRetiredRuntimeCleanupContractData(value) {
+    if (!isMapping(value))
+        return ["retired runtime cleanup contract must be a YAML object"];
+    const errors = [];
+    if (value.schema_version !== "agentera.retiredRuntimeResources.v1") {
+        errors.push("schema_version must be agentera.retiredRuntimeResources.v1");
+    }
+    if (value.status !== "retired_migration_contract")
+        errors.push("status must be retired_migration_contract");
+    if (value.decision !== 92)
+        errors.push("decision must cite approved Decision 92");
+    if (value.authority !== LIFECYCLE_AUTHORITY_RELATIVE_PATH) {
+        errors.push(`authority must point to ${LIFECYCLE_AUTHORITY_RELATIVE_PATH}`);
+    }
+    if (value.operation_contract !== LIFECYCLE_OPERATION_CONTRACT_RELATIVE_PATH) {
+        errors.push(`operation_contract must point to ${LIFECYCLE_OPERATION_CONTRACT_RELATIVE_PATH}`);
+    }
+    const policy = isMapping(value.policy) ? value.policy : {};
+    if (policy.active_inventory_exposure !== "forbidden"
+        || policy.preview !== "strictly_read_only"
+        || policy.apply_requires !== "explicit_approval"
+        || policy.ownership !== "matching_whole_resource_legacy_ledger_identity_and_fingerprint"
+        || policy.unsupported_platform_result !== "action_required") {
+        errors.push("policy must fail closed with pure preview, explicit approval, and legacy ledger ownership");
+    }
+    const runtimes = value.retired_runtimes;
+    if (!Array.isArray(runtimes) || runtimes.length !== 1 || !isMapping(runtimes[0])) {
+        return [...errors, "retired_runtimes must contain exactly one Claude migration record"];
+    }
+    const claude = runtimes[0];
+    if (claude.id !== "claude"
+        || claude.active_runtime !== false
+        || claude.source_product !== "claude-code") {
+        errors.push("retired Claude record must be inactive with source_product claude-code");
+    }
+    const resources = claude.resources;
+    if (!Array.isArray(resources) || resources.length !== 1 || !isMapping(resources[0])) {
+        errors.push("Claude cleanup must declare exactly one legacy Agentera resource");
+    }
+    else if (resources[0].id !== "claude.agentera-skill-link"
+        || resources[0].kind !== "symlink"
+        || resources[0].intent !== "remove"
+        || resources[0].destination !== "{home}/.claude/skills/agentera"
+        || resources[0].ledger_status !== "legacy") {
+        errors.push("Claude cleanup resource must be the legacy-ledger Agentera skill symlink removal");
+    }
+    const neverTouch = stringList(claude.never_touch);
+    for (const required of ["projects", "settings", "credentials", "conversations", "cache", "stats"]) {
+        if (!neverTouch.some((entry) => entry.toLowerCase().includes(required))) {
+            errors.push(`Claude never_touch must cover ${required}`);
+        }
+    }
+    return errors;
+}
+export function loadRetiredRuntimeCleanupContract(contractPath = path.join(resolveSourceRoot(), RETIRED_RUNTIME_CLEANUP_CONTRACT_RELATIVE_PATH)) {
+    const data = loadYamlMapping(fs.readFileSync(contractPath, "utf8"));
+    const errors = validateRetiredRuntimeCleanupContractData(data);
+    if (errors.length > 0)
+        throw new Error(`Retired runtime cleanup contract validation failed: ${errors.join("; ")}`);
+    const runtimes = data.retired_runtimes.map((runtime) => ({
+        id: runtime.id,
+        displayName: runtime.display_name,
+        sourceProduct: runtime.source_product,
+        resources: runtime.resources.map((resource) => ({
+            id: resource.id,
+            kind: resource.kind,
+            destination: resource.destination,
+            ledgerStatus: resource.ledger_status,
+        })),
+        neverTouch: runtime.never_touch,
+        safetyNote: runtime.safety_note,
+    }));
+    return { sourcePath: contractPath, runtimes };
+}
+export function validateRetiredRuntimeCleanupContractRoot(root = resolveSourceRoot()) {
+    const contractPath = path.join(root, RETIRED_RUNTIME_CLEANUP_CONTRACT_RELATIVE_PATH);
+    if (!fs.existsSync(contractPath)) {
+        return [`${RETIRED_RUNTIME_CLEANUP_CONTRACT_RELATIVE_PATH}: missing retired runtime cleanup contract`];
+    }
+    try {
+        return validateRetiredRuntimeCleanupContractData(loadYamlMapping(fs.readFileSync(contractPath, "utf8"))).map((error) => `${RETIRED_RUNTIME_CLEANUP_CONTRACT_RELATIVE_PATH}: ${error}`);
+    }
+    catch (error) {
+        return [`${RETIRED_RUNTIME_CLEANUP_CONTRACT_RELATIVE_PATH}: could not parse contract: ${error.message}`];
+    }
+}
+function expandHome(template, home) {
+    if (!template.startsWith("{home}/") || template.includes("..")) {
+        throw new Error(`unsafe retired runtime destination template: ${template}`);
+    }
+    return path.join(path.resolve(home), template.slice("{home}/".length));
+}
+function legacyLedgerDiagnostics(plan) {
+    const ledger = plan.request.ledger ?? emptyLifecycleOwnershipLedger();
+    const diagnostics = [];
+    for (const operation of plan.request.operations) {
+        const planned = plan.operations.find((candidate) => candidate.id === operation.id);
+        const records = ledger.records.filter((record) => record.resourceId === operation.id);
+        if (records.length === 0 && planned?.action === "noop")
+            continue;
+        if (records.length !== 1) {
+            diagnostics.push(`${operation.id}: retired cleanup requires exactly one ownership ledger record`);
+            continue;
+        }
+        const record = records[0];
+        if (record.status !== "legacy"
+            || record.scope !== "whole"
+            || path.resolve(record.destination) !== path.resolve(operation.destination)
+            || record.kind !== operation.kind
+            || record.identity === null
+            || record.fingerprint === null) {
+            diagnostics.push(`${operation.id}: retired cleanup requires matching whole-resource ledger status legacy with identity and fingerprint`);
+        }
+    }
+    return diagnostics;
+}
+function blockedRetiredPlan(plan, diagnostics) {
+    const reason = `${diagnostics.join("; ")} ${LIFECYCLE_MANUAL_REVIEW_GUIDANCE}`;
+    return {
+        ...plan,
+        operations: plan.operations.map((operation) => operation.action === "noop"
+            ? operation
+            : operation.action === "remove" && operation.ownership === "managed"
+                ? {
+                    ...operation,
+                    state: "ambiguous_ownership",
+                    ownership: "ambiguous",
+                    action: "blocked_unowned",
+                    reason,
+                }
+                : {
+                    ...operation,
+                    reason: `${operation.reason}; ${reason}`,
+                }),
+    };
+}
+export function previewRetiredRuntimeCleanup(opts) {
+    const contract = opts.contract ?? loadRetiredRuntimeCleanupContract();
+    const runtime = contract.runtimes.find((candidate) => candidate.id === opts.runtimeId);
+    if (!runtime)
+        throw new Error(`unknown retired runtime cleanup id: ${opts.runtimeId}`);
+    const operations = runtime.resources.map((resource) => ({
+        id: resource.id,
+        destination: expandHome(resource.destination, opts.home),
+        kind: resource.kind,
+        intent: "remove",
+        required: true,
+    }));
+    const suppliedLedger = opts.ledger ?? emptyLifecycleOwnershipLedger();
+    const ledgerErrors = validateLifecycleOwnershipLedger(suppliedLedger);
+    const plan = planLifecycleOperations({
+        allowedRoots: [path.resolve(opts.home)],
+        operations,
+        manifest: createLifecycleOwnershipManifest(operations),
+        ledger: ledgerErrors.length === 0 ? suppliedLedger : emptyLifecycleOwnershipLedger(),
+    });
+    const ledgerDiagnostics = ledgerErrors.length > 0
+        ? ledgerErrors.map((error) => `invalid ownership ledger: ${error}`)
+        : legacyLedgerDiagnostics(plan);
+    const authorizedPlan = ledgerDiagnostics.length === 0
+        ? plan
+        : blockedRetiredPlan(plan, ledgerDiagnostics);
+    return {
+        schemaVersion: "agentera.retiredRuntimeCleanupPreview.v1",
+        mode: "preview",
+        runtimeId: runtime.id,
+        activeRuntime: false,
+        sourceProduct: runtime.sourceProduct,
+        approvalRequired: true,
+        ownershipRequirement: "matching_whole_resource_legacy_ledger",
+        ledgerAuthorization: ledgerDiagnostics.length === 0 ? "legacy_match_or_absent_noop" : "blocked",
+        ledgerDiagnostics,
+        plan: authorizedPlan,
+        neverTouch: runtime.neverTouch.map((entry) => expandHome(entry, opts.home)),
+        safetyNote: runtime.safetyNote,
+    };
+}
+function approvalRequiredResult(preview) {
+    const operations = preview.plan.operations.map((operation) => ({
+        ...operation,
+        action: operation.action === "noop" || operation.action === "blocked_unowned"
+            ? operation.action
+            : "action_required",
+        status: operation.action === "noop"
+            ? "noop"
+            : operation.action === "blocked_unowned"
+                ? "blocked_unowned"
+                : "action_required",
+        dependencyCauses: [],
+        reason: operation.action === "noop" || operation.action === "blocked_unowned"
+            ? operation.reason
+            : "explicit cleanup approval is required",
+    }));
+    const summary = {
+        applied: 0,
+        noop: operations.filter((item) => item.status === "noop").length,
+        failed: 0,
+        blocked_unowned: operations.filter((item) => item.status === "blocked_unowned").length,
+        skipped_dependency: 0,
+        action_required: operations.filter((item) => item.status === "action_required").length,
+    };
+    return {
+        schemaVersion: "agentera.lifecycleApplyResult.v1",
+        status: operations.every((item) => item.status === "noop") ? "success" : "non_success",
+        operations,
+        summary,
+        requiredUnmet: operations.filter((item) => item.required && item.status !== "noop").map((item) => item.id),
+        ownershipLedger: preview.plan.request.ledger ?? emptyLifecycleOwnershipLedger(),
+    };
+}
+export function applyRetiredRuntimeCleanup(preview, options) {
+    const currentLedgerDiagnostics = legacyLedgerDiagnostics(preview.plan);
+    const authorized = preview.ledgerAuthorization === "legacy_match_or_absent_noop"
+        && currentLedgerDiagnostics.length === 0;
+    const result = options.approved && authorized
+        ? applyLifecycleOperations(preview.plan, options)
+        : approvalRequiredResult(preview);
+    return {
+        ...result,
+        runtimeId: preview.runtimeId,
+        activeRuntime: false,
+        sourceProduct: preview.sourceProduct,
+        approval: options.approved ? "approved" : "required",
+    };
+}
+//# sourceMappingURL=retiredRuntimeCleanup.js.map

package/dist/runtime/retiredRuntimeCleanup.js.map

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

package/dist/setup/codex/agents.js

@@ -0,0 +1,96 @@
+import fs from "node:fs";
+import path from "node:path";
+import { expanduser, isFile, pathExists } from "../../core/paths.js";
+import { CAPABILITY_AGENT_NAMES } from "./constants.js";
+export function codexAgentSourceDir(installRoot) {
+    const candidates = [
+        path.join(installRoot, "app", "skills", "agentera", "agents"),
+        path.join(installRoot, "skills", "agentera", "agents"),
+    ];
+    for (const candidate of candidates) {
+        try {
+            if (fs.statSync(candidate).isDirectory())
+                return candidate;
+        }
+        catch {
+            /* not a dir */
+        }
+    }
+    return candidates[0];
+}
+export function defaultAgentsDirForConfig(configPath) {
+    const expanded = expanduser(configPath);
+    if (path.basename(expanded) === "config.toml" && path.basename(path.dirname(expanded)) === ".codex") {
+        return path.join(path.dirname(expanded), "agents");
+    }
+    throw new Error("Codex agent descriptors can be inferred only for documented config layouts: " +
+        "~/.codex/config.toml or <project>/.codex/config.toml. " +
+        "Pass --agents-dir for nonstandard --config-file paths.");
+}
+function codexDescriptorManaged(text) {
+    const lines = text.split(/\r\n|\r|\n/).slice(0, 5);
+    return lines.some((line) => line.trim() === "# agentera_managed: true");
+}
+export function planAgentDescriptorChanges(installRoot, agentsDir, opts) {
+    const sourceDir = codexAgentSourceDir(installRoot);
+    const changes = [];
+    for (const name of CAPABILITY_AGENT_NAMES) {
+        const source = path.join(sourceDir, `${name}.toml`);
+        const target = path.join(agentsDir, `${name}.toml`);
+        let sourceText;
+        try {
+            sourceText = fs.readFileSync(source, "utf8");
+        }
+        catch {
+            changes.push({ action: "blocked", name, source, target, message: "source descriptor is missing", content: "" });
+            continue;
+        }
+        if (!pathExists(target)) {
+            changes.push({ action: "pending", name, source, target, message: "would install Codex agent descriptor", content: sourceText });
+            continue;
+        }
+        if (!isFile(target)) {
+            changes.push({ action: "blocked", name, source, target, message: "target exists but is not a regular file", content: sourceText });
+            continue;
+        }
+        let targetText;
+        try {
+            targetText = fs.readFileSync(target, "utf8");
+        }
+        catch (exc) {
+            changes.push({ action: "blocked", name, source, target, message: `cannot read target descriptor: ${exc.message}`, content: sourceText });
+            continue;
+        }
+        if (targetText === sourceText) {
+            changes.push({ action: "noop", name, source, target, message: "Codex agent descriptor is current", content: sourceText });
+        }
+        else if (opts.force || codexDescriptorManaged(targetText)) {
+            changes.push({ action: "pending", name, source, target, message: "would refresh Codex agent descriptor", content: sourceText });
+        }
+        else {
+            changes.push({
+                action: "blocked",
+                name,
+                source,
+                target,
+                message: "target exists without Agentera ownership proof; treating it as user-owned",
+                content: sourceText,
+            });
+        }
+    }
+    return changes;
+}
+export function writeAgentDescriptorChanges(changes) {
+    for (const change of changes) {
+        if (change.action !== "pending")
+            continue;
+        fs.mkdirSync(path.dirname(change.target), { recursive: true });
+        fs.writeFileSync(change.target, change.content, "utf8");
+    }
+}
+function readTextOrNull(p) {
+    if (!pathExists(p))
+        return null;
+    return fs.readFileSync(p, "utf8");
+}
+//# sourceMappingURL=agents.js.map

package/dist/setup/codex/agents.js.map

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

package/dist/setup/codex/cli.js

@@ -0,0 +1,161 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parseToml } from "../../core/toml.js";
+import { pathExists } from "../../core/paths.js";
+import { DEFAULT_CONFIG_PATH, InstallRootError, resolveInstallRoot } from "./installRoot.js";
+import { planAgentDescriptorChanges, writeAgentDescriptorChanges, defaultAgentsDirForConfig } from "./agents.js";
+import { planChange } from "./state.js";
+function readTextOrNull(p) {
+    if (!pathExists(p))
+        return null;
+    return fs.readFileSync(p, "utf8");
+}
+export function codexMain(argv = [], io = {}) {
+    const writeOut = io.out ?? ((text) => process.stdout.write(text));
+    const writeErr = io.err ?? ((text) => process.stderr.write(text));
+    const out = (line) => writeOut(line + "\n");
+    const err = (line) => writeErr(line + "\n");
+    const env = io.env ?? process.env;
+    const args = {
+        installRoot: null,
+        configFile: DEFAULT_CONFIG_PATH,
+        agentsDir: null,
+        dryRun: false,
+        force: false,
+        enableAgents: false,
+    };
+    const valueFlag = (a, name) => {
+        if (a === name)
+            return "__NEXT__";
+        if (a.startsWith(name + "="))
+            return a.slice(name.length + 1);
+        return null;
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        let v;
+        if ((v = valueFlag(a, "--install-root")) !== null) {
+            args.installRoot = v === "__NEXT__" ? argv[++i] : v;
+        }
+        else if ((v = valueFlag(a, "--config-file")) !== null) {
+            args.configFile = v === "__NEXT__" ? argv[++i] : v;
+        }
+        else if ((v = valueFlag(a, "--agents-dir")) !== null) {
+            args.agentsDir = v === "__NEXT__" ? argv[++i] : v;
+        }
+        else if (a === "--dry-run") {
+            args.dryRun = true;
+        }
+        else if (a === "--force") {
+            args.force = true;
+        }
+        else if (a === "--enable-agents") {
+            args.enableAgents = true;
+        }
+        else {
+            err(`setup_codex: error: unrecognized arguments: ${a}`);
+            return 2;
+        }
+    }
+    // Step 1: resolve and verify the Agentera directory.
+    let installRoot;
+    try {
+        installRoot = resolveInstallRoot(args.installRoot, env);
+    }
+    catch (errx) {
+        if (errx instanceof InstallRootError) {
+            err(errx.message);
+            return 2;
+        }
+        throw errx;
+    }
+    // Step 2: read current config (None if absent).
+    const configPath = args.configFile;
+    let currentText;
+    try {
+        currentText = readTextOrNull(configPath);
+    }
+    catch (errx) {
+        err(`error reading ${configPath}: ${errx.message}`);
+        return 2;
+    }
+    // Step 3: parse-check existing content.
+    if (currentText !== null && currentText.trim()) {
+        try {
+            parseToml(currentText);
+        }
+        catch (errx) {
+            err(`error: ${configPath} is not valid TOML (${errx.message}). ` +
+                "Repair it manually before running this helper.");
+            return 2;
+        }
+    }
+    // Step 4: plan the AGENTERA_HOME change and runtime-native descriptors.
+    const outcome = planChange(currentText, installRoot, { force: args.force });
+    let agentsDir;
+    try {
+        agentsDir = args.agentsDir ?? defaultAgentsDirForConfig(configPath);
+    }
+    catch (errx) {
+        err(`error: ${errx.message}`);
+        return 2;
+    }
+    const descriptorChanges = planAgentDescriptorChanges(installRoot, agentsDir, { force: args.force });
+    const pendingDescriptors = descriptorChanges.filter((c) => c.action === "pending");
+    const blockedDescriptors = descriptorChanges.filter((c) => c.action === "blocked");
+    if (args.enableAgents) {
+        err("--enable-agents is deprecated in Agentera v2; no [agents.*] " +
+            "blocks will be written; runtime-native descriptor files are managed separately.");
+    }
+    // Step 5: dispatch on the outcome.
+    if (outcome.action === "conflict") {
+        err(outcome.message);
+        if (outcome.diff)
+            err(outcome.diff);
+        return 2;
+    }
+    if (blockedDescriptors.length > 0) {
+        for (const change of blockedDescriptors) {
+            err(`error: ${change.target}: ${change.message}`);
+        }
+        return 2;
+    }
+    if (outcome.action === "noop" && pendingDescriptors.length === 0) {
+        out(outcome.message);
+        return 0;
+    }
+    if (args.dryRun) {
+        out(outcome.message);
+        if (outcome.diff) {
+            writeOut(outcome.diff);
+            if (!outcome.diff.endsWith("\n"))
+                out("");
+        }
+        for (const change of pendingDescriptors) {
+            out(`${change.message}: ${change.target}`);
+        }
+        return 1;
+    }
+    try {
+        if (outcome.action !== "noop") {
+            fs.mkdirSync(path.dirname(configPath), { recursive: true });
+            fs.writeFileSync(configPath, outcome.newText, "utf8");
+        }
+        writeAgentDescriptorChanges(pendingDescriptors);
+    }
+    catch (errx) {
+        err(`error writing Codex setup targets: ${errx.message}`);
+        return 2;
+    }
+    if (outcome.action !== "noop") {
+        out(`wrote ${configPath}: ${outcome.message.replaceAll("would ", "")}`);
+    }
+    else {
+        out(outcome.message);
+    }
+    for (const change of pendingDescriptors) {
+        out(`wrote ${change.target}: ${change.message.replaceAll("would ", "")}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/setup/codex/cli.js.map

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