@nolrm/contextkit 0.13.2 → 0.13.3

package/README.md

@@ -284,6 +284,36 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 
 ---
 
+## CI Squad — GitHub Issues → PR
+
+ContextKit can automatically turn GitHub issues into pull requests — no local development required.
+
+**How it works:**
+
+1. Label any issue `squad-ready`
+2. GitHub Actions runs the full squad pipeline (architect → dev → test → review) using Claude
+3. A draft PR is opened, linked to the issue
+
+**Setup:**
+
+```bash
+ck install   # answer "yes" to the CI squad prompt
+```
+
+Then add your Anthropic API key as a repository secret:
+
+> **Settings → Secrets and variables → Actions → New repository secret**
+> Name: `ANTHROPIC_API_KEY`
+
+**Tips:**
+
+- Write issues with clear acceptance criteria for the best results
+- If the issue is too vague, the workflow posts a comment asking for clarification instead of generating a bad PR
+- PRs always open as **draft** — you review and merge manually
+- Re-apply the `squad-ready` label after answering a clarification comment to re-trigger the pipeline
+
+---
+
 ## Key Features
 
 - 🧠 **Context Engineering** - Structured MD files your AI reads automatically

package/lib/commands/install.js

@@ -114,11 +114,20 @@ class InstallCommand {
       await this.gitHooksManager.installHooks(packageManager, hookChoices);
     }
 
+    // Ask about GitHub Actions CI squad workflow
+    let squadCi = false;
+    if (!options.nonInteractive) {
+      squadCi = await this.promptGitHubActionsWorkflow();
+    }
+    if (squadCi) {
+      await this.installGitHubActionsWorkflow();
+    }
+
     // Create configuration
-    await this.createConfiguration(projectType, hookChoices);
+    await this.createConfiguration(projectType, hookChoices, squadCi);
 
     // Create status tracking
-    await this.createStatusFile(projectType, packageManager, hookChoices);
+    await this.createStatusFile(projectType, packageManager, hookChoices, squadCi);
 
     // Determine which platform to install
     let chosenPlatform = requestedPlatform || null;
@@ -204,6 +213,56 @@ class InstallCommand {
     return platform;
   }
 
+  async promptGitHubActionsWorkflow() {
+    if (process.env.CI === 'true' || process.env.NON_INTERACTIVE === 'true') {
+      return false;
+    }
+
+    console.log('');
+    console.log('──────────────────────────────────────────────');
+    console.log(chalk.blue('🤖  CI Squad — GitHub Issues → PR'));
+    console.log('──────────────────────────────────────────────');
+    console.log('');
+    console.log(chalk.dim('Label any GitHub issue `squad-ready` and ContextKit will'));
+    console.log(chalk.dim('automatically create a branch, run the full squad pipeline'));
+    console.log(chalk.dim('(architect → dev → test → review), and open a draft PR.'));
+    console.log('');
+    console.log(chalk.dim('Requires: ANTHROPIC_API_KEY secret in your repo settings.'));
+    console.log('');
+
+    const { squadCi } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'squadCi',
+        message: 'Install GitHub Actions workflow for issue-triggered squad automation?',
+        default: false,
+      },
+    ]);
+
+    if (squadCi) {
+      console.log(chalk.green('  ✅ CI squad workflow will be installed'));
+      console.log(chalk.blue('  💡 Add ANTHROPIC_API_KEY to: Settings → Secrets → Actions'));
+    } else {
+      console.log(chalk.yellow('  ⏭️  Skipping CI squad workflow'));
+    }
+    console.log('');
+
+    return squadCi;
+  }
+
+  async installGitHubActionsWorkflow() {
+    try {
+      await fs.ensureDir('.github/workflows');
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/templates/github-actions/squad-issue.yml`,
+        '.github/workflows/squad-issue.yml'
+      );
+      console.log(chalk.green('✅ CI squad workflow installed → .github/workflows/squad-issue.yml'));
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  Could not install CI squad workflow:'), error.message);
+    }
+  }
+
   async promptGitHooks() {
     // Check for non-interactive mode
     if (process.env.CI === 'true' || process.env.NON_INTERACTIVE === 'true') {
@@ -738,6 +797,10 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         `${this.repoUrl}/commands/squad-doc.md`,
         '.contextkit/commands/squad-doc.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-ci.md`,
+        '.contextkit/commands/squad-ci.md'
+      );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/commands/health-check.md`,
         '.contextkit/commands/health-check.md'
@@ -948,7 +1011,7 @@ esac
     console.log(chalk.green('✅ CLI helpers installed'));
   }
 
-  async createConfiguration(projectType, hookChoices) {
+  async createConfiguration(projectType, hookChoices, squadCi = false) {
     const projectName = path.basename(process.cwd());
 
     const config = {
@@ -962,7 +1025,8 @@ esac
         linting: true,
         type_safety: true,
         pre_push_hook: hookChoices.prePush,
-        commit_msg_hook: hookChoices.commitMsg
+        commit_msg_hook: hookChoices.commitMsg,
+        squad_ci_workflow: squadCi,
       },
       paths: {
         components: 'src/components',
@@ -1038,6 +1102,7 @@ features:
   type_safety: ${config.features.type_safety}
   pre_push_hook: ${config.features.pre_push_hook}
   commit_msg_hook: ${config.features.commit_msg_hook}
+  squad_ci_workflow: ${config.features.squad_ci_workflow}
 
 # Paths (customize for your project)
 paths:
@@ -1078,13 +1143,14 @@ https://www.npmjs.com/package/@nolrm/contextkit
     await fs.writeFile('.contextkit/README.md', content);
   }
 
-  async createStatusFile(projectType, packageManager, hookChoices) {
+  async createStatusFile(projectType, packageManager, hookChoices, squadCi = false) {
     try {
       const status = this.statusManager.getDefaultStatus();
       status.project_type = projectType;
       status.package_manager = packageManager;
       status.features.pre_push_hook = hookChoices.prePush;
       status.features.commit_msg_hook = hookChoices.commitMsg;
+      status.features.squad_ci_workflow = squadCi;
       
       await this.statusManager.saveStatus(status);
       console.log(chalk.green('✅ Status tracking initialized'));

package/lib/commands/update.js

@@ -64,7 +64,7 @@ class UpdateCommand {
       }
 
       // Download latest files
-      await this.downloadFiles(projectType);
+      await this.downloadFiles(projectType, config);
 
       // Remove files that were removed from CK
       await this.removeLegacyFiles();
@@ -205,13 +205,16 @@ class UpdateCommand {
       } else if (trimmed.startsWith('commit_msg_hook:')) {
         config.features = config.features || {};
         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';
       }
     }
 
     return config;
   }
 
-  async downloadFiles(projectType) {
+  async downloadFiles(projectType, config = {}) {
     const spinner = ora('Downloading latest files...').start();
 
     try {
@@ -306,11 +309,24 @@ class UpdateCommand {
         `${this.repoUrl}/commands/squad-doc.md`,
         '.contextkit/commands/squad-doc.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-ci.md`,
+        '.contextkit/commands/squad-ci.md'
+      );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/commands/health-check.md`,
         '.contextkit/commands/health-check.md'
       );
 
+      // Update CI squad workflow if the user opted in
+      if (config.features?.squad_ci_workflow) {
+        await fs.ensureDir('.github/workflows');
+        await this.downloadManager.downloadFile(
+          `${this.repoUrl}/templates/github-actions/squad-issue.yml`,
+          '.github/workflows/squad-issue.yml'
+        );
+      }
+
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/hooks/pre-push`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "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": {