Files
Claude-Code-Workflow/ccw/src/tools
catlog22 680c2a0597 fix(cli): allow codex review with target flags without prompt
- Skip template concatenation when using --uncommitted/--base/--commit
- Allow empty prompt for review mode with target flags
- Add hasReviewTarget check in command routing
- Update documentation with validation constraints

codex review constraint: target flags and prompt are mutually exclusive
2026-01-17 22:07:26 +08:00
..

Tools

This directory contains CCW “tools”: self-contained modules that implement concrete functionality (executors, integrations, etc.) that higher-level CLI and route layers call into.

CLI Executor

The CLI executor is split into focused modules to keep responsibilities clear and keep the public API stable via re-exports.

Entry point

  • ccw/src/tools/cli-executor.ts thin facade that re-exports from cli-executor-core.ts (stable import path for callers).

Modules

  • ccw/src/tools/cli-executor-core.ts orchestrates tool execution, resume/merge logic, and conversation persistence wiring.
  • ccw/src/tools/cli-executor-utils.ts debug logging, tool availability checks (with cache), command building.
  • ccw/src/tools/cli-executor-state.ts conversation/history types + SQLite-backed storage helpers.
  • ccw/src/tools/cli-prompt-builder.ts prompt concatenation helpers (plain/YAML/JSON) and merged-conversation prompt formatting.

Dependency flow (high level)

cli-executor.ts
  -> cli-executor-core.ts
      -> cli-executor-utils.ts
      -> cli-executor-state.ts
      -> cli-prompt-builder.ts

Public API

  • Prefer importing from ccw/src/tools/cli-executor.ts.
  • cli-executor-core.ts re-exports prompt helpers/types from cli-prompt-builder.ts to preserve existing imports (PromptConcatenator, buildPrompt, PromptFormat, etc.).