impliforge 0.1.1__tar.gz

impliforge-0.1.1/.gitignore

@@ -0,0 +1,24 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+.env
+.envrc
+
+# Local environment
+.python-version
+
+# Generated workflow artifacts
+artifacts/
+
+# Coverage data
+.coverage
+
+.pytest_cache/

impliforge-0.1.1/.rules

@@ -0,0 +1 @@
+../ctxledger/.rules

impliforge-0.1.1/Formula/impliforge.rb

@@ -0,0 +1,159 @@
+class Impliforge < Formula
+  include Language::Python::Virtualenv
+
+  desc "Orchestrator-centric multi-agent workflow runner built on the GitHub Copilot SDK"
+  homepage "https://pypi.org/project/impliforge/"
+  url "https://github.com/rioriost/impliforge/releases/download/0.1.1/impliforge-0.1.1.tar.gz"
+  sha256 "f03f757eb5bb5fe66b52d1a5afdb713b82d6dd3bb285c53c66d247ef23ef0021"
+  license "MIT"
+
+  depends_on "python@3.14"
+  resource "annotated-types" do
+    url "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl"
+    sha256 "1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53"
+  end
+  resource "github-copilot-sdk" do
+    if OS.mac? && Hardware::CPU.arm?
+      url "https://files.pythonhosted.org/packages/04/04/d2e8bf4587c4da270ccb9cbd5ab8a2c4b41217c2bf04a43904be8a27ae20/github_copilot_sdk-0.2.1-py3-none-macosx_11_0_arm64.whl"
+      sha256 "ef7ff68eb8960515e1a2e199ac0ffb9a17cd3325266461e6edd7290e43dcf012"
+    elsif OS.mac? && Hardware::CPU.intel?
+      url "https://files.pythonhosted.org/packages/67/41/76a9d50d7600bf8d26c659dc113be62e4e56e00a5cbfd544e1b5b200f45c/github_copilot_sdk-0.2.1-py3-none-macosx_10_9_x86_64.whl"
+      sha256 "c0823150f3b73431f04caee43d1dbafac22ae7e8bd1fc83727ee8363089ee038"
+    elsif OS.linux?
+      url "https://files.pythonhosted.org/packages/cf/ee/facf04e22e42d4bdd4fe3d356f3a51180a6ea769ae2ac306d0897f9bf9d9/github_copilot_sdk-0.2.1-py3-none-manylinux_2_28_x86_64.whl"
+      sha256 "6502be0b9ececacbda671835e5f61c7aaa906c6b8657ee252cad6cc8335cac8e"
+    else
+      url "https://files.pythonhosted.org/packages/04/04/d2e8bf4587c4da270ccb9cbd5ab8a2c4b41217c2bf04a43904be8a27ae20/github_copilot_sdk-0.2.1-py3-none-macosx_11_0_arm64.whl"
+      sha256 "ef7ff68eb8960515e1a2e199ac0ffb9a17cd3325266461e6edd7290e43dcf012"
+    end
+  end
+  resource "pydantic" do
+    url "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl"
+    sha256 "e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d"
+  end
+  resource "pydantic-core" do
+    if OS.mac? && Hardware::CPU.arm?
+      url "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl"
+      sha256 "1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14"
+    elsif OS.mac? && Hardware::CPU.intel?
+      url "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl"
+      sha256 "3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a"
+    elsif OS.linux?
+      url "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl"
+      sha256 "22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375"
+    else
+      url "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl"
+      sha256 "1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14"
+    end
+  end
+  resource "python-dateutil" do
+    url "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl"
+    sha256 "a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427"
+  end
+  resource "six" do
+    url "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl"
+    sha256 "4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274"
+  end
+  resource "typing-extensions" do
+    url "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl"
+    sha256 "f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548"
+  end
+  resource "typing-inspection" do
+    url "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl"
+    sha256 "4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7"
+  end
+
+  def install
+    if OS.mac?
+      ENV.append "LDFLAGS", "-Wl,-headerpad_max_install_names"
+      ENV.append "RUSTFLAGS", "-C link-arg=-Wl,-headerpad_max_install_names"
+    end
+
+    venv = virtualenv_create(libexec, "python3.14")
+
+    resource("annotated-types").stage do
+      wheel = Dir["*.whl"].first
+      if wheel
+        venv.pip_install Pathname(wheel)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("github-copilot-sdk").stage do
+      if OS.mac? && Hardware::CPU.arm?
+        venv.pip_install Pathname(Dir["*.whl"].first)
+      elsif OS.mac? && Hardware::CPU.intel?
+        venv.pip_install Pathname(Dir["*.whl"].first)
+      elsif OS.linux?
+        venv.pip_install Pathname(Dir["*.whl"].first)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("pydantic").stage do
+      wheel = Dir["*.whl"].first
+      if wheel
+        venv.pip_install Pathname(wheel)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("pydantic-core").stage do
+      if OS.mac? && Hardware::CPU.arm?
+        venv.pip_install Pathname(Dir["*.whl"].first)
+      elsif OS.mac? && Hardware::CPU.intel?
+        venv.pip_install Pathname(Dir["*.whl"].first)
+      elsif OS.linux?
+        venv.pip_install Pathname(Dir["*.whl"].first)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("python-dateutil").stage do
+      wheel = Dir["*.whl"].first
+      if wheel
+        venv.pip_install Pathname(wheel)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("six").stage do
+      wheel = Dir["*.whl"].first
+      if wheel
+        venv.pip_install Pathname(wheel)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("typing-extensions").stage do
+      wheel = Dir["*.whl"].first
+      if wheel
+        venv.pip_install Pathname(wheel)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    resource("typing-inspection").stage do
+      wheel = Dir["*.whl"].first
+      if wheel
+        venv.pip_install Pathname(wheel)
+      else
+        venv.pip_install Pathname.pwd
+      end
+    end
+
+    venv.pip_install buildpath
+    bin.install_symlink libexec/"bin/impliforge"
+  end
+
+  test do
+    system "#{bin}/impliforge", "--help"
+  end
+end

impliforge-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rio Fujita
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

impliforge-0.1.1/Makefile

@@ -0,0 +1,25 @@
+SHELL := /bin/sh
+
+REPO_ROOT := $(CURDIR)
+UV ?= uv
+DIST_DIR := $(REPO_ROOT)/dist
+FORMULA_DIR := $(REPO_ROOT)/Formula
+FORMULA_FILE := $(FORMULA_DIR)/impliforge.rb
+
+.PHONY: release-artifacts sync build formula
+
+release-artifacts: sync build formula
+
+sync:
+	$(UV) sync --extra test --group dev
+
+build:
+	rm -rf "$(DIST_DIR)"
+	$(UV) build
+
+formula:
+	mkdir -p "$(FORMULA_DIR)"
+	genformula \
+		--source-subdir . \
+		--pyproject "$(REPO_ROOT)/pyproject.toml" \
+		--output "$(FORMULA_FILE)"

impliforge-0.1.1/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: impliforge
+Version: 0.1.1
+Summary: Orchestrator-centric multi-agent workflow runner built on the GitHub Copilot SDK
+Author-email: Rio Fujita <rio_github@rio.st>
+License: MIT License
+        
+        Copyright (c) 2026 Rio Fujita
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agents,automation,copilot,orchestrator,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.14
+Requires-Dist: github-copilot-sdk>=0.2.1
+Provides-Extra: test
+Requires-Dist: bandit>=1.7.10; extra == 'test'
+Requires-Dist: pytest-cov>=7; extra == 'test'
+Requires-Dist: pytest>=9; extra == 'test'
+Description-Content-Type: text/markdown
+
+# impliforge
+
+`impliforge` is an orchestrator-centric multi-agent workflow tool built on top of the GitHub Copilot SDK.
+
+It treats requirement analysis, planning, documentation generation, implementation proposals, test design and execution, review, fix loops, and artifact persistence as one end-to-end workflow.
+
+## License
+
+This project is licensed under the MIT License. See `LICENSE` for details.
+
+## Features
+
+- Multi-agent workflow covering requirements, planning, documentation, implementation, test design, test execution, review, and fix loops
+- Session snapshot, restore, and rotation support
+- Task-aware model routing
+- Operator-facing run summaries, final summaries, review reports, and fix reports
+- Acceptance gating and completion evidence
+- Approval-aware safe edit orchestration
+
+## Installation
+
+This project uses `uv` for dependency management and execution.
+
+Install the default dependencies:
+
+```sh
+uv sync
+```
+
+Install test dependencies as well:
+
+```sh
+uv sync --extra test
+```
+
+## CLI Usage
+
+`impliforge` accepts a **requirement file path** as its positional argument, not an inline requirement string.
+
+### Basic usage
+
+```sh
+uv run impliforge requirements/sample-requirement.md
+```
+
+Or run it as a module:
+
+```sh
+uv run python -m impliforge requirements/sample-requirement.md
+```
+
+### With options
+
+```sh
+uv run impliforge requirements/sample-requirement.md \
+  --model gpt-5.4 \
+  --routing-mode quality \
+  --token-usage-ratio 0.35 \
+  --artifacts-dir artifacts \
+  --docs-dir docs
+```
+
+## Requirement File Format
+
+Requirement files are expected to be plain text or Markdown. Multi-line requirements are supported and recommended.
+
+Example:
+
+```md
+Build a multi-agent environment using the GitHub Copilot SDK
+
+- Support session persistence
+- Include review and fix loops
+- Persist outputs under docs/ and artifacts/
+```
+
+## Error Handling
+
+The CLI exits with an error when:
+
+- The specified requirement file does not exist
+- The requirement file is empty
+- The requirement file cannot be read
+
+Example:
+
+```sh
+uv run impliforge requirements/missing.md
+# error: requirement file not found: requirements/missing.md
+```
+
+## Generated Outputs
+
+The workflow primarily generates the following outputs.
+
+### Documentation outputs
+
+- `docs/design.md`
+- `docs/runbook.md`
+- `docs/test-plan.md`
+- `docs/test-results.md`
+- `docs/review-report.md`
+- `docs/fix-report.md`
+- `docs/final-summary.md`
+
+### Artifact outputs
+
+- `artifacts/workflow-state.json`
+- `artifacts/sessions/<session_id>/session-snapshot.json`
+- `artifacts/workflows/<workflow_id>/workflow-details.json`
+- `artifacts/summaries/<workflow_id>/run-summary.json`
+
+## Validation
+
+Run the full test suite:
+
+```sh
+uv run pytest -q tests
+```
+
+Run tests with coverage:
+
+```sh
+uv run pytest --cov=src/impliforge --cov-report=term-missing:skip-covered -q tests
+```
+
+## Notes
+
+- Generated outputs under `docs/` and `artifacts/` are treated as normal workflow outputs
+- Source edits are expected to go through approval-aware paths
+- Open questions should be treated as either resolved or explicitly deferred

impliforge-0.1.1/README.ja.md

@@ -0,0 +1,129 @@
+# impliforge
+
+`impliforge` は、GitHub Copilot SDK を基盤にした orchestrator-centric なマルチエージェント実行ツール。
+
+要件分析、計画、ドキュメント生成、実装提案、テスト設計・実行、レビュー、修正ループ、成果物保存までを一連の workflow として扱う。
+
+## ライセンス
+
+このプロジェクトは MIT License の下で提供される。詳細は `LICENSE` を参照。
+
+## 主な機能
+
+- requirements / planning / documentation / implementation / test_design / test_execution / review / fix loop を持つ workflow
+- session snapshot / restore / rotation
+- task-aware model routing
+- operator-facing run summary / final summary / review / fix artifacts
+- acceptance gating と completion evidence
+- approval-aware safe edit orchestration
+
+## インストール
+
+依存解決と実行は `uv` 前提。
+
+```sh
+uv sync
+```
+
+テスト依存も入れる場合:
+
+```sh
+uv sync --extra test
+```
+
+## CLI の使い方
+
+`impliforge` は**要件文字列そのものではなく、要件を書いたファイルパス**を位置引数として受け取る。
+
+### 基本
+
+```sh
+uv run impliforge requirements/sample-requirement.md
+```
+
+または module 実行:
+
+```sh
+uv run python -m impliforge requirements/sample-requirement.md
+```
+
+### オプション付き
+
+```sh
+uv run impliforge requirements/sample-requirement.md \
+  --model gpt-5.4 \
+  --routing-mode quality \
+  --token-usage-ratio 0.35 \
+  --artifacts-dir artifacts \
+  --docs-dir docs
+```
+
+## 要件ファイルの形式
+
+要件ファイルは plain text / markdown を想定。複数行で書いてよい。
+
+例:
+
+```md
+GitHub Copilot SDK を用いたマルチエージェント環境を構築する
+
+- session persistence を持つこと
+- review と fix loop を含むこと
+- docs/ と artifacts/ に成果物を保存すること
+```
+
+## エラーハンドリング
+
+次の場合はエラー終了する。
+
+- 指定した要件ファイルが存在しない
+- 要件ファイルが空
+- 要件ファイルを読み取れない
+
+例:
+
+```sh
+uv run impliforge requirements/missing.md
+# error: requirement file not found: requirements/missing.md
+```
+
+## 生成物
+
+主に以下を生成する。
+
+### docs
+
+- `docs/design.md`
+- `docs/runbook.md`
+- `docs/test-plan.md`
+- `docs/test-results.md`
+- `docs/review-report.md`
+- `docs/fix-report.md`
+- `docs/final-summary.md`
+
+### artifacts
+
+- `artifacts/workflow-state.json`
+- `artifacts/sessions/<session_id>/session-snapshot.json`
+- `artifacts/workflows/<workflow_id>/workflow-details.json`
+- `artifacts/summaries/<workflow_id>/run-summary.json`
+
+## 検証
+
+全体テスト:
+
+```sh
+uv run pytest -q tests
+```
+
+coverage:
+
+```sh
+uv run pytest --cov=src/impliforge --cov-report=term-missing:skip-covered -q tests
+```
+
+## 補足
+
+- `docs/` と `artifacts/` への生成物保存は通常運用として扱う
+- source edit は approval-aware な経路を通す前提
+- unresolved open questions は resolved または explicitly deferred として扱う

impliforge-0.1.1/README.md

@@ -0,0 +1,131 @@
+# impliforge
+
+`impliforge` is an orchestrator-centric multi-agent workflow tool built on top of the GitHub Copilot SDK.
+
+It treats requirement analysis, planning, documentation generation, implementation proposals, test design and execution, review, fix loops, and artifact persistence as one end-to-end workflow.
+
+## License
+
+This project is licensed under the MIT License. See `LICENSE` for details.
+
+## Features
+
+- Multi-agent workflow covering requirements, planning, documentation, implementation, test design, test execution, review, and fix loops
+- Session snapshot, restore, and rotation support
+- Task-aware model routing
+- Operator-facing run summaries, final summaries, review reports, and fix reports
+- Acceptance gating and completion evidence
+- Approval-aware safe edit orchestration
+
+## Installation
+
+This project uses `uv` for dependency management and execution.
+
+Install the default dependencies:
+
+```sh
+uv sync
+```
+
+Install test dependencies as well:
+
+```sh
+uv sync --extra test
+```
+
+## CLI Usage
+
+`impliforge` accepts a **requirement file path** as its positional argument, not an inline requirement string.
+
+### Basic usage
+
+```sh
+uv run impliforge requirements/sample-requirement.md
+```
+
+Or run it as a module:
+
+```sh
+uv run python -m impliforge requirements/sample-requirement.md
+```
+
+### With options
+
+```sh
+uv run impliforge requirements/sample-requirement.md \
+  --model gpt-5.4 \
+  --routing-mode quality \
+  --token-usage-ratio 0.35 \
+  --artifacts-dir artifacts \
+  --docs-dir docs
+```
+
+## Requirement File Format
+
+Requirement files are expected to be plain text or Markdown. Multi-line requirements are supported and recommended.
+
+Example:
+
+```md
+Build a multi-agent environment using the GitHub Copilot SDK
+
+- Support session persistence
+- Include review and fix loops
+- Persist outputs under docs/ and artifacts/
+```
+
+## Error Handling
+
+The CLI exits with an error when:
+
+- The specified requirement file does not exist
+- The requirement file is empty
+- The requirement file cannot be read
+
+Example:
+
+```sh
+uv run impliforge requirements/missing.md
+# error: requirement file not found: requirements/missing.md
+```
+
+## Generated Outputs
+
+The workflow primarily generates the following outputs.
+
+### Documentation outputs
+
+- `docs/design.md`
+- `docs/runbook.md`
+- `docs/test-plan.md`
+- `docs/test-results.md`
+- `docs/review-report.md`
+- `docs/fix-report.md`
+- `docs/final-summary.md`
+
+### Artifact outputs
+
+- `artifacts/workflow-state.json`
+- `artifacts/sessions/<session_id>/session-snapshot.json`
+- `artifacts/workflows/<workflow_id>/workflow-details.json`
+- `artifacts/summaries/<workflow_id>/run-summary.json`
+
+## Validation
+
+Run the full test suite:
+
+```sh
+uv run pytest -q tests
+```
+
+Run tests with coverage:
+
+```sh
+uv run pytest --cov=src/impliforge --cov-report=term-missing:skip-covered -q tests
+```
+
+## Notes
+
+- Generated outputs under `docs/` and `artifacts/` are treated as normal workflow outputs
+- Source edits are expected to go through approval-aware paths
+- Open questions should be treated as either resolved or explicitly deferred