docsweep 0.1.0__tar.gz

docsweep-0.1.0/.docsweep.yaml

@@ -0,0 +1,5 @@
+# docsweep 自身のプロジェクト設定（ドッグフーディング）
+#
+# archive はリポルート直下ではなく gitignore 済みの docs/local/ 配下へ移送する。
+# ルート直下 archive/ は git 追跡対象になり、非公開の作業ログが公開リポに乗るため。
+archive_dir: docs/local/archive

docsweep-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,85 @@
+# PyPI publish via Trusted Publishing (OIDC)
+#
+# トリガー: タグ `v*` の push（例: `v0.1.0`）
+# 認証:    PyPI の Pending publisher で登録した OIDC（API トークン不要）
+# 環境:    `pypi`（リポジトリ Settings → Environments で作成。承認制にもできる）
+#
+# 手動公開フロー:
+#   1. pyproject.toml の version を上げる
+#   2. git tag v0.1.0 && git push --tags
+#   3. このワークフローが build → publish を実行
+
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    name: Build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: python -m pip install --upgrade build
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # OIDC for Trusted Publishing
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish via Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write   # gh release create
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0   # gh --generate-notes が前タグまで遡るため
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release with auto-generated notes
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${GITHUB_REF_NAME}" \
+            dist/*.whl dist/*.tar.gz \
+            --title "${GITHUB_REF_NAME}" \
+            --generate-notes

docsweep-0.1.0/.gitignore

@@ -0,0 +1,83 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+*.egg
+.venv/
+venv/
+env/
+.env
+
+# Test / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Packaging (PyInstaller)
+*.spec
+*.manifest
+
+# OS / editor
+.DS_Store
+Thumbs.db
+desktop.ini
+.idea/
+.vscode/
+*.swp
+
+# AI ツールのローカル状態・生成物
+.claude/
+*.log
+*.jsonl
+*.tmp
+*.bak
+*.orig
+*.rej
+
+# === 機密・ローカル専用ファイルは絶対にコミットしない ===
+# --- 認証情報・secrets・鍵 ---
+*.pem
+*.key
+*.p12
+*.pfx
+*.ppk
+id_rsa
+id_dsa
+id_ecdsa
+id_ed25519
+.env.*
+*.env
+secrets.*
+*secret*
+*credential*
+*token*
+.netrc
+.npmrc
+.pypirc
+
+# --- ローカル専用ファイル ---
+*.local
+*.local.*
+*.secret.*
+
+# docsweep の個人作業ログ（公開しない）
+docs/local/
+
+# docsweep 実行時の生成物（スキャン結果・履歴）
+INDEX.md
+INDEX.json
+.docsweep/
+
+# テスト用 fixture / golden は上の無視パターンより優先して追跡する。
+# docsweep は INDEX.md・*.jsonl（移動ログ）・各種 *.md を生成するため、
+# それらの期待値を testdata に置くと黙って脱落する。ディレクトリ単位で明示許可。
+!**/testdata/**
+!**/tests/fixtures/**

docsweep-0.1.0/AGENTS.md

@@ -0,0 +1,20 @@
+# Agent Entry Point (docsweep)
+
+This repository's operational guidance for **developing docsweep itself** is
+maintained in `CLAUDE.md`.
+
+- Project overview & dev guide: `./CLAUDE.md`
+- Naming / status convention (human-facing spec): `./docs/conventions.md`
+- Design source of truth (private, may be absent in a fresh clone): `./docs/local/`
+- Local/private additions (if present, not committed): `./CLAUDE.local.md` / `./AGENTS.local.md`
+
+⚠️ **Do not confuse this with `templates/AGENTS.md` and `templates/CLAUDE.md`.**
+Those under `templates/` are the **shipped product** — the ruleset that *adopters*
+copy into their own projects. The root `CLAUDE.md` / `AGENTS.md` (this file) are the
+**maintainer-facing** dev guide for this OSS repo.
+
+Personal/global AI rules are intentionally kept outside this repository. Use each AI
+tool's supported global instruction location for user-specific rules; this file must
+remain valid for a fresh public clone with no private files.
+
+If any project guidance conflicts, follow `CLAUDE.md`.

docsweep-0.1.0/CHANGELOG.md

@@ -0,0 +1,194 @@
+# Changelog
+
+本ファイルは [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) の考え方を緩く参照しています。
+バージョニングは [SemVer](https://semver.org/lang/ja/) に従います。
+
+## [0.1.0] - 2026-07-03
+
+初回リリース。AI コーディングツール（Claude Code / Codex 等）が生成する
+`plan_*.md` / `bugfix_*.md` / `pending_*.md` の蓄積・陳腐化問題を解決する CLI + Web UI + MCP サーバー。
+
+主な機能:
+
+- H1 ステータスラベル（`[完了]` / `[計画]` / `[様子見]` / `[保留]` / `[廃止]`）の機械的読み取り
+- 完了したファイルを各プロジェクトの `archive/` へ自動移送
+- 陳腐化を「要判断」フラグで可視化
+- 複数プロジェクトを横断する INDEX
+- AI エージェント向け **MCP サーバー**（`scan` / `triage` / `apply` / `sweep` / `promote` / `summary` / `index` / `inject` / `eject` + 書き込みツール 4 種）
+- 個人グローバル設定への運用ルール **`inject --global`**（Claude Code / Codex 対応）
+- Web UI: 看板（カンバン）ボード（FastAPI + htmx・`docsweep[web]`）
+- 対話レビュー（`--review` / `docsweep[review]`）
+
+以下は初版に含まれる機能の開発経緯別の内訳。
+
+### Added — OKF（Open Knowledge Format）採用 Phase 3（親 plan `okf-adoption_2026-06-29` C3）
+
+- README 冒頭に OKF 互換宣言を追加（[OKF 仕様](https://zenn.dev/knowledgesense/articles/14a874a9f423bb)
+  へのリンク + docsweep 固有の追加規約「固定 type 集合・H1 ラベル併用」の明示）
+- 配布物 `templates/CLAUDE.md` に OKF 準拠 frontmatter ブロック例・既存採用者向け移行ガイド
+  （`migrate-frontmatter` / `fix-related` / `export --okf` / pre-commit hook 案内）を追記
+- 配布物 `templates/AGENTS.md` の frontmatter 例を OKF 推奨フィールド込みに更新
+  （`type` / `tags` / `owner` / `review_status` / `related` / `last_reviewed`）
+- `docs/okf-mapping.md`（新規）— OKF type 語彙 / status 語彙 / review_status 値域と
+  docsweep 固定語彙との対応表
+- `docs/okf-export-format.md`（新規）— `export --okf` の zip 構造と `okf-manifest.json` 仕様
+- **`docsweep export --okf` サブコマンド**を追加（`docsweep/export.py` 新規）
+  - スキャン範囲内の plan / bugfix / pending を frontmatter ごとそのまま zip に取り出し、
+    OKF 互換語彙との対応表 `okf-manifest.json` を同梱
+  - `--out <path>` で出力先指定（既定 `./docsweep-okf-<date>.zip`）
+  - `--include-archive` で archive 配下も含める
+  - `--project` で特定プロジェクトに絞る
+  - `--json` で結果を機械可読出力
+  - 「docsweep を抜けても md が腐らない」を実演する材料
+- 配布物 pre-commit hook（opt-in）を追加
+  - `templates/.githooks/docsweep-check.py` — frontmatter 不整合検知（type/status の値域違反、
+    review_status が許容外、related に存在しない md 指定）。docsweep 未インストール環境でも
+    動くスタンドアロン実装（PyYAML 無しでも最小 parser でフォールバック）
+  - `templates/install-hooks.sh` / `install-hooks.ps1` — 配置スクリプト（POSIX / Windows）
+
+### Added — OKF 採用 Phase 1 / 2 / 4（親 plan `okf-adoption_2026-06-29` C1 / C2 / C4）
+
+- **Phase 1（C1）— frontmatter 併用パーサ + テンプレ + triage 拡張 + インタラクティブ triage**
+  - `docsweep/detect.py` を拡張: frontmatter > H1 > filename の優先順で type / status を検出。
+    frontmatter と H1 が矛盾する md は warn を出してユーザー判断に委ねる（自動上書きしない）
+  - `docsweep new <type> <topic>` のテンプレに OKF frontmatter ブロックを追加
+    （`type` / `status` / `tags: []` / `owner:` / `review_status: draft` / `related: []` /
+    `last_reviewed: <today>`）
+  - `docsweep triage --tag <name>` で frontmatter `tags:` 絞り込み、`--show owner/tags` で
+    表示列追加
+  - `docsweep triage --review` でインタラクティブ triage（c=完了 / w=様子見 / x=廃止 /
+    s=スキップ / l=後で / o=md を開く / q=終了 の 1 キー判定 → 終了時に一括処理）
+- **Phase 2（C2）— 一括変換 + related 双方向化 + 陳腐化検知 + 派生コマンド一式**
+  - `docsweep migrate-frontmatter --dry-run` / `--apply` — H1 ラベル + ファイル名プレフィックスから
+    frontmatter を生成し既存 md に非破壊挿入（H1 ラベルは温存）
+  - `docsweep fix-related` — 片側参照 `related: [B]` を B 側にも追記して対称化
+  - `docsweep show <file>` — 指定 md を参照している plan/bugfix/pending を逆参照表示
+  - `docsweep stale` — `review_status` 別の前倒し陳腐化候補を列挙
+    （draft 14 日 / review 7 日 / published `last_reviewed` 90 日経過）
+  - `docsweep context <file>` — 本文 + 親 plan + related の bugfix/pending を 1 つの
+    AI 用プロンプト文字列で stdout 出力（`--clipboard` で OS クリップボードへ）
+  - `docsweep claim <file>` / `--unclaim` — frontmatter の owner を現ユーザーで上書き
+    （解決順: `docsweep config user.name` → `git config user.name` → OS ログイン名）
+  - `docsweep config user.name <name>` / `user.email <email>` — `~/.docsweep/config.yaml` の
+    user 設定を CLI / Web UI 双方から読み書き
+  - `docsweep timeline <topic>` — topic を含む plan/bugfix/pending を時系列で列挙
+    （`--format markdown|plain|json`）
+  - `docsweep find --owner X --tag Y --status 実行中 --review-status draft` — 自由クエリ
+  - `docsweep completion bash|zsh|pwsh` — シェル補完スクリプト生成
+- **Phase 4（C4）— カンバン Web UI の OKF 対応**
+  - カード表示に `tags` バッジ / `owner` / `related` 件数アイコンを追加
+  - 詳細パネルに `review_status` / `last_reviewed` / `related` 一覧 / 逆参照を表示
+  - tags / owner / related をインライン編集・書き戻し（services/frontmatter.py 経由・
+    H1 ラベル温存）
+  - 検索バーに `--tag` / `--owner` / `--status` 相当の絞り込み UI を追加
+  - Web UI 上で claim / unclaim 可能（CLI の `claim` と同じファイルを更新）
+
+### Added — 看板方式 Web UI と MCP 書き込み口（親 plan `kanban-board-write-ops`）
+
+- frontmatter `due:` の書き込み側基盤を実装
+  - `docsweep/atomic.py`: アトミック書き込み（`os.replace` 経由）+ 楽観ロック（`expected_mtime`）+ バックアップ（`.docsweep/backup/`・30 日保持・自動掃除）
+  - `docsweep/state.py`: `.docsweep/state.json`（`postpone_count` / `due_history` / `label_history`・v1 スキーマ）の読み書き層
+  - 軸 1（ラベル）の遷移時に `postpone_count` を自動リセット（`[計画]→[実行中]` `[実行中]→[様子見]` `[対応中]→[様子見]` `[保留]→[計画]/[実行中]`）
+- 書き込み API の services 層（CLI / MCP / Web UI が共通で呼ぶ単一実装）
+  - `docsweep/services/due.py`: `update_due` — frontmatter `due:` 書き換え + `postpone_count` インクリメント + 相対指定（`today` / `+1d` / `+1w` / `+1m`）解釈
+  - `docsweep/services/status.py`: `update_status` — H1 ラベル書き換え + ファイル種別×ラベル組み合わせバリデーション + 自動リセット連携
+  - `docsweep/services/content.py`: `update_content` — 本文全置換（楽観ロック必須）
+  - `docsweep/services/archive.py`: `archive_done` — `[完了]` / `[廃止]` のみ移送（`[様子見]` は明示指定でも拒否・寝かせを守る）
+- 配布規約 `templates/CLAUDE.md` と運用解説 `docs/conventions.md` に「期日（due）と看板方式」セクションを追加
+- 配布設定サンプル `templates/.docsweep.yaml` に `due:` / `web_ui:` セクションのコメント例を追加
+- `templates/AGENTS.md` の frontmatter 例に `due:` を追記
+- Web UI に **看板（カンバン）ボード**を新設（`/board`・FastAPI + htmx）
+  - 3 列レイアウト（🔴やり忘れ / 🟡今日 / 🟢実行中）+ 折りたたみ（▼卒業判定 / ▶未来期日 / ▶期日未設定 / ▶archive 候補）
+  - カード UI（ラベルバッジ / 期日バッジ / 先送り回数バッジ + 3 ボタン）
+  - ラベル変更（バッジクリック → セグメント、数字キー 1-6）
+  - 期日変更（クイック +1d / +3d / +1w / +1m / 任意、キーボード d / w / m）
+  - 本文編集ペイン（textarea + Ctrl+S + mtime 競合検出 → 409 Conflict）
+  - 列ドラッグ&ドロップは**期日操作のみ**（ラベル変更には使わない・直交軸を守る）
+  - 旧 dashboard（`/`）は無改変で残存
+- MCP **書き込みツール 4 種**を追加（`docsweep mcp` 経由で AI から呼べる）
+  - `update_status(path, new_status, expected_mtime?)` — H1 ラベル書き換え + ファイル種別×ラベル検証 + `postpone_count` 自動リセット + `[完了]` / `[廃止]` で archive 自動連携
+  - `update_due(path, new_due, reason?, expected_mtime?)` — frontmatter `due:` 書き換え + 相対指定（`today` / `+1d` / `+1w` / `+1m`）解釈 + `postpone_count` インクリメント + しきい値 warning
+  - `update_content(path, new_content, expected_mtime?)` — 本文全置換 + 楽観ロック + H1 欠落警告
+  - `archive_done(paths?, auto?)` — `[完了]` / `[廃止]` のみ archive 移送（`[様子見]` は明示指定でも拒否）
+- 既存 MCP `triage` の戻り値スキーマを拡張（旧クライアント非破壊）
+  - 各 item に `due` / `due_raw` / `due_parse_error` / `overdue_kind` / `overdue_days` / `postpone_count` / `label_history_count` を追加
+  - `allowed_actions` 集合に `update_due` / `update_content` を追加
+  - `summary` ブロックに `overdue_todo` / `today` / `overdue_graduate` / `future` / `missing_due` のカウントを追加
+- パス境界チェック層を新設（`docsweep/security/path.py`）— スキャンルート配下のみ書き込み可・`realpath` 解決後にスコープ境界チェック・`..` 拒否・`.md` ファイルのみ
+- 不変条件のホワイトボックステストを追加（`tests/test_invariants.py`）— 物理削除口の不存在を AST レベルで担保
+- `Config` に `due:` セクションを追加（`due_warn_threshold` / `due_alert_threshold` / `due_default_offset_days`）— `.docsweep.yaml` の `due:` ブロックから上書き可能
+- Web UI / MCP の `update_due` がしきい値を Config から受け取るように配線（`postpone_warn_threshold` / `postpone_alert_threshold` が実際に効くようになった）
+- `docsweep new <type> <topic>` で frontmatter `due:` 初期値を自動付与（`Config.due_default_offset_days` から `today + N` を計算）
+  - `plan` は既定 today+7、`pending` は today+14、`bugfix` は新規時に付けない（`[様子見]` 遷移時に追記する設計）
+  - `--due YYYY-MM-DD` で明示指定、`--no-due` で自動付与を抑止
+- Web UI 編集ペイン用に `GET /api/cards/raw` を新規追加 — 編集 textarea を生 MD で初期化（プレビュー HTML のテキスト化では Markdown 構造が壊れるため）
+- 受信トレイ (`/`) のサイドバーに「📋 看板（カンバン）」リンクを追加（新旧 UI の導線確保）
+
+### Added — 看板の一括編集（派生 plan `kanban-bulk-edit`）
+
+- 看板の全 7 セクション（3 列 + 卒業判定 + 未来期日 + 期日未設定 + archive 候補）を横断して一括操作:
+  - 各カードに checkbox を追加
+  - 各セクションヘッダに「全選択 + 4 ボタン（+1d/+1w/着手/廃止）」セット
+    - 卒業判定は「着手」の代わりに「完了」、archive 候補は「archive へ」のみ
+  - 上部 sticky バー（N 件選択中・+1d/+1w/着手/廃止/archive/解除/画面全選択）
+  - キーバインド `a` = 画面全カード選択 / `Esc` = ピッカー閉じ + 選択解除
+- Web UI 専用 bulk API 3 種（`/api/cards/bulk/{due,status,archive}`）— 既存 services を for ループで呼ぶ薄いラッパ
+  - 部分成功 `{ok:[], failed:[]}` を返す（1 件失敗しても他は続行）
+  - スコープ外パス / mtime conflict / validation エラーは個別に `failed[]` に振り分け
+  - `[完了]` / `[廃止]` 一括指定で archive 移送が連動（単数 API と同じ閉じた口を通す）
+- 確認ダイアログ強化 — `[廃止]` / `[完了]` / archive は ⚠ 強警告メッセージ
+- 部分失敗時の集約ダイアログ — 「成功 N 件／失敗 M 件」と失敗 path の先頭 5 件を表示
+- カードの「📂 プロジェクト名」バッジをクリックで **プロジェクト単位選択切替**（同じプロジェクトのカードだけ全選択・他プロジェクトは解除・再クリックで全解除）。「1 プロジェクトずつ捌く」ワークフロー用
+- バルクバーに **プロジェクト絞り込みドロップダウン**（名前順チェックリスト・部分選択 indeterminate 表示・全 ON / 全 OFF クイックボタン）
+
+### Added — UX 拡張（kanban-bulk-edit 後追加）
+
+- **Undo（直近 archive バッチの取り消し）** — `archive_done` 実行ごとに `batch_id` を生成（`MoveLogEntry` スキーマ拡張）、`undo_last_batch()` で逆操作（archive 配下 → 元の場所へ shutil.move、restore エントリで二重 Undo 防止）。Web UI は archive 後に右下トーストで「↶ Undo」ボタンを 10 秒表示
+- `POST /api/cards/undo` — Undo API エンドポイント（services 層のラッパ）
+- **カード検索ボックス** — topbar に検索 input（ファイル名・タイトル・概要から絞り込み）。`/` キーでフォーカス・`Esc` でクリア。検索ヒット件数も表示
+- **絶対日付指定の一括設定** — バルクバーに「📅 日付」ボタン → date picker dialog → 選択 N 件の `due` を YYYY-MM-DD で一括設定
+
+### Changed — Web UI を看板に集約（plan `consolidate-to-board`）
+
+- 旧 dashboard（`/`）を廃止し、Web UI を **看板（`/board`）一本に集約**
+- `/` は `/board` へ **302 リダイレクト**（トークン引き継ぎ）
+- 旧 dashboard 専用ルート `GET /list` / `GET /fragment` は削除
+- 看板 topbar に **「⚙ 設定・注入」モーダル** を追加（プロジェクト一覧 / inject / eject / グローバル inject Claude・Codex 切替）
+- 看板 topbar に **health chip**（上位 5 プロジェクトの最古経過日数を `📊 mer 90d` 形式で表示）
+- 旧 dashboard テンプレ・CSS・JS（`dashboard.html` / `_dashboard_body.html` / `_list.html` / `index.html` / `app.css` / `app.js`）は当初残置としたが、その後**物理撤去**（下記 Removed 参照）
+- 看板の編集ペインからは引き続き `/preview` `/api/cards/raw` を使用
+
+### Changed
+
+- `docsweep new` で生成される plan / bugfix / pending テンプレから `> 最終更新:` 行を撤去
+  （`st_mtime` ベースで判定しており重複情報だったため）
+- 配布規約 `templates/CLAUDE.md` と運用解説 `docs/conventions.md` からも
+  `> 最終更新: ...` 行の指示・記述を撤去（書く側と読む側を整合）
+- 自リポ `CLAUDE.md` 先頭の `> 最終更新:` 行を撤去（ドッグフーディング整合）
+
+### Removed — 旧 dashboard 資産と TS+Vite スタックの撤去（plan `legacy-stack-retirement` C1/C2）
+
+- Web から到達不能になっていた旧 dashboard 資産を物理撤去
+  （テンプレ 4 枚 + `static/app.js` / `app.css` + server 内の死コードヘルパ群）
+- フロントエンドの TS+Vite+bun ビルドスタック（`src/` / `vite.config.ts` / `tsconfig.json` /
+  `package.json` / `bun.lock`）を撤去し、看板の plain JS + `htmx.min.js` に一本化
+  （**Python 環境だけで開発・配布が完結**。Node/bun 不要）
+
+### Fixed
+
+- archive 移送先を**対象プロジェクト自身の `.docsweep.yaml` から解決**するように修正。
+  sweep / promote は複数プロジェクト横断で動くのに archive 先が起動時の単一 config でしか
+  解決されず、`--project-dir` を明示しないとプロジェクト設定の `archive_dir` が無視されていた
+
+### 不変条件（新機能でも厳守）
+
+- 物理削除の口を実装として持たない（最悪でも `archive_done` 止まり・復元可能）
+- `[様子見]` は明示指定でも archive されない（寝かせを守る）
+- 期日切れだけでは絶対に `[廃止]` 化しない（AI / 人の明示意図が必須）
+- Web UI に新しい特権を持たせない（CLI / MCP と同じ services 関数を呼ぶ）
+- バインド `127.0.0.1` 固定・スキャンルート配下のみ書き込み可・`realpath` 解決後にスコープ境界チェック
+
+`docsweep/detect.py` の `>` 引用行スキップロジックと
+`tests/test_detect.py` の後方互換 fixture は残置（過去ファイルとの互換のため）。
+
+[0.1.0]: https://github.com/ishizakahiroshi/docsweep/releases/tag/v0.1.0

docsweep-0.1.0/CLAUDE.md

@@ -0,0 +1,90 @@
+# docsweep 開発ガイド
+
+> このファイルは **docsweep そのものを開発する** ための AI 向けプロジェクト固有ガイドです。
+> リポジトリを clone した人・AI が常時参照する想定の最小ロード分だけを置きます。
+
+> ⚠️ **`templates/CLAUDE.md` と混同しないこと。** あちらは **配布物**（採用者が自分のプロジェクトに
+> 取り込む AI 作業ドキュメント運用ルールの正本テンプレート）です。本ファイルは
+> **この OSS の中の人向け** 開発ガイドであり、役割がまったく異なります。
+
+## プロジェクト概要
+
+**docsweep** — AI コーディングツール（Claude Code / Codex 等）が生成する
+`plan_*.md` / `bugfix_*.md` / `pending_*.md` の **蓄積・陳腐化問題を解決する
+クロスプラットフォーム CLI + Web UI ツール**。H1 ステータスラベル（`[完了]` / `[計画]` /
+`[廃止]` 等）を機械的に読み取り、完了を各プロジェクトの `archive/` へ自動移送し、
+陳腐化を「要判断」フラグで可視化し、複数プロジェクトを横断 INDEX で一望できるようにする。
+
+- GitHub リポジトリ名: `docsweep`
+- 配布: `pip install docsweep` + 単体バイナリ（PyInstaller）、Win / Mac / Linux 対応
+- 設計の正本: [docs/local/plan_v0.1.0-product-requirements.md](docs/local/plan_v0.1.0-product-requirements.md)
+  および [docs/local/plan_state-tag-orthogonalization.md](docs/local/plan_state-tag-orthogonalization.md)
+
+> 個人/グローバルな AI ルール（言語・確認フォーマット・スクリーンショット規約・
+> ターン終端の出力ルール等）は **このリポジトリには置かない**。各利用者が使う AI ツールの
+> グローバル設定に置くこと。公開リポジトリの `CLAUDE.md` / `AGENTS.md` は
+> **プロジェクト固有ルールだけ**を扱い、private ファイルが無い fresh clone でも有効であること。
+
+## このリポジトリ自身のドキュメント運用
+
+docsweep は **自分自身のルールでドッグフーディング** する。
+`docs/local/` に作業記録（plan / bugfix / pending）を残す際は、**配布物である
+[templates/CLAUDE.md](templates/CLAUDE.md) の「AI 作業ドキュメント運用ルール」に従う**
+（命名・H1 ステータスラベル・必須セクション・ライフサイクルの正本はあちら）。
+規約の人間向け解説は [docs/conventions.md](docs/conventions.md)。
+
+- `docs/local/` は個人作業ログ（gitignore 済み・非公開）
+- 規約を変更するときは `templates/CLAUDE.md`（正本）→ `docs/conventions.md`（解説）の
+  順で更新し、両者をズラさない
+
+## 技術スタック（予定）
+
+| レイヤ | 採用 |
+|------|------|
+| 言語 | Python（クロスプラットフォーム） |
+| パッケージ | `docsweep/`（`pip install docsweep`） |
+| CLI | サブコマンド + フラグ（`--auto` / `--dry-run` / `--review` / `--json` / `--report` / `--summary` / `new`） |
+| インタラクティブ UI | `InquirerPy` / `questionary`（`--review` のチェックリスト専用） |
+| 設定 | YAML（`~/.docsweep/config.yaml` / プロジェクトの `.docsweep.yaml`） |
+| 単体配布 | PyInstaller |
+
+## リポジトリ構成（予定）
+
+```
+docsweep/
+├─ docsweep/        # Python ツール本体（CLI・コアエンジン・Web UI）
+├─ templates/            # 配布物（採用者が取り込む）
+│  ├─ CLAUDE.md          #   Claude Code 向けルールの正本テンプレ
+│  ├─ AGENTS.md          #   Codex 向けの薄いポインタ
+│  └─ .docsweep.yaml#   設定サンプル
+├─ docs/
+│  ├─ conventions.md     # 命名・ステータス規約の人間向け解説
+│  ├─ mockups/           # Web UI モックアップ
+│  └─ local/             # 設計書・作業ログ（非公開・gitignore）
+└─ CLAUDE.md / AGENTS.md # ← 本ファイル（リポジトリ開発者向け）
+```
+
+## クロスプラットフォーム原則
+
+- **パス操作は `pathlib.Path` / `os.path` を使い、区切り文字をハードコードしない**。
+- **ホームディレクトリ起点の設定・状態は全 OS 共通の `~/.docsweep/`**
+  （Windows でも `%USERPROFILE%\.docsweep\` で同じ意味になるようにする）。
+- **ファイル移送（archive 移動）は同一ボリューム前提に依存しない**（`shutil.move` 等で吸収）。
+- **インタラクティブ UI は `--review` 専用**。`--auto` / `--json` は非対話を厳守
+  （cron・CI・AI エージェント委譲向け。プロンプトを出さない）。
+
+## 作業運用ルール（AI 共通）
+
+- **ビルド・パッケージング・公開・コミット・プッシュは全てユーザーが行う**。
+  AI からは自動実行も提案もしない（確認質問も出さない）。
+  - 例外: ユーザーが明示的に「ビルドして」「`pip install -e .` 走らせて」「コミットして」等と
+    指示した場合のみ。
+  - 対象: `pyinstaller` / `pip install` / `pnpm publish` / `git commit` / `git push` / `git tag` 等。
+  - 型チェック・テスト実行（`pytest` / `ruff` / `mypy` 等、コードの正しさ確認）は本ルールの対象外。
+- 完了報告では「公開しますか？」のような提案を出さず、コード変更の要約だけ伝える。
+
+## 公開・配布の方針
+
+- 秘匿情報が無ければ全公開（ツール本体 + テンプレ + 規約ドキュメントをセットで）。
+- 配布の既定は **npm ではなく PyPI**（Python パッケージ）。詳細・npm 連携が絡む場合の
+  運用は予約済みハンドル/トークンの状況に依存するため、公開作業前にユーザーへ確認する。

docsweep-0.1.0/LICENSE

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

docsweep-0.1.0/NOTICES.md

@@ -0,0 +1,47 @@
+# Third-Party Notices
+
+docsweep 自体は MIT License で配布されています（リポジトリ直下 `LICENSE` 参照）。
+本ファイルは **配布物に bundle されているサードパーティ・ソフトウェア** の出典と
+ライセンスを記録するためのものです。
+
+> 注: ここに挙げる依存はいずれも **法的に著作権表記が必須なライセンスではありません**
+> （bundle 対象は現状 0BSD のみ）。それでも透明性・将来 BSD/MIT 等を bundle する場合の
+> 足場・利用者への情報提供の観点から記録を残しています。
+>
+> **pip install で別途解決される依存**（PyYAML / FastAPI / Jinja2 / mcp 等）は
+> bundle ではないため本ファイル対象外です。各依存パッケージは PyPI 上で自身の
+> LICENSE を同梱して配布されており、ユーザーは pip 経由で個別に受け取ります。
+
+## Bundled
+
+### htmx 1.9.12
+
+- 用途: Web UI の HTML over the wire (HTMX) ライブラリ
+- 同梱パス: `docsweep/server/static/htmx.min.js`
+- 出典: https://github.com/bigskysoftware/htmx
+- ライセンス: **BSD Zero Clause License (0BSD)**
+- 著作権表記: 0BSD のため不要（参考までに原 LICENSE 全文を下記に記載）
+
+```
+# Zero-Clause BSD License
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```
+
+## Runtime dependencies (not bundled — pulled by pip)
+
+参考。これらは wheel に含まれず、ユーザーの `pip install` 時に PyPI から個別に取得されます。
+各パッケージは自身の LICENSE を同梱して配布されるため、本ファイルでの転載は不要です。
+
+- **PyYAML** — MIT License — 設定ファイル読み書き
+- **fastapi** / **uvicorn** / **jinja2** / **markdown** / **python-multipart** / **nh3** — Web UI（`docsweep[web]`）
+- **questionary** — 対話レビュー（`docsweep[review]`）
+- **mcp** — MCP stdio サーバー（`docsweep[mcp]`）
+
+## メンテナンス方針
+
+- 新しい静的アセット（JS / CSS / フォント / 画像のうち外部由来のもの）を `docsweep/server/static/` 等に bundle した場合は、**本ファイルの "Bundled" セクションに追記**する
+- 「bundle 追加 → NOTICES 追記」を忘れない仕組みは `pypi-publish` スキルの前提チェックに記載
+- pip 依存（`pyproject.toml` の dependencies / optional-dependencies）の増減は本ファイル対象外