open-multi-agent-kit 0.78.5 → 0.78.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +64 -0
- package/MATURITY.md +2 -2
- package/README.md +20 -5
- package/dist/brand/night-city.theme.json +80 -0
- package/dist/brand/palette.d.ts +73 -177
- package/dist/brand/palette.js +115 -39
- package/dist/brand/rust-forge.theme.json +216 -0
- package/dist/brand/theme-compiled.d.ts +61 -0
- package/dist/brand/theme-compiled.js +241 -0
- package/dist/brand/theme.js +50 -37
- package/dist/cli/release-promotion-gate.d.ts +8 -1
- package/dist/cli/release-promotion-gate.js +23 -11
- package/dist/cli/root.d.ts +1 -0
- package/dist/cli/root.js +2 -1
- package/dist/cli/theme/index.d.ts +11 -2
- package/dist/cli/theme/index.js +6 -1
- package/dist/cli/theme/oklab-quantize.d.ts +29 -0
- package/dist/cli/theme/oklab-quantize.js +105 -0
- package/dist/cli/theme/render-table.d.ts +59 -0
- package/dist/cli/theme/render-table.js +112 -0
- package/dist/cli/theme/status-frame.d.ts +10 -0
- package/dist/cli/theme/status-frame.js +22 -0
- package/dist/cli/theme/terminal-capability.d.ts +6 -1
- package/dist/cli/theme/terminal-capability.js +20 -4
- package/dist/cli/theme/theme-doc.d.ts +22 -0
- package/dist/cli/theme/theme-doc.js +97 -0
- package/dist/cli/theme/theme-registry.js +39 -18
- package/dist/cli/theme/tier-explain.d.ts +21 -0
- package/dist/cli/theme/tier-explain.js +60 -0
- package/dist/cli/ui/green-rain-renderer.js +3 -2
- package/dist/cli/ui/neon-grid-renderer.js +4 -3
- package/dist/cli/ui/rust-forge-renderer.js +17 -3
- package/dist/cli/ui/system24-renderer.d.ts +18 -1
- package/dist/cli/ui/system24-renderer.js +39 -16
- package/dist/cli/v2/chat-repl.js +3 -1
- package/dist/cli/v2/cli-v2-skeleton.d.ts +6 -0
- package/dist/cli/v2/cli-v2-skeleton.js +121 -9
- package/dist/cli/v2/interactive-prompt.d.ts +1 -0
- package/dist/cli/v2/interactive-prompt.js +6 -2
- package/dist/commands/chat/core.js +2 -2
- package/dist/commands/chat/runtime.js +2 -0
- package/dist/commands/chat/utils.js +12 -4
- package/dist/commands/cockpit/render.js +102 -64
- package/dist/commands/cockpit/utils.d.ts +2 -0
- package/dist/commands/design.js +18 -16
- package/dist/commands/doctor/checks.d.ts +0 -1
- package/dist/commands/doctor/checks.js +1 -36
- package/dist/commands/doctor/report.js +0 -11
- package/dist/commands/init/content.d.ts +1 -1
- package/dist/commands/init/content.js +3 -11
- package/dist/commands/init.js +2 -2
- package/dist/commands/mcp/config.d.ts +32 -0
- package/dist/commands/mcp/config.js +264 -0
- package/dist/commands/mcp/doctor-fix.d.ts +12 -0
- package/dist/commands/mcp/doctor-fix.js +261 -0
- package/dist/commands/mcp/doctor.d.ts +55 -0
- package/dist/commands/mcp/doctor.js +401 -0
- package/dist/commands/mcp/list.d.ts +1 -0
- package/dist/commands/mcp/list.js +56 -0
- package/dist/commands/mcp/shared.d.ts +47 -0
- package/dist/commands/mcp/shared.js +192 -0
- package/dist/commands/mcp/test.d.ts +5 -0
- package/dist/commands/mcp/test.js +457 -0
- package/dist/commands/mcp.d.ts +8 -104
- package/dist/commands/mcp.js +5 -1603
- package/dist/contracts/proof.d.ts +1 -1
- package/dist/goal/control-loop.d.ts +15 -0
- package/dist/goal/control-loop.js +39 -5
- package/dist/hud/render.d.ts +2 -0
- package/dist/hud/render.js +7 -1
- package/dist/mcp/secret-scanner.d.ts +6 -0
- package/dist/mcp/secret-scanner.js +44 -11
- package/dist/memory/graph-delta-log.d.ts +137 -0
- package/dist/memory/graph-delta-log.js +650 -0
- package/dist/memory/graph-viewer.js +13 -32
- package/dist/memory/local-graph-memory-store.d.ts +36 -3
- package/dist/memory/local-graph-memory-store.js +255 -10
- package/dist/orchestration/log-streamer.js +13 -8
- package/dist/orchestration/routing.d.ts +4 -0
- package/dist/orchestration/routing.js +28 -3
- package/dist/orchestration/state-persister.js +8 -1
- package/dist/providers/anthropic-messages-runner.d.ts +17 -0
- package/dist/providers/anthropic-messages-runner.js +197 -0
- package/dist/providers/model-registry.d.ts +1 -1
- package/dist/providers/model-registry.js +37 -3
- package/dist/providers/provider-runtime.js +27 -11
- package/dist/providers/thinking-levels.js +4 -1
- package/dist/providers/types.d.ts +3 -3
- package/dist/runtime/contracts/weakness-remediation.d.ts +11 -1
- package/dist/runtime/contracts/weakness-remediation.js +9 -1
- package/dist/runtime/router-v2-scoring.d.ts +8 -3
- package/dist/runtime/router-v2-scoring.js +27 -22
- package/dist/runtime/runtime-router.d.ts +5 -0
- package/dist/runtime/runtime-router.js +40 -8
- package/dist/runtime/sandbox-profile.d.ts +29 -0
- package/dist/runtime/sandbox-profile.js +101 -0
- package/dist/runtime/slash-commands.js +300 -2
- package/dist/runtime/tool-dispatch-contracts.d.ts +15 -0
- package/dist/runtime/tool-dispatch-contracts.js +12 -0
- package/dist/runtime/weights-config.d.ts +90 -0
- package/dist/runtime/weights-config.js +249 -0
- package/dist/schema/envelope.schema.d.ts +18 -18
- package/dist/schema/evidence.schema.d.ts +2 -2
- package/dist/schema/proof-bundle.schema.d.ts +6 -6
- package/dist/schema/proof-bundle.schema.js +0 -1
- package/dist/schema/provider.schema.d.ts +2 -2
- package/dist/schema/run-manifest.schema.d.ts +16 -16
- package/dist/theme/ansi.js +9 -2
- package/dist/theme/extended-palette.d.ts +85 -0
- package/dist/theme/extended-palette.js +108 -0
- package/dist/theme/layout.js +29 -8
- package/dist/theme/metrics.js +5 -5
- package/dist/theme/parallel.js +25 -15
- package/dist/ui/omk-sigil.js +5 -14
- package/dist/ui/omk-working-sweep.js +5 -15
- package/dist/util/chat-agent-mode.d.ts +11 -0
- package/dist/util/chat-agent-mode.js +41 -8
- package/dist/util/chat-cockpit.d.ts +9 -0
- package/dist/util/chat-cockpit.js +77 -20
- package/dist/util/fs/core.d.ts +5 -0
- package/dist/util/fs/core.js +35 -0
- package/dist/util/fs/internal.d.ts +14 -0
- package/dist/util/fs/internal.js +169 -0
- package/dist/util/fs/kimi-sync.d.ts +41 -0
- package/dist/util/fs/kimi-sync.js +495 -0
- package/dist/util/fs/logo.d.ts +2 -0
- package/dist/util/fs/logo.js +78 -0
- package/dist/util/fs/manifest.d.ts +6 -0
- package/dist/util/fs/manifest.js +40 -0
- package/dist/util/fs/mcp-diagnose.d.ts +15 -0
- package/dist/util/fs/mcp-diagnose.js +204 -0
- package/dist/util/fs/mcp-runtime-config.d.ts +23 -0
- package/dist/util/fs/mcp-runtime-config.js +412 -0
- package/dist/util/fs/paths.d.ts +13 -0
- package/dist/util/fs/paths.js +82 -0
- package/dist/util/fs/preflight.d.ts +27 -0
- package/dist/util/fs/preflight.js +271 -0
- package/dist/util/fs.d.ts +8 -128
- package/dist/util/fs.js +8 -1757
- package/dist/util/terminal-layout.js +5 -1
- package/dist/util/version.js +2 -1
- package/docs/2026-06-10/critical-issues.md +20 -0
- package/docs/2026-06-10/improvements.md +14 -0
- package/docs/2026-06-10/init-checklist.md +25 -0
- package/docs/2026-06-10/plan.md +20 -0
- package/docs/2026-06-11/critical-issues.md +20 -0
- package/docs/2026-06-11/improvements.md +14 -0
- package/docs/2026-06-11/init-checklist.md +25 -0
- package/docs/2026-06-11/plan.md +20 -0
- package/docs/ARCHITECTURE_ANALYSIS_CODEGRAPH.md +223 -0
- package/docs/adr/0001-no-native-rust-lane.md +52 -0
- package/docs/codex-oauth-setup.md +14 -0
- package/docs/decisions/2026-06-10-git-history-bloat.md +61 -0
- package/docs/decisions/ADR-theme-dark-only-assets.md +43 -0
- package/docs/getting-started.md +1 -1
- package/docs/headroom-omk-final-summary.md +188 -0
- package/docs/headroom-omk-integration.md +394 -0
- package/docs/headroom-omk-setup-guide.md +422 -0
- package/docs/headroom-omk-usage-examples.md +371 -0
- package/docs/provider-maturity.md +1 -1
- package/docs/versioning.md +3 -3
- package/package.json +10 -10
- package/readmeasset/.npmignore +2 -0
- package/readmeasset/ASSET_INDEX.md +7 -5
- package/readmeasset/ASSET_PROVENANCE.md +21 -5
- package/readmeasset/omk-control-surfaces.svg +55 -0
- package/readmeasset/omk-core-loop.svg +1 -0
- package/readmeasset/omk-logo-mark.svg +1 -0
- package/readmeasset/omk-release-assertions.svg +51 -0
- package/dist/native/linux-x64/omk-safety +0 -0
- package/dist/util/native-safety.d.ts +0 -28
- package/dist/util/native-safety.js +0 -118
- package/templates/skills/agents/omk-adaptorch-orchestration-review/SKILL.md +0 -52
- package/templates/skills/kimi/mcp-install/SKILL.md +0 -66
- package/templates/skills/kimi/omk-adaptorch-orchestration-review/SKILL.md +0 -52
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
export type NativeSafetySource = "env" | "bundled" | "target-release" | "target-debug" | "missing";
|
|
2
|
-
export type NativeSafetyStatus = "ok" | "warn" | "info";
|
|
3
|
-
export interface NativeSafetyResolution {
|
|
4
|
-
ok: boolean;
|
|
5
|
-
source: NativeSafetySource;
|
|
6
|
-
path: string | null;
|
|
7
|
-
platformArch: string;
|
|
8
|
-
builtFromSource: boolean;
|
|
9
|
-
message: string;
|
|
10
|
-
}
|
|
11
|
-
export interface NativeSafetySelfTest extends NativeSafetyResolution {
|
|
12
|
-
status: NativeSafetyStatus;
|
|
13
|
-
checks: number | null;
|
|
14
|
-
}
|
|
15
|
-
export interface NativeSafetyOptions {
|
|
16
|
-
root?: string;
|
|
17
|
-
packageRoot?: string;
|
|
18
|
-
env?: NodeJS.ProcessEnv;
|
|
19
|
-
platform?: NodeJS.Platform | string;
|
|
20
|
-
arch?: string;
|
|
21
|
-
timeoutMs?: number;
|
|
22
|
-
}
|
|
23
|
-
export declare function getNativePlatformArchKey(platform?: NodeJS.Platform | string, arch?: string): string;
|
|
24
|
-
export declare function getOmkSafetyBinaryName(platform?: NodeJS.Platform | string): string;
|
|
25
|
-
export declare function getOmkPackageRoot(): string;
|
|
26
|
-
export declare function getBundledOmkSafetyBinaryPath(packageRoot?: string, platform?: NodeJS.Platform | string, arch?: string): string;
|
|
27
|
-
export declare function resolveOmkSafetyNative(options?: NativeSafetyOptions): Promise<NativeSafetyResolution>;
|
|
28
|
-
export declare function runOmkSafetySelfTest(options?: NativeSafetyOptions): Promise<NativeSafetySelfTest>;
|
|
@@ -1,118 +0,0 @@
|
|
|
1
|
-
import { constants } from "node:fs";
|
|
2
|
-
import { access } from "node:fs/promises";
|
|
3
|
-
import { dirname, isAbsolute, join } from "node:path";
|
|
4
|
-
import { fileURLToPath } from "node:url";
|
|
5
|
-
import { runShell } from "./shell.js";
|
|
6
|
-
const SUPPORTED_PLATFORMS = new Set(["linux", "darwin", "win32"]);
|
|
7
|
-
const SUPPORTED_ARCHES = new Set(["x64", "arm64"]);
|
|
8
|
-
export function getNativePlatformArchKey(platform = process.platform, arch = process.arch) {
|
|
9
|
-
return `${platform}-${arch}`;
|
|
10
|
-
}
|
|
11
|
-
export function getOmkSafetyBinaryName(platform = process.platform) {
|
|
12
|
-
return platform === "win32" ? "omk-safety.exe" : "omk-safety";
|
|
13
|
-
}
|
|
14
|
-
export function getOmkPackageRoot() {
|
|
15
|
-
return join(dirname(fileURLToPath(import.meta.url)), "..", "..");
|
|
16
|
-
}
|
|
17
|
-
export function getBundledOmkSafetyBinaryPath(packageRoot = getOmkPackageRoot(), platform = process.platform, arch = process.arch) {
|
|
18
|
-
return join(packageRoot, "dist", "native", getNativePlatformArchKey(platform, arch), getOmkSafetyBinaryName(platform));
|
|
19
|
-
}
|
|
20
|
-
function isSupportedPlatformArch(platform, arch) {
|
|
21
|
-
return SUPPORTED_PLATFORMS.has(platform) && SUPPORTED_ARCHES.has(arch);
|
|
22
|
-
}
|
|
23
|
-
function normalizeEnvPath(rawPath) {
|
|
24
|
-
return isAbsolute(rawPath) ? rawPath : join(process.cwd(), rawPath);
|
|
25
|
-
}
|
|
26
|
-
function getNativeSafetyCandidates(options = {}) {
|
|
27
|
-
const env = options.env ?? process.env;
|
|
28
|
-
const packageRoot = options.packageRoot ?? getOmkPackageRoot();
|
|
29
|
-
const root = options.root ?? packageRoot;
|
|
30
|
-
const platform = options.platform ?? process.platform;
|
|
31
|
-
const arch = options.arch ?? process.arch;
|
|
32
|
-
const binaryName = getOmkSafetyBinaryName(platform);
|
|
33
|
-
const candidates = [];
|
|
34
|
-
if (env.OMK_SAFETY_BIN) {
|
|
35
|
-
candidates.push({ source: "env", path: normalizeEnvPath(env.OMK_SAFETY_BIN), builtFromSource: false });
|
|
36
|
-
}
|
|
37
|
-
if (isSupportedPlatformArch(platform, arch)) {
|
|
38
|
-
candidates.push({ source: "bundled", path: getBundledOmkSafetyBinaryPath(packageRoot, platform, arch), builtFromSource: false });
|
|
39
|
-
}
|
|
40
|
-
candidates.push({ source: "target-release", path: join(root, "target", "release", binaryName), builtFromSource: true });
|
|
41
|
-
candidates.push({ source: "target-debug", path: join(root, "target", "debug", binaryName), builtFromSource: true });
|
|
42
|
-
return candidates;
|
|
43
|
-
}
|
|
44
|
-
async function fileExists(path) {
|
|
45
|
-
try {
|
|
46
|
-
await access(path, constants.F_OK);
|
|
47
|
-
return true;
|
|
48
|
-
}
|
|
49
|
-
catch {
|
|
50
|
-
return false;
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
export async function resolveOmkSafetyNative(options = {}) {
|
|
54
|
-
const platform = options.platform ?? process.platform;
|
|
55
|
-
const arch = options.arch ?? process.arch;
|
|
56
|
-
const platformArch = getNativePlatformArchKey(platform, arch);
|
|
57
|
-
for (const candidate of getNativeSafetyCandidates(options)) {
|
|
58
|
-
if (await fileExists(candidate.path)) {
|
|
59
|
-
return {
|
|
60
|
-
ok: true,
|
|
61
|
-
source: candidate.source,
|
|
62
|
-
path: candidate.path,
|
|
63
|
-
platformArch,
|
|
64
|
-
builtFromSource: candidate.builtFromSource,
|
|
65
|
-
message: `native omk-safety resolved via ${candidate.source}: ${candidate.path}`,
|
|
66
|
-
};
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
return {
|
|
70
|
-
ok: false,
|
|
71
|
-
source: "missing",
|
|
72
|
-
path: null,
|
|
73
|
-
platformArch,
|
|
74
|
-
builtFromSource: false,
|
|
75
|
-
message: `native omk-safety binary not bundled for ${platformArch} — run npm run native:build or use TS fallback`,
|
|
76
|
-
};
|
|
77
|
-
}
|
|
78
|
-
export async function runOmkSafetySelfTest(options = {}) {
|
|
79
|
-
const resolution = await resolveOmkSafetyNative(options);
|
|
80
|
-
if (!resolution.path) {
|
|
81
|
-
return { ...resolution, status: "info", checks: null };
|
|
82
|
-
}
|
|
83
|
-
const result = await runShell(resolution.path, ["self-test"], {
|
|
84
|
-
cwd: options.root ?? options.packageRoot ?? getOmkPackageRoot(),
|
|
85
|
-
timeout: options.timeoutMs ?? 5000,
|
|
86
|
-
});
|
|
87
|
-
if (result.failed) {
|
|
88
|
-
return {
|
|
89
|
-
...resolution,
|
|
90
|
-
ok: false,
|
|
91
|
-
status: "warn",
|
|
92
|
-
checks: null,
|
|
93
|
-
message: `self-test failed for ${resolution.path}`,
|
|
94
|
-
};
|
|
95
|
-
}
|
|
96
|
-
try {
|
|
97
|
-
const parsed = JSON.parse(result.stdout);
|
|
98
|
-
if (parsed.ok === true && typeof parsed.checks === "number") {
|
|
99
|
-
const prefix = resolution.builtFromSource ? "self-test passed from source build" : "self-test passed";
|
|
100
|
-
return {
|
|
101
|
-
...resolution,
|
|
102
|
-
status: "ok",
|
|
103
|
-
checks: parsed.checks,
|
|
104
|
-
message: `${prefix} (${parsed.checks} checks): ${resolution.path}`,
|
|
105
|
-
};
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
catch {
|
|
109
|
-
// fall through to warning below
|
|
110
|
-
}
|
|
111
|
-
return {
|
|
112
|
-
...resolution,
|
|
113
|
-
ok: false,
|
|
114
|
-
status: "warn",
|
|
115
|
-
checks: null,
|
|
116
|
-
message: `self-test returned unexpected output for ${resolution.path}`,
|
|
117
|
-
};
|
|
118
|
-
}
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: omk-adaptorch-orchestration-review
|
|
3
|
-
description: Review AdaptOrch, OMK, and similar DAG multi-agent orchestration frameworks. Use when assessing DAG node responsibility, dependency edges, worker write authority, fallback/retry/timeout/evidence gates, review/merge boundaries, or reproducible decision traces.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Orchestration Review
|
|
7
|
-
|
|
8
|
-
Use this for read-only architecture review of DAG runtimes, multi-agent pipelines, worktree teams, schedulers, and evidence-gated repair loops.
|
|
9
|
-
|
|
10
|
-
## Checklist
|
|
11
|
-
|
|
12
|
-
### DAG node contract
|
|
13
|
-
|
|
14
|
-
- Verify each node has one responsibility, one owner role, and one observable outcome.
|
|
15
|
-
- Verify inputs, outputs, side effects, and acceptance evidence are explicit.
|
|
16
|
-
- Flag nodes that mix planning, implementation, review, and merge authority without a gate.
|
|
17
|
-
|
|
18
|
-
### Dependency edges
|
|
19
|
-
|
|
20
|
-
- Confirm each edge represents a real data dependency, verification dependency, or authority handoff.
|
|
21
|
-
- Flag ordering-only edges that do not protect correctness or safety.
|
|
22
|
-
- Check that failed evidence blocks dependent nodes or routes them to repair.
|
|
23
|
-
|
|
24
|
-
### Worker authority
|
|
25
|
-
|
|
26
|
-
- Confirm each worker has bounded write scope and cannot overwrite unrelated lanes.
|
|
27
|
-
- Check shared-file ownership, merge points, and escalation paths.
|
|
28
|
-
- Require reviewer/merger separation for risky or cross-cutting changes.
|
|
29
|
-
|
|
30
|
-
### Resilience and gates
|
|
31
|
-
|
|
32
|
-
- Look for explicit retry limits, timeout presets, fallback routes, stop conditions, and evidence gates.
|
|
33
|
-
- Confirm fallback does not silently weaken acceptance criteria.
|
|
34
|
-
- Check that blocked, skipped, failed, and complete states are distinct.
|
|
35
|
-
|
|
36
|
-
### Decision trace
|
|
37
|
-
|
|
38
|
-
- Confirm routing, scheduler decisions, tool calls, evidence, retries, and final verdict are replayable.
|
|
39
|
-
- Flag missing timestamps, inputs, outputs, or rationale needed to reproduce a run.
|
|
40
|
-
|
|
41
|
-
## Output
|
|
42
|
-
|
|
43
|
-
```txt
|
|
44
|
-
Verdict:
|
|
45
|
-
DAG node issues:
|
|
46
|
-
Dependency edge issues:
|
|
47
|
-
Worker authority risks:
|
|
48
|
-
Missing gates:
|
|
49
|
-
Decision trace gaps:
|
|
50
|
-
Recommended fixes:
|
|
51
|
-
Files/artifacts reviewed:
|
|
52
|
-
```
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: mcp-install
|
|
3
|
-
description: Install, validate, and manage MCP servers for OMK using the curated catalog and parallel processing.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# MCP Server Installation Skill
|
|
7
|
-
|
|
8
|
-
Guide for adding MCP servers to an OMK project using the built-in catalog and parallel orchestration.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
```bash
|
|
13
|
-
# List configured MCP servers
|
|
14
|
-
omk mcp list
|
|
15
|
-
|
|
16
|
-
# Diagnose all MCP servers
|
|
17
|
-
omk mcp doctor
|
|
18
|
-
|
|
19
|
-
# Diagnose a specific server
|
|
20
|
-
omk mcp doctor <server-name>
|
|
21
|
-
|
|
22
|
-
# Install a single MCP server
|
|
23
|
-
omk mcp install <name> <command> [args...]
|
|
24
|
-
|
|
25
|
-
# Remove a server from project-local config
|
|
26
|
-
omk mcp remove <name>
|
|
27
|
-
|
|
28
|
-
# Sync global MCP servers into project
|
|
29
|
-
omk mcp sync-global
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
## Curated Catalog
|
|
33
|
-
|
|
34
|
-
OMK ships with a verified catalog in `src/mcp/server-catalog.ts` (or accessible via the runtime).
|
|
35
|
-
Recommended categories:
|
|
36
|
-
|
|
37
|
-
- **reasoning**: `sequential-thinking` — structured problem solving
|
|
38
|
-
- **memory**: `memory` — persistent knowledge graph
|
|
39
|
-
- **docs**: `pdf` — PDF text extraction
|
|
40
|
-
- **web**: `puppeteer` — browser automation
|
|
41
|
-
- **devtools**: `filesystem`, `sqlite` — file and database access
|
|
42
|
-
- **ops**: `railway` — remote Railway MCP; `supabase` — database management and edge functions
|
|
43
|
-
|
|
44
|
-
## Parallel Installation
|
|
45
|
-
|
|
46
|
-
When installing multiple servers (e.g., during `omk init`), OMK uses `Promise.all` for parallel setup.
|
|
47
|
-
Agents and hooks can also trigger bulk installs:
|
|
48
|
-
|
|
49
|
-
1. **Agent lane**: explorer validates which servers are needed
|
|
50
|
-
2. **Coder lane**: writes the MCP JSON entries
|
|
51
|
-
3. **QA lane**: runs `omk mcp doctor` to verify each server
|
|
52
|
-
4. **Hook**: `post-init-mcp.sh` runs non-blocking validation after init
|
|
53
|
-
|
|
54
|
-
## Rules
|
|
55
|
-
|
|
56
|
-
1. Prefer `npx -y <package>` so no global install is required.
|
|
57
|
-
2. Use `${PROJECT_ROOT}` and `${DB_PATH}` placeholders in catalog entries; they are resolved at install time.
|
|
58
|
-
3. Do not commit secrets in `mcp.json` env values.
|
|
59
|
-
4. Run `omk mcp doctor` after adding servers to confirm they start.
|
|
60
|
-
5. If a server fails to start, check `startup_timeout_sec` and network access.
|
|
61
|
-
|
|
62
|
-
## When to Use
|
|
63
|
-
|
|
64
|
-
- During `omk init` when selecting additional MCP servers.
|
|
65
|
-
- When a task requires a new capability (browser, PDF, database).
|
|
66
|
-
- Before reporting an MCP issue, run `omk mcp doctor --json` for structured evidence.
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: omk-adaptorch-orchestration-review
|
|
3
|
-
description: Review AdaptOrch, OMK, and similar DAG multi-agent orchestration frameworks. Use when assessing DAG node responsibility, dependency edges, worker write authority, fallback/retry/timeout/evidence gates, review/merge boundaries, or reproducible decision traces.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Orchestration Review
|
|
7
|
-
|
|
8
|
-
Use this for read-only architecture review of DAG runtimes, multi-agent pipelines, worktree teams, schedulers, and evidence-gated repair loops.
|
|
9
|
-
|
|
10
|
-
## Checklist
|
|
11
|
-
|
|
12
|
-
### DAG node contract
|
|
13
|
-
|
|
14
|
-
- Verify each node has one responsibility, one owner role, and one observable outcome.
|
|
15
|
-
- Verify inputs, outputs, side effects, and acceptance evidence are explicit.
|
|
16
|
-
- Flag nodes that mix planning, implementation, review, and merge authority without a gate.
|
|
17
|
-
|
|
18
|
-
### Dependency edges
|
|
19
|
-
|
|
20
|
-
- Confirm each edge represents a real data dependency, verification dependency, or authority handoff.
|
|
21
|
-
- Flag ordering-only edges that do not protect correctness or safety.
|
|
22
|
-
- Check that failed evidence blocks dependent nodes or routes them to repair.
|
|
23
|
-
|
|
24
|
-
### Worker authority
|
|
25
|
-
|
|
26
|
-
- Confirm each worker has bounded write scope and cannot overwrite unrelated lanes.
|
|
27
|
-
- Check shared-file ownership, merge points, and escalation paths.
|
|
28
|
-
- Require reviewer/merger separation for risky or cross-cutting changes.
|
|
29
|
-
|
|
30
|
-
### Resilience and gates
|
|
31
|
-
|
|
32
|
-
- Look for explicit retry limits, timeout presets, fallback routes, stop conditions, and evidence gates.
|
|
33
|
-
- Confirm fallback does not silently weaken acceptance criteria.
|
|
34
|
-
- Check that blocked, skipped, failed, and complete states are distinct.
|
|
35
|
-
|
|
36
|
-
### Decision trace
|
|
37
|
-
|
|
38
|
-
- Confirm routing, scheduler decisions, tool calls, evidence, retries, and final verdict are replayable.
|
|
39
|
-
- Flag missing timestamps, inputs, outputs, or rationale needed to reproduce a run.
|
|
40
|
-
|
|
41
|
-
## Output
|
|
42
|
-
|
|
43
|
-
```txt
|
|
44
|
-
Verdict:
|
|
45
|
-
DAG node issues:
|
|
46
|
-
Dependency edge issues:
|
|
47
|
-
Worker authority risks:
|
|
48
|
-
Missing gates:
|
|
49
|
-
Decision trace gaps:
|
|
50
|
-
Recommended fixes:
|
|
51
|
-
Files/artifacts reviewed:
|
|
52
|
-
```
|