agent-first-data 0.13.2__tar.gz → 0.14.0__tar.gz

{agent_first_data-0.13.2 → agent_first_data-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.13.2
+Version: 0.14.0
 Summary: A naming convention that lets AI agents understand your data without being told what it means.
 License-Expression: MIT
 Project-URL: Repository, https://github.com/agentfirstkit/agent-first-data
@@ -50,7 +50,7 @@ init_logging_json("INFO", secret_names=("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)

{agent_first_data-0.13.2 → agent_first_data-0.14.0}/README.md

@@ -41,7 +41,7 @@ init_logging_json("INFO", secret_names=("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)

{agent_first_data-0.13.2 → agent_first_data-0.14.0}/agent_first_data/skill.py

@@ -2,7 +2,7 @@
 
 A spore that embeds its ``SKILL.md`` describes itself with a :class:`SkillSpec` and
 calls :func:`run_skill_admin` to install, uninstall, or report status of that skill
-across supported coding agents (Codex, Claude Code, opencode).
+across supported coding agents (Codex, Claude Code, opencode, Hermes).
 
 The function performs the filesystem work and returns the protocol ``dict`` (rendered
 by the caller with ``cli_output``) or raises :class:`SkillError`. It never writes to
@@ -52,7 +52,7 @@ class SkillScope(enum.Enum):
     """Where to install the skill."""
 
     PERSONAL = "personal"
-    PROJECT = "project"
+    WORKSPACE = "workspace"
 
 
 class SkillAgentSelection(enum.Enum):
@@ -62,6 +62,7 @@ class SkillAgentSelection(enum.Enum):
     CODEX = "codex"
     CLAUDE_CODE = "claude-code"
     OPENCODE = "opencode"
+    HERMES = "hermes"
 
 
 class SkillAgent(enum.Enum):
@@ -70,6 +71,7 @@ class SkillAgent(enum.Enum):
     CODEX = "codex"
     CLAUDE_CODE = "claude-code"
     OPENCODE = "opencode"
+    HERMES = "hermes"
 
 
 @dataclass
@@ -310,24 +312,23 @@ def _resolve_targets(spec: SkillSpec, options: SkillOptions) -> list[_SkillTarge
             _resolve_target(spec, SkillAgent.CODEX, SkillScope.PERSONAL, None),
             _resolve_target(spec, SkillAgent.CLAUDE_CODE, SkillScope.PERSONAL, None),
             _resolve_target(spec, SkillAgent.OPENCODE, SkillScope.PERSONAL, None),
+            _resolve_target(spec, SkillAgent.HERMES, SkillScope.PERSONAL, None),
         ]
-    # Codex has no project scope, so --agent all --scope project skips it.
-    if agent is SkillAgentSelection.ALL and scope is SkillScope.PROJECT:
+    if agent is SkillAgentSelection.ALL and scope is SkillScope.WORKSPACE:
         return [
-            _resolve_target(spec, SkillAgent.CLAUDE_CODE, SkillScope.PROJECT, None),
-            _resolve_target(spec, SkillAgent.OPENCODE, SkillScope.PROJECT, None),
+            _resolve_target(spec, SkillAgent.CODEX, SkillScope.WORKSPACE, None),
+            _resolve_target(spec, SkillAgent.CLAUDE_CODE, SkillScope.WORKSPACE, None),
+            _resolve_target(spec, SkillAgent.OPENCODE, SkillScope.WORKSPACE, None),
+            _resolve_target(spec, SkillAgent.HERMES, SkillScope.WORKSPACE, None),
         ]
-    if agent is SkillAgentSelection.CODEX and scope is SkillScope.PROJECT:
-        raise SkillError(
-            "Codex project skill scope is not supported",
-            "use personal scope for Codex, or --agent claude-code/opencode --scope project",
-        )
     if agent is SkillAgentSelection.CODEX:
-        return [_resolve_target(spec, SkillAgent.CODEX, SkillScope.PERSONAL, options.skills_dir)]
+        return [_resolve_target(spec, SkillAgent.CODEX, scope, options.skills_dir)]
     if agent is SkillAgentSelection.CLAUDE_CODE:
         return [_resolve_target(spec, SkillAgent.CLAUDE_CODE, scope, options.skills_dir)]
     if agent is SkillAgentSelection.OPENCODE:
         return [_resolve_target(spec, SkillAgent.OPENCODE, scope, options.skills_dir)]
+    if agent is SkillAgentSelection.HERMES:
+        return [_resolve_target(spec, SkillAgent.HERMES, scope, options.skills_dir)]
     raise SkillError(f"invalid --agent {agent!r}")
 
 
@@ -350,23 +351,30 @@ def _resolve_target(
 
 def _default_skills_dir(agent: SkillAgent, scope: SkillScope) -> Path:
     if agent is SkillAgent.CODEX:
-        if scope is SkillScope.PROJECT:
-            raise SkillError("Codex project skill scope is not supported")
+        if scope is not SkillScope.PERSONAL:
+            return Path.cwd() / ".codex" / "skills"
         codex_home = os.environ.get("CODEX_HOME")
         if codex_home is not None:
             return Path(codex_home) / "skills"
         return _home_dir() / ".codex" / "skills"
     if agent is SkillAgent.CLAUDE_CODE:
-        if scope is SkillScope.PROJECT:
+        if scope is not SkillScope.PERSONAL:
             return Path.cwd() / ".claude" / "skills"
         return _home_dir() / ".claude" / "skills"
     if agent is SkillAgent.OPENCODE:
-        if scope is SkillScope.PROJECT:
+        if scope is not SkillScope.PERSONAL:
             return Path.cwd() / ".opencode" / "skills"
         xdg = os.environ.get("XDG_CONFIG_HOME")
         if xdg is not None:
             return Path(xdg) / "opencode" / "skills"
         return _home_dir() / ".config" / "opencode" / "skills"
+    if agent is SkillAgent.HERMES:
+        if scope is not SkillScope.PERSONAL:
+            return Path.cwd() / ".hermes" / "skills"
+        hermes_home = os.environ.get("HERMES_HOME")
+        if hermes_home is not None:
+            return Path(hermes_home) / "skills"
+        return _home_dir() / ".hermes" / "skills"
     raise SkillError(f"unknown agent {agent!r}")
 
 

{agent_first_data-0.13.2 → agent_first_data-0.14.0}/agent_first_data.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.13.2
+Version: 0.14.0
 Summary: A naming convention that lets AI agents understand your data without being told what it means.
 License-Expression: MIT
 Project-URL: Repository, https://github.com/agentfirstkit/agent-first-data
@@ -50,7 +50,7 @@ init_logging_json("INFO", secret_names=("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)

{agent_first_data-0.13.2 → agent_first_data-0.14.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 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"
 readme = "README.md"

{agent_first_data-0.13.2 → agent_first_data-0.14.0}/tests/test_skill.py

@@ -62,6 +62,7 @@ def test_rejects_unquoted_colon_space():
         (SkillAgentSelection.CODEX, "codex"),
         (SkillAgentSelection.CLAUDE_CODE, "claude-code"),
         (SkillAgentSelection.OPENCODE, "opencode"),
+        (SkillAgentSelection.HERMES, "hermes"),
     ],
 )
 def test_install_status_uninstall(agent, expect, tmp_path):
@@ -218,22 +219,48 @@ def test_force_uninstall_removes_symlink_without_following(tmp_path):
     assert external.read_text(encoding="utf-8") == "external"
 
 
-def test_all_personal_resolves_three_targets():
+def test_all_personal_resolves_four_targets():
     opts = SkillOptions(agent=SkillAgentSelection.ALL, scope=SkillScope.PERSONAL)
     targets = _resolve_targets(spec(), opts)
-    assert [t.agent for t in targets] == [SkillAgent.CODEX, SkillAgent.CLAUDE_CODE, SkillAgent.OPENCODE]
+    assert [t.agent for t in targets] == [
+        SkillAgent.CODEX,
+        SkillAgent.CLAUDE_CODE,
+        SkillAgent.OPENCODE,
+        SkillAgent.HERMES,
+    ]
 
 
-def test_all_project_skips_codex():
-    opts = SkillOptions(agent=SkillAgentSelection.ALL, scope=SkillScope.PROJECT)
+def test_all_workspace_resolves_four_targets():
+    opts = SkillOptions(agent=SkillAgentSelection.ALL, scope=SkillScope.WORKSPACE)
     targets = _resolve_targets(spec(), opts)
-    assert [t.agent for t in targets] == [SkillAgent.CLAUDE_CODE, SkillAgent.OPENCODE]
+    assert [t.agent for t in targets] == [
+        SkillAgent.CODEX,
+        SkillAgent.CLAUDE_CODE,
+        SkillAgent.OPENCODE,
+        SkillAgent.HERMES,
+    ]
+    assert [t.scope for t in targets] == [
+        SkillScope.WORKSPACE,
+        SkillScope.WORKSPACE,
+        SkillScope.WORKSPACE,
+        SkillScope.WORKSPACE,
+    ]
+
+
+def test_codex_workspace_scope_uses_codex_skills_dir():
+    opts = SkillOptions(agent=SkillAgentSelection.CODEX, scope=SkillScope.WORKSPACE)
+    targets = _resolve_targets(spec(), opts)
+    assert [t.agent for t in targets] == [SkillAgent.CODEX]
+    assert targets[0].scope is SkillScope.WORKSPACE
+    assert str(targets[0].skills_dir).endswith(".codex/skills")
 
 
-def test_codex_project_scope_rejected():
-    opts = SkillOptions(agent=SkillAgentSelection.CODEX, scope=SkillScope.PROJECT)
-    with pytest.raises(SkillError):
-        _resolve_targets(spec(), opts)
+def test_hermes_workspace_scope_uses_hermes_skills_dir():
+    opts = SkillOptions(agent=SkillAgentSelection.HERMES, scope=SkillScope.WORKSPACE)
+    targets = _resolve_targets(spec(), opts)
+    assert [t.agent for t in targets] == [SkillAgent.HERMES]
+    assert targets[0].scope is SkillScope.WORKSPACE
+    assert str(targets[0].skills_dir).endswith(".hermes/skills")
 
 
 def test_skills_dir_requires_single_agent():