omegon 0.6.5 → 0.6.7

package/README.md

@@ -10,6 +10,8 @@ An opinionated distribution of [**pi**](https://github.com/badlogic/pi) — the
 npm install -g omegon
 ```
 
+**Node requirement:** Omegon requires **Node.js 20+**. Node 18 will fail because bundled pi-tui uses modern Unicode regex features unsupported by older runtimes.
+
 This installs the canonical `omegon` command globally. A legacy `pi` alias may remain available for compatibility, but the supported lifecycle entrypoint is `omegon`. If a standalone pi package is already installed, omegon transparently takes ownership of the lifecycle boundary so startup, update, verification, and restart all stay inside Omegon control. To switch back to standalone pi at any time:
 
 ```bash

package/extensions/cleave/dispatcher.ts

@@ -1,13 +1,13 @@
 /**
  * cleave/dispatcher — Child process dispatch and monitoring.
  *
- * Spawns `pi` subprocesses for each child task, using the same
+ * Spawns Omegon-owned subprocesses for each child task, using the same
  * subagent pattern as pi's example extension. Each child runs in
  * its own git worktree with an isolated context.
  *
  * Supports two backends:
- * - "cloud": spawns a full `pi` process (uses cloud API)
- * - "local": spawns `pi` with --model pointing to a local Ollama model
+ * - "cloud": spawns a full Omegon child process (uses cloud API)
+ * - "local": spawns Omegon with --model pointing to a local Ollama model
  *
  * The dispatcher handles:
  * - Dependency-ordered wave execution
@@ -26,6 +26,7 @@ import { computeDispatchWaves } from "./planner.ts";
 import { executeWithReview, type ReviewConfig, type ReviewExecutor, DEFAULT_REVIEW_CONFIG } from "./review.ts";
 import { saveState } from "./workspace.ts";
 import { resolveTier, getDefaultPolicy, getViableModels, type ProviderRoutingPolicy, type RegistryModel } from "../lib/model-routing.ts";
+import { resolveOmegonSubprocess } from "../lib/omegon-subprocess.ts";
 
 // ─── Large-run threshold ────────────────────────────────────────────────────
 
@@ -370,7 +371,8 @@ async function spawnChild(
 	localModel?: string,
 	onLine?: (line: string) => void,
 ): Promise<ChildResult> {
-	const args = ["-p", "--no-session"];
+	const omegon = resolveOmegonSubprocess();
+	const args = [...omegon.argvPrefix, "-p", "--no-session"];
 	if (localModel) {
 		args.push("--model", localModel);
 	}
@@ -380,7 +382,7 @@ async function spawnChild(
 		let stderr = "";
 		let killed = false;
 
-		const proc = spawn("pi", args, {
+		const proc = spawn(omegon.command, args, {
 			cwd,
 			stdio: ["pipe", "pipe", "pipe"],
 			env: {

package/extensions/cleave/index.ts

@@ -20,6 +20,8 @@ import { truncateTail, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize } from "
 import { Text } from "@styrene-lab/pi-tui";
 import { Type } from "@sinclair/typebox";
 import { spawn, execFile } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
 import { promisify } from "node:util";
 import { createHash } from "node:crypto";
 
@@ -29,12 +31,12 @@ import { debug } from "../lib/debug.ts";
 import { emitOpenSpecState } from "../openspec/dashboard-state.ts";
 import { getSharedBridge, buildSlashCommandResult } from "../lib/slash-command-bridge.ts";
 import { buildAssessBridgeResult } from "./bridge.ts";
+import { resolveOmegonSubprocess } from "../lib/omegon-subprocess.ts";
+import { scanDesignDocs, getNodeSections } from "../design-tree/tree.ts";
 import {
 	assessDirective,
 	PATTERNS,
 	runDesignStructuralCheck,
-	buildDesignAssessmentPrompt,
-	parseDesignAssessmentFindings,
 	type AssessCompletion,
 	type AssessEffect,
 	type AssessLifecycleHint,
@@ -755,11 +757,12 @@ async function runSpecAssessmentSubprocess(
 		...(input.diffContent ? ["### Recent Changes", "", "```diff", input.diffContent, "```", ""] : []),
 	].join("\n");
 
-	const args = ["--mode", "json", "--plan", "-p", "--no-session"];
+	const omegon = resolveOmegonSubprocess();
+	const args = [...omegon.argvPrefix, "--mode", "json", "--plan", "-p", "--no-session"];
 	if (input.modelId) args.push("--model", input.modelId);
 
 	return await new Promise<SpecAssessmentRunnerOutput>((resolve, reject) => {
-		const proc = spawn("pi", args, {
+		const proc = spawn(omegon.command, args, {
 			cwd: input.repoPath,
 			shell: false,
 			stdio: ["pipe", "pipe", "pipe"],
@@ -1420,118 +1423,6 @@ async function executeAssessComplexity(args: string): Promise<AssessStructuredRe
 	});
 }
 
-async function runDesignAssessmentSubprocess(
-	repoPath: string,
-	nodeId: string,
-	modelId?: string,
-): Promise<{ findings: DesignAssessmentFinding[]; nodeTitle: string; structuralPass: boolean }> {
-	const prompt = [
-		"You are performing a read-only design-tree node assessment.",
-		"Operate in read-only plan mode. Never call edit, write, or any workspace-mutating command.",
-		"",
-		`## Task`,
-		"",
-		`1. Call design_tree with action='node', node_id='${nodeId}' to load the node.`,
-		"2. Run the structural pre-check:",
-		"   - open_questions must be empty — if not, emit a structural finding for each",
-		"   - decisions must have at least one entry — if not, emit a structural finding",
-		"   - acceptanceCriteria must have at least one scenario, falsifiability, or constraint — if not, emit a structural finding",
-		"3. If structural pre-check fails, output ONLY the JSON result below and stop.",
-		"4. Otherwise, evaluate each acceptance criterion against the document body:",
-		"   - For each Scenario (Given/When/Then): does the document body address the Then clause?",
-		"   - For each Falsifiability condition: is it addressed, ruled out, or acknowledged as a known risk?",
-		"   - For each Constraint: is it satisfied by the document content?",
-		"",
-		"## Output Format",
-		"",
-		"Output ONLY a single JSON object (no prose, no markdown, no code blocks):",
-		"{",
-		'  "nodeTitle": "<title from node>",',
-		'  "structuralPass": true|false,',
-		'  "findings": [',
-		'    {"type":"scenario"|"falsifiability"|"constraint"|"structural","index":N,"pass":true|false,"finding":"<reason>"}',
-		"  ]",
-		"}",
-	].join("\n");
-
-	const args = ["--mode", "json", "--plan", "-p", "--no-session"];
-	if (modelId) args.push("--model", modelId);
-
-	return await new Promise<{ findings: DesignAssessmentFinding[]; nodeTitle: string; structuralPass: boolean }>(
-		(resolve, reject) => {
-			const proc = spawn("pi", args, {
-				cwd: repoPath,
-				shell: false,
-				stdio: ["pipe", "pipe", "pipe"],
-				env: { ...process.env, PI_CHILD: "1", TERM: process.env.TERM ?? "dumb" },
-			});
-			let buffer = "";
-			let assistantText = "";
-			let settled = false;
-			const settleReject = (error: Error) => {
-				if (settled) return;
-				settled = true;
-				clearTimeout(timer);
-				reject(error);
-			};
-			const settleResolve = (value: { findings: DesignAssessmentFinding[]; nodeTitle: string; structuralPass: boolean }) => {
-				if (settled) return;
-				settled = true;
-				clearTimeout(timer);
-				resolve(value);
-			};
-			const timer = setTimeout(() => {
-				proc.kill("SIGTERM");
-				setTimeout(() => { if (!proc.killed) proc.kill("SIGKILL"); }, 5_000);
-				settleReject(new Error(`Timed out after 120s while assessing design node ${nodeId}.`));
-			}, 120_000);
-			const processLine = (line: string) => {
-				if (!line.trim()) return;
-				let event: unknown;
-				try { event = JSON.parse(line); } catch { return; }
-				if (!event || typeof event !== "object") return;
-				const typed = event as { type?: string; message?: { role?: string; content?: unknown } };
-				if (typed.type === "message_end" && typed.message?.role === "assistant") {
-					assistantText = extractAssistantText(typed.message.content);
-				}
-			};
-			proc.stdout.on("data", (data) => {
-				buffer += (data as Buffer).toString();
-				const lines = buffer.split("\n");
-				buffer = lines.pop() || "";
-				for (const line of lines) processLine(line);
-			});
-			let stderr = "";
-			proc.stderr.on("data", (data) => { stderr += (data as Buffer).toString(); });
-			proc.on("error", (error) => settleReject(error));
-			proc.on("close", (code) => {
-				if (buffer.trim()) processLine(buffer.trim());
-				if ((code ?? 1) !== 0) {
-					settleReject(new Error(stderr.trim() || `Design assessment subprocess exited with code ${code ?? 1}.`));
-					return;
-				}
-				const jsonText = extractJsonObject(assistantText || buffer);
-				if (!jsonText) {
-					settleReject(new Error(`Design assessment subprocess did not return parseable JSON.\n${stderr}`));
-					return;
-				}
-				try {
-					const parsed = JSON.parse(jsonText) as { nodeTitle?: string; structuralPass?: boolean; findings?: DesignAssessmentFinding[] };
-					settleResolve({
-						nodeTitle: parsed.nodeTitle ?? nodeId,
-						structuralPass: parsed.structuralPass ?? true,
-						findings: Array.isArray(parsed.findings) ? parsed.findings : [],
-					});
-				} catch (err) {
-					settleReject(new Error(`Design assessment JSON was invalid: ${String(err)}`));
-				}
-			});
-			proc.stdin.write(prompt + "\n");
-			proc.stdin.end();
-		},
-	);
-}
-
 async function executeAssessDesign(
 	pi: ExtensionAPI,
 	ctx: AssessExecutionContext,
@@ -1601,23 +1492,69 @@ async function executeAssessDesign(
 	}
 
 	// Bridged / subprocess mode
-	let subResult: { findings: DesignAssessmentFinding[]; nodeTitle: string; structuralPass: boolean };
-	try {
-		subResult = await runDesignAssessmentSubprocess(cwd, nodeId, ctx.model?.id);
-	} catch (err) {
-		const msg = `Design assessment subprocess failed: ${String(err)}`;
+	// Prefer an in-process deterministic fallback so design assessment does not depend
+	// on a nested Omegon subprocess successfully loading a second extension graph.
+	const tree = scanDesignDocs(path.join(cwd, "docs"));
+	const node = tree.nodes.get(nodeId);
+	if (!node) {
+		const msg = `Design node '${nodeId}' not found under docs/.`;
 		return makeAssessResult({
 			subcommand: "design",
 			args,
 			ok: false,
 			summary: msg,
 			humanText: msg,
-			data: { reason: "subprocess_failed", nodeId },
+			data: { reason: "node_not_found", nodeId },
 			effects: [{ type: "view", content: msg }],
 		});
 	}
-
-	const { findings, nodeTitle, structuralPass } = subResult;
+	const sections = getNodeSections(node);
+	const structuralFindings = runDesignStructuralCheck(nodeId, sections);
+	const structuralPass = structuralFindings.length === 0;
+	const documentBody = fs.readFileSync(node.filePath, "utf-8").toLowerCase();
+	const normalizeCriterion = (value: string) => value.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+	const includesCriterion = (value: string) => {
+		const normalized = normalizeCriterion(value);
+		if (!normalized) return true;
+		return documentBody.includes(normalized) || normalized.split(/\s+/).filter(Boolean).every((part) => part.length < 4 || documentBody.includes(part));
+	};
+	const findings: DesignAssessmentFinding[] = [...structuralFindings];
+	if (structuralPass) {
+		sections.acceptanceCriteria.scenarios.forEach((scenario, index) => {
+			const pass = includesCriterion(scenario.then);
+			findings.push({
+				type: "scenario",
+				index,
+				pass,
+				finding: pass
+					? `Document addresses the scenario outcome: ${scenario.then}`
+					: `Document does not clearly address the scenario outcome: ${scenario.then}`,
+			});
+		});
+		sections.acceptanceCriteria.falsifiability.forEach((item, index) => {
+			const pass = includesCriterion(item.condition);
+			findings.push({
+				type: "falsifiability",
+				index,
+				pass,
+				finding: pass
+					? `Document addresses the falsifiability condition: ${item.condition}`
+					: `Document does not clearly address the falsifiability condition: ${item.condition}`,
+			});
+		});
+		sections.acceptanceCriteria.constraints.forEach((item, index) => {
+			const pass = includesCriterion(item.text);
+			findings.push({
+				type: "constraint",
+				index,
+				pass,
+				finding: pass
+					? `Document addresses the constraint: ${item.text}`
+					: `Document does not clearly address the constraint: ${item.text}`,
+			});
+		});
+	}
+	const nodeTitle = node.title;
 	const overallPass = structuralPass && findings.length > 0 && findings.every((f) => f.pass);
 
 	const result: DesignAssessmentResult = { nodeId, pass: overallPass, structuralPass, findings };

package/extensions/cleave/workspace.ts

@@ -598,7 +598,10 @@ export interface DirtyTreeClassificationOptions {
 	volatileAllowlist?: string[];
 }
 
-export const DEFAULT_VOLATILE_ALLOWLIST = [".pi/memory/facts.jsonl"];
+export const DEFAULT_VOLATILE_ALLOWLIST = [
+	".pi/memory/facts.jsonl",
+	".pi/runtime/operator-profile.json",
+];
 
 /**
  * Classify dirty-tree paths for preflight UX.

package/extensions/lib/omegon-subprocess.ts

@@ -0,0 +1,29 @@
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+export interface OmegonSubprocessSpec {
+  command: string;
+  argvPrefix: string[];
+  omegonEntry: string;
+}
+
+let cached: OmegonSubprocessSpec | null = null;
+
+/**
+ * Resolve the canonical Omegon-owned subprocess entrypoint without relying on PATH.
+ *
+ * Internal helpers should spawn `process.execPath` with `bin/omegon.mjs` explicitly,
+ * rather than assuming a `pi` or `omegon` binary on PATH points back to this install.
+ */
+export function resolveOmegonSubprocess(): OmegonSubprocessSpec {
+  if (cached) return cached;
+
+  const here = dirname(fileURLToPath(import.meta.url));
+  const omegonEntry = join(here, "..", "..", "bin", "omegon.mjs");
+  cached = {
+    command: process.execPath,
+    argvPrefix: [omegonEntry],
+    omegonEntry,
+  };
+  return cached;
+}

package/extensions/lib/slash-command-bridge.ts

@@ -80,9 +80,9 @@ const EXECUTE_PARAMS = Type.Object({
 export type SlashCommandBridgeExecuteParams = Static<typeof EXECUTE_PARAMS>;
 
 function toArgString(args: readonly string[] | undefined): string {
-  // Join args with spaces — executors split on whitespace to extract subcommand and rest.
-  // Individual args containing spaces are unsupported (none currently need them).
-  return (args ?? []).join(" ");
+  // Preserve token boundaries for bridged execution (including args containing spaces).
+  // Structured executors in bridge mode can parse this JSON payload deterministically.
+  return JSON.stringify([...(args ?? [])]);
 }
 
 function summarize(command: string, args: readonly string[] | undefined): string {

package/extensions/project-memory/extraction-v2.ts

@@ -15,6 +15,7 @@
 import { spawn, type ChildProcess } from "node:child_process";
 import type { MemoryConfig } from "./types.ts";
 import type { Fact, Edge } from "./factstore.ts";
+import { resolveOmegonSubprocess } from "../lib/omegon-subprocess.ts";
 
 // ---------------------------------------------------------------------------
 // Shared subprocess runner
@@ -95,7 +96,9 @@ function spawnExtraction(opts: {
       return;
     }
 
+    const omegon = resolveOmegonSubprocess();
     const args = [
+      ...omegon.argvPrefix,
       "--model", opts.model,
       "--no-session", "--no-tools", "--no-extensions",
       "--no-skills", "--no-themes", "--thinking", "off",
@@ -103,7 +106,7 @@ function spawnExtraction(opts: {
       "-p", opts.userMessage,
     ];
 
-    const proc = spawn("pi", args, {
+    const proc = spawn(omegon.command, args, {
       cwd: opts.cwd,
       stdio: ["ignore", "pipe", "pipe"],
       // Detach into new session so child has no controlling terminal.

package/extensions/project-memory/factstore.ts

@@ -91,6 +91,30 @@ function loadDatabase(): any {
 
 const Database = loadDatabase();
 
+function buildSafeFtsQuery(query: string, joiner: "AND" | "OR" = "AND"): string {
+  const tokens = query
+    .split(/\s+/)
+    .map(token => token.trim())
+    .filter(token => token.length > 0)
+    .map(token => token.replace(/"/g, '""'))
+    .filter(token => /[\p{L}\p{N}]/u.test(token))
+    .map(token => `"${token}"`);
+
+  return tokens.join(` ${joiner} `);
+}
+
+function isIgnorableFtsQueryError(error: unknown): boolean {
+  if (!(error instanceof Error)) return false;
+  const message = error.message.toLowerCase();
+  return (
+    message.includes("fts5")
+    || message.includes("malformed match expression")
+    || message.includes("syntax error")
+    || message.includes("unterminated string")
+    || message.includes("no such column")
+  );
+}
+
 /** Generate a short unique ID */
 function nanoid(size = 12): string {
   const bytes = crypto.randomBytes(size);
@@ -234,6 +258,7 @@ export class FactStore {
     fs.mkdirSync(memoryDir, { recursive: true });
     this.db = new Database(this.dbPath);
     this.db.pragma("journal_mode = WAL");
+    this.db.pragma("busy_timeout = 5000");
     this.db.pragma("foreign_keys = ON");
     this.initSchema();
     this.runMigrations();
@@ -1027,47 +1052,56 @@ export class FactStore {
 
   /** Full-text search across all facts (all minds, all statuses) */
   searchFacts(query: string, mind?: string): Fact[] {
-    // FTS5 match syntax
-    const ftsQuery = query.split(/\s+/).filter(t => t.length > 0).join(" AND ");
+    const ftsQuery = buildSafeFtsQuery(query, "AND");
     if (!ftsQuery) return [];
 
-    if (mind) {
+    try {
+      if (mind) {
+        return this.db.prepare(`
+          SELECT f.* FROM facts f
+          JOIN facts_fts fts ON f.rowid = fts.rowid
+          WHERE facts_fts MATCH ? AND f.mind = ?
+          ORDER BY rank
+        `).all(ftsQuery, mind) as Fact[];
+      }
+
       return this.db.prepare(`
         SELECT f.* FROM facts f
         JOIN facts_fts fts ON f.rowid = fts.rowid
-        WHERE facts_fts MATCH ? AND f.mind = ?
+        WHERE facts_fts MATCH ?
         ORDER BY rank
-      `).all(ftsQuery, mind) as Fact[];
+      `).all(ftsQuery) as Fact[];
+    } catch (error) {
+      if (isIgnorableFtsQueryError(error)) return [];
+      throw error;
     }
-
-    return this.db.prepare(`
-      SELECT f.* FROM facts f
-      JOIN facts_fts fts ON f.rowid = fts.rowid
-      WHERE facts_fts MATCH ?
-      ORDER BY rank
-    `).all(ftsQuery) as Fact[];
   }
 
   /** Search archived/superseded facts (replaces searchArchive) */
   searchArchive(query: string, mind?: string): Fact[] {
-    const ftsQuery = query.split(/\s+/).filter(t => t.length > 0).join(" AND ");
+    const ftsQuery = buildSafeFtsQuery(query, "AND");
     if (!ftsQuery) return [];
 
-    if (mind) {
+    try {
+      if (mind) {
+        return this.db.prepare(`
+          SELECT f.* FROM facts f
+          JOIN facts_fts fts ON f.rowid = fts.rowid
+          WHERE facts_fts MATCH ? AND f.mind = ? AND f.status IN ('archived', 'superseded')
+          ORDER BY f.created_at DESC
+        `).all(ftsQuery, mind) as Fact[];
+      }
+
       return this.db.prepare(`
         SELECT f.* FROM facts f
         JOIN facts_fts fts ON f.rowid = fts.rowid
-        WHERE facts_fts MATCH ? AND f.mind = ? AND f.status IN ('archived', 'superseded')
+        WHERE facts_fts MATCH ? AND f.status IN ('archived', 'superseded')
         ORDER BY f.created_at DESC
-      `).all(ftsQuery, mind) as Fact[];
+      `).all(ftsQuery) as Fact[];
+    } catch (error) {
+      if (isIgnorableFtsQueryError(error)) return [];
+      throw error;
     }
-
-    return this.db.prepare(`
-      SELECT f.* FROM facts f
-      JOIN facts_fts fts ON f.rowid = fts.rowid
-      WHERE facts_fts MATCH ? AND f.status IN ('archived', 'superseded')
-      ORDER BY f.created_at DESC
-    `).all(ftsQuery) as Fact[];
   }
 
   /** Get a single fact by ID */
@@ -1850,9 +1884,8 @@ export class FactStore {
     const ftsRanked: Map<string, number> = new Map(); // fact.id → rank (0-indexed)
     if (queryText.length > 2) {
       // Use OR mode for broader recall — AND is too restrictive for injection
-      const tokens = queryText.split(/\s+/).filter(t => t.length > 1);
-      if (tokens.length > 0) {
-        const ftsQuery = tokens.join(" OR ");
+      const ftsQuery = buildSafeFtsQuery(queryText, "OR");
+      if (ftsQuery) {
         try {
           let query = `
             SELECT f.* FROM facts f

package/extensions/project-memory/index.ts

@@ -55,6 +55,7 @@ import { DEFAULT_CONFIG, type MemoryConfig, type LifecycleMemoryCandidate } from
 import { sanitizeCompactionText, shouldInterceptCompaction } from "./compaction-policy.ts";
 import { writeJsonlIfChanged } from "./jsonl-io.ts";
 import {
+  computeMemoryBudgetPolicy,
   createMemoryInjectionMetrics,
   estimateTokensFromChars,
   formatMemoryInjectionMetrics,
@@ -1501,17 +1502,13 @@ export default function (pi: ExtensionAPI) {
     const usage = ctx.getContextUsage();
 
     // Budget: reserve space for other context (design-tree, system prompt, etc.)
-    // Use 15% of total context as memory budget, with a floor and ceiling.
-    // Estimate total tokens from current usage: tokens / (percent/100).
-    const usedTokens = usage?.tokens ?? 0;
-    const usedPercent = usage?.percent ?? 0;
-    const estimatedTotalTokens = usedPercent > 0
-      ? Math.round(usedTokens / (usedPercent / 100))
-      : 200_000; // safe default
-    const MAX_MEMORY_CHARS = Math.min(
-      Math.max(Math.round(estimatedTotalTokens * 0.15 * 4), 4_000),  // 15% of context, min 4K chars
-      16_000,  // absolute ceiling
-    );
+    // Routine turns should carry a much smaller memory payload by default.
+    const budgetPolicy = computeMemoryBudgetPolicy({
+      usedTokens: usage?.tokens,
+      usedPercent: usage?.percent,
+      userText,
+    });
+    const MAX_MEMORY_CHARS = budgetPolicy.maxChars;
 
     const allFacts = store.getActiveFacts(mind);
     const injectedIds = new Set<string>();
@@ -1578,22 +1575,24 @@ export default function (pi: ExtensionAPI) {
     // Ensures every section has representation even without a matching query.
     // This is what bulk mode got right that old semantic mode missed.
     const FILL_SECTIONS = ["Constraints", "Known Issues", "Patterns & Conventions", "Specs", "Recent Work"] as const;
-    for (const section of FILL_SECTIONS) {
-      if (currentChars >= MAX_MEMORY_CHARS) break;
-      const sectionFacts = allFacts
-        .filter(f => f.section === section)
-        .sort((a, b) => b.confidence - a.confidence)
-        .slice(0, 3);
-      for (const f of sectionFacts) {
-        if (!tryAdd(f)) break;
+    if (budgetPolicy.includeStructuralFill) {
+      for (const section of FILL_SECTIONS) {
+        if (currentChars >= MAX_MEMORY_CHARS) break;
+        const sectionFacts = allFacts
+          .filter(f => f.section === section)
+          .sort((a, b) => b.confidence - a.confidence)
+          .slice(0, 2);
+        for (const f of sectionFacts) {
+          if (!tryAdd(f)) break;
+        }
       }
     }
 
     // --- Tier 6: Recency fill — most recently reinforced not yet included ---
-    if (currentChars < MAX_MEMORY_CHARS) {
+    if (budgetPolicy.includeStructuralFill && currentChars < MAX_MEMORY_CHARS) {
       const recentFacts = [...allFacts]
         .sort((a, b) => new Date(b.last_reinforced).getTime() - new Date(a.last_reinforced).getTime())
-        .slice(0, 20);
+        .slice(0, 12);
       for (const f of recentFacts) {
         if (!tryAdd(f)) break;
       }
@@ -1605,7 +1604,7 @@ export default function (pi: ExtensionAPI) {
     // --- Global knowledge: semantic-gated, only when query is available ---
     let globalSection = "";
     let injectedGlobalFactCount = 0;
-    if (globalStore && userText.length > 10) {
+    if (budgetPolicy.includeGlobalFacts && globalStore && userText.length > 10) {
       const globalMind = globalStore.getActiveMind() ?? "default";
       const globalFactCount = globalStore.countActiveFacts(globalMind);
       if (globalFactCount > 0) {
@@ -1633,7 +1632,7 @@ export default function (pi: ExtensionAPI) {
     let episodeSection = "";
     let injectedEpisodeCount = 0;
     const episodeCount = store.countEpisodes(mind);
-    if (episodeCount > 0) {
+    if (budgetPolicy.includeEpisode && episodeCount > 0) {
       const recentEpisodes = store.getEpisodes(mind, 1);
       if (recentEpisodes.length > 0) {
         injectedEpisodeCount = recentEpisodes.length;

package/extensions/project-memory/injection-metrics.ts

@@ -17,6 +17,38 @@ export interface MemoryInjectionMetrics {
   estimatedVsObservedDelta?: number | null;
 }
 
+export interface MemoryBudgetPolicy {
+  maxChars: number;
+  includeStructuralFill: boolean;
+  includeGlobalFacts: boolean;
+  includeEpisode: boolean;
+}
+
+export function computeMemoryBudgetPolicy(input: {
+  usedTokens?: number | null;
+  usedPercent?: number | null;
+  userText?: string;
+}): MemoryBudgetPolicy {
+  const usedTokens = input.usedTokens ?? 0;
+  const usedPercent = input.usedPercent ?? 0;
+  const userText = input.userText ?? "";
+  const estimatedTotalTokens = usedPercent > 0
+    ? Math.round(usedTokens / (usedPercent / 100))
+    : 200_000;
+  const maxChars = Math.min(
+    Math.max(Math.round(estimatedTotalTokens * 0.08 * 4), 2_000),
+    8_000,
+  );
+  const trimmed = userText.trim();
+  const signalLength = trimmed.length;
+  const signalWords = trimmed.split(/\s+/).filter(Boolean).length;
+  const includeStructuralFill = signalLength >= 24 || signalWords >= 5;
+  const includeGlobalFacts = signalLength >= 48 || signalWords >= 8;
+  const includeEpisode = signalLength >= 64 || signalWords >= 10;
+
+  return { maxChars, includeStructuralFill, includeGlobalFacts, includeEpisode };
+}
+
 export function estimateTokensFromChars(content: string): number {
   return Math.round(content.length / 4);
 }

package/extensions/render/composition/package-lock.json

@@ -0,0 +1,534 @@
+{
+  "name": "@omegon/composition",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@omegon/composition",
+      "version": "0.1.0",
+      "dependencies": {
+        "@resvg/resvg-js": "^2.6.2",
+        "gifenc": "^1.0.3",
+        "jiti": "^2.4.2",
+        "react": "^18.3.1",
+        "react-dom": "^18.3.1",
+        "satori": "^0.11.2"
+      },
+      "devDependencies": {
+        "@types/react": "^18.3.12",
+        "@types/react-dom": "^18.3.1"
+      }
+    },
+    "node_modules/@resvg/resvg-js": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js/-/resvg-js-2.6.2.tgz",
+      "integrity": "sha512-xBaJish5OeGmniDj9cW5PRa/PtmuVU3ziqrbr5xJj901ZDN4TosrVaNZpEiLZAxdfnhAe7uQ7QFWfjPe9d9K2Q==",
+      "license": "MPL-2.0",
+      "engines": {
+        "node": ">= 10"
+      },
+      "optionalDependencies": {
+        "@resvg/resvg-js-android-arm-eabi": "2.6.2",
+        "@resvg/resvg-js-android-arm64": "2.6.2",
+        "@resvg/resvg-js-darwin-arm64": "2.6.2",
+        "@resvg/resvg-js-darwin-x64": "2.6.2",
+        "@resvg/resvg-js-linux-arm-gnueabihf": "2.6.2",
+        "@resvg/resvg-js-linux-arm64-gnu": "2.6.2",
+        "@resvg/resvg-js-linux-arm64-musl": "2.6.2",
+        "@resvg/resvg-js-linux-x64-gnu": "2.6.2",
+        "@resvg/resvg-js-linux-x64-musl": "2.6.2",
+        "@resvg/resvg-js-win32-arm64-msvc": "2.6.2",
+        "@resvg/resvg-js-win32-ia32-msvc": "2.6.2",
+        "@resvg/resvg-js-win32-x64-msvc": "2.6.2"
+      }
+    },
+    "node_modules/@resvg/resvg-js-android-arm-eabi": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-android-arm-eabi/-/resvg-js-android-arm-eabi-2.6.2.tgz",
+      "integrity": "sha512-FrJibrAk6v29eabIPgcTUMPXiEz8ssrAk7TXxsiZzww9UTQ1Z5KAbFJs+Z0Ez+VZTYgnE5IQJqBcoSiMebtPHA==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-android-arm64": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-android-arm64/-/resvg-js-android-arm64-2.6.2.tgz",
+      "integrity": "sha512-VcOKezEhm2VqzXpcIJoITuvUS/fcjIw5NA/w3tjzWyzmvoCdd+QXIqy3FBGulWdClvp4g+IfUemigrkLThSjAQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-darwin-arm64": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-darwin-arm64/-/resvg-js-darwin-arm64-2.6.2.tgz",
+      "integrity": "sha512-nmok2LnAd6nLUKI16aEB9ydMC6Lidiiq2m1nEBDR1LaaP7FGs4AJ90qDraxX+CWlVuRlvNjyYJTNv8qFjtL9+A==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-darwin-x64": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-darwin-x64/-/resvg-js-darwin-x64-2.6.2.tgz",
+      "integrity": "sha512-GInyZLjgWDfsVT6+SHxQVRwNzV0AuA1uqGsOAW+0th56J7Nh6bHHKXHBWzUrihxMetcFDmQMAX1tZ1fZDYSRsw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-linux-arm-gnueabihf": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-linux-arm-gnueabihf/-/resvg-js-linux-arm-gnueabihf-2.6.2.tgz",
+      "integrity": "sha512-YIV3u/R9zJbpqTTNwTZM5/ocWetDKGsro0SWp70eGEM9eV2MerWyBRZnQIgzU3YBnSBQ1RcxRZvY/UxwESfZIw==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-linux-arm64-gnu": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-linux-arm64-gnu/-/resvg-js-linux-arm64-gnu-2.6.2.tgz",
+      "integrity": "sha512-zc2BlJSim7YR4FZDQ8OUoJg5holYzdiYMeobb9pJuGDidGL9KZUv7SbiD4E8oZogtYY42UZEap7dqkkYuA91pg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-linux-arm64-musl": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-linux-arm64-musl/-/resvg-js-linux-arm64-musl-2.6.2.tgz",
+      "integrity": "sha512-3h3dLPWNgSsD4lQBJPb4f+kvdOSJHa5PjTYVsWHxLUzH4IFTJUAnmuWpw4KqyQ3NA5QCyhw4TWgxk3jRkQxEKg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-linux-x64-gnu": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-linux-x64-gnu/-/resvg-js-linux-x64-gnu-2.6.2.tgz",
+      "integrity": "sha512-IVUe+ckIerA7xMZ50duAZzwf1U7khQe2E0QpUxu5MBJNao5RqC0zwV/Zm965vw6D3gGFUl7j4m+oJjubBVoftw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-linux-x64-musl": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-linux-x64-musl/-/resvg-js-linux-x64-musl-2.6.2.tgz",
+      "integrity": "sha512-UOf83vqTzoYQO9SZ0fPl2ZIFtNIz/Rr/y+7X8XRX1ZnBYsQ/tTb+cj9TE+KHOdmlTFBxhYzVkP2lRByCzqi4jQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-win32-arm64-msvc": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-win32-arm64-msvc/-/resvg-js-win32-arm64-msvc-2.6.2.tgz",
+      "integrity": "sha512-7C/RSgCa+7vqZ7qAbItfiaAWhyRSoD4l4BQAbVDqRRsRgY+S+hgS3in0Rxr7IorKUpGE69X48q6/nOAuTJQxeQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-win32-ia32-msvc": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-win32-ia32-msvc/-/resvg-js-win32-ia32-msvc-2.6.2.tgz",
+      "integrity": "sha512-har4aPAlvjnLcil40AC77YDIk6loMawuJwFINEM7n0pZviwMkMvjb2W5ZirsNOZY4aDbo5tLx0wNMREp5Brk+w==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@resvg/resvg-js-win32-x64-msvc": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/@resvg/resvg-js-win32-x64-msvc/-/resvg-js-win32-x64-msvc-2.6.2.tgz",
+      "integrity": "sha512-ZXtYhtUr5SSaBrUDq7DiyjOFJqBVL/dOBN7N/qmi/pO0IgiWW/f/ue3nbvu9joWE5aAKDoIzy/CxsY0suwGosQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MPL-2.0",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@shuding/opentype.js": {
+      "version": "1.4.0-beta.0",
+      "resolved": "https://registry.npmjs.org/@shuding/opentype.js/-/opentype.js-1.4.0-beta.0.tgz",
+      "integrity": "sha512-3NgmNyH3l/Hv6EvsWJbsvpcpUba6R8IREQ83nH83cyakCw7uM1arZKNfHwv1Wz6jgqrF/j4x5ELvR6PnK9nTcA==",
+      "license": "MIT",
+      "dependencies": {
+        "fflate": "^0.7.3",
+        "string.prototype.codepointat": "^0.2.1"
+      },
+      "bin": {
+        "ot": "bin/ot"
+      },
+      "engines": {
+        "node": ">= 8.0.0"
+      }
+    },
+    "node_modules/@types/prop-types": {
+      "version": "15.7.15",
+      "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz",
+      "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/react": {
+      "version": "18.3.28",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.28.tgz",
+      "integrity": "sha512-z9VXpC7MWrhfWipitjNdgCauoMLRdIILQsAEV+ZesIzBq/oUlxk0m3ApZuMFCXdnS4U7KrI+l3WRUEGQ8K1QKw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/prop-types": "*",
+        "csstype": "^3.2.2"
+      }
+    },
+    "node_modules/@types/react-dom": {
+      "version": "18.3.7",
+      "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-18.3.7.tgz",
+      "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "@types/react": "^18.0.0"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "0.0.8",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-0.0.8.tgz",
+      "integrity": "sha512-3XSA2cR/h/73EzlXXdU6YNycmYI7+kicTxks4eJg2g39biHR84slg2+des+p7iHYhbRg/udIS4TD53WabcOUkw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/camelize": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/camelize/-/camelize-1.0.1.tgz",
+      "integrity": "sha512-dU+Tx2fsypxTgtLoE36npi3UqcjSSMNYfkqgmoEhtZrraP5VWq0K7FkWVTYa8eMPtnU/G2txVsfdCJTn9uzpuQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "license": "MIT"
+    },
+    "node_modules/css-background-parser": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/css-background-parser/-/css-background-parser-0.1.0.tgz",
+      "integrity": "sha512-2EZLisiZQ+7m4wwur/qiYJRniHX4K5Tc9w93MT3AS0WS1u5kaZ4FKXlOTBhOjc+CgEgPiGY+fX1yWD8UwpEqUA==",
+      "license": "MIT"
+    },
+    "node_modules/css-box-shadow": {
+      "version": "1.0.0-3",
+      "resolved": "https://registry.npmjs.org/css-box-shadow/-/css-box-shadow-1.0.0-3.tgz",
+      "integrity": "sha512-9jaqR6e7Ohds+aWwmhe6wILJ99xYQbfmK9QQB9CcMjDbTxPZjwEmUQpU91OG05Xgm8BahT5fW+svbsQGjS/zPg==",
+      "license": "MIT"
+    },
+    "node_modules/css-color-keywords": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/css-color-keywords/-/css-color-keywords-1.0.0.tgz",
+      "integrity": "sha512-FyyrDHZKEjXDpNJYvVsV960FiqQyXc/LlYmsxl2BcdMb2WPx0OGRVgTg55rPSyLSNMqP52R9r8geSp7apN3Ofg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/css-gradient-parser": {
+      "version": "0.0.16",
+      "resolved": "https://registry.npmjs.org/css-gradient-parser/-/css-gradient-parser-0.0.16.tgz",
+      "integrity": "sha512-3O5QdqgFRUbXvK1x5INf1YkBz1UKSWqrd63vWsum8MNHDBYD5urm3QtxZbKU259OrEXNM26lP/MPY3d1IGkBgA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/css-to-react-native": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/css-to-react-native/-/css-to-react-native-3.2.0.tgz",
+      "integrity": "sha512-e8RKaLXMOFii+02mOlqwjbD00KSEKqblnpO9e++1aXS1fPQOpS1YoqdVHBqPjHNoxeF2mimzVqawm2KCbEdtHQ==",
+      "license": "MIT",
+      "dependencies": {
+        "camelize": "^1.0.0",
+        "css-color-keywords": "^1.0.0",
+        "postcss-value-parser": "^4.0.2"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/emoji-regex": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
+      "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",
+      "license": "MIT"
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/fflate": {
+      "version": "0.7.4",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.7.4.tgz",
+      "integrity": "sha512-5u2V/CDW15QM1XbbgS+0DfPxVB+jUKhWEKuuFuHncbk3tEEqzmoXL+2KyOFuKGqOnmdIy0/davWF1CkuwtibCw==",
+      "license": "MIT"
+    },
+    "node_modules/gifenc": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/gifenc/-/gifenc-1.0.3.tgz",
+      "integrity": "sha512-xdr6AdrfGBcfzncONUOlXMBuc5wJDtOueE3c5rdG0oNgtINLD+f2iFZltrBRZYzACRbKr+mSVU/x98zv2u3jmw==",
+      "license": "MIT"
+    },
+    "node_modules/hex-rgb": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/hex-rgb/-/hex-rgb-4.3.0.tgz",
+      "integrity": "sha512-Ox1pJVrDCyGHMG9CFg1tmrRUMRPRsAWYc/PinY0XzJU4K7y7vjNoLKIQ7BR5UJMCxNN8EM1MNDmHWA/B3aZUuw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/jiti": {
+      "version": "2.6.1",
+      "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.1.tgz",
+      "integrity": "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==",
+      "license": "MIT",
+      "bin": {
+        "jiti": "lib/jiti-cli.mjs"
+      }
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+      "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+      "license": "MIT"
+    },
+    "node_modules/linebreak": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/linebreak/-/linebreak-1.1.0.tgz",
+      "integrity": "sha512-MHp03UImeVhB7XZtjd0E4n6+3xr5Dq/9xI/5FptGk5FrbDR3zagPa2DS6U8ks/3HjbKWG9Q1M2ufOzxV2qLYSQ==",
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "0.0.8",
+        "unicode-trie": "^2.0.0"
+      }
+    },
+    "node_modules/loose-envify": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",
+      "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==",
+      "license": "MIT",
+      "dependencies": {
+        "js-tokens": "^3.0.0 || ^4.0.0"
+      },
+      "bin": {
+        "loose-envify": "cli.js"
+      }
+    },
+    "node_modules/pako": {
+      "version": "0.2.9",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-0.2.9.tgz",
+      "integrity": "sha512-NUcwaKxUxWrZLpDG+z/xZaCgQITkA/Dv4V/T6bw7VON6l1Xz/VnrBqrYjZQ12TamKHzITTfOEIYUj48y2KXImA==",
+      "license": "MIT"
+    },
+    "node_modules/parse-css-color": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/parse-css-color/-/parse-css-color-0.2.1.tgz",
+      "integrity": "sha512-bwS/GGIFV3b6KS4uwpzCFj4w297Yl3uqnSgIPsoQkx7GMLROXfMnWvxfNkL0oh8HVhZA4hvJoEoEIqonfJ3BWg==",
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "^1.1.4",
+        "hex-rgb": "^4.1.0"
+      }
+    },
+    "node_modules/postcss-value-parser": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
+      "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
+      "license": "MIT"
+    },
+    "node_modules/react": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
+      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/react-dom": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
+      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0",
+        "scheduler": "^0.23.2"
+      },
+      "peerDependencies": {
+        "react": "^18.3.1"
+      }
+    },
+    "node_modules/satori": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/satori/-/satori-0.11.3.tgz",
+      "integrity": "sha512-Wg7sls0iYAEETzi9YYcY16QVIqXjZT06XjkwondC5CGhw1mhmgKBCub8cCmkxdl/naXXQD+m29CFgn8pwtYCnA==",
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@shuding/opentype.js": "1.4.0-beta.0",
+        "css-background-parser": "^0.1.0",
+        "css-box-shadow": "1.0.0-3",
+        "css-gradient-parser": "^0.0.16",
+        "css-to-react-native": "^3.0.0",
+        "emoji-regex": "^10.2.1",
+        "escape-html": "^1.0.3",
+        "linebreak": "^1.1.0",
+        "parse-css-color": "^0.2.1",
+        "postcss-value-parser": "^4.2.0",
+        "yoga-wasm-web": "^0.3.3"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/scheduler": {
+      "version": "0.23.2",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
+      "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
+      "license": "MIT",
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      }
+    },
+    "node_modules/string.prototype.codepointat": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/string.prototype.codepointat/-/string.prototype.codepointat-0.2.1.tgz",
+      "integrity": "sha512-2cBVCj6I4IOvEnjgO/hWqXjqBGsY+zwPmHl12Srk9IXSZ56Jwwmy+66XO5Iut/oQVR7t5ihYdLB0GMa4alEUcg==",
+      "license": "MIT"
+    },
+    "node_modules/tiny-inflate": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz",
+      "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==",
+      "license": "MIT"
+    },
+    "node_modules/unicode-trie": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/unicode-trie/-/unicode-trie-2.0.0.tgz",
+      "integrity": "sha512-x7bc76x0bm4prf1VLg79uhAzKw8DVboClSN5VxJuQ+LKDOVEW9CdH+VY7SP+vX7xCYQqzzgQpFqz15zeLvAtZQ==",
+      "license": "MIT",
+      "dependencies": {
+        "pako": "^0.2.5",
+        "tiny-inflate": "^1.0.0"
+      }
+    },
+    "node_modules/yoga-wasm-web": {
+      "version": "0.3.3",
+      "resolved": "https://registry.npmjs.org/yoga-wasm-web/-/yoga-wasm-web-0.3.3.tgz",
+      "integrity": "sha512-N+d4UJSJbt/R3wqY7Coqs5pcV0aUj2j9IaQ3rNj9bVCLld8tTGKRa2USARjnvZJWVx1NDmQev8EknoczaOQDOA==",
+      "license": "MIT"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "omegon",
-	"version": "0.6.5",
+	"version": "0.6.7",
 	"description": "Omegon — an opinionated distribution of pi (by Mario Zechner) with extensions for lifecycle management, memory, orchestration, and visualization",
 	"bin": {
 		"omegon": "bin/omegon.mjs",
@@ -32,6 +32,9 @@
 		"url": "https://github.com/styrene-lab/omegon/issues"
 	},
 	"homepage": "https://github.com/styrene-lab/omegon#readme",
+	"engines": {
+		"node": ">=20.0.0"
+	},
 	"pi": {
 		"extensions": [
 			"./extensions/bootstrap",
@@ -72,10 +75,10 @@
 		]
 	},
 	"dependencies": {
-		"@styrene-lab/pi-coding-agent": "0.58.1-cwilson613.1",
-		"@styrene-lab/pi-agent-core": "0.58.1",
-		"@styrene-lab/pi-ai": "0.58.1-cwilson613.1",
-		"@styrene-lab/pi-tui": "0.58.1-cwilson613.1",
+		"@styrene-lab/pi-coding-agent": "file:./vendor/pi-mono/packages/coding-agent",
+		"@styrene-lab/pi-agent-core": "file:./vendor/pi-mono/packages/agent",
+		"@styrene-lab/pi-ai": "file:./vendor/pi-mono/packages/ai",
+		"@styrene-lab/pi-tui": "file:./vendor/pi-mono/packages/tui",
 		"@modelcontextprotocol/sdk": "^1.12.1",
 		"@resvg/resvg-js": "^2.6.2",
 		"@sinclair/typebox": "^0.34.48",

package/scripts/preinstall.sh

@@ -17,6 +17,16 @@
 #
 # Only acts during global installs (npm_config_global=true).
 
+node_major="$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0)"
+if [ "$node_major" -lt 20 ]; then
+  echo ""
+  echo "  omegon: Unsupported Node.js runtime detected ($(node -v 2>/dev/null || echo unknown))."
+  echo "  omegon: Omegon requires Node.js 20 or later because bundled pi-tui uses modern Unicode regex features."
+  echo "  omegon: Upgrade Node.js to 20+ and retry the install/update."
+  echo ""
+  exit 1
+fi
+
 if [ "$npm_config_global" != "true" ]; then
   exit 0
 fi

package/settings.json

@@ -0,0 +1,7 @@
+{
+  "lastChangelogVersion": "0.58.1-cwilson613.1",
+  "theme": "alpharius",
+  "defaultProvider": "anthropic",
+  "defaultModel": "claude-opus-4-6",
+  "defaultThinkingLevel": "low"
+}