open-multi-agent-kit 0.78.5 → 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 +38 -0
- package/MATURITY.md +2 -2
- package/README.md +4 -4
- package/dist/cli/release-promotion-gate.js +4 -3
- package/dist/runtime/contracts/weakness-remediation.d.ts +2 -0
- 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/getting-started.md +1 -1
- package/docs/provider-maturity.md +1 -1
- package/docs/versioning.md +3 -3
- package/package.json +3 -3
- 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
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.
|
|
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.
|
|
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.
|
|
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`.
|
|
67
|
-
|
|
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.
|
|
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` |
|
|
@@ -15,6 +15,7 @@ export function createReleasePromotionGate() {
|
|
|
15
15
|
const versionConsistency = inputs.versionConsistency ?? inputs.semver ?? 1;
|
|
16
16
|
const liveBenchmarkPass = inputs.liveBenchmarkPass ?? false;
|
|
17
17
|
const sandboxViolationCount = inputs.sandboxViolationCount ?? Number.POSITIVE_INFINITY;
|
|
18
|
+
const exactTagCiPass = inputs.exactTagCiPass ?? false;
|
|
18
19
|
const rawScore = w.ci * inputs.ci +
|
|
19
20
|
w.build * (inputs.build ?? 0) +
|
|
20
21
|
w.types * (inputs.types ?? 0) +
|
|
@@ -42,20 +43,20 @@ export function createReleasePromotionGate() {
|
|
|
42
43
|
reasons.push("Minimal verified demo run failed or missing (blocking)");
|
|
43
44
|
}
|
|
44
45
|
}
|
|
45
|
-
const stableEligible = liveBenchmarkPass && sandboxViolationCount === 0;
|
|
46
|
+
const stableEligible = liveBenchmarkPass && sandboxViolationCount === 0 && exactTagCiPass;
|
|
46
47
|
let verdict;
|
|
47
48
|
if (blocked) {
|
|
48
49
|
verdict = "block";
|
|
49
50
|
}
|
|
50
51
|
else if (score >= 0.90 && inputs.proofMedian >= 0.85 && maturity >= 0.80 && stableEligible) {
|
|
51
52
|
verdict = "stable";
|
|
52
|
-
reasons.push(`Score ${formatScore(score)} meets stable threshold (≥0.90) with proof≥0.85, maturity≥0.80, live benchmark pass,
|
|
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`);
|
|
53
54
|
}
|
|
54
55
|
else if (score >= 0.75 && inputs.proofMedian >= 0.75) {
|
|
55
56
|
verdict = "pre-release";
|
|
56
57
|
reasons.push(`Score ${formatScore(score)} meets pre-release threshold (≥0.75) with proof≥0.75`);
|
|
57
58
|
if (score >= 0.90 && inputs.proofMedian >= 0.85 && maturity >= 0.80 && !stableEligible) {
|
|
58
|
-
reasons.push("Stable verdict withheld until live benchmark passes
|
|
59
|
+
reasons.push("Stable verdict withheld until live benchmark passes, sandboxViolationCount is 0, and exact-tag CI passes");
|
|
59
60
|
}
|
|
60
61
|
}
|
|
61
62
|
else {
|
|
@@ -61,6 +61,8 @@ export interface ReleasePromotionInputs {
|
|
|
61
61
|
readonly sandboxViolationCount?: number;
|
|
62
62
|
/** Stable claim gate — package/lock/docs/proof/bin invariant. */
|
|
63
63
|
readonly versionConsistency?: number;
|
|
64
|
+
/** Stable claim gate — CI must pass on the exact release tag/commit before stable verdict. */
|
|
65
|
+
readonly exactTagCiPass?: boolean;
|
|
64
66
|
}
|
|
65
67
|
export interface ReleasePromotionResult {
|
|
66
68
|
readonly score: number;
|
|
@@ -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.
|
package/docs/getting-started.md
CHANGED
package/docs/versioning.md
CHANGED
|
@@ -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.
|
|
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.
|
|
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.
|
|
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,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "open-multi-agent-kit",
|
|
3
|
-
"version": "0.78.
|
|
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": {
|
|
@@ -34,9 +34,9 @@
|
|
|
34
34
|
"contract:check": "npm run build:clean && npm run schema:check && node scripts/check-json-stdout.mjs",
|
|
35
35
|
"verify:contracts": "npm run contract:check",
|
|
36
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",
|
|
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",
|
|
38
38
|
"regression:matrix": "node scripts/regression-proof-matrix.mjs",
|
|
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",
|
|
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",
|
|
40
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",
|
|
41
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",
|
|
42
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
|
-
```
|