paper-harness-cli 0.1.0__tar.gz

paper_harness_cli-0.1.0/.agents/skills/apply-template-improvement/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: apply-template-improvement
+description: 承認されたテンプレート改善を、後方互換性とドキュメント更新を伴って安全に実装する。
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+---
+
+# apply-template-improvement
+
+テンプレートの変更が承認され、安全に実装する必要がある場合にこのスキルを使用する。
+
+## 目的
+
+1. ルートと `template/` のファイルを最小限のセットで更新する。
+2. マイグレーションが明示的に意図されていない限り、既存の下流の期待を維持する。
+3. 実装と並行してドキュメントと変更履歴のエントリを更新する。
+4. 変更後にローカル smoke チェックを実行する。
+
+## チェックリスト
+
+- 編集前に影響を受けるディレクトリとスクリプトを確認する。
+- ユーザーに影響する変更は `CHANGELOG.md` を更新する。
+- `docs/` の関連ドキュメントを調整する。
+- `make smoke` を実行する。
+- 下流リポジトリに残るマイグレーション作業を要約する。
+
+## Issue とコミットの紐付け
+
+コミットメッセージに対応 Issue 番号を含めること:
+
+```
+fix: 問題の説明 (closes #123)
+feat: 機能の説明 (closes #456)
+design: 設計変更の説明 (closes #789)
+```
+
+複数の Issue を一つのコミットで解決する場合は、すべての番号を列挙する:
+
+```
+design: 構造変更の説明 (closes #4, closes #5)
+```
+
+実装完了後に手動で Issue をクローズする場合:
+
+```sh
+gh issue close <number> --comment "<commit-hash> で対応済み。<変更内容の要約>"
+```

paper_harness_cli-0.1.0/.agents/skills/review-template-regression/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: review-template-regression
+description: テンプレート変更がミラー追跡、ファイル保護、セッション継続性、下流互換性にリグレッションを起こしていないかレビューする。
+allowed-tools: Read, Glob, Grep
+---
+
+# review-template-regression
+
+テンプレートを変更するプルリクエストや差分をレビューする際にこのスキルを使用する。
+
+## レビューの重点
+
+- 日英ミラー追跡のリグレッション
+- 生成ファイルやローカルパスの保護の弱体化
+- `notes/` のセッション継続性の喪失
+- スタータースクリプトや再利用可能ワークフローの破損
+- 下流リポジトリに対する未文書化のインターフェース変更
+
+## プロセス
+
+1. 変更されたファイルを全文読む。
+2. `docs/architecture.md` と `docs/change-policy.md` と比較する。
+3. 具体的な破損と不足しているマイグレーションを優先する。
+4. smoke チェックが変更されたパスを検証しない場合、テストギャップを指摘する。

paper_harness_cli-0.1.0/.agents/skills/triage-template-feedback/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: triage-template-feedback
+description: 受信したテンプレートフィードバックを評価し、スコープ・ラベル・実装先を判断する。Issue トリアージ時に使用。
+allowed-tools: Read, Glob, Grep, Bash
+---
+
+# triage-template-feedback
+
+テンプレートフィードバックの Issue を評価する際、または問題がテンプレートリポジトリに属するかを判断する際にこのスキルを使用する。
+
+## 目的
+
+1. `gh issue list --state open` でオープンな Issue を取得する。
+2. 各 Issue の本文を `gh issue view <number>` で読み、問題を把握する。
+3. 変更がテンプレートに属するか、プロジェクトローカルに留めるべきかを判断する。
+4. `area:*`、`type:*`、`scope:*` ラベルで Issue を分類する。
+5. 繰り返される摩擦を解消する最小の変更を提案する。
+
+## 読み込むべき入力
+
+- `README.md`
+- `docs/architecture.md`
+- `docs/change-policy.md`
+- `docs/triage-rules.md`
+- `template/` 配下の関連ファイル
+
+## 出力形式
+
+各 Issue について以下を含む簡潔なトリアージノートを作成する:
+
+- Issue 番号とタイトル
+- 問題の説明
+- 再現手順
+- スコープの判断
+- 提案するラベル
+- 提案する実装先
+- 実施優先順位
+
+## Issue とコミットの紐付け
+
+トリアージ後に実装する際は、コミットメッセージに Issue 番号を含めて紐付ける:
+
+```
+fix: 問題の説明 (closes #123)
+feat: 機能の説明 (closes #456)
+design: 設計変更の説明 (closes #789, closes #790)
+```
+
+`closes #N` をコミットメッセージに含めることで、main にマージされた時点で自動的に Issue がクローズされる。
+
+実装完了後に手動で Issue をクローズする場合は、対応コミットハッシュを参照するコメントを添えてクローズする:
+
+```sh
+gh issue close <number> --comment "<commit-hash> で対応済み。<変更内容の要約>"
+```

paper_harness_cli-0.1.0/.claude/skills/apply-template-improvement/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: apply-template-improvement
+description: 承認されたテンプレート改善を、後方互換性とドキュメント更新を伴って安全に実装する。
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash
+---
+
+# apply-template-improvement
+
+テンプレートの変更が承認され、安全に実装する必要がある場合にこのスキルを使用する。
+
+## 目的
+
+1. ルートと `template/` のファイルを最小限のセットで更新する。
+2. マイグレーションが明示的に意図されていない限り、既存の下流の期待を維持する。
+3. 実装と並行してドキュメントと変更履歴のエントリを更新する。
+4. 変更後にローカル smoke チェックを実行する。
+
+## チェックリスト
+
+- 編集前に影響を受けるディレクトリとスクリプトを確認する。
+- ユーザーに影響する変更は `CHANGELOG.md` を更新する。
+- `docs/` の関連ドキュメントを調整する。
+- `make smoke` を実行する。
+- 下流リポジトリに残るマイグレーション作業を要約する。
+
+## Issue とコミットの紐付け
+
+コミットメッセージに対応 Issue 番号を含めること:
+
+```
+fix: 問題の説明 (closes #123)
+feat: 機能の説明 (closes #456)
+design: 設計変更の説明 (closes #789)
+```
+
+複数の Issue を一つのコミットで解決する場合は、すべての番号を列挙する:
+
+```
+design: 構造変更の説明 (closes #4, closes #5)
+```
+
+実装完了後に手動で Issue をクローズする場合:
+
+```sh
+gh issue close <number> --comment "<commit-hash> で対応済み。<変更内容の要約>"
+```

paper_harness_cli-0.1.0/.claude/skills/review-template-regression/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: review-template-regression
+description: テンプレート変更がミラー追跡、ファイル保護、セッション継続性、下流互換性にリグレッションを起こしていないかレビューする。
+allowed-tools: Read, Glob, Grep
+---
+
+# review-template-regression
+
+テンプレートを変更するプルリクエストや差分をレビューする際にこのスキルを使用する。
+
+## レビューの重点
+
+- 日英ミラー追跡のリグレッション
+- 生成ファイルやローカルパスの保護の弱体化
+- `notes/` のセッション継続性の喪失
+- スタータースクリプトや再利用可能ワークフローの破損
+- 下流リポジトリに対する未文書化のインターフェース変更
+
+## プロセス
+
+1. 変更されたファイルを全文読む。
+2. `docs/architecture.md` と `docs/change-policy.md` と比較する。
+3. 具体的な破損と不足しているマイグレーションを優先する。
+4. smoke チェックが変更されたパスを検証しない場合、テストギャップを指摘する。

paper_harness_cli-0.1.0/.claude/skills/triage-template-feedback/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: triage-template-feedback
+description: 受信したテンプレートフィードバックを評価し、スコープ・ラベル・実装先を判断する。Issue トリアージ時に使用。
+allowed-tools: Read, Glob, Grep, Bash
+---
+
+# triage-template-feedback
+
+テンプレートフィードバックの Issue を評価する際、または問題がテンプレートリポジトリに属するかを判断する際にこのスキルを使用する。
+
+## 目的
+
+1. `gh issue list --state open` でオープンな Issue を取得する。
+2. 各 Issue の本文を `gh issue view <number>` で読み、問題を把握する。
+3. 変更がテンプレートに属するか、プロジェクトローカルに留めるべきかを判断する。
+4. `area:*`、`type:*`、`scope:*` ラベルで Issue を分類する。
+5. 繰り返される摩擦を解消する最小の変更を提案する。
+
+## 読み込むべき入力
+
+- `README.md`
+- `docs/architecture.md`
+- `docs/change-policy.md`
+- `docs/triage-rules.md`
+- `template/` 配下の関連ファイル
+
+## 出力形式
+
+各 Issue について以下を含む簡潔なトリアージノートを作成する:
+
+- Issue 番号とタイトル
+- 問題の説明
+- 再現手順
+- スコープの判断
+- 提案するラベル
+- 提案する実装先
+- 実施優先順位
+
+## Issue とコミットの紐付け
+
+トリアージ後に実装する際は、コミットメッセージに Issue 番号を含めて紐付ける:
+
+```
+fix: 問題の説明 (closes #123)
+feat: 機能の説明 (closes #456)
+design: 設計変更の説明 (closes #789, closes #790)
+```
+
+`closes #N` をコミットメッセージに含めることで、main にマージされた時点で自動的に Issue がクローズされる。
+
+実装完了後に手動で Issue をクローズする場合は、対応コミットハッシュを参照するコメントを添えてクローズする:
+
+```sh
+gh issue close <number> --comment "<commit-hash> で対応済み。<変更内容の要約>"
+```

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

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 一般的な使い方の質問
+    url: https://github.com/OWNER/REPO/discussions
+    about: 一般的な使い方の質問は Discussions で質問してください。

paper_harness_cli-0.1.0/.github/ISSUE_TEMPLATE/skill-request.yml

@@ -0,0 +1,35 @@
+name: スキルリクエスト
+description: 新しいテンプレートまたはスキャフォールドのスキルをリクエストする。
+title: "[skill-request] "
+labels:
+  - area:skills
+  - type:enhancement
+body:
+  - type: input
+    id: skill_name
+    attributes:
+      label: 提案するスキル名
+      placeholder: sync-reviewer-response
+    validations:
+      required: true
+  - type: textarea
+    id: job
+    attributes:
+      label: 解決したいタスク
+      description: このスキルによって、どの繰り返しタスクをより安全・高速にすべきですか？
+    validations:
+      required: true
+  - type: textarea
+    id: inputs
+    attributes:
+      label: 入力とファイル
+      description: スキルが読み取りまたは更新すべきファイルやアーティファクトは何ですか？
+    validations:
+      required: true
+  - type: textarea
+    id: non_goals
+    attributes:
+      label: スコープ外
+      description: スキルが避けるべきことを明確にしてください。
+    validations:
+      required: false

paper_harness_cli-0.1.0/.github/ISSUE_TEMPLATE/structure-change.yml

@@ -0,0 +1,37 @@
+name: 構造変更
+description: リポジトリまたはスキャフォールドの構造変更を提案する。
+title: "[structure-change] "
+labels:
+  - area:structure
+body:
+  - type: textarea
+    id: current_pain
+    attributes:
+      label: 現在の問題点
+      description: 現在のレイアウトのどこが混乱や重複を引き起こしていますか？
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_structure
+    attributes:
+      label: 提案する構造
+      description: 希望するディレクトリまたはファイルレイアウトを記述してください。
+    validations:
+      required: true
+  - type: checkboxes
+    id: compatibility
+    attributes:
+      label: 互換性の考慮事項
+      options:
+        - label: この変更には下流リポジトリのマイグレーションが必要になる。
+        - label: この変更は追加的に導入できる。
+        - label: ドキュメントの更新が必要になる。
+    validations:
+      required: true
+  - type: textarea
+    id: rationale
+    attributes:
+      label: 根拠
+      description: なぜこの構造が長期的に優れているのですか？
+    validations:
+      required: true

paper_harness_cli-0.1.0/.github/ISSUE_TEMPLATE/template-feedback.yml

@@ -0,0 +1,49 @@
+name: テンプレートフィードバック
+description: テンプレートで修正すべき繰り返しの摩擦を報告する。
+title: "[template-feedback] "
+labels:
+  - scope:template
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: 問題
+      description: 摩擦または障害モードを説明してください。
+      placeholder: 論文スキャフォールドでは...が困難です
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 再現手順
+      description: 下流の論文リポジトリで問題を再現する方法を説明してください。
+      placeholder: 1. template/ から開始... 2. 実行...
+    validations:
+      required: true
+  - type: dropdown
+    id: impact
+    attributes:
+      label: 影響度
+      options:
+        - 執筆フローをブロックする
+        - 手動クリーンアップの繰り返しが発生する
+        - AI のガイダンスの信頼性が低下する
+        - ドキュメントの明確さの問題
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_change
+    attributes:
+      label: 提案する変更
+      description: 部分的でも構わないので修正案を提案してください。
+      placeholder: フックを追加、スキルを更新、スキャフォールドを調整...
+    validations:
+      required: false
+  - type: textarea
+    id: downstream_scope
+    attributes:
+      label: 下流での影響範囲
+      description: この問題が発生したリポジトリや状況を列挙してください。
+      placeholder: paper-lunar-cavity, paper-solar-wind-review, ...
+    validations:
+      required: false

paper_harness_cli-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## 概要
+
+テンプレートの変更内容と誰に恩恵があるかを説明する。
+
+## チェック項目
+
+- [ ] 関連ドキュメントを更新した
+- [ ] `CHANGELOG.md` を更新した
+- [ ] `make smoke` を実行した
+- [ ] 下流へのマイグレーション影響を記載した（該当する場合）

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

@@ -0,0 +1,62 @@
+name: PyPI 公開
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-pypi
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: Python をセットアップ
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: ビルドツールをインストール
+        run: python -m pip install --upgrade build twine
+
+      - name: distribution をビルド
+        run: python -m build
+
+      - name: distribution を検証
+        run: python -m twine check dist/*
+
+      - name: distribution をアップロード
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-distribution
+          path: dist/*
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/paper-harness-cli
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: distribution をダウンロード
+        uses: actions/download-artifact@v4
+        with:
+          name: python-distribution
+          path: dist
+
+      - name: PyPI に公開
+        uses: pypa/gh-action-pypi-publish@release/v1

paper_harness_cli-0.1.0/.github/workflows/reusable-build.yml

@@ -0,0 +1,42 @@
+name: 再利用可能ビルド
+
+on:
+  workflow_call:
+    inputs:
+      working-directory:
+        description: 検証対象のリポジトリルート。
+        required: false
+        type: string
+        default: .
+      run-latex:
+        description: 利用可能な場合に latexmk コンパイルを試行する。
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ${{ inputs.working-directory }}
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: Python をセットアップ
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: ハーネスチェックを実行
+        run: |
+          if [ "${{ inputs.run-latex }}" = "true" ]; then
+            export PAPER_TEMPLATE_RUN_LATEX=1
+          else
+            export PAPER_TEMPLATE_RUN_LATEX=0
+          fi
+          make ci

paper_harness_cli-0.1.0/.github/workflows/reusable-mirror-check.yml

@@ -0,0 +1,31 @@
+name: 再利用可能ミラーチェック
+
+on:
+  workflow_call:
+    inputs:
+      working-directory:
+        description: 検証対象のリポジトリルート。
+        required: false
+        type: string
+        default: .
+
+permissions:
+  contents: read
+
+jobs:
+  mirror-check:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ${{ inputs.working-directory }}
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: Python をセットアップ
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: ミラーチェックを実行
+        run: python3 scripts/mirror-check.py --root manuscript --report manuscript/mirror/reports/ci-report.md

paper_harness_cli-0.1.0/.github/workflows/reusable-release.yml

@@ -0,0 +1,37 @@
+name: 再利用可能リリース
+
+on:
+  workflow_call:
+    inputs:
+      working-directory:
+        description: パッケージ対象のリポジトリルート。
+        required: false
+        type: string
+        default: .
+      artifact-name:
+        description: アップロードするアーティファクトの名前。
+        required: false
+        type: string
+        default: arxiv-export
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ${{ inputs.working-directory }}
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: エクスポートバンドルを準備
+        run: ./scripts/export-arxiv.sh
+
+      - name: エクスポートアーティファクトをアップロード
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ inputs.artifact-name }}
+          path: ${{ inputs.working-directory }}/dist/arxiv-export

paper_harness_cli-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+.DS_Store
+.codex-tmp/
+.venv/
+__pycache__/
+src/**/__pycache__/
+*.egg-info/
+build/
+dist/
+template/**/__pycache__/
+template/**/*.pyc
+template/dist/
+template/manuscript/shared/build/*
+!template/manuscript/shared/build/README.md
+template/manuscript/mirror/reports/latest.md
+template/manuscript/mirror/reports/smoke-check.md
+template/notes/session-context.generated.md
+template/refs/local/locations.toml
+template/.claude/settings.local.json
+template/refs/papers/**
+!template/refs/papers/.gitkeep
+template/**/*.pdf
+!template/manuscript/shared/figures/**/*.pdf

paper_harness_cli-0.1.0/AGENTS.md

@@ -0,0 +1,60 @@
+# AGENTS.md
+
+ユーザーとは**日本語**でコミュニケーションすること。
+
+これは `paperops` の**テンプレート管理リポジトリ**である。
+
+## アーキテクチャ
+
+二層構成:
+
+- **ルート層**: テンプレートガバナンス、再利用可能ワークフロー、`pops` CLI、テンプレート保守スキル
+- **`template/` 層**: 個別の `paper-<topic>` リポジトリにコピーされる論文用スキャフォールド
+
+この二つを混同しないこと。ルートレベルのファイルはテンプレート自体を管理し、`template/` は下流ユーザーが受け取る内容を格納する。
+
+## 主要コマンド
+
+```sh
+make venv                      # Python 3.11 で .venv を作成
+make smoke                     # template/ に対して lint-bib + citation-check + mirror-check + collect-context + readiness-check を実行
+make cli-smoke                 # pops CLI の最小 smoke test を実行
+```
+
+## 変更ワークフロー
+
+1. 構造化された Issue フォーム（`template-feedback`, `skill-request`, `structure-change`）で Issue を受理する。
+2. `/triage-template-feedback` でトリアージする。
+3. `/apply-template-improvement` で実装する。
+4. `/review-template-regression` でレビューする。
+5. マージ前に `make smoke` を実行する。
+6. ユーザーに影響する変更ごとに `CHANGELOG.md` を更新する。
+
+変更を反映する前に `docs/change-policy.md` と `docs/triage-rules.md` を確認すること。
+
+## ルール
+
+- `template/AGENTS.md`、`template/CLAUDE.md`、`template/.agents/skills/`、`template/.claude/skills/`、`template/scripts/` は**ユーザー向けインターフェース**として扱う。変更にはマイグレーションノートが必要。
+- 構造的な書き換えよりも追加的な変更を優先する。
+- 生成されたコンテンツはバージョン管理に含めない。
+- 下流作成は `pops init` に統一する。
+- `template/` 配下を変更した後は必ず `make smoke` を実行する。
+- 長時間セッションでは、コンテキスト使用量が約50%の時点で手動で `/compact` を実行する。
+
+## Git コミットルール
+
+- 意味のある作業単位ごとにコミットする。大量の変更を一つのコミットにまとめない。
+- コミットメッセージは日本語で、変更の「なぜ」を記述する。
+- `git push` はユーザーの明示的な指示なしに実行しない。
+
+## リポジトリマップ
+
+```
+docs/                  architecture, change-policy, triage-rules, skill-catalog, distribution
+.Codex/skills/        triage-template-feedback, apply-template-improvement, review-template-regression
+.github/workflows/     reusable-build, reusable-mirror-check, reusable-release, publish-pypi
+.github/ISSUE_TEMPLATE/ template-feedback, skill-request, structure-change
+src/paperops/          pops CLI
+scripts/               smoke helpers
+template/              下流スキャフォールド一式（template/AGENTS.md を参照）
+```