@hasna/machines 0.0.1 → 0.0.3

package/README.md

@@ -1,16 +1,16 @@
 # @hasna/machines
 
-Machine fleet management for developers — provision, sync, and manage multiple dev machines from CLI and MCP.
+Machine fleet management for developers — provision, sync, inspect, and operate multiple development machines from CLI and MCP.
 
-## Planned surface
+## Binaries
 
-- `machines`: Commander-based CLI for manifest, setup, sync, and status commands
+- `machines`: Commander-based CLI for manifest, setup, sync, inspection, and dashboard commands
 - `machines-mcp`: MCP server exposing fleet tools to AI agents
 - `machines-agent`: lightweight local daemon for heartbeats and runtime reporting
 
 ## Manifest
 
-`machines.json` is the desired fleet declaration. Current commands:
+`machines.json` is the desired fleet declaration.
 
 ```bash
 machines manifest init
@@ -28,23 +28,41 @@ machines setup --machine spark01 --json
 machines setup --machine spark01 --apply --yes
 machines sync --machine spark01 --json
 machines sync --machine spark01 --apply --yes
+machines doctor --machine spark01
+machines self-test
 ```
 
 ## Applications and tooling
 
 ```bash
-machines apps list --machine apple03 --json
+machines apps list --machine apple03
+machines apps status --machine apple03
+machines apps diff --machine apple03
 machines apps plan --machine apple03 --json
 machines apps apply --machine apple03 --yes
 
-machines install-claude --machine spark01 --json
-machines install-claude --machine spark01 --tool claude codex --apply --yes
+machines install-claude status --machine spark01
+machines install-claude diff --machine spark01
+machines install-claude plan --machine spark01 --tool claude codex --json
+machines install-claude apply --machine spark01 --tool claude codex --yes
 
 machines install-tailscale --machine apple03 --json
+```
+
+## Notifications
+
+```bash
 machines notifications add --id ops --type webhook --target https://example.com/hook --event sync_failed
-machines notifications test --channel ops --json
+machines notifications list
+machines notifications test --channel ops
+machines notifications test --channel ops --apply --yes
+machines notifications dispatch --event manual.test --message "hello fleet"
 ```
 
+- `email` channels deliver through local `sendmail` or `mail` when available
+- `webhook` channels deliver JSON via HTTP POST
+- `command` channels execute the configured command with `HASNA_MACHINES_NOTIFICATION_*` env vars
+
 ## Dashboard
 
 ```bash
@@ -59,6 +77,13 @@ The dashboard exposes:
 - `/api/status` fleet status JSON
 - `/api/manifest` current manifest JSON
 - `/api/notifications` notification channel JSON
+- `/api/doctor` doctor report JSON
+- `/api/self-test` smoke-check JSON
+- `/api/apps/status` app inventory JSON
+- `/api/apps/diff` app drift JSON
+- `/api/install-claude/status` CLI inventory JSON
+- `/api/install-claude/diff` CLI drift JSON
+- `/api/notifications/test` POST endpoint for test delivery
 
 ## Local development
 

package/dist/agent/index.js

@@ -2084,13 +2084,17 @@ var {
 } = import__.default;
 
 // src/version.ts
-import { readFileSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 function getPackageVersion() {
   try {
     const here = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join(here, "..", "package.json");
+    const candidates = [join(here, "..", "package.json"), join(here, "..", "..", "package.json")];
+    const pkgPath = candidates.find((candidate) => existsSync(candidate));
+    if (!pkgPath) {
+      return "0.0.0";
+    }
     return JSON.parse(readFileSync(pkgPath, "utf8")).version || "0.0.0";
   } catch {
     return "0.0.0";
@@ -2104,14 +2108,14 @@ import { hostname } from "os";
 import { createRequire } from "module";
 import { Database } from "bun:sqlite";
 import {
-  existsSync,
+  existsSync as existsSync2,
   mkdirSync,
   readdirSync,
   copyFileSync
 } from "fs";
 import { homedir } from "os";
 import { join as join2, relative } from "path";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { existsSync as existsSync22, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join22 } from "path";
 import { readdirSync as readdirSync2, existsSync as existsSync3 } from "fs";
@@ -11313,7 +11317,7 @@ function getConfigPath() {
   return CONFIG_PATH;
 }
 function getCloudConfig() {
-  if (!existsSync2(CONFIG_PATH)) {
+  if (!existsSync22(CONFIG_PATH)) {
     return CloudConfigSchema.parse({});
   }
   try {