@work-graph/cli 0.2.1 → 0.2.3

package/README.md

@@ -1,6 +1,6 @@
 # @work-graph/cli
 
-User-first установка Work Graph в любой проект.
+Install [Work Graph](https://github.com/work-graph/work-graph) in any project via npm — no engine clone, no manual `engineRoot`.
 
 ## Quick start
 
@@ -16,16 +16,25 @@ npm run workgraph:ui
 
 | Command | Description |
 |---------|-------------|
-| `init [path]` | Канон `intent/`, devDependencies, MCP, Cursor rule |
-| `ui [path]` | Backlog UI для проекта |
-| `doctor [path]` | Проверка установки |
-| `register [path]` | Опционально: multiproject registry (power-user) |
+| `init [path]` | Scaffold `intent/`, add devDependencies, MCP config, Cursor rule |
+| `ui [path]` | Start backlog UI for the project |
+| `doctor [path]` | Verify installation |
+| `register [path]` | Optional: multiproject registry (power users) |
 
-## Dev (contributors)
+## Flags (`init`)
+
+| Flag | Purpose |
+|------|---------|
+| `--label`, `--id` | Display name and project id |
+| `--no-mcp` | Do not update `.cursor/mcp.json` |
+| `--no-package` | Do not update `package.json` |
+| `--legacy-engine-config` | Dev only: write deprecated `engineRoot` to config |
+
+## Contributors (monorepo dev)
 
 ```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.
+See [CONTRIBUTING.md](https://github.com/work-graph/work-graph/blob/main/CONTRIBUTING.md) in the Work Graph repository.

package/bin/work-graph.mjs

@@ -28,22 +28,21 @@ function resolveRuntimeModule(relativePath) {
   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);
+async function loadProjectInit() {
+  return import(resolveRuntimeModule('src/workGraphProjectInit.mjs'));
+}
+
+async function loadWorkspaceRegistry() {
+  return import(resolveRuntimeModule('src/workspaceRegistry.mjs'));
+}
+
+async function loadEngineRoot() {
+  return import(resolveRuntimeModule('src/workGraphEngineRoot.mjs'));
+}
+
+async function loadBacklogUi() {
+  return import(resolveRuntimeModule('src/workGraphBacklogUiServer.mjs'));
+}
 
 function usage() {
   console.log(`Work Graph CLI
@@ -126,6 +125,8 @@ function parseArgs(argv) {
 }
 
 async function cmdInit(targetPath, flags) {
+  const { defaultEngineRootFromCliModule, initWorkGraphProject } = await loadProjectInit();
+  const devEngineRoot = defaultEngineRootFromCliModule(cliModuleUrl);
   const root = resolve(targetPath ?? process.cwd());
   const useLegacyEngine = Boolean(flags.engine || flags.legacyEngineConfig);
   const result = await initWorkGraphProject({
@@ -142,6 +143,7 @@ async function cmdInit(targetPath, flags) {
   });
 
   if (flags.registerHost) {
+    const { registerWorkspace, setActiveWorkspace } = await loadWorkspaceRegistry();
     const registry = await registerWorkspace({
       id: result.projectId,
       root: result.projectRoot,
@@ -158,6 +160,7 @@ async function cmdInit(targetPath, flags) {
 }
 
 async function cmdRegister(targetPath, flags) {
+  const { registerWorkspace } = await loadWorkspaceRegistry();
   const root = resolve(targetPath ?? process.cwd());
   const registry = await registerWorkspace({
     id: flags.id,
@@ -175,6 +178,7 @@ async function cmdRegister(targetPath, flags) {
 }
 
 async function cmdDoctor(targetPath) {
+  const { runWorkGraphDoctor } = await loadProjectInit();
   const cwd = resolve(targetPath ?? process.cwd());
   const report = await runWorkGraphDoctor({ cwd, cliModuleUrl });
   console.log(JSON.stringify(report, null, 2));
@@ -184,6 +188,8 @@ async function cmdDoctor(targetPath) {
 }
 
 async function cmdUi(targetPath, flags) {
+  const { defaultEngineRootFromCliModule, startProjectUiFromCwd } = await loadProjectInit();
+  const devEngineRoot = defaultEngineRootFromCliModule(cliModuleUrl);
   const cwd = resolve(targetPath ?? process.cwd());
 
   try {
@@ -194,6 +200,8 @@ async function cmdUi(targetPath, flags) {
     // fallback: запуск из репозитория движка (разработка WG)
   }
 
+  const { resolveEngineRoot } = await loadEngineRoot();
+  const { startBacklogUiServer } = await loadBacklogUi();
   const engineRoot = resolveEngineRoot({ cliModuleUrl }) ?? devEngineRoot;
   const { host, port } = await startBacklogUiServer({
     hostRoot: engineRoot,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@work-graph/cli",
-  "version": "0.2.1",
-  "description": "Work Graph CLI — init project, doctor, start UI",
+  "version": "0.2.3",
+  "description": "Work Graph CLI — npm-first project setup, doctor, backlog UI",
   "type": "module",
   "bin": {
     "work-graph": "bin/work-graph.mjs"
@@ -30,6 +30,7 @@
     "cli"
   ],
   "dependencies": {
+    "@dagrejs/dagre": "^3.0.0",
     "mermaid": "^11.15.0"
   },
   "scripts": {

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

@@ -1,6 +1,6 @@
 # @work-graph/mcp
 
-MCP server for Work Graph — list/create/update work items in `intent/**/*.work.bvc`.
+[MCP](https://modelcontextprotocol.io) server for Work Graph — list, create, and update work items in `intent/**/*.work.bvc`.
 
 ## Cursor
 
@@ -21,8 +21,12 @@ After `npx @work-graph/cli init .`, `.cursor/mcp.json` includes:
 }
 ```
 
+Reload MCP in Cursor after init.
+
 ## Standalone
 
 ```bash
 WORKGRAPH_ROOT=/path/to/project npx @work-graph/mcp
 ```
+
+Requires a project with `.work-graph/config.json` (run `npx @work-graph/cli init` first).

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

@@ -1,7 +1,7 @@
 {
   "name": "@work-graph/mcp",
-  "version": "0.2.1",
-  "description": "MCP server for Work Graph WorkItems",
+  "version": "0.2.3",
+  "description": "MCP server for Work Graph — work items in intent/**/*.work.bvc",
   "type": "module",
   "bin": {
     "workgraph-mcp": "bin/workgraph-mcp.mjs"
@@ -16,7 +16,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@work-graph/cli": "^0.2.1",
+    "@work-graph/cli": "^0.2.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76"
   },

package/vendor/src/workGraphProjectInit.mjs

@@ -20,8 +20,8 @@ export {
 
 const CONFIG_SCHEMA_V1 = 'workgraph.project.config.v1';
 const CONFIG_SCHEMA_V2 = 'workgraph.project.config.v2';
-const DEFAULT_CLI_VERSION = '0.2.1';
-const DEFAULT_MCP_VERSION = '0.2.1';
+const DEFAULT_CLI_VERSION = '0.2.3';
+const DEFAULT_MCP_VERSION = '0.2.3';
 
 const INDEX_STUB = `#Index<[
 WorkItems: