@knowledgine/cli 0.4.1 → 0.6.0

package/dist/templates/skills/types.d.ts

@@ -0,0 +1,4 @@
+export declare const SUPPORTED_LOCALES: readonly ["en", "ja"];
+export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+export declare const DEFAULT_LOCALE: SupportedLocale;
+//# sourceMappingURL=types.d.ts.map

package/dist/templates/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/templates/skills/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,uBAAwB,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,eAAO,MAAM,cAAc,EAAE,eAAsB,CAAC"}

package/dist/templates/skills/types.js

@@ -0,0 +1,3 @@
+export const SUPPORTED_LOCALES = ["en", "ja"];
+export const DEFAULT_LOCALE = "en";
+//# sourceMappingURL=types.js.map

package/dist/templates/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/templates/skills/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC;AAEvD,MAAM,CAAC,MAAM,cAAc,GAAoB,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledgine/cli",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,9 +25,9 @@
     "log-symbols": "^7.0.1",
     "ora": "^9.3.0",
     "smol-toml": "^1.6.1",
-    "@knowledgine/ingest": "0.4.1",
-    "@knowledgine/mcp-server": "0.4.1",
-    "@knowledgine/core": "0.4.1"
+    "@knowledgine/mcp-server": "0.6.0",
+    "@knowledgine/core": "0.6.0",
+    "@knowledgine/ingest": "0.6.0"
   },
   "files": [
     "dist",

package/dist/lib/entity-extractor.d.ts

@@ -1,17 +0,0 @@
-import { KnowledgeRepository, GraphRepository } from "@knowledgine/core";
-export interface PostIngestSummary {
-    totalNotes: number;
-    processedNotes: number;
-    totalEntities: number;
-    totalRelations: number;
-    totalPatterns: number;
-    errors: number;
-}
-/**
- * 全ノートに対してパターン抽出、エンティティ抽出、関係推論をバッチ実行する。
- * init コマンドから ingest パイプライン経由でノートが保存された後に呼ばれる。
- *
- * @deprecated 新規コードは IncrementalExtractor を直接使用してください
- */
-export declare function postIngestProcessing(repository: KnowledgeRepository, graphRepository: GraphRepository, onProgress?: (current: number, total: number) => void): Promise<PostIngestSummary>;
-//# sourceMappingURL=entity-extractor.d.ts.map

package/dist/lib/entity-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-extractor.d.ts","sourceRoot":"","sources":["../../src/lib/entity-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAwB,MAAM,mBAAmB,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,mBAAmB,EAC/B,eAAe,EAAE,eAAe,EAChC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACpD,OAAO,CAAC,iBAAiB,CAAC,CAgB5B"}

package/dist/lib/entity-extractor.js

@@ -1,23 +0,0 @@
-import { KnowledgeRepository, GraphRepository, IncrementalExtractor } from "@knowledgine/core";
-/**
- * 全ノートに対してパターン抽出、エンティティ抽出、関係推論をバッチ実行する。
- * init コマンドから ingest パイプライン経由でノートが保存された後に呼ばれる。
- *
- * @deprecated 新規コードは IncrementalExtractor を直接使用してください
- */
-export async function postIngestProcessing(repository, graphRepository, onProgress) {
-    const notes = repository.getAllNotes();
-    const allNoteIds = notes.map((n) => n.id);
-    const totalNotes = notes.length;
-    const incrementalExtractor = new IncrementalExtractor(repository, graphRepository);
-    const summary = await incrementalExtractor.process(allNoteIds, onProgress);
-    return {
-        totalNotes,
-        processedNotes: summary.processedNotes,
-        totalEntities: summary.totalEntities,
-        totalRelations: summary.totalRelations,
-        totalPatterns: summary.totalPatterns,
-        errors: summary.errors,
-    };
-}
-//# sourceMappingURL=entity-extractor.js.map

package/dist/lib/entity-extractor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-extractor.js","sourceRoot":"","sources":["../../src/lib/entity-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAW/F;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAA+B,EAC/B,eAAgC,EAChC,UAAqD;IAErD,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAEhC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAE3E,OAAO;QACL,UAAU;QACV,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}

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

@@ -1,2 +0,0 @@
-export declare const SKILL_MD = "---\nname: knowledgine-explain\ndescription: >\n  Explore entities, knowledge graph connections, and design history for unfamiliar\n  components. Invoke when exploring code you did not write, tracing the history of a\n  design decision, or understanding how a named entity (technology, library, project,\n  person) relates to other parts of the knowledge base.\n---\n# knowledgine-explain\n\n## Purpose\n\nTrace the knowledge graph to understand why things are the way they are. Explain uses\nentity search and graph traversal to surface the full context around a component or\nconcept \u2014 not just what exists, but how it connects to other parts of the system and\nwhat decisions shaped it.\n\n## When to Use\n\n- **Exploring unfamiliar code** \u2014 Who wrote what and why? What decisions shaped this?\n- **Understanding design rationale** \u2014 What alternatives were considered?\n- **Tracing knowledge provenance** \u2014 Where did this pattern or approach come from?\n- **Auditing a technology choice** \u2014 Why is this library used here?\n- **Understanding relationships** \u2014 How do components A and B relate?\n\n## When NOT to Use\n\n- When you just need to find a specific past solution (use knowledgine-recall instead)\n- When the entity does not exist in the knowledge base yet\n- For trivial well-known concepts with no project-specific context\n\n## How to Explain (MCP Tools)\n\n### Step 1: Search for entities\n\n```\nsearch_entities(\n  query: string,   // Entity name, technology, concept, or person\n  limit?: number   // Max results (default 10)\n)\n```\n\n### Step 2: Explore entity graph\n\n```\nget_entity_graph(\n  entityId?: string,    // ID from search_entities result\n  entityName?: string   // Or search by name directly\n)\n```\n\n### Step 3: Find related notes\n\n```\nfind_related(\n  noteId?: string,    // A relevant note ID found in earlier steps\n  filePath?: string,  // Or a relevant file path\n  limit?: number,\n  maxHops?: number    // 1\u20133, default 2\n)\n```\n\n## How to Explain (CLI Alternative)\n\n```bash\nknowledgine explain \"<entity name or concept>\"\n```\n\n## Step-by-Step Instructions\n\n1. **Identify the subject** \u2014 What entity, component, or concept do you want to understand?\n2. **Search for the entity** \u2014 Call `search_entities` with the subject name\n3. **Inspect the entity graph** \u2014 Call `get_entity_graph` with the entity ID\n4. **Traverse related notes** \u2014 Call `find_related` for notes that mention this entity\n5. **Synthesize findings** \u2014 Summarize what you learned about the entity's history and connections\n\n## Best Practices\n\n- Start with `search_entities` to discover the exact entity name as stored in the knowledge base\n- Use `get_entity_graph` to map the neighborhood before diving into individual notes\n- Increase `maxHops` gradually \u2014 start at 1, go to 2 or 3 if the immediate neighborhood is sparse\n- Look specifically for notes tagged `design-decision` \u2014 they explain the \"why\"\n\n## Reference Files\n\n- See `entity-types.md` for the entity taxonomy used in knowledgine\n- See `graph-navigation.md` for how to traverse the knowledge graph effectively\n";
-//# sourceMappingURL=skill-md.d.ts.map

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

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

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

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

package/dist/templates/skills/knowledgine-recall/references.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-recall/references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8GvB;IAEC,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FlB;CACA,CAAC"}

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

@@ -1,2 +0,0 @@
-export declare const SKILL_MD = "---\nname: knowledgine-recall\ndescription: >\n  Search the local knowledge base for past solutions, design decisions, and patterns\n  before starting work. Invoke when facing an error or exception, when approaching an\n  unfamiliar area of the codebase, or when considering implementation approaches.\n  Prevents re-solving already-solved problems and surfaces relevant context proactively.\n---\n# knowledgine-recall\n\n## Purpose\n\nSearch accumulated project knowledge before solving problems from scratch. The knowledge\nbase contains past bug fixes, design decisions, troubleshooting records, and patterns\ngathered across all previous sessions. Searching first avoids duplicate work and surfaces\nwarnings about known pitfalls.\n\n## When to Use\n\n- **Error or exception encountered** \u2014 Search for the exact error message or key terms\n- **Unfamiliar code area** \u2014 Search for context about the component or module\n- **Implementation choice** \u2014 Search for past decisions on the same topic\n- **Considering a library or approach** \u2014 Search for known gotchas or prior art\n- **Starting work on a file** \u2014 Search for related notes about that file path\n\n## When NOT to Use\n\n- Purely mechanical tasks with no ambiguity (renaming a variable, formatting)\n- When you have already searched and found no relevant results within this session\n- Do not call recall on every single action \u2014 use judgment\n\n## How to Search (MCP Tool)\n\nUse the `search_knowledge` MCP tool:\n\n```\nsearch_knowledge(\n  query: string,          // Search query \u2014 see query tips below\n  mode: \"keyword\"         // \"keyword\" | \"semantic\" | \"hybrid\"\n       | \"semantic\"       //   keyword: exact text match (fast, precise)\n       | \"hybrid\",        //   semantic: meaning-based (requires embeddings)\n                          //   hybrid:   combines both (best results)\n  limit?: number          // Max results (default 10)\n)\n```\n\n## How to Search (CLI Alternative)\n\n```bash\nknowledgine recall \"<query>\"                    # keyword search\nknowledgine recall \"<query>\" --mode semantic    # semantic search\nknowledgine recall \"<query>\" --mode hybrid      # hybrid search\n```\n\n## Choosing Search Mode\n\n| Situation | Mode |\n|-----------|------|\n| You have an exact error message | `keyword` |\n| You remember specific function or variable names | `keyword` |\n| You know the concept but not the exact wording | `semantic` |\n| General exploration of a topic | `hybrid` |\n| Embeddings not available (FTS5-only setup) | `keyword` (only option) |\n\n## Step-by-Step Instructions\n\n1. **Identify the query** \u2014 Extract the key terms from the problem (see search-strategy.md)\n2. **Choose mode** \u2014 keyword for precise terms, semantic or hybrid for concepts\n3. **Call search_knowledge** \u2014 Pass query, mode, limit (5\u201310 is usually sufficient)\n4. **Evaluate results** \u2014 Read the returned notes for relevance\n5. **Apply findings** \u2014 Use relevant past solutions or decisions to inform your work\n6. **Capture if new** \u2014 If you discover a new solution, use knowledgine-capture to save it\n\n## Best Practices\n\n- Search before proposing a solution, not after\n- Use the actual error message text as a query \u2014 it is the most targeted search\n- Try multiple queries if the first returns no results\n- Combine recall + suggest at session start for comprehensive context\n\n## Reference Files\n\n- See `search-strategy.md` for when to use keyword vs semantic vs hybrid\n- See `query-tips.md` for how to formulate effective queries\n";
-//# sourceMappingURL=skill-md.d.ts.map

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

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

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

@@ -1,86 +0,0 @@
-export const SKILL_MD = `---
-name: knowledgine-recall
-description: >
-  Search the local knowledge base for past solutions, design decisions, and patterns
-  before starting work. Invoke when facing an error or exception, when approaching an
-  unfamiliar area of the codebase, or when considering implementation approaches.
-  Prevents re-solving already-solved problems and surfaces relevant context proactively.
----
-# knowledgine-recall
-
-## Purpose
-
-Search accumulated project knowledge before solving problems from scratch. The knowledge
-base contains past bug fixes, design decisions, troubleshooting records, and patterns
-gathered across all previous sessions. Searching first avoids duplicate work and surfaces
-warnings about known pitfalls.
-
-## When to Use
-
-- **Error or exception encountered** — Search for the exact error message or key terms
-- **Unfamiliar code area** — Search for context about the component or module
-- **Implementation choice** — Search for past decisions on the same topic
-- **Considering a library or approach** — Search for known gotchas or prior art
-- **Starting work on a file** — Search for related notes about that file path
-
-## When NOT to Use
-
-- Purely mechanical tasks with no ambiguity (renaming a variable, formatting)
-- When you have already searched and found no relevant results within this session
-- Do not call recall on every single action — use judgment
-
-## How to Search (MCP Tool)
-
-Use the \`search_knowledge\` MCP tool:
-
-\`\`\`
-search_knowledge(
-  query: string,          // Search query — see query tips below
-  mode: "keyword"         // "keyword" | "semantic" | "hybrid"
-       | "semantic"       //   keyword: exact text match (fast, precise)
-       | "hybrid",        //   semantic: meaning-based (requires embeddings)
-                          //   hybrid:   combines both (best results)
-  limit?: number          // Max results (default 10)
-)
-\`\`\`
-
-## How to Search (CLI Alternative)
-
-\`\`\`bash
-knowledgine recall "<query>"                    # keyword search
-knowledgine recall "<query>" --mode semantic    # semantic search
-knowledgine recall "<query>" --mode hybrid      # hybrid search
-\`\`\`
-
-## Choosing Search Mode
-
-| Situation | Mode |
-|-----------|------|
-| You have an exact error message | \`keyword\` |
-| You remember specific function or variable names | \`keyword\` |
-| You know the concept but not the exact wording | \`semantic\` |
-| General exploration of a topic | \`hybrid\` |
-| Embeddings not available (FTS5-only setup) | \`keyword\` (only option) |
-
-## Step-by-Step Instructions
-
-1. **Identify the query** — Extract the key terms from the problem (see search-strategy.md)
-2. **Choose mode** — keyword for precise terms, semantic or hybrid for concepts
-3. **Call search_knowledge** — Pass query, mode, limit (5–10 is usually sufficient)
-4. **Evaluate results** — Read the returned notes for relevance
-5. **Apply findings** — Use relevant past solutions or decisions to inform your work
-6. **Capture if new** — If you discover a new solution, use knowledgine-capture to save it
-
-## Best Practices
-
-- Search before proposing a solution, not after
-- Use the actual error message text as a query — it is the most targeted search
-- Try multiple queries if the first returns no results
-- Combine recall + suggest at session start for comprehensive context
-
-## Reference Files
-
-- See \`search-strategy.md\` for when to use keyword vs semantic vs hybrid
-- See \`query-tips.md\` for how to formulate effective queries
-`;
-//# sourceMappingURL=skill-md.js.map

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

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

package/dist/templates/skills/knowledgine-suggest/references.js

@@ -1,121 +0,0 @@
-export const REFERENCES = {
-    "context-patterns.md": `# Context Patterns
-
-How to extract effective context signals from your current work to generate meaningful
-knowledge suggestions.
-
----
-
-## Context Signal Types
-
-### 1. File Path Context
-
-The file path is often the most precise context signal. It encodes module, feature area,
-and component type simultaneously.
-
-**How to use**:
-- Pass the file path to \`find_related(filePath: "<path>")\` directly
-- Extract path segments for search queries
-
-**Examples**:
-| File Path | Extracted Query |
-|-----------|-----------------|
-| \`src/commands/setup.ts\` | \`"setup command configuration"\` |
-| \`packages/core/src/config/config-loader.ts\` | \`"config loader configuration"\` |
-| \`packages/ingest/src/plugins/github.ts\` | \`"github ingest plugin"\` |
-
-### 2. Task Description Context
-
-Transform the task description into a knowledge query by extracting nouns and
-technical terms.
-
-**Pattern**:
-\`\`\`
-Task: "Add support for TOML config files in the setup command"
-Query: "TOML configuration setup"
-Query: "config file format"
-\`\`\`
-
-**Pattern**:
-\`\`\`
-Task: "Fix the entity extraction pipeline to handle empty documents"
-Query: "entity extraction empty document"
-Query: "edge case null handling entity"
-\`\`\`
-
-### 3. Error Message Context
-
-When starting work to fix a specific error, use the error as the primary signal.
-
-**Pattern**:
-\`\`\`
-Error: "SQLITE_ERROR: table entities has no column 'confidence'"
-Query keyword: "SQLITE_ERROR entities column"
-Query keyword: "migration entities table"
-\`\`\`
-
-### 4. Feature Area Context
-
-When working on a broad feature, search for the feature domain.
-
-**Examples**:
-| Feature Area | Context Query |
-|-------------|---------------|
-| Authentication | \`"authentication session token"\` |
-| Search | \`"search_knowledge FTS5 semantic"\` |
-| Ingest pipeline | \`"ingest plugin markdown"\` |
-| MCP server | \`"MCP server start file watcher"\` |
-
----
-
-## Multi-Signal Queries
-
-Combine 2–3 signals for more targeted results:
-
-\`\`\`
-// File + task
-query: "config-loader TOML parsing"
-
-// Component + problem type
-query: "KnowledgeRepository null safety"
-
-// Technology + pattern
-query: "sqlite migration schema change"
-\`\`\`
-
----
-
-## Using find_related for Graph Traversal
-
-After finding an initial relevant note, use \`find_related\` to discover connected notes:
-
-\`\`\`
-// Found note ID "abc123" about config loading
-find_related(noteId: "abc123", limit: 10, maxHops: 2)
-
-// Or search by the current file path directly
-find_related(filePath: "packages/core/src/config/config-loader.ts", limit: 10)
-\`\`\`
-
-**maxHops guidance**:
-| maxHops | Effect |
-|---------|--------|
-| 1 | Direct references only — fast, focused |
-| 2 | One degree of separation — good default |
-| 3 | Broader graph — use for open-ended exploration |
-
----
-
-## Suggest vs Recall Decision Guide
-
-| Situation | Use |
-|-----------|-----|
-| You have a specific error message | knowledgine-recall |
-| You know exactly what to search for | knowledgine-recall |
-| You are starting work, unsure what is relevant | knowledgine-suggest |
-| You want to discover what you don't know | knowledgine-suggest |
-| You have a file path but no specific query | knowledgine-suggest |
-| You want both targeted + exploratory | suggest first, then recall |
-`,
-};
-//# sourceMappingURL=references.js.map

package/dist/templates/skills/knowledgine-suggest/references.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../../../../src/templates/skills/knowledgine-suggest/references.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqHxB;CACA,CAAC"}

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

@@ -1,2 +0,0 @@
-export declare const SKILL_MD = "---\nname: knowledgine-suggest\ndescription: >\n  Get contextual knowledge suggestions based on the current work context \u2014 the file\n  being edited, the task being performed, or the error being investigated. Invoke at\n  the start of a work session, when opening a new file, or when beginning a feature.\n  Surfaces relevant past knowledge proactively without requiring a specific query.\n---\n# knowledgine-suggest\n\n## Purpose\n\nSurface relevant knowledge from the knowledge base based on contextual signals extracted\nfrom the current work, rather than a specific search query. Suggest combines search and\ngraph traversal to bring forward knowledge you might not know to search for.\n\n## When to Use\n\n- **Starting a session** \u2014 Get context about the area you will work in\n- **Opening a new file** \u2014 Discover past knowledge about that component\n- **Beginning a feature** \u2014 Find related patterns and past decisions\n- **Before making changes** \u2014 Check for warnings or prior art on the topic\n- **Exploring an unfamiliar module** \u2014 Find related entities and notes\n\n## When NOT to Use\n\n- When you already have a specific query in mind (use knowledgine-recall instead)\n- When working on trivial mechanical tasks with no design ambiguity\n- After already calling suggest for the same file in the same session\n\n## How to Get Suggestions (MCP Tools)\n\n### Step 1: Search by context\n\n```\nsearch_knowledge(\n  query: string,   // Derived from file path, task description, or component name\n  mode: \"hybrid\",  // Hybrid gives best results for context-based queries\n  limit: 10\n)\n```\n\n### Step 2: Find related notes (if you have a note ID or file path)\n\n```\nfind_related(\n  noteId?: string,    // ID of a relevant note found in step 1\n  filePath?: string,  // Current file path being worked on\n  limit?: number,     // Max results (default 10)\n  maxHops?: number    // Graph traversal depth (default 2)\n)\n```\n\n## How to Get Suggestions (CLI Alternative)\n\n```bash\nknowledgine suggest \"<context description>\"\nknowledgine suggest --file src/commands/setup.ts\n```\n\n## Extracting Context\n\nThe quality of suggestions depends on the context you provide. Extract signals from:\n\n| Signal | Example |\n|--------|---------|\n| Current file path | `src/commands/setup.ts` |\n| Component or class name | `SetupCommand`, `KnowledgeRepository` |\n| Task description | `\"add TOML config support to setup command\"` |\n| Feature area | `\"MCP configuration\", \"entity extraction\"` |\n| Error message | `\"TypeError: Cannot set properties of undefined\"` |\n\n## Step-by-Step Instructions\n\n1. **Extract context signals** from the current task (see context-patterns.md)\n2. **Build a query** \u2014 Combine the most specific signals into a search query\n3. **Call search_knowledge** with mode: \"hybrid\" and the derived query\n4. **Review results** \u2014 Read the top 3\u20135 most relevant notes\n5. **Traverse related notes** \u2014 Call find_related with a relevant noteId or the current filePath\n6. **Summarize findings** \u2014 Note any relevant warnings, patterns, or decisions found\n7. **Proceed informed** \u2014 Use the discovered context to guide your implementation\n\n## Best Practices\n\n- Run suggest once at session start for the primary area of work\n- Combine with knowledgine-recall for targeted queries as specific issues arise\n- Prioritize notes tagged with `bug-fix` or `troubleshooting` \u2014 they contain warnings\n- Notes tagged `design-decision` are especially valuable before making changes\n\n## Reference Files\n\n- See `context-patterns.md` for how to extract effective context from your current work\n";
-//# sourceMappingURL=skill-md.d.ts.map

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

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

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

@@ -1,94 +0,0 @@
-export const SKILL_MD = `---
-name: knowledgine-suggest
-description: >
-  Get contextual knowledge suggestions based on the current work context — the file
-  being edited, the task being performed, or the error being investigated. Invoke at
-  the start of a work session, when opening a new file, or when beginning a feature.
-  Surfaces relevant past knowledge proactively without requiring a specific query.
----
-# knowledgine-suggest
-
-## Purpose
-
-Surface relevant knowledge from the knowledge base based on contextual signals extracted
-from the current work, rather than a specific search query. Suggest combines search and
-graph traversal to bring forward knowledge you might not know to search for.
-
-## When to Use
-
-- **Starting a session** — Get context about the area you will work in
-- **Opening a new file** — Discover past knowledge about that component
-- **Beginning a feature** — Find related patterns and past decisions
-- **Before making changes** — Check for warnings or prior art on the topic
-- **Exploring an unfamiliar module** — Find related entities and notes
-
-## When NOT to Use
-
-- When you already have a specific query in mind (use knowledgine-recall instead)
-- When working on trivial mechanical tasks with no design ambiguity
-- After already calling suggest for the same file in the same session
-
-## How to Get Suggestions (MCP Tools)
-
-### Step 1: Search by context
-
-\`\`\`
-search_knowledge(
-  query: string,   // Derived from file path, task description, or component name
-  mode: "hybrid",  // Hybrid gives best results for context-based queries
-  limit: 10
-)
-\`\`\`
-
-### Step 2: Find related notes (if you have a note ID or file path)
-
-\`\`\`
-find_related(
-  noteId?: string,    // ID of a relevant note found in step 1
-  filePath?: string,  // Current file path being worked on
-  limit?: number,     // Max results (default 10)
-  maxHops?: number    // Graph traversal depth (default 2)
-)
-\`\`\`
-
-## How to Get Suggestions (CLI Alternative)
-
-\`\`\`bash
-knowledgine suggest "<context description>"
-knowledgine suggest --file src/commands/setup.ts
-\`\`\`
-
-## Extracting Context
-
-The quality of suggestions depends on the context you provide. Extract signals from:
-
-| Signal | Example |
-|--------|---------|
-| Current file path | \`src/commands/setup.ts\` |
-| Component or class name | \`SetupCommand\`, \`KnowledgeRepository\` |
-| Task description | \`"add TOML config support to setup command"\` |
-| Feature area | \`"MCP configuration", "entity extraction"\` |
-| Error message | \`"TypeError: Cannot set properties of undefined"\` |
-
-## Step-by-Step Instructions
-
-1. **Extract context signals** from the current task (see context-patterns.md)
-2. **Build a query** — Combine the most specific signals into a search query
-3. **Call search_knowledge** with mode: "hybrid" and the derived query
-4. **Review results** — Read the top 3–5 most relevant notes
-5. **Traverse related notes** — Call find_related with a relevant noteId or the current filePath
-6. **Summarize findings** — Note any relevant warnings, patterns, or decisions found
-7. **Proceed informed** — Use the discovered context to guide your implementation
-
-## Best Practices
-
-- Run suggest once at session start for the primary area of work
-- Combine with knowledgine-recall for targeted queries as specific issues arise
-- Prioritize notes tagged with \`bug-fix\` or \`troubleshooting\` — they contain warnings
-- Notes tagged \`design-decision\` are especially valuable before making changes
-
-## Reference Files
-
-- See \`context-patterns.md\` for how to extract effective context from your current work
-`;
-//# sourceMappingURL=skill-md.js.map