agentharnesses-cli 0.1.0__tar.gz → 0.1.3__tar.gz

{agentharnesses_cli-0.1.0 → agentharnesses_cli-0.1.3}/.github/workflows/pypi.yaml

@@ -1,21 +1,24 @@
 name: Publish to PyPI
 
 on:
-  release:
-    types: [published]
+  push:
+    tags:
+      - 'v*'
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
 
       - name: Install hatch
-        run: pip install hatch
+        run: pip install hatch hatch-vcs
 
       - name: Build
         run: hatch build

agentharnesses_cli-0.1.3/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: agentharnesses-cli
+Version: 0.1.3
+Summary: CLI tools for agentharnesses.io
+Project-URL: Homepage, https://agentharnesses.io
+Project-URL: Repository, https://github.com/agentharnesses/cli
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Description-Content-Type: text/markdown
+
+# agentharnesses-cli
+
+CLI for [agentharnesses.io](https://agentharnesses.io) — scaffold and manage Agent Harnesses.
+
+## Installation
+
+```bash
+pip install agentharnesses-cli
+```
+
+## Usage
+
+```bash
+ahar --help
+```
+
+### `ahar init`
+
+Initialize a new harness in the current directory:
+
+```bash
+ahar init
+```
+
+Optionally specify a name (defaults to the directory name):
+
+```bash
+ahar init my-harness
+```
+
+Scaffolds the following structure:
+
+```
+my-harness/
+├── HARNESS.md                       # entry point and agent identity
+├── README.md                        # human-facing description
+├── .gitignore
+├── .claude/settings.json            # registers the harness as a Claude Code plugin
+├── skills/
+│   └── SKILLS.md                    # skill index
+└── references/
+    └── REFERENCES.md                # reference index
+```
+
+When using the `claude` preset (default), also installs:
+
+```
+├── .claude/skills/agent-harnesses/  # metaskill for progressive harness exploration
+└── skills/
+    └── maintenance/
+        ├── SKILLS.md
+        └── modify-harness/
+            └── SKILL.md
+```
+
+## Publishing
+
+Releases are published to PyPI automatically when a version tag is pushed:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+The GitHub Actions workflow builds the package and publishes it via trusted publishing (no API token required). The version is derived from the tag via `hatch-vcs`.
+
+## License
+
+Apache 2.0

agentharnesses_cli-0.1.3/README.md

@@ -0,0 +1,69 @@
+# agentharnesses-cli
+
+CLI for [agentharnesses.io](https://agentharnesses.io) — scaffold and manage Agent Harnesses.
+
+## Installation
+
+```bash
+pip install agentharnesses-cli
+```
+
+## Usage
+
+```bash
+ahar --help
+```
+
+### `ahar init`
+
+Initialize a new harness in the current directory:
+
+```bash
+ahar init
+```
+
+Optionally specify a name (defaults to the directory name):
+
+```bash
+ahar init my-harness
+```
+
+Scaffolds the following structure:
+
+```
+my-harness/
+├── HARNESS.md                       # entry point and agent identity
+├── README.md                        # human-facing description
+├── .gitignore
+├── .claude/settings.json            # registers the harness as a Claude Code plugin
+├── skills/
+│   └── SKILLS.md                    # skill index
+└── references/
+    └── REFERENCES.md                # reference index
+```
+
+When using the `claude` preset (default), also installs:
+
+```
+├── .claude/skills/agent-harnesses/  # metaskill for progressive harness exploration
+└── skills/
+    └── maintenance/
+        ├── SKILLS.md
+        └── modify-harness/
+            └── SKILL.md
+```
+
+## Publishing
+
+Releases are published to PyPI automatically when a version tag is pushed:
+
+```bash
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+The GitHub Actions workflow builds the package and publishes it via trusted publishing (no API token required). The version is derived from the tag via `hatch-vcs`.
+
+## License
+
+Apache 2.0

{agentharnesses_cli-0.1.0 → agentharnesses_cli-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentharnesses-cli"
-version = "0.1.0"
+dynamic = ["version"]
 description = "CLI tools for agentharnesses.io"
 license = "Apache-2.0"
 readme = "README.md"
@@ -17,8 +17,11 @@ Repository = "https://github.com/agentharnesses/cli"
 ahar = "ahar.main:cli"
 
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
+[tool.hatch.version]
+source = "vcs"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/ahar"]

{agentharnesses_cli-0.1.0 → agentharnesses_cli-0.1.3}/src/ahar/commands/init.py

@@ -1,43 +1,50 @@
 import os
+import shutil
 import subprocess
 import sys
+import tempfile
 import click
 
-_METASKILL_REPO = "https://github.com/agentharnesses/metaskill"  # TODO: replace with final URL
-_METASKILL_DEST = ".claude/plugins/metaskill"
-_MAINTAIN_SKILL_DEST = ".claude/skills/maintain-harness.md"
+_METASKILL_REPO = "https://github.com/agentharnesses/metaskill"
+_METASKILL_DEST = ".claude/skills/agent-harnesses"
+
+_MAINTAIN_SKILL_DEST = "skills/maintenance/modify-harness/SKILL.md"
+_MAINTAIN_SKILLS_INDEX_DEST = "skills/maintenance/SKILLS.md"
 
 _MAINTAIN_SKILL = """\
 ---
-name: maintain-harness
-description: How to maintain and update this harness — updating HARNESS.md, adding skills and references, managing the skill index.
+name: modify-harness
+description: Update harness structure files — HARNESS.md, SKILLS.md indexes, REFERENCES.md — to keep routing and descriptions accurate as the harness evolves.
 ---
 
-## Maintaining the Harness
+## Role
 
-When asked to maintain, update, or extend this harness, follow these conventions:
+Keep the harness self-consistent when skills or references are added, renamed, or removed.
 
-### HARNESS.md
-- Keep the `## Skills` section in sync with entries in `skills/SKILLS.md`
-- Keep the `## References` section in sync with entries in `references/REFERENCES.md`
-- Update the `description` frontmatter field when the harness scope changes
+## What to do
 
-### Adding a skill bucket
-1. Create `skills/<bucket-name>/<bucket-name>.md` with a frontmatter `name` and `description`
-2. Add an entry to `skills/SKILLS.md` summarizing when to use the bucket
-3. Add a bullet to the `## Skills` section in `HARNESS.md`
+1. Use reverse progressive disclosure (via the `agent-harnesses` skill) to find which index files reference the target path
+2. Read the current state of each affected file
+3. Apply the change: add, update, or remove the relevant entry
+4. Ensure descriptions remain accurate and routing summaries reflect actual contents
 
-### Adding a reference document
-1. Add the document to `references/`
-2. Add an entry to `references/REFERENCES.md` describing the document's purpose
-3. Add a bullet to the `## References` section in `HARNESS.md`
+## Conventions
 
-### General conventions
-- Keep skill descriptions actionable: "Use when..." not "This skill..."
+- Keep `HARNESS.md` `## Skills` and `## References` sections in sync with `skills/SKILLS.md` and `references/REFERENCES.md`
+- Update the `description` frontmatter in `HARNESS.md` when the harness scope changes
+- Skill descriptions should be actionable: "Use when..." not "This skill..."
 - Reference documents should be stable facts; skill buckets contain executable guidance
 - Prefer updating existing skill buckets over creating new ones when scope overlaps
 """
 
+_MAINTAIN_SKILLS_INDEX = """\
+---
+description: Harness upkeep skills — for modifying the harness structure, adding skills and references.
+---
+
+- [modify-harness](modify-harness/SKILL.md) — Use when maintaining or extending this harness
+"""
+
 
 def _write(path, content):
     os.makedirs(os.path.dirname(path), exist_ok=True)
@@ -58,6 +65,12 @@ description: TODO: describe what this harness does and the role it gives Claude.
 
 TODO: write the entry message Claude should internalize when this harness loads.
 
+## How to Find Information for Claude
+
+Use the `agent-harnesses` skill to explore the harness just in time, based on prompts from the user. Select only what is relevant and repeat until the session is complete, then read the returned resources.
+
+When **maintaining the harness** (adding, moving, or renaming files), consult the `agent-harnesses` skill for reverse progressive disclosure to keep routing files in sync.
+
 ## Skills
 
 TODO: list skill buckets here as they are created.
@@ -79,6 +92,21 @@ TODO: brief description of this harness.
 """,
     )
 
+    _write(
+        f"{root}/.gitignore",
+        """\
+# Claude settings contain absolute paths — keep local
+.claude/settings.json
+.claude/settings.local.json
+
+# Metaskill session state
+.claude/skills/agent-harnesses/sessions/
+
+# Mac
+.DS_Store
+""",
+    )
+
     _write(
         f"{root}/.claude/settings.json",
         f"""\
@@ -145,6 +173,7 @@ def init(name):
     click.echo(f"Initialized harness '{name}' in {cwd}")
     click.echo("  HARNESS.md")
     click.echo("  README.md")
+    click.echo("  .gitignore")
     click.echo("  .claude/settings.json")
     click.echo("  skills/SKILLS.md")
     click.echo("  references/REFERENCES.md")
@@ -175,26 +204,38 @@ def _configure_claude(root, preset):
 def _install_metaskill(root):
     dest = os.path.join(root, _METASKILL_DEST)
     if os.path.exists(dest):
-        click.echo(f"Metaskill already present at {_METASKILL_DEST} — skipping clone.")
+        click.echo(f"Metaskill already present at {_METASKILL_DEST} — skipping.")
         return
 
-    os.makedirs(os.path.dirname(dest), exist_ok=True)
-    click.echo(f"Cloning metaskill into {_METASKILL_DEST}...")
-    result = subprocess.run(
-        ["git", "clone", _METASKILL_REPO, dest],
-        capture_output=True,
-        text=True,
-    )
-    if result.returncode != 0:
-        click.echo(f"Clone failed:\n{result.stderr.strip()}", err=True)
-        sys.exit(1)
+    click.echo("Cloning metaskill...")
+    with tempfile.TemporaryDirectory() as tmp:
+        clone_dir = os.path.join(tmp, "metaskill")
+        result = subprocess.run(
+            ["git", "clone", _METASKILL_REPO, clone_dir],
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode != 0:
+            click.echo(f"Clone failed:\n{result.stderr.strip()}", err=True)
+            sys.exit(1)
+
+        src = os.path.join(clone_dir, "agent-harnesses")
+        os.makedirs(os.path.dirname(dest), exist_ok=True)
+        shutil.copytree(src, dest)
+
     click.echo(f"  {_METASKILL_DEST}")
 
 
 def _install_maintain_skill(root):
-    dest = os.path.join(root, _MAINTAIN_SKILL_DEST)
-    if os.path.exists(dest):
-        click.echo(f"maintain-harness skill already present at {_MAINTAIN_SKILL_DEST} — skipping.")
+    skill_dest = os.path.join(root, _MAINTAIN_SKILL_DEST)
+    index_dest = os.path.join(root, _MAINTAIN_SKILLS_INDEX_DEST)
+
+    if os.path.exists(skill_dest):
+        click.echo(f"maintain-harness skill already present — skipping.")
         return
-    _write(dest, _MAINTAIN_SKILL)
+
+    _write(index_dest, _MAINTAIN_SKILLS_INDEX)
+    click.echo(f"  {_MAINTAIN_SKILLS_INDEX_DEST}")
+
+    _write(skill_dest, _MAINTAIN_SKILL)
     click.echo(f"  {_MAINTAIN_SKILL_DEST}")

agentharnesses_cli-0.1.0/PKG-INFO

@@ -1,62 +0,0 @@
-Metadata-Version: 2.4
-Name: agentharnesses-cli
-Version: 0.1.0
-Summary: CLI tools for agentharnesses.io
-Project-URL: Homepage, https://agentharnesses.io
-Project-URL: Repository, https://github.com/agentharnesses/cli
-License-Expression: Apache-2.0
-Requires-Python: >=3.10
-Requires-Dist: click>=8.1
-Description-Content-Type: text/markdown
-
-# agentharnesses-cli
-
-Command line tools for [agentharnesses.io](http://agentharnesses.io).
-
-## Installation
-
-### From PyPI (once published)
-
-```bash
-pip install agentharnesses-cli
-```
-
-### From source
-
-```bash
-git clone https://github.com/your-org/cli.git
-cd cli
-pip install .
-```
-
-### Development install
-
-```bash
-git clone https://github.com/your-org/cli.git
-cd cli
-pip install -e .
-```
-
-The `-e` flag installs in editable mode so changes to the source are reflected immediately without reinstalling.
-
-## Usage
-
-```bash
-ahar --help
-```
-
-### `ahar init`
-
-Initialize a new harness in the current directory:
-
-```bash
-ahar init
-```
-
-Optionally specify a name (defaults to the directory name):
-
-```bash
-ahar init my-harness
-```
-
-This creates a `harness.yaml` file in the current directory.

agentharnesses_cli-0.1.0/README.md

@@ -1,51 +0,0 @@
-# agentharnesses-cli
-
-Command line tools for [agentharnesses.io](http://agentharnesses.io).
-
-## Installation
-
-### From PyPI (once published)
-
-```bash
-pip install agentharnesses-cli
-```
-
-### From source
-
-```bash
-git clone https://github.com/your-org/cli.git
-cd cli
-pip install .
-```
-
-### Development install
-
-```bash
-git clone https://github.com/your-org/cli.git
-cd cli
-pip install -e .
-```
-
-The `-e` flag installs in editable mode so changes to the source are reflected immediately without reinstalling.
-
-## Usage
-
-```bash
-ahar --help
-```
-
-### `ahar init`
-
-Initialize a new harness in the current directory:
-
-```bash
-ahar init
-```
-
-Optionally specify a name (defaults to the directory name):
-
-```bash
-ahar init my-harness
-```
-
-This creates a `harness.yaml` file in the current directory.