opencode-matrixx 2.6.0 → 2.6.1

package/README.md

@@ -100,6 +100,9 @@ Create `matrixx.jsonc` in your project root:
 }
 ```
 
+> **Full example:** See [`matrixx.example.jsonc`](./matrixx.example.jsonc) — a fully annotated reference covering every configuration parameter (agents, categories, **headroom**, **context-mode** (external), DCP, RTK, security, tmux, assembly, evolution, and more) with inline comments and defaults. Copy the sections you need into your project `.opencode/matrixx.jsonc` or user `~/.config/opencode/matrixx.jsonc` (both support JSONC comments).
+> Full guide: [Configuration →](docs/configurations.md) · [Context Management (5 layers) →](docs/context-management.md)
+
 ### Authenticate
 
 ```bash

package/dist/cli/doctor/checks/context-mode.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const contextModeCheck: DoctorCheck;

package/dist/cli/doctor/checks/dcp.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const dcpCheck: DoctorCheck;

package/dist/cli/doctor/checks/docker.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const dockerCheck: DoctorCheck;

package/dist/cli/doctor/checks/headroom.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const headroomCheck: DoctorCheck;

package/dist/cli/doctor/checks/helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function readMatrixxConfig(): Record<string, unknown> | null;
+export declare function getNested<T>(obj: Record<string, unknown> | null, path: string): T | undefined;

package/dist/cli/doctor/checks/index.d.ts

@@ -4,7 +4,13 @@ export declare function getChecksByCategory(category: string): DoctorCheck[];
 export declare function getCategories(): string[];
 export { authCheck } from "./auth";
 export { configValidationCheck } from "./config";
+export { contextModeCheck } from "./context-mode";
+export { dcpCheck } from "./dcp";
+export { dockerCheck } from "./docker";
+export { headroomCheck } from "./headroom";
 export { mcpPrerequisitesCheck } from "./mcp";
 export { optionalToolsCheck } from "./optional";
 export { pluginInstallationCheck } from "./plugin";
+export { rtkCheck } from "./rtk";
 export { runtimeDepsCheck } from "./runtime";
+export { tmuxCheck } from "./tmux";

package/dist/cli/doctor/checks/rtk.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const rtkCheck: DoctorCheck;

package/dist/cli/doctor/checks/tmux.d.ts

@@ -0,0 +1,2 @@
+import type { DoctorCheck } from "../types";
+export declare const tmuxCheck: DoctorCheck;

package/dist/cli/doctor/types.d.ts

@@ -6,7 +6,7 @@ export interface CheckResult {
     category?: string;
     detail?: string;
 }
-export type CheckCategory = "installation" | "configuration" | "authentication" | "dependencies" | "tools" | "updates";
+export type CheckCategory = "installation" | "configuration" | "authentication" | "dependencies" | "tools" | "integrations" | "updates";
 export interface DoctorCheck {
     name: string;
     category: CheckCategory;

package/dist/cli/index.d.ts

@@ -5,6 +5,7 @@
  * Commands:
  *   doctor    - Environment diagnostics and health checks
  *   install   - Interactive setup wizard (--no-tui for CI)
+ *   setup     - Standalone setup wizard for deps + matrixx.jsonc generation
  *   version   - Display version information
  *   help      - Display help information
  */

package/dist/cli/setup/config-writer.d.ts

@@ -0,0 +1,12 @@
+import { type MatrixxConfig } from "../../config/schema/matrixx-config";
+import type { SetupState } from "./types";
+export declare function resolveMatrixxConfigPath(): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};
+export declare function buildMatrixxConfig(state: SetupState, existing: MatrixxConfig | null): MatrixxConfig;
+export declare function previewDiff(existing: string, next: string): string;
+export declare function writeMatrixxConfig(targetPath: string, config: MatrixxConfig, opts: {
+    dryRun: boolean;
+    backup: boolean;
+}): Promise<void>;

package/dist/cli/setup/config-writer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/setup/constants.d.ts

@@ -0,0 +1,8 @@
+import type { Platform } from "./types";
+export declare const REQUIRED_DEPS: readonly ["bun", "opencode", "git"];
+export declare const OPTIONAL_DEPS: readonly ["headroom", "rtk", "dcp", "gitleaks", "ast-grep", "playwright"];
+export type InstallCommandMap = Record<string, Record<Platform | "all", string> | Record<string, string>>;
+export declare const PLATFORM_INSTALL_COMMANDS: Record<string, Partial<Record<Platform | "all", string>>>;
+export declare function getDcpInstallHint(): string;
+export declare function configDirHint(): string;
+export declare function dcpPluginDirHint(): string;

package/dist/cli/setup/deps.d.ts

@@ -0,0 +1,8 @@
+import { type DepStatus, type Platform } from "./types";
+export declare function isBunVersionOk(found: string): boolean;
+export declare function isOpenCodeVersionOk(found: string): boolean;
+export declare function getPlatform(): Platform;
+export declare function getInstallCommand(dep: string, platform: Platform): string;
+export declare function checkRequiredDeps(): DepStatus[];
+export declare function checkOptionalDeps(): DepStatus[];
+export declare function formatDepReport(statuses: DepStatus[]): string;

package/dist/cli/setup/deps.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/setup/index.d.ts

@@ -0,0 +1,8 @@
+export { PLATFORM_INSTALL_COMMANDS } from "./constants";
+export { checkOptionalDeps, checkRequiredDeps, formatDepReport, getInstallCommand, getPlatform, isBunVersionOk, isOpenCodeVersionOk } from "./deps";
+export { runSetupPrompts } from "./prompts";
+export type { DepStatus, Platform, SetupState } from "./types";
+export declare function executeSetup(opts: {
+    dryRun: boolean;
+    yes: boolean;
+}): Promise<string>;

package/dist/cli/setup/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/setup/opencode-sync.d.ts

@@ -0,0 +1,9 @@
+import type { SetupState } from "./types";
+export declare function resolveOpencodeConfigPath(): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};
+export declare function syncOpencodePlugins(state: SetupState, opts: {
+    dryRun: boolean;
+}): Promise<void>;
+export declare function hasContextModePlugin(plugins: string[]): boolean;

package/dist/cli/setup/opencode-sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/setup/prompts.d.ts

@@ -0,0 +1,4 @@
+import type { DepStatus, SetupState } from "./types";
+export declare function runSetupPrompts(deps: DepStatus[], opts: {
+    yes: boolean;
+}): Promise<SetupState>;

package/dist/cli/setup/prompts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/setup/types.d.ts

@@ -0,0 +1,26 @@
+export type Platform = "darwin" | "linux" | "win32";
+export type DepStatus = {
+    name: string;
+    required: boolean;
+    found: boolean;
+    version?: string;
+    installHint: string;
+};
+export type SetupState = {
+    taskSystem: boolean;
+    headroom: {
+        enabled: boolean;
+        proxyUrl?: string;
+        project?: string;
+    };
+    rtk: {
+        enabled: boolean;
+        binaryPath?: string;
+    };
+    dcp: {
+        enabled: boolean;
+    };
+    contextMode: boolean;
+};
+export declare const BUN_REQUIRED = "1.4.0";
+export declare const OPENCODE_MIN = "1.0.150";