@kl-c/matrixos 0.2.1 → 0.2.6

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.1",
+  version: "0.2.6",
   description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   main: "./dist/index.js",
   types: "dist/index.d.ts",
@@ -443547,11 +443547,22 @@ class TelegramAdapter {
       }
       const text = envelope.content.text ?? "";
       const result = await this.bot.api.sendMessage(chatId, text);
-      return String(result.message_id);
+      const messageId = String(result.message_id);
+      if (envelope.metadata?.onMessageId && typeof envelope.metadata.onMessageId === "function") {
+        envelope.metadata.onMessageId(messageId);
+      }
+      return messageId;
     } catch (err) {
       throw new TelegramSendError(`Failed to send Telegram message: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
     }
   }
+  async editMessage(recipientId, messageId, text) {
+    try {
+      await this.bot.api.editMessageText(recipientId, Number(messageId), text);
+    } catch (err) {
+      console.warn(`[telegram] editMessage failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
   onMessage(handler) {
     this.messageHandler = handler;
   }

package/dist/project/project-context.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A5 — Active Project Context
+ *
+ * Lightweight project manager for MaTrixOS. Each project is a directory
+ * under .matrixos/projects/<slug>/ containing meta.json, kanban.json and a
+ * kb/ folder. The active project is stored in .matrixos/state.json.
+ */
+export interface ProjectMeta {
+    readonly slug: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly createdAt: string;
+    readonly archived?: boolean;
+    readonly archivedAt?: string;
+}
+export interface ProjectState {
+    readonly activeProject?: string;
+}
+export interface ProjectInfo {
+    readonly slug: string;
+    readonly meta: ProjectMeta;
+    readonly active: boolean;
+}
+export declare function getMatrixOsDir(cwd?: string): string;
+export declare function getProjectsDir(cwd?: string): string;
+export declare function getProjectDir(slug: string, cwd?: string): string;
+export declare function getStatePath(cwd?: string): string;
+export declare function loadState(cwd?: string): ProjectState;
+export declare function saveState(state: ProjectState, cwd?: string): void;
+export declare function loadProjectMeta(slug: string, cwd?: string): ProjectMeta | null;
+export declare function saveProjectMeta(slug: string, meta: ProjectMeta, cwd?: string): void;
+export declare function initProjectFiles(slug: string, cwd?: string): void;
+export declare function createProject(slug: string, options?: {
+    name?: string;
+    description?: string;
+    cwd?: string;
+}): ProjectInfo;
+export declare function listProjects(cwd?: string): ProjectInfo[];
+export declare function switchProject(slug: string, cwd?: string): ProjectInfo;
+export declare function archiveProject(slug: string, cwd?: string): ProjectInfo;
+export declare function unarchiveProject(slug: string, cwd?: string): ProjectInfo;
+export declare function deleteProject(slug: string, cwd?: string): void;
+export declare function getActiveProject(cwd?: string): ProjectInfo | null;

package/dist/project/project-memory.d.ts

@@ -0,0 +1,35 @@
+/**
+ * A1 — Project-scoped memory and search
+ *
+ * Builds on top of the learning-loop memory store. Adds a project tag to
+ * every episode recorded while a project is active, and filters search by
+ * project. Also provides a simple KB text search over .matrixos/projects/
+ * <slug>/kb/.
+ */
+export interface ProjectMemoryOptions {
+    cwd?: string;
+}
+export interface KbDocument {
+    readonly path: string;
+    readonly content: string;
+}
+export interface ProjectSearchResult {
+    readonly project: string;
+    readonly source: "kb" | "episode";
+    readonly path?: string;
+    readonly summary?: string;
+    readonly content?: string;
+    readonly score: number;
+}
+export declare function tagWithProject(metadata?: Record<string, unknown>, projectSlug?: string, cwd?: string): Record<string, unknown>;
+export declare function isProjectEpisode(ep: {
+    metadata?: Record<string, unknown> | null;
+}, projectSlug?: string, cwd?: string): boolean;
+export declare function listKbDocuments(projectSlug: string, cwd?: string): KbDocument[];
+export declare function searchKb(projectSlug: string, query: string, cwd?: string): ProjectSearchResult[];
+export declare function searchProject(query: string, options?: {
+    projectSlug?: string;
+    cwd?: string;
+    memoryStore?: any;
+}): Promise<ProjectSearchResult[]>;
+export declare function addKbDocument(projectSlug: string, filename: string, content: string, cwd?: string): string;

package/package.json

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