@nolrm/contextkit 0.12.14 → 0.12.17

package/README.md

@@ -213,6 +213,14 @@ Pass multiple tasks to `/squad` and it automatically runs in batch mode:
 # Phase 2: dev→test→review pipeline runs in parallel per task
 ```
 
+**Model routing (Claude Code only):** Set `model_routing: true` in `.contextkit/squad/config.md` to have `/squad-auto` automatically use Claude Haiku for Dev and Test phases. Architect and Review always run on your primary model. Saves ~35% tokens with no quality loss — the standards files and Review gate maintain quality.
+
+```markdown
+# .contextkit/squad/config.md
+checkpoint: po
+model_routing: true   # dev + test → Haiku, architect + review → primary model
+```
+
 ### Feedback Loop
 
 Any downstream role can raise questions for an upstream role. When this happens, the pipeline pauses and directs you to the right command:
@@ -288,8 +296,6 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 - ⚡ **Zero Config** - Auto-detects project type and package manager
 - ✅ **Policy Enforcement** - Configurable validation with `ck check`
 - 📝 **Corrections Tracking** - Track AI performance issues with corrections log
-- 🔄 **Workflow Orchestration** - Structured workflows with `ck run`
-- 📦 **Registry System** - Share standards across teams with `ck publish/pull`
 - 📊 **Observability Dashboard** - Visual metrics and compliance tracking
 
 ## Commands
@@ -297,7 +303,7 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 ```bash
 # Installation & Setup
 ck install            # set up .contextkit + pick AI tool interactively
-ck install claude     # set up .contextkit + Claude (no prompt)
+ck install claude     # set up .contextkit + Claude, or add Claude to an existing install
 ck claude      # add Claude Code integration (CLAUDE.md + rules)
 ck cursor      # add Cursor integration (scoped .mdc rules)
 ck copilot     # add GitHub Copilot integration
@@ -322,23 +328,14 @@ ck check --strict  # treat warnings as errors
 ck note "message"  # add note to corrections log
 ck note "AI issue" --category "AI Behavior" --priority HIGH
 
-# Workflow Orchestration
-ck run <workflow>  # run structured workflow
-ck run create-component  # example workflow
-ck run create-component --interactive  # interactive mode
-
-# Registry & Versioning
-ck publish --name @company/react-standards --version 1.0.0
-ck pull @company/react-standards@1.0.0
-ck pull @company/react-standards@latest --backup
+# Squad — multi-role AI pipeline (slash commands in your AI tool)
+/squad "add dark mode"   # PO writes spec
+/squad-auto              # runs architect → dev → test → review hands-free
+/squad-reset             # clear stuck or mixed squad state
 
 # Observability
 ck dashboard   # start web dashboard
 ck dashboard --no-server  # CLI metrics only
-
-# AI Usage (loads .contextkit context automatically)
-ck "create a button"  # quick AI chat with context
-ck ai "create a button"  # explicit AI command
 ```
 
 ## Links

package/bin/contextkit.js

@@ -27,7 +27,7 @@ program
   .option('--non-interactive', 'Skip interactive prompts')
   .action(async (platform, options) => {
     try {
-      await install({ ...options, ...(platform ? { platform, fullInstall: true } : { fullInstall: true }) });
+      await install({ ...options, ...(platform ? { platform } : { fullInstall: true }) });
     } catch (error) {
       console.error(chalk.red('Installation failed:'), error.message);
       process.exit(1);

package/lib/commands/install.js

@@ -9,6 +9,7 @@ const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
 const GitHooksManager = require('../utils/git-hooks');
 const StatusManager = require('../utils/status-manager');
+const { printBanner } = require('../utils/banner');
 
 class InstallCommand {
   constructor() {
@@ -69,6 +70,7 @@ class InstallCommand {
     }
 
     // Full installation
+    printBanner();
     console.log(chalk.magenta('🎵 Installing ContextKit...'));
     console.log('');
 
@@ -728,6 +730,10 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         `${this.repoUrl}/commands/squad-auto-parallel.md`,
         '.contextkit/commands/squad-auto-parallel.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-reset.md`,
+        '.contextkit/commands/squad-reset.md'
+      );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(

package/lib/commands/update.js

@@ -6,6 +6,7 @@ const path = require('path');
 const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
 const GitHooksManager = require('../utils/git-hooks');
+const { printBanner } = require('../utils/banner');
 
 class UpdateCommand {
   constructor() {
@@ -16,6 +17,7 @@ class UpdateCommand {
   }
 
   async update(options = {}) {
+    printBanner();
     console.log(chalk.magenta('🔄 Updating ContextKit...'));
 
     // Check if ContextKit is installed
@@ -55,6 +57,9 @@ class UpdateCommand {
       // Download latest files
       await this.downloadFiles(projectType);
 
+      // Remove files that were removed from CK
+      await this.removeLegacyFiles();
+
       // Restore user configuration
       await this.restoreUserConfig(config);
 
@@ -282,6 +287,10 @@ class UpdateCommand {
         `${this.repoUrl}/commands/squad-auto-parallel.md`,
         '.contextkit/commands/squad-auto-parallel.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-reset.md`,
+        '.contextkit/commands/squad-reset.md'
+      );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
@@ -401,6 +410,17 @@ commands:
     }
   }
 
+  async removeLegacyFiles() {
+    const legacyFiles = [
+      '.contextkit/commands/squad-peer-review.md',
+    ];
+    for (const file of legacyFiles) {
+      if (await fs.pathExists(file)) {
+        await fs.remove(file);
+      }
+    }
+  }
+
   async updateConfigVersion(version) {
     const configContent = await fs.readFile('.contextkit/config.yml', 'utf8');
     const updatedContent = configContent.replace(

package/lib/integrations/claude-integration.js

@@ -24,6 +24,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-review.md',
       '.claude/commands/squad-auto.md',
       '.claude/commands/squad-auto-parallel.md',
+      '.claude/commands/squad-reset.md',
       '.claude/commands/spec.md',
       '.claude/commands/ck.md',
     ];
@@ -44,6 +45,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/rules/vibe-kit-testing.md',
       '.claude/rules/vibe-kit-code-style.md',
       '.claude/commands/squad-batch.md',
+      '.claude/commands/squad-peer-review.md',
     ];
     for (const file of legacyFiles) {
       if (await fs.pathExists(file)) {
@@ -252,6 +254,13 @@ Run after \`/squad\` kickoff. Automatically runs architect → dev → test →
 Read \`.contextkit/commands/squad-auto-parallel.md\` and execute the parallel pipeline workflow.
 
 Spawn one subagent per task per phase using the Task tool, so all tasks progress simultaneously instead of sequentially. Use this after \`/squad\` batch kickoff for faster execution on multi-task batches.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/squad-reset.md', `# Squad — Reset
+
+Read \`.contextkit/commands/squad-reset.md\` and execute the reset workflow.
+
+Delete the current squad state (.contextkit/squad/) so you can start fresh. Use when the squad folder is in a mixed or stuck state.
 `);
 
     await this.writeGeneratedFile('.claude/commands/ck.md', `# ContextKit Health Check

package/lib/utils/banner.js

@@ -0,0 +1,47 @@
+const chalk = require('chalk');
+
+// ── ASCII art ──────────────────────────────────────────────────────────────
+
+const LINES = [
+  '   ______                     __                     __     __ __    _    __     ',
+  '  / ____/  ____     ____     / /_   ___     _  __   / /_   / //_/   (_)  / /_    ',
+  ' / /      / __ \\   / __ \\   / __/  / _ \\   | |/_/  / __/  / ,<     / /  / __/    ',
+  '/ /___   / /_/ /  / / / /  / /_   /  __/  _>  <   / /_   / /| |   / /  / /_      ',
+  '\\____/   \\____/  /_/ /_/   \\__/   \\___/  /_/|_|   \\__/  /_/ |_|  /_/   \\__/      ',
+];
+
+// ── Color helpers ──────────────────────────────────────────────────────────
+
+/**
+ * Convert HSL (h: 0–360, s: 0–100, l: 0–100) to [r, g, b] (0–255).
+ * Standard algorithm — no dependencies.
+ */
+function hslToRgb(h, s, l) {
+  s /= 100;
+  l /= 100;
+  const k = n => (n + h / 30) % 12;
+  const a = s * Math.min(l, 1 - l);
+  const f = n => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));
+  return [Math.round(f(0) * 255), Math.round(f(8) * 255), Math.round(f(4) * 255)];
+}
+
+// ── Banner ─────────────────────────────────────────────────────────────────
+
+function printBanner() {
+  const maxLen = Math.max(...LINES.map(l => l.length));
+
+  console.log('');
+  LINES.forEach(line => {
+    const colored = line.split('').map((char, i) => {
+      if (char === ' ') return ' ';
+      // Cycle hues 20–290°: warm red → yellow → green → cyan → blue
+      const hue = (i / maxLen) * 270 + 20;
+      const [r, g, b] = hslToRgb(hue, 100, 65);
+      return chalk.rgb(r, g, b)(char);
+    }).join('');
+    console.log(colored);
+  });
+  console.log('');
+}
+
+module.exports = { printBanner, hslToRgb };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.12.14",
+  "version": "0.12.17",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {