@nolrm/contextkit 0.12.15 → 0.12.19

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:
@@ -295,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
@@ -310,6 +318,7 @@ ck vscode      # alias for copilot
 # Analysis & Updates
 /analyze       # customize standards to your project (slash command in your AI tool)
 ck update      # pull latest commands/hooks — preserves your analyzed standards
+               # updates are also flagged automatically after each ck command (24h cache)
 ck status      # check install & integrations
 
 # Validation & Compliance

package/bin/contextkit.js

@@ -12,6 +12,9 @@ const publish = require('../lib/commands/publish');
 const pull = require('../lib/commands/pull');
 const dashboard = require('../lib/commands/dashboard');
 const packageJson = require('../package.json');
+const { checkForUpdates } = require('../lib/utils/notifier');
+
+checkForUpdates();
 
 // Set up the CLI
 program
@@ -27,7 +30,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('');
 
@@ -732,6 +734,10 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         `${this.repoUrl}/commands/squad-reset.md`,
         '.contextkit/commands/squad-reset.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/health-check.md`,
+        '.contextkit/commands/health-check.md'
+      );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
@@ -790,7 +796,6 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
     await this.createCorrectionsLog();
     await this.createMetaInstructions();
     await this.createPolicyFile();
-    await this.createHealthCheckCommand();
 
     // Install CLI helpers
     await this.installCLIHelpers();
@@ -1590,58 +1595,6 @@ enforcement:
     console.log(chalk.green('✅ Policy file created'));
   }
 
-  async createHealthCheckCommand() {
-    const healthCheckContent = `# ContextKit Health Check
-
-Check this project's ContextKit setup and report status.
-
-## Steps
-
-1. Check if \`.contextkit/\` directory exists. If not → STOP and tell user: "Run \`ck install\` to set up ContextKit."
-
-2. Read \`.contextkit/config.yml\` and check the \`last_analyzed\` field.
-
-3. Check each standards file for skeleton markers. Read these files and check if they contain \`<!-- Content will be generated by running: /analyze -->\`:
-   - \`.contextkit/standards/code-style.md\`
-   - \`.contextkit/standards/testing.md\`
-   - \`.contextkit/standards/architecture.md\`
-   - \`.contextkit/standards/ai-guidelines.md\`
-   - \`.contextkit/standards/workflows.md\`
-   - \`.contextkit/standards/glossary.md\`
-
-4. Check product files for placeholder content (e.g., \`[ELEVATOR_PITCH_FROM_MISSION_MD]\`):
-   - \`.contextkit/product/mission-lite.md\`
-   - \`.contextkit/product/decisions.md\`
-   - \`.contextkit/product/roadmap.md\`
-
-5. Check which platform integrations exist:
-   - \`CLAUDE.md\` → Claude Code
-   - \`.cursor/rules/\` → Cursor
-   - \`AGENTS.md\` → Codex
-   - \`GEMINI.md\` → Gemini
-   - \`CONVENTIONS.md\` → Aider
-   - \`.windsurfrules\` → Windsurf
-   - \`.github/copilot-instructions.md\` → Copilot
-
-6. Report findings as a status summary table and list recommended next steps.
-
-## Output Format
-
-| Area | Status | Action |
-|------|--------|--------|
-| Installation | OK/Missing | \`ck install\` |
-| Standards | Populated/Skeleton | \`ck analyze\` or \`/analyze\` |
-| Product context | Populated/Placeholder | Edit \`.contextkit/product/\` files |
-| Integrations | List active | \`ck <platform>\` to add more |
-
-## Token Note
-
-If standards are still skeletons, warn that @imports in CLAUDE.md are loading empty files — wasting context tokens. Run \`/analyze\` to populate them.
-`;
-
-    await fs.writeFile('.contextkit/commands/health-check.md', healthCheckContent);
-  }
-
   showSuccessMessage(hookChoices, platform = null, projectType = '', packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));

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
@@ -289,6 +291,10 @@ class UpdateCommand {
         `${this.repoUrl}/commands/squad-reset.md`,
         '.contextkit/commands/squad-reset.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/health-check.md`,
+        '.contextkit/commands/health-check.md'
+      );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(

package/lib/integrations/claude-integration.js

@@ -82,11 +82,16 @@ The following standards are auto-loaded into context via @imports:
   }
 
   async generateFiles() {
+    const { version } = require('../../package.json');
+
     // Bridge file: CLAUDE.md (auto-loaded every session)
     const bridgeContent = `# Project Standards (ContextKit)
 
 This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
 
+## ContextKit
+Version: ${version}
+
 ${this.getStandardsBlock()}
 
 ## Corrections Log

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/lib/utils/notifier.js

@@ -0,0 +1,17 @@
+const updateNotifier = require('update-notifier');
+const pkg = require('../../package.json');
+
+/**
+ * Check for available updates to @nolrm/contextkit on npm.
+ * Results are cached for 24 hours. Notification prints after the command
+ * completes. Suppressed automatically in CI environments.
+ */
+function checkForUpdates() {
+  try {
+    updateNotifier({ pkg }).notify();
+  } catch (err) {
+    // Never crash the CLI due to a notifier failure
+  }
+}
+
+module.exports = { checkForUpdates };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.12.15",
+  "version": "0.12.19",
   "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": {
@@ -69,7 +69,8 @@
     "fs-extra": "^11.1.1",
     "inquirer": "^8.2.6",
     "js-yaml": "^4.1.0",
-    "ora": "^5.4.1"
+    "ora": "^5.4.1",
+    "update-notifier": "^5.1.0"
   },
   "files": [
     "bin/",