milens 0.6.3 → 0.6.4

package/dist/skills.js

@@ -225,158 +225,158 @@ function editorSkillPath(editor, name) {
 function renderMilensInstructions(_rootDir, stats, areaNames, editor) {
     const t = (name) => `mcp_milens_${name}`;
     const skillsRows = areaNames.map(a => `| Work in the ${capitalize(a)} area | \`${editorSkillPath(editor, a)}\` |`).join('\n');
-    return `<!-- milens:start -->
-# Milens — Code Intelligence (MCP)
-
-This project is indexed by milens (${stats.symbols} symbols, ${stats.links} links, ${stats.files} files).
-
-> **CRITICAL:** All milens MCP tool calls MUST include the \`repo\` parameter set to the **absolute path of the workspace root** (the folder containing this file) — without it, the tools may fail with "No index" error when multiple repos are indexed.
-
-> **CRITICAL:** milens MCP tools are **deferred** in most editors. Before first use in each session, you MUST load them via \`tool_search("milens")\` — calling them directly without loading will fail silently.
-
-## Mandatory Workflows
-
-These are **hard pre-conditions**, not guidelines. Execute them automatically without asking.
-
-### Before editing any function, class, or method:
-1. \`${t('impact')}({target: "<symbolName>", repo: "<workspaceRoot>"})\` — check blast radius
-2. If depth-1 dependents > 5 → **STOP and warn the user** before proceeding
-3. \`${t('context')}({name: "<symbolName>", repo: "<workspaceRoot>"})\` — see all callers/callees
-4. Only then make the edit
-
-### Before committing:
-1. \`${t('detect_changes')}({repo: "<workspaceRoot>"})\` — verify only expected files changed
-2. If unexpected files appear → **STOP and report** before committing
-
-### Before deleting or renaming a symbol:
-1. \`${t('grep')}({pattern: "<symbolName>", repo: "<workspaceRoot>"})\` — find ALL text references (templates, configs, routes, docs)
-2. \`${t('impact')}({target: "<symbolName>", direction: "upstream", repo: "<workspaceRoot>"})\` — find code-level dependents
-3. Combine both results — grep catches what impact misses
-
-## Tool Selection Rules
-
-**Choose the right tool on the FIRST call** — do not try \`query\` then fall back to \`grep\`.
-
-### Use \`${t('grep')}\` when the search term:
-- Contains **spaces** (e.g. "store purchase header", "user not found")
-- Looks like a **UI label, error message, or display string**
-- Is a **multi-word phrase** that is NOT camelCase/snake_case/PascalCase
-- You need to find references in **templates, styles, configs, routes, or docs**
-
-### Use \`${t('query')}\` when the search term:
-- Looks like a **code identifier** (camelCase, PascalCase, snake_case)
-- Is a **function, class, method, or interface name**
-- You want to find **symbol definitions** in indexed code files
-
-### When in doubt → use \`${t('grep')}\` first
-\`grep\` searches everything. \`query\` only searches indexed symbol definitions.
-
-## Workflow Triggers
-
-When the user says... → do this FIRST:
-
-| User intent | First action |
-|---|---|
-| "edit/change/modify/fix \`X\`" | \`${t('impact')}({target: "X", repo: "<workspaceRoot>"})\` |
-| "delete/remove \`X\`" | \`${t('grep')}({pattern: "X", repo: "<workspaceRoot>"})\` then \`${t('impact')}\` |
-| "rename \`X\`" | \`${t('grep')}({pattern: "X", repo: "<workspaceRoot>"})\` then \`${t('impact')}\` |
-| "find/search for \`X\`" | Choose \`query\` or \`grep\` per rules above |
-| "commit" / "push" | \`${t('detect_changes')}({repo: "<workspaceRoot>"})\` |
-| "what calls/uses \`X\`" | \`${t('context')}({name: "X", repo: "<workspaceRoot>"})\` |
-| "what happens if I change \`X\`" | \`${t('impact')}({target: "X", repo: "<workspaceRoot>"})\` |
-| "how are \`A\` and \`B\` connected" | \`${t('explain_relationship')}({from: "A", to: "B", repo: "<workspaceRoot>"})\` |
-| "explore/understand \`X\`" | \`${t('context')}({name: "X", repo: "<workspaceRoot>"})\` |
-| "update/write docs for \`X\`" | \`${t('grep')}({pattern: "X", include: "**/*.md"})\` — find existing docs mentioning X, then \`${t('context')}({name: "X"})\` for full symbol info |
-| "research/explore docs" | \`${t('get_file_symbols')}({file: "<doc.md>"})\` — see document outline (headings as sections) |
-| "what docs mention \`X\`" | \`${t('grep')}({pattern: "X", include: "**/*.md"})\` — find all markdown references |
-| "review this PR" | \`${t('review_pr')}({repo: "<workspaceRoot>"})\` — risk assessment for changed files |
-| "is \`X\` risky to change" | \`${t('review_symbol')}({name: "X", repo: "<workspaceRoot>"})\` |
-| "write tests for \`X\`" | \`${t('test_plan')}({name: "X", repo: "<workspaceRoot>"})\` — deps, mocks, suggested tests |
-| "what needs tests" | \`${t('test_coverage_gaps')}({repo: "<workspaceRoot>"})\` — untested symbols by risk |
-| "which tests to run" | \`${t('test_impact')}({repo: "<workspaceRoot>"})\` — maps changes → test files |
-| "remember/note that \`X\`..." | \`${t('annotate')}({symbol: "X", key: "note", value: "...", repo: "<workspaceRoot>"})\` |
-| "what do we know about \`X\`" | \`${t('recall')}({symbol: "X", repo: "<workspaceRoot>"})\` |
-| "start new session" | \`${t('session_start')}({agent: "...", repo: "<workspaceRoot>"})\` |
-| "find code like \`X\`" | \`${t('find_similar')}({name: "X", repo: "<workspaceRoot>"})\` |
-| "search for \`concept\`" | \`${t('semantic_search')}({query: "concept", repo: "<workspaceRoot>"})\` |
-
-## Documentation Workflows
-
-Milens indexes **Markdown files** (.md, .mdx) — headings become \`section\` symbols with parent-child hierarchy, and local links become cross-file references.
-
-### Researching or exploring documentation:
-1. \`${t('get_file_symbols')}({file: "README.md", repo: "<workspaceRoot>"})\` — see the full heading outline (TOC) of any doc
-2. \`${t('query')}({query: "<topic>"})\` — search section headings across all docs and code
-3. \`${t('grep')}({pattern: "<keyword>", include: "**/*.md"})\` — text search within docs only
-
-### Before updating documentation:
-1. \`${t('get_file_symbols')}({file: "<doc.md>"})\` — understand document structure first
-2. If documenting a code symbol: \`${t('context')}({name: "<symbolName>"})\` — get full symbol info (signature, callers, deps)
-3. \`${t('grep')}({pattern: "<symbolName>", include: "**/*.md"})\` — check if other docs already reference it
-
-### After renaming/deleting a code symbol:
-- \`${t('grep')}({pattern: "<oldName>", include: "**/*.md"})\` — find docs that need updating (milens indexes markdown links as cross-file references)
-
-## Never Do
-
-- NEVER edit a symbol without first running \`${t('impact')}\` on it.
-- NEVER delete or rename without running both \`${t('grep')}\` and \`${t('impact')}\`.
-- NEVER commit without running \`${t('detect_changes')}()\`.
-- NEVER call milens MCP tools without the \`repo\` parameter.
-- NEVER use \`${t('query')}\` for multi-word display text or UI labels — use \`${t('grep')}\`.
-
----
-
-## Reference
-
-### Tools
-
-| Tool | Purpose |
-|---|---|
-| \`${t('query')}\` | Find symbol definitions by name (FTS5) |
-| \`${t('grep')}\` | Text search ALL files (templates, styles, configs, docs) |
-| \`${t('context')}\` | 360° view: incoming refs + outgoing deps |
-| \`${t('impact')}\` | Blast radius before editing |
-| \`${t('detect_changes')}\` | Pre-commit scope check |
-| \`${t('explain_relationship')}\` | Shortest path between two symbols |
-| \`${t('get_file_symbols')}\` | All symbols in a file |
-| \`${t('get_type_hierarchy')}\` | Class inheritance tree |
-| \`${t('find_dead_code')}\` | Unused exported symbols |
-| \`${t('status')}\` | Index health check |
-| \`${t('edit_check')}\` | Pre-edit safety: callers + export status + re-export chains + test coverage |
-| \`${t('trace')}\` | Execution flow: call chains from entrypoints to a symbol |
-| \`${t('routes')}\` | Detect framework routes/endpoints (Express, FastAPI, NestJS, etc.) |
-| \`${t('smart_context')}\` | Intent-aware context: understand/edit/debug/test |
-| \`${t('overview')}\` | Combined context + impact + grep in one call |
-| \`${t('domains')}\` | Domain clusters: groups of files forming logical modules |
-| \`${t('repos')}\` | List all indexed repositories with summary stats |
-| \`${t('ast_explore')}\` | Explore raw AST structure of a code file |
-| \`${t('test_query')}\` | Run raw SQL query against the milens index database |
-| \`${t('review_pr')}\` | PR risk assessment: scores changed symbols by blast radius + test coverage |
-| \`${t('review_symbol')}\` | Single symbol risk: role, heat, dependents, test status |
-| \`${t('test_plan')}\` | Dependency-aware test plan: mocks, strategies, suggested tests |
-| \`${t('test_coverage_gaps')}\` | Untested exported symbols sorted by risk |
-| \`${t('test_impact')}\` | Which tests to run for current changes |
-| \`${t('annotate')}\` | Store observation/note about a symbol (persists across sessions) |
-| \`${t('recall')}\` | Retrieve annotations (filter by symbol, key, agent, session) |
-| \`${t('session_start')}\` | Register agent session for multi-agent coordination |
-| \`${t('session_context')}\` | Get session metadata + annotations |
-| \`${t('handoff')}\` | Transfer context between agent sessions |
-| \`${t('codebase_summary')}\` | High-level bootstrapping context: domains, key symbols, coverage |
-| \`${t('semantic_search')}\` | Hybrid FTS5 + vector search (requires --embeddings) |
-| \`${t('find_similar')}\` | Find symbols similar by embedding proximity |
-
-### Keeping the Index Fresh
-
-After significant code changes: \`npx milens analyze -p . --force\`
-
-### Skills
-
-| Task | Read this skill file |
-|------|---------------------|
-| General milens tools reference | \`${editorSkillPath(editor, 'milens')}\` |
-${skillsRows}
-
+    return `<!-- milens:start -->
+# Milens — Code Intelligence (MCP)
+
+This project is indexed by milens (${stats.symbols} symbols, ${stats.links} links, ${stats.files} files).
+
+> **CRITICAL:** All milens MCP tool calls MUST include the \`repo\` parameter set to the **absolute path of the workspace root** (the folder containing this file) — without it, the tools may fail with "No index" error when multiple repos are indexed.
+
+> **CRITICAL:** milens MCP tools are **deferred** in most editors. Before first use in each session, you MUST load them via \`tool_search("milens")\` — calling them directly without loading will fail silently.
+
+## Mandatory Workflows
+
+These are **hard pre-conditions**, not guidelines. Execute them automatically without asking.
+
+### Before editing any function, class, or method:
+1. \`${t('impact')}({target: "<symbolName>", repo: "<workspaceRoot>"})\` — check blast radius
+2. If depth-1 dependents > 5 → **STOP and warn the user** before proceeding
+3. \`${t('context')}({name: "<symbolName>", repo: "<workspaceRoot>"})\` — see all callers/callees
+4. Only then make the edit
+
+### Before committing:
+1. \`${t('detect_changes')}({repo: "<workspaceRoot>"})\` — verify only expected files changed
+2. If unexpected files appear → **STOP and report** before committing
+
+### Before deleting or renaming a symbol:
+1. \`${t('grep')}({pattern: "<symbolName>", repo: "<workspaceRoot>"})\` — find ALL text references (templates, configs, routes, docs)
+2. \`${t('impact')}({target: "<symbolName>", direction: "upstream", repo: "<workspaceRoot>"})\` — find code-level dependents
+3. Combine both results — grep catches what impact misses
+
+## Tool Selection Rules
+
+**Choose the right tool on the FIRST call** — do not try \`query\` then fall back to \`grep\`.
+
+### Use \`${t('grep')}\` when the search term:
+- Contains **spaces** (e.g. "store purchase header", "user not found")
+- Looks like a **UI label, error message, or display string**
+- Is a **multi-word phrase** that is NOT camelCase/snake_case/PascalCase
+- You need to find references in **templates, styles, configs, routes, or docs**
+
+### Use \`${t('query')}\` when the search term:
+- Looks like a **code identifier** (camelCase, PascalCase, snake_case)
+- Is a **function, class, method, or interface name**
+- You want to find **symbol definitions** in indexed code files
+
+### When in doubt → use \`${t('grep')}\` first
+\`grep\` searches everything. \`query\` only searches indexed symbol definitions.
+
+## Workflow Triggers
+
+When the user says... → do this FIRST:
+
+| User intent | First action |
+|---|---|
+| "edit/change/modify/fix \`X\`" | \`${t('impact')}({target: "X", repo: "<workspaceRoot>"})\` |
+| "delete/remove \`X\`" | \`${t('grep')}({pattern: "X", repo: "<workspaceRoot>"})\` then \`${t('impact')}\` |
+| "rename \`X\`" | \`${t('grep')}({pattern: "X", repo: "<workspaceRoot>"})\` then \`${t('impact')}\` |
+| "find/search for \`X\`" | Choose \`query\` or \`grep\` per rules above |
+| "commit" / "push" | \`${t('detect_changes')}({repo: "<workspaceRoot>"})\` |
+| "what calls/uses \`X\`" | \`${t('context')}({name: "X", repo: "<workspaceRoot>"})\` |
+| "what happens if I change \`X\`" | \`${t('impact')}({target: "X", repo: "<workspaceRoot>"})\` |
+| "how are \`A\` and \`B\` connected" | \`${t('explain_relationship')}({from: "A", to: "B", repo: "<workspaceRoot>"})\` |
+| "explore/understand \`X\`" | \`${t('context')}({name: "X", repo: "<workspaceRoot>"})\` |
+| "update/write docs for \`X\`" | \`${t('grep')}({pattern: "X", include: "**/*.md"})\` — find existing docs mentioning X, then \`${t('context')}({name: "X"})\` for full symbol info |
+| "research/explore docs" | \`${t('get_file_symbols')}({file: "<doc.md>"})\` — see document outline (headings as sections) |
+| "what docs mention \`X\`" | \`${t('grep')}({pattern: "X", include: "**/*.md"})\` — find all markdown references |
+| "review this PR" | \`${t('review_pr')}({repo: "<workspaceRoot>"})\` — risk assessment for changed files |
+| "is \`X\` risky to change" | \`${t('review_symbol')}({name: "X", repo: "<workspaceRoot>"})\` |
+| "write tests for \`X\`" | \`${t('test_plan')}({name: "X", repo: "<workspaceRoot>"})\` — deps, mocks, suggested tests |
+| "what needs tests" | \`${t('test_coverage_gaps')}({repo: "<workspaceRoot>"})\` — untested symbols by risk |
+| "which tests to run" | \`${t('test_impact')}({repo: "<workspaceRoot>"})\` — maps changes → test files |
+| "remember/note that \`X\`..." | \`${t('annotate')}({symbol: "X", key: "note", value: "...", repo: "<workspaceRoot>"})\` |
+| "what do we know about \`X\`" | \`${t('recall')}({symbol: "X", repo: "<workspaceRoot>"})\` |
+| "start new session" | \`${t('session_start')}({agent: "...", repo: "<workspaceRoot>"})\` |
+| "find code like \`X\`" | \`${t('find_similar')}({name: "X", repo: "<workspaceRoot>"})\` |
+| "search for \`concept\`" | \`${t('semantic_search')}({query: "concept", repo: "<workspaceRoot>"})\` |
+
+## Documentation Workflows
+
+Milens indexes **Markdown files** (.md, .mdx) — headings become \`section\` symbols with parent-child hierarchy, and local links become cross-file references.
+
+### Researching or exploring documentation:
+1. \`${t('get_file_symbols')}({file: "README.md", repo: "<workspaceRoot>"})\` — see the full heading outline (TOC) of any doc
+2. \`${t('query')}({query: "<topic>"})\` — search section headings across all docs and code
+3. \`${t('grep')}({pattern: "<keyword>", include: "**/*.md"})\` — text search within docs only
+
+### Before updating documentation:
+1. \`${t('get_file_symbols')}({file: "<doc.md>"})\` — understand document structure first
+2. If documenting a code symbol: \`${t('context')}({name: "<symbolName>"})\` — get full symbol info (signature, callers, deps)
+3. \`${t('grep')}({pattern: "<symbolName>", include: "**/*.md"})\` — check if other docs already reference it
+
+### After renaming/deleting a code symbol:
+- \`${t('grep')}({pattern: "<oldName>", include: "**/*.md"})\` — find docs that need updating (milens indexes markdown links as cross-file references)
+
+## Never Do
+
+- NEVER edit a symbol without first running \`${t('impact')}\` on it.
+- NEVER delete or rename without running both \`${t('grep')}\` and \`${t('impact')}\`.
+- NEVER commit without running \`${t('detect_changes')}()\`.
+- NEVER call milens MCP tools without the \`repo\` parameter.
+- NEVER use \`${t('query')}\` for multi-word display text or UI labels — use \`${t('grep')}\`.
+
+---
+
+## Reference
+
+### Tools
+
+| Tool | Purpose |
+|---|---|
+| \`${t('query')}\` | Find symbol definitions by name (FTS5) |
+| \`${t('grep')}\` | Text search ALL files (templates, styles, configs, docs) |
+| \`${t('context')}\` | 360° view: incoming refs + outgoing deps |
+| \`${t('impact')}\` | Blast radius before editing |
+| \`${t('detect_changes')}\` | Pre-commit scope check |
+| \`${t('explain_relationship')}\` | Shortest path between two symbols |
+| \`${t('get_file_symbols')}\` | All symbols in a file |
+| \`${t('get_type_hierarchy')}\` | Class inheritance tree |
+| \`${t('find_dead_code')}\` | Unused exported symbols |
+| \`${t('status')}\` | Index health check |
+| \`${t('edit_check')}\` | Pre-edit safety: callers + export status + re-export chains + test coverage |
+| \`${t('trace')}\` | Execution flow: call chains from entrypoints to a symbol |
+| \`${t('routes')}\` | Detect framework routes/endpoints (Express, FastAPI, NestJS, etc.) |
+| \`${t('smart_context')}\` | Intent-aware context: understand/edit/debug/test |
+| \`${t('overview')}\` | Combined context + impact + grep in one call |
+| \`${t('domains')}\` | Domain clusters: groups of files forming logical modules |
+| \`${t('repos')}\` | List all indexed repositories with summary stats |
+| \`${t('ast_explore')}\` | Explore raw AST structure of a code file |
+| \`${t('test_query')}\` | Run raw SQL query against the milens index database |
+| \`${t('review_pr')}\` | PR risk assessment: scores changed symbols by blast radius + test coverage |
+| \`${t('review_symbol')}\` | Single symbol risk: role, heat, dependents, test status |
+| \`${t('test_plan')}\` | Dependency-aware test plan: mocks, strategies, suggested tests |
+| \`${t('test_coverage_gaps')}\` | Untested exported symbols sorted by risk |
+| \`${t('test_impact')}\` | Which tests to run for current changes |
+| \`${t('annotate')}\` | Store observation/note about a symbol (persists across sessions) |
+| \`${t('recall')}\` | Retrieve annotations (filter by symbol, key, agent, session) |
+| \`${t('session_start')}\` | Register agent session for multi-agent coordination |
+| \`${t('session_context')}\` | Get session metadata + annotations |
+| \`${t('handoff')}\` | Transfer context between agent sessions |
+| \`${t('codebase_summary')}\` | High-level bootstrapping context: domains, key symbols, coverage |
+| \`${t('semantic_search')}\` | Hybrid FTS5 + vector search (requires --embeddings) |
+| \`${t('find_similar')}\` | Find symbols similar by embedding proximity |
+
+### Keeping the Index Fresh
+
+After significant code changes: \`npx milens analyze -p . --force\`
+
+### Skills
+
+| Task | Read this skill file |
+|------|---------------------|
+| General milens tools reference | \`${editorSkillPath(editor, 'milens')}\` |
+${skillsRows}
+
 <!-- milens:end -->`;
 }
 function generateToolInstructions(rootDir, copilotDir, cursorDir, claudeDir, _claudeRulesDir, agentsDir, stats, areaNames, has) {

package/dist/store/annotations.d.ts

@@ -0,0 +1,41 @@
+import BetterSqlite3 from 'better-sqlite3';
+import type { Annotation, AnnotationKey, Session, EvolutionEvent } from '../types.js';
+export declare class AnnotationStore {
+    private db;
+    private stmts;
+    constructor(db: BetterSqlite3.Database);
+    private prepareStatements;
+    annotate(symbol: string, key: string, value: string, options?: {
+        agent?: string;
+        sessionId?: string;
+    }): Annotation;
+    recall(filters?: {
+        symbol?: string;
+        key?: AnnotationKey;
+        agent?: string;
+        sessionId?: string;
+        limit?: number;
+    }): Annotation[];
+    sessionStart(agent: string): string;
+    sessionEnd(sessionId: string, status?: string): {
+        sessionId: string;
+        status: string;
+        annotationCount: number;
+    };
+    sessionContext(sessionId: string): {
+        session: Session;
+        annotations: Annotation[];
+        annotationCount: number;
+        toolCallsCount: number;
+    };
+    handoff(fromSessionId: string, toAgent: string, context: string): {
+        newSessionId: string;
+        annotationsCopied: number;
+    };
+    getPromotableAnnotations(): Annotation[];
+    getStaleAnnotations(daysOld: number, confidenceThreshold: number): Annotation[];
+    archiveAnnotation(id: string): void;
+    logEvolutionEvent(annotationId: string, event: EvolutionEvent['event'], oldValue?: string, newValue?: string): void;
+    getAnnotationCount(): number;
+}
+//# sourceMappingURL=annotations.d.ts.map

package/dist/store/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/store/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQtF,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,KAAK,CAAmD;gBAEpD,EAAE,EAAE,aAAa,CAAC,QAAQ;IAKtC,OAAO,CAAC,iBAAiB;IAsDzB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IAkDlH,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,aAAa,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,EAAE;IA8B5H,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMnC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IAW9G,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,UAAU,EAAE,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAenI,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE;IAiBrH,wBAAwB,IAAI,UAAU,EAAE;IAKxC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,UAAU,EAAE;IAM/E,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASnC,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnH,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/store/annotations.js

@@ -0,0 +1,192 @@
+import { randomUUID } from 'node:crypto';
+const VALID_KEYS = [
+    'note', 'bug', 'security', 'architecture',
+    'workflow', 'test', 'dependency', 'refactor',
+];
+export class AnnotationStore {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.stmts = this.prepareStatements();
+    }
+    prepareStatements() {
+        return {
+            insertAnnotation: this.db.prepare(`INSERT OR REPLACE INTO annotations (id, symbol, key, value, agent, session_id, confidence, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+            findBySymbolKey: this.db.prepare('SELECT * FROM annotations WHERE symbol = ? AND key = ?'),
+            updateAnnotation: this.db.prepare('UPDATE annotations SET value = ?, confidence = ?, updated_at = datetime(\'now\') WHERE id = ?'),
+            queryBySymbol: this.db.prepare('SELECT * FROM annotations WHERE symbol = ? ORDER BY confidence DESC, updated_at DESC LIMIT ?'),
+            queryByKey: this.db.prepare('SELECT * FROM annotations WHERE key = ? ORDER BY confidence DESC LIMIT ?'),
+            queryByAgent: this.db.prepare('SELECT * FROM annotations WHERE agent = ? ORDER BY updated_at DESC LIMIT ?'),
+            queryAll: this.db.prepare('SELECT * FROM annotations ORDER BY confidence DESC, updated_at DESC LIMIT ?'),
+            queryBySession: this.db.prepare('SELECT * FROM annotations WHERE session_id = ? ORDER BY updated_at DESC'),
+            insertSession: this.db.prepare('INSERT INTO sessions (id, agent, status, started_at) VALUES (?, ?, ?, datetime(\'now\'))'),
+            endSession: this.db.prepare('UPDATE sessions SET ended_at = datetime(\'now\'), status = ?, tool_calls_count = ?, annotations_count = ? WHERE id = ?'),
+            getSession: this.db.prepare('SELECT * FROM sessions WHERE id = ?'),
+            countSessionAnns: this.db.prepare('SELECT COUNT(*) as c FROM annotations WHERE session_id = ?'),
+            countAll: this.db.prepare('SELECT COUNT(*) as c FROM annotations'),
+            insertEvent: this.db.prepare('INSERT INTO evolution_log (annotation_id, event, old_value, new_value) VALUES (?, ?, ?, ?)'),
+            getPromotable: this.db.prepare("SELECT * FROM annotations WHERE confidence >= 0.8 ORDER BY confidence DESC"),
+            getStale: this.db.prepare("SELECT * FROM annotations WHERE updated_at < datetime('now', ?) AND confidence < ? ORDER BY confidence ASC"),
+            archiveAnnotation: this.db.prepare("UPDATE annotations SET confidence = 0, updated_at = datetime('now') WHERE id = ?"),
+            deleteAnnotation: this.db.prepare('DELETE FROM annotations WHERE id = ?'),
+        };
+    }
+    // ── Annotation CRUD ──
+    annotate(symbol, key, value, options) {
+        if (!VALID_KEYS.includes(key)) {
+            throw new Error(`Invalid annotation key: "${key}". Valid: ${VALID_KEYS.join(', ')}`);
+        }
+        const annotationKey = key;
+        const existing = this.stmts.findBySymbolKey.get(symbol, annotationKey);
+        if (existing) {
+            if (existing.value === value) {
+                const newConfidence = Math.min(existing.confidence + 0.1, 1.0);
+                this.stmts.updateAnnotation.run(value, newConfidence, existing.id);
+                const eventType = newConfidence >= 0.8 && existing.confidence < 0.8 ? 'promoted' : 'confidence_up';
+                this.logEvolutionEvent(existing.id, eventType, existing.value, value);
+                return rowToAnnotation({
+                    ...existing,
+                    confidence: newConfidence,
+                    updated_at: new Date().toISOString(),
+                });
+            }
+            this.stmts.updateAnnotation.run(value, 0.5, existing.id);
+            this.logEvolutionEvent(existing.id, 'created', existing.value, value);
+            return rowToAnnotation({
+                ...existing,
+                value,
+                confidence: 0.5,
+                updated_at: new Date().toISOString(),
+            });
+        }
+        const id = randomUUID();
+        const now = new Date().toISOString();
+        this.stmts.insertAnnotation.run(id, symbol, annotationKey, value, options?.agent ?? null, options?.sessionId ?? null, 0.5, now, now);
+        this.logEvolutionEvent(id, 'created', undefined, value);
+        return {
+            id, symbol, key: annotationKey, value,
+            agent: options?.agent,
+            sessionId: options?.sessionId,
+            confidence: 0.5,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    recall(filters) {
+        const limit = filters?.limit ?? 50;
+        if (filters?.symbol && filters?.key) {
+            const rows = this.stmts.findBySymbolKey.all(filters.symbol, filters.key);
+            return rows.map(rowToAnnotation);
+        }
+        if (filters?.symbol) {
+            const rows = this.stmts.queryBySymbol.all(filters.symbol, limit);
+            return rows.map(rowToAnnotation);
+        }
+        if (filters?.key) {
+            const rows = this.stmts.queryByKey.all(filters.key, limit);
+            return rows.map(rowToAnnotation);
+        }
+        if (filters?.agent) {
+            const rows = this.stmts.queryByAgent.all(filters.agent, limit);
+            return rows.map(rowToAnnotation);
+        }
+        if (filters?.sessionId) {
+            const rows = this.stmts.queryBySession.all(filters.sessionId);
+            return rows.map(rowToAnnotation);
+        }
+        const rows = this.stmts.queryAll.all(limit);
+        return rows.map(rowToAnnotation);
+    }
+    // ── Session management ──
+    sessionStart(agent) {
+        const id = randomUUID();
+        this.stmts.insertSession.run(id, agent, 'active');
+        return id;
+    }
+    sessionEnd(sessionId, status) {
+        const session = this.stmts.getSession.get(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        const annCount = this.stmts.countSessionAnns.get(sessionId).c;
+        const finalStatus = status ?? 'completed';
+        this.stmts.endSession.run(finalStatus, session.tool_calls_count ?? 0, annCount, sessionId);
+        return { sessionId, status: finalStatus, annotationCount: annCount };
+    }
+    sessionContext(sessionId) {
+        const sessionRow = this.stmts.getSession.get(sessionId);
+        if (!sessionRow)
+            throw new Error(`Session not found: ${sessionId}`);
+        const annotations = this.recall({ sessionId });
+        const annCount = this.stmts.countSessionAnns.get(sessionId).c;
+        return {
+            session: rowToSession(sessionRow),
+            annotations,
+            annotationCount: annCount,
+            toolCallsCount: sessionRow.tool_calls_count ?? 0,
+        };
+    }
+    handoff(fromSessionId, toAgent, context) {
+        const fromSession = this.stmts.getSession.get(fromSessionId);
+        if (!fromSession)
+            throw new Error(`Session not found: ${fromSessionId}`);
+        const fromAnnCount = this.stmts.countSessionAnns.get(fromSessionId).c;
+        this.stmts.endSession.run('completed', fromSession.tool_calls_count ?? 0, fromAnnCount, fromSessionId);
+        const newId = randomUUID();
+        this.db.prepare('INSERT INTO sessions (id, agent, status, started_at, context) VALUES (?, ?, ?, datetime(\'now\'), ?)').run(newId, toAgent, 'active', context);
+        return { newSessionId: newId, annotationsCopied: fromAnnCount };
+    }
+    // ── Maintenance ──
+    getPromotableAnnotations() {
+        const rows = this.stmts.getPromotable.all();
+        return rows.map(rowToAnnotation);
+    }
+    getStaleAnnotations(daysOld, confidenceThreshold) {
+        const modifier = `-${daysOld} days`;
+        const rows = this.stmts.getStale.all(modifier, confidenceThreshold);
+        return rows.map(rowToAnnotation);
+    }
+    archiveAnnotation(id) {
+        const row = this.db.prepare('SELECT * FROM annotations WHERE id = ?').get(id);
+        if (!row)
+            throw new Error(`Annotation not found: ${id}`);
+        this.stmts.archiveAnnotation.run(id);
+        this.logEvolutionEvent(id, 'archived', row.value, undefined);
+    }
+    // ── Evolution log ──
+    logEvolutionEvent(annotationId, event, oldValue, newValue) {
+        this.stmts.insertEvent.run(annotationId, event, oldValue ?? null, newValue ?? null);
+    }
+    // ── Stats ──
+    getAnnotationCount() {
+        return this.stmts.countAll.get().c;
+    }
+}
+// ── Row mappers ──
+function rowToAnnotation(row) {
+    return {
+        id: row.id,
+        symbol: row.symbol,
+        key: row.key,
+        value: row.value,
+        agent: row.agent ?? undefined,
+        sessionId: row.session_id ?? undefined,
+        confidence: row.confidence,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function rowToSession(row) {
+    return {
+        id: row.id,
+        agent: row.agent,
+        status: row.status,
+        startedAt: row.started_at,
+        endedAt: row.ended_at ?? undefined,
+        toolCallsCount: row.tool_calls_count ?? 0,
+        annotationsCount: row.annotations_count ?? 0,
+        context: row.context ?? undefined,
+    };
+}
+//# sourceMappingURL=annotations.js.map

package/dist/store/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/store/annotations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAA6B;IAC3C,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc;IACzC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU;CACpC,CAAC;AAEX,MAAM,OAAO,eAAe;IAClB,EAAE,CAAyB;IAC3B,KAAK,CAAmD;IAEhE,YAAY,EAA0B;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACxC,CAAC;IAEO,iBAAiB;QACvB,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC/B;4CACoC,CACrC;YACD,eAAe,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC9B,wDAAwD,CACzD;YACD,gBAAgB,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC/B,+FAA+F,CAChG;YACD,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,8FAA8F,CAC/F;YACD,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CACzB,0EAA0E,CAC3E;YACD,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC3B,4EAA4E,CAC7E;YACD,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CACvB,6EAA6E,CAC9E;YACD,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC7B,yEAAyE,CAC1E;YACD,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,0FAA0F,CAC3F;YACD,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CACzB,wHAAwH,CACzH;YACD,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC;YAClE,gBAAgB,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,4DAA4D,CAAC;YAC/F,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC;YAClE,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,4FAA4F,CAC7F;YACD,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,4EAA4E,CAC7E;YACD,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CACvB,4GAA4G,CAC7G;YACD,iBAAiB,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAChC,kFAAkF,CACnF;YACD,gBAAgB,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC;SAC1E,CAAC;IACJ,CAAC;IAED,wBAAwB;IAExB,QAAQ,CAAC,MAAc,EAAE,GAAW,EAAE,KAAa,EAAE,OAAgD;QACnG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAoB,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,aAAa,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,aAAa,GAAG,GAAoB,CAAC;QAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAQ,CAAC;QAE9E,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC/D,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACnE,MAAM,SAAS,GAAG,aAAa,IAAI,GAAG,IAAI,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC;gBACnG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACtE,OAAO,eAAe,CAAC;oBACrB,GAAG,QAAQ;oBACX,UAAU,EAAE,aAAa;oBACzB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACtE,OAAO,eAAe,CAAC;gBACrB,GAAG,QAAQ;gBACX,KAAK;gBACL,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAC7B,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAChC,OAAO,EAAE,KAAK,IAAI,IAAI,EACtB,OAAO,EAAE,SAAS,IAAI,IAAI,EAC1B,GAAG,EAAE,GAAG,EAAE,GAAG,CACd,CAAC;QACF,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO;YACL,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK;YACrC,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAsG;QAC3G,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QAEnC,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAU,CAAC;YAClF,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;YAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC;YACpE,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;YACxE,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAU,CAAC;YACvE,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAU,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,2BAA2B;IAE3B,YAAY,CAAC,KAAa;QACxB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,MAAe;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAC;QAC5D,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAS,CAAC,CAAW,CAAC;QACjF,MAAM,WAAW,GAAG,MAAM,IAAI,WAAW,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAE3F,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IACvE,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAQ,CAAC;QAC/D,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QAEpE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAS,CAAC,CAAW,CAAC;QAEjF,OAAO;YACL,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC;YACjC,WAAW;YACX,eAAe,EAAE,QAAQ;YACzB,cAAc,EAAE,UAAU,CAAC,gBAAgB,IAAI,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,aAAqB,EAAE,OAAe,EAAE,OAAe;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAQ,CAAC;QACpE,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,aAAa,EAAE,CAAC,CAAC;QAEzE,MAAM,YAAY,GAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAS,CAAC,CAAW,CAAC;QACzF,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,gBAAgB,IAAI,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QAEvG,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,CAAC,OAAO,CACb,sGAAsG,CACvG,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEzC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;IAClE,CAAC;IAED,oBAAoB;IAEpB,wBAAwB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,EAAW,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,mBAAmB,CAAC,OAAe,EAAE,mBAA2B;QAC9D,MAAM,QAAQ,GAAG,IAAI,OAAO,OAAO,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,mBAAmB,CAAU,CAAC;QAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,iBAAiB,CAAC,EAAU;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAQ,CAAC;QACrF,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,sBAAsB;IAEtB,iBAAiB,CAAC,YAAoB,EAAE,KAA8B,EAAE,QAAiB,EAAE,QAAiB;QAC1G,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,IAAI,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,cAAc;IAEd,kBAAkB;QAChB,OAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAU,CAAC,CAAW,CAAC;IACxD,CAAC;CACF;AAED,oBAAoB;AAEpB,SAAS,eAAe,CAAC,GAAQ;IAC/B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAoB;QAC7B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;QAC7B,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;QACtC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAQ;IAC5B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAA2B;QACvC,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;QAClC,cAAc,EAAE,GAAG,CAAC,gBAAgB,IAAI,CAAC;QACzC,gBAAgB,EAAE,GAAG,CAAC,iBAAiB,IAAI,CAAC;QAC5C,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;KAClC,CAAC;AACJ,CAAC"}

package/dist/store/confidence.d.ts

@@ -0,0 +1,18 @@
+import type { AnnotationStore } from './annotations.js';
+/** Boost confidence for an annotation, logging the evolution event */
+export declare function boostConfidence(store: AnnotationStore, annotationId: string, increment?: number): void;
+/** Decay confidence for stale annotations */
+export declare function decayConfidence(store: AnnotationStore, annotationId: string, decrement?: number): void;
+/** Get stale annotations older than daysOld with confidence below threshold */
+export declare function getStaleAnnotations(store: AnnotationStore, daysOld?: number, confidenceThreshold?: number): ReturnType<typeof store.recall>;
+/** Promote high-confidence security annotations to SECURITY.md rules */
+export declare function promoteSecurityAnnotations(store: AnnotationStore, rootPath: string): {
+    promoted: number;
+    content: string;
+};
+/** Run full decay pass on all annotations */
+export declare function runDecayPass(store: AnnotationStore): {
+    decayed: number;
+    archived: number;
+};
+//# sourceMappingURL=confidence.d.ts.map

package/dist/store/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/store/confidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAY,GACtB,IAAI,CAUN;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,MAAY,GACtB,IAAI,CASN;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,MAAW,EACpB,mBAAmB,GAAE,MAAY,GAChC,UAAU,CAAC,OAAO,KAAK,CAAC,MAAM,CAAC,CAGjC;AAED,wEAAwE;AACxE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA+BvC;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAkB1F"}