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

{agentharnesses_cli-0.1.0 → agentharnesses_cli-0.1.2}/.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.2/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: agentharnesses-cli
+Version: 0.1.2
+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.2/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.2}/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.2}/src/ahar/commands/init.py

@@ -1,21 +1,33 @@
 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: Use when asked to maintain, update, or extend this harness — updating HARNESS.md, adding skills and references, managing the skill index.
 ---
 
 ## Maintaining the Harness
 
-When asked to maintain, update, or extend this harness, follow these conventions:
+When asked to maintain, update, or extend this harness, follow these conventions.
+
+When **maintaining the harness** (adding, moving, or renaming files), use `reverse_disclose.py` to find every `.md` file above the target that links to it — so you can update all references that would break:
+
+```
+python3 .claude/skills/agent-harnesses/scripts/reverse_disclose.py <target_path>
+```
+
+Run this before and after any structural change. The output lists each ancestor `.md` file that references the target, with line numbers and link text, so nothing is left pointing to a stale path.
 
 ### HARNESS.md
 - Keep the `## Skills` section in sync with entries in `skills/SKILLS.md`
@@ -23,9 +35,10 @@ When asked to maintain, update, or extend this harness, follow these conventions
 - Update the `description` frontmatter field when the harness scope changes
 
 ### 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. Create `skills/<bucket-name>/<skill-name>/SKILL.md` with a frontmatter `name` and `description`
+2. Add an entry to `skills/<bucket-name>/SKILLS.md` summarizing when to use the skill
+3. Ensure `skills/SKILLS.md` references the bucket
+4. Add a bullet to the `## Skills` section in `HARNESS.md`
 
 ### Adding a reference document
 1. Add the document to `references/`
@@ -38,6 +51,14 @@ When asked to maintain, update, or extend this harness, follow these conventions
 - 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 +79,20 @@ 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. Run `disclose.py` with `python3` against this harness directory to progressively explore its contents — select only what is relevant and repeat until the session is complete, then read the returned resources.
+
+Do not load skills or references speculatively. Use `disclose.py` to find resources when necessary. Any time you need to find anything in the harness, and you don't already know where it exists, use `disclose.py`.
+
+When **maintaining the harness** (adding, moving, or renaming files), use `reverse_disclose.py` to find every `.md` file above the target that links to it — so you can update all references that would break:
+
+```
+python3 .claude/skills/agent-harnesses/scripts/reverse_disclose.py <target_path>
+```
+
+Run this before and after any structural change. The output lists each ancestor `.md` file that references the target, with line numbers and link text, so nothing is left pointing to a stale path.
+
 ## Skills
 
 TODO: list skill buckets here as they are created.
@@ -79,6 +114,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 +195,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 +226,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.