import assert from "node:assert/strict"; import { test } from "node:test"; import { capabilityId as id, valueType, validateWorkspaceRevision } from "../src/capability-model/index.js"; import { contentDigest, planEvolution, runtimeContracts, storageContracts } from "../src/capability-model/evolution.js"; import { capabilityFixtureSource, capabilityResourceSources, compileCapabilityFixture, makeValidCapabilityWorkspace } from "./fixtures/capability-model.js"; test("QX carries stable conformance IDs and implementation semantic majors", () => { const result = compileCapabilityFixture({ workspace: capabilityFixtureSource.replace("conform Project as Named {", 'conform Project as Named id "conformance:project:named" semantic-major 3 {'), todo: capabilityResourceSources.todo.replace('revision "package:todo-runtime@1" {', 'revision "package:todo-runtime@1" semantic-major 2 {'), }); assert.ok(result.ok, JSON.stringify(result)); assert.equal(result.workspace.conformances[0]!.id, "conformance:project:named"); assert.equal(result.workspace.conformances[0]!.semanticMajor, 3); assert.equal(result.workspace.packageImports[0]!.semanticMajor, 2); }); test("invalid majors and duplicate owner identities are rejected", () => { const workspace = makeValidCapabilityWorkspace(); workspace.packageImports[0]!.semanticMajor = 0; workspace.conformances[0]!.semanticMajor = 1.5; workspace.conformances[0]!.id = id.conformance("same"); workspace.conformances[1]!.id = id.conformance("same"); const issues = validateWorkspaceRevision(workspace); assert.equal(issues.filter((entry) => entry.code === "invalid-semantic-major").length, 2); assert.ok(issues.some((entry) => entry.code === "duplicate-conformance-id")); }); test("hashing is canonical and rejects values outside the persisted JSON contract", () => { assert.equal(contentDigest({ z: 1, a: { y: 3, b: 2 } }), contentDigest({ a: { b: 2, y: 3 }, z: 1 })); assert.notEqual(contentDigest([1, 2]), contentDigest([2, 1])); assert.throws(() => contentDigest(NaN)); assert.throws(() => contentDigest(new Date())); }); test("a workspace root change and display names do not restart package runtimes", () => { const before = makeValidCapabilityWorkspace(); const after = structuredClone(before); after.id = id.workspaceRevision("next"); after.sourceRootCommit = "f".repeat(40); after.atoms[0]!.displayName = "Renamed"; after.sharedAttachments[0]!.displayName = "Renamed storage"; after.conformances.reverse(); after.interfaceImports.reverse(); const report = planEvolution(before, after, { allowLegacy: true }); assert.deepEqual(report.runtimeActions.map((entry) => entry.action), ["keep"]); assert.deepEqual(report.storageChanges, []); assert.deepEqual(report.packageChecks, []); }); test("consumer changes preserve unrelated resource owners", () => { const before = makeValidCapabilityWorkspace(); before.packageImports.push({ packageId: id.package("package:resource-owner"), revisionId: id.packageRevision("package:resource-owner@1"), displayName: "ResourceOwner", source: { repository: "https://example.org/owner.git", commit: "a".repeat(40) }, exports: [{ kind: "function", id: id.packageExport("export:owner:ping"), displayName: "ping", inputType: valueType.unit, outputType: valueType.unit, dependencyPorts: [] }] }); const after = structuredClone(before); after.packageImports[0]!.source.commit = "e".repeat(40); const actions = planEvolution(before, after, { allowLegacy: true }).runtimeActions; assert.equal(actions.find((entry) => entry.groupId === "package:resource-owner")!.action, "keep"); assert.equal(actions.find((entry) => entry.groupId === "package:todo-runtime")!.action, "replace"); }); test("storage defaults and ownership changes invalidate consumers without requiring a major", () => { const before = makeValidCapabilityWorkspace(); const after = structuredClone(before); const slot = after.sharedAttachments[0]!; assert.equal(slot.kind, "state"); if (slot.kind === "state") slot.defaultValue = "Different default"; const report = planEvolution(before, after, { allowLegacy: true }); assert.equal(report.storageChanges.length, 1); assert.deepEqual(report.migrationRequired, []); assert.equal(report.runtimeActions[0]!.action, "replace"); assert.deepEqual(report.reviews, []); assert.notDeepEqual(storageContracts(before), storageContracts(after)); }); test("semantic review receipts cover exact consumer/provider contracts", () => { const before = makeValidCapabilityWorkspace(); before.conformances[0]!.id = id.conformance("conformance:project:named"); const after = structuredClone(before); after.conformances[0]!.semanticMajor = 2; const report = planEvolution(before, after, { allowLegacy: true }); assert.equal(report.reviews.length, 1); assert.equal(report.reviews[0]!.accepted, false); const receipt = { requirementDigest: report.reviews[0]!.requirementDigest, decision: "accepted-unchanged" as const, rationale: "Reviewed the semantic change against summary behavior", agentId: "workspace-agent" }; assert.equal(planEvolution(before, after, { allowLegacy: true, reviews: [receipt] }).reviews[0]!.accepted, true); after.packageImports[0]!.source.commit = "f".repeat(40); assert.equal(planEvolution(before, after, { allowLegacy: true, reviews: [receipt] }).reviews[0]!.accepted, false); }); test("evolution enrollment is explicit and never erases legacy ownership", () => { const workspace = makeValidCapabilityWorkspace(); const report = planEvolution(workspace, workspace); assert.ok(report.blockers.some((entry) => entry.includes("workspace-shared"))); assert.ok(report.blockers.some((entry) => entry.includes("authored ID"))); assert.equal(runtimeContracts(workspace).length, 1); assert.throws(() => planEvolution(workspace, { ...workspace, workspaceId: id.workspace("other") }), /different workspace/); });