@paths.design/caws-cli 8.2.1 → 8.3.0

package/dist/generators/working-spec.js

@@ -209,13 +209,13 @@ function validateGeneratedSpec(specContent, _answers) {
     const isValid = validateWorkingSpec(spec);
 
     if (!isValid) {
-      console.error(chalk.red('❌ Generated working spec failed validation:'));
+      console.error(chalk.red('Generated working spec failed validation:'));
       validateWorkingSpec.errors.forEach((error) => {
         console.error(`   - ${error.instancePath || 'root'}: ${error.message}`);
       });
 
       // Provide helpful guidance
-      console.log(chalk.blue('\n💡 Validation Tips:'));
+      console.log(chalk.blue('\nValidation Tips:'));
       console.log('   - Ensure risk_tier is 1, 2, or 3');
       console.log('   - Check that scope.in is not empty');
       console.log('   - Verify invariants and acceptance criteria are provided');
@@ -224,9 +224,9 @@ function validateGeneratedSpec(specContent, _answers) {
       process.exit(1);
     }
 
-    console.log(chalk.green('✅ Generated working spec passed validation'));
+    console.log(chalk.green('Generated working spec passed validation'));
   } catch (error) {
-    console.error(chalk.red('❌ Error validating working spec:'), error.message);
+    console.error(chalk.red('Error validating working spec:'), error.message);
     process.exit(1);
   }
 }

package/dist/index.js

@@ -50,6 +50,7 @@ const { modeCommand } = require('./commands/mode');
 const { tutorialCommand } = require('./commands/tutorial');
 const { planCommand } = require('./commands/plan');
 const { worktreeCommand } = require('./commands/worktree');
+const { sessionCommand } = require('./commands/session');
 
 // Import scaffold functionality
 const { scaffoldProject, setScaffoldDependencies } = require('./scaffold');
@@ -378,6 +379,56 @@ worktreeCmd
   .option('--max-age <days>', 'Remove entries older than N days', '30')
   .action((options) => worktreeCommand('prune', options));
 
+// Session command group
+const sessionCmd = program
+  .command('session')
+  .description('Manage session lifecycle and capsules for multi-agent coordination');
+
+sessionCmd
+  .command('start')
+  .description('Start a new tracked session with baseline checkpoint')
+  .option('--role <role>', 'Agent role (worker, integrator, qa)', 'worker')
+  .option('--spec-id <id>', 'Associated feature spec ID')
+  .option('--scope <patterns>', 'Allowed file patterns (comma-separated)')
+  .option('--intent <text>', 'What this session intends to accomplish')
+  .action((options) => sessionCommand('start', options));
+
+sessionCmd
+  .command('checkpoint')
+  .description('Record a checkpoint in the current session')
+  .option('--session-id <id>', 'Specific session ID (uses latest active if omitted)')
+  .option('--intent <text>', 'Updated intent description')
+  .option('--paths <paths>', 'Files changed (comma-separated)')
+  .option('--tests <json>', 'Test results as JSON array [{name, status, evidence}]')
+  .option('--issues <json>', 'Known issues as JSON array [{type, description}]')
+  .action((options) => sessionCommand('checkpoint', options));
+
+sessionCmd
+  .command('end')
+  .description('End the current session with handoff information')
+  .option('--session-id <id>', 'Specific session ID (uses latest active if omitted)')
+  .option('--next-actions <actions>', 'Handoff actions (pipe-separated)')
+  .option('--risk-notes <notes>', 'Risk notes (pipe-separated)')
+  .action((options) => sessionCommand('end', options));
+
+sessionCmd
+  .command('list')
+  .description('List all sessions')
+  .option('--status <status>', 'Filter by status (active, completed)')
+  .option('--limit <n>', 'Max entries to show')
+  .action((options) => sessionCommand('list', options));
+
+sessionCmd
+  .command('show [id]')
+  .description('Show session capsule details (default: latest)')
+  .option('--json', 'Output as raw JSON', false)
+  .action((id, options) => sessionCommand('show', { ...options, id: id || 'latest' }));
+
+sessionCmd
+  .command('briefing')
+  .description('Show session briefing for hooks/startup')
+  .action(() => sessionCommand('briefing'));
+
 // Templates command
 program
   .command('templates [subcommand]')
@@ -566,15 +617,15 @@ hooksCmd
     try {
       const result = await scaffoldGitHooks(process.cwd(), hookOptions);
       if (result.added > 0) {
-        console.log(`✅ Successfully installed ${result.added} git hooks`);
+        console.log(`Successfully installed ${result.added} git hooks`);
         if (result.skipped > 0) {
-          console.log(`⏭️  Skipped ${result.skipped} existing hooks`);
+          console.log(`Skipped ${result.skipped} existing hooks`);
         }
       } else {
-        console.log('ℹ️  All hooks already configured');
+        console.log('All hooks already configured');
       }
     } catch (error) {
-      console.error(`❌ Failed to install git hooks: ${error.message}`);
+      console.error(`Failed to install git hooks: ${error.message}`);
       process.exit(1);
     }
   });
@@ -586,7 +637,7 @@ hooksCmd
     try {
       await removeGitHooks(process.cwd());
     } catch (error) {
-      console.error(`❌ Failed to remove git hooks: ${error.message}`);
+      console.error(`Failed to remove git hooks: ${error.message}`);
       process.exit(1);
     }
   });
@@ -598,7 +649,7 @@ hooksCmd
     try {
       await checkGitHooksStatus(process.cwd());
     } catch (error) {
-      console.error(`❌ Failed to check git hooks status: ${error.message}`);
+      console.error(`Failed to check git hooks status: ${error.message}`);
       process.exit(1);
     }
   });
@@ -647,22 +698,23 @@ program.exitOverride((err) => {
       'burnup',
       'tool',
       'worktree',
+      'session',
     ];
     const similar = findSimilarCommand(commandName, validCommands);
 
-    console.error(chalk.red(`\n❌ Unknown command: ${commandName}`));
+    console.error(chalk.red(`\nUnknown command: ${commandName}`));
 
     if (similar) {
-      console.error(chalk.yellow(`\n💡 Did you mean: caws ${similar}?`));
+      console.error(chalk.yellow(`\nDid you mean: caws ${similar}?`));
     }
 
     console.error(
-      chalk.yellow('💡 Available commands: init, validate, scaffold, provenance, hooks')
+      chalk.yellow('Available commands: init, validate, scaffold, provenance, hooks')
     );
-    console.error(chalk.yellow('💡 Try: caws --help for full command list'));
+    console.error(chalk.yellow('Try: caws --help for full command list'));
     console.error(
       chalk.blue(
-        '\n📚 Documentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
+        '\nDocumentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
       )
     );
 
@@ -674,18 +726,18 @@ program.exitOverride((err) => {
     const optionMatch = err.message.match(/unknown option ['"]([^'"]+)['"]/i);
     const option = optionMatch ? optionMatch[1] : '';
 
-    console.error(chalk.red(`\n❌ Unknown option: ${option}`));
-    console.error(chalk.yellow(`\n💡 Try: caws ${commandName || ''} --help for available options`));
+    console.error(chalk.red(`\nUnknown option: ${option}`));
+    console.error(chalk.yellow(`\nTry: caws ${commandName || ''} --help for available options`));
 
     // Provide specific suggestions for common mistakes
     if (option === '--suggestions' || option === '--suggest') {
-      console.error(chalk.yellow('💡 Note: Validation includes suggestions by default'));
+      console.error(chalk.yellow('Note: Validation includes suggestions by default'));
       console.error(chalk.yellow('   Just run: caws validate'));
     }
 
     console.error(
       chalk.blue(
-        '\n📚 Documentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
+        '\nDocumentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
       )
     );
 
@@ -693,11 +745,11 @@ program.exitOverride((err) => {
   }
 
   // Generic Commander error
-  console.error(chalk.red('\n❌ Error:'), err.message);
-  console.error(chalk.yellow('\n💡 Try: caws --help for usage information'));
+  console.error(chalk.red('\nError:'), err.message);
+  console.error(chalk.yellow('\nTry: caws --help for usage information'));
   console.error(
     chalk.blue(
-      '\n📚 Documentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/agents/full-guide.md'
+      '\nDocumentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/agents/full-guide.md'
     )
   );
   process.exit(1);
@@ -743,19 +795,19 @@ if (require.main === module) {
       ];
       const similar = findSimilarCommand(commandName, validCommands);
 
-      console.error(chalk.red(`\n❌ Unknown command: ${commandName}`));
+      console.error(chalk.red(`\nUnknown command: ${commandName}`));
 
       if (similar) {
-        console.error(chalk.yellow(`\n💡 Did you mean: caws ${similar}?`));
+        console.error(chalk.yellow(`\nDid you mean: caws ${similar}?`));
       }
 
       console.error(
-        chalk.yellow('💡 Available commands: init, validate, scaffold, provenance, hooks')
+        chalk.yellow('Available commands: init, validate, scaffold, provenance, hooks')
       );
-      console.error(chalk.yellow('💡 Try: caws --help for full command list'));
+      console.error(chalk.yellow('Try: caws --help for full command list'));
       console.error(
         chalk.blue(
-          '\n📚 Documentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
+          '\nDocumentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
         )
       );
 
@@ -767,20 +819,20 @@ if (require.main === module) {
       const optionMatch = error.message.match(/unknown option ['"]([^'"]+)['"]/i);
       const option = optionMatch ? optionMatch[1] : '';
 
-      console.error(chalk.red(`\n❌ Unknown option: ${option}`));
+      console.error(chalk.red(`\nUnknown option: ${option}`));
       console.error(
-        chalk.yellow(`\n💡 Try: caws ${commandName || ''} --help for available options`)
+        chalk.yellow(`\nTry: caws ${commandName || ''} --help for available options`)
       );
 
       // Provide specific suggestions for common mistakes
       if (option === '--suggestions' || option === '--suggest') {
-        console.error(chalk.yellow('💡 Note: Validation includes suggestions by default'));
+        console.error(chalk.yellow('Note: Validation includes suggestions by default'));
         console.error(chalk.yellow('   Just run: caws validate'));
       }
 
       console.error(
         chalk.blue(
-          '\n📚 Documentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
+          '\nDocumentation: https://github.com/Paths-Design/coding-agent-working-standard/blob/main/docs/api/cli.md'
         )
       );
 

package/dist/minimal-cli.js

@@ -29,24 +29,24 @@ function showVersion() {
  * Initialize a new project
  */
 async function initProject(projectName, _options) {
-  console.log(chalk.cyan(`🚀 Initializing new CAWS project: ${projectName}`));
+  console.log(chalk.cyan(`Initializing new CAWS project: ${projectName}`));
 
   try {
     if (!projectName || projectName.trim() === '') {
-      console.error(chalk.red('❌ Project name is required'));
-      console.error(chalk.blue('💡 Usage: caws init <project-name>'));
+      console.error(chalk.red('Project name is required'));
+      console.error(chalk.blue('Usage: caws init <project-name>'));
       process.exit(1);
     }
 
-    console.log(chalk.green('✅ Project initialization started'));
-    console.log(chalk.bold('\n📋 Configuration Summary:'));
+    console.log(chalk.green('Project initialization started'));
+    console.log(chalk.bold('\nConfiguration Summary:'));
     console.log(`   ${chalk.cyan('Project')}: ${projectName}`);
     console.log(`   ${chalk.cyan('Status')}: Initialized`);
 
-    console.log(chalk.green('\n🎉 Project initialized successfully!'));
+    console.log(chalk.green('\nProject initialized successfully!'));
     console.log(chalk.blue('\nFor help: caws --help'));
   } catch (error) {
-    console.error(chalk.red('❌ Error during project initialization:'), error.message);
+    console.error(chalk.red('Error during project initialization:'), error.message);
     process.exit(1);
   }
 }
@@ -71,7 +71,7 @@ program.exitOverride((err) => {
   if (err.code === 'commander.help') {
     process.exit(0);
   }
-  console.error(chalk.red('❌ Error:'), err.message);
+  console.error(chalk.red('Error:'), err.message);
   process.exit(1);
 });
 
@@ -82,7 +82,7 @@ try {
   if (error.code === 'commander.help' || error.code === 'commander.version') {
     process.exit(0);
   } else {
-    console.error(chalk.red('❌ Error:'), error.message);
+    console.error(chalk.red('Error:'), error.message);
     process.exit(1);
   }
 }

package/dist/policy/PolicyManager.js

@@ -101,7 +101,7 @@ class PolicyManager {
         // Warn if using legacy location
         if (policyPath.endsWith('.json')) {
           console.warn(
-            '⚠️  Using legacy policy file location: .caws/policy/tier-policy.json\n' +
+            'Using legacy policy file location: .caws/policy/tier-policy.json\n' +
               '   Migrate to .caws/policy.yaml for better compatibility\n' +
               '   Run: caws init --migrate-policy'
           );

package/dist/scaffold/claude-hooks.js

@@ -46,8 +46,8 @@ async function scaffoldClaudeHooks(projectDir, levels = ['safety', 'quality', 's
     const claudeHooksTemplateDir = path.join(claudeTemplateDir, 'hooks');
 
     if (!fs.existsSync(claudeTemplateDir)) {
-      console.warn(chalk.yellow('⚠️  Claude Code hooks templates not found'));
-      console.warn(chalk.blue('💡 Skipping Claude Code hooks setup'));
+      console.warn(chalk.yellow('Claude Code hooks templates not found'));
+      console.warn(chalk.blue('Skipping Claude Code hooks setup'));
       return;
     }
 
@@ -118,7 +118,7 @@ async function scaffoldClaudeHooks(projectDir, levels = ['safety', 'quality', 's
           }
         });
       } catch (error) {
-        console.warn(chalk.yellow('⚠️  Could not merge existing settings:'), error.message);
+        console.warn(chalk.yellow('Could not merge existing settings:'), error.message);
       }
     }
 
@@ -131,15 +131,15 @@ async function scaffoldClaudeHooks(projectDir, levels = ['safety', 'quality', 's
       await fs.copy(readmePath, path.join(claudeDir, 'README.md'));
     }
 
-    console.log(chalk.green('✅ Claude Code hooks configured'));
+    console.log(chalk.green('Claude Code hooks configured'));
     console.log(chalk.gray(`   Enabled: ${levels.join(', ')}`));
     console.log(
       chalk.gray(`   Scripts: ${Array.from(enabledHooks).length} hook scripts installed`)
     );
-    console.log(chalk.blue('💡 Hooks will activate on next Claude Code session'));
+    console.log(chalk.blue('Hooks will activate on next Claude Code session'));
   } catch (error) {
-    console.error(chalk.yellow('⚠️  Failed to setup Claude Code hooks:'), error.message);
-    console.log(chalk.blue('💡 You can manually copy .claude/ directory later'));
+    console.error(chalk.yellow('Failed to setup Claude Code hooks:'), error.message);
+    console.log(chalk.blue('You can manually copy .claude/ directory later'));
   }
 }
 

package/dist/scaffold/cursor-hooks.js

@@ -45,8 +45,8 @@ async function scaffoldCursorHooks(projectDir, levels = ['safety', 'quality', 's
     const cursorHooksTemplateDir = path.join(cursorTemplateDir, 'hooks');
 
     if (!fs.existsSync(cursorTemplateDir)) {
-      console.warn(chalk.yellow('⚠️  Cursor hooks templates not found'));
-      console.warn(chalk.blue('💡 Skipping Cursor hooks setup'));
+      console.warn(chalk.yellow('Cursor hooks templates not found'));
+      console.warn(chalk.blue('Skipping Cursor hooks setup'));
       return;
     }
 
@@ -154,22 +154,22 @@ async function scaffoldCursorHooks(projectDir, levels = ['safety', 'quality', 's
         await fs.ensureDir(rulesDestDir);
         await fs.copy(rulesTemplateDir, rulesDestDir);
         const ruleFiles = fs.readdirSync(rulesTemplateDir).filter((file) => file.endsWith('.mdc'));
-        console.log(chalk.green('✅ Cursor rules configured'));
+        console.log(chalk.green('Cursor rules configured'));
         console.log(chalk.gray(`   Rules: ${ruleFiles.length} rule files installed`));
       } catch (error) {
-        console.warn(chalk.yellow('⚠️  Failed to copy Cursor rules:'), error.message);
+        console.warn(chalk.yellow('Failed to copy Cursor rules:'), error.message);
       }
     }
 
-    console.log(chalk.green('✅ Cursor hooks configured'));
+    console.log(chalk.green('Cursor hooks configured'));
     console.log(chalk.gray(`   Enabled: ${levels.join(', ')}`));
     console.log(
       chalk.gray(`   Scripts: ${Array.from(enabledHooks).length} hook scripts installed`)
     );
-    console.log(chalk.blue('💡 Restart Cursor to activate hooks'));
+    console.log(chalk.blue('Restart Cursor to activate hooks'));
   } catch (error) {
-    console.error(chalk.yellow('⚠️  Failed to setup Cursor hooks:'), error.message);
-    console.log(chalk.blue('💡 You can manually copy .cursor/ directory later'));
+    console.error(chalk.yellow('Failed to setup Cursor hooks:'), error.message);
+    console.log(chalk.blue('You can manually copy .cursor/ directory later'));
   }
 }