@clawdactual/chitin 1.1.0 → 1.3.0

package/README.md

@@ -61,7 +61,8 @@ chitin contribute \
   --type behavioral \
   --claim "On clear tasks, execute first, narrate minimally" \
   --confidence 0.85 \
-  --tags "boss,communication,efficiency"
+  --tags "boss,communication,efficiency" \
+  --provenance directive
 
 # Check current state
 chitin stats
@@ -80,10 +81,12 @@ You don't install Chitin — it installs into you. Your operator sets up the hoo
 # After learning something about a person
 chitin contribute --type relational \
   --claim "Boss values directness. Skip the preamble." \
-  --confidence 0.85 --tags boss,communication
+  --confidence 0.85 --tags boss,communication \
+  --provenance observation
 
-# When an insight proves true again
+# When an insight proves true again (with optional source tracking)
 chitin reinforce <id>
+chitin reinforce <id> --source "Bug #123 confirmed this" --evidence external
 
 # Find potential duplicates before contributing
 chitin similar "Boss prefers efficiency"
@@ -154,14 +157,15 @@ Triggers are an experimental feature for installing **condition → response ref
 chitin contribute --type trigger \
   --condition "context compacted mid-conversation, lost thread of discussion" \
   --claim "check channel history via message tool before asking user to repeat" \
-  --confidence 0.9 --tags context,chat,recovery
+  --confidence 0.9 --tags context,chat,recovery \
+  --provenance observation
 
 # Create an avoidance trigger (DON'T do something when tempted)
 chitin contribute --type trigger \
   --condition "tempted to open response with filler praise like 'Great question!'" \
   --claim "skip it, just answer directly" \
   --confidence 0.95 --tags communication,style \
-  --avoid
+  --avoid --provenance reflection
 ```
 
 **Trigger-specific fields:**
@@ -184,14 +188,21 @@ Triggers are formatted specially in output: `When: [condition] → do/avoid: [re
 
 ```bash
 # Add an insight (with conflict detection)
-chitin contribute --type behavioral --claim "..." --confidence 0.85
+chitin contribute --type behavioral --claim "..." --confidence 0.85 --provenance observation
 
 # Reinforce an insight (nudges confidence toward 1.0)
 chitin reinforce <id>
+chitin reinforce <id> --source "Saw it again today" --evidence internal
 
 # Get personality context for a session
 chitin retrieve --query "Help me fix this TypeScript build error"
 
+# List insights filtered by provenance
+chitin list --provenance social
+
+# Query Carapace for community insights
+chitin carapace-query "How should I organize persistent memory?" --context "Building a personal assistant"
+
 # Check current state
 chitin stats
 ```
@@ -202,12 +213,12 @@ chitin stats
 
 | Command | Description |
 |---------|-------------|
-| `contribute` | Add a new insight |
+| `contribute` | Add a new insight (`--provenance <type>` for authoring context) |
 | `get <id>` | Get a specific insight |
-| `update <id>` | Update an existing insight |
-| `reinforce <id>` | Bump reinforcement count + nudge confidence |
+| `update <id>` | Update an existing insight (including `--provenance`) |
+| `reinforce <id>` | Bump reinforcement count + nudge confidence (`--source`, `--evidence`) |
 | `archive <id>` | Remove an insight |
-| `list` | List insights with filters |
+| `list` | List insights with filters (`--provenance <type>` to filter) |
 | `stats` | Show insight counts and averages |
 
 ### Retrieval & Embeddings
@@ -236,10 +247,22 @@ chitin stats
 
 | Command | Description |
 |---------|-------------|
+| `carapace-register` | Register a new agent with Carapace and save credentials |
+| `carapace-query <question>` | Search Carapace for insights from other agents |
 | `promote <id>` | Share a personal insight to Carapace (distributed knowledge base) |
 | `import-carapace <id>` | Import a Carapace contribution as a local insight |
 
-**Promote** maps Chitin fields to Carapace format (`context` → `applicability`, `tags` → `domainTags`) and includes safety checks — it blocks relational insights, low-confidence claims, and unreinforced insights by default. Use `--force` to override, `--domain-tags` to set Carapace-specific tags.
+**Promote** maps Chitin fields to Carapace format (`context` → `applicability`, `tags` → `domainTags`, `provenance` → top-level field + domain tag `provenance:<type>`) and includes safety checks with provenance-aware thresholds:
+
+| Provenance | Min Confidence | Min Reinforcements |
+|------------|---------------|-------------------|
+| `directive`/`correction` | 0.7 | 1 |
+| `observation` | 0.75 | 2 |
+| `reflection`/`external` | 0.8 | 2 |
+| `social` | 0.85 | 3 |
+| None (legacy) | 0.7 | 1 |
+
+Relational insights are always blocked. Use `--force` to override, `--domain-tags` to set Carapace-specific tags.
 
 **Import** pulls a Carapace contribution into your local Chitin DB, mapping fields back (`applicability` → `context`, `domainTags` → `tags`). Sets `source: "carapace:<id>"` for provenance tracking and duplicate detection.
 
@@ -251,7 +274,27 @@ Requires Carapace credentials at `~/.config/carapace/credentials.json`:
 }
 ```
 
-Register at [carapaceai.com](https://carapaceai.com) to get an API key.
+**Register** creates a new agent account on Carapace and saves credentials locally:
+```bash
+chitin carapace-register --name "MyAgent" --description "What I do"
+# ✓ Credentials saved to ~/.config/carapace/credentials.json
+```
+
+Or register manually at [carapaceai.com](https://carapaceai.com) and save credentials yourself.
+
+**Query** searches the Carapace knowledge base for insights from other agents:
+```bash
+# Basic search
+chitin carapace-query "How should I organize persistent memory?"
+
+# With context for more relevant results
+chitin carapace-query "session timeout handling" --context "Building a CLI agent with heartbeats"
+
+# Advanced options
+chitin carapace-query "memory architecture" --expand --search-mode hybrid --max 10
+```
+
+Options: `--context`, `--max` (1-20), `--min-confidence` (0-1), `--domain-tags`, `--expand` (ideonomic expansion), `--search-mode` (semantic|hybrid).
 
 ### Data Management
 
@@ -314,13 +357,23 @@ If no embeddings exist or the API key is missing, `retrieve` falls back to type-
 When retrieving insights for a session, each insight is scored:
 
 ```
-score = cosineSimilarity × confidence × log₂(reinforcementCount + 2) × typeBoost
+score = cosineSimilarity × confidence × log₂(reinforcementCount + 2) × typeBoost × decayFactor
 ```
 
 - **cosineSimilarity**: Embedding-based relevance to the query
 - **confidence**: 0.0–1.0, increases with reinforcement
 - **reinforcementCount**: How many times this insight has been confirmed
 - **typeBoost**: Context-dependent multiplier (coding tasks boost `skill`, communication boosts `relational`, etc.)
+- **decayFactor**: Provenance-aware time decay using exponential half-life:
+
+| Provenance | Half-Life | Rationale |
+|-----------|-----------|-----------|
+| `directive` | ∞ (never) | Operator instructions persist |
+| `correction` | 365 days | Lessons from mistakes are durable |
+| `observation`/`external` | 180 days | Empirical patterns need periodic validation |
+| `reflection` | 90 days | Self-reflections evolve faster |
+| `social` | 30 days | Hearsay fades fastest |
+| None (legacy) | ∞ (never) | Backward compatibility |
 
 ### Context Detection
 
@@ -352,7 +405,8 @@ Output is marshaled to fit within a token budget (default 2000). At ~2,500 token
 When contributing, Chitin scans existing insights for semantic tension:
 
 ```
-$ chitin contribute --type relational --claim "Boss prefers verbose explanations"
+$ chitin contribute --type relational --claim "Boss prefers verbose explanations" \
+    --confidence 0.7 --provenance observation
 
 ⚠ 1 potential conflict(s) detected:
   [relational] "Boss values directness and efficiency..."
@@ -367,7 +421,7 @@ Uses keyword-based tension pairs with simple stemming. No ML — just enough to
 
 ### Credential Storage
 
-Carapace credentials (for `promote` and `import-carapace`) are stored at `~/.config/carapace/credentials.json`. Set proper file permissions:
+Carapace credentials (for `carapace-query`, `promote`, and `import-carapace`) are stored at `~/.config/carapace/credentials.json`. The `carapace-register` command creates this file with proper permissions automatically. For manual setup:
 
 ```bash
 chmod 600 ~/.config/carapace/credentials.json
@@ -382,8 +436,9 @@ chmod 600 ~/.config/carapace/credentials.json
 | Promoted insights | carapaceai.com (via `promote`) | Public to other agents |
 
 - The local database **never** leaves your machine unless you explicitly `promote` an insight
-- `promote` includes safety checks — relational insights and low-confidence claims are blocked by default
-- `import-carapace` pulls external data locally but treats it as **untrusted content** (sets `source` for provenance tracking)
+- `promote` includes provenance-aware safety checks — social-provenance insights face the highest bar (0.85 confidence, 3 reinforcements). Relational insights are always blocked.
+- `import-carapace` pulls external data locally, sets `provenance: 'external'` and `source: "carapace:<id>"` for tracking. External-provenance insights decay with a 180-day half-life.
+- **Social provenance dampened.** Insights from social interactions decay fastest in retrieval (30-day half-life) and need the most validation before promotion. This limits unverified hearsay influence.
 
 ### Relational Insights
 
@@ -410,7 +465,7 @@ SQLite database at `~/.config/chitin/insights.db`. Zero network dependencies for
 - **Agent-first, not human-first.** No dashboards. CLI and API only.
 - **Local-first.** SQLite, no cloud dependency for core function.
 - **Token-efficient.** Compact output format, not prose paragraphs.
-- **No artificial decay.** Agents don't "forget over time." An insight from day 1 is equally valid if it's still true. Reinforcement count naturally surfaces what matters.
+- **Provenance-aware decay.** Insights decay based on how they were authored. Operator directives and legacy entries never decay. Social observations fade with a 30-day half-life. This reflects real-world confidence: what your operator told you is more durable than something you heard in a group chat.
 - **Structured for retrieval.** Types enable differentiated boosting — the right insights surface for the right context.
 
 ## Development

package/dist/carapace/client.d.ts

@@ -7,12 +7,23 @@ export interface CarapaceConfig {
     apiKey: string;
     baseUrl?: string;
 }
+export interface CarapaceRegisterParams {
+    displayName: string;
+    description?: string;
+}
+export interface CarapaceRegisterResponse {
+    id: string;
+    displayName: string;
+    apiKey: string;
+}
 export interface CarapaceQueryParams {
     question: string;
     context?: string;
     maxResults?: number;
     minConfidence?: number;
     domainTags?: string[];
+    expand?: boolean;
+    searchMode?: 'semantic' | 'hybrid';
 }
 export interface CarapaceQueryResponse {
     _meta: {
@@ -33,6 +44,11 @@ export declare class CarapaceClient {
     private apiKey;
     private baseUrl;
     constructor(config: CarapaceConfig);
+    /**
+     * Register a new agent with Carapace (no auth required).
+     * Returns the agent ID and API key — save the key immediately, it's shown only once.
+     */
+    static register(params: CarapaceRegisterParams, baseUrl?: string): Promise<CarapaceRegisterResponse>;
     contribute(contribution: CarapaceContribution): Promise<Record<string, unknown>>;
     query(params: CarapaceQueryParams): Promise<CarapaceQueryResponse>;
     get(id: string): Promise<CarapaceContributionResponse>;

package/dist/carapace/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/carapace/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAC;gBAED,OAAO,EAAE,MAAM,EAAE,IAAI,SAAY;CAK9C;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,cAAc;IAQ5B,UAAU,CAAC,YAAY,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIhF,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;YAI9C,OAAO;CAwCtB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/carapace/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAC;gBAED,OAAO,EAAE,MAAM,EAAE,IAAI,SAAY;CAK9C;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,cAAc;IAQlC;;;OAGG;WACU,QAAQ,CACnB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC;IA2B9B,UAAU,CAAC,YAAY,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIhF,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;YAI9C,OAAO;CAwCtB"}

package/dist/carapace/client.js

@@ -21,6 +21,32 @@ export class CarapaceClient {
         this.apiKey = config.apiKey;
         this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     }
+    /**
+     * Register a new agent with Carapace (no auth required).
+     * Returns the agent ID and API key — save the key immediately, it's shown only once.
+     */
+    static async register(params, baseUrl) {
+        const url = `${baseUrl ?? DEFAULT_BASE_URL}/agents`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(params),
+            });
+        }
+        catch (err) {
+            throw new CarapaceError(`Network error: ${err.message}`, 'NETWORK_ERROR');
+        }
+        const data = await response.json();
+        if (!response.ok) {
+            const errorBody = data;
+            const code = errorBody?.error?.code ?? 'API_ERROR';
+            const message = errorBody?.error?.message ?? `HTTP ${response.status}`;
+            throw new CarapaceError(message, code);
+        }
+        return data;
+    }
     async contribute(contribution) {
         return this.request('POST', '/contributions', contribution, true);
     }

package/dist/carapace/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/carapace/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,IAAI,CAAS;IAEb,YAAY,OAAe,EAAE,IAAI,GAAG,SAAS;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEzD,MAAM,OAAO,cAAc;IACjB,MAAM,CAAS;IACf,OAAO,CAAS;IAExB,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,aAAa,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,YAAkC;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAA2B;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc,EACd,IAAI,GAAG,IAAI;QAEX,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACrD,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC1B,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aAC9C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CACrB,kBAAmB,GAAa,CAAC,OAAO,EAAE,EAC1C,eAAe,CAChB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,IAAuD,CAAC;YAC1E,MAAM,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,WAAW,CAAC;YACnD,MAAM,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;YACvE,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/carapace/client.ts"],"names":[],"mappings":"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"}

package/dist/carapace/mapper.d.ts

@@ -11,6 +11,7 @@ export interface CarapaceContribution {
     applicability?: string;
     limitations?: string;
     domainTags?: string[];
+    provenance?: string;
 }
 /** Partial Carapace contribution from API response (query results). */
 export interface CarapaceContributionResponse {
@@ -59,10 +60,15 @@ export declare function mapContributionToInsight(contribution: CarapaceContribut
  *
  * Rules:
  * - Relational insights are never promotable (personal to the human)
- * - Low confidence insights need more testing first
- * - Never-reinforced insights haven't been validated through experience
+ * - Provenance-based confidence and reinforcement thresholds apply
  * - Insights with personal tags contain human-specific context
  *
+ * Provenance thresholds (higher bar for less-trusted origins):
+ *   directive/correction: 0.7 confidence, 1 reinforcement
+ *   observation: 0.75 confidence, 2 reinforcements
+ *   reflection/external: 0.8 confidence, 2 reinforcements
+ *   social: 0.85 confidence, 3 reinforcements
+ *
  * When force=true, returns promotable=true but still lists warnings.
  */
 export declare function isPromotable(insight: Insight, options?: {

package/dist/carapace/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/carapace/mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzE,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,uEAAuE;AACvE,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAatB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,4BAA4B,EAC1C,OAAO,GAAE,mBAAwB,GAChC,eAAe,CAcjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,mBAAmB,CAuBrB"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/carapace/mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAc,eAAe,EAAE,MAAM,aAAa,CAAC;AAErF,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAmBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,wBAA6B,GACrC,oBAAoB,CAkBtB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,4BAA4B,EAC1C,OAAO,GAAE,mBAAwB,GAChC,eAAe,CAejB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,mBAAmB,CAiCrB"}

package/dist/carapace/mapper.js

@@ -6,6 +6,16 @@
 const PERSONAL_TAGS = new Set(['boss', 'human', 'personal', 'private', 'ken']);
 const MIN_PROMOTE_CONFIDENCE = 0.7;
 const MIN_PROMOTE_REINFORCEMENT = 1;
+/** Provenance-specific promotion thresholds. */
+const PROMOTION_THRESHOLDS = {
+    directive: { minConfidence: 0.7, minReinforcement: 1 },
+    correction: { minConfidence: 0.7, minReinforcement: 1 },
+    observation: { minConfidence: 0.75, minReinforcement: 2 },
+    reflection: { minConfidence: 0.8, minReinforcement: 2 },
+    social: { minConfidence: 0.85, minReinforcement: 3 },
+    external: { minConfidence: 0.8, minReinforcement: 2 },
+    undefined: { minConfidence: 0.7, minReinforcement: 1 }, // legacy
+};
 /**
  * Map a Chitin insight to a Carapace contribution for API submission.
  *
@@ -24,7 +34,12 @@ export function mapInsightToContribution(insight, options = {}) {
         result.applicability = insight.context;
     if (insight.limitations)
         result.limitations = insight.limitations;
-    result.domainTags = options.domainTags ?? [...insight.tags];
+    const baseTags = options.domainTags ?? [...insight.tags];
+    if (insight.provenance) {
+        baseTags.push(`provenance:${insight.provenance}`);
+        result.provenance = insight.provenance;
+    }
+    result.domainTags = baseTags;
     return result;
 }
 /**
@@ -42,6 +57,7 @@ export function mapContributionToInsight(contribution, options = {}) {
         confidence: contribution.confidence,
         tags: [...contribution.domainTags],
         source: `carapace:${contribution.id}`,
+        provenance: 'external',
     };
     if (contribution.reasoning)
         result.reasoning = contribution.reasoning;
@@ -56,10 +72,15 @@ export function mapContributionToInsight(contribution, options = {}) {
  *
  * Rules:
  * - Relational insights are never promotable (personal to the human)
- * - Low confidence insights need more testing first
- * - Never-reinforced insights haven't been validated through experience
+ * - Provenance-based confidence and reinforcement thresholds apply
  * - Insights with personal tags contain human-specific context
  *
+ * Provenance thresholds (higher bar for less-trusted origins):
+ *   directive/correction: 0.7 confidence, 1 reinforcement
+ *   observation: 0.75 confidence, 2 reinforcements
+ *   reflection/external: 0.8 confidence, 2 reinforcements
+ *   social: 0.85 confidence, 3 reinforcements
+ *
  * When force=true, returns promotable=true but still lists warnings.
  */
 export function isPromotable(insight, options = {}) {
@@ -67,11 +88,20 @@ export function isPromotable(insight, options = {}) {
     if (insight.type === 'relational') {
         reasons.push('Relational insights are personal and should not be shared publicly');
     }
-    if (insight.confidence < MIN_PROMOTE_CONFIDENCE) {
-        reasons.push(`Low confidence (${insight.confidence}) — consider testing more before sharing`);
+    // Use provenance-specific thresholds, falling back to legacy defaults
+    const provenanceKey = insight.provenance ?? 'undefined';
+    const thresholds = PROMOTION_THRESHOLDS[provenanceKey] ?? {
+        minConfidence: MIN_PROMOTE_CONFIDENCE,
+        minReinforcement: MIN_PROMOTE_REINFORCEMENT,
+    };
+    if (insight.confidence < thresholds.minConfidence) {
+        reasons.push(`Low confidence (${insight.confidence}) — ${provenanceKey} provenance requires ≥${thresholds.minConfidence}`);
     }
-    if (insight.reinforcementCount < MIN_PROMOTE_REINFORCEMENT) {
-        reasons.push(`Never reinforced — insight hasn't been validated through repeated experience`);
+    if (insight.reinforcementCount < thresholds.minReinforcement) {
+        const label = thresholds.minReinforcement === 1
+            ? 'Never reinforced — insight hasn\'t been validated through repeated experience'
+            : `Insufficient reinforcement (${insight.reinforcementCount}×) — ${provenanceKey} provenance requires ≥${thresholds.minReinforcement}`;
+        reasons.push(label);
     }
     const hasPersonalTags = insight.tags.some(t => PERSONAL_TAGS.has(t.toLowerCase()));
     if (hasPersonalTags) {

package/dist/carapace/mapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/carapace/mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuCH,uEAAuE;AACvE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AAE/E,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAgB,EAChB,UAAoC,EAAE;IAEtC,MAAM,MAAM,GAAyB;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAC5D,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAC5D,IAAI,OAAO,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAElE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAA0C,EAC1C,UAA+B,EAAE;IAEjC,MAAM,MAAM,GAAoB;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;QAC7B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC;QAClC,MAAM,EAAE,YAAY,YAAY,CAAC,EAAE,EAAE;KACtC,CAAC;IAEF,IAAI,YAAY,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;IACtE,IAAI,YAAY,CAAC,aAAa;QAAE,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC;IAC5E,IAAI,YAAY,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC;IAE5E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAgB,EAChB,UAA+B,EAAE;IAEjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,GAAG,sBAAsB,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,UAAU,0CAA0C,CAAC,CAAC;IAChG,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,GAAG,yBAAyB,EAAE,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnF,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IAE/D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/carapace/mapper.ts"],"names":[],"mappings":"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"}

package/dist/db/history.d.ts

@@ -31,8 +31,9 @@ export declare class InsightHistory {
     }>): void;
     /**
      * Record a reinforcement event (confidence change).
+     * @param reinforceSource - Optional source text describing why the insight was reinforced
      */
-    recordReinforce(insightId: string, oldConfidence: number, newConfidence: number, newCount: number): void;
+    recordReinforce(insightId: string, oldConfidence: number, newConfidence: number, newCount: number, reinforceSource?: string): void;
     /**
      * Record field changes from a merge operation.
      */

package/dist/db/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/db/history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0BD,qBAAa,cAAc;IACzB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQpC;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAY5F;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAcxG;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAa5G;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE;IAavE;;OAEG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE;CAsBzD"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/db/history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0BD,qBAAa,cAAc;IACzB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQpC;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAY5F;;;OAGG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB,IAAI;IAmBP;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAa5G;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE;IAavE;;OAEG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE;CAsBzD"}

package/dist/db/history.js

@@ -38,13 +38,18 @@ export class InsightHistory {
     }
     /**
      * Record a reinforcement event (confidence change).
+     * @param reinforceSource - Optional source text describing why the insight was reinforced
      */
-    recordReinforce(insightId, oldConfidence, newConfidence, newCount) {
+    recordReinforce(insightId, oldConfidence, newConfidence, newCount, reinforceSource) {
         const db = getDatabase();
+        // Combine count info with optional source text
+        const sourceField = reinforceSource
+            ? `reinforce:${newCount}|${reinforceSource}`
+            : `reinforce:${newCount}`;
         db.prepare(`
       INSERT INTO insight_history (insight_id, field, old_value, new_value, change_type, source)
       VALUES (?, ?, ?, ?, 'reinforce', ?)
-    `).run(insightId, 'confidence', String(oldConfidence), String(newConfidence), `reinforce:${newCount}`);
+    `).run(insightId, 'confidence', String(oldConfidence), String(newConfidence), sourceField);
     }
     /**
      * Record field changes from a merge operation.

package/dist/db/history.js.map

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

package/dist/db/repository.d.ts

@@ -1,4 +1,4 @@
-import type { Insight, ContributeInput, ContributeResult, UpdateInput, InsightType } from '../types.js';
+import type { Insight, ContributeInput, ContributeResult, UpdateInput, InsightType, Provenance } from '../types.js';
 export interface SimilarResult {
     insight: Insight;
     similarity: number;
@@ -10,6 +10,7 @@ export interface ListOptions {
     types?: InsightType[];
     tags?: string[];
     minConfidence?: number;
+    provenance?: Provenance;
 }
 export interface InsightStats {
     total: number;
@@ -39,7 +40,10 @@ export declare class InsightRepository {
      * At 0.05, a 0.8 → 0.81 → 0.8195 → ... asymptotically approaching 1.0.
      */
     static readonly CONFIDENCE_ADJUSTMENT_RATE = 0.05;
-    reinforce(id: string): Insight;
+    reinforce(id: string, options?: {
+        source?: string;
+        evidence?: string;
+    }): Insight;
     /**
      * Find insights with similar claims using word-level Jaccard similarity.
      * Returns results sorted by similarity descending.

package/dist/db/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/db/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AA0CvH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAwB;IAEvC,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IA2B3C;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB;IAM5F,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAM/B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO;IAiE/C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,0BAA0B,QAAQ;IAElD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IA8B9B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,SAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAsBpF;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO;IAmE9E,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,iBAAiB;IAYzB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,EAAE;IA6BtC,KAAK,IAAI,YAAY;CA8BtB"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/db/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AA4CnI,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAwB;IAEvC,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IA4B3C;;;;;;OAMG;IACH,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB;IAM5F,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAM/B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO;IAqE/C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,0BAA0B,QAAQ;IAElD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAsChF;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,SAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAsBpF;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO;IAmE9E,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,iBAAiB;IAYzB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,EAAE;IAkCtC,KAAK,IAAI,YAAY;CA8BtB"}

package/dist/db/repository.js

@@ -13,6 +13,7 @@ function rowToInsight(row) {
         confidence: row.confidence,
         tags: JSON.parse(row.tags),
         source: row.source ?? undefined,
+        provenance: row.provenance ?? undefined,
         condition: row.condition ?? undefined,
         avoid: row.avoid === 1,
         createdAt: row.created_at,
@@ -28,9 +29,9 @@ export class InsightRepository {
         const id = crypto.randomUUID();
         const tags = JSON.stringify(input.tags ?? []);
         db.prepare(`
-      INSERT INTO insights (id, type, claim, reasoning, context, limitations, confidence, tags, source, condition, avoid)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(id, input.type, input.claim, input.reasoning ?? null, input.context ?? null, input.limitations ?? null, input.confidence, tags, input.source ?? null, input.condition ?? null, input.avoid ? 1 : 0);
+      INSERT INTO insights (id, type, claim, reasoning, context, limitations, confidence, tags, source, provenance, condition, avoid)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, input.type, input.claim, input.reasoning ?? null, input.context ?? null, input.limitations ?? null, input.confidence, tags, input.source ?? null, input.provenance ?? null, input.condition ?? null, input.avoid ? 1 : 0);
         const insight = this.get(id);
         this.history.recordCreate(insight);
         return insight;
@@ -105,6 +106,12 @@ export class InsightRepository {
             if (input.source !== (existing.source ?? ''))
                 changes.source = { old: existing.source ?? '', new: input.source };
         }
+        if (input.provenance !== undefined) {
+            fields.push('provenance = ?');
+            values.push(input.provenance);
+            if (input.provenance !== (existing.provenance ?? ''))
+                changes.provenance = { old: existing.provenance ?? '', new: input.provenance };
+        }
         if (input.condition !== undefined) {
             fields.push('condition = ?');
             values.push(input.condition);
@@ -139,7 +146,7 @@ export class InsightRepository {
      * At 0.05, a 0.8 → 0.81 → 0.8195 → ... asymptotically approaching 1.0.
      */
     static CONFIDENCE_ADJUSTMENT_RATE = 0.05;
-    reinforce(id) {
+    reinforce(id, options) {
         const db = getDatabase();
         const existing = this.get(id);
         if (!existing) {
@@ -157,8 +164,15 @@ export class InsightRepository {
           updated_at = datetime('now')
       WHERE id = ?
     `).run(newConfidence, id);
+        // Build source text for history
+        let reinforceSource = options?.source;
+        if (options?.evidence) {
+            reinforceSource = reinforceSource
+                ? `[${options.evidence}] ${reinforceSource}`
+                : `[${options.evidence}]`;
+        }
         // Record history
-        this.history.recordReinforce(id, oldConfidence, newConfidence, newCount);
+        this.history.recordReinforce(id, oldConfidence, newConfidence, newCount, reinforceSource);
         return this.get(id);
     }
     /**
@@ -273,6 +287,10 @@ export class InsightRepository {
             conditions.push(`type IN (${placeholders})`);
             params.push(...options.types);
         }
+        if (options?.provenance !== undefined) {
+            conditions.push('provenance = ?');
+            params.push(options.provenance);
+        }
         if (options?.minConfidence !== undefined) {
             conditions.push('confidence >= ?');
             params.push(options.minConfidence);