@work-graph/cli 0.2.0

package/README.md

@@ -0,0 +1,31 @@
+# @work-graph/cli
+
+User-first установка Work Graph в любой проект.
+
+## Quick start
+
+```bash
+npx @work-graph/cli init .
+npm install
+npm run workgraph:ui
+```
+
+→ http://127.0.0.1:4177/
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init [path]` | Канон `intent/`, devDependencies, MCP, Cursor rule |
+| `ui [path]` | Backlog UI для проекта |
+| `doctor [path]` | Проверка установки |
+| `register [path]` | Опционально: multiproject registry (power-user) |
+
+## Dev (contributors)
+
+```bash
+git clone …/work-graph && cd work-graph && npm install
+WORKGRAPH_ENGINE_ROOT=. npx work-graph ui /path/to/project
+```
+
+См. [CONTRIBUTING.md](../../CONTRIBUTING.md) в репозитории Work Graph.

package/bin/work-graph.mjs

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+import { accessSync, constants } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const cliModuleUrl = import.meta.url;
+const cliDir = dirname(fileURLToPath(cliModuleUrl));
+const packageRoot = resolve(cliDir, '..');
+
+function pathExists(path) {
+  try {
+    accessSync(path, constants.R_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function resolveRuntimeModule(relativePath) {
+  const vendorPath = join(packageRoot, 'vendor', relativePath);
+  if (pathExists(vendorPath)) {
+    return pathToFileURL(vendorPath).href;
+  }
+  const monorepoPath = join(packageRoot, '../..', relativePath);
+  if (pathExists(monorepoPath)) {
+    return pathToFileURL(monorepoPath).href;
+  }
+  throw new Error(`Work Graph runtime module not found: ${relativePath}`);
+}
+
+const projectInitUrl = resolveRuntimeModule('src/workGraphProjectInit.mjs');
+const workspaceRegistryUrl = resolveRuntimeModule('src/workspaceRegistry.mjs');
+const backlogUiUrl = resolveRuntimeModule('src/workGraphBacklogUiServer.mjs');
+const engineRootUrl = resolveRuntimeModule('src/workGraphEngineRoot.mjs');
+
+const {
+  defaultEngineRootFromCliModule,
+  initWorkGraphProject,
+  runWorkGraphDoctor,
+  startProjectUiFromCwd,
+} = await import(projectInitUrl);
+const { registerWorkspace, setActiveWorkspace } = await import(workspaceRegistryUrl);
+const { startBacklogUiServer } = await import(backlogUiUrl);
+const { resolveEngineRoot } = await import(engineRootUrl);
+
+const devEngineRoot = defaultEngineRootFromCliModule(cliModuleUrl);
+
+function usage() {
+  console.log(`Work Graph CLI
+
+Usage:
+  work-graph init [path]       установить WG в проект (канон + npm deps + MCP + rule)
+  work-graph ui [path]         backlog UI для текущего или указанного проекта
+  work-graph doctor [path]     проверить установку WG в проекте
+  work-graph register [path]   (опционально) добавить проект в общий хост ~/.work-graph/
+
+Options:
+  --engine <path>              dev-only: путь к clone WG (WORKGRAPH_ENGINE_ROOT)
+  --id <projectId>             id проекта
+  --label <name>               отображаемое имя
+  --port <number>              порт UI (по умолчанию 4177)
+  --no-mcp                     не трогать .cursor/mcp.json
+  --no-package                 не трогать package.json
+  --no-rule                    не создавать .cursor/rules/work-graph-project.mdc
+  --register-host              после init зарегистрировать проект в multiproject-хосте
+  --legacy-engine-config       записать engineRoot в config (dev-first, deprecated)
+`);
+}
+
+function parseArgs(argv) {
+  const args = [...argv];
+  const flags = {
+    mergeMcp: true,
+    mergePackageJson: true,
+    writeCursorRule: true,
+    registerHost: false,
+    legacyEngineConfig: false,
+  };
+  const positionals = [];
+
+  while (args.length > 0) {
+    const token = args.shift();
+    if (token === '--id') {
+      flags.id = args.shift();
+      continue;
+    }
+    if (token === '--label') {
+      flags.label = args.shift();
+      continue;
+    }
+    if (token === '--port') {
+      flags.port = Number(args.shift());
+      continue;
+    }
+    if (token === '--engine') {
+      flags.engine = args.shift();
+      continue;
+    }
+    if (token === '--no-mcp') {
+      flags.mergeMcp = false;
+      continue;
+    }
+    if (token === '--no-package') {
+      flags.mergePackageJson = false;
+      continue;
+    }
+    if (token === '--no-rule') {
+      flags.writeCursorRule = false;
+      continue;
+    }
+    if (token === '--register-host') {
+      flags.registerHost = true;
+      continue;
+    }
+    if (token === '--legacy-engine-config') {
+      flags.legacyEngineConfig = true;
+      continue;
+    }
+    if (token?.startsWith('--')) {
+      throw new Error(`unknown flag: ${token}`);
+    }
+    positionals.push(token);
+  }
+
+  return { flags, positionals };
+}
+
+async function cmdInit(targetPath, flags) {
+  const root = resolve(targetPath ?? process.cwd());
+  const useLegacyEngine = Boolean(flags.engine || flags.legacyEngineConfig);
+  const result = await initWorkGraphProject({
+    projectRoot: root,
+    engineRoot: useLegacyEngine ? resolve(flags.engine ?? devEngineRoot) : undefined,
+    npmFirst: !useLegacyEngine,
+    cliModuleUrl,
+    id: flags.id,
+    label: flags.label,
+    uiPort: flags.port,
+    mergeMcp: flags.mergeMcp,
+    mergePackageJson: flags.mergePackageJson,
+    writeCursorRule: flags.writeCursorRule,
+  });
+
+  if (flags.registerHost) {
+    const registry = await registerWorkspace({
+      id: result.projectId,
+      root: result.projectRoot,
+      label: result.label,
+    });
+    await setActiveWorkspace(result.projectId);
+    result.hostRegistry = {
+      activeProjectId: registry.activeProjectId,
+      workspaceCount: registry.workspaces.length,
+    };
+  }
+
+  console.log(JSON.stringify(result, null, 2));
+}
+
+async function cmdRegister(targetPath, flags) {
+  const root = resolve(targetPath ?? process.cwd());
+  const registry = await registerWorkspace({
+    id: flags.id,
+    root,
+    label: flags.label,
+  });
+  const entry = registry.workspaces.find((item) => resolve(item.root) === root);
+  console.log(JSON.stringify({
+    ok: true,
+    schema: 'workgraph.cli.register.v1',
+    workspace: entry,
+    activeProjectId: registry.activeProjectId,
+    note: 'Опционально: для power-user с одним UI на N проектов. Основной путь — work-graph init в каждом репо.',
+  }, null, 2));
+}
+
+async function cmdDoctor(targetPath) {
+  const cwd = resolve(targetPath ?? process.cwd());
+  const report = await runWorkGraphDoctor({ cwd, cliModuleUrl });
+  console.log(JSON.stringify(report, null, 2));
+  if (!report.ok) {
+    process.exitCode = 1;
+  }
+}
+
+async function cmdUi(targetPath, flags) {
+  const cwd = resolve(targetPath ?? process.cwd());
+
+  try {
+    const { host, port } = await startProjectUiFromCwd({ cwd, port: flags.port, cliModuleUrl });
+    console.log(`Work Graph UI: http://${host}:${port}/`);
+    return;
+  } catch {
+    // fallback: запуск из репозитория движка (разработка WG)
+  }
+
+  const engineRoot = resolveEngineRoot({ cliModuleUrl }) ?? devEngineRoot;
+  const { host, port } = await startBacklogUiServer({
+    hostRoot: engineRoot,
+    cwd: engineRoot,
+    port: flags.port,
+  });
+  console.log(`Work Graph UI (engine): http://${host}:${port}/`);
+}
+
+async function main() {
+  const [command, ...rest] = process.argv.slice(2);
+  if (!command || command === '--help' || command === '-h') {
+    usage();
+    return;
+  }
+
+  const { flags, positionals } = parseArgs(rest);
+
+  if (command === 'init') {
+    await cmdInit(positionals[0], flags);
+    return;
+  }
+  if (command === 'register') {
+    await cmdRegister(positionals[0], flags);
+    return;
+  }
+  if (command === 'doctor') {
+    await cmdDoctor(positionals[0]);
+    return;
+  }
+  if (command === 'ui') {
+    await cmdUi(positionals[0], flags);
+    return;
+  }
+
+  throw new Error(`unknown command: ${command}`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@work-graph/cli",
+  "version": "0.2.0",
+  "description": "Work Graph CLI — init project, doctor, start UI",
+  "type": "module",
+  "bin": {
+    "work-graph": "bin/work-graph.mjs"
+  },
+  "files": [
+    "bin",
+    "vendor",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/work-graph/work-graph.git",
+    "directory": "packages/work-graph-cli"
+  },
+  "keywords": [
+    "work-graph",
+    "backlog",
+    "bvc",
+    "cli"
+  ],
+  "dependencies": {
+    "mermaid": "^11.15.0"
+  },
+  "scripts": {
+    "prepack": "node ../../scripts/sync-work-graph-cli-vendor.mjs"
+  }
+}

package/vendor/packages/design-tokens/generated/gripe-dark-default.css

@@ -0,0 +1,67 @@
+/**
+ * Generated by @iohasc/design-tokens — do not edit by hand.
+ * theme: gripe-dark-default
+ */
+:root {
+  --brand-font-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --brand-radius-sm: 0.25rem;
+  --brand-radius-md: 0.5rem;
+  --brand-radius-lg: 0.75rem;
+  --brand-primary-rgb: 245 158 11;
+  --brand-primary-foreground-rgb: 17 17 17;
+  --brand-bg-rgb: 30 30 30;
+  --brand-surface-rgb: 37 37 38;
+  --brand-border-rgb: 60 60 60;
+  --brand-muted-rgb: 157 157 157;
+  --brand-scrollbar-track: #1e1e1e;
+  --brand-scrollbar-thumb: rgba(255, 255, 255, 0.22);
+  --brand-scrollbar-thumb-hover: rgba(255, 255, 255, 0.34);
+
+  /* Typography (Marketplace scale) */
+  --text-heading-letter-spacing: 0.01em;
+  --text-xs: 0.6875rem;
+  --text-xs-line-height: 1rem;
+  --text-sm: 0.8125rem;
+  --text-sm-line-height: 1.25rem;
+  --text-base: 0.9375rem;
+  --text-base-line-height: 1.5rem;
+  --text-lg: 1.0625rem;
+  --text-lg-line-height: 1.625rem;
+  --text-xl: 1.1875rem;
+  --text-xl-line-height: 1.75rem;
+  --text-2xl: 1.4375rem;
+  --text-2xl-line-height: 1.875rem;
+  --font-weight-strong: 600;
+  --font-size-sm: var(--text-sm);
+  --font-size-base: var(--text-base);
+
+  /* Runtime UI semantic tokens */
+  --ui-accent-rgb: 245 158 11;
+  --ui-accent-hover-rgb: 217 119 6;
+  --ui-accent-active-rgb: 180 83 9;
+  --ui-accent-foreground-rgb: 17 17 17;
+  --ui-link-rgb: 245 158 11;
+  --ui-link-hover-rgb: 251 191 36;
+  --ui-link-active-rgb: 217 119 6;
+  --ui-text-rgb: 212 212 212;
+  --ui-muted-rgb: 157 157 157;
+  --ui-surface-rgb: 37 37 38;
+  --ui-surface-muted-rgb: 45 45 48;
+  --ui-surface-hover-rgb: 45 45 48;
+  --ui-control-bg-rgb: 45 45 48;
+  --ui-control-bg-hover-rgb: 60 60 60;
+  --ui-control-checked-rgb: 245 158 11;
+  --ui-control-checked-foreground-rgb: 17 17 17;
+  --ui-focus-ring-rgb: 245 158 11;
+  --ui-danger-rgb: 241 76 76;
+  --ui-cta-rgb: 245 158 11;
+  --ui-cta-hover-rgb: 217 119 6;
+  --ui-cta-active-rgb: 180 83 9;
+  --ui-cta-foreground-rgb: 17 17 17;
+  --ui-rating-active-rgb: 245 158 11;
+  --ui-radius-card: 0.5rem;
+  --ui-radius-modal: 0.5rem;
+  --ui-radius-control-lg: 0.5rem;
+  --ui-radius-control: 0.375rem;
+  --ui-radius-control-sm: 0.25rem;
+}

package/vendor/packages/design-tokens/generated/marketplace-default.css

@@ -0,0 +1,67 @@
+/**
+ * Generated by @iohasc/design-tokens — do not edit by hand.
+ * theme: marketplace-default
+ */
+:root {
+  --brand-font-sans: 'Graphik LCG', ui-sans-serif, system-ui, sans-serif;
+  --brand-radius-sm: 0.25rem;
+  --brand-radius-md: 0.5rem;
+  --brand-radius-lg: 0.75rem;
+  --brand-primary-rgb: 245 158 11;
+  --brand-primary-foreground-rgb: 15 23 42;
+  --brand-bg-rgb: 2 6 23;
+  --brand-surface-rgb: 15 23 42;
+  --brand-border-rgb: 30 41 59;
+  --brand-muted-rgb: 148 163 184;
+  --brand-scrollbar-track: #f1f5f9;
+  --brand-scrollbar-thumb: #cbd5e1;
+  --brand-scrollbar-thumb-hover: #94a3b8;
+
+  /* Typography (Marketplace scale) */
+  --text-heading-letter-spacing: 0.01em;
+  --text-xs: 0.6875rem;
+  --text-xs-line-height: 1rem;
+  --text-sm: 0.8125rem;
+  --text-sm-line-height: 1.25rem;
+  --text-base: 0.9375rem;
+  --text-base-line-height: 1.5rem;
+  --text-lg: 1.0625rem;
+  --text-lg-line-height: 1.625rem;
+  --text-xl: 1.1875rem;
+  --text-xl-line-height: 1.75rem;
+  --text-2xl: 1.4375rem;
+  --text-2xl-line-height: 1.875rem;
+  --font-weight-strong: 600;
+  --font-size-sm: var(--text-sm);
+  --font-size-base: var(--text-base);
+
+  /* Runtime UI semantic tokens */
+  --ui-accent-rgb: 12 115 254;
+  --ui-accent-hover-rgb: 9 101 224;
+  --ui-accent-active-rgb: 8 88 199;
+  --ui-accent-foreground-rgb: 255 255 255;
+  --ui-link-rgb: 12 115 254;
+  --ui-link-hover-rgb: 220 38 38;
+  --ui-link-active-rgb: 185 28 28;
+  --ui-text-rgb: 15 23 42;
+  --ui-muted-rgb: 100 116 139;
+  --ui-surface-rgb: 255 255 255;
+  --ui-surface-muted-rgb: 245 245 245;
+  --ui-surface-hover-rgb: 243 243 243;
+  --ui-control-bg-rgb: 242 242 242;
+  --ui-control-bg-hover-rgb: 226 232 240;
+  --ui-control-checked-rgb: 0 0 0;
+  --ui-control-checked-foreground-rgb: 255 255 255;
+  --ui-focus-ring-rgb: 12 115 254;
+  --ui-danger-rgb: 220 38 38;
+  --ui-cta-rgb: 0 0 0;
+  --ui-cta-hover-rgb: 38 38 38;
+  --ui-cta-active-rgb: 23 23 23;
+  --ui-cta-foreground-rgb: 255 255 255;
+  --ui-rating-active-rgb: 12 115 254;
+  --ui-radius-card: 1.5rem;
+  --ui-radius-modal: 1.5rem;
+  --ui-radius-control-lg: 1rem;
+  --ui-radius-control: 0.75rem;
+  --ui-radius-control-sm: 0.5rem;
+}

package/vendor/packages/design-tokens/generated/workgraph-dark.css

@@ -0,0 +1,67 @@
+/**
+ * Generated by @iohasc/design-tokens — do not edit by hand.
+ * theme: workgraph-dark
+ */
+:root {
+  --brand-font-sans: 'Graphik LCG', ui-sans-serif, system-ui, sans-serif;
+  --brand-radius-sm: 0.25rem;
+  --brand-radius-md: 0.5rem;
+  --brand-radius-lg: 0.75rem;
+  --brand-primary-rgb: 0 102 255;
+  --brand-primary-foreground-rgb: 255 255 255;
+  --brand-bg-rgb: 30 30 30;
+  --brand-surface-rgb: 37 37 38;
+  --brand-border-rgb: 60 60 60;
+  --brand-muted-rgb: 157 157 157;
+  --brand-scrollbar-track: #1e1e1e;
+  --brand-scrollbar-thumb: rgba(255, 255, 255, 0.22);
+  --brand-scrollbar-thumb-hover: rgba(255, 255, 255, 0.34);
+
+  /* Typography (Marketplace scale) */
+  --text-heading-letter-spacing: 0.01em;
+  --text-xs: 0.6875rem;
+  --text-xs-line-height: 1rem;
+  --text-sm: 0.8125rem;
+  --text-sm-line-height: 1.25rem;
+  --text-base: 0.9375rem;
+  --text-base-line-height: 1.5rem;
+  --text-lg: 1.0625rem;
+  --text-lg-line-height: 1.625rem;
+  --text-xl: 1.1875rem;
+  --text-xl-line-height: 1.75rem;
+  --text-2xl: 1.4375rem;
+  --text-2xl-line-height: 1.875rem;
+  --font-weight-strong: 600;
+  --font-size-sm: var(--text-sm);
+  --font-size-base: var(--text-base);
+
+  /* Runtime UI semantic tokens */
+  --ui-accent-rgb: 0 102 255;
+  --ui-accent-hover-rgb: 0 90 230;
+  --ui-accent-active-rgb: 0 78 204;
+  --ui-accent-foreground-rgb: 255 255 255;
+  --ui-link-rgb: 0 102 255;
+  --ui-link-hover-rgb: 96 165 250;
+  --ui-link-active-rgb: 59 130 246;
+  --ui-text-rgb: 212 212 212;
+  --ui-muted-rgb: 157 157 157;
+  --ui-surface-rgb: 37 37 38;
+  --ui-surface-muted-rgb: 45 45 48;
+  --ui-surface-hover-rgb: 45 45 48;
+  --ui-control-bg-rgb: 45 45 48;
+  --ui-control-bg-hover-rgb: 60 60 60;
+  --ui-control-checked-rgb: 0 102 255;
+  --ui-control-checked-foreground-rgb: 255 255 255;
+  --ui-focus-ring-rgb: 0 102 255;
+  --ui-danger-rgb: 241 76 76;
+  --ui-cta-rgb: 0 102 255;
+  --ui-cta-hover-rgb: 0 90 230;
+  --ui-cta-active-rgb: 0 78 204;
+  --ui-cta-foreground-rgb: 255 255 255;
+  --ui-rating-active-rgb: 240 173 78;
+  --ui-radius-card: 0.5rem;
+  --ui-radius-modal: 0.5rem;
+  --ui-radius-control-lg: 0.5rem;
+  --ui-radius-control: 0.375rem;
+  --ui-radius-control-sm: 0.25rem;
+}

package/vendor/packages/workgraph-mcp/README.md

@@ -0,0 +1,28 @@
+# @work-graph/mcp
+
+MCP server for Work Graph — list/create/update work items in `intent/**/*.work.bvc`.
+
+## Cursor
+
+After `npx @work-graph/cli init .`, `.cursor/mcp.json` includes:
+
+```json
+{
+  "mcpServers": {
+    "workgraph": {
+      "command": "npx",
+      "args": ["-y", "@work-graph/mcp"],
+      "env": {
+        "WORKGRAPH_ROOT": "${workspaceFolder}",
+        "WG_PROJECT_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}
+```
+
+## Standalone
+
+```bash
+WORKGRAPH_ROOT=/path/to/project npx @work-graph/mcp
+```

package/vendor/packages/workgraph-mcp/bin/workgraph-mcp.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const require = createRequire(import.meta.url);
+
+function resolveMcpEntry() {
+  try {
+    const cliPkg = require.resolve('@work-graph/cli/package.json');
+    const cliRoot = dirname(cliPkg);
+    const vendorEntry = join(cliRoot, 'vendor/packages/workgraph-mcp/src/index.mjs');
+    return pathToFileURL(vendorEntry).href;
+  } catch {
+    // monorepo dev
+    const localEntry = new URL('../src/index.mjs', import.meta.url).href;
+    return localEntry;
+  }
+}
+
+await import(resolveMcpEntry());

package/vendor/packages/workgraph-mcp/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@work-graph/mcp",
+  "version": "0.2.0",
+  "description": "MCP server for Work Graph WorkItems",
+  "type": "module",
+  "bin": {
+    "workgraph-mcp": "bin/workgraph-mcp.mjs"
+  },
+  "main": "src/index.mjs",
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@work-graph/cli": "^0.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/work-graph/work-graph.git",
+    "directory": "packages/workgraph-mcp"
+  },
+  "keywords": [
+    "work-graph",
+    "mcp",
+    "cursor"
+  ],
+  "scripts": {
+    "start": "node bin/workgraph-mcp.mjs"
+  }
+}