@kl-c/matrixos 0.2.5 → 0.2.7

package/.agents/command/adopt.md

@@ -6,13 +6,13 @@ description: Launch or re-run the Morpheus adoption ritual — establish user co
 You are executing the **Morpheus adoption ritual** (`/adopt`). This is the first-contact (or re-adoption) ceremony that establishes the user's context and offers optional MaTrixOS features.
 
 ## When this runs
-- First launch, if `/root/MOS_Vault/04-Areas/user-context.md` is missing or still a template.
+- First launch, if `.matrixos/user-context.md` is missing or still a template.
 - Any time the user explicitly types `/adopt` to (re)do the ritual.
 
 ## Behavior
 
 ### 1. Detect current state
-Check whether `/root/MOS_Vault/04-Areas/user-context.md` exists and is filled.
+Check whether `.matrixos/user-context.md` exists and is filled.
 - If filled: tell the user "Tu as déjà un contexte d'adoption. Je relance le rituel pour le mettre à jour." and proceed to step 2 (re-adoption mode — EDIT sections, do NOT rewrite from scratch).
 - If missing/template: adoption mode — you will CREATE the file.
 
@@ -28,32 +28,20 @@ Keep it to one short paragraph — this is awareness, not the opt-in checklist (
 Pose ~5 targeted questions:
 1. **Qui es-tu ?** (nom/alias, rôle, ce que tu fais)
 2. **Pour quel projet / besoin m'as-tu déployé ?** (objectif, stack, périmètre)
-3. **Quelles contraintes / garde-fous ?** (infra, interdits, modèles si hors défaut)
-4. **Comment veux-tu collaborer ?** (style de réponse, proactivité, niveau de vérif)
-5. **À qui est-ce que je rends compte ?** (confirmation : toi seul, ou une entité que tu désignes)
-
-### 3. Offer opt-in features (DO NOT skip this)
-After the questions, read the feature inventory from:
-`packages/omo-opencode/src/features/matrix-inventory/features.ts` (export `OPT_IN_FEATURES`).
-
-Present the opt-in features as a checklist. For EACH, give: name, one-line description, and the honest provisioning note (especially the Dashboard — clarify it is a web UI served on 127.0.0.1:9123, backend always present, frontend bundled by the build; to enable: `matrixos dashboard --daemon`).
-
-Ask the user which they want activated. Confirm specifically the **Dashboard (Mission Control)** since the user explicitly cares about it.
-
-### 4. Synthesize
-Write/edit `/root/MOS_Vault/04-Areas/user-context.md`:
-- Adoption mode: fill sections 1–4, set `last_verified` to today, add a line in section 5 (Mises à jour) with today's date.
-- Re-adoption mode: edit only the sections the user changed; update `last_verified`; append a line in section 5.
-- **ALWAYS add a `## Features` section** (even in re-adoption) listing which opt-in features the user chose to activate (e.g. `Dashboard: activé`, `Kanban: non`, etc.). This marker tells the auto-adoption trigger that the feature checklist was presented — without it, the ritual will re-run on next launch.
-Never rewrite the whole file from scratch — preserve existing context.
-
-Also update `/root/MOS_Vault/MEMORY.md` routing if the user-context file was just created.
-
-### 5. Confirm
-End with: « C'est noté, je suis désormais configuré pour toi. Tu peux à tout moment utiliser `/features` pour voir ce que je peux faire, ou `/adopt` pour refaire ce rituel. »
-
-## Rules
-- User context is NEVER fixed: user can say "mets à jour mon contexte" → edit, not rewrite.
-- Do not invent a hierarchy/manager — Morpheus reports only to the user who installed it.
-- Do not store code-derivable facts in user-context.md (that belongs to Magic Context / MOS_Vault project files).
-- If the user wants a feature activated that requires provisioning (e.g. Dashboard), relay the exact provisioning steps from the inventory — and if you are instructed to actually enable it, follow the `provisioning.activation` recipe (e.g. launch `matrixos dashboard --daemon`).
+3. **Quel niveau d'automatisation veux-tu ?** (assistant, agent, team mode)
+4. **Veux-tu activer le dashboard ?** (Mission Control)
+5. **Veux-tu le gateway Telegram ?** (répondre depuis ton téléphone)
+
+### 4. Write user-context.md
+Write the answers to `.matrixos/user-context.md` in French, structured as YAML frontmatter + markdown sections.
+
+### 5. Offer feature toggles
+After writing context, offer to enable:
+- Dashboard (`matrixos dashboard --daemon`)
+- Gateway Telegram (`matrixos gateway adopt telegram`)
+- Kanban (`matrixos project switch`)
+- Cron / auto-audit (`matrixos self-audit --install-cron`)
+
+### 6. Confirm
+"Rituel terminé. Tu peux me demander n'importe quoi maintenant — je connais ton contexte."
+</command-instruction>

package/dist/cli/index.js

@@ -2163,7 +2163,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.2.5",
+    version: "0.2.7",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -165755,6 +165755,13 @@ async function runAdopt(options = {}) {
       message: "Global adoption requires an interactive terminal. Run: matrixos adopt (no arguments)."
     };
   }
+  if (!process.stdin.isTTY) {
+    return {
+      ok: false,
+      message: `Cannot run interactive adoption: stdin is not a TTY.
+` + "Run in a terminal, or use: matrixos gateway adopt telegram --token <token>"
+    };
+  }
   console.log(`
 === MaTrixOS Re-Adoption ===`);
   console.log(`You can reconfigure providers, channels, and profile.
@@ -166086,8 +166093,357 @@ var init_gateway_start = __esm(() => {
   ENV_PATH = resolve19(process.cwd(), ".klc-gateway.env");
 });
 
+// packages/omo-opencode/src/deployment/deployment-core.ts
+function registerTarget(target) {
+  targets.set(target.name, target);
+}
+function getTarget(name2) {
+  return targets.get(name2);
+}
+function listTargets() {
+  return Array.from(targets.keys());
+}
+var targets;
+var init_deployment_core = __esm(() => {
+  targets = new Map;
+});
+
+// packages/omo-opencode/src/deployment/deploy-static.ts
+import { spawn as spawn6 } from "child_process";
+import { existsSync as existsSync78 } from "fs";
+import { resolve as resolve20 } from "path";
+function pushStage(stage, message, ok = true) {
+  return { stage, message, ok };
+}
+function run2(cmd, args, cwd) {
+  return new Promise((resolve21) => {
+    let output = "";
+    let error51 = "";
+    const child = spawn6(cmd, args, { cwd, shell: false });
+    child.stdout.on("data", (d) => output += d.toString());
+    child.stderr.on("data", (d) => error51 += d.toString());
+    child.on("close", (code) => resolve21({ ok: code === 0, output, error: error51 }));
+  });
+}
+var deployStatic;
+var init_deploy_static = __esm(() => {
+  deployStatic = {
+    name: "static",
+    async deploy(ctx, params) {
+      const stages = [];
+      const buildDir = resolve20(ctx.projectRoot, params.buildDir ?? "dist");
+      const destination = params.destination;
+      const prebuild = params.prebuild ?? "bun run build";
+      try {
+        if (!destination) {
+          return { target: "static", ok: false, stages: [pushStage("build", "missing destination parameter", false)], error: "missing destination" };
+        }
+        if (ctx.environment === "production" && ctx.requireValidation && !params.force) {
+          return {
+            target: "static",
+            ok: false,
+            stages: [pushStage("build", "production deploy requires explicit validation (force=true or use staging)", false)],
+            error: "validation required"
+          };
+        }
+        if (!ctx.execute) {
+          return {
+            target: "static",
+            ok: true,
+            url: destination,
+            stages: [
+              pushStage("build", `dry-run: would run '${prebuild}' in ${ctx.projectRoot}`),
+              pushStage("push", `dry-run: would rsync ${buildDir} to ${destination}`),
+              pushStage("verify", "dry-run: would verify 200 from deployed URL")
+            ]
+          };
+        }
+        if (prebuild) {
+          stages.push(pushStage("build", `running '${prebuild}'...`));
+          const build = await run2(prebuild, [], ctx.projectRoot);
+          if (!build.ok) {
+            stages.push(pushStage("build", `build failed: ${build.error}`, false));
+            return { target: "static", ok: false, stages, error: build.error };
+          }
+          stages.push(pushStage("build", "build succeeded"));
+        }
+        if (!existsSync78(buildDir)) {
+          stages.push(pushStage("push", `build directory not found: ${buildDir}`, false));
+          return { target: "static", ok: false, stages, error: "build directory missing" };
+        }
+        stages.push(pushStage("push", `syncing ${buildDir} to ${destination}...`));
+        const rsync = await run2("rsync", ["-avz", "--delete", buildDir + "/", destination], ctx.projectRoot);
+        if (!rsync.ok) {
+          stages.push(pushStage("push", `rsync failed: ${rsync.error}`, false));
+          return { target: "static", ok: false, stages, error: rsync.error };
+        }
+        stages.push(pushStage("push", "sync complete"));
+        const url3 = params.verifyUrl;
+        if (url3) {
+          stages.push(pushStage("verify", `checking ${url3}...`));
+          const check2 = await run2("curl", ["-sf", url3], ctx.projectRoot);
+          if (!check2.ok) {
+            stages.push(pushStage("verify", `verify failed: ${check2.error}`, false));
+            return { target: "static", ok: false, stages, error: check2.error };
+          }
+          stages.push(pushStage("verify", "verify ok"));
+        }
+        return { target: "static", ok: true, url: url3, stages };
+      } catch (err) {
+        const error51 = err instanceof Error ? err.message : String(err);
+        stages.push(pushStage("done", `unexpected error: ${error51}`, false));
+        return { target: "static", ok: false, stages, error: error51 };
+      }
+    }
+  };
+});
+
+// packages/omo-opencode/src/deployment/deploy-vercel.ts
+import { spawn as spawn7 } from "child_process";
+function pushStage2(stage, message, ok = true) {
+  return { stage, message, ok };
+}
+function run3(cmd, args, cwd, env5) {
+  return new Promise((resolve21) => {
+    let output = "";
+    let error51 = "";
+    const child = spawn7(cmd, args, { cwd, env: { ...process.env, ...env5 }, shell: false });
+    child.stdout.on("data", (d) => output += d.toString());
+    child.stderr.on("data", (d) => error51 += d.toString());
+    child.on("close", (code) => resolve21({ ok: code === 0, output, error: error51 }));
+  });
+}
+var deployVercel;
+var init_deploy_vercel = __esm(() => {
+  deployVercel = {
+    name: "vercel",
+    async deploy(ctx, params) {
+      const stages = [];
+      const prod = ctx.environment === "production";
+      const token = process.env.VERCEL_TOKEN || params.token;
+      try {
+        if (prod && ctx.requireValidation && !params.force) {
+          return {
+            target: "vercel",
+            ok: false,
+            stages: [pushStage2("build", "production deploy to Vercel requires explicit validation", false)],
+            error: "validation required"
+          };
+        }
+        if (!ctx.execute) {
+          return {
+            target: "vercel",
+            ok: true,
+            stages: [
+              pushStage2("build", `dry-run: would run vercel deploy${prod ? " --prod" : ""}`),
+              pushStage2("verify", "dry-run: would verify deployment URL")
+            ]
+          };
+        }
+        if (!token && prod) {
+          stages.push(pushStage2("build", "VERCEL_TOKEN missing", false));
+          return { target: "vercel", ok: false, stages, error: "missing VERCEL_TOKEN" };
+        }
+        const args = ["deploy"];
+        if (prod)
+          args.push("--prod");
+        if (token)
+          args.push("--token", token);
+        if (params.scope)
+          args.push("--scope", params.scope);
+        stages.push(pushStage2("push", `vercel ${args.join(" ")}...`));
+        const result = await run3("vercel", args, ctx.projectRoot, token ? { VERCEL_TOKEN: token } : undefined);
+        if (!result.ok) {
+          stages.push(pushStage2("push", `vercel deploy failed: ${result.error}`, false));
+          return { target: "vercel", ok: false, stages, error: result.error };
+        }
+        const urlMatch = result.output.match(/https:\/\/[^\s]+\.vercel\.app/);
+        const url3 = urlMatch?.[0];
+        stages.push(pushStage2("verify", url3 ? `deployed to ${url3}` : "deployed (URL not parsed)"));
+        return { target: "vercel", ok: true, url: url3, stages };
+      } catch (err) {
+        const error51 = err instanceof Error ? err.message : String(err);
+        stages.push(pushStage2("done", `unexpected error: ${error51}`, false));
+        return { target: "vercel", ok: false, stages, error: error51 };
+      }
+    }
+  };
+});
+
+// packages/omo-opencode/src/deployment/deploy-vps.ts
+import { spawn as spawn8 } from "child_process";
+function pushStage3(stage, message, ok = true) {
+  return { stage, message, ok };
+}
+function run4(cmd, args, cwd, env5) {
+  return new Promise((resolve21) => {
+    let output = "";
+    let error51 = "";
+    const child = spawn8(cmd, args, { cwd, env: { ...process.env, ...env5 }, shell: false });
+    child.stdout.on("data", (d) => output += d.toString());
+    child.stderr.on("data", (d) => error51 += d.toString());
+    child.on("close", (code) => resolve21({ ok: code === 0, output, error: error51 }));
+  });
+}
+var deployVps;
+var init_deploy_vps = __esm(() => {
+  deployVps = {
+    name: "vps",
+    async deploy(ctx, params) {
+      const stages = [];
+      const host = params.host;
+      const user = params.user ?? "deploy";
+      const remoteDir = params.remoteDir;
+      const buildDir = params.buildDir ?? "dist";
+      const service = params.service;
+      const healthUrl = params.healthUrl;
+      try {
+        if (!host || !remoteDir) {
+          return { target: "vps", ok: false, stages: [pushStage3("build", "missing host or remoteDir", false)], error: "missing parameters" };
+        }
+        if (ctx.environment === "production" && ctx.requireValidation && !params.force) {
+          return {
+            target: "vps",
+            ok: false,
+            stages: [pushStage3("build", "production deploy to VPS requires explicit validation", false)],
+            error: "validation required"
+          };
+        }
+        if (!ctx.execute) {
+          return {
+            target: "vps",
+            ok: true,
+            stages: [
+              pushStage3("build", `dry-run: would build in ${ctx.projectRoot}`),
+              pushStage3("push", `dry-run: would rsync ${buildDir} to ${user}@${host}:${remoteDir}`),
+              pushStage3("verify", `dry-run: would restart ${service ?? "service"} + health check ${healthUrl ?? ""}`)
+            ]
+          };
+        }
+        stages.push(pushStage3("build", "building..."));
+        const build = await run4("bun", ["run", "build"], ctx.projectRoot);
+        if (!build.ok) {
+          stages.push(pushStage3("build", `build failed: ${build.error}`, false));
+          return { target: "vps", ok: false, stages, error: build.error };
+        }
+        stages.push(pushStage3("build", "build ok"));
+        stages.push(pushStage3("push", `rsync to ${host}...`));
+        const rsync = await run4("rsync", ["-avz", "--delete", `${buildDir}/`, `${user}@${host}:${remoteDir}/`], ctx.projectRoot);
+        if (!rsync.ok) {
+          stages.push(pushStage3("push", `rsync failed: ${rsync.error}`, false));
+          return { target: "vps", ok: false, stages, error: rsync.error };
+        }
+        stages.push(pushStage3("push", "rsync ok"));
+        if (service) {
+          stages.push(pushStage3("verify", `restarting ${service}...`));
+          const restart = await run4("ssh", [`${user}@${host}`, `sudo systemctl restart ${service}`], ctx.projectRoot);
+          if (!restart.ok) {
+            stages.push(pushStage3("verify", `restart failed: ${restart.error}`, false));
+            return { target: "vps", ok: false, stages, error: restart.error };
+          }
+          stages.push(pushStage3("verify", "restart ok"));
+        }
+        if (healthUrl) {
+          stages.push(pushStage3("verify", `health check ${healthUrl}...`));
+          await new Promise((r2) => setTimeout(r2, 2000));
+          const health = await run4("curl", ["-sf", healthUrl], ctx.projectRoot);
+          if (!health.ok) {
+            stages.push(pushStage3("verify", `health check failed: ${health.error}`, false));
+            return { target: "vps", ok: false, stages, error: health.error };
+          }
+          stages.push(pushStage3("verify", "health ok"));
+        }
+        return { target: "vps", ok: true, url: healthUrl, stages };
+      } catch (err) {
+        const error51 = err instanceof Error ? err.message : String(err);
+        stages.push(pushStage3("done", `unexpected error: ${error51}`, false));
+        return { target: "vps", ok: false, stages, error: error51 };
+      }
+    }
+  };
+});
+
+// packages/omo-opencode/src/deployment/deploy-cli.ts
+import { resolve as resolve21 } from "path";
+async function runDeploy(options) {
+  const target = getTarget(options.target);
+  if (!target) {
+    console.error(`Unknown deployment target: ${options.target}`);
+    console.error(`Available: ${["static", "vercel", "vps", "docker", "wordpress"].join(", ")}`);
+    return 1;
+  }
+  const project = options.projectRoot ? undefined : await getActiveProject();
+  if (!options.projectRoot && !project) {
+    console.error("No active project. Run `matrixos project switch <slug>` or pass --project-root.");
+    return 1;
+  }
+  const projectRoot = resolve21(options.projectRoot ?? getProjectDir(project.slug));
+  const ctx = {
+    projectRoot,
+    projectSlug: project?.slug,
+    environment: options.environment ?? (options.dryRun ? "staging" : "production"),
+    execute: !options.dryRun,
+    requireValidation: true
+  };
+  const params = {};
+  for (const p2 of options.params ?? []) {
+    const [key, ...rest] = p2.split("=");
+    if (key)
+      params[key] = rest.join("=");
+  }
+  if (ctx.environment === "production" && ctx.requireValidation && !options.force) {
+    console.warn("Production deployment. This action requires explicit validation.");
+    console.warn("Re-run with --force to confirm, or use --env staging.");
+    return 1;
+  }
+  const result = await target.deploy(ctx, params);
+  if (result.ok) {
+    console.log(`\u2713 Deployed to ${result.target}${result.url ? ` \u2192 ${result.url}` : ""}`);
+    for (const s of result.stages) {
+      console.log(`  [${s.stage}] ${s.ok ? "\u2713" : "\u2717"} ${s.message}`);
+    }
+    return 0;
+  }
+  console.error(`\u2717 Deploy to ${result.target} failed: ${result.error ?? "unknown error"}`);
+  for (const s of result.stages) {
+    console.log(`  [${s.stage}] ${s.ok ? "\u2713" : "\u2717"} ${s.message}`);
+  }
+  return 1;
+}
+var init_deploy_cli = __esm(() => {
+  init_project_context();
+  init_deployment_core();
+});
+
+// packages/omo-opencode/src/deployment/index.ts
+var exports_deployment = {};
+__export(exports_deployment, {
+  targets: () => targets,
+  runDeploy: () => runDeploy,
+  registerTarget: () => registerTarget,
+  listTargets: () => listTargets,
+  getTarget: () => getTarget,
+  deployVps: () => deployVps,
+  deployVercel: () => deployVercel,
+  deployStatic: () => deployStatic
+});
+var init_deployment = __esm(() => {
+  init_deployment_core();
+  init_deploy_static();
+  init_deploy_vercel();
+  init_deploy_vps();
+  init_deploy_static();
+  init_deploy_vercel();
+  init_deploy_vps();
+  init_deploy_cli();
+  init_deployment_core();
+  registerTarget(deployStatic);
+  registerTarget(deployVercel);
+  registerTarget(deployVps);
+});
+
 // packages/omo-opencode/src/audit/self-audit.ts
-import { existsSync as existsSync78, mkdirSync as mkdirSync29, readdirSync as readdirSync17, readFileSync as readFileSync63, writeFileSync as writeFileSync29 } from "fs";
+import { existsSync as existsSync79, mkdirSync as mkdirSync29, readdirSync as readdirSync17, readFileSync as readFileSync63, writeFileSync as writeFileSync29 } from "fs";
 import { join as join83 } from "path";
 function getAuditDir(cwd = process.cwd()) {
   return join83(cwd, ".matrixos", "audits");
@@ -187060,6 +187416,9 @@ function configureRuntimeCommands(program2) {
 init_package();
 var VERSION4 = package_default.version;
 var program2 = new Command;
+function collectParams(value, previous) {
+  return previous.concat([value]);
+}
 function resolveInstallArgs(options, invocationName = process.env.OMO_INVOCATION_NAME) {
   const defaultPlatform = invocationName === "lazycodex" || invocationName === "lazycodex-ai" ? "codex" : undefined;
   const platform2 = options.platform ?? defaultPlatform;
@@ -187374,6 +187733,19 @@ gateway2.command("status").description("Check gateway status (best-effort, inspe
   }, null, 2) + `
 `);
 });
+program2.command("deploy <target>").description("Deploy the active project (static, vercel, vps)").option("-e, --env <env>", "Environment (staging, production, preview)", "production").option("-n, --dry-run", "Show what would happen without executing").option("-f, --force", "Skip production validation prompt").option("-r, --project-root <path>", "Override project root directory").option("-p, --param <param>", "Target-specific parameter (key=value)", collectParams, []).action(async (target, options) => {
+  const { runDeploy: runDeploy2 } = await Promise.resolve().then(() => (init_deployment(), exports_deployment));
+  const env5 = options.env;
+  const code = await runDeploy2({
+    target,
+    environment: env5,
+    dryRun: options.dryRun,
+    force: options.force,
+    projectRoot: options.projectRoot,
+    params: options.param
+  });
+  process.exit(code);
+});
 program2.command("self-audit").description("Generate the weekly self-audit report from task ledger and scanner signals").option("-w, --week <week>", "ISO week string, e.g. 2026-W30").option("-j, --json", "Output JSON instead of markdown").option("--tasks-db <path>", "Path to the task ledger SQLite DB").option("--install-cron", "Install the weekly cron job (Sunday 22:00)").action(async (options) => {
   const { executeSelfAuditCommand: executeSelfAuditCommand2 } = await Promise.resolve().then(() => (init_self_audit_command(), exports_self_audit_command));
   const result = await executeSelfAuditCommand2(options);
@@ -187387,13 +187759,22 @@ program2.command("self-audit").description("Generate the weekly self-audit repor
   }
   process.exit(result.ok ? 0 : 1);
 });
-program2.command("adopt").description("Re-run the MaTrixOS adoption wizard (providers, channels, profile)").addHelpText("after", `
+program2.command("adopt").description("Re-run the MaTrixOS adoption wizard (providers, channels, profile)").argument("[channel]", "optional channel to adopt (telegram). Redirects to: matrixos gateway adopt <channel>").addHelpText("after", `
 Examples:
   $ matrixos adopt                    # interactive re-adoption (TUI)
+  $ matrixos adopt telegram           # alias for: matrixos gateway adopt telegram
 
 For channel-specific setup, use:
   $ matrixos gateway adopt telegram
-`).action(async () => {
+`).action(async (channel) => {
+  if (channel) {
+    const { runAdopt: runAdopt3 } = await Promise.resolve().then(() => (init_adopt(), exports_adopt));
+    const result2 = await runAdopt3({ channel, nonInteractive: true });
+    console.log(result2.message);
+    if (!result2.ok)
+      process.exit(1);
+    return;
+  }
   const { runAdopt: runAdopt2 } = await Promise.resolve().then(() => (init_adopt(), exports_adopt));
   const result = await runAdopt2({});
   if (!result.ok)

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.2.5",
+    version: "0.2.7",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -165810,6 +165810,13 @@ async function runAdopt(options = {}) {
       message: "Global adoption requires an interactive terminal. Run: matrixos adopt (no arguments)."
     };
   }
+  if (!process.stdin.isTTY) {
+    return {
+      ok: false,
+      message: `Cannot run interactive adoption: stdin is not a TTY.
+` + "Run in a terminal, or use: matrixos gateway adopt telegram --token <token>"
+    };
+  }
   console.log(`
 === MaTrixOS Re-Adoption ===`);
   console.log(`You can reconfigure providers, channels, and profile.
@@ -166141,8 +166148,357 @@ var init_gateway_start = __esm(() => {
   ENV_PATH = resolve19(process.cwd(), ".klc-gateway.env");
 });
 
+// packages/omo-opencode/src/deployment/deployment-core.ts
+function registerTarget(target) {
+  targets.set(target.name, target);
+}
+function getTarget(name2) {
+  return targets.get(name2);
+}
+function listTargets() {
+  return Array.from(targets.keys());
+}
+var targets;
+var init_deployment_core = __esm(() => {
+  targets = new Map;
+});
+
+// packages/omo-opencode/src/deployment/deploy-static.ts
+import { spawn as spawn6 } from "child_process";
+import { existsSync as existsSync78 } from "fs";
+import { resolve as resolve20 } from "path";
+function pushStage(stage, message, ok = true) {
+  return { stage, message, ok };
+}
+function run2(cmd, args, cwd) {
+  return new Promise((resolve21) => {
+    let output = "";
+    let error51 = "";
+    const child = spawn6(cmd, args, { cwd, shell: false });
+    child.stdout.on("data", (d) => output += d.toString());
+    child.stderr.on("data", (d) => error51 += d.toString());
+    child.on("close", (code) => resolve21({ ok: code === 0, output, error: error51 }));
+  });
+}
+var deployStatic;
+var init_deploy_static = __esm(() => {
+  deployStatic = {
+    name: "static",
+    async deploy(ctx, params) {
+      const stages = [];
+      const buildDir = resolve20(ctx.projectRoot, params.buildDir ?? "dist");
+      const destination = params.destination;
+      const prebuild = params.prebuild ?? "bun run build";
+      try {
+        if (!destination) {
+          return { target: "static", ok: false, stages: [pushStage("build", "missing destination parameter", false)], error: "missing destination" };
+        }
+        if (ctx.environment === "production" && ctx.requireValidation && !params.force) {
+          return {
+            target: "static",
+            ok: false,
+            stages: [pushStage("build", "production deploy requires explicit validation (force=true or use staging)", false)],
+            error: "validation required"
+          };
+        }
+        if (!ctx.execute) {
+          return {
+            target: "static",
+            ok: true,
+            url: destination,
+            stages: [
+              pushStage("build", `dry-run: would run '${prebuild}' in ${ctx.projectRoot}`),
+              pushStage("push", `dry-run: would rsync ${buildDir} to ${destination}`),
+              pushStage("verify", "dry-run: would verify 200 from deployed URL")
+            ]
+          };
+        }
+        if (prebuild) {
+          stages.push(pushStage("build", `running '${prebuild}'...`));
+          const build = await run2(prebuild, [], ctx.projectRoot);
+          if (!build.ok) {
+            stages.push(pushStage("build", `build failed: ${build.error}`, false));
+            return { target: "static", ok: false, stages, error: build.error };
+          }
+          stages.push(pushStage("build", "build succeeded"));
+        }
+        if (!existsSync78(buildDir)) {
+          stages.push(pushStage("push", `build directory not found: ${buildDir}`, false));
+          return { target: "static", ok: false, stages, error: "build directory missing" };
+        }
+        stages.push(pushStage("push", `syncing ${buildDir} to ${destination}...`));
+        const rsync = await run2("rsync", ["-avz", "--delete", buildDir + "/", destination], ctx.projectRoot);
+        if (!rsync.ok) {
+          stages.push(pushStage("push", `rsync failed: ${rsync.error}`, false));
+          return { target: "static", ok: false, stages, error: rsync.error };
+        }
+        stages.push(pushStage("push", "sync complete"));
+        const url3 = params.verifyUrl;
+        if (url3) {
+          stages.push(pushStage("verify", `checking ${url3}...`));
+          const check2 = await run2("curl", ["-sf", url3], ctx.projectRoot);
+          if (!check2.ok) {
+            stages.push(pushStage("verify", `verify failed: ${check2.error}`, false));
+            return { target: "static", ok: false, stages, error: check2.error };
+          }
+          stages.push(pushStage("verify", "verify ok"));
+        }
+        return { target: "static", ok: true, url: url3, stages };
+      } catch (err) {
+        const error51 = err instanceof Error ? err.message : String(err);
+        stages.push(pushStage("done", `unexpected error: ${error51}`, false));
+        return { target: "static", ok: false, stages, error: error51 };
+      }
+    }
+  };
+});
+
+// packages/omo-opencode/src/deployment/deploy-vercel.ts
+import { spawn as spawn7 } from "child_process";
+function pushStage2(stage, message, ok = true) {
+  return { stage, message, ok };
+}
+function run3(cmd, args, cwd, env5) {
+  return new Promise((resolve21) => {
+    let output = "";
+    let error51 = "";
+    const child = spawn7(cmd, args, { cwd, env: { ...process.env, ...env5 }, shell: false });
+    child.stdout.on("data", (d) => output += d.toString());
+    child.stderr.on("data", (d) => error51 += d.toString());
+    child.on("close", (code) => resolve21({ ok: code === 0, output, error: error51 }));
+  });
+}
+var deployVercel;
+var init_deploy_vercel = __esm(() => {
+  deployVercel = {
+    name: "vercel",
+    async deploy(ctx, params) {
+      const stages = [];
+      const prod = ctx.environment === "production";
+      const token = process.env.VERCEL_TOKEN || params.token;
+      try {
+        if (prod && ctx.requireValidation && !params.force) {
+          return {
+            target: "vercel",
+            ok: false,
+            stages: [pushStage2("build", "production deploy to Vercel requires explicit validation", false)],
+            error: "validation required"
+          };
+        }
+        if (!ctx.execute) {
+          return {
+            target: "vercel",
+            ok: true,
+            stages: [
+              pushStage2("build", `dry-run: would run vercel deploy${prod ? " --prod" : ""}`),
+              pushStage2("verify", "dry-run: would verify deployment URL")
+            ]
+          };
+        }
+        if (!token && prod) {
+          stages.push(pushStage2("build", "VERCEL_TOKEN missing", false));
+          return { target: "vercel", ok: false, stages, error: "missing VERCEL_TOKEN" };
+        }
+        const args = ["deploy"];
+        if (prod)
+          args.push("--prod");
+        if (token)
+          args.push("--token", token);
+        if (params.scope)
+          args.push("--scope", params.scope);
+        stages.push(pushStage2("push", `vercel ${args.join(" ")}...`));
+        const result = await run3("vercel", args, ctx.projectRoot, token ? { VERCEL_TOKEN: token } : undefined);
+        if (!result.ok) {
+          stages.push(pushStage2("push", `vercel deploy failed: ${result.error}`, false));
+          return { target: "vercel", ok: false, stages, error: result.error };
+        }
+        const urlMatch = result.output.match(/https:\/\/[^\s]+\.vercel\.app/);
+        const url3 = urlMatch?.[0];
+        stages.push(pushStage2("verify", url3 ? `deployed to ${url3}` : "deployed (URL not parsed)"));
+        return { target: "vercel", ok: true, url: url3, stages };
+      } catch (err) {
+        const error51 = err instanceof Error ? err.message : String(err);
+        stages.push(pushStage2("done", `unexpected error: ${error51}`, false));
+        return { target: "vercel", ok: false, stages, error: error51 };
+      }
+    }
+  };
+});
+
+// packages/omo-opencode/src/deployment/deploy-vps.ts
+import { spawn as spawn8 } from "child_process";
+function pushStage3(stage, message, ok = true) {
+  return { stage, message, ok };
+}
+function run4(cmd, args, cwd, env5) {
+  return new Promise((resolve21) => {
+    let output = "";
+    let error51 = "";
+    const child = spawn8(cmd, args, { cwd, env: { ...process.env, ...env5 }, shell: false });
+    child.stdout.on("data", (d) => output += d.toString());
+    child.stderr.on("data", (d) => error51 += d.toString());
+    child.on("close", (code) => resolve21({ ok: code === 0, output, error: error51 }));
+  });
+}
+var deployVps;
+var init_deploy_vps = __esm(() => {
+  deployVps = {
+    name: "vps",
+    async deploy(ctx, params) {
+      const stages = [];
+      const host = params.host;
+      const user = params.user ?? "deploy";
+      const remoteDir = params.remoteDir;
+      const buildDir = params.buildDir ?? "dist";
+      const service = params.service;
+      const healthUrl = params.healthUrl;
+      try {
+        if (!host || !remoteDir) {
+          return { target: "vps", ok: false, stages: [pushStage3("build", "missing host or remoteDir", false)], error: "missing parameters" };
+        }
+        if (ctx.environment === "production" && ctx.requireValidation && !params.force) {
+          return {
+            target: "vps",
+            ok: false,
+            stages: [pushStage3("build", "production deploy to VPS requires explicit validation", false)],
+            error: "validation required"
+          };
+        }
+        if (!ctx.execute) {
+          return {
+            target: "vps",
+            ok: true,
+            stages: [
+              pushStage3("build", `dry-run: would build in ${ctx.projectRoot}`),
+              pushStage3("push", `dry-run: would rsync ${buildDir} to ${user}@${host}:${remoteDir}`),
+              pushStage3("verify", `dry-run: would restart ${service ?? "service"} + health check ${healthUrl ?? ""}`)
+            ]
+          };
+        }
+        stages.push(pushStage3("build", "building..."));
+        const build = await run4("bun", ["run", "build"], ctx.projectRoot);
+        if (!build.ok) {
+          stages.push(pushStage3("build", `build failed: ${build.error}`, false));
+          return { target: "vps", ok: false, stages, error: build.error };
+        }
+        stages.push(pushStage3("build", "build ok"));
+        stages.push(pushStage3("push", `rsync to ${host}...`));
+        const rsync = await run4("rsync", ["-avz", "--delete", `${buildDir}/`, `${user}@${host}:${remoteDir}/`], ctx.projectRoot);
+        if (!rsync.ok) {
+          stages.push(pushStage3("push", `rsync failed: ${rsync.error}`, false));
+          return { target: "vps", ok: false, stages, error: rsync.error };
+        }
+        stages.push(pushStage3("push", "rsync ok"));
+        if (service) {
+          stages.push(pushStage3("verify", `restarting ${service}...`));
+          const restart = await run4("ssh", [`${user}@${host}`, `sudo systemctl restart ${service}`], ctx.projectRoot);
+          if (!restart.ok) {
+            stages.push(pushStage3("verify", `restart failed: ${restart.error}`, false));
+            return { target: "vps", ok: false, stages, error: restart.error };
+          }
+          stages.push(pushStage3("verify", "restart ok"));
+        }
+        if (healthUrl) {
+          stages.push(pushStage3("verify", `health check ${healthUrl}...`));
+          await new Promise((r2) => setTimeout(r2, 2000));
+          const health = await run4("curl", ["-sf", healthUrl], ctx.projectRoot);
+          if (!health.ok) {
+            stages.push(pushStage3("verify", `health check failed: ${health.error}`, false));
+            return { target: "vps", ok: false, stages, error: health.error };
+          }
+          stages.push(pushStage3("verify", "health ok"));
+        }
+        return { target: "vps", ok: true, url: healthUrl, stages };
+      } catch (err) {
+        const error51 = err instanceof Error ? err.message : String(err);
+        stages.push(pushStage3("done", `unexpected error: ${error51}`, false));
+        return { target: "vps", ok: false, stages, error: error51 };
+      }
+    }
+  };
+});
+
+// packages/omo-opencode/src/deployment/deploy-cli.ts
+import { resolve as resolve21 } from "path";
+async function runDeploy(options) {
+  const target = getTarget(options.target);
+  if (!target) {
+    console.error(`Unknown deployment target: ${options.target}`);
+    console.error(`Available: ${["static", "vercel", "vps", "docker", "wordpress"].join(", ")}`);
+    return 1;
+  }
+  const project = options.projectRoot ? undefined : await getActiveProject();
+  if (!options.projectRoot && !project) {
+    console.error("No active project. Run `matrixos project switch <slug>` or pass --project-root.");
+    return 1;
+  }
+  const projectRoot = resolve21(options.projectRoot ?? getProjectDir(project.slug));
+  const ctx = {
+    projectRoot,
+    projectSlug: project?.slug,
+    environment: options.environment ?? (options.dryRun ? "staging" : "production"),
+    execute: !options.dryRun,
+    requireValidation: true
+  };
+  const params = {};
+  for (const p2 of options.params ?? []) {
+    const [key, ...rest] = p2.split("=");
+    if (key)
+      params[key] = rest.join("=");
+  }
+  if (ctx.environment === "production" && ctx.requireValidation && !options.force) {
+    console.warn("Production deployment. This action requires explicit validation.");
+    console.warn("Re-run with --force to confirm, or use --env staging.");
+    return 1;
+  }
+  const result = await target.deploy(ctx, params);
+  if (result.ok) {
+    console.log(`\u2713 Deployed to ${result.target}${result.url ? ` \u2192 ${result.url}` : ""}`);
+    for (const s of result.stages) {
+      console.log(`  [${s.stage}] ${s.ok ? "\u2713" : "\u2717"} ${s.message}`);
+    }
+    return 0;
+  }
+  console.error(`\u2717 Deploy to ${result.target} failed: ${result.error ?? "unknown error"}`);
+  for (const s of result.stages) {
+    console.log(`  [${s.stage}] ${s.ok ? "\u2713" : "\u2717"} ${s.message}`);
+  }
+  return 1;
+}
+var init_deploy_cli = __esm(() => {
+  init_project_context();
+  init_deployment_core();
+});
+
+// packages/omo-opencode/src/deployment/index.ts
+var exports_deployment = {};
+__export(exports_deployment, {
+  targets: () => targets,
+  runDeploy: () => runDeploy,
+  registerTarget: () => registerTarget,
+  listTargets: () => listTargets,
+  getTarget: () => getTarget,
+  deployVps: () => deployVps,
+  deployVercel: () => deployVercel,
+  deployStatic: () => deployStatic
+});
+var init_deployment = __esm(() => {
+  init_deployment_core();
+  init_deploy_static();
+  init_deploy_vercel();
+  init_deploy_vps();
+  init_deploy_static();
+  init_deploy_vercel();
+  init_deploy_vps();
+  init_deploy_cli();
+  init_deployment_core();
+  registerTarget(deployStatic);
+  registerTarget(deployVercel);
+  registerTarget(deployVps);
+});
+
 // packages/omo-opencode/src/audit/self-audit.ts
-import { existsSync as existsSync78, mkdirSync as mkdirSync29, readdirSync as readdirSync17, readFileSync as readFileSync63, writeFileSync as writeFileSync29 } from "fs";
+import { existsSync as existsSync79, mkdirSync as mkdirSync29, readdirSync as readdirSync17, readFileSync as readFileSync63, writeFileSync as writeFileSync29 } from "fs";
 import { join as join83 } from "path";
 function getAuditDir(cwd = process.cwd()) {
   return join83(cwd, ".matrixos", "audits");
@@ -187115,6 +187471,9 @@ function configureRuntimeCommands(program2) {
 init_package();
 var VERSION4 = package_default.version;
 var program2 = new Command;
+function collectParams(value, previous) {
+  return previous.concat([value]);
+}
 function resolveInstallArgs(options, invocationName = process.env.OMO_INVOCATION_NAME) {
   const defaultPlatform = invocationName === "lazycodex" || invocationName === "lazycodex-ai" ? "codex" : undefined;
   const platform2 = options.platform ?? defaultPlatform;
@@ -187429,6 +187788,19 @@ gateway2.command("status").description("Check gateway status (best-effort, inspe
   }, null, 2) + `
 `);
 });
+program2.command("deploy <target>").description("Deploy the active project (static, vercel, vps)").option("-e, --env <env>", "Environment (staging, production, preview)", "production").option("-n, --dry-run", "Show what would happen without executing").option("-f, --force", "Skip production validation prompt").option("-r, --project-root <path>", "Override project root directory").option("-p, --param <param>", "Target-specific parameter (key=value)", collectParams, []).action(async (target, options) => {
+  const { runDeploy: runDeploy2 } = await Promise.resolve().then(() => (init_deployment(), exports_deployment));
+  const env5 = options.env;
+  const code = await runDeploy2({
+    target,
+    environment: env5,
+    dryRun: options.dryRun,
+    force: options.force,
+    projectRoot: options.projectRoot,
+    params: options.param
+  });
+  process.exit(code);
+});
 program2.command("self-audit").description("Generate the weekly self-audit report from task ledger and scanner signals").option("-w, --week <week>", "ISO week string, e.g. 2026-W30").option("-j, --json", "Output JSON instead of markdown").option("--tasks-db <path>", "Path to the task ledger SQLite DB").option("--install-cron", "Install the weekly cron job (Sunday 22:00)").action(async (options) => {
   const { executeSelfAuditCommand: executeSelfAuditCommand2 } = await Promise.resolve().then(() => (init_self_audit_command(), exports_self_audit_command));
   const result = await executeSelfAuditCommand2(options);
@@ -187442,13 +187814,22 @@ program2.command("self-audit").description("Generate the weekly self-audit repor
   }
   process.exit(result.ok ? 0 : 1);
 });
-program2.command("adopt").description("Re-run the MaTrixOS adoption wizard (providers, channels, profile)").addHelpText("after", `
+program2.command("adopt").description("Re-run the MaTrixOS adoption wizard (providers, channels, profile)").argument("[channel]", "optional channel to adopt (telegram). Redirects to: matrixos gateway adopt <channel>").addHelpText("after", `
 Examples:
   $ matrixos adopt                    # interactive re-adoption (TUI)
+  $ matrixos adopt telegram           # alias for: matrixos gateway adopt telegram
 
 For channel-specific setup, use:
   $ matrixos gateway adopt telegram
-`).action(async () => {
+`).action(async (channel) => {
+  if (channel) {
+    const { runAdopt: runAdopt3 } = await Promise.resolve().then(() => (init_adopt(), exports_adopt));
+    const result2 = await runAdopt3({ channel, nonInteractive: true });
+    console.log(result2.message);
+    if (!result2.ok)
+      process.exit(1);
+    return;
+  }
   const { runAdopt: runAdopt2 } = await Promise.resolve().then(() => (init_adopt(), exports_adopt));
   const result = await runAdopt2({});
   if (!result.ok)

package/dist/deployment/deploy-cli.d.ts

@@ -0,0 +1,14 @@
+/**
+ * deploy-cli.ts
+ *
+ * Handles `matrixos deploy <target> [options]`.
+ */
+export interface DeployOptions {
+    target: string;
+    projectRoot?: string;
+    environment?: "staging" | "production" | "preview";
+    dryRun?: boolean;
+    force?: boolean;
+    params?: string[];
+}
+export declare function runDeploy(options: DeployOptions): Promise<number>;

package/dist/deployment/deploy-static.d.ts

@@ -0,0 +1,5 @@
+/**
+ * deploy-static — build + push to a static host via rsync/ssh.
+ */
+import type { DeploymentTarget } from "./deployment-core";
+export declare const deployStatic: DeploymentTarget;

package/dist/deployment/deploy-vercel.d.ts

@@ -0,0 +1,5 @@
+/**
+ * deploy-vercel — thin wrapper around `vercel deploy`.
+ */
+import type { DeploymentTarget } from "./deployment-core";
+export declare const deployVercel: DeploymentTarget;

package/dist/deployment/deploy-vps.d.ts

@@ -0,0 +1,5 @@
+/**
+ * deploy-vps — rsync build + ssh systemd restart + health check.
+ */
+import type { DeploymentTarget } from "./deployment-core";
+export declare const deployVps: DeploymentTarget;

package/dist/deployment/deployment-core.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A6 — Deployment skills core
+ *
+ * Shared types and helpers for MaTrixOS deployment skills.
+ * Each target implements the DeploymentTarget interface.
+ */
+export type DeploymentStage = "build" | "push" | "verify" | "rollback" | "done";
+export interface DeploymentProgress {
+    stage: DeploymentStage;
+    message: string;
+    ok: boolean;
+}
+export interface DeploymentContext {
+    projectRoot: string;
+    /** Active project slug from `matrixos project switch`. */
+    projectSlug?: string;
+    /** Environment name: staging, production, preview... */
+    environment: "staging" | "production" | "preview";
+    /** If true, perform the deployment; if false, dry-run. */
+    execute: boolean;
+    /** If true, require explicit user validation before production deploy. */
+    requireValidation: boolean;
+}
+export interface DeploymentResult {
+    target: string;
+    ok: boolean;
+    url?: string;
+    stages: DeploymentProgress[];
+    error?: string;
+}
+export interface DeploymentTarget {
+    readonly name: string;
+    deploy(ctx: DeploymentContext, params: Record<string, string>): Promise<DeploymentResult>;
+}
+export declare const targets: Map<string, DeploymentTarget>;
+export declare function registerTarget(target: DeploymentTarget): void;
+export declare function getTarget(name: string): DeploymentTarget | undefined;
+export declare function listTargets(): string[];

package/dist/deployment/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Deployment skills index (A6).
+ *
+ * Registers all built-in deployment targets so the CLI can look them up.
+ */
+export * from "./deployment-core";
+export { deployStatic } from "./deploy-static";
+export { deployVercel } from "./deploy-vercel";
+export { deployVps } from "./deploy-vps";
+export { runDeploy, type DeployOptions } from "./deploy-cli";

package/dist/index.js

@@ -368023,7 +368023,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "@kl-c/matrixos",
-  version: "0.2.5",
+  version: "0.2.7",
   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.2.5",
+  "version": "0.2.7",
   "description": "MaTrixOS — Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",