@wipcomputer/wip-ldm-os 0.2.1

package/lib/detect.mjs

@@ -0,0 +1,130 @@
+/**
+ * lib/detect.mjs
+ * Interface detection logic. Scans a repo and reports which interfaces it exposes.
+ * Adapted from wip-universal-installer/detect.mjs. Zero dependencies.
+ */
+
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+
+function readJSON(path) {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Detect all interfaces in a repo.
+ * Returns { interfaces, pkg } where interfaces is an object keyed by interface type.
+ */
+export function detectInterfaces(repoPath) {
+  const interfaces = {};
+  const pkg = readJSON(join(repoPath, 'package.json'));
+
+  // 1. CLI: package.json has bin entry
+  if (pkg?.bin) {
+    interfaces.cli = { bin: pkg.bin, name: pkg.name };
+  }
+
+  // 2. Module: package.json has main or exports
+  if (pkg?.main || pkg?.exports) {
+    interfaces.module = { main: pkg.main || pkg.exports };
+  }
+
+  // 3. MCP Server: mcp-server.mjs/js/ts or dist/mcp-server.js
+  const mcpFiles = ['mcp-server.mjs', 'mcp-server.js', 'mcp-server.ts', 'dist/mcp-server.js'];
+  for (const f of mcpFiles) {
+    if (existsSync(join(repoPath, f))) {
+      interfaces.mcp = { file: f, name: pkg?.name || basename(repoPath) };
+      break;
+    }
+  }
+
+  // 4. OpenClaw Plugin: openclaw.plugin.json exists
+  const ocPlugin = join(repoPath, 'openclaw.plugin.json');
+  if (existsSync(ocPlugin)) {
+    interfaces.openclaw = { config: readJSON(ocPlugin), path: ocPlugin };
+  }
+
+  // 5. Skill: SKILL.md exists
+  if (existsSync(join(repoPath, 'SKILL.md'))) {
+    interfaces.skill = { path: join(repoPath, 'SKILL.md') };
+  }
+
+  // 6. Claude Code Hook: guard.mjs or claudeCode.hook in package.json
+  if (pkg?.claudeCode?.hook) {
+    interfaces.claudeCodeHook = pkg.claudeCode.hook;
+  } else if (existsSync(join(repoPath, 'guard.mjs'))) {
+    interfaces.claudeCodeHook = {
+      event: 'PreToolUse',
+      matcher: 'Edit|Write',
+      command: `node "${join(repoPath, 'guard.mjs')}"`,
+      timeout: 5,
+    };
+  }
+
+  return { interfaces, pkg };
+}
+
+/**
+ * Describe detected interfaces as a human-readable summary.
+ */
+export function describeInterfaces(interfaces) {
+  const lines = [];
+  const names = Object.keys(interfaces);
+
+  if (names.length === 0) {
+    return 'No interfaces detected.';
+  }
+
+  if (interfaces.cli) {
+    const bins = typeof interfaces.cli.bin === 'string' ? [interfaces.cli.name] : Object.keys(interfaces.cli.bin);
+    lines.push(`CLI: ${bins.join(', ')}`);
+  }
+  if (interfaces.module) lines.push(`Module: ${JSON.stringify(interfaces.module.main)}`);
+  if (interfaces.mcp) lines.push(`MCP Server: ${interfaces.mcp.file}`);
+  if (interfaces.openclaw) lines.push(`OpenClaw Plugin: ${interfaces.openclaw.config?.name || 'detected'}`);
+  if (interfaces.skill) lines.push(`Skill: SKILL.md`);
+  if (interfaces.claudeCodeHook) lines.push(`Claude Code Hook: ${interfaces.claudeCodeHook.event || 'PreToolUse'}`);
+
+  return `${names.length} interface(s): ${names.join(', ')}\n${lines.map(l => `  ${l}`).join('\n')}`;
+}
+
+/**
+ * Detect if a repo is a toolbox (has tools/ subdirectories with package.json).
+ * Returns array of { name, path } for each sub-tool, or empty array if not a toolbox.
+ */
+export function detectToolbox(repoPath) {
+  const toolsDir = join(repoPath, 'tools');
+  if (!existsSync(toolsDir)) return [];
+
+  try {
+    const entries = readdirSync(toolsDir, { withFileTypes: true });
+    return entries
+      .filter(e => e.isDirectory() && existsSync(join(toolsDir, e.name, 'package.json')))
+      .map(e => ({ name: e.name, path: join(toolsDir, e.name) }));
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Detect interfaces and return a structured JSON-serializable result.
+ */
+export function detectInterfacesJSON(repoPath) {
+  const { interfaces, pkg } = detectInterfaces(repoPath);
+  return {
+    repo: basename(repoPath),
+    package: pkg?.name || null,
+    version: pkg?.version || null,
+    interfaces: Object.fromEntries(
+      Object.entries(interfaces).map(([type, info]) => [type, {
+        detected: true,
+        ...info,
+      }])
+    ),
+    interfaceCount: Object.keys(interfaces).length,
+  };
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@wipcomputer/wip-ldm-os",
+  "version": "0.2.1",
+  "type": "module",
+  "description": "LDM OS: identity, memory, and sovereignty infrastructure for AI agents",
+  "main": "src/boot/boot-hook.mjs",
+  "bin": {
+    "ldm": "./bin/ldm.mjs",
+    "wip-ldm-os": "./bin/ldm.mjs",
+    "ldm-scaffold": "./bin/scaffold.sh",
+    "ldm-boot-install": "./src/boot/install-cli.mjs"
+  },
+  "claudeCode": {
+    "hook": {
+      "event": "SessionStart",
+      "matcher": "*",
+      "command": "node /Users/lesa/.ldm/shared/boot/boot-hook.mjs",
+      "timeout": 15
+    }
+  },
+  "files": [
+    "src/",
+    "lib/",
+    "bin/",
+    "templates/",
+    "catalog.json",
+    "SKILL.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wipcomputer/wip-ldm-os-private.git"
+  },
+  "author": "WIP Computer, Inc.",
+  "license": "MIT"
+}

package/src/boot/README.md

@@ -0,0 +1,61 @@
+# LDM OS Boot Sequence Hook
+
+SessionStart hook for Claude Code. Reads boot files and injects them into the agent's context before the first user message. No dependencies. No build step.
+
+## What It Does
+
+Reads 9 files from the Dream Weaver Boot Sequence (SHARED-CONTEXT.md, SOUL.md, CONTEXT.md, daily logs, journals, repo-locations.md) and injects them as `additionalContext` in the SessionStart response. The agent wakes up already knowing who it is, what's happening, and where things live.
+
+## Content Budget
+
+~700 lines, ~3,500 tokens. Under 2% of the context window. Large files (journals, daily logs) are truncated. Missing files are skipped gracefully.
+
+## Deploy
+
+```bash
+mkdir -p ~/.ldm/shared/boot
+cp src/boot/boot-hook.mjs ~/.ldm/shared/boot/
+cp src/boot/boot-config.json ~/.ldm/shared/boot/
+```
+
+Then add to `~/.claude/settings.json` inside the `hooks` object:
+
+```json
+"SessionStart": [
+  {
+    "matcher": "*",
+    "hooks": [
+      {
+        "type": "command",
+        "command": "node /Users/lesa/.ldm/shared/boot/boot-hook.mjs",
+        "timeout": 15
+      }
+    ]
+  }
+]
+```
+
+Restart Claude Code to pick up the hook.
+
+## Test
+
+```bash
+echo '{"session_id":"test","hook_event_name":"SessionStart"}' | node ~/.ldm/shared/boot/boot-hook.mjs
+```
+
+Should output JSON with `hookSpecificOutput.additionalContext` containing all boot content. Check stderr for the load summary.
+
+## Config
+
+`boot-config.json` defines paths and limits for each boot step. Uses `~` shorthand (resolved at runtime). To support a different agent (cc-air), deploy a different config alongside the same script.
+
+## Adding a Boot Step
+
+1. Add an entry to `boot-config.json` under `steps`
+2. Set `path` (single file) or `dir` + `strategy` (directory scan)
+3. Set `stepNumber`, `label`, and optionally `maxLines` and `critical`
+4. The hook picks it up automatically. No code changes needed.
+
+## Error Philosophy
+
+Partial boot > no boot > blocked session. The hook exits 0 no matter what. Missing files are logged to stderr and skipped. The session always starts.

package/src/boot/boot-config.json

@@ -0,0 +1,65 @@
+{
+  "agentId": "cc-mini",
+  "timezone": "America/Los_Angeles",
+  "maxTotalLines": 2000,
+  "steps": {
+    "sharedContext": {
+      "path": "~/.openclaw/workspace/SHARED-CONTEXT.md",
+      "label": "SHARED-CONTEXT.md",
+      "stepNumber": 2,
+      "critical": true
+    },
+    "journals": {
+      "dir": "~/Documents/wipcomputer--mac-mini-01/staff/Parker/Claude Code - Mini/documents/journals",
+      "label": "Most Recent Journal (Parker)",
+      "stepNumber": 3,
+      "maxLines": 80,
+      "strategy": "most-recent"
+    },
+    "workspaceDailyLogs": {
+      "dir": "~/.openclaw/workspace/memory",
+      "label": "Workspace Daily Logs",
+      "stepNumber": 4,
+      "maxLines": 40,
+      "strategy": "daily-logs",
+      "days": ["today", "yesterday"]
+    },
+    "fullHistory": {
+      "label": "Full History",
+      "stepNumber": 5,
+      "reminder": "Read on cold start: staff/Parker/Claude Code - Mini/documents/cc-full-history.md"
+    },
+    "context": {
+      "path": "~/.ldm/agents/cc-mini/CONTEXT.md",
+      "label": "CC CONTEXT.md",
+      "stepNumber": 6,
+      "critical": true
+    },
+    "soul": {
+      "path": "~/.ldm/agents/cc-mini/SOUL.md",
+      "label": "CC SOUL.md",
+      "stepNumber": 7
+    },
+    "ccJournals": {
+      "dir": "~/.ldm/agents/cc-mini/memory/journals",
+      "label": "Most Recent CC Journal",
+      "stepNumber": 8,
+      "maxLines": 80,
+      "strategy": "most-recent"
+    },
+    "ccDailyLog": {
+      "dir": "~/.ldm/agents/cc-mini/memory/daily",
+      "label": "CC Daily Log",
+      "stepNumber": 9,
+      "maxLines": 60,
+      "strategy": "daily-logs",
+      "days": ["today", "yesterday"]
+    },
+    "repoLocations": {
+      "path": "~/.claude/projects/-Users-lesa--openclaw/memory/repo-locations.md",
+      "label": "repo-locations.md",
+      "stepNumber": 10,
+      "critical": true
+    }
+  }
+}

package/src/boot/boot-hook.mjs

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+// LDM OS Boot Sequence Hook
+// SessionStart hook for Claude Code.
+// Reads boot files and injects them into context via additionalContext.
+// Follows guard.mjs pattern: stdin JSON in, stdout JSON out, exit 0 always.
+
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = homedir();
+const TAG = '[boot-hook]';
+
+function resolvePath(p) {
+  if (p.startsWith('~/')) return join(HOME, p.slice(2));
+  return p;
+}
+
+function readFileSafe(filePath) {
+  try {
+    const resolved = resolvePath(filePath);
+    if (!existsSync(resolved)) return null;
+    return readFileSync(resolved, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+
+function listDirSafe(dirPath) {
+  try {
+    const resolved = resolvePath(dirPath);
+    if (!existsSync(resolved)) return [];
+    return readdirSync(resolved).sort();
+  } catch {
+    return [];
+  }
+}
+
+function truncateTop(content, maxLines) {
+  if (!maxLines || !content) return content;
+  const lines = content.split('\n');
+  if (lines.length <= maxLines) return content;
+  return lines.slice(0, maxLines).join('\n') + `\n[... truncated at ${maxLines} lines, ${lines.length} total ...]`;
+}
+
+function truncateBottom(content, maxLines) {
+  if (!maxLines || !content) return content;
+  const lines = content.split('\n');
+  if (lines.length <= maxLines) return content;
+  return `[... showing last ${maxLines} of ${lines.length} lines ...]\n` + lines.slice(-maxLines).join('\n');
+}
+
+function getTodayAndYesterday(timezone) {
+  const now = new Date();
+  const formatter = new Intl.DateTimeFormat('en-CA', {
+    timeZone: timezone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+  });
+  const today = formatter.format(now);
+
+  const yesterday = new Date(now);
+  yesterday.setDate(yesterday.getDate() - 1);
+  const yesterdayStr = formatter.format(yesterday);
+
+  return { today, yesterday: yesterdayStr };
+}
+
+function findMostRecent(dirPath) {
+  const files = listDirSafe(dirPath);
+  // Filter to .md files with date-like names, sort descending
+  const dated = files
+    .filter(f => f.endsWith('.md') && /^\d{4}-\d{2}-\d{2}/.test(f))
+    .sort()
+    .reverse();
+
+  if (dated.length > 0) return dated[0];
+
+  // Fallback: any .md file, most recent by name
+  const mds = files.filter(f => f.endsWith('.md')).sort().reverse();
+  return mds[0] || null;
+}
+
+function loadConfig() {
+  const configPath = join(__dirname, 'boot-config.json');
+  try {
+    return JSON.parse(readFileSync(configPath, 'utf-8'));
+  } catch {
+    process.stderr.write(`${TAG} boot-config.json not found, using hardcoded defaults\n`);
+    return null;
+  }
+}
+
+function getDefaultConfig() {
+  return {
+    agentId: 'cc-mini',
+    timezone: 'America/Los_Angeles',
+    maxTotalLines: 2000,
+    steps: {
+      sharedContext: { path: '~/.openclaw/workspace/SHARED-CONTEXT.md', label: 'SHARED-CONTEXT.md', stepNumber: 2, critical: true },
+      journals: { dir: '~/Documents/wipcomputer--mac-mini-01/staff/Parker/Claude Code - Mini/documents/journals', label: 'Most Recent Journal (Parker)', stepNumber: 3, maxLines: 80, strategy: 'most-recent' },
+      workspaceDailyLogs: { dir: '~/.openclaw/workspace/memory', label: 'Workspace Daily Logs', stepNumber: 4, maxLines: 40, strategy: 'daily-logs', days: ['today', 'yesterday'] },
+      fullHistory: { label: 'Full History', stepNumber: 5, reminder: 'Read on cold start: staff/Parker/Claude Code - Mini/documents/cc-full-history.md' },
+      context: { path: '~/.ldm/agents/cc-mini/CONTEXT.md', label: 'CC CONTEXT.md', stepNumber: 6, critical: true },
+      soul: { path: '~/.ldm/agents/cc-mini/SOUL.md', label: 'CC SOUL.md', stepNumber: 7 },
+      ccJournals: { dir: '~/.ldm/agents/cc-mini/memory/journals', label: 'Most Recent CC Journal', stepNumber: 8, maxLines: 80, strategy: 'most-recent' },
+      ccDailyLog: { dir: '~/.ldm/agents/cc-mini/memory/daily', label: 'CC Daily Log', stepNumber: 9, maxLines: 60, strategy: 'daily-logs', days: ['today', 'yesterday'] },
+      repoLocations: { path: '~/.claude/projects/-Users-lesa--openclaw/memory/repo-locations.md', label: 'repo-locations.md', stepNumber: 10, critical: true },
+    },
+  };
+}
+
+function processStep(key, step, dates) {
+  // Reminder-only step (e.g. full history)
+  if (step.reminder) {
+    return { content: step.reminder, loaded: true, fileName: null };
+  }
+
+  // Single file step
+  if (step.path) {
+    const content = readFileSafe(step.path);
+    if (!content) return { content: null, loaded: false, fileName: resolvePath(step.path) };
+    const trimmed = step.maxLines ? truncateTop(content, step.maxLines) : content;
+    return { content: trimmed, loaded: true, fileName: resolvePath(step.path) };
+  }
+
+  // Directory-based step
+  if (step.dir) {
+    if (step.strategy === 'most-recent') {
+      const fileName = findMostRecent(step.dir);
+      if (!fileName) return { content: null, loaded: false, fileName: resolvePath(step.dir) };
+      const fullPath = join(resolvePath(step.dir), fileName);
+      const content = readFileSafe(fullPath);
+      if (!content) return { content: null, loaded: false, fileName: fullPath };
+      const trimmed = step.maxLines ? truncateTop(content, step.maxLines) : content;
+      return { content: trimmed, loaded: true, fileName: `${fileName}` };
+    }
+
+    if (step.strategy === 'daily-logs') {
+      const parts = [];
+      let anyLoaded = false;
+      for (const day of (step.days || ['today'])) {
+        const dateStr = day === 'today' ? dates.today : dates.yesterday;
+        const fileName = `${dateStr}.md`;
+        const fullPath = join(resolvePath(step.dir), fileName);
+        const content = readFileSafe(fullPath);
+        if (content) {
+          const trimmed = step.maxLines ? truncateBottom(content, step.maxLines) : content;
+          parts.push(`--- ${day} (${dateStr}) ---\n${trimmed}`);
+          anyLoaded = true;
+        }
+      }
+      if (!anyLoaded) return { content: null, loaded: false, fileName: resolvePath(step.dir) };
+      return { content: parts.join('\n\n'), loaded: true, fileName: null };
+    }
+  }
+
+  return { content: null, loaded: false, fileName: null };
+}
+
+async function main() {
+  const startTime = Date.now();
+  let raw = '';
+  for await (const chunk of process.stdin) {
+    raw += chunk;
+  }
+
+  let input;
+  try {
+    input = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  const config = loadConfig() || getDefaultConfig();
+  const dates = getTodayAndYesterday(config.timezone || 'America/Los_Angeles');
+
+  const sections = [];
+  const loaded = [];
+  const skipped = [];
+  let totalLines = 0;
+
+  // Sort steps by stepNumber
+  const stepEntries = Object.entries(config.steps).sort(
+    ([, a], [, b]) => (a.stepNumber || 0) - (b.stepNumber || 0)
+  );
+
+  for (const [key, step] of stepEntries) {
+    const result = processStep(key, step, dates);
+
+    if (result.loaded && result.content) {
+      const criticalTag = step.critical ? ' (CRITICAL)' : '';
+      const fileTag = result.fileName ? `: ${result.fileName}` : '';
+      const header = `== [Step ${step.stepNumber}] ${step.label}${criticalTag}${fileTag} ==`;
+      sections.push(`${header}\n${result.content}`);
+      loaded.push(`Step ${step.stepNumber}: ${step.label}`);
+      totalLines += result.content.split('\n').length;
+    } else {
+      skipped.push(`Step ${step.stepNumber}: ${step.label}`);
+      if (result.fileName) {
+        process.stderr.write(`${TAG} skipped step ${step.stepNumber}: ${result.fileName} not found\n`);
+      }
+    }
+
+    // Safety cap
+    if (totalLines > (config.maxTotalLines || 2000)) {
+      process.stderr.write(`${TAG} hit line cap at ${totalLines} lines, stopping\n`);
+      break;
+    }
+  }
+
+  const elapsed = Date.now() - startTime;
+  const footer = `== Boot complete. Loaded ${loaded.length}/9 files in ${elapsed}ms. ==`;
+  if (skipped.length > 0) {
+    sections.push(`${footer}\nSkipped: ${skipped.join(', ')}`);
+  } else {
+    sections.push(footer);
+  }
+
+  const additionalContext =
+    `== LDM OS BOOT SEQUENCE (loaded automatically by SessionStart hook) ==\n\n` +
+    sections.join('\n\n');
+
+  const output = {
+    hookSpecificOutput: {
+      hookEventName: 'SessionStart',
+      additionalContext,
+    },
+  };
+
+  process.stdout.write(JSON.stringify(output));
+  process.stderr.write(`${TAG} loaded ${loaded.length}/9 files in ${elapsed}ms\n`);
+  process.exit(0);
+}
+
+main().catch((err) => {
+  process.stderr.write(`${TAG} fatal: ${err.message}\n`);
+  process.exit(0);
+});

package/src/boot/install-cli.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// LDM OS Boot Hook Installer CLI
+// Usage:
+//   node install-cli.mjs           # install or update
+//   node install-cli.mjs --status  # show current state
+//   node install-cli.mjs --dry-run # preview without changes
+
+import { detectInstallState, runInstallOrUpdate, formatStatus, formatResult } from './installer.mjs';
+
+const args = process.argv.slice(2);
+
+if (args.includes('--status')) {
+  const state = detectInstallState();
+  console.log(formatStatus(state));
+  process.exit(0);
+}
+
+if (args.includes('--dry-run')) {
+  const result = runInstallOrUpdate({ dryRun: true });
+  console.log(formatResult(result));
+  process.exit(0);
+}
+
+// Run install/update
+const result = runInstallOrUpdate();
+console.log(formatResult(result));
+process.exit(0);