devworkspace 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -2,9 +2,26 @@
 
 All notable changes are documented here. This project follows [Semantic Versioning](https://semver.org/). Workspace schema changes are called out under **Breaking**.
 
-## [Unreleased]
+## [0.3.2] - 2026-11-02
 
 ### Added
+- **Single-Command Repository Setup (`devworkspace setup`)**:
+  - One-command onboarding workflow inspecting project structure, initializing `.devworkspace/`, discovering verification contracts, checking integration status, and validating overall health.
+  - Automatically verifies command contracts against real package manifests and execution directories (`cwd`), reporting drift before task execution.
+  - Safe and idempotent; preserves existing project UUID, user overrides, and custom commands across repeated executions.
+- **Feature-Level Knowledge Map & Verification (`devworkspace feature`)**:
+  - Introduced typed, backward-compatible feature schema in `.devworkspace/context/features.json` connecting frontend entry points, API routes, backend services, database models, and unit tests.
+  - Added `devworkspace feature list`, `devworkspace feature show <id>`, `devworkspace feature add`, and `devworkspace feature validate`.
+  - Feature validator inspects real repository files and code symbols on disk, distinguishing verified facts from inferred entries and flagging broken references.
+- **Bounded Graphify Knowledge Graph Tracing (`devworkspace graph`)**:
+  - Added `devworkspace graph status` and `devworkspace graph trace [--from <node|path>] [--depth <n>]` supporting Graphify's output format (`graphify-out/graph.json`).
+  - Traversal is bounded by BFS depth limits with cycle protection and edge deduplication.
+  - Verifies graph nodes against real repository files and code symbols, tagging unverified nodes or references as hypotheses (`[hypothesis]`).
+- **Verification Integrity & Contract Drift Prevention**:
+  - Prevents vacuous test passes: detects zero-test executions (`0 passed, 0 failed`) and flags them as unverified rather than false successes.
+  - Reports command-contract drift in `devworkspace doctor` when configured checks reference missing npm scripts or non-existent working directories.
+- **CLI Provenance & Version Diagnostics**:
+  - Reports exact CLI version, executable path, and execution mode (`source-checkout`, `installed-package`, `npx-cache`) in `setup` and `doctor`.
 - **Agent-Agnostic Architecture & Multi-Agent Compatibility**:
   - Introduced typed `AgentAdapter` interface and shared section-merging engine in `src/agents/` to decouple DevWorkspace from Claude-specific assumptions.
   - Implemented typed adapters for **Claude Code** (`claude`), **OpenAI Codex / open agent standard** (`codex` / `agents` via `AGENTS.md`), **Cursor** (`cursor` via modern `.cursor/rules/devworkspace.mdc` and legacy `.cursorrules`), and **GitHub Copilot** (`copilot` via `.github/copilot-instructions.md`).

package/README.md

@@ -91,7 +91,7 @@ devworkspace doctor        # check workspace, integrations, security, portabilit
 | Command | Purpose |
 | --- | --- |
 | `init` | Create `.devworkspace/` (idempotent, never touches source) |
-| `setup --integrations` | Install and verify Graphify, Agent Skills and Ponytail (`--dry-run`, `--yes`, `--scope`, `--only`) |
+| `setup` | One-command setup: initialize workspace, discover commands, verify diagnostics, optionally install integrations (`--integrations`) |
 | `integrations` | `status` (observed, never assumed) and `repair` |
 | `analyze` | Deterministic discovery; writes `discovery.json`, testing contract, onboarding prompt |
 | `agent install` | Add managed instruction blocks for your coding agent (`--agent claude\|codex\|cursor\|copilot\|all`) |
@@ -101,6 +101,8 @@ devworkspace doctor        # check workspace, integrations, security, portabilit
 | `refresh` | Incremental staleness check; writes a refresh prompt when AI re-validation is needed |
 | `context` | Show stored knowledge (`--topic` filters facts and the testing contract; safety rules are always shown; `--full`) |
 | `fact` | `add` / `verify` / `remove` / `list` project knowledge with provenance |
+| `feature` | `list` / `show` / `validate` / `add` feature-level map connecting frontend, backend, database and tests |
+| `graph` | `status` and `trace` bounded knowledge-graph navigation with node and edge verification |
 | `task` | `new` / `list` / `show` / `status` / `update` / `run` / `verify` / `tests` / `attest` with a package-aware completion gate |
 | `testenv` | `declare` / `list` / `revoke` a test environment so database-touching checks may run (local, never committed) |
 | `decision` | Append-only, human-readable decision records |

package/dist/cli/args.d.ts

@@ -223,6 +223,48 @@ export declare const OPTIONS: {
     readonly deep: {
         readonly type: "boolean";
     };
+    readonly id: {
+        readonly type: "string";
+    };
+    readonly name: {
+        readonly type: "string";
+    };
+    readonly description: {
+        readonly type: "string";
+    };
+    readonly symbol: {
+        readonly type: "string";
+    };
+    readonly entry: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly route: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly service: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly model: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly test: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly tag: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly from: {
+        readonly type: "string";
+    };
+    readonly depth: {
+        readonly type: "string";
+    };
 };
 export interface ParsedArgs {
     positionals: string[];

package/dist/cli/args.js

@@ -71,6 +71,18 @@ export const OPTIONS = {
     target: { type: 'string' },
     timeout: { type: 'string' },
     deep: { type: 'boolean' },
+    id: { type: 'string' },
+    name: { type: 'string' },
+    description: { type: 'string' },
+    symbol: { type: 'string' },
+    entry: { type: 'string', multiple: true },
+    route: { type: 'string', multiple: true },
+    service: { type: 'string', multiple: true },
+    model: { type: 'string', multiple: true },
+    test: { type: 'string', multiple: true },
+    tag: { type: 'string', multiple: true },
+    from: { type: 'string' },
+    depth: { type: 'string' },
 };
 export function parseCli(argv) {
     try {

package/dist/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseArgs } from 'node:util';\nimport { DevWorkspaceError } from '../errors/index.js';\n\ntype OptionSpec = { type: 'boolean' | 'string'; short?: string; multiple?: boolean };\n\n/** Every flag the CLI understands. Unknown flags are rejected so typos never silently do nothing. */\nexport const OPTIONS = {\n  help: { type: 'boolean', short: 'h' },\n  version: { type: 'boolean', short: 'v' },\n  json: { type: 'boolean' },\n  debug: { type: 'boolean' },\n  'no-color': { type: 'boolean' },\n  ascii: { type: 'boolean' },\n  'dry-run': { type: 'boolean' },\n  yes: { type: 'boolean', short: 'y' },\n  'include-agent-files': { type: 'boolean' },\n  integrations: { type: 'boolean' },\n  'with-integrations': { type: 'boolean' },\n  only: { type: 'string', multiple: true },\n  scope: { type: 'string' },\n  restarted: { type: 'boolean' },\n  quick: { type: 'boolean' },\n  cwd: { type: 'string' },\n  root: { type: 'string' },\n  fix: { type: 'boolean' },\n  strict: { type: 'boolean' },\n  out: { type: 'string', short: 'o' },\n  overwrite: { type: 'boolean' },\n  'allow-different-project': { type: 'boolean' },\n  topic: { type: 'string' },\n  full: { type: 'boolean' },\n  all: { type: 'boolean' },\n  agent: { type: 'string' },\n  type: { type: 'string' },\n  title: { type: 'string' },\n  key: { type: 'string' },\n  value: { type: 'string' },\n  source: { type: 'string' },\n  'source-type': { type: 'string' },\n  file: { type: 'string', multiple: true },\n  confidence: { type: 'string' },\n  status: { type: 'string' },\n  reason: { type: 'string' },\n  detail: { type: 'string' },\n  note: { type: 'string' },\n  phase: { type: 'string' },\n  passed: { type: 'string' },\n  failed: { type: 'string' },\n  criteria: { type: 'string', multiple: true },\n  plan: { type: 'string', multiple: true },\n  area: { type: 'string', multiple: true },\n  'decision-note': { type: 'string', multiple: true },\n  summary: { type: 'string' },\n  blocker: { type: 'string', multiple: true },\n  'clear-blockers': { type: 'boolean' },\n  require: { type: 'string', multiple: true },\n  'user-work-intact': { type: 'boolean' },\n  'knowledge-reviewed': { type: 'boolean' },\n  'final-state-inspected': { type: 'boolean' },\n  context: { type: 'string' },\n  for: { type: 'string' },\n  decision: { type: 'string' },\n  consequences: { type: 'string' },\n  supersedes: { type: 'string' },\n  goal: { type: 'string' },\n  done: { type: 'string', multiple: true },\n  'tests-run': { type: 'string', multiple: true },\n  remaining: { type: 'string', multiple: true },\n  next: { type: 'string' },\n  task: { type: 'string' },\n  limit: { type: 'string' },\n  package: { type: 'string' },\n  check: { type: 'string', multiple: true },\n  target: { type: 'string' },\n  timeout: { type: 'string' },\n  deep: { type: 'boolean' },\n} as const satisfies Record<string, OptionSpec>;\n\nexport interface ParsedArgs {\n  positionals: string[];\n  values: Record<string, string | boolean | string[] | undefined>;\n}\n\nexport function parseCli(argv: string[]): ParsedArgs {\n  try {\n    const { values, positionals } = parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: true });\n    return { positionals, values: values as ParsedArgs['values'] };\n  } catch (e) {\n    throw new DevWorkspaceError('USAGE', (e as Error).message.replace(/^Unknown option/, 'Unknown option'), {\n      hint: 'Run \"devworkspace --help\" or \"devworkspace <command> --help\".',\n    });\n  }\n}\n\nexport function str(v: ParsedArgs['values'], k: string): string | undefined {\n  const x = v[k];\n  return typeof x === 'string' ? x : undefined;\n}\n\nexport function bool(v: ParsedArgs['values'], k: string): boolean {\n  return v[k] === true;\n}\n\nexport function list(v: ParsedArgs['values'], k: string): string[] {\n  const x = v[k];\n  return Array.isArray(x) ? x : [];\n}\n\nexport function int(v: ParsedArgs['values'], k: string): number | undefined {\n  const s = str(v, k);\n  if (s === undefined) return undefined;\n  const n = Number(s);\n  if (!Number.isInteger(n)) throw new DevWorkspaceError('USAGE', `--${k} must be an integer (got \"${s}\").`);\n  return n;\n}\n"]}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseArgs } from 'node:util';\nimport { DevWorkspaceError } from '../errors/index.js';\n\ntype OptionSpec = { type: 'boolean' | 'string'; short?: string; multiple?: boolean };\n\n/** Every flag the CLI understands. Unknown flags are rejected so typos never silently do nothing. */\nexport const OPTIONS = {\n  help: { type: 'boolean', short: 'h' },\n  version: { type: 'boolean', short: 'v' },\n  json: { type: 'boolean' },\n  debug: { type: 'boolean' },\n  'no-color': { type: 'boolean' },\n  ascii: { type: 'boolean' },\n  'dry-run': { type: 'boolean' },\n  yes: { type: 'boolean', short: 'y' },\n  'include-agent-files': { type: 'boolean' },\n  integrations: { type: 'boolean' },\n  'with-integrations': { type: 'boolean' },\n  only: { type: 'string', multiple: true },\n  scope: { type: 'string' },\n  restarted: { type: 'boolean' },\n  quick: { type: 'boolean' },\n  cwd: { type: 'string' },\n  root: { type: 'string' },\n  fix: { type: 'boolean' },\n  strict: { type: 'boolean' },\n  out: { type: 'string', short: 'o' },\n  overwrite: { type: 'boolean' },\n  'allow-different-project': { type: 'boolean' },\n  topic: { type: 'string' },\n  full: { type: 'boolean' },\n  all: { type: 'boolean' },\n  agent: { type: 'string' },\n  type: { type: 'string' },\n  title: { type: 'string' },\n  key: { type: 'string' },\n  value: { type: 'string' },\n  source: { type: 'string' },\n  'source-type': { type: 'string' },\n  file: { type: 'string', multiple: true },\n  confidence: { type: 'string' },\n  status: { type: 'string' },\n  reason: { type: 'string' },\n  detail: { type: 'string' },\n  note: { type: 'string' },\n  phase: { type: 'string' },\n  passed: { type: 'string' },\n  failed: { type: 'string' },\n  criteria: { type: 'string', multiple: true },\n  plan: { type: 'string', multiple: true },\n  area: { type: 'string', multiple: true },\n  'decision-note': { type: 'string', multiple: true },\n  summary: { type: 'string' },\n  blocker: { type: 'string', multiple: true },\n  'clear-blockers': { type: 'boolean' },\n  require: { type: 'string', multiple: true },\n  'user-work-intact': { type: 'boolean' },\n  'knowledge-reviewed': { type: 'boolean' },\n  'final-state-inspected': { type: 'boolean' },\n  context: { type: 'string' },\n  for: { type: 'string' },\n  decision: { type: 'string' },\n  consequences: { type: 'string' },\n  supersedes: { type: 'string' },\n  goal: { type: 'string' },\n  done: { type: 'string', multiple: true },\n  'tests-run': { type: 'string', multiple: true },\n  remaining: { type: 'string', multiple: true },\n  next: { type: 'string' },\n  task: { type: 'string' },\n  limit: { type: 'string' },\n  package: { type: 'string' },\n  check: { type: 'string', multiple: true },\n  target: { type: 'string' },\n  timeout: { type: 'string' },\n  deep: { type: 'boolean' },\n  id: { type: 'string' },\n  name: { type: 'string' },\n  description: { type: 'string' },\n  symbol: { type: 'string' },\n  entry: { type: 'string', multiple: true },\n  route: { type: 'string', multiple: true },\n  service: { type: 'string', multiple: true },\n  model: { type: 'string', multiple: true },\n  test: { type: 'string', multiple: true },\n  tag: { type: 'string', multiple: true },\n  from: { type: 'string' },\n  depth: { type: 'string' },\n} as const satisfies Record<string, OptionSpec>;\n\nexport interface ParsedArgs {\n  positionals: string[];\n  values: Record<string, string | boolean | string[] | undefined>;\n}\n\nexport function parseCli(argv: string[]): ParsedArgs {\n  try {\n    const { values, positionals } = parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: true });\n    return { positionals, values: values as ParsedArgs['values'] };\n  } catch (e) {\n    throw new DevWorkspaceError('USAGE', (e as Error).message.replace(/^Unknown option/, 'Unknown option'), {\n      hint: 'Run \"devworkspace --help\" or \"devworkspace <command> --help\".',\n    });\n  }\n}\n\nexport function str(v: ParsedArgs['values'], k: string): string | undefined {\n  const x = v[k];\n  return typeof x === 'string' ? x : undefined;\n}\n\nexport function bool(v: ParsedArgs['values'], k: string): boolean {\n  return v[k] === true;\n}\n\nexport function list(v: ParsedArgs['values'], k: string): string[] {\n  const x = v[k];\n  return Array.isArray(x) ? x : [];\n}\n\nexport function int(v: ParsedArgs['values'], k: string): number | undefined {\n  const s = str(v, k);\n  if (s === undefined) return undefined;\n  const n = Number(s);\n  if (!Number.isInteger(n)) throw new DevWorkspaceError('USAGE', `--${k} must be an integer (got \"${s}\").`);\n  return n;\n}\n"]}

package/dist/cli/help.js

@@ -19,17 +19,20 @@ export const COMMANDS = [
     },
     {
         name: 'setup',
-        summary: 'Install and verify Graphify, Agent Skills and Ponytail',
-        usage: ['devworkspace setup --integrations [--yes] [--dry-run] [--scope project|user] [--only graphify,agent-skills,ponytail] [--json]'],
+        summary: 'Single-command repository setup (inspect, initialize, discover contract & validate)',
+        usage: [
+            'devworkspace setup',
+            'devworkspace setup --integrations [--yes] [--dry-run] [--scope project|user] [--only graphify,agent-skills,ponytail]',
+        ],
         options: [
-            ['--integrations', 'set up the integrations (required: it is the only thing setup does today)'],
+            ['--integrations', 'set up external integrations (Graphify, Agent Skills, Ponytail)'],
             ['--dry-run', 'show exactly what would run; changes nothing'],
-            ['--yes', 'approve steps that install a tool for your user account, change user-level Claude Code settings, or run a registry package. Without it only project-local steps run.'],
+            ['--yes', 'with --integrations: approve machine-level and third-party installs'],
             ['--scope project|user', 'where to install (default: project; user needs --yes)'],
             ['--only <ids>', 'comma-separated: graphify, agent-skills, ponytail'],
             ...COMMON,
         ],
-        examples: ['devworkspace setup --integrations --dry-run', 'devworkspace setup --integrations --yes', 'devworkspace setup --integrations --only ponytail --yes --json'],
+        examples: ['devworkspace setup', 'devworkspace setup --json', 'devworkspace setup --integrations --yes'],
     },
     {
         name: 'integrations',
@@ -98,6 +101,50 @@ export const COMMANDS = [
         ],
         examples: ['devworkspace fact add --key auth.sessions --value "Sessions live in Redis" --source "src/auth/session.ts" --file src/auth/session.ts --source-type ai --confidence HIGH --status VERIFIED'],
     },
+    {
+        name: 'feature',
+        summary: 'Manage feature-level knowledge and end-to-end component traces',
+        usage: [
+            'devworkspace feature list',
+            'devworkspace feature show <id>',
+            'devworkspace feature validate',
+            'devworkspace feature add --id <id> --name <name> [--entry <path>...] [--route <path>...] [--service <path>...] [--model <path>...] [--test <path>...] [--symbol <sym>]',
+        ],
+        options: [
+            ['--id <id>', 'unique feature identifier, e.g. auth.login'],
+            ['--name <name>', 'human-readable name for the feature'],
+            ['--entry <path>', 'frontend entry point path (repeatable)'],
+            ['--route <path>', 'backend route/controller path (repeatable)'],
+            ['--service <path>', 'backend service path (repeatable)'],
+            ['--model <path>', 'database model/schema path (repeatable)'],
+            ['--test <path>', 'test file path (repeatable)'],
+            ['--symbol <sym>', 'symbol name (function, class, endpoint) to verify in component files'],
+            ...COMMON,
+        ],
+        examples: [
+            'devworkspace feature list',
+            'devworkspace feature show auth.login',
+            'devworkspace feature validate',
+            'devworkspace feature add --id auth.login --name "User Authentication" --entry frontend/src/pages/Login.tsx --route backend/src/routes/auth.ts --symbol authRoutes',
+        ],
+    },
+    {
+        name: 'graph',
+        summary: 'Inspect and trace Graphify knowledge graphs',
+        usage: [
+            'devworkspace graph status',
+            'devworkspace graph trace [--from <path|query>] [--depth <n>]',
+        ],
+        options: [
+            ['--from <path|query>', 'starting node file path or symbol name to trace from'],
+            ['--depth <n>', 'maximum traversal depth (1-10, default 2)'],
+            ...COMMON,
+        ],
+        examples: [
+            'devworkspace graph status',
+            'devworkspace graph trace --from src/api.ts --depth 3',
+        ],
+    },
     {
         name: 'task',
         summary: 'Track engineering tasks with a completion gate',

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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","sourcesContent":["export interface CommandHelp {\n  name: string;\n  summary: string;\n  usage: string[];\n  options: [string, string][];\n  examples: string[];\n}\n\nconst COMMON: [string, string][] = [\n  ['--json', 'machine-readable output'],\n  ['--cwd <dir>', 'run as if started in <dir>'],\n  ['--debug', 'show stack traces and debug logs'],\n];\n\nexport const COMMANDS: CommandHelp[] = [\n  {\n    name: 'init',\n    summary: 'Create .devworkspace/ in the current project (safe to re-run)',\n    usage: ['devworkspace init [--root <dir>] [--dry-run] [--with-integrations [--yes] [--scope project|user]]'],\n    options: [\n      ['--root <dir>', 'project root (default: Git top-level or current directory)'],\n      ['--dry-run', 'show what would be created'],\n      ['--with-integrations', 'then run the same integration setup as \"devworkspace setup --integrations\"'],\n      ['--yes', 'with --with-integrations: approve machine-level and third-party installs'],\n      ...COMMON,\n    ],\n    examples: ['npx devworkspace init', 'npx devworkspace init --with-integrations --yes'],\n  },\n  {\n    name: 'setup',\n    summary: 'Install and verify Graphify, Agent Skills and Ponytail',\n    usage: ['devworkspace setup --integrations [--yes] [--dry-run] [--scope project|user] [--only graphify,agent-skills,ponytail] [--json]'],\n    options: [\n      ['--integrations', 'set up the integrations (required: it is the only thing setup does today)'],\n      ['--dry-run', 'show exactly what would run; changes nothing'],\n      ['--yes', 'approve steps that install a tool for your user account, change user-level Claude Code settings, or run a registry package. Without it only project-local steps run.'],\n      ['--scope project|user', 'where to install (default: project; user needs --yes)'],\n      ['--only <ids>', 'comma-separated: graphify, agent-skills, ponytail'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace setup --integrations --dry-run', 'devworkspace setup --integrations --yes', 'devworkspace setup --integrations --only ponytail --yes --json'],\n  },\n  {\n    name: 'integrations',\n    summary: 'Show or repair the integration installation (observed, not assumed)',\n    usage: [\n      'devworkspace integrations status [--quick] [--restarted] [--strict]',\n      'devworkspace integrations repair [--yes] [--dry-run] [--only <ids>] [--scope project|user]',\n    ],\n    options: [\n      ['--quick', 'only look at files and PATH (fast, but nothing can show VERIFIED)'],\n      ['--restarted', 'record that you restarted Claude Code, clearing RESTART_REQUIRED'],\n      ['--strict', 'exit 3 unless every required integration is VERIFIED'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace integrations status', 'devworkspace integrations repair --yes'],\n  },\n  {\n    name: 'analyze',\n    summary: 'Deterministic repository discovery + generate the Claude onboarding prompt',\n    usage: ['devworkspace analyze [--dry-run]'],\n    options: [['--dry-run', 'discover and report without writing files'], ...COMMON],\n    examples: ['devworkspace analyze', 'devworkspace analyze --json'],\n  },\n  {\n    name: 'status',\n    summary: 'Concise overview: health, Git, knowledge, tasks, integrations, verification',\n    usage: ['devworkspace status [--strict] [--deep]   (read-only)'],\n    options: [['--strict', 'exit 3 when anything needs attention'], ['--deep', 'also run the integration health checks (what doctor does)'], ...COMMON],\n    examples: ['devworkspace status', 'devworkspace status --json'],\n  },\n  {\n    name: 'doctor',\n    summary: 'Check the workspace, integrations, security and portability',\n    usage: ['devworkspace doctor [--fix] [--strict]   (core workspace and integrations are reported separately)'],\n    options: [['--fix', 'safely create missing folders/ignore rules (never deletes)'], ['--strict', 'exit 3 when there are warnings'], ...COMMON],\n    examples: ['devworkspace doctor', 'devworkspace doctor --json --strict'],\n  },\n  {\n    name: 'refresh',\n    summary: 'Re-derive deterministic facts and mark knowledge stale when its evidence changed',\n    usage: ['devworkspace refresh [--dry-run]   (writes discovery files and detector facts; --dry-run writes nothing)'],\n    options: [['--dry-run', 'report stale knowledge without writing'], ...COMMON],\n    examples: ['devworkspace refresh'],\n  },\n  {\n    name: 'context',\n    summary: 'Show what DevWorkspace believes about the project',\n    usage: ['devworkspace context [--for <request>] [--topic <prefix>] [--full]'],\n    options: [['--for <request>', 'task-aware context: only what this request needs, each item with the reason it is included (safety rules are always shown)'], ['--topic <text>', 'only facts and testing-contract entries that match <text> (safety rules are always shown)'], ['--full', 'also print .devworkspace/context/*.md'], ...COMMON],\n    examples: ['devworkspace context --topic auth', 'devworkspace context --for \"fix the invoice total rounding bug\"'],\n  },\n  {\n    name: 'fact',\n    summary: 'Record, verify or remove a piece of project knowledge',\n    usage: [\n      'devworkspace fact add --key <key> --value <text> --source <desc> [--file <rel path>]... [--source-type ai|user|file|git] [--confidence HIGH|MEDIUM|LOW] [--status VERIFIED|INFERRED|UNKNOWN]',\n      'devworkspace fact verify <key>',\n      'devworkspace fact remove <key>',\n      'devworkspace fact list',\n    ],\n    options: [\n      ['--key', 'lowercase dotted key, e.g. auth.session-store'],\n      ['--value', 'one concise sentence (no secrets, no absolute paths)'],\n      ['--file <path>', 'repository file that evidences the fact (repeatable); used for staleness'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace fact add --key auth.sessions --value \"Sessions live in Redis\" --source \"src/auth/session.ts\" --file src/auth/session.ts --source-type ai --confidence HIGH --status VERIFIED'],\n  },\n  {\n    name: 'task',\n    summary: 'Track engineering tasks with a completion gate',\n    usage: [\n      'devworkspace task new \"<request>\" [--type BUG|FEATURE|...]',\n      'devworkspace task list [--all]          (alias: devworkspace tasks)',\n      'devworkspace task show <id>',\n      'devworkspace task status <id> <STATUS> [--note <text>]',\n      'devworkspace task update <id> [--title ..] [--criteria ..]... [--plan ..]... [--area ..]... [--blocker ..]... [--require <check>]... [--summary ..]',\n      'devworkspace task run <id> <check> [--package <dir>] [--timeout <seconds>]   (executes the contract command; read-only checks only)',\n      'devworkspace task verify <id> <check> pass|fail|skip|pending [--package <dir>] [--reason user-override] [--detail <text>]   (records a report, not an executed result)',\n      'devworkspace task tests <id> --phase baseline|after --passed <n> --failed <n>',\n      'devworkspace task attest <id> [--user-work-intact] [--knowledge-reviewed] [--final-state-inspected]',\n    ],\n    options: [\n      ['--all', 'include completed tasks'],\n      ['--package <dir>', 'with run/verify: the package the result belongs to (default: every changed package / the root)'],\n      ['--timeout <seconds>', 'with run: per-command time limit (default 600)'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace task run T-20260101-ab12 typecheck', 'devworkspace task new \"Fix the quotation email bug\"', 'devworkspace task status T-20260101-ab12 COMPLETED'],\n  },\n  {\n    name: 'testenv',\n    summary: 'Declare a test environment so database-touching checks may run (local, never committed)',\n    usage: [\n      'devworkspace testenv declare --package <dir> --check integration|security|e2e|unit [--check ...] --target \"<description>\" --yes',\n      'devworkspace testenv list',\n      'devworkspace testenv revoke --package <dir>',\n    ],\n    options: [\n      ['--package <dir>', 'package directory the declaration covers'],\n      ['--check <id>', 'check the declaration allows (repeatable)'],\n      ['--target <text>', 'words describing the environment, never a connection string'],\n      ['--yes', 'confirm that running those checks there is safe'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace testenv declare --package backend --check integration --target \"disposable docker compose stack\" --yes'],\n  },\n  {\n    name: 'decision',\n    summary: 'Record architectural/project decisions (append-only, human-readable)',\n    usage: [\n      'devworkspace decision add --title <t> --context <c> --decision <d> --consequences <q> [--supersedes <n>]',\n      'devworkspace decision list',\n      'devworkspace decision show <n>',\n    ],\n    options: COMMON,\n    examples: ['devworkspace decision list'],\n  },\n  {\n    name: 'session',\n    summary: 'Save or list short session summaries (never transcripts)',\n    usage: [\n      'devworkspace session save --goal <g> [--done <x>]... [--area <a>]... [--tests-run <t>]... [--decision-note <d>]... [--remaining <r>]... [--next <n>] [--task <id>]',\n      'devworkspace session list',\n    ],\n    options: COMMON,\n    examples: ['devworkspace session save --goal \"Fix login bug\" --done \"Added regression test\" --next \"Run e2e\"'],\n  },\n  {\n    name: 'agent',\n    summary: 'Manage coding agent integrations (claude, codex, cursor, copilot)',\n    usage: [\n      'devworkspace agent install [--agent claude|codex|cursor|copilot|all] [--dry-run]',\n      'devworkspace agent list',\n    ],\n    options: [\n      ['--agent <id>', 'agent adapter: claude, codex, cursor, copilot, or all (default: claude)'],\n      ['--dry-run', 'preview the files that would change'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace agent install --agent cursor', 'devworkspace agent install --agent all --dry-run', 'devworkspace agent list'],\n  },\n  {\n    name: 'export',\n    summary: 'Export portable project knowledge to a JSON bundle',\n    usage: ['devworkspace export [--out <file>] [--dry-run]'],\n    options: [['--out <file>', 'output path (default: devworkspace-export-<date>.json)'], ...COMMON],\n    examples: ['devworkspace export --out knowledge.json'],\n  },\n  {\n    name: 'import',\n    summary: 'Safely import an export bundle (validated; never silently overwrites)',\n    usage: ['devworkspace import <file> [--dry-run] [--overwrite] [--allow-different-project]'],\n    options: [['--overwrite', 'replace differing local files (backups are kept)'], ['--dry-run', 'show what would change'], ...COMMON],\n    examples: ['devworkspace import knowledge.json --dry-run'],\n  },\n  {\n    name: 'reset',\n    summary: 'Delete .devworkspace/ so you can start again with init (shows a plan unless --yes)',\n    usage: ['devworkspace reset [--include-agent-files] [--yes]'],\n    options: [\n      ['--yes', 'actually delete (without it, reset only shows what it would remove)'],\n      ['--include-agent-files', 'also remove managed DevWorkspace blocks and skills from agent instruction files'],\n      ['--dry-run', 'show the plan only'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace reset', 'devworkspace reset --yes', 'devworkspace reset --yes --include-agent-files && devworkspace init'],\n  },\n  {\n    name: 'migrate',\n    summary: 'Upgrade workspace files to the current schema (with backups)',\n    usage: ['devworkspace migrate [--dry-run]'],\n    options: [['--dry-run', 'list what would be migrated'], ...COMMON],\n    examples: ['devworkspace migrate'],\n  },\n];\n\nexport function topHelp(version: string): string {\n  const w = Math.max(...COMMANDS.map((c) => c.name.length));\n  return [\n    `devworkspace ${version} - project-local AI engineering workspace`,\n    '',\n    'Usage: devworkspace <command> [options]',\n    '',\n    'Commands:',\n    ...COMMANDS.map((c) => `  ${c.name.padEnd(w + 2)}${c.summary}`),\n    '',\n    'Quick start:',\n    '  cd my-project',\n    '  npx devworkspace init',\n    '  npx devworkspace analyze',\n    '  # paste .devworkspace/analysis/onboarding-prompt.md into Claude Code',\n    '',\n    'Global options: --json  --cwd <dir>  --debug  --no-color  --ascii  --help  --version',\n    '(DevWorkspace never prompts interactively; destructive commands such as reset require --yes.)',\n    'Exit codes: 0 ok · 1 failure · 2 usage error or approval needed · 3 warnings (--strict) or setup finished but not fully verified · 130 interrupted',\n    'Run \"devworkspace <command> --help\" for details.',\n  ].join('\\n');\n}\n\nexport function commandHelp(c: CommandHelp): string {\n  const w = Math.max(...c.options.map(([o]) => o.length));\n  return [\n    `devworkspace ${c.name} - ${c.summary}`,\n    '',\n    'Usage:',\n    ...c.usage.map((u) => `  ${u}`),\n    '',\n    'Options:',\n    ...c.options.map(([o, d]) => `  ${o.padEnd(w + 2)}${d}`),\n    '',\n    'Examples:',\n    ...c.examples.map((e) => `  ${e}`),\n  ].join('\\n');\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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","sourcesContent":["export interface CommandHelp {\n  name: string;\n  summary: string;\n  usage: string[];\n  options: [string, string][];\n  examples: string[];\n}\n\nconst COMMON: [string, string][] = [\n  ['--json', 'machine-readable output'],\n  ['--cwd <dir>', 'run as if started in <dir>'],\n  ['--debug', 'show stack traces and debug logs'],\n];\n\nexport const COMMANDS: CommandHelp[] = [\n  {\n    name: 'init',\n    summary: 'Create .devworkspace/ in the current project (safe to re-run)',\n    usage: ['devworkspace init [--root <dir>] [--dry-run] [--with-integrations [--yes] [--scope project|user]]'],\n    options: [\n      ['--root <dir>', 'project root (default: Git top-level or current directory)'],\n      ['--dry-run', 'show what would be created'],\n      ['--with-integrations', 'then run the same integration setup as \"devworkspace setup --integrations\"'],\n      ['--yes', 'with --with-integrations: approve machine-level and third-party installs'],\n      ...COMMON,\n    ],\n    examples: ['npx devworkspace init', 'npx devworkspace init --with-integrations --yes'],\n  },\n  {\n    name: 'setup',\n    summary: 'Single-command repository setup (inspect, initialize, discover contract & validate)',\n    usage: [\n      'devworkspace setup',\n      'devworkspace setup --integrations [--yes] [--dry-run] [--scope project|user] [--only graphify,agent-skills,ponytail]',\n    ],\n    options: [\n      ['--integrations', 'set up external integrations (Graphify, Agent Skills, Ponytail)'],\n      ['--dry-run', 'show exactly what would run; changes nothing'],\n      ['--yes', 'with --integrations: approve machine-level and third-party installs'],\n      ['--scope project|user', 'where to install (default: project; user needs --yes)'],\n      ['--only <ids>', 'comma-separated: graphify, agent-skills, ponytail'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace setup', 'devworkspace setup --json', 'devworkspace setup --integrations --yes'],\n  },\n  {\n    name: 'integrations',\n    summary: 'Show or repair the integration installation (observed, not assumed)',\n    usage: [\n      'devworkspace integrations status [--quick] [--restarted] [--strict]',\n      'devworkspace integrations repair [--yes] [--dry-run] [--only <ids>] [--scope project|user]',\n    ],\n    options: [\n      ['--quick', 'only look at files and PATH (fast, but nothing can show VERIFIED)'],\n      ['--restarted', 'record that you restarted Claude Code, clearing RESTART_REQUIRED'],\n      ['--strict', 'exit 3 unless every required integration is VERIFIED'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace integrations status', 'devworkspace integrations repair --yes'],\n  },\n  {\n    name: 'analyze',\n    summary: 'Deterministic repository discovery + generate the Claude onboarding prompt',\n    usage: ['devworkspace analyze [--dry-run]'],\n    options: [['--dry-run', 'discover and report without writing files'], ...COMMON],\n    examples: ['devworkspace analyze', 'devworkspace analyze --json'],\n  },\n  {\n    name: 'status',\n    summary: 'Concise overview: health, Git, knowledge, tasks, integrations, verification',\n    usage: ['devworkspace status [--strict] [--deep]   (read-only)'],\n    options: [['--strict', 'exit 3 when anything needs attention'], ['--deep', 'also run the integration health checks (what doctor does)'], ...COMMON],\n    examples: ['devworkspace status', 'devworkspace status --json'],\n  },\n  {\n    name: 'doctor',\n    summary: 'Check the workspace, integrations, security and portability',\n    usage: ['devworkspace doctor [--fix] [--strict]   (core workspace and integrations are reported separately)'],\n    options: [['--fix', 'safely create missing folders/ignore rules (never deletes)'], ['--strict', 'exit 3 when there are warnings'], ...COMMON],\n    examples: ['devworkspace doctor', 'devworkspace doctor --json --strict'],\n  },\n  {\n    name: 'refresh',\n    summary: 'Re-derive deterministic facts and mark knowledge stale when its evidence changed',\n    usage: ['devworkspace refresh [--dry-run]   (writes discovery files and detector facts; --dry-run writes nothing)'],\n    options: [['--dry-run', 'report stale knowledge without writing'], ...COMMON],\n    examples: ['devworkspace refresh'],\n  },\n  {\n    name: 'context',\n    summary: 'Show what DevWorkspace believes about the project',\n    usage: ['devworkspace context [--for <request>] [--topic <prefix>] [--full]'],\n    options: [['--for <request>', 'task-aware context: only what this request needs, each item with the reason it is included (safety rules are always shown)'], ['--topic <text>', 'only facts and testing-contract entries that match <text> (safety rules are always shown)'], ['--full', 'also print .devworkspace/context/*.md'], ...COMMON],\n    examples: ['devworkspace context --topic auth', 'devworkspace context --for \"fix the invoice total rounding bug\"'],\n  },\n  {\n    name: 'fact',\n    summary: 'Record, verify or remove a piece of project knowledge',\n    usage: [\n      'devworkspace fact add --key <key> --value <text> --source <desc> [--file <rel path>]... [--source-type ai|user|file|git] [--confidence HIGH|MEDIUM|LOW] [--status VERIFIED|INFERRED|UNKNOWN]',\n      'devworkspace fact verify <key>',\n      'devworkspace fact remove <key>',\n      'devworkspace fact list',\n    ],\n    options: [\n      ['--key', 'lowercase dotted key, e.g. auth.session-store'],\n      ['--value', 'one concise sentence (no secrets, no absolute paths)'],\n      ['--file <path>', 'repository file that evidences the fact (repeatable); used for staleness'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace fact add --key auth.sessions --value \"Sessions live in Redis\" --source \"src/auth/session.ts\" --file src/auth/session.ts --source-type ai --confidence HIGH --status VERIFIED'],\n  },\n  {\n    name: 'feature',\n    summary: 'Manage feature-level knowledge and end-to-end component traces',\n    usage: [\n      'devworkspace feature list',\n      'devworkspace feature show <id>',\n      'devworkspace feature validate',\n      'devworkspace feature add --id <id> --name <name> [--entry <path>...] [--route <path>...] [--service <path>...] [--model <path>...] [--test <path>...] [--symbol <sym>]',\n    ],\n    options: [\n      ['--id <id>', 'unique feature identifier, e.g. auth.login'],\n      ['--name <name>', 'human-readable name for the feature'],\n      ['--entry <path>', 'frontend entry point path (repeatable)'],\n      ['--route <path>', 'backend route/controller path (repeatable)'],\n      ['--service <path>', 'backend service path (repeatable)'],\n      ['--model <path>', 'database model/schema path (repeatable)'],\n      ['--test <path>', 'test file path (repeatable)'],\n      ['--symbol <sym>', 'symbol name (function, class, endpoint) to verify in component files'],\n      ...COMMON,\n    ],\n    examples: [\n      'devworkspace feature list',\n      'devworkspace feature show auth.login',\n      'devworkspace feature validate',\n      'devworkspace feature add --id auth.login --name \"User Authentication\" --entry frontend/src/pages/Login.tsx --route backend/src/routes/auth.ts --symbol authRoutes',\n    ],\n  },\n  {\n    name: 'graph',\n    summary: 'Inspect and trace Graphify knowledge graphs',\n    usage: [\n      'devworkspace graph status',\n      'devworkspace graph trace [--from <path|query>] [--depth <n>]',\n    ],\n    options: [\n      ['--from <path|query>', 'starting node file path or symbol name to trace from'],\n      ['--depth <n>', 'maximum traversal depth (1-10, default 2)'],\n      ...COMMON,\n    ],\n    examples: [\n      'devworkspace graph status',\n      'devworkspace graph trace --from src/api.ts --depth 3',\n    ],\n  },\n  {\n    name: 'task',\n    summary: 'Track engineering tasks with a completion gate',\n    usage: [\n      'devworkspace task new \"<request>\" [--type BUG|FEATURE|...]',\n      'devworkspace task list [--all]          (alias: devworkspace tasks)',\n      'devworkspace task show <id>',\n      'devworkspace task status <id> <STATUS> [--note <text>]',\n      'devworkspace task update <id> [--title ..] [--criteria ..]... [--plan ..]... [--area ..]... [--blocker ..]... [--require <check>]... [--summary ..]',\n      'devworkspace task run <id> <check> [--package <dir>] [--timeout <seconds>]   (executes the contract command; read-only checks only)',\n      'devworkspace task verify <id> <check> pass|fail|skip|pending [--package <dir>] [--reason user-override] [--detail <text>]   (records a report, not an executed result)',\n      'devworkspace task tests <id> --phase baseline|after --passed <n> --failed <n>',\n      'devworkspace task attest <id> [--user-work-intact] [--knowledge-reviewed] [--final-state-inspected]',\n    ],\n    options: [\n      ['--all', 'include completed tasks'],\n      ['--package <dir>', 'with run/verify: the package the result belongs to (default: every changed package / the root)'],\n      ['--timeout <seconds>', 'with run: per-command time limit (default 600)'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace task run T-20260101-ab12 typecheck', 'devworkspace task new \"Fix the quotation email bug\"', 'devworkspace task status T-20260101-ab12 COMPLETED'],\n  },\n  {\n    name: 'testenv',\n    summary: 'Declare a test environment so database-touching checks may run (local, never committed)',\n    usage: [\n      'devworkspace testenv declare --package <dir> --check integration|security|e2e|unit [--check ...] --target \"<description>\" --yes',\n      'devworkspace testenv list',\n      'devworkspace testenv revoke --package <dir>',\n    ],\n    options: [\n      ['--package <dir>', 'package directory the declaration covers'],\n      ['--check <id>', 'check the declaration allows (repeatable)'],\n      ['--target <text>', 'words describing the environment, never a connection string'],\n      ['--yes', 'confirm that running those checks there is safe'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace testenv declare --package backend --check integration --target \"disposable docker compose stack\" --yes'],\n  },\n  {\n    name: 'decision',\n    summary: 'Record architectural/project decisions (append-only, human-readable)',\n    usage: [\n      'devworkspace decision add --title <t> --context <c> --decision <d> --consequences <q> [--supersedes <n>]',\n      'devworkspace decision list',\n      'devworkspace decision show <n>',\n    ],\n    options: COMMON,\n    examples: ['devworkspace decision list'],\n  },\n  {\n    name: 'session',\n    summary: 'Save or list short session summaries (never transcripts)',\n    usage: [\n      'devworkspace session save --goal <g> [--done <x>]... [--area <a>]... [--tests-run <t>]... [--decision-note <d>]... [--remaining <r>]... [--next <n>] [--task <id>]',\n      'devworkspace session list',\n    ],\n    options: COMMON,\n    examples: ['devworkspace session save --goal \"Fix login bug\" --done \"Added regression test\" --next \"Run e2e\"'],\n  },\n  {\n    name: 'agent',\n    summary: 'Manage coding agent integrations (claude, codex, cursor, copilot)',\n    usage: [\n      'devworkspace agent install [--agent claude|codex|cursor|copilot|all] [--dry-run]',\n      'devworkspace agent list',\n    ],\n    options: [\n      ['--agent <id>', 'agent adapter: claude, codex, cursor, copilot, or all (default: claude)'],\n      ['--dry-run', 'preview the files that would change'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace agent install --agent cursor', 'devworkspace agent install --agent all --dry-run', 'devworkspace agent list'],\n  },\n  {\n    name: 'export',\n    summary: 'Export portable project knowledge to a JSON bundle',\n    usage: ['devworkspace export [--out <file>] [--dry-run]'],\n    options: [['--out <file>', 'output path (default: devworkspace-export-<date>.json)'], ...COMMON],\n    examples: ['devworkspace export --out knowledge.json'],\n  },\n  {\n    name: 'import',\n    summary: 'Safely import an export bundle (validated; never silently overwrites)',\n    usage: ['devworkspace import <file> [--dry-run] [--overwrite] [--allow-different-project]'],\n    options: [['--overwrite', 'replace differing local files (backups are kept)'], ['--dry-run', 'show what would change'], ...COMMON],\n    examples: ['devworkspace import knowledge.json --dry-run'],\n  },\n  {\n    name: 'reset',\n    summary: 'Delete .devworkspace/ so you can start again with init (shows a plan unless --yes)',\n    usage: ['devworkspace reset [--include-agent-files] [--yes]'],\n    options: [\n      ['--yes', 'actually delete (without it, reset only shows what it would remove)'],\n      ['--include-agent-files', 'also remove managed DevWorkspace blocks and skills from agent instruction files'],\n      ['--dry-run', 'show the plan only'],\n      ...COMMON,\n    ],\n    examples: ['devworkspace reset', 'devworkspace reset --yes', 'devworkspace reset --yes --include-agent-files && devworkspace init'],\n  },\n  {\n    name: 'migrate',\n    summary: 'Upgrade workspace files to the current schema (with backups)',\n    usage: ['devworkspace migrate [--dry-run]'],\n    options: [['--dry-run', 'list what would be migrated'], ...COMMON],\n    examples: ['devworkspace migrate'],\n  },\n];\n\nexport function topHelp(version: string): string {\n  const w = Math.max(...COMMANDS.map((c) => c.name.length));\n  return [\n    `devworkspace ${version} - project-local AI engineering workspace`,\n    '',\n    'Usage: devworkspace <command> [options]',\n    '',\n    'Commands:',\n    ...COMMANDS.map((c) => `  ${c.name.padEnd(w + 2)}${c.summary}`),\n    '',\n    'Quick start:',\n    '  cd my-project',\n    '  npx devworkspace init',\n    '  npx devworkspace analyze',\n    '  # paste .devworkspace/analysis/onboarding-prompt.md into Claude Code',\n    '',\n    'Global options: --json  --cwd <dir>  --debug  --no-color  --ascii  --help  --version',\n    '(DevWorkspace never prompts interactively; destructive commands such as reset require --yes.)',\n    'Exit codes: 0 ok · 1 failure · 2 usage error or approval needed · 3 warnings (--strict) or setup finished but not fully verified · 130 interrupted',\n    'Run \"devworkspace <command> --help\" for details.',\n  ].join('\\n');\n}\n\nexport function commandHelp(c: CommandHelp): string {\n  const w = Math.max(...c.options.map(([o]) => o.length));\n  return [\n    `devworkspace ${c.name} - ${c.summary}`,\n    '',\n    'Usage:',\n    ...c.usage.map((u) => `  ${u}`),\n    '',\n    'Options:',\n    ...c.options.map(([o, d]) => `  ${o.padEnd(w + 2)}${d}`),\n    '',\n    'Examples:',\n    ...c.examples.map((e) => `  ${e}`),\n  ].join('\\n');\n}\n"]}

package/dist/cli/render.d.ts

@@ -14,6 +14,10 @@ import type { ResetResult } from '../services/reset.js';
 import type { IntegrationReport } from '../integrations/types.js';
 import type { SetupResult } from '../integrations/manager.js';
 import type { IntegrationsStatus } from '../services/integrations.js';
+import type { FeatureItem, FeatureValidationReport } from '../features/types.js';
+import type { FeatureSummary } from '../services/features.js';
+import type { ProjectSetupResult } from '../services/setup.js';
+import type { GraphStatusResult, GraphTraceResult } from '../services/graph.js';
 export interface Style {
     ok(s: string): string;
     warn(s: string): string;
@@ -55,3 +59,9 @@ export declare function renderReset(s: Style, r: ResetResult): string;
 export declare function renderMigrate(s: Style, r: MigrateResult): string;
 export declare function renderSetup(s: Style, r: SetupResult): string;
 export declare function renderIntegrationsStatus(s: Style, r: IntegrationsStatus): string;
+export declare function renderFeature(s: Style, f: FeatureItem): string;
+export declare function renderFeatureList(s: Style, features: FeatureSummary[]): string;
+export declare function renderFeatureValidation(s: Style, rep: FeatureValidationReport): string;
+export declare function renderProjectSetup(s: Style, r: ProjectSetupResult): string;
+export declare function renderGraphStatus(s: Style, res: GraphStatusResult): string;
+export declare function renderGraphTrace(s: Style, trace: GraphTraceResult): string;

package/dist/cli/render.js

@@ -403,4 +403,171 @@ export function renderIntegrationsStatus(s, r) {
     L.push('', r.summary.complete ? `${s.ok(s.sym.ok)} All required integrations are verified.` : `${s.warn(s.sym.warn)} ${r.summary.verified} of ${r.summary.required} required integrations verified.`);
     return L.join('\n');
 }
+export function renderFeature(s, f) {
+    const L = [];
+    const statusColor = f.status === 'verified' ? s.ok(`[${f.status}]`) : f.status === 'inferred' ? s.warn(`[${f.status}]`) : s.dim(`[${f.status}]`);
+    L.push(`${s.bold(f.name)} (${f.id}) ${statusColor}`);
+    if (f.description)
+        L.push(`  ${f.description}`);
+    if (f.tags?.length)
+        L.push(`  Tags: ${f.tags.join(', ')}`);
+    L.push(`  Updated: ${f.updatedAt}`);
+    const renderGroup = (label, group) => {
+        if (!group)
+            return;
+        const entries = Object.entries(group).filter(([, comps]) => Array.isArray(comps) && comps.length > 0);
+        if (entries.length === 0)
+            return;
+        L.push('', `  ${s.bold(label)}:`);
+        for (const [type, comps] of entries) {
+            for (const c of comps) {
+                const mark = c.status === 'verified' ? s.ok(s.sym.ok) : c.status === 'inferred' ? s.warn('?') : s.fail(s.sym.fail);
+                const sym = c.symbol ? `:${c.symbol}` : '';
+                const det = c.detail ? ` (${c.detail})` : '';
+                L.push(`    ${mark} [${type}] ${c.path}${sym}${det}`);
+            }
+        }
+    };
+    renderGroup('Frontend', f.frontend);
+    renderGroup('Backend', f.backend);
+    renderGroup('Database & Migrations', f.database);
+    renderGroup('Tests', f.tests);
+    return L.join('\n');
+}
+export function renderFeatureList(s, features) {
+    if (features.length === 0) {
+        return 'No features mapped yet. Use "devworkspace feature add" or edit .devworkspace/context/features.json.';
+    }
+    const L = ['Mapped features:'];
+    for (const f of features) {
+        const mark = f.status === 'verified' ? s.ok(s.sym.ok) : f.status === 'inferred' ? s.warn('?') : s.fail(s.sym.fail);
+        L.push(`  ${mark} ${f.id.padEnd(20)} ${f.status.padEnd(10)} ${f.name} (${f.componentsCount} components, ${f.testsCount} tests)`);
+    }
+    return L.join('\n');
+}
+export function renderFeatureValidation(s, rep) {
+    const L = [];
+    L.push(`Feature map validation: ${rep.total} total feature(s)`);
+    L.push(`  ${s.ok(s.sym.ok)} Verified: ${rep.verified}`);
+    L.push(`  ${s.warn('?')} Inferred: ${rep.inferred}`);
+    L.push(`  ${s.fail(s.sym.fail)} Unknown / broken: ${rep.unknown}`);
+    for (const f of rep.features) {
+        if (!f.valid) {
+            L.push('', `  ${s.warn(s.sym.warn)} [${f.featureId}] ${f.name}:`);
+            for (const iss of f.issues) {
+                L.push(`      - ${iss}`);
+            }
+        }
+    }
+    return L.join('\n');
+}
+export function renderProjectSetup(s, r) {
+    const L = [];
+    L.push(s.bold(`DevWorkspace Setup: ${r.projectName}`));
+    L.push(`  Repository root: ${r.root}`);
+    L.push(`  Platform: ${r.os} | Node.js: ${r.nodeVersion}`);
+    const cliNote = r.cli.mode === 'source-checkout' ? ' (local source checkout)' : r.cli.mode === 'npx-cache' ? ' (npx cache)' : '';
+    L.push(`  DevWorkspace CLI: v${r.cli.version}${cliNote} [${r.cli.path}]`);
+    L.push('');
+    L.push(s.bold('Workspace & Discovery:'));
+    L.push(`  ${s.ok(s.sym.ok)} Workspace initialized: ${r.isFirstRun ? 'Created fresh .devworkspace/' : 'Existing workspace preserved'}`);
+    if (r.packages.length > 0) {
+        L.push(`  ${s.ok(s.sym.ok)} Packages detected: ${r.packages.map((p) => `${p.path} (${p.ecosystem}${p.packageManager ? `, ${p.packageManager}` : ''})`).join(', ')}`);
+    }
+    if (r.frameworks.length > 0) {
+        L.push(`  ${s.ok(s.sym.ok)} Frameworks: ${r.frameworks.join(', ')}`);
+    }
+    L.push('');
+    L.push(s.bold('Verification Contract:'));
+    L.push(`  ${s.ok(s.sym.ok)} ${r.verification.available} verification command(s) available: ${r.verification.checks.join(', ') || 'none'}`);
+    if (r.verification.drift.length > 0) {
+        L.push(`  ${s.warn(s.sym.warn)} Contract drift detected: ${r.verification.drift.length} issue(s) need attention`);
+        for (const d of r.verification.drift.slice(0, 3)) {
+            L.push(`      - ${d.id}${d.cwd ? ` [${d.cwd}]` : ''}: ${d.message}`);
+        }
+    }
+    else {
+        L.push(`  ${s.ok(s.sym.ok)} Configured commands match repository manifests and working directories`);
+    }
+    L.push('');
+    if (r.features) {
+        L.push(s.bold('Feature-Level Knowledge:'));
+        L.push(`  ${s.ok(s.sym.ok)} ${r.features.total} feature(s) mapped: ${r.features.verified} verified, ${r.features.unknown} unknown/broken`);
+        L.push('');
+    }
+    L.push(s.bold('Integrations:'));
+    for (const i of r.integrations) {
+        const mark = i.status === 'VERIFIED' ? s.ok(s.sym.ok) : i.status === 'NOT_INSTALLED' ? s.dim('-') : s.warn(s.sym.warn);
+        L.push(`  ${mark} ${i.name.padEnd(16)} ${i.status} ${i.required ? '(recommended)' : '(optional)'}`);
+    }
+    L.push('');
+    L.push(s.bold('Readiness & Health:'));
+    const healthMark = r.doctor.healthy ? s.ok(s.sym.ok) : s.warn(s.sym.warn);
+    L.push(`  ${healthMark} Doctor checks: ${r.doctor.passed} passed, ${r.doctor.warnings} warning(s), ${r.doctor.failures} failure(s)`);
+    L.push('');
+    L.push(s.bold('Next Steps:'));
+    for (const step of r.nextSteps) {
+        L.push(`  ${s.sym.arrow} ${step}`);
+    }
+    return L.join('\n');
+}
+export function renderGraphStatus(s, res) {
+    const L = [];
+    L.push(s.bold('Graphify Knowledge Graph:'));
+    if (!res.available) {
+        L.push(`  ${s.warn(s.sym.warn)} ${res.message}`);
+        if (res.hint)
+            L.push(`  ${s.sym.arrow} Hint: ${res.hint}`);
+        return L.join('\n');
+    }
+    L.push(`  ${s.ok(s.sym.ok)} Location: ${res.graphPath}`);
+    L.push(`  ${s.ok(s.sym.ok)} Nodes: ${res.nodesCount} | Edges: ${res.edgesCount}`);
+    if (Object.keys(res.nodeTypes).length > 0) {
+        L.push('');
+        L.push(s.bold('Node Types:'));
+        for (const [t, count] of Object.entries(res.nodeTypes)) {
+            L.push(`  - ${t.padEnd(14)}: ${count}`);
+        }
+    }
+    return L.join('\n');
+}
+export function renderGraphTrace(s, trace) {
+    const L = [];
+    L.push(s.bold(`Graph Trace: "${trace.query}" (depth: ${trace.depth})`));
+    if (!trace.available) {
+        L.push(`  ${s.warn(s.sym.warn)} Graph not available. ${trace.warnings.join(' ')}`);
+        return L.join('\n');
+    }
+    if (!trace.matchedNode) {
+        L.push(`  ${s.warn(s.sym.warn)} No start node matched "${trace.query}".`);
+        for (const w of trace.warnings)
+            L.push(`  ${s.dim(w)}`);
+        return L.join('\n');
+    }
+    L.push(`  Start node: ${s.bold(trace.matchedNode.id)} [${trace.matchedNode.status}]`);
+    L.push(`  Traversed: ${trace.totalNodes} node(s) (${s.ok(`${trace.verifiedNodes} verified`)}, ${trace.hypothesisNodes > 0 ? s.warn(`${trace.hypothesisNodes} hypothesis`) : '0 hypothesis'})`);
+    L.push('');
+    L.push(s.bold('Traversed Nodes:'));
+    for (const n of trace.nodes) {
+        const indent = '  '.repeat(n.depth + 1);
+        const tag = n.status === 'verified' ? s.ok('[verified]') : s.warn('[hypothesis]');
+        const pathInfo = n.path ? s.dim(`(${n.path}${n.symbol ? `::${n.symbol}` : ''})`) : s.dim('(no file)');
+        const reason = n.reason ? ` - ${s.dim(n.reason)}` : '';
+        L.push(`${indent}${tag} ${n.id} ${pathInfo}${reason}`);
+    }
+    if (trace.edges.length > 0) {
+        L.push('');
+        L.push(s.bold('Relationships:'));
+        for (const e of trace.edges) {
+            const tag = e.status === 'verified' ? s.ok('[verified]') : s.warn('[hypothesis]');
+            L.push(`  ${tag} ${e.source} --(${e.relation})--> ${e.target}`);
+        }
+    }
+    if (trace.warnings.length > 0) {
+        L.push('');
+        for (const w of trace.warnings)
+            L.push(`  ${s.warn(s.sym.warn)} ${w}`);
+    }
+    return L.join('\n');
+}
 //# sourceMappingURL=render.js.map