claude-code-workflow 6.1.3 → 6.2.1

package/CLAUDE.md

@@ -1,91 +0,0 @@
-# Development Guidelines
-
-## Overview
-
-This document defines project-specific coding standards and development principles.
-### CLI Tool Context Protocols
-For all CLI tool usage, command syntax, and integration guidelines:
-- **Tool Strategy**: @~/.claude/workflows/tool-strategy.md
-- **Intelligent Context Strategy**: @~/.claude/workflows/intelligent-tools-strategy.md
-- **Context Search Commands**: @~/.claude/workflows/context-search-strategy.md
-
-**Context Requirements**:
-- Identify 3+ existing similar patterns before implementation
-- Map dependencies and integration points
-- Understand testing framework and coding conventions
-
-
-## Philosophy
-
-### Core Beliefs
-
-- **Pursue good taste** - Eliminate edge cases to make code logic natural and elegant
-- **Embrace extreme simplicity** - Complexity is the root of all evil
-- **Be pragmatic** - Code must solve real-world problems, not hypothetical ones
-- **Data structures first** - Bad programmers worry about code; good programmers worry about data structures
-- **Never break backward compatibility** - Existing functionality is sacred and inviolable
-- **Incremental progress over big bangs** - Small changes that compile and pass tests
-- **Learning from existing code** - Study and plan before implementing
-- **Clear intent over clever code** - Be boring and obvious
-- **Follow existing code style** - Match import patterns, naming conventions, and formatting of existing codebase
-- **Minimize changes** - Only modify what's directly required; avoid refactoring, adding features, or "improving" code beyond the request
-- **No unsolicited documentation** - NEVER generate reports, documentation files, or summaries without explicit user request. If required, save to .workflow/.scratchpad/
-
-### Simplicity Means
-
-- Single responsibility per function/class
-- Avoid premature abstractions
-- No clever tricks - choose the boring solution
-- If you need to explain it, it's too complex
-
-## Project Integration
-
-### Learning the Codebase
-
-- Find 3 similar features/components
-- Identify common patterns and conventions
-- Use same libraries/utilities when possible
-- Follow existing test patterns
-
-### Tooling
-
-- Use project's existing build system
-- Use project's test framework  
-- Use project's formatter/linter settings
-- Don't introduce new tools without strong justification
-
-
-### Fix, Don't Hide
-
-- **Solve problems, don't silence symptoms** - Skipped tests, `@ts-ignore`, empty catch, `as any`, excessive timeouts = hiding bugs, not fixing them
-
-**NEVER**:
-- Make assumptions - verify with existing code
-- Generate reports, summaries, or documentation files without explicit user request
-- Use suppression mechanisms (`skip`, `ignore`, `disable`) without fixing root cause
-
-**ALWAYS**:
-- Plan complex tasks thoroughly before implementation
-- Generate task decomposition for multi-module work (>3 modules or >5 subtasks)
-- Track progress using TODO checklists for complex tasks
-- Validate planning documents before starting development
-- Commit working code incrementally
-- Update plan documentation and progress tracking as you go
-- Learn from existing implementations
-- Stop after 3 failed attempts and reassess
-- **Edit fallback**: When Edit tool fails 2+ times on same file, try Bash sed/awk first, then Write to recreate if still failing
-
-## Platform-Specific Guidelines
-
-### Windows Path Format Guidelines
-- **MCP Tools**: Double backslash `D:\\path\\file.txt`
-- **Bash Commands**: Forward slash `D:/path/file.txt` or `/d/path/file.txt`
-- **Relative Paths**: Universal (works in both)
-
-#### **Content Uniqueness Rules**
-
-- **Each layer owns its abstraction level** - no content sharing between layers
-- **Reference, don't duplicate** - point to other layers, never copy content
-- **Maintain perspective** - each layer sees the system at its appropriate scale
-- **Avoid implementation creep** - higher layers stay architectural
-

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Claude Development Guidelines
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/ccw/README.md

@@ -1,121 +0,0 @@
-# CCW - Claude Code Workflow CLI
-
-A command-line tool for viewing workflow sessions and code review results from the Claude Code Workflow system.
-
-## Installation
-
-```bash
-# Install globally
-npm install -g ccw
-
-# Or install from local source
-cd path/to/ccw
-npm install
-npm link
-```
-
-## Usage
-
-### View Dashboard
-
-```bash
-# Open workflow dashboard in browser
-ccw view
-
-# Specify project path
-ccw view -p /path/to/project
-
-# Generate dashboard without opening browser
-ccw view --no-browser
-
-# Custom output path
-ccw view -o report.html
-```
-
-## Features
-
-### Workflow Dashboard
-- **Active Sessions**: View all active workflow sessions with task progress
-- **Archived Sessions**: Browse completed/archived sessions
-- **Task Tracking**: See individual task status (pending/in_progress/completed)
-- **Progress Bars**: Visual progress indicators for each session
-
-### Review Integration
-- **Code Review Findings**: View results from `review-module-cycle`
-- **Severity Distribution**: Critical/High/Medium/Low finding counts
-- **Dimension Analysis**: Findings by review dimension (Security, Architecture, Quality, etc.)
-- **Tabbed Interface**: Switch between Workflow and Reviews tabs
-
-## Dashboard Data Sources
-
-The CLI reads data from the `.workflow/` directory structure:
-
-```
-.workflow/
-├── active/
-│   └── WFS-{session-id}/
-│       ├── workflow-session.json    # Session metadata
-│       ├── .task/
-│       │   └── IMPL-*.json          # Task definitions
-│       └── .review/
-│           ├── review-progress.json # Review progress
-│           └── dimensions/
-│               └── *.json           # Dimension findings
-└── archives/
-    └── WFS-{session-id}/            # Archived sessions
-```
-
-## Bundled Templates
-
-The CLI includes bundled dashboard templates:
-- `workflow-dashboard.html` - Workflow session and task visualization
-- `review-cycle-dashboard.html` - Code review findings display
-
-No external template installation required - templates are included in the npm package.
-
-## Requirements
-
-- Node.js >= 16.0.0
-- npm or yarn
-
-## Integration with Claude Code Workflow
-
-This CLI is a standalone tool that works with the Claude Code Workflow system:
-
-1. **Install CCW CLI** (via npm)
-   - `npm install -g ccw`
-   - Provides `ccw view` command for dashboard viewing
-   - Templates are bundled - no additional installation required
-
-2. **Optional: Install Claude Code Workflow** (via `Install-Claude.ps1`)
-   - Provides workflow commands, agents, and automation
-   - CCW will automatically detect and display workflow sessions
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `-p, --path <path>` | Path to project directory (default: current directory) |
-| `--no-browser` | Generate dashboard without opening browser |
-| `-o, --output <file>` | Custom output path for HTML file |
-| `-V, --version` | Display version number |
-| `-h, --help` | Display help information |
-
-## Development
-
-```bash
-# Clone and install dependencies
-git clone <repo-url>
-cd ccw
-npm install
-
-# Link for local testing
-npm link
-
-# Test the CLI
-ccw view -p /path/to/test/project
-```
-
-## License
-
-MIT

package/ccw/bin/ccw.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * CCW CLI - Claude Code Workflow Dashboard
- * Entry point for global CLI installation
- */
-
-import { run } from '../src/cli.js';
-
-run(process.argv);

package/ccw/package.json

@@ -1,47 +0,0 @@
-{
-  "name": "ccw",
-  "version": "1.0.0",
-  "description": "Claude Code Workflow CLI - Dashboard viewer for workflow sessions and reviews",
-  "type": "module",
-  "main": "src/index.js",
-  "bin": {
-    "ccw": "./bin/ccw.js"
-  },
-  "scripts": {
-    "test": "node --test",
-    "lint": "eslint src/"
-  },
-  "keywords": [
-    "claude",
-    "workflow",
-    "cli",
-    "dashboard",
-    "code-review"
-  ],
-  "author": "Claude Code Workflow",
-  "license": "MIT",
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "dependencies": {
-    "boxen": "^7.1.0",
-    "chalk": "^5.3.0",
-    "commander": "^11.0.0",
-    "figlet": "^1.7.0",
-    "glob": "^10.3.0",
-    "gradient-string": "^2.0.2",
-    "inquirer": "^9.2.0",
-    "open": "^9.1.0",
-    "ora": "^7.0.0"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/claude-code-workflow/ccw"
-  }
-}

package/ccw/src/cli.js

@@ -1,119 +0,0 @@
-import { Command } from 'commander';
-import { viewCommand } from './commands/view.js';
-import { serveCommand } from './commands/serve.js';
-import { stopCommand } from './commands/stop.js';
-import { installCommand } from './commands/install.js';
-import { uninstallCommand } from './commands/uninstall.js';
-import { upgradeCommand } from './commands/upgrade.js';
-import { listCommand } from './commands/list.js';
-import { toolCommand } from './commands/tool.js';
-import { readFileSync, existsSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * Load package.json with error handling
- * @returns {Object} - Package info with version
- */
-function loadPackageInfo() {
-  const pkgPath = join(__dirname, '../package.json');
-
-  try {
-    if (!existsSync(pkgPath)) {
-      console.error('Fatal Error: package.json not found.');
-      console.error(`Expected location: ${pkgPath}`);
-      process.exit(1);
-    }
-
-    const content = readFileSync(pkgPath, 'utf8');
-    return JSON.parse(content);
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      console.error('Fatal Error: package.json contains invalid JSON.');
-      console.error(`Parse error: ${error.message}`);
-    } else {
-      console.error('Fatal Error: Could not read package.json.');
-      console.error(`Error: ${error.message}`);
-    }
-    process.exit(1);
-  }
-}
-
-const pkg = loadPackageInfo();
-
-export function run(argv) {
-  const program = new Command();
-
-  program
-    .name('ccw')
-    .description('Claude Code Workflow CLI - Dashboard and workflow tools')
-    .version(pkg.version);
-
-  // View command (server mode with live path switching)
-  program
-    .command('view')
-    .description('Open workflow dashboard server with live path switching')
-    .option('-p, --path <path>', 'Path to project directory', '.')
-    .option('--port <port>', 'Server port', '3456')
-    .option('--no-browser', 'Start server without opening browser')
-    .action(viewCommand);
-
-  // Serve command (alias for view)
-  program
-    .command('serve')
-    .description('Alias for view command')
-    .option('-p, --path <path>', 'Initial project directory')
-    .option('--port <port>', 'Server port', '3456')
-    .option('--no-browser', 'Start server without opening browser')
-    .action(serveCommand);
-
-  // Stop command
-  program
-    .command('stop')
-    .description('Stop the running CCW dashboard server')
-    .option('--port <port>', 'Server port', '3456')
-    .option('-f, --force', 'Force kill process on the port')
-    .action(stopCommand);
-
-  // Install command
-  program
-    .command('install')
-    .description('Install Claude Code Workflow to your system')
-    .option('-m, --mode <mode>', 'Installation mode: Global or Path')
-    .option('-p, --path <path>', 'Installation path (for Path mode)')
-    .option('-f, --force', 'Force installation without prompts')
-    .action(installCommand);
-
-  // Uninstall command
-  program
-    .command('uninstall')
-    .description('Uninstall Claude Code Workflow')
-    .action(uninstallCommand);
-
-  // Upgrade command
-  program
-    .command('upgrade')
-    .description('Upgrade Claude Code Workflow installations')
-    .option('-a, --all', 'Upgrade all installations without prompting')
-    .action(upgradeCommand);
-
-  // List command
-  program
-    .command('list')
-    .description('List all installed Claude Code Workflow instances')
-    .action(listCommand);
-
-  // Tool command
-  program
-    .command('tool [subcommand] [args]')
-    .description('Execute CCW tools')
-    .option('--path <path>', 'File path (for edit_file)')
-    .option('--old <text>', 'Old text to replace (for edit_file)')
-    .option('--new <text>', 'New text (for edit_file)')
-    .action((subcommand, args, options) => toolCommand(subcommand, args, options));
-
-  program.parse(argv);
-}