novahiz 0.1.0 → 0.1.1

package/README.md

@@ -48,14 +48,19 @@ The package exposes no programmatic import surface. It ships a CLI and an MCP se
 
 ## Install
 
-Clone into the Novahiz home and run the installer:
+```
+npm install -g novahiz
+novahiz init
+```
+
+Or from source:
 
 ```
 git clone https://github.com/novahiz/novahiz ~/.config/novahiz
 node ~/.config/novahiz/install/install.mjs
 ```
 
-The installer copies the bundled skills, drops the opencode plugin, writes `novahiz.config.json` if missing, and builds the catalog. It never deletes your files. Restart opencode afterward. The plugin registers the MCP server on its own.
+Restart opencode afterward. The plugin registers the MCP server on its own.
 
 Full options and the uninstall steps are in [docs/INSTALL.md](docs/INSTALL.md).
 
@@ -72,35 +77,34 @@ Machine-specific settings live in `novahiz.config.json`, which is gitignored: th
 ## CLI
 
 ```
-node src/cli.ts sync
-node src/cli.ts check
-node src/cli.ts classify "ajoute une migration supabase avec une policy rls"
-node src/cli.ts gate --file src/hero.css --tool edit
-node src/cli.ts gate --file src/hero.css --tool edit --loaded humanizer,impeccable
-node src/cli.ts skills --category design-ui
-node src/cli.ts catalog "design frontend landing" --limit 5
-node src/cli.ts roadmap --category code
-node src/cli.ts step --session my-session --done plan
-node src/cli.ts report --format markdown
-node src/cli.ts task new --title "Add the CSV export"
-node src/cli.ts task plan --task <id> --json '[{"label":"read the parser","kind":"read"},{"label":"write the exporter","kind":"edit","acceptance":"csv round-trips","owner":"src/export.ts"}]'
-node src/cli.ts task start --id <todo>
-node src/cli.ts task done --id <todo> --proof "node --test tests/export.test.ts -> 4 pass"
-node src/cli.ts task status --session <id>
-node src/cli.ts dispatch --task <id>
-node src/cli.ts tokens --calibrate --format text
-node src/cli.ts clean --days 30 --dry-run
-node src/cli.ts clean --days 30 --apply --vacuum
-node src/cli.ts doctor
+novahiz init                    # one-shot setup (config, skills, catalog)
+novahiz doctor                  # health check
+novahiz status                  # classification and gate state
+novahiz task new "Add CSV"      # start a tracked task
+novahiz task status             # show task progress
+novahiz task done <id>          # mark a todo complete
+novahiz report                  # session report
+novahiz clean                   # remove old logs and sessions
+novahiz upgrade                 # pull latest and rebuild catalog
+novahiz version                 # show version
 ```
 
-`gate` prints a JSON verdict and exits `0` when the edit is allowed, `2` when it is blocked. Adapters rely on that exit code.
+Advanced (for power users and adapters):
 
-Output follows the terminal by default, and `--pretty` or `--json` forces a mode. `clean` prunes old enforcement logs, roadmap progress, sessions, and closed tasks; without `--apply` it shows the plan and, on an interactive terminal, asks for confirmation. `doctor` runs the preflight checks and exits non-zero on a blocking finding.
+```
+novahiz classify "ajoute une migration supabase"
+novahiz gate --file src/hero.css --tool edit
+novahiz skills --category design-ui
+novahiz catalog "design frontend landing" --limit 5
+novahiz roadmap --category code
+novahiz dispatch --task <id>
+novahiz tokens --calibrate
+novahiz clean --days 30 --apply --vacuum
+```
 
-Run `node src/cli.ts` with no arguments for the full command list, including `categories`, `rules`, `session-load`, `session-state`, `hook`, `providers`, `deps`, and every `task` subcommand.
+`gate` prints a JSON verdict and exits `0` when the edit is allowed, `2` when it is blocked. Adapters rely on that exit code.
 
-The adapter also trims tool output and deduplicates stale reads to keep long sessions cheap.
+Run `novahiz` with no arguments for the full command list.
 
 ## opencode adapter
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novahiz",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Deterministic agentic layer for coding harnesses: skill catalog, prompt classifier, and a pre-edit enforcement gate.",
   "type": "module",
   "license": "Apache-2.0",

package/src/cli.ts

@@ -1,4 +1,7 @@
-import { resolve } from "node:path";
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
 import { parse, print } from "./commands/context.ts";
 import { expandHome } from "./spec.ts";
 
@@ -10,42 +13,88 @@ import { commandClean } from "./commands/clean.ts";
 import { commandDoctor } from "./commands/doctor.ts";
 import { commandTokens } from "./commands/tokens.ts";
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = process.env.NOVAHIZ_HOME || join(process.env.HOME || process.env.USERPROFILE || "", ".config", "novahiz");
+
+function runSync(): void {
+  const cli = join(HOME, "src", "cli.ts");
+  if (existsSync(cli)) {
+    spawnSync(process.execPath, [cli, "sync"], {
+      encoding: "utf8",
+      stdio: "inherit",
+      env: { ...process.env, NOVAHIZ_HOME: HOME }
+    });
+  }
+}
+
 function usage(): void {
   print({
     name: "novahiz",
     commands: [
-      "check",
-      "sync",
-      "classify <text> [--min-score N] [--max-categories N]",
-      "gate --tool <tool> (--file <path> | --args-stdin) [--categories a,b] [--loaded a,b] [--session id]",
-      "skills [--category id]",
-      "categories",
-      "rules",
-      "session-load --session id --skill name",
-      "session-state --session id",
-      "report [--format markdown]",
-      "catalog <query> [--limit N]",
-      "roadmap --category id | <query>",
-      "step --session id --done <step>",
-      "providers [--category id] [--mcp-json] [--install]",
-      "deps [--install]",
-      "task new --title <title> [--id id] [--session id]",
-      "task plan [--task id] [--session id] (JSON array on stdin or --json '<...>')",
-      "task todo --label <label> [--task id] [--kind read|edit|verify|delegate] [--owner a,b] [--acceptance ...] [--max-iterations N]",
-      "task start|done|block --id <todo> [--proof ...|--reason ...]",
-      "task review [--task id] [--reason ...] [--json '<additions|amendments|removals|order>'] (or JSON on stdin)",
-      "task amend --id <todo> [--label ...] [--kind ...] [--acceptance ...] [--owner a,b] [--max-iterations N]",
-      "task insert --label <label> [--task id] [--kind ...] [--owner a,b] [--acceptance ...] [--position start|end|N]",
-      "task drop --id <todo> [--reason ...]",
-      "task reorder [--task id] --order <id,id,...>",
-      "task signals [--task id]",
-      "task status|resume|current [--session id]",
-      "dispatch [--task id] [--session id]",
-      "clean [--target logs|roadmap|sessions|tasks|all] [--days N] [--dry-run|--apply] [--vacuum] [--json]",
-      "doctor [--json]",
-      "tokens [--json] [--calibrate]"
+      "init                    Set up Novahiz (config, skills, catalog)",
+      "doctor                  Check that everything works",
+      "status                  Show current classification and gate state",
+      "task new <title>        Start a new tracked task",
+      "task status             Show task progress",
+      "task done <id>          Mark a todo as complete",
+      "report                  Session report",
+      "clean                   Remove old logs and sessions",
+      "upgrade                 Pull latest and rebuild catalog",
+      "version                 Show version",
+      "",
+      "Advanced (for power users and adapters):",
+      "  classify <text>       Classify a prompt",
+      "  gate --tool <t> --file <f>  Check if an edit is allowed",
+      "  skills [--category c] List loaded skills",
+      "  catalog <query>       Search the skill catalog",
+      "  roadmap --category c  Show execution roadmap",
+      "  dispatch [--task id]  Generate work packets",
+      "  tokens                Token diagnostics",
     ]
-  });}
+  });
+}
+
+function printVersion(): void {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+    process.stdout.write(`novahiz ${pkg.version}\n`);
+  } catch {
+    process.stdout.write("novahiz (unknown version)\n");
+  }
+}
+
+function runInit(): void {
+  const installScript = join(HOME, "install", "install.mjs");
+  if (existsSync(installScript)) {
+    process.stdout.write("Installing Novahiz...\n");
+    const result = spawnSync(process.execPath, [installScript, "--yes"], {
+      encoding: "utf8",
+      stdio: "inherit",
+      env: { ...process.env, NOVAHIZ_HOME: HOME }
+    });
+    if (result.status !== 0) {
+      process.stderr.write("Installation failed. Run `novahiz doctor` for details.\n");
+      process.exitCode = 1;
+      return;
+    }
+  }
+  process.stdout.write("\nBuilding skill catalog...\n");
+  runSync();
+  process.stdout.write("\nDone! Restart opencode to activate Novahiz.\n");
+}
+
+function runUpgrade(): void {
+  if (!existsSync(join(HOME, ".git"))) {
+    process.stderr.write("Not a git repository. Install from source first.\n");
+    process.exitCode = 1;
+    return;
+  }
+  process.stdout.write("Pulling latest changes...\n");
+  spawnSync("git", ["pull"], { cwd: HOME, stdio: "inherit" });
+  process.stdout.write("\nRebuilding skill catalog...\n");
+  runSync();
+  process.stdout.write("\nUpgraded! Restart opencode to apply changes.\n");
+}
 
 function main(argv: string[]): void {
   const parsed = parse(argv);
@@ -58,8 +107,27 @@ function main(argv: string[]): void {
     return;
   }
   switch (command) {
+    case "init":
+    case "setup":
+      return runInit();
+    case "doctor":
+      return commandDoctor(parsed);
+    case "status":
     case "check":
       return commandCheck();
+    case "report":
+      return commandReport(parsed);
+    case "clean":
+      return commandClean(parsed);
+    case "upgrade":
+    case "update":
+      return runUpgrade();
+    case "version":
+    case "-v":
+    case "--version":
+      return printVersion();
+    case "task":
+      return commandTask(parsed);
     case "sync":
       return commandSync();
     case "classify":
@@ -76,14 +144,6 @@ function main(argv: string[]): void {
       return commandSessionLoad(parsed);
     case "session-state":
       return commandSessionState(parsed);
-    case "report":
-      return commandReport(parsed);
-    case "clean":
-      return commandClean(parsed);
-    case "doctor":
-      return commandDoctor(parsed);
-    case "tokens":
-      return commandTokens(parsed);
     case "catalog":
       return commandCatalog(parsed);
     case "roadmap":
@@ -94,12 +154,12 @@ function main(argv: string[]): void {
       return commandProviders(parsed);
     case "deps":
       return commandDeps(parsed);
-    case "task":
-      return commandTask(parsed);
     case "dispatch":
       return commandDispatch(parsed);
+    case "tokens":
+      return commandTokens(parsed);
     default:
-      process.stderr.write(`novahiz: unknown command ${command}\n`);
+      process.stderr.write(`novahiz: unknown command "${command}"\n\n`);
       usage();
       process.exitCode = 1;
       return;