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

package/dist/cli/commands/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,oBAAoB,GAGrB,MAAM,sCAAsC,CAAC;AAiB9C,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD,SAAS,kBAAkB,CAAC,IAAiB;IAC3C,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;QACtB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAC1D,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,KAAS,EAAE;IACvD,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAElD,IAAI,gBAAgB,CAAC,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC;QACpD,GAAG,CAAC,6DAA6D,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,MAAM,UAAU,GAAG,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACnE,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,kBAAkB,UAAU,IAAI,CAAC,CAAC;gBACtC,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,kBAAmB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,MAAM,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera/packages/cli/src/cli/commands/upgrade.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/upgradeVerify.js

@@ -0,0 +1,119 @@
+import os from "node:os";
+import { expanduser, resolvePath } from "../../core/paths.js";
+import { resolveDoctorInstallRoot, resolveSourceRootStrict } from "../../upgrade/appModel.js";
+import { APP_UP_TO_DATE, buildDoctorStatus } from "../../upgrade/doctor.js";
+import { CAPABILITY_INSTRUCTIONS } from "../../capabilities/index.js";
+import { buildPrimeCapabilityContextPayload } from "../capabilityContext.js";
+import { collectOrientationState } from "./prime/collectOrientationState.js";
+import { cmdPrime } from "./prime.js";
+import { validateStatePayload } from "./validate.js";
+import { enforceCompletedEntityCutover } from "../migrationRequired.js";
+function inProject(project, action) {
+    const previous = process.cwd();
+    process.chdir(project);
+    try {
+        return action();
+    }
+    finally {
+        process.chdir(previous);
+    }
+}
+/** Mandatory read-only checks for an activated v2-to-v3 project. */
+export function verifyOneWayUpgrade(ctx) {
+    const project = resolvePath(expanduser(ctx.project ?? process.cwd()));
+    const cutoverPassed = enforceCompletedEntityCutover(project, "json", {
+        out: () => { },
+        err: () => { },
+    }) === null;
+    let stateValidation;
+    try {
+        const state = validateStatePayload(project);
+        stateValidation = {
+            status: cutoverPassed && state.valid === true ? "passed" : "failed",
+            entity_count: Number(state.entity_count),
+            issue_count: Number(state.issue_count) + (cutoverPassed ? 0 : 1),
+        };
+    }
+    catch {
+        stateValidation = { status: "failed", entity_count: 0, issue_count: 1 };
+    }
+    let startupPassed = false;
+    if (cutoverPassed) {
+        try {
+            startupPassed = inProject(project, () => cmdPrime({
+                context: "status",
+                format: "json",
+                home: resolvePath(expanduser(ctx.home ?? os.homedir())),
+                installRoot: ctx.installRoot ?? null,
+                expectedVersion: ctx.expectedVersion ?? null,
+            }, { out: () => { }, err: () => { } })) === 0;
+        }
+        catch {
+            startupPassed = false;
+        }
+    }
+    return {
+        state_validation: stateValidation,
+        startup_validation: { status: startupPassed ? "passed" : "failed" },
+    };
+}
+export function verifyUpgrade(ctx) {
+    const sourceRoot = resolveSourceRootStrict();
+    const home = resolvePath(expanduser(ctx.home ?? os.homedir()));
+    const project = resolvePath(expanduser(ctx.project ?? process.cwd()));
+    const [installRoot, rootSource] = resolveDoctorInstallRoot(ctx.installRoot ?? null, {
+        home,
+        sourceRoot,
+    });
+    const checks = [];
+    const status = buildDoctorStatus(installRoot, {
+        rootSource,
+        sourceRoot,
+        home,
+        project,
+        expectedVersion: ctx.expectedVersion ?? null,
+    });
+    const doctorOk = status.status === APP_UP_TO_DATE && status.signals.length === 0;
+    checks.push({
+        name: "doctor",
+        passed: doctorOk,
+        detail: `status=${status.status}; signals=${status.signals.length}`,
+    });
+    const state = collectOrientationState({
+        home,
+        installRoot,
+        expectedVersion: ctx.expectedVersion ?? null,
+    });
+    for (const capability of Object.keys(CAPABILITY_INSTRUCTIONS)) {
+        const payload = buildPrimeCapabilityContextPayload(state, capability, "prime");
+        const capabilityContext = payload.capability_context;
+        const stateBlock = capabilityContext?.state;
+        const schemaError = stateBlock?.schema_error ?? null;
+        const passed = schemaError === null;
+        checks.push({
+            name: `prime --context ${capability}`,
+            passed,
+            detail: passed ? "schema_error: null" : `schema_error: ${String(schemaError)}`,
+        });
+    }
+    return { passed: checks.every((c) => c.passed), checks };
+}
+export function renderVerifySummary(result, json) {
+    if (json) {
+        return (JSON.stringify({
+            command: "upgrade --verify",
+            status: result.passed ? "passed" : "failed",
+            checks: result.checks,
+        }, null, 2) + "\n");
+    }
+    const lines = [
+        "Agentera verify",
+        `status: ${result.passed ? "passed" : "failed"}`,
+        "checks:",
+    ];
+    for (const check of result.checks) {
+        lines.push(`  - ${check.name}: ${check.passed ? "passed" : "failed"}  (${check.detail})`);
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=upgradeVerify.js.map

package/dist/cli/commands/upgradeVerify.js.map

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

package/dist/cli/commands/validate.js

@@ -1,20 +1,29 @@
 import path from "node:path";
-import { readdirSync as fsReaddirSync, readFileSync as fsReadFileSync, statSync as fsStatSync } from "node:fs";
+import { readdirSync as fsReaddirSync, statSync as fsStatSync } from "node:fs";
 import { resolvePath } from "../../core/paths.js";
 import { resolveSourceRoot } from "../../core/sourceRoot.js";
 import { validateAgentString, validatePathValue } from "../argvalidate.js";
-import { HookCliAdapter } from "../../hooks/validateArtifact.js";
+import { HookCliAdapter } from "../../hooks/validateArtifact/index.js";
 import { validateCapability, validateContractSelf, validateProtocolSelf } from "../../validate/capability.js";
 import { loadYamlMapping } from "../../core/yaml.js";
-import { parseToml as parseTomlValidate } from "../../core/toml.js";
 import { validateGraph } from "../../validate/crossCapability.js";
-import { lifecycleMain } from "../../validate/lifecycleAdapters.js";
 import { validate as validateAppHome } from "../../validate/appHomeContract.js";
+import { selfAuditMain } from "../../validate/selfAudit.js";
+import { vocabularyAuthorityMain } from "../../validate/vocabularyAuthority.js";
+import { releaseMetadataMain } from "../../release/releaseMetadata.js";
+import { VALIDATE_ARTIFACT_PROTOCOL_IDS, normalizeArtifactProtocolId, } from "../../registries/artifactProtocolIds.js";
 import { emitStructured } from "../structured.js";
+import { validateEntityState } from "../../state/entityStorage.js";
+import { detectStateModeBinding } from "../../state/stateMode.js";
+import { loadEntityCutoverTargetsForMarker } from "../../state/entityCutover.js";
+import { validateRealProjectRoot } from "../../state/projectRoot.js";
+import { readProjectFileSnapshot } from "../../state/safeProjectFile.js";
 const VALIDATE_DELEGATED_SCRIPTS = {
     "cross-capability": "validate_cross_capability.py",
-    "lifecycle-adapters": "validate_lifecycle_adapters.py",
     "app-home-contract": "validate_app_home_contract.py",
+    vocabularyAuthority: "validate_vocabulary_authority.py",
+    selfAudit: "self_audit.py",
+    "release-metadata": "validate_release_metadata.py",
 };
 function pySplitlines(s) {
     if (!s)
@@ -31,11 +40,6 @@ function runCrossCapability() {
     }
     return { stdout: "cross-capability artifact graph ok\n", stderr: "", returncode: 0 };
 }
-function runLifecycleAdapters() {
-    const lines = [];
-    const rc = lifecycleMain({ out: (line) => lines.push(line) });
-    return { stdout: lines.map((l) => l + "\n").join(""), stderr: "", returncode: rc };
-}
 function runAppHomeContract() {
     const errors = validateAppHome(resolvePath(repoRoot()));
     if (errors.length > 0) {
@@ -47,14 +51,31 @@ function runAppHomeContract() {
     }
     return { stdout: "OK: app-home contract terminology is release-ready\n", stderr: "", returncode: 0 };
 }
+function runVocabularyAuthority() {
+    const lines = [];
+    const rc = vocabularyAuthorityMain({ out: (line) => lines.push(line) });
+    return { stdout: lines.map((l) => l + "\n").join(""), stderr: "", returncode: rc };
+}
+function runSelfAudit() {
+    const lines = [];
+    const rc = selfAuditMain({ out: (line) => lines.push(line) });
+    return { stdout: lines.map((l) => l + "\n").join(""), stderr: "", returncode: rc };
+}
+function runReleaseMetadata() {
+    const lines = [];
+    const rc = releaseMetadataMain({ out: (line) => lines.push(line) });
+    return { stdout: lines.map((l) => l + "\n").join(""), stderr: "", returncode: rc };
+}
 function repoRoot() {
     // appHomeContract.validate resolves its own default root; pass the source root.
     return process.cwd();
 }
 const DELEGATED_RUNNERS = {
-    "cross-capability": runCrossCapability,
-    "lifecycle-adapters": runLifecycleAdapters,
-    "app-home-contract": runAppHomeContract,
+    "cross-capability": () => runCrossCapability(),
+    "app-home-contract": () => runAppHomeContract(),
+    vocabularyAuthority: () => runVocabularyAuthority(),
+    selfAudit: () => runSelfAudit(),
+    "release-metadata": () => runReleaseMetadata(),
 };
 function validationProcessPayload(targetFamily, target, p, result) {
     const lines = pySplitlines(result.stderr).map((l) => l.trim());
@@ -77,6 +98,7 @@ function validationProcessPayload(targetFamily, target, p, result) {
 }
 function delegatedValidationPayload(targetFamily, result, engineCommand) {
     const payload = validationProcessPayload(targetFamily, targetFamily, null, result);
+    // cast: payload.engine carries captured subprocess stdout/stderr (IO boundary)
     payload.engine = { ...payload.engine, command: engineCommand };
     return payload;
 }
@@ -84,10 +106,10 @@ export function cmdValidate(family, args, io) {
     const out = io.out ?? ((t) => process.stdout.write(t));
     const err = io.err ?? ((t) => process.stderr.write(t));
     if (!(family in DELEGATED_RUNNERS)) {
-        throw new Error("unsupported validate target family; valid families: capability, artifact, descriptors, " +
-            "cross-capability, lifecycle-adapters, app-home-contract, capability-contract.");
+        throw new Error("unsupported validate target family; valid families: capability, artifact, " +
+            "cross-capability, app-home-contract, vocabularyAuthority, selfAudit, release-metadata, capability-contract.");
     }
-    const result = DELEGATED_RUNNERS[family]();
+    const result = DELEGATED_RUNNERS[family](args);
     if ((args.format ?? "text") === "json") {
         emitStructured(delegatedValidationPayload(family, result, VALIDATE_DELEGATED_SCRIPTS[family]), "json", out);
     }
@@ -104,8 +126,8 @@ export function isDelegatedValidateFamily(family) {
 }
 // ── capability + capability-contract families ───────────────────────
 const CAPABILITY_NAMES = [
-    "hej", "visionera", "resonera", "inspirera", "planera", "realisera",
-    "optimera", "inspektera", "dokumentera", "profilera", "visualisera", "orkestrera",
+    "status", "vision", "discuss", "research", "plan", "build",
+    "optimize", "audit", "document", "profile", "design", "orchestrate",
 ];
 const CONTRACT_PATH = "skills/agentera/capability_schema_contract.yaml";
 const PROTOCOL_PATH = "skills/agentera/protocol.yaml";
@@ -122,7 +144,7 @@ function validateCapabilityTarget(target) {
         const valid = CAPABILITY_NAMES.join(", ");
         throw new Error(`unsupported capability target ${pyRepr(target)}; valid capability names: ${valid}. ` +
             "Syntax: agentera validate capability <capability-or-path> [--format text|json]. " +
-            "Example: agentera validate capability hej");
+            "Example: agentera validate capability status");
     }
     validatePathValue(target, "capability path");
     return target;
@@ -191,6 +213,7 @@ export function cmdValidateCapability(target, args, io) {
                 target,
                 path: resolvePath(capDir),
                 checks,
+                // cast: c.violations are captured validation-engine lines (subprocess IO boundary)
                 violations: checks.flatMap((c) => c.violations),
                 summary: {
                     passed: checks.filter((c) => c.status === "pass").length,
@@ -275,6 +298,7 @@ export function cmdValidateCapabilityContract(args, io) {
             target_family: "capability-contract",
             target: "capability-schema-contract-and-protocol",
             checks,
+            // cast: c.violations are captured validation-engine lines (subprocess IO boundary)
             violations: checks.flatMap((c) => c.violations),
             summary: {
                 passed: results.filter(([, r]) => r.returncode === 0).length,
@@ -292,199 +316,14 @@ export function cmdValidateCapabilityContract(args, io) {
     }
     return results.every(([, r]) => r.returncode === 0) ? 0 : 1;
 }
-// ── descriptors family ──────────────────────────────────────────────
-function pySplitlinesText(s) {
-    return s.split(/\r\n|\r|\n/);
-}
-function descriptorValidationPayload() {
-    const sourceRoot = resolveSourceRoot();
-    const codexDir = path.join(sourceRoot, "skills", "agentera", "agents");
-    const opencodeDir = path.join(sourceRoot, ".opencode", "agents");
-    const classificationPath = path.join(sourceRoot, "references", "cli", "capability-tool-classification.yaml");
-    const checks = [];
-    const violations = [];
-    let capPermissions = {};
-    try {
-        const classificationData = loadYamlMapping(fsReadFileSync(classificationPath, "utf8"));
-        capPermissions = {};
-        for (const categoryData of Object.values(classificationData.classification)) {
-            for (const [capability, capData] of Object.entries(categoryData.capabilities)) {
-                capPermissions[capability] = capData.permission;
-            }
-        }
-    }
-    catch (exc) {
-        violations.push(`classification authority: failed to load classification: ${exc.message}`);
-        capPermissions = {};
-    }
-    for (const name of CAPABILITY_NAMES) {
-        const codexPath = path.join(codexDir, `${name}.toml`);
-        let check = { runtime: "codex", capability: name, path: codexPath, status: "pass" };
-        let text;
-        let parsed;
-        try {
-            text = fsReadFileSync(codexPath, "utf8");
-            parsed = parseTomlValidate(text);
-        }
-        catch (exc) {
-            check = { ...check, status: "fail", message: exc.message };
-            violations.push(`codex ${name}: ${exc.message}`);
-            checks.push(check);
-            continue;
-        }
-        const expectedRef = `capabilities/${name}/instructions.md`;
-        if (parsed.name !== name) {
-            check = { ...check, status: "fail", message: "name field does not match capability" };
-            violations.push(`codex ${name}: name field must be ${name}`);
-        }
-        else if (typeof parsed.description !== "string" || !parsed.description.trim()) {
-            check = { ...check, status: "fail", message: "description is required" };
-            violations.push(`codex ${name}: description is required`);
-        }
-        else if (typeof parsed.developer_instructions !== "string" || !parsed.developer_instructions.includes(expectedRef)) {
-            check = { ...check, status: "fail", message: "developer_instructions must reference capability instructions" };
-            violations.push(`codex ${name}: developer_instructions must reference ${expectedRef}`);
-        }
-        else if (!pySplitlinesText(text).slice(0, 5).includes("# agentera_managed: true")) {
-            check = { ...check, status: "fail", message: "managed marker is required" };
-            violations.push(`codex ${name}: managed marker is required`);
-        }
-        else {
-            const devInst = parsed.developer_instructions;
-            const expectedPermission = (capPermissions[name] ?? {});
-            if (expectedPermission && Object.keys(expectedPermission).length > 0) {
-                let expectedGuidance;
-                if (expectedPermission.write === "allow" && expectedPermission.bash === "allow") {
-                    expectedGuidance = "You have full file write, file edit, and shell execution tools available";
-                }
-                else if (expectedPermission.write === "allow" && expectedPermission.bash === "deny") {
-                    expectedGuidance =
-                        "You have file write and file edit tools available to create or update files, but shell execution is disabled";
-                }
-                else {
-                    expectedGuidance = "You are a read-only agent \u2014 do not write files or execute shell commands";
-                }
-                if (!devInst.includes(expectedGuidance)) {
-                    check = { ...check, status: "fail", message: `developer_instructions must contain guidance '${expectedGuidance}'` };
-                    violations.push(`codex ${name}: developer_instructions must contain guidance '${expectedGuidance}'`);
-                }
-            }
-        }
-        checks.push(check);
-        const opencodePath = path.join(opencodeDir, `${name}.md`);
-        let ocheck = { runtime: "opencode", capability: name, path: opencodePath, status: "pass" };
-        let otext;
-        try {
-            otext = fsReadFileSync(opencodePath, "utf8");
-        }
-        catch (exc) {
-            ocheck = { ...ocheck, status: "fail", message: exc.message };
-            violations.push(`opencode ${name}: ${exc.message}`);
-            checks.push(ocheck);
-            continue;
-        }
-        let frontmatter = {};
-        try {
-            const lines = pySplitlinesText(otext);
-            if (lines.length > 0 && lines[0] === "---") {
-                const closing = lines.indexOf("---", 1);
-                if (closing !== -1) {
-                    const frontmatterText = lines.slice(1, closing).join("\n");
-                    frontmatter = loadYamlMapping(frontmatterText);
-                }
-            }
-        }
-        catch {
-            frontmatter = {};
-        }
-        const expectedRefO = `capabilities/${name}/instructions.md`;
-        const expectedPermission = (capPermissions[name] ?? {});
-        const actualPermission = frontmatter.permission;
-        if ("name" in frontmatter) {
-            ocheck = { ...ocheck, status: "fail", message: "name frontmatter must be omitted" };
-            violations.push(`opencode ${name}: name frontmatter must be omitted`);
-        }
-        else if (frontmatter.agentera_managed === "true") {
-            ocheck = { ...ocheck, status: "fail", message: "agentera_managed frontmatter must be omitted" };
-            violations.push(`opencode ${name}: agentera_managed frontmatter must be omitted`);
-        }
-        else if (frontmatter.mode !== "subagent") {
-            ocheck = { ...ocheck, status: "fail", message: "mode: subagent frontmatter is required" };
-            violations.push(`opencode ${name}: mode: subagent frontmatter is required`);
-        }
-        else if (!frontmatter.description) {
-            ocheck = { ...ocheck, status: "fail", message: "description is required" };
-            violations.push(`opencode ${name}: description is required`);
-        }
-        else if (!actualPermission || typeof actualPermission !== "object" || Array.isArray(actualPermission)) {
-            ocheck = { ...ocheck, status: "fail", message: "permission frontmatter is required and must be an object" };
-            violations.push(`opencode ${name}: permission frontmatter is required and must be an object`);
-        }
-        else if (actualPermission.write !== expectedPermission.write ||
-            actualPermission.bash !== expectedPermission.bash) {
-            ocheck = { ...ocheck, status: "fail", message: "permission frontmatter does not match classification" };
-            violations.push(`opencode ${name}: permission frontmatter must be write: ${expectedPermission.write}, bash: ${expectedPermission.bash}`);
-        }
-        else if (!otext.includes("<!-- agentera: managed -->")) {
-            ocheck = { ...ocheck, status: "fail", message: "managed body marker is required" };
-            violations.push(`opencode ${name}: managed body marker is required`);
-        }
-        else if (!otext.includes(expectedRefO)) {
-            ocheck = { ...ocheck, status: "fail", message: "descriptor must reference capability instructions" };
-            violations.push(`opencode ${name}: descriptor must reference ${expectedRefO}`);
-        }
-        else if (otext.includes("Dispatch only through the runtime-native") || otext.includes(`\`@${name}\``)) {
-            ocheck = { ...ocheck, status: "fail", message: "descriptor must not self-dispatch from a subagent" };
-            violations.push(`opencode ${name}: descriptor must execute directly without self-dispatch`);
-        }
-        checks.push(ocheck);
-    }
-    return {
-        command: "validate",
-        status: violations.length > 0 ? "fail" : "pass",
-        target_family: "descriptors",
-        target: "agent-descriptors",
-        checks,
-        violations,
-        summary: {
-            passed: checks.filter((c) => c.status === "pass").length,
-            failed: checks.filter((c) => c.status === "fail").length,
-        },
-    };
-}
-export function cmdValidateDescriptors(args, io) {
-    const out = io.out ?? ((t) => process.stdout.write(t));
-    const err = io.err ?? ((t) => process.stderr.write(t));
-    const payload = descriptorValidationPayload();
-    if ((args.format ?? "text") === "json") {
-        emitStructured(payload, "json", out);
-    }
-    else {
-        out(`descriptor validation ${payload.status}: ${payload.summary.passed} passed, ${payload.summary.failed} failed\n`);
-        for (const violation of payload.violations)
-            err(`- ${violation}\n`);
-    }
-    return payload.status === "pass" ? 0 : 1;
-}
 // ── artifact family ─────────────────────────────────────────────────
-const VALIDATE_ARTIFACT_LABELS = [
-    "CHANGELOG.md",
-    "DECISIONS.md",
-    "DESIGN.md",
-    "DOCS.md",
-    "HEALTH.md",
-    "PLAN.md",
-    "PROGRESS.md",
-    "TODO.md",
-    "VISION.md",
-];
 function validateArtifactLabel(artifact) {
     validateAgentString(artifact, "artifact");
-    if (!VALIDATE_ARTIFACT_LABELS.includes(artifact)) {
-        const valid = VALIDATE_ARTIFACT_LABELS.join(", ");
-        throw new Error(`unsupported artifact ${pyRepr(artifact)}; valid artifacts: ${valid}. ` +
-            "Syntax: agentera validate artifact --artifact <ARTIFACT> [--file <PATH>] [--format text|json]. " +
-            "Example: agentera validate artifact --artifact PLAN.md --file .agentera/plan.yaml --format json");
+    if (normalizeArtifactProtocolId(artifact) === null) {
+        const valid = VALIDATE_ARTIFACT_PROTOCOL_IDS.join(", ");
+        throw new Error(`unsupported artifact ${pyRepr(artifact)}; valid artifact_id values: ${valid}. ` +
+            "Syntax: agentera check validate artifact --artifact <ARTIFACT_ID> [--file <PATH>] [--format text|json]. " +
+            "Example: agentera check validate artifact --artifact plan --file .agentera/plan.yaml --format json");
     }
 }
 export function cmdValidateArtifact(args, io) {
@@ -512,8 +351,69 @@ export function cmdValidateArtifact(args, io) {
     out(`status=${payload.status} | artifact=${payload.artifact} | ` +
         `file=${payload.file} | docs_mapped_default=${payload.docs_mapped_default} | ` +
         `path_source=${payload.path_source}\n`);
+    // cast: payload.violations come from the artifact-validation hook (subprocess IO boundary)
     for (const violation of payload.violations)
         err(`${violation}\n`);
     return rc;
 }
+export function cmdValidateState(args, io) {
+    const out = io.out ?? ((text) => process.stdout.write(text));
+    const err = io.err ?? ((text) => process.stderr.write(text));
+    const projectRoot = resolvePath(args.cwd ?? process.cwd());
+    const payload = validateStatePayload(projectRoot);
+    const issues = payload.issues;
+    if ((args.format ?? "text") === "json")
+        emitStructured(payload, "json", out);
+    else {
+        out(`status=${payload.status} | entities=${payload.entity_count} | issues=${payload.issue_count} | project_root=${projectRoot}\n`);
+        for (const issue of issues)
+            err(`${issue.code}: ${issue.message}\nrecovery: ${issue.recovery}\n`);
+        if (payload.omitted_issue_count > 0)
+            err(`omitted ${payload.omitted_issue_count} additional issues; repair listed issues and rerun agentera check validate state --cwd ${JSON.stringify(projectRoot)}\n`);
+    }
+    return payload.valid ? 0 : 1;
+}
+/** The executable whole-state contract shared by the public command and upgrade verification. */
+export function validateStatePayload(projectRootInput) {
+    const projectRoot = resolvePath(projectRootInput);
+    const result = validateEntityState(projectRoot);
+    const issues = [...result.issues];
+    try {
+        const binding = detectStateModeBinding(projectRoot);
+        if (binding.mode === "entities") {
+            binding.publicationContext.close();
+            const markerSnapshot = readProjectFileSnapshot(validateRealProjectRoot(projectRoot), ".agentera/state-mode.yaml");
+            if (markerSnapshot.kind !== "file")
+                throw new Error("entity-mode marker became unavailable during maintenance validation");
+            const marker = loadYamlMapping(markerSnapshot.bytes.toString("utf8"));
+            if (typeof marker.migration_id === "string" || marker.cutover === "one_way_git") {
+                const targets = loadEntityCutoverTargetsForMarker(projectRoot, markerSnapshot.bytes);
+                const byPath = new Map(result.entities.map((entity) => [entity.relativePath, entity]));
+                for (const target of targets) {
+                    const actual = byPath.get(target.path);
+                    if (!actual || actual.classification !== "valid" || (target.id && actual.id !== target.id) || (target.artifact && actual.artifact !== target.artifact)) {
+                        issues.push({ code: "missing_migrated_entity", path: target.path, id: target.id ?? null, artifact: target.artifact ?? null, message: `cutover target '${target.path}' is missing or no longer has its declared identity`, recovery: "Restore a valid canonical entity at the manifest-declared path; no state was changed." });
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        issues.push({ code: "invalid_state_marker_or_manifest", path: ".agentera/state-mode.yaml", message: error.message, recovery: "Restore the durable marker and immutable migration evidence, then rerun this read-only check." });
+    }
+    const valid = result.valid && issues.length === 0;
+    const payload = {
+        command: "check validate state",
+        target_family: "state",
+        status: valid ? "pass" : "fail",
+        valid,
+        project_root: projectRoot,
+        entity_count: result.entityCount,
+        issue_count: issues.length + result.omittedIssueCount,
+        omitted_issue_count: result.omittedIssueCount,
+        valid_artifact_values: result.validArtifactValues,
+        issues: issues,
+    };
+    return payload;
+}
 //# sourceMappingURL=validate.js.map