@nolrm/contextkit 0.13.5 → 0.14.0

package/lib/commands/update.js

@@ -1,7 +1,6 @@
 const chalk = require('chalk');
 const ora = require('ora');
 const fs = require('fs-extra');
-const path = require('path');
 
 const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
@@ -22,7 +21,7 @@ class UpdateCommand {
     console.log(chalk.magenta('🔄 Updating ContextKit...'));
 
     // Check if ContextKit is installed
-    if (!await fs.pathExists('.contextkit/config.yml')) {
+    if (!(await fs.pathExists('.contextkit/config.yml'))) {
       console.log(chalk.red('❌ No ContextKit installation found in current directory'));
       console.log(chalk.yellow('💡 Run: contextkit install'));
       return;
@@ -36,7 +35,9 @@ class UpdateCommand {
     }
 
     if (updateInfo.hasUpdate) {
-      console.log(chalk.blue(`📦 Updating from ${updateInfo.currentVersion} to ${updateInfo.latestVersion}`));
+      console.log(
+        chalk.blue(`📦 Updating from ${updateInfo.currentVersion} to ${updateInfo.latestVersion}`)
+      );
     }
 
     // Create backup
@@ -75,7 +76,7 @@ class UpdateCommand {
       // Update Git hooks if they were enabled
       const hookChoices = {
         prePush: config.features?.pre_push_hook || config.features?.git_hooks || false,
-        commitMsg: config.features?.commit_msg_hook || config.features?.git_hooks || false
+        commitMsg: config.features?.commit_msg_hook || config.features?.git_hooks || false,
       };
       if (hookChoices.prePush || hookChoices.commitMsg) {
         await this.gitHooksManager.installHooks(packageManager, hookChoices);
@@ -88,7 +89,6 @@ class UpdateCommand {
       await this.updateConfigVersion(updateInfo.latestVersion || '1.0.0');
 
       console.log(chalk.green('✅ ContextKit updated successfully!'));
-
     } catch (error) {
       console.log(chalk.red('❌ Update failed, restoring from backup...'));
       await this.restoreFromBackup(backupPath);
@@ -104,25 +104,28 @@ class UpdateCommand {
   async checkForUpdates() {
     try {
       const axios = require('axios');
-      const response = await axios.get('https://api.github.com/repos/nolrm/contextkit/releases/latest', {
-        timeout: 5000
-      });
-      
+      const response = await axios.get(
+        'https://api.github.com/repos/nolrm/contextkit/releases/latest',
+        {
+          timeout: 5000,
+        }
+      );
+
       const latestVersion = response.data.tag_name.replace('v', '');
       const currentVersion = await this.getCurrentVersion();
       const hasUpdate = this.isNewerVersion(latestVersion, currentVersion);
-      
+
       return {
         hasUpdate,
         currentVersion,
-        latestVersion
+        latestVersion,
       };
     } catch (error) {
       return {
         hasUpdate: true, // Assume update available if we can't check
         currentVersion: await this.getCurrentVersion(),
         latestVersion: 'latest',
-        error: error.message
+        error: error.message,
       };
     }
   }
@@ -139,22 +142,22 @@ class UpdateCommand {
   isNewerVersion(latest, current) {
     const latestParts = latest.split('.').map(Number);
     const currentParts = current.split('.').map(Number);
-    
+
     for (let i = 0; i < Math.max(latestParts.length, currentParts.length); i++) {
       const latestPart = latestParts[i] || 0;
       const currentPart = currentParts[i] || 0;
-      
+
       if (latestPart > currentPart) return true;
       if (latestPart < currentPart) return false;
     }
-    
+
     return false;
   }
 
   async createBackup() {
     const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
     const backupPath = `.contextkit-backup-${timestamp}`;
-    
+
     await fs.copy('.contextkit', backupPath);
     return backupPath;
   }
@@ -167,7 +170,7 @@ class UpdateCommand {
   async parseConfig() {
     const configContent = await fs.readFile('.contextkit/config.yml', 'utf8');
     const config = {};
-    
+
     // Simple YAML parsing for our config format
     const lines = configContent.split('\n');
     for (const line of lines) {
@@ -207,7 +210,8 @@ class UpdateCommand {
         config.features.commit_msg_hook = trimmed.split('commit_msg_hook:')[1].trim() === 'true';
       } else if (trimmed.startsWith('squad_ci_workflow:')) {
         config.features = config.features || {};
-        config.features.squad_ci_workflow = trimmed.split('squad_ci_workflow:')[1].trim() === 'true';
+        config.features.squad_ci_workflow =
+          trimmed.split('squad_ci_workflow:')[1].trim() === 'true';
       }
     }
 
@@ -223,7 +227,7 @@ class UpdateCommand {
         `${this.repoUrl}/standards/README.md`,
         '.contextkit/standards/README.md'
       );
-      
+
       // Keep glossary updated (universal file)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/standards/glossary.md`,
@@ -232,104 +236,116 @@ class UpdateCommand {
 
       // Download commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/analyze.md`,
-        '.contextkit/commands/analyze.md'
+        `${this.repoUrl}/commands/dev/analyze.md`,
+        '.contextkit/commands/dev/analyze.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/review.md`,
-        '.contextkit/commands/review.md'
+        `${this.repoUrl}/commands/dev/review.md`,
+        '.contextkit/commands/dev/review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/fix.md`,
-        '.contextkit/commands/fix.md'
+        `${this.repoUrl}/commands/dev/fix.md`,
+        '.contextkit/commands/dev/fix.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/refactor.md`,
-        '.contextkit/commands/refactor.md'
+        `${this.repoUrl}/commands/dev/refactor.md`,
+        '.contextkit/commands/dev/refactor.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/run-tests.md`,
-        '.contextkit/commands/run-tests.md'
+        `${this.repoUrl}/commands/dev/run-tests.md`,
+        '.contextkit/commands/dev/run-tests.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/add-documentation.md`,
-        '.contextkit/commands/add-documentation.md'
+        `${this.repoUrl}/commands/docs/add-documentation.md`,
+        '.contextkit/commands/docs/add-documentation.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/quality-check.md`,
-        '.contextkit/commands/quality-check.md'
+        `${this.repoUrl}/commands/dev/quality-check.md`,
+        '.contextkit/commands/dev/quality-check.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-feature.md`,
-        '.contextkit/commands/create-feature.md'
+        `${this.repoUrl}/commands/dev/create-feature.md`,
+        '.contextkit/commands/dev/create-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-component.md`,
-        '.contextkit/commands/create-component.md'
+        `${this.repoUrl}/commands/dev/create-component.md`,
+        '.contextkit/commands/dev/create-component.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/spec.md`,
-        '.contextkit/commands/spec.md'
+        `${this.repoUrl}/commands/dev/spec.md`,
+        '.contextkit/commands/dev/spec.md'
       );
 
       // Download squad commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad.md`,
-        '.contextkit/commands/squad.md'
+        `${this.repoUrl}/commands/squad/squad.md`,
+        '.contextkit/commands/squad/squad.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-architect.md`,
-        '.contextkit/commands/squad-architect.md'
+        `${this.repoUrl}/commands/squad/squad-architect.md`,
+        '.contextkit/commands/squad/squad-architect.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-dev.md`,
-        '.contextkit/commands/squad-dev.md'
+        `${this.repoUrl}/commands/squad/squad-dev.md`,
+        '.contextkit/commands/squad/squad-dev.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-test.md`,
-        '.contextkit/commands/squad-test.md'
+        `${this.repoUrl}/commands/squad/squad-test.md`,
+        '.contextkit/commands/squad/squad-test.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-review.md`,
-        '.contextkit/commands/squad-review.md'
+        `${this.repoUrl}/commands/squad/squad-review.md`,
+        '.contextkit/commands/squad/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto.md`,
-        '.contextkit/commands/squad-auto.md'
+        `${this.repoUrl}/commands/squad/squad-auto.md`,
+        '.contextkit/commands/squad/squad-auto.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto-parallel.md`,
-        '.contextkit/commands/squad-auto-parallel.md'
+        `${this.repoUrl}/commands/squad/squad-auto-parallel.md`,
+        '.contextkit/commands/squad/squad-auto-parallel.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-reset.md`,
-        '.contextkit/commands/squad-reset.md'
+        `${this.repoUrl}/commands/squad/squad-reset.md`,
+        '.contextkit/commands/squad/squad-reset.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-doc.md`,
-        '.contextkit/commands/squad-doc.md'
+        `${this.repoUrl}/commands/squad/squad-doc.md`,
+        '.contextkit/commands/squad/squad-doc.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-ci.md`,
-        '.contextkit/commands/squad-ci.md'
+        `${this.repoUrl}/commands/squad/squad-ci.md`,
+        '.contextkit/commands/squad/squad-ci.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/health-check.md`,
-        '.contextkit/commands/health-check.md'
+        `${this.repoUrl}/commands/dev/health-check.md`,
+        '.contextkit/commands/dev/health-check.md'
       );
 
       // Download doc family commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-arch.md`,
-        '.contextkit/commands/doc-arch.md'
+        `${this.repoUrl}/commands/docs/doc-arch.md`,
+        '.contextkit/commands/docs/doc-arch.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/docs/doc-feature.md`,
+        '.contextkit/commands/docs/doc-feature.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/docs/doc-component.md`,
+        '.contextkit/commands/docs/doc-component.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/context-budget.md`,
+        '.contextkit/commands/agents/context-budget.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-feature.md`,
-        '.contextkit/commands/doc-feature.md'
+        `${this.repoUrl}/commands/agents/agent-push-checklist.md`,
+        '.contextkit/commands/agents/agent-push-checklist.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-component.md`,
-        '.contextkit/commands/doc-component.md'
+        `${this.repoUrl}/commands/agents/standards-aware.md`,
+        '.contextkit/commands/agents/standards-aware.md'
       );
 
       // Update CI squad workflow if the user opted in
@@ -422,15 +438,15 @@ paths:
 
 # Commands
 commands:
-  analyze: "${config.commands?.analyze || '@.contextkit/commands/analyze.md'}"
-  review: "${config.commands?.review || '@.contextkit/commands/review.md'}"
-  fix: "${config.commands?.fix || '@.contextkit/commands/fix.md'}"
-  refactor: "${config.commands?.refactor || '@.contextkit/commands/refactor.md'}"
-  run_tests: "${config.commands?.run_tests || '@.contextkit/commands/run-tests.md'}"
-  add_docs: "${config.commands?.add_docs || '@.contextkit/commands/add-documentation.md'}"
-  quality_check: "${config.commands?.quality_check || '@.contextkit/commands/quality-check.md'}"
-  create_component: "${config.commands?.create_component || '@.contextkit/commands/create-component.md'}"
-  create_feature: "${config.commands?.create_feature || '@.contextkit/commands/create-feature.md'}"
+  analyze: "${config.commands?.analyze || '@.contextkit/commands/dev/analyze.md'}"
+  review: "${config.commands?.review || '@.contextkit/commands/dev/review.md'}"
+  fix: "${config.commands?.fix || '@.contextkit/commands/dev/fix.md'}"
+  refactor: "${config.commands?.refactor || '@.contextkit/commands/dev/refactor.md'}"
+  run_tests: "${config.commands?.run_tests || '@.contextkit/commands/dev/run-tests.md'}"
+  add_docs: "${config.commands?.add_docs || '@.contextkit/commands/docs/add-documentation.md'}"
+  quality_check: "${config.commands?.quality_check || '@.contextkit/commands/dev/quality-check.md'}"
+  create_component: "${config.commands?.create_component || '@.contextkit/commands/dev/create-component.md'}"
+  create_feature: "${config.commands?.create_feature || '@.contextkit/commands/dev/create-feature.md'}"
 `;
 
     await fs.writeFile('.contextkit/config.yml', configContent);
@@ -462,6 +478,32 @@ commands:
 
   async removeLegacyFiles() {
     const legacyFiles = [
+      // Removed in 0.14.0 — commands reorganised into dev/ squad/ docs/ agents/ subdirs
+      '.contextkit/commands/analyze.md',
+      '.contextkit/commands/review.md',
+      '.contextkit/commands/fix.md',
+      '.contextkit/commands/refactor.md',
+      '.contextkit/commands/run-tests.md',
+      '.contextkit/commands/add-documentation.md',
+      '.contextkit/commands/quality-check.md',
+      '.contextkit/commands/create-feature.md',
+      '.contextkit/commands/create-component.md',
+      '.contextkit/commands/spec.md',
+      '.contextkit/commands/health-check.md',
+      '.contextkit/commands/squad.md',
+      '.contextkit/commands/squad-architect.md',
+      '.contextkit/commands/squad-dev.md',
+      '.contextkit/commands/squad-test.md',
+      '.contextkit/commands/squad-review.md',
+      '.contextkit/commands/squad-auto.md',
+      '.contextkit/commands/squad-auto-parallel.md',
+      '.contextkit/commands/squad-reset.md',
+      '.contextkit/commands/squad-doc.md',
+      '.contextkit/commands/squad-ci.md',
+      '.contextkit/commands/doc-arch.md',
+      '.contextkit/commands/doc-feature.md',
+      '.contextkit/commands/doc-component.md',
+      // Older legacy
       '.contextkit/commands/squad-peer-review.md',
     ];
     for (const file of legacyFiles) {
@@ -473,10 +515,7 @@ commands:
 
   async updateConfigVersion(version) {
     const configContent = await fs.readFile('.contextkit/config.yml', 'utf8');
-    const updatedContent = configContent.replace(
-      /version: "[^"]*"/,
-      `version: "${version}"`
-    );
+    const updatedContent = configContent.replace(/version: "[^"]*"/, `version: "${version}"`);
     await fs.writeFile('.contextkit/config.yml', updatedContent);
   }
 }

package/lib/index.js

@@ -1,9 +1,11 @@
 const install = require('./commands/install');
 const update = require('./commands/update');
 const status = require('./commands/status');
+const GatesCommand = require('./commands/gates');
 
 module.exports = {
   install,
   update,
-  status
+  status,
+  gates: GatesCommand,
 };

package/lib/integrations/aider-integration.js

@@ -71,7 +71,7 @@ ${this.getStandardsBlock()}
 .contextkit/instructions/meta/
 `;
     // Only create if doesn't exist (don't overwrite user customizations)
-    if (!await fs.pathExists('.aiderignore')) {
+    if (!(await fs.pathExists('.aiderignore'))) {
       await fs.writeFile('.aiderignore', aiderignore);
     }
   }

package/lib/integrations/base-integration.js

@@ -2,7 +2,8 @@ const chalk = require('chalk');
 const fs = require('fs-extra');
 const path = require('path');
 
-const MARKER = '<!-- Generated by ContextKit (@nolrm/contextkit) https://www.npmjs.com/package/@nolrm/contextkit -->';
+const MARKER =
+  '<!-- Generated by ContextKit (@nolrm/contextkit) https://www.npmjs.com/package/@nolrm/contextkit -->';
 const MARKER_END = '<!-- End ContextKit -->';
 const LEGACY_MARKER_V1 = '<!-- Generated by ContextKit -->';
 const LEGACY_MARKER = '<!-- Generated by Vibe Kit -->';
@@ -64,13 +65,19 @@ class BaseIntegration {
       const hasLegacyMarker = existing.includes(LEGACY_MARKER);
 
       if (hasCurrentMarker || hasLegacyMarkerV1 || hasLegacyMarker) {
-        const activeMarker = hasCurrentMarker ? MARKER : (hasLegacyMarkerV1 ? LEGACY_MARKER_V1 : LEGACY_MARKER);
-        const activeMarkerEnd = hasLegacyMarker && !hasCurrentMarker && !hasLegacyMarkerV1 ? LEGACY_MARKER_END : MARKER_END;
+        const activeMarker = hasCurrentMarker
+          ? MARKER
+          : hasLegacyMarkerV1
+            ? LEGACY_MARKER_V1
+            : LEGACY_MARKER;
+        const activeMarkerEnd =
+          hasLegacyMarker && !hasCurrentMarker && !hasLegacyMarkerV1
+            ? LEGACY_MARKER_END
+            : MARKER_END;
         const before = existing.substring(0, existing.indexOf(activeMarker));
         const afterMarkerEnd = existing.indexOf(activeMarkerEnd);
-        const after = afterMarkerEnd !== -1
-          ? existing.substring(afterMarkerEnd + activeMarkerEnd.length)
-          : '';
+        const after =
+          afterMarkerEnd !== -1 ? existing.substring(afterMarkerEnd + activeMarkerEnd.length) : '';
         await fs.writeFile(filePath, before + markedContent + after);
       } else {
         // Append below existing content