devworkspace 0.0.0-stage → 0.1.0

package/dist/cli/args.d.ts

@@ -0,0 +1,194 @@
+/** Every flag the CLI understands. Unknown flags are rejected so typos never silently do nothing. */
+export declare const OPTIONS: {
+    readonly help: {
+        readonly type: "boolean";
+        readonly short: "h";
+    };
+    readonly version: {
+        readonly type: "boolean";
+        readonly short: "v";
+    };
+    readonly json: {
+        readonly type: "boolean";
+    };
+    readonly debug: {
+        readonly type: "boolean";
+    };
+    readonly 'no-color': {
+        readonly type: "boolean";
+    };
+    readonly ascii: {
+        readonly type: "boolean";
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+    };
+    readonly yes: {
+        readonly type: "boolean";
+        readonly short: "y";
+    };
+    readonly cwd: {
+        readonly type: "string";
+    };
+    readonly root: {
+        readonly type: "string";
+    };
+    readonly fix: {
+        readonly type: "boolean";
+    };
+    readonly strict: {
+        readonly type: "boolean";
+    };
+    readonly out: {
+        readonly type: "string";
+        readonly short: "o";
+    };
+    readonly overwrite: {
+        readonly type: "boolean";
+    };
+    readonly 'allow-different-project': {
+        readonly type: "boolean";
+    };
+    readonly topic: {
+        readonly type: "string";
+    };
+    readonly full: {
+        readonly type: "boolean";
+    };
+    readonly all: {
+        readonly type: "boolean";
+    };
+    readonly agent: {
+        readonly type: "string";
+    };
+    readonly type: {
+        readonly type: "string";
+    };
+    readonly title: {
+        readonly type: "string";
+    };
+    readonly key: {
+        readonly type: "string";
+    };
+    readonly value: {
+        readonly type: "string";
+    };
+    readonly source: {
+        readonly type: "string";
+    };
+    readonly 'source-type': {
+        readonly type: "string";
+    };
+    readonly file: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly confidence: {
+        readonly type: "string";
+    };
+    readonly status: {
+        readonly type: "string";
+    };
+    readonly reason: {
+        readonly type: "string";
+    };
+    readonly detail: {
+        readonly type: "string";
+    };
+    readonly note: {
+        readonly type: "string";
+    };
+    readonly phase: {
+        readonly type: "string";
+    };
+    readonly passed: {
+        readonly type: "string";
+    };
+    readonly failed: {
+        readonly type: "string";
+    };
+    readonly criteria: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly plan: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly area: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly 'decision-note': {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly summary: {
+        readonly type: "string";
+    };
+    readonly blocker: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly 'clear-blockers': {
+        readonly type: "boolean";
+    };
+    readonly require: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly 'user-work-intact': {
+        readonly type: "boolean";
+    };
+    readonly 'knowledge-reviewed': {
+        readonly type: "boolean";
+    };
+    readonly 'final-state-inspected': {
+        readonly type: "boolean";
+    };
+    readonly context: {
+        readonly type: "string";
+    };
+    readonly decision: {
+        readonly type: "string";
+    };
+    readonly consequences: {
+        readonly type: "string";
+    };
+    readonly supersedes: {
+        readonly type: "string";
+    };
+    readonly goal: {
+        readonly type: "string";
+    };
+    readonly done: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly 'tests-run': {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly remaining: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly next: {
+        readonly type: "string";
+    };
+    readonly task: {
+        readonly type: "string";
+    };
+    readonly limit: {
+        readonly type: "string";
+    };
+};
+export interface ParsedArgs {
+    positionals: string[];
+    values: Record<string, string | boolean | string[] | undefined>;
+}
+export declare function parseCli(argv: string[]): ParsedArgs;
+export declare function str(v: ParsedArgs['values'], k: string): string | undefined;
+export declare function bool(v: ParsedArgs['values'], k: string): boolean;
+export declare function list(v: ParsedArgs['values'], k: string): string[];
+export declare function int(v: ParsedArgs['values'], k: string): number | undefined;

package/dist/cli/args.js

@@ -0,0 +1,93 @@
+import { parseArgs } from 'node:util';
+import { DevWorkspaceError } from '../errors/index.js';
+/** Every flag the CLI understands. Unknown flags are rejected so typos never silently do nothing. */
+export const OPTIONS = {
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    json: { type: 'boolean' },
+    debug: { type: 'boolean' },
+    'no-color': { type: 'boolean' },
+    ascii: { type: 'boolean' },
+    'dry-run': { type: 'boolean' },
+    yes: { type: 'boolean', short: 'y' },
+    cwd: { type: 'string' },
+    root: { type: 'string' },
+    fix: { type: 'boolean' },
+    strict: { type: 'boolean' },
+    out: { type: 'string', short: 'o' },
+    overwrite: { type: 'boolean' },
+    'allow-different-project': { type: 'boolean' },
+    topic: { type: 'string' },
+    full: { type: 'boolean' },
+    all: { type: 'boolean' },
+    agent: { type: 'string' },
+    type: { type: 'string' },
+    title: { type: 'string' },
+    key: { type: 'string' },
+    value: { type: 'string' },
+    source: { type: 'string' },
+    'source-type': { type: 'string' },
+    file: { type: 'string', multiple: true },
+    confidence: { type: 'string' },
+    status: { type: 'string' },
+    reason: { type: 'string' },
+    detail: { type: 'string' },
+    note: { type: 'string' },
+    phase: { type: 'string' },
+    passed: { type: 'string' },
+    failed: { type: 'string' },
+    criteria: { type: 'string', multiple: true },
+    plan: { type: 'string', multiple: true },
+    area: { type: 'string', multiple: true },
+    'decision-note': { type: 'string', multiple: true },
+    summary: { type: 'string' },
+    blocker: { type: 'string', multiple: true },
+    'clear-blockers': { type: 'boolean' },
+    require: { type: 'string', multiple: true },
+    'user-work-intact': { type: 'boolean' },
+    'knowledge-reviewed': { type: 'boolean' },
+    'final-state-inspected': { type: 'boolean' },
+    context: { type: 'string' },
+    decision: { type: 'string' },
+    consequences: { type: 'string' },
+    supersedes: { type: 'string' },
+    goal: { type: 'string' },
+    done: { type: 'string', multiple: true },
+    'tests-run': { type: 'string', multiple: true },
+    remaining: { type: 'string', multiple: true },
+    next: { type: 'string' },
+    task: { type: 'string' },
+    limit: { type: 'string' },
+};
+export function parseCli(argv) {
+    try {
+        const { values, positionals } = parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: true });
+        return { positionals, values: values };
+    }
+    catch (e) {
+        throw new DevWorkspaceError('USAGE', e.message.replace(/^Unknown option/, 'Unknown option'), {
+            hint: 'Run "devworkspace --help" or "devworkspace <command> --help".',
+        });
+    }
+}
+export function str(v, k) {
+    const x = v[k];
+    return typeof x === 'string' ? x : undefined;
+}
+export function bool(v, k) {
+    return v[k] === true;
+}
+export function list(v, k) {
+    const x = v[k];
+    return Array.isArray(x) ? x : [];
+}
+export function int(v, k) {
+    const s = str(v, k);
+    if (s === undefined)
+        return undefined;
+    const n = Number(s);
+    if (!Number.isInteger(n))
+        throw new DevWorkspaceError('USAGE', `--${k} must be an integer (got "${s}").`);
+    return n;
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +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  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  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} 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.d.ts

@@ -0,0 +1,10 @@
+export interface CommandHelp {
+    name: string;
+    summary: string;
+    usage: string[];
+    options: [string, string][];
+    examples: string[];
+}
+export declare const COMMANDS: CommandHelp[];
+export declare function topHelp(version: string): string;
+export declare function commandHelp(c: CommandHelp): string;

package/dist/cli/help.js

@@ -0,0 +1,169 @@
+const COMMON = [
+    ['--json', 'machine-readable output'],
+    ['--cwd <dir>', 'run as if started in <dir>'],
+    ['--debug', 'show stack traces and debug logs'],
+];
+export const COMMANDS = [
+    {
+        name: 'init',
+        summary: 'Create .devworkspace/ in the current project (safe to re-run)',
+        usage: ['devworkspace init [--root <dir>] [--dry-run]'],
+        options: [['--root <dir>', 'project root (default: Git top-level or current directory)'], ['--dry-run', 'show what would be created'], ...COMMON],
+        examples: ['npx devworkspace init'],
+    },
+    {
+        name: 'analyze',
+        summary: 'Deterministic repository discovery + generate the Claude onboarding prompt',
+        usage: ['devworkspace analyze [--dry-run]'],
+        options: [['--dry-run', 'discover and report without writing files'], ...COMMON],
+        examples: ['devworkspace analyze', 'devworkspace analyze --json'],
+    },
+    {
+        name: 'status',
+        summary: 'Concise overview: health, Git, knowledge, tasks, integrations, verification',
+        usage: ['devworkspace status [--strict]'],
+        options: [['--strict', 'exit 3 when anything needs attention'], ...COMMON],
+        examples: ['devworkspace status', 'devworkspace status --json'],
+    },
+    {
+        name: 'doctor',
+        summary: 'Check the workspace, integrations, security and portability',
+        usage: ['devworkspace doctor [--fix] [--strict]'],
+        options: [['--fix', 'safely create missing folders/ignore rules (never deletes)'], ['--strict', 'exit 3 when there are warnings'], ...COMMON],
+        examples: ['devworkspace doctor', 'devworkspace doctor --json --strict'],
+    },
+    {
+        name: 'refresh',
+        summary: 'Re-derive deterministic facts and mark knowledge stale when its evidence changed',
+        usage: ['devworkspace refresh [--dry-run]'],
+        options: [['--dry-run', 'report stale knowledge without writing'], ...COMMON],
+        examples: ['devworkspace refresh'],
+    },
+    {
+        name: 'context',
+        summary: 'Show what DevWorkspace believes about the project',
+        usage: ['devworkspace context [--topic <prefix>] [--full]'],
+        options: [['--topic <text>', 'only facts whose key contains <text>'], ['--full', 'also print .devworkspace/context/*.md'], ...COMMON],
+        examples: ['devworkspace context --topic auth'],
+    },
+    {
+        name: 'fact',
+        summary: 'Record, verify or remove a piece of project knowledge',
+        usage: [
+            '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]',
+            'devworkspace fact verify <key>',
+            'devworkspace fact remove <key>',
+            'devworkspace fact list',
+        ],
+        options: [
+            ['--key', 'lowercase dotted key, e.g. auth.session-store'],
+            ['--value', 'one concise sentence (no secrets, no absolute paths)'],
+            ['--file <path>', 'repository file that evidences the fact (repeatable); used for staleness'],
+            ...COMMON,
+        ],
+        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: 'task',
+        summary: 'Track engineering tasks with a completion gate',
+        usage: [
+            'devworkspace task new "<request>" [--type BUG|FEATURE|...]',
+            'devworkspace task list [--all]          (alias: devworkspace tasks)',
+            'devworkspace task show <id>',
+            'devworkspace task status <id> <STATUS> [--note <text>]',
+            'devworkspace task update <id> [--title ..] [--criteria ..]... [--plan ..]... [--area ..]... [--blocker ..]... [--require <check>]... [--summary ..]',
+            'devworkspace task verify <id> <check> pass|fail|skip|pending [--reason user-override] [--detail <text>]',
+            'devworkspace task tests <id> --phase baseline|after --passed <n> --failed <n>',
+            'devworkspace task attest <id> [--user-work-intact] [--knowledge-reviewed] [--final-state-inspected]',
+        ],
+        options: [['--all', 'include completed tasks'], ...COMMON],
+        examples: ['devworkspace task new "Fix the quotation email bug"', 'devworkspace task status T-20260101-ab12 COMPLETED'],
+    },
+    {
+        name: 'decision',
+        summary: 'Record architectural/project decisions (append-only, human-readable)',
+        usage: [
+            'devworkspace decision add --title <t> --context <c> --decision <d> --consequences <q> [--supersedes <n>]',
+            'devworkspace decision list',
+            'devworkspace decision show <n>',
+        ],
+        options: COMMON,
+        examples: ['devworkspace decision list'],
+    },
+    {
+        name: 'session',
+        summary: 'Save or list short session summaries (never transcripts)',
+        usage: [
+            'devworkspace session save --goal <g> [--done <x>]... [--area <a>]... [--tests-run <t>]... [--decision-note <d>]... [--remaining <r>]... [--next <n>] [--task <id>]',
+            'devworkspace session list',
+        ],
+        options: COMMON,
+        examples: ['devworkspace session save --goal "Fix login bug" --done "Added regression test" --next "Run e2e"'],
+    },
+    {
+        name: 'agent',
+        summary: 'Install DevWorkspace instructions for a coding agent (default: claude)',
+        usage: ['devworkspace agent install [--agent claude] [--dry-run]'],
+        options: [['--agent <id>', 'agent adapter (default: claude)'], ['--dry-run', 'preview the files that would change'], ...COMMON],
+        examples: ['devworkspace agent install --dry-run'],
+    },
+    {
+        name: 'export',
+        summary: 'Export portable project knowledge to a JSON bundle',
+        usage: ['devworkspace export [--out <file>] [--dry-run]'],
+        options: [['--out <file>', 'output path (default: devworkspace-export-<date>.json)'], ...COMMON],
+        examples: ['devworkspace export --out knowledge.json'],
+    },
+    {
+        name: 'import',
+        summary: 'Safely import an export bundle (validated; never silently overwrites)',
+        usage: ['devworkspace import <file> [--dry-run] [--overwrite] [--allow-different-project]'],
+        options: [['--overwrite', 'replace differing local files (backups are kept)'], ['--dry-run', 'show what would change'], ...COMMON],
+        examples: ['devworkspace import knowledge.json --dry-run'],
+    },
+    {
+        name: 'migrate',
+        summary: 'Upgrade workspace files to the current schema (with backups)',
+        usage: ['devworkspace migrate [--dry-run]'],
+        options: [['--dry-run', 'list what would be migrated'], ...COMMON],
+        examples: ['devworkspace migrate'],
+    },
+];
+export function topHelp(version) {
+    const w = Math.max(...COMMANDS.map((c) => c.name.length));
+    return [
+        `devworkspace ${version} - project-local AI engineering workspace`,
+        '',
+        'Usage: devworkspace <command> [options]',
+        '',
+        'Commands:',
+        ...COMMANDS.map((c) => `  ${c.name.padEnd(w + 2)}${c.summary}`),
+        '',
+        'Quick start:',
+        '  cd my-project',
+        '  npx devworkspace init',
+        '  npx devworkspace analyze',
+        '  # paste .devworkspace/analysis/onboarding-prompt.md into Claude Code',
+        '',
+        'Global options: --json  --cwd <dir>  --debug  --no-color  --ascii  --yes  --help  --version',
+        '(DevWorkspace never prompts interactively, so --yes is accepted as a no-op for script compatibility.)',
+        'Exit codes: 0 ok · 1 failure · 2 usage error · 3 warnings (only with --strict) · 130 interrupted',
+        'Run "devworkspace <command> --help" for details.',
+    ].join('\n');
+}
+export function commandHelp(c) {
+    const w = Math.max(...c.options.map(([o]) => o.length));
+    return [
+        `devworkspace ${c.name} - ${c.summary}`,
+        '',
+        'Usage:',
+        ...c.usage.map((u) => `  ${u}`),
+        '',
+        'Options:',
+        ...c.options.map(([o, d]) => `  ${o.padEnd(w + 2)}${d}`),
+        '',
+        'Examples:',
+        ...c.examples.map((e) => `  ${e}`),
+    ].join('\n');
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +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]'],\n    options: [['--root <dir>', 'project root (default: Git top-level or current directory)'], ['--dry-run', 'show what would be created'], ...COMMON],\n    examples: ['npx devworkspace init'],\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]'],\n    options: [['--strict', 'exit 3 when anything needs attention'], ...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]'],\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]'],\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 [--topic <prefix>] [--full]'],\n    options: [['--topic <text>', 'only facts whose key contains <text>'], ['--full', 'also print .devworkspace/context/*.md'], ...COMMON],\n    examples: ['devworkspace context --topic auth'],\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 verify <id> <check> pass|fail|skip|pending [--reason user-override] [--detail <text>]',\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: [['--all', 'include completed tasks'], ...COMMON],\n    examples: ['devworkspace task new \"Fix the quotation email bug\"', 'devworkspace task status T-20260101-ab12 COMPLETED'],\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: 'Install DevWorkspace instructions for a coding agent (default: claude)',\n    usage: ['devworkspace agent install [--agent claude] [--dry-run]'],\n    options: [['--agent <id>', 'agent adapter (default: claude)'], ['--dry-run', 'preview the files that would change'], ...COMMON],\n    examples: ['devworkspace agent install --dry-run'],\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: '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  --yes  --help  --version',\n    '(DevWorkspace never prompts interactively, so --yes is accepted as a no-op for script compatibility.)',\n    'Exit codes: 0 ok · 1 failure · 2 usage error · 3 warnings (only with --strict) · 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/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/main.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { EXIT } from '../errors/index.js';
+import { runCleanups } from '../utils/cleanup.js';
+import { run } from './run.js';
+// Release locks and exit with the conventional 128+signal code. Atomic writes mean no file is ever left half-written.
+for (const [sig, code] of [['SIGINT', EXIT.SIGINT], ['SIGTERM', EXIT.SIGTERM]]) {
+    process.on(sig, () => {
+        runCleanups();
+        process.stderr.write(`\nInterrupted (${sig}). Workspace files are written atomically, so no partial state was left behind.\n`);
+        process.exit(code);
+    });
+}
+run(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (e) => {
+    process.stderr.write(`✗ Fatal: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exitCode = EXIT.FAILURE;
+});
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,sHAAsH;AACtH,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAU,EAAE,CAAC;IACxF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;QACnB,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,mFAAmF,CAAC,CAAC;QAC/H,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,CAAU,EAAE,EAAE;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjF,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;AAClC,CAAC,CACF,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { EXIT } from '../errors/index.js';\nimport { runCleanups } from '../utils/cleanup.js';\nimport { run } from './run.js';\n\n// Release locks and exit with the conventional 128+signal code. Atomic writes mean no file is ever left half-written.\nfor (const [sig, code] of [['SIGINT', EXIT.SIGINT], ['SIGTERM', EXIT.SIGTERM]] as const) {\n  process.on(sig, () => {\n    runCleanups();\n    process.stderr.write(`\\nInterrupted (${sig}). Workspace files are written atomically, so no partial state was left behind.\\n`);\n    process.exit(code);\n  });\n}\n\nrun(process.argv.slice(2)).then(\n  (code) => {\n    process.exitCode = code;\n  },\n  (e: unknown) => {\n    process.stderr.write(`✗ Fatal: ${e instanceof Error ? e.message : String(e)}\\n`);\n    process.exitCode = EXIT.FAILURE;\n  },\n);\n"]}

package/dist/cli/render.d.ts

@@ -0,0 +1,39 @@
+import type { DoctorResult } from '../services/doctor.js';
+import type { StatusResult } from '../services/status.js';
+import type { InitResult } from '../services/init.js';
+import type { AnalyzeResult } from '../services/analysis.js';
+import type { RefreshResult } from '../services/refresh.js';
+import type { ContextResult } from '../services/knowledge.js';
+import type { Task, GateResult } from '../tasks/task.js';
+import type { AgentInstallResult } from '../services/agent.js';
+import type { ImportResult, ExportResult } from '../services/portability.js';
+import type { MigrateResult } from '../services/migrate.js';
+export interface Style {
+    ok(s: string): string;
+    warn(s: string): string;
+    fail(s: string): string;
+    dim(s: string): string;
+    bold(s: string): string;
+    sym: {
+        ok: string;
+        warn: string;
+        fail: string;
+        info: string;
+        arrow: string;
+    };
+}
+export declare function makeStyle(opts: {
+    color: boolean;
+    ascii: boolean;
+}): Style;
+export declare function renderStatus(s: Style, r: StatusResult): string;
+export declare function renderDoctor(s: Style, r: DoctorResult): string;
+export declare function renderInit(s: Style, r: InitResult): string;
+export declare function renderAnalyze(s: Style, r: AnalyzeResult): string;
+export declare function renderRefresh(s: Style, r: RefreshResult): string;
+export declare function renderContext(s: Style, r: ContextResult): string;
+export declare function renderTask(s: Style, t: Task, gate?: GateResult): string;
+export declare function renderAgentInstall(s: Style, r: AgentInstallResult): string;
+export declare function renderExport(s: Style, r: ExportResult): string;
+export declare function renderImport(s: Style, r: ImportResult): string;
+export declare function renderMigrate(s: Style, r: MigrateResult): string;