@danalexilewis/taskgraph 0.1.0 → 0.2.0

package/README.md

@@ -12,18 +12,35 @@ TaskGraph is a small CLI (`tg`) + Dolt-backed schema for managing **plans, tasks
 
 ## Quick start
 
-1. Install Dolt (`brew install dolt`)
-2. Initialize TaskGraph in your repo:
+1. **Install Dolt** (required for the local DB): `brew install dolt`
+2. **Install TaskGraph** in your repo:
 
-```bash
-tg init
-```
+   ```bash
+   pnpm add -D @danalexilewis/taskgraph
+   ```
 
-1. Scaffold recommended conventions (example domain docs, skill guides, and Cursor rules):
+3. **Register the command** in your repo so `tg` runs the installed CLI. In `package.json`, add a script:
 
-```bash
-tg setup
-```
+   ```json
+   "scripts": {
+     "tg": "tg"
+   }
+   ```
+
+   Then use `pnpm tg` (or `npm run tg`) for all commands; the script runs the binary from `node_modules/.bin`.
+4. **Initialize** from your repo root (creates `.taskgraph/` and Dolt DB):
+
+   ```bash
+   pnpm tg init
+   ```
+
+5. **Scaffold** (optional; domain docs, skill guides, Cursor rules):
+
+   ```bash
+   pnpm tg setup
+   ```
+
+Without the script, the shell can't find `tg`; `npx tg init` also works if you prefer not to add the script.
 
 ## Conventions (domain + skill guides)
 
@@ -33,15 +50,3 @@ Tasks can optionally declare:
 - `skill`: slug(s) that map to `docs/skills/<skill>.md`
 
 Agents can read the docs printed by `tg context <taskId>` to load repo-specific conventions before making changes.
-
-## Publishing the CLI to npm
-
-The repo root is the publishable package. **Run from the repo root**:
-
-1. **Package name**: The name `taskgraph` is available. If it were taken, use a scoped name in `package.json` (e.g. `@yourname/taskgraph`).
-2. **Build**: `pnpm build`
-3. **Dry-run** (see what will be in the tarball): `npm pack --dry-run`
-4. **Publish**: `npm publish`  
-   (Requires `npm login` and 2FA if enabled.)
-
-The `prepublishOnly` script runs `npm run build` when you publish, so `dist/` is built before packing. The tarball includes only `dist`, `templates`, and `README.md` (see `files` in package.json).

package/dist/cli/init.js

@@ -43,6 +43,18 @@ const neverthrow_1 = require("neverthrow");
 const errors_1 = require("../domain/errors");
 const TASKGRAPH_DIR = ".taskgraph";
 const CONFIG_FILE = path.join(TASKGRAPH_DIR, "config.json");
+/** Build a user-friendly hint when init fails (e.g. dolt not found). */
+function initFailureHint(cause) {
+    if (cause instanceof Error) {
+        const code = cause.code;
+        const msg = cause.message ?? String(cause);
+        if (code === "ENOENT" || /not found|command not found/i.test(msg)) {
+            return " Dolt may not be installed or not on PATH. Install it (e.g. brew install dolt) and ensure you run tg from your repo (e.g. npx tg init or pnpm exec tg init).";
+        }
+        return ` Cause: ${msg}`;
+    }
+    return ` Cause: ${String(cause)}`;
+}
 function initCommand(program) {
     program
         .command("init")
@@ -91,7 +103,10 @@ function initCommand(program) {
             // ... rest of the match block remains the same
         }, (error) => {
             const appError = error;
-            console.error(`Error initializing Task Graph: ${appError.message}`); // Used appError.message
+            console.error(`Error initializing Task Graph: ${appError.message}`);
+            if (!cmd.parent?.opts().json && appError.cause != null) {
+                console.error(initFailureHint(appError.cause));
+            }
             if (cmd.parent?.opts().json) {
                 console.log(JSON.stringify({
                     status: "error",

package/package.json

@@ -1,23 +1,25 @@
 {
   "name": "@danalexilewis/taskgraph",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Task Graph CLI for Centaur Development",
   "main": "dist/cli/index.js",
   "bin": {
     "tg": "dist/cli/index.js"
   },
-  "files": ["dist", "README.md"],
-  "scripts": {
-    "tg": "node dist/cli/index.js",
-    "dev": "tsx src/cli/index.ts",
-    "build": "tsc && node -e \"require('fs').cpSync('src/template','dist/template',{recursive:true})\"",
-    "prepublishOnly": "npm run build",
-    "start": "node dist/cli/index.js",
-    "test": "vitest run --dir __tests__",
-    "test:e2e": "vitest run --dir __tests__/e2e",
-    "test:integration": "vitest run --dir __tests__/integration"
-  },
-  "keywords": ["cli", "tasks", "plans", "dolt", "cursor", "centaur", "taskgraph", "agent-workflow"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "tasks",
+    "plans",
+    "dolt",
+    "cursor",
+    "centaur",
+    "taskgraph",
+    "agent-workflow"
+  ],
   "author": "danalexilewis",
   "license": "MIT",
   "engines": {
@@ -43,5 +45,14 @@
     "tsx": "^4.7.1",
     "typescript": "^5.3.3",
     "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "tg": "node dist/cli/index.js",
+    "dev": "tsx src/cli/index.ts",
+    "build": "tsc && node -e \"require('fs').cpSync('src/template','dist/template',{recursive:true})\"",
+    "start": "node dist/cli/index.js",
+    "test": "vitest run --dir __tests__",
+    "test:e2e": "vitest run --dir __tests__/e2e",
+    "test:integration": "vitest run --dir __tests__/integration"
   }
-}
+}