@ai-agent-forge/agent-forge 0.86.7 → 0.88.0

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

@@ -1 +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"]}
+{"version":3,"file":"goal-plugin.d.ts","sourceRoot":"","sources":["../../src/profile/goal-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,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,CA8InG","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 */\n\nimport { t } from \"../core/i18n/index.ts\";\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(t(\"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\tt(\"Goal {goalId} must be in draft status to activate (current: {status})\", {\n\t\t\t\t\t\tgoalId,\n\t\t\t\t\t\tstatus: existing?.status ?? \"missing\",\n\t\t\t\t\t}),\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(\n\t\t\t\t\tt(\"Goal {goalId} must be active to achieve (current: {status})\", {\n\t\t\t\t\t\tgoalId,\n\t\t\t\t\t\tstatus: existing?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (evidence.length === 0) throw new Error(t(\"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(\n\t\t\t\t\tt(\"Goal {goalId} cannot be archived from status {status}\", {\n\t\t\t\t\t\tgoalId,\n\t\t\t\t\t\tstatus: existing?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\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

@@ -1,3 +1,13 @@
+/**
+ * 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 { t } from "../core/i18n/index.js";
 export function createGoalPlugin(options) {
     const transitions = options.transitions;
     const goalHistory = (goalId, owner) => transitions.history(goalId).filter((record) => record.domain === "goal" && record.owner === owner);
@@ -67,7 +77,7 @@ export function createGoalPlugin(options) {
     return {
         createGoal({ goalId, owner, title }) {
             if (title.trim().length === 0)
-                throw new Error("Goal title must be a non-empty string");
+                throw new Error(t("Goal title must be a non-empty string"));
             return transitionGoal(goalId, owner, null, "draft", {
                 payload: { title },
                 operationId: `create:${goalId}`,
@@ -79,7 +89,10 @@ export function createGoalPlugin(options) {
                 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"})`);
+                throw new Error(t("Goal {goalId} must be in draft status to activate (current: {status})", {
+                    goalId,
+                    status: existing?.status ?? "missing",
+                }));
             }
             return transitionGoal(goalId, owner, "draft", "active", { operationId: activateOptions?.operationId });
         },
@@ -89,10 +102,13 @@ export function createGoalPlugin(options) {
                 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"})`);
+                throw new Error(t("Goal {goalId} must be active to achieve (current: {status})", {
+                    goalId,
+                    status: existing?.status ?? "missing",
+                }));
             }
             if (evidence.length === 0)
-                throw new Error("Achieving a goal requires at least one evidence reference");
+                throw new Error(t("Achieving a goal requires at least one evidence reference"));
             return transitionGoal(goalId, owner, "active", "achieved", {
                 evidence,
                 operationId: achieveOptions?.operationId,
@@ -101,7 +117,10 @@ export function createGoalPlugin(options) {
         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"}`);
+                throw new Error(t("Goal {goalId} cannot be archived from status {status}", {
+                    goalId,
+                    status: existing?.status ?? "missing",
+                }));
             }
             return transitionGoal(goalId, owner, existing.status, "archived", {});
         },

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

@@ -1 +1 @@
-{"version":3,"file":"goal-plugin.js","sourceRoot":"","sources":["../../src/profile/goal-plugin.ts"],"names":[],"mappings":"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","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"]}
+{"version":3,"file":"goal-plugin.js","sourceRoot":"","sources":["../../src/profile/goal-plugin.ts"],"names":[],"mappings":"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","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 */\n\nimport { t } from \"../core/i18n/index.ts\";\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(t(\"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\tt(\"Goal {goalId} must be in draft status to activate (current: {status})\", {\n\t\t\t\t\t\tgoalId,\n\t\t\t\t\t\tstatus: existing?.status ?? \"missing\",\n\t\t\t\t\t}),\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(\n\t\t\t\t\tt(\"Goal {goalId} must be active to achieve (current: {status})\", {\n\t\t\t\t\t\tgoalId,\n\t\t\t\t\t\tstatus: existing?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (evidence.length === 0) throw new Error(t(\"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(\n\t\t\t\t\tt(\"Goal {goalId} cannot be archived from status {status}\", {\n\t\t\t\t\t\tgoalId,\n\t\t\t\t\t\tstatus: existing?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\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.map

@@ -1 +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"]}
+{"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;AAIjD,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;AA4CD;;;;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,CAkCpB;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 { t } from \"../core/i18n/index.ts\";\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)\n\t\tthrow new Error(t(\"{label} must be a non-empty string\", { label }));\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(t(\"{label} must be an array\", { label }));\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(t(\"{label}[{index}] must be a plain object\", { label, index }));\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(t(\"{label} contains duplicate entry: {key}\", { label, 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(t(\"{label}[{index}].selectedAdapter must be an object\", { label, index }));\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(\n\t\t\t\t\tt(\"Profile identity.capabilityVersions version must be a positive safe integer: {id}\", { id: ref.id }),\n\t\t\t\t);\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

@@ -1,3 +1,4 @@
+import { t } from "../core/i18n/index.js";
 import { comparePluginVersionsV1 } from "../plugins/ecosystem/catalog.js";
 function stableStringify(value) {
     if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
@@ -22,28 +23,28 @@ export function stableJsonDigest(value) {
 }
 function assertNonEmptyString(value, label) {
     if (typeof value !== "string" || value.trim().length === 0)
-        throw new Error(`${label} must be a non-empty string`);
+        throw new Error(t("{label} must be a non-empty string", { label }));
 }
 function assertPluginEntries(value, label) {
     if (!Array.isArray(value))
-        throw new Error(`${label} must be an array`);
+        throw new Error(t("{label} must be an array", { label }));
     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`);
+            throw new Error(t("{label}[{index}] must be a plain object", { label, index }));
         }
         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}`);
+            throw new Error(t("{label} contains duplicate entry: {key}", { label, 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`);
+            throw new Error(t("{label}[{index}].selectedAdapter must be an object", { label, index }));
         }
         const adapter = selectedAdapter;
         assertNonEmptyString(adapter.id, `${label}[${index}].selectedAdapter.id`);
@@ -70,7 +71,7 @@ export function buildProfileIdentityV1(input) {
     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}`);
+            throw new Error(t("Profile identity.capabilityVersions version must be a positive safe integer: {id}", { id: ref.id }));
         }
         assertNonEmptyString(ref.id, "Profile identity.capabilityVersions.id");
         return { id: ref.id, version: ref.version };

package/dist/profile/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/profile/identity.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAqB1E,SAAS,eAAe,CAAC,KAAgB,EAAU;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5G,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SAChC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAE,KAAmC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACvG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAAA,CAChC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAU;IAC1D,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,qBAAqB,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAAA,CAC7C;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa,EAA2B;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;AAAA,CACnH;AAED,SAAS,mBAAmB,CAC3B,KAAc,EACd,KAAa,EACsF;IACnG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1C,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,KAAK,0BAA0B,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,IAA+B,CAAC;QAC/C,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,KAAK,YAAY,CAAC,CAAC;QACrE,oBAAoB,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,KAAK,IAAI,KAAK,iBAAiB,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,GAAG,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC/C,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7G,IAAI,eAAe,KAAK,IAAI,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YACvG,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,KAAK,qCAAqC,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,OAAO,GAAG,eAA0C,CAAC;QAC3D,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,KAAK,sBAAsB,CAAC,CAAC;QAC1E,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,2BAA2B,CAAC,CAAC;QACpF,OAAO;YACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,eAAe,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;SAC7D,CAAC;IAAA,CACF,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QAC/B,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC;QAClE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC9C,CAAC;AAAA,CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAOtC,EAAqB;IACrB,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;IACpE,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;IAErG,MAAM,kBAAkB,GAAG,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC;SACtD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACb,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YAC9F,MAAM,IAAI,KAAK,CAAC,gFAAgF,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,wCAAwC,CAAC,CAAC;QACvE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAAA,CAC5C,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjH,MAAM,cAAc,GAAG,gBAAgB,CAAC;QACvC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;SAC1F,CAAC,CAAC;QACH,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;KAC3F,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,cAAc;QACd,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;KAC7F,CAAC,CAAC;AAAA,CACH;AAED,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B,CAAC,IAAuB,EAAE,KAAwB,EAAW;IACvG,OAAO,IAAI,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc,CAAC;AAAA,CACpD","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"]}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/profile/identity.ts"],"names":[],"mappings":"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","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 { t } from \"../core/i18n/index.ts\";\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)\n\t\tthrow new Error(t(\"{label} must be a non-empty string\", { label }));\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(t(\"{label} must be an array\", { label }));\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(t(\"{label}[{index}] must be a plain object\", { label, index }));\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(t(\"{label} contains duplicate entry: {key}\", { label, 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(t(\"{label}[{index}].selectedAdapter must be an object\", { label, index }));\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(\n\t\t\t\t\tt(\"Profile identity.capabilityVersions version must be a positive safe integer: {id}\", { id: ref.id }),\n\t\t\t\t);\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/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/profile/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;CAC9B;AAED,MAAM,MAAM,yBAAyB,GAClC;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC7B;IACA,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtD,QAAQ,CAAC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD,GACD;IACA,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEL,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC7B;AAMD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACvE,aAAa,CAQf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,yBAAyB,CAsB5G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAChD,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAC3C,0BAA0B,CAW5B","sourcesContent":["/**\n * Profile lock — pre-creation lock and reopen/reload drift detection (2.0b).\n *\n * A Profile lock freezes the resolved `ProfileIdentityV1` at session creation.\n * Reopen/reload verifies the current resolved identity against the lock:\n * - same manifest digest + profile version → `locked`;\n * - same version but a different resolved set → `drift` with the differing\n *   capability/plugin facts;\n * - different profile version → `migration_required` (explicit, never an\n *   automatic replacement).\n * Replacing a lock requires explicit authorization and is observable — the\n * locked list can never be silently swapped.\n */\nimport type { ProfileIdentityV1 } from \"./identity.ts\";\nimport { profileIdentitiesCompatible } from \"./identity.ts\";\n\nexport interface ProfileLockV1 {\n\treadonly identity: ProfileIdentityV1;\n\treadonly lockedAt: number;\n\treadonly lockedBy: string;\n\t/** Generation increments on each authorized replacement. */\n\treadonly generation: number;\n\treadonly supersededBy?: never;\n}\n\nexport type ProfileLockVerificationV1 =\n\t| { readonly status: \"locked\" }\n\t| {\n\t\t\treadonly status: \"drift\";\n\t\t\treadonly reason: string;\n\t\t\treadonly missingCapabilityVersions: readonly string[];\n\t\t\treadonly addedCapabilityVersions: readonly string[];\n\t  }\n\t| {\n\t\t\treadonly status: \"migration_required\";\n\t\t\treadonly reason: string;\n\t\t\treadonly fromProfileVersion: string;\n\t\t\treadonly toProfileVersion: string;\n\t  };\n\nexport interface ProfileLockReplaceResultV1 {\n\treadonly previousGeneration: number;\n\treadonly lock: ProfileLockV1;\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\n/** Creates an immutable Profile lock over a resolved identity (2.0b). */\nexport function createProfileLock(\n\tidentity: ProfileIdentityV1,\n\toptions: { readonly lockedBy?: string; readonly now?: () => number } = {},\n): ProfileLockV1 {\n\tassertNonEmptyString(identity.profileId, \"Profile lock.profileId\");\n\treturn Object.freeze({\n\t\tidentity,\n\t\tlockedAt: options.now?.() ?? 0,\n\t\tlockedBy: options.lockedBy ?? \"host\",\n\t\tgeneration: 1,\n\t});\n}\n\n/**\n * Verifies a current resolved identity against the lock during reopen/reload.\n * The lock itself is never mutated; drift and migration are explicit results.\n */\nexport function verifyProfileLock(lock: ProfileLockV1, current: ProfileIdentityV1): ProfileLockVerificationV1 {\n\tif (current.profileVersion !== lock.identity.profileVersion) {\n\t\treturn Object.freeze({\n\t\t\tstatus: \"migration_required\",\n\t\t\treason: `Profile version changed from ${lock.identity.profileVersion} to ${current.profileVersion}; explicit migration is required`,\n\t\t\tfromProfileVersion: lock.identity.profileVersion,\n\t\t\ttoProfileVersion: current.profileVersion,\n\t\t});\n\t}\n\tif (!profileIdentitiesCompatible(lock.identity, current)) {\n\t\tconst lockedIds = new Set(lock.identity.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst currentIds = new Set(current.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst missing = [...lockedIds].filter((id) => !currentIds.has(id));\n\t\tconst added = [...currentIds].filter((id) => !lockedIds.has(id));\n\t\treturn Object.freeze({\n\t\t\tstatus: \"drift\",\n\t\t\treason: \"Resolved manifest digest differs from the locked profile identity\",\n\t\t\tmissingCapabilityVersions: Object.freeze(missing),\n\t\t\taddedCapabilityVersions: Object.freeze(added),\n\t\t});\n\t}\n\treturn { status: \"locked\" };\n}\n\n/**\n * Replaces a lock with explicit authorization. This is the ONLY way to change\n * a lock — silent replacement does not exist.\n */\nexport function replaceProfileLock(\n\tlock: ProfileLockV1,\n\tidentity: ProfileIdentityV1,\n\tauthorization: { readonly authorizedBy: string },\n\toptions: { readonly now?: () => number } = {},\n): ProfileLockReplaceResultV1 {\n\tassertNonEmptyString(authorization.authorizedBy, \"authorizedBy\");\n\treturn {\n\t\tpreviousGeneration: lock.generation,\n\t\tlock: Object.freeze({\n\t\t\tidentity,\n\t\t\tlockedAt: options.now?.() ?? 0,\n\t\t\tlockedBy: authorization.authorizedBy,\n\t\t\tgeneration: lock.generation + 1,\n\t\t}),\n\t};\n}\n"]}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/profile/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;CAC9B;AAED,MAAM,MAAM,yBAAyB,GAClC;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC7B;IACA,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtD,QAAQ,CAAC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD,GACD;IACA,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEL,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC7B;AAOD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACvE,aAAa,CAQf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,yBAAyB,CAsB5G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAChD,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAC3C,0BAA0B,CAW5B","sourcesContent":["/**\n * Profile lock — pre-creation lock and reopen/reload drift detection (2.0b).\n *\n * A Profile lock freezes the resolved `ProfileIdentityV1` at session creation.\n * Reopen/reload verifies the current resolved identity against the lock:\n * - same manifest digest + profile version → `locked`;\n * - same version but a different resolved set → `drift` with the differing\n *   capability/plugin facts;\n * - different profile version → `migration_required` (explicit, never an\n *   automatic replacement).\n * Replacing a lock requires explicit authorization and is observable — the\n * locked list can never be silently swapped.\n */\n\nimport { t } from \"../core/i18n/index.ts\";\nimport type { ProfileIdentityV1 } from \"./identity.ts\";\nimport { profileIdentitiesCompatible } from \"./identity.ts\";\n\nexport interface ProfileLockV1 {\n\treadonly identity: ProfileIdentityV1;\n\treadonly lockedAt: number;\n\treadonly lockedBy: string;\n\t/** Generation increments on each authorized replacement. */\n\treadonly generation: number;\n\treadonly supersededBy?: never;\n}\n\nexport type ProfileLockVerificationV1 =\n\t| { readonly status: \"locked\" }\n\t| {\n\t\t\treadonly status: \"drift\";\n\t\t\treadonly reason: string;\n\t\t\treadonly missingCapabilityVersions: readonly string[];\n\t\t\treadonly addedCapabilityVersions: readonly string[];\n\t  }\n\t| {\n\t\t\treadonly status: \"migration_required\";\n\t\t\treadonly reason: string;\n\t\t\treadonly fromProfileVersion: string;\n\t\t\treadonly toProfileVersion: string;\n\t  };\n\nexport interface ProfileLockReplaceResultV1 {\n\treadonly previousGeneration: number;\n\treadonly lock: ProfileLockV1;\n}\n\nfunction assertNonEmptyString(value: unknown, label: string): asserts value is string {\n\tif (typeof value !== \"string\" || value.trim().length === 0)\n\t\tthrow new Error(t(\"{label} must be a non-empty string\", { label }));\n}\n\n/** Creates an immutable Profile lock over a resolved identity (2.0b). */\nexport function createProfileLock(\n\tidentity: ProfileIdentityV1,\n\toptions: { readonly lockedBy?: string; readonly now?: () => number } = {},\n): ProfileLockV1 {\n\tassertNonEmptyString(identity.profileId, \"Profile lock.profileId\");\n\treturn Object.freeze({\n\t\tidentity,\n\t\tlockedAt: options.now?.() ?? 0,\n\t\tlockedBy: options.lockedBy ?? \"host\",\n\t\tgeneration: 1,\n\t});\n}\n\n/**\n * Verifies a current resolved identity against the lock during reopen/reload.\n * The lock itself is never mutated; drift and migration are explicit results.\n */\nexport function verifyProfileLock(lock: ProfileLockV1, current: ProfileIdentityV1): ProfileLockVerificationV1 {\n\tif (current.profileVersion !== lock.identity.profileVersion) {\n\t\treturn Object.freeze({\n\t\t\tstatus: \"migration_required\",\n\t\t\treason: `Profile version changed from ${lock.identity.profileVersion} to ${current.profileVersion}; explicit migration is required`,\n\t\t\tfromProfileVersion: lock.identity.profileVersion,\n\t\t\ttoProfileVersion: current.profileVersion,\n\t\t});\n\t}\n\tif (!profileIdentitiesCompatible(lock.identity, current)) {\n\t\tconst lockedIds = new Set(lock.identity.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst currentIds = new Set(current.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst missing = [...lockedIds].filter((id) => !currentIds.has(id));\n\t\tconst added = [...currentIds].filter((id) => !lockedIds.has(id));\n\t\treturn Object.freeze({\n\t\t\tstatus: \"drift\",\n\t\t\treason: \"Resolved manifest digest differs from the locked profile identity\",\n\t\t\tmissingCapabilityVersions: Object.freeze(missing),\n\t\t\taddedCapabilityVersions: Object.freeze(added),\n\t\t});\n\t}\n\treturn { status: \"locked\" };\n}\n\n/**\n * Replaces a lock with explicit authorization. This is the ONLY way to change\n * a lock — silent replacement does not exist.\n */\nexport function replaceProfileLock(\n\tlock: ProfileLockV1,\n\tidentity: ProfileIdentityV1,\n\tauthorization: { readonly authorizedBy: string },\n\toptions: { readonly now?: () => number } = {},\n): ProfileLockReplaceResultV1 {\n\tassertNonEmptyString(authorization.authorizedBy, \"authorizedBy\");\n\treturn {\n\t\tpreviousGeneration: lock.generation,\n\t\tlock: Object.freeze({\n\t\t\tidentity,\n\t\t\tlockedAt: options.now?.() ?? 0,\n\t\t\tlockedBy: authorization.authorizedBy,\n\t\t\tgeneration: lock.generation + 1,\n\t\t}),\n\t};\n}\n"]}

package/dist/profile/lock.js

@@ -1,7 +1,21 @@
+/**
+ * Profile lock — pre-creation lock and reopen/reload drift detection (2.0b).
+ *
+ * A Profile lock freezes the resolved `ProfileIdentityV1` at session creation.
+ * Reopen/reload verifies the current resolved identity against the lock:
+ * - same manifest digest + profile version → `locked`;
+ * - same version but a different resolved set → `drift` with the differing
+ *   capability/plugin facts;
+ * - different profile version → `migration_required` (explicit, never an
+ *   automatic replacement).
+ * Replacing a lock requires explicit authorization and is observable — the
+ * locked list can never be silently swapped.
+ */
+import { t } from "../core/i18n/index.js";
 import { profileIdentitiesCompatible } from "./identity.js";
 function assertNonEmptyString(value, label) {
     if (typeof value !== "string" || value.trim().length === 0)
-        throw new Error(`${label} must be a non-empty string`);
+        throw new Error(t("{label} must be a non-empty string", { label }));
 }
 /** Creates an immutable Profile lock over a resolved identity (2.0b). */
 export function createProfileLock(identity, options = {}) {

package/dist/profile/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/profile/lock.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Profile lock — pre-creation lock and reopen/reload drift detection (2.0b).\n *\n * A Profile lock freezes the resolved `ProfileIdentityV1` at session creation.\n * Reopen/reload verifies the current resolved identity against the lock:\n * - same manifest digest + profile version → `locked`;\n * - same version but a different resolved set → `drift` with the differing\n *   capability/plugin facts;\n * - different profile version → `migration_required` (explicit, never an\n *   automatic replacement).\n * Replacing a lock requires explicit authorization and is observable — the\n * locked list can never be silently swapped.\n */\nimport type { ProfileIdentityV1 } from \"./identity.ts\";\nimport { profileIdentitiesCompatible } from \"./identity.ts\";\n\nexport interface ProfileLockV1 {\n\treadonly identity: ProfileIdentityV1;\n\treadonly lockedAt: number;\n\treadonly lockedBy: string;\n\t/** Generation increments on each authorized replacement. */\n\treadonly generation: number;\n\treadonly supersededBy?: never;\n}\n\nexport type ProfileLockVerificationV1 =\n\t| { readonly status: \"locked\" }\n\t| {\n\t\t\treadonly status: \"drift\";\n\t\t\treadonly reason: string;\n\t\t\treadonly missingCapabilityVersions: readonly string[];\n\t\t\treadonly addedCapabilityVersions: readonly string[];\n\t  }\n\t| {\n\t\t\treadonly status: \"migration_required\";\n\t\t\treadonly reason: string;\n\t\t\treadonly fromProfileVersion: string;\n\t\t\treadonly toProfileVersion: string;\n\t  };\n\nexport interface ProfileLockReplaceResultV1 {\n\treadonly previousGeneration: number;\n\treadonly lock: ProfileLockV1;\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\n/** Creates an immutable Profile lock over a resolved identity (2.0b). */\nexport function createProfileLock(\n\tidentity: ProfileIdentityV1,\n\toptions: { readonly lockedBy?: string; readonly now?: () => number } = {},\n): ProfileLockV1 {\n\tassertNonEmptyString(identity.profileId, \"Profile lock.profileId\");\n\treturn Object.freeze({\n\t\tidentity,\n\t\tlockedAt: options.now?.() ?? 0,\n\t\tlockedBy: options.lockedBy ?? \"host\",\n\t\tgeneration: 1,\n\t});\n}\n\n/**\n * Verifies a current resolved identity against the lock during reopen/reload.\n * The lock itself is never mutated; drift and migration are explicit results.\n */\nexport function verifyProfileLock(lock: ProfileLockV1, current: ProfileIdentityV1): ProfileLockVerificationV1 {\n\tif (current.profileVersion !== lock.identity.profileVersion) {\n\t\treturn Object.freeze({\n\t\t\tstatus: \"migration_required\",\n\t\t\treason: `Profile version changed from ${lock.identity.profileVersion} to ${current.profileVersion}; explicit migration is required`,\n\t\t\tfromProfileVersion: lock.identity.profileVersion,\n\t\t\ttoProfileVersion: current.profileVersion,\n\t\t});\n\t}\n\tif (!profileIdentitiesCompatible(lock.identity, current)) {\n\t\tconst lockedIds = new Set(lock.identity.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst currentIds = new Set(current.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst missing = [...lockedIds].filter((id) => !currentIds.has(id));\n\t\tconst added = [...currentIds].filter((id) => !lockedIds.has(id));\n\t\treturn Object.freeze({\n\t\t\tstatus: \"drift\",\n\t\t\treason: \"Resolved manifest digest differs from the locked profile identity\",\n\t\t\tmissingCapabilityVersions: Object.freeze(missing),\n\t\t\taddedCapabilityVersions: Object.freeze(added),\n\t\t});\n\t}\n\treturn { status: \"locked\" };\n}\n\n/**\n * Replaces a lock with explicit authorization. This is the ONLY way to change\n * a lock — silent replacement does not exist.\n */\nexport function replaceProfileLock(\n\tlock: ProfileLockV1,\n\tidentity: ProfileIdentityV1,\n\tauthorization: { readonly authorizedBy: string },\n\toptions: { readonly now?: () => number } = {},\n): ProfileLockReplaceResultV1 {\n\tassertNonEmptyString(authorization.authorizedBy, \"authorizedBy\");\n\treturn {\n\t\tpreviousGeneration: lock.generation,\n\t\tlock: Object.freeze({\n\t\t\tidentity,\n\t\t\tlockedAt: options.now?.() ?? 0,\n\t\t\tlockedBy: authorization.authorizedBy,\n\t\t\tgeneration: lock.generation + 1,\n\t\t}),\n\t};\n}\n"]}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/profile/lock.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Profile lock — pre-creation lock and reopen/reload drift detection (2.0b).\n *\n * A Profile lock freezes the resolved `ProfileIdentityV1` at session creation.\n * Reopen/reload verifies the current resolved identity against the lock:\n * - same manifest digest + profile version → `locked`;\n * - same version but a different resolved set → `drift` with the differing\n *   capability/plugin facts;\n * - different profile version → `migration_required` (explicit, never an\n *   automatic replacement).\n * Replacing a lock requires explicit authorization and is observable — the\n * locked list can never be silently swapped.\n */\n\nimport { t } from \"../core/i18n/index.ts\";\nimport type { ProfileIdentityV1 } from \"./identity.ts\";\nimport { profileIdentitiesCompatible } from \"./identity.ts\";\n\nexport interface ProfileLockV1 {\n\treadonly identity: ProfileIdentityV1;\n\treadonly lockedAt: number;\n\treadonly lockedBy: string;\n\t/** Generation increments on each authorized replacement. */\n\treadonly generation: number;\n\treadonly supersededBy?: never;\n}\n\nexport type ProfileLockVerificationV1 =\n\t| { readonly status: \"locked\" }\n\t| {\n\t\t\treadonly status: \"drift\";\n\t\t\treadonly reason: string;\n\t\t\treadonly missingCapabilityVersions: readonly string[];\n\t\t\treadonly addedCapabilityVersions: readonly string[];\n\t  }\n\t| {\n\t\t\treadonly status: \"migration_required\";\n\t\t\treadonly reason: string;\n\t\t\treadonly fromProfileVersion: string;\n\t\t\treadonly toProfileVersion: string;\n\t  };\n\nexport interface ProfileLockReplaceResultV1 {\n\treadonly previousGeneration: number;\n\treadonly lock: ProfileLockV1;\n}\n\nfunction assertNonEmptyString(value: unknown, label: string): asserts value is string {\n\tif (typeof value !== \"string\" || value.trim().length === 0)\n\t\tthrow new Error(t(\"{label} must be a non-empty string\", { label }));\n}\n\n/** Creates an immutable Profile lock over a resolved identity (2.0b). */\nexport function createProfileLock(\n\tidentity: ProfileIdentityV1,\n\toptions: { readonly lockedBy?: string; readonly now?: () => number } = {},\n): ProfileLockV1 {\n\tassertNonEmptyString(identity.profileId, \"Profile lock.profileId\");\n\treturn Object.freeze({\n\t\tidentity,\n\t\tlockedAt: options.now?.() ?? 0,\n\t\tlockedBy: options.lockedBy ?? \"host\",\n\t\tgeneration: 1,\n\t});\n}\n\n/**\n * Verifies a current resolved identity against the lock during reopen/reload.\n * The lock itself is never mutated; drift and migration are explicit results.\n */\nexport function verifyProfileLock(lock: ProfileLockV1, current: ProfileIdentityV1): ProfileLockVerificationV1 {\n\tif (current.profileVersion !== lock.identity.profileVersion) {\n\t\treturn Object.freeze({\n\t\t\tstatus: \"migration_required\",\n\t\t\treason: `Profile version changed from ${lock.identity.profileVersion} to ${current.profileVersion}; explicit migration is required`,\n\t\t\tfromProfileVersion: lock.identity.profileVersion,\n\t\t\ttoProfileVersion: current.profileVersion,\n\t\t});\n\t}\n\tif (!profileIdentitiesCompatible(lock.identity, current)) {\n\t\tconst lockedIds = new Set(lock.identity.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst currentIds = new Set(current.capabilityVersions.map((ref) => `${ref.id}@${ref.version}`));\n\t\tconst missing = [...lockedIds].filter((id) => !currentIds.has(id));\n\t\tconst added = [...currentIds].filter((id) => !lockedIds.has(id));\n\t\treturn Object.freeze({\n\t\t\tstatus: \"drift\",\n\t\t\treason: \"Resolved manifest digest differs from the locked profile identity\",\n\t\t\tmissingCapabilityVersions: Object.freeze(missing),\n\t\t\taddedCapabilityVersions: Object.freeze(added),\n\t\t});\n\t}\n\treturn { status: \"locked\" };\n}\n\n/**\n * Replaces a lock with explicit authorization. This is the ONLY way to change\n * a lock — silent replacement does not exist.\n */\nexport function replaceProfileLock(\n\tlock: ProfileLockV1,\n\tidentity: ProfileIdentityV1,\n\tauthorization: { readonly authorizedBy: string },\n\toptions: { readonly now?: () => number } = {},\n): ProfileLockReplaceResultV1 {\n\tassertNonEmptyString(authorization.authorizedBy, \"authorizedBy\");\n\treturn {\n\t\tpreviousGeneration: lock.generation,\n\t\tlock: Object.freeze({\n\t\t\tidentity,\n\t\t\tlockedAt: options.now?.() ?? 0,\n\t\t\tlockedBy: authorization.authorizedBy,\n\t\t\tgeneration: lock.generation + 1,\n\t\t}),\n\t};\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"plan-plugin.d.ts","sourceRoot":"","sources":["../../src/profile/plan-plugin.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,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,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;KACtC,GAAG,MAAM,CAAC;IACX,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,6EAA6E;IAC7E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACnH,QAAQ,CACP,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,uBAAuB,EAAE,EAC5C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,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;AAiBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GAAG,YAAY,CAsJnG","sourcesContent":["/**\n * Plan plugin (2.3c) — Plan semantics bound to a branch/revision over the\n * 2.3a transition store.\n *\n * Status graph: null → draft → active → completed, and draft/active →\n * discarded. A plan is created with its step list and bound to a code branch;\n * while active, `linkRevision` records plan progress against concrete\n * revisions, and `complete` requires evidence plus the final revision. The\n * plugin holds NO shadow state: status, revision, steps, branch, and the\n * latest linked revision are all derived from the transition history, so\n * recovery is exactly a store replay.\n */\nimport type { JsonValue } from \"@agent-forge/ai\";\nimport type { TransitionEvidenceRefV1, TransitionStoreV1 } from \"./state-store.ts\";\n\nexport type PlanStatusV1 = \"draft\" | \"active\" | \"completed\" | \"discarded\";\n\nexport interface PlanStepV1 {\n\treadonly stepId: string;\n\treadonly title: string;\n}\n\nexport interface PlanV1 {\n\treadonly planId: string;\n\treadonly owner: string;\n\treadonly title: string;\n\treadonly branch: string;\n\treadonly steps: readonly PlanStepV1[];\n\treadonly status: PlanStatusV1;\n\t/** The latest revision explicitly linked while active (undefined before the first link). */\n\treadonly revision?: number;\n\treadonly evidence: readonly TransitionEvidenceRefV1[];\n\treadonly revisionNo: number;\n}\n\nexport interface PlanPluginV1 {\n\tcreatePlan(input: {\n\t\treadonly planId: string;\n\t\treadonly owner: string;\n\t\treadonly title: string;\n\t\treadonly branch: string;\n\t\treadonly steps: readonly PlanStepV1[];\n\t}): PlanV1;\n\tactivate(planId: string, owner: string, options?: { readonly operationId?: string }): PlanV1;\n\t/** Records plan progress against a concrete revision of the bound branch. */\n\tlinkRevision(planId: string, owner: string, revision: number, options?: { readonly operationId?: string }): PlanV1;\n\tcomplete(\n\t\tplanId: string,\n\t\towner: string,\n\t\tevidence: readonly TransitionEvidenceRefV1[],\n\t\toptions?: { readonly atRevision?: number; readonly operationId?: string },\n\t): PlanV1;\n\tdiscard(planId: string, owner: string): PlanV1;\n\tget(planId: string, owner: string): PlanV1 | undefined;\n}\n\ninterface PlanPayloadV1 {\n\treadonly title: string;\n\treadonly branch: string;\n\treadonly steps: readonly PlanStepV1[];\n\treadonly linkedRevision?: number;\n}\n\nfunction planPayloadOf(record: { readonly payload?: unknown }): Partial<PlanPayloadV1> | undefined {\n\tconst payload = record.payload;\n\tif (payload !== null && typeof payload === \"object\" && !Array.isArray(payload)) {\n\t\treturn payload as Partial<PlanPayloadV1>;\n\t}\n\treturn undefined;\n}\n\nexport function createPlanPlugin(options: { readonly transitions: TransitionStoreV1 }): PlanPluginV1 {\n\tconst transitions = options.transitions;\n\n\tconst planHistory = (planId: string, owner: string) =>\n\t\ttransitions.history(planId).filter((record) => record.domain === \"plan\" && record.owner === owner);\n\n\tconst current = (planId: string, owner: string): { status: PlanStatusV1; revisionNo: number } | undefined => {\n\t\tconst state = transitions.currentStatus(\"plan\", planId);\n\t\tif (state === undefined || planHistory(planId, owner).length === 0) return undefined;\n\t\treturn { status: state.status as PlanStatusV1, revisionNo: state.revision };\n\t};\n\n\tconst planGet = (planId: string, owner: string): PlanV1 | undefined => {\n\t\tconst state = current(planId, owner);\n\t\tif (!state) return undefined;\n\t\tconst history = planHistory(planId, owner);\n\t\t// v8 ignore next -- 因果校验保证每条 plan 历史都以 fromStatus=null 的创建记录开始\n\t\tconst createPayload = planPayloadOf(history.find((record) => record.fromStatus === null) ?? {});\n\t\tconst lastLinked = [...history]\n\t\t\t.reverse()\n\t\t\t.map((record) => planPayloadOf(record)?.linkedRevision)\n\t\t\t.find((revision): revision is number => typeof revision === \"number\");\n\t\tconst lastEvidence = [...history].reverse().find((record) => record.evidence.length > 0)?.evidence ?? [];\n\t\treturn {\n\t\t\tplanId,\n\t\t\towner,\n\t\t\ttitle: createPayload?.title ?? planId,\n\t\t\tbranch: createPayload?.branch ?? \"\",\n\t\t\tsteps: createPayload?.steps ?? [],\n\t\t\tstatus: state.status,\n\t\t\t...(lastLinked === undefined ? {} : { revision: lastLinked }),\n\t\t\tevidence: lastEvidence,\n\t\t\trevisionNo: state.revisionNo,\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 replayedPlan = (\n\t\tplanId: string,\n\t\towner: string,\n\t\ttoStatus: PlanStatusV1,\n\t\toperationId?: string,\n\t): PlanV1 | undefined => {\n\t\tif (!operationId) return undefined;\n\t\tconst applied = planHistory(planId, owner).some(\n\t\t\t(record) => record.toStatus === toStatus && record.operationId === operationId,\n\t\t);\n\t\treturn applied ? planGet(planId, owner) : undefined;\n\t};\n\n\tconst transitionPlan = (\n\t\tplanId: string,\n\t\towner: string,\n\t\tfromStatus: PlanStatusV1 | null,\n\t\ttoStatus: PlanStatusV1,\n\t\tplanOptions: {\n\t\t\treadonly evidence?: readonly TransitionEvidenceRefV1[];\n\t\t\treadonly payload?: PlanPayloadV1;\n\t\t\treadonly operationId?: string;\n\t\t},\n\t): PlanV1 => {\n\t\ttransitions.transition({\n\t\t\tdomain: \"plan\",\n\t\t\tentityId: planId,\n\t\t\towner,\n\t\t\tfromStatus,\n\t\t\ttoStatus,\n\t\t\toperationId: planOptions.operationId ?? `${toStatus}:${planId}`,\n\t\t\tevidence: planOptions.evidence,\n\t\t\tpayload: planOptions.payload as JsonValue | undefined,\n\t\t});\n\t\treturn planGet(planId, owner)!;\n\t};\n\n\treturn {\n\t\tcreatePlan({ planId, owner, title, branch, steps }) {\n\t\t\tif (title.trim().length === 0) throw new Error(\"Plan title must be a non-empty string\");\n\t\t\tif (branch.trim().length === 0) throw new Error(\"Plan branch must be a non-empty string\");\n\t\t\tif (steps.length === 0) throw new Error(\"Plan requires at least one step\");\n\t\t\tconst stepIds = new Set<string>();\n\t\t\tfor (const step of steps) {\n\t\t\t\tif (typeof step.stepId !== \"string\" || step.stepId.trim().length === 0) {\n\t\t\t\t\tthrow new Error(\"Plan stepId must be a non-empty string\");\n\t\t\t\t}\n\t\t\t\tif (typeof step.title !== \"string\" || step.title.trim().length === 0) {\n\t\t\t\t\tthrow new Error(\"Plan step title must be a non-empty string\");\n\t\t\t\t}\n\t\t\t\tif (stepIds.has(step.stepId)) throw new Error(`Duplicate plan stepId: ${step.stepId}`);\n\t\t\t\tstepIds.add(step.stepId);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, null, \"draft\", {\n\t\t\t\tpayload: { title, branch, steps: [...steps] },\n\t\t\t\toperationId: `create:${planId}`,\n\t\t\t});\n\t\t},\n\t\tactivate(planId, owner, activateOptions) {\n\t\t\tconst replayed = replayedPlan(planId, owner, \"active\", activateOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (plan?.status !== \"draft\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Plan ${planId} must be in draft status to activate (current: ${plan?.status ?? \"missing\"})`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, \"draft\", \"active\", { operationId: activateOptions?.operationId });\n\t\t},\n\t\tlinkRevision(planId, owner, revision, linkOptions) {\n\t\t\tconst replayed = replayedPlan(planId, owner, \"active\", linkOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (plan?.status !== \"active\") {\n\t\t\t\tthrow new Error(`Plan ${planId} must be active to link a revision (current: ${plan?.status ?? \"missing\"})`);\n\t\t\t}\n\t\t\tif (!Number.isSafeInteger(revision) || revision < 1) {\n\t\t\t\tthrow new Error(`Plan revision must be a positive safe integer, got ${revision}`);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, \"active\", \"active\", {\n\t\t\t\tpayload: { title: plan.title, branch: plan.branch, steps: plan.steps, linkedRevision: revision },\n\t\t\t\toperationId: linkOptions?.operationId ?? `link:${planId}:${revision}`,\n\t\t\t});\n\t\t},\n\t\tcomplete(planId, owner, evidence, completeOptions) {\n\t\t\tconst replayed = replayedPlan(planId, owner, \"completed\", completeOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (plan?.status !== \"active\") {\n\t\t\t\tthrow new Error(`Plan ${planId} must be active to complete (current: ${plan?.status ?? \"missing\"})`);\n\t\t\t}\n\t\t\tif (evidence.length === 0) throw new Error(\"Completing a plan requires at least one evidence reference\");\n\t\t\tconst target = completeOptions?.atRevision ?? plan.revision;\n\t\t\tif (typeof target !== \"number\") {\n\t\t\t\tthrow new Error(`Plan ${planId} requires atRevision or a linked revision to complete`);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, \"active\", \"completed\", {\n\t\t\t\tevidence,\n\t\t\t\tpayload: { title: plan.title, branch: plan.branch, steps: plan.steps, linkedRevision: target },\n\t\t\t\toperationId: completeOptions?.operationId,\n\t\t\t});\n\t\t},\n\t\tdiscard(planId, owner) {\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (!plan || plan.status === \"completed\" || plan.status === \"discarded\") {\n\t\t\t\tthrow new Error(`Plan ${planId} cannot be discarded from status ${plan?.status ?? \"missing\"}`);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, plan.status, \"discarded\", {});\n\t\t},\n\t\tget(planId, owner) {\n\t\t\treturn planGet(planId, owner);\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"plan-plugin.d.ts","sourceRoot":"","sources":["../../src/profile/plan-plugin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,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,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;KACtC,GAAG,MAAM,CAAC;IACX,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,6EAA6E;IAC7E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACnH,QAAQ,CACP,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,uBAAuB,EAAE,EAC5C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,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;AAiBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GAAG,YAAY,CAyKnG","sourcesContent":["/**\n * Plan plugin (2.3c) — Plan semantics bound to a branch/revision over the\n * 2.3a transition store.\n *\n * Status graph: null → draft → active → completed, and draft/active →\n * discarded. A plan is created with its step list and bound to a code branch;\n * while active, `linkRevision` records plan progress against concrete\n * revisions, and `complete` requires evidence plus the final revision. The\n * plugin holds NO shadow state: status, revision, steps, branch, and the\n * latest linked revision are all derived from the transition history, so\n * recovery is exactly a store replay.\n */\nimport type { JsonValue } from \"@agent-forge/ai\";\nimport { t } from \"../core/i18n/index.ts\";\nimport type { TransitionEvidenceRefV1, TransitionStoreV1 } from \"./state-store.ts\";\n\nexport type PlanStatusV1 = \"draft\" | \"active\" | \"completed\" | \"discarded\";\n\nexport interface PlanStepV1 {\n\treadonly stepId: string;\n\treadonly title: string;\n}\n\nexport interface PlanV1 {\n\treadonly planId: string;\n\treadonly owner: string;\n\treadonly title: string;\n\treadonly branch: string;\n\treadonly steps: readonly PlanStepV1[];\n\treadonly status: PlanStatusV1;\n\t/** The latest revision explicitly linked while active (undefined before the first link). */\n\treadonly revision?: number;\n\treadonly evidence: readonly TransitionEvidenceRefV1[];\n\treadonly revisionNo: number;\n}\n\nexport interface PlanPluginV1 {\n\tcreatePlan(input: {\n\t\treadonly planId: string;\n\t\treadonly owner: string;\n\t\treadonly title: string;\n\t\treadonly branch: string;\n\t\treadonly steps: readonly PlanStepV1[];\n\t}): PlanV1;\n\tactivate(planId: string, owner: string, options?: { readonly operationId?: string }): PlanV1;\n\t/** Records plan progress against a concrete revision of the bound branch. */\n\tlinkRevision(planId: string, owner: string, revision: number, options?: { readonly operationId?: string }): PlanV1;\n\tcomplete(\n\t\tplanId: string,\n\t\towner: string,\n\t\tevidence: readonly TransitionEvidenceRefV1[],\n\t\toptions?: { readonly atRevision?: number; readonly operationId?: string },\n\t): PlanV1;\n\tdiscard(planId: string, owner: string): PlanV1;\n\tget(planId: string, owner: string): PlanV1 | undefined;\n}\n\ninterface PlanPayloadV1 {\n\treadonly title: string;\n\treadonly branch: string;\n\treadonly steps: readonly PlanStepV1[];\n\treadonly linkedRevision?: number;\n}\n\nfunction planPayloadOf(record: { readonly payload?: unknown }): Partial<PlanPayloadV1> | undefined {\n\tconst payload = record.payload;\n\tif (payload !== null && typeof payload === \"object\" && !Array.isArray(payload)) {\n\t\treturn payload as Partial<PlanPayloadV1>;\n\t}\n\treturn undefined;\n}\n\nexport function createPlanPlugin(options: { readonly transitions: TransitionStoreV1 }): PlanPluginV1 {\n\tconst transitions = options.transitions;\n\n\tconst planHistory = (planId: string, owner: string) =>\n\t\ttransitions.history(planId).filter((record) => record.domain === \"plan\" && record.owner === owner);\n\n\tconst current = (planId: string, owner: string): { status: PlanStatusV1; revisionNo: number } | undefined => {\n\t\tconst state = transitions.currentStatus(\"plan\", planId);\n\t\tif (state === undefined || planHistory(planId, owner).length === 0) return undefined;\n\t\treturn { status: state.status as PlanStatusV1, revisionNo: state.revision };\n\t};\n\n\tconst planGet = (planId: string, owner: string): PlanV1 | undefined => {\n\t\tconst state = current(planId, owner);\n\t\tif (!state) return undefined;\n\t\tconst history = planHistory(planId, owner);\n\t\t// v8 ignore next -- 因果校验保证每条 plan 历史都以 fromStatus=null 的创建记录开始\n\t\tconst createPayload = planPayloadOf(history.find((record) => record.fromStatus === null) ?? {});\n\t\tconst lastLinked = [...history]\n\t\t\t.reverse()\n\t\t\t.map((record) => planPayloadOf(record)?.linkedRevision)\n\t\t\t.find((revision): revision is number => typeof revision === \"number\");\n\t\tconst lastEvidence = [...history].reverse().find((record) => record.evidence.length > 0)?.evidence ?? [];\n\t\treturn {\n\t\t\tplanId,\n\t\t\towner,\n\t\t\ttitle: createPayload?.title ?? planId,\n\t\t\tbranch: createPayload?.branch ?? \"\",\n\t\t\tsteps: createPayload?.steps ?? [],\n\t\t\tstatus: state.status,\n\t\t\t...(lastLinked === undefined ? {} : { revision: lastLinked }),\n\t\t\tevidence: lastEvidence,\n\t\t\trevisionNo: state.revisionNo,\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 replayedPlan = (\n\t\tplanId: string,\n\t\towner: string,\n\t\ttoStatus: PlanStatusV1,\n\t\toperationId?: string,\n\t): PlanV1 | undefined => {\n\t\tif (!operationId) return undefined;\n\t\tconst applied = planHistory(planId, owner).some(\n\t\t\t(record) => record.toStatus === toStatus && record.operationId === operationId,\n\t\t);\n\t\treturn applied ? planGet(planId, owner) : undefined;\n\t};\n\n\tconst transitionPlan = (\n\t\tplanId: string,\n\t\towner: string,\n\t\tfromStatus: PlanStatusV1 | null,\n\t\ttoStatus: PlanStatusV1,\n\t\tplanOptions: {\n\t\t\treadonly evidence?: readonly TransitionEvidenceRefV1[];\n\t\t\treadonly payload?: PlanPayloadV1;\n\t\t\treadonly operationId?: string;\n\t\t},\n\t): PlanV1 => {\n\t\ttransitions.transition({\n\t\t\tdomain: \"plan\",\n\t\t\tentityId: planId,\n\t\t\towner,\n\t\t\tfromStatus,\n\t\t\ttoStatus,\n\t\t\toperationId: planOptions.operationId ?? `${toStatus}:${planId}`,\n\t\t\tevidence: planOptions.evidence,\n\t\t\tpayload: planOptions.payload as JsonValue | undefined,\n\t\t});\n\t\treturn planGet(planId, owner)!;\n\t};\n\n\treturn {\n\t\tcreatePlan({ planId, owner, title, branch, steps }) {\n\t\t\tif (title.trim().length === 0) throw new Error(t(\"Plan title must be a non-empty string\"));\n\t\t\tif (branch.trim().length === 0) throw new Error(t(\"Plan branch must be a non-empty string\"));\n\t\t\tif (steps.length === 0) throw new Error(t(\"Plan requires at least one step\"));\n\t\t\tconst stepIds = new Set<string>();\n\t\t\tfor (const step of steps) {\n\t\t\t\tif (typeof step.stepId !== \"string\" || step.stepId.trim().length === 0) {\n\t\t\t\t\tthrow new Error(t(\"Plan stepId must be a non-empty string\"));\n\t\t\t\t}\n\t\t\t\tif (typeof step.title !== \"string\" || step.title.trim().length === 0) {\n\t\t\t\t\tthrow new Error(t(\"Plan step title must be a non-empty string\"));\n\t\t\t\t}\n\t\t\t\tif (stepIds.has(step.stepId))\n\t\t\t\t\tthrow new Error(t(\"Duplicate plan stepId: {stepId}\", { stepId: step.stepId }));\n\t\t\t\tstepIds.add(step.stepId);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, null, \"draft\", {\n\t\t\t\tpayload: { title, branch, steps: [...steps] },\n\t\t\t\toperationId: `create:${planId}`,\n\t\t\t});\n\t\t},\n\t\tactivate(planId, owner, activateOptions) {\n\t\t\tconst replayed = replayedPlan(planId, owner, \"active\", activateOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (plan?.status !== \"draft\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Plan {planId} must be in draft status to activate (current: {status})\", {\n\t\t\t\t\t\tplanId,\n\t\t\t\t\t\tstatus: plan?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, \"draft\", \"active\", { operationId: activateOptions?.operationId });\n\t\t},\n\t\tlinkRevision(planId, owner, revision, linkOptions) {\n\t\t\tconst replayed = replayedPlan(planId, owner, \"active\", linkOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (plan?.status !== \"active\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Plan {planId} must be active to link a revision (current: {status})\", {\n\t\t\t\t\t\tplanId,\n\t\t\t\t\t\tstatus: plan?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (!Number.isSafeInteger(revision) || revision < 1) {\n\t\t\t\tthrow new Error(t(\"Plan revision must be a positive safe integer, got {revision}\", { revision }));\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, \"active\", \"active\", {\n\t\t\t\tpayload: { title: plan.title, branch: plan.branch, steps: plan.steps, linkedRevision: revision },\n\t\t\t\toperationId: linkOptions?.operationId ?? `link:${planId}:${revision}`,\n\t\t\t});\n\t\t},\n\t\tcomplete(planId, owner, evidence, completeOptions) {\n\t\t\tconst replayed = replayedPlan(planId, owner, \"completed\", completeOptions?.operationId);\n\t\t\tif (replayed) return replayed;\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (plan?.status !== \"active\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Plan {planId} must be active to complete (current: {status})\", {\n\t\t\t\t\t\tplanId,\n\t\t\t\t\t\tstatus: plan?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (evidence.length === 0) throw new Error(t(\"Completing a plan requires at least one evidence reference\"));\n\t\t\tconst target = completeOptions?.atRevision ?? plan.revision;\n\t\t\tif (typeof target !== \"number\") {\n\t\t\t\tthrow new Error(t(\"Plan {planId} requires atRevision or a linked revision to complete\", { planId }));\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, \"active\", \"completed\", {\n\t\t\t\tevidence,\n\t\t\t\tpayload: { title: plan.title, branch: plan.branch, steps: plan.steps, linkedRevision: target },\n\t\t\t\toperationId: completeOptions?.operationId,\n\t\t\t});\n\t\t},\n\t\tdiscard(planId, owner) {\n\t\t\tconst plan = planGet(planId, owner);\n\t\t\tif (!plan || plan.status === \"completed\" || plan.status === \"discarded\") {\n\t\t\t\tthrow new Error(\n\t\t\t\t\tt(\"Plan {planId} cannot be discarded from status {status}\", {\n\t\t\t\t\t\tplanId,\n\t\t\t\t\t\tstatus: plan?.status ?? \"missing\",\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn transitionPlan(planId, owner, plan.status, \"discarded\", {});\n\t\t},\n\t\tget(planId, owner) {\n\t\t\treturn planGet(planId, owner);\n\t\t},\n\t};\n}\n"]}

package/dist/profile/plan-plugin.js

@@ -1,3 +1,4 @@
+import { t } from "../core/i18n/index.js";
 function planPayloadOf(record) {
     const payload = record.payload;
     if (payload !== null && typeof payload === "object" && !Array.isArray(payload)) {
@@ -61,21 +62,21 @@ export function createPlanPlugin(options) {
     return {
         createPlan({ planId, owner, title, branch, steps }) {
             if (title.trim().length === 0)
-                throw new Error("Plan title must be a non-empty string");
+                throw new Error(t("Plan title must be a non-empty string"));
             if (branch.trim().length === 0)
-                throw new Error("Plan branch must be a non-empty string");
+                throw new Error(t("Plan branch must be a non-empty string"));
             if (steps.length === 0)
-                throw new Error("Plan requires at least one step");
+                throw new Error(t("Plan requires at least one step"));
             const stepIds = new Set();
             for (const step of steps) {
                 if (typeof step.stepId !== "string" || step.stepId.trim().length === 0) {
-                    throw new Error("Plan stepId must be a non-empty string");
+                    throw new Error(t("Plan stepId must be a non-empty string"));
                 }
                 if (typeof step.title !== "string" || step.title.trim().length === 0) {
-                    throw new Error("Plan step title must be a non-empty string");
+                    throw new Error(t("Plan step title must be a non-empty string"));
                 }
                 if (stepIds.has(step.stepId))
-                    throw new Error(`Duplicate plan stepId: ${step.stepId}`);
+                    throw new Error(t("Duplicate plan stepId: {stepId}", { stepId: step.stepId }));
                 stepIds.add(step.stepId);
             }
             return transitionPlan(planId, owner, null, "draft", {
@@ -89,7 +90,10 @@ export function createPlanPlugin(options) {
                 return replayed;
             const plan = planGet(planId, owner);
             if (plan?.status !== "draft") {
-                throw new Error(`Plan ${planId} must be in draft status to activate (current: ${plan?.status ?? "missing"})`);
+                throw new Error(t("Plan {planId} must be in draft status to activate (current: {status})", {
+                    planId,
+                    status: plan?.status ?? "missing",
+                }));
             }
             return transitionPlan(planId, owner, "draft", "active", { operationId: activateOptions?.operationId });
         },
@@ -99,10 +103,13 @@ export function createPlanPlugin(options) {
                 return replayed;
             const plan = planGet(planId, owner);
             if (plan?.status !== "active") {
-                throw new Error(`Plan ${planId} must be active to link a revision (current: ${plan?.status ?? "missing"})`);
+                throw new Error(t("Plan {planId} must be active to link a revision (current: {status})", {
+                    planId,
+                    status: plan?.status ?? "missing",
+                }));
             }
             if (!Number.isSafeInteger(revision) || revision < 1) {
-                throw new Error(`Plan revision must be a positive safe integer, got ${revision}`);
+                throw new Error(t("Plan revision must be a positive safe integer, got {revision}", { revision }));
             }
             return transitionPlan(planId, owner, "active", "active", {
                 payload: { title: plan.title, branch: plan.branch, steps: plan.steps, linkedRevision: revision },
@@ -115,13 +122,16 @@ export function createPlanPlugin(options) {
                 return replayed;
             const plan = planGet(planId, owner);
             if (plan?.status !== "active") {
-                throw new Error(`Plan ${planId} must be active to complete (current: ${plan?.status ?? "missing"})`);
+                throw new Error(t("Plan {planId} must be active to complete (current: {status})", {
+                    planId,
+                    status: plan?.status ?? "missing",
+                }));
             }
             if (evidence.length === 0)
-                throw new Error("Completing a plan requires at least one evidence reference");
+                throw new Error(t("Completing a plan requires at least one evidence reference"));
             const target = completeOptions?.atRevision ?? plan.revision;
             if (typeof target !== "number") {
-                throw new Error(`Plan ${planId} requires atRevision or a linked revision to complete`);
+                throw new Error(t("Plan {planId} requires atRevision or a linked revision to complete", { planId }));
             }
             return transitionPlan(planId, owner, "active", "completed", {
                 evidence,
@@ -132,7 +142,10 @@ export function createPlanPlugin(options) {
         discard(planId, owner) {
             const plan = planGet(planId, owner);
             if (!plan || plan.status === "completed" || plan.status === "discarded") {
-                throw new Error(`Plan ${planId} cannot be discarded from status ${plan?.status ?? "missing"}`);
+                throw new Error(t("Plan {planId} cannot be discarded from status {status}", {
+                    planId,
+                    status: plan?.status ?? "missing",
+                }));
             }
             return transitionPlan(planId, owner, plan.status, "discarded", {});
         },