@dtoolkit/dcontext 0.1.0 → 0.1.2

package/README.md

@@ -60,21 +60,27 @@ dcontext hooks into two moments of a session's lifecycle:
 
 The AI receives the context transparently via hooks — it never calls dcontext directly.
 
-```
-┌─────────────────┐     SessionStart      ┌─────────────┐
-│   Claude Code   │◄─────────────────────  │  dcontext    │
-│   Gemini CLI    │  additionalContext     │  (hooks)     │
-│   OpenCode      │                        │              │
-│                 │     PreCompact         │              │
-│                 │─────────────────────►  │              │
-└─────────────────┘  transcript            └──────┬───────┘
-                                                  │
-                                           search / save
-                                                  │
-                                           ┌──────▼───────┐
-                                           │    dbrain     │
-                                           │  (memory)     │
-                                           └──────────────┘
+```mermaid
+graph LR
+    subgraph Clients["AI Coding CLIs"]
+        claude["Claude Code"]
+        gemini["Gemini CLI"]
+        opencode["OpenCode"]
+    end
+
+    subgraph Hooks["dcontext (hooks)"]
+        hook["SessionStart<br/><small>additionalContext</small><br/><br/>PreCompact<br/><small>transcript</small>"]
+    end
+
+    hook -- "additionalContext" --> Clients
+    Clients -- "transcript" --> hook
+    hook -- "search / save" --> brain
+
+    brain["dbrain<br/><strong>memory</strong>"]
+
+    style Clients fill:#f8fafc,color:#1e293b,stroke:#e2e8f0
+    style Hooks fill:#0f3460,color:#fff,stroke:#16213e
+    style brain fill:#2563eb,color:#fff,stroke:#1e40af
 ```
 
 ### What gets injected
@@ -85,9 +91,12 @@ The session briefing includes (in order):
 2. **Soul** — behavioral guidelines
 3. **User** — who you are (name, timezone)
 4. **Project facts** — recent decisions, milestones, preferences, context (up to 15 facts, truncated to 200 chars each)
+5. **Connected brains** — if the personal brain has connections to shared brains, their names and online/offline status
 
 Total briefing capped at 8000 characters.
 
+> When connected to a brain with shared brain connections, dcontext automatically includes federation status in the briefing. The `share` MCP tool is available for pushing facts to team brains.
+
 ### Instruction file integration
 
 When you run `dcontext install <target>`, it modifies the dbrain section in the client's instruction file to tell the AI **not to call `recall` at session start** — since the context is already injected. Run `dbrain connect <target>` to restore the original dbrain instructions after uninstalling.

package/dist/index.js

@@ -39,9 +39,10 @@ function truncateFact(fact, max) {
 async function generateBriefing(projectEntity, config) {
   const client = new DBrainClient(config.dbrain.url, config.dbrain.token);
   const safeQuery = `"${projectEntity}"`;
-  const [results, documents] = await Promise.all([
+  const [results, documents, health] = await Promise.all([
     client.search(safeQuery, { limit: config.briefing.maxFacts }).catch(() => []),
-    config.briefing.includeIdentity ? client.listDocuments() : Promise.resolve([])
+    config.briefing.includeIdentity ? client.listDocuments() : Promise.resolve([]),
+    client.health().catch(() => null)
   ]);
   if (results.length === 0 && documents.length === 0) return null;
   const parts = [];
@@ -77,6 +78,22 @@ async function generateBriefing(projectEntity, config) {
       parts.push(`- [${category}] ${truncateFact(r.fact.fact, config.briefing.maxCharsPerFact)}`);
     }
   }
+  if (health && health.connectedBrains && health.connectedBrains > 0) {
+    try {
+      const connections = await client.listConnections();
+      parts.push("");
+      parts.push(`### Connected Brains (${connections.length})`);
+      for (const conn of connections) {
+        const status = conn.online ? "online" : "offline";
+        parts.push(`- **${conn.name}** (${status})${conn.brainName ? ` \u2014 ${conn.brainName}` : ""}`);
+      }
+      parts.push("");
+      parts.push(
+        "> `recall` automatically searches these brains. Use `share` to push a fact to a connected brain."
+      );
+    } catch {
+    }
+  }
   let briefing = parts.join("\n");
   if (briefing.length > config.briefing.maxChars) {
     briefing = briefing.slice(0, config.briefing.maxChars - 3) + "\u2026";
@@ -173,6 +190,26 @@ async function updateStats(fn) {
   await ensureDataDir();
   await atomicWriteFile(join(DATA_DIR, "stats.json"), JSON.stringify(stats, null, 2) + "\n");
 }
+async function loadSessionOffset(sessionId) {
+  try {
+    const raw = await readFile(join(DATA_DIR, "sessions.json"), "utf-8");
+    const sessions = JSON.parse(raw);
+    return sessions[sessionId] ?? 0;
+  } catch {
+    return 0;
+  }
+}
+async function saveSessionOffset(sessionId, offset) {
+  await ensureDataDir();
+  let sessions = {};
+  try {
+    const raw = await readFile(join(DATA_DIR, "sessions.json"), "utf-8");
+    sessions = JSON.parse(raw);
+  } catch {
+  }
+  sessions[sessionId] = offset;
+  await atomicWriteFile(join(DATA_DIR, "sessions.json"), JSON.stringify(sessions, null, 2) + "\n");
+}
 async function logError(message) {
   try {
     await ensureDataDir();
@@ -244,24 +281,28 @@ async function extractAndSave(sessionId, target, cwd, config) {
   }
   const filtered = entries.filter((e) => e.content.length >= 50);
   if (filtered.length === 0) return null;
-  const messages = filtered.map((e) => ({ role: e.role, content: e.content }));
+  const savedOffset = await loadSessionOffset(sessionId);
+  const newMessages = filtered.slice(savedOffset).map((e) => ({ role: e.role, content: e.content }));
+  if (newMessages.length === 0) return null;
   try {
     const client = new DBrainClient2(config.dbrain.url, config.dbrain.token);
-    const conv = await client.startConversation(`dcontext-${target.name}`);
-    await client.sendMessages(conv.id, messages);
+    await client.startConversation(`dcontext-${target.name}`, sessionId);
+    await client.sendMessages(sessionId, newMessages);
   } catch (err) {
     await logError(`Failed to save to dbrain: ${err.message}`);
+    return null;
   }
+  await saveSessionOffset(sessionId, filtered.length);
   await updateStats((stats) => {
     stats.extractions.total++;
     stats.extractions.lastAt = (/* @__PURE__ */ new Date()).toISOString();
-    stats.extractions.messagesSaved += messages.length;
+    stats.extractions.messagesSaved += newMessages.length;
     if (!stats.byTarget[target.name]) {
       stats.byTarget[target.name] = { briefings: 0, extractions: 0 };
     }
     stats.byTarget[target.name].extractions++;
   });
-  return `Session log saved to dbrain (${messages.length} messages from ${target.name})`;
+  return `Session log saved to dbrain (${newMessages.length} new messages from ${target.name})`;
 }
 
 // src/commands/targets.ts
@@ -680,6 +721,19 @@ async function runStatus() {
       const client = new DBrainClient4(url, token);
       const health = await client.health();
       console.log(`  ${pc4.green(url)} \u2014 ${health.entities} entities, ${health.facts} facts`);
+      const brainType = health.brainType ?? "personal";
+      console.log(`  Type: ${brainType === "shared" ? pc4.green(brainType) : pc4.blue(brainType)}`);
+      if (health.connectedBrains && health.connectedBrains > 0) {
+        console.log(`  Connected: ${pc4.green(String(health.connectedBrains))} brain(s)`);
+        try {
+          const conns = await client.listConnections();
+          for (const c of conns) {
+            const s = c.online ? pc4.green("online") : pc4.red("offline");
+            console.log(`    ${pc4.bold(c.name)} ${s}`);
+          }
+        } catch {
+        }
+      }
     } catch {
       console.log(`  ${pc4.red(url)} (unreachable)`);
     }
@@ -798,7 +852,7 @@ var description = `${pc6.green(banner)}
 
 ${pc6.green("dbrain hooks for AI coding CLIs")}
 ${pc6.dim("Part of the dtoolkit suite")}`;
-program.name("dcontext").description(description).version("0.1.0");
+program.name("dcontext").description(description).version("0.1.2");
 var guarded = (cmd) => {
   cmd.hook("preAction", async () => {
     await requireInit();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtoolkit/dcontext",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "dbrain hooks for AI coding CLIs",
   "type": "module",
   "license": "MIT",
@@ -40,12 +40,12 @@
     "@clack/prompts": "^1.3.0",
     "commander": "^13.0.0",
     "picocolors": "^1.1.0",
-    "@dtoolkit/adapter-gemini": "1.3.0",
-    "@dtoolkit/adapter-claude": "1.3.0",
-    "@dtoolkit/core": "0.4.0",
-    "@dtoolkit/sdk": "0.3.1",
-    "@dtoolkit/adapter-opencode": "1.3.0",
-    "@dtoolkit/adapter-codex": "1.3.0"
+    "@dtoolkit/adapter-claude": "1.3.1",
+    "@dtoolkit/adapter-codex": "1.3.1",
+    "@dtoolkit/adapter-opencode": "1.3.1",
+    "@dtoolkit/adapter-gemini": "1.3.1",
+    "@dtoolkit/core": "0.4.1",
+    "@dtoolkit/sdk": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",