agentera 3.0.0-dev.5 → 3.0.0-dev.51

package/dist/validate/activationEvidenceManifest.js

@@ -0,0 +1,515 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { ACTIVATION_CENSUS_AUTHORITY, ACTIVATION_CHECK_IDS, } from "../registries/packagePublication.js";
+import { ACTIVATION_CANONICAL_TUPLES, ACTIVATION_TUPLE_AUTHORITY, } from "../registries/activationTuples.js";
+import { DEVELOPMENT_RUNTIME_REQUIRED_FILES } from "../core/developmentInvocation.js";
+import { GENERATED_OWNER_EVIDENCE_SCHEMA, PACKAGE_OWNER_EVIDENCE_SCHEMA, SOURCE_OWNER_EVIDENCE_SCHEMA, activationPackageIdentityViolations, activationSourceDigest, canonicalObservationJson, createGeneratedOwnerEvidence, createSourceOwnerEvidence, observationDigest, } from "./activationArtifactEvidence.js";
+export { activationSourceDigest } from "./activationArtifactEvidence.js";
+export const ACTIVATION_EVIDENCE_SCHEMA = "agentera.activationEvidence.v1";
+export const ACTIVATION_EVIDENCE_FILE = "activation-evidence.json";
+export const ACTIVATION_EVIDENCE_MAX_BYTES = 1_048_576;
+const CHECK_OBSERVATIONS = Object.freeze({
+    "cli.discovery": ["generic.cli.discovery"],
+    "cli.behavior": ["generic.cli.behavior"],
+    "cli.diagnostics": ["generic.cli.diagnostics"],
+    "cli.package_projection": ["generic.cli.package_projection"],
+    "cli.instructions": ["generic.cli.instructions"],
+    "cli.adversarial": ["generic.cli.adversarial"],
+    "capability.discovery": ["capability.source-modules", "capability.source-registry"],
+    "capability.behavior": ["capability.generated-served", "capability.generated-routes"],
+    "capability.diagnostics": ["capability.generated-modules", "capability.generated-schemas"],
+    "capability.package_projection": ["capability.extracted-modules", "capability.extracted-served", "capability.extracted-registry", "capability.extracted-routes", "capability.extracted-schemas"],
+    "capability.instructions": ["capability.source-runtime-registry", "capability.generated-runtime-registry", "capability.extracted-runtime-registry"],
+    "capability.adversarial": ["capability.source-routes", "capability.source-schemas", "capability.generated-registry"],
+    "runtime.discovery": ["generic.runtime.discovery"],
+    "runtime.behavior": ["generic.runtime.behavior"],
+    "runtime.diagnostics": ["generic.runtime.diagnostics"],
+    "runtime.package_projection": ["generic.runtime.package_projection"],
+    "runtime.instructions": ["generic.runtime.instructions"],
+    "runtime.adversarial": ["generic.runtime.adversarial"],
+    "reference.discovery": ["generic.reference.discovery"],
+    "reference.behavior": ["generic.reference.behavior"],
+    "reference.diagnostics": ["generic.reference.diagnostics"],
+    "reference.package_projection": ["generic.reference.package_projection"],
+    "reference.instructions": ["generic.reference.instructions"],
+    "reference.adversarial": ["generic.reference.adversarial"],
+    "state.discovery": ["generic.state.discovery"],
+    "state.behavior": ["generic.state.behavior"],
+    "state.diagnostics": ["generic.state.diagnostics"],
+    "state.package_projection": ["generic.state.package_projection"],
+    "state.instructions": ["generic.state.instructions"],
+    "state.adversarial": ["generic.state.adversarial"],
+    "package.discovery": ["package.source-registry"],
+    "package.behavior": ["package.source-construction", "package.generated-construction"],
+    "package.diagnostics": ["package.command-policy"],
+    "package.package_projection": ["package.generated-registry", "package.extracted-artifact", "package.extracted-registry"],
+    "package.instructions": ["package.source-selectors", "package.generated-selectors"],
+    "package.adversarial": ["package.portability", "package.adversarial"],
+    "bootstrap.discovery": ["bootstrap.source-authority"],
+    "bootstrap.behavior": ["bootstrap.generated-binder"],
+    "bootstrap.diagnostics": ["bootstrap.generated-diagnostics", "bootstrap.extracted-diagnostics"],
+    "bootstrap.package_projection": ["bootstrap.extracted-classifications", "bootstrap.source-package-parity"],
+    "bootstrap.instructions": ["bootstrap.generated-startup", "bootstrap.generated-declarations", "bootstrap.extracted-startup", "bootstrap.extracted-declarations"],
+    "bootstrap.adversarial": ["bootstrap.missing-surface"],
+});
+const SOURCE_PROVENANCE = {
+    "capability.source-modules": ["capability-source-modules", "packages/cli/src/capabilities/*/instructions.ts"],
+    "capability.source-runtime-registry": ["capability-source-runtime-registry", "packages/cli/src/capabilities/index.ts#CAPABILITY_INSTRUCTIONS"],
+    "capability.source-registry": ["capability-source-registry", "registry.json#skills[0].capabilities"],
+    "capability.source-routes": ["capability-source-routes", "packages/cli/src/cli/commands/capability.ts#CAPABILITY_ROUTING_NAMES"],
+    "capability.source-schemas": ["capability-source-schemas", "skills/agentera/capabilities/*/schemas"],
+    "package.source-registry": ["package-source-registry", "references/adapters/package-registry.yaml#records[agentera]"],
+    "package.source-construction": ["package-source-construction", "references/adapters/package-registry.yaml#records[agentera].bundle_surfaces"],
+    "package.source-selectors": ["package-source-selectors", "references/adapters/package-registry.yaml#records[agentera].semantic_fields"],
+    "bootstrap.source-authority": ["bootstrap-source-authority", "packages/cli/src/validate/bootstrapAuthority.ts#bootstrapMatrixAuthority"],
+};
+const GENERATED_PROVENANCE = {
+    "capability.generated-modules": ["capability-generated-modules", "generation/dist/capabilities/*/instructions.js"],
+    "capability.generated-runtime-registry": ["capability-generated-runtime-registry", "generation/dist/capabilities/index.js#CAPABILITY_INSTRUCTIONS"],
+    "capability.generated-served": ["capability-generated-served", "generation/dist/bin/agentera.js#prime-context"],
+    "capability.generated-registry": ["capability-generated-registry", "generation/bundle/registry.json#skills[0].capabilities"],
+    "capability.generated-routes": ["capability-generated-routes", "generation/dist/cli/commands/capability.js#CAPABILITY_ROUTING_NAMES"],
+    "capability.generated-schemas": ["capability-generated-schemas", "generation/bundle/skills/agentera/capabilities/*/schemas"],
+    "package.generated-construction": ["package-generated-construction", "generation/package-construction-markers"],
+    "package.generated-registry": ["package-generated-registry", "generation/bundle/references/adapters/package-registry.yaml#records[agentera]"],
+    "package.generated-selectors": ["package-generated-selectors", "generation/bundle/references/adapters/package-registry.yaml#semantic_fields"],
+    "bootstrap.generated-binder": ["bootstrap-generated-binder", "generation/dist/core/developmentInvocation.js#bindDevelopmentInvocation"],
+    "bootstrap.generated-diagnostics": ["bootstrap-generated-diagnostics", "generation/dist/core/developmentInvocation.js#DevelopmentInvocationError"],
+    "bootstrap.generated-startup": ["bootstrap-generated-startup", "generation/dist/bin/agentera.js#startup-producers"],
+    "bootstrap.generated-declarations": ["bootstrap-generated-declarations", "generation/bundle/references/adapters/package-registry.yaml#bootstrap_command_authority"],
+    "generic.cli.package_projection": ["cli-package-projection", "generation/dist/cli/dispatch/projections.js"],
+};
+const PACKAGE_PROVENANCE = {
+    "capability.extracted-modules": ["capability-extracted-modules", "package/dist/capabilities/*/instructions.js"],
+    "capability.extracted-runtime-registry": ["capability-extracted-runtime-registry", "package/dist/capabilities/index.js#CAPABILITY_INSTRUCTIONS"],
+    "capability.extracted-served": ["capability-extracted-served", "package/dist/bin/agentera.js#prime-context"],
+    "capability.extracted-registry": ["capability-extracted-registry", "package/bundle/registry.json#skills[0].capabilities"],
+    "capability.extracted-routes": ["capability-extracted-routes", "package/dist/cli/commands/capability.js#CAPABILITY_ROUTING_NAMES"],
+    "capability.extracted-schemas": ["capability-extracted-schemas", "package/bundle/skills/agentera/capabilities/*/schemas"],
+    "package.extracted-artifact": ["package-extracted-artifact", "npm-tarball/extracted-package"],
+    "package.extracted-registry": ["package-extracted-registry", "package/bundle/references/adapters/package-registry.yaml#records[agentera]"],
+    "package.command-policy": ["package-command-policy", "package/runtime-matrix/classifications"],
+    "package.portability": ["package-portability", "npm-tarball/path-portability"],
+    "package.adversarial": ["package-adversarial", "package/runtime-matrix/rejections"],
+    "bootstrap.extracted-classifications": ["bootstrap-extracted-classifications", "package/runtime-matrix/rows"],
+    "bootstrap.extracted-diagnostics": ["bootstrap-extracted-diagnostics", "package/runtime-matrix/rejection-diagnostics"],
+    "bootstrap.extracted-startup": ["bootstrap-extracted-startup", "package/dist/bin/agentera.js#startup-producers"],
+    "bootstrap.extracted-declarations": ["bootstrap-extracted-declarations", "package/bundle/references/adapters/package-registry.yaml#bootstrap_command_authority"],
+    "bootstrap.source-package-parity": ["bootstrap-source-package-parity", "package/runtime-matrix/parity"],
+    "bootstrap.missing-surface": ["bootstrap-missing-surface", "package/runtime-matrix/missing-required-surfaces"],
+};
+for (const classId of ["cli", "runtime", "reference", "state"]) {
+    for (const dimension of ["discovery", "behavior", "diagnostics", "instructions", "adversarial"]) {
+        SOURCE_PROVENANCE[`generic.${classId}.${dimension}`] = [`${classId}-${dimension}-source-observation`, `${classId}.${dimension}`];
+    }
+}
+for (const classId of ["runtime", "reference", "state"]) {
+    PACKAGE_PROVENANCE[`generic.${classId}.package_projection`] = [`${classId}-package-projection`, `package/${classId}/projection`];
+}
+const PROVENANCE = Object.freeze(Object.fromEntries([
+    ...Object.entries(SOURCE_PROVENANCE).map(([ref, [artifactClass, artifactIdentity]]) => [ref, { producerKind: "source-owner", artifactClass, artifactIdentity }]),
+    ...Object.entries(GENERATED_PROVENANCE).map(([ref, [artifactClass, artifactIdentity]]) => [ref, { producerKind: "generated-owner", artifactClass, artifactIdentity }]),
+    ...Object.entries(PACKAGE_PROVENANCE).map(([ref, [artifactClass, artifactIdentity]]) => [ref, { producerKind: "package-owner", artifactClass, artifactIdentity }]),
+]));
+function hash(value) { return createHash("sha256").update(value).digest("hex"); }
+function digestIdentities(values) { return hash([...values].sort().join("\n")); }
+function allRecords(producers) {
+    const entries = [
+        ...Object.entries(producers.source.records),
+        ...Object.entries(producers.generated.records),
+        ...Object.entries(producers.package.records),
+    ];
+    return new Map(entries);
+}
+function capabilityParity(producers) {
+    const records = allRecords(producers);
+    const bodyRefs = [
+        "capability.source-modules", "capability.source-runtime-registry",
+        "capability.generated-modules", "capability.generated-runtime-registry", "capability.generated-served",
+        "capability.extracted-modules", "capability.extracted-runtime-registry", "capability.extracted-served",
+    ];
+    const identityRefs = [
+        "capability.source-registry", "capability.source-routes", "capability.source-schemas",
+        "capability.generated-registry", "capability.generated-routes", "capability.generated-schemas",
+        "capability.extracted-registry", "capability.extracted-routes", "capability.extracted-schemas",
+    ];
+    return {
+        bodies: bodyRefs.map((ref) => ({ ref, content: records.get(ref)?.content ?? null })),
+        identities: identityRefs.map((ref) => ({ ref, content: records.get(ref)?.content ?? null })),
+    };
+}
+function packageSemanticParity(producers) {
+    const records = allRecords(producers);
+    return ["package.source-registry", "package.source-selectors", "package.generated-registry", "package.generated-selectors", "package.extracted-registry"]
+        .map((ref) => {
+        const content = records.get(ref)?.content;
+        return { ref, content: content?.semanticSelectors ?? content ?? null };
+    });
+}
+function packageArtifact(producers) {
+    const content = producers.package.records["package.extracted-artifact"]?.content;
+    return {
+        filename: content?.filename ?? "missing",
+        integrity: content?.integrity ?? "missing",
+        shasum: content?.shasum ?? "missing",
+        tarballSha256: content?.tarballSha256 ?? "missing",
+    };
+}
+export function createActivationEvidenceManifest(options) {
+    const producers = { source: options.sourceEvidence, generated: options.generatedEvidence, package: options.packageEvidence };
+    const records = allRecords(producers);
+    const checks = ACTIVATION_CHECK_IDS.map((id) => {
+        const [classId, dimension] = id.split(".");
+        const identities = [...(options.productionEvidence.classes[classId]?.dimensions[dimension]?.identities ?? [])].sort();
+        const observationRefs = [...(CHECK_OBSERVATIONS[id] ?? [])];
+        return {
+            id,
+            identities,
+            identityDigest: digestIdentities(identities),
+            observationRefs,
+            observationDigest: observationDigest(observationRefs.map((ref) => records.get(ref)?.content ?? null)),
+        };
+    });
+    const unsigned = {
+        schemaVersion: ACTIVATION_EVIDENCE_SCHEMA,
+        generation: options.generation,
+        currentSourceDigest: activationSourceDigest(options.root),
+        packageArtifact: packageArtifact(producers),
+        tupleDigest: ACTIVATION_TUPLE_AUTHORITY.total.sha256,
+        producers,
+        capabilityParityDigest: observationDigest(capabilityParity(producers)),
+        packageSemanticParityDigest: observationDigest(packageSemanticParity(producers)),
+        checks,
+    };
+    return { ...unsigned, manifestDigest: observationDigest(unsigned) };
+}
+function validateOwnerEvidence(owner, producerKind, schemaVersion, sourceDigest, generation, packageIntegrity, violations) {
+    if (!owner || owner.schemaVersion !== schemaVersion || owner.producerKind !== producerKind) {
+        violations.push(`${producerKind} evidence schema or producer is wrong`);
+        return;
+    }
+    const { evidenceDigest, ...unsigned } = owner;
+    if (observationDigest(unsigned) !== evidenceDigest)
+        violations.push(`${producerKind} evidence digest mismatched`);
+    if (owner.sourceDigest !== sourceDigest)
+        violations.push(`${producerKind} evidence source provenance is stale or wrong`);
+    if (producerKind === "generated-owner" && owner.generation !== generation)
+        violations.push("generated-owner evidence generation is stale or wrong");
+    if (producerKind !== "generated-owner" && owner.generation !== null)
+        violations.push(`${producerKind} evidence must not claim a generation`);
+    if (producerKind === "package-owner" && owner.packageIntegrity !== packageIntegrity)
+        violations.push("package-owner evidence integrity is wrong");
+    if (producerKind !== "package-owner" && owner.packageIntegrity !== null)
+        violations.push(`${producerKind} evidence must not claim package integrity`);
+    const expectedRefs = Object.entries(PROVENANCE).filter(([, authority]) => authority.producerKind === producerKind).map(([ref]) => ref).sort();
+    const actualRefs = Object.keys(owner.records ?? {}).sort();
+    if (canonicalObservationJson(actualRefs) !== canonicalObservationJson(expectedRefs))
+        violations.push(`${producerKind} evidence records are missing, duplicated, or unknown`);
+    for (const [ref, record] of Object.entries(owner.records ?? {})) {
+        const authority = PROVENANCE[ref];
+        if (!authority || record.producerKind !== authority.producerKind || record.artifactClass !== authority.artifactClass || record.artifactIdentity !== authority.artifactIdentity) {
+            violations.push(`activation evidence record '${ref}' has wrong producer or artifact provenance`);
+            continue;
+        }
+        if (!/^[a-f0-9]{64}$/.test(record.artifactContentDigest) || record.observationDigest !== observationDigest(record.content)) {
+            violations.push(`activation evidence record '${ref}' content digest mismatched`);
+        }
+        if (record.generation !== owner.generation || record.packageIntegrity !== owner.packageIntegrity) {
+            violations.push(`activation evidence record '${ref}' provenance binding mismatched`);
+        }
+    }
+}
+function validateAuthoritativeOwner(actual, authoritative, violations) {
+    if (!actual)
+        return;
+    for (const [ref, expected] of Object.entries(authoritative.records)) {
+        const observed = actual.records?.[ref];
+        if (!observed || observed.artifactContentDigest !== expected.artifactContentDigest
+            || observed.observationDigest !== expected.observationDigest
+            || canonicalObservationJson(observed.content) !== canonicalObservationJson(expected.content)) {
+            violations.push(`activation evidence record '${ref}' does not match its authoritative artifact observation`);
+        }
+    }
+}
+function validateCapabilityParity(manifest, violations) {
+    const records = allRecords(manifest.producers);
+    const canonicalIds = ACTIVATION_CANONICAL_TUPLES.filter((tuple) => tuple.class === "capability").map((tuple) => tuple.surface_id).sort();
+    const bodyRefs = [
+        "capability.source-modules", "capability.source-runtime-registry",
+        "capability.generated-modules", "capability.generated-runtime-registry", "capability.generated-served",
+        "capability.extracted-modules", "capability.extracted-runtime-registry", "capability.extracted-served",
+    ];
+    const baseline = records.get(bodyRefs[0])?.content;
+    for (const ref of bodyRefs) {
+        const content = records.get(ref)?.content;
+        if (canonicalObservationJson(content?.identities) !== canonicalObservationJson(canonicalIds)
+            || canonicalObservationJson(content) !== canonicalObservationJson(baseline)
+            || !canonicalIds.every((id) => content?.bodies?.[id]?.bytes > 0 && /^[a-f0-9]{64}$/.test(content?.bodies?.[id]?.sha256 ?? ""))) {
+            violations.push(`capability body projection '${ref}' does not exactly match all canonical source bodies`);
+        }
+    }
+    for (const ref of [
+        "capability.source-registry", "capability.source-routes", "capability.source-schemas",
+        "capability.generated-registry", "capability.generated-routes", "capability.generated-schemas",
+        "capability.extracted-registry", "capability.extracted-routes", "capability.extracted-schemas",
+    ]) {
+        if (canonicalObservationJson(records.get(ref)?.content) !== canonicalObservationJson(canonicalIds)) {
+            violations.push(`capability identity projection '${ref}' does not exactly match the canonical capability set`);
+        }
+    }
+    if (manifest.capabilityParityDigest !== observationDigest(capabilityParity(manifest.producers)))
+        violations.push("capability parity digest mismatched");
+}
+function validatePackageSemantics(manifest, violations) {
+    const parity = packageSemanticParity(manifest.producers);
+    const canonical = ACTIVATION_CANONICAL_TUPLES.filter((tuple) => tuple.class === "package")
+        .map((tuple) => `${tuple.surface_id}\0${tuple.semantic_selector_if_any}`)
+        .sort();
+    for (const { ref, content } of parity) {
+        if (canonicalObservationJson(content) !== canonicalObservationJson(canonical)) {
+            violations.push(`package semantic projection '${ref}' does not match the immutable tuple catalog`);
+        }
+    }
+    if (manifest.packageSemanticParityDigest !== observationDigest(parity))
+        violations.push("package semantic parity digest mismatched");
+}
+function validateExecutedArtifactSemantics(manifest, violations) {
+    const records = allRecords(manifest.producers);
+    const artifact = records.get("package.extracted-artifact")?.content;
+    if (!artifact || canonicalObservationJson({
+        filename: artifact.filename,
+        integrity: artifact.integrity,
+        shasum: artifact.shasum,
+        tarballSha256: artifact.tarballSha256,
+    }) !== canonicalObservationJson(manifest.packageArtifact))
+        violations.push("extracted package artifact identity does not bind the manifest package identity");
+    if (artifact?.manifest?.path !== "package.json" || artifact?.manifest?.type !== "file"
+        || !Number.isInteger(artifact?.manifest?.mode) || !/^[a-f0-9]{64}$/.test(artifact?.manifest?.contentDigest ?? "")) {
+        violations.push("extracted package manifest path, type, mode, or content digest is invalid");
+    }
+    const required = artifact?.requiredSurfaces;
+    if (!Array.isArray(required)
+        || canonicalObservationJson(required.map((entry) => entry.path)) !== canonicalObservationJson(DEVELOPMENT_RUNTIME_REQUIRED_FILES)
+        || required.some((entry) => !["file", "directory"].includes(entry.type) || !Number.isInteger(entry.mode) || (entry.type === "file" && !/^[a-f0-9]{64}$/.test(entry.contentDigest ?? "")))) {
+        violations.push("extracted package required-surface evidence is incomplete or malformed");
+    }
+    if (!Array.isArray(artifact?.extractedTree?.entries)
+        || artifact.extractedTree.entries.some((entry) => String(entry.path).endsWith(".js.map"))) {
+        violations.push("extracted package file manifest contains an unclassified source map or is missing");
+    }
+    const extractedEntries = artifact?.extractedTree?.entries;
+    const supportPaths = artifact?.runtimeSupportPaths;
+    const extractedPayload = Array.isArray(extractedEntries) && Array.isArray(supportPaths)
+        ? extractedEntries.filter((entry) => !supportPaths.includes(entry.path))
+        : null;
+    if (!Array.isArray(extractedEntries) || extractedEntries.length < 1
+        || new Set(extractedEntries.map((entry) => entry.path)).size !== extractedEntries.length
+        || extractedEntries.some((entry) => typeof entry.path !== "string" || !["directory", "file", "symlink"].includes(entry.type) || !Number.isInteger(entry.mode)
+            || (entry.type === "file" && (!Number.isInteger(entry.size) || !/^[a-f0-9]{64}$/.test(entry.sha256 ?? "")))
+            || (entry.type === "symlink" && !/^[a-f0-9]{64}$/.test(entry.targetSha256 ?? "")))
+        || artifact.extractedTree.digest !== observationDigest(extractedEntries)
+        || !Number.isInteger(artifact?.tarballTree?.count) || artifact.tarballTree.count < 1
+        || !/^[a-f0-9]{64}$/.test(artifact?.tarballTree?.digest ?? "")
+        || !Array.isArray(supportPaths)
+        || new Set(supportPaths).size !== supportPaths.length
+        || supportPaths.some((entry) => entry !== "node_modules")
+        || extractedPayload?.length !== artifact.tarballTree.count
+        || observationDigest(extractedPayload) !== artifact.tarballTree.digest) {
+        violations.push("complete extracted package tree is not bound to the current tarball payload");
+    }
+    const portability = records.get("package.portability")?.content;
+    if (portability?.constructionRootCount !== 2 || portability?.constructionRootsDistinct !== true
+        || portability?.extractedRootCount !== 2 || portability?.extractedRootsDistinct !== true
+        || portability?.forbiddenPathMatches?.length !== 0 || !/^[a-f0-9]{64}$/.test(portability?.contentSha256 ?? "")) {
+        violations.push("extracted package portability evidence is incomplete or failed");
+    }
+    const sourceAuthority = records.get("bootstrap.source-authority")?.content;
+    const expectedSpecs = [
+        ...(sourceAuthority?.accepted ?? []).map((entry) => ({ ...entry, accepted: true })),
+        ...(sourceAuthority?.rejections ?? []).map((entry) => ({ ...entry, accepted: false })),
+    ];
+    const expectedById = new Map(expectedSpecs.map((entry) => [entry.id, entry]));
+    const generated = records.get("bootstrap.generated-binder")?.content;
+    const generatedRows = generated?.rows;
+    if (!Array.isArray(generatedRows) || generatedRows.length !== expectedSpecs.length || new Set(generatedRows.map((row) => row.id)).size !== expectedSpecs.length
+        || generatedRows.some((row) => {
+            const expected = expectedById.get(row.id);
+            return !expected || row.classification !== expected.classification || canonicalObservationJson(row.states) !== canonicalObservationJson(expected.states);
+        }))
+        violations.push("generated binder classifications do not match the source bootstrap authority");
+    const extractedRows = records.get("bootstrap.extracted-classifications")?.content;
+    const expectedComposite = expectedSpecs.flatMap((entry) => entry.states.map((state) => `package/${state}/${entry.id}`)).sort();
+    if (!Array.isArray(extractedRows)
+        || canonicalObservationJson(extractedRows.map((row) => `package/${row.projectState}/${row.id}`).sort()) !== canonicalObservationJson(expectedComposite)
+        || extractedRows.some((row) => {
+            const expected = expectedById.get(row.id);
+            return !expected || row.accepted !== expected.accepted || row.classification !== expected.classification || row.preservationRoots !== 9 || row.childStarted !== expected.accepted;
+        }))
+        violations.push("extracted package runtime classifications or sentinel results do not match bootstrap authority");
+    const expectedCommandPolicy = Array.isArray(extractedRows) ? {
+        rowCount: extractedRows.length,
+        accepted: extractedRows.filter((row) => row.accepted).length,
+        rejected: extractedRows.filter((row) => !row.accepted).length,
+        classifications: Object.fromEntries([...new Set(extractedRows.map((row) => row.classification))].sort().map((classification) => [classification, extractedRows.filter((row) => row.classification === classification).length])),
+        compositeIdentityDigest: observationDigest(extractedRows.map((row) => `${row.runtime}/${row.projectState}/${row.id}`).sort()),
+    } : null;
+    if (canonicalObservationJson(records.get("package.command-policy")?.content) !== canonicalObservationJson(expectedCommandPolicy)) {
+        violations.push("extracted package command-policy classification does not bind the executed runtime matrix");
+    }
+    const diagnostics = records.get("bootstrap.extracted-diagnostics")?.content;
+    if (!Array.isArray(diagnostics) || diagnostics.length !== expectedComposite.length - expectedSpecs.filter((entry) => entry.accepted).flatMap((entry) => entry.states).length
+        || diagnostics.some((row) => row.accepted !== false || !["wrong_channel", "not_exact", "malformed"].includes(row.classification))) {
+        violations.push("extracted package rejection diagnostics are incomplete or misclassified");
+    }
+    const expectedAdversarial = Array.isArray(diagnostics) ? {
+        rowCount: diagnostics.length,
+        allBlockedBeforeChildStart: diagnostics.every((row) => row.childStarted === false),
+        classifications: Object.fromEntries([...new Set(diagnostics.map((row) => row.classification))].sort().map((classification) => [classification, diagnostics.filter((row) => row.classification === classification).length])),
+    } : null;
+    if (canonicalObservationJson(records.get("package.adversarial")?.content) !== canonicalObservationJson(expectedAdversarial)) {
+        violations.push("package adversarial classifications do not bind extracted rejection diagnostics");
+    }
+    const generatedDiagnostics = records.get("bootstrap.generated-diagnostics")?.content;
+    if (!Array.isArray(generatedDiagnostics) || generatedDiagnostics.length !== sourceAuthority?.rejections?.length
+        || generatedDiagnostics.some((row) => !["wrong_channel", "not_exact", "malformed"].includes(row.classification))) {
+        violations.push("generated binder rejection diagnostics are incomplete or misclassified");
+    }
+    for (const ref of ["bootstrap.generated-startup", "bootstrap.extracted-startup"]) {
+        const producers = records.get(ref)?.content;
+        if (!Array.isArray(producers) || producers.length === 0 || producers.some((entry) => typeof entry.path !== "string" || !String(entry.value).startsWith("npx -y agentera@next "))) {
+            violations.push(`bootstrap startup producer evidence '${ref}' is incomplete`);
+        }
+    }
+    if (canonicalObservationJson(records.get("bootstrap.generated-declarations")?.content)
+        !== canonicalObservationJson(records.get("bootstrap.extracted-declarations")?.content)) {
+        violations.push("generated and extracted bootstrap command declarations drifted");
+    }
+    const parity = records.get("bootstrap.source-package-parity")?.content;
+    if (!parity?.source || !parity?.package || canonicalObservationJson(parity.source) !== canonicalObservationJson(parity.package)
+        || canonicalObservationJson(Object.keys(parity.source).sort()) !== canonicalObservationJson(["clean", "partial", "v2", "v3"])) {
+        violations.push("source and extracted package runtime classification parity failed");
+    }
+    const missing = records.get("bootstrap.missing-surface")?.content;
+    if (!Array.isArray(missing) || missing.length !== DEVELOPMENT_RUNTIME_REQUIRED_FILES.length * 2
+        || new Set(missing.map((entry) => `${entry.runtime}/${entry.relative}`)).size !== missing.length
+        || missing.some((entry) => !["source", "package"].includes(entry.runtime) || entry.status !== 64 || entry.classification !== "invalid_authority" || entry.childStarted !== false)) {
+        violations.push("bootstrap missing-surface failure evidence is incomplete or misclassified");
+    }
+}
+function validateChecks(manifest, violations) {
+    const records = allRecords(manifest.producers);
+    const provenanceDigests = new Map();
+    for (const [ref, record] of records) {
+        const key = `${record.producerKind}\0${record.artifactContentDigest}\0${record.observationDigest}`;
+        const prior = provenanceDigests.get(key);
+        if (prior)
+            violations.push(`activation evidence records '${prior}' and '${ref}' alias one producer artifact observation`);
+        else
+            provenanceDigests.set(key, ref);
+    }
+    const ids = manifest.checks?.map((check) => check.id) ?? [];
+    if (canonicalObservationJson(ids) !== canonicalObservationJson(ACTIVATION_CHECK_IDS))
+        violations.push("activation evidence checks are missing, duplicated, unknown, or out of order");
+    const used = new Set();
+    for (const check of manifest.checks ?? []) {
+        const expectedRefs = CHECK_OBSERVATIONS[check.id];
+        if (!expectedRefs || canonicalObservationJson(check.observationRefs) !== canonicalObservationJson(expectedRefs)) {
+            violations.push(`activation evidence check '${check.id}' producer requirements drifted`);
+            continue;
+        }
+        for (const ref of check.observationRefs) {
+            if (used.has(ref))
+                violations.push(`activation evidence record '${ref}' was aliased across checks`);
+            used.add(ref);
+            if (!records.has(ref))
+                violations.push(`activation evidence check '${check.id}' references missing record '${ref}'`);
+        }
+        const [classId] = check.id.split(".");
+        const census = ACTIVATION_CENSUS_AUTHORITY.classes[classId];
+        if (!census || check.identities.length !== census.count || check.identityDigest !== census.sha256 || digestIdentities(check.identities) !== census.sha256) {
+            violations.push(`activation evidence check '${check.id}' identity closure failed`);
+        }
+        if (check.observationDigest !== observationDigest(check.observationRefs.map((ref) => records.get(ref)?.content ?? null))) {
+            violations.push(`activation evidence check '${check.id}' observation digest mismatched`);
+        }
+    }
+    if (used.size !== Object.keys(PROVENANCE).length)
+        violations.push("activation evidence contains unconsumed or multiply consumed producer records");
+}
+export function activationEvidenceViolations(actual, expectedOrContext) {
+    const manifest = actual;
+    if (!manifest || typeof manifest !== "object")
+        return ["activation evidence manifest is missing"];
+    const violations = [];
+    const context = "root" in expectedOrContext ? expectedOrContext : null;
+    const expected = context ? null : expectedOrContext;
+    const generation = context?.generation ?? expected.generation;
+    const sourceDigest = context ? activationSourceDigest(context.root) : expected.currentSourceDigest;
+    const packageIntegrity = context
+        ? context.expectedPackageIdentity?.packageArtifact?.integrity ?? null
+        : manifest.packageArtifact?.integrity ?? null;
+    if (manifest.schemaVersion !== ACTIVATION_EVIDENCE_SCHEMA)
+        violations.push("activation evidence schema is wrong");
+    if (manifest.generation !== generation)
+        violations.push("activation evidence generation is stale or wrong");
+    if (manifest.currentSourceDigest !== sourceDigest)
+        violations.push("activation evidence current-source provenance drifted");
+    if (manifest.tupleDigest !== ACTIVATION_TUPLE_AUTHORITY.total.sha256)
+        violations.push("activation evidence tuple digest mismatched");
+    if (!manifest.packageArtifact || !/^agentera-\d+\.\d+\.\d+(?:-dev\.\d+)?\.tgz$/.test(manifest.packageArtifact.filename)
+        || !/^sha512-[A-Za-z0-9+/]+={0,2}$/.test(manifest.packageArtifact.integrity)
+        || !/^[a-f0-9]{40}$/.test(manifest.packageArtifact.shasum)
+        || !/^[a-f0-9]{64}$/.test(manifest.packageArtifact.tarballSha256))
+        violations.push("activation evidence package artifact identity is malformed");
+    validateOwnerEvidence(manifest.producers?.source, "source-owner", SOURCE_OWNER_EVIDENCE_SCHEMA, sourceDigest, generation, null, violations);
+    validateOwnerEvidence(manifest.producers?.generated, "generated-owner", GENERATED_OWNER_EVIDENCE_SCHEMA, sourceDigest, generation, null, violations);
+    validateOwnerEvidence(manifest.producers?.package, "package-owner", PACKAGE_OWNER_EVIDENCE_SCHEMA, sourceDigest, generation, packageIntegrity, violations);
+    validateCapabilityParity(manifest, violations);
+    validatePackageSemantics(manifest, violations);
+    validateExecutedArtifactSemantics(manifest, violations);
+    validateChecks(manifest, violations);
+    const { manifestDigest, ...unsigned } = manifest;
+    if (manifestDigest !== observationDigest(unsigned))
+        violations.push("activation evidence manifest digest mismatched");
+    if (Buffer.byteLength(`${canonicalObservationJson(manifest)}\n`, "utf8") > ACTIVATION_EVIDENCE_MAX_BYTES)
+        violations.push("activation evidence manifest exceeds its byte bound");
+    if (context) {
+        const authoritativeSource = createSourceOwnerEvidence(context.root, context.productionInputs);
+        const authoritativeGenerated = createGeneratedOwnerEvidence({
+            root: context.root,
+            generationRoot: context.generationRoot,
+            generation: context.generation,
+            productionInputs: context.productionInputs,
+        });
+        validateAuthoritativeOwner(manifest.producers?.source, authoritativeSource, violations);
+        validateAuthoritativeOwner(manifest.producers?.generated, authoritativeGenerated, violations);
+        if (!/^[a-f0-9]{64}$/.test(context.expectedManifestDigest)) {
+            violations.push("trusted release activation evidence digest is missing or malformed");
+        }
+        else if (manifest.manifestDigest !== context.expectedManifestDigest) {
+            violations.push("activation evidence manifest differs from the trusted release observation");
+        }
+        violations.push(...activationPackageIdentityViolations(context.expectedPackageIdentity, manifest.producers?.package));
+        for (const relative of [".agentera-generation.json", "dist/.agentera-generation.json", "bundle/.agentera-generation.json"]) {
+            try {
+                if (JSON.parse(fs.readFileSync(path.join(context.generationRoot, relative), "utf8")).id !== generation)
+                    violations.push("activation evidence generation marker provenance drifted");
+            }
+            catch {
+                violations.push("activation evidence generation marker is missing or malformed");
+            }
+        }
+    }
+    if (expected && canonicalObservationJson(manifest) !== canonicalObservationJson(expected))
+        violations.push("activation evidence differs from the expected independently observed manifest");
+    return [...new Set(violations)];
+}
+export function readActivationEvidenceManifest(generationRoot) {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(generationRoot, ACTIVATION_EVIDENCE_FILE), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}

package/dist/validate/activationPackageSemantics.js

@@ -0,0 +1,29 @@
+/** Normalize every semantic field carried by a package activation surface. */
+export function packageSemanticSelector(entry) {
+    return JSON.stringify({
+        path: entry.path,
+        selector: entry.selector ?? null,
+        format: entry.format ?? null,
+        classification: entry.classification ?? null,
+        reason: entry.command_authority_reason ?? entry.reason ?? null,
+    });
+}
+export function packageDescriptors(record) {
+    return [
+        ...record.version_surfaces.surfaces.map((entry) => ({ id: `version:${String(entry.id)}`, entry, selector: `records[agentera].version_surfaces.surfaces[id=${String(entry.id)}]` })),
+        ...record.bundle_surfaces.directories.map((entry) => ({ id: `bundle:${String(entry.id)}`, entry, selector: `records[agentera].bundle_surfaces.directories[id=${String(entry.id)}]` })),
+        ...record.bundle_surfaces.files.map((entry) => ({ id: `bundle:${String(entry.id)}`, entry, selector: `records[agentera].bundle_surfaces.files[id=${String(entry.id)}]` })),
+        ...record.bundle_surfaces.generated_files.map((entry) => ({ id: `generated:${String(entry.id)}`, entry, selector: `records[agentera].bundle_surfaces.generated_files[id=${String(entry.id)}]` })),
+        ...record.bootstrap_command_authority.emitted_producers.map((entry) => ({ id: `emitted:${String(entry.path)}`, entry, selector: `records[agentera].bootstrap_command_authority.emitted_producers[path=${String(entry.path)}]` })),
+    ];
+}
+export function packageDescriptorSemantics(descriptors) {
+    return descriptors.map(({ id, entry }) => `${id}\0${packageSemanticSelector(entry)}`).sort();
+}
+export function packageCommandDeclarations(record) {
+    return {
+        scanned_formats: record.bootstrap_command_authority.scanned_formats,
+        scalar_classifications: record.bootstrap_command_authority.scalar_classifications,
+        emitted_producers: record.bootstrap_command_authority.emitted_producers,
+    };
+}

package/dist/validate/appHomeContract.js

@@ -11,27 +11,22 @@ 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/hej/instructions.ts",
-    "skills/agentera/references/contract.md",
+    "packages/cli/src/capabilities/status/instructions.ts",
 ];
 export const CLI_HELP_COMMANDS = [
     ["--help"],
-    ["hej", "--help"],
+    ["prime", "--help"],
     ["doctor", "--help"],
     ["upgrade", "--help"],
 ];
 export const CLI_OUTPUT_COMMANDS = [
-    ["hej"],
-    ["hej", "--format", "json"],
+    ["prime"],
+    ["prime", "--format", "json"],
     ["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] })),
+    };
+}