open-multi-agent-kit 0.78.6 → 0.78.7

package/docs/headroom-omk-usage-examples.md

@@ -0,0 +1,371 @@
+# Headroom OMK 사용 예시
+
+## 1. 기본 컨텍스트 압축
+
+### 예시 1: 대용량 코드 출력 압축
+
+```
+사용자: 이 대용량 코드 출력을 압축해줘
+
+에이전트: headroom_compress 도구를 사용하여 컨텍스트를 압축하겠습니다.
+
+[에이전트가 headroom_compress 도구를 사용]
+
+결과: 60-95% 토큰 절약, 답변 품질 유지
+```
+
+### 예시 2: 로그 파일 압축
+
+```
+사용자: 이 에러 로그를 분석해줘 (10,000줄)
+
+에이전트: 먼저 headroom으로 로그를 압축하겠습니다.
+
+[에이전트가 headroom_compress 도구를 사용]
+
+결과: 10,000줄 로그 → 1,000줄로 압축, 토큰 90% 절약
+```
+
+## 2. 병렬 서브에이전트 작업
+
+### 예시 1: 코드베이스 보안 분석
+
+```
+사용자: 3개의 다른 코드베이스를 병렬로 분석해줘
+
+에이전트: 3개의 병렬 서브에이전트를 생성하겠습니다.
+
+[에이전트가 spawn_parallel_agents 도구를 사용]
+
+결과:
+- 에이전트 1: SQL 인젝션 취약점 스캔
+- 에이전트 2: 인증 결함 검사
+- 에이전트 3: 권한 부여 문제 분석
+```
+
+### 예시 2: 멀티 프로젝트 빌드
+
+```
+사용자: 5개의 마이크로서비스를 병렬로 빌드해줘
+
+에이전트: 5개의 병렬 빌드 에이전트를 생성하겠습니다.
+
+[에이전트가 spawn_parallel_agents 도구를 사용]
+
+결과:
+- 각 에이전트가 다른 서비스를 빌드
+- 모든 빌드가 병렬로 실행
+- 결과가 통합되어 보고
+```
+
+## 3. 목표 지향적 오케스트레이션
+
+### 예시 1: REST API 구축
+
+```
+사용자: JWT 인증이 있는 REST API를 구축해줘
+
+에이전트: 이 목표를 위해 여러 서브에이전트를 오케스트레이션하겠습니다.
+
+[에이전트가 orchestrate_goal 도구를 사용]
+
+결과:
+- API 설계사: 엔드포인트 및 스키마 설계
+- 인증 전문가: JWT 인증 구현
+- 데이터베이스 엔지니어: 데이터베이스 스키마 설계
+- 테스트 작성자: 포괄적인 테스트 작성
+```
+
+### 예시 2: 실시간 알림 시스템
+
+```
+사용자: 실시간 알림 시스템을 구축해줘
+
+에이전트: 이 목표를 위해 5개의 서브에이전트를 오케스트레이션하겠습니다.
+
+[에이전트가 orchestrate_goal 도구를 사용]
+
+결과:
+- WebSocket 전문가
+- 데이터베이스 설계자
+- API 개발자
+- 프론트엔드 통합자
+- 테스트 자동화 전문가
+```
+
+## 4. 통합 사용 예시
+
+### 예시 1: 보안 감사 with 토큰 절약
+
+```
+사용자: 대규모 코드베이스의 보안 감사를 수행해줘
+
+에이전트: 먼저 코드베이스를 분석하고, 병렬로 보안 검사를 수행하겠습니다.
+
+1단계: 코드베이스 탐색 (대용량)
+   → headroom_compress로 탐색 결과 압축
+   → 토큰 80% 절약
+
+2단계: 병렬 보안 검사
+   → 4개의 병렬 에이전트 생성
+   → 각각 다른 보안 측면 검사
+
+3단계: 결과 통합
+   → coordinate_agent_results로 결과 병합
+   → 포괄적인 보안 보고서 생성
+```
+
+### 예시 2: 코드 리팩토링 with 오케스트레이션
+
+```
+사용자: 레거시 인증 시스템을 리팩토링해줘
+
+에이전트: 이 목표를 위해 오케스트레이션을 사용하겠습니다.
+
+1단계: 현재 시스템 분석
+   → 코드 분석 에이전트
+   → 대용량 코드 압축 with headroom
+
+2단계: 새 패턴 설계
+   → 패턴 설계 에이전트
+   → 설계 문서 압축
+
+3단계: 마이그레이션 계획
+   → 마이그레이션 플래너 에이전트
+   → 계획 문서 압축
+
+4단계: 테스트 작성
+   → 테스트 작성 에이전트
+   → 테스트 코드 압축
+```
+
+## 5. 고급 사용 예시
+
+### 예시 1: 적응형 오케스트레이션
+
+```
+사용자: 복잡한 데이터 파이프라인을 구축해줘
+
+에이전트: 적응형 오케스트레이션을 사용하겠습니다.
+
+[에이전트가 orchestrate_goal 도구를 사용 with strategy: "adaptive"]
+
+결과:
+- 의존성 기반 실행
+- 이전 에이전트 완료 후 다음 에이전트 시작
+- 자동 조정 및 최적화
+```
+
+### 예시 2: 파이프라인 오케스트레이션
+
+```
+사용자: 머신러닝 모델 학습 파이프라인을 구축해줘
+
+에이전트: 파이프라인 오케스트레이션을 사용하겠습니다.
+
+[에이전트가 orchestrate_goal 도구를 사용 with strategy: "pipeline"]
+
+결과:
+- 데이터 수집 → 전처리 → 모델 학습 → 평가 → 배포
+- 각 단계가 이전 단계 결과를 사용
+- 순차적 but 효율적 실행
+```
+
+## 6. 토큰 절약 최적화
+
+### 예시 1: 반복적 압축
+
+```
+사용자: 대규모 코드 리뷰를 수행해줘
+
+에이전트: 반복적 압축을 사용하여 토큰을 최적화하겠습니다.
+
+1단계: 코드 탐색 (대용량)
+   → headroom_compress로 탐색 결과 압축
+   → 토큰 90% 절약
+
+2단계: 상세 분석 (중간 크기)
+   → 압축된 컨텍스트 사용
+   → 추가 압축 필요시 다시 압축
+
+3단계: 최종 보고서 (소규모)
+   → 압축된 결과 사용
+   → 최소한의 토큰으로 보고서 생성
+```
+
+### 예시 2: 컨텍스트 윈도우 관리
+
+```
+사용자: 긴 대화에서 컨텍스트를 관리해줘
+
+에이전트: headroom을 사용하여 컨텍스트 윈도우를 관리하겠습니다.
+
+[에이전트가 자동으로 컨텍스트 압축]
+
+결과:
+- 대화 시작: 원본 컨텍스트
+- 대화 중반: 압축된 컨텍스트 (60-95% 절약)
+- 대화 후반: 추가 압축 필요시 자동 압축
+- 컨텍스트 윈도우 한계 방지
+```
+
+## 7. 에이전트 장비 설정
+
+### 예시 1: 보안 전문 에이전트 장비
+
+```
+사용자: 보안 전문 에이전트를 장비해줘
+
+에이전트: equip_agent 도구를 사용하여 에이전트를 장비하겠습니다.
+
+[에이전트가 equip_agent 도구를 사용]
+
+결과:
+- Skills: 보안 스캐너, 취약점 분석기, 침입 탐지기
+- Hooks: 사전 커밋 검사, 사후 커밋 분석
+- MCP Servers: 취약점 데이터베이스, 보안 패턴 저장소
+```
+
+### 예시 2: 데이터베이스 전문 에이전트 장비
+
+```
+사용자: 데이터베이스 전문 에이전트를 장비해줘
+
+에이전트: equip_agent 도구를 사용하여 에이전트를 장비하겠습니다.
+
+[에이전트가 equip_agent 도구를 사용]
+
+결과:
+- Skills: 데이터베이스 설계, 마이그레이션, 최적화
+- Hooks: 백업, 복원, 무결성 검사
+- MCP Servers: PostgreSQL, Redis, Elasticsearch
+```
+
+## 8. 모니터링 및 통계
+
+### 예시 1: 압축 통계 확인
+
+```
+사용자: headroom 압축 통계를 보여줘
+
+에이전트: headroom_stats 도구를 사용하여 통계를 확인하겠습니다.
+
+[에이전트가 headroom_stats 도구를 사용]
+
+결과:
+- 총 압축 횟수: 150회
+- 평균 절약률: 75%
+- 총 절약된 토큰: 1,500,000개
+```
+
+### 예시 2: 오케스트레이터 상태 확인
+
+```
+사용자: 오케스트레이터 상태를 확인해줘
+
+에이전트: orchestrator_status 도구를 사용하여 상태를 확인하겠습니다.
+
+[에이전트가 orchestrator_status 도구를 사용]
+
+결과:
+- 현재 목표: REST API 구축
+- 활성 에이전트: 5개
+- 완료된 에이전트: 3개
+- 실패한 에이전트: 0개
+```
+
+## 9. 문제 해결
+
+### 예시 1: 압축 실패 시
+
+```
+사용자: 압축이 실패했어
+
+에이전트: headroom_install 도구를 사용하여 headroom을 재설치하겠습니다.
+
+[에이전트가 headroom_install 도구를 사용 with force: true]
+
+결과: headroom 재설치, 압축 기능 복구
+```
+
+### 예시 2: 에이전트 스폰 실패 시
+
+```
+사용자: 에이전트가 스폰되지 않아
+
+에이전트: check_parallel_agents 도구를 사용하여 상태를 확인하겠습니다.
+
+[에이전트가 check_parallel_agents 도구를 사용]
+
+결과: 에이전트 상태 확인, 문제 진단, 해결책 제시
+```
+
+## 10. 통합 워크플로우
+
+### 예시 1: 완전한 개발 워크플로우
+
+```
+사용자: 새로운 기능을 개발해줘
+
+에이전트: 완전한 개발 워크플로우를 시작하겠습니다.
+
+1단계: 요구사항 분석
+   → 오케스트레이터가 목표 설정
+   → 분석 에이전트 생성
+
+2단계: 설계
+   → 설계 에이전트 생성
+   → 설계 문서 압축 with headroom
+
+3단계: 구현
+   → 구현 에이전트 생성 (병렬)
+   → 코드 압축 with headroom
+
+4단계: 테스트
+   → 테스트 에이전트 생성
+   → 테스트 결과 압축
+
+5단계: 배포
+   → 배포 에이전트 생성
+   → 배포 로그 압축
+
+결과: 토큰 70% 절약, 개발 시간 50% 단축
+```
+
+### 예시 2: 지속적 통합 워크플로우
+
+```
+사용자: CI/CD 파이프라인을 구축해줘
+
+에이전트: 지속적 통합 워크플로우를 구축하겠습니다.
+
+1단계: 코드 변경 감지
+   → Git 훅 에이전트
+   → 변경사항 압축
+
+2단계: 빌드
+   → 빌드 에이전트 (병렬)
+   → 빌드 로그 압축
+
+3단계: 테스트
+   → 테스트 에이전트 (병렬)
+   → 테스트 결과 압축
+
+4단계: 배포
+   → 배포 에이전트
+   → 배포 로그 압축
+
+결과: 자동화된 CI/CD, 토큰 80% 절약
+```
+
+## 결론
+
+이 예시들은 headroom과 OMK의 통합이如何提供하는지 보여줍니다:
+
+1. **토큰 절약**: 60-95% 토큰 절약 through headroom 압축
+2. **병렬 처리**:多个 서브에이전트가 동시에 작업
+3. **목표 오케스트레이션**: 복잡한 목표를 향한协调된 작업
+4. **유연한 장비**: 각 에이전트에特定한 skills, hooks, MCP 서버
+5. **모니터링 및 통계**: 압축效果 및 에이전트状态 모니터링
+
+이러한 도구들을 사용하여 OMK 워크플로우를 효율적인 컨텍스트 압축과 병렬 에이전트 오케스트레이션으로 향상시키세요.

package/docs/provider-maturity.md

@@ -4,7 +4,7 @@ This page documents provider status for the current source tree.
 
 ## Current source target
 
-- Package version: `0.78.6`
+- Package version: `0.78.7`
 - Runtime contract family: `v1.2`
 - Release channel: `pre-1.0`
 

package/docs/versioning.md

@@ -4,11 +4,11 @@ OMK uses two version fields in release artifacts:
 
 | Field | Current value | Source | Meaning |
 | --- | --- | --- | --- |
-| Package version | `0.78.6` | `package.json`, `package-lock.json` | npm/package source version. |
+| Package version | `0.78.7` | `package.json`, `package-lock.json` | npm/package source version. |
 | Runtime version | `v1.2` | `src/version.ts`, JSON schemas | Contract/runtime family used by OMK envelopes. |
 | Release channel | `pre-1.0` | `src/version.ts` | Pre-1.0 package channel. |
 
-`0.78.6` is the package source version for the `v1.2` runtime contract family.
+`0.78.7` is the package source version for the `v1.2` runtime contract family.
 Use `v1.2` only for runtime contracts; do not substitute it for the package version.
 
 ## Contract versions
@@ -44,6 +44,6 @@ The `version --json` command emits one `omk.contract.v1` envelope whose data pay
 
 ## Documentation rules
 
-- Use `0.78.6` when referring to the current package source version.
+- Use `0.78.7` when referring to the current package source version.
 - Use `v1.2` only for the runtime contract family.
 - Keep historical changelog entries unchanged unless the text is not clearly historical.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-multi-agent-kit",
-  "version": "0.78.6",
+  "version": "0.78.7",
   "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.",
   "type": "module",
   "bin": {
@@ -28,24 +28,24 @@
     "prepare": "npm run build",
     "yaml:check": "node scripts/validate-yaml.mjs",
     "schema:check": "node scripts/validate-json-contracts.mjs",
+    "theme:check": "node scripts/theme-check.mjs --out proof/theme-check",
+    "assets:build": "node scripts/assets-build.mjs",
+    "assets:check": "node scripts/assets-check.mjs",
+    "color:gate": "node scripts/color-literal-gate.mjs",
     "proof:index": "node scripts/build-proof-index.mjs",
     "proof:check": "node scripts/proof-check.mjs",
     "version:check": "node scripts/check-version-consistency.mjs",
     "contract:check": "npm run build:clean && npm run schema:check && node scripts/check-json-stdout.mjs",
     "verify:contracts": "npm run contract:check",
-    "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",
-    "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",
+    "verify:no-persona": "node scripts/verify-no-persona.mjs",
+    "release:check": "npm run verify:no-kimi && npm run verify:no-persona && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
+    "release:full": "npm run verify && npm run verify:no-kimi && npm run verify:no-persona && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
     "regression:matrix": "node scripts/regression-proof-matrix.mjs",
-    "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",
+    "release:rc": "npm run verify && npm run verify:no-kimi && npm run verify:no-persona && npm run contract:check && npm run schema:check && npm run version:check && npm run proof:check && npm run smoke:execution && npm run pack:dry && npm run audit:package && npm run smoke:pack && OMK_RELEASE_DEMO=1 node scripts/release-gate.mjs",
     "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",
     "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",
     "smoke:no-kimi:doctor": "OMK_PROJECT_ROOT=\"$PWD\" node dist/cli.js doctor --json",
-    "verify:no-kimi": "npm run build:clean && npm run smoke:no-kimi:doctor && npm run smoke:no-kimi:chat && npm run smoke:no-kimi:codex && npm run native:no-kimi:turn && npm run no-kimi:default-surface && npm run test:no-kimi:runtime-routing",
-    "rust:check": "node scripts/rust-safety-check.mjs",
-    "rust:build": "cargo build -p omk-safety",
-    "native:build": "node scripts/build-native.mjs",
-    "native:normalize": "node scripts/normalize-native-artifacts.mjs",
-    "native:no-kimi:turn": "OMK_MCP_PREFLIGHT=off OMK_PROJECT_ROOT=\"$PWD\" node --test test/no-kimi-native-turn.test.mjs",
+    "verify:no-kimi": "npm run build:clean && npm run smoke:no-kimi:doctor && npm run smoke:no-kimi:chat && npm run smoke:no-kimi:codex && npm run no-kimi:default-surface && npm run test:no-kimi:runtime-routing",
     "no-kimi:default-surface": "node scripts/no-kimi-default-surface.mjs",
     "test:no-kimi:runtime-routing": "node --test --test-timeout=300000 test/provider-router.test.mjs test/runtime-router.test.mjs && node --test --test-timeout=300000 --test-name-pattern='authority provider write-risk routes|configured non-Kimi authority|implicit default authority|unavailable DeepSeek|external direct fallback|Super OMK config|scoreProviders includes|computeProviderRouteScore|runtime fallback' test/provider-routing.test.mjs && node --test test/no-kimi-cli-hud-surface.test.mjs test/v2-regression.test.mjs",
     "legacy-identity:check": "node scripts/no-legacy-identity-surface.mjs",

package/readmeasset/.npmignore

@@ -17,4 +17,6 @@
 !omk-provider-router-card.png
 !omk-evidence-gate-card.png
 !omk-core-loop.svg
+!omk-control-surfaces.svg
+!omk-release-assertions.svg
 !.npmignore

package/readmeasset/ASSET_INDEX.md

@@ -30,8 +30,10 @@ Curated OMK//CONTROL assets in this directory. Assets are provenance-covered and
 | `omk-evidence-loop-0.78.0.webp` | repo-only | Evidence bundle and verify gate crop           | omk-runtime-flow-0.78.0.webp               | `900x774`   | `WEBP` |  60808 |
 | `omk-runtime-flow-wide.webp`    | repo-only | Runtime flow wide strip                        | omk-runtime-flow-0.78.0.webp               | `1485x178`  | `WEBP` |  45258 |
 | `omk-architecture-strip.webp`   | repo-only | TUI command timeline and evidence ledger strip | omk-tui-0.78.0.webp                        | `1536x273`  | `WEBP` |  71128 |
-| `omk-core-loop.svg`             | yes       | OMK Core Loop                                  | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2671 |
-| `omk-provider-lanes.svg`        | repo-only | Provider Lanes                                 | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2693 |
-| `omk-evidence-ledger.svg`       | repo-only | Evidence Ledger                                | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2351 |
-| `omk-badges.svg`                | repo-only | OMK Badges                                     | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2345 |
-| `omk-logo-mark.svg`             | yes       | Vector OMK logo mark                           | local SVG render from OMK palette          | `512x512`   | `SVG`  |    589 |
+| `omk-core-loop.svg`             | yes       | OMK Core Loop                                  | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2731 |
+| `omk-control-surfaces.svg`      | yes       | Operator control surfaces                      | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   3325 |
+| `omk-release-assertions.svg`    | yes       | Release assertion card                         | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   3052 |
+| `omk-provider-lanes.svg`        | repo-only | Provider Lanes                                 | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2753 |
+| `omk-evidence-ledger.svg`       | repo-only | Evidence Ledger                                | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2411 |
+| `omk-badges.svg`                | repo-only | OMK Badges                                     | local SVG render from OMK palette          | `1200x420`  | `SVG`  |   2405 |
+| `omk-logo-mark.svg`             | yes       | Vector OMK logo mark                           | local SVG render from OMK palette          | `512x512`   | `SVG`  |    649 |

package/readmeasset/ASSET_PROVENANCE.md

@@ -87,8 +87,24 @@
 | `omk-evidence-loop-0.78.0.webp` | omk-runtime-flow-0.78.0.webp | Evidence bundle and verify gate crop | `900x774` | `WEBP` | 60808 | `2c4bf27d738710461b9979144759e06a99729ffcc97f53d1bd985b503b0f99da` |
 | `omk-runtime-flow-wide.webp` | omk-runtime-flow-0.78.0.webp | Runtime flow wide strip | `1485x178` | `WEBP` | 45258 | `9edac732cd8de0533e345337392f3dca464a9d8a2f08d8b7a464b685a8da45ce` |
 | `omk-architecture-strip.webp` | omk-tui-0.78.0.webp | TUI command timeline and evidence ledger strip | `1536x273` | `WEBP` | 71128 | `c76b825863260ecff832e31d986b91d341903f929faa62727511a594cb714cfe` |
-| `omk-core-loop.svg` | local SVG render from OMK palette | OMK Core Loop | `1200x420` | `SVG` | 2671 | `95ffbc24fb6c52bb91172e05a77360f7604dcd3c383840139f851c7066af4184` |
-| `omk-provider-lanes.svg` | local SVG render from OMK palette | Provider Lanes | `1200x420` | `SVG` | 2693 | `84dd51d8835c0b8a682945958f1121d3d65530904b3818739fa47f9b8a2b6ef6` |
-| `omk-evidence-ledger.svg` | local SVG render from OMK palette | Evidence Ledger | `1200x420` | `SVG` | 2351 | `ef07178bf9fc3e6a9dd56e0150b1b410cf1c5e457b6a4b42511a9f2f16ed8465` |
-| `omk-badges.svg` | local SVG render from OMK palette | OMK Badges | `1200x420` | `SVG` | 2345 | `cb1980381dfac48c665c23517450419ca91860db96968bff8f9c158888c08b69` |
-| `omk-logo-mark.svg` | local SVG render from OMK palette | Vector OMK logo mark | `512x512` | `SVG` | 589 | `b98505c0a72d50af8a7d432af6c7563498c04c355a0b8d5057b33457a8dd1be0` |
+| `omk-core-loop.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | OMK Core Loop | `1200x420` | `SVG` | 2731 | `0f60a453833c541a05db3b509f9d56fae02c38c89334c7c57357f281cad439f2` |
+| `omk-control-surfaces.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | Operator control surfaces | `1200x420` | `SVG` | 3325 | `2295e2048336452a7abef90c0636107be36845946976fd79563f10092b22bd99` |
+| `omk-release-assertions.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | Release assertion card | `1200x420` | `SVG` | 3052 | `8040d23c46bf48fd7f946f9ff491dcad8aa41ce023b7b062ff5475667c8f283d` |
+| `omk-provider-lanes.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | Provider Lanes | `1200x420` | `SVG` | 2753 | `d7d85098e02e78d37d10a9886a041a8546bfa8438dd3f29bb157ce848bfd0b83` |
+| `omk-evidence-ledger.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | Evidence Ledger | `1200x420` | `SVG` | 2411 | `01f0d66d2ba9915d9975bd7f93bb790e7ab0e11adbaedf84b4e5c25be6fe837c` |
+| `omk-badges.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | OMK Badges | `1200x420` | `SVG` | 2405 | `4a4c94daca5d81e10a1ca185d3c07d4dfa6ac732363ecbc4bdbde841d4624cf6` |
+| `omk-logo-mark.svg` | themes/night-city.theme.json via scripts/assets-build.mjs | Vector OMK logo mark | `512x512` | `SVG` | 649 | `f5ba6323a9bf471b3c6001d063b90087dece0491ef15c4f0f1ea314785bef124` |
+
+## Theme-derived SVG assets (2026-06-10)
+
+- Source of truth: `themes/night-city.theme.json` (`omk.theme.v1` contract, contrast-gated by `npm run theme:check`).
+- Generator: `scripts/assets-build.mjs` resolves every `fill`/`stroke`/`stop-color` value from theme primitives and embeds a provenance comment; geometry, layout, and text are preserved.
+- Regeneration command: `npm run assets:build` (re-run after any theme token change; the `@<hash>` suffix is the first 12 hex of the theme file's SHA-256).
+- Light variant: not built — dark-only by ADR, see `docs/decisions/ADR-theme-dark-only-assets.md`. Non-dark themes are refused unless every used pair passes the 4.5/3.0 WCAG gates inline.
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-badges.svg`
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-control-surfaces.svg`
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-core-loop.svg`
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-evidence-ledger.svg`
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-logo-mark.svg`
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-provider-lanes.svg`
+- derived-from: omk.theme.v1/night-city@e5daf40d789d — `omk-release-assertions.svg`

package/readmeasset/omk-control-surfaces.svg

@@ -0,0 +1,55 @@
+<!-- derived-from: omk.theme.v1/night-city@e5daf40d789d -->
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="420" viewBox="0 0 1200 420" role="img" aria-labelledby="title desc">
+  <title id="title">OMK operator surfaces</title>
+  <desc id="desc">OMK operator surfaces: CLI, provider router, MCP scope, evidence gate, replay ledger, and package audit.</desc>
+  <defs>
+    <linearGradient id="panel" x1="0" x2="1" y1="0" y2="1">
+      <stop offset="0" stop-color="#070B14"/>
+      <stop offset="1" stop-color="#101826"/>
+    </linearGradient>
+    <linearGradient id="lane" x1="0" x2="1">
+      <stop offset="0" stop-color="#00D6FF"/>
+      <stop offset="0.5" stop-color="#00FFC2"/>
+      <stop offset="1" stop-color="#FF47B2"/>
+    </linearGradient>
+  </defs>
+  <rect width="1200" height="420" rx="34" fill="url(#panel)"/>
+  <rect x="28" y="28" width="1144" height="364" rx="24" fill="none" stroke="#00D6FF" stroke-width="2"/>
+  <text x="60" y="72" fill="#E8F8FF" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="34" font-weight="800">OMK//CONTROL SURFACES</text>
+  <text x="60" y="110" fill="#9DB3C7" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18">operator-visible assertions, not hidden agent folklore</text>
+  <path d="M92 232 H1108" stroke="url(#lane)" stroke-width="8" stroke-linecap="round"/>
+
+  <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" text-anchor="middle">
+    <g transform="translate(112 232)">
+      <circle r="38" fill="#070B14" stroke="#00D6FF" stroke-width="4"/>
+      <text y="7" fill="#00D6FF" font-size="22" font-weight="800">CLI</text>
+      <text y="72" fill="#E8F8FF" font-size="16">doctor/chat</text>
+    </g>
+    <g transform="translate(308 232)">
+      <circle r="38" fill="#070B14" stroke="#00FFC2" stroke-width="4"/>
+      <text y="7" fill="#00FFC2" font-size="22" font-weight="800">ROUTE</text>
+      <text y="72" fill="#E8F8FF" font-size="16">provider policy</text>
+    </g>
+    <g transform="translate(504 232)">
+      <circle r="38" fill="#070B14" stroke="#9D4EDD" stroke-width="4"/>
+      <text y="7" fill="#9D4EDD" font-size="22" font-weight="800">MCP</text>
+      <text y="72" fill="#E8F8FF" font-size="16">scoped tools</text>
+    </g>
+    <g transform="translate(700 232)">
+      <circle r="38" fill="#070B14" stroke="#FFB000" stroke-width="4"/>
+      <text y="7" fill="#FFB000" font-size="22" font-weight="800">GATE</text>
+      <text y="72" fill="#E8F8FF" font-size="16">evidence</text>
+    </g>
+    <g transform="translate(896 232)">
+      <circle r="38" fill="#070B14" stroke="#FF47B2" stroke-width="4"/>
+      <text y="7" fill="#FF47B2" font-size="22" font-weight="800">LEDGER</text>
+      <text y="72" fill="#E8F8FF" font-size="16">replay/inspect</text>
+    </g>
+    <g transform="translate(1088 232)">
+      <circle r="38" fill="#070B14" stroke="#FF5874" stroke-width="4"/>
+      <text y="7" fill="#FF5874" font-size="22" font-weight="800">AUDIT</text>
+      <text y="72" fill="#E8F8FF" font-size="16">package-safe</text>
+    </g>
+  </g>
+  <text x="600" y="366" fill="#9DB3C7" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" text-anchor="middle">Every claim routes through a visible command, artifact, or proof bundle.</text>
+</svg>

package/readmeasset/omk-core-loop.svg

@@ -1,3 +1,4 @@
+<!-- derived-from: omk.theme.v1/night-city@e5daf40d789d -->
 <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="420" viewBox="0 0 1200 420">
 <rect width="1200" height="420" fill="#070B14"/>
 <defs><filter id="glow"><feGaussianBlur stdDeviation="3" result="b"/><feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge></filter></defs>

package/readmeasset/omk-logo-mark.svg

@@ -1,3 +1,4 @@
+<!-- derived-from: omk.theme.v1/night-city@e5daf40d789d -->
 <svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512">
 <rect width="512" height="512" rx="96" fill="#070B14"/>
 <path d="M256 48 424 144v224L256 464 88 368V144Z" fill="#101826" stroke="#00D6FF" stroke-width="16"/>

package/readmeasset/omk-release-assertions.svg

@@ -0,0 +1,51 @@
+<!-- derived-from: omk.theme.v1/night-city@e5daf40d789d -->
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="420" viewBox="0 0 1200 420" role="img" aria-labelledby="title desc">
+  <title id="title">OMK release assertions</title>
+  <desc id="desc">Package, binary, gate, and package-safety assertions for open-multi-agent-kit releases.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" x2="1" y1="0" y2="1">
+      <stop offset="0" stop-color="#070B14"/>
+      <stop offset="0.52" stop-color="#101826"/>
+      <stop offset="1" stop-color="#070B14"/>
+    </linearGradient>
+    <linearGradient id="cyanMagenta" x1="0" x2="1">
+      <stop offset="0" stop-color="#00D6FF"/>
+      <stop offset="0.5" stop-color="#00FFC2"/>
+      <stop offset="1" stop-color="#FF47B2"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+  <rect width="1200" height="420" rx="34" fill="url(#bg)"/>
+  <rect x="24" y="24" width="1152" height="372" rx="24" fill="none" stroke="url(#cyanMagenta)" stroke-width="3" filter="url(#glow)"/>
+  <path d="M54 96 H1146" stroke="#00D6FF" stroke-width="1" stroke-dasharray="8 14" opacity="0.72"/>
+  <text x="60" y="72" fill="#E8F8FF" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="34" font-weight="800">OMK//RELEASE ASSERTIONS</text>
+  <text x="60" y="112" fill="#9DB3C7" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18">npm truth surface for open-multi-agent-kit</text>
+
+  <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="21">
+    <rect x="60" y="148" width="500" height="58" rx="14" fill="#101826" stroke="#00D6FF"/>
+    <text x="86" y="184" fill="#00D6FF" font-weight="700">assert package.name</text>
+    <text x="330" y="184" fill="#E8F8FF">open-multi-agent-kit</text>
+
+    <rect x="640" y="148" width="500" height="58" rx="14" fill="#101826" stroke="#00FFC2"/>
+    <text x="666" y="184" fill="#00FFC2" font-weight="700">assert bins</text>
+    <text x="826" y="184" fill="#E8F8FF">omk + MCP + ACP</text>
+
+    <rect x="60" y="226" width="500" height="58" rx="14" fill="#101826" stroke="#FFB000"/>
+    <text x="86" y="262" fill="#FFB000" font-weight="700">assert gates</text>
+    <text x="252" y="262" fill="#E8F8FF">version proof pack audit smoke</text>
+
+    <rect x="640" y="226" width="500" height="58" rx="14" fill="#101826" stroke="#FF47B2"/>
+    <text x="666" y="262" fill="#FF47B2" font-weight="700">assert excluded</text>
+    <text x="880" y="262" fill="#E8F8FF">local state + secrets</text>
+
+    <rect x="60" y="304" width="1080" height="58" rx="14" fill="#070B14" stroke="#9D4EDD"/>
+    <text x="86" y="340" fill="#9D4EDD" font-weight="700">assert release_truth</text>
+    <text x="346" y="340" fill="#E8F8FF">tagged checks + registry verification before claims</text>
+  </g>
+</svg>