@doquflow/cli 0.4.0 → 0.4.2

package/README.md

@@ -1,38 +1,83 @@
 # @doquflow/cli
 
-CLI for setting up Docuflow in your project. Registers the MCP server in Claude Desktop and scaffolds `.docuflow/specs/`.
+CLI for setting up Docuflow in your project. Registers the MCP server in Claude Desktop, scaffolds `.docuflow/`, generates `CLAUDE.md`, and gives domain-aware onboarding guidance.
 
-## Usage
+## Install
+
+```bash
+npm install -g @doquflow/cli
+```
+
+Or use without installing:
 
 ```bash
 npx @doquflow/cli init
 ```
 
-That's it. One command to:
+## Commands
+
+### `docuflow init`
+
+One command to:
+- Create `.docuflow/` directory structure (sources/, wiki/, specs/, schema.md, index.md, log.md)
 - Register the `@doquflow/server` MCP server in your Claude Desktop config
-- Create `.docuflow/specs/` in your current project
-- Add `.docuflow/` to `.gitignore`
+- Generate `CLAUDE.md` at the project root so Claude auto-discovers all 15 tools
+
+```bash
+docuflow init
+```
+
+### `docuflow init --interactive`
+
+Interactive domain-aware setup:
+- Choose your domain: Code/Architecture, Research, Business, or Personal
+- Enter project name and description
+- Auto-generates a domain-specific schema template
+- Creates a planning template (PLAN.md)
+- Generates CLAUDE.md
+
+```bash
+docuflow init --interactive
+# or: docuflow init -i
+```
+
+### `docuflow status`
+
+Shows current Docuflow state:
+- Package version
+- MCP server registration status
+- CLAUDE.md presence
+- Wiki page counts by category (entities, concepts, syntheses, timelines)
+- Source file count
+- Last ingest date
+- Smart hints
 
 ```bash
-npx @doquflow/cli status
+docuflow status
 ```
 
-Shows how many specs are written and whether the MCP server is registered.
+### `docuflow suggest`
+
+Domain-aware first-steps guidance. Reads your domain from `.docuflow/schema.md`, counts existing wiki pages and sources, then prints 5 prioritised suggestions with reasons and ready-to-paste Claude prompt starters.
+
+```bash
+docuflow suggest
+```
 
 ## How it works
 
-After running `init`, open Claude Desktop and ask it to document your codebase:
+After running `init`, open Claude Desktop (or any MCP-compatible agent) and start working:
 
 ```
-Read the modules in src/ and write specs for each one.
+Scan src/ with list_modules and write wiki pages for each major module.
 ```
 
-Claude will call the Docuflow MCP tools to read your files and write living markdown specs to `.docuflow/specs/`. No API keys, no uploads, no AI inside the server.
+Claude will call Docuflow's 15 MCP tools to read files, build a wiki, and answer questions about your codebase — persisting knowledge that compounds over time.
 
 ## Requirements
 
 - Node.js 18+
-- Claude Desktop
+- Claude Desktop, Cursor, Copilot, or any MCP-compatible agent
 
 ## License
 

package/dist/index.js

@@ -33,8 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { version } = require('../package.json');
 const [, , cmd, flag] = process.argv;
-if (cmd === 'init') {
+if (cmd === '--version' || cmd === '-v') {
+    console.log(version);
+}
+else if (cmd === 'init') {
     if (flag === '--interactive' || flag === '-i') {
         Promise.resolve().then(() => __importStar(require('./commands/init-interactive'))).then(m => m.runInteractive());
     }
@@ -49,10 +54,16 @@ else if (cmd === 'suggest') {
     Promise.resolve().then(() => __importStar(require('./commands/suggest'))).then(m => m.run());
 }
 else {
-    console.log('Usage: npx @doquflow/cli <command>');
+    console.log(`DocuFlow v${version}`);
+    console.log('');
+    console.log('Usage: docuflow <command>');
     console.log('');
-    console.log('  init              Register Docuflow MCP and generate CLAUDE.md');
+    console.log('Commands:');
+    console.log('  init              Register DocuFlow MCP and generate CLAUDE.md');
     console.log('  init --interactive  Interactive setup wizard (choose domain, project name)');
     console.log('  status            Show wiki health, page counts, and MCP status');
     console.log('  suggest           Show what to document first (domain-specific guidance)');
+    console.log('');
+    console.log('Options:');
+    console.log('  --version, -v     Print version number');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doquflow/cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "CLI for setting up Docuflow in your project",
   "author": "Docuflow <hello@doquflows.dev>",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@doquflow/server": "0.4.0"
+    "@doquflow/server": "0.4.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",