create-claude-context 1.0.0 → 1.2.0

package/templates/base/team/roles.json

@@ -1,145 +1,145 @@
-{
-  "$schema": "../schemas/roles.schema.json",
-  "$comment": "Role definitions for team collaboration",
-
-  "roles": {
-    "team-lead": {
-      "displayName": "Team Lead",
-      "description": "Full access to all features, manages team settings and approvals",
-      "permissions": [
-        "read",
-        "write",
-        "execute",
-        "approve",
-        "configure",
-        "manage-members",
-        "manage-knowledge",
-        "manage-sessions"
-      ],
-      "capabilities": {
-        "can_approve_plans": true,
-        "can_modify_team_config": true,
-        "can_add_members": true,
-        "can_remove_members": true,
-        "can_access_all_sessions": true,
-        "can_override_policies": true
-      },
-      "context_access": {
-        "shared_knowledge": "full",
-        "session_history": "all",
-        "sensitive_configs": true
-      }
-    },
-
-    "senior-developer": {
-      "displayName": "Senior Developer",
-      "description": "Full development access with plan approval capabilities",
-      "permissions": [
-        "read",
-        "write",
-        "execute",
-        "approve"
-      ],
-      "capabilities": {
-        "can_approve_plans": true,
-        "can_modify_team_config": false,
-        "can_add_members": false,
-        "can_remove_members": false,
-        "can_access_all_sessions": true,
-        "can_override_policies": false
-      },
-      "context_access": {
-        "shared_knowledge": "full",
-        "session_history": "team",
-        "sensitive_configs": false
-      }
-    },
-
-    "developer": {
-      "displayName": "Developer",
-      "description": "Standard development access for implementing features and fixes",
-      "permissions": [
-        "read",
-        "write",
-        "execute"
-      ],
-      "capabilities": {
-        "can_approve_plans": false,
-        "can_modify_team_config": false,
-        "can_add_members": false,
-        "can_remove_members": false,
-        "can_access_all_sessions": false,
-        "can_override_policies": false
-      },
-      "context_access": {
-        "shared_knowledge": "full",
-        "session_history": "own",
-        "sensitive_configs": false
-      }
-    },
-
-    "reviewer": {
-      "displayName": "Code Reviewer",
-      "description": "Read access with approval capabilities for code review",
-      "permissions": [
-        "read",
-        "approve"
-      ],
-      "capabilities": {
-        "can_approve_plans": true,
-        "can_modify_team_config": false,
-        "can_add_members": false,
-        "can_remove_members": false,
-        "can_access_all_sessions": true,
-        "can_override_policies": false
-      },
-      "context_access": {
-        "shared_knowledge": "read-only",
-        "session_history": "team",
-        "sensitive_configs": false
-      }
-    },
-
-    "observer": {
-      "displayName": "Observer",
-      "description": "Read-only access for monitoring and learning",
-      "permissions": [
-        "read"
-      ],
-      "capabilities": {
-        "can_approve_plans": false,
-        "can_modify_team_config": false,
-        "can_add_members": false,
-        "can_remove_members": false,
-        "can_access_all_sessions": false,
-        "can_override_policies": false
-      },
-      "context_access": {
-        "shared_knowledge": "read-only",
-        "session_history": "none",
-        "sensitive_configs": false
-      }
-    }
-  },
-
-  "permission_definitions": {
-    "read": "View files, documentation, and session history",
-    "write": "Create and modify files, documentation",
-    "execute": "Run commands, scripts, and Claude Code operations",
-    "approve": "Approve plans, pull requests, and changes",
-    "configure": "Modify project and team configuration",
-    "manage-members": "Add, remove, and modify team members",
-    "manage-knowledge": "Create, edit, and delete shared knowledge",
-    "manage-sessions": "Access and manage all team sessions"
-  },
-
-  "default_role": "developer",
-
-  "role_hierarchy": [
-    "team-lead",
-    "senior-developer",
-    "developer",
-    "reviewer",
-    "observer"
-  ]
-}
+{
+  "$schema": "../schemas/roles.schema.json",
+  "$comment": "Role definitions for team collaboration",
+
+  "roles": {
+    "team-lead": {
+      "displayName": "Team Lead",
+      "description": "Full access to all features, manages team settings and approvals",
+      "permissions": [
+        "read",
+        "write",
+        "execute",
+        "approve",
+        "configure",
+        "manage-members",
+        "manage-knowledge",
+        "manage-sessions"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": true,
+        "can_add_members": true,
+        "can_remove_members": true,
+        "can_access_all_sessions": true,
+        "can_override_policies": true
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "all",
+        "sensitive_configs": true
+      }
+    },
+
+    "senior-developer": {
+      "displayName": "Senior Developer",
+      "description": "Full development access with plan approval capabilities",
+      "permissions": [
+        "read",
+        "write",
+        "execute",
+        "approve"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": true,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "team",
+        "sensitive_configs": false
+      }
+    },
+
+    "developer": {
+      "displayName": "Developer",
+      "description": "Standard development access for implementing features and fixes",
+      "permissions": [
+        "read",
+        "write",
+        "execute"
+      ],
+      "capabilities": {
+        "can_approve_plans": false,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": false,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "own",
+        "sensitive_configs": false
+      }
+    },
+
+    "reviewer": {
+      "displayName": "Code Reviewer",
+      "description": "Read access with approval capabilities for code review",
+      "permissions": [
+        "read",
+        "approve"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": true,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "read-only",
+        "session_history": "team",
+        "sensitive_configs": false
+      }
+    },
+
+    "observer": {
+      "displayName": "Observer",
+      "description": "Read-only access for monitoring and learning",
+      "permissions": [
+        "read"
+      ],
+      "capabilities": {
+        "can_approve_plans": false,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": false,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "read-only",
+        "session_history": "none",
+        "sensitive_configs": false
+      }
+    }
+  },
+
+  "permission_definitions": {
+    "read": "View files, documentation, and session history",
+    "write": "Create and modify files, documentation",
+    "execute": "Run commands, scripts, and Claude Code operations",
+    "approve": "Approve plans, pull requests, and changes",
+    "configure": "Modify project and team configuration",
+    "manage-members": "Add, remove, and modify team members",
+    "manage-knowledge": "Create, edit, and delete shared knowledge",
+    "manage-sessions": "Access and manage all team sessions"
+  },
+
+  "default_role": "developer",
+
+  "role_hierarchy": [
+    "team-lead",
+    "senior-developer",
+    "developer",
+    "reviewer",
+    "observer"
+  ]
+}

package/templates/base/tools/bin/claude-context.js

@@ -1,151 +1,151 @@
-#!/usr/bin/env node
-
-/**
- * Claude Context Engineering CLI
- *
- * Main entry point for the claude-context command line tool.
- * Provides commands for initialization, validation, and management
- * of the Claude context engineering system.
- */
-
-const { program } = require('commander');
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs');
-
-// Import command handlers
-const { init } = require('../lib/init');
-const { validate } = require('../lib/validate');
-const { diagnose } = require('../lib/diagnose');
-const { configLoader } = require('../lib/config-loader');
-
-// Package info
-const pkg = require('../package.json');
-
-// ASCII banner
-const banner = `
-${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
-${chalk.cyan('║')}  ${chalk.bold.white('Claude Context Engineering')}                              ${chalk.cyan('║')}
-${chalk.cyan('║')}  ${chalk.gray('Optimize AI-assisted development with pre-computed')}        ${chalk.cyan('║')}
-${chalk.cyan('║')}  ${chalk.gray('system knowledge and structured documentation.')}             ${chalk.cyan('║')}
-${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
-`;
-
-program
-  .name('claude-context')
-  .description('CLI tools for Claude Context Engineering')
-  .version(pkg.version)
-  .hook('preAction', () => {
-    // Show banner on all commands
-    if (process.argv.includes('--no-banner')) return;
-    console.log(banner);
-  });
-
-// Init command
-program
-  .command('init')
-  .description('Initialize context engineering for a repository')
-  .option('-c, --config <path>', 'Path to configuration file')
-  .option('-i, --interactive', 'Run in interactive mode', true)
-  .option('--no-interactive', 'Run in non-interactive mode')
-  .option('--resume', 'Resume interrupted initialization')
-  .option('--validate-only', 'Only validate existing initialization')
-  .option('--tech-stack <stack>', 'Specify tech stack (e.g., "python-fastapi")')
-  .option('--project-name <name>', 'Specify project name')
-  .action(async (options) => {
-    try {
-      await init(options);
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Validate command
-program
-  .command('validate')
-  .description('Validate the context engineering setup')
-  .option('-a, --all', 'Run all validations', false)
-  .option('--links', 'Validate markdown links')
-  .option('--lines', 'Check line number accuracy')
-  .option('--placeholders', 'Check for remaining placeholders')
-  .option('--schema', 'Validate JSON files against schemas')
-  .option('--structure', 'Validate directory structure')
-  .option('-t, --threshold <percent>', 'Minimum accuracy threshold', '60')
-  .option('-o, --output <format>', 'Output format: console, json, markdown', 'console')
-  .option('-f, --file <path>', 'Validate specific file')
-  .action(async (options) => {
-    try {
-      // If no specific option, run all
-      if (!options.links && !options.lines && !options.placeholders &&
-          !options.schema && !options.structure && !options.file) {
-        options.all = true;
-      }
-      await validate(options);
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Diagnose command
-program
-  .command('diagnose')
-  .description('Diagnose issues with the context engineering setup')
-  .option('--fix', 'Attempt to fix detected issues')
-  .option('-v, --verbose', 'Show detailed diagnostics')
-  .action(async (options) => {
-    try {
-      await diagnose(options);
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Config command
-program
-  .command('config')
-  .description('Manage configuration')
-  .argument('[action]', 'Action: get, set, list, path')
-  .argument('[key]', 'Configuration key')
-  .argument('[value]', 'Configuration value (for set)')
-  .option('-e, --env <environment>', 'Environment (development, staging, production)')
-  .action(async (action, key, value, options) => {
-    try {
-      const config = await configLoader.load({ env: options.env });
-
-      switch (action) {
-        case 'get':
-          if (!key) {
-            console.log(JSON.stringify(config, null, 2));
-          } else {
-            const val = key.split('.').reduce((o, k) => o?.[k], config);
-            console.log(val !== undefined ? JSON.stringify(val, null, 2) : 'Key not found');
-          }
-          break;
-        case 'list':
-          console.log(JSON.stringify(config, null, 2));
-          break;
-        case 'path':
-          console.log(configLoader.getConfigPath());
-          break;
-        case 'set':
-          console.log(chalk.yellow('Config set not yet implemented. Edit files directly.'));
-          break;
-        default:
-          console.log(JSON.stringify(config, null, 2));
-      }
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Parse and execute
-program.parse();
-
-// Show help if no command
-if (!process.argv.slice(2).length) {
-  program.outputHelp();
-}
+#!/usr/bin/env node
+
+/**
+ * Claude Context Engineering CLI
+ *
+ * Main entry point for the claude-context command line tool.
+ * Provides commands for initialization, validation, and management
+ * of the Claude context engineering system.
+ */
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+
+// Import command handlers
+const { init } = require('../lib/init');
+const { validate } = require('../lib/validate');
+const { diagnose } = require('../lib/diagnose');
+const { configLoader } = require('../lib/config-loader');
+
+// Package info
+const pkg = require('../package.json');
+
+// ASCII banner
+const banner = `
+${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
+${chalk.cyan('║')}  ${chalk.bold.white('Claude Context Engineering')}                              ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.gray('Optimize AI-assisted development with pre-computed')}        ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.gray('system knowledge and structured documentation.')}             ${chalk.cyan('║')}
+${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
+`;
+
+program
+  .name('claude-context')
+  .description('CLI tools for Claude Context Engineering')
+  .version(pkg.version)
+  .hook('preAction', () => {
+    // Show banner on all commands
+    if (process.argv.includes('--no-banner')) return;
+    console.log(banner);
+  });
+
+// Init command
+program
+  .command('init')
+  .description('Initialize context engineering for a repository')
+  .option('-c, --config <path>', 'Path to configuration file')
+  .option('-i, --interactive', 'Run in interactive mode', true)
+  .option('--no-interactive', 'Run in non-interactive mode')
+  .option('--resume', 'Resume interrupted initialization')
+  .option('--validate-only', 'Only validate existing initialization')
+  .option('--tech-stack <stack>', 'Specify tech stack (e.g., "python-fastapi")')
+  .option('--project-name <name>', 'Specify project name')
+  .action(async (options) => {
+    try {
+      await init(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Validate command
+program
+  .command('validate')
+  .description('Validate the context engineering setup')
+  .option('-a, --all', 'Run all validations', false)
+  .option('--links', 'Validate markdown links')
+  .option('--lines', 'Check line number accuracy')
+  .option('--placeholders', 'Check for remaining placeholders')
+  .option('--schema', 'Validate JSON files against schemas')
+  .option('--structure', 'Validate directory structure')
+  .option('-t, --threshold <percent>', 'Minimum accuracy threshold', '60')
+  .option('-o, --output <format>', 'Output format: console, json, markdown', 'console')
+  .option('-f, --file <path>', 'Validate specific file')
+  .action(async (options) => {
+    try {
+      // If no specific option, run all
+      if (!options.links && !options.lines && !options.placeholders &&
+          !options.schema && !options.structure && !options.file) {
+        options.all = true;
+      }
+      await validate(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Diagnose command
+program
+  .command('diagnose')
+  .description('Diagnose issues with the context engineering setup')
+  .option('--fix', 'Attempt to fix detected issues')
+  .option('-v, --verbose', 'Show detailed diagnostics')
+  .action(async (options) => {
+    try {
+      await diagnose(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Config command
+program
+  .command('config')
+  .description('Manage configuration')
+  .argument('[action]', 'Action: get, set, list, path')
+  .argument('[key]', 'Configuration key')
+  .argument('[value]', 'Configuration value (for set)')
+  .option('-e, --env <environment>', 'Environment (development, staging, production)')
+  .action(async (action, key, value, options) => {
+    try {
+      const config = await configLoader.load({ env: options.env });
+
+      switch (action) {
+        case 'get':
+          if (!key) {
+            console.log(JSON.stringify(config, null, 2));
+          } else {
+            const val = key.split('.').reduce((o, k) => o?.[k], config);
+            console.log(val !== undefined ? JSON.stringify(val, null, 2) : 'Key not found');
+          }
+          break;
+        case 'list':
+          console.log(JSON.stringify(config, null, 2));
+          break;
+        case 'path':
+          console.log(configLoader.getConfigPath());
+          break;
+        case 'set':
+          console.log(chalk.yellow('Config set not yet implemented. Edit files directly.'));
+          break;
+        default:
+          console.log(JSON.stringify(config, null, 2));
+      }
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Parse and execute
+program.parse();
+
+// Show help if no command
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}