open-multi-agent-kit 0.78.3 → 0.78.6

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/CHANGELOG.md CHANGED
@@ -1,5 +1,43 @@
1
1
  # Changelog
2
2
 
3
+ ## v0.78.6 — exclude AdaptOrch skills and MCP install template from package (2026-06-09)
4
+
5
+ ### Changed
6
+
7
+ - Added `.npmignore` exclusions so the published package no longer ships:
8
+ - `templates/skills/**/omk-adaptorch-orchestration-review/`
9
+ - `templates/skills/**/mcp-install/`
10
+ - Core AdaptOrch topology routing and MCP runtime code remain in the package;
11
+ only the optional skill templates are removed from the npm tarball.
12
+
13
+ ### Notes
14
+
15
+ - This remains a pre-1.0 release line.
16
+ - Stable release claims are still withheld pending exact-tag CI, live benchmark pass,
17
+ and sandbox violation count equal to zero.
18
+
19
+ ## v0.78.5 — release truthfulness, CLI bin restoration, and gate hardening (2026-06-09)
20
+
21
+ ### Fixed
22
+
23
+ - Restored the public `omk` CLI bin in `package.json` and `package-lock.json`.
24
+ - Aligned package, lockfile, docs, provider maturity notes, and release-truthfulness proof metadata to `0.78.5`.
25
+ - Reworked `version:check` to derive the expected package version from `package.json`.
26
+ - Extended `version:check` to validate required bins, docs, lockfile, schemas, and release-truthfulness proof metadata.
27
+ - Wired `release:check` to pass an explicit demo signal to the release promotion gate only after local package, smoke, proof, and audit gates pass.
28
+
29
+ ### Changed
30
+
31
+ - Stable release claims are withheld until exact-tag CI, live benchmark pass, and sandbox violation count equal to zero are available.
32
+ - `release:full` and `release:rc` now finish with the same explicit final release promotion gate as `release:check`.
33
+ - README release wording treats npm `latest` as release-truthful only after tagged workflow and registry verification both pass.
34
+
35
+ ### Notes
36
+
37
+ - This remains a pre-1.0 release line.
38
+ - The `v1.2` label is a runtime contract family, not an npm stable `1.x` release.
39
+ - `v0.78.4` was superseded by `v0.78.5` after benchmark shadow fixture gate repair.
40
+
3
41
  ## v0.78.2 — Regression Proof Matrix, deep interview, clipboard image paste, and README hardening (2026-06-09)
4
42
 
5
43
  ### Overview
package/MATURITY.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # OMK Command Maturity Matrix
2
2
 
3
3
  Last updated: 2026-06-07
4
- Current source version: v0.78.1 (`v1.2` runtime contract family)
4
+ Current source version: v0.78.6 (`v1.2` runtime contract family)
5
5
 
6
6
  | Level | Meaning |
7
7
  |-------|---------|
@@ -76,6 +76,6 @@ Regression Proof Matrix is a release-defense gate, not a stable-release claim. S
76
76
  | Native runtime safety | OMK owns the root-orchestrator direction, but native chat must still lock turn-risk inference, approval/sandbox propagation, authority resolution, provider health probes, and DeepSeek read-only enforcement before stable provider-neutral claims. | Treat `docs/native-root-runtime-hardening.md` and `.omk/specs/native-orchestrator-phase1/` as the active hardening contract. |
77
77
  | MCP diagnostics | `mcp list/doctor/test` exist; invalid project/global MCP JSON now fails visibly through diagnostics without exposing config contents. | Add machine-readable MCP JSON and structured failure categories for command resolution, timeout, permission, and server health. |
78
78
  | Skills and harness templates | `omk skill` exposes current core/TypeScript/review packs, while init templates document project MCP scope, runtime skills, portable `.agents/skills`, and run-scoped harness manifests. | Keep external-inspired skills compact, source-linked, and non-vendored; verify install/sync through `skill-command` tests and package audit. |
79
- | Release docs and site | README, CHANGELOG, MATURITY, ROADMAP, versioning docs, provider-maturity docs, package audit, and release-gate commands distinguish the `0.78.x` public package line from the `v1.2` runtime contract family while documenting alpha/experimental surfaces, current harness templates, provider limits, and the public project repository at `https://github.com/dmae97/open-multi-agent-kit`. | Treat `npm run release:check`, native safety packaging, tarball install smoke, and CI evidence on the exact commit as the publish/deploy gate before claiming `0.78.1` published or release-ready. |
79
+ | Release docs and site | README, CHANGELOG, MATURITY, ROADMAP, versioning docs, provider-maturity docs, package audit, and release-gate commands distinguish the `0.78.x` public package line from the `v1.2` runtime contract family while documenting alpha/experimental surfaces, current harness templates, provider limits, and the public project repository at `https://github.com/dmae97/open-multi-agent-kit`. | Treat `npm run release:check`, native safety packaging, tarball install smoke, and CI evidence on the exact commit as the publish/deploy gate before claiming `0.78.6` published or release-ready. |
80
80
  | Public proof bundles | `omk.proof-bundle.v1`, `npm run proof:check`, `npm run proof:index`, and ten scoped RC hardening bundles now cover no-Kimi, provider/doctor, fallback routing, native safety, contract/version, evidence-block, replay/inspect, and graph-audit axes. Proof integrity includes runId/commit/evidence/decision linkage and per-bundle `sha256sums.txt` artifact hashes. | Keep strengthening proof authenticity with sanitized repo-relative artifacts, non-empty known limitations, and broader provider fallback variants. |
81
81
  | Goal planner | Goal lifecycle exists, including continue, generated plan/evidence criteria, and verification. | Expand planner quality scoring and release evidence. |
package/README.md CHANGED
@@ -39,7 +39,7 @@ Use OMK when one coding agent is not enough: route Codex, OpenCode, Kimi, DeepSe
39
39
  - Teams that need MCP-scoped agent execution instead of unrestricted tool access.
40
40
  - Agent builders who want routing, fallback, evidence gates, telemetry, and replay.
41
41
 
42
- > Current package source target: `open-multi-agent-kit@0.78.1`.
42
+ > Current package source target: `open-multi-agent-kit@0.78.6`.
43
43
  > Public package name: `open-multi-agent-kit` (`@omk/cli` is not the active npm package).
44
44
  > Runtime contract family: `v1.2` (contract family, not a stable npm `1.x` release).
45
45
  > Release channel: `pre-1.0`.
@@ -63,8 +63,8 @@ omk chat
63
63
 
64
64
  ## Current release reality
65
65
 
66
- - The public npm line is `open-multi-agent-kit@0.78.x`. Published npm `latest` is `0.78.0`;
67
- source/target is `0.78.1` and is published only after the release workflow passes on the tagged commit.
66
+ - The public npm line is `open-multi-agent-kit@0.78.x`. The source target is `open-multi-agent-kit@0.78.6`;
67
+ treat npm `latest` as release-truthful only after the tagged release workflow and registry verification both pass.
68
68
  - The `v1.2` label in docs is a runtime contract family for the source tree, not a claim that
69
69
  an npm `1.2.x` stable release exists.
70
70
  - Provider support is intentionally uneven: Kimi remains the most mature authority path;
@@ -305,7 +305,7 @@ The npm package is intentionally package-safe:
305
305
  | Contract | Value |
306
306
  | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
307
307
  | Package | [`open-multi-agent-kit`](https://www.npmjs.com/package/open-multi-agent-kit) |
308
- | Version | `0.78.1` |
308
+ | Version | `0.78.6` |
309
309
  | Runtime contract family | `v1.2` |
310
310
  | Bins | `omk`, `omk-project-mcp`, `omk-acp`, `omk-mcp-host` |
311
311
  | Packaged docs | `README.md`, `docs/`, `SECURITY.md`, `ROADMAP.md`, `MATURITY.md`, `DESIGN.md` |
@@ -67,11 +67,14 @@ function makeAttemptStub(taskId, category, attemptNumber, rng, outcomeOverride)
67
67
  function makeTask(index, category, seed, omkVersion, treeHash, providerConfigHash) {
68
68
  const rng = seededRandom(seed + index * 7919);
69
69
  const taskId = `bench-${category}-${String(index).padStart(3, "0")}`;
70
- const expectedOutcome = pick(["success", "success", "failure", "fallback"], rng);
70
+ const expectedOutcome = category === "provider-failure-fallback" || category === "quota-auth-failure-fallback"
71
+ ? "fallback"
72
+ : "success";
71
73
  const attempts = [];
72
74
  const attemptCount = expectedOutcome === "fallback" ? 2 : 1;
73
75
  for (let i = 1; i <= attemptCount; i++) {
74
- attempts.push(makeAttemptStub(taskId, category, i, rng, i === 1 ? undefined : "success"));
76
+ const outcome = expectedOutcome === "fallback" && i === 1 ? "fallback" : "success";
77
+ attempts.push(makeAttemptStub(taskId, category, i, rng, outcome));
75
78
  }
76
79
  return {
77
80
  taskId,
@@ -86,7 +86,6 @@ export function createShadowModeEngine(options) {
86
86
  return { evaluate, toBenchmarkDecision };
87
87
  }
88
88
  export function computeRouterRegret(candidates, intent, history, selectedId) {
89
- const engine = createRouterV2ScoringEngine();
90
89
  const scores = scoreRuntimes(candidates, intent, history);
91
90
  if (scores.length === 0)
92
91
  return 0;
@@ -12,6 +12,10 @@ export function createReleasePromotionGate() {
12
12
  const w = RELEASE_GATE_WEIGHTS;
13
13
  const demoRun = inputs.demoRun ?? false;
14
14
  const maturity = inputs.maturity ?? inputs.providerMinimum ?? 0;
15
+ const versionConsistency = inputs.versionConsistency ?? inputs.semver ?? 1;
16
+ const liveBenchmarkPass = inputs.liveBenchmarkPass ?? false;
17
+ const sandboxViolationCount = inputs.sandboxViolationCount ?? Number.POSITIVE_INFINITY;
18
+ const exactTagCiPass = inputs.exactTagCiPass ?? false;
15
19
  const rawScore = w.ci * inputs.ci +
16
20
  w.build * (inputs.build ?? 0) +
17
21
  w.types * (inputs.types ?? 0) +
@@ -20,11 +24,11 @@ export function createReleasePromotionGate() {
20
24
  w.demo * (demoRun ? 1 : 0) +
21
25
  w.proof * inputs.proofMedian +
22
26
  w.maturity * maturity +
23
- w.docs * inputs.docs -
27
+ w.docs * inputs.docs * versionConsistency -
24
28
  w.regression * inputs.regressionSeverity;
25
29
  const score = clamp01(rawScore);
26
30
  const reasons = [];
27
- const blocked = inputs.ci === 0 || inputs.freshInstallSmoke === 0 || !demoRun;
31
+ const blocked = inputs.ci === 0 || inputs.freshInstallSmoke === 0 || versionConsistency === 0 || !demoRun;
28
32
  if (blocked) {
29
33
  if (inputs.ci === 0) {
30
34
  reasons.push("CI score is 0 (blocking)");
@@ -32,21 +36,28 @@ export function createReleasePromotionGate() {
32
36
  if (inputs.freshInstallSmoke === 0) {
33
37
  reasons.push("Fresh install smoke is 0 (blocking)");
34
38
  }
39
+ if (versionConsistency === 0) {
40
+ reasons.push("Version/package/proof consistency is 0 (blocking)");
41
+ }
35
42
  if (!demoRun) {
36
43
  reasons.push("Minimal verified demo run failed or missing (blocking)");
37
44
  }
38
45
  }
46
+ const stableEligible = liveBenchmarkPass && sandboxViolationCount === 0 && exactTagCiPass;
39
47
  let verdict;
40
48
  if (blocked) {
41
49
  verdict = "block";
42
50
  }
43
- else if (score >= 0.90 && inputs.proofMedian >= 0.85 && maturity >= 0.80) {
51
+ else if (score >= 0.90 && inputs.proofMedian >= 0.85 && maturity >= 0.80 && stableEligible) {
44
52
  verdict = "stable";
45
- reasons.push(`Score ${formatScore(score)} meets stable threshold (≥0.90) with proof≥0.85 and maturity≥0.80`);
53
+ reasons.push(`Score ${formatScore(score)} meets stable threshold (≥0.90) with proof≥0.85, maturity≥0.80, live benchmark pass, sandbox violations=0, and exact-tag CI pass`);
46
54
  }
47
55
  else if (score >= 0.75 && inputs.proofMedian >= 0.75) {
48
56
  verdict = "pre-release";
49
57
  reasons.push(`Score ${formatScore(score)} meets pre-release threshold (≥0.75) with proof≥0.75`);
58
+ if (score >= 0.90 && inputs.proofMedian >= 0.85 && maturity >= 0.80 && !stableEligible) {
59
+ reasons.push("Stable verdict withheld until live benchmark passes, sandboxViolationCount is 0, and exact-tag CI passes");
60
+ }
50
61
  }
51
62
  else {
52
63
  verdict = "block";
Binary file
@@ -200,13 +200,6 @@ function requestedExternalProvider(input) {
200
200
  function isGenericExternalProvider(value) {
201
201
  return typeof value === "string" && value !== "auto" && value !== "kimi" && value !== "deepseek";
202
202
  }
203
- function providerVectorMeets(vector, minState) {
204
- if (!vector)
205
- return true;
206
- const current = PROVIDER_CAPABILITY_ORDINAL[vector.auth];
207
- const required = PROVIDER_CAPABILITY_ORDINAL[minState];
208
- return current >= required;
209
- }
210
203
  function providerVectorQuotaOk(vector) {
211
204
  if (!vector)
212
205
  return true;
@@ -55,6 +55,14 @@ export interface ReleasePromotionInputs {
55
55
  readonly maturity?: number;
56
56
  /** Algorithm 8 — minimal verified demo run gate. Hard block when false/undefined. */
57
57
  readonly demoRun?: boolean;
58
+ /** Stable claim gate — live/recorded benchmark must pass before stable verdict. */
59
+ readonly liveBenchmarkPass?: boolean;
60
+ /** Stable claim gate — must be exactly 0 before stable verdict. */
61
+ readonly sandboxViolationCount?: number;
62
+ /** Stable claim gate — package/lock/docs/proof/bin invariant. */
63
+ readonly versionConsistency?: number;
64
+ /** Stable claim gate — CI must pass on the exact release tag/commit before stable verdict. */
65
+ readonly exactTagCiPass?: boolean;
58
66
  }
59
67
  export interface ReleasePromotionResult {
60
68
  readonly score: number;
@@ -76,8 +76,6 @@ export function createProviderMaturityTable() {
76
76
  function vectorToAdapterResults(vector) {
77
77
  const authOrdinal = PROVIDER_CAPABILITY_ORDINAL[vector.auth];
78
78
  const binaryOrdinal = PROVIDER_CAPABILITY_ORDINAL[vector.binary];
79
- const modelOrdinal = PROVIDER_CAPABILITY_ORDINAL[vector.model];
80
- const quotaOrdinal = PROVIDER_CAPABILITY_ORDINAL[vector.quota];
81
79
  const authScore = authOrdinal >= PROVIDER_CAPABILITY_ORDINAL["auth_valid"] ? 1.0 : authOrdinal / PROVIDER_CAPABILITY_ORDINAL["auth_valid"];
82
80
  const readScore = vector.supportsRead ? 1.0 : 0.0;
83
81
  const writeScore = vector.supportsWrite ? 1.0 : 0.0;
@@ -0,0 +1,20 @@
1
+ # 2026-06-10 Critical Issues
2
+
3
+ ## Critical Init Status
4
+ - No critical init artifacts were missing when this daily file was generated.
5
+ ### Missing critical artifacts
6
+ - None detected.
7
+
8
+
9
+ ## Critical Artifacts Present
10
+ - ✅ `AGENTS.md` — top-level operating contract
11
+ - ✅ `.kimi/AGENTS.md` — Kimi-specific operating rules
12
+ - ✅ `.omk/config.toml` — OMK project runtime settings
13
+ - ✅ `.omk/agents/root.yaml` — root coordinator agent
14
+ - ✅ `.kimi/mcp.json` — Kimi project MCP registry
15
+ - ✅ `.omk/hooks/pre-shell-guard.sh` — destructive shell guard
16
+ - ✅ `.omk/hooks/protect-secrets.sh` — secret write guard
17
+ - ✅ `.omk/memory/graph-state.json` — local ontology graph database
18
+
19
+ ## Escalation Rule
20
+ - Treat missing shell/secret guards, root agent config, MCP registry, or ontology graph as critical until restored.
@@ -0,0 +1,14 @@
1
+ # 2026-06-10 Improvements
2
+
3
+ ## Current Improvement Backlog
4
+ ### Optional init/support artifacts to add or refresh
5
+ - None detected.
6
+
7
+ ### Critical init artifacts currently blocking reliable chat startup
8
+ - None detected.
9
+
10
+
11
+ ## Suggested Focus
12
+ - Keep `omk chat` startup idempotent and non-destructive.
13
+ - Prefer local graph memory for default ontology state.
14
+ - Keep generated daily docs small, dated, and safe to edit by hand.
@@ -0,0 +1,25 @@
1
+ # 2026-06-10 Required Init Checklist
2
+
3
+ **Run ID:** chat-2026-06-09T17-45-36-041Z-4951
4
+ **Ontology graph:** `.omk/memory/graph-state.json`
5
+
6
+ ## Required Artifacts
7
+ - ✅ `AGENTS.md` — critical; top-level operating contract
8
+ - ✅ `.kimi/AGENTS.md` — critical; Kimi-specific operating rules
9
+ - ✅ `DESIGN.md` — support; design/brand source of truth
10
+ - ✅ `.omk/config.toml` — critical; OMK project runtime settings
11
+ - ✅ `.omk/agents/root.yaml` — critical; root coordinator agent
12
+ - ✅ `.kimi/mcp.json` — critical; Kimi project MCP registry
13
+ - ✅ `.omk/mcp.json` — support; legacy OMK MCP fallback
14
+ - ✅ `.omk/lsp.json` — support; bundled TypeScript/Python LSP config
15
+ - ✅ `.omk/hooks/pre-shell-guard.sh` — critical; destructive shell guard
16
+ - ✅ `.omk/hooks/protect-secrets.sh` — critical; secret write guard
17
+ - ✅ `.omk/memory/graph-state.json` — critical; local ontology graph database
18
+ - ✅ `.kimi/skills` — support; Kimi skill directory
19
+ - ✅ `.agents/skills` — support; portable skill directory
20
+
21
+ ## Recovery Command
22
+ ```bash
23
+ omk init
24
+ omk doctor
25
+ ```
@@ -0,0 +1,20 @@
1
+ # 2026-06-10 OMK Chat Plan
2
+
3
+ **Run ID:** chat-2026-06-09T17-45-36-041Z-4951
4
+ **Generated by:** omk chat bootstrap
5
+
6
+ ## Purpose
7
+ - Start every chat with a dated workspace for planning, issue triage, and verification evidence.
8
+ - Keep ontology-backed memory available before the root coordinator starts.
9
+ - Make required init state visible without overwriting user-authored docs.
10
+
11
+ ## Today Plan
12
+ 1. Review `init-checklist.md` and resolve missing critical init artifacts first.
13
+ 2. Use `improvements.md` as the active improvement backlog.
14
+ 3. Use `critical-issues.md` for blocking defects, safety risks, and verification gaps.
15
+ 4. Record command evidence before claiming work is complete.
16
+
17
+ ## Stop Condition
18
+ - Critical init artifacts are present.
19
+ - Ontology graph exists at `.omk/memory/graph-state.json`.
20
+ - Any new code/docs changes have explicit verification evidence.
@@ -1,6 +1,6 @@
1
1
  # Getting Started
2
2
 
3
- Source release target: `open-multi-agent-kit@0.78.1` (`pre-1.0`).
3
+ Source release target: `open-multi-agent-kit@0.78.6` (`pre-1.0`).
4
4
 
5
5
  ## Prerequisites
6
6
 
@@ -4,7 +4,7 @@ This page documents provider status for the current source tree.
4
4
 
5
5
  ## Current source target
6
6
 
7
- - Package version: `0.78.1`
7
+ - Package version: `0.78.6`
8
8
  - Runtime contract family: `v1.2`
9
9
  - Release channel: `pre-1.0`
10
10
 
@@ -4,11 +4,11 @@ OMK uses two version fields in release artifacts:
4
4
 
5
5
  | Field | Current value | Source | Meaning |
6
6
  | --- | --- | --- | --- |
7
- | Package version | `0.78.1` | `package.json`, `package-lock.json` | npm/package source version. |
7
+ | Package version | `0.78.6` | `package.json`, `package-lock.json` | npm/package source version. |
8
8
  | Runtime version | `v1.2` | `src/version.ts`, JSON schemas | Contract/runtime family used by OMK envelopes. |
9
9
  | Release channel | `pre-1.0` | `src/version.ts` | Pre-1.0 package channel. |
10
10
 
11
- `0.78.1` is the package source version for the `v1.2` runtime contract family.
11
+ `0.78.6` is the package source version for the `v1.2` runtime contract family.
12
12
  Use `v1.2` only for runtime contracts; do not substitute it for the package version.
13
13
 
14
14
  ## Contract versions
@@ -44,6 +44,6 @@ The `version --json` command emits one `omk.contract.v1` envelope whose data pay
44
44
 
45
45
  ## Documentation rules
46
46
 
47
- - Use `0.78.1` when referring to the current package source version.
47
+ - Use `0.78.6` when referring to the current package source version.
48
48
  - Use `v1.2` only for the runtime contract family.
49
49
  - Keep historical changelog entries unchanged unless the text is not clearly historical.
package/package.json CHANGED
@@ -1,9 +1,10 @@
1
1
  {
2
2
  "name": "open-multi-agent-kit",
3
- "version": "0.78.3",
3
+ "version": "0.78.6",
4
4
  "description": "Provider-neutral multi-agent control plane for coding workflows: route agents, verify evidence, orchestrate MCP-aware DAGs, and control the loop from the omk CLI.",
5
5
  "type": "module",
6
6
  "bin": {
7
+ "omk": "dist/cli.js",
7
8
  "omk-project-mcp": "dist/mcp/omk-project-server.js",
8
9
  "omk-acp": "dist/mcp/acp-server.js",
9
10
  "omk-mcp-host": "dist/mcp/host.js"
@@ -32,10 +33,10 @@
32
33
  "version:check": "node scripts/check-version-consistency.mjs",
33
34
  "contract:check": "npm run build:clean && npm run schema:check && node scripts/check-json-stdout.mjs",
34
35
  "verify:contracts": "npm run contract:check",
35
- "release:check": "node scripts/release-gate.mjs",
36
- "release:full": "npm run verify && npm run verify:no-kimi && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run native:build && npm run pack:dry && npm run audit:package && npm run smoke:pack",
36
+ "release:check": "npm run verify:no-kimi && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run native:build && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
37
+ "release:full": "npm run verify && npm run verify:no-kimi && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run native:build && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
37
38
  "regression:matrix": "node scripts/regression-proof-matrix.mjs",
38
- "release:rc": "npm run verify && npm run verify:no-kimi && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run native:build && npm run pack:dry && npm run audit:package && npm run smoke:pack",
39
+ "release:rc": "npm run verify && npm run verify:no-kimi && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run native:build && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
39
40
  "smoke:no-kimi:chat": "OMK_MCP_PREFLIGHT=off OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js chat --provider auto --mode agent --execution ask --layout plain --mcp-scope none --smoke --json",
40
41
  "smoke:no-kimi:codex": "OMK_MCP_PREFLIGHT=off OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js chat --provider codex --mode agent --execution ask --layout plain --mcp-scope none --smoke --json",
41
42
  "smoke:no-kimi:doctor": "OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js doctor --json",
@@ -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
- ```