release: Devran AI Kit v4.2.1

.agent/CheatSheet.md

@@ -1,6 +1,6 @@
 # Devran AI Kit — CheatSheet
 
-> **Version**: v4.2.0 | **Quick Reference** for all capabilities
+> **Version**: v4.2.1 | **Quick Reference** for all capabilities
 > **Session**: Start with `/status`, end with session-end checklist
 
 ---

.agent/commands/help.md

@@ -24,7 +24,7 @@ Your complete guide to the Devran AI Kit. Type `/help` for a quick overview, or
 
 ## Quick Overview
 
-**Devran AI Kit v4.2.0** — Trust-Grade AI Development Framework
+**Devran AI Kit v4.2.1** — Trust-Grade AI Development Framework
 
 | Category | Count | Description |
 |:---------|:------|:------------|

.agent/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "kitVersion": "4.2.0",
+  "kitVersion": "4.2.1",
   "lastAuditedAt": null,
   "description": "Devran AI Kit — Trust-Grade AI Development Framework",
   "repository": "https://github.com/devran-ai/kit",

README.md

@@ -1,8 +1,8 @@
 # Devran AI Kit
 
-[![Version](https://img.shields.io/badge/version-4.2.0-blue.svg)](https://github.com/devran-ai/kit)
+[![Version](https://img.shields.io/badge/version-4.2.1-blue.svg)](https://github.com/devran-ai/kit)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-382%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-388%20passing-brightgreen.svg)](tests/)
 [![Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](package.json)
 [![AI Agents](https://img.shields.io/badge/AI%20Agents-23-purple.svg)](.agent/agents/)
 [![Skills](https://img.shields.io/badge/Skills-34-orange.svg)](.agent/skills/)
@@ -26,7 +26,7 @@
 | Self-healing CI | None | None | Auto-diagnoses and patches failures |
 | Cross-IDE support | Single IDE | Single IDE | 5 IDEs from one source of truth |
 | Plugin marketplace | None | None | Trust-verified skill marketplace |
-| Test suite | None | None | 382+ tests with security validation |
+| Test suite | None | None | 388+ tests with security validation |
 | Runtime dependencies | Varies | Varies | **Zero** |
 
 ## Quick Start
@@ -95,15 +95,31 @@ IDLE -> EXPLORE -> PLAN -> IMPLEMENT -> VERIFY -> CHECKPOINT -> REVIEW -> DEPLOY
 
 Each phase requires explicit developer approval before transitioning. The engine enforces governance rules and tracks session state across restarts.
 
-## What's New in v4.1.0
+## What's New
+
+### v4.2.1
+
+| Change | Details |
+|---|---|
+| Untrack hint | Detects tracked `.agent/` and prints `git rm --cached` command |
+| Documentation fixes | Updated release notes, stale test counts corrected |
+
+### v4.2.0
+
+| Change | Details |
+|---|---|
+| Gitignore by default | `kit init` adds `.agent/` to `.gitignore` — personal dev tooling |
+| `--shared` flag | Opt-in to commit `.agent/` for team sharing |
+| 388 tests | 37 test suites across unit, structural, and security |
+
+### v4.1.0
 
 | Change | Details |
 |---|---|
 | Cross-IDE support | Cursor, OpenCode, Codex, Antigravity — all from one manifest |
 | Multi-language reviewers | TypeScript, Python, Go dedicated review agents |
 | Continuous learning | Confidence scoring with time-based decay model |
 | MCP server templates | GitHub, Supabase, Vercel, PostgreSQL, Filesystem |
-| Test coverage | 382 tests (up from 348) across 36 test suites |
 
 ## Cross-IDE Support
 
@@ -200,7 +216,7 @@ kit/
 ├── create-kit-app/         # Project scaffolder
 ├── docs/                   # MkDocs documentation site
 ├── examples/               # Starter examples (minimal, full-stack)
-└── tests/                  # 382 tests (unit, structural, security)
+└── tests/                  # 388 tests (unit, structural, security)
 ```
 
 ## Security

bin/kit.js

@@ -330,9 +330,10 @@ function initCommand(options) {
 
   // Add .agent/ to .gitignore (unless --shared)
   if (!options.shared) {
+    const { addToGitignore } = require('../lib/io');
+    const { execSync } = require('child_process');
     logStep(`${currentStep}/${totalSteps}`, 'Configuring .gitignore...');
     try {
-      const { addToGitignore } = require('../lib/io');
       const result = addToGitignore(targetDir);
       if (result.added) {
         log('   ✓ .agent/ added to .gitignore (local dev tooling)', 'green');
@@ -342,6 +343,18 @@ function initCommand(options) {
     } catch (err) {
       log(`   ⚠️  Could not update .gitignore: ${err.message}`, 'yellow');
     }
+    // Detect if .agent/ is still git-tracked despite being gitignored
+    try {
+      const tracked = execSync('git ls-files .agent/', { cwd: targetDir, encoding: 'utf-8' }).trim();
+      if (tracked.length > 0) {
+        log('', 'reset');
+        log('   ⚠️  .agent/ is gitignored but still tracked by git.', 'yellow');
+        log('   Run this to untrack (keeps local files):', 'yellow');
+        log(`   ${colors.cyan}git rm -r --cached .agent/${colors.reset}`, 'reset');
+      }
+    } catch (err) {
+      // Not a git repo or git not available — skip hint
+    }
   } else {
     logStep(`${currentStep}/${totalSteps}`, 'Shared mode — .agent/ will be committed');
     log('   ℹ .gitignore not modified (--shared flag)', 'cyan');

docs/architecture.md

@@ -1,14 +1,14 @@
 # Architecture
 
-Devran AI Kit v4.2.0 is an engineered framework with a **29-module runtime engine**, 23 agents, 34 skills, 37 commands, and 21 workflows.
+Devran AI Kit v4.2.1 is an engineered framework with a **29-module runtime engine**, 23 agents, 34 skills, 37 commands, and 21 workflows.
 
 ---
 
 ## Architecture Overview
 
 ```
 ┌─────────────────────────────────────────────────────────────────────┐
-│                      DEVRAN AI KIT v4.2.0                       │
+│                      DEVRAN AI KIT v4.2.1                       │
 ├─────────────────────────────────────────────────────────────────────┤
 │                                                                      │
 │  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐      │

docs/index.md

@@ -88,10 +88,15 @@ This isn't just a collection of prompts. It's an **engineered framework** that e
 
 ---
 
-## What's New in v4.1.0
+## What's New in v4.2.1
 
-- **Cross-IDE Support** — Native config generation for Claude Code, Antigravity, Cursor, OpenCode, and Codex from a single `manifest.json`
-- **3 New Agents** — Mobile Developer, Database Specialist, and PR Reviewer join the 20 existing agents
-- **Plugin Marketplace** — Browse, install, and manage trust-verified skills with `kit market`
-- **Self-Healing CI** — Auto-diagnose and patch CI failures with `kit heal`
-- **Aggregated Health Check** — Single `kit health` command covers error budget, plugin integrity, config validation, and healing status
+- **Untrack hint** — Detects tracked `.agent/` and prints the `git rm --cached` command
+- **Documentation fixes** — Updated release notes, stale test counts corrected
+
+## What's New in v4.2.0
+
+- **Gitignore by default** — `kit init` adds `.agent/` to `.gitignore` automatically. Personal dev tooling stays local.
+- **`--shared` flag** — Opt-in for teams that want to commit `.agent/` to the repo
+- **Cross-IDE Support** — Native config generation for Claude Code, Antigravity, Cursor, OpenCode, and Codex
+- **3 Language Reviewers** — TypeScript, Python, Go specialized code review agents
+- **388 tests** — 37 test suites across unit, structural, and security

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devran-ai/kit",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "Trust-grade AI development framework — zero-dependency runtime engine for agent orchestration, workflow governance, and skill management.",
   "main": "bin/kit.js",
   "bin": {