2.6.0 — Modular CLI hygiene + field-test fixes

ArkGate 2.6.0

Maintainability (#11 / #12)

• bin/ark-check.mjs modularized (~5.8k → ~2.1k): bin/lib/agent-gates, html-report, doctor-plan, violations, suggestions, presets
• Single layer-match algorithm: bin/ark-layer-match.mjs (CLI) + src/domain/layerMatch.ts (eslint); Tooling → DomainModel; parity tests

Field-test fixes (Codex + Grok)

• --report absolute paths no longer print as ../../../../tmp/...
• Dual-bin help + --version / -V
• Doctor: no false “matches the contract” when coverage is thin
• Grok hooks: ${GROK_WORKSPACE_ROOT:-${CLAUDE_PROJECT_DIR:-.}}
• AGENTS/package/Cursor check commands include --baseline when .ark-baseline.json exists

Upgrade

npm install -D arkgate@2.6.0
npx arkgate upgrade

Full notes: CHANGELOG.md

2.5.0 — ESLint ↔ CI layer parity

ArkGate 2.5.0

ESLint ↔ CI parity

• arkgate/eslint loads ark.config.json (walk-up from the linted file)
• Same layer globs, specificity, exclude, and rules[] as arkgate-check
• Relative imports resolve to TS/JS; type-only and value forbidden edges both fail
• no-forbidden-globals uses per-layer forbiddenGlobals from the contract
• ESLint 8–10 filename API: physicalFilename → filename → getFilename()
• Dual-driver tests: same fixtures → ESLint + ark-check --json

Also on this train

• .ark/ gitignored for local report snapshots
• Roadmap: next-iteration debt (split ark-check.mjs, shared layer globs)

Upgrade

npm install -D arkgate@2.5.0
npx arkgate upgrade
# editor: import ark from 'arkgate/eslint' → ark.configs.recommended

Full notes: CHANGELOG.md

2.4.0 — TypeScript 5/6/7 + adoption completeness

ArkGate 2.4.0

TypeScript 5 / 6 / 7

• Gate host needs classic JS API (sys + AST + resolve). TS 7.0 main export is version-only — falls back to nested typescript@^5.9.
• CI matrix 5.9.3 / 6.0.3 / 7.0.2 · docs/typescript-support.md

Adoption completeness (P0–P2)

• arkgate-check --doctor Adoption section (hosts, dual-bin MCP, Codex home temp paths, optional-but-populated cores, origin report, baseline policy)
• HTML report Adoption card (separate from 0–100 fitness)
• Codex home fail-closed rewrite to absolute project root + arkgate-mcp
• Educational layer-balance note · structural test template under templates/tests/

Fixed

• --migrate-commands dual ark-mcp + arkgate-mcp argv (stdio break)

Upgrade

npm install -D arkgate@2.4.0
npx arkgate upgrade
npx arkgate-check --doctor

Full notes: CHANGELOG.md

v2.3.0 — P0 complete

ArkGate 2.3.0 — P0 complete

Mechanical-safe (co-pilot plan)

1. Type-only import edges
2. Pure-type file relocate (sourcePureTypeModule + type-only)
3. Static import of pure-type target modules (targetTypeOnlyExports)

Still judgment: value coupling, side-effect type files, require/dynamic import, globals, cycles.

Deferred: verbatim infra relocation of value modules (cannot prove safe statically).

Release-trust

• scripts/verify-release-tag.mjs fails closed on unsigned tags by default
• Override: ARK_ALLOW_UNSIGNED_RELEASE_TAG=true (CI sets this until GPG signing)

npm install -D arkgate@2.3.0

v2.2.0 — Co-pilot P0 depth

ArkGate 2.2.0

Co-pilot plan classifier

• New mechanical-safe class: static value-syntax imports of pure type-only modules (targetTypeOnlyExports) → convert to import type
• Still judgment: mixed modules, type files with runtime side effects, require() / dynamic import(), value coupling, forbidden globals, cycles
• Scan cache v3 + two-pass target resolve
• Expanded zero-false-safe corpus tests

Install

npm install -D arkgate@2.2.0
npx arkgate-check --plan

Upgrade from 2.1.x

npm install -D arkgate@latest
npx arkgate upgrade

v2.1.1 — Migration guide

Migration docs for users of deprecated ark-runtime-kernel (~4.5k downloads).

• docs/migrate-from-ark-runtime-kernel.md
• README: Upgrading from ark-runtime-kernel?

npm uninstall ark-runtime-kernel && npm install -D arkgate
npx arkgate-check --install-agent-gates --force

v2.1.0 — ArkGate

ArkGate

npm package is now arkgate (was ark-runtime-kernel).

Same architecture co-pilot / write gate / CI product — honest name.

Install

npm install -D arkgate typescript
npx arkgate start
npx arkgate-check --plan

CLI aliases ark / ark-check / ark-mcp still work for one major.

Migration

npm uninstall ark-runtime-kernel
npm install -D arkgate

MCP: publish under identifier arkgate (maintainer).

Config file is still ark.config.json. Skills remain /ark-*.

v2.0.1 — Architecture Co-pilot (Grok · skills · report)

Ark — Architecture Co-pilot for AI TypeScript

Highlights

• Showcase HTML architecture report + origin/latest/history under .ark/reports/
• Grok Build first-class host (--install-agent-gates --tools grok)
• README inventory of all 11 /ark-* skills
• Product title clarified; npm name ark-runtime-kernel is historical

Install

npm install -D ark-runtime-kernel@2.0.1
npx ark upgrade

MCP registry publish: maintainer step (not in this release automation).

2.0.0 — architecture co-pilot

Ark 2.0.0 — the architecture co-pilot

Architecture guardrails for TypeScript projects that use AI agents.

Highlights

• Co-pilot: ark start + /ark-autopilot (plan · goal · loop)
• Honesty: suggest / adapt / enforce; no false-green at ~0% governed
• Day-1 coverage: Nest / Next / express / library layout overlays
• pnpm-safe runner; clearer product README
• Milestone major — not an API break (1.x still works)

Install

npm install -D ark-runtime-kernel@2.0.0 typescript
npx ark start

See CHANGELOG and README.

v1.19.0 — co-pilot Phase H: `/ark-loop` (the loop primitive)

Third slice of the co-pilot — the safe, reversible apply loop.

• /ark-loop skill (installed for every detected agent CLI): drives the classified plan in a discardable git worktree — applies one mechanical-safe step at a time, validates with ark-check, keeps on green / rolls back on regression, PROPOSES judgment steps for a human decision, loops until goal.met or no-progress, then reports auto-applied vs proposed vs deferred. The agent edits, Ark validates — code only, never DB/schema, never weakening the gate.
• goal.met added to ark-check --plan --json as the loop's termination signal.

Completes the harness primitives: plan + goal (Phase F) · loop (Phase H). Also fixes an intermittent CI "onTaskUpdate" vitest flake (single-fork test run).

Full notes: CHANGELOG.md.