@kl-c/matrixos 0.1.13 → 0.1.15

package/dist/cli/index.js

@@ -2145,7 +2145,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.1.13",
+    version: "0.1.15",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -2220,6 +2220,7 @@ var init_package = __esm(() => {
       },
       "./server": "./dist/index.js",
       "./tui": "./dist/tui.js",
+      "./features": "./dist/features/matrix-inventory/features.js",
       "./schema.json": "./dist/matrixos.schema.json"
     },
     scripts: {
@@ -2231,6 +2232,7 @@ var init_package = __esm(() => {
       "build:lsp-daemon": "npm --prefix packages/lsp-daemon ci && npm --prefix packages/lsp-daemon run build",
       "build:node-require-shim": "bun run script/patch-node-require-shim.ts",
       "build:binaries": "bun run script/build-binaries.ts",
+      "build:features-inventory": "bun build packages/omo-opencode/src/features/matrix-inventory/features.ts --outdir dist/features/matrix-inventory --target bun --format esm --external zod",
       "build:schema": "bun run script/build-schema.ts",
       "build:model-capabilities": "bun run script/build-model-capabilities.ts",
       clean: "rm -rf dist",

package/dist/cli-node/index.js

@@ -2145,7 +2145,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.1.13",
+    version: "0.1.15",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -2220,6 +2220,7 @@ var init_package = __esm(() => {
       },
       "./server": "./dist/index.js",
       "./tui": "./dist/tui.js",
+      "./features": "./dist/features/matrix-inventory/features.js",
       "./schema.json": "./dist/matrixos.schema.json"
     },
     scripts: {
@@ -2231,6 +2232,7 @@ var init_package = __esm(() => {
       "build:lsp-daemon": "npm --prefix packages/lsp-daemon ci && npm --prefix packages/lsp-daemon run build",
       "build:node-require-shim": "bun run script/patch-node-require-shim.ts",
       "build:binaries": "bun run script/build-binaries.ts",
+      "build:features-inventory": "bun build packages/omo-opencode/src/features/matrix-inventory/features.ts --outdir dist/features/matrix-inventory --target bun --format esm --external zod",
       "build:schema": "bun run script/build-schema.ts",
       "build:model-capabilities": "bun run script/build-model-capabilities.ts",
       clean: "rm -rf dist",

package/dist/features/matrix-inventory/features.js

@@ -0,0 +1,207 @@
+// @bun
+// packages/omo-opencode/src/features/matrix-inventory/features.ts
+var MATRIX_FEATURES = [
+  {
+    id: "dashboard",
+    name: "Mission Control (Dashboard)",
+    description: "Web UI to supervise agents, sessions, tasks, cost and incidents in real time.",
+    enabledByDefault: false,
+    status: "cli-only",
+    userBenefit: "Open a browser page (default http://127.0.0.1:9123) showing live agent/session/task state, cost, kanban and incidents.",
+    provisioning: {
+      activation: "Launch the bundled server: `matrixos dashboard --daemon` (listens on 127.0.0.1:9123 by default). For remote access over Tailscale, rebind with `--host <tailscale-ip>` (e.g. 100.96.138.13).",
+      configPath: "matrixos.json \u2192 could expose a `dashboard` section (currently launched via CLI only)",
+      notes: "The backend serves an API + SSE. The frontend (vanilla HTML/JS/CSS) MUST be present in dist/features/dashboard/frontend \u2014 it is copied there by the build (node `dashboard-frontend`). If the frontend folder is empty after install, rebuild from source: `bun run build` then `matrixos dashboard --daemon`."
+    }
+  },
+  {
+    id: "kanban",
+    name: "Kanban",
+    description: "Lightweight task/backlog board with a state machine (backlog \u2192 in_progress \u2192 review \u2192 done \u2192 archived).",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Track work items with assignee and status transitions without leaving MaTrixOS.",
+    provisioning: {
+      activation: "Enable via config; the store is in-memory (MVP). Future: SQLite-backed durability.",
+      configPath: "matrixos.json \u2192 kanban.enabled",
+      notes: "UI is API-only for now (no dedicated panel in Mission Control yet)."
+    }
+  },
+  {
+    id: "cron",
+    name: "Cron (Scheduled tasks)",
+    description: "Recurring task scheduler using cron expressions (node-cron).",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Run automations on a schedule \u2014 morning digest, periodic sync, routine jobs.",
+    provisioning: {
+      activation: "Register jobs via config/cron API; CronRunner schedules them.",
+      configPath: "matrixos.json \u2192 cron.jobs[]"
+    }
+  },
+  {
+    id: "goal-mode",
+    name: "Goal Mode",
+    description: "Objective-driven mode with GOAL.md / VERIFY.md / PROGRESS.md tracking.",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Give Morpheus a goal + acceptance criteria; it tracks progress in plan files.",
+    provisioning: {
+      activation: "Create a GOAL.md in the worktree; Morpheus enters goal mode and maintains VERIFY/PROGRESS.",
+      configPath: "project worktree \u2192 GOAL.md",
+      notes: "MVP is file-based; a verifier subagent and token budget are planned for later phases."
+    }
+  },
+  {
+    id: "team-mode",
+    name: "Team Mode",
+    description: "Spawn parallel sub-agent teams (12 team_* tools) with mailbox, tasklist and optional tmux layout.",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Decompose a big task across multiple specialized agents running concurrently.",
+    provisioning: {
+      activation: "Set `team_mode.enabled: true` in config (off by default).",
+      configPath: "matrixos.json \u2192 team_mode.enabled"
+    }
+  },
+  {
+    id: "gateway",
+    name: "Messaging Gateway",
+    description: "Multi-channel gateway: Telegram, Discord, WhatsApp (with audit, dedupe, rate-limit).",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Drive Morpheus from your chat apps; receive digests and alerts where you already are.",
+    provisioning: {
+      activation: "1) Set `gateway.enabled: true` in matrixos.json. 2) Add a channel entry under `gateway.channels` (type: telegram | discord | whatsapp) with the bot token via ENV, never inline \u2014 e.g. load `/home/shiro/.klc-gateway.env` (chmod 600) or export `MATRIXOS_TELEGRAM_TOKEN`. 3) Restart OpenCode. Inbound messages are relayed to a fresh Morpheus session and the reply is sent back to the chat automatically.",
+      configPath: "matrixos.json \u2192 gateway.enabled + gateway.channels[]",
+      notes: "WhatsApp is sandbox-by-default (requires explicit allowlist). The relay is wired in create-plugin-module.ts \u2014 each inbound message spawns a Morpheus session and returns the reply. Tokens MUST come from env/vault; the published config never contains secrets."
+    }
+  },
+  {
+    id: "learning-loop",
+    name: "Learning Loop",
+    description: "Self-improvement: scans audit log \u2192 proposes learnings \u2192 writes .omo/rules/matrix-learnings.md.",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "MaTrixOS gets smarter over time by recording what worked.",
+    provisioning: {
+      activation: "Run `matrixos apply-learnings` (dry-run by default; `--apply` to write rules).",
+      configPath: ".omo/rules/matrix-learnings.md",
+      notes: "All mutating self-improvement defaults to dry-run (human validation required)."
+    }
+  },
+  {
+    id: "upstream-sync",
+    name: "Upstream Sync",
+    description: "Periodic comparison with upstream OMO releases, classified into merge/cherry-pick/skip recommendations.",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Stay current with upstream fixes without blindly auto-merging.",
+    provisioning: {
+      activation: "Run the upstream-sync check command; it produces a recommendation only (never auto-merges).",
+      notes: "Read-only by design \u2014 the human decides what to pull."
+    }
+  },
+  {
+    id: "skill-curator",
+    name: "Skill Curator",
+    description: "4-scope audit of skills: duplicate names, broken paths, missing descriptions, superseded skills.",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Keep your skills clean and non-conflicting.",
+    provisioning: {
+      activation: "Run the skill-curator audit command."
+    }
+  },
+  {
+    id: "anti-loop",
+    name: "Anti-Loop Watchdog",
+    description: "Detects doom loops, stuck agents, zombie sessions, hook recursion, context bloat, runaway tasks.",
+    enabledByDefault: true,
+    status: "native",
+    userBenefit: "Morpheus self-protects against infinite loops and runaway background work.",
+    provisioning: {
+      activation: "Always on; configurable thresholds in watchdog config.",
+      configPath: "matrixos.json \u2192 watchdog.*"
+    }
+  },
+  {
+    id: "background-agent",
+    name: "Background Agent Engine",
+    description: "Core orchestration: lifecycle of tasks, concurrency control, circuit breaker, parent-wake.",
+    enabledByDefault: true,
+    status: "native",
+    userBenefit: "Run heavy/delegated work in the background while you keep working.",
+    provisioning: {
+      activation: "Always on (part of the runtime)."
+    }
+  },
+  {
+    id: "mcp-oauth",
+    name: "MCP + OAuth",
+    description: "Manage MCP servers (3 tiers) with OAuth 2.0 (PKCE + DCR + step-up).",
+    enabledByDefault: true,
+    status: "native",
+    userBenefit: "Connect external tools/secured APIs to Morpheus via MCP.",
+    provisioning: {
+      activation: "Register MCP servers via config or `matrixos mcp-oauth login`.",
+      configPath: "matrixos.json \u2192 mcpServers"
+    }
+  },
+  {
+    id: "monitor",
+    name: "Session Monitor",
+    description: "Captures session output (ring buffer, filtering pipeline) for observability.",
+    enabledByDefault: true,
+    status: "native",
+    userBenefit: "Morpheus keeps an eye on long-running sessions and flags anomalies.",
+    provisioning: {
+      activation: "Always on (part of the runtime)."
+    }
+  },
+  {
+    id: "boulder-state",
+    name: "Boulder State",
+    description: "Persistent work-plan tracker (.omo/boulder.json) for plan progress.",
+    enabledByDefault: true,
+    status: "native",
+    userBenefit: "Resume multi-step plans across sessions without losing track.",
+    provisioning: {
+      activation: "Always on; inspected via `matrixos boulder`."
+    }
+  },
+  {
+    id: "tui-sidebar",
+    name: "TUI Sidebar",
+    description: "Real-time sidebar in the OpenCode TUI showing agents/tasks/sessions.",
+    enabledByDefault: true,
+    status: "native",
+    userBenefit: "See live agent/task state inside your terminal UI.",
+    provisioning: {
+      activation: "Always on in the OpenCode TUI."
+    }
+  },
+  {
+    id: "envsitter-guard",
+    name: "Envsitter Guard",
+    description: "Security guardrail plugin that blocks Morpheus from reading or writing .env* files and other secret-bearing paths.",
+    enabledByDefault: false,
+    status: "opt-in",
+    userBenefit: "Prevents accidental secret exposure: Morpheus cannot cat/edit a .env or any file matching secret patterns (.env, .env.*, *.pem, *.key, secrets/, etc.). Recommended for any agentic setup handling credentials.",
+    provisioning: {
+      activation: 'Add the plugin to OpenCode\'s `plugin` array (not the matrixos config):\n```json\n// opencode.json\n{\n  "plugin": ["envsitter-guard"]\n}\n```\nThe plugin is installed by OpenCode on first boot (npm/git). Restart OpenCode after editing the config.',
+      configPath: "opencode.json \u2192 plugin[]",
+      notes: "Guardrail is independent from MaTrixOS \u2014 it lives in the OpenCode plugin layer. Even if the user disables the feature in features.ts, the underlying guard still applies as long as the plugin is registered. Use it in conjunction with the gateway env token (TELEGRAM_BOT_TOKEN lives in .klc-gateway.env, chmod 600)."
+    }
+  }
+];
+var OPT_IN_FEATURES = MATRIX_FEATURES.filter((f) => !f.enabledByDefault);
+function getFeature(id) {
+  const lower = id.toLowerCase();
+  return MATRIX_FEATURES.find((f) => f.id.toLowerCase() === lower);
+}
+export {
+  getFeature,
+  OPT_IN_FEATURES,
+  MATRIX_FEATURES
+};

package/dist/index.js

@@ -367932,7 +367932,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "@kl-c/matrixos",
-  version: "0.1.13",
+  version: "0.1.15",
   description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   main: "./dist/index.js",
   types: "dist/index.d.ts",
@@ -368007,6 +368007,7 @@ var package_default = {
     },
     "./server": "./dist/index.js",
     "./tui": "./dist/tui.js",
+    "./features": "./dist/features/matrix-inventory/features.js",
     "./schema.json": "./dist/matrixos.schema.json"
   },
   scripts: {
@@ -368018,6 +368019,7 @@ var package_default = {
     "build:lsp-daemon": "npm --prefix packages/lsp-daemon ci && npm --prefix packages/lsp-daemon run build",
     "build:node-require-shim": "bun run script/patch-node-require-shim.ts",
     "build:binaries": "bun run script/build-binaries.ts",
+    "build:features-inventory": "bun build packages/omo-opencode/src/features/matrix-inventory/features.ts --outdir dist/features/matrix-inventory --target bun --format esm --external zod",
     "build:schema": "bun run script/build-schema.ts",
     "build:model-capabilities": "bun run script/build-model-capabilities.ts",
     clean: "rm -rf dist",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kl-c/matrixos",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "MaTrixOS — Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",
@@ -75,6 +75,7 @@
     },
     "./server": "./dist/index.js",
     "./tui": "./dist/tui.js",
+    "./features": "./dist/features/matrix-inventory/features.js",
     "./schema.json": "./dist/matrixos.schema.json"
   },
   "scripts": {
@@ -86,6 +87,7 @@
     "build:lsp-daemon": "npm --prefix packages/lsp-daemon ci && npm --prefix packages/lsp-daemon run build",
     "build:node-require-shim": "bun run script/patch-node-require-shim.ts",
     "build:binaries": "bun run script/build-binaries.ts",
+    "build:features-inventory": "bun build packages/omo-opencode/src/features/matrix-inventory/features.ts --outdir dist/features/matrix-inventory --target bun --format esm --external zod",
     "build:schema": "bun run script/build-schema.ts",
     "build:model-capabilities": "bun run script/build-model-capabilities.ts",
     "clean": "rm -rf dist",