@cleocode/cleo-os 2026.4.16 → 2026.4.17

package/bin/postinstall.js

@@ -1,94 +1,208 @@
-#!/usr/bin/env node
 /**
- * CleoOS postinstall — scaffolds global XDG hub and deploys extensions.
+ * CleoOS postinstall — scaffolds the global XDG hub and deploys extensions.
  *
  * Runs automatically after `npm install -g @cleocode/cleo-os`.
- * Creates XDG-compliant directory structure and copies the CANT bridge
- * extension template into the extensions directory.
+ * Creates an XDG-compliant directory structure, copies the compiled CANT
+ * bridge extension to the extensions directory, and optionally invokes
+ * `cleo skills install` for any bundled CleoOS skills.
  *
- * Skips during workspace/dev installs (non-global).
+ * Behaviour:
+ *   - Skips silently during workspace/dev installs (non-global).
+ *   - All directory creation is idempotent (no-op if directory exists).
+ *   - All file copies are idempotent (only copies if target is missing).
+ *   - Skill install is best-effort; failures are logged but not fatal.
+ *   - Missing `@mariozechner/pi-coding-agent` is handled gracefully.
  *
- * This file is plain JS (not compiled from src/) so it can run before
- * the package is built, matching the @cleocode/cleo postinstall pattern.
+ * This source compiles to `bin/postinstall.js` via a dedicated tsconfig
+ * (see `tsconfig.postinstall.json`). The `postinstall` script in
+ * `package.json` references the compiled output at `bin/postinstall.js`.
+ *
+ * @packageDocumentation
  */
-
-import { existsSync, mkdirSync, cpSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { cpSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { homedir } from 'node:os';
-
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-
+// ---------------------------------------------------------------------------
+// XDG path resolution (inline copy — avoids importing from dist/ which may
+// not exist when this script runs for the first time)
+// ---------------------------------------------------------------------------
+/**
+ * Inline XDG path resolution that mirrors `src/xdg.ts`.
+ *
+ * Uses an inline copy here so the postinstall script can run before
+ * the compiled `dist/` tree is available on a fresh install.
+ *
+ * @returns Resolved CleoOS XDG directory paths.
+ */
+function resolveCleoOsPaths() {
+    const home = homedir();
+    const xdgData = process.env['XDG_DATA_HOME'] ?? join(home, '.local', 'share');
+    const xdgConfig = process.env['XDG_CONFIG_HOME'] ?? join(home, '.config');
+    const data = join(xdgData, 'cleo');
+    const config = join(xdgConfig, 'cleo');
+    return {
+        data,
+        config,
+        agentDir: data,
+        extensions: join(data, 'extensions'),
+        cant: join(data, 'cant'),
+        auth: join(config, 'auth'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Global install detection
+// ---------------------------------------------------------------------------
 /**
- * Detect if this is a global npm install (not a workspace/dev install).
+ * Detect whether this is a global npm / pnpm install.
+ *
+ * Uses four heuristics in priority order:
+ *  1. `npm_config_global=true` env var (set by npm/pnpm for global installs)
+ *  2. Package path contains `lib/node_modules/` (npm global pattern)
+ *  3. Package path starts with `npm_config_prefix` (npm prefix-based check)
+ *  4. Presence of `pnpm-workspace.yaml` two levels up (workspace = dev)
+ *
+ * @returns `true` if the install appears to be a global install.
  */
 function isGlobalInstall() {
-  const pkgRoot = resolve(__dirname, '..');
-
-  // Signal 1: npm_config_global env var (set by npm during global installs)
-  if (process.env.npm_config_global === 'true') return true;
-
-  // Signal 2: path contains a global node_modules (npm, pnpm, yarn)
-  if (/[/\\]lib[/\\]node_modules[/\\]/.test(pkgRoot)) return true;
-
-  // Signal 3: npm_config_prefix matches the package path
-  const prefix = process.env.npm_config_prefix;
-  if (prefix && pkgRoot.startsWith(prefix)) return true;
-
-  // Signal 4: inside a pnpm workspace — definitely not global
-  const workspaceMarker = join(pkgRoot, '..', '..', 'pnpm-workspace.yaml');
-  if (existsSync(workspaceMarker)) return false;
-
-  return false;
+    const pkgRoot = resolve(__dirname, '..');
+    // Signal 1: npm_config_global env var (set by npm during global installs)
+    if (process.env['npm_config_global'] === 'true')
+        return true;
+    // Signal 2: path contains a global node_modules (npm, pnpm, yarn)
+    if (/[/\\]lib[/\\]node_modules[/\\]/.test(pkgRoot))
+        return true;
+    // Signal 3: npm_config_prefix matches the package path
+    const prefix = process.env['npm_config_prefix'];
+    if (prefix !== undefined && pkgRoot.startsWith(prefix))
+        return true;
+    // Signal 4: inside a pnpm workspace — definitely not global
+    const workspaceMarker = join(pkgRoot, '..', '..', 'pnpm-workspace.yaml');
+    if (existsSync(workspaceMarker))
+        return false;
+    return false;
 }
-
+// ---------------------------------------------------------------------------
+// Directory scaffolding
+// ---------------------------------------------------------------------------
 /**
- * Inline XDG path resolution (avoids importing from dist/ which may not exist).
+ * Idempotently create a directory if it does not already exist.
+ *
+ * @param dir - Absolute path to the directory to create.
  */
-function resolveCleoOsPaths() {
-  const home = homedir();
-  const xdgData = process.env.XDG_DATA_HOME ?? join(home, '.local', 'share');
-  const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(home, '.config');
-
-  const data = join(xdgData, 'cleo');
-  const config = join(xdgConfig, 'cleo');
-
-  return {
-    data,
-    config,
-    agentDir: data,
-    extensions: join(data, 'extensions'),
-    cant: join(data, 'cant'),
-    auth: join(config, 'auth'),
-  };
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+        process.stdout.write(`CleoOS: created ${dir}\n`);
+    }
 }
-
+// ---------------------------------------------------------------------------
+// Extension deployment
+// ---------------------------------------------------------------------------
+/**
+ * Copy a compiled extension to the XDG extensions directory.
+ *
+ * Only copies if the target does not already exist (idempotent). The
+ * source is the compiled `.js` file in the package's `extensions/` folder.
+ *
+ * @param extensionName - Filename without the `.js` extension.
+ * @param pkgRoot - Absolute path to the installed package root.
+ * @param extensionsDir - Absolute path to the XDG extensions directory.
+ */
+function deployExtension(extensionName, pkgRoot, extensionsDir) {
+    const src = join(pkgRoot, 'extensions', `${extensionName}.js`);
+    const dest = join(extensionsDir, `${extensionName}.js`);
+    if (!existsSync(src)) {
+        process.stdout.write(`CleoOS: skipping ${extensionName}.js (source not found at ${src})\n`);
+        return;
+    }
+    if (existsSync(dest)) {
+        // Already deployed — idempotent, skip.
+        return;
+    }
+    cpSync(src, dest, { force: false });
+    process.stdout.write(`CleoOS: deployed ${extensionName}.js to ${dest}\n`);
+}
+// ---------------------------------------------------------------------------
+// Default CANT file scaffolding
+// ---------------------------------------------------------------------------
+/**
+ * Write a default `model-routing.cant` stub to the XDG CANT directory if
+ * no `.cant` files are present. This gives the user a starting point for
+ * CANT declarations without overwriting any existing work.
+ *
+ * @param cantDir - Absolute path to the XDG CANT directory.
+ */
+function scaffoldDefaultCant(cantDir) {
+    const modelRoutingPath = join(cantDir, 'model-routing.cant');
+    if (existsSync(modelRoutingPath))
+        return;
+    const stub = [
+        '# CleoOS default model-routing.cant',
+        '# Declare agents, teams, and routing rules here.',
+        '# See: https://github.com/kryptobaseddev/cleo/blob/main/docs/cant-dsl.md',
+        '',
+    ].join('\n');
+    try {
+        writeFileSync(modelRoutingPath, stub, 'utf-8');
+        process.stdout.write(`CleoOS: created default ${modelRoutingPath}\n`);
+    }
+    catch {
+        // Best-effort: non-fatal.
+    }
+}
+// ---------------------------------------------------------------------------
+// Skill installation
+// ---------------------------------------------------------------------------
+/**
+ * Invoke `cleo skills install` via `execFileSync` to register the CleoOS
+ * bundled skills with the project. This is best-effort — if `cleo` is not
+ * on PATH or the command fails, we log and continue.
+ *
+ * Uses `execFileSync` (not `exec`) to prevent shell injection: the command
+ * and arguments are passed as separate parameters so no shell is spawned.
+ */
+function installSkills() {
+    try {
+        execFileSync('cleo', ['skills', 'install'], { stdio: 'inherit' });
+        process.stdout.write('CleoOS: skills install complete\n');
+    }
+    catch {
+        // cleo may not be installed or skills may already be up to date.
+        process.stdout.write('CleoOS: skipping skills install (cleo not found or already installed)\n');
+    }
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+/**
+ * Entry point for the CleoOS postinstall script.
+ *
+ * Orchestrates directory scaffolding, extension deployment, CANT stub
+ * creation, and optional skill installation. All operations are idempotent.
+ */
 function main() {
-  if (!isGlobalInstall()) {
-    console.log('CleoOS: skipping postinstall (not global install)');
-    return;
-  }
-
-  const paths = resolveCleoOsPaths();
-
-  // Scaffold directories
-  for (const dir of [paths.data, paths.config, paths.extensions, paths.cant, paths.auth]) {
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
-      console.log(`CleoOS: created ${dir}`);
+    if (!isGlobalInstall()) {
+        process.stdout.write('CleoOS: skipping postinstall (not global install)\n');
+        return;
+    }
+    const paths = resolveCleoOsPaths();
+    const pkgRoot = resolve(__dirname, '..');
+    // 1. Scaffold XDG directories
+    for (const dir of [paths.data, paths.config, paths.extensions, paths.cant, paths.auth]) {
+        ensureDir(dir);
     }
-  }
-
-  // Deploy bridge extension from package template
-  const bridgeTemplate = join(__dirname, '..', 'extensions', 'cleo-cant-bridge.js');
-  const bridgeTarget = join(paths.extensions, 'cleo-cant-bridge.js');
-  if (existsSync(bridgeTemplate)) {
-    cpSync(bridgeTemplate, bridgeTarget, { force: true });
-    console.log(`CleoOS: deployed bridge extension to ${bridgeTarget}`);
-  }
-
-  console.log('CleoOS: postinstall complete');
+    // 2. Deploy compiled extensions
+    deployExtension('cleo-cant-bridge', pkgRoot, paths.extensions);
+    deployExtension('cleo-chatroom', pkgRoot, paths.extensions);
+    // 3. Write default CANT stub (only if file does not exist)
+    scaffoldDefaultCant(paths.cant);
+    // 4. Install CleoOS skills (best-effort)
+    installSkills();
+    process.stdout.write('CleoOS: postinstall complete\n');
 }
-
 main();
+//# sourceMappingURL=postinstall.js.map

package/bin/postinstall.js.map

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

package/extensions/cleo-cant-bridge.d.ts

@@ -0,0 +1,85 @@
+/**
+ * CleoOS CANT bridge — Wave 2 Pi extension.
+ *
+ * CANONICAL LOCATION: `packages/cleo-os/extensions/cleo-cant-bridge.ts`
+ *
+ * This file was copied from
+ * `packages/cleo/templates/cleoos-hub/pi-extensions/cleo-cant-bridge.ts`
+ * (T393). The template path is kept for reference but this file is the
+ * authoritative source. A future cleanup wave (post-T381) should remove
+ * the template copy once all consumers have migrated.
+ *
+ * Installed to: $XDG_DATA_HOME/cleo/extensions/cleo-cant-bridge.js
+ * Loaded by:    Pi via `--extension <path>` injected by CleoOS cli.ts
+ *
+ * This bridge discovers `.cant` files in the project's `.cleo/cant/`
+ * directory at session start, compiles them via `@cleocode/cant`'s
+ * `compileBundle()`, and appends the compiled declarations to Pi's
+ * system prompt on `before_agent_start`. This gives the LLM awareness
+ * of all declared agents, teams, and tools without hand-authored
+ * protocol text.
+ *
+ * Wave 2 scope:
+ *   - Scans project tier only: `<cwd>/.cleo/cant/` (recursive)
+ *   - Three-tier resolution (global, user, project) is Wave 5
+ *   - Prompt strategy: APPEND (per ULTRAPLAN L6, never replace)
+ *
+ * Wave 8 additions (T420):
+ *   - validate-on-load mental-model injection
+ *   - When the spawned agent's CANT definition has a `mentalModel` block,
+ *     fetches prior mental-model observations via memoryFind and injects
+ *     them into the Pi system prompt with VALIDATE_ON_LOAD_PREAMBLE.
+ *   - Exports `VALIDATE_ON_LOAD_PREAMBLE` and `buildMentalModelInjection`
+ *     for testability (T421).
+ *
+ * Requirements:
+ *   - `@cleocode/cant` must be installed (provides `compileBundle`)
+ *   - Pi coding agent runtime (`@mariozechner/pi-coding-agent`)
+ *
+ * Guardrails:
+ *   - Best-effort: if `@cleocode/cant` is not installed or `.cleo/cant`
+ *     does not exist, the bridge is a no-op. NEVER crash Pi.
+ *   - NO top-level await; all work happens inside event handlers.
+ *   - APPEND to system prompt, never replace.
+ *
+ * @packageDocumentation
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+/**
+ * Preamble text injected into the Pi system prompt when an agent has a
+ * `mental_model:` CANT block. The agent MUST re-evaluate each observation
+ * against the current project state before acting.
+ *
+ * Exported so empirical tests (T421) can assert on its presence.
+ */
+export declare const VALIDATE_ON_LOAD_PREAMBLE: string;
+/** Minimal observation shape returned by memoryFind / searchBrainCompact. */
+export interface MentalModelObservation {
+    id: string;
+    type: string;
+    title: string;
+    date?: string;
+}
+/**
+ * Build the validate-on-load mental-model injection string.
+ *
+ * Pure function — no I/O, safe to call in tests without a real DB.
+ *
+ * @param agentName - Name of the spawned agent (used in the header line).
+ * @param observations - Prior mental-model observations to list.
+ * @returns System-prompt block containing the preamble and numbered observations,
+ *          or an empty string when `observations` is empty.
+ */
+export declare function buildMentalModelInjection(agentName: string, observations: MentalModelObservation[]): string;
+/**
+ * Pi extension factory for the CleoOS CANT bridge.
+ *
+ * Registers event handlers for `session_start` (compile `.cant` files)
+ * and `before_agent_start` (append compiled bundle + mental-model injection
+ * to system prompt). Also registers a `/cant:bundle-info` command for
+ * introspection.
+ *
+ * @param pi - The Pi extension API instance.
+ */
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=cleo-cant-bridge.d.ts.map

package/extensions/cleo-cant-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleo-cant-bridge.d.ts","sourceRoot":"","sources":["cleo-cant-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAIH,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,+BAA+B,CAAC;AAMvC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,QAIiC,CAAC;AAExE,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,sBAAsB,EAAE,GACrC,MAAM,CAmBR;AA+OD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CA6O/C"}