From 38bb57723fc2be3132676b6bc4e87926b93d54e4 Mon Sep 17 00:00:00 2001 From: emredursun Date: Fri, 10 Apr 2026 03:18:27 +0200 Subject: [PATCH 1/2] =?UTF-8?q?fix:=20v5.2.7=20=E2=80=94=20kit=20update=20?= =?UTF-8?q?now=20fixes=20missing=20gitignore=20entries=20(#29)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `kit update` was missing the `addToGitignore()` call, so projects upgraded from older Kit versions kept stale gitignore — leaving `.cursor/commands/` and other bridge dirs untracked in git status. Now `kit update` runs the full 4-step gitignore pipeline: narrow → cleanup → addToGitignore → worktree regeneration. 1018 tests passing (53 files). --- .agent/CheatSheet.md | 2 +- .agent/commands/help.md | 2 +- .agent/manifest.json | 2 +- .agent/session-context.md | 2 +- CHANGELOG.md | 11 +++++++++ README.md | 2 +- docs/architecture.md | 2 +- lib/updater.js | 11 ++++++++- package-lock.json | 4 +-- package.json | 2 +- tests/unit/updater.test.js | 50 ++++++++++++++++++++++++++++++++++++++ 11 files changed, 80 insertions(+), 10 deletions(-) diff --git a/.agent/CheatSheet.md b/.agent/CheatSheet.md index 1b916f6..5ed2dc4 100644 --- a/.agent/CheatSheet.md +++ b/.agent/CheatSheet.md @@ -1,6 +1,6 @@ # Devran AI Kit — CheatSheet -> **Version**: v5.2.6 | **Quick Reference** for all capabilities +> **Version**: v5.2.7 | **Quick Reference** for all capabilities > **Session**: Start with `/project-status`, end with session-end checklist --- diff --git a/.agent/commands/help.md b/.agent/commands/help.md index ea8e9b2..fa58080 100644 --- a/.agent/commands/help.md +++ b/.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 v5.2.6** — Trust-Grade AI Development Framework +**Devran AI Kit v5.2.7** — Trust-Grade AI Development Framework | Category | Count | Description | |:---------|:------|:------------| diff --git a/.agent/manifest.json b/.agent/manifest.json index 8fc075c..6d687de 100644 --- a/.agent/manifest.json +++ b/.agent/manifest.json @@ -1,6 +1,6 @@ { "schemaVersion": "1.0.0", - "kitVersion": "5.2.6", + "kitVersion": "5.2.7", "lastAuditedAt": null, "description": "Devran AI Kit — Trust-Grade AI Development Framework", "repository": "https://github.com/devran-ai/kit", diff --git a/.agent/session-context.md b/.agent/session-context.md index fb2652b..7f3e279 100644 --- a/.agent/session-context.md +++ b/.agent/session-context.md @@ -32,7 +32,7 @@ **Branch**: — **Repository**: — -**Framework**: Devran AI Kit v5.2.6 +**Framework**: Devran AI Kit v5.2.7 ### Key File Locations diff --git a/CHANGELOG.md b/CHANGELOG.md index 2f0d07c..e7af480 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,17 @@ All notable changes to Devran AI Kit will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [5.2.7] — 2026-04-10 + +### Fixed + +- **`kit update` missing gitignore pipeline** — `addToGitignore()` was not called during updates, leaving projects with stale gitignore entries after upgrade. Existing projects missing `.cursor/commands/`, `.opencode/commands/`, or other bridge entries will now be auto-fixed on `kit update`. + +### Added + +- 3 new updater tests: gitignore narrowing, missing entry addition, and no-gitignore creation during update +- Test count: 1015 → 1018 (53 files) + ## [5.2.6] — 2026-04-09 ### Fixed diff --git a/README.md b/README.md index d86bcc9..d3dc969 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@

- Version + Version License Tests Dependencies diff --git a/docs/architecture.md b/docs/architecture.md index 9b6d86b..d96f76b 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,6 +1,6 @@ # Architecture -Devran AI Kit v5.2.6 is an engineered framework with a **43-module runtime engine**, 26 agents, 39 skills, 40 commands, 25 workflows, and 15 governance rules. +Devran AI Kit v5.2.7 is an engineered framework with a **43-module runtime engine**, 26 agents, 39 skills, 40 commands, 25 workflows, and 15 governance rules. --- diff --git a/lib/updater.js b/lib/updater.js index db44bd4..57cf0db 100644 --- a/lib/updater.js +++ b/lib/updater.js @@ -268,7 +268,16 @@ function applyUpdate(sourceRoot, targetRoot, dryRun = false) { report.warnings.push(`Legacy gitignore cleanup failed: ${err.message}`); } - // Step 3: Regenerate worktree support files + // Step 3: Add any missing gitignore entries (bridges, configs, worktreeinclude) + try { + const { addToGitignore } = require('./io'); + addToGitignore(targetRoot, detectedIDEs); + } catch (err) { + report.warnings = report.warnings || []; + report.warnings.push(`Gitignore entry addition failed: ${err.message}`); + } + + // Step 4: Regenerate worktree support files try { const { generateWorktreeInclude, installPostCheckoutHook } = require('./worktree'); generateWorktreeInclude(targetRoot, detectedIDEs); diff --git a/package-lock.json b/package-lock.json index b8b5b14..da20fcc 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@devran-ai/kit", - "version": "5.2.6", + "version": "5.2.7", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@devran-ai/kit", - "version": "5.2.6", + "version": "5.2.7", "hasInstallScript": true, "license": "MIT", "bin": { diff --git a/package.json b/package.json index 489d28e..46ee426 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@devran-ai/kit", - "version": "5.2.6", + "version": "5.2.7", "description": "Trust-grade AI development framework — zero-dependency runtime engine for agent orchestration, workflow governance, and skill management.", "main": "bin/kit.js", "bin": { diff --git a/tests/unit/updater.test.js b/tests/unit/updater.test.js index 6a70f48..cb69493 100644 --- a/tests/unit/updater.test.js +++ b/tests/unit/updater.test.js @@ -149,3 +149,53 @@ describe('CLI Updater — Non-Destructive Merge', () => { expect(report.added.length).toBeGreaterThan(0); }); }); + +describe('CLI Updater — Gitignore Pipeline', () => { + beforeEach(() => { setupTestDirs(); }); + afterEach(() => { teardownTestDirs(); }); + + it('should add missing .cursor/commands/ to gitignore during update', async () => { + // Simulate a project that has .gitignore with only .claude/ blanket ignore + const gitignorePath = path.join(TMP_TARGET, '.gitignore'); + fs.writeFileSync(gitignorePath, 'node_modules/\n.claude/\n', 'utf-8'); + + const updater = await loadUpdater(); + updater.applyUpdate(TMP_SOURCE, TMP_TARGET); + + const content = fs.readFileSync(gitignorePath, 'utf-8'); + // narrowBlanketClaudeIgnore should have narrowed .claude/ to .claude/commands/ + expect(content).toContain('.claude/commands/'); + // addToGitignore should have added .cursor/commands/ if cursor detected + expect(content).toContain('.agent/'); + }); + + it('should narrow blanket .claude/ to .claude/commands/ during update', async () => { + const gitignorePath = path.join(TMP_TARGET, '.gitignore'); + fs.writeFileSync(gitignorePath, 'node_modules/\n.claude/\n.agent/\n', 'utf-8'); + + const updater = await loadUpdater(); + updater.applyUpdate(TMP_SOURCE, TMP_TARGET); + + const content = fs.readFileSync(gitignorePath, 'utf-8'); + // Should have narrowed blanket .claude/ to .claude/commands/ + expect(content).toContain('.claude/commands/'); + // Should not have the blanket pattern anymore + const lines = content.split('\n').map(l => l.trim()); + expect(lines).not.toContain('.claude/'); + }); + + it('should add gitignore entries even when no .gitignore exists', async () => { + const gitignorePath = path.join(TMP_TARGET, '.gitignore'); + // Ensure no .gitignore exists + if (fs.existsSync(gitignorePath)) fs.unlinkSync(gitignorePath); + + const updater = await loadUpdater(); + updater.applyUpdate(TMP_SOURCE, TMP_TARGET); + + // addToGitignore creates .gitignore if missing + expect(fs.existsSync(gitignorePath)).toBe(true); + const content = fs.readFileSync(gitignorePath, 'utf-8'); + expect(content).toContain('.agent/'); + expect(content).toContain('.claude/commands/'); + }); +}); From 30471ca87d2a9580af7d6ad5d563ccdab6d2a487 Mon Sep 17 00:00:00 2001 From: emredursun Date: Fri, 10 Apr 2026 03:27:41 +0200 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20sync=20documentation=20to=20v5.2.7?= =?UTF-8?q?=20=E2=80=94=20test=20counts,=20module=20listing,=20What's=20Ne?= =?UTF-8?q?w?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README: test badge 1015 → 1018, comparison table count updated, What's New section adds v5.2.7 entry - architecture.md: ASCII banner version 5.2.5 → 5.2.7, runtime engine module table expanded from 4 phases (21 modules listed) to 6 phases (43 modules fully enumerated), directory tree adds command-bridge, worktree, io, telegram-sync; test count 1015 → 1018 --- README.md | 10 ++++++---- docs/architecture.md | 22 ++++++++++++++-------- 2 files changed, 20 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index d3dc969..69d6def 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@

Version License - Tests + Tests Dependencies

@@ -43,7 +43,7 @@ | Cross-IDE support | Single IDE | Single IDE | 5 IDEs from one source of truth | | Plugin marketplace | None | None | Trust-verified skill marketplace | | Telegram control | None | None | Full IDE control from your phone | -| Test suite | None | None | 1015 tests with security validation | +| Test suite | None | None | 1018 tests with security validation | | Runtime dependencies | Varies | Varies | **Zero** | ## Quick Start @@ -117,7 +117,9 @@ Onboarding (`/greenfield` or `/brownfield`) is a one-time pre-SDLC phase. Each s See the full **[CHANGELOG](CHANGELOG.md)** for detailed release notes. -**Latest (v5.2.6):** Fixed Claude Code CLI slash command discovery — blanket `.claude/` gitignore narrowed to `.claude/commands/` for proper directory discovery. New `narrowBlanketClaudeIgnore()` migration function. CRLF-safe regex patterns. `path.isAbsolute()` guards on all gitignore functions. 1015 tests passing. +**Latest (v5.2.7):** `kit update` now runs the full gitignore pipeline — projects upgraded from older Kit versions get missing `.cursor/commands/`, `.opencode/commands/`, and other bridge entries auto-fixed. 1018 tests passing. + +**v5.2.6:** Fixed Claude Code CLI slash command discovery — blanket `.claude/` gitignore narrowed to `.claude/commands/` for proper directory discovery. New `narrowBlanketClaudeIgnore()` migration function. CRLF-safe regex patterns. **v5.2.5:** Complete gitignore coverage — `kit init` now gitignores all generated artifacts (bridge dirs, IDE configs, `.worktreeinclude`) so `git status` stays clean. @@ -231,7 +233,7 @@ kit/ ├── create-kit-app/ # Project scaffolder ├── docs/ # MkDocs documentation site ├── examples/ # Starter examples (minimal, full-stack) -└── tests/ # 1015 tests (unit, structural, integration, security) +└── tests/ # 1018 tests (unit, structural, integration, security) ``` ## Security diff --git a/docs/architecture.md b/docs/architecture.md index d96f76b..dd01390 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -8,7 +8,7 @@ Devran AI Kit v5.2.7 is an engineered framework with a **43-module runtime engin ``` ┌─────────────────────────────────────────────────────────────────────┐ -│ DEVRAN AI KIT v5.2.5 │ +│ DEVRAN AI KIT v5.2.7 │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ @@ -43,7 +43,7 @@ Devran AI Kit v5.2.7 is an engineered framework with a **43-module runtime engin │ │ RUNTIME ENGINE (43 modules) │ │ │ │ workflow-engine • session-manager • task-governance │ │ │ │ agent-reputation • self-healing • marketplace │ │ -│ │ plugin-system • identity • conflict-detector • + 12 │ │ +│ │ plugin-system • identity • command-bridge • worktree │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ @@ -96,10 +96,12 @@ Node.js runtime modules that enforce governance, manage state, and provide platf | Phase | Modules | |:---|:---| -| **Phase 1 — Foundation** | `workflow-engine`, `session-manager`, `verify`, `updater`, `error-budget` | -| **Phase 2 — Runtime** | `workflow-persistence`, `agent-registry`, `loading-engine`, `hook-system`, `task-model` | -| **Phase 3 — Collaboration** | `identity`, `task-governance`, `skill-sandbox`, `conflict-detector`, `security-scanner`, `plugin-system` | -| **Phase 4 — Platform** | `agent-reputation`, `engineering-manager`, `self-healing`, `marketplace`, `cli-commands` | +| **Phase 1 — Foundation** | `workflow-engine`, `session-manager`, `verify`, `updater`, `error-budget`, `io`, `constants`, `logger` | +| **Phase 2 — Runtime** | `workflow-persistence`, `workflow-events`, `agent-registry`, `loading-engine`, `hook-system`, `task-model`, `learning-engine` | +| **Phase 3 — Collaboration** | `identity`, `task-governance`, `skill-sandbox`, `conflict-detector`, `security-scanner`, `plugin-system`, `plugin-verifier` | +| **Phase 4 — Platform** | `agent-reputation`, `engineering-manager`, `self-healing`, `marketplace`, `cli-commands`, `commands/init` | +| **Phase 5 — IDE & Bridge** | `command-bridge`, `ide-generator`, `project-ide-generator`, `worktree`, `config-validator`, `doc-discovery`, `doc-generator` | +| **Phase 6 — Integrations** | `telegram-sync`, `telegram-menu-guard`, `market-research`, `circuit-breaker`, `rate-limiter`, `quality-score`, `decision-validator`, `onboarding-engine` | ### Rules & Hooks @@ -129,9 +131,13 @@ lib/ # Runtime Engine (43 modules) ├── agent-reputation.js # Score tracking & rankings ├── self-healing.js # CI failure detection & patch generation ├── marketplace.js # Community skill marketplace -└── + 17 more modules # Identity, plugins, hooks, registry... +├── command-bridge.js # Cross-IDE slash command bridge generation +├── worktree.js # Git worktree support (.worktreeinclude, post-checkout) +├── io.js # Gitignore management (narrow, cleanup, addToGitignore) +├── telegram-sync.js # Telegram bot menu synchronization +└── + 14 more modules # Identity, plugins, hooks, registry... -tests/ # 1015 tests (53 files) +tests/ # 1018 tests (53 files) ├── unit/ # Module tests ├── structural/ # Inventory + schema validation ├── integration/ # Cross-module tests