harnessops 0.1.0__tar.gz

harnessops-0.1.0/.agents/skills/release/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: release
+description: HarnessOps repository を GitHub release するときに使う repo-local skill。version/tag確認、検証、push、gh release create、release後のworkflow確認を行う。
+---
+
+この skill は HarnessOps repository 専用です。共通 plugin ではなく repo-local skill として扱います。
+
+`.harnessops/`、`harness-feedback/`、`harness-lab/` の構造を直接組み替えず、HarnessOps 状態変更は `hops` に委譲します。
+
+手順:
+
+1. `git status --short --branch`、`git log --oneline --decorate -5`、`git tag --list` を確認する。
+2. `pyproject.toml` の version から tag `v<version>` を決める。既存 tag/release がある場合は上書きしない。
+3. release 前に次を実行する。
+
+```bash
+PYTHONPATH="$PWD/src" python3.11 -m pytest -q
+uv run --with-editable . hops doctor --check-overlay --check-records
+uv run --with-editable . hops migrate --check
+```
+
+4. `main` がリリース対象なら必要な commit を作り、`git push origin main` で remote に反映する。
+5. この repository は published GitHub release で PyPI publish workflow が走る。PyPI Trusted Publisher の environment は `pypi` なので、workflow の publish job は `environment: pypi` を持つ必要がある。
+6. `gh release create v<version> --target main --title "harnessops v<version>" --notes <notes>` で release を作る。
+7. 作成後に `gh release view v<version>`、`gh run list --limit 5`、`git status --short --branch` を確認する。
+
+追加の GitHub Actions workflow dispatch は、ユーザーが明示した場合だけ行う。

harnessops-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+concurrency:
+  group: publish-pypi
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    name: Build and publish harnessops
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: python -m twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

harnessops-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+*.pyc
+_handoff

harnessops-0.1.0/.harness/manifest.toml

@@ -0,0 +1,14 @@
+schema_version = "0.1"
+
+[harness]
+provider = "harnessops"
+kind = "harnessops-repository"
+version = "0.1.0"
+
+[commands]
+doctor = "hops doctor"
+migrate = "hops migrate"
+version = "hops version"
+
+[harnessops]
+recommended_profile = "harnessops-core"

harnessops-0.1.0/.harnessops/lock.json

@@ -0,0 +1,22 @@
+{
+  "harnessops_version": "0.1.0",
+  "layout_version": "0.1",
+  "managed_files": {
+    "harness-lab/README.md": "sha256:440eea30a3b85b64a5b79ea8a8e9f497f029328ca1b18e96fb9bf13a372348b5",
+    "harness-lab/views/backlog.md": "sha256:0ed4436872ad24f9c73737b7f84290306dc4baaf36154b7e36be521e985b791c",
+    "harness-lab/views/imported-feedback.md": "sha256:a1f06ef8e94c49bc4eb298f28a8d5bf017dc855c8dbbdcb07a9500445595e3f2",
+    "harness-lab/views/score-trajectory.md": "sha256:a3d2f445609e5e9da0269ece3b10aff2414f3830bd185ad257d32ae19026b616"
+  },
+  "migrations": [],
+  "overlay": {
+    "mode": "meta-lab",
+    "path": "harness-lab"
+  },
+  "profile": {
+    "fingerprint": "sha256:55f93b1f90fa336209e503a4770f4cae5693ed2eda315d9798a893ec16678594",
+    "id": "harnessops-core",
+    "source": "builtin",
+    "version": "0.1.0"
+  },
+  "schema_version": "0.1"
+}

harnessops-0.1.0/.harnessops/project.toml

@@ -0,0 +1,29 @@
+schema_version = "0.1"
+layout_version = "0.1"
+
+[project]
+name = "harnessops"
+root = "."
+kind = "harnessops-repository"
+
+[profile]
+id = "harnessops-core"
+version = "0.1.0"
+source = "builtin"
+adapter = "harnessops_core"
+
+[overlay]
+mode = "meta-lab"
+path = "harness-lab"
+managed_by = "harnessops"
+
+[privacy]
+default_visibility = "private-until-sanitized"
+
+[agents]
+codex = true
+claude = true
+
+[target_harness]
+provider = "harnessops"
+manifest = ".harness/manifest.toml"

harnessops-0.1.0/AGENTS.md

@@ -0,0 +1,18 @@
+# HarnessOps エージェントメモ
+
+このリポジトリは HarnessOps 自身の実装リポジトリです。状態変更の正本は `hops` CLI、仕様の正本は `SPEC.md` です。
+
+## 操作ルール
+
+- HarnessOps の状態変更には必ず `hops` を使います。PATH にない場合は `uv run --with-editable . hops <command>` を使います。
+- 作業開始時に `.harnessops/project.toml` を読み、必要に応じて `hops doctor --check-overlay --check-records` でリンク状態を確認します。
+- HarnessOps 実装コード自体を編集する場合を除き、`.harnessops/`、`harness-feedback/`、`harness-lab/` の構造を直接組み替えないでください。
+- レコード作成、ルーティング、フィードバックのエクスポート/インポート、ラボ評価、採用判断は CLI に委譲します。
+- プロジェクト固有の研究方針、論文内容、実験転換は `harness-feedback/` や `harness-lab/` に混ぜず、対象プロジェクトの `research/` または `notes/` に置きます。
+- 外部共有前に `hops feedback export --sanitize` を使い、ローカルパス、非公開語、未公開研究の文脈を残さないでください。
+
+## 開発時の確認
+
+- `uv run --with-editable . hops doctor --check-overlay --check-records`
+- `uv run --with-editable . hops migrate --check`
+- CLI、ブリッジ、プラグインを変えた場合は関連する `pytest` を実行します。

harnessops-0.1.0/CLAUDE.md

@@ -0,0 +1,16 @@
+# HarnessOps Claude メモ
+
+このリポジトリは HarnessOps 自身の実装リポジトリです。管理対象状態の変更は `hops` CLI に委譲し、リポジトリローカルのブリッジスキルと同梱プラグインは薄い案内に限定します。
+
+## 操作ルール
+
+- PATH に `hops` がない場合は `uv run --with-editable . hops <command>` を使います。
+- 作業開始時に `.harnessops/project.toml` を読み、必要に応じて `hops doctor --check-overlay --check-records` を実行します。
+- HarnessOps 実装コード自体を編集する場合を除き、`.harnessops/`、`harness-feedback/`、`harness-lab/` の構造を直接組み替えないでください。
+- レコード作成、ルーティング、フィードバックのエクスポート/インポート、ラボ評価、採用判断は CLI に委譲します。
+- 外部共有前に `hops feedback export --sanitize` を使い、ローカルパス、非公開語、未公開研究の文脈を残さないでください。
+
+## 開発時の確認
+
+- `uv run --with-editable . hops doctor --check-overlay --check-records`
+- `uv run --with-editable . hops migrate --check`

harnessops-0.1.0/LICENSE

@@ -0,0 +1,2 @@
+Apache-2.0
+

harnessops-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: harnessops
+Version: 0.1.0
+Summary: AI支援ハーネスプロジェクト向けのフィードバックと改善実験OS
+Project-URL: Homepage, https://github.com/Nkzono99/harnessops
+Project-URL: Repository, https://github.com/Nkzono99/harnessops
+Project-URL: Documentation, https://github.com/Nkzono99/harnessops#readme
+Project-URL: Issues, https://github.com/Nkzono99/harnessops/issues
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1
+Requires-Dist: pydantic>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: ruamel-yaml>=0.18
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: jsonschema>=4.0; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# HarnessOps
+
+HarnessOps は、AI Agent がハーネスプロジェクトの失敗、フィードバック、評価、改善判断を証拠付きで扱うための運用基盤です。
+
+このプロジェクトは基本的にAI経由で利用します。人間がCLI手順を覚えることより、何をAI Agentに任せるか、どこに記録が残るか、どの安全条件が守られるかを把握することを重視します。
+
+## 人間が把握すること
+
+HarnessOps は3つのリポジトリ役割を分けます。
+
+| レイヤー | オーバーレイ | 目的 |
+|---|---|---|
+| プロジェクトリポジトリ | `harness-feedback/` | 失敗、ローカル回避策、上流へ送る候補を記録します。 |
+| ターゲットリポジトリ | `harness-lab/` | 受け取ったフィードバックを評価ケース、仮説、判断に変換します。 |
+| HarnessOps リポジトリ | `harness-lab/` | HarnessOps 自身のCLI、スキーマ、プラグイン、運用ループを改善します。 |
+
+プロジェクト固有の研究方針、論文内容、実験転換は `harness-feedback/` ではなく、各プロジェクトの `research/` または `notes/` に置きます。上流やメタ改善へ回す内容は、必ずルーティングとサニタイズを通します。
+
+## 名前
+
+- GitHub repository: `Nkzono99/harnessops`
+- PyPI package: `harnessops`
+- Python import: `harnessops`
+- CLI: `hops`
+
+## 読む順番
+
+- 人間がAI Agent経由で使い始める: [docs/get-started-with-agent.md](docs/get-started-with-agent.md)
+- AI Agent向けの運用手順: [docs/agent-user-guide.md](docs/agent-user-guide.md)
+- target repositoryへ組み込むAgentに渡す文書: [docs/target-integration-agent-brief.md](docs/target-integration-agent-brief.md)
+- project repository単体へ組み込むAgentに渡す文書: [docs/project-repository-integration-agent-brief.md](docs/project-repository-integration-agent-brief.md)
+- 現行仕様の正本: [SPEC.md](SPEC.md)
+- 設計思想: [docs/design-principles.md](docs/design-principles.md)
+- 今後のロードマップ: [docs/roadmap.md](docs/roadmap.md)
+- 個別仕様の補助資料: [specs/](specs/)
+
+## 安全上の前提
+
+- `hops` が HarnessOps 状態変更の正本です。Agentやプラグインは、`.harnessops/`、`harness-feedback/`、`harness-lab/` の構造を直接組み替えません。
+- 未サニタイズのフィードバックは既定で外部出力されません。
+- 採用済み判断には、証拠、回帰リスク、ガードパスが必要です。
+- 生成ビューは更新されますが、人が作成した `records/` 配下の履歴はビュー更新で再生成されません。
+
+## 開発時の確認
+
+```bash
+PYTHONPATH="$PWD/src" python3.11 -m pytest -q
+uv run --with-editable . hops doctor --check-overlay --check-records
+uv run --with-editable . hops migrate --check
+```

harnessops-0.1.0/README.md

@@ -0,0 +1,50 @@
+# HarnessOps
+
+HarnessOps は、AI Agent がハーネスプロジェクトの失敗、フィードバック、評価、改善判断を証拠付きで扱うための運用基盤です。
+
+このプロジェクトは基本的にAI経由で利用します。人間がCLI手順を覚えることより、何をAI Agentに任せるか、どこに記録が残るか、どの安全条件が守られるかを把握することを重視します。
+
+## 人間が把握すること
+
+HarnessOps は3つのリポジトリ役割を分けます。
+
+| レイヤー | オーバーレイ | 目的 |
+|---|---|---|
+| プロジェクトリポジトリ | `harness-feedback/` | 失敗、ローカル回避策、上流へ送る候補を記録します。 |
+| ターゲットリポジトリ | `harness-lab/` | 受け取ったフィードバックを評価ケース、仮説、判断に変換します。 |
+| HarnessOps リポジトリ | `harness-lab/` | HarnessOps 自身のCLI、スキーマ、プラグイン、運用ループを改善します。 |
+
+プロジェクト固有の研究方針、論文内容、実験転換は `harness-feedback/` ではなく、各プロジェクトの `research/` または `notes/` に置きます。上流やメタ改善へ回す内容は、必ずルーティングとサニタイズを通します。
+
+## 名前
+
+- GitHub repository: `Nkzono99/harnessops`
+- PyPI package: `harnessops`
+- Python import: `harnessops`
+- CLI: `hops`
+
+## 読む順番
+
+- 人間がAI Agent経由で使い始める: [docs/get-started-with-agent.md](docs/get-started-with-agent.md)
+- AI Agent向けの運用手順: [docs/agent-user-guide.md](docs/agent-user-guide.md)
+- target repositoryへ組み込むAgentに渡す文書: [docs/target-integration-agent-brief.md](docs/target-integration-agent-brief.md)
+- project repository単体へ組み込むAgentに渡す文書: [docs/project-repository-integration-agent-brief.md](docs/project-repository-integration-agent-brief.md)
+- 現行仕様の正本: [SPEC.md](SPEC.md)
+- 設計思想: [docs/design-principles.md](docs/design-principles.md)
+- 今後のロードマップ: [docs/roadmap.md](docs/roadmap.md)
+- 個別仕様の補助資料: [specs/](specs/)
+
+## 安全上の前提
+
+- `hops` が HarnessOps 状態変更の正本です。Agentやプラグインは、`.harnessops/`、`harness-feedback/`、`harness-lab/` の構造を直接組み替えません。
+- 未サニタイズのフィードバックは既定で外部出力されません。
+- 採用済み判断には、証拠、回帰リスク、ガードパスが必要です。
+- 生成ビューは更新されますが、人が作成した `records/` 配下の履歴はビュー更新で再生成されません。
+
+## 開発時の確認
+
+```bash
+PYTHONPATH="$PWD/src" python3.11 -m pytest -q
+uv run --with-editable . hops doctor --check-overlay --check-records
+uv run --with-editable . hops migrate --check
+```