agenttakt 0.1.0__tar.gz

agenttakt-0.1.0/.claude/settings.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "permissions": {
+    "allow": [],
+    "deny": []
+  }
+}

agenttakt-0.1.0/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab
+
+[*.{py,go}]
+indent_size = 4

agenttakt-0.1.0/.gitattributes

@@ -0,0 +1,23 @@
+# 改行コードを LF に正規化（Windows / macOS / Linux 間のトラブル予防）
+* text=auto eol=lf
+
+# シェルスクリプトは LF 固定
+*.sh text eol=lf
+
+# Windows バッチは CRLF 固定
+*.bat text eol=crlf
+*.cmd text eol=crlf
+
+# バイナリ判定（diff 抑制）
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.webp binary
+*.pdf binary
+*.zip binary
+*.gz binary
+*.tar binary
+*.mp4 binary
+*.mov binary

agenttakt-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# CODEOWNERS
+#
+# PR レビュー自動割り当て用。リポジトリ全体のオーナーを ryoohshima としている。
+# 必要に応じてパス毎の所有者を追加すること（例: /docs/ @doc-team）。
+# https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+* @ryoohshima

agenttakt-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: バグ報告
+about: バグの報告
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+## 概要
+
+<!-- どのような不具合か簡潔に記載してください -->
+
+## 再現手順
+
+1.
+2.
+3.
+
+## 期待動作
+
+<!-- 本来どう動作すべきか -->
+
+## 実際の動作
+
+<!-- 実際に起きた動作 -->
+
+## 環境
+
+- OS:
+- ブラウザ / ランタイム:
+- バージョン:
+
+## 補足
+
+<!-- スクリーンショット、ログ、関連 PR など -->

agenttakt-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

agenttakt-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: 機能要望
+about: 新機能・改善の提案
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+---
+
+## 概要
+
+<!-- 何を実現したいか簡潔に -->
+
+## 動機・背景
+
+<!-- なぜ必要か、現状の課題 -->
+
+## 提案
+
+<!-- 具体的な実装案・仕様案 -->
+
+## 代替案
+
+<!-- 検討したが採用しなかった案があれば -->
+
+## 補足
+
+<!-- 参考リンク、関連 Issue など -->

agenttakt-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+## What
+
+<!-- 具体的な変更内容を記載してください -->
+
+## Why
+
+<!-- 変更理由や背景を記載してください -->
+
+## Refs
+
+<!-- 関連 Issue、参考リンクなどを記載してください -->
+
+## Type of Change
+
+<!-- 該当するプレフィックスを 1 つ選択してください -->
+
+- [ ] `feat:` 新機能
+- [ ] `fix:` バグ修正
+- [ ] `docs:` ドキュメント
+- [ ] `refactor:` リファクタリング
+- [ ] `test:` テスト
+- [ ] `perf:` パフォーマンス改善
+- [ ] `build:` ビルド設定
+- [ ] `ci:` CI/CD 設定
+- [ ] `chore:` 雑務

agenttakt-0.1.0/.github/dependabot.yml

@@ -0,0 +1,37 @@
+# Dependabot 設定
+#
+# 依存関係の自動更新 PR を週次で起こす。
+# プロジェクトに該当するエコシステムが無い場合は `package-ecosystem` ブロックごと削除すること。
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+
+updates:
+  - package-ecosystem: npm
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "09:00"
+      timezone: Asia/Tokyo
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: chore
+      include: scope
+    labels:
+      - dependencies
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "09:00"
+      timezone: Asia/Tokyo
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: ci
+      include: scope
+    labels:
+      - dependencies
+      - ci

agenttakt-0.1.0/.github/release.yml

@@ -0,0 +1,35 @@
+changelog:
+  categories:
+    - title: 新機能
+      labels:
+        - feat
+        - feature
+        - enhancement
+    - title: バグ修正
+      labels:
+        - fix
+        - bug
+    - title: パフォーマンス改善
+      labels:
+        - perf
+    - title: リファクタリング
+      labels:
+        - refactor
+    - title: ドキュメント
+      labels:
+        - docs
+    - title: テスト
+      labels:
+        - test
+    - title: CI / ビルド
+      labels:
+        - ci
+        - build
+    - title: その他
+      labels:
+        - chore
+        - "*"
+  exclude:
+    labels:
+      - skip-changelog
+      - dependencies

agenttakt-0.1.0/.github/workflows/ci.yml.example

@@ -0,0 +1,63 @@
+# Node.js プロジェクト用 CI 雛形
+#
+# 使用方法:
+#   1. このファイルを ci.yml にリネーム（拡張子 .example を外す）
+#   2. プロジェクトのスクリプト名（lint / typecheck / test）に合わせて run: を調整
+#   3. パッケージマネージャ・Node バージョンをプロジェクトに合わせて変更
+#
+# .example のままだと GitHub Actions に認識されないため、リネームするまで実行されない。
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm lint
+
+  typecheck:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm typecheck
+
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm test

agenttakt-0.1.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,44 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+

agenttakt-0.1.0/.github/workflows/claude.yml

@@ -0,0 +1,57 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # Required for Claude to push the working branch
+      pull-requests: write # Required for Claude to open a PR
+      issues: write # Required for Claude to update its progress comment
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          #
+          # Let Claude run the verification commands before pushing.
+          # These are merged into tag mode's built-in tools, not a replacement for them.
+          #
+          # Each command is allowlisted exactly. Avoid a wildcard such as `Bash(pnpm:*)`:
+          # it would also permit `pnpm exec` / `pnpm dlx` / `pnpm run <any script>`,
+          # which is arbitrary code execution under a `contents: write` token.
+          # Adjust the commands to match the project (npm / yarn / cargo / go ...).
+          claude_args: '--allowed-tools "Bash(pnpm lint)" "Bash(pnpm typecheck)" "Bash(pnpm test)"'
+

agenttakt-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.12"
+      - run: uv sync
+      - run: uv run pytest
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agenttakt
+    permissions:
+      # PyPI Trusted Publishing (OIDC) に必須
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

agenttakt-0.1.0/.github/workflows/stale.yml

@@ -0,0 +1,34 @@
+name: Stale Issues / PRs
+
+# 古い Issue / PR を自動でクローズする。
+# 30 日無活動で stale ラベル付与、さらに 7 日無活動で自動クローズ。
+
+on:
+  schedule:
+    - cron: "0 0 * * 1"  # 毎週月曜 00:00 UTC (= JST 月曜 09:00)
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v10
+        with:
+          days-before-stale: 30
+          days-before-close: 7
+          stale-issue-label: stale
+          stale-pr-label: stale
+          exempt-issue-labels: "pinned,security,keep-open"
+          exempt-pr-labels: "pinned,security,keep-open"
+          stale-issue-message: |
+            この Issue は 30 日間活動がないため stale としてマークされました。
+            7 日以内に追加コメントが無ければ自動でクローズされます。
+          stale-pr-message: |
+            この PR は 30 日間活動がないため stale としてマークされました。
+            7 日以内に追加コメントが無ければ自動でクローズされます。
+          close-issue-message: 自動クローズしました。再度議論が必要な場合は新しい Issue を作成してください。
+          close-pr-message: 自動クローズしました。継続作業が必要な場合は新しい PR を作成してください。

agenttakt-0.1.0/.gitignore

@@ -0,0 +1,59 @@
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# IDE / エディタ
+.idea/
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+*.swp
+*.swo
+*~
+
+# ログ
+*.log
+logs/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# 環境変数
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# 依存関係（主要なもの）
+node_modules/
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+.bundle/
+vendor/
+
+# pytest / pytest-textual-snapshot
+.pytest_cache/
+snapshot_report.html
+
+# ビルド成果物（汎用）
+dist/
+build/
+out/
+coverage/
+.cache/
+.next/
+.nuxt/
+.turbo/
+.parcel-cache/
+
+# テスト
+.nyc_output/
+
+# 一時ファイル
+*.tmp
+.tmp/
+tmp/

agenttakt-0.1.0/CLAUDE.md

@@ -0,0 +1,68 @@
+# プロジェクト固有の Claude Code 指示
+
+このファイルは本プロジェクトに固有のルール・コンテキストを Claude Code に伝えるためのものでござる。
+全プロジェクト共通のガイドラインは `~/.claude/CLAUDE.md` に記載されており、本ファイルはそれを補完する形で記述するでござる。
+
+## プロジェクト概要
+
+AgentTakt — AI エージェント（Executor）が MCP 経由で送信したタスク実行計画 JSON を、人間がターミナル上の ComfyUI 風ビジュアルノードエディタでレビュー・編集・承認する MCP サーバー兼 TUI ツール。
+
+- MCP サーバー（`agenttakt serve`）と TUI 常駐プロセス（`agenttakt`）の 2 プロセス構成。Unix domain socket（NDJSON）で接続する（詳細は [docs/architecture.md](./docs/architecture.md)）
+- 親 issue: [#3](https://github.com/ryoohshima/AgentTakt/issues/3)（M0〜M4 + docs の sub-issue で進捗管理）
+
+## 技術スタック
+
+- 言語: Python 3.10+（開発環境は 3.12）
+- TUI: Textual >= 8.2
+- MCP: Python MCP SDK v1 FastMCP（`mcp>=1.9,<2` にピン留め。SDK import は `src/agenttakt/server/mcp_server.py` に閉じ込める）
+- データモデル: pydantic v2
+- パッケージマネージャ: uv（build backend は hatchling、src レイアウト）
+
+## ディレクトリ構成
+
+```
+.
+├── src/agenttakt/
+│   ├── cli.py             # エントリポイント（agenttakt / at）
+│   ├── models/            # Plan データモデル・DAG 検証・自動レイアウト
+│   ├── bridge/            # socket プロトコル・クライアント・サーバー
+│   ├── server/            # MCP サーバー（SDK import はここのみ）
+│   └── tui/               # Textual アプリ（screens / widgets / geometry）
+├── tests/                 # pytest（モデル・プロトコル・Pilot による TUI テスト）
+├── examples/              # デバッグモード用サンプル計画 JSON
+├── docs/                  # 設計ドキュメント
+└── tasks/                 # Claude Code 作業記録（todo.md / lessons.md）
+```
+
+## 開発コマンド
+
+```sh
+# セットアップ
+uv sync
+
+# 実行
+uv run agenttakt                                  # TUI 常駐起動
+uv run agenttakt serve                            # MCP stdio サーバー
+uv run agenttakt open examples/sample_plan.json   # デバッグモード（MCP なし）
+
+# テスト
+uv run pytest
+
+# TUI 開発（textual devtools）
+uv run textual console                            # 別ターミナルでログ閲覧
+uv run textual run --dev src/agenttakt/tui/app.py
+```
+
+## このリポジトリ固有の注意事項
+
+- **stdio MCP サーバー内で TUI を起動してはならない**（stdio がプロトコル通信に専有されている）。TUI に触る処理は必ず TUI プロセス側に置く
+- エッジ描画は経路計算（`tui/geometry.py`）と文字化（`tui/widgets/edge_layer.py`）を分離したまま保つ（braille 曲線への差し替え口）
+- Plan / Node / Edge は `extra="allow"`。Executor 独自フィールドのラウンドトリップを壊さないこと
+- socket パスは `AGENTTAKT_SOCKET` → 既定 `{tempdir}/agenttakt-{uid}/takt.sock`。テストでは `tmp_path` 上の実 UDS を使う
+
+## 参照ドキュメント
+
+- [README.md](./README.md)
+- [docs/architecture.md](./docs/architecture.md) — 2 プロセス構成・承認フロー
+- [docs/schema.md](./docs/schema.md) — Plan JSON スキーマ
+- [docs/protocol.md](./docs/protocol.md) — ブリッジプロトコル

agenttakt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryo Ohshima
+
+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.