paput-mcp 2.0.3 → 2.2.0

package/README.md

@@ -1,50 +1,42 @@
 # PaPut MCP サーバー
 
 [PaPut](https://paput.io) と連携する Model Context Protocol (MCP) サーバーです。
-AI アシスタント（Windsurf、Cursor、Claude Desktop 等）から PaPut の様々な機能を利用できます。
+Claude、Codex、Cursor などの AI アシスタントから PaPut のメモ、ノート、アイデア、スキルシートを操作できます。
 
 ## 機能
 
-### メモ管理
-
-- メモの作成、検索、取得、更新、削除
-- カテゴリの設定と管理
-- 公開/非公開設定
-
-### ノート管理
-
-- ノートの作成、検索、取得、更新、削除
-- メモとの関連付け
-
-### アイデア管理
+### PaPut データ管理
 
+- メモの作成、検索、取得、更新
+- ノートの作成、検索、取得、更新
 - アイデアの作成、一覧表示、更新、削除
+- スキルシートの取得、基本情報更新、自己PR更新
+- スキルシートのスキル/プロジェクト管理
 
-### スキルシート管理
+### AI セッションの知見保存
 
-- スキルシートの取得
-- 基本情報の更新（生年月日、性別、最寄駅、経験年数）
-- 自己PRの更新
-- スキル情報の個別管理（追加、更新、削除、一括更新）
-- プロジェクト情報の個別管理（追加、更新、削除、検索）
+- Claude/Codex のセッションログを検出
+- AI が抽出した知見候補を pending に一時保存
+- 既存 PaPut メモをローカルキャッシュへ同期
+- fingerprint による重複登録の抑制
+- pending 候補を確認してから PaPut に本保存
+- Claude/Codex 向け Skill とグローバルルールのセットアップ
 
 ## インストール
 
-npm を使用してグローバルにインストールする場合:
+npx で直接実行できます。
 
 ```bash
-npm install -g paput-mcp
+npx -y paput-mcp
 ```
 
-または、npx を使用して直接実行することもできます:
+グローバルにインストールする場合:
 
 ```bash
-npx paput-mcp
+npm install -g paput-mcp
 ```
 
-## 設定方法
-
-### 各 AI アシスタントの設定
+## MCP 設定
 
 API キーは PaPut の設定画面から取得できます。
 
@@ -59,27 +51,83 @@ API キーは PaPut の設定画面から取得できます。
 }
 ```
 
-### プロジェクト自動紐付け機能
+### 環境変数
 
-`PAPUT_PROJECT_MATCH` 環境変数を設定すると、メモ作成・更新時に自動的にプロジェクトが紐付けられます。
+- `PAPUT_API_KEY` - 必須。PaPut API キー
+- `PAPUT_API_URL` - 任意。API URL。未指定時は `https://api.paput.io`
+- `PAPUT_PROJECT_MATCH` - 任意。メモ作成/更新時に紐付けるプロジェクト名の一部
+- `PAPUT_CACHE_DIR` - 任意。知見保存用ローカルキャッシュの保存先。未指定時は `~/.paput-mcp`
+- `PAPUT_HOME` - 任意。PaPut Skill 正本の保存先。未指定時は `~/.paput`
 
-```json
-"env": {
-  "PAPUT_API_KEY": "your-api-key",
-  "PAPUT_PROJECT_MATCH": "ECサイト"  // プロジェクトタイトルの一部を指定
-}
+`PAPUT_PROJECT_MATCH` を設定すると、メモ作成・更新時に、指定文字列を含むスキルシートプロジェクトが自動で紐付けられます。複数マッチした場合は最初のプロジェクトが使われます。
+
+## AI 連携の初期設定
+
+Claude/Codex で PaPut Skill とグローバルルールを使う場合は、次を実行します。
+
+```bash
+npx -y paput-mcp setup-ai
+```
+
+このコマンドは、実行時に変更内容を表示したうえで以下を行います。
+
+- `~/.paput/skills` に PaPut Skill の正本を作成
+- Claude が存在する場合、`~/.claude/skills` に symlink を作成
+- Codex が存在する場合、`~/.agents/skills` に symlink を作成
+- Claude/Codex のグローバルルールに PaPut 利用ルールを追記
+
+オプション:
+
+```bash
+# グローバルルールを変更しない
+npx -y paput-mcp setup-ai --no-rules
+
+# PaPut 管理のリンクやルールを更新
+npx -y paput-mcp setup-ai --force
+
+# Claude または Codex だけ設定
+npx -y paput-mcp setup-ai --claude-only
+npx -y paput-mcp setup-ai --codex-only
+```
+
+生成される Skill:
+
+- `paput-init` - 初回設定、既存メモ同期、未処理セッション確認
+- `paput-sync` - 既存 PaPut メモをローカルキャッシュへ同期
+- `paput-capture` - 現在の会話や指定テーマから知見候補を pending に保存
+- `paput-save` - pending 候補を確認し、承認したものだけ PaPut に保存
+
+## 知見保存ワークフロー
+
+PaPut への保存は、意図しないメモ登録を避けるために 2 段階で行います。
+
+```text
+知見候補を抽出
+  ↓
+pending に保存
+  ↓
+確認後に PaPut へ本保存
 ```
 
-- 指定した文字列を含むプロジェクトが自動的に選択されます
-- 複数マッチした場合は最初のプロジェクトが選択されます
+通常は、`setup-ai` が追記するグローバルルールにより、AI が作業完了時や問題解決時に PaPut へ残す候補を自発的に提示します。
 
-## 使用方法
+AI が候補提示を行わなかった場合は、`paput-capture` を使います。
 
-設定が完了したら、AI アシスタントから以下のツールを利用できます：
+```text
+PaPut に残す知見候補を作って
+```
 
-### 利用可能なツール
+pending 候補を PaPut に本保存する場合は、`paput-save` を使います。
 
-#### メモ管理
+```text
+PaPut の保存候補を確認して
+```
+
+Claude では `/paput-save` のように Skill を呼び出せます。Codex では `$paput-save` または自然言語で利用します。
+
+## 利用可能なツール
+
+### メモ管理
 
 - `paput_create_memo` - メモを作成
 - `paput_search_memo` - メモを検索
@@ -87,21 +135,21 @@ API キーは PaPut の設定画面から取得できます。
 - `paput_update_memo` - メモを更新
 - `paput_get_categories` - カテゴリー一覧を取得
 
-#### ノート管理
+### ノート管理
 
 - `paput_create_note` - ノートを作成
 - `paput_search_notes` - ノートを検索
 - `paput_get_note` - ノートの詳細を取得
 - `paput_update_note` - ノートを更新
 
-#### アイデア管理
+### アイデア管理
 
 - `paput_list_ideas` - アイデア一覧を取得
 - `paput_create_idea` - アイデアを作成
 - `paput_update_idea` - アイデアを更新
 - `paput_delete_idea` - アイデアを削除
 
-#### スキルシート管理
+### スキルシート管理
 
 - `paput_get_skill_sheet` - スキルシートを取得
 - `paput_update_skill_sheet_basic_info` - スキルシート基本情報を更新
@@ -116,93 +164,13 @@ API キーは PaPut の設定画面から取得できます。
 - `paput_update_skill_sheet_project` - スキルシートのプロジェクトを更新
 - `paput_delete_skill_sheet_project` - スキルシートからプロジェクトを削除
 
-以下、推奨する使用方法です。
-
-### AI アシスタントのルール設定
-
-AI アシスタントの設定（.windsurfrules など）に以下を追加してください。（あくまで例です。ご自身の要件に応じて調整してください。）
-
-```
-## メモ作成依頼について（paput-mcp）
-メモ作成を依頼した場合、以下を準拠する
-- 一つのメモが大きくなりすぎないように、最小の粒度でメモを作成する
-- タイトル、内容、カテゴリー（複数可）を提示する
-- 文章は、です/ます 調にしない
-- カテゴリーは、言語、フレームワーク、ツールくらいの粒度で設定する（例: バックエンド のような大きな括りは設定しない）
-- プロジェクト固有のコードを含めない
-- 勝手に MCP を経由してメモを作成せず、明示的に指示するまではチャット上にメモを提示すること
-- 基本的に非公開に設定し、明示的に指示した場合のみ公開にする
-- 内容には、マークダウンの # で始まる行を含めない（タイトルに相当するため）
-```
-
-### プロンプト例
-
-1. 登録すべきメモを提示してもらう（推奨）
-
-```
-ここまでの開発をメモにして提示してください。
-```
-
-2. メモ確認し問題がなかったら、登録する
-
-```
-提案された内容で、PaPut にメモを作成してください。
-```
-
-いきなり 2 の方法を実施すると、意図しないメモが登録されてしまう可能性があるため、1 の方法を挟んでからメモを登録することを推奨します。
-また、各 AI アシスタントのルール設定で、自分好みのメモを作成してもらえるように、ある程度コントロールすることが可能です。
-
-## Claude Code の Custom Slash Command の使用例
-
-以下の設定を `~/.claude/commands/paput.md` ファイルとして保存すると、Claude Code で `/paput` コマンドが使用できます：
-
-````markdown
----
-allowed-tools: mcp__paput__paput_create_memo, mcp__paput__paput_search_memo, mcp__paput__paput_get_categories
-description: 問題解決時の知見やベストプラクティスをPaPutにメモとして保存
-argument-hint: (任意) 保存したい知見の概要
----
-
-## PaPut メモ作成コマンド
-
-このコマンドは、コーディング中に得られた知見を PaPut にメモとして保存します。
-
-### 使用方法
-
-```bash
-# 会話全体から知見を自動抽出
-/paput
-
-# 特定の知見についてメモ化（例）
-/paput Bunでのマイグレーション手順
-/paput JWT認証のエラーハンドリング方法
-/paput クリーンアーキテクチャでのリポジトリ実装パターン
-```
-
-### メモ作成のタイミング
-
-以下のような場面で、自動的にメモの下書きを提示します：
-
-1. **問題解決時の知見** - バグ修正や問題解決で得られた知識
-2. **設計・アーキテクチャ決定** - システム設計の重要な決定事項
-3. **ベストプラクティスの発見** - より良い実装方法の発見
-4. **デバッグ手法の確立** - 効果的なデバッグ方法の発見
-5. **タスク完了時に得られた知見** - タスク完了後の学び
-
-### 処理フロー
-
-1. 現在の会話内容から、保存すべき知見を分析
-2. メモの下書きを提示（タイトル、内容、カテゴリー）
-3. ユーザーの確認・修正を待つ
-4. 承認されたら PaPut に登録
-
-### メモ作成ルール
+### 知見保存・ローカルキャッシュ
 
-- 一つのメモが大きくなりすぎないよう、最小の粒度で作成
-- タイトル、内容、カテゴリー（複数可）を提示
-- 文章は「です/ます」調にしない
-- カテゴリーは言語、フレームワーク、ツールレベルの粒度
-- プロジェクト固有のコードは含めない
-- 基本的に非公開設定（明示的な指示がない限り）
-- 内容にマークダウンの # で始まる行は含めない
-````
+- `paput_cache_status` - ローカルキャッシュ状態を取得
+- `paput_sync_remote_memos` - 既存 PaPut メモをローカルキャッシュへ同期
+- `paput_scan_sessions` - Claude/Codex のローカルセッションログを検出
+- `paput_get_session_transcript` - セッション本文を取得
+- `paput_add_knowledge_candidates` - AI が抽出した知見候補を pending に保存
+- `paput_list_pending_candidates` - 未保存の知見候補を一覧表示
+- `paput_save_pending_candidate` - pending 候補を PaPut メモとして保存
+- `paput_discard_pending_candidate` - pending 候補を破棄

package/dist/cli/index.js

@@ -0,0 +1,31 @@
+import { setupAi } from './setup-ai.js';
+export function runCli(args) {
+    const command = args[0];
+    if (!command)
+        return false;
+    if (command === 'setup-ai') {
+        setupAi(args.slice(1));
+        return true;
+    }
+    if (command === '--help' || command === '-h' || command === 'help') {
+        printHelp();
+        return true;
+    }
+    console.error(`Unknown command: ${command}`);
+    printHelp();
+    process.exitCode = 1;
+    return true;
+}
+function printHelp() {
+    console.log(`Usage:
+  paput-mcp             MCP サーバーを起動
+  paput-mcp setup-ai    Claude/Codex 向け PaPut 連携を初期設定
+
+Options:
+  --force               PaPut 管理の既存リンク/ルールを更新
+  --no-rules            グローバルルールを追記しない
+  --claude-only         Claude のみ設定
+  --codex-only          Codex のみ設定
+`);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,MAAM,CAAC,IAAc;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnE,SAAS,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;CASb,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/install-codex-skill.js

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const SKILL_CONTENT = `---
+name: paput
+description: Use this skill when the user wants to save, review, sync, or extract reusable knowledge with PaPut from Codex sessions, pending candidates, or the local PaPut MCP cache.
+---
+
+# PaPut Knowledge Workflow
+
+Use PaPut MCP tools when the user asks to save knowledge, review pending candidates, sync PaPut, or digest Codex/Claude sessions.
+
+## Session Digest
+
+1. Call \`paput_scan_sessions\` to find unprocessed sessions.
+2. Call \`paput_get_session_transcript\` for relevant sessions.
+3. Extract concise, reusable knowledge candidates.
+4. Save candidates with \`paput_add_knowledge_candidates\`.
+5. Do not publish directly unless the user explicitly asks.
+
+## Review
+
+1. Call \`paput_list_pending_candidates\`.
+2. Show concise candidates with titles, categories, and similar memo hints.
+3. Save approved items with \`paput_save_pending_candidate\`.
+4. Discard rejected items with \`paput_discard_pending_candidate\`.
+
+## Sync
+
+Call \`paput_sync_remote_memos\` before duplicate-sensitive work or when the user updated PaPut outside Codex.
+
+## Defaults
+
+- Keep new candidates private unless the user says otherwise.
+- Prefer pending review over direct save.
+- Avoid saving project-specific secrets, credentials, or private customer data.
+- If no PaPut cache exists, call \`paput_cache_status\` and then \`paput_sync_remote_memos\`.
+`;
+export function installCodexSkill(args) {
+    const force = args.includes('--force');
+    const codexHome = process.env.CODEX_HOME || join(homedir(), '.codex');
+    const skillDir = join(codexHome, 'skills', 'paput');
+    const skillPath = join(skillDir, 'SKILL.md');
+    if (existsSync(skillPath) && !force) {
+        console.error(`Codex Skill already exists: ${skillPath}\nUse --force to overwrite it.`);
+        process.exitCode = 1;
+        return;
+    }
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(skillPath, SKILL_CONTENT, 'utf8');
+    console.log(`Installed PaPut Codex Skill: ${skillPath}`);
+    console.log('');
+    console.log('Try asking Codex:');
+    console.log('- PaPut の pending 候補を確認して');
+    console.log('- このセッションから知見候補を抽出して PaPut の pending に入れて');
+    console.log('- PaPut の既存メモを同期して');
+}
+//# sourceMappingURL=install-codex-skill.js.map

package/dist/cli/install-codex-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-codex-skill.js","sourceRoot":"","sources":["../../src/cli/install-codex-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCrB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE7C,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CACX,+BAA+B,SAAS,gCAAgC,CACzE,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CACT,2CAA2C,CAC5C,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli/setup-ai.js

@@ -0,0 +1,260 @@
+import { existsSync, lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const SKILLS = [
+    {
+        name: 'paput-init',
+        description: 'PaPut の初期設定、既存メモ同期、未処理セッション確認を行いたい時に使う。',
+        body: `# PaPut 初期設定
+
+PaPut の知見保存運用を始めるための初期設定を行う。
+
+## 手順
+
+1. \`paput_cache_status\` でローカルキャッシュ状態を確認する。
+2. \`paput_sync_remote_memos\` で既存 PaPut メモをローカルキャッシュへ同期する。
+3. \`paput_scan_sessions\` で Claude/Codex の未処理セッションを確認する。
+4. 未処理セッションがある場合は、件数と概要をユーザーに提示する。
+5. ユーザーが希望した場合のみ、\`paput_get_session_transcript\` で本文を取得し、知見候補を抽出して \`paput_add_knowledge_candidates\` で pending に保存する。
+
+## 注意
+
+- PaPut への本保存は行わない。
+- 候補はまず pending に保存する。
+- 重複や類似メモがある場合は、その情報を提示する。`,
+    },
+    {
+        name: 'paput-sync',
+        description: 'PaPut の既存メモをローカルキャッシュへ同期し、重複判定の精度を上げたい時に使う。',
+        body: `# PaPut 同期
+
+PaPut の既存メモをローカルキャッシュへ同期する。
+
+## 手順
+
+1. \`paput_cache_status\` で同期前の状態を確認する。
+2. \`paput_sync_remote_memos\` を実行する。
+3. 再度 \`paput_cache_status\` を実行し、同期後の件数を確認する。
+4. 同期結果を簡潔にユーザーへ報告する。
+
+## 注意
+
+- 同期は重複判定のために行う。
+- pending 候補の保存や破棄は行わない。
+- PaPut への新規メモ作成は行わない。`,
+    },
+    {
+        name: 'paput-save',
+        description: 'PaPut の pending 候補を確認し、ユーザーが承認したものだけ PaPut に保存したい時に使う。',
+        body: `# PaPut 保存
+
+pending に保存された知見候補を確認し、ユーザーが承認したものだけ PaPut に保存する。
+
+## 手順
+
+1. \`paput_list_pending_candidates\` で pending 候補を取得する。
+2. 候補ごとにタイトル、カテゴリ、要約、類似メモ情報を簡潔に提示する。
+3. ユーザーが保存を承認した候補だけ \`paput_save_pending_candidate\` で PaPut に保存する。
+4. ユーザーが不要と判断した候補は \`paput_discard_pending_candidate\` で破棄する。
+5. 保存・破棄した件数を報告する。
+
+## 注意
+
+- ユーザー承認なしに PaPut へ保存しない。
+- 「全部保存して」と明示された場合のみ複数候補をまとめて保存する。
+- 候補のタイトルや本文の修正を求められた場合は、保存時に上書きする。
+- 迷う候補や重複が疑われる候補は、保存しない選択肢も提示する。`,
+    },
+    {
+        name: 'paput-capture',
+        description: '作業中の会話や指定テーマから PaPut に残す知見候補を抽出し、pending に保存したい時に使う。',
+        body: `# PaPut 知見候補作成
+
+現在の会話やユーザーが指定したテーマから、PaPut に残すべき知見候補を抽出して pending に保存する。グローバルルールで自動提案されなかった時の手動バックアップとして使う。
+
+## 使う場面
+
+- 問題解決で得た知見を残したい時
+- 設計判断やその理由を残したい時
+- ベストプラクティスやデバッグ手法を残したい時
+- ユーザーが特定テーマのメモ化を依頼した時
+
+## 手順
+
+1. \`paput_list_pending_candidates\` で既存 pending 候補を確認する。
+2. 現在の会話、またはユーザーが指定したテーマに関連する会話内容から、再利用可能な知見だけを抽出する。
+3. 候補は小さい単位に分け、タイトル、本文、カテゴリ、公開設定を提示する。
+4. 既存 pending と重複しそうな候補は追加せず、既存候補の利用を提案する。
+5. ユーザーが承認した候補だけ \`paput_add_knowledge_candidates\` で pending に保存する。
+
+## メモ作成ルール
+
+- 一つの候補が大きくなりすぎないよう、最小の粒度で作成する。
+- タイトルは簡潔で検索しやすくする。
+- 本文は具体的な手順、原因、理由、判断基準を含める。
+- 文章は「です/ます」調にしない。
+- カテゴリは言語、フレームワーク、ツール程度の粒度にする。
+- プロジェクト固有のコード、秘密情報、顧客情報は含めない。
+- 基本的に非公開として扱う。
+- 本文に Markdown の \`#\` で始まる見出し行を含めない。
+
+## 注意
+
+- PaPut へ直接保存しない。
+- 保存先は pending のみ。PaPut への本保存は \`paput-save\` で行う。
+- 候補がない場合は、無理に作らず「保存すべき知見は見つからない」と伝える。`,
+    },
+];
+const RULES = `## PaPut 知見保存ルール
+
+作業完了時、問題解決時、設計判断が固まった時、または再利用可能な知見が発生した時は、PaPut に保存すべき候補がないか自動で確認する。
+
+候補がある場合は、ユーザーにコマンド実行を求めず、タイトル・本文・カテゴリを提示する。ユーザーが承認したら \`paput_add_knowledge_candidates\` で pending に保存する。
+
+PaPut への本保存は、ユーザーが明示的に保存を承認した場合のみ \`paput_save_pending_candidate\` を使う。
+
+保存前にはローカルキャッシュや類似メモ情報を使って重複の可能性を確認する。重複が疑われる場合は、保存しない判断も提示する。
+
+pending 候補の確認や PaPut への保存をユーザーが求めた場合は、\`paput-save\` の手順に従う。`;
+const RULE_START = '<!-- paput-mcp:start -->';
+const RULE_END = '<!-- paput-mcp:end -->';
+export function setupAi(args) {
+    const options = parseOptions(args);
+    const paputHome = process.env.PAPUT_HOME || join(homedir(), '.paput');
+    const sourceSkillsDir = join(paputHome, 'skills');
+    printSetupNotice(options);
+    createSourceSkills(sourceSkillsDir, options.force);
+    if (options.claude) {
+        setupClaude(sourceSkillsDir, options);
+    }
+    if (options.codex) {
+        setupCodex(sourceSkillsDir, options);
+    }
+}
+function parseOptions(args) {
+    const claudeOnly = args.includes('--claude-only');
+    const codexOnly = args.includes('--codex-only');
+    if (claudeOnly && codexOnly) {
+        console.error('--claude-only と --codex-only は同時に指定できません。');
+        process.exitCode = 1;
+        return {
+            force: false,
+            noRules: false,
+            claude: false,
+            codex: false,
+        };
+    }
+    return {
+        force: args.includes('--force'),
+        noRules: args.includes('--no-rules'),
+        claude: !codexOnly,
+        codex: !claudeOnly,
+    };
+}
+function printSetupNotice(options) {
+    console.log('PaPut AI 連携の初期設定を行います。');
+    console.log('');
+    console.log('このコマンドは以下を実行します。');
+    console.log('- ~/.paput/skills に PaPut Skill の正本を作成');
+    if (options.claude) {
+        console.log('- Claude が存在する場合、~/.claude/skills にリンクを作成');
+    }
+    if (options.codex) {
+        console.log('- Codex が存在する場合、~/.agents/skills にリンクを作成');
+    }
+    if (!options.noRules) {
+        console.log('- Claude/Codex のグローバルルールに PaPut 利用ルールを追記');
+    }
+    console.log('');
+    console.log('グローバルルールを変更したくない場合は --no-rules を指定してください。');
+    console.log('既存の PaPut 管理ブロックやリンクを更新する場合は --force を指定してください。');
+    console.log('');
+}
+function createSourceSkills(sourceSkillsDir, force) {
+    mkdirSync(sourceSkillsDir, { recursive: true });
+    for (const skill of SKILLS) {
+        const skillDir = join(sourceSkillsDir, skill.name);
+        const skillPath = join(skillDir, 'SKILL.md');
+        if (existsSync(skillPath) && !force) {
+            console.log(`Skip source skill: ${skillPath} は既に存在します。`);
+            continue;
+        }
+        mkdirSync(skillDir, { recursive: true });
+        writeFileSync(skillPath, renderSkill(skill), 'utf8');
+        console.log(`Create source skill: ${skillPath}`);
+    }
+}
+function setupClaude(sourceSkillsDir, options) {
+    const claudeHome = process.env.CLAUDE_HOME || join(homedir(), '.claude');
+    if (!existsSync(claudeHome)) {
+        console.log('Skip Claude: ~/.claude が見つかりません。');
+        return;
+    }
+    linkSkills(sourceSkillsDir, join(claudeHome, 'skills'), 'Claude', options.force);
+    if (!options.noRules) {
+        upsertRules(join(claudeHome, 'CLAUDE.md'), options.force, 'Claude');
+    }
+}
+function setupCodex(sourceSkillsDir, options) {
+    const codexHome = process.env.CODEX_HOME || join(homedir(), '.codex');
+    const agentsHome = process.env.AGENTS_HOME || join(homedir(), '.agents');
+    if (!existsSync(codexHome) && !existsSync(agentsHome)) {
+        console.log('Skip Codex: ~/.codex と ~/.agents が見つかりません。');
+        return;
+    }
+    linkSkills(sourceSkillsDir, join(agentsHome, 'skills'), 'Codex', options.force);
+    if (!options.noRules) {
+        upsertRules(join(codexHome, 'AGENTS.md'), options.force, 'Codex');
+    }
+}
+function linkSkills(sourceSkillsDir, targetSkillsDir, label, force) {
+    mkdirSync(targetSkillsDir, { recursive: true });
+    for (const skill of SKILLS) {
+        const sourceDir = join(sourceSkillsDir, skill.name);
+        const targetDir = join(targetSkillsDir, skill.name);
+        if (existsSync(targetDir)) {
+            const stat = lstatSync(targetDir);
+            if (!force) {
+                console.log(`Skip ${label} skill link: ${targetDir} は既に存在します。`);
+                continue;
+            }
+            rmSync(targetDir, {
+                recursive: stat.isDirectory() && !stat.isSymbolicLink(),
+                force: true,
+            });
+        }
+        symlinkSync(sourceDir, targetDir, 'dir');
+        console.log(`Link ${label} skill: ${targetDir} -> ${sourceDir}`);
+    }
+}
+function upsertRules(path, force, label) {
+    mkdirSync(dirname(path), { recursive: true });
+    const block = `${RULE_START}\n${RULES}\n${RULE_END}`;
+    const current = existsSync(path) ? readFileSync(path, 'utf8') : '';
+    const pattern = new RegExp(`${escapeRegExp(RULE_START)}[\\s\\S]*?${escapeRegExp(RULE_END)}`);
+    if (pattern.test(current)) {
+        if (!force) {
+            console.log(`Skip ${label} rules: ${path} には PaPut 管理ブロックが既に存在します。`);
+            return;
+        }
+        writeFileSync(path, current.replace(pattern, block), 'utf8');
+        console.log(`Update ${label} rules: ${path}`);
+        return;
+    }
+    const next = `${current.trimEnd()}${current ? '\n\n' : ''}${block}\n`;
+    writeFileSync(path, next, 'utf8');
+    console.log(`Append ${label} rules: ${path}`);
+}
+function renderSkill(skill) {
+    return `---
+name: ${skill.name}
+description: ${skill.description}
+---
+
+${skill.body}
+`;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=setup-ai.js.map

package/dist/cli/setup-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-ai.js","sourceRoot":"","sources":["../../src/cli/setup-ai.ts"],"names":[],"mappings":"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"}