@wipcomputer/wip-ldm-os 0.4.73-alpha.14 → 0.4.73-alpha.16

package/dist/bridge/{chunk-RUQEH7GZ.js → chunk-24DJYS7Z.js}

@@ -9,7 +9,7 @@ var execAsync = promisify(exec);
 var GATEWAY_HOST = "127.0.0.1";
 var DEFAULT_GATEWAY_PORT = 18789;
 var DEFAULT_INBOX_PORT = 18790;
-var GATEWAY_TIMEOUT_MS = 15e3;
+var GATEWAY_TIMEOUT_MS = 12e4;
 var OP_CLI_TIMEOUT_MS = 1e4;
 var EMBEDDING_API_URL = "https://api.openai.com/v1/embeddings";
 var DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
@@ -283,31 +283,41 @@ async function sendMessage(openclawDir, message, options) {
   const { token, port } = resolveGatewayConfig(openclawDir);
   const agentId = options?.agentId || "main";
   const senderLabel = options?.senderLabel || "Claude Code";
+  const fireAndForget = options?.fireAndForget ?? false;
+  const requestBody = JSON.stringify({
+    model: `openclaw/${agentId}`,
+    messages: [
+      {
+        role: "user",
+        content: `[${senderLabel}]: ${message}`
+      }
+    ]
+  });
+  const requestHeaders = {
+    Authorization: `Bearer ${token}`,
+    "Content-Type": "application/json",
+    "x-openclaw-scopes": "operator.read,operator.write",
+    "x-openclaw-session-key": `agent:${agentId}:main`
+  };
+  const url = `http://${GATEWAY_HOST}:${port}/v1/chat/completions`;
+  if (fireAndForget) {
+    fetch(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: requestBody
+    }).catch(() => {
+    });
+    return "Message sent (queued). Response will arrive in the TUI.";
+  }
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), GATEWAY_TIMEOUT_MS);
   try {
-    const response = await fetch(
-      `http://${GATEWAY_HOST}:${port}/v1/chat/completions`,
-      {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "Content-Type": "application/json",
-          "x-openclaw-scopes": "operator.read,operator.write",
-          "x-openclaw-session-key": `agent:${agentId}:main`
-        },
-        body: JSON.stringify({
-          model: `openclaw/${agentId}`,
-          messages: [
-            {
-              role: "user",
-              content: `[${senderLabel}]: ${message}`
-            }
-          ]
-        }),
-        signal: controller.signal
-      }
-    );
+    const response = await fetch(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: requestBody,
+      signal: controller.signal
+    });
     clearTimeout(timeoutId);
     if (!response.ok) {
       const body = await response.text();

package/dist/bridge/cli.js

@@ -8,7 +8,7 @@ import {
   searchConversations,
   searchWorkspace,
   sendMessage
-} from "./chunk-RUQEH7GZ.js";
+} from "./chunk-24DJYS7Z.js";
 
 // cli.ts
 import { existsSync, statSync } from "fs";

package/dist/bridge/core.d.ts

@@ -107,6 +107,7 @@ declare function sendMessage(openclawDir: string, message: string, options?: {
     agentId?: string;
     user?: string;
     senderLabel?: string;
+    fireAndForget?: boolean;
 }): Promise<string>;
 declare function getQueryEmbedding(text: string, apiKey: string, model?: string, dimensions?: number): Promise<number[]>;
 declare function blobToEmbedding(blob: Buffer): number[];

package/dist/bridge/core.js

@@ -23,7 +23,7 @@ import {
   sendLdmMessage,
   sendMessage,
   setSessionIdentity
-} from "./chunk-RUQEH7GZ.js";
+} from "./chunk-24DJYS7Z.js";
 export {
   LDM_ROOT,
   blobToEmbedding,

package/dist/bridge/mcp-server.js

@@ -15,7 +15,7 @@ import {
   sendLdmMessage,
   sendMessage,
   setSessionIdentity
-} from "./chunk-RUQEH7GZ.js";
+} from "./chunk-24DJYS7Z.js";
 
 // mcp-server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/docs/doc-pipeline/README.md

@@ -0,0 +1,74 @@
+# Documentation Pipeline
+
+Documentation lives in three places. They stay in sync through the installer. This is not optional.
+
+## The Three Levels
+
+### 1. Repo Docs (source of truth)
+
+Every repo has documentation at its root and in `docs/` for features:
+
+```
+repo/
+├── README.md              What this repo is
+├── TECHNICAL.md           How it works
+├── SKILL.md               Agent instructions
+├── CLAUDE.md              Agent context for Claude Code
+├── docs/
+│   └── <feature>/
+│       ├── README.md      What this feature is
+│       └── TECHNICAL.md   How this feature works
+```
+
+When a feature gets absorbed into a repo, its README and TECHNICAL move into `docs/<feature>/`.
+
+Repo docs are the source of truth. Everything else is derived from them.
+
+### 2. Home Docs (human readable, personalized)
+
+Location: `~/wipcomputerinc/library/documentation/`
+
+These are personalized for YOUR system. "Here's how releases work on YOUR machine." Generated by the installer from repo doc templates + your `~/.ldm/config.json`.
+
+The human reads these. They describe how the system is set up on this specific machine, with this specific configuration.
+
+### 3. Agent Docs (OS reference)
+
+Location: `~/.ldm/shared/`
+
+```
+~/.ldm/shared/
+├── rules/               Thin rules deployed to ~/.claude/rules/
+├── dev-guide-*.md       Org-specific dev conventions
+├── boot/                Boot sequence config
+└── prompts/             Cron prompts
+```
+
+These are what agents reference. Rules, dev guide, boot config. The installer deploys them so agents always have current instructions.
+
+### 4. ai/ (development process)
+
+Location: `<repo>/ai/`
+
+Plans, bugs, research, dev updates. Private repo only. Never ships to public. Updated by the dev team (humans + AI agents) during development.
+
+## The Update Flow
+
+### On merge to private main
+
+1. **Repo docs** updated. README, TECHNICAL, docs/<feature>/, SKILL.md, CLAUDE.md. Part of the PR. Code and docs ship together.
+2. **ai/** updated. Plan archived, bugs closed, dev update written. Notes the version is on alpha.
+
+### On `ldm install`
+
+3. **Home docs** regenerated. Installer reads repo doc templates + config.json, generates personalized `library/documentation/` files.
+4. **Agent docs** deployed. Installer copies rules, dev guide, boot config from the installed package to `~/.ldm/shared/` and `~/.claude/rules/`.
+
+### On deploy to public
+
+5. **Public repo** updated. `deploy-public.sh` syncs everything except `ai/`.
+6. **ai/** dev update notes the version moved from alpha to release.
+
+## The Rule
+
+Three places, one update, never out of sync. The installer is the bridge between "code landed" and "docs are current everywhere." Developers write repo docs. The installer propagates them. Nobody manually updates home docs or agent docs.

package/docs/doc-pipeline/TECHNICAL.md

@@ -0,0 +1,79 @@
+# Documentation Pipeline: Technical Details
+
+## File Paths
+
+### Repo doc templates (in the LDM OS repo)
+
+```
+shared/docs/*.md.tmpl           Templates for home docs
+shared/rules/*.md               Source for agent rules
+shared/boot/                    Boot sequence config
+```
+
+Templates use placeholders from `~/.ldm/config.json` (workspace path, agent names, org name, etc.).
+
+### Installed locations
+
+```
+~/.ldm/config.json                       Org config (agents, paths, co-authors)
+~/.ldm/shared/rules/*.md                 Agent rules (source for ~/.claude/rules/)
+~/.ldm/shared/dev-guide-*.md             Org dev guide
+~/.ldm/shared/boot/                      Boot sequence config
+~/.ldm/shared/prompts/                   Cron prompts
+~/.ldm/templates/                        CLAUDE.md templates, install prompt, etc.
+~/wipcomputerinc/library/documentation/  Personalized human docs (from templates)
+~/.claude/rules/                         Deployed rules (copied from ~/.ldm/shared/rules/)
+~/.claude/CLAUDE.md                      Level 1 global (generated from template + config)
+```
+
+### What ldm install deploys
+
+| Source | Destination | When |
+|--------|------------|------|
+| `shared/rules/*.md` | `~/.ldm/shared/rules/` then `~/.claude/rules/` | Every install |
+| `shared/docs/*.md.tmpl` | `~/wipcomputerinc/library/documentation/` | Every install |
+| `shared/boot/` | `~/.ldm/shared/boot/` | Every install |
+| `shared/prompts/` | `~/.ldm/shared/prompts/` | Every install |
+| `shared/templates/` | `~/.ldm/templates/` | Every install |
+
+**Known bug (April 2026):** The installer currently deploys shared rules on `ldm init` (first install) but not on every `ldm install`. This means rule updates in new versions don't propagate until the user re-initializes. This needs to be fixed so rules deploy on every install.
+
+**Known bug (April 2026):** The installer previously deployed home docs to `settings/docs/`. This path was renamed to `library/documentation/` on March 28, 2026. The installer must deploy to the correct path.
+
+## How templates work
+
+Home doc templates at `shared/docs/*.md.tmpl` contain placeholders:
+
+```
+Workspace: {{workspace}}
+Agents: {{agents}}
+```
+
+The installer reads `~/.ldm/config.json`, substitutes the placeholders, and writes the personalized docs to `~/wipcomputerinc/library/documentation/`.
+
+## CLAUDE.md cascade
+
+Three levels. Claude Code reads all of them, walking up from CWD:
+
+```
+Level 1: ~/.claude/CLAUDE.md              Global. ~30 lines. Universal rules.
+Level 2: ~/wipcomputerinc/CLAUDE.md       Workspace. ~150 lines. Org context.
+Level 3: <repo>/CLAUDE.md                 Per-repo. ~50-86 lines. Repo-specific.
+```
+
+After context compaction, CWD may shift to a repo. Without Level 3, all context is lost. Every repo must have a CLAUDE.md.
+
+## Config paths (correct as of April 2026)
+
+References in CLAUDE.md and rules must use absolute paths:
+
+| Reference | Correct path |
+|-----------|-------------|
+| Org config | `~/.ldm/config.json` |
+| Dev guide | `~/.ldm/shared/dev-guide-wipcomputerinc.md` |
+| Human docs | `~/wipcomputerinc/library/documentation/` |
+| Agent rules | `~/.ldm/shared/rules/` (source) or `~/.claude/rules/` (deployed) |
+| Workspace CLAUDE.md | `~/wipcomputerinc/CLAUDE.md` |
+| Global CLAUDE.md | `~/.claude/CLAUDE.md` |
+
+NOT `settings/config.json`. NOT `settings/docs/`. Those paths are from before the March 28 rename.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-ldm-os",
-  "version": "0.4.73-alpha.14",
+  "version": "0.4.73-alpha.16",
   "type": "module",
   "description": "LDM OS: identity, memory, and sovereignty infrastructure for AI agents",
   "engines": {

package/src/bridge/core.ts

@@ -16,7 +16,7 @@ const execAsync = promisify(exec);
 const GATEWAY_HOST = "127.0.0.1";
 const DEFAULT_GATEWAY_PORT = 18_789;         // openclaw.json gateway.port fallback
 const DEFAULT_INBOX_PORT = 18_790;           // env LESA_BRIDGE_INBOX_PORT fallback
-const GATEWAY_TIMEOUT_MS = 15_000;           // max wait for gateway chat response
+const GATEWAY_TIMEOUT_MS = 120_000;          // max wait for gateway chat response (2 min, agent turns can be long)
 const OP_CLI_TIMEOUT_MS = 10_000;            // max wait for 1Password CLI
 const EMBEDDING_API_URL = "https://api.openai.com/v1/embeddings";
 const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
@@ -475,41 +475,58 @@ export function listActiveSessions(agentFilter?: string): SessionInfo[] {
 export async function sendMessage(
   openclawDir: string,
   message: string,
-  options?: { agentId?: string; user?: string; senderLabel?: string }
+  options?: { agentId?: string; user?: string; senderLabel?: string; fireAndForget?: boolean }
 ): Promise<string> {
   const { token, port } = resolveGatewayConfig(openclawDir);
   const agentId = options?.agentId || "main";
   const senderLabel = options?.senderLabel || "Claude Code";
+  const fireAndForget = options?.fireAndForget ?? false;
 
   // Send user: "main" to route to the main session (agent:main:main).
   // This ensures Parker sees CC's messages in the same stream as iMessage.
   // The OpenClaw gateway treats user: "main" as "use the default session."
+  const requestBody = JSON.stringify({
+    model: `openclaw/${agentId}`,
+    messages: [
+      {
+        role: "user",
+        content: `[${senderLabel}]: ${message}`,
+      },
+    ],
+  });
+
+  const requestHeaders: Record<string, string> = {
+    Authorization: `Bearer ${token}`,
+    "Content-Type": "application/json",
+    "x-openclaw-scopes": "operator.read,operator.write",
+    "x-openclaw-session-key": `agent:${agentId}:main`,
+  };
+
+  const url = `http://${GATEWAY_HOST}:${port}/v1/chat/completions`;
+
+  // Fire-and-forget: send the request and return immediately.
+  // The message is queued in the gateway. Lēsa processes it when she's ready.
+  // No timeout. No waiting. Like dropping a letter in a mailbox.
+  if (fireAndForget) {
+    fetch(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: requestBody,
+    }).catch(() => {}); // Ignore errors silently
+    return "Message sent (queued). Response will arrive in the TUI.";
+  }
+
+  // Synchronous: wait for the full response.
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), GATEWAY_TIMEOUT_MS);
 
   try {
-    const response = await fetch(
-      `http://${GATEWAY_HOST}:${port}/v1/chat/completions`,
-      {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "Content-Type": "application/json",
-          "x-openclaw-scopes": "operator.read,operator.write",
-          "x-openclaw-session-key": `agent:${agentId}:main`,
-        },
-        body: JSON.stringify({
-          model: `openclaw/${agentId}`,
-          messages: [
-            {
-              role: "user",
-              content: `[${senderLabel}]: ${message}`,
-            },
-          ],
-        }),
-        signal: controller.signal,
-      }
-    );
+    const response = await fetch(url, {
+      method: "POST",
+      headers: requestHeaders,
+      body: requestBody,
+      signal: controller.signal,
+    });
     clearTimeout(timeoutId);
 
     if (!response.ok) {