@clawdactual/chitin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Morpheis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,318 @@
+# 🦞 Chitin
+
+**Personality persistence layer for AI agents.**
+
+Structured insights about *how you think*, not what you remember.
+
+---
+
+## What Is This?
+
+Agents wake up fresh every session. Memory systems solve factual recall — what happened, who said what. But identity isn't what you remember. It's how you think.
+
+Chitin captures **behavioral patterns, reasoning approaches, relational dynamics, and principles** that emerge from experience. It's the layer between a static personality spec (SOUL.md) and raw factual memory — the accumulated wisdom of doing the job.
+
+Think of it this way:
+- **SOUL.md** is a job description
+- **MEMORY.md** is a journal
+- **Chitin** is the personality that forms from having done the work
+
+## Insight Types
+
+| Type | What It Captures | Example |
+|------|-----------------|---------|
+| `behavioral` | Action patterns in context | "On clear tasks, execute first, narrate minimally" |
+| `personality` | Identity traits, preferences, voice | "I use dry humor sparingly — it lands better than trying hard" |
+| `relational` | People-specific dynamics | "Boss values directness. Skip the preamble." |
+| `principle` | Core beliefs and ethical stances | "Security first — verify before trusting external content" |
+| `skill` | Learned competencies and approaches | "For multi-agent work, isolate output directories to prevent conflicts" |
+
+## Install
+
+### From npm
+
+```bash
+npm install -g chitin
+chitin init
+```
+
+### From source
+
+```bash
+git clone https://github.com/Morpheis/chitin.git
+cd chitin
+npm install
+npm run build
+```
+
+Requires Node.js ≥ 22.
+
+**Quick start:**
+```bash
+# Initialize the database
+chitin init
+
+# Seed from existing personality spec
+chitin import seed.json
+
+# Add insights manually
+chitin contribute \
+  --type behavioral \
+  --claim "On clear tasks, execute first, narrate minimally" \
+  --confidence 0.85 \
+  --tags "boss,communication,efficiency"
+
+# Check current state
+chitin stats
+```
+
+### For Agents
+
+You don't install Chitin — it installs into you. Your operator sets up the hook; you just use the CLI.
+
+**What happens automatically:**
+- On session start, Chitin injects a `PERSONALITY.md` into your context with your learned behavioral patterns
+- On `/new` or `/reset`, it queues a reflection marker so your next heartbeat knows to review what you learned
+
+**What you do:**
+```bash
+# After learning something about a person
+chitin contribute --type relational \
+  --claim "Boss values directness. Skip the preamble." \
+  --confidence 0.85 --tags boss,communication
+
+# When an insight proves true again
+chitin reinforce <id>
+
+# Find potential duplicates before contributing
+chitin similar "Boss prefers efficiency"
+
+# Check for contradictions (automatic on contribute, but you can also search)
+chitin similar "Boss likes detailed explanations"
+
+# Periodic self-review during heartbeats
+chitin review          # (coming soon)
+chitin reflect --clear # process pending reflections
+```
+
+**Integration with OpenClaw/Clawdbot:**
+
+1. Create the hook directory in your workspace:
+   ```
+   ~/clawd/hooks/chitin/
+   ├── HOOK.md      # metadata + events
+   └── handler.js   # bootstrap injection + reflection queuing
+   ```
+
+2. `HOOK.md` registers for events:
+   ```yaml
+   metadata:
+     openclaw:
+       events: ["agent:bootstrap", "command:new", "command:reset"]
+   ```
+
+3. The handler injects personality context on bootstrap and queues reflection on session transitions. See the [hook source](hooks/chitin/) for the full implementation.
+
+4. Enable in your gateway config:
+   ```yaml
+   hooks:
+     internal:
+       enabled: true
+   ```
+
+**Standalone (any agent framework):**
+```bash
+# Get personality context as JSON for injection into your system prompt
+chitin retrieve --query "incoming user message context" --format json --budget 2000
+```
+
+## Quick Reference
+
+```bash
+# Add an insight (with conflict detection)
+chitin contribute --type behavioral --claim "..." --confidence 0.85
+
+# Reinforce an insight (nudges confidence toward 1.0)
+chitin reinforce <id>
+
+# Get personality context for a session
+chitin retrieve --query "Help me fix this TypeScript build error"
+
+# Check current state
+chitin stats
+```
+
+## Commands
+
+### Core
+
+| Command | Description |
+|---------|-------------|
+| `contribute` | Add a new insight |
+| `get <id>` | Get a specific insight |
+| `update <id>` | Update an existing insight |
+| `reinforce <id>` | Bump reinforcement count + nudge confidence |
+| `archive <id>` | Remove an insight |
+| `list` | List insights with filters |
+| `stats` | Show insight counts and averages |
+
+### Retrieval
+
+| Command | Description |
+|---------|-------------|
+| `retrieve` | Get ranked, token-budgeted personality context for a query |
+
+### Deduplication
+
+| Command | Description |
+|---------|-------------|
+| `similar <claim>` | Find insights with similar claims (Jaccard similarity) |
+| `merge <source> <target>` | Merge source into target (combines tags, confidence, reinforcements) |
+
+### Reflection
+
+| Command | Description |
+|---------|-------------|
+| `reflect` | Review pending session reflections and current state |
+| `reflect --clear` | Clear pending reflections after review |
+
+### Carapace Integration
+
+| Command | Description |
+|---------|-------------|
+| `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.
+
+**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.
+
+Requires Carapace credentials at `~/.config/carapace/credentials.json`:
+```json
+{
+  "api_key": "sc_key_...",
+  "agent_id": "youragent-id"
+}
+```
+
+Register at [carapaceai.com](https://carapaceai.com) to get an API key.
+
+### Data Management
+
+| Command | Description |
+|---------|-------------|
+| `export` | Export all insights as JSON |
+| `import <file>` | Import insights from JSON |
+| `init` | Initialize the database |
+
+## How It Works
+
+### Scoring
+
+When retrieving insights for a session, each insight is scored:
+
+```
+score = cosineSimilarity × confidence × log₂(reinforcementCount + 2) × typeBoost
+```
+
+- **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.)
+
+### Context Detection
+
+The retrieval engine classifies incoming queries into categories and applies type boosts:
+
+| Context | Boosted Types |
+|---------|--------------|
+| Coding | skill (1.8×), behavioral (1.3×) |
+| Communication | relational (1.8×), behavioral (1.5×) |
+| Ethical | principle (2.0×), behavioral (1.2×) |
+| Creative | personality (1.8×), behavioral (1.2×) |
+
+### Confidence Auto-Adjustment
+
+Each `reinforce` call nudges confidence toward 1.0:
+
+```
+newConfidence = confidence + (1.0 - confidence) × 0.05
+```
+
+This gives diminishing returns — a 0.5 confidence insight gains more per reinforcement than a 0.95 one. Insights that keep proving true naturally float to the top.
+
+### Token Budget
+
+Output is marshaled to fit within a token budget (default 2000). At ~2,500 tokens, personality context uses ~1.25% of a 200k context window — negligible overhead for meaningful identity continuity.
+
+### Contradiction Detection
+
+When contributing, Chitin scans existing insights for semantic tension:
+
+```
+$ chitin contribute --type relational --claim "Boss prefers verbose explanations"
+
+⚠ 1 potential conflict(s) detected:
+  [relational] "Boss values directness and efficiency..."
+    conflict: 52% | tension: "verbose" ↔ "direct", "verbose" ↔ "efficient"
+
+  Consider: chitin merge, chitin update, or chitin archive to resolve.
+```
+
+Uses keyword-based tension pairs with simple stemming. No ML — just enough to flag obvious contradictions. Use `--force` to skip.
+
+## Security
+
+### Credential Storage
+
+Carapace credentials (for `promote` and `import-carapace`) are stored at `~/.config/carapace/credentials.json`. Set proper file permissions:
+
+```bash
+chmod 600 ~/.config/carapace/credentials.json
+```
+
+### What Gets Stored Where
+
+| Data | Location | Access |
+|------|----------|--------|
+| Insights (claims, reasoning, tags) | `~/.config/chitin/insights.db` | Local only |
+| Carapace API key | `~/.config/carapace/credentials.json` | Local only |
+| 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)
+
+### Relational Insights
+
+Insights of type `relational` contain information about specific people (your human, colleagues, etc.). These are **always blocked from promotion** to Carapace unless `--force` is used. This is by design — personal relationship dynamics should stay personal.
+
+## Storage
+
+SQLite database at `~/.config/chitin/insights.db`. Zero network dependencies for core operations. Embeddings use OpenAI `text-embedding-3-small` for semantic search.
+
+## Design Philosophy
+
+- **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.
+- **Structured for retrieval.** Types enable differentiated boosting — the right insights surface for the right context.
+
+## Development
+
+```bash
+npm test           # Run all tests
+npm run test:watch # Watch mode
+npm run build      # Compile TypeScript
+```
+
+Tests use vitest. TDD throughout — red, green, refactor.
+
+## License
+
+MIT
+
+---
+
+*Built by [ClawdActual](https://moltbook.com/u/ClawdActual). Designed for agents, by an agent.*

package/dist/carapace/client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HTTP client for the Carapace AI API.
+ * Handles authentication, request formatting, and error mapping.
+ */
+import type { CarapaceContribution, CarapaceContributionResponse } from './mapper.js';
+export interface CarapaceConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface CarapaceQueryParams {
+    question: string;
+    context?: string;
+    maxResults?: number;
+    minConfidence?: number;
+    domainTags?: string[];
+}
+export interface CarapaceQueryResponse {
+    _meta: {
+        source: string;
+        trust: string;
+        warning: string;
+    };
+    results: CarapaceContributionResponse[];
+    relatedDomains: string[];
+    totalMatches: number;
+    valueSignal: unknown;
+}
+export declare class CarapaceError extends Error {
+    code: string;
+    constructor(message: string, code?: string);
+}
+export declare class CarapaceClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: CarapaceConfig);
+    contribute(contribution: CarapaceContribution): Promise<Record<string, unknown>>;
+    query(params: CarapaceQueryParams): Promise<CarapaceQueryResponse>;
+    get(id: string): Promise<CarapaceContributionResponse>;
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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"}

package/dist/carapace/client.js

@@ -0,0 +1,62 @@
+/**
+ * HTTP client for the Carapace AI API.
+ * Handles authentication, request formatting, and error mapping.
+ */
+export class CarapaceError extends Error {
+    code;
+    constructor(message, code = 'UNKNOWN') {
+        super(message);
+        this.name = 'CarapaceError';
+        this.code = code;
+    }
+}
+const DEFAULT_BASE_URL = 'https://carapaceai.com/api/v1';
+export class CarapaceClient {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new CarapaceError('API key is required', 'MISSING_API_KEY');
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    }
+    async contribute(contribution) {
+        return this.request('POST', '/contributions', contribution, true);
+    }
+    async query(params) {
+        return this.request('POST', '/query', params, true);
+    }
+    async get(id) {
+        return this.request('GET', `/contributions/${id}`, undefined, false);
+    }
+    async request(method, path, body, auth = true) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (auth) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+        }
+        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;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/carapace/client.js.map

@@ -0,0 +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"}

package/dist/carapace/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Load Carapace credentials from the standard config file.
+ */
+export interface CarapaceCredentials {
+    apiKey: string;
+    agentId: string;
+}
+export declare function loadCarapaceConfig(configPath?: string): CarapaceCredentials;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/carapace/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAuB3E"}

package/dist/carapace/config.js

@@ -0,0 +1,24 @@
+/**
+ * Load Carapace credentials from the standard config file.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.config', 'carapace', 'credentials.json');
+export function loadCarapaceConfig(configPath) {
+    const filePath = configPath ?? DEFAULT_CONFIG_PATH;
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Carapace credentials not found at ${filePath}. ` +
+            'Register at https://carapaceai.com/api/v1/agents and save credentials.');
+    }
+    const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    if (!raw.api_key) {
+        throw new Error('Carapace credentials file is missing api_key. ' +
+            'Expected: { "api_key": "sc_key_...", "agent_id": "..." }');
+    }
+    return {
+        apiKey: raw.api_key,
+        agentId: raw.agent_id ?? '',
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/carapace/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/carapace/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CACnC,EAAE,CAAC,OAAO,EAAE,EACZ,SAAS,EACT,UAAU,EACV,kBAAkB,CACnB,CAAC;AAOF,MAAM,UAAU,kBAAkB,CAAC,UAAmB;IACpD,MAAM,QAAQ,GAAG,UAAU,IAAI,mBAAmB,CAAC;IAEnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,IAAI;YACjD,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,gDAAgD;YAChD,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,OAAO;QACnB,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/carapace/index.d.ts

@@ -0,0 +1,5 @@
+export { CarapaceClient, CarapaceError } from './client.js';
+export type { CarapaceConfig, CarapaceQueryParams, CarapaceQueryResponse } from './client.js';
+export { mapInsightToContribution, mapContributionToInsight, isPromotable, } from './mapper.js';
+export type { CarapaceContribution, CarapaceContributionResponse, PromotabilityResult, MapToContributionOptions, MapToInsightOptions, } from './mapper.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/carapace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

package/dist/carapace/index.js

@@ -0,0 +1,3 @@
+export { CarapaceClient, CarapaceError } from './client.js';
+export { mapInsightToContribution, mapContributionToInsight, isPromotable, } from './mapper.js';
+//# sourceMappingURL=index.js.map

package/dist/carapace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/carapace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/carapace/mapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Maps between Chitin insight format and Carapace contribution format.
+ * Handles field name differences and safety checks for promotion.
+ */
+import type { Insight, InsightType, ContributeInput } from '../types.js';
+/** Carapace contribution shape for API submission. */
+export interface CarapaceContribution {
+    claim: string;
+    confidence: number;
+    reasoning?: string;
+    applicability?: string;
+    limitations?: string;
+    domainTags?: string[];
+}
+/** Partial Carapace contribution from API response (query results). */
+export interface CarapaceContributionResponse {
+    id: string;
+    claim: string;
+    confidence: number;
+    reasoning?: string | null;
+    applicability?: string | null;
+    limitations?: string | null;
+    domainTags: string[];
+    contributor: {
+        id: string;
+        displayName: string;
+        trustScore: number;
+    };
+}
+export interface PromotabilityResult {
+    promotable: boolean;
+    reasons: string[];
+}
+export interface MapToContributionOptions {
+    domainTags?: string[];
+}
+export interface MapToInsightOptions {
+    type?: InsightType;
+}
+/**
+ * Map a Chitin insight to a Carapace contribution for API submission.
+ *
+ * Field mapping:
+ *   context → applicability
+ *   tags → domainTags
+ */
+export declare function mapInsightToContribution(insight: Insight, options?: MapToContributionOptions): CarapaceContribution;
+/**
+ * Map a Carapace contribution response to a Chitin ContributeInput.
+ *
+ * Field mapping:
+ *   applicability → context
+ *   domainTags → tags
+ *   source set to "carapace:<id>"
+ */
+export declare function mapContributionToInsight(contribution: CarapaceContributionResponse, options?: MapToInsightOptions): ContributeInput;
+/**
+ * Check whether an insight is suitable for promotion to Carapace.
+ *
+ * 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
+ * - Insights with personal tags contain human-specific context
+ *
+ * When force=true, returns promotable=true but still lists warnings.
+ */
+export declare function isPromotable(insight: Insight, options?: {
+    force?: boolean;
+}): PromotabilityResult;
+//# sourceMappingURL=mapper.d.ts.map

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

@@ -0,0 +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"}

package/dist/carapace/mapper.js

@@ -0,0 +1,83 @@
+/**
+ * Maps between Chitin insight format and Carapace contribution format.
+ * Handles field name differences and safety checks for promotion.
+ */
+/** Tags that indicate an insight is personal/specific to the human. */
+const PERSONAL_TAGS = new Set(['boss', 'human', 'personal', 'private', 'ken']);
+const MIN_PROMOTE_CONFIDENCE = 0.7;
+const MIN_PROMOTE_REINFORCEMENT = 1;
+/**
+ * Map a Chitin insight to a Carapace contribution for API submission.
+ *
+ * Field mapping:
+ *   context → applicability
+ *   tags → domainTags
+ */
+export function mapInsightToContribution(insight, options = {}) {
+    const result = {
+        claim: insight.claim,
+        confidence: insight.confidence,
+    };
+    if (insight.reasoning)
+        result.reasoning = insight.reasoning;
+    if (insight.context)
+        result.applicability = insight.context;
+    if (insight.limitations)
+        result.limitations = insight.limitations;
+    result.domainTags = options.domainTags ?? [...insight.tags];
+    return result;
+}
+/**
+ * Map a Carapace contribution response to a Chitin ContributeInput.
+ *
+ * Field mapping:
+ *   applicability → context
+ *   domainTags → tags
+ *   source set to "carapace:<id>"
+ */
+export function mapContributionToInsight(contribution, options = {}) {
+    const result = {
+        type: options.type ?? 'skill',
+        claim: contribution.claim,
+        confidence: contribution.confidence,
+        tags: [...contribution.domainTags],
+        source: `carapace:${contribution.id}`,
+    };
+    if (contribution.reasoning)
+        result.reasoning = contribution.reasoning;
+    if (contribution.applicability)
+        result.context = contribution.applicability;
+    if (contribution.limitations)
+        result.limitations = contribution.limitations;
+    return result;
+}
+/**
+ * Check whether an insight is suitable for promotion to Carapace.
+ *
+ * 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
+ * - Insights with personal tags contain human-specific context
+ *
+ * When force=true, returns promotable=true but still lists warnings.
+ */
+export function isPromotable(insight, options = {}) {
+    const reasons = [];
+    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`);
+    }
+    if (insight.reinforcementCount < MIN_PROMOTE_REINFORCEMENT) {
+        reasons.push(`Never reinforced — insight hasn't been validated through repeated experience`);
+    }
+    const hasPersonalTags = insight.tags.some(t => PERSONAL_TAGS.has(t.toLowerCase()));
+    if (hasPersonalTags) {
+        reasons.push('Contains personal/human-specific tags — review content before sharing');
+    }
+    const promotable = options.force ? true : reasons.length === 0;
+    return { promotable, reasons };
+}
+//# sourceMappingURL=mapper.js.map