agent-first-data 0.13.2 → 0.14.0

package/README.md

@@ -41,7 +41,7 @@ initJson({ secretNames: ["authorization"] });
 
 ## Reference
 
-- Full convention and API groups: [../docs/overview.md](../docs/overview.md)
-- Formal cross-language contract: [../spec/agent-first-data.md](../spec/agent-first-data.md)
-- Conformance fixtures: [../spec/fixtures](../spec/fixtures)
-- Agent skill: [../skills/agent-first-data.md](../skills/agent-first-data.md)
+- Full convention and API groups: [docs/overview.md](https://github.com/agentfirstkit/agent-first-data/blob/main/docs/overview.md)
+- Formal cross-language contract: [spec/agent-first-data.md](https://github.com/agentfirstkit/agent-first-data/blob/main/spec/agent-first-data.md)
+- Conformance fixtures: [spec/fixtures](https://github.com/agentfirstkit/agent-first-data/tree/main/spec/fixtures)
+- Agent skill: [skills/agent-first-data.md](https://github.com/agentfirstkit/agent-first-data/blob/main/skills/agent-first-data.md)

package/dist/skill.d.ts

@@ -3,7 +3,7 @@
  *
  * A spore that embeds its `SKILL.md` describes itself with a {@link SkillSpec} and calls
  * {@link runSkillAdmin} to install, uninstall, or report status of that skill across
- * supported coding agents (Codex, Claude Code, opencode).
+ * supported coding agents (Codex, Claude Code, opencode, Hermes).
  *
  * The function performs the filesystem work and returns the protocol value (rendered by
  * the caller with `cliOutput`) or throws a {@link SkillError}. It never writes to
@@ -26,11 +26,11 @@ export interface SkillSpec {
 /** The skill action to perform. */
 export type SkillAction = "status" | "install" | "uninstall";
 /** Where to install the skill. */
-export type SkillScope = "personal" | "project";
+export type SkillScope = "personal" | "workspace";
 /** Which agent target(s) to manage. */
-export type SkillAgentSelection = "all" | "codex" | "claude-code" | "opencode";
+export type SkillAgentSelection = "all" | "codex" | "claude-code" | "opencode" | "hermes";
 /** A concrete agent a skill is installed for (no `all`). */
-export type SkillAgent = "codex" | "claude-code" | "opencode";
+export type SkillAgent = "codex" | "claude-code" | "opencode" | "hermes";
 /** Options shared by every skill action. */
 export interface SkillOptions {
     agent: SkillAgentSelection;

package/dist/skill.js

@@ -3,7 +3,7 @@
  *
  * A spore that embeds its `SKILL.md` describes itself with a {@link SkillSpec} and calls
  * {@link runSkillAdmin} to install, uninstall, or report status of that skill across
- * supported coding agents (Codex, Claude Code, opencode).
+ * supported coding agents (Codex, Claude Code, opencode, Hermes).
  *
  * The function performs the filesystem work and returns the protocol value (rendered by
  * the caller with `cliOutput`) or throws a {@link SkillError}. It never writes to
@@ -128,20 +128,19 @@ function resolveTargets(spec, options) {
             resolveTarget(spec, "codex", "personal", undefined),
             resolveTarget(spec, "claude-code", "personal", undefined),
             resolveTarget(spec, "opencode", "personal", undefined),
+            resolveTarget(spec, "hermes", "personal", undefined),
         ];
     }
-    // Codex has no project scope, so --agent all --scope project skips it.
-    if (agent === "all" && scope === "project") {
+    if (agent === "all" && scope === "workspace") {
         return [
-            resolveTarget(spec, "claude-code", "project", undefined),
-            resolveTarget(spec, "opencode", "project", undefined),
+            resolveTarget(spec, "codex", "workspace", undefined),
+            resolveTarget(spec, "claude-code", "workspace", undefined),
+            resolveTarget(spec, "opencode", "workspace", undefined),
+            resolveTarget(spec, "hermes", "workspace", undefined),
         ];
     }
-    if (agent === "codex" && scope === "project") {
-        throw new SkillError("Codex project skill scope is not supported", "use personal scope for Codex, or --agent claude-code/opencode --scope project");
-    }
     if (agent === "codex") {
-        return [resolveTarget(spec, "codex", "personal", options.skillsDir)];
+        return [resolveTarget(spec, "codex", scope, options.skillsDir)];
     }
     if (agent === "claude-code") {
         return [resolveTarget(spec, "claude-code", scope, options.skillsDir)];
@@ -149,6 +148,9 @@ function resolveTargets(spec, options) {
     if (agent === "opencode") {
         return [resolveTarget(spec, "opencode", scope, options.skillsDir)];
     }
+    if (agent === "hermes") {
+        return [resolveTarget(spec, "hermes", scope, options.skillsDir)];
+    }
     throw new SkillError(`invalid --agent '${agent}'`);
 }
 function resolveTarget(spec, agent, scope, skillsDir) {
@@ -164,8 +166,8 @@ function resolveTarget(spec, agent, scope, skillsDir) {
 }
 function defaultSkillsDir(agent, scope) {
     if (agent === "codex") {
-        if (scope === "project") {
-            throw new SkillError("Codex project skill scope is not supported");
+        if (scope !== "personal") {
+            return join(process.cwd(), ".codex", "skills");
         }
         const codexHome = process.env["CODEX_HOME"];
         if (codexHome !== undefined) {
@@ -174,20 +176,30 @@ function defaultSkillsDir(agent, scope) {
         return join(homeDir(), ".codex", "skills");
     }
     if (agent === "claude-code") {
-        if (scope === "project") {
+        if (scope !== "personal") {
             return join(process.cwd(), ".claude", "skills");
         }
         return join(homeDir(), ".claude", "skills");
     }
-    // opencode
-    if (scope === "project") {
-        return join(process.cwd(), ".opencode", "skills");
+    if (agent === "opencode") {
+        if (scope !== "personal") {
+            return join(process.cwd(), ".opencode", "skills");
+        }
+        const xdg = process.env["XDG_CONFIG_HOME"];
+        if (xdg !== undefined) {
+            return join(xdg, "opencode", "skills");
+        }
+        return join(homeDir(), ".config", "opencode", "skills");
+    }
+    // hermes
+    if (scope !== "personal") {
+        return join(process.cwd(), ".hermes", "skills");
     }
-    const xdg = process.env["XDG_CONFIG_HOME"];
-    if (xdg !== undefined) {
-        return join(xdg, "opencode", "skills");
+    const hermesHome = process.env["HERMES_HOME"];
+    if (hermesHome !== undefined) {
+        return join(hermesHome, "skills");
     }
-    return join(homeDir(), ".config", "opencode", "skills");
+    return join(homeDir(), ".hermes", "skills");
 }
 function targetStatus(spec, target) {
     const st = lstatOrNull(target.skillPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-first-data",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "description": "A naming convention that lets AI agents understand your data without being told what it means.",
   "license": "MIT",
   "repository": {