open-wiki-spec 0.1.0 → 0.2.0

package/dist/cli/init/meta-files.js

@@ -55,23 +55,19 @@ This file is the entry point for navigating the vault.
 
 ## Note Types
 
+This file is a manual entry point. Use \`ows list\` for the current vault contents.
+
 ### Features
-<!-- Auto-populated by ows or manually maintained -->
 
 ### Systems
-<!-- Auto-populated by ows or manually maintained -->
 
 ### Active Changes
-<!-- Auto-populated by ows or manually maintained -->
 
 ### Decisions
-<!-- Auto-populated by ows or manually maintained -->
 
 ### Sources
-<!-- Auto-populated by ows or manually maintained -->
 
 ### Queries
-<!-- Auto-populated by ows or manually maintained -->
 `;
     fs.writeFileSync(path.join(wikiPath, '00-meta', 'index.md'), content);
 }
@@ -107,7 +103,7 @@ type: meta
 ## Frontmatter Rules
 
 - \`id\` is immutable after creation. Never change it.
-- \`status\` must follow the allowed lifecycle transitions.
+- \`status\` should follow the allowed lifecycle transitions.
 - Wikilinks in frontmatter use the format: \`"[[Note Title]]"\`.
 
 ## Wikilink Conventions
@@ -118,23 +114,23 @@ type: meta
 
 ## Section Conventions
 
-- Each note type has minimum required sections (see [[schema]]).
+- Each note type has recommended sections (see [[schema]]).
 - Additional sections can be added freely.
-- Section names must match the expected names exactly (case-sensitive).
+- Section names should match the expected names exactly (case-sensitive).
 
 ## Requirement Conventions
 
 - Requirements live inside Feature notes under \`## Requirements\`.
 - Each requirement: \`### Requirement: <name>\` with \`<name>\` unique within the Feature.
-- Normative statement must contain \`SHALL\` or \`MUST\`.
-- Each requirement needs at least one \`#### Scenario:\` with \`WHEN\`/\`THEN\` format.
+- Normative statement should contain \`SHALL\` or \`MUST\`.
+- Each requirement should have at least one \`#### Scenario:\` with \`WHEN\`/\`THEN\` format.
 
 ## Delta Summary Conventions
 
 - Delta Summary lives inside Change notes under \`## Delta Summary\`.
 - Operations: \`ADDED\`, \`MODIFIED\`, \`REMOVED\`, \`RENAMED\`.
 - Apply order: RENAMED -> REMOVED -> MODIFIED -> ADDED.
-- MODIFIED/REMOVED/RENAMED entries include \`[base: <content_hash>]\`.
+- MODIFIED/REMOVED/RENAMED entries should include \`[base: <content_hash>]\`.
 `;
     fs.writeFileSync(path.join(wikiPath, '00-meta', 'conventions.md'), content);
 }

package/dist/cli/init/meta-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-files.js","sourceRoot":"","sources":["../../../src/cli/init/meta-files.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG;;mBAEC,cAAc;mBACd,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;;;;;;;IAOrC,cAAc;;;;;;;;;;;;;;;;;;;;CAoBjB,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjB,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG;;;;;;;;;;IAUd,IAAI;CACP,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CjB,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,SAAiB,EACjB,MAAc,EACd,QAAgB,KAAK;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,KAAK,IAAI,MAAM,SAAS,MAAM,MAAM,MAAM,KAAK,IAAI,CAAC;IAClE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,IAAU;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"meta-files.js","sourceRoot":"","sources":["../../../src/cli/init/meta-files.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG;;mBAEC,cAAc;mBACd,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;;;;;;;IAOrC,cAAc;;;;;;;;;;;;;;;;;;;;CAoBjB,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BjB,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG;;;;;;;;;;IAUd,IAAI;CACP,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CjB,CAAC;IACA,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,SAAiB,EACjB,MAAc,EACd,QAAgB,KAAK;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,KAAK,IAAI,MAAM,SAAS,MAAM,MAAM,MAAM,KAAK,IAAI,CAAC;IAClE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,IAAU;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC"}

package/dist/cli/init/skill-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../../src/cli/init/skill-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA+sB3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAQnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE"}
+{"version":3,"file":"skill-generator.d.ts","sourceRoot":"","sources":["../../../src/cli/init/skill-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA0wB3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAQnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAahE"}

package/dist/cli/init/skill-generator.js

@@ -19,7 +19,22 @@ export const WORKFLOW_SKILLS = {
 
    **IMPORTANT**: Do NOT proceed without understanding what the user wants.
 
-2. **Run preflight retrieval (dry-run first)**
+2. **If input is long natural language, refine it first**
+
+   Extract the core from the user's input:
+   - **intent**: add / modify / remove / query
+   - **keywords**: 3-5 essential keywords (prioritize technical terms, feature names, system names)
+   - **summary**: 1-sentence summary
+
+   Example: "우리 앱에서 워치랑 연동해서 수영 기록을 자동으로 가져오는데 HealthKit에서 데이터를 못 가져오는 케이스가 있어서 그걸 Sentry로 추적하고 싶거든"
+   → summary: "HealthKit 워치 동기화 실패 Sentry 추적"
+   → keywords: "워치 동기화,HealthKit,Sentry,에러 추적"
+
+3. **Run preflight retrieval (dry-run first)**
+   \`\`\`bash
+   ows propose "<summary>" --keywords "<keyword1>,<keyword2>,..." --dry-run --json
+   \`\`\`
+   If the user's input is already concise, skip \`--keywords\` and use the input directly:
    \`\`\`bash
    ows propose "<user's description>" --dry-run --json
    \`\`\`
@@ -30,7 +45,7 @@ export const WORKFLOW_SKILLS = {
    - \`classification.primary_candidate\`: the top matching note
    - \`sequencing_warnings\`: any parallel work conflicts
 
-3. **Act based on classification**
+4. **Act based on classification**
 
    ---
 
@@ -47,24 +62,27 @@ export const WORKFLOW_SKILLS = {
 
    ---
 
-4. **Execute the propose (if confirmed)**
+5. **Execute the propose (if confirmed)**
+
+   **IMPORTANT**: Use the same \`--keywords\` from the dry-run step to ensure consistent retrieval results.
 
    For \`new_feature\` or \`existing_feature\` classification, run directly:
    \`\`\`bash
-   ows propose "<user's description>" --json
+   ows propose "<summary>" --keywords "<keyword1>,<keyword2>,..." --json
    \`\`\`
 
-   For \`needs_confirmation\` (after user chooses), use \`--force-classification\` to override:
+   For \`needs_confirmation\` (after user chooses), use \`--force-classification\` AND \`--force-target\`:
    \`\`\`bash
    # User chose to create new Feature + Change:
-   ows propose "<user's description>" --force-classification new_feature --json
-   # User chose an existing Feature:
-   ows propose "<user's description>" --force-classification existing_feature --json
-   # User chose to continue an existing Change:
-   ows propose "<user's description>" --force-classification existing_change --json
+   ows propose "<summary>" --force-classification new_feature --json
+   # User chose an existing Feature (use the candidate id from dry-run):
+   ows propose "<summary>" --force-classification existing_feature --force-target "<candidate-id>" --json
+   # User chose to continue an existing Change (hand off to continue):
+   /ows-continue <candidate-change-id>
    \`\`\`
+   **IMPORTANT**: When user picks \`existing_feature\` or \`existing_change\`, always include \`--force-target <id>\` with the candidate's actual id from the dry-run results. Without it, the engine uses the top candidate which may not be what the user chose.
 
-5. **Show results**
+6. **Show results**
 
    Display:
    - Classification decision and reasoning
@@ -79,6 +97,14 @@ After completing, summarize:
 - Why (classification reasoning from retrieval)
 - What to do next
 
+**Retrieval Quality**
+
+The propose workflow automatically enriches the query with system_terms by matching feature/entity terms against System note titles and aliases in the vault index. This means:
+- System-related queries like "auth login" will auto-detect System notes titled "Authentication" and use them for scoring
+- Partial title matches are supported: a search for "auth" will match "Feature: Auth Login" (partial match, +20 points)
+- Title prefix stripping: "auth login" matches "Feature: Auth Login" (prefix-stripped match, +30 points)
+- Derived aliases are auto-generated from note titles and IDs, improving alias-based matching even when no explicit aliases are set
+
 **Guardrails**
 - Always show dry-run results before creating anything
 - If classification is \`needs_confirmation\`, NEVER auto-decide — always ask the user
@@ -90,15 +116,18 @@ After completing, summarize:
         description: 'Continue work on an existing Change.',
         instructions: `Continue working on an existing Change by filling sections or advancing status.
 
-**Input**: Optionally specify a change ID after \`/ows-continue\` (e.g., \`/ows-continue change-add-auth\`). If omitted, prompt for selection.
+**Input**: Optionally specify a change ID after \`/ows-continue\` (e.g., \`/ows-continue change-add-auth\`). If omitted and only one active change exists, it is auto-selected. If multiple active changes exist, the CLI returns a list and the agent must ask the user to choose.
 
 **Steps**
 
-1. **If no change ID provided, prompt for selection**
+1. **If no change ID provided**
 
-   Run \`ows list --json\` to get active changes. Show them and let the user pick.
+   Run \`ows continue --json\`. The CLI will:
+   - **If 1 active change**: auto-select it and proceed.
+   - **If 2+ active changes**: return an error with the list of active changes. Show them and let the user pick, then re-run with the chosen ID.
+   - **If 0 active changes**: return an error. Suggest \`/ows-propose\` to create one.
 
-   **IMPORTANT**: Do NOT guess or auto-select. Always let the user choose.
+   **IMPORTANT**: When the CLI returns multiple active changes, NEVER auto-select. Always ask the user.
 
 2. **Check current status**
    \`\`\`bash
@@ -144,9 +173,20 @@ After each invocation, show:
 - Section/task progress
 - What to do next
 
+**Context Enrichment**
+
+The continue result includes a \`context\` object with real content from linked notes (truncated at 500 chars per section):
+- \`context.features[]\`: Purpose, Current Behavior, Requirements sections from linked Feature notes
+- \`context.decisions[]\`: Summary, Context, Decision sections from linked Decision notes
+- \`context.systems[]\`: Purpose, Boundaries sections from linked System notes
+- \`context.sources[]\`: Summary, Content sections from linked Source notes
+
+Use this context to inform section writing (especially Why and Delta Summary).
+
 **Guardrails**
 - Perform ONE section fill or ONE status transition per invocation
 - Always read the Change note before modifying it
+- Use the \`context\` from the continue result to inform your writing — do not ignore linked note content
 - If context is unclear, ask the user before writing
 - Show status after every change
 - The continue workflow owns proposed->planned and planned->in_progress transitions ONLY
@@ -206,7 +246,11 @@ After each invocation, show:
    - **Phase 1** (validate & compute): Parse Delta Summary, stale-check all entries, pre-validate operations. No files written.
    - **Phase 2** (write): Only if Phase 1 passes. Apply operations in **atomic order**: RENAMED -> REMOVED -> MODIFIED -> ADDED.
 
-   Programmatic operations (RENAMED, REMOVED) are executed directly. Agent-driven operations (MODIFIED, ADDED) may require the agent to write content.
+   The apply engine programmatically modifies Feature notes:
+   - **RENAMED**: Automatically renames the requirement in the Feature note. Fully automated.
+   - **REMOVED**: Automatically removes the requirement from the Feature note. Fully automated.
+   - **MODIFIED**: Inserts a \`<!-- MODIFIED by change: <changeId> -->\` marker after the requirement heading. The agent must then update the requirement text.
+   - **ADDED**: Inserts a \`<!-- ADDED by change: <changeId>. Fill in normative statement (SHALL/MUST) and scenarios (WHEN/THEN). -->\` marker in the Requirements section. The agent must then write the new requirement content.
 
 5. **Show final state**
    \`\`\`bash
@@ -591,6 +635,7 @@ The change has been archived. Decision history is preserved.
 **Available flags**:
 - \`--json\`: Output structured JSON result
 - \`--force\`: Force re-initialization, recreating meta files even if they exist
+- \`--skip-seed\`: Skip creating seed notes (source and system placeholders)
 
 **Steps**
 
@@ -601,6 +646,8 @@ The change has been archived. Decision history is preserved.
    ows init <path> --json
    # force re-init:
    ows init --force --json
+   # skip seed notes:
+   ows init --skip-seed --json
    \`\`\`
 
 2. **Parse the result**
@@ -610,6 +657,7 @@ The change has been archived. Decision history is preserved.
    - \`wikiPath\`: path to the created wiki directory
    - \`directoriesCreated\`: list of directories created
    - \`metaFilesCreated\`: list of meta files created (log.md, index, etc.)
+   - \`seedFilesCreated\`: list of seed notes created (Source and System placeholders)
    - \`skillFilesGenerated\`: list of Claude Code skill files generated
    - \`warnings\`: any warnings during initialization
 
@@ -622,11 +670,13 @@ The change has been archived. Decision history is preserved.
    Created new vault at: <wikiPath>
    - N directories created
    - N meta files created
+   - N seed notes created
    - N skill files generated
 
    Next steps:
-   - Run \`/ows-propose\` to create your first Change
-   - Run \`/ows-query\` to search the vault
+   1. Edit \`wiki/01-sources/seed-context.md\` to describe your project (stack, constraints, goals)
+   2. Edit \`wiki/02-systems/default-system.md\` to define your primary system boundary
+   3. Run \`/ows-propose\` to create your first Change
    \`\`\`
 
    **If extend** (existing directory):
@@ -637,12 +687,21 @@ The change has been archived. Decision history is preserved.
    - N new directories added
    - N meta files updated
 
-   Your existing notes are preserved.
+   Your existing notes are preserved. Seed notes are not overwritten.
    \`\`\`
 
+**Seed Notes**
+
+On fresh init, two seed notes are created:
+- \`wiki/01-sources/seed-context.md\` — A placeholder Source note for the user to fill with project context (tech stack, goals, constraints)
+- \`wiki/02-systems/default-system.md\` — A default System note for the user to define their primary system boundary
+
+In extend mode, existing seed notes are never overwritten. Use \`--skip-seed\` to skip seed creation entirely.
+
 **Guardrails**
 - If the vault already exists and --force is not used, the init will extend rather than overwrite
 - Never destroy existing vault content
+- Encourage the user to edit seed-context.md after init — it improves retrieval quality
 - Show warnings if any files were skipped`,
     },
     migrate: {

package/dist/cli/init/skill-generator.js.map

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

package/dist/cli/init/types.d.ts

@@ -10,12 +10,15 @@ export interface InitOptions {
     nonInteractive?: boolean;
     /** Output as JSON */
     json?: boolean;
+    /** Skip seed note generation */
+    skipSeed?: boolean;
 }
 export interface InitResult {
     mode: 'fresh' | 'extend';
     wikiPath: string;
     directoriesCreated: string[];
     metaFilesCreated: string[];
+    seedFilesCreated: string[];
     skillFilesGenerated: string[];
     warnings: string[];
 }

package/dist/cli/init/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/init/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/init/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/core/embedding/cache.d.ts

@@ -0,0 +1,28 @@
+export interface EmbeddingCacheEntry {
+    vector: number[];
+    content_hash: string;
+}
+export interface EmbeddingCache {
+    model: string;
+    entries: Record<string, EmbeddingCacheEntry>;
+}
+export declare function createEmptyCache(model: string): EmbeddingCache;
+/**
+ * Load embedding cache from disk.
+ * Returns null if file doesn't exist, is corrupted, or model mismatches.
+ */
+export declare function loadEmbeddingCache(filePath: string, expectedModel?: string): EmbeddingCache | null;
+/**
+ * Save embedding cache to disk atomically (write-to-temp-then-rename).
+ * Prevents corruption from interrupted or concurrent writes.
+ */
+export declare function saveEmbeddingCache(filePath: string, cache: EmbeddingCache): void;
+/**
+ * Get cached vector if content_hash matches.
+ */
+export declare function getCachedVector(cache: EmbeddingCache, id: string, currentHash: string): number[] | null;
+/**
+ * Store a vector in the cache.
+ */
+export declare function setCachedVector(cache: EmbeddingCache, id: string, vector: number[], contentHash: string): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/embedding/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/embedding/cache.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC9C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAE9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,GAAG,IAAI,CAWvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAMhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,GAAG,IAAI,CAIjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,MAAM,GAClB,IAAI,CAEN"}

package/dist/core/embedding/cache.js

@@ -0,0 +1,53 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+export function createEmptyCache(model) {
+    return { model, entries: {} };
+}
+/**
+ * Load embedding cache from disk.
+ * Returns null if file doesn't exist, is corrupted, or model mismatches.
+ */
+export function loadEmbeddingCache(filePath, expectedModel) {
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (!data.model || !data.entries || typeof data.entries !== 'object')
+            return null;
+        if (expectedModel && data.model !== expectedModel)
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save embedding cache to disk atomically (write-to-temp-then-rename).
+ * Prevents corruption from interrupted or concurrent writes.
+ */
+export function saveEmbeddingCache(filePath, cache) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmpPath = path.join(dir, `.embeddings-${crypto.randomBytes(4).toString('hex')}.tmp`);
+    fs.writeFileSync(tmpPath, JSON.stringify(cache), 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Get cached vector if content_hash matches.
+ */
+export function getCachedVector(cache, id, currentHash) {
+    const entry = cache.entries[id];
+    if (!entry || entry.content_hash !== currentHash)
+        return null;
+    return entry.vector;
+}
+/**
+ * Store a vector in the cache.
+ */
+export function setCachedVector(cache, id, vector, contentHash) {
+    cache.entries[id] = { vector, content_hash: contentHash };
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/embedding/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/embedding/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAYtC,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,aAAsB;IAEtB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClF,IAAI,aAAa,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa;YAAE,OAAO,IAAI,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAqB;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3F,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1D,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAqB,EACrB,EAAU,EACV,WAAmB;IAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAqB,EACrB,EAAU,EACV,MAAgB,EAChB,WAAmB;IAEnB,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5D,CAAC"}

package/dist/core/embedding/embedder.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Embedding model wrapper with graceful degradation.
+ * Uses @huggingface/transformers when available, otherwise returns null vectors.
+ */
+export declare const DEFAULT_MODEL = "Xenova/multilingual-e5-small";
+export type EmbedPipeline = (text: string) => Promise<number[]>;
+export interface Embedder {
+    available: boolean;
+    embed: (text: string) => Promise<number[] | null>;
+    embedBatch: (texts: string[]) => Promise<(number[] | null)[]>;
+}
+export interface CreateEmbedderOptions {
+    /** If false, skip model loading (for testing). */
+    loadModel?: boolean;
+    /** Inject a mock pipeline (for testing). */
+    pipeline?: EmbedPipeline;
+    /** Model name override. */
+    model?: string;
+}
+/**
+ * Create an embedder instance.
+ * When @huggingface/transformers is not installed or loadModel is false,
+ * returns a no-op embedder (available: false).
+ */
+export declare function createEmbedder(options?: CreateEmbedderOptions): Promise<Embedder>;
+//# sourceMappingURL=embedder.d.ts.map

package/dist/core/embedding/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../../src/core/embedding/embedder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,aAAa,iCAAiC,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEhE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,QAAQ,CAAC,CAsCnB"}

package/dist/core/embedding/embedder.js

@@ -0,0 +1,51 @@
+/**
+ * Embedding model wrapper with graceful degradation.
+ * Uses @huggingface/transformers when available, otherwise returns null vectors.
+ */
+export const DEFAULT_MODEL = 'Xenova/multilingual-e5-small';
+/**
+ * Create an embedder instance.
+ * When @huggingface/transformers is not installed or loadModel is false,
+ * returns a no-op embedder (available: false).
+ */
+export async function createEmbedder(options = {}) {
+    const { loadModel = true, pipeline: injectedPipeline, model = DEFAULT_MODEL } = options;
+    // If a mock pipeline is injected, use it directly
+    if (injectedPipeline) {
+        return {
+            available: true,
+            embed: async (text) => injectedPipeline(text),
+            embedBatch: async (texts) => Promise.all(texts.map((t) => injectedPipeline(t))),
+        };
+    }
+    if (!loadModel) {
+        return createNullEmbedder();
+    }
+    // Try to load @huggingface/transformers dynamically
+    try {
+        const { pipeline } = await import('@huggingface/transformers');
+        const extractor = await pipeline('feature-extraction', model, {
+            dtype: 'q8',
+        });
+        const embedFn = async (text) => {
+            const output = await extractor(text, { pooling: 'mean', normalize: true });
+            return Array.from(output.data);
+        };
+        return {
+            available: true,
+            embed: async (text) => embedFn(text),
+            embedBatch: async (texts) => Promise.all(texts.map((t) => embedFn(t))),
+        };
+    }
+    catch {
+        return createNullEmbedder();
+    }
+}
+function createNullEmbedder() {
+    return {
+        available: false,
+        embed: async () => null,
+        embedBatch: async (texts) => texts.map(() => null),
+    };
+}
+//# sourceMappingURL=embedder.js.map

package/dist/core/embedding/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../../src/core/embedding/embedder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,8BAA8B,CAAC;AAmB5D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAiC,EAAE;IAEnC,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IAExF,kDAAkD;IAClD,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACrD,UAAU,EAAE,KAAK,EAAE,KAAe,EAAE,EAAE,CACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;SACrD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,kBAAkB,EAAE,CAAC;IAC9B,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,KAAK,EAAE;YAC5D,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,MAAM,OAAO,GAAkB,KAAK,EAAE,IAAY,EAAE,EAAE;YACpD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;QACjD,CAAC,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;YAC5C,UAAU,EAAE,KAAK,EAAE,KAAe,EAAE,EAAE,CACpC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;SAC5C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QACvB,UAAU,EAAE,KAAK,EAAE,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/core/embedding/index.d.ts

@@ -0,0 +1,5 @@
+export { cosineSimilarity } from './similarity.js';
+export { loadEmbeddingCache, saveEmbeddingCache, getCachedVector, setCachedVector, createEmptyCache, type EmbeddingCache, type EmbeddingCacheEntry, } from './cache.js';
+export { createEmbedder, DEFAULT_MODEL, type Embedder, type EmbedPipeline, type CreateEmbedderOptions, } from './embedder.js';
+export { computeSemanticRecall, type SemanticRecallResult, type SemanticRecallOptions, } from './semantic-recall.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/embedding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/core/embedding/index.js

@@ -0,0 +1,5 @@
+export { cosineSimilarity } from './similarity.js';
+export { loadEmbeddingCache, saveEmbeddingCache, getCachedVector, setCachedVector, createEmptyCache, } from './cache.js';
+export { createEmbedder, DEFAULT_MODEL, } from './embedder.js';
+export { computeSemanticRecall, } from './semantic-recall.js';
+//# sourceMappingURL=index.js.map

package/dist/core/embedding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,GAGjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,aAAa,GAId,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC"}

package/dist/core/embedding/semantic-recall.d.ts

@@ -0,0 +1,18 @@
+import type { EmbeddingCache } from './cache.js';
+import type { Embedder } from './embedder.js';
+export interface SemanticRecallOptions {
+    /** Max number of candidates to return. Default: 20 */
+    topK?: number;
+    /** Minimum cosine similarity to include. Default: 0.5 */
+    minScore?: number;
+}
+export interface SemanticRecallResult {
+    /** Cosine similarities per note ID (keys = candidate IDs). */
+    scores: ReadonlyMap<string, number>;
+}
+/**
+ * Find semantically similar notes by comparing query embedding against cached note embeddings.
+ * Returns topK candidates above minScore, sorted by similarity descending.
+ */
+export declare function computeSemanticRecall(querySummary: string, cache: EmbeddingCache, embedder: Embedder, options?: SemanticRecallOptions): Promise<SemanticRecallResult>;
+//# sourceMappingURL=semantic-recall.d.ts.map

package/dist/core/embedding/semantic-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../../../src/core/embedding/semantic-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}

package/dist/core/embedding/semantic-recall.js

@@ -0,0 +1,37 @@
+import { cosineSimilarity } from './similarity.js';
+/**
+ * Find semantically similar notes by comparing query embedding against cached note embeddings.
+ * Returns topK candidates above minScore, sorted by similarity descending.
+ */
+export async function computeSemanticRecall(querySummary, cache, embedder, options) {
+    const topK = options?.topK ?? 20;
+    const minScore = options?.minScore ?? 0.5;
+    const emptyResult = { scores: new Map() };
+    if (!embedder.available)
+        return emptyResult;
+    const queryVector = await embedder.embed(querySummary);
+    if (!queryVector)
+        return emptyResult;
+    const entries = Object.entries(cache.entries);
+    if (entries.length === 0)
+        return emptyResult;
+    // Compute similarities for all cached entries
+    const scored = [];
+    for (const [id, entry] of entries) {
+        if (!entry.vector || entry.vector.length !== queryVector.length)
+            continue;
+        const sim = cosineSimilarity(queryVector, entry.vector);
+        if (sim >= minScore) {
+            scored.push({ id, score: sim });
+        }
+    }
+    // Sort by score descending, take topK
+    scored.sort((a, b) => b.score - a.score);
+    const topResults = scored.slice(0, topK);
+    const scores = new Map();
+    for (const { id, score } of topResults) {
+        scores.set(id, score);
+    }
+    return { scores };
+}
+//# sourceMappingURL=semantic-recall.js.map

package/dist/core/embedding/semantic-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-recall.js","sourceRoot":"","sources":["../../../src/core/embedding/semantic-recall.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAcnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAoB,EACpB,KAAqB,EACrB,QAAkB,EAClB,OAA+B;IAE/B,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAC1C,MAAM,WAAW,GAAyB,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAEhE,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IAE5C,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,WAAW;QAAE,OAAO,WAAW,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAE7C,8CAA8C;IAC9C,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM;YAAE,SAAS;QAC1E,MAAM,GAAG,GAAG,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,UAAU,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/core/embedding/similarity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compute cosine similarity between two vectors.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/core/embedding/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../../src/core/embedding/similarity.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBjE"}

package/dist/core/embedding/similarity.js

@@ -0,0 +1,21 @@
+/**
+ * Compute cosine similarity between two vectors.
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denom === 0)
+        return 0;
+    return dot / denom;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/core/embedding/similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.js","sourceRoot":"","sources":["../../../src/core/embedding/similarity.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1B,OAAO,GAAG,GAAG,KAAK,CAAC;AACrB,CAAC"}

package/dist/core/index/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/core/index/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAgB,MAAM,6BAA6B,CAAC;AAczF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8BD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CA8DhF"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/core/index/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAgB,MAAM,6BAA6B,CAAC;AAczF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8BD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU,CAyEhF"}