@kl-c/matrixos 0.3.52 → 0.3.53

package/dist/cli/index.js

@@ -2163,7 +2163,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.3.52",
+    version: "0.3.53",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -168480,14 +168480,161 @@ function submitPr(options) {
 }
 var init_prepare = () => {};
 
+// packages/omo-opencode/src/cli/project-init.ts
+var exports_project_init = {};
+__export(exports_project_init, {
+  projectInit: () => projectInit
+});
+import * as fs24 from "fs";
+import * as path29 from "path";
+function projectInit(options) {
+  const target = path29.resolve(options.path ?? process.cwd(), options.name);
+  const apply = options.apply ?? false;
+  if (fs24.existsSync(target) && fs24.readdirSync(target).length > 0) {
+    console.error(`[project] target exists and is not empty: ${target}`);
+    return 1;
+  }
+  const files = Object.entries(TEMPLATES).map(([rel, fn]) => ({ rel, content: fn(options.name) }));
+  if (!apply) {
+    console.log(`[dry-run] would create project '${options.name}' at:
+${target}
+`);
+    console.log("Files:");
+    for (const f2 of files) {
+      console.log(`  ${f2.rel}`);
+    }
+    console.log(`
+[dry-run] re-run with --apply to write the files.`);
+    return 0;
+  }
+  fs24.mkdirSync(path29.join(target, "src"), { recursive: true });
+  for (const f2 of files) {
+    const full = path29.join(target, f2.rel);
+    fs24.mkdirSync(path29.dirname(full), { recursive: true });
+    fs24.writeFileSync(full, f2.content);
+    console.log(`[project] wrote ${f2.rel}`);
+  }
+  console.log(`
+[project] '${options.name}' initialized at ${target}`);
+  console.log(`[project] Next: cd ${target} && matrixos run --agent Architect 'refine the plan.md'`);
+  return 0;
+}
+var TEMPLATES;
+var init_project_init = __esm(() => {
+  TEMPLATES = {
+    "AGENTS.md": (name2) => `# ${name2}
+
+> Project context for AI agents. Keep this file accurate \u2014 agents read it first.
+
+## OVERVIEW
+
+One-paragraph description of what this project is and who uses it.
+
+## CONVENTIONS
+
+- Code style: TBD
+- Tests: TBD
+- Commits: conventional commits
+
+## STRUCTURE
+
+\`\`\`
+${name2}/
+\u251C\u2500\u2500 README.md
+\u251C\u2500\u2500 PROJECT.md   # project state / roadmap
+\u251C\u2500\u2500 plan.md      # current plan
+\u2514\u2500\u2500 src/
+\`\`\`
+
+## NOTES
+
+- Link the relevant MaTrixOS Goal/Kanban board for tracking.
+`,
+    "README.md": (name2) => `# ${name2}
+
+## Install
+
+\`\`\`bash
+# add your install steps
+\`\`\`
+
+## Usage
+
+\`\`\`bash
+# add your usage steps
+\`\`\`
+
+## Development
+
+See AGENTS.md for agent context.
+`,
+    ".gitignore": () => `# Dependencies
+node_modules/
+.venv/
+__pycache__/
+
+# Build
+/dist/
+build/
+
+# Env / secrets
+.env
+.env.local
+*.secret
+
+# OS
+.DS_Store
+
+# MaTrixOS
+.omo/
+`,
+    "PROJECT.md": (name2) => `# ${name2} \u2014 Project State
+
+## STATUS
+
+| Item | State |
+|------|-------|
+| Scope | defined / wip / done |
+| Health | green / yellow / red |
+
+## ROADMAP
+
+- [ ] Milestone 1
+- [ ] Milestone 2
+
+## LINKS
+
+- MaTrixOS Goal: (create via dashboard)
+- Kanban: (link board)
+`,
+    "plan.md": () => `# Plan
+
+## Goal
+
+What are we trying to achieve?
+
+## Steps
+
+1. 
+2. 
+3. 
+
+## Open Questions
+
+- 
+`,
+    "src/.gitkeep": () => ""
+  };
+});
+
 // packages/omo-opencode/src/cli/service.ts
 var exports_service = {};
 __export(exports_service, {
   serviceInstallCommand: () => serviceInstallCommand
 });
 import * as os15 from "os";
-import * as fs24 from "fs";
-import * as path29 from "path";
+import * as fs25 from "fs";
+import * as path30 from "path";
 import { execSync as execSync4 } from "child_process";
 function resolveMatrixosBin2() {
   try {
@@ -168495,8 +168642,8 @@ function resolveMatrixosBin2() {
     if (p2)
       return p2;
   } catch {}
-  for (const cand of ["/usr/local/bin/matrixos", "/usr/bin/matrixos", path29.join(os15.homedir(), ".bun/bin/matrixos")]) {
-    if (fs24.existsSync(cand))
+  for (const cand of ["/usr/local/bin/matrixos", "/usr/bin/matrixos", path30.join(os15.homedir(), ".bun/bin/matrixos")]) {
+    if (fs25.existsSync(cand))
       return cand;
   }
   return "matrixos";
@@ -168510,16 +168657,16 @@ function resolveBunBin() {
   return "/usr/bin/bun";
 }
 function writeFileEnsureDir(filePath, content) {
-  fs24.mkdirSync(path29.dirname(filePath), { recursive: true });
-  fs24.writeFileSync(filePath, content, "utf-8");
+  fs25.mkdirSync(path30.dirname(filePath), { recursive: true });
+  fs25.writeFileSync(filePath, content, "utf-8");
   console.log(`[service] written: ${filePath}`);
 }
 function installSystemd(opts) {
   const bin = resolveMatrixosBin2();
   const bun = resolveBunBin();
   const scope = opts.user ? "--user" : "";
-  const unitDir = opts.user ? path29.join(os15.homedir(), ".config", "systemd", "user") : "/etc/systemd/system";
-  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  const unitDir = opts.user ? path30.join(os15.homedir(), ".config", "systemd", "user") : "/etc/systemd/system";
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path30.dirname(bun)}`;
   if (opts.dashboard !== false) {
     const unit = `[Unit]
 Description=MaTrixOS Dashboard
@@ -168538,7 +168685,7 @@ RestartSec=5
 [Install]
 WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 `;
-    writeFileEnsureDir(path29.join(unitDir, "matrixos-dashboard.service"), unit);
+    writeFileEnsureDir(path30.join(unitDir, "matrixos-dashboard.service"), unit);
   }
   if (opts.gateway !== false) {
     const unit = `[Unit]
@@ -168558,7 +168705,7 @@ RestartSec=5
 [Install]
 WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 `;
-    writeFileEnsureDir(path29.join(unitDir, "matrixos-gateway.service"), unit);
+    writeFileEnsureDir(path30.join(unitDir, "matrixos-gateway.service"), unit);
   }
   if (opts.cron !== false) {
     const unit = `[Unit]
@@ -168578,7 +168725,7 @@ RestartSec=5
 [Install]
 WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 `;
-    writeFileEnsureDir(path29.join(unitDir, "matrixos-cron.service"), unit);
+    writeFileEnsureDir(path30.join(unitDir, "matrixos-cron.service"), unit);
   }
   console.log("[service] reloading systemd...");
   if (scope) {
@@ -168615,8 +168762,8 @@ WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 function installLaunchd(opts) {
   const bin = resolveMatrixosBin2();
   const bun = resolveBunBin();
-  const launchDir = path29.join(os15.homedir(), "Library", "LaunchAgents");
-  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  const launchDir = path30.join(os15.homedir(), "Library", "LaunchAgents");
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path30.dirname(bun)}`;
   if (opts.dashboard !== false) {
     const label = "com.klc.matrixos.dashboard";
     const plist = `<?xml version="1.0" encoding="UTF-8"?>
@@ -168653,8 +168800,8 @@ function installLaunchd(opts) {
 </dict>
 </plist>
 `;
-    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
-    execSync4(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+    writeFileEnsureDir(path30.join(launchDir, `${label}.plist`), plist);
+    execSync4(`launchctl load ${path30.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
   }
   if (opts.gateway !== false) {
     const label = "com.klc.matrixos.gateway";
@@ -168692,8 +168839,8 @@ function installLaunchd(opts) {
 </dict>
 </plist>
 `;
-    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
-    execSync4(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+    writeFileEnsureDir(path30.join(launchDir, `${label}.plist`), plist);
+    execSync4(`launchctl load ${path30.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
   }
   console.log("[service] launchd agents installed and loaded.");
 }
@@ -168707,7 +168854,7 @@ async function serviceInstallCommand(options) {
   const platform2 = process.platform;
   console.log(`[service] detected platform: ${platform2}`);
   if (platform2 === "linux") {
-    if (!fs24.existsSync("/run/systemd/system") && !fs24.existsSync("/etc/systemd/system")) {
+    if (!fs25.existsSync("/run/systemd/system") && !fs25.existsSync("/etc/systemd/system")) {
       console.error("[service] systemd not detected \u2014 cannot install service automatically.");
       console.error("  Start manually: matrixos dashboard --host 0.0.0.0 --daemon");
       return 1;
@@ -190436,6 +190583,21 @@ prepare.command("submit <pr>").description("Mark a prepared PR as ready (human v
   const code = submitPr2({ pr, json: options.json ?? false });
   process.exit(code);
 });
+var projectCmd = program2.command("project").description("Project lifecycle helpers (generic scaffolding)");
+projectCmd.command("init <name>").description("Scaffold a generic project (AGENTS.md, README, .gitignore, PROJECT.md, plan.md)").option("-p, --path <dir>", "Target directory (default: cwd)").option("--apply", "Actually write the files (default dry-run)").option("--json", "Output as JSON").addHelpText("after", `
+Examples:
+  $ matrixos project init my-app            # dry-run
+  $ matrixos project init my-app --apply    # write files
+`).action(async (name2, options) => {
+  const { projectInit: projectInit2 } = await Promise.resolve().then(() => (init_project_init(), exports_project_init));
+  const code = projectInit2({
+    name: name2,
+    path: options.path,
+    apply: options.apply ?? false,
+    json: options.json ?? false
+  });
+  process.exit(code);
+});
 program2.command("service").description("Install MaTrixOS as a persistent OS service (dashboard + gateway)").argument("<action>", "install | uninstall").option("--no-dashboard", "Skip dashboard service").option("--no-gateway", "Skip gateway service").option("--no-cron", "Skip cron scheduler service").option("--user", "Install as current user (systemd --user / launchd user agent)").action(async (action, options) => {
   if (action !== "install" && action !== "uninstall") {
     console.error(`[service] unknown action: ${action}. Use 'install' or 'uninstall'.`);

package/dist/cli/project-init.d.ts

@@ -0,0 +1,7 @@
+export interface ProjectInitOptions {
+    name: string;
+    path?: string;
+    apply?: boolean;
+    json?: boolean;
+}
+export declare function projectInit(options: ProjectInitOptions): number;

package/dist/cli-node/index.js

@@ -2163,7 +2163,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.3.52",
+    version: "0.3.53",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -168535,14 +168535,161 @@ function submitPr(options) {
 }
 var init_prepare = () => {};
 
+// packages/omo-opencode/src/cli/project-init.ts
+var exports_project_init = {};
+__export(exports_project_init, {
+  projectInit: () => projectInit
+});
+import * as fs24 from "fs";
+import * as path29 from "path";
+function projectInit(options) {
+  const target = path29.resolve(options.path ?? process.cwd(), options.name);
+  const apply = options.apply ?? false;
+  if (fs24.existsSync(target) && fs24.readdirSync(target).length > 0) {
+    console.error(`[project] target exists and is not empty: ${target}`);
+    return 1;
+  }
+  const files = Object.entries(TEMPLATES).map(([rel, fn]) => ({ rel, content: fn(options.name) }));
+  if (!apply) {
+    console.log(`[dry-run] would create project '${options.name}' at:
+${target}
+`);
+    console.log("Files:");
+    for (const f2 of files) {
+      console.log(`  ${f2.rel}`);
+    }
+    console.log(`
+[dry-run] re-run with --apply to write the files.`);
+    return 0;
+  }
+  fs24.mkdirSync(path29.join(target, "src"), { recursive: true });
+  for (const f2 of files) {
+    const full = path29.join(target, f2.rel);
+    fs24.mkdirSync(path29.dirname(full), { recursive: true });
+    fs24.writeFileSync(full, f2.content);
+    console.log(`[project] wrote ${f2.rel}`);
+  }
+  console.log(`
+[project] '${options.name}' initialized at ${target}`);
+  console.log(`[project] Next: cd ${target} && matrixos run --agent Architect 'refine the plan.md'`);
+  return 0;
+}
+var TEMPLATES;
+var init_project_init = __esm(() => {
+  TEMPLATES = {
+    "AGENTS.md": (name2) => `# ${name2}
+
+> Project context for AI agents. Keep this file accurate \u2014 agents read it first.
+
+## OVERVIEW
+
+One-paragraph description of what this project is and who uses it.
+
+## CONVENTIONS
+
+- Code style: TBD
+- Tests: TBD
+- Commits: conventional commits
+
+## STRUCTURE
+
+\`\`\`
+${name2}/
+\u251C\u2500\u2500 README.md
+\u251C\u2500\u2500 PROJECT.md   # project state / roadmap
+\u251C\u2500\u2500 plan.md      # current plan
+\u2514\u2500\u2500 src/
+\`\`\`
+
+## NOTES
+
+- Link the relevant MaTrixOS Goal/Kanban board for tracking.
+`,
+    "README.md": (name2) => `# ${name2}
+
+## Install
+
+\`\`\`bash
+# add your install steps
+\`\`\`
+
+## Usage
+
+\`\`\`bash
+# add your usage steps
+\`\`\`
+
+## Development
+
+See AGENTS.md for agent context.
+`,
+    ".gitignore": () => `# Dependencies
+node_modules/
+.venv/
+__pycache__/
+
+# Build
+/dist/
+build/
+
+# Env / secrets
+.env
+.env.local
+*.secret
+
+# OS
+.DS_Store
+
+# MaTrixOS
+.omo/
+`,
+    "PROJECT.md": (name2) => `# ${name2} \u2014 Project State
+
+## STATUS
+
+| Item | State |
+|------|-------|
+| Scope | defined / wip / done |
+| Health | green / yellow / red |
+
+## ROADMAP
+
+- [ ] Milestone 1
+- [ ] Milestone 2
+
+## LINKS
+
+- MaTrixOS Goal: (create via dashboard)
+- Kanban: (link board)
+`,
+    "plan.md": () => `# Plan
+
+## Goal
+
+What are we trying to achieve?
+
+## Steps
+
+1. 
+2. 
+3. 
+
+## Open Questions
+
+- 
+`,
+    "src/.gitkeep": () => ""
+  };
+});
+
 // packages/omo-opencode/src/cli/service.ts
 var exports_service = {};
 __export(exports_service, {
   serviceInstallCommand: () => serviceInstallCommand
 });
 import * as os15 from "os";
-import * as fs24 from "fs";
-import * as path29 from "path";
+import * as fs25 from "fs";
+import * as path30 from "path";
 import { execSync as execSync4 } from "child_process";
 function resolveMatrixosBin2() {
   try {
@@ -168550,8 +168697,8 @@ function resolveMatrixosBin2() {
     if (p2)
       return p2;
   } catch {}
-  for (const cand of ["/usr/local/bin/matrixos", "/usr/bin/matrixos", path29.join(os15.homedir(), ".bun/bin/matrixos")]) {
-    if (fs24.existsSync(cand))
+  for (const cand of ["/usr/local/bin/matrixos", "/usr/bin/matrixos", path30.join(os15.homedir(), ".bun/bin/matrixos")]) {
+    if (fs25.existsSync(cand))
       return cand;
   }
   return "matrixos";
@@ -168565,16 +168712,16 @@ function resolveBunBin() {
   return "/usr/bin/bun";
 }
 function writeFileEnsureDir(filePath, content) {
-  fs24.mkdirSync(path29.dirname(filePath), { recursive: true });
-  fs24.writeFileSync(filePath, content, "utf-8");
+  fs25.mkdirSync(path30.dirname(filePath), { recursive: true });
+  fs25.writeFileSync(filePath, content, "utf-8");
   console.log(`[service] written: ${filePath}`);
 }
 function installSystemd(opts) {
   const bin = resolveMatrixosBin2();
   const bun = resolveBunBin();
   const scope = opts.user ? "--user" : "";
-  const unitDir = opts.user ? path29.join(os15.homedir(), ".config", "systemd", "user") : "/etc/systemd/system";
-  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  const unitDir = opts.user ? path30.join(os15.homedir(), ".config", "systemd", "user") : "/etc/systemd/system";
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path30.dirname(bun)}`;
   if (opts.dashboard !== false) {
     const unit = `[Unit]
 Description=MaTrixOS Dashboard
@@ -168593,7 +168740,7 @@ RestartSec=5
 [Install]
 WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 `;
-    writeFileEnsureDir(path29.join(unitDir, "matrixos-dashboard.service"), unit);
+    writeFileEnsureDir(path30.join(unitDir, "matrixos-dashboard.service"), unit);
   }
   if (opts.gateway !== false) {
     const unit = `[Unit]
@@ -168613,7 +168760,7 @@ RestartSec=5
 [Install]
 WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 `;
-    writeFileEnsureDir(path29.join(unitDir, "matrixos-gateway.service"), unit);
+    writeFileEnsureDir(path30.join(unitDir, "matrixos-gateway.service"), unit);
   }
   if (opts.cron !== false) {
     const unit = `[Unit]
@@ -168633,7 +168780,7 @@ RestartSec=5
 [Install]
 WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 `;
-    writeFileEnsureDir(path29.join(unitDir, "matrixos-cron.service"), unit);
+    writeFileEnsureDir(path30.join(unitDir, "matrixos-cron.service"), unit);
   }
   console.log("[service] reloading systemd...");
   if (scope) {
@@ -168670,8 +168817,8 @@ WantedBy=${opts.user ? "default.target" : "multi-user.target"}
 function installLaunchd(opts) {
   const bin = resolveMatrixosBin2();
   const bun = resolveBunBin();
-  const launchDir = path29.join(os15.homedir(), "Library", "LaunchAgents");
-  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  const launchDir = path30.join(os15.homedir(), "Library", "LaunchAgents");
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path30.dirname(bun)}`;
   if (opts.dashboard !== false) {
     const label = "com.klc.matrixos.dashboard";
     const plist = `<?xml version="1.0" encoding="UTF-8"?>
@@ -168708,8 +168855,8 @@ function installLaunchd(opts) {
 </dict>
 </plist>
 `;
-    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
-    execSync4(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+    writeFileEnsureDir(path30.join(launchDir, `${label}.plist`), plist);
+    execSync4(`launchctl load ${path30.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
   }
   if (opts.gateway !== false) {
     const label = "com.klc.matrixos.gateway";
@@ -168747,8 +168894,8 @@ function installLaunchd(opts) {
 </dict>
 </plist>
 `;
-    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
-    execSync4(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+    writeFileEnsureDir(path30.join(launchDir, `${label}.plist`), plist);
+    execSync4(`launchctl load ${path30.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
   }
   console.log("[service] launchd agents installed and loaded.");
 }
@@ -168762,7 +168909,7 @@ async function serviceInstallCommand(options) {
   const platform2 = process.platform;
   console.log(`[service] detected platform: ${platform2}`);
   if (platform2 === "linux") {
-    if (!fs24.existsSync("/run/systemd/system") && !fs24.existsSync("/etc/systemd/system")) {
+    if (!fs25.existsSync("/run/systemd/system") && !fs25.existsSync("/etc/systemd/system")) {
       console.error("[service] systemd not detected \u2014 cannot install service automatically.");
       console.error("  Start manually: matrixos dashboard --host 0.0.0.0 --daemon");
       return 1;
@@ -190491,6 +190638,21 @@ prepare.command("submit <pr>").description("Mark a prepared PR as ready (human v
   const code = submitPr2({ pr, json: options.json ?? false });
   process.exit(code);
 });
+var projectCmd = program2.command("project").description("Project lifecycle helpers (generic scaffolding)");
+projectCmd.command("init <name>").description("Scaffold a generic project (AGENTS.md, README, .gitignore, PROJECT.md, plan.md)").option("-p, --path <dir>", "Target directory (default: cwd)").option("--apply", "Actually write the files (default dry-run)").option("--json", "Output as JSON").addHelpText("after", `
+Examples:
+  $ matrixos project init my-app            # dry-run
+  $ matrixos project init my-app --apply    # write files
+`).action(async (name2, options) => {
+  const { projectInit: projectInit2 } = await Promise.resolve().then(() => (init_project_init(), exports_project_init));
+  const code = projectInit2({
+    name: name2,
+    path: options.path,
+    apply: options.apply ?? false,
+    json: options.json ?? false
+  });
+  process.exit(code);
+});
 program2.command("service").description("Install MaTrixOS as a persistent OS service (dashboard + gateway)").argument("<action>", "install | uninstall").option("--no-dashboard", "Skip dashboard service").option("--no-gateway", "Skip gateway service").option("--no-cron", "Skip cron scheduler service").option("--user", "Install as current user (systemd --user / launchd user agent)").action(async (action, options) => {
   if (action !== "install" && action !== "uninstall") {
     console.error(`[service] unknown action: ${action}. Use 'install' or 'uninstall'.`);

package/dist/index.js

@@ -368086,7 +368086,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "@kl-c/matrixos",
-  version: "0.3.52",
+  version: "0.3.53",
   description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   main: "./dist/index.js",
   types: "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kl-c/matrixos",
-  "version": "0.3.52",
+  "version": "0.3.53",
   "description": "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",