arkgate 2.4.0 → 2.6.0

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 All notable changes to ArkGate (`arkgate`; formerly `ark-runtime-kernel`) are documented here.
 
+## 2.6.0 — 2026-07-09
+
+### Changed — maintainability hygiene (#11 / #12)
+
+- **`bin/ark-check.mjs` modularized** (~5.8k → ~2.1k lines of orchestration):
+  `bin/lib/agent-gates.mjs`, `html-report.mjs`, `doctor-plan.mjs`, `violations.mjs`,
+  `suggestions.mjs`, `presets.mjs`. Entry owns scan/CLI only.
+- **Layer matching single algorithm:** pure matcher in `bin/ark-layer-match.mjs` (CLI) and
+  `src/domain/layerMatch.ts` (eslint). Tooling may import DomainModel for that pure helper.
+  `tests/unit/static-check/layerMatchParity.test.ts` locks both implementations.
+- Dual-driver ESLint/CI tests retained.
+
+### Fixed — field test (Codex + Grok on random repos)
+
+- **`--report` path display:** absolute report paths no longer print as brittle
+  `../../../../tmp/...` relatives; paths outside the project root print absolute.
+- **`ark-check --help`:** documents dual bins `arkgate-check | ark-check`.
+- **`ark-check --version` / `-V`:** prints package version (no longer runs a full check).
+- **Doctor thin-coverage honesty:** when there are zero violations but governed < 50%
+  (or empty scope), doctor no longer claims “code matches the contract”; it warns that
+  green is not yet honest enforcement.
+- **Grok write-gate hooks:** root env
+  `${GROK_WORKSPACE_ROOT:-${CLAUDE_PROJECT_DIR:-.}}` (Grok → Claude alias → cwd).
+- **AGENTS / package / Cursor check command:** if `.ark-baseline.json` exists, emitted
+  `ark-check` commands include `--baseline .ark-baseline.json` (same ratchet as CI).
+
+## 2.5.0 — 2026-07-09
+
+### Added — ESLint ↔ CI layer parity
+
+- **`arkgate/eslint`** `no-domain-infra-imports` is **config-driven**: loads
+  `ark.config.json` (walk-up from the linted file), classifies layers with the same
+  glob specificity + `exclude` semantics as `arkgate-check`, and denies edges from
+  `rules[]` — not path-token “domain/infra” heuristics alone.
+- Relative imports resolve to on-disk TS/JS targets; type-only and value imports both
+  fail when the edge is denied (same pass/fail as CI).
+- **`no-forbidden-globals`** reads `forbiddenGlobals` from the matched layer in
+  `ark.config.json` (no invented defaults for layers without a purity list). Optional
+  rule option `globals` still overrides. Domain path heuristic + defaults only when
+  no config is found.
+- Dual-driver tests: same fixtures → ESLint rule + `ark-check --json` agree.
+- Recommended config enables `ark/no-forbidden-globals`.
+- Without `ark.config.json`, legacy domain→infra path heuristic remains for bare trees.
+- **ESLint 8–10 filename API:** rules read `physicalFilename` → `filename` → `getFilename()`
+  so config walk-up works on ESLint 10 (where `getFilename` was removed).
+
 ## 2.4.0 — 2026-07-08
 
 ### Added — Adoption completeness (P0–P2)

package/README.md

@@ -167,6 +167,7 @@ ark.config.json
 | Classified plan (`mechanical-safe` / judgment) | ✅ | ❌ |
 | TypeScript 5 / 6 / 7 project compilers | ✅ | varies |
 | Adoption scorecard (hosts / MCP / origin) | ✅ | ❌ |
+| **Editor ESLint same layer contract as CI** | ✅ (`arkgate/eslint`) | varies |
 
 ---
 
@@ -210,7 +211,7 @@ NestJS: `arkgate/nestjs` (optional peer `@nestjs/common`).
 | Audience | Link |
 |----------|------|
 | New builders (plain language) | [docs/enthusiast/](docs/enthusiast/README.md) |
-| Wire Claude / Cursor / Codex / Grok | [docs/ai-gates.md](docs/ai-gates.md) |
+| Wire Claude / Cursor / Codex / Grok + **ESLint (CI-parity)** | [docs/ai-gates.md](docs/ai-gates.md) |
 | **TypeScript 5 / 6 / 7 support** | [docs/typescript-support.md](docs/typescript-support.md) |
 | Migrate from `ark-runtime-kernel` | [docs/migrate-from-ark-runtime-kernel.md](docs/migrate-from-ark-runtime-kernel.md) |
 | Messy existing repo | [docs/brownfield-adoption.md](docs/brownfield-adoption.md) |