agentera 3.0.0-dev.7 → 3.0.0-dev.74

package/dist/validate/appHomeContract.js

@@ -11,13 +11,8 @@ 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",
     "packages/cli/src/capabilities/status/instructions.ts",
-    "skills/agentera/references/contract.md",
 ];
 export const CLI_HELP_COMMANDS = [
     ["--help"],
@@ -31,7 +26,7 @@ export const CLI_OUTPUT_COMMANDS = [
     ["doctor", "--json"],
     ["upgrade", "--only", "bundle", "--dry-run"],
     ["upgrade", "--only", "bundle", "--dry-run", "--json"],
-    ["upgrade", "--only", "runtime", "--runtime", "claude", "--dry-run"],
+    ["upgrade", "--only", "runtime", "--runtime", "opencode", "--dry-run"],
 ];
 const FORBIDDEN = [
     [/\bbundle[- ]root\b/i, "bundle-root wording"],
@@ -147,4 +142,3 @@ export function validate(root, opts = {}) {
     }
     return errors;
 }
-//# sourceMappingURL=appHomeContract.js.map

package/dist/validate/bootstrapAuthority.js

@@ -0,0 +1,44 @@
+/** Production authority for the source/package bootstrap evidence matrix. */
+export const BOOTSTRAP_RUNTIME_IDS = Object.freeze(["source", "package"]);
+export const BOOTSTRAP_PROJECT_STATE_IDS = Object.freeze(["clean", "v2", "partial", "v3"]);
+const spec = (id, states, classification, candidate) => Object.freeze({ id, states: Object.freeze([...states]), classification, ...(candidate ? { candidate } : {}) });
+export const BOOTSTRAP_ACCEPTED_SPECS = Object.freeze([
+    spec("prime-quoted-lf", ["clean"], "accepted"),
+    spec("prime-quoted-cr", ["v2"], "accepted"),
+    spec("prime", ["partial", "v3"], "accepted"),
+    spec("recommended-startup", BOOTSTRAP_PROJECT_STATE_IDS, "accepted"),
+    spec("doctor-quoted-lf", ["clean"], "accepted"),
+    spec("doctor-quoted-cr", ["v2"], "accepted"),
+    spec("doctor", ["partial", "v3"], "accepted"),
+    spec("recovery-0", ["clean", "v2", "partial"], "accepted"),
+]);
+export const BOOTSTRAP_REJECTION_SPECS = Object.freeze([
+    spec("reject-bare", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "agentera prime --context status --format json"),
+    spec("reject-bare-next", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "agentera@next prime --context status --format json"),
+    spec("reject-stable", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "npx -y agentera@latest prime --context status --format json"),
+    spec("reject-stable-bare", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "agentera@latest prime --context status --format json"),
+    spec("reject-npx-no-y", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "npx agentera@next prime --context status --format json"),
+    spec("reject-split-selector", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "npx -y agentera @next prime --context status --format json"),
+    spec("reject-missing-format", BOOTSTRAP_PROJECT_STATE_IDS, "not_exact", "npx -y agentera@next prime --context status"),
+    spec("reject-reordered", BOOTSTRAP_PROJECT_STATE_IDS, "not_exact", "npx -y agentera@next prime --format json --context status"),
+    spec("reject-env-wrapper", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "env npx -y agentera@next prime --context status --format json"),
+    spec("reject-time-wrapper", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "time npx -y agentera@next prime --context status --format json"),
+    spec("reject-eval-wrapper", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "eval 'npx -y agentera@next prime --context status --format json'"),
+    spec("reject-bash-wrapper", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "bash -c 'npx -y agentera@next prime --context status --format json'"),
+    spec("reject-alias", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "a prime --context status --format json"),
+    spec("reject-function", BOOTSTRAP_PROJECT_STATE_IDS, "malformed", "agentera() { :; }; agentera prime --context status --format json"),
+    spec("reject-nested", BOOTSTRAP_PROJECT_STATE_IDS, "not_exact", "npx -y agentera@next prime --context 'bash -c whoami' --format json"),
+    spec("reject-composition", BOOTSTRAP_PROJECT_STATE_IDS, "malformed", "npx -y agentera@next prime --context status --format json && whoami"),
+    spec("reject-multiple", BOOTSTRAP_PROJECT_STATE_IDS, "malformed", "npx -y agentera@next prime --context status --format json; npx -y agentera@next doctor"),
+    spec("reject-substitution", BOOTSTRAP_PROJECT_STATE_IDS, "malformed", "npx -y agentera@next prime --context $(whoami) --format json"),
+    spec("reject-malformed-quote", BOOTSTRAP_PROJECT_STATE_IDS, "malformed", "npx -y agentera@next prime --context 'status --format json"),
+    spec("reject-malformed-channel", BOOTSTRAP_PROJECT_STATE_IDS, "wrong_channel", "npx -y agentera@next@latest prime --context status --format json"),
+]);
+export function bootstrapMatrixAuthority() {
+    return {
+        runtimeIds: [...BOOTSTRAP_RUNTIME_IDS],
+        stateIds: [...BOOTSTRAP_PROJECT_STATE_IDS],
+        accepted: BOOTSTRAP_ACCEPTED_SPECS.map((entry) => ({ ...entry, states: [...entry.states] })),
+        rejections: BOOTSTRAP_REJECTION_SPECS.map((entry) => ({ ...entry, states: [...entry.states] })),
+    };
+}

package/dist/validate/capability.js

@@ -191,8 +191,10 @@ export function checkTriggerPriorities(groups, sourceLabel, contract) {
 /**
  * V7 trigger-entry enrichment validation. Enforces the four optional fields
  * declared in TRIGGER_ENRICHMENT in capability_schema_contract.yaml. Every
- * field is OPTIONAL; a triggers.yaml entry that omits all enriched fields
- * passes (backward compatibility per spec §6). Error messages include the
+ * field is OPTIONAL; a triggers.yaml entry that omits all compatibility fields
+ * passes. The hybrid route contract limits these fields to the semantic phase
+ * after deterministic abstention while this validator preserves legacy
+ * enriched-file compatibility. Error messages include the
  * valid range/value and the offending entry ID so authors can locate the
  * violation without grepping the contract.
  */
@@ -212,6 +214,13 @@ export function checkTriggerEnrichment(groups, sourceLabel, contract) {
         }
         const entryId = entry.id ?? key;
         const location = `TRIGGERS entry ${key} (${entryId}) in ${sourceLabel}`;
+        if (entry.patterns !== undefined) {
+            const value = entry.patterns;
+            if (!Array.isArray(value) || !value.every((pattern) => typeof pattern === "string")) {
+                errors.push(`V7 [error]: ${location} has patterns=${valueRepr(value)} ` +
+                    `(must be a list of strings)`);
+            }
+        }
         if (entry.confidence_threshold !== undefined) {
             const value = entry.confidence_threshold;
             const min = confidenceField.min ?? 0;
@@ -530,4 +539,3 @@ export function checkPrimitiveReferences(capDir, protocolPath, contractPath = "s
     }
     return errors;
 }
-//# sourceMappingURL=capability.js.map

package/dist/validate/crossCapability.js

@@ -2,21 +2,22 @@ import fs from "node:fs";
 import path from "node:path";
 import { loadYamlMapping } from "../core/yaml.js";
 import { resolveSourceRoot } from "../core/sourceRoot.js";
-import { artifactSchemasDir as defaultArtifactSchemasDir, loadArtifactRegistry, } from "../registries/artifactRegistry.js";
+import { artifactSchemasDir as defaultArtifactSchemasDir, loadArtifactRegistry, registryModelPath as defaultRegistryModelPath, } from "../registries/artifactRegistry.js";
 function capabilitiesDirDefault() {
     return path.join(resolveSourceRoot(), "skills", "agentera", "capabilities");
 }
 function loadYaml(p) {
     return loadYamlMapping(fs.readFileSync(p, "utf8")); // cast: YAML parse IO boundary
 }
-export function loadCanonicalArtifacts(artifactSchemasDir = defaultArtifactSchemasDir()) {
+export function loadCanonicalArtifacts(artifactSchemasDir = defaultArtifactSchemasDir(), registryModelPathArg = defaultRegistryModelPath()) {
     const out = new Map();
-    for (const [artifactId, record] of loadArtifactRegistry(artifactSchemasDir)) {
+    for (const [artifactId, record] of loadArtifactRegistry(artifactSchemasDir, registryModelPathArg)) {
         out.set(artifactId, {
             artifactId: record.artifactId,
             displayName: record.displayName,
             producers: record.producers,
             consumers: record.consumers,
+            implementationStatus: record.implementationStatus,
         });
     }
     return out;
@@ -47,7 +48,7 @@ export function loadCapabilityArtifacts(capabilitiesDir = capabilitiesDirDefault
                 continue;
             }
             const e = entry;
-            const artifactId = String(e.artifact_id ?? "").trim();
+            const artifactId = String(e.artifact ?? "").trim();
             const localRole = String(e.local_role ?? "").trim();
             if (!artifactId) {
                 continue;
@@ -102,9 +103,12 @@ function sortedListRepr(s) {
     const arr = [...s].sort();
     return "[" + arr.map((v) => `'${v}'`).join(", ") + "]";
 }
-export function validateGraph(artifactSchemasDir = defaultArtifactSchemasDir(), capabilitiesDir = capabilitiesDirDefault()) {
-    const registry = loadArtifactRegistry(artifactSchemasDir);
-    const canonical = loadCanonicalArtifacts(artifactSchemasDir);
+export function validateGraph(artifactSchemasDir = defaultArtifactSchemasDir(), capabilitiesDir = capabilitiesDirDefault(), registryModelPathArg = defaultRegistryModelPath()) {
+    // Thread the same model path into both registry loads so a synthetic
+    // test fixture (or a non-default install) resolves the same identity set in
+    // the canonical map and the dependency-graph walk below.
+    const registry = loadArtifactRegistry(artifactSchemasDir, registryModelPathArg);
+    const canonical = loadCanonicalArtifacts(artifactSchemasDir, registryModelPathArg);
     const capabilityArtifacts = loadCapabilityArtifacts(capabilitiesDir);
     const capabilityNames = new Set(listCapabilityDirs(capabilitiesDir));
     const errors = [];
@@ -116,7 +120,7 @@ export function validateGraph(artifactSchemasDir = defaultArtifactSchemasDir(),
         byArtifactId.get(record.artifactId).push(record);
         const name = displayName(record, registry);
         if (!canonical.has(record.artifactId)) {
-            errors.push(`${record.capability}: unknown artifact_id '${record.artifactId}'`);
+            errors.push(`${record.capability}: unknown artifact '${record.artifactId}'`);
             continue;
         }
         if (record.producers.size === 0 && record.consumers.size === 0) {
@@ -124,6 +128,8 @@ export function validateGraph(artifactSchemasDir = defaultArtifactSchemasDir(),
         }
     }
     for (const [artifactId, artifact] of canonical) {
+        if (artifact.implementationStatus === "declared_deferred")
+            continue;
         const records = byArtifactId.get(artifactId) ?? [];
         const producedBy = records.length ? unionSets(records.map((r) => r.producers)) : new Set();
         const consumedBy = records.length ? unionSets(records.map((r) => r.consumers)) : new Set();
@@ -142,4 +148,3 @@ export function validateGraph(artifactSchemasDir = defaultArtifactSchemasDir(),
     }
     return errors;
 }
-//# sourceMappingURL=crossCapability.js.map