@ai-agent-forge/agent-forge 0.85.0

package/dist/profile/domain-recovery.js

@@ -0,0 +1,94 @@
+const GOAL_TERMINAL = new Set(["achieved", "archived"]);
+const PLAN_TERMINAL = new Set(["completed", "discarded"]);
+const TODO_TERMINAL = new Set(["completed", "cancelled"]);
+/**
+ * 5.2a — recovers plans for the current branch. Plans on other branches are
+ * reported and left untouched (no scans, no writes). Terminal plans on the
+ * current branch are kept as-is; draft/active plans are recovered through
+ * the plugin's own ledger-derived state (no shadow writes).
+ */
+export function recoverPlansForBranch(plans, currentBranch) {
+    const entries = plans.map((plan) => {
+        const terminal = PLAN_TERMINAL.has(plan.status);
+        if (plan.branch !== currentBranch) {
+            return {
+                planId: plan.planId,
+                outcome: "skipped_other_branch",
+                branch: plan.branch,
+                statusBefore: plan.status,
+            };
+        }
+        return {
+            planId: plan.planId,
+            outcome: terminal ? "terminal_kept" : "recovered",
+            branch: plan.branch,
+            statusBefore: plan.status,
+        };
+    });
+    return { currentBranch, entries: Object.freeze(entries) };
+}
+/**
+ * 5.2b — restores goal/plan/todo state after a restart by replaying each
+ * entity's history into a fresh store (the caller performs the replay via
+ * the plugin attached to the rebuilt store) and comparing against the
+ * pre-restart snapshots.
+ */
+export function buildRestartReport(snapshots, restored, owner) {
+    const records = [];
+    let identical = true;
+    const compare = (domain, entityId, statusAfter, revisionAfter, evidenceCount, terminal, statusBefore, revisionBefore) => {
+        if (statusAfter !== statusBefore || revisionAfter !== revisionBefore)
+            identical = false;
+        records.push({ domain, entityId, statusAfter, revisionAfter, evidenceCount, terminal });
+    };
+    for (const goal of snapshots.goal ?? []) {
+        const after = restored.goals.get(goal.goalId, owner);
+        if (!after) {
+            identical = false;
+            records.push({
+                domain: "goal",
+                entityId: goal.goalId,
+                statusAfter: "missing",
+                revisionAfter: 0,
+                evidenceCount: 0,
+                terminal: false,
+            });
+            continue;
+        }
+        compare("goal", goal.goalId, after.status, after.revision, after.evidence.length, GOAL_TERMINAL.has(after.status), goal.status, goal.revision);
+    }
+    for (const plan of snapshots.plan ?? []) {
+        const after = restored.plans.get(plan.planId, owner);
+        if (!after) {
+            identical = false;
+            records.push({
+                domain: "plan",
+                entityId: plan.planId,
+                statusAfter: "missing",
+                revisionAfter: 0,
+                evidenceCount: 0,
+                terminal: false,
+            });
+            continue;
+        }
+        compare("plan", plan.planId, after.status, after.revisionNo, after.evidence.length, PLAN_TERMINAL.has(after.status), plan.status, plan.revisionNo);
+    }
+    for (const todo of snapshots.todo ?? []) {
+        const after = restored.todos.get(todo.todoId, owner);
+        if (!after) {
+            identical = false;
+            records.push({
+                domain: "todo",
+                entityId: todo.todoId,
+                statusAfter: "missing",
+                revisionAfter: 0,
+                evidenceCount: 0,
+                terminal: false,
+            });
+            continue;
+        }
+        compare("todo", todo.todoId, after.status, after.revision, after.evidence.length, TODO_TERMINAL.has(after.status), todo.status, todo.revision);
+    }
+    return { records: Object.freeze(records), identical };
+}
+//# sourceMappingURL=domain-recovery.js.map

package/dist/profile/domain-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-recovery.js","sourceRoot":"","sources":["../../src/profile/domain-recovery.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Domain recovery for branches and restarts (5.2a/5.2b).\n *\n * Branch recovery (5.2a): plans are bound to a branch via the 2.3c plugin;\n * recovering a session on branch B must touch ONLY plans whose branch is B\n * — other-branch plans stay ledgered but are reported as skipped and never\n * written to. Restart recovery (5.2b): replaying a domain's history into a\n * fresh store restores revision, evidence, and terminal state exactly; the\n * recovery report records the before/after facts so a restart is auditable.\n * Multi-Agent scheduling is out of scope.\n */\nimport type { GoalPluginV1, GoalV1 } from \"./goal-plugin.ts\";\nimport type { PlanPluginV1, PlanV1 } from \"./plan-plugin.ts\";\nimport type { TodoPluginV1, TodoV1 } from \"./todo-plugin.ts\";\n\nexport interface PlanBranchRecoveryEntryV1 {\n\treadonly planId: string;\n\treadonly outcome: \"recovered\" | \"terminal_kept\" | \"skipped_other_branch\";\n\treadonly branch: string;\n\treadonly statusBefore: string;\n}\n\nexport interface PlanBranchRecoveryReportV1 {\n\treadonly currentBranch: string;\n\treadonly entries: readonly PlanBranchRecoveryEntryV1[];\n}\n\nexport interface DomainRestartRecordV1 {\n\treadonly domain: \"goal\" | \"plan\" | \"todo\";\n\treadonly entityId: string;\n\treadonly statusAfter: string;\n\treadonly revisionAfter: number;\n\treadonly evidenceCount: number;\n\treadonly terminal: boolean;\n}\n\nexport interface DomainRestartReportV1 {\n\treadonly records: readonly DomainRestartRecordV1[];\n\t/** True when every restored entity matches the state it had before the restart. */\n\treadonly identical: boolean;\n}\n\nconst GOAL_TERMINAL = new Set([\"achieved\", \"archived\"]);\nconst PLAN_TERMINAL = new Set([\"completed\", \"discarded\"]);\nconst TODO_TERMINAL = new Set([\"completed\", \"cancelled\"]);\n\n/**\n * 5.2a — recovers plans for the current branch. Plans on other branches are\n * reported and left untouched (no scans, no writes). Terminal plans on the\n * current branch are kept as-is; draft/active plans are recovered through\n * the plugin's own ledger-derived state (no shadow writes).\n */\nexport function recoverPlansForBranch(plans: readonly PlanV1[], currentBranch: string): PlanBranchRecoveryReportV1 {\n\tconst entries = plans.map((plan): PlanBranchRecoveryEntryV1 => {\n\t\tconst terminal = PLAN_TERMINAL.has(plan.status);\n\t\tif (plan.branch !== currentBranch) {\n\t\t\treturn {\n\t\t\t\tplanId: plan.planId,\n\t\t\t\toutcome: \"skipped_other_branch\",\n\t\t\t\tbranch: plan.branch,\n\t\t\t\tstatusBefore: plan.status,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tplanId: plan.planId,\n\t\t\toutcome: terminal ? \"terminal_kept\" : \"recovered\",\n\t\t\tbranch: plan.branch,\n\t\t\tstatusBefore: plan.status,\n\t\t};\n\t});\n\treturn { currentBranch, entries: Object.freeze(entries) };\n}\n\n/**\n * 5.2b — restores goal/plan/todo state after a restart by replaying each\n * entity's history into a fresh store (the caller performs the replay via\n * the plugin attached to the rebuilt store) and comparing against the\n * pre-restart snapshots.\n */\nexport function buildRestartReport(\n\tsnapshots: {\n\t\treadonly goal?: readonly GoalV1[];\n\t\treadonly plan?: readonly PlanV1[];\n\t\treadonly todo?: readonly TodoV1[];\n\t},\n\trestored: {\n\t\treadonly goals: GoalPluginV1;\n\t\treadonly plans: PlanPluginV1;\n\t\treadonly todos: TodoPluginV1;\n\t},\n\towner: string,\n): DomainRestartReportV1 {\n\tconst records: DomainRestartRecordV1[] = [];\n\tlet identical = true;\n\tconst compare = (\n\t\tdomain: \"goal\" | \"plan\" | \"todo\",\n\t\tentityId: string,\n\t\tstatusAfter: string,\n\t\trevisionAfter: number,\n\t\tevidenceCount: number,\n\t\tterminal: boolean,\n\t\tstatusBefore: string,\n\t\trevisionBefore: number,\n\t): void => {\n\t\tif (statusAfter !== statusBefore || revisionAfter !== revisionBefore) identical = false;\n\t\trecords.push({ domain, entityId, statusAfter, revisionAfter, evidenceCount, terminal });\n\t};\n\tfor (const goal of snapshots.goal ?? []) {\n\t\tconst after = restored.goals.get(goal.goalId, owner);\n\t\tif (!after) {\n\t\t\tidentical = false;\n\t\t\trecords.push({\n\t\t\t\tdomain: \"goal\",\n\t\t\t\tentityId: goal.goalId,\n\t\t\t\tstatusAfter: \"missing\",\n\t\t\t\trevisionAfter: 0,\n\t\t\t\tevidenceCount: 0,\n\t\t\t\tterminal: false,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tcompare(\n\t\t\t\"goal\",\n\t\t\tgoal.goalId,\n\t\t\tafter.status,\n\t\t\tafter.revision,\n\t\t\tafter.evidence.length,\n\t\t\tGOAL_TERMINAL.has(after.status),\n\t\t\tgoal.status,\n\t\t\tgoal.revision,\n\t\t);\n\t}\n\tfor (const plan of snapshots.plan ?? []) {\n\t\tconst after = restored.plans.get(plan.planId, owner);\n\t\tif (!after) {\n\t\t\tidentical = false;\n\t\t\trecords.push({\n\t\t\t\tdomain: \"plan\",\n\t\t\t\tentityId: plan.planId,\n\t\t\t\tstatusAfter: \"missing\",\n\t\t\t\trevisionAfter: 0,\n\t\t\t\tevidenceCount: 0,\n\t\t\t\tterminal: false,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tcompare(\n\t\t\t\"plan\",\n\t\t\tplan.planId,\n\t\t\tafter.status,\n\t\t\tafter.revisionNo,\n\t\t\tafter.evidence.length,\n\t\t\tPLAN_TERMINAL.has(after.status),\n\t\t\tplan.status,\n\t\t\tplan.revisionNo,\n\t\t);\n\t}\n\tfor (const todo of snapshots.todo ?? []) {\n\t\tconst after = restored.todos.get(todo.todoId, owner);\n\t\tif (!after) {\n\t\t\tidentical = false;\n\t\t\trecords.push({\n\t\t\t\tdomain: \"todo\",\n\t\t\t\tentityId: todo.todoId,\n\t\t\t\tstatusAfter: \"missing\",\n\t\t\t\trevisionAfter: 0,\n\t\t\t\tevidenceCount: 0,\n\t\t\t\tterminal: false,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tcompare(\n\t\t\t\"todo\",\n\t\t\ttodo.todoId,\n\t\t\tafter.status,\n\t\t\tafter.revision,\n\t\t\tafter.evidence.length,\n\t\t\tTODO_TERMINAL.has(after.status),\n\t\t\ttodo.status,\n\t\t\ttodo.revision,\n\t\t);\n\t}\n\treturn { records: Object.freeze(records), identical };\n}\n"]}

package/dist/profile/first-roles.d.ts

@@ -0,0 +1,30 @@
+/**
+ * First-batch role vertical slices (2.2c): 架构/实现/测试.
+ *
+ * Each role is a `RoleMetadataV1` registered in the role catalog plus a
+ * deterministic runner that only consumes the public facade — no private
+ * session access. These are the first vertical slices proving that a role can
+ * be declared, discovered, and executed end to end.
+ */
+import type { RoleCatalogV1, RoleMetadataV1 } from "./role-catalog.ts";
+export interface FirstBatchRoleV1 {
+    readonly metadata: RoleMetadataV1;
+    readonly run: (input: {
+        readonly spec: string;
+    }) => Promise<{
+        readonly result: string;
+    }>;
+}
+export declare const FIRST_BATCH_ROLES: readonly {
+    readonly metadata: RoleMetadataV1;
+    readonly run: FirstBatchRoleV1["run"];
+}[];
+/** Registers and returns the first-batch role vertical slices. */
+export declare function createFirstBatchRoleSlices(catalog: RoleCatalogV1): {
+    readonly roles: readonly FirstBatchRoleV1[];
+    run(roleId: string, spec: string): Promise<{
+        readonly roleId: string;
+        readonly result: string;
+    }>;
+};
+//# sourceMappingURL=first-roles.d.ts.map

package/dist/profile/first-roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-roles.d.ts","sourceRoot":"","sources":["../../src/profile/first-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGvE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzF;AAsCD,eAAO,MAAM,iBAAiB,EAAE,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;CACtC,EAmBA,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjG,CAeA","sourcesContent":["/**\n * First-batch role vertical slices (2.2c): 架构/实现/测试.\n *\n * Each role is a `RoleMetadataV1` registered in the role catalog plus a\n * deterministic runner that only consumes the public facade — no private\n * session access. These are the first vertical slices proving that a role can\n * be declared, discovered, and executed end to end.\n */\nimport type { RoleCatalogV1, RoleMetadataV1 } from \"./role-catalog.ts\";\nimport { validateRoleMetadataV1 } from \"./role-catalog.ts\";\n\nexport interface FirstBatchRoleV1 {\n\treadonly metadata: RoleMetadataV1;\n\treadonly run: (input: { readonly spec: string }) => Promise<{ readonly result: string }>;\n}\n\nconst ARCHITECTURE_ROLE: RoleMetadataV1 = {\n\troleId: \"architecture-analyst\",\n\ttitle: \"Architecture Analyst\",\n\tinput: { schemaId: \"role/architecture-input@1\", schemaVersion: 1 },\n\toutput: { schemaId: \"role/architecture-output@1\", schemaVersion: 1 },\n\tcapabilityDependencies: [{ capabilityId: \"tool.read\", capabilityVersion: 1, required: true }],\n\twritableScopes: [\"session\"],\n\tconcurrency: \"parallel\",\n\tcompletionCriteria: \"module structure findings recorded\",\n};\n\nconst IMPLEMENTER_ROLE: RoleMetadataV1 = {\n\troleId: \"implementer\",\n\ttitle: \"Implementer\",\n\tinput: { schemaId: \"role/implement-input@1\", schemaVersion: 1 },\n\toutput: { schemaId: \"role/implement-output@1\", schemaVersion: 1 },\n\tcapabilityDependencies: [\n\t\t{ capabilityId: \"tool.edit\", capabilityVersion: 1, required: true },\n\t\t{ capabilityId: \"tool.write\", capabilityVersion: 1, required: false },\n\t],\n\twritableScopes: [\"session\", \"cycle\"],\n\tconcurrency: \"single\",\n\tcompletionCriteria: \"patch produced for the requested spec\",\n};\n\nconst TEST_DESIGNER_ROLE: RoleMetadataV1 = {\n\troleId: \"test-designer\",\n\ttitle: \"Test Designer\",\n\tinput: { schemaId: \"role/test-input@1\", schemaVersion: 1 },\n\toutput: { schemaId: \"role/test-output@1\", schemaVersion: 1 },\n\tcapabilityDependencies: [{ capabilityId: \"tool.read\", capabilityVersion: 1, required: true }],\n\twritableScopes: [\"session\"],\n\tconcurrency: \"parallel\",\n\tcompletionCriteria: \"test cases derived from the spec\",\n};\n\nexport const FIRST_BATCH_ROLES: readonly {\n\treadonly metadata: RoleMetadataV1;\n\treadonly run: FirstBatchRoleV1[\"run\"];\n}[] = [\n\t{\n\t\tmetadata: ARCHITECTURE_ROLE,\n\t\trun: async (input) => ({\n\t\t\tresult: `architecture findings for: ${input.spec.slice(0, 64)}`,\n\t\t}),\n\t},\n\t{\n\t\tmetadata: IMPLEMENTER_ROLE,\n\t\trun: async (input) => ({\n\t\t\tresult: `patch for: ${input.spec.slice(0, 64)}`,\n\t\t}),\n\t},\n\t{\n\t\tmetadata: TEST_DESIGNER_ROLE,\n\t\trun: async (input) => ({\n\t\t\tresult: `test cases for: ${input.spec.slice(0, 64)}`,\n\t\t}),\n\t},\n];\n\n/** Registers and returns the first-batch role vertical slices. */\nexport function createFirstBatchRoleSlices(catalog: RoleCatalogV1): {\n\treadonly roles: readonly FirstBatchRoleV1[];\n\trun(roleId: string, spec: string): Promise<{ readonly roleId: string; readonly result: string }>;\n} {\n\tconst roles = FIRST_BATCH_ROLES.map((role) => ({\n\t\tmetadata: validateRoleMetadataV1(role.metadata),\n\t\trun: role.run,\n\t}));\n\tfor (const role of roles) catalog.register(role.metadata);\n\tconst runners = new Map(roles.map((role) => [role.metadata.roleId, role.run]));\n\treturn {\n\t\troles,\n\t\tasync run(roleId, spec) {\n\t\t\tconst run = runners.get(roleId);\n\t\t\tif (!run) throw new Error(`Unknown first-batch role: ${roleId}`);\n\t\t\treturn { roleId, result: (await run({ spec })).result };\n\t\t},\n\t};\n}\n"]}

package/dist/profile/first-roles.js

@@ -0,0 +1,74 @@
+import { validateRoleMetadataV1 } from "./role-catalog.js";
+const ARCHITECTURE_ROLE = {
+    roleId: "architecture-analyst",
+    title: "Architecture Analyst",
+    input: { schemaId: "role/architecture-input@1", schemaVersion: 1 },
+    output: { schemaId: "role/architecture-output@1", schemaVersion: 1 },
+    capabilityDependencies: [{ capabilityId: "tool.read", capabilityVersion: 1, required: true }],
+    writableScopes: ["session"],
+    concurrency: "parallel",
+    completionCriteria: "module structure findings recorded",
+};
+const IMPLEMENTER_ROLE = {
+    roleId: "implementer",
+    title: "Implementer",
+    input: { schemaId: "role/implement-input@1", schemaVersion: 1 },
+    output: { schemaId: "role/implement-output@1", schemaVersion: 1 },
+    capabilityDependencies: [
+        { capabilityId: "tool.edit", capabilityVersion: 1, required: true },
+        { capabilityId: "tool.write", capabilityVersion: 1, required: false },
+    ],
+    writableScopes: ["session", "cycle"],
+    concurrency: "single",
+    completionCriteria: "patch produced for the requested spec",
+};
+const TEST_DESIGNER_ROLE = {
+    roleId: "test-designer",
+    title: "Test Designer",
+    input: { schemaId: "role/test-input@1", schemaVersion: 1 },
+    output: { schemaId: "role/test-output@1", schemaVersion: 1 },
+    capabilityDependencies: [{ capabilityId: "tool.read", capabilityVersion: 1, required: true }],
+    writableScopes: ["session"],
+    concurrency: "parallel",
+    completionCriteria: "test cases derived from the spec",
+};
+export const FIRST_BATCH_ROLES = [
+    {
+        metadata: ARCHITECTURE_ROLE,
+        run: async (input) => ({
+            result: `architecture findings for: ${input.spec.slice(0, 64)}`,
+        }),
+    },
+    {
+        metadata: IMPLEMENTER_ROLE,
+        run: async (input) => ({
+            result: `patch for: ${input.spec.slice(0, 64)}`,
+        }),
+    },
+    {
+        metadata: TEST_DESIGNER_ROLE,
+        run: async (input) => ({
+            result: `test cases for: ${input.spec.slice(0, 64)}`,
+        }),
+    },
+];
+/** Registers and returns the first-batch role vertical slices. */
+export function createFirstBatchRoleSlices(catalog) {
+    const roles = FIRST_BATCH_ROLES.map((role) => ({
+        metadata: validateRoleMetadataV1(role.metadata),
+        run: role.run,
+    }));
+    for (const role of roles)
+        catalog.register(role.metadata);
+    const runners = new Map(roles.map((role) => [role.metadata.roleId, role.run]));
+    return {
+        roles,
+        async run(roleId, spec) {
+            const run = runners.get(roleId);
+            if (!run)
+                throw new Error(`Unknown first-batch role: ${roleId}`);
+            return { roleId, result: (await run({ spec })).result };
+        },
+    };
+}
+//# sourceMappingURL=first-roles.js.map

package/dist/profile/first-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-roles.js","sourceRoot":"","sources":["../../src/profile/first-roles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * First-batch role vertical slices (2.2c): 架构/实现/测试.\n *\n * Each role is a `RoleMetadataV1` registered in the role catalog plus a\n * deterministic runner that only consumes the public facade — no private\n * session access. These are the first vertical slices proving that a role can\n * be declared, discovered, and executed end to end.\n */\nimport type { RoleCatalogV1, RoleMetadataV1 } from \"./role-catalog.ts\";\nimport { validateRoleMetadataV1 } from \"./role-catalog.ts\";\n\nexport interface FirstBatchRoleV1 {\n\treadonly metadata: RoleMetadataV1;\n\treadonly run: (input: { readonly spec: string }) => Promise<{ readonly result: string }>;\n}\n\nconst ARCHITECTURE_ROLE: RoleMetadataV1 = {\n\troleId: \"architecture-analyst\",\n\ttitle: \"Architecture Analyst\",\n\tinput: { schemaId: \"role/architecture-input@1\", schemaVersion: 1 },\n\toutput: { schemaId: \"role/architecture-output@1\", schemaVersion: 1 },\n\tcapabilityDependencies: [{ capabilityId: \"tool.read\", capabilityVersion: 1, required: true }],\n\twritableScopes: [\"session\"],\n\tconcurrency: \"parallel\",\n\tcompletionCriteria: \"module structure findings recorded\",\n};\n\nconst IMPLEMENTER_ROLE: RoleMetadataV1 = {\n\troleId: \"implementer\",\n\ttitle: \"Implementer\",\n\tinput: { schemaId: \"role/implement-input@1\", schemaVersion: 1 },\n\toutput: { schemaId: \"role/implement-output@1\", schemaVersion: 1 },\n\tcapabilityDependencies: [\n\t\t{ capabilityId: \"tool.edit\", capabilityVersion: 1, required: true },\n\t\t{ capabilityId: \"tool.write\", capabilityVersion: 1, required: false },\n\t],\n\twritableScopes: [\"session\", \"cycle\"],\n\tconcurrency: \"single\",\n\tcompletionCriteria: \"patch produced for the requested spec\",\n};\n\nconst TEST_DESIGNER_ROLE: RoleMetadataV1 = {\n\troleId: \"test-designer\",\n\ttitle: \"Test Designer\",\n\tinput: { schemaId: \"role/test-input@1\", schemaVersion: 1 },\n\toutput: { schemaId: \"role/test-output@1\", schemaVersion: 1 },\n\tcapabilityDependencies: [{ capabilityId: \"tool.read\", capabilityVersion: 1, required: true }],\n\twritableScopes: [\"session\"],\n\tconcurrency: \"parallel\",\n\tcompletionCriteria: \"test cases derived from the spec\",\n};\n\nexport const FIRST_BATCH_ROLES: readonly {\n\treadonly metadata: RoleMetadataV1;\n\treadonly run: FirstBatchRoleV1[\"run\"];\n}[] = [\n\t{\n\t\tmetadata: ARCHITECTURE_ROLE,\n\t\trun: async (input) => ({\n\t\t\tresult: `architecture findings for: ${input.spec.slice(0, 64)}`,\n\t\t}),\n\t},\n\t{\n\t\tmetadata: IMPLEMENTER_ROLE,\n\t\trun: async (input) => ({\n\t\t\tresult: `patch for: ${input.spec.slice(0, 64)}`,\n\t\t}),\n\t},\n\t{\n\t\tmetadata: TEST_DESIGNER_ROLE,\n\t\trun: async (input) => ({\n\t\t\tresult: `test cases for: ${input.spec.slice(0, 64)}`,\n\t\t}),\n\t},\n];\n\n/** Registers and returns the first-batch role vertical slices. */\nexport function createFirstBatchRoleSlices(catalog: RoleCatalogV1): {\n\treadonly roles: readonly FirstBatchRoleV1[];\n\trun(roleId: string, spec: string): Promise<{ readonly roleId: string; readonly result: string }>;\n} {\n\tconst roles = FIRST_BATCH_ROLES.map((role) => ({\n\t\tmetadata: validateRoleMetadataV1(role.metadata),\n\t\trun: role.run,\n\t}));\n\tfor (const role of roles) catalog.register(role.metadata);\n\tconst runners = new Map(roles.map((role) => [role.metadata.roleId, role.run]));\n\treturn {\n\t\troles,\n\t\tasync run(roleId, spec) {\n\t\t\tconst run = runners.get(roleId);\n\t\t\tif (!run) throw new Error(`Unknown first-batch role: ${roleId}`);\n\t\t\treturn { roleId, result: (await run({ spec })).result };\n\t\t},\n\t};\n}\n"]}

package/dist/profile/goal-plugin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Goal plugin (2.3b) — Goal schema, evidence, and recovery on top of the 2.3a
+ * transition store.
+ *
+ * Status graph: null → draft → active → achieved, and draft/active → archived.
+ * `achieve` requires at least one evidence reference. The plugin holds NO
+ * shadow state: every read derives status, revision, title, and evidence from
+ * the transition history, so recovery is exactly a store replay.
+ */
+import type { TransitionEvidenceRefV1, TransitionStoreV1 } from "./state-store.ts";
+export type GoalStatusV1 = "draft" | "active" | "achieved" | "archived";
+export interface GoalV1 {
+    readonly goalId: string;
+    readonly owner: string;
+    readonly title: string;
+    readonly status: GoalStatusV1;
+    readonly evidence: readonly TransitionEvidenceRefV1[];
+    readonly revision: number;
+}
+export interface GoalPluginV1 {
+    createGoal(input: {
+        readonly goalId: string;
+        readonly owner: string;
+        readonly title: string;
+    }): GoalV1;
+    activate(goalId: string, owner: string, options?: {
+        readonly operationId?: string;
+    }): GoalV1;
+    achieve(goalId: string, owner: string, evidence: readonly TransitionEvidenceRefV1[], options?: {
+        readonly operationId?: string;
+    }): GoalV1;
+    archive(goalId: string, owner: string): GoalV1;
+    get(goalId: string, owner: string): GoalV1 | undefined;
+}
+export declare function createGoalPlugin(options: {
+    readonly transitions: TransitionStoreV1;
+}): GoalPluginV1;
+//# sourceMappingURL=goal-plugin.d.ts.map

package/dist/profile/goal-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-plugin.d.ts","sourceRoot":"","sources":["../../src/profile/goal-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,MAAM;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACvG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAC7F,OAAO,CACN,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,uBAAuB,EAAE,EAC5C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,MAAM,CAAC;IACV,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACvD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GAAG,YAAY,CAiInG","sourcesContent":["/**\n * Goal plugin (2.3b) — Goal schema, evidence, and recovery on top of the 2.3a\n * transition store.\n *\n * Status graph: null → draft → active → achieved, and draft/active → archived.\n * `achieve` requires at least one evidence reference. The plugin holds NO\n * shadow state: every read derives status, revision, title, and evidence from\n * the transition history, so recovery is exactly a store replay.\n */\nimport type { TransitionEvidenceRefV1, TransitionStoreV1 } from \"./state-store.ts\";\n\nexport type GoalStatusV1 = \"draft\" | \"active\" | \"achieved\" | \"archived\";\n\nexport interface GoalV1 {\n\treadonly goalId: string;\n\treadonly owner: string;\n\treadonly title: string;\n\treadonly status: GoalStatusV1;\n\treadonly evidence: readonly TransitionEvidenceRefV1[];\n\treadonly revision: number;\n}\n\nexport interface GoalPluginV1 {\n\tcreateGoal(input: { readonly goalId: string; readonly owner: string; readonly title: string }): GoalV1;\n\tactivate(goalId: string, owner: string, options?: { readonly operationId?: string }): GoalV1;\n\tachieve(\n\t\tgoalId: string,\n\t\towner: string,\n\t\tevidence: readonly TransitionEvidenceRefV1[],\n\t\toptions?: { readonly operationId?: string },\n\t): GoalV1;\n\tarchive(goalId: string, owner: string): GoalV1;\n\tget(goalId: string, owner: string): GoalV1 | undefined;\n}\n\nexport function createGoalPlugin(options: { readonly transitions: TransitionStoreV1 }): GoalPluginV1 {\n\tconst transitions = options.transitions;\n\n\tconst goalHistory = (goalId: string, owner: string) =>\n\t\ttransitions.history(goalId).filter((record) => record.domain === \"goal\" && record.owner === owner);\n\n\tconst current = (goalId: string, owner: string): { status: GoalStatusV1; revision: number } | undefined => {\n\t\tconst state = transitions.currentStatus(\"goal\", goalId);\n\t\tif (state === undefined || goalHistory(goalId, owner).length === 0) return undefined;\n\t\treturn { status: state.status as GoalStatusV1, revision: state.revision };\n\t};\n\n\tconst titleOf = (goalId: string, owner: string): string => {\n\t\tfor (const record of goalHistory(goalId, owner)) {\n\t\t\tif (record.fromStatus !== null) continue;\n\t\t\tconst payload = record.payload;\n\t\t\tif (payload !== null && typeof payload === \"object\" && !Array.isArray(payload)) {\n\t\t\t\tconst title = (payload as Record<string, unknown>).title;\n\t\t\t\tif (typeof title === \"string\") return title;\n\t\t\t}\n\t\t}\n\t\treturn goalId;\n\t};\n\n\tconst goalGet = (goalId: string, owner: string): GoalV1 | undefined => {\n\t\tconst state = current(goalId, owner);\n\t\tif (!state) return undefined;\n\t\tconst history = goalHistory(goalId, owner);\n\t\tconst lastEvidence = [...history].reverse().find((record) => record.evidence.length > 0)?.evidence ?? [];\n\t\treturn {\n\t\t\tgoalId,\n\t\t\towner,\n\t\t\ttitle: titleOf(goalId, owner),\n\t\t\tstatus: state.status,\n\t\t\tevidence: lastEvidence,\n\t\t\trevision: state.revision,\n\t\t};\n\t};\n\n\t/** A retried transition with an already-applied operationId returns the existing state instead of conflicting. */\n\tconst replayedGoal = (\n\t\tgoalId: string,\n\t\towner: string,\n\t\ttoStatus: GoalStatusV1,\n\t\toperationId?: string,\n\t): GoalV1 | undefined => {\n\t\tif (!operationId) return undefined;\n\t\tconst applied = goalHistory(goalId, owner).some(\n\t\t\t(record) => record.toStatus === toStatus && record.operationId === operationId,\n\t\t);\n\t\treturn applied ? goalGet(goalId, owner) : undefined;\n\t};\n\n\tconst transitionGoal = (\n\t\tgoalId: string,\n\t\towner: string,\n\t\tfromStatus: GoalStatusV1 | null,\n\t\ttoStatus: GoalStatusV1,\n\t\tgoalOptions: {\n\t\t\treadonly evidence?: readonly TransitionEvidenceRefV1[];\n\t\t\treadonly payload?: { readonly title: string };\n\t\t\treadonly operationId?: string;\n\t\t},\n\t): GoalV1 => {\n\t\ttransitions.transition({\n\t\t\tdomain: \"goal\",\n\t\t\tentityId: goalId,\n\t\t\towner,\n\t\t\tfromStatus,\n\t\t\ttoStatus,\n\t\t\toperationId: goalOptions.operationId ?? `${toStatus}:${goalId}`,\n\t\t\tevidence: goalOptions.evidence,\n\t\t\tpayload: goalOptions.payload,\n\t\t});\n\t\tconst state = transitions.currentStatus(\"goal\", goalId);\n\t\treturn {\n\t\t\tgoalId,\n\t\t\towner,\n\t\t\ttitle: titleOf(goalId, owner),\n\t\t\tstatus: state?.status as GoalStatusV1,\n\t\t\tevidence: goalOptions.evidence ?? [],\n\t\t\t// v8 ignore next -- transition 刚写入 currentStatus，必可读到 revision\n\t\t\trevision: state?.revision ?? 0,\n\t\t};\n\t};\n\n\treturn {\n\t\tcreateGoal({ goalId, owner, title }) {\n\t\t\tif (title.trim().length === 0) throw new Error(\"Goal title must be a non-empty string\");\n\t\t\treturn transitionGoal(goalId, owner, null, \"draft\", {\n\t\t\t\tpayload: { title },\n\t\t\t\toperationId: `create:${goalId}`,\n\t\t\t});\n\t\t},\n\t\tactivate(goalId, owner, activateOptions) {\n\t\t\tconst replayed = replayedGoal(goalId, owner, \"active\", activateOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst existing = current(goalId, owner);\n\t\t\tif (existing?.status !== \"draft\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Goal ${goalId} must be in draft status to activate (current: ${existing?.status ?? \"missing\"})`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn transitionGoal(goalId, owner, \"draft\", \"active\", { operationId: activateOptions?.operationId });\n\t\t},\n\t\tachieve(goalId, owner, evidence, achieveOptions) {\n\t\t\tconst replayed = replayedGoal(goalId, owner, \"achieved\", achieveOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst existing = current(goalId, owner);\n\t\t\tif (existing?.status !== \"active\") {\n\t\t\t\tthrow new Error(`Goal ${goalId} must be active to achieve (current: ${existing?.status ?? \"missing\"})`);\n\t\t\t}\n\t\t\tif (evidence.length === 0) throw new Error(\"Achieving a goal requires at least one evidence reference\");\n\t\t\treturn transitionGoal(goalId, owner, \"active\", \"achieved\", {\n\t\t\t\tevidence,\n\t\t\t\toperationId: achieveOptions?.operationId,\n\t\t\t});\n\t\t},\n\t\tarchive(goalId, owner) {\n\t\t\tconst existing = current(goalId, owner);\n\t\t\tif (!existing || existing.status === \"achieved\" || existing.status === \"archived\") {\n\t\t\t\tthrow new Error(`Goal ${goalId} cannot be archived from status ${existing?.status ?? \"missing\"}`);\n\t\t\t}\n\t\t\treturn transitionGoal(goalId, owner, existing.status, \"archived\", {});\n\t\t},\n\t\tget(goalId, owner) {\n\t\t\treturn goalGet(goalId, owner);\n\t\t},\n\t};\n}\n"]}

package/dist/profile/goal-plugin.js

@@ -0,0 +1,113 @@
+export function createGoalPlugin(options) {
+    const transitions = options.transitions;
+    const goalHistory = (goalId, owner) => transitions.history(goalId).filter((record) => record.domain === "goal" && record.owner === owner);
+    const current = (goalId, owner) => {
+        const state = transitions.currentStatus("goal", goalId);
+        if (state === undefined || goalHistory(goalId, owner).length === 0)
+            return undefined;
+        return { status: state.status, revision: state.revision };
+    };
+    const titleOf = (goalId, owner) => {
+        for (const record of goalHistory(goalId, owner)) {
+            if (record.fromStatus !== null)
+                continue;
+            const payload = record.payload;
+            if (payload !== null && typeof payload === "object" && !Array.isArray(payload)) {
+                const title = payload.title;
+                if (typeof title === "string")
+                    return title;
+            }
+        }
+        return goalId;
+    };
+    const goalGet = (goalId, owner) => {
+        const state = current(goalId, owner);
+        if (!state)
+            return undefined;
+        const history = goalHistory(goalId, owner);
+        const lastEvidence = [...history].reverse().find((record) => record.evidence.length > 0)?.evidence ?? [];
+        return {
+            goalId,
+            owner,
+            title: titleOf(goalId, owner),
+            status: state.status,
+            evidence: lastEvidence,
+            revision: state.revision,
+        };
+    };
+    /** A retried transition with an already-applied operationId returns the existing state instead of conflicting. */
+    const replayedGoal = (goalId, owner, toStatus, operationId) => {
+        if (!operationId)
+            return undefined;
+        const applied = goalHistory(goalId, owner).some((record) => record.toStatus === toStatus && record.operationId === operationId);
+        return applied ? goalGet(goalId, owner) : undefined;
+    };
+    const transitionGoal = (goalId, owner, fromStatus, toStatus, goalOptions) => {
+        transitions.transition({
+            domain: "goal",
+            entityId: goalId,
+            owner,
+            fromStatus,
+            toStatus,
+            operationId: goalOptions.operationId ?? `${toStatus}:${goalId}`,
+            evidence: goalOptions.evidence,
+            payload: goalOptions.payload,
+        });
+        const state = transitions.currentStatus("goal", goalId);
+        return {
+            goalId,
+            owner,
+            title: titleOf(goalId, owner),
+            status: state?.status,
+            evidence: goalOptions.evidence ?? [],
+            // v8 ignore next -- transition 刚写入 currentStatus，必可读到 revision
+            revision: state?.revision ?? 0,
+        };
+    };
+    return {
+        createGoal({ goalId, owner, title }) {
+            if (title.trim().length === 0)
+                throw new Error("Goal title must be a non-empty string");
+            return transitionGoal(goalId, owner, null, "draft", {
+                payload: { title },
+                operationId: `create:${goalId}`,
+            });
+        },
+        activate(goalId, owner, activateOptions) {
+            const replayed = replayedGoal(goalId, owner, "active", activateOptions?.operationId);
+            if (replayed)
+                return replayed;
+            const existing = current(goalId, owner);
+            if (existing?.status !== "draft") {
+                throw new Error(`Goal ${goalId} must be in draft status to activate (current: ${existing?.status ?? "missing"})`);
+            }
+            return transitionGoal(goalId, owner, "draft", "active", { operationId: activateOptions?.operationId });
+        },
+        achieve(goalId, owner, evidence, achieveOptions) {
+            const replayed = replayedGoal(goalId, owner, "achieved", achieveOptions?.operationId);
+            if (replayed)
+                return replayed;
+            const existing = current(goalId, owner);
+            if (existing?.status !== "active") {
+                throw new Error(`Goal ${goalId} must be active to achieve (current: ${existing?.status ?? "missing"})`);
+            }
+            if (evidence.length === 0)
+                throw new Error("Achieving a goal requires at least one evidence reference");
+            return transitionGoal(goalId, owner, "active", "achieved", {
+                evidence,
+                operationId: achieveOptions?.operationId,
+            });
+        },
+        archive(goalId, owner) {
+            const existing = current(goalId, owner);
+            if (!existing || existing.status === "achieved" || existing.status === "archived") {
+                throw new Error(`Goal ${goalId} cannot be archived from status ${existing?.status ?? "missing"}`);
+            }
+            return transitionGoal(goalId, owner, existing.status, "archived", {});
+        },
+        get(goalId, owner) {
+            return goalGet(goalId, owner);
+        },
+    };
+}
+//# sourceMappingURL=goal-plugin.js.map

package/dist/profile/goal-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-plugin.js","sourceRoot":"","sources":["../../src/profile/goal-plugin.ts"],"names":[],"mappings":"AAmCA,MAAM,UAAU,gBAAgB,CAAC,OAAoD,EAAgB;IACpG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAExC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,KAAa,EAAE,EAAE,CACrD,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAEpG,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,KAAa,EAA0D,EAAE,CAAC;QAC1G,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACrF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAsB,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IAAA,CAC1E,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,KAAa,EAAU,EAAE,CAAC;QAC1D,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;gBAAE,SAAS;YACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC/B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChF,MAAM,KAAK,GAAI,OAAmC,CAAC,KAAK,CAAC;gBACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;YAC7C,CAAC;QACF,CAAC;QACD,OAAO,MAAM,CAAC;IAAA,CACd,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,KAAa,EAAsB,EAAE,CAAC;QACtE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;QACzG,OAAO;YACN,MAAM;YACN,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACxB,CAAC;IAAA,CACF,CAAC;IAEF,kHAAkH;IAClH,MAAM,YAAY,GAAG,CACpB,MAAc,EACd,KAAa,EACb,QAAsB,EACtB,WAAoB,EACC,EAAE,CAAC;QACxB,IAAI,CAAC,WAAW;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAC9C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,CAC9E,CAAC;QACF,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAAA,CACpD,CAAC;IAEF,MAAM,cAAc,GAAG,CACtB,MAAc,EACd,KAAa,EACb,UAA+B,EAC/B,QAAsB,EACtB,WAIC,EACQ,EAAE,CAAC;QACZ,WAAW,CAAC,UAAU,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,MAAM;YAChB,KAAK;YACL,UAAU;YACV,QAAQ;YACR,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,GAAG,QAAQ,IAAI,MAAM,EAAE;YAC/D,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;SAC5B,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO;YACN,MAAM;YACN,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;YAC7B,MAAM,EAAE,KAAK,EAAE,MAAsB;YACrC,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;YACpC,+EAA+D;YAC/D,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC;SAC9B,CAAC;IAAA,CACF,CAAC;IAEF,OAAO;QACN,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACpC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACxF,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE;gBACnD,OAAO,EAAE,EAAE,KAAK,EAAE;gBAClB,WAAW,EAAE,UAAU,MAAM,EAAE;aAC/B,CAAC,CAAC;QAAA,CACH;QACD,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE;YACxC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;YACrF,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,QAAQ,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACd,QAAQ,MAAM,kDAAkD,QAAQ,EAAE,MAAM,IAAI,SAAS,GAAG,CAChG,CAAC;YACH,CAAC;YACD,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC;QAAA,CACvG;QACD,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE;YAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;YACtF,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,QAAQ,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,wCAAwC,QAAQ,EAAE,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC;YACzG,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YACxG,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE;gBAC1D,QAAQ;gBACR,WAAW,EAAE,cAAc,EAAE,WAAW;aACxC,CAAC,CAAC;QAAA,CACH;QACD,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE;YACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACnF,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,mCAAmC,QAAQ,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;YACnG,CAAC;YACD,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAAA,CACtE;QACD,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE;YAClB,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAA,CAC9B;KACD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Goal plugin (2.3b) — Goal schema, evidence, and recovery on top of the 2.3a\n * transition store.\n *\n * Status graph: null → draft → active → achieved, and draft/active → archived.\n * `achieve` requires at least one evidence reference. The plugin holds NO\n * shadow state: every read derives status, revision, title, and evidence from\n * the transition history, so recovery is exactly a store replay.\n */\nimport type { TransitionEvidenceRefV1, TransitionStoreV1 } from \"./state-store.ts\";\n\nexport type GoalStatusV1 = \"draft\" | \"active\" | \"achieved\" | \"archived\";\n\nexport interface GoalV1 {\n\treadonly goalId: string;\n\treadonly owner: string;\n\treadonly title: string;\n\treadonly status: GoalStatusV1;\n\treadonly evidence: readonly TransitionEvidenceRefV1[];\n\treadonly revision: number;\n}\n\nexport interface GoalPluginV1 {\n\tcreateGoal(input: { readonly goalId: string; readonly owner: string; readonly title: string }): GoalV1;\n\tactivate(goalId: string, owner: string, options?: { readonly operationId?: string }): GoalV1;\n\tachieve(\n\t\tgoalId: string,\n\t\towner: string,\n\t\tevidence: readonly TransitionEvidenceRefV1[],\n\t\toptions?: { readonly operationId?: string },\n\t): GoalV1;\n\tarchive(goalId: string, owner: string): GoalV1;\n\tget(goalId: string, owner: string): GoalV1 | undefined;\n}\n\nexport function createGoalPlugin(options: { readonly transitions: TransitionStoreV1 }): GoalPluginV1 {\n\tconst transitions = options.transitions;\n\n\tconst goalHistory = (goalId: string, owner: string) =>\n\t\ttransitions.history(goalId).filter((record) => record.domain === \"goal\" && record.owner === owner);\n\n\tconst current = (goalId: string, owner: string): { status: GoalStatusV1; revision: number } | undefined => {\n\t\tconst state = transitions.currentStatus(\"goal\", goalId);\n\t\tif (state === undefined || goalHistory(goalId, owner).length === 0) return undefined;\n\t\treturn { status: state.status as GoalStatusV1, revision: state.revision };\n\t};\n\n\tconst titleOf = (goalId: string, owner: string): string => {\n\t\tfor (const record of goalHistory(goalId, owner)) {\n\t\t\tif (record.fromStatus !== null) continue;\n\t\t\tconst payload = record.payload;\n\t\t\tif (payload !== null && typeof payload === \"object\" && !Array.isArray(payload)) {\n\t\t\t\tconst title = (payload as Record<string, unknown>).title;\n\t\t\t\tif (typeof title === \"string\") return title;\n\t\t\t}\n\t\t}\n\t\treturn goalId;\n\t};\n\n\tconst goalGet = (goalId: string, owner: string): GoalV1 | undefined => {\n\t\tconst state = current(goalId, owner);\n\t\tif (!state) return undefined;\n\t\tconst history = goalHistory(goalId, owner);\n\t\tconst lastEvidence = [...history].reverse().find((record) => record.evidence.length > 0)?.evidence ?? [];\n\t\treturn {\n\t\t\tgoalId,\n\t\t\towner,\n\t\t\ttitle: titleOf(goalId, owner),\n\t\t\tstatus: state.status,\n\t\t\tevidence: lastEvidence,\n\t\t\trevision: state.revision,\n\t\t};\n\t};\n\n\t/** A retried transition with an already-applied operationId returns the existing state instead of conflicting. */\n\tconst replayedGoal = (\n\t\tgoalId: string,\n\t\towner: string,\n\t\ttoStatus: GoalStatusV1,\n\t\toperationId?: string,\n\t): GoalV1 | undefined => {\n\t\tif (!operationId) return undefined;\n\t\tconst applied = goalHistory(goalId, owner).some(\n\t\t\t(record) => record.toStatus === toStatus && record.operationId === operationId,\n\t\t);\n\t\treturn applied ? goalGet(goalId, owner) : undefined;\n\t};\n\n\tconst transitionGoal = (\n\t\tgoalId: string,\n\t\towner: string,\n\t\tfromStatus: GoalStatusV1 | null,\n\t\ttoStatus: GoalStatusV1,\n\t\tgoalOptions: {\n\t\t\treadonly evidence?: readonly TransitionEvidenceRefV1[];\n\t\t\treadonly payload?: { readonly title: string };\n\t\t\treadonly operationId?: string;\n\t\t},\n\t): GoalV1 => {\n\t\ttransitions.transition({\n\t\t\tdomain: \"goal\",\n\t\t\tentityId: goalId,\n\t\t\towner,\n\t\t\tfromStatus,\n\t\t\ttoStatus,\n\t\t\toperationId: goalOptions.operationId ?? `${toStatus}:${goalId}`,\n\t\t\tevidence: goalOptions.evidence,\n\t\t\tpayload: goalOptions.payload,\n\t\t});\n\t\tconst state = transitions.currentStatus(\"goal\", goalId);\n\t\treturn {\n\t\t\tgoalId,\n\t\t\towner,\n\t\t\ttitle: titleOf(goalId, owner),\n\t\t\tstatus: state?.status as GoalStatusV1,\n\t\t\tevidence: goalOptions.evidence ?? [],\n\t\t\t// v8 ignore next -- transition 刚写入 currentStatus，必可读到 revision\n\t\t\trevision: state?.revision ?? 0,\n\t\t};\n\t};\n\n\treturn {\n\t\tcreateGoal({ goalId, owner, title }) {\n\t\t\tif (title.trim().length === 0) throw new Error(\"Goal title must be a non-empty string\");\n\t\t\treturn transitionGoal(goalId, owner, null, \"draft\", {\n\t\t\t\tpayload: { title },\n\t\t\t\toperationId: `create:${goalId}`,\n\t\t\t});\n\t\t},\n\t\tactivate(goalId, owner, activateOptions) {\n\t\t\tconst replayed = replayedGoal(goalId, owner, \"active\", activateOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst existing = current(goalId, owner);\n\t\t\tif (existing?.status !== \"draft\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Goal ${goalId} must be in draft status to activate (current: ${existing?.status ?? \"missing\"})`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn transitionGoal(goalId, owner, \"draft\", \"active\", { operationId: activateOptions?.operationId });\n\t\t},\n\t\tachieve(goalId, owner, evidence, achieveOptions) {\n\t\t\tconst replayed = replayedGoal(goalId, owner, \"achieved\", achieveOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst existing = current(goalId, owner);\n\t\t\tif (existing?.status !== \"active\") {\n\t\t\t\tthrow new Error(`Goal ${goalId} must be active to achieve (current: ${existing?.status ?? \"missing\"})`);\n\t\t\t}\n\t\t\tif (evidence.length === 0) throw new Error(\"Achieving a goal requires at least one evidence reference\");\n\t\t\treturn transitionGoal(goalId, owner, \"active\", \"achieved\", {\n\t\t\t\tevidence,\n\t\t\t\toperationId: achieveOptions?.operationId,\n\t\t\t});\n\t\t},\n\t\tarchive(goalId, owner) {\n\t\t\tconst existing = current(goalId, owner);\n\t\t\tif (!existing || existing.status === \"achieved\" || existing.status === \"archived\") {\n\t\t\t\tthrow new Error(`Goal ${goalId} cannot be archived from status ${existing?.status ?? \"missing\"}`);\n\t\t\t}\n\t\t\treturn transitionGoal(goalId, owner, existing.status, \"archived\", {});\n\t\t},\n\t\tget(goalId, owner) {\n\t\t\treturn goalGet(goalId, owner);\n\t\t},\n\t};\n}\n"]}

package/dist/profile/identity.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Profile identity — minimal Profile identity, resolved manifest digest, and
+ * host compatibility facts (2.0a).
+ *
+ * The identity is fully determined by the resolved inputs: profileId +
+ * profileVersion name it; the manifest digest is an FNV-1a digest over the
+ * key-order-stable serialization of the sorted resolved plugin manifests; the
+ * resolved capability versions are carried as a sorted, JSON-serializable
+ * list. The identity is the input for the session-start Profile lock (2.0b).
+ */
+import type { JsonValue } from "@agent-forge/ai";
+/** One resolved plugin manifest entry of a Profile. */
+export interface ResolvedPluginManifestV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly manifestPath?: string;
+    readonly capabilityRefs: readonly {
+        readonly id: string;
+        readonly version: number;
+    }[];
+    readonly selectedAdapter?: {
+        readonly id: string;
+        readonly version: string;
+    };
+}
+/** The serializable, digest-carrying Profile identity. */
+export interface ProfileIdentityV1 {
+    readonly profileId: string;
+    readonly profileVersion: string;
+    /** FNV-1a digest over the stable serialization of the resolved manifests. */
+    readonly manifestDigest: string;
+    /** Sorted (id, version) capability references of the resolved set. */
+    readonly capabilityVersions: readonly {
+        readonly id: string;
+        readonly version: number;
+    }[];
+}
+/** FNV-1a 64-bit digest over the key-order-stable JSON serialization. */
+export declare function stableJsonDigest(value: JsonValue): string;
+/**
+ * Builds the Profile identity from the resolved inputs. The digest is
+ * order-independent (sorted before serialization) so the same resolved set
+ * always yields the same identity regardless of discovery order.
+ */
+export declare function buildProfileIdentityV1(input: {
+    readonly profileId: string;
+    readonly profileVersion: string;
+    /** Resolved plugin manifests participating in the Profile. */
+    readonly resolvedPlugins: readonly ResolvedPluginManifestV1[];
+    /** Resolved capability references (id + exact version). */
+    readonly capabilityVersions: readonly {
+        readonly id: string;
+        readonly version: number;
+    }[];
+}): ProfileIdentityV1;
+/** Host compatibility check: identities match when the digests are equal. */
+export declare function profileIdentitiesCompatible(left: ProfileIdentityV1, right: ProfileIdentityV1): boolean;
+//# sourceMappingURL=identity.d.ts.map

package/dist/profile/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/profile/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtF,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1F;AAaD,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAQzD;AA2CD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9D,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1F,GAAG,iBAAiB,CAgCpB;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAEtG","sourcesContent":["/**\n * Profile identity — minimal Profile identity, resolved manifest digest, and\n * host compatibility facts (2.0a).\n *\n * The identity is fully determined by the resolved inputs: profileId +\n * profileVersion name it; the manifest digest is an FNV-1a digest over the\n * key-order-stable serialization of the sorted resolved plugin manifests; the\n * resolved capability versions are carried as a sorted, JSON-serializable\n * list. The identity is the input for the session-start Profile lock (2.0b).\n */\nimport type { JsonValue } from \"@agent-forge/ai\";\nimport { comparePluginVersionsV1 } from \"../plugins/ecosystem/catalog.ts\";\n\n/** One resolved plugin manifest entry of a Profile. */\nexport interface ResolvedPluginManifestV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly manifestPath?: string;\n\treadonly capabilityRefs: readonly { readonly id: string; readonly version: number }[];\n\treadonly selectedAdapter?: { readonly id: string; readonly version: string };\n}\n\n/** The serializable, digest-carrying Profile identity. */\nexport interface ProfileIdentityV1 {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\t/** FNV-1a digest over the stable serialization of the resolved manifests. */\n\treadonly manifestDigest: string;\n\t/** Sorted (id, version) capability references of the resolved set. */\n\treadonly capabilityVersions: readonly { readonly id: string; readonly version: number }[];\n}\n\nfunction stableStringify(value: JsonValue): string {\n\tif (value === null || typeof value === \"boolean\" || typeof value === \"number\" || typeof value === \"string\") {\n\t\treturn JSON.stringify(value);\n\t}\n\tif (Array.isArray(value)) return `[${value.map((item) => stableStringify(item)).join(\",\")}]`;\n\tconst entries = Object.keys(value)\n\t\t.sort()\n\t\t.map((key) => `${JSON.stringify(key)}:${stableStringify((value as Record<string, JsonValue>)[key])}`);\n\treturn `{${entries.join(\",\")}}`;\n}\n\n/** FNV-1a 64-bit digest over the key-order-stable JSON serialization. */\nexport function stableJsonDigest(value: JsonValue): string {\n\tconst serialized = stableStringify(value);\n\tlet digest = 14695981039346656037n;\n\tfor (const byte of new TextEncoder().encode(serialized)) {\n\t\tdigest ^= BigInt(byte);\n\t\tdigest = BigInt.asUintN(64, digest * 1099511628211n);\n\t}\n\treturn digest.toString(16).padStart(16, \"0\");\n}\n\nfunction assertNonEmptyString(value: unknown, label: string): asserts value is string {\n\tif (typeof value !== \"string\" || value.trim().length === 0) throw new Error(`${label} must be a non-empty string`);\n}\n\nfunction assertPluginEntries(\n\tvalue: unknown,\n\tlabel: string,\n): { pluginId: string; pluginVersion: string; selectedAdapter?: { id: string; version: string } }[] {\n\tif (!Array.isArray(value)) throw new Error(`${label} must be an array`);\n\tconst seen = new Set<string>();\n\tconst entries = value.map((item, index) => {\n\t\tif (item === null || typeof item !== \"object\" || Array.isArray(item)) {\n\t\t\tthrow new Error(`${label}[${index}] must be a plain object`);\n\t\t}\n\t\tconst record = item as Record<string, unknown>;\n\t\tassertNonEmptyString(record.pluginId, `${label}[${index}].pluginId`);\n\t\tassertNonEmptyString(record.pluginVersion, `${label}[${index}].pluginVersion`);\n\t\tconst key = `${record.pluginId}@${record.pluginVersion}`;\n\t\tif (seen.has(key)) throw new Error(`${label} contains duplicate entry: ${key}`);\n\t\tseen.add(key);\n\t\tconst selectedAdapter = record.selectedAdapter;\n\t\tif (selectedAdapter === undefined) return { pluginId: record.pluginId, pluginVersion: record.pluginVersion };\n\t\tif (selectedAdapter === null || typeof selectedAdapter !== \"object\" || Array.isArray(selectedAdapter)) {\n\t\t\tthrow new Error(`${label}[${index}].selectedAdapter must be an object`);\n\t\t}\n\t\tconst adapter = selectedAdapter as Record<string, unknown>;\n\t\tassertNonEmptyString(adapter.id, `${label}[${index}].selectedAdapter.id`);\n\t\tassertNonEmptyString(adapter.version, `${label}[${index}].selectedAdapter.version`);\n\t\treturn {\n\t\t\tpluginId: record.pluginId,\n\t\t\tpluginVersion: record.pluginVersion,\n\t\t\tselectedAdapter: { id: adapter.id, version: adapter.version },\n\t\t};\n\t});\n\treturn entries.sort((left, right) =>\n\t\tleft.pluginId === right.pluginId\n\t\t\t? comparePluginVersionsV1(left.pluginVersion, right.pluginVersion)\n\t\t\t: left.pluginId.localeCompare(right.pluginId),\n\t);\n}\n\n/**\n * Builds the Profile identity from the resolved inputs. The digest is\n * order-independent (sorted before serialization) so the same resolved set\n * always yields the same identity regardless of discovery order.\n */\nexport function buildProfileIdentityV1(input: {\n\treadonly profileId: string;\n\treadonly profileVersion: string;\n\t/** Resolved plugin manifests participating in the Profile. */\n\treadonly resolvedPlugins: readonly ResolvedPluginManifestV1[];\n\t/** Resolved capability references (id + exact version). */\n\treadonly capabilityVersions: readonly { readonly id: string; readonly version: number }[];\n}): ProfileIdentityV1 {\n\tassertNonEmptyString(input.profileId, \"Profile identity.profileId\");\n\tassertNonEmptyString(input.profileVersion, \"Profile identity.profileVersion\");\n\tconst pluginEntries = assertPluginEntries(input.resolvedPlugins, \"Profile identity.resolvedPlugins\");\n\n\tconst capabilityVersions = [...input.capabilityVersions]\n\t\t.map((ref) => {\n\t\t\tif (typeof ref.version !== \"number\" || !Number.isSafeInteger(ref.version) || ref.version < 1) {\n\t\t\t\tthrow new Error(`Profile identity.capabilityVersions version must be a positive safe integer: ${ref.id}`);\n\t\t\t}\n\t\t\tassertNonEmptyString(ref.id, \"Profile identity.capabilityVersions.id\");\n\t\t\treturn { id: ref.id, version: ref.version };\n\t\t})\n\t\t.sort((left, right) => (left.id === right.id ? left.version - right.version : left.id.localeCompare(right.id)));\n\n\tconst manifestDigest = stableJsonDigest({\n\t\tprofileId: input.profileId,\n\t\tprofileVersion: input.profileVersion,\n\t\tplugins: pluginEntries.map((entry) => ({\n\t\t\tpluginId: entry.pluginId,\n\t\t\tpluginVersion: entry.pluginVersion,\n\t\t\t...(entry.selectedAdapter === undefined ? {} : { selectedAdapter: entry.selectedAdapter }),\n\t\t})),\n\t\tcapabilityVersions: capabilityVersions.map((ref) => ({ id: ref.id, version: ref.version })),\n\t});\n\n\treturn Object.freeze({\n\t\tprofileId: input.profileId,\n\t\tprofileVersion: input.profileVersion,\n\t\tmanifestDigest,\n\t\tcapabilityVersions: Object.freeze(capabilityVersions.map((ref) => Object.freeze({ ...ref }))),\n\t});\n}\n\n/** Host compatibility check: identities match when the digests are equal. */\nexport function profileIdentitiesCompatible(left: ProfileIdentityV1, right: ProfileIdentityV1): boolean {\n\treturn left.manifestDigest === right.manifestDigest;\n}\n"]}

package/dist/profile/identity.js

@@ -0,0 +1,100 @@
+import { comparePluginVersionsV1 } from "../plugins/ecosystem/catalog.js";
+function stableStringify(value) {
+    if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    const entries = Object.keys(value)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`);
+    return `{${entries.join(",")}}`;
+}
+/** FNV-1a 64-bit digest over the key-order-stable JSON serialization. */
+export function stableJsonDigest(value) {
+    const serialized = stableStringify(value);
+    let digest = 14695981039346656037n;
+    for (const byte of new TextEncoder().encode(serialized)) {
+        digest ^= BigInt(byte);
+        digest = BigInt.asUintN(64, digest * 1099511628211n);
+    }
+    return digest.toString(16).padStart(16, "0");
+}
+function assertNonEmptyString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        throw new Error(`${label} must be a non-empty string`);
+}
+function assertPluginEntries(value, label) {
+    if (!Array.isArray(value))
+        throw new Error(`${label} must be an array`);
+    const seen = new Set();
+    const entries = value.map((item, index) => {
+        if (item === null || typeof item !== "object" || Array.isArray(item)) {
+            throw new Error(`${label}[${index}] must be a plain object`);
+        }
+        const record = item;
+        assertNonEmptyString(record.pluginId, `${label}[${index}].pluginId`);
+        assertNonEmptyString(record.pluginVersion, `${label}[${index}].pluginVersion`);
+        const key = `${record.pluginId}@${record.pluginVersion}`;
+        if (seen.has(key))
+            throw new Error(`${label} contains duplicate entry: ${key}`);
+        seen.add(key);
+        const selectedAdapter = record.selectedAdapter;
+        if (selectedAdapter === undefined)
+            return { pluginId: record.pluginId, pluginVersion: record.pluginVersion };
+        if (selectedAdapter === null || typeof selectedAdapter !== "object" || Array.isArray(selectedAdapter)) {
+            throw new Error(`${label}[${index}].selectedAdapter must be an object`);
+        }
+        const adapter = selectedAdapter;
+        assertNonEmptyString(adapter.id, `${label}[${index}].selectedAdapter.id`);
+        assertNonEmptyString(adapter.version, `${label}[${index}].selectedAdapter.version`);
+        return {
+            pluginId: record.pluginId,
+            pluginVersion: record.pluginVersion,
+            selectedAdapter: { id: adapter.id, version: adapter.version },
+        };
+    });
+    return entries.sort((left, right) => left.pluginId === right.pluginId
+        ? comparePluginVersionsV1(left.pluginVersion, right.pluginVersion)
+        : left.pluginId.localeCompare(right.pluginId));
+}
+/**
+ * Builds the Profile identity from the resolved inputs. The digest is
+ * order-independent (sorted before serialization) so the same resolved set
+ * always yields the same identity regardless of discovery order.
+ */
+export function buildProfileIdentityV1(input) {
+    assertNonEmptyString(input.profileId, "Profile identity.profileId");
+    assertNonEmptyString(input.profileVersion, "Profile identity.profileVersion");
+    const pluginEntries = assertPluginEntries(input.resolvedPlugins, "Profile identity.resolvedPlugins");
+    const capabilityVersions = [...input.capabilityVersions]
+        .map((ref) => {
+        if (typeof ref.version !== "number" || !Number.isSafeInteger(ref.version) || ref.version < 1) {
+            throw new Error(`Profile identity.capabilityVersions version must be a positive safe integer: ${ref.id}`);
+        }
+        assertNonEmptyString(ref.id, "Profile identity.capabilityVersions.id");
+        return { id: ref.id, version: ref.version };
+    })
+        .sort((left, right) => (left.id === right.id ? left.version - right.version : left.id.localeCompare(right.id)));
+    const manifestDigest = stableJsonDigest({
+        profileId: input.profileId,
+        profileVersion: input.profileVersion,
+        plugins: pluginEntries.map((entry) => ({
+            pluginId: entry.pluginId,
+            pluginVersion: entry.pluginVersion,
+            ...(entry.selectedAdapter === undefined ? {} : { selectedAdapter: entry.selectedAdapter }),
+        })),
+        capabilityVersions: capabilityVersions.map((ref) => ({ id: ref.id, version: ref.version })),
+    });
+    return Object.freeze({
+        profileId: input.profileId,
+        profileVersion: input.profileVersion,
+        manifestDigest,
+        capabilityVersions: Object.freeze(capabilityVersions.map((ref) => Object.freeze({ ...ref }))),
+    });
+}
+/** Host compatibility check: identities match when the digests are equal. */
+export function profileIdentitiesCompatible(left, right) {
+    return left.manifestDigest === right.manifestDigest;
+}
+//# sourceMappingURL=identity.js.map