@ai-agent-forge/plugin-multi-agent 0.88.1

package/README.md

@@ -0,0 +1,3 @@
+# @agent-forge/plugin-multi-agent
+
+Agent Forge 的多 Agent 编排插件库（D-082 批 4）：角色目录/执行器/装配/编排器、root/child 门面适配器、基于 transition store 的 Goal/Plan/Todo 领域插件、依赖与 Skill/MCP 发现接线、默认策略清单与领域恢复，逻辑自宿主 `packages/agent-forge/src/profile/` 逐字迁出，i18n 经 `@agent-forge/host/i18n` 供给键注入。

package/dist/child-facade.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Child Agent lifecycle adapter (2.2b).
+ *
+ * Spawns child agents bound to their parent via the composition's
+ * `parentInstanceId`, with cancel/wait and an independently replayable result
+ * reference (`childInstanceId` + `revision`). Only the public
+ * `AgentCompositionAPI` is consumed.
+ */
+import type { AgentCompositionAPI } from "@agent-forge/plugin-sdk";
+export interface ChildAgentResultRefV1 {
+    readonly childInstanceId: string;
+    readonly revision: number;
+}
+export interface ChildAgentTurnV1<TResult = unknown> {
+    readonly childInstanceId: string;
+    /** Stable, replayable identity of the turn result. */
+    readonly resultRef: () => ChildAgentResultRefV1 | undefined;
+    wait(): Promise<{
+        readonly status: "succeeded" | "failed" | "cancelled" | "disposed";
+        readonly output?: TResult;
+        readonly revision: number;
+        readonly error?: Error;
+    }>;
+    cancel(reason?: string): Promise<void>;
+}
+export interface ChildAgentFacadeV1<TInput = unknown, TResult = unknown> {
+    readonly childDefinitionId: string;
+    spawnChild(input: TInput, options?: {
+        readonly signal?: AbortSignal;
+    }): ChildAgentTurnV1<TResult>;
+}
+export declare function createChildAgentFacade<TInput, TResult = unknown>(options: {
+    readonly composition: AgentCompositionAPI;
+    readonly parentInstanceId: string;
+    readonly childDefinitionId?: string;
+    readonly childVersion?: number;
+    readonly owner?: string;
+    /** The child turn implementation (deterministic in tests). */
+    readonly run: (input: TInput, context: {
+        readonly parentInstanceId: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<TResult> | TResult;
+}): ChildAgentFacadeV1<TInput, TResult>;
+//# sourceMappingURL=child-facade.d.ts.map

package/dist/child-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-facade.d.ts","sourceRoot":"","sources":["../src/child-facade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO;IAClD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,qBAAqB,GAAG,SAAS,CAAC;IAC5D,IAAI,IAAI,OAAO,CAAC;QACf,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;QACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACtE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAClG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE;IAC1E,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KACzE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChC,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAwDtC","sourcesContent":["/**\n * Child Agent lifecycle adapter (2.2b).\n *\n * Spawns child agents bound to their parent via the composition's\n * `parentInstanceId`, with cancel/wait and an independently replayable result\n * reference (`childInstanceId` + `revision`). Only the public\n * `AgentCompositionAPI` is consumed.\n */\nimport type { AgentCompositionAPI } from \"@agent-forge/plugin-sdk\";\n\nexport interface ChildAgentResultRefV1 {\n\treadonly childInstanceId: string;\n\treadonly revision: number;\n}\n\nexport interface ChildAgentTurnV1<TResult = unknown> {\n\treadonly childInstanceId: string;\n\t/** Stable, replayable identity of the turn result. */\n\treadonly resultRef: () => ChildAgentResultRefV1 | undefined;\n\twait(): Promise<{\n\t\treadonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"disposed\";\n\t\treadonly output?: TResult;\n\t\treadonly revision: number;\n\t\treadonly error?: Error;\n\t}>;\n\tcancel(reason?: string): Promise<void>;\n}\n\nexport interface ChildAgentFacadeV1<TInput = unknown, TResult = unknown> {\n\treadonly childDefinitionId: string;\n\tspawnChild(input: TInput, options?: { readonly signal?: AbortSignal }): ChildAgentTurnV1<TResult>;\n}\n\nexport function createChildAgentFacade<TInput, TResult = unknown>(options: {\n\treadonly composition: AgentCompositionAPI;\n\treadonly parentInstanceId: string;\n\treadonly childDefinitionId?: string;\n\treadonly childVersion?: number;\n\treadonly owner?: string;\n\t/** The child turn implementation (deterministic in tests). */\n\treadonly run: (\n\t\tinput: TInput,\n\t\tcontext: { readonly parentInstanceId: string; readonly signal?: AbortSignal },\n\t) => Promise<TResult> | TResult;\n}): ChildAgentFacadeV1<TInput, TResult> {\n\tconst childDefinitionId = options.childDefinitionId ?? \"child-agent-controller\";\n\tconst owner = options.owner ?? \"parent\";\n\tconst definition = options.composition.define({\n\t\tid: childDefinitionId,\n\t\tversion: options.childVersion ?? 1,\n\t\trole: \"child-agent-controller\",\n\t\trun: (input: TInput, context: { readonly signal?: AbortSignal }) =>\n\t\t\toptions.run(input, { parentInstanceId: options.parentInstanceId, signal: context?.signal }),\n\t});\n\n\treturn {\n\t\tchildDefinitionId,\n\t\tspawnChild(input, spawnOptions): ChildAgentTurnV1<TResult> {\n\t\t\tconst instance = options.composition.create<TInput, TResult>(definition, {\n\t\t\t\tparentInstanceId: options.parentInstanceId,\n\t\t\t});\n\t\t\tconst childInstanceId = instance.id;\n\t\t\tlet settledRevision: number | undefined;\n\t\t\tconst leasePromise = instance.acquireControllerLease(owner);\n\t\t\tconst runPromise = leasePromise.then(async (lease) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst operation = instance.run(input, { lease, signal: spawnOptions?.signal });\n\t\t\t\t\tawait operation.result;\n\t\t\t\t} catch {\n\t\t\t\t\t// run() can reject when the instance was cancelled or disposed\n\t\t\t\t\t// mid-flight; instance.wait() below yields the terminal status.\n\t\t\t\t}\n\t\t\t\tconst instanceResult = await instance.wait();\n\t\t\t\tsettledRevision = instanceResult.revision;\n\t\t\t\tif (lease.isActive()) await lease.release();\n\t\t\t\treturn {\n\t\t\t\t\tstatus: instanceResult.status,\n\t\t\t\t\t...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),\n\t\t\t\t\t...(instanceResult.error !== undefined\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t\t\tinstanceResult.error instanceof Error\n\t\t\t\t\t\t\t\t\t\t? instanceResult.error\n\t\t\t\t\t\t\t\t\t\t: new Error(String(instanceResult.error)),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {}),\n\t\t\t\t\trevision: instanceResult.revision,\n\t\t\t\t};\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tchildInstanceId,\n\t\t\t\tresultRef: () =>\n\t\t\t\t\tsettledRevision === undefined\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: Object.freeze({ childInstanceId, revision: settledRevision }),\n\t\t\t\twait: () => runPromise,\n\t\t\t\tcancel: (reason?: string) => instance.cancel(reason),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/child-facade.js

@@ -0,0 +1,56 @@
+export function createChildAgentFacade(options) {
+    const childDefinitionId = options.childDefinitionId ?? "child-agent-controller";
+    const owner = options.owner ?? "parent";
+    const definition = options.composition.define({
+        id: childDefinitionId,
+        version: options.childVersion ?? 1,
+        role: "child-agent-controller",
+        run: (input, context) => options.run(input, { parentInstanceId: options.parentInstanceId, signal: context?.signal }),
+    });
+    return {
+        childDefinitionId,
+        spawnChild(input, spawnOptions) {
+            const instance = options.composition.create(definition, {
+                parentInstanceId: options.parentInstanceId,
+            });
+            const childInstanceId = instance.id;
+            let settledRevision;
+            const leasePromise = instance.acquireControllerLease(owner);
+            const runPromise = leasePromise.then(async (lease) => {
+                try {
+                    const operation = instance.run(input, { lease, signal: spawnOptions?.signal });
+                    await operation.result;
+                }
+                catch {
+                    // run() can reject when the instance was cancelled or disposed
+                    // mid-flight; instance.wait() below yields the terminal status.
+                }
+                const instanceResult = await instance.wait();
+                settledRevision = instanceResult.revision;
+                if (lease.isActive())
+                    await lease.release();
+                return {
+                    status: instanceResult.status,
+                    ...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),
+                    ...(instanceResult.error !== undefined
+                        ? {
+                            error: instanceResult.error instanceof Error
+                                ? instanceResult.error
+                                : new Error(String(instanceResult.error)),
+                        }
+                        : {}),
+                    revision: instanceResult.revision,
+                };
+            });
+            return {
+                childInstanceId,
+                resultRef: () => settledRevision === undefined
+                    ? undefined
+                    : Object.freeze({ childInstanceId, revision: settledRevision }),
+                wait: () => runPromise,
+                cancel: (reason) => instance.cancel(reason),
+            };
+        },
+    };
+}
+//# sourceMappingURL=child-facade.js.map

package/dist/child-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-facade.js","sourceRoot":"","sources":["../src/child-facade.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,sBAAsB,CAA4B,OAWjE,EAAuC;IACvC,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,wBAAwB,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;QAC7C,EAAE,EAAE,iBAAiB;QACrB,OAAO,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;QAClC,IAAI,EAAE,wBAAwB;QAC9B,GAAG,EAAE,CAAC,KAAa,EAAE,OAA0C,EAAE,EAAE,CAClE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEH,OAAO;QACN,iBAAiB;QACjB,UAAU,CAAC,KAAK,EAAE,YAAY,EAA6B;YAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAkB,UAAU,EAAE;gBACxE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC1C,CAAC,CAAC;YACH,MAAM,eAAe,GAAG,QAAQ,CAAC,EAAE,CAAC;YACpC,IAAI,eAAmC,CAAC;YACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;gBACrD,IAAI,CAAC;oBACJ,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC/E,MAAM,SAAS,CAAC,MAAM,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACR,+DAA+D;oBAC/D,gEAAgE;gBACjE,CAAC;gBACD,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC7C,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC;gBAC1C,IAAI,KAAK,CAAC,QAAQ,EAAE;oBAAE,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC5C,OAAO;oBACN,MAAM,EAAE,cAAc,CAAC,MAAM;oBAC7B,GAAG,CAAC,cAAc,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjF,GAAG,CAAC,cAAc,CAAC,KAAK,KAAK,SAAS;wBACrC,CAAC,CAAC;4BACA,KAAK,EACJ,cAAc,CAAC,KAAK,YAAY,KAAK;gCACpC,CAAC,CAAC,cAAc,CAAC,KAAK;gCACtB,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;yBAC3C;wBACF,CAAC,CAAC,EAAE,CAAC;oBACN,QAAQ,EAAE,cAAc,CAAC,QAAQ;iBACjC,CAAC;YAAA,CACF,CAAC,CAAC;YACH,OAAO;gBACN,eAAe;gBACf,SAAS,EAAE,GAAG,EAAE,CACf,eAAe,KAAK,SAAS;oBAC5B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;gBACjE,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU;gBACtB,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;aACpD,CAAC;QAAA,CACF;KACD,CAAC;AAAA,CACF","sourcesContent":["/**\n * Child Agent lifecycle adapter (2.2b).\n *\n * Spawns child agents bound to their parent via the composition's\n * `parentInstanceId`, with cancel/wait and an independently replayable result\n * reference (`childInstanceId` + `revision`). Only the public\n * `AgentCompositionAPI` is consumed.\n */\nimport type { AgentCompositionAPI } from \"@agent-forge/plugin-sdk\";\n\nexport interface ChildAgentResultRefV1 {\n\treadonly childInstanceId: string;\n\treadonly revision: number;\n}\n\nexport interface ChildAgentTurnV1<TResult = unknown> {\n\treadonly childInstanceId: string;\n\t/** Stable, replayable identity of the turn result. */\n\treadonly resultRef: () => ChildAgentResultRefV1 | undefined;\n\twait(): Promise<{\n\t\treadonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"disposed\";\n\t\treadonly output?: TResult;\n\t\treadonly revision: number;\n\t\treadonly error?: Error;\n\t}>;\n\tcancel(reason?: string): Promise<void>;\n}\n\nexport interface ChildAgentFacadeV1<TInput = unknown, TResult = unknown> {\n\treadonly childDefinitionId: string;\n\tspawnChild(input: TInput, options?: { readonly signal?: AbortSignal }): ChildAgentTurnV1<TResult>;\n}\n\nexport function createChildAgentFacade<TInput, TResult = unknown>(options: {\n\treadonly composition: AgentCompositionAPI;\n\treadonly parentInstanceId: string;\n\treadonly childDefinitionId?: string;\n\treadonly childVersion?: number;\n\treadonly owner?: string;\n\t/** The child turn implementation (deterministic in tests). */\n\treadonly run: (\n\t\tinput: TInput,\n\t\tcontext: { readonly parentInstanceId: string; readonly signal?: AbortSignal },\n\t) => Promise<TResult> | TResult;\n}): ChildAgentFacadeV1<TInput, TResult> {\n\tconst childDefinitionId = options.childDefinitionId ?? \"child-agent-controller\";\n\tconst owner = options.owner ?? \"parent\";\n\tconst definition = options.composition.define({\n\t\tid: childDefinitionId,\n\t\tversion: options.childVersion ?? 1,\n\t\trole: \"child-agent-controller\",\n\t\trun: (input: TInput, context: { readonly signal?: AbortSignal }) =>\n\t\t\toptions.run(input, { parentInstanceId: options.parentInstanceId, signal: context?.signal }),\n\t});\n\n\treturn {\n\t\tchildDefinitionId,\n\t\tspawnChild(input, spawnOptions): ChildAgentTurnV1<TResult> {\n\t\t\tconst instance = options.composition.create<TInput, TResult>(definition, {\n\t\t\t\tparentInstanceId: options.parentInstanceId,\n\t\t\t});\n\t\t\tconst childInstanceId = instance.id;\n\t\t\tlet settledRevision: number | undefined;\n\t\t\tconst leasePromise = instance.acquireControllerLease(owner);\n\t\t\tconst runPromise = leasePromise.then(async (lease) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst operation = instance.run(input, { lease, signal: spawnOptions?.signal });\n\t\t\t\t\tawait operation.result;\n\t\t\t\t} catch {\n\t\t\t\t\t// run() can reject when the instance was cancelled or disposed\n\t\t\t\t\t// mid-flight; instance.wait() below yields the terminal status.\n\t\t\t\t}\n\t\t\t\tconst instanceResult = await instance.wait();\n\t\t\t\tsettledRevision = instanceResult.revision;\n\t\t\t\tif (lease.isActive()) await lease.release();\n\t\t\t\treturn {\n\t\t\t\t\tstatus: instanceResult.status,\n\t\t\t\t\t...(instanceResult.output !== undefined ? { output: instanceResult.output } : {}),\n\t\t\t\t\t...(instanceResult.error !== undefined\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\terror:\n\t\t\t\t\t\t\t\t\tinstanceResult.error instanceof Error\n\t\t\t\t\t\t\t\t\t\t? instanceResult.error\n\t\t\t\t\t\t\t\t\t\t: new Error(String(instanceResult.error)),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {}),\n\t\t\t\t\trevision: instanceResult.revision,\n\t\t\t\t};\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tchildInstanceId,\n\t\t\t\tresultRef: () =>\n\t\t\t\t\tsettledRevision === undefined\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: Object.freeze({ childInstanceId, revision: settledRevision }),\n\t\t\t\twait: () => runPromise,\n\t\t\t\tcancel: (reason?: string) => instance.cancel(reason),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/dependency-wiring.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Profile dependency wiring (2.5a) — resolves every resolved plugin's
+ * capability references (Skill/tool/MCP-capability IDs) against the host's
+ * available capability registry BEFORE a session is created.
+ *
+ * Resolution is exact-version: a reference is satisfied only when the
+ * registry offers the same capability ID at exactly the requested version.
+ * Missing or version-mismatched capabilities produce a structured `missing`
+ * result so session creation can fail up front — never a half-wired session.
+ * Plugins listed in `disabledPluginIds` are skipped as a whole (their
+ * references are reported as `skipped_disabled`), which lets a profile drop
+ * a plugin without touching the kernel or the other plugins. The same input
+ * always resolves identically.
+ */
+import type { ResolvedPluginManifestV1 } from "./identity.ts";
+export interface AvailableCapabilityV1 {
+    readonly id: string;
+    readonly version: number;
+}
+export interface WiredCapabilityV1 {
+    readonly id: string;
+    readonly version: number;
+}
+export interface PluginWiringResultV1 {
+    readonly pluginId: string;
+    readonly pluginVersion: string;
+    readonly status: "wired" | "skipped_disabled";
+    readonly wired: readonly WiredCapabilityV1[];
+}
+export interface MissingDependencyV1 {
+    readonly pluginId: string;
+    readonly capabilityId: string;
+    readonly requestedVersion: number;
+    /** Undefined when the capability is entirely absent from the registry. */
+    readonly availableVersion?: number;
+    readonly reason: "missing" | "version_mismatch";
+}
+export interface ProfileDependencyWiringV1 {
+    readonly status: "wired" | "missing";
+    readonly plugins: readonly PluginWiringResultV1[];
+    readonly missing: readonly MissingDependencyV1[];
+}
+export declare function wireProfileDependencies(input: {
+    readonly resolvedPlugins: readonly ResolvedPluginManifestV1[];
+    readonly availableCapabilities: readonly AvailableCapabilityV1[];
+    readonly disabledPluginIds?: readonly string[];
+}): ProfileDependencyWiringV1;
+//# sourceMappingURL=dependency-wiring.d.ts.map

package/dist/dependency-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-wiring.d.ts","sourceRoot":"","sources":["../src/dependency-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,eAAe,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9D,QAAQ,CAAC,qBAAqB,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C,GAAG,yBAAyB,CAuD5B","sourcesContent":["/**\n * Profile dependency wiring (2.5a) — resolves every resolved plugin's\n * capability references (Skill/tool/MCP-capability IDs) against the host's\n * available capability registry BEFORE a session is created.\n *\n * Resolution is exact-version: a reference is satisfied only when the\n * registry offers the same capability ID at exactly the requested version.\n * Missing or version-mismatched capabilities produce a structured `missing`\n * result so session creation can fail up front — never a half-wired session.\n * Plugins listed in `disabledPluginIds` are skipped as a whole (their\n * references are reported as `skipped_disabled`), which lets a profile drop\n * a plugin without touching the kernel or the other plugins. The same input\n * always resolves identically.\n */\nimport type { ResolvedPluginManifestV1 } from \"./identity.ts\";\n\nexport interface AvailableCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface WiredCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface PluginWiringResultV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly status: \"wired\" | \"skipped_disabled\";\n\treadonly wired: readonly WiredCapabilityV1[];\n}\n\nexport interface MissingDependencyV1 {\n\treadonly pluginId: string;\n\treadonly capabilityId: string;\n\treadonly requestedVersion: number;\n\t/** Undefined when the capability is entirely absent from the registry. */\n\treadonly availableVersion?: number;\n\treadonly reason: \"missing\" | \"version_mismatch\";\n}\n\nexport interface ProfileDependencyWiringV1 {\n\treadonly status: \"wired\" | \"missing\";\n\treadonly plugins: readonly PluginWiringResultV1[];\n\treadonly missing: readonly MissingDependencyV1[];\n}\n\nexport function wireProfileDependencies(input: {\n\treadonly resolvedPlugins: readonly ResolvedPluginManifestV1[];\n\treadonly availableCapabilities: readonly AvailableCapabilityV1[];\n\treadonly disabledPluginIds?: readonly string[];\n}): ProfileDependencyWiringV1 {\n\tconst registry = new Map<string, number>();\n\tfor (const capability of input.availableCapabilities) {\n\t\tregistry.set(capability.id, capability.version);\n\t}\n\tconst disabled = new Set(input.disabledPluginIds ?? []);\n\n\tconst plugins: PluginWiringResultV1[] = [];\n\tconst missing: MissingDependencyV1[] = [];\n\n\tfor (const plugin of input.resolvedPlugins) {\n\t\tif (disabled.has(plugin.pluginId)) {\n\t\t\tplugins.push({\n\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\t\tstatus: \"skipped_disabled\",\n\t\t\t\twired: [],\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst wired: WiredCapabilityV1[] = [];\n\t\tfor (const reference of plugin.capabilityRefs) {\n\t\t\tconst availableVersion = registry.get(reference.id);\n\t\t\tif (availableVersion === undefined) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\treason: \"missing\",\n\t\t\t\t});\n\t\t\t} else if (availableVersion !== reference.version) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\tavailableVersion,\n\t\t\t\t\treason: \"version_mismatch\",\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\twired.push({ id: reference.id, version: reference.version });\n\t\t\t}\n\t\t}\n\t\tplugins.push({\n\t\t\tpluginId: plugin.pluginId,\n\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\tstatus: \"wired\",\n\t\t\twired,\n\t\t});\n\t}\n\n\treturn {\n\t\tstatus: missing.length > 0 ? \"missing\" : \"wired\",\n\t\tplugins,\n\t\tmissing,\n\t};\n}\n"]}

package/dist/dependency-wiring.js

@@ -0,0 +1,56 @@
+export function wireProfileDependencies(input) {
+    const registry = new Map();
+    for (const capability of input.availableCapabilities) {
+        registry.set(capability.id, capability.version);
+    }
+    const disabled = new Set(input.disabledPluginIds ?? []);
+    const plugins = [];
+    const missing = [];
+    for (const plugin of input.resolvedPlugins) {
+        if (disabled.has(plugin.pluginId)) {
+            plugins.push({
+                pluginId: plugin.pluginId,
+                pluginVersion: plugin.pluginVersion,
+                status: "skipped_disabled",
+                wired: [],
+            });
+            continue;
+        }
+        const wired = [];
+        for (const reference of plugin.capabilityRefs) {
+            const availableVersion = registry.get(reference.id);
+            if (availableVersion === undefined) {
+                missing.push({
+                    pluginId: plugin.pluginId,
+                    capabilityId: reference.id,
+                    requestedVersion: reference.version,
+                    reason: "missing",
+                });
+            }
+            else if (availableVersion !== reference.version) {
+                missing.push({
+                    pluginId: plugin.pluginId,
+                    capabilityId: reference.id,
+                    requestedVersion: reference.version,
+                    availableVersion,
+                    reason: "version_mismatch",
+                });
+            }
+            else {
+                wired.push({ id: reference.id, version: reference.version });
+            }
+        }
+        plugins.push({
+            pluginId: plugin.pluginId,
+            pluginVersion: plugin.pluginVersion,
+            status: "wired",
+            wired,
+        });
+    }
+    return {
+        status: missing.length > 0 ? "missing" : "wired",
+        plugins,
+        missing,
+    };
+}
+//# sourceMappingURL=dependency-wiring.js.map

package/dist/dependency-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-wiring.js","sourceRoot":"","sources":["../src/dependency-wiring.ts"],"names":[],"mappings":"AAgDA,MAAM,UAAU,uBAAuB,CAAC,KAIvC,EAA6B;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC;QACtD,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,MAAM,EAAE,kBAAkB;gBAC1B,KAAK,EAAE,EAAE;aACT,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QACD,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY,EAAE,SAAS,CAAC,EAAE;oBAC1B,gBAAgB,EAAE,SAAS,CAAC,OAAO;oBACnC,MAAM,EAAE,SAAS;iBACjB,CAAC,CAAC;YACJ,CAAC;iBAAM,IAAI,gBAAgB,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY,EAAE,SAAS,CAAC,EAAE;oBAC1B,gBAAgB,EAAE,SAAS,CAAC,OAAO;oBACnC,gBAAgB;oBAChB,MAAM,EAAE,kBAAkB;iBAC1B,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,OAAO;YACf,KAAK;SACL,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;QAChD,OAAO;QACP,OAAO;KACP,CAAC;AAAA,CACF","sourcesContent":["/**\n * Profile dependency wiring (2.5a) — resolves every resolved plugin's\n * capability references (Skill/tool/MCP-capability IDs) against the host's\n * available capability registry BEFORE a session is created.\n *\n * Resolution is exact-version: a reference is satisfied only when the\n * registry offers the same capability ID at exactly the requested version.\n * Missing or version-mismatched capabilities produce a structured `missing`\n * result so session creation can fail up front — never a half-wired session.\n * Plugins listed in `disabledPluginIds` are skipped as a whole (their\n * references are reported as `skipped_disabled`), which lets a profile drop\n * a plugin without touching the kernel or the other plugins. The same input\n * always resolves identically.\n */\nimport type { ResolvedPluginManifestV1 } from \"./identity.ts\";\n\nexport interface AvailableCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface WiredCapabilityV1 {\n\treadonly id: string;\n\treadonly version: number;\n}\n\nexport interface PluginWiringResultV1 {\n\treadonly pluginId: string;\n\treadonly pluginVersion: string;\n\treadonly status: \"wired\" | \"skipped_disabled\";\n\treadonly wired: readonly WiredCapabilityV1[];\n}\n\nexport interface MissingDependencyV1 {\n\treadonly pluginId: string;\n\treadonly capabilityId: string;\n\treadonly requestedVersion: number;\n\t/** Undefined when the capability is entirely absent from the registry. */\n\treadonly availableVersion?: number;\n\treadonly reason: \"missing\" | \"version_mismatch\";\n}\n\nexport interface ProfileDependencyWiringV1 {\n\treadonly status: \"wired\" | \"missing\";\n\treadonly plugins: readonly PluginWiringResultV1[];\n\treadonly missing: readonly MissingDependencyV1[];\n}\n\nexport function wireProfileDependencies(input: {\n\treadonly resolvedPlugins: readonly ResolvedPluginManifestV1[];\n\treadonly availableCapabilities: readonly AvailableCapabilityV1[];\n\treadonly disabledPluginIds?: readonly string[];\n}): ProfileDependencyWiringV1 {\n\tconst registry = new Map<string, number>();\n\tfor (const capability of input.availableCapabilities) {\n\t\tregistry.set(capability.id, capability.version);\n\t}\n\tconst disabled = new Set(input.disabledPluginIds ?? []);\n\n\tconst plugins: PluginWiringResultV1[] = [];\n\tconst missing: MissingDependencyV1[] = [];\n\n\tfor (const plugin of input.resolvedPlugins) {\n\t\tif (disabled.has(plugin.pluginId)) {\n\t\t\tplugins.push({\n\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\t\tstatus: \"skipped_disabled\",\n\t\t\t\twired: [],\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst wired: WiredCapabilityV1[] = [];\n\t\tfor (const reference of plugin.capabilityRefs) {\n\t\t\tconst availableVersion = registry.get(reference.id);\n\t\t\tif (availableVersion === undefined) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\treason: \"missing\",\n\t\t\t\t});\n\t\t\t} else if (availableVersion !== reference.version) {\n\t\t\t\tmissing.push({\n\t\t\t\t\tpluginId: plugin.pluginId,\n\t\t\t\t\tcapabilityId: reference.id,\n\t\t\t\t\trequestedVersion: reference.version,\n\t\t\t\t\tavailableVersion,\n\t\t\t\t\treason: \"version_mismatch\",\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\twired.push({ id: reference.id, version: reference.version });\n\t\t\t}\n\t\t}\n\t\tplugins.push({\n\t\t\tpluginId: plugin.pluginId,\n\t\t\tpluginVersion: plugin.pluginVersion,\n\t\t\tstatus: \"wired\",\n\t\t\twired,\n\t\t});\n\t}\n\n\treturn {\n\t\tstatus: missing.length > 0 ? \"missing\" : \"wired\",\n\t\tplugins,\n\t\tmissing,\n\t};\n}\n"]}

package/dist/domain-recovery.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Domain recovery for branches and restarts (5.2a/5.2b).
+ *
+ * Branch recovery (5.2a): plans are bound to a branch via the 2.3c plugin;
+ * recovering a session on branch B must touch ONLY plans whose branch is B
+ * — other-branch plans stay ledgered but are reported as skipped and never
+ * written to. Restart recovery (5.2b): replaying a domain's history into a
+ * fresh store restores revision, evidence, and terminal state exactly; the
+ * recovery report records the before/after facts so a restart is auditable.
+ * Multi-Agent scheduling is out of scope.
+ */
+import type { GoalPluginV1, GoalV1 } from "./goal-plugin.ts";
+import type { PlanPluginV1, PlanV1 } from "./plan-plugin.ts";
+import type { TodoPluginV1, TodoV1 } from "./todo-plugin.ts";
+export interface PlanBranchRecoveryEntryV1 {
+    readonly planId: string;
+    readonly outcome: "recovered" | "terminal_kept" | "skipped_other_branch";
+    readonly branch: string;
+    readonly statusBefore: string;
+}
+export interface PlanBranchRecoveryReportV1 {
+    readonly currentBranch: string;
+    readonly entries: readonly PlanBranchRecoveryEntryV1[];
+}
+export interface DomainRestartRecordV1 {
+    readonly domain: "goal" | "plan" | "todo";
+    readonly entityId: string;
+    readonly statusAfter: string;
+    readonly revisionAfter: number;
+    readonly evidenceCount: number;
+    readonly terminal: boolean;
+}
+export interface DomainRestartReportV1 {
+    readonly records: readonly DomainRestartRecordV1[];
+    /** True when every restored entity matches the state it had before the restart. */
+    readonly identical: boolean;
+}
+/**
+ * 5.2a — recovers plans for the current branch. Plans on other branches are
+ * reported and left untouched (no scans, no writes). Terminal plans on the
+ * current branch are kept as-is; draft/active plans are recovered through
+ * the plugin's own ledger-derived state (no shadow writes).
+ */
+export declare function recoverPlansForBranch(plans: readonly PlanV1[], currentBranch: string): PlanBranchRecoveryReportV1;
+/**
+ * 5.2b — restores goal/plan/todo state after a restart by replaying each
+ * entity's history into a fresh store (the caller performs the replay via
+ * the plugin attached to the rebuilt store) and comparing against the
+ * pre-restart snapshots.
+ */
+export declare function buildRestartReport(snapshots: {
+    readonly goal?: readonly GoalV1[];
+    readonly plan?: readonly PlanV1[];
+    readonly todo?: readonly TodoV1[];
+}, restored: {
+    readonly goals: GoalPluginV1;
+    readonly plans: PlanPluginV1;
+    readonly todos: TodoPluginV1;
+}, owner: string): DomainRestartReportV1;
+//# sourceMappingURL=domain-recovery.d.ts.map

package/dist/domain-recovery.d.ts.map

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

package/dist/domain-recovery.js

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

package/dist/domain-recovery.js.map

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

package/dist/first-roles.d.ts

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

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

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

package/dist/first-roles.js

@@ -0,0 +1,83 @@
+/**
+ * First-batch role vertical slices (2.2c): 架构/实现/测试.
+ *
+ * Each role is a `RoleMetadataV1` registered in the role catalog plus a
+ * deterministic runner that only consumes the public facade — no private
+ * session access. These are the first vertical slices proving that a role can
+ * be declared, discovered, and executed end to end.
+ */
+import { t } from "@agent-forge/host/i18n";
+import { validateRoleMetadataV1 } from "./role-catalog.js";
+const ARCHITECTURE_ROLE = {
+    roleId: "architecture-analyst",
+    title: "Architecture Analyst",
+    input: { schemaId: "role/architecture-input@1", schemaVersion: 1 },
+    output: { schemaId: "role/architecture-output@1", schemaVersion: 1 },
+    capabilityDependencies: [{ capabilityId: "tool.read", capabilityVersion: 1, required: true }],
+    writableScopes: ["session"],
+    concurrency: "parallel",
+    completionCriteria: "module structure findings recorded",
+};
+const IMPLEMENTER_ROLE = {
+    roleId: "implementer",
+    title: "Implementer",
+    input: { schemaId: "role/implement-input@1", schemaVersion: 1 },
+    output: { schemaId: "role/implement-output@1", schemaVersion: 1 },
+    capabilityDependencies: [
+        { capabilityId: "tool.edit", capabilityVersion: 1, required: true },
+        { capabilityId: "tool.write", capabilityVersion: 1, required: false },
+    ],
+    writableScopes: ["session", "cycle"],
+    concurrency: "single",
+    completionCriteria: "patch produced for the requested spec",
+};
+const TEST_DESIGNER_ROLE = {
+    roleId: "test-designer",
+    title: "Test Designer",
+    input: { schemaId: "role/test-input@1", schemaVersion: 1 },
+    output: { schemaId: "role/test-output@1", schemaVersion: 1 },
+    capabilityDependencies: [{ capabilityId: "tool.read", capabilityVersion: 1, required: true }],
+    writableScopes: ["session"],
+    concurrency: "parallel",
+    completionCriteria: "test cases derived from the spec",
+};
+export const FIRST_BATCH_ROLES = [
+    {
+        metadata: ARCHITECTURE_ROLE,
+        run: async (input) => ({
+            result: `architecture findings for: ${input.spec.slice(0, 64)}`,
+        }),
+    },
+    {
+        metadata: IMPLEMENTER_ROLE,
+        run: async (input) => ({
+            result: `patch for: ${input.spec.slice(0, 64)}`,
+        }),
+    },
+    {
+        metadata: TEST_DESIGNER_ROLE,
+        run: async (input) => ({
+            result: `test cases for: ${input.spec.slice(0, 64)}`,
+        }),
+    },
+];
+/** Registers and returns the first-batch role vertical slices. */
+export function createFirstBatchRoleSlices(catalog) {
+    const roles = FIRST_BATCH_ROLES.map((role) => ({
+        metadata: validateRoleMetadataV1(role.metadata),
+        run: role.run,
+    }));
+    for (const role of roles)
+        catalog.register(role.metadata);
+    const runners = new Map(roles.map((role) => [role.metadata.roleId, role.run]));
+    return {
+        roles,
+        async run(roleId, spec) {
+            const run = runners.get(roleId);
+            if (!run)
+                throw new Error(t("Unknown first-batch role: {roleId}", { roleId }));
+            return { roleId, result: (await run({ spec })).result };
+        },
+    };
+}
+//# sourceMappingURL=first-roles.js.map

package/dist/first-roles.js.map

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