@diff-review-system/drs 4.0.0-rc.4 → 4.1.0

package/README.md

@@ -29,7 +29,7 @@ DRS runs agentic workflows for local diffs, GitHub PRs, and GitLab MRs. Review i
 
 ### 1. Prerequisites
 
-- Node.js 20+
+- Node.js 22.19+
 - API key for your chosen model provider (Anthropic/OpenAI/ZhipuAI/etc.)
 
 ### 2. Install DRS
@@ -50,8 +50,8 @@ drs init
 ### 4. Configure Environment
 
 ```bash
-# Copy example env file
-cp .env.example .env
+# Create a local env file
+touch .env
 
 # Edit .env and set:
 # - GITLAB_TOKEN: Your GitLab access token (for GitLab MRs)
@@ -75,7 +75,7 @@ DRS CLI now loads `.env` automatically from your current working directory.
 drs workflow run local-review
 
 # Review staged changes
-drs workflow run local-staged-review
+drs workflow run local-review --input staged=true
 
 # Update CHANGELOG.md from local changes
 drs workflow run local-changelog-update
@@ -83,8 +83,8 @@ drs workflow run local-changelog-update
 # Update CHANGELOG.md from the previous tag to the current tag, or explicit refs
 drs workflow run tag-changelog-update --input from=v3.3.1 --input to=v4.0.0-rc.1
 
-# Fix issues from a saved workflow review result
-drs workflow run local-fix-review-issues --input-file review=.drs/local-review.json
+# Fix issues from the latest saved local review artifact
+drs workflow run local-fix-review-issues
 
 # Refresh AGENTS.md or equivalent repository guidance
 drs workflow run local-update-agents-md
@@ -98,20 +98,24 @@ drs workflow run local-update-agents-md
 | Goal | Command |
 |---|---|
 | Review local unstaged changes | `drs workflow run local-review` |
-| Review local staged changes | `drs workflow run local-staged-review` |
+| Review local staged changes | `drs workflow run local-review --input staged=true` |
 | Update changelog from local changes | `drs workflow run local-changelog-update` |
 | Update changelog from tag range | `drs workflow run tag-changelog-update` |
-| Fix issues from saved review output | `drs workflow run local-fix-review-issues --input-file review=.drs/local-review.json` |
+| Fix issues from latest saved local review artifact | `drs workflow run local-fix-review-issues` |
 | Update AGENTS.md-style guidance | `drs workflow run local-update-agents-md` |
 | Update changelog and review local changes | `drs workflow run local-changelog-review` |
 | Review GitHub PR via workflow | `drs workflow run github-pr-review --input owner=<owner> --input repo=<repo> --input pr=<number>` |
 | Review GitLab MR via workflow | `drs workflow run gitlab-mr-review --input project=<group/repo> --input mr=<number>` |
 | Show GitHub PR review context | `drs workflow run github-pr-show-changes --input owner=<owner> --input repo=<repo> --input pr=<number>` |
 | Show GitLab MR review context | `drs workflow run gitlab-mr-show-changes --input project=<group/repo> --input mr=<number>` |
-| Review and comment on GitHub PR via workflow | `drs workflow run github-pr-review-post --input owner=<owner> --input repo=<repo> --input pr=<number>` |
-| Review and comment on GitLab MR via workflow | `drs workflow run gitlab-mr-review-post --input project=<group/repo> --input mr=<number>` |
-| Review GitLab MR and write Code Quality report | `drs workflow run gitlab-mr-review-code-quality --input project=<group/repo> --input mr=<number>` |
-| Review/comment GitLab MR and write Code Quality report | `drs workflow run gitlab-mr-review-post-code-quality --input project=<group/repo> --input mr=<number>` |
+| Generate visual PR explainer artifact | `drs workflow run github-pr-visual-explain --input owner=<owner> --input repo=<repo> --input pr=<number>` |
+| Generate visual MR explainer artifact | `drs workflow run gitlab-mr-visual-explain --input project=<group/repo> --input mr=<number>` |
+| Generate visual local diff explainer | `drs workflow run local-visual-explain` |
+| Describe, review, and comment on GitHub PR via workflow | `drs workflow run github-pr-review --input owner=<owner> --input repo=<repo> --input pr=<number> --input describe=true --input post=true` |
+| Describe, review, and comment on GitLab MR via workflow | `drs workflow run gitlab-mr-review --input project=<group/repo> --input mr=<number> --input describe=true --input post=true` |
+| Describe, review, comment, and generate visual PR explainer | `drs workflow run github-pr-review --input owner=<owner> --input repo=<repo> --input pr=<number> --input describe=true --input post=true --input visual=true` |
+| Review GitLab MR and write Code Quality report | `drs workflow run gitlab-mr-review --input project=<group/repo> --input mr=<number> --input codeQuality=true` |
+| Describe/review/comment GitLab MR and write Code Quality report | `drs workflow run gitlab-mr-review --input project=<group/repo> --input mr=<number> --input describe=true --input post=true --input codeQuality=true` |
 | Generate PR description | `drs workflow run github-pr-describe --input owner=<owner> --input repo=<repo> --input pr=<number>` |
 | Generate MR description | `drs workflow run gitlab-mr-describe --input project=<group/repo> --input mr=<number>` |
 | Post or update a PR comment | `drs workflow run github-pr-post-comment --input owner=<owner> --input repo=<repo> --input pr=<number> --input body="..." --input marker=<id>` |
@@ -120,6 +124,7 @@ drs workflow run local-update-agents-md
 | Run a configured workflow | `drs workflow run release-notes --input-file diff=.drs/diff.md` |
 | Run the default project workflow | `drs workflow run` |
 | List available workflows | `drs workflow list` |
+| Show workflow inputs and steps | `drs workflow show github-pr-review` |
 
 ## Deployment Modes
 
@@ -132,13 +137,16 @@ Review code locally before pushing:
 drs workflow run local-review
 
 # Review specific GitLab MR
-drs workflow run gitlab-mr-review-post --input project=my-org/my-repo --input mr=123
+drs workflow run gitlab-mr-review --input project=my-org/my-repo --input mr=123 --input describe=true --input post=true
 
 # Review specific GitHub PR
-drs workflow run github-pr-review-post --input owner=octocat --input repo=hello-world --input pr=456
+drs workflow run github-pr-review --input owner=octocat --input repo=hello-world --input pr=456 --input describe=true --input post=true
+
+# Review and generate a visual explainer artifact
+drs workflow run github-pr-review --input owner=octocat --input repo=hello-world --input pr=456 --input describe=true --input post=true --input visual=true
 
 # Review local staged changes
-drs workflow run local-staged-review
+drs workflow run local-review --input staged=true
 
 # Override model/agent behavior through config, then run workflows
 drs workflow run github-pr-review --input owner=octocat --input repo=hello-world --input pr=456
@@ -152,11 +160,16 @@ drs workflow run github-pr-show-changes --input owner=octocat --input repo=hello
 # Show diff context for a single file
 drs workflow run github-pr-show-changes --input owner=octocat --input repo=hello-world --input pr=456 --input file=src/app.ts
 
+# Generate self-contained HTML visual explainers
+drs workflow run local-visual-explain
+drs workflow run github-pr-visual-explain --input owner=octocat --input repo=hello-world --input pr=456
+drs workflow run gitlab-mr-visual-explain --input project=my-org/my-repo --input mr=123
+
 # Generate PR/MR descriptions on demand
 drs workflow run github-pr-describe --input owner=octocat --input repo=hello-world --input pr=456
-drs workflow run github-pr-describe-post --input owner=octocat --input repo=hello-world --input pr=456
+drs workflow run github-pr-describe --input owner=octocat --input repo=hello-world --input pr=456 --input post=true
 drs workflow run gitlab-mr-describe --input project=my-org/my-repo --input mr=123
-drs workflow run gitlab-mr-describe-post --input project=my-org/my-repo --input mr=123
+drs workflow run gitlab-mr-describe --input project=my-org/my-repo --input mr=123 --input post=true
 
 # Post or update a single marked PR/MR comment
 drs workflow run github-pr-post-comment --input owner=octocat --input repo=hello-world --input pr=456 --input body="Release notes are ready." --input marker=release-notes
@@ -215,6 +228,51 @@ DRS includes a **secure, pre-configured workflow** at `.github/workflows/pr-revi
 - Maintainer workflow
 - Attack prevention strategies
 
+### Visual PR Explainer Artifacts
+
+DRS includes visual explainer workflows that generate a self-contained HTML page for reviewers:
+
+- `github-pr-visual-explain` writes `.drs/visual-pr-explainer.html` by default.
+- `gitlab-mr-visual-explain` writes `.drs/visual-mr-explainer.html` by default.
+- `local-visual-explain` writes `.drs/visual-local-explainer.html` by default.
+
+The main review workflows also support visual artifacts:
+
+```bash
+drs workflow run github-pr-review \
+  --input owner=octocat \
+  --input repo=hello-world \
+  --input pr=456 \
+  --input describe=true \
+  --input post=true \
+  --input visual=true
+```
+
+The built-in `visual/pr-explainer` agent includes DRS-specific HTML generation guidance out of the box. Override `.drs/agents/visual/pr-explainer/agent.md` or configure `agents.overrides.visual/pr-explainer` to tune the output for your project. If you install an external `visual-explainer` skill, add it through `agents.overrides.visual/pr-explainer.skills` so the agent loads those richer templates and design rules.
+
+To publish the generated page from GitHub Actions, upload it as an artifact:
+
+```yaml
+- name: Generate visual explainer
+  env:
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    OPENCODE_API_KEY: ${{ secrets.DRS_PROVIDER_API_KEY }}
+  run: |
+    node dist/cli/index.js workflow run github-pr-review \
+      --input owner="${{ github.event.repository.owner.login }}" \
+      --input repo="${{ github.event.repository.name }}" \
+      --input pr="${{ github.event.pull_request.number }}" \
+      --input describe=true \
+      --input post=true \
+      --input visual=true \
+      --input visualOutputPath=".drs/visual-pr-explainer.html"
+
+- uses: actions/upload-artifact@v4
+  with:
+    name: visual-pr-explainer
+    path: .drs/visual-pr-explainer.html
+```
+
 ## GitLab Code Quality Reports
 
 DRS can generate GitLab-compatible code quality reports that integrate seamlessly with GitLab CI/CD. This provides an alternative (or complement) to inline MR comments.
@@ -229,7 +287,8 @@ DRS can generate GitLab-compatible code quality reports that integrate seamlessl
 - **Non-intrusive**: Doesn't create discussion threads
 
 **When to Use:**
-- Use review-post workflows for critical issues requiring discussion
+- Use `describe=true` to update the PR/MR description before review
+- Use `post=true` for review issues requiring discussion
 - Use **code quality reports** (`--code-quality-report`) for comprehensive static analysis
 - Use **both together** for maximum visibility
 
@@ -237,10 +296,10 @@ DRS can generate GitLab-compatible code quality reports that integrate seamlessl
 
 ```bash
 # Use workflow-based MR review with comments
-drs workflow run gitlab-mr-review-post --input project=my-org/my-repo --input mr=123
+drs workflow run gitlab-mr-review --input project=my-org/my-repo --input mr=123 --input describe=true --input post=true
 
-# For code quality artifacts, run a packaged code-quality workflow
-drs workflow run gitlab-mr-review-code-quality --input project=my-org/my-repo --input mr=123
+# For code quality artifacts, enable codeQuality
+drs workflow run gitlab-mr-review --input project=my-org/my-repo --input mr=123 --input codeQuality=true
 ```
 
 ### GitLab CI Integration
@@ -254,7 +313,7 @@ code_review:
   before_script:
     - npm install -g @diff-review-system/drs
   script:
-    - drs workflow run gitlab-mr-review-post --input project=$CI_PROJECT_PATH --input mr=$CI_MERGE_REQUEST_IID
+    - drs workflow run gitlab-mr-review --input project=$CI_PROJECT_PATH --input mr=$CI_MERGE_REQUEST_IID --input describe=true --input post=true
   only:
     - merge_requests
 ```
@@ -460,6 +519,45 @@ workflow:
 
 See [docs/WORKFLOWS.md](docs/WORKFLOWS.md) for the full workflow configuration reference.
 
+### Temporal Execution (Experimental)
+
+DRS can dispatch workflows through Temporal. The workflow YAML remains the source of truth; DRS compiles it to a JSON plan, runs deterministic scheduling in a generic Temporal workflow, and executes workflow nodes as Temporal activities.
+
+Configure Temporal in `.drs/drs.config.yaml` when the defaults do not match your environment:
+
+```yaml
+temporal:
+  address: localhost:7233
+  namespace: default
+  taskQueue: drs-workflows
+  workflowIdPrefix: drs
+```
+
+Start a worker in the repository where node activities should execute:
+
+```bash
+drs temporal worker
+```
+
+Run a supported workflow through Temporal:
+
+```bash
+drs workflow run local-review --executor temporal
+drs workflow run github-pr-show-changes --executor temporal --input owner=octocat --input repo=hello-world --input pr=456
+drs workflow run local-review --executor temporal --no-wait
+drs workflow run local-review --executor temporal --trace
+```
+
+For a safe local smoke test that does not require model or platform credentials, run the packaged control-flow workflow:
+
+```bash
+drs workflow run temporal-control-smoke --executor temporal --input mode=loop
+drs workflow run temporal-control-smoke --executor temporal --input mode=pass
+drs workflow run temporal-control-smoke --executor temporal --input mode=end
+```
+
+Temporal mode is experimental. It supports DAG workflows and DRS control-flow nodes (`loop`, `switch`, `passThrough`, `end`), structured logs, workflow queries, cancellation state, trace artifacts, and side-effect retry safeguards. See [docs/TEMPORAL.md](docs/TEMPORAL.md) for worker deployment, Temporal UI troubleshooting, and opt-in smoke coverage. See [TEMPORAL_EXECUTION_PLAN.md](TEMPORAL_EXECUTION_PLAN.md) for the rollout plan.
+
 ### Configure Review Behavior
 
 Edit `.drs/drs.config.yaml`:
@@ -591,6 +689,7 @@ contextCompression:
   softBufferTokens: 1500
   hardBufferTokens: 1000
   tokenEstimateDivisor: 4
+  summaryThresholdMultiplier: 3 # use summary-only context above hard limit * multiplier
 ```
 
 ### Runtime Timeouts and Provider Retry
@@ -701,8 +800,9 @@ OPENAI_API_KEY=sk-xxx               # For OpenAI models
 # Optional
 GITLAB_URL=https://gitlab.com
 DRS_DEFAULT_MODEL=anthropic/claude-sonnet-4-5-20250929
-DRS_AGENT_REVIEW_SECURITY_MODEL=anthropic/claude-opus-4-5-20251101
-REVIEW_AGENTS=review/unified-reviewer
+DRS_AGENT_REVIEW_UNIFIED_REVIEWER_MODEL=anthropic/claude-opus-4-5-20251101
+# Configure review agents in .drs/drs.config.yaml via review.agents.
+# Legacy REVIEW_AGENTS is still accepted as a compatibility alias.
 REVIEW_THINKING_LEVEL=medium              # Reasoning effort: off, minimal, low, medium, high, xhigh
 ```
 
@@ -726,13 +826,16 @@ npm run build
 # Run tests
 npm test
 
-# Development mode
-npm run dev
+# Run the CLI from TypeScript once
+npm run dev:cli -- workflow list
+
+# Watch-mode CLI entrypoint
+npm run dev -- workflow list
 ```
 
 ## Requirements
 
-- Node.js 20+
+- Node.js 22.19+
 - API key for your selected provider (Anthropic/OpenAI/ZhipuAI/etc.)
 - GitLab access token (for GitLab MR reviews)
 - GitHub access token (for GitHub PR reviews)

package/dist/ci/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/ci/runner.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAgBnD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAuDjD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/ci/runner.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAgBnD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAyDjD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B"}

package/dist/ci/runner.js

@@ -56,10 +56,12 @@ export async function runCIReview() {
     log.info(`Project: ${env.projectId} | MR: !${env.mrIid} | Branch: ${env.sourceBranch} → ${env.targetBranch}`);
     // Run review
     try {
-        await runWorkflow(config, 'gitlab-mr-review-post', {
+        await runWorkflow(config, 'gitlab-mr-review', {
             inputs: {
                 project: env.projectId,
                 mr: String(env.mrIid),
+                describe: 'true',
+                post: 'true',
             },
             workingDir: projectDir,
         });

package/dist/ci/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/ci/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/ci/runner.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -5,10 +5,14 @@ import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { runAgent } from './run-agent.js';
-import { runWorkflow, listWorkflows } from './workflow.js';
+import { listWorkflows, showWorkflow, showWorkflowGraph, validateWorkflows } from './workflow.js';
 import { loadConfig } from '../lib/config.js';
 import { configureLogger } from '../lib/logger.js';
+import { runTemporalWorker } from '../temporal/worker.js';
+import { createWorkflowExecutor } from './workflow-executor-selection.js';
 import { config as loadDotenv } from 'dotenv';
+import { getSkillStatuses, installBundledSkill, listBundledSkills, syncBundledSkills, } from '../lib/skills.js';
+import { getProjectSetupStatus, syncProjectSetup } from '../lib/project-setup.js';
 // Load environment variables from .env in current working directory (if present)
 loadDotenv();
 const __filename = fileURLToPath(import.meta.url);
@@ -44,6 +48,22 @@ function parseKeyValueOptions(values, optionName) {
     }
     return parsed;
 }
+function printSkillStatuses(statuses) {
+    if (statuses.length === 0) {
+        console.log('No bundled skills found.');
+        return;
+    }
+    for (const status of statuses) {
+        const state = !status.installed
+            ? 'missing'
+            : status.modified
+                ? 'modified'
+                : status.outdated
+                    ? 'outdated'
+                    : 'installed';
+        console.log(`${status.name.padEnd(24)} ${state.padEnd(10)} ${status.installedPath}`);
+    }
+}
 const program = new Command();
 program
     .name('drs')
@@ -67,7 +87,7 @@ program
     try {
         configureLogger({
             level: options.debug ? 'debug' : 'error',
-            format: options.logFormat || 'human',
+            format: options.logFormat ?? 'human',
             timestamps: options.logFormat === 'json',
         });
         const config = loadConfig(process.cwd());
@@ -79,7 +99,7 @@ program
             model: options.model,
             outputPath: options.output,
             jsonOutput: options.json,
-            debug: options.debug || false,
+            debug: options.debug ?? false,
             thinkingLevel,
             workingDir: process.cwd(),
         });
@@ -98,7 +118,10 @@ workflowCommand
     .option('--input-file <key=path>', 'Read workflow input value from a file', collectOption, [])
     .option('-o, --output <path>', 'Write workflow result JSON to a file')
     .option('--json', 'Output workflow result as JSON to console')
+    .option('--executor <executor>', 'Workflow executor: local or temporal', 'local')
+    .option('--no-wait', 'Dispatch Temporal workflow and return immediately')
     .option('--debug', 'Print Pi runtime configuration for debugging')
+    .option('--trace', 'Collect agent traces and save as trace artifact + HTML viewer')
     .option('--log-format <format>', 'Log output format: human (default) or json', 'human')
     .option('--reasoning-effort <level>', 'Reasoning effort level: off, minimal, low, medium, high, xhigh')
     .option('--ultrathink', 'Enable maximum reasoning effort (alias for --reasoning-effort high)')
@@ -106,7 +129,7 @@ workflowCommand
     try {
         configureLogger({
             level: options.debug ? 'debug' : 'error',
-            format: options.logFormat || 'human',
+            format: options.logFormat ?? 'human',
             timestamps: options.logFormat === 'json',
         });
         const config = loadConfig(process.cwd());
@@ -115,13 +138,16 @@ workflowCommand
         if (!workflowName) {
             throw new Error('Provide a workflow name or set workflow.default in .drs/drs.config.yaml.');
         }
-        await runWorkflow(config, workflowName, {
+        const executor = createWorkflowExecutor(String(options.executor ?? 'local'), options.wait !== false);
+        await executor.run(config, workflowName, {
             inputs: parseKeyValueOptions(options.input, '--input'),
             inputFiles: parseKeyValueOptions(options.inputFile, '--input-file'),
             outputPath: options.output,
             jsonOutput: options.json,
-            debug: options.debug || false,
+            debug: options.debug ?? false,
+            trace: options.trace ?? false,
             thinkingLevel,
+            wait: options.wait !== false,
             workingDir: process.cwd(),
         });
         process.exit(0);
@@ -139,9 +165,71 @@ workflowCommand
     try {
         const config = loadConfig(process.cwd());
         listWorkflows(config, {
-            json: options.json || false,
+            json: options.json ?? false,
+            workingDir: process.cwd(),
+        });
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+workflowCommand
+    .command('show <name>')
+    .alias('get')
+    .description('Show workflow details, including inputs and nodes')
+    .option('--json', 'Output as JSON')
+    .action((name, options) => {
+    try {
+        const config = loadConfig(process.cwd());
+        showWorkflow(config, name, {
+            json: options.json ?? false,
+            workingDir: process.cwd(),
+        });
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+workflowCommand
+    .command('graph <name>')
+    .description('Show workflow graph edges as text, JSON, or Mermaid')
+    .option('--format <format>', 'Output format: text, json, or mermaid', 'text')
+    .action((name, options) => {
+    try {
+        const format = String(options.format ?? 'text');
+        if (!['text', 'json', 'mermaid'].includes(format)) {
+            throw new Error('Invalid graph format. Expected one of: text, json, mermaid.');
+        }
+        const config = loadConfig(process.cwd());
+        showWorkflowGraph(config, name, {
+            format: format,
+            workingDir: process.cwd(),
+        });
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+workflowCommand
+    .command('validate [name]')
+    .description('Validate workflow definitions without running them')
+    .option('--json', 'Output as JSON')
+    .action((name, options) => {
+    try {
+        const config = loadConfig(process.cwd());
+        const results = validateWorkflows(config, name, {
+            json: options.json ?? false,
             workingDir: process.cwd(),
         });
+        if (results.some((result) => !result.valid)) {
+            process.exit(1);
+        }
         process.exit(0);
     }
     catch (error) {
@@ -149,7 +237,115 @@ workflowCommand
         process.exit(1);
     }
 });
+const temporalCommand = new Command('temporal').description('Run Temporal workflow workers');
+temporalCommand
+    .command('worker')
+    .description('Run a Temporal worker for DRS workflows')
+    .option('--debug', 'Print debug logs')
+    .option('--log-format <format>', 'Log output format: human (default) or json', 'human')
+    .action(async (options) => {
+    try {
+        configureLogger({
+            level: options.debug ? 'debug' : 'error',
+            format: options.logFormat ?? 'human',
+            timestamps: options.logFormat === 'json',
+        });
+        const config = loadConfig(process.cwd());
+        await runTemporalWorker(config);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
 program.addCommand(workflowCommand);
+program.addCommand(temporalCommand);
+const skillsCommand = new Command('skills').description('Manage project-installed DRS skills');
+skillsCommand
+    .command('list')
+    .description('List bundled DRS skills')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+    try {
+        const skills = listBundledSkills();
+        if (options.json)
+            console.log(JSON.stringify({ skills }, null, 2));
+        else
+            for (const skill of skills)
+                console.log(skill);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+skillsCommand
+    .command('status')
+    .description('Show installed status for bundled DRS skills')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+    try {
+        const statuses = getSkillStatuses(process.cwd());
+        if (options.json)
+            console.log(JSON.stringify({ skills: statuses }, null, 2));
+        else
+            printSkillStatuses(statuses);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+skillsCommand
+    .command('install [name]')
+    .description('Install a bundled DRS skill into .agents/skills')
+    .option('--all', 'Install all bundled skills')
+    .option('--force', 'Overwrite existing skill files')
+    .option('--json', 'Output as JSON')
+    .action((name, options) => {
+    try {
+        let statuses;
+        if (options.all) {
+            statuses = listBundledSkills().map((skill) => installBundledSkill(process.cwd(), skill, { force: options.force ?? false }));
+        }
+        else if (name) {
+            statuses = [installBundledSkill(process.cwd(), name, { force: options.force ?? false })];
+        }
+        else {
+            throw new Error('Provide a skill name or --all.');
+        }
+        if (options.json)
+            console.log(JSON.stringify({ skills: statuses }, null, 2));
+        else
+            printSkillStatuses(statuses);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+skillsCommand
+    .command('sync')
+    .description('Update DRS-managed installed skills when they have no local changes')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+    try {
+        const statuses = syncBundledSkills(process.cwd());
+        if (options.json)
+            console.log(JSON.stringify({ skills: statuses }, null, 2));
+        else
+            printSkillStatuses(statuses);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+program.addCommand(skillsCommand);
 program
     .command('list-agents')
     .description('List available agents')
@@ -172,10 +368,63 @@ program
 program
     .command('init')
     .description('Initialize DRS configuration in current project')
-    .action(async () => {
+    .option('-y, --yes', 'Use non-interactive defaults')
+    .option('--force', 'Overwrite existing project config')
+    .action(async (options) => {
     try {
         const { initProject } = await import('./init.js');
-        await initProject(process.cwd());
+        await initProject(process.cwd(), {
+            yes: options.yes ?? false,
+            force: options.force ?? false,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+program
+    .command('doctor')
+    .description('Check DRS project setup without modifying files')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+    try {
+        const status = getProjectSetupStatus(process.cwd());
+        if (options.json)
+            console.log(JSON.stringify(status, null, 2));
+        else {
+            console.log(`Config: ${status.initialized ? 'present' : 'missing'} (${status.configPath})`);
+            printSkillStatuses(status.skills);
+            if (status.issues.length > 0) {
+                console.log(`Issues: ${status.issues.join(', ')}`);
+            }
+            else {
+                console.log('DRS project setup looks good.');
+            }
+        }
+        process.exit(status.initialized ? 0 : 1);
+    }
+    catch (error) {
+        console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+program
+    .command('sync')
+    .description('Safely sync DRS-managed project assets')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+    try {
+        const status = syncProjectSetup(process.cwd());
+        if (options.json)
+            console.log(JSON.stringify(status, null, 2));
+        else {
+            console.log(`Config: ${status.initialized ? 'present' : 'missing'} (${status.configPath})`);
+            printSkillStatuses(status.skills);
+            if (status.issues.length > 0)
+                console.log(`Issues: ${status.issues.join(', ')}`);
+        }
+        process.exit(status.initialized ? 0 : 1);
     }
     catch (error) {
         console.error(chalk.red('Error:'), error instanceof Error ? error.message : String(error));