agentera 3.0.0-dev.3 → 3.0.0-dev.31

package/dist/cli/commands/doctor.js

@@ -1,7 +1,13 @@
 import os from "node:os";
 import { expanduser, resolvePath } from "../../core/paths.js";
+import { pyJsonIndentSorted } from "../../core/pyjson.js";
 import { resolveDoctorInstallRoot, resolveSourceRootStrict, } from "../../upgrade/appModel.js";
-import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE, buildDoctorStatus, EXPECTED_STATE_COMMANDS, publicDoctorStatus, } from "../../upgrade/doctor.js";
+import { runNpmSmokeChecks } from "../../setup/smokeChecks.js";
+import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE, appLifecycleActionNoun, buildDoctorStatus, EXPECTED_STATE_COMMANDS, doctorParityJsonEnvelope, } from "../../upgrade/doctor.js";
+import { classifyInstall } from "../../upgrade/compatibility.js";
+import { prependCoexistenceDoctorSection, resolveCoexistenceDoctorLines, } from "../../upgrade/coexistenceProbe.js";
+import { prependNextMajorDoctorSection, resolveNextMajorDoctorLines, } from "../../upgrade/nextMajorDoctor.js";
+import { diagnoseCanonicalSkill } from "../../setup/sharedSkill.js";
 const PLAIN_STATUS = {
     pending: "ready to fix",
     applied: "fixed",
@@ -15,40 +21,11 @@ const PLAIN_STATUS = {
     [APP_MIGRATION_NEEDED]: "needs migration",
     [APP_MANUAL_REVIEW_NEEDED]: "needs manual review",
 };
-/** Commands the TS dispatcher exposes (used by the in-process CLI probe). */
-const DISPATCHER_COMMANDS = new Set([
-    "prime", "hej", "schema", "describe", "state", "query", "check", "lint", "backfill",
-    "compact", "gate", "validate", "decisions", "health", "todo", "plan", "progress",
-    "docs", "objective", "experiments",
-]);
 function plainStatus(value) {
     return PLAIN_STATUS[value] ?? value.replace(/_/g, " ").replace(/-/g, " ");
 }
-function doctorActionNoun(status) {
-    if (status.status === APP_OUTDATED)
-        return "update";
-    if (status.status === APP_MIGRATION_NEEDED)
-        return "migration";
-    return "repair";
-}
-/** In-process probe: confirm the TS CLI exposes the expected state commands. */
-function inProcessProbe(args) {
-    const missing = args.expectedCommands.filter((name) => !DISPATCHER_COMMANDS.has(name));
-    const command = ["npx", "-y", "agentera", "--help"];
-    return {
-        ok: missing.length === 0,
-        command,
-        returnCode: 0,
-        stdoutTail: [],
-        stderrTail: [],
-        missingCommands: missing,
-        message: missing.length === 0
-            ? "CLI exposes expected state commands"
-            : "CLI is missing expected state commands",
-    };
-}
 export function renderDoctorStatus(status) {
-    const actionNoun = doctorActionNoun(status);
+    const actionNoun = appLifecycleActionNoun(String(status.status));
     const lines = [
         "Agentera doctor",
         `status: ${plainStatus(status.status)}`,
@@ -76,7 +53,12 @@ export function renderDoctorStatus(status) {
         lines.push("Next:");
         lines.push(`  1. Preview the ${actionNoun}: ${status.dryRunCommand}`);
         lines.push(`  2. If the preview looks right, apply the ${actionNoun}: ${status.applyCommand}`);
-        lines.push(`  3. Then retry Agentera: ${status.retryCommand}`);
+        if (status.retryCommand) {
+            lines.push(`  3. Then retry Agentera: ${status.retryCommand}`);
+        }
+        else {
+            lines.push("  3. Then retry Agentera once a retry command is available.");
+        }
     }
     else {
         lines.push("");
@@ -84,66 +66,17 @@ export function renderDoctorStatus(status) {
     }
     return lines.join("\n");
 }
-export function pyJsonIndentSorted(value) {
-    return jsonIndent(value, 0);
-}
-function jsonAscii(str) {
-    let out = '"';
-    for (const ch of str) {
-        const cp = ch.codePointAt(0);
-        if (ch === '"')
-            out += '\\"';
-        else if (ch === "\\")
-            out += "\\\\";
-        else if (cp === 0x08)
-            out += "\\b";
-        else if (cp === 0x09)
-            out += "\\t";
-        else if (cp === 0x0a)
-            out += "\\n";
-        else if (cp === 0x0c)
-            out += "\\f";
-        else if (cp === 0x0d)
-            out += "\\r";
-        else if (cp < 0x20)
-            out += "\\u" + cp.toString(16).padStart(4, "0");
-        else if (cp < 0x80)
-            out += ch;
-        else if (cp > 0xffff) {
-            const v = cp - 0x10000;
-            out += "\\u" + (0xd800 + (v >> 10)).toString(16).padStart(4, "0");
-            out += "\\u" + (0xdc00 + (v & 0x3ff)).toString(16).padStart(4, "0");
-        }
-        else
-            out += "\\u" + cp.toString(16).padStart(4, "0");
-    }
-    return out + '"';
-}
-function jsonIndent(value, level) {
-    const pad = "  ".repeat(level);
-    const padIn = "  ".repeat(level + 1);
-    if (value === null || value === undefined)
-        return "null";
-    if (value === true)
-        return "true";
-    if (value === false)
-        return "false";
-    if (typeof value === "number")
-        return String(value);
-    if (typeof value === "string")
-        return jsonAscii(value);
-    if (Array.isArray(value)) {
-        if (value.length === 0)
-            return "[]";
-        return "[\n" + value.map((v) => padIn + jsonIndent(v, level + 1)).join(",\n") + "\n" + pad + "]";
-    }
-    if (typeof value === "object") {
-        const keys = Object.keys(value).sort();
-        if (keys.length === 0)
-            return "{}";
-        return "{\n" + keys.map((k) => padIn + jsonAscii(k) + ": " + jsonIndent(value[k], level + 1)).join(",\n") + "\n" + pad + "}";
+function renderDoctorSmoke(smoke) {
+    const lines = [
+        "",
+        "Smoke checks:",
+        `  enabled: ${smoke.enabled ? "yes" : "no"}`,
+        `  model calls attempted: ${smoke.modelCallsAttempted ? "yes" : "no"}`,
+    ];
+    for (const check of (smoke.checks ?? [])) {
+        lines.push(`  - ${check.name}: ${check.status} - ${check.message}`);
     }
-    return "null";
+    return lines.join("\n");
 }
 export function cmdDoctor(args, io = {}) {
     const out = io.out ?? ((t) => process.stdout.write(t));
@@ -157,24 +90,53 @@ export function cmdDoctor(args, io = {}) {
         return 2;
     }
     const home = resolvePath(expanduser(args.home ?? os.homedir()));
+    const project = resolvePath(expanduser(args.project ?? process.cwd()));
     const [installRoot, rootSource] = resolveDoctorInstallRoot(args.installRoot ?? null, { home, sourceRoot });
     const expectedCommands = args.expectCommand && args.expectCommand.length > 0 ? args.expectCommand : [...EXPECTED_STATE_COMMANDS];
     const status = buildDoctorStatus(installRoot, {
         rootSource,
         sourceRoot,
         home,
-        project: resolvePath(expanduser(args.project ?? process.cwd())),
+        project,
         expectedVersion: args.expectedVersion ?? null,
         expectedCommands,
-        probeCli: true,
-        probeRunner: inProcessProbe,
     });
+    const sharedSkill = diagnoseCanonicalSkill(home);
+    let smokeReport = null;
+    if (args.smoke) {
+        smokeReport = runNpmSmokeChecks(sourceRoot, process.env, {
+            liveModelAllowed: Boolean(args.allowLiveModel),
+        });
+    }
     if ((args.format ?? "text") === "json") {
-        out(pyJsonIndentSorted(publicDoctorStatus(status)) + "\n");
+        const payload = doctorParityJsonEnvelope(status);
+        payload.shared_skill = sharedSkill;
+        if (smokeReport)
+            payload.smoke = smokeReport;
+        out(pyJsonIndentSorted(payload) + "\n");
     }
     else {
-        out(renderDoctorStatus(status) + "\n");
+        const install = classifyInstall({ appHome: installRoot, sourceRoot });
+        const coexistenceLines = resolveCoexistenceDoctorLines({
+            home,
+            sourceRoot,
+            env: { ...process.env, HOME: home },
+        });
+        const nextMajorLines = resolveNextMajorDoctorLines({
+            sourceRoot,
+            home,
+            channel: status.updateChannel ?? null,
+            install,
+            env: process.env,
+        });
+        const body = prependCoexistenceDoctorSection(prependNextMajorDoctorSection(renderDoctorStatus(status), nextMajorLines), coexistenceLines) + `\nShared skill\n  ${String(sharedSkill.status)}: ${String(sharedSkill.message)}\n  path: ${String(sharedSkill.path)}\n` + (smokeReport ? renderDoctorSmoke(smokeReport) : "");
+        out(body + "\n");
+    }
+    if (args.smoke) {
+        const failCount = Number(smokeReport?.summary?.fail ?? 0);
+        if (failCount > 0)
+            return 1;
     }
-    return status.status === APP_UP_TO_DATE ? 0 : 1;
+    return status.status === APP_UP_TO_DATE && sharedSkill.status === "pass" ? 0 : 1;
 }
 //# sourceMappingURL=doctor.js.map

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

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

package/dist/cli/commands/durability.js

@@ -0,0 +1,82 @@
+import { resolvePath } from "../../core/paths.js";
+import { resolveSourceRoot } from "../../core/sourceRoot.js";
+import { emitStructured } from "../structured.js";
+import { stateDurabilityContract } from "../../state/archiveDiscovery.js";
+import { StateRetrievalFailure } from "../../state/directRetrieval.js";
+import { inspectDurability, renderDurabilityText, } from "../../state/durability.js";
+import { entityArtifactValues } from "../../state/entityStorage.js";
+export function requestedDurabilityFormat(argv) {
+    for (let index = 0; index < argv.length; index += 1) {
+        if (argv[index] === "--format") {
+            const value = argv[index + 1];
+            if (value === "json" || value === "yaml")
+                return value;
+        }
+        if (argv[index].startsWith("--format=")) {
+            const value = argv[index].slice("--format=".length);
+            if (value === "json" || value === "yaml")
+                return value;
+        }
+    }
+    return "text";
+}
+export function validateDurabilityArgs(args, sourceRoot) {
+    const contract = stateDurabilityContract(sourceRoot);
+    const validArtifacts = entityArtifactValues(sourceRoot);
+    if (args.number !== undefined)
+        throw entityDurabilityFailure("entity mode rejects --number; use --artifact ARTIFACT --id ID", args.artifact, args.id ?? undefined, validArtifacts);
+    if (!args.artifact || !args.id)
+        throw entityDurabilityFailure("entity-mode durability requires --artifact ARTIFACT --id ID", args.artifact, args.id ?? undefined, validArtifacts);
+    if (!/^[a-z]{10}$/.test(args.id))
+        throw entityDurabilityFailure(`entity ID '${args.id}' must be ten lowercase letters`, args.artifact, args.id, validArtifacts);
+    if (args.artifact && !validArtifacts.includes(args.artifact)) {
+        throw entityDurabilityFailure(`unsupported durability artifact '${args.artifact}'`, args.artifact, args.id ?? undefined, validArtifacts);
+    }
+    if (args.limit !== undefined && (args.limit < 1 || args.limit > contract.maximumLimit)) {
+        throw entityDurabilityFailure(`argument --limit must be between 1 and ${contract.maximumLimit}`, args.artifact, args.id ?? undefined, validArtifacts);
+    }
+}
+export function entityDurabilityFailure(message, artifact, id, validValues) {
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: "invalid_request",
+            message,
+            syntax: "agentera check durability --artifact ARTIFACT --id ID --format json",
+            example: "agentera check durability --artifact progress --id qjtrmnpvka --format json",
+            recovery: "Use one bare entity ID returned by the artifact list; no state was changed.",
+            ...(artifact ? { artifact } : {}),
+            ...(id ? { id } : {}),
+            ...(validValues ? { valid_values: validValues } : {}),
+        },
+    }, 2);
+}
+export function emitDurabilityFailure(failure, format, io) {
+    const out = io.out ?? ((text) => process.stdout.write(text));
+    if (format === "json" || format === "yaml")
+        emitStructured(failure.body, format, out);
+    else {
+        const details = failure.body.error;
+        out([
+            `Error: ${details.message}`,
+            `Class: ${details.class}`,
+            `Syntax: ${details.syntax}`,
+            `Example: ${details.example}`,
+            `Recovery: ${details.recovery}`,
+        ].join("\n") + "\n");
+    }
+    return failure.exitCode;
+}
+export function cmdDurability(args, io = {}) {
+    const output = io.out ?? ((text) => process.stdout.write(text));
+    const response = inspectDurability(resolvePath(args.project ?? process.cwd()), args, { sourceRoot: resolveSourceRoot() });
+    if (args.format === "json" || args.format === "yaml") {
+        emitStructured(response, args.format, output);
+    }
+    else {
+        renderDurabilityText(response, output);
+    }
+    return 0;
+}
+//# sourceMappingURL=durability.js.map

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

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

package/dist/cli/commands/entityMigrate.js

@@ -0,0 +1,132 @@
+import path from "node:path";
+import { emitStructured } from "../structured.js";
+import { resolveSourceRoot } from "../../core/sourceRoot.js";
+import { EntityMigrationContinuationError, previewEntityMigration } from "../../state/entityMigrationPreview.js";
+const SYNTAX = "agentera state migrate entities [--project PATH] [--after SOURCE_IDENTITY --source-fingerprint SHA256 --preview-digest SHA256] [--limit N] --dry-run [--format {text,json,yaml}]";
+export function entityMigrateHelp() {
+    return [
+        `usage: ${SYNTAX}`,
+        "",
+        "Inventory the complete Decision 94 entity migration graph without writing state.",
+        "Entity publication is available only through one full development-channel upgrade --yes.",
+        "",
+        "options:",
+        "  -h, --help                 Show this dedicated help message and exit",
+        "  --project PATH             Existing real project directory to inventory",
+        "  --after SOURCE_IDENTITY --source-fingerprint SHA256 --preview-digest SHA256",
+        "                              Continue the bound snapshot from a prior page",
+        "  --limit 1..1000            Bound logical identities returned on one preview page (default 100)",
+        "  --dry-run                  Read-only inventory and preview",
+        "  --format {text,json,yaml}  Output format (default text)",
+    ].join("\n");
+}
+function parse(argv, cwd) {
+    const args = { project: cwd, dryRun: false, format: "text" };
+    const values = new Map([
+        ["--project", "project"], ["--after", "after"], ["--limit", "limit"], ["--source-fingerprint", "sourceFingerprint"], ["--preview-digest", "previewDigest"], ["--format", "format"],
+    ]);
+    const seen = new Set();
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--dry-run") {
+            if (seen.has(token))
+                return `${token} may only be supplied once`;
+            seen.add(token);
+            args.dryRun = true;
+            continue;
+        }
+        const pair = [...values].find(([flag]) => token === flag || token.startsWith(`${flag}=`));
+        if (!pair)
+            return `unrecognized argument '${token}'`;
+        const [flag, field] = pair;
+        if (seen.has(flag))
+            return `${flag} may only be supplied once`;
+        seen.add(flag);
+        const value = token.startsWith(`${flag}=`) ? token.slice(flag.length + 1) : argv[++index];
+        if (!value || value.startsWith("--"))
+            return `${flag} requires a value`;
+        if (field === "limit") {
+            if (!/^[1-9][0-9]*$/.test(value) || Number(value) > 1000)
+                return "--limit must be between 1 and 1000";
+            args.limit = Number(value);
+        }
+        else if (field === "format") {
+            if (!["text", "json", "yaml"].includes(value))
+                return "--format must be text, json, or yaml";
+            args.format = value;
+        }
+        else if (field === "project")
+            args.project = value;
+        else if (field === "after")
+            args.after = value;
+        else if (field === "sourceFingerprint")
+            args.sourceFingerprint = value;
+        else
+            args.previewDigest = value;
+    }
+    if (!args.dryRun)
+        return "--dry-run is required; entity apply is owned by one full development-channel upgrade --yes";
+    if (args.after && (!/^[a-f0-9]{64}$/.test(args.sourceFingerprint ?? "") || !/^[a-f0-9]{64}$/.test(args.previewDigest ?? "")))
+        return "--after requires the prior page's --source-fingerprint SHA256 and --preview-digest SHA256";
+    if (!args.after && (args.sourceFingerprint || args.previewDigest))
+        return "--source-fingerprint and --preview-digest are only valid with --after";
+    return args;
+}
+function output(value, format, io) {
+    const out = io.out ?? ((text) => process.stdout.write(text));
+    if (format !== "text") {
+        emitStructured(value, format, out);
+        return;
+    }
+    const counts = value.counts;
+    const error = value.error;
+    const diagnostics = Array.isArray(value.diagnostics) ? value.diagnostics : [];
+    const classes = counts ? ["verified_full", "recoverable_degraded_full_projection", "valid_compacted_summary", "duplicate", "conflict", "corrupt", "unsupported"].map((name) => `${name}=${counts[name] ?? 0}`).join(", ") : "unavailable";
+    const sink = error ? io.err ?? ((text) => process.stderr.write(text)) : out;
+    sink([
+        `status: ${String(value.status)}`,
+        `command: ${String(value.command)}`,
+        `classes: ${classes}`,
+        `physical_records: ${counts?.physical_records ?? "unavailable"}; logical_identities: ${counts?.logical_identities ?? "unavailable"}; mirrors: ${counts?.mirrors ?? "unavailable"}; duplicates: ${counts?.duplicates ?? "unavailable"}; conflicts: ${counts?.conflicts ?? "unavailable"}`,
+        `relationships: ${counts?.relationships ?? "unavailable"}; unresolved_relationships: ${counts?.unresolved_relationships ?? "unavailable"}; root_blockers: ${counts?.root_blockers ?? "unavailable"}; dependent_blockers: ${counts?.dependent_blockers ?? "unavailable"}; blockers: ${counts?.blockers ?? "unavailable"}`,
+        `omission: omitted=${String(value.omitted ?? false)}, entries=${String(value.omitted_count ?? 0)}, diagnostics=${String(value.diagnostics_omitted_count ?? 0)}, reason=${String(value.omission_reason ?? "none")}`,
+        `source_fingerprint: ${String(value.source_fingerprint ?? "unavailable")}`,
+        `preview_digest: ${String(value.preview_digest ?? "unavailable")}`,
+        ...diagnostics.map((diagnostic) => [
+            `blocker ${String(diagnostic.classification)} ${String(diagnostic.source_identity)}`,
+            diagnostic.root_source_identity === undefined ? "" : ` root_source_identity=${String(diagnostic.root_source_identity)}`,
+            `: ${String(diagnostic.message)}; recovery: ${String(diagnostic.recovery)}`,
+        ].join("")),
+        `recovery: ${String(error?.recovery ?? value.retrieval?.command ?? "none")}`,
+        "",
+    ].join("\n"));
+}
+export function runEntityMigrate(argv, io, cwd = process.cwd(), sourceRoot = resolveSourceRoot()) {
+    if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
+        (io.out ?? ((text) => process.stdout.write(text)))(`${entityMigrateHelp()}\n`);
+        return 0;
+    }
+    const parsed = parse(argv, cwd);
+    const requested = argv.includes("--format") ? argv[argv.indexOf("--format") + 1] : argv.find((item) => item.startsWith("--format="))?.slice(9);
+    const format = requested === "json" || requested === "yaml" ? requested : "text";
+    if (typeof parsed === "string") {
+        const body = { schemaVersion: "agentera.invalidInputEnvelope.v2", command: "state migrate entities", status: "fail", error: { class: "invalid_request", message: parsed, syntax: SYNTAX, example: "agentera state migrate entities --dry-run --format json", recovery: "Correct the command and retry; no state was changed." } };
+        if (format === "text")
+            (io.err ?? ((text) => process.stderr.write(text)))(`${parsed}\nSyntax: ${SYNTAX}\n`);
+        else
+            output(body, format, io);
+        return 2;
+    }
+    try {
+        const preview = previewEntityMigration(path.resolve(parsed.project), sourceRoot, { limit: parsed.limit, after: parsed.after, sourceFingerprint: parsed.sourceFingerprint, previewDigest: parsed.previewDigest });
+        output(preview, parsed.format, io);
+        return preview.status === "ready" ? 0 : 1;
+    }
+    catch (error) {
+        const continuation = error instanceof EntityMigrationContinuationError;
+        const body = { schemaVersion: "agentera.entityMigrationFailure.v1", command: "state migrate entities", status: "fail", read_only: true, mutation_performed: false, error: { class: continuation ? error.classification : "inventory_failed", message: error.message, recovery: continuation ? error.restartCommand : "Choose an existing, real directory inside the intended checkout, repair the reported source, then rerun agentera state migrate entities --project PATH --dry-run --format json; no state was changed." } };
+        output(body, parsed.format, io);
+        return 1;
+    }
+}
+//# sourceMappingURL=entityMigrate.js.map

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

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

package/dist/cli/commands/lint.js

@@ -9,29 +9,7 @@ const LINT_CHECKS = [
     ["abstraction", "Add a concrete anchor such as a path, line number, metric, command, identifier, or quote."],
     ["filler", "Remove the named filler phrase category before writing the artifact."],
 ];
-const LINT_CANONICAL_LABELS = {
-    changelog: "CHANGELOG.md",
-    decisions: "DECISIONS.md",
-    design: "DESIGN.md",
-    docs: "DOCS.md",
-    health: "HEALTH.md",
-    plan: "PLAN.md",
-    progress: "PROGRESS.md",
-    todo: "TODO.md",
-    vision: "VISION.md",
-    experiments: "EXPERIMENTS.md",
-};
-const VALIDATE_ARTIFACT_LABELS = [
-    "CHANGELOG.md",
-    "DECISIONS.md",
-    "DESIGN.md",
-    "DOCS.md",
-    "HEALTH.md",
-    "PLAN.md",
-    "PROGRESS.md",
-    "TODO.md",
-    "VISION.md",
-];
+import { VALIDATE_ARTIFACT_PROTOCOL_IDS, normalizeArtifactProtocolId } from "../../registries/artifactProtocolIds.js";
 function lintSchemaName(artifact, schemas) {
     if (artifact in schemas)
         return artifact;
@@ -48,24 +26,14 @@ function lintSchemaName(artifact, schemas) {
         return stem;
     return null;
 }
-function lintCanonicalLabel(schemaName, info, artifact) {
-    if (schemaName in LINT_CANONICAL_LABELS)
-        return LINT_CANONICAL_LABELS[schemaName];
-    const record = info.record;
-    if (record && record.displayName)
-        return record.displayName;
-    if (VALIDATE_ARTIFACT_LABELS.includes(artifact))
-        return artifact;
-    const upper = artifact.trim().toUpperCase();
-    if (VALIDATE_ARTIFACT_LABELS.includes(upper))
-        return upper;
-    return artifact;
+function lintCanonicalLabel(schemaName, _info, artifact) {
+    return normalizeArtifactProtocolId(artifact) ?? schemaName;
 }
 function resolveLintArtifactFile(artifact) {
     const schemas = loadSchemas(discoverSchemasDir());
     const schemaName = lintSchemaName(artifact, schemas);
     if (schemaName === null) {
-        const validLabels = VALIDATE_ARTIFACT_LABELS.join(", ");
+        const validLabels = VALIDATE_ARTIFACT_PROTOCOL_IDS.join(", ");
         throw new Error(`unsupported artifact ${pyRepr(artifact)}; provide --file or --text, ` +
             "or use a schema name from `agentera query --list-artifacts` " +
             `or a canonical label (${validLabels})`);
@@ -112,6 +80,9 @@ function isFileSafe(p) {
         return false;
     }
 }
+function isVerbosityAuthorityError(detail) {
+    return detail.startsWith("verbosity authority error");
+}
 function lintChecks(text, artifact, fullArtifact) {
     const verbosityCheck = fullArtifact ? checkFullFileVerbosity(text, artifact) : checkVerbosity(text, artifact);
     const raw = {
@@ -127,14 +98,16 @@ function lintChecks(text, artifact, fullArtifact) {
             name,
             status: passed ? "pass" : "fail",
             detail,
-            action: passed ? "" : actions[name],
+            action: passed
+                ? ""
+                : name === "verbosity" && isVerbosityAuthorityError(detail)
+                    ? "Repair the verbosity budget authority or its owning artifact schema, then retry lint."
+                    : actions[name],
         });
     }
     return checks;
 }
-export function lintPayload(args) {
-    const [text, source, fullArtifact, budgetArtifact] = lintInputText(args);
-    const artifact = budgetArtifact || String(args.artifact);
+function lintPayloadForContent(artifact, text, source, fullArtifact, strict = false) {
     validateAgentString(artifact, "artifact");
     const checks = lintChecks(text, artifact, fullArtifact);
     const failures = checks.filter((c) => c.status === "fail");
@@ -143,15 +116,24 @@ export function lintPayload(args) {
         status: failures.length > 0 ? "fail" : "pass",
         artifact,
         source,
-        strict: Boolean(args.strict),
+        strict,
         checks,
         summary: {
             failed: failures.length,
             passed: checks.length - failures.length,
-            advisory: !args.strict,
+            advisory: !strict,
         },
     };
 }
+/** Runs the same full-artifact checks as `check lint --file` without a staging file. */
+export function lintFullArtifactPayload(artifact, content) {
+    return lintPayloadForContent(artifact, content, "candidate", true, true);
+}
+export function lintPayload(args) {
+    const [text, source, fullArtifact, budgetArtifact] = lintInputText(args);
+    const artifact = budgetArtifact || String(args.artifact);
+    return lintPayloadForContent(artifact, text, source, fullArtifact, Boolean(args.strict));
+}
 function emitLintText(payload, out) {
     const failures = payload.checks.filter((c) => c.status === "fail");
     out(`lint ${payload.status}: ${payload.artifact} (${payload.source})\n`);
@@ -174,6 +156,7 @@ export function cmdLint(args, io = {}) {
     else {
         emitLintText(payload, out);
     }
-    return payload.status === "fail" ? 1 : 0;
+    const operationalFailure = payload.checks.some((check) => check.status === "fail" && isVerbosityAuthorityError(check.detail));
+    return operationalFailure || (args.strict && payload.status === "fail") ? 1 : 0;
 }
 //# sourceMappingURL=lint.js.map