@moldea.ai/adapter-eve 3.0.1 → 3.0.2

package/README.md

@@ -19,7 +19,7 @@ const core = createCore({ adapters: [eveAdapter] });
 
 ## Verified target
 
-Version `3.0.1` supports Repository Format `1`, `@moldea.ai/core ^4.0.0`, and direct TypeScript Eve filesystem agents whose declared Eve range intersects `eve >=0.39.1`. Eve `0.39.1` is the verified minimum. Later stable releases are eligible for deterministic inspection on a best-effort basis and must still match the documented source patterns. Qualification evidence records the exact package versions and date used for each execution. The target recognizes:
+Version `3.0.2` supports Repository Format `1`, `@moldea.ai/core ^4.0.0`, and direct TypeScript Eve filesystem agents whose declared Eve range intersects `eve >=0.39.1`. Eve `0.39.1` is the verified minimum. Later stable releases are eligible for deterministic inspection on a best-effort basis and must still match the documented source patterns. Qualification evidence records the exact package versions and date used for each execution. The target recognizes:
 
 - flat and nested root `agent.ts` definitions
 - recursive directory-backed local subagents
@@ -36,6 +36,8 @@ The package exports only `eveAdapter`. It has no default export, configuration f
 
 ## Documentation
 
+These guides are included in the installed package. Open only the page relevant to your task.
+
 - [Package overview](docs/index.md)
 - [Verified target](docs/verified-target.md)
 - [Evidence and diagnostics](docs/evidence-and-diagnostics.md)

package/docs/evidence-and-diagnostics.md

@@ -0,0 +1,47 @@
+---
+title: Evidence and diagnostics
+description: Source-grounded Eve observations and stable adapter failures.
+order: 20
+---
+
+# Evidence and diagnostics
+
+The adapter may emit `runtime-package`, `language`, `agent-definition`, `instruction-loader`, `schema`, `tool-registration`, `skill-registration`, and `handoff-registration` evidence. Dynamic or collided forms suppress optimistic evidence and any negative diagnostic that would require selecting an uncertain source.
+
+## Stable diagnostics
+
+| Code                                        | Message                                                                                   |
+| ------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `EVE_PACKAGE_MANIFEST_INVALID`              | The owning package manifest is invalid for Eve dependency detection.                      |
+| `EVE_SDK_VERSION_UNSUPPORTED`               | The observed Eve dependency range is disjoint from the supported range.                   |
+| `EVE_SOURCE_TEXT_INVALID`                   | The referenced Eve source file is not valid normalized text.                              |
+| `EVE_SOURCE_SYNTAX_INVALID`                 | The referenced Eve source file contains invalid TypeScript syntax.                        |
+| `EVE_RUNTIME_AGENT_SYMBOL_NOT_FOUND`        | The declared Eve runtime-agent symbol was not found.                                      |
+| `EVE_INSTRUCTION_LOADER_SYMBOL_NOT_FOUND`   | The declared Eve instruction-loader symbol was not found.                                 |
+| `EVE_AGENT_OUTPUT_SCHEMA_SYMBOL_NOT_FOUND`  | The declared Eve agent output-schema symbol was not found.                                |
+| `EVE_TOOL_IMPLEMENTATION_SYMBOL_NOT_FOUND`  | The declared Eve tool implementation symbol was not found.                                |
+| `EVE_TOOL_REGISTRATION_SYMBOL_NOT_FOUND`    | The declared Eve tool registration symbol was not found.                                  |
+| `EVE_TOOL_INPUT_SCHEMA_SYMBOL_NOT_FOUND`    | The declared Eve tool input-schema symbol was not found.                                  |
+| `EVE_TOOL_OUTPUT_SCHEMA_SYMBOL_NOT_FOUND`   | The declared Eve tool output-schema symbol was not found.                                 |
+| `EVE_SKILL_IMPLEMENTATION_SYMBOL_NOT_FOUND` | The declared Eve skill implementation symbol was not found.                               |
+| `EVE_SKILL_REGISTRATION_SYMBOL_NOT_FOUND`   | The declared Eve skill registration symbol was not found.                                 |
+| `EVE_INSTRUCTION_ROOT_CONFLICT`             | The Eve instruction slot contains conflicting authored sources.                           |
+| `EVE_INSTRUCTION_LOADER_NOT_WIRED`          | The declared instruction loader is not wired to the supported Eve instruction surface.    |
+| `EVE_AGENT_OUTPUT_SCHEMA_NOT_WIRED`         | The declared agent output schema is not wired to the Eve agent definition.                |
+| `EVE_TOOL_IMPLEMENTATION_NOT_WIRED`         | The declared tool implementation is not wired to the Eve tool definition.                 |
+| `EVE_TOOL_REGISTRATION_NOT_WIRED`           | The declared tool registration is not wired to the owning Eve agent.                      |
+| `EVE_TOOL_NAME_INVALID`                     | The Eve filesystem tool name is invalid.                                                  |
+| `EVE_TOOL_NAME_RESERVED`                    | The Eve filesystem tool name is reserved by the runtime.                                  |
+| `EVE_TOOL_RUNTIME_NAME_COLLISION`           | Multiple Eve tool sources resolve to the same runtime tool name.                          |
+| `EVE_TOOL_NAME_MISMATCH`                    | The declared tool name does not match the Eve path-derived runtime name.                  |
+| `EVE_TOOL_INPUT_SCHEMA_NOT_WIRED`           | The declared tool input schema is not wired to the Eve tool definition.                   |
+| `EVE_TOOL_OUTPUT_SCHEMA_NOT_WIRED`          | The declared tool output schema is not wired to the Eve tool definition.                  |
+| `EVE_SKILL_IMPLEMENTATION_NOT_WIRED`        | The declared skill implementation is not the discovered Eve skill artifact.               |
+| `EVE_SKILL_REGISTRATION_NOT_WIRED`          | The declared skill registration is not wired to the owning Eve agent.                     |
+| `EVE_SKILL_NAME_MISMATCH`                   | The declared skill name does not match the Eve path-derived runtime name.                 |
+| `EVE_TOOL_SUBAGENT_NAME_COLLISION`          | The Eve tool and local subagent use the same runtime tool name.                           |
+| `EVE_SUBAGENT_PARENT_AMBIGUOUS`             | Multiple registered Eve agents map to the local subagent's immediate parent root.         |
+| `EVE_ROUTING_DESCRIPTION_MISSING`           | The supported Eve local subagent definition is missing its routing description.           |
+| `EVE_ROUTING_DESCRIPTION_NOT_WIRED`         | The Eve local subagent description does not use the target effective routing description. |
+
+Diagnostics never include source snippets, descriptions, instructions, schema contents, credentials, URLs, host paths, or raw TypeScript diagnostic messages.

package/docs/index.md

@@ -0,0 +1,13 @@
+---
+title: Eve adapter
+description: Deterministic evidence for Eve TypeScript filesystem agents.
+order: 1
+---
+
+# Eve adapter
+
+`@moldea.ai/adapter-eve` connects Repository Format `1` declarations to static Eve filesystem conventions. Eve `0.39.1` is the verified minimum. Later stable releases are eligible for deterministic inspection on a best-effort basis and must still match the documented source patterns.
+
+The adapter begins at each declared runtime-agent path, finds its nearest owning package, validates the exact Eve layout, and returns immutable evidence and stable diagnostics through Core. It neither executes the application nor treats package presence as proof of an agent definition.
+
+The package exports only `eveAdapter`. The generated API reference derives that surface from the package export.

package/docs/limitations.md

@@ -0,0 +1,15 @@
+---
+title: Limitations
+description: Conservative boundaries of the initial Eve adapter target.
+order: 30
+---
+
+# Limitations
+
+The initial target intentionally excludes dynamic agents and capabilities, configuration-free roots, positive single-file-subagent analysis, JavaScript and non-`.ts` parsing, arbitrary compiler resolution, remote agents, extensions, connections, channels, schedules, hooks, state, sessions, auth, and runtime execution.
+
+Known alternate authored module extensions participate only in collision preflight. Their contents are not read. Flat and packaged Markdown skills may establish an implementation path but do not establish runtime registration. Schema contents, model identifiers, provider configuration, tool side effects, approval behavior, and semantic description quality are not validated.
+
+When an unsupported source could replace, rename, compose, or collide with a relationship, the adapter returns no optimistic evidence and suppresses contradiction diagnostics that would require guessing Eve's effective runtime state.
+
+Each invocation sees one declared agent and bounded logical repository operations, not a complete agent collection or project body index.

package/docs/verified-target.md

@@ -0,0 +1,15 @@
+---
+title: Verified target
+description: Static forms covered by the Eve filesystem-agent target from verified minimum 0.39.1.
+order: 10
+---
+
+# Verified target
+
+Technical target `typescript-filesystem-agent-0-39` admits declared Eve ranges that intersect `eve >=0.39.1`. Eve `0.39.1` is the verified minimum. Later stable releases are eligible for deterministic inspection on a best-effort basis and must still match the source patterns below. Qualification evidence records the exact package versions and date used for each execution.
+
+Positive agent evidence requires an uncollided flat or nested `agent.ts` that directly default-exports `defineAgent(...)`, uses only `model`, optional `description`, and optional `outputSchema`, and resolves `model` to a supported static string. Directory-backed local subagents use the same rule recursively.
+
+Instructions require one exclusive exact-lowercase `instructions.md` or one exact-shape `instructions.ts`. Tools are discovered recursively under `tools/`, use Eve's exact path-segment grammar, and flatten path separators to hyphens. Positive skill registration is limited to uncollided direct TypeScript `defineSkill(...)` modules.
+
+The adapter itself supports Node.js `>=22.11.0`. Applications must also satisfy the selected Eve release's Node.js requirement; the verified minimum requires Node.js 24 or newer according to Eve's package metadata.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/adapter-eve",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Deterministic runtime evidence and diagnostics for Eve filesystem agents.",
   "homepage": "https://github.com/moldea-ai/packages/tree/main/projects/adapter-eve#readme",
   "bugs": {
@@ -18,6 +18,7 @@
   "files": [
     "cover.png",
     "dist",
+    "docs",
     "LICENSE",
     "README.md"
   ],