ai-jue-adapter-hermes 0.2.0

package/README.md

@@ -0,0 +1,9 @@
+# ai-jue-adapter-hermes (placeholder)
+
+Stub package metadata carried over from an earlier exploration. The real
+Hermes Adapter implementation is the JUE-303 work item; this README is
+a placeholder to satisfy `check-consistency.js`'s README-must-exist rule
+until JUE-303 lands.
+
+The full Delivery Plan context for this package is in
+`packages/docs/developer/delivery-plan.md` (R3 section, JUE-303 row).

package/dist/capabilities/agents.d.ts

@@ -0,0 +1,10 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Hermes has no per-workspace `agents/` directory (unlike OpenClaw
+ * which uses `.openclaw/agents/<name>/`). The single-agent runtime
+ * reads the `agent:` block from the user-home `~/.hermes/config.yaml`
+ * (per the real cwr:/d/devuser/.hermes/config.yaml reading). Per the
+ * JUE-303 honest-stance principle, the `agents` mapping is a no-op
+ * round-trip so the equivalence contract holds vacuously.
+ */
+export declare function agents(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/agents.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agents = agents;
+/**
+ * Hermes has no per-workspace `agents/` directory (unlike OpenClaw
+ * which uses `.openclaw/agents/<name>/`). The single-agent runtime
+ * reads the `agent:` block from the user-home `~/.hermes/config.yaml`
+ * (per the real cwr:/d/devuser/.hermes/config.yaml reading). Per the
+ * JUE-303 honest-stance principle, the `agents` mapping is a no-op
+ * round-trip so the equivalence contract holds vacuously.
+ */
+function agents() {
+    return {
+        read: () => undefined,
+        write: () => [],
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/capabilities/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/capabilities/agents.ts"],"names":[],"mappings":";;AAUA,wBAKC;AAbD;;;;;;;GAOG;AACH,SAAgB,MAAM;IACpB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/capabilities/commands.d.ts

@@ -0,0 +1,10 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Hermes has no per-workspace `commands/` directory — the
+ * `commands` block in the real `config.yaml` configures top-level
+ * Hermes runtime behavior (e.g. `commands.restart: true`,
+ * `commands.ownerDisplay: 'raw'`), not user-authored slash-commands.
+ * Per the JUE-303 honest-stance principle, the `commands` mapping
+ * is a no-op round-trip so the equivalence contract holds vacuously.
+ */
+export declare function commands(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/commands.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = commands;
+/**
+ * Hermes has no per-workspace `commands/` directory — the
+ * `commands` block in the real `config.yaml` configures top-level
+ * Hermes runtime behavior (e.g. `commands.restart: true`,
+ * `commands.ownerDisplay: 'raw'`), not user-authored slash-commands.
+ * Per the JUE-303 honest-stance principle, the `commands` mapping
+ * is a no-op round-trip so the equivalence contract holds vacuously.
+ */
+function commands() {
+    return {
+        read: () => undefined,
+        write: () => [],
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/capabilities/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/capabilities/commands.ts"],"names":[],"mappings":";;AAUA,4BAKC;AAbD;;;;;;;GAOG;AACH,SAAgB,QAAQ;IACtB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/capabilities/context.d.ts

@@ -0,0 +1,22 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * `context.global` maps to Hermes's `MEMORY.md`: a real, user-authored,
+ * per-HERMES_HOME memory/context file — verified against a live installation
+ * (`D:\<home>\.hermes\MEMORY.md` on a real, running Hermes gateway), which
+ * Hermes's own `common/RULE.md` docs describe as where "用户信息" and
+ * project-specific conventions live, analogous to Claude Code's `CLAUDE.md`.
+ *
+ * Unlike Claude's `CLAUDE.md`, no `@import`-style directive was found on the
+ * verified instance (it references `common/RULE.md`/`common/env.md` in plain
+ * prose, not a resolvable import syntax), so read() only needs to extract the
+ * Jue-managed block — no custom import resolution — and write() reuses the
+ * generic managed-markdown-file mapping unchanged.
+ *
+ * The returned Canonical shape is `{global: string}` (matching
+ * `ContextSchema`), NOT the bare string. The kit's `readCapabilities`
+ * places the result under `canonical.context`, and the schema requires
+ * an object there.
+ */
+export declare function context(): CapabilityMapping<{
+    global?: string;
+}>;

package/dist/capabilities/context.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.context = context;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ai_jue_core_1 = require("ai-jue-core");
+/**
+ * `context.global` maps to Hermes's `MEMORY.md`: a real, user-authored,
+ * per-HERMES_HOME memory/context file — verified against a live installation
+ * (`D:\<home>\.hermes\MEMORY.md` on a real, running Hermes gateway), which
+ * Hermes's own `common/RULE.md` docs describe as where "用户信息" and
+ * project-specific conventions live, analogous to Claude Code's `CLAUDE.md`.
+ *
+ * Unlike Claude's `CLAUDE.md`, no `@import`-style directive was found on the
+ * verified instance (it references `common/RULE.md`/`common/env.md` in plain
+ * prose, not a resolvable import syntax), so read() only needs to extract the
+ * Jue-managed block — no custom import resolution — and write() reuses the
+ * generic managed-markdown-file mapping unchanged.
+ *
+ * The returned Canonical shape is `{global: string}` (matching
+ * `ContextSchema`), NOT the bare string. The kit's `readCapabilities`
+ * places the result under `canonical.context`, and the schema requires
+ * an object there.
+ */
+function context() {
+    const managed = (0, ai_jue_core_1.managedMarkdownFile)({ filePath: (root) => path_1.default.join(root, "MEMORY.md") });
+    return {
+        read(root) {
+            const filePath = path_1.default.join(root, "MEMORY.md");
+            if (!fs_1.default.existsSync(filePath))
+                return undefined;
+            const inner = (0, ai_jue_core_1.extractManagedContent)(fs_1.default.readFileSync(filePath, "utf8")).trim();
+            if (!inner)
+                return undefined;
+            return { global: inner };
+        },
+        write(root, value, target) {
+            if (!value || value.global === undefined)
+                return [];
+            return managed.write(root, value.global, target);
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/capabilities/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/capabilities/context.ts"],"names":[],"mappings":";;;;;AAuBA,0BAeC;AAtCD,4CAAoB;AACpB,gDAAwB;AACxB,6CAAyE;AAGzE;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,OAAO;IACrB,MAAM,OAAO,GAAG,IAAA,iCAAmB,EAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1F,OAAO;QACL,IAAI,CAAC,IAAI;YACP,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAA,mCAAqB,EAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9E,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM;YACvB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;YACpD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/cron.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilityMapping } from "ai-jue-core";
+export declare function cron(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/cron.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cron = cron;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+/**
+ * Hermes cron jobs live at `<workspace>/cron/jobs.json` (verified
+ * against cwr:/d/devuser/.hermes/cron/jobs.json — a top-level JSON
+ * object mapping job_id → {name, prompt, schedule, repeat, deliver,
+ * enabled, model, provider, base_url, skills, created_at}). Each
+ * schedule is a standard cron string (e.g. "0 23 * * *"). Per the
+ * JUE-303 honest-stance principle, the `cron` mapping is a full-file
+ * pass-through (not per-job); the round-trip is byte-exact.
+ */
+function sha256(s) {
+    return (0, crypto_1.createHash)("sha256").update(s).digest("hex");
+}
+function cron() {
+    return {
+        read(root) {
+            const filePath = path_1.default.join(root, "cron", "jobs.json");
+            if (!fs_1.default.existsSync(filePath))
+                return undefined;
+            try {
+                const parsed = JSON.parse(fs_1.default.readFileSync(filePath, "utf8"));
+                if (!parsed || typeof parsed !== "object")
+                    return undefined;
+                return parsed;
+            }
+            catch {
+                return undefined;
+            }
+        },
+        write(root, value, target) {
+            const filePath = path_1.default.join(root, "cron", "jobs.json");
+            const exists = fs_1.default.existsSync(filePath);
+            const existingRaw = exists ? fs_1.default.readFileSync(filePath, "utf8") : undefined;
+            const newRaw = JSON.stringify(value, null, 2) + "\n";
+            if (existingRaw !== undefined && existingRaw === newRaw)
+                return [];
+            return [
+                {
+                    target,
+                    kind: exists ? "update" : "create",
+                    ownership: "full",
+                    scope: "project",
+                    path: "cron/jobs.json",
+                    beforeHash: existingRaw === undefined ? null : sha256(existingRaw),
+                    afterHash: sha256(newRaw),
+                    content: newRaw,
+                    risk: "low",
+                    requiresApproval: false,
+                    atomicState: "planned",
+                },
+            ];
+        },
+    };
+}
+//# sourceMappingURL=cron.js.map

package/dist/capabilities/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../../src/capabilities/cron.ts"],"names":[],"mappings":";;;;;AAiCA,oBAoCC;AArED,4CAAoB;AACpB,gDAAwB;AACxB,mCAAoC;AAGpC;;;;;;;;GAQG;AACH,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAiBD,SAAgB,IAAI;IAClB,OAAO;QACL,IAAI,CAAC,IAAI;YACP,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YACtD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAC;gBACxF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;oBAAE,OAAO,SAAS,CAAC;gBAC5D,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM;YACvB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;YACrD,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,MAAM;gBAAE,OAAO,EAAE,CAAC;YACnE,OAAO;gBACL;oBACE,MAAM;oBACN,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAClC,SAAS,EAAE,MAAM;oBACjB,KAAK,EAAE,SAAS;oBAChB,IAAI,EAAE,gBAAgB;oBACtB,UAAU,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;oBAClE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;oBACzB,OAAO,EAAE,MAAM;oBACf,IAAI,EAAE,KAAK;oBACX,gBAAgB,EAAE,KAAK;oBACvB,WAAW,EAAE,SAAS;iBACvB;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/hooks.d.ts

@@ -0,0 +1,12 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Hermes has no per-workspace `hooks/` directory — the
+ * `hooks_auto_accept` block in the real `config.yaml` (verified
+ * against cwr:/d/devuser/.hermes/config.yaml) configures the
+ * session-level hooks-acceptance policy, and the
+ * `~/.hermes/hooks/` directory exists but is **empty** on the real
+ * installation. Per the JUE-303 honest-stance principle, the `hooks`
+ * mapping is a no-op round-trip; if/when Hermes grows a per-workspace
+ * hook directory convention, this mapping will be reimplemented.
+ */
+export declare function hooks(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/hooks.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hooks = hooks;
+/**
+ * Hermes has no per-workspace `hooks/` directory — the
+ * `hooks_auto_accept` block in the real `config.yaml` (verified
+ * against cwr:/d/devuser/.hermes/config.yaml) configures the
+ * session-level hooks-acceptance policy, and the
+ * `~/.hermes/hooks/` directory exists but is **empty** on the real
+ * installation. Per the JUE-303 honest-stance principle, the `hooks`
+ * mapping is a no-op round-trip; if/when Hermes grows a per-workspace
+ * hook directory convention, this mapping will be reimplemented.
+ */
+function hooks() {
+    return {
+        read: () => undefined,
+        write: () => [],
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/capabilities/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/capabilities/hooks.ts"],"names":[],"mappings":";;AAYA,sBAKC;AAfD;;;;;;;;;GASG;AACH,SAAgB,KAAK;IACnB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/capabilities/layout.d.ts

@@ -0,0 +1,9 @@
+/**
+ * JUE-303 Hermes Adapter supports exactly one native Artifact kind: a
+ * per-workspace directory tree (the global `~/.hermes/` config lives at
+ * the user home and is NOT a project-scoped surface this Adapter
+ * targets). Three-level skills shape (`<workspace>/skills/<cat>/<name>/SKILL.md`)
+ * confirmed by reading the real cwr:/d/devuser/.hermes/skills tree.
+ */
+export type HermesArtifactKind = "workspace";
+export declare function isWorkspaceLayout(root: string): boolean;

package/dist/capabilities/layout.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWorkspaceLayout = isWorkspaceLayout;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function isWorkspaceLayout(root) {
+    return (fs_1.default.existsSync(path_1.default.join(root, "config.yaml")) ||
+        fs_1.default.existsSync(path_1.default.join(root, "skills")) ||
+        fs_1.default.existsSync(path_1.default.join(root, "cron")));
+}
+//# sourceMappingURL=layout.js.map

package/dist/capabilities/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/capabilities/layout.ts"],"names":[],"mappings":";;;;;AAYA,8CAMC;AAlBD,4CAAoB;AACpB,gDAAwB;AAWxB,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,OAAO,CACL,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC7C,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxC,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC"}

package/dist/capabilities/manifest.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactChange } from "ai-jue-core";
+/**
+ * Hermes has no Plugin/Bundle aggregate Artifact kind analogous to
+ * Codex's `marketplace add + plugin add` or Claude's `claude plugin
+ * validate`. Hermes has a `~/.hermes/plugins/` directory on the real
+ * install (verified via SSH) but it holds only `installs.json` (the
+ * installed-plugin registry, not a project-scoped distribution shape).
+ * The JUE-303 honest-stance principle says we don't invent a plugin
+ * manifest for an Agent that doesn't have one.
+ */
+export declare function writeHermesPluginManifest(_root: string, _manifest: Record<string, unknown>, _target: string): ArtifactChange[];

package/dist/capabilities/manifest.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeHermesPluginManifest = writeHermesPluginManifest;
+const path_1 = __importDefault(require("path"));
+/**
+ * Hermes has no Plugin/Bundle aggregate Artifact kind analogous to
+ * Codex's `marketplace add + plugin add` or Claude's `claude plugin
+ * validate`. Hermes has a `~/.hermes/plugins/` directory on the real
+ * install (verified via SSH) but it holds only `installs.json` (the
+ * installed-plugin registry, not a project-scoped distribution shape).
+ * The JUE-303 honest-stance principle says we don't invent a plugin
+ * manifest for an Agent that doesn't have one.
+ */
+function writeHermesPluginManifest(_root, _manifest, _target) {
+    // No-op: Hermes has no project-scoped Plugin/Bundle aggregate.
+    return [];
+}
+// Keep `path` available for future implementations; reserve the symbol.
+void path_1.default;
+//# sourceMappingURL=manifest.js.map

package/dist/capabilities/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/capabilities/manifest.ts"],"names":[],"mappings":";;;;;AAYA,8DAOC;AAnBD,gDAAwB;AAGxB;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CACvC,KAAa,EACb,SAAkC,EAClC,OAAe;IAEf,+DAA+D;IAC/D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,wEAAwE;AACxE,KAAK,cAAI,CAAC"}

package/dist/capabilities/mcp.d.ts

@@ -0,0 +1,15 @@
+import type { CapabilityMapping } from "ai-jue-core";
+export interface CanonicalMcp {
+    servers: Record<string, any>;
+}
+/**
+ * Hermes's only verified MCP surface: the `mcp.servers` key of `config.yaml`
+ * (root of `HERMES_HOME`), e.g. `mcp.servers.chrome-devtools` /
+ * `mcp.servers.minimax` on a live installation. `config.yaml` is YAML, not
+ * JSON, so the shared `mergedJsonFile` factory in `ai-jue-core` (JSON-only)
+ * doesn't fit — this hand-writes the same "deep-merge one key, preserve
+ * everything else in the file" semantics for YAML, reusing
+ * `computeMergedJson` for the merge itself so the policy stays identical to
+ * every JSON-based Capability mapping.
+ */
+export declare function mcp(): CapabilityMapping<CanonicalMcp>;

package/dist/capabilities/mcp.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcp = mcp;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const ai_jue_core_1 = require("ai-jue-core");
+/** Verified against a live `config.yaml`'s `mcp.servers.<name>.env` values, e.g. `${MINIMAX_COMPANY_API_KEY}`. */
+function toCanonicalMcp(native) {
+    for (const [name, server] of Object.entries(native)) {
+        (0, ai_jue_core_1.assertNoLiteralCredentials)(server, `Hermes MCP server "${name}"`);
+    }
+    return { servers: native };
+}
+function toNativeMcp(canonical) {
+    return canonical.servers;
+}
+/**
+ * Hermes's only verified MCP surface: the `mcp.servers` key of `config.yaml`
+ * (root of `HERMES_HOME`), e.g. `mcp.servers.chrome-devtools` /
+ * `mcp.servers.minimax` on a live installation. `config.yaml` is YAML, not
+ * JSON, so the shared `mergedJsonFile` factory in `ai-jue-core` (JSON-only)
+ * doesn't fit — this hand-writes the same "deep-merge one key, preserve
+ * everything else in the file" semantics for YAML, reusing
+ * `computeMergedJson` for the merge itself so the policy stays identical to
+ * every JSON-based Capability mapping.
+ */
+function mcp() {
+    return {
+        read(root) {
+            const filePath = path_1.default.join(root, "config.yaml");
+            if (!fs_1.default.existsSync(filePath))
+                return undefined;
+            const parsed = (yaml.load(fs_1.default.readFileSync(filePath, "utf8")) ?? {});
+            const servers = parsed?.mcp?.servers;
+            if (!servers || typeof servers !== "object")
+                return undefined;
+            return toCanonicalMcp(servers);
+        },
+        write(root, value, target) {
+            const filePath = path_1.default.join(root, "config.yaml");
+            const exists = fs_1.default.existsSync(filePath);
+            const existingRaw = exists ? fs_1.default.readFileSync(filePath, "utf8") : undefined;
+            const existingParsed = existingRaw !== undefined ? (yaml.load(existingRaw) ?? {}) : undefined;
+            const merged = (0, ai_jue_core_1.computeMergedJson)(existingParsed, { mcp: { servers: toNativeMcp(value) } });
+            const finalRaw = yaml.dump(merged, { lineWidth: -1, noRefs: true });
+            if (existingRaw !== undefined && existingRaw.trim() === finalRaw.trim())
+                return [];
+            const change = {
+                target,
+                kind: exists ? "update" : "create",
+                ownership: "merged-keys",
+                scope: "project",
+                path: "config.yaml",
+                beforeHash: exists ? (0, ai_jue_core_1.hashArtifactContent)(existingRaw) : null,
+                afterHash: (0, ai_jue_core_1.hashArtifactContent)(finalRaw),
+                content: finalRaw,
+                risk: "low",
+                requiresApproval: false,
+                atomicState: "planned",
+            };
+            return [change];
+        },
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/capabilities/mcp.js.map

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

package/dist/capabilities/skills.d.ts

@@ -0,0 +1,18 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * `skills/<category>/<name>/SKILL.md` (+ optional `references/*`), verified
+ * against a live Hermes installation's `~/.hermes/skills/` tree — e.g.
+ * `skills/software-development/plan/SKILL.md`,
+ * `skills/software-development/hermes-windows-maintenance/references/*.md`.
+ *
+ * Hermes nests one category directory deeper than Claude Code's flat
+ * `skills/<name>/SKILL.md`, which `ai-jue-core`'s shared `directoryPerItem`
+ * factory does not support (single-level item directories only). Per
+ * `adapter-creator/references/IMPLEMENTATION-patterns.md` #6, a shape that
+ * doesn't fit a shared factory is hand-written rather than forcing the
+ * abstraction or changing the shared engine. The Canonical skill key encodes
+ * the category as `"<category>/<name>"` (a plain string key — Canonical's
+ * `skills` field is `record(string, SkillSchema)`, no slash restriction) so
+ * read/write stay exact inverses without any Canonical schema change.
+ */
+export declare function skills(): CapabilityMapping<Record<string, any>>;

package/dist/capabilities/skills.js

@@ -0,0 +1,192 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skills = skills;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const ai_jue_core_1 = require("ai-jue-core");
+const SAFE_SEGMENT = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+const MAIN_FILE = "SKILL.md";
+/** Only bundle key actually observed on a live installation (e.g. `hermes-windows-maintenance/references/*.md`, `subagent-driven-development/references/*.md`). Unlike Claude's fixtures, no `scripts/`/`assets/` sibling was ever found, so this Adapter does not claim them. */
+const BUNDLE_KEYS = ["references"];
+function assertSafeSegment(kind, value) {
+    if (!SAFE_SEGMENT.test(value)) {
+        throw new Error(`Hermes skill ${kind} must be a safe single path segment: ${value}`);
+    }
+}
+function relativePortablePath(root, absolutePath) {
+    return path_1.default.relative(root, absolutePath).split(path_1.default.sep).join("/");
+}
+function parseFrontmatterFile(filePath) {
+    const raw = fs_1.default.readFileSync(filePath, "utf8");
+    const { frontmatterText, body } = (0, ai_jue_core_1.splitFrontmatter)(raw);
+    const attributes = frontmatterText ? (yaml.load(frontmatterText) ?? {}) : {};
+    return { content: body.trim(), attributes };
+}
+function renderFrontmatterFile(attributes, body) {
+    if (Object.keys(attributes).length === 0)
+        return body;
+    const frontmatterText = yaml.dump(attributes, { lineWidth: -1, noRefs: true }).trim();
+    return `---\n${frontmatterText}\n---\n\n${body.trim()}`;
+}
+function sortedDirEntries(dirPath) {
+    if (!fs_1.default.existsSync(dirPath))
+        return [];
+    return fs_1.default.readdirSync(dirPath, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+}
+function buildTextChange(target, root, absolutePath, newContent) {
+    const exists = fs_1.default.existsSync(absolutePath);
+    const existingContent = exists ? fs_1.default.readFileSync(absolutePath, "utf8") : undefined;
+    if (existingContent === newContent)
+        return null;
+    return {
+        target,
+        kind: exists ? "update" : "create",
+        ownership: "full",
+        scope: "project",
+        path: relativePortablePath(root, absolutePath),
+        beforeHash: exists ? (0, ai_jue_core_1.hashArtifactContent)(existingContent) : null,
+        afterHash: (0, ai_jue_core_1.hashArtifactContent)(newContent),
+        content: newContent,
+        risk: "low",
+        requiresApproval: false,
+        atomicState: "planned",
+    };
+}
+/**
+ * `skills/<category>/<name>/SKILL.md` (+ optional `references/*`), verified
+ * against a live Hermes installation's `~/.hermes/skills/` tree — e.g.
+ * `skills/software-development/plan/SKILL.md`,
+ * `skills/software-development/hermes-windows-maintenance/references/*.md`.
+ *
+ * Hermes nests one category directory deeper than Claude Code's flat
+ * `skills/<name>/SKILL.md`, which `ai-jue-core`'s shared `directoryPerItem`
+ * factory does not support (single-level item directories only). Per
+ * `adapter-creator/references/IMPLEMENTATION-patterns.md` #6, a shape that
+ * doesn't fit a shared factory is hand-written rather than forcing the
+ * abstraction or changing the shared engine. The Canonical skill key encodes
+ * the category as `"<category>/<name>"` (a plain string key — Canonical's
+ * `skills` field is `record(string, SkillSchema)`, no slash restriction) so
+ * read/write stay exact inverses without any Canonical schema change.
+ */
+function skills() {
+    return {
+        read(root) {
+            const skillsDir = path_1.default.join(root, "skills");
+            const result = {};
+            for (const categoryEntry of sortedDirEntries(skillsDir)) {
+                if (!categoryEntry.isDirectory() || categoryEntry.name.startsWith("."))
+                    continue;
+                const categoryDir = path_1.default.join(skillsDir, categoryEntry.name);
+                for (const itemEntry of sortedDirEntries(categoryDir)) {
+                    if (!itemEntry.isDirectory())
+                        continue;
+                    const itemDir = path_1.default.join(categoryDir, itemEntry.name);
+                    const mainFilePath = path_1.default.join(itemDir, MAIN_FILE);
+                    if (!fs_1.default.existsSync(mainFilePath))
+                        continue;
+                    const { content, attributes } = parseFrontmatterFile(mainFilePath);
+                    const entry = { ...attributes, content, prompt: content };
+                    for (const bundleKey of BUNDLE_KEYS) {
+                        const bundleDir = path_1.default.join(itemDir, bundleKey);
+                        const files = {};
+                        for (const fileEntry of sortedDirEntries(bundleDir)) {
+                            if (!fileEntry.isFile())
+                                continue;
+                            files[fileEntry.name] = fs_1.default.readFileSync(path_1.default.join(bundleDir, fileEntry.name), "utf8");
+                        }
+                        if (Object.keys(files).length > 0)
+                            entry[bundleKey] = files;
+                    }
+                    result[`${categoryEntry.name}/${itemEntry.name}`] = entry;
+                }
+            }
+            return Object.keys(result).length > 0 ? result : undefined;
+        },
+        write(root, value, target) {
+            const skillsDir = path_1.default.join(root, "skills");
+            const changes = [];
+            for (const [key, rawEntry] of Object.entries(value)) {
+                const slash = key.indexOf("/");
+                // Canonical's `skills` schema is `record(string, SkillSchema)` with no
+                // format constraint on the key. A flat key (no `/`) is normal, portable
+                // input coming from a shared Preset that other Adapters (Claude/Codex/
+                // OpenClaw all use 1-level `skills/<name>/SKILL.md`) also consume —
+                // throwing here would make any such Preset fail `jue apply --adapter
+                // hermes` outright. Fall back to a default "general" category instead
+                // of rejecting valid Canonical input; a properly-categorized
+                // `"<category>/<name>"` key (Hermes's own native shape) still round-trips
+                // exactly as before.
+                const hasCategory = slash > 0 && slash < key.length - 1;
+                const category = hasCategory ? key.slice(0, slash) : "general";
+                const name = hasCategory ? key.slice(slash + 1) : key;
+                assertSafeSegment("category", category);
+                assertSafeSegment("name", name);
+                const itemDir = path_1.default.join(skillsDir, category, name);
+                const { content, prompt, ...rest } = rawEntry;
+                const bundles = {};
+                for (const bundleKey of BUNDLE_KEYS) {
+                    bundles[bundleKey] = rest[bundleKey];
+                    delete rest[bundleKey];
+                }
+                const body = String(content ?? prompt ?? "").trim();
+                const rendered = renderFrontmatterFile(rest, body);
+                const change = buildTextChange(target, root, path_1.default.join(itemDir, MAIN_FILE), rendered);
+                if (change)
+                    changes.push(change);
+                for (const [bundleKey, files] of Object.entries(bundles)) {
+                    for (const [fileName, fileContent] of Object.entries(files ?? {})) {
+                        // Reference files may be nested (e.g. "nested/guide.md", as
+                        // produced by Claude/Codex/OpenClaw-shaped Presets); reject
+                        // path traversal but otherwise allow subdirectories, matching
+                        // the shared `resolveSupportFilePath` used by the other
+                        // Adapters' `directoryPerItem` factory rather than the
+                        // single-segment restriction this file uses for skill
+                        // category/name.
+                        const bundleChange = buildTextChange(target, root, (0, ai_jue_core_1.resolveSupportFilePath)(path_1.default.join(itemDir, bundleKey), fileName), String(fileContent));
+                        if (bundleChange)
+                            changes.push(bundleChange);
+                    }
+                }
+            }
+            return changes;
+        },
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/capabilities/skills.js.map

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

package/dist/confirm.d.ts

@@ -0,0 +1,27 @@
+import type { ArtifactResult, Confirmation } from "ai-jue-core";
+export interface ConfirmContext {
+    projectRoot: string;
+}
+/**
+ * Hermes v0.18.0 has no per-file validate command analogous to
+ * `claude plugin validate --strict` (Claude) or
+ * `codex plugin marketplace add <local>` (Codex). The strongest native
+ * confirmation path is the real Hermes `tirith` binary
+ * (D:\devuser\.hermes\bin\tirith, 9.8MB), which exposes
+ * `config validate` for the on-disk config tree.
+ *
+ * We invoke `tirith config validate <projectRoot>` against the
+ * freshly-written workspace (Atomically swap the real cwr fixture
+ * into a temp HOME, run validate, swap back — preserves the operator's
+ * real Hermes state in the rare case the user has one on the same
+ * machine, even though in this contract test we use a freshly-built
+ * workspace).
+ *
+ * For project scope (no Plugin/Bundle aggregate to install+verify),
+ * we report `unconfirmed` — there's nothing Hermes offers that
+ * "confirms" a project-scoped workspace beyond `tirith` validating
+ * the config tree; that path is exercised in the
+ * `cwr-real-config` round-trip test (out of in-suite scope per
+ * JUE-301/JUE-302's openclaw-spawnSync quirk discovery).
+ */
+export declare function confirm(_results: ArtifactResult[], context: ConfirmContext): Promise<Confirmation>;

package/dist/confirm.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirm = confirm;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const TARGET = "hermes";
+/**
+ * Hermes v0.18.0 has no per-file validate command analogous to
+ * `claude plugin validate --strict` (Claude) or
+ * `codex plugin marketplace add <local>` (Codex). The strongest native
+ * confirmation path is the real Hermes `tirith` binary
+ * (D:\devuser\.hermes\bin\tirith, 9.8MB), which exposes
+ * `config validate` for the on-disk config tree.
+ *
+ * We invoke `tirith config validate <projectRoot>` against the
+ * freshly-written workspace (Atomically swap the real cwr fixture
+ * into a temp HOME, run validate, swap back — preserves the operator's
+ * real Hermes state in the rare case the user has one on the same
+ * machine, even though in this contract test we use a freshly-built
+ * workspace).
+ *
+ * For project scope (no Plugin/Bundle aggregate to install+verify),
+ * we report `unconfirmed` — there's nothing Hermes offers that
+ * "confirms" a project-scoped workspace beyond `tirith` validating
+ * the config tree; that path is exercised in the
+ * `cwr-real-config` round-trip test (out of in-suite scope per
+ * JUE-301/JUE-302's openclaw-spawnSync quirk discovery).
+ */
+async function confirm(_results, context) {
+    if (!(0, fs_1.existsSync)(context.projectRoot)) {
+        return { target: TARGET, status: "failed", evidence: "projectRoot does not exist" };
+    }
+    // Stage the workspace under a fresh HOME so `tirith config validate`
+    // doesn't pick up the operator's real Hermes state.
+    const tempHome = (0, fs_1.mkdtempSync)(path_1.default.join(os_1.default.tmpdir(), "jue-303-confirm-"));
+    try {
+        // `execFileSync(file, args, options)` — file and args must stay
+        // separate. Concatenating them into one string (as a prior revision
+        // did) makes Node treat the whole string as a literal executable
+        // name and always throw ENOENT, since execFileSync never invokes a
+        // shell to tokenize it.
+        const result = (0, child_process_1.execFileSync)("tirith", ["config", "validate", context.projectRoot], {
+            encoding: "utf8",
+            env: { ...process.env, HOME: tempHome, HERMES_HOME: tempHome },
+            stdio: ["ignore", "pipe", "pipe"],
+            timeout: 10000,
+        });
+        if (/invalid|error|fail/i.test(result)) {
+            return {
+                target: TARGET,
+                status: "failed",
+                evidence: `tirith config validate returned non-clean: ${result.slice(0, 500)}`,
+            };
+        }
+        return {
+            target: TARGET,
+            status: "confirmed",
+            evidence: `tirith config validate ran cleanly against ${context.projectRoot}: ${result.slice(0, 200)}`,
+        };
+    }
+    catch (error) {
+        const stderr = error && typeof error === "object" && "stderr" in error
+            ? String(error.stderr)
+            : "";
+        const stdout = error && typeof error === "object" && "stdout" in error
+            ? String(error.stdout)
+            : "";
+        return {
+            target: TARGET,
+            status: "failed",
+            evidence: `tirith config validate failed: exit=${error.status} stdout=${stdout.slice(0, 300)} stderr=${stderr.slice(0, 300)}`,
+        };
+    }
+    finally {
+        (0, fs_1.rmSync)(tempHome, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=confirm.js.map

package/dist/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../src/confirm.ts"],"names":[],"mappings":";;;;;AAkCA,0BAiDC;AAnFD,iDAA6C;AAC7C,2BAAqD;AACrD,4CAAoB;AACpB,gDAAwB;AAOxB,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,OAAO,CAC3B,QAA0B,EAC1B,OAAuB;IAEvB,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,4BAA4B,EAAE,CAAC;IACtF,CAAC;IACD,qEAAqE;IACrE,oDAAoD;IACpD,MAAM,QAAQ,GAAG,IAAA,gBAAW,EAAC,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,gEAAgE;QAChE,oEAAoE;QACpE,iEAAiE;QACjE,mEAAmE;QACnE,wBAAwB;QACxB,MAAM,MAAM,GAAG,IAAA,4BAAY,EAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE;YACjF,QAAQ,EAAE,MAAM;YAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;YAC9D,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,OAAO,EAAE,KAAM;SAChB,CAAC,CAAC;QACH,IAAI,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,8CAA8C,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;aAC/E,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,8CAA8C,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;SACvG,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK;YACpE,CAAC,CAAC,MAAM,CAAE,KAA6B,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK;YACpE,CAAC,CAAC,MAAM,CAAE,KAA6B,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,uCAAwC,KAA6B,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;SACvJ,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAA,WAAM,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { read } from "./read";
+export type { ReadContext } from "./read";
+export { write } from "./write";
+export type { WriteContext } from "./write";
+export { confirm } from "./confirm";
+export type { ConfirmContext } from "./confirm";
+/**
+ * `jue apply`'s Hermes entry point: thin wrapper, parallel to Claude
+ * and Codex. Kept for the legacy `jue apply --all` path while the
+ * canonical JUE-103 contract is the `Adapter` default export below.
+ */
+export declare function generate(config: any, outputDir: string): Promise<void>;
+declare const _default: import("ai-jue-core").ExtensionDefinition;
+export default _default;

package/dist/index.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirm = exports.write = exports.read = void 0;
+exports.generate = generate;
+const ai_jue_core_1 = require("ai-jue-core");
+const confirm_1 = require("./confirm");
+const read_1 = require("./read");
+const write_1 = require("./write");
+var read_2 = require("./read");
+Object.defineProperty(exports, "read", { enumerable: true, get: function () { return read_2.read; } });
+var write_2 = require("./write");
+Object.defineProperty(exports, "write", { enumerable: true, get: function () { return write_2.write; } });
+var confirm_2 = require("./confirm");
+Object.defineProperty(exports, "confirm", { enumerable: true, get: function () { return confirm_2.confirm; } });
+/**
+ * `jue apply`'s Hermes entry point: thin wrapper, parallel to Claude
+ * and Codex. Kept for the legacy `jue apply --all` path while the
+ * canonical JUE-103 contract is the `Adapter` default export below.
+ */
+async function generate(config, outputDir) {
+    const canonical = (0, ai_jue_core_1.toCanonicalDocument)(config);
+    const changes = await (0, write_1.write)(canonical, { projectRoot: outputDir });
+    (0, ai_jue_core_1.applyChangesOrThrow)(outputDir, changes);
+}
+const hermesAdapter = {
+    id: "hermes",
+    capabilities: {
+        // `rules` → Hermes has no separate rules directory (uses config.yaml's
+        // prefill_messages_file + toolsets instead); honestly `unsupported`.
+        rules: "unsupported",
+        // `commands` → Hermes has no per-workspace commands directory (the
+        // `commands:` block in config.yaml is runtime policy, not user-
+        // authored slash-commands); honestly `degraded` (no-op round-trip).
+        commands: "degraded",
+        // `skills` → real, 3-level skills/<cat>/<name>/SKILL.md shape;
+        // supported via hand-written mapping.
+        skills: "supported",
+        // `agents` → no per-workspace agents directory; `agent:` block in
+        // config.yaml is global; honestly `degraded`.
+        agents: "degraded",
+        // `hooks` → ~/.hermes/hooks/ is empty on the real install; the
+        // `hooks_auto_accept:` block in config.yaml is session-level
+        // policy. Honestly `unsupported`.
+        hooks: "unsupported",
+        // `mcp` → real `mcp.servers` block in config.yaml; supported
+        // (hand-written YAML-aware mapping reusing computeMergedJson).
+        mcp: "supported",
+    },
+    read: read_1.read,
+    write: write_1.write,
+    confirm: confirm_1.confirm,
+};
+exports.default = (0, ai_jue_core_1.defineExtension)({ adapters: [hermesAdapter] });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAkBA,4BAIC;AAtBD,6CAAwF;AAExF,uCAAoC;AACpC,iCAA8B;AAC9B,mCAAgC;AAEhC,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAEb,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAGhB;;;;GAIG;AACI,KAAK,UAAU,QAAQ,CAAC,MAAW,EAAE,SAAiB;IAC3D,MAAM,SAAS,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,IAAA,aAAK,EAAC,SAAS,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,IAAA,iCAAmB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,aAAa,GAAY;IAC7B,EAAE,EAAE,QAAQ;IACZ,YAAY,EAAE;QACZ,uEAAuE;QACvE,qEAAqE;QACrE,KAAK,EAAE,aAAa;QACpB,mEAAmE;QACnE,gEAAgE;QAChE,oEAAoE;QACpE,QAAQ,EAAE,UAAU;QACpB,+DAA+D;QAC/D,sCAAsC;QACtC,MAAM,EAAE,WAAW;QACnB,kEAAkE;QAClE,8CAA8C;QAC9C,MAAM,EAAE,UAAU;QAClB,+DAA+D;QAC/D,6DAA6D;QAC7D,kCAAkC;QAClC,KAAK,EAAE,aAAa;QACpB,6DAA6D;QAC7D,+DAA+D;QAC/D,GAAG,EAAE,WAAW;KACjB;IACD,IAAI,EAAJ,WAAI;IACJ,KAAK,EAAL,aAAK;IACL,OAAO,EAAP,iBAAO;CACR,CAAC;AAEF,kBAAe,IAAA,6BAAe,EAAC,EAAE,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC"}

package/dist/read.d.ts

@@ -0,0 +1,17 @@
+import type { CanonicalDocument } from "ai-jue-core";
+export interface ReadContext {
+    projectRoot: string;
+}
+/**
+ * Hermes Adapter's read: thin composition over a small subset of the
+ * real `cwr:/d/devuser/.hermes` surface — per the JUE-303 honest-stance
+ * principle, only the surfaces we have ground-truth evidence for:
+ *   - `context.global`  ← workspace-root `MEMORY.md`
+ *   - `hooks`            ← empty no-op (the real ~/.hermes/hooks/ is empty)
+ *   - `mcp`              ← config.yaml's `mcp.servers` block
+ *   - `commands`         ← no-op (Hermes has no per-workspace commands/)
+ *   - `agents`           ← no-op (the single-agent runtime reads config.yaml)
+ *   - `skills`           ← `skills/<cat>/<name>/SKILL.md` (3-level shape)
+ *   - `cron`             ← `cron/jobs.json` (full-file pass-through)
+ */
+export declare function read({ projectRoot }: ReadContext): Promise<CanonicalDocument>;

package/dist/read.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.read = read;
+const ai_jue_core_1 = require("ai-jue-core");
+const context_1 = require("./capabilities/context");
+const cron_1 = require("./capabilities/cron");
+const mcp_1 = require("./capabilities/mcp");
+const skills_1 = require("./capabilities/skills");
+/**
+ * Hermes Adapter's read: thin composition over a small subset of the
+ * real `cwr:/d/devuser/.hermes` surface — per the JUE-303 honest-stance
+ * principle, only the surfaces we have ground-truth evidence for:
+ *   - `context.global`  ← workspace-root `MEMORY.md`
+ *   - `hooks`            ← empty no-op (the real ~/.hermes/hooks/ is empty)
+ *   - `mcp`              ← config.yaml's `mcp.servers` block
+ *   - `commands`         ← no-op (Hermes has no per-workspace commands/)
+ *   - `agents`           ← no-op (the single-agent runtime reads config.yaml)
+ *   - `skills`           ← `skills/<cat>/<name>/SKILL.md` (3-level shape)
+ *   - `cron`             ← `cron/jobs.json` (full-file pass-through)
+ */
+async function read({ projectRoot }) {
+    const canonical = (0, ai_jue_core_1.readCapabilities)({
+        context: (0, context_1.context)(),
+        hooks: { read: () => undefined, write: () => [] },
+        commands: { read: () => undefined, write: () => [] },
+        agents: { read: () => undefined, write: () => [] },
+        mcp: (0, mcp_1.mcp)(),
+        skills: (0, skills_1.skills)(),
+        cron: (0, cron_1.cron)(),
+    }, projectRoot);
+    return (0, ai_jue_core_1.toCanonicalDocument)(canonical);
+}
+//# sourceMappingURL=read.js.map

package/dist/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":";;AAuBA,oBAcC;AArCD,6CAAoE;AAEpE,oDAAiD;AACjD,8CAA2C;AAC3C,4CAAyC;AACzC,kDAA+C;AAM/C;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,IAAI,CAAC,EAAE,WAAW,EAAe;IACrD,MAAM,SAAS,GAAG,IAAA,8BAAgB,EAChC;QACE,OAAO,EAAE,IAAA,iBAAO,GAAE;QAClB,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACjD,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACpD,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QAClD,GAAG,EAAE,IAAA,SAAG,GAAE;QACV,MAAM,EAAE,IAAA,eAAM,GAAE;QAChB,IAAI,EAAE,IAAA,WAAI,GAAE;KACb,EACD,WAAW,CACZ,CAAC;IACF,OAAO,IAAA,iCAAmB,EAAC,SAA+C,CAAC,CAAC;AAC9E,CAAC"}

package/dist/write.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactChange, CanonicalDocument } from "ai-jue-core";
+export interface WriteContext {
+    projectRoot: string;
+}
+/**
+ * Hermes Adapter's write: thin composition; routes through
+ * `core-executor.ts` `applyChangesOrThrow` (no bespoke apply/rollback
+ * mechanism — Core executes `ArtifactChange` per the JUE-103 contract).
+ * Same honest-stance map as read.
+ */
+export declare function write(canonical: CanonicalDocument, writeContext: WriteContext): Promise<ArtifactChange[]>;

package/dist/write.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.write = write;
+const ai_jue_core_1 = require("ai-jue-core");
+const context_1 = require("./capabilities/context");
+const cron_1 = require("./capabilities/cron");
+const mcp_1 = require("./capabilities/mcp");
+const skills_1 = require("./capabilities/skills");
+const TARGET = "hermes";
+/**
+ * Hermes Adapter's write: thin composition; routes through
+ * `core-executor.ts` `applyChangesOrThrow` (no bespoke apply/rollback
+ * mechanism — Core executes `ArtifactChange` per the JUE-103 contract).
+ * Same honest-stance map as read.
+ */
+async function write(canonical, writeContext) {
+    const result = (0, ai_jue_core_1.writeCapabilities)({
+        hooks: { read: () => undefined, write: () => [] },
+        commands: { read: () => undefined, write: () => [] },
+        agents: { read: () => undefined, write: () => [] },
+        mcp: (0, mcp_1.mcp)(),
+        skills: (0, skills_1.skills)(),
+        cron: (0, cron_1.cron)(),
+    }, canonical, writeContext.projectRoot, TARGET);
+    if (canonical.context?.global) {
+        result.push(...(0, context_1.context)().write(writeContext.projectRoot, { global: canonical.context.global ?? "" }, TARGET));
+    }
+    return result;
+}
+//# sourceMappingURL=write.js.map

package/dist/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":";;AAmBA,sBA6BC;AAhDD,6CAAgD;AAEhD,oDAAiD;AACjD,8CAA2C;AAC3C,4CAAyC;AACzC,kDAA+C;AAM/C,MAAM,MAAM,GAAG,QAAQ,CAAC;AAExB;;;;;GAKG;AACI,KAAK,UAAU,KAAK,CACzB,SAA4B,EAC5B,YAA0B;IAE1B,MAAM,MAAM,GAAG,IAAA,+BAAiB,EAC9B;QACE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACjD,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACpD,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QAClD,GAAG,EAAE,IAAA,SAAG,GAAE;QACV,MAAM,EAAE,IAAA,eAAM,GAAE;QAChB,IAAI,EAAE,IAAA,WAAI,GAAE;KACb,EACD,SAA+C,EAC/C,YAAY,CAAC,WAAW,EACxB,MAAM,CACP,CAAC;IAEF,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,GAAG,IAAA,iBAAO,GAAE,CAAC,KAAK,CAChB,YAAY,CAAC,WAAW,EACxB,EAAE,MAAM,EAAG,SAAS,CAAC,OAA+B,CAAC,MAAM,IAAI,EAAE,EAAE,EACnE,MAAM,CACP,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "ai-jue-adapter-hermes",
+  "version": "0.2.0",
+  "description": "Adapter for generating Hermes configurations.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "ai-jue-core": "*",
+    "js-yaml": "^4.1.0"
+  },
+  "peerDependencies": {
+    "ai-jue-core": "*"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "typescript": "^5.0.0"
+  },
+  "author": "AI-Jue Team <contact@ai-jue.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zenHeart/ai-jue.git",
+    "directory": "packages/ai-jue-adapter-hermes"
+  },
+  "bugs": {
+    "url": "https://github.com/zenHeart/ai-jue/issues"
+  },
+  "homepage": "https://github.com/zenHeart/ai-jue/tree/main/packages/ai-jue-adapter-hermes#readme",
+  "files": [
+    "dist"
+  ]
+}