wingfoil 0.2.1 → 0.3.0

package/dist/mcp/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * `mcp-server` module — agent interface (MCP over stdio, Anthropic SDK); Resources, Prompts, Tools.
+ * `mcp-server` module — agent interface (MCP over stdio, `@modelcontextprotocol/sdk`); Resources, Prompts, Tools.
  * Path is `src/mcp` per `dna.yaml`'s module entry (`name: mcp-server`, `path: src/mcp`).
  *
  * task-006-dual-interface-shared-core adds the thin adapter (spec-006 §2, spec-004): `registerCoreModules`
@@ -11,9 +11,10 @@
  * channel (REQ-INT-01 / REQ-SEC-05): `registerMemoryResources` (`wingfoil://memory/{type}`,
  * `wingfoil://memory/{type}/{id}` — REPLACING task-009-mcp-resource-fetch-latency's placeholder
  * `wingfoil://memory/{id}` adapter), `registerDnaResources` (`wingfoil://dna`, `wingfoil://dna/{section}`),
- * `registerWorkflowResources` (`wingfoil://workflows`, `wingfoil://workflows/{name}`), and
+ * `registerWorkflowResources` (`wingfoil://workflows`, `wingfoil://workflows/{name}`; task-239 adds
+ * `registerWorkflowStateResources`, `wingfoil://workflows/-/next` and `-/status`), and
  * `registerWriteRefusalHandler` (the structural `resources/write` refusal, spec-004 §2.3).
- * `registerReadOnlyResources` wires all four together — the one call a future production entry point
+ * `registerReadOnlyResources` wires all five together — the one call a future production entry point
  * (`task-030-implement-mcp-resources`'s `StdioServerTransport`/`wingfoil mcp` command, out of this
  * task's scope) needs alongside `registerCoreModules`. See `./read-only.ts` for the shared
  * write-refusal/not-found conventions every one of these Resources follows.
@@ -27,11 +28,13 @@ export { registerMemoryResources, MEMORY_COLLECTION_URI_TEMPLATE, MEMORY_DOCUMEN
 export type { RegisterMemoryResourcesOptions } from './memory-resource';
 export { registerDnaResources, DNA_WHOLE_URI, DNA_SECTION_URI_TEMPLATE } from './dna-resource';
 export type { RegisterDnaResourcesOptions } from './dna-resource';
-export { registerWorkflowResources, WORKFLOWS_COLLECTION_URI, WORKFLOW_DOCUMENT_URI_TEMPLATE, } from './workflow-resource';
+export { registerWorkflowResources, registerWorkflowStateResources, WORKFLOWS_COLLECTION_URI, WORKFLOW_DOCUMENT_URI_TEMPLATE, WORKFLOW_NEXT_URI, WORKFLOW_STATUS_URI, } from './workflow-resource';
 export type { RegisterWorkflowResourcesOptions } from './workflow-resource';
 export { registerWriteRefusalHandler, refuseIfWriteIntent, resourceNotFoundError, WRITE_REFUSAL_MESSAGE, WRITE_INTENT_META_KEY, } from './read-only';
 export { registerRolePrompts, roleSessionPromptName } from './prompt';
 export type { RegisterRolePromptsOptions } from './prompt';
+export { registerSessionContextResource, SESSION_CONTEXT_URI_TEMPLATE } from './session-resource';
+export type { RegisterSessionContextResourceOptions } from './session-resource';
 /** Options for {@link registerReadOnlyResources}. */
 export interface RegisterReadOnlyResourcesOptions {
     /** Resolves the project root each Resource read is served from (an ambient concern, not a request parameter). */
@@ -39,7 +42,8 @@ export interface RegisterReadOnlyResourcesOptions {
 }
 /**
  * Wire the full spec-004 §2 read-only Resources channel onto `server` in one call: the Memory, DNA,
- * and Workflow Resources plus the structural `resources/write` refusal. Deliberately does not touch
+ * and Workflow Resources — the two workflow-state Resources `wingfoil://workflows/-/next` and `-/status`
+ * included (task-239, `spec-017` §9) — plus the structural `resources/write` refusal. Deliberately does not touch
  * `registerCoreModules`/`CORE_MODULES` — a caller building a real server still calls that separately
  * for the (today, zero) Tools/legacy-shaped Resources it derives from `src/core`.
  */

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,yGAAyG;AACzG,eAAO,MAAM,WAAW,EAAG,YAAqB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAO3D,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,iHAAiH;IACjH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAgC,GAAG,IAAI,CAK5G;AAMD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,yGAAyG;AACzG,eAAO,MAAM,WAAW,EAAG,YAAqB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,wBAAwB,EACxB,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAK3D,OAAO,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClG,YAAY,EAAE,qCAAqC,EAAE,MAAM,oBAAoB,CAAC;AAOhF,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,iHAAiH;IACjH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAgC,GAAG,IAAI,CAM5G;AAMD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/mcp/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startMcpServer = exports.createMcpServer = exports.roleSessionPromptName = exports.registerRolePrompts = exports.WRITE_INTENT_META_KEY = exports.WRITE_REFUSAL_MESSAGE = exports.resourceNotFoundError = exports.refuseIfWriteIntent = exports.registerWriteRefusalHandler = exports.WORKFLOW_DOCUMENT_URI_TEMPLATE = exports.WORKFLOWS_COLLECTION_URI = exports.registerWorkflowResources = exports.DNA_SECTION_URI_TEMPLATE = exports.DNA_WHOLE_URI = exports.registerDnaResources = exports.MEMORY_DOCUMENT_URI_TEMPLATE = exports.MEMORY_COLLECTION_URI_TEMPLATE = exports.registerMemoryResources = exports.deriveMcpResourceUri = exports.deriveMcpToolName = exports.registerCoreModules = exports.MODULE_NAME = void 0;
+exports.startMcpServer = exports.createMcpServer = exports.SESSION_CONTEXT_URI_TEMPLATE = exports.registerSessionContextResource = exports.roleSessionPromptName = exports.registerRolePrompts = exports.WRITE_INTENT_META_KEY = exports.WRITE_REFUSAL_MESSAGE = exports.resourceNotFoundError = exports.refuseIfWriteIntent = exports.registerWriteRefusalHandler = exports.WORKFLOW_STATUS_URI = exports.WORKFLOW_NEXT_URI = exports.WORKFLOW_DOCUMENT_URI_TEMPLATE = exports.WORKFLOWS_COLLECTION_URI = exports.registerWorkflowStateResources = exports.registerWorkflowResources = exports.DNA_SECTION_URI_TEMPLATE = exports.DNA_WHOLE_URI = exports.registerDnaResources = exports.MEMORY_DOCUMENT_URI_TEMPLATE = exports.MEMORY_COLLECTION_URI_TEMPLATE = exports.registerMemoryResources = exports.deriveMcpResourceUri = exports.deriveMcpToolName = exports.registerCoreModules = exports.MODULE_NAME = void 0;
 exports.registerReadOnlyResources = registerReadOnlyResources;
 /** This module's `dna.yaml` name (`mcp-server`) — the stable identifier surfaces and tests key it by. */
 exports.MODULE_NAME = 'mcp-server';
@@ -18,8 +18,11 @@ Object.defineProperty(exports, "DNA_WHOLE_URI", { enumerable: true, get: functio
 Object.defineProperty(exports, "DNA_SECTION_URI_TEMPLATE", { enumerable: true, get: function () { return dna_resource_1.DNA_SECTION_URI_TEMPLATE; } });
 var workflow_resource_1 = require("./workflow-resource");
 Object.defineProperty(exports, "registerWorkflowResources", { enumerable: true, get: function () { return workflow_resource_1.registerWorkflowResources; } });
+Object.defineProperty(exports, "registerWorkflowStateResources", { enumerable: true, get: function () { return workflow_resource_1.registerWorkflowStateResources; } });
 Object.defineProperty(exports, "WORKFLOWS_COLLECTION_URI", { enumerable: true, get: function () { return workflow_resource_1.WORKFLOWS_COLLECTION_URI; } });
 Object.defineProperty(exports, "WORKFLOW_DOCUMENT_URI_TEMPLATE", { enumerable: true, get: function () { return workflow_resource_1.WORKFLOW_DOCUMENT_URI_TEMPLATE; } });
+Object.defineProperty(exports, "WORKFLOW_NEXT_URI", { enumerable: true, get: function () { return workflow_resource_1.WORKFLOW_NEXT_URI; } });
+Object.defineProperty(exports, "WORKFLOW_STATUS_URI", { enumerable: true, get: function () { return workflow_resource_1.WORKFLOW_STATUS_URI; } });
 var read_only_1 = require("./read-only");
 Object.defineProperty(exports, "registerWriteRefusalHandler", { enumerable: true, get: function () { return read_only_1.registerWriteRefusalHandler; } });
 Object.defineProperty(exports, "refuseIfWriteIntent", { enumerable: true, get: function () { return read_only_1.refuseIfWriteIntent; } });
@@ -34,13 +37,20 @@ Object.defineProperty(exports, "WRITE_INTENT_META_KEY", { enumerable: true, get:
 var prompt_1 = require("./prompt");
 Object.defineProperty(exports, "registerRolePrompts", { enumerable: true, get: function () { return prompt_1.registerRolePrompts; } });
 Object.defineProperty(exports, "roleSessionPromptName", { enumerable: true, get: function () { return prompt_1.roleSessionPromptName; } });
+// task-236: the same execution context as the `{role}-session` Prompt with `element` and `state`, served also
+// as the read-only Resource template `wingfoil://session/{role}/{element}/{state}` (spec-004 §2.1), because an
+// agent CLI may let its model read Resources but not get Prompts. See `./session-resource.ts`.
+var session_resource_1 = require("./session-resource");
+Object.defineProperty(exports, "registerSessionContextResource", { enumerable: true, get: function () { return session_resource_1.registerSessionContextResource; } });
+Object.defineProperty(exports, "SESSION_CONTEXT_URI_TEMPLATE", { enumerable: true, get: function () { return session_resource_1.SESSION_CONTEXT_URI_TEMPLATE; } });
 const dna_resource_2 = require("./dna-resource");
 const memory_resource_2 = require("./memory-resource");
 const read_only_2 = require("./read-only");
 const workflow_resource_2 = require("./workflow-resource");
 /**
  * Wire the full spec-004 §2 read-only Resources channel onto `server` in one call: the Memory, DNA,
- * and Workflow Resources plus the structural `resources/write` refusal. Deliberately does not touch
+ * and Workflow Resources — the two workflow-state Resources `wingfoil://workflows/-/next` and `-/status`
+ * included (task-239, `spec-017` §9) — plus the structural `resources/write` refusal. Deliberately does not touch
  * `registerCoreModules`/`CORE_MODULES` — a caller building a real server still calls that separately
  * for the (today, zero) Tools/legacy-shaped Resources it derives from `src/core`.
  */
@@ -49,6 +59,7 @@ function registerReadOnlyResources(server, options) {
     (0, memory_resource_2.registerMemoryResources)(server, options);
     (0, dna_resource_2.registerDnaResources)(server, options);
     (0, workflow_resource_2.registerWorkflowResources)(server, options);
+    (0, workflow_resource_2.registerWorkflowStateResources)(server, options);
 }
 // The production stdio entry point (task-030-implement-mcp-resources, spec-014-mcp-server-entry-point):
 // `createMcpServer` builds a real `McpServer` with the read-only Resources and Prompts channels above wired on,

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;AA8EA,8DAKC;AA7DD,yGAAyG;AAC5F,QAAA,WAAW,GAAG,YAAqB,CAAC;AAEjD,yCAA2F;AAAlF,gHAAA,mBAAmB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAGrE,qDAI2B;AAHzB,0HAAA,uBAAuB,OAAA;AACvB,iIAAA,8BAA8B,OAAA;AAC9B,+HAAA,4BAA4B,OAAA;AAI9B,+CAA+F;AAAtF,oHAAA,oBAAoB,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,wHAAA,wBAAwB,OAAA;AAGtE,yDAI6B;AAH3B,8HAAA,yBAAyB,OAAA;AACzB,6HAAA,wBAAwB,OAAA;AACxB,mIAAA,8BAA8B,OAAA;AAIhC,yCAMqB;AALnB,wHAAA,2BAA2B,OAAA;AAC3B,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AAGvB,+FAA+F;AAC/F,8FAA8F;AAC9F,sGAAsG;AACtG,gFAAgF;AAChF,8EAA8E;AAC9E,mCAAsE;AAA7D,6GAAA,mBAAmB,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAGnD,iDAAsD;AACtD,uDAA4D;AAC5D,2CAA0D;AAC1D,2DAAgE;AAQhE;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,MAAiB,EAAE,OAAyC;IACpG,IAAA,uCAA2B,EAAC,MAAM,CAAC,CAAC;IACpC,IAAA,yCAAuB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,IAAA,mCAAoB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAA,6CAAyB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,wGAAwG;AACxG,gHAAgH;AAChH,sGAAsG;AACtG,4DAA4D;AAC5D,mCAA2D;AAAlD,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;AAyFA,8DAMC;AAxED,yGAAyG;AAC5F,QAAA,WAAW,GAAG,YAAqB,CAAC;AAEjD,yCAA2F;AAAlF,gHAAA,mBAAmB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAGrE,qDAI2B;AAHzB,0HAAA,uBAAuB,OAAA;AACvB,iIAAA,8BAA8B,OAAA;AAC9B,+HAAA,4BAA4B,OAAA;AAI9B,+CAA+F;AAAtF,oHAAA,oBAAoB,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,wHAAA,wBAAwB,OAAA;AAGtE,yDAO6B;AAN3B,8HAAA,yBAAyB,OAAA;AACzB,mIAAA,8BAA8B,OAAA;AAC9B,6HAAA,wBAAwB,OAAA;AACxB,mIAAA,8BAA8B,OAAA;AAC9B,sHAAA,iBAAiB,OAAA;AACjB,wHAAA,mBAAmB,OAAA;AAIrB,yCAMqB;AALnB,wHAAA,2BAA2B,OAAA;AAC3B,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AACrB,kHAAA,qBAAqB,OAAA;AAGvB,+FAA+F;AAC/F,8FAA8F;AAC9F,sGAAsG;AACtG,gFAAgF;AAChF,8EAA8E;AAC9E,mCAAsE;AAA7D,6GAAA,mBAAmB,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAGnD,8GAA8G;AAC9G,+GAA+G;AAC/G,+FAA+F;AAC/F,uDAAkG;AAAzF,kIAAA,8BAA8B,OAAA;AAAE,gIAAA,4BAA4B,OAAA;AAGrE,iDAAsD;AACtD,uDAA4D;AAC5D,2CAA0D;AAC1D,2DAAgG;AAQhG;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,MAAiB,EAAE,OAAyC;IACpG,IAAA,uCAA2B,EAAC,MAAM,CAAC,CAAC;IACpC,IAAA,yCAAuB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,IAAA,mCAAoB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAA,6CAAyB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAA,kDAA8B,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,wGAAwG;AACxG,gHAAgH;AAChH,sGAAsG;AACtG,4DAA4D;AAC5D,mCAA2D;AAAlD,yGAAA,eAAe,OAAA;AAAE,wGAAA,cAAc,OAAA"}

package/dist/mcp/memory-resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-resource.d.ts","sourceRoot":"","sources":["../../src/mcp/memory-resource.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,wHAAwH;IACxH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,6BAA6B,CAAC;AACzE,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,8BAA8B,GAAG,IAAI,CAyFxG"}
+{"version":3,"file":"memory-resource.d.ts","sourceRoot":"","sources":["../../src/mcp/memory-resource.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBzE,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,wHAAwH;IACxH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,6BAA6B,CAAC;AACzE,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,8BAA8B,GAAG,IAAI,CAmGxG"}

package/dist/mcp/memory-resource.js

@@ -18,7 +18,10 @@ exports.registerMemoryResources = registerMemoryResources;
  * an agent browsing a type is never handed a replaced or retired decision as if it were current — the
  * same guarantee `wingfoil://memory/search` and default `memory search` already give. The
  * **single-document** Resource does **not** filter: addressing a document by its id is explicit
- * retrieval, which REQ-STATE-06 preserves ("remaining present on disk and in git history"). It is the
+ * retrieval, which REQ-STATE-06 preserves ("remaining present on disk and in git history"). Since
+ * task-171 (`dl-038` option 1) the primitives exclude archived content by default, so the collection
+ * inherits its filter and the single-document Resource asks for archived content with
+ * `includeArchived: true`. It is the
  * MCP counterpart of `memory search --status deprecated` on the CLI, whose own opt-in
  * (`memorySearchFn`, `src/core/index.ts`) is gated on the same `isArchivedStatus`. `draft` is not
  * archived and is withheld by neither handler; only the *context* path (`src/core/relevance.ts`)
@@ -41,8 +44,8 @@ const path_1 = require("path");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const core_1 = require("../core");
 const query_1 = require("../memory/query");
-const state_machine_1 = require("../memory/state-machine");
 const storage_1 = require("../storage");
+const validation_1 = require("../validation");
 const read_only_1 = require("./read-only");
 /** spec-004 §2.1 — collection listing (frontmatter only, no `{id}`). */
 exports.MEMORY_COLLECTION_URI_TEMPLATE = 'wingfoil://memory/{type}';
@@ -55,7 +58,7 @@ exports.MEMORY_DOCUMENT_URI_TEMPLATE = 'wingfoil://memory/{type}/{id}';
  */
 function registerMemoryResources(server, options) {
     const collectionTemplate = new mcp_js_1.ResourceTemplate(exports.MEMORY_COLLECTION_URI_TEMPLATE, { list: undefined });
-    server.registerResource('memory.list', collectionTemplate, { description: 'Memory documents of one type, frontmatter only (read-only)' }, async (uri, variables, extra) => {
+    server.registerResource('memory.list', collectionTemplate, { description: 'Memory documents of one type, frontmatter only (read-only)' }, (uri, variables, extra) => (0, read_only_1.withRefusalDetails)(() => {
         (0, read_only_1.refuseIfWriteIntent)(extra._meta);
         const root = options.resolveRoot();
         const memoryYaml = (0, core_1.loadMemoryYaml)(root);
@@ -68,25 +71,22 @@ function registerMemoryResources(server, options) {
             throw (0, read_only_1.resourceNotFoundError)(`memory/${type}`);
         // REQ-STATE-06 / `dl-028-archived-states-excluded-from-context` (`bug-010`): this collection is
         // an agent-facing read path, so archived documents — `{deprecated, superseded}`, per the shared
-        // `isArchivedStatus` — are withheld here. The filter sits at this call site rather than inside
-        // `listMemoryDocumentsByType` because that primitive also serves the single-document Resource's
-        // consumers, which must still see archived content; the *policy* belongs to the surface, while
-        // the *definition* of "archived" stays single, as dl-028 requires. `status` is already
-        // projected to `string | undefined` by the primitive — the shape `isArchivedStatus` takes — so
-        // a non-string frontmatter `status` is never archived. `filter` preserves the primitive's
-        // id-ascending order (REQ-SYS-07).
-        const summaries = (0, query_1.listMemoryDocumentsByType)(root, memoryYaml, type)
-            .filter(({ status }) => !(0, state_machine_1.isArchivedStatus)(status))
+        // `isArchivedStatus` — are withheld. Since task-171 (`dl-038` option 1) the primitive withholds
+        // them by default, so this call site no longer filters: omitting a filter fails closed.
+        // A document the scan leaves out (unreadable, a link, a newer `format:`) is reported, and the
+        // report reaches the client as `warnings` (task-195, `bug-231`), as the CLI prints it.
+        const diagnostics = [];
+        const summaries = (0, query_1.listMemoryDocumentsByType)(root, memoryYaml, type, { onDiagnostic: (diagnostic) => diagnostics.push(diagnostic) })
             .map(({ id, title, status, tags }) => ({
             id,
             title,
             status,
             tags,
         }));
-        return (0, read_only_1.jsonResourceResult)(uri, summaries);
-    });
+        return (0, read_only_1.withWarnings)((0, read_only_1.jsonResourceResult)(uri, summaries), diagnostics.map(validation_1.formatDiagnostic));
+    }));
     const documentTemplate = new mcp_js_1.ResourceTemplate(exports.MEMORY_DOCUMENT_URI_TEMPLATE, { list: undefined });
-    server.registerResource('memory.show', documentTemplate, { description: 'one Memory document, full content + metadata (read-only)' }, async (uri, variables, extra) => {
+    server.registerResource('memory.show', documentTemplate, { description: 'one Memory document, full content + metadata (read-only)' }, (uri, variables, extra) => (0, read_only_1.withRefusalDetails)(() => {
         (0, read_only_1.refuseIfWriteIntent)(extra._meta);
         const root = options.resolveRoot();
         const memoryYaml = (0, core_1.loadMemoryYaml)(root);
@@ -94,9 +94,20 @@ function registerMemoryResources(server, options) {
         const id = variables.id;
         if (!(type in memoryYaml.types))
             throw (0, read_only_1.resourceNotFoundError)(`memory/${type}/${id}`);
-        const doc = (0, query_1.findMemoryDocumentByTypeAndId)(root, memoryYaml, type, id);
+        // `includeArchived: true`, said here on purpose (task-171, `dl-038` option 1): REQ-STATE-06 keeps
+        // an archived document "present on disk and in git history", and this Resource is how an agent
+        // retrieves one explicitly.
+        // The lookup reports the files it could not read on its way (task-195, `bug-231`): beside the
+        // document on success, and as the refusal's details when it found nothing, since the document
+        // may be one of them.
+        const diagnostics = [];
+        const doc = (0, query_1.findMemoryDocumentByTypeAndId)(root, memoryYaml, type, id, {
+            includeArchived: true,
+            onDiagnostic: (diagnostic) => diagnostics.push(diagnostic),
+        });
+        const warnings = diagnostics.map(validation_1.formatDiagnostic);
         if (!doc)
-            throw (0, read_only_1.resourceNotFoundError)(`memory/${type}/${id}`);
+            throw (0, read_only_1.readRefusalError)((0, read_only_1.resourceNotFoundError)(`memory/${type}/${id}`).message, (0, read_only_1.warningDetails)(warnings));
         // spec-004 §2.2 wants the *full file content* (frontmatter + body), not the re-serialized
         // parsed frontmatter `loadMemoryDocumentSummary` already split apart for the scan — so this
         // re-reads the resolved path's raw bytes via `storage.readDocument` (still a read primitive
@@ -127,7 +138,7 @@ function registerMemoryResources(server, options) {
                 title: doc.frontmatter.title,
             },
         };
-        return result;
-    });
+        return (0, read_only_1.withWarnings)(result, warnings);
+    }));
 }
 //# sourceMappingURL=memory-resource.js.map

package/dist/mcp/memory-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-resource.js","sourceRoot":"","sources":["../../src/mcp/memory-resource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-resource.js","sourceRoot":"","sources":["../../src/mcp/memory-resource.ts"],"names":[],"mappings":"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"}

package/dist/mcp/prompt.d.ts

@@ -1,12 +1,18 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ExecutionContextElement } from '../core';
 /** Options for {@link registerRolePrompts}. */
 export interface RegisterRolePromptsOptions {
     /**
-     * Resolves the project root each `prompts/get` is served from — invoked per request by the prompt
-     * handlers, and once by {@link registerRolePrompts} itself to read the DNA role catalogue (see
-     * that function's note on the two different timings spec-004 §3.1 and §3.2 mandate).
+     * Resolves the project root each `prompts/get` is served from — invoked per request by the
+     * `prompts/get` handler, which resolves the role's directives then (spec-004 §3.2).
      */
     readonly resolveRoot: () => string;
+    /**
+     * The DNA role set (`dna.yaml` `team.roles[].name`, declaration order), read once before the server
+     * starts — by `wingfoil mcp`'s pre-flight (`loadDnaRoleSet`, `dl-049` (b)) — and fixed for the
+     * server's life: spec-004 §3.1's "fixed set derived from DNA at server start".
+     */
+    readonly roles: readonly string[];
 }
 /**
  * `{role}-session` — spec-004 §3.1's prompt naming convention, as a function so the wire-visible name
@@ -15,32 +21,63 @@ export interface RegisterRolePromptsOptions {
  */
 export declare function roleSessionPromptName(role: string): string;
 /**
- * Register the role-scoped Prompts channel: one `{role}-session` Prompt per role in `dna.yaml`'s
- * `team.roles` catalogue (spec-004 §3.1), each embedding that role's directives (§3.2), and a refusal
- * for a session prompt naming a role DNA does not declare (P5.2.2's undefined-role scenario).
+ * A request refusal — of `prompts/get`, or of the session Resource's read (`./session-resource.ts`, task-236) —
+ * whose JSON-RPC error carries `message` **verbatim** with code `InvalidParams` (-32602, the code the MCP SDK
+ * itself uses for an unknown prompt name or resource).
  *
- * **Nothing is read here — every read happens per request** (task-058 second pass, rejection `ff13321`).
- * spec-014 §2 requires `createMcpServer` to perform "no I/O at construction time beyond wiring
- * handlers", so the DNA role catalogue is loaded inside the `prompts/list` / `prompts/get` handlers,
- * next to the per-request directive resolution spec-004 §3.2 already mandated (REQ-INT-02's "a newly
- * assigned directive appears on the next session start"). Two consequences, both deliberate:
+ * Deliberately a plain `Error` with a `code`, not the SDK's `McpError`: `McpError`'s constructor
+ * prefixes its own message with `MCP error <code>: `, and the SDK serializes `error.message` as-is, so a
+ * client — which adds that prefix again when it rebuilds the error — would read the prefix twice.
+ */
+export declare function promptRequestError(message: string): Error;
+/** The execution context for `(role, element, state)`, as text, with the diagnostics that ride beside it. */
+export interface SessionContext {
+    /** `assembleExecutionContext`'s `spec-012` §7 payload, as returned. */
+    readonly text: string;
+    /** The directive-resolution warnings, then the builder's notes, then the `W_MEMORY_UNREADABLE` lines. */
+    readonly warnings: readonly string[];
+}
+/**
+ * The execution context for `role`, `element` and `state` (task-195, spec-004 §3.2): `assembleExecutionContext`'s
+ * §7 payload, as returned — never re-serialized, and never indexed by its body markers (`bug-265`). `state` is
+ * resolved once, here, and the builder reads everything at that sha, so neither a later commit nor an uncommitted
+ * edit changes the answer. ONE builder for both carriers: the `{role}-session` Prompt wraps it in `messages`
+ * ({@link buildContextPrompt}), the session Resource in `contents` (`./session-resource.ts`, task-236), so the two
+ * answer the same bytes for the same arguments.
+ *
+ * The diagnostics: the directive-resolution warnings (`spec-012` §5.1 order), then the builder's notes (§3 stage
+ * order), then the `W_MEMORY_UNREADABLE` lines of the files the scan left out (path order, task-171).
+ *
+ * Refusals (spec-004 §3.4): a `state` that is not a commit and an element the commit does not hold are request
+ * errors, `-32602` — the latter with the unreadable files as `error.data.details`, so a subject that does not parse
+ * is not reported as merely absent. Every other refusal is about the repository (an archived subject, one in a
+ * newer `format:`, a missing pillar file) and is a failed read, as a failed Resource read is: the core message with
+ * its details.
+ */
+export declare function buildSessionContext(root: string, role: string, element: ExecutionContextElement, state: string): SessionContext;
+/**
+ * Register the role-scoped Prompts channel: one `{role}-session` Prompt per role in `options.roles`
+ * (spec-004 §3.1), each embedding that role's directives (§3.2), and the refusals of §3.4.
  *
- * - `wingfoil mcp` starts in a git root with no `.wingfoil/dna.yaml` (e.g. a repository that has not
- *   run `wingfoil init`) exactly as the Resources channel always has; the missing DNA surfaces as the
- *   error of each Prompts request instead of aborting the process start.
- * - spec-004 §3.1's "fixed set derived from DNA at server start" is served as the DNA role set **at
- *   request time**: a role added to `dna.yaml` while the server runs is listed on the next
- *   `prompts/list`. That tension between spec-014 §2 and spec-004 §3.1 is open for the approver.
+ * **The role set is fixed; the directives are not** (`dl-049` (b), task-174). `options.roles` is the
+ * DNA role set `wingfoil mcp` read once, in its pre-flight, before the server started; it is copied
+ * here and never re-read, so `prompts/list` and the undefined-role check read nothing, and a role added
+ * to `dna.yaml` while the server runs is served after a restart. The Prompts capability is therefore
+ * declared without `listChanged`: the list cannot change during a session. What a Prompt *embeds* is
+ * still resolved per request — `roles.yaml` and the directive files are read on every `prompts/get`
+ * (spec-004 §3.2, REQ-INT-02's "a newly assigned directive appears on the next session start"). This
+ * function itself reads nothing, so `createMcpServer` keeps spec-014 §2's "no I/O at construction".
  *
  * **Why the low-level handlers, not `McpServer.registerPrompt`.** The high-level API answers an
  * unregistered name with its own `Prompt <name> not found` before any WingFoil code runs, so the BDD's
- * `no prompt for undefined role 'wizard'` cannot be expressed through it (and it would need the role
- * set at registration time). This function therefore owns `prompts/list` and `prompts/get` on
- * `server.server` — the same pattern `./read-only.ts`'s `registerWriteRefusalHandler` uses — and a
- * later `registerPrompt` on the same server fails loudly ("A request handler for prompts/list already
- * exists") instead of being silently shadowed. A requested name that is not `{role}-session`-shaped
- * keeps the SDK-equivalent `Prompt <name> not found` wording: it names no role, so it is not an
- * undefined-role request, and it is answered without reading anything.
+ * `no prompt for undefined role 'wizard'` cannot be expressed through it. This function therefore owns
+ * `prompts/list` and `prompts/get` on `server.server` — the same pattern `./read-only.ts`'s
+ * `registerWriteRefusalHandler` uses — and a later `registerPrompt` on the same server fails loudly ("A
+ * request handler for prompts/list already exists") instead of being silently shadowed. spec-004 §3.4's
+ * two refusals, both `-32602`: a `{role}-session` name whose role is not in the set is `no prompt for
+ * undefined role '<role>'`; a name that is not `{role}-session`-shaped names no role and keeps the SDK's
+ * `Prompt <name> not found`. A read that fails while a Prompt is built carries the loader's details as
+ * `error.data.details`, as a failed Resource read does (`withRefusalDetails`, `bug-184`).
  *
  * Call before the server is connected (MCP capabilities cannot be registered after connecting).
  */

package/dist/mcp/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/mcp/prompt.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAgGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAkBhG"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/mcp/prompt.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,OAAO,KAAK,EAA4B,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAMjF,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEzD;AAuCD,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAmB/H;AA6HD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAyChG"}