arkgate 2.1.0 → 2.2.0

package/docs/migrate-from-ark-runtime-kernel.md

@@ -0,0 +1,152 @@
+# Migrate from `ark-runtime-kernel` → **ArkGate** (`arkgate`)
+
+**Same product.** Only the npm name and primary CLI names changed.
+Config, baselines, and `/ark-*` skills stay.
+
+| | Before | After |
+|--|--------|--------|
+| Package | `ark-runtime-kernel` | **`arkgate`** |
+| Product name | Ark | **ArkGate** |
+| Check CLI | `ark-check` | **`arkgate-check`** (alias `ark-check` still works) |
+| MCP CLI | `ark-mcp` | **`arkgate-mcp`** (alias `ark-mcp` still works) |
+| Setup CLI | `ark` | **`arkgate`** (alias `ark` still works) |
+| Config | `ark.config.json` | **unchanged** |
+| Baseline | `.ark-baseline.json` | **unchanged** |
+| Skills | `/ark-autopilot`, … | **unchanged** |
+| GitHub | `pedroknigge/ark-runtime-kernel` | **`pedroknigge/arkgate`** (old URL redirects) |
+
+---
+
+## Fast path (recommended)
+
+```bash
+# 1) Swap the dependency
+npm uninstall ark-runtime-kernel
+npm install -D arkgate
+# pnpm: pnpm remove ark-runtime-kernel && pnpm add -D arkgate
+# yarn: yarn remove ark-runtime-kernel && yarn add -D arkgate
+
+# 2) Refresh gates, skills, MCP templates
+npx arkgate-check --install-agent-gates --force
+
+# 3) Verify
+npx arkgate-check --doctor
+npx arkgate-check --root . --config ark.config.json --strict-config
+```
+
+One-liner if the old bin is still on the path after installing `arkgate`:
+
+```bash
+npx arkgate upgrade
+```
+
+(`ark upgrade` works too — both install `arkgate@latest` and refresh gates.)
+
+---
+
+## What to change in your repo
+
+### `package.json`
+
+```diff
+- "ark-runtime-kernel": "^2.0.1"
++ "arkgate": "^2.1.0"
+```
+
+Scripts:
+
+```diff
+- "check:architecture": "ark-check --root . --config ark.config.json --strict-config"
++ "check:architecture": "arkgate-check --root . --config ark.config.json --strict-config"
+```
+
+(`ark-check` still works as a compat alias for one major.)
+
+### CI / GitHub Actions
+
+```diff
+- run: npx ark-check --root . --config ark.config.json --strict-config
++ run: npx arkgate-check --root . --config ark.config.json --strict-config
+```
+
+Composite action:
+
+```diff
+- uses: pedroknigge/ark-runtime-kernel@main
++ uses: pedroknigge/arkgate@main
+```
+
+### MCP (Claude / Cursor / `.mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "ark": {
+      "command": "npx",
+      "args": ["arkgate-mcp", "--root", ".", "--config", "ark.config.json"]
+    }
+  }
+}
+```
+
+Then restart the agent / reload MCP.
+
+### Codex
+
+Re-register so home MCP points at this project with the new bin:
+
+```bash
+npx arkgate-check --install-agent-gates --tools codex --force
+# optional home skills:
+npx arkgate-check --install-agent-gates --codex-home --force
+```
+
+### Grok
+
+```bash
+npx arkgate-check --install-agent-gates --tools grok --force
+```
+
+Or edit `.grok/config.toml` → `args` use `arkgate-mcp`.
+
+### TypeScript imports (runtime / Nest / ESLint only)
+
+```diff
+- import { createStrictArkKernelFromConfig } from 'ark-runtime-kernel';
++ import { createStrictArkKernelFromConfig } from 'arkgate';
+
+- import { ArkModule } from 'ark-runtime-kernel/nestjs';
++ import { ArkModule } from 'arkgate/nestjs';
+
+- import ark from 'ark-runtime-kernel/eslint';
++ import ark from 'arkgate/eslint';
+```
+
+If you only used the CLI + MCP (most projects), **no import changes**.
+
+---
+
+## What you can ignore
+
+- Renaming `ark.config.json` — not required  
+- Renaming `/ark-*` skills — not required  
+- Re-running full adopt/architect — not required unless you want a fresh plan  
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| `npm warn deprecated ark-runtime-kernel` | Swap dep to `arkgate` (this guide) |
+| `ark-check: not found` after uninstall | Use `npx arkgate-check` or reinstall `arkgate` |
+| MCP still launches old package | Update `.mcp.json` / Codex / Grok config; restart agent |
+| pnpm blocks new package age | Wait for cooling-off or pin exact version `arkgate@2.1.0` |
+
+---
+
+## Why the rename
+
+`ark-runtime-kernel` suggested a runtime framework. The product is the **architecture co-pilot / write+CI gate** for AI TypeScript. npm name is now **`arkgate`**.
+
+Questions: [github.com/pedroknigge/arkgate](https://github.com/pedroknigge/arkgate)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkgate",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "ArkGate — architecture co-pilot for AI TypeScript (write gate, CI gate, plan/loop)",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -40,6 +40,7 @@
     "docs/enthusiast",
     "docs/demos",
     "docs/ai-gates.md",
+    "docs/migrate-from-ark-runtime-kernel.md",
     "docs/ark-check-example.json",
     "docs/assets",
     "docs/brownfield-adoption.md",
@@ -117,9 +118,13 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pedroknigge/ark-runtime-kernel.git"
+    "url": "git+https://github.com/pedroknigge/arkgate.git"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "bugs": {
+    "url": "https://github.com/pedroknigge/arkgate/issues"
+  },
+  "homepage": "https://github.com/pedroknigge/arkgate#readme"
 }

package/server.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.pedroknigge/arkgate",
-  "description": "ArkGate \u2014 architecture co-pilot for AI TypeScript (write gate, CI, plan/loop)",
+  "description": "ArkGate — architecture co-pilot for AI TypeScript (write gate, CI, plan/loop)",
   "repository": {
-    "url": "https://github.com/pedroknigge/ark-runtime-kernel",
+    "url": "https://github.com/pedroknigge/arkgate",
     "source": "github"
   },
-  "version": "2.1.0",
+  "version": "2.2.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "arkgate",
-      "version": "2.1.0",
+      "version": "2.2.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/templates/skills/ark-upgrade.md

@@ -3,19 +3,29 @@ name: ark-upgrade
 description: Update arkgate to the latest published version, then refresh gates and /ark-* skills for every agent CLI and re-verify the architecture check. Autonomous.
 ---
 
-# /ark-upgrade — Update Ark and refresh its gates
+# /ark-upgrade — Update ArkGate and refresh its gates
 
 Update the `arkgate` dependency to the latest published version and
 bring the repo's generated artifacts and gates in line with it. This skill
 checks the registry itself — don't assume the copy in `node_modules` is current.
 
+**Still on `ark-runtime-kernel`?** Migrate first (same product, new package name):
+
+```bash
+npm uninstall ark-runtime-kernel && npm install -D arkgate
+npx arkgate-check --install-agent-gates --force
+```
+
+Guide: `docs/migrate-from-ark-runtime-kernel.md` in the package (or on GitHub).
+
 ## Fast path
 
 One command does the whole flow — update the package, refresh gates + `/ark-*` skills
 (and Codex home prompts), migrate command runners, and run the strict check:
 
 ```
-ark upgrade
+arkgate upgrade
+# (alias: ark upgrade)
 ```
 
 Use it when the user just wants the update done. Run the detailed steps below instead when