@knowledgine/cli 0.5.0 → 0.6.0

package/dist/templates/skills/knowledgine-explore/skill-md.ja.js

@@ -0,0 +1,98 @@
+export const SKILL_MD = `---
+name: knowledgine-explore
+version: "1.0.0"
+lang: ja
+description: >
+  慣れないコンポーネントのエンティティ、ナレッジグラフの接続、設計の歴史を探索します。
+  自分が書いていないコードを探索するとき、設計上の決定の経緯を追跡するとき、
+  または名前付きエンティティ（技術、ライブラリ、プロジェクト、コンポーネント）が
+  ナレッジベースの他の部分とどのように関連しているかを理解するときに呼び出します。
+---
+# knowledgine-explore
+
+## 目的
+
+ナレッジグラフを追跡して、なぜ物事が現状のようになっているかを理解します。
+Explore はエンティティ検索とグラフ走査を使用して、コンポーネントや概念を取り巻く
+完全なコンテキストを提示します — 何が存在するかだけでなく、それがシステムの他の部分と
+どのように接続されているか、そしてどのような決定がそれを形成したかも含めます。
+
+## 使用するタイミング
+
+- **慣れないコードを探索するとき** — 誰が何をなぜ作ったのか？どのような決定がこれを形成したのか？
+- **設計の根拠を理解するとき** — どのような代替案が検討されたのか？
+- **知識の出所を追跡するとき** — このパターンやアプローチはどこから来たのか？
+- **技術選択の監査** — なぜここでこのライブラリが使われているのか？
+- **関係性を理解するとき** — コンポーネント A と B はどのように関連しているのか？
+
+## 使用しないタイミング
+
+- 特定の過去の解決策を見つけたいだけのとき（代わりに knowledgine-search を使用）
+- エンティティがまだナレッジベースに存在しないとき
+- プロジェクト固有のコンテキストがない自明の広く知られた概念
+
+## 探索方法 (MCP ツール)
+
+### Step 1: エンティティを検索する
+
+\`\`\`
+search_entities(
+  query: string,   // エンティティ名、技術、概念、または人物
+  limit?: number   // 最大結果数（デフォルト 20）
+)
+\`\`\`
+
+### Step 2: エンティティグラフを探索する
+
+\`\`\`
+get_entity_graph(
+  entityId?: number,    // search_entities の結果からの ID
+  entityName?: string   // または名前で直接検索
+)
+\`\`\`
+
+### Step 3: 関連ノートを見つける
+
+\`\`\`
+find_related(
+  noteId?: number,    // 前のステップで見つけた関連ノードの ID
+  filePath?: string,  // または関連するファイルパス
+  limit?: number,     // 返すノートの最大数（デフォルト 5）
+  maxHops?: number    // 1〜3、デフォルト 1
+)
+\`\`\`
+
+## 探索方法 (CLI の代替手段)
+
+\`\`\`bash
+knowledgine explain "<entity name or concept>"
+\`\`\`
+
+## 手順
+
+1. **対象を特定する** — 理解したいエンティティ、コンポーネント、または概念は何か？
+2. **エンティティを検索する** — 対象の名前で \`search_entities\` を呼び出す
+3. **エンティティグラフを調べる** — エンティティ ID で \`get_entity_graph\` を呼び出す
+4. **関連ノートを走査する** — このエンティティに言及するノートに対して \`find_related\` を呼び出す
+5. **発見内容を統合する** — エンティティの歴史と接続について学んだことをまとめる
+
+## ベストプラクティス
+
+- \`search_entities\` から始めて、ナレッジベースに保存されている正確なエンティティ名を発見する
+- 個々のノートを詳しく見る前に \`get_entity_graph\` で近隣をマッピングする
+- \`maxHops\` を段階的に増やす — 1 から始め、近隣が疎な場合は 2 または 3 にする
+- \`design-decision\` タグが付いたノートを特に探す — それらが「なぜ」を説明している
+
+## エッジケース
+
+- **ナレッジベースが空の場合** — エンティティは見つかりません。探索する前に
+  \`knowledgine-ingest\` を実行してナレッジベースを入力してください。
+- **セマンティック検索が利用できない場合** — 特定の技術またはコンポーネント名を
+  クエリ文字列として使用してキーワード検索にフォールバックしてください。
+
+## 参照ファイル
+
+- knowledgine で使用されるエンティティの分類については \`entity-types.md\` を参照
+- ナレッジグラフを効果的に走査する方法については \`graph-navigation.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

package/dist/templates/skills/knowledgine-explore/skill-md.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGvB,CAAC"}

package/dist/templates/skills/{knowledgine-explain → knowledgine-explore}/skill-md.js

@@ -1,16 +1,18 @@
 export const SKILL_MD = `---
-name: knowledgine-explain
+name: knowledgine-explore
+version: "1.0.0"
+lang: en
 description: >
   Explore entities, knowledge graph connections, and design history for unfamiliar
   components. Invoke when exploring code you did not write, tracing the history of a
   design decision, or understanding how a named entity (technology, library, project,
-  person) relates to other parts of the knowledge base.
+  component) relates to other parts of the knowledge base.
 ---
-# knowledgine-explain
+# knowledgine-explore
 
 ## Purpose
 
-Trace the knowledge graph to understand why things are the way they are. Explain uses
+Trace the knowledge graph to understand why things are the way they are. Explore uses
 entity search and graph traversal to surface the full context around a component or
 concept — not just what exists, but how it connects to other parts of the system and
 what decisions shaped it.
@@ -25,18 +27,18 @@ what decisions shaped it.
 
 ## When NOT to Use
 
-- When you just need to find a specific past solution (use knowledgine-recall instead)
+- When you just need to find a specific past solution (use knowledgine-search instead)
 - When the entity does not exist in the knowledge base yet
 - For trivial well-known concepts with no project-specific context
 
-## How to Explain (MCP Tools)
+## How to Explore (MCP Tools)
 
 ### Step 1: Search for entities
 
 \`\`\`
 search_entities(
   query: string,   // Entity name, technology, concept, or person
-  limit?: number   // Max results (default 10)
+  limit?: number   // Max results (default 20)
 )
 \`\`\`
 
@@ -44,7 +46,7 @@ search_entities(
 
 \`\`\`
 get_entity_graph(
-  entityId?: string,    // ID from search_entities result
+  entityId?: number,    // ID from search_entities result
   entityName?: string   // Or search by name directly
 )
 \`\`\`
@@ -53,14 +55,14 @@ get_entity_graph(
 
 \`\`\`
 find_related(
-  noteId?: string,    // A relevant note ID found in earlier steps
+  noteId?: number,    // A relevant note ID found in earlier steps
   filePath?: string,  // Or a relevant file path
-  limit?: number,
-  maxHops?: number    // 1–3, default 2
+  limit?: number,     // Max notes to return (default 5)
+  maxHops?: number    // 1–3, default 1
 )
 \`\`\`
 
-## How to Explain (CLI Alternative)
+## How to Explore (CLI Alternative)
 
 \`\`\`bash
 knowledgine explain "<entity name or concept>"
@@ -81,6 +83,11 @@ knowledgine explain "<entity name or concept>"
 - Increase \`maxHops\` gradually — start at 1, go to 2 or 3 if the immediate neighborhood is sparse
 - Look specifically for notes tagged \`design-decision\` — they explain the "why"
 
+## Edge Cases
+
+- **If the knowledge base is empty** — No entities will be found. Run \`knowledgine-ingest\` first to populate the knowledge base before exploring.
+- **If semantic search is unavailable** — Fall back to keyword search by using specific technology or component names as the query string.
+
 ## Reference Files
 
 - See \`entity-types.md\` for the entity taxonomy used in knowledgine

package/dist/templates/skills/{knowledgine-suggest → knowledgine-explore}/skill-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-suggest/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FvB,CAAC"}
+{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-explore/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FvB,CAAC"}

package/dist/templates/skills/knowledgine-feedback/references.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCES: Record<string, string>;
+//# sourceMappingURL=references.ja.d.ts.map

package/dist/templates/skills/knowledgine-feedback/references.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqN7C,CAAC"}

package/dist/templates/skills/knowledgine-feedback/references.ja.js

@@ -0,0 +1,214 @@
+export const REFERENCES = {
+    "error-types.md": `# エラータイプ
+
+3つのエンティティ抽出エラータイプの説明と例。
+
+---
+
+## false_positive（誤検出）
+
+**定義**：意味のある固有表現ではないエンティティが抽出された。
+抽出システムが単語やフレーズを重要なエンティティとして誤って識別した。
+
+**一般的な原因**：
+- エンティティタイプとして抽出された一般的な英単語（例：技術として「Map」）
+- 実在するエンティティではないコンテキスト固有の専門用語（例：概念として「Result」）
+- エンティティ名の部分一致（例：「TypeScript」から「Type」が抽出される）
+
+**例**：
+
+| エンティティ | 抽出されたタイプ | 誤りの理由 |
+|--------|---------------|----------------|
+| "the" | concept | 一般的な冠詞で、エンティティではない |
+| "Manager" | technology | 一般的なクラス名サフィックスで、製品ではない |
+| "Error" | technology | 一般的なプログラミング用語で、特定のツールではない |
+| "Result" | concept | どこでも使われる汎用的なプログラミング用語 |
+
+**報告するタイミング**：
+誤検出されたエンティティが検索結果に頻繁に現れて結果の品質を低下させている場合に報告する。
+目立たないノートの1回だけの出現は報告する価値がないかもしれない。
+
+**報告方法**：
+\`\`\`
+report_extraction_error(
+  entityName: "Manager",
+  errorType: "false_positive",
+  entityType: "technology",
+  details: "Generic class name suffix, not a specific technology product"
+)
+\`\`\`
+
+---
+
+## wrong_type（誤分類）
+
+**定義**：実在する意味のあるエンティティが抽出されたが、誤ったタイプに分類された。
+エンティティは存在して有効だが、誤って分類されている。
+
+**一般的な原因**：
+- 人名のように聞こえる技術名（例：「Rust」は姓と混同される可能性がある）
+- 技術的な名前を持つ概念
+- 一般的な単語と同じ名前を持つプロジェクトやツール
+
+**例**：
+
+| エンティティ | 誤ったタイプ | 正しいタイプ | 理由 |
+|--------|-----------|--------------|--------|
+| "TypeScript" | person | technology | プログラミング言語であり、人ではない |
+| "Rust" | concept | technology | プログラミング言語 |
+| "knowledgine" | concept | project | このプロジェクトの名前 |
+| "Jest" | person | technology | JavaScriptテストフレームワーク |
+
+**報告するタイミング**：
+誤った分類によりエンティティが無関係な検索に現れたり、
+正しいエンティティタイプのクエリに現れなくなったりする場合に報告する。
+
+**報告方法**：
+\`\`\`
+report_extraction_error(
+  entityName: "TypeScript",
+  errorType: "wrong_type",
+  entityType: "person",
+  correctType: "technology",
+  details: "TypeScript is a programming language, not a person's name"
+)
+\`\`\`
+
+---
+
+## missed_entity（見落とし）
+
+**定義**：重要なエンティティがまったく抽出されなかった。エンティティはナレッジベースの
+ノートに存在するが、グラフにエンティティレコードがない。
+
+**一般的な原因**：
+- このエンティティに対してエンティティ抽出の信頼度閾値が高すぎた
+- エンティティ名が通常とは異なる形式やコンテキストで言及されていた
+- エンティティが新しく、抽出器のモデルがそれについて学習されていない
+- エンティティが散文ではなくコードブロック内に現れている
+
+**例**：
+- バリデーションコード全体で「Zod」が言及されているがエンティティが抽出されていない
+- コミットメッセージに現れるチームメンバーの名前がエンティティグラフにない
+- 頻繁に参照される特定のエラーコード（例：「SQLITE_CONSTRAINT_UNIQUE」）
+- importステートメントにのみ現れるライブラリ名
+
+**報告するタイミング**：
+\`search_entities\` または \`get_entity_graph\` でそのエンティティを検索するほど重要な場合に報告する。
+頻度の低いマイナーなエンティティは追加する価値がないかもしれない。
+
+**報告方法**：
+\`\`\`
+report_extraction_error(
+  entityName: "Zod",
+  errorType: "missed_entity",
+  details: "Validation library used throughout packages/core for schema validation. \
+Appears in imports and error messages but no entity was extracted."
+)
+\`\`\`
+`,
+    "feedback-guide.md": `# フィードバックガイド
+
+抽出の改善につながる効果的なフィードバックレポートの書き方。
+
+---
+
+## 効果的なフィードバックの条件
+
+良いフィードバック：
+1. **具体的なエンティティを特定する** — 説明ではなく正確な名前
+2. **正しい分類を述べる** — どのタイプであるべきか、またはあるべきでないか
+3. **理由を説明する** — 簡潔な理由付けがフィードバックを実行可能にする
+4. **ノートを参照する** — 問題が確認された場所へのリンク（可能な場合）
+
+---
+
+## フィードバック報告のワークフロー
+
+### ステップ1：問題を特定する
+
+\`search_entities\` を使って対象のエンティティを探す：
+\`\`\`
+search_entities(query: "TypeScript", limit: 5)
+\`\`\`
+
+返されたタイプと期待するものを照合する。
+
+### ステップ2：関連するノートを探す（任意だが有用）
+
+特定のノートでエンティティの誤分類を確認した場合は、そのIDをメモする。
+ノートIDはsearch_knowledgeの結果で確認できる。
+
+### ステップ3：報告する
+
+利用可能なすべての情報を含めて \`report_extraction_error\` を呼び出す：
+\`\`\`
+report_extraction_error(
+  entityName: "<exact name>",
+  errorType: "<false_positive|wrong_type|missed_entity>",
+  entityType: "<current type if known>",
+  correctType: "<correct type for wrong_type errors>",
+  noteId: "<note id if available>",
+  details: "<1〜2文の説明>"
+)
+\`\`\`
+
+### ステップ4：送信を確認する
+
+ツールがフィードバックIDを含む成功レスポンスを返したことを確認する。
+後でフィードバックの状態を追跡したい場合はIDをメモしておく。
+
+---
+
+## detailsフィールドの書き方
+
+\`details\` フィールドは効果的なフィードバックで最も重要な部分。以下を含める：
+
+- エンティティが実際に何であるか（名前だけで明確でない場合）
+- 抽出されたタイプがなぜ誤りなのか
+- エンティティがどのくらいの頻度で現れるか（見落としの場合）
+- 抽出器の改善に役立つコンテキスト
+
+**弱い詳細**：
+\`\`\`
+details: "wrong"
+details: "this is not right"
+\`\`\`
+
+**強い詳細**：
+\`\`\`
+details: "Zod is a TypeScript-first schema validation library. It appears in ~20 notes
+under packages/core/src as imports and in error messages but was not extracted. It
+should be classified as 'technology'."
+\`\`\`
+
+---
+
+## 何を報告するかの優先順位
+
+| 優先度 | 基準 |
+|----------|----------|
+| 高 | エンティティが多くのノートに現れる；誤分類が検索結果を汚染している |
+| 高 | 見落とされたエンティティがプロジェクトドメインの中心である |
+| 中 | 誤検出が頻繁に現れるが、大きな害を与えていない |
+| 低 | 検索品質への影響が軽微な1回限りの問題 |
+
+---
+
+## 報告後の対応
+
+フィードバックの状態を確認し、改善を適用する：
+
+\`\`\`bash
+# 保留中のフィードバックを一覧表示
+knowledgine feedback list --status pending
+
+# フィードバック品質の統計を確認
+knowledgine feedback stats
+\`\`\`
+
+適用されたフィードバックは抽出設定を更新し、将来のインジェストがより良い結果を生成します。
+却下されたフィードバックは記録されますが、変更は行われません。
+`,
+};
+//# sourceMappingURL=references.ja.js.map

package/dist/templates/skills/knowledgine-feedback/references.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/references.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2GnB;IAEC,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGtB;CACA,CAAC"}

package/dist/templates/skills/knowledgine-feedback/skill-md.d.ts

@@ -1,2 +1,2 @@
-export declare const SKILL_MD = "---\nname: knowledgine-feedback\ndescription: >\n  Report incorrect, missing, or misclassified entity extractions to improve knowledge\n  base quality. Invoke when you notice an entity that should not exist (false positive),\n  an entity assigned to the wrong type (wrong_type), or a real entity that was not\n  extracted at all (missed_entity).\n---\n# knowledgine-feedback\n\n## Purpose\n\nImprove the quality of automatic entity extraction by reporting errors. Feedback is\nstored and can be applied to update extraction rules, preventing the same errors from\nrecurring in future ingests.\n\n## When to Use\n\n- **False positive detected** \u2014 An entity was extracted that is not actually a named entity\n  (e.g., a common English word extracted as a \"technology\" entity)\n- **Wrong type detected** \u2014 An entity exists but is classified incorrectly\n  (e.g., \"TypeScript\" classified as \"person\" instead of \"technology\")\n- **Missed entity detected** \u2014 An important entity was not extracted at all\n  (e.g., a library name that appears frequently but has no entity record)\n\n## When NOT to Use\n\n- When entity extraction quality is acceptable \u2014 minor imprecision is normal\n- For subjective disagreements about entity importance (not extracting an entity\n  does not always mean it was missed \u2014 the extractor uses confidence thresholds)\n\n## How to Report (MCP Tool)\n\nUse the `report_extraction_error` MCP tool:\n\n```\nreport_extraction_error(\n  entityName: string,      // The entity name as it appears in the note\n  errorType: string,       // \"false_positive\" | \"wrong_type\" | \"missed_entity\"\n  entityType?: string,     // Current entity type (for wrong_type and false_positive)\n  correctType?: string,    // What the type should be (for wrong_type)\n  noteId?: string,         // ID of the note where the issue was observed\n  details?: string         // Additional context about the error\n)\n```\n\n## How to Report (CLI Alternative)\n\n```bash\n# Report a false positive\nknowledgine feedback report   --entity \"the\"   --type false_positive   --entity-type concept   --details \"Common English article incorrectly extracted as entity\"\n\n# Report wrong type\nknowledgine feedback report   --entity \"TypeScript\"   --type wrong_type   --entity-type person   --correct-type technology\n\n# Report missed entity\nknowledgine feedback report   --entity \"Zod\"   --type missed_entity   --details \"Validation library used throughout packages/core but not extracted\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the error type** \u2014 Is it a false positive, wrong type, or missed entity?\n2. **Find the entity name** \u2014 Use `search_entities` to find the exact stored name if it exists\n3. **Note the note ID** \u2014 If you observed the error in a specific note, record its ID\n4. **Call report_extraction_error** \u2014 Include all applicable parameters\n5. **Verify submission** \u2014 Confirm the tool returned a success response\n\n## Managing Feedback\n\n```bash\n# View pending feedback\nknowledgine feedback list --status pending\n\n# Apply a specific feedback report (admin operation)\nknowledgine feedback apply <id>\n\n# Dismiss feedback without applying\nknowledgine feedback dismiss <id>\n\n# View feedback statistics\nknowledgine feedback stats\n```\n\n## Best Practices\n\n- Report high-frequency errors first \u2014 they have the most impact\n- Include specific details about what makes the extraction incorrect\n- Reference a note ID when possible so the error can be verified in context\n- Do not report minor cases that have no practical impact on search quality\n\n## Reference Files\n\n- See `error-types.md` for detailed descriptions and examples of each error type\n- See `feedback-guide.md` for how to write effective feedback reports\n";
+export declare const SKILL_MD = "---\nname: knowledgine-feedback\nversion: \"1.0.0\"\nlang: en\ndescription: >\n  Report incorrect, missing, or misclassified entity extractions to improve knowledge\n  base quality. Invoke when you notice an entity that should not exist (false positive),\n  an entity assigned to the wrong type (wrong_type), or a real entity that was not\n  extracted at all (missed_entity).\n---\n# knowledgine-feedback\n\n## Purpose\n\nImprove the quality of automatic entity extraction by reporting errors. Feedback is\nstored and can be applied to update extraction rules, preventing the same errors from\nrecurring in future ingests.\n\n## When to Use\n\n- **False positive detected** \u2014 An entity was extracted that is not actually a named entity\n  (e.g., a common English word extracted as a \"technology\" entity)\n- **Wrong type detected** \u2014 An entity exists but is classified incorrectly\n  (e.g., \"TypeScript\" classified as \"person\" instead of \"technology\")\n- **Missed entity detected** \u2014 An important entity was not extracted at all\n  (e.g., a library name that appears frequently but has no entity record)\n\n## When NOT to Use\n\n- When entity extraction quality is acceptable \u2014 minor imprecision is normal\n- For subjective disagreements about entity importance (not extracting an entity\n  does not always mean it was missed \u2014 the extractor uses confidence thresholds)\n\n## How to Report (MCP Tool)\n\nUse the `report_extraction_error` MCP tool:\n\n```\nreport_extraction_error(\n  entityName: string,      // The entity name as it appears in the note\n  errorType: \"false_positive\" | \"wrong_type\" | \"missed_entity\",\n  entityType?: string,     // Current entity type (for wrong_type and false_positive)\n  correctType?: string,    // What the type should be (for wrong_type)\n  noteId?: number,         // ID of the note where the issue was observed\n  details?: string         // Additional context about the error\n)\n```\n\n## How to Report (CLI Alternative)\n\n```bash\n# Report a false positive\nknowledgine feedback report   --entity \"the\"   --type false_positive   --entity-type concept   --details \"Common English article incorrectly extracted as entity\"\n\n# Report wrong type\nknowledgine feedback report   --entity \"TypeScript\"   --type wrong_type   --entity-type person   --correct-type technology\n\n# Report missed entity\nknowledgine feedback report   --entity \"Zod\"   --type missed_entity   --details \"Validation library used throughout packages/core but not extracted\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the error type** \u2014 Is it a false positive, wrong type, or missed entity?\n2. **Find the entity name** \u2014 Use `search_entities` to find the exact stored name if it exists\n3. **Note the note ID** \u2014 If you observed the error in a specific note, record its ID\n4. **Call report_extraction_error** \u2014 Include all applicable parameters\n5. **Verify submission** \u2014 Confirm the tool returned a success response\n\n## Managing Feedback\n\n```bash\n# View pending feedback\nknowledgine feedback list --status pending\n\n# Apply a specific feedback report (admin operation)\nknowledgine feedback apply <id>\n\n# Dismiss feedback without applying\nknowledgine feedback dismiss <id>\n\n# View feedback statistics\nknowledgine feedback stats\n```\n\n## Best Practices\n\n- Report high-frequency errors first \u2014 they have the most impact\n- Include specific details about what makes the extraction incorrect\n- Reference a note ID when possible so the error can be verified in context\n- Do not report minor cases that have no practical impact on search quality\n\n## Reference Files\n\n- See `error-types.md` for detailed descriptions and examples of each error type\n- See `feedback-guide.md` for how to write effective feedback reports\n";
 //# sourceMappingURL=skill-md.d.ts.map

package/dist/templates/skills/knowledgine-feedback/skill-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,2vHAyGpB,CAAC"}
+{"version":3,"file":"skill-md.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/skill-md.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,ywHA2GpB,CAAC"}

package/dist/templates/skills/knowledgine-feedback/skill-md.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_MD = "---\nname: knowledgine-feedback\nversion: \"1.0.0\"\nlang: ja\ndescription: >\n  \u30CA\u30EC\u30C3\u30B8\u30D9\u30FC\u30B9\u306E\u54C1\u8CEA\u3092\u5411\u4E0A\u3055\u305B\u308B\u305F\u3081\u306B\u3001\u8AA4\u3063\u305F\u30FB\u6B20\u843D\u3057\u3066\u3044\u308B\u30FB\u8AA4\u5206\u985E\u3055\u308C\u305F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u62BD\u51FA\u3092\n  \u5831\u544A\u3057\u307E\u3059\u3002\u5B58\u5728\u3059\u3079\u304D\u3067\u306A\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\uFF08false_positive\uFF09\u3001\u8AA4\u3063\u305F\u30BF\u30A4\u30D7\u306B\u5206\u985E\u3055\u308C\u305F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\n  \uFF08wrong_type\uFF09\u3001\u307E\u305F\u306F\u5B9F\u5728\u3059\u308B\u304C\u62BD\u51FA\u3055\u308C\u306A\u304B\u3063\u305F\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\uFF08missed_entity\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D\u306B\n  \u547C\u3073\u51FA\u3057\u3066\u304F\u3060\u3055\u3044\u3002\n---\n# knowledgine-feedback\n\n## \u76EE\u7684\n\n\u30A8\u30E9\u30FC\u3092\u5831\u544A\u3059\u308B\u3053\u3068\u3067\u3001\u81EA\u52D5\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u62BD\u51FA\u306E\u54C1\u8CEA\u3092\u6539\u5584\u3057\u307E\u3059\u3002\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u306F\u4FDD\u5B58\u3055\u308C\u3001\n\u62BD\u51FA\u30EB\u30FC\u30EB\u306E\u66F4\u65B0\u306B\u9069\u7528\u3067\u304D\u307E\u3059\u3002\u3053\u308C\u306B\u3088\u308A\u3001\u5C06\u6765\u306E\u30A4\u30F3\u30B8\u30A7\u30B9\u30C8\u3067\u540C\u3058\u30A8\u30E9\u30FC\u304C\u7E70\u308A\u8FD4\u3055\u308C\u308B\u3053\u3068\u3092\u9632\u304E\u307E\u3059\u3002\n\n## \u4F7F\u7528\u3059\u308B\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- **\u8AA4\u691C\u51FA\uFF08false positive\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D** \u2014 \u5B9F\u969B\u306B\u306F\u56FA\u6709\u8868\u73FE\u3067\u306F\u306A\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\n  \u62BD\u51FA\u3055\u308C\u305F\u5834\u5408\uFF08\u4F8B\uFF1A\u4E00\u822C\u7684\u306A\u82F1\u5358\u8A9E\u304C\u300Ctechnology\u300D\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3068\u3057\u3066\u62BD\u51FA\u3055\u308C\u305F\uFF09\n- **\u8AA4\u3063\u305F\u5206\u985E\uFF08wrong type\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D** \u2014 \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306F\u5B58\u5728\u3059\u308B\u304C\u8AA4\u5206\u985E\u3055\u308C\u3066\u3044\u308B\u5834\u5408\n  \uFF08\u4F8B\uFF1A\u300CTypeScript\u300D\u304C\u300Ctechnology\u300D\u3067\u306F\u306A\u304F\u300Cperson\u300D\u3068\u3057\u3066\u5206\u985E\u3055\u308C\u3066\u3044\u308B\uFF09\n- **\u898B\u843D\u3068\u3057\uFF08missed entity\uFF09\u3092\u767A\u898B\u3057\u305F\u3068\u304D** \u2014 \u91CD\u8981\u306A\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\u307E\u3063\u305F\u304F\u62BD\u51FA\u3055\u308C\u306A\u304B\u3063\u305F\u5834\u5408\n  \uFF08\u4F8B\uFF1A\u983B\u7E41\u306B\u767B\u5834\u3059\u308B\u30E9\u30A4\u30D6\u30E9\u30EA\u540D\u306B\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30EC\u30B3\u30FC\u30C9\u304C\u306A\u3044\uFF09\n\n## \u4F7F\u7528\u3057\u306A\u3044\u30BF\u30A4\u30DF\u30F3\u30B0\n\n- \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u62BD\u51FA\u306E\u54C1\u8CEA\u304C\u8A31\u5BB9\u7BC4\u56F2\u5185\u306E\u3068\u304D\u2014\u2014\u8EFD\u5FAE\u306A\u4E0D\u7CBE\u78BA\u3055\u306F\u6B63\u5E38\n- \u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u306E\u91CD\u8981\u6027\u306B\u95A2\u3059\u308B\u4E3B\u89B3\u7684\u306A\u610F\u898B\u306E\u76F8\u9055\uFF08\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u304C\u62BD\u51FA\u3055\u308C\u3066\u3044\u306A\u3044\u3053\u3068\u304C\n  \u5E38\u306B\u898B\u843D\u3068\u3057\u3092\u610F\u5473\u3059\u308B\u308F\u3051\u3067\u306F\u306A\u3044\u2014\u2014\u62BD\u51FA\u5668\u306F\u4FE1\u983C\u5EA6\u95BE\u5024\u3092\u4F7F\u7528\u3057\u3066\u3044\u308B\uFF09\n\n## \u5831\u544A\u65B9\u6CD5\uFF08MCP\u30C4\u30FC\u30EB\uFF09\n\n`report_extraction_error` MCP\u30C4\u30FC\u30EB\u3092\u4F7F\u7528\u3057\u307E\u3059\uFF1A\n\n```\nreport_extraction_error(\n  entityName: string,      // \u30CE\u30FC\u30C8\u306B\u8A18\u8F09\u3055\u308C\u3066\u3044\u308B\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\n  errorType: \"false_positive\" | \"wrong_type\" | \"missed_entity\",\n  entityType?: string,     // \u73FE\u5728\u306E\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u30BF\u30A4\u30D7\uFF08wrong_type \u3068 false_positive \u306E\u5834\u5408\uFF09\n  correctType?: string,    // \u6B63\u3057\u3044\u30BF\u30A4\u30D7\uFF08wrong_type \u306E\u5834\u5408\uFF09\n  noteId?: number,         // \u554F\u984C\u3092\u78BA\u8A8D\u3057\u305F\u30CE\u30FC\u30C8\u306EID\n  details?: string         // \u30A8\u30E9\u30FC\u306B\u95A2\u3059\u308B\u8FFD\u52A0\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\n)\n```\n\n## \u5831\u544A\u65B9\u6CD5\uFF08CLI\u306E\u4EE3\u66FF\u624B\u6BB5\uFF09\n\n```bash\n# \u8AA4\u691C\u51FA\u3092\u5831\u544A\nknowledgine feedback report \\\n  --entity \"the\" \\\n  --type false_positive \\\n  --entity-type concept \\\n  --details \"Common English article incorrectly extracted as entity\"\n\n# \u8AA4\u3063\u305F\u5206\u985E\u3092\u5831\u544A\nknowledgine feedback report \\\n  --entity \"TypeScript\" \\\n  --type wrong_type \\\n  --entity-type person \\\n  --correct-type technology\n\n# \u898B\u843D\u3068\u3057\u3092\u5831\u544A\nknowledgine feedback report \\\n  --entity \"Zod\" \\\n  --type missed_entity \\\n  --details \"Validation library used throughout packages/core but not extracted\"\n```\n\n## \u30B9\u30C6\u30C3\u30D7\u30D0\u30A4\u30B9\u30C6\u30C3\u30D7\u306E\u624B\u9806\n\n1. **\u30A8\u30E9\u30FC\u30BF\u30A4\u30D7\u3092\u7279\u5B9A\u3059\u308B** \u2014 \u8AA4\u691C\u51FA\u3001\u8AA4\u3063\u305F\u5206\u985E\u3001\u898B\u843D\u3068\u3057\u306E\u3069\u308C\u304B\uFF1F\n2. **\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u540D\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u5B58\u5728\u3059\u308B\u5834\u5408\u306F `search_entities` \u3067\u6B63\u78BA\u306A\u767B\u9332\u540D\u3092\u78BA\u8A8D\u3059\u308B\n3. **\u30CE\u30FC\u30C8ID\u3092\u30E1\u30E2\u3059\u308B** \u2014 \u7279\u5B9A\u306E\u30CE\u30FC\u30C8\u3067\u30A8\u30E9\u30FC\u3092\u78BA\u8A8D\u3057\u305F\u5834\u5408\u306F\u3001\u305D\u306EID\u3092\u8A18\u9332\u3059\u308B\n4. **report_extraction_error\u3092\u547C\u3073\u51FA\u3059** \u2014 \u8A72\u5F53\u3059\u308B\u3059\u3079\u3066\u306E\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u542B\u3081\u308B\n5. **\u9001\u4FE1\u3092\u78BA\u8A8D\u3059\u308B** \u2014 \u30C4\u30FC\u30EB\u304C\u6210\u529F\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u8FD4\u3057\u305F\u3053\u3068\u3092\u78BA\u8A8D\u3059\u308B\n\n## \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u306E\u7BA1\u7406\n\n```bash\n# \u4FDD\u7559\u4E2D\u306E\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3092\u78BA\u8A8D\nknowledgine feedback list --status pending\n\n# \u7279\u5B9A\u306E\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3092\u9069\u7528\uFF08\u7BA1\u7406\u8005\u64CD\u4F5C\uFF09\nknowledgine feedback apply <id>\n\n# \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u3092\u9069\u7528\u305B\u305A\u306B\u5374\u4E0B\nknowledgine feedback dismiss <id>\n\n# \u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u306E\u7D71\u8A08\u3092\u78BA\u8A8D\nknowledgine feedback stats\n```\n\n## \u30D9\u30B9\u30C8\u30D7\u30E9\u30AF\u30C6\u30A3\u30B9\n\n- \u6700\u521D\u306B\u9AD8\u983B\u5EA6\u306E\u30A8\u30E9\u30FC\u3092\u5831\u544A\u3059\u308B\u2014\u2014\u6700\u3082\u5F71\u97FF\u304C\u5927\u304D\u3044\n- \u62BD\u51FA\u304C\u8AA4\u308A\u3067\u3042\u308B\u7406\u7531\u306B\u3064\u3044\u3066\u5177\u4F53\u7684\u306A\u8A73\u7D30\u3092\u542B\u3081\u308B\n- \u53EF\u80FD\u306A\u5834\u5408\u306F\u30CE\u30FC\u30C8ID\u3092\u53C2\u7167\u3057\u3066\u3001\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u304B\u3089\u30A8\u30E9\u30FC\u3092\u78BA\u8A8D\u3067\u304D\u308B\u3088\u3046\u306B\u3059\u308B\n- \u691C\u7D22\u54C1\u8CEA\u3078\u306E\u5B9F\u969B\u306E\u5F71\u97FF\u304C\u306A\u3044\u8EFD\u5FAE\u306A\u30B1\u30FC\u30B9\u306F\u5831\u544A\u3057\u306A\u3044\n\n## \u53C2\u7167\u30D5\u30A1\u30A4\u30EB\n\n- \u5404\u30A8\u30E9\u30FC\u30BF\u30A4\u30D7\u306E\u8A73\u7D30\u306A\u8AAC\u660E\u3068\u4F8B\u306F `error-types.md` \u3092\u53C2\u7167\n- \u52B9\u679C\u7684\u306A\u30D5\u30A3\u30FC\u30C9\u30D0\u30C3\u30AF\u30EC\u30DD\u30FC\u30C8\u306E\u66F8\u304D\u65B9\u306F `feedback-guide.md` \u3092\u53C2\u7167\n";
+//# sourceMappingURL=skill-md.ja.d.ts.map

package/dist/templates/skills/knowledgine-feedback/skill-md.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/skill-md.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,g7PA0GpB,CAAC"}

package/dist/templates/skills/knowledgine-feedback/skill-md.ja.js

@@ -0,0 +1,108 @@
+export const SKILL_MD = `---
+name: knowledgine-feedback
+version: "1.0.0"
+lang: ja
+description: >
+  ナレッジベースの品質を向上させるために、誤った・欠落している・誤分類されたエンティティ抽出を
+  報告します。存在すべきでないエンティティ（false_positive）、誤ったタイプに分類されたエンティティ
+  （wrong_type）、または実在するが抽出されなかったエンティティ（missed_entity）を発見したときに
+  呼び出してください。
+---
+# knowledgine-feedback
+
+## 目的
+
+エラーを報告することで、自動エンティティ抽出の品質を改善します。フィードバックは保存され、
+抽出ルールの更新に適用できます。これにより、将来のインジェストで同じエラーが繰り返されることを防ぎます。
+
+## 使用するタイミング
+
+- **誤検出（false positive）を発見したとき** — 実際には固有表現ではないエンティティが
+  抽出された場合（例：一般的な英単語が「technology」エンティティとして抽出された）
+- **誤った分類（wrong type）を発見したとき** — エンティティは存在するが誤分類されている場合
+  （例：「TypeScript」が「technology」ではなく「person」として分類されている）
+- **見落とし（missed entity）を発見したとき** — 重要なエンティティがまったく抽出されなかった場合
+  （例：頻繁に登場するライブラリ名にエンティティレコードがない）
+
+## 使用しないタイミング
+
+- エンティティ抽出の品質が許容範囲内のとき——軽微な不精確さは正常
+- エンティティの重要性に関する主観的な意見の相違（エンティティが抽出されていないことが
+  常に見落としを意味するわけではない——抽出器は信頼度閾値を使用している）
+
+## 報告方法（MCPツール）
+
+\`report_extraction_error\` MCPツールを使用します：
+
+\`\`\`
+report_extraction_error(
+  entityName: string,      // ノートに記載されているエンティティ名
+  errorType: "false_positive" | "wrong_type" | "missed_entity",
+  entityType?: string,     // 現在のエンティティタイプ（wrong_type と false_positive の場合）
+  correctType?: string,    // 正しいタイプ（wrong_type の場合）
+  noteId?: number,         // 問題を確認したノートのID
+  details?: string         // エラーに関する追加コンテキスト
+)
+\`\`\`
+
+## 報告方法（CLIの代替手段）
+
+\`\`\`bash
+# 誤検出を報告
+knowledgine feedback report \\
+  --entity "the" \\
+  --type false_positive \\
+  --entity-type concept \\
+  --details "Common English article incorrectly extracted as entity"
+
+# 誤った分類を報告
+knowledgine feedback report \\
+  --entity "TypeScript" \\
+  --type wrong_type \\
+  --entity-type person \\
+  --correct-type technology
+
+# 見落としを報告
+knowledgine feedback report \\
+  --entity "Zod" \\
+  --type missed_entity \\
+  --details "Validation library used throughout packages/core but not extracted"
+\`\`\`
+
+## ステップバイステップの手順
+
+1. **エラータイプを特定する** — 誤検出、誤った分類、見落としのどれか？
+2. **エンティティ名を確認する** — 存在する場合は \`search_entities\` で正確な登録名を確認する
+3. **ノートIDをメモする** — 特定のノートでエラーを確認した場合は、そのIDを記録する
+4. **report_extraction_errorを呼び出す** — 該当するすべてのパラメータを含める
+5. **送信を確認する** — ツールが成功レスポンスを返したことを確認する
+
+## フィードバックの管理
+
+\`\`\`bash
+# 保留中のフィードバックを確認
+knowledgine feedback list --status pending
+
+# 特定のフィードバックを適用（管理者操作）
+knowledgine feedback apply <id>
+
+# フィードバックを適用せずに却下
+knowledgine feedback dismiss <id>
+
+# フィードバックの統計を確認
+knowledgine feedback stats
+\`\`\`
+
+## ベストプラクティス
+
+- 最初に高頻度のエラーを報告する——最も影響が大きい
+- 抽出が誤りである理由について具体的な詳細を含める
+- 可能な場合はノートIDを参照して、コンテキストからエラーを確認できるようにする
+- 検索品質への実際の影響がない軽微なケースは報告しない
+
+## 参照ファイル
+
+- 各エラータイプの詳細な説明と例は \`error-types.md\` を参照
+- 効果的なフィードバックレポートの書き方は \`feedback-guide.md\` を参照
+`;
+//# sourceMappingURL=skill-md.ja.js.map

package/dist/templates/skills/knowledgine-feedback/skill-md.ja.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-md.ja.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/skill-md.ja.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0GvB,CAAC"}

package/dist/templates/skills/knowledgine-feedback/skill-md.js

@@ -1,5 +1,7 @@
 export const SKILL_MD = `---
 name: knowledgine-feedback
+version: "1.0.0"
+lang: en
 description: >
   Report incorrect, missing, or misclassified entity extractions to improve knowledge
   base quality. Invoke when you notice an entity that should not exist (false positive),
@@ -36,10 +38,10 @@ Use the \`report_extraction_error\` MCP tool:
 \`\`\`
 report_extraction_error(
   entityName: string,      // The entity name as it appears in the note
-  errorType: string,       // "false_positive" | "wrong_type" | "missed_entity"
+  errorType: "false_positive" | "wrong_type" | "missed_entity",
   entityType?: string,     // Current entity type (for wrong_type and false_positive)
   correctType?: string,    // What the type should be (for wrong_type)
-  noteId?: string,         // ID of the note where the issue was observed
+  noteId?: number,         // ID of the note where the issue was observed
   details?: string         // Additional context about the error
 )
 \`\`\`

package/dist/templates/skills/knowledgine-feedback/skill-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyGvB,CAAC"}
+{"version":3,"file":"skill-md.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-feedback/skill-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2GvB,CAAC"}

package/dist/templates/skills/knowledgine-ingest/references.ja.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCES: Record<string, string>;
+//# sourceMappingURL=references.ja.d.ts.map

package/dist/templates/skills/knowledgine-ingest/references.ja.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.ja.d.ts","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-ingest/references.ja.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmP7C,CAAC"}