npm - @hacksmith/doraval - Versions diffs - 0.2.45 → 0.2.46 - Mend

@hacksmith/doraval 0.2.45 → 0.2.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -1,10 +1,14 @@
 # doraval
-The context engineering toolkit for coding agents.
+The context engineering toolkit for coding agent orchestrators.
-If you've ever shipped a Claude Code skill that stopped firing after a refactor, or wondered whether your plugin's structure actually matches what the agent expects — doraval validates that before it becomes a runtime surprise.
+If you're a senior engineer handing skills to new team members, a company publishing AI resources, or anyone who wants agents (and humans) to succeed on the first attempt instead of after days of debugging — this is for you.
-> **Quick start:**
+**The orchestrator problem:** Give 10 new engineers (or agents) a skill and only 3/10 succeed on the first try. 4/10 take hours. 7/10 take a day. 10/10 take days.
+doraval helps you **left-shift success** — validate, scaffold, and manage context so the first attempt works across Claude, Cursor, Codex, Copilot, and whatever comes next.
+> **Quick start (left-shift success in < 2 minutes):**
 > ```bash
 > # macOS
 > brew install saif-shines/tap/doraval
@@ -14,7 +18,7 @@ If you've ever shipped a Claude Code skill that stopped firing after a refactor,
 > npx @hacksmith/doraval validate .
 > ```
-Point it at any local directory or GitHub URL. It auto-detects what you have and tells you what's broken.
+Validate before you hand a skill to a new engineer or publish it. It auto-detects issues across agents and tells you what's broken.
 ## Install

package/bin/doraval.js CHANGED Viewed

@@ -599,7 +599,7 @@ var init_dist = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hacksmith/doraval",
-    version: "0.2.45",
+    version: "0.2.46",
     author: "Saif",
     repository: {
       type: "git",
@@ -612,7 +612,7 @@ var require_package = __commonJS((exports, module) => {
       doraval: "bin/doraval-wrapper.js",
       dora: "bin/doraval-wrapper.js"
     },
-    description: "The context engineering toolkit for coding agents",
+    description: "The context engineering toolkit for coding agent orchestrators",
     engines: {
       bun: ">=1.2.0",
       node: ">=14.18.0"
@@ -4457,8 +4457,8 @@ async function killPort(port) {
     await new Promise((r) => setTimeout(r, 400));
   } catch {}
 }
-function readPid() {
-  const file = getPidFile();
+function readPid(p) {
+  const file = getPidFile(p);
   if (!existsSync19(file))
     return null;
   try {
@@ -4475,14 +4475,14 @@ function readPid() {
     return null;
   }
 }
-function writePid(pid) {
+function writePid(pid, p) {
   ensureDoravalDirs();
-  writeFileSync6(getPidFile(), String(pid) + `
+  writeFileSync6(getPidFile(p), String(pid) + `
 `);
 }
-function removePid() {
+function removePid(p) {
   try {
-    unlinkSync2(getPidFile());
+    unlinkSync2(getPidFile(p));
   } catch {}
 }
 async function getDashboardHtml() {
@@ -4495,7 +4495,7 @@ async function getDashboardHtml() {
     return `<!doctype html><meta charset="utf-8"><body style="font-family:monospace;background:#111;color:#ddd;padding:2rem"><h1>doraval ui</h1><p>Dashboard HTML missing.</p><pre>${String(err)}</pre></body>`;
   }
 }
-var import_picocolors16, DEFAULT_PORT = 3737, getPidFile = () => join18(getDoravalDir(), "ui.pid"), ui_default;
+var import_picocolors16, DEFAULT_PORT = 3737, getPidFile = (p) => join18(getDoravalDir(), `ui.${p}.pid`), ui_default;
 var init_ui = __esm(() => {
   init_journal_config();
   init_journal_parse();
@@ -4510,7 +4510,7 @@ var init_ui = __esm(() => {
       const showStatusOnly = !!args.status;
       const force = !!args.force;
       ensureDoravalDirs();
-      const existingPid = readPid();
+      const existingPid = readPid(port);
       if (showStatusOnly) {
         if (existingPid) {
           const url2 = `http://${host === "0.0.0.0" ? "localhost" : host}:${port}`;
@@ -4539,7 +4539,7 @@ var init_ui = __esm(() => {
           process.kill(existingPid, "SIGTERM");
         } catch {}
         await new Promise((r) => setTimeout(r, 400));
-        removePid();
+        removePid(port);
       } else if (!existingPid) {
         await killPort(port);
       }
@@ -4552,106 +4552,113 @@ var init_ui = __esm(() => {
           project = undefined;
         }
       }
-      const server = Bun.serve({
-        port,
-        hostname: host,
-        async fetch(req) {
-          const url2 = new URL(req.url);
-          if (url2.pathname === "/" || url2.pathname === "/index.html") {
-            const html = await getDashboardHtml();
-            return new Response(html, {
-              headers: { "content-type": "text/html; charset=utf-8" }
-            });
-          }
-          if (url2.pathname === "/api/status") {
-            return Response.json({
-              project: project || null,
-              doravalDir: getJournalsDir(),
-              hasConfig: !!config,
-              repo: config?.journal?.repo ?? null
-            });
-          }
-          if (url2.pathname === "/api/entries") {
-            const { committed, staged } = await loadAllEntries(project || null);
-            return Response.json({ project, committed, staged });
-          }
-          if (url2.pathname === "/api/context") {
-            const { committed, staged } = await loadAllEntries(project || null);
-            const all = [...staged, ...committed].filter((e) => (e.status || "active") === "active");
-            const text = generateJournalContext(all, project || null, { minPushback: 1 });
-            return Response.json({ text, project });
-          }
-          if (url2.pathname === "/api/hooks/status" && req.method === "GET") {
-            const localPath = getLocalHooksPath();
-            const globalPath = getGlobalSettingsPath();
-            const localHas = hasHook(await readJson(localPath));
-            const globalHas = hasHook(await readJson(globalPath));
-            return Response.json({
-              local: { enabled: localHas, path: localPath },
-              global: { enabled: globalHas, path: globalPath }
-            });
-          }
-          if (url2.pathname === "/api/hooks/enable" && req.method === "POST") {
-            const body = await req.json().catch(() => ({}));
-            const useGlobal = !!body.global;
-            const target = useGlobal ? getGlobalSettingsPath() : getLocalHooksPath();
-            const res = await addHook(target);
-            return Response.json(res);
-          }
-          if (url2.pathname === "/api/hooks/disable" && req.method === "POST") {
-            const body = await req.json().catch(() => ({}));
-            const useGlobal = !!body.global;
-            const target = useGlobal ? getGlobalSettingsPath() : getLocalHooksPath();
-            const res = await removeHook(target);
-            return Response.json(res);
-          }
-          if (url2.pathname === "/api/add" && req.method === "POST") {
-            if (!project) {
-              return Response.json({ error: "No project configured. Run dora init or dora journal init first." }, { status: 400 });
+      let server;
+      try {
+        server = Bun.serve({
+          port,
+          hostname: host,
+          async fetch(req) {
+            const url2 = new URL(req.url);
+            if (url2.pathname === "/" || url2.pathname === "/index.html") {
+              const html = await getDashboardHtml();
+              return new Response(html, {
+                headers: { "content-type": "text/html; charset=utf-8" }
+              });
             }
-            const body = await req.json();
-            const title = String(body.title || "Untitled decision").trim();
-            const pushback = Number(body.pushback ?? 4);
-            const tags = Array.isArray(body.tags) ? body.tags.map((t) => String(t).trim()).filter(Boolean) : [];
-            const rationale = String(body.rationale || title).trim();
-            try {
-              const result = await writePendingEntry(project, { title, pushback, tags, rationale });
-              return Response.json({ ok: true, ...result });
-            } catch (e) {
-              return Response.json({ error: e.message }, { status: 500 });
+            if (url2.pathname === "/api/status") {
+              return Response.json({
+                project: project || null,
+                doravalDir: getJournalsDir(),
+                hasConfig: !!config,
+                repo: config?.journal?.repo ?? null
+              });
             }
-          }
-          if (url2.pathname === "/api/refresh" && req.method === "POST") {
-            const { committed, staged } = await loadAllEntries(project || null);
-            return Response.json({ ok: true, committed, staged });
-          }
-          if (url2.pathname === "/api/delete-staged" && req.method === "POST") {
-            if (!project) {
-              return Response.json({ error: "No project" }, { status: 400 });
+            if (url2.pathname === "/api/entries") {
+              const { committed, staged } = await loadAllEntries(project || null);
+              return Response.json({ project, committed, staged });
+            }
+            if (url2.pathname === "/api/context") {
+              const { committed, staged } = await loadAllEntries(project || null);
+              const all = [...staged, ...committed].filter((e) => (e.status || "active") === "active");
+              const text = generateJournalContext(all, project || null, { minPushback: 1 });
+              return Response.json({ text, project });
+            }
+            if (url2.pathname === "/api/hooks/status" && req.method === "GET") {
+              const localPath = getLocalHooksPath();
+              const globalPath = getGlobalSettingsPath();
+              const localHas = hasHook(await readJson(localPath));
+              const globalHas = hasHook(await readJson(globalPath));
+              return Response.json({
+                local: { enabled: localHas, path: localPath },
+                global: { enabled: globalHas, path: globalPath }
+              });
             }
-            const body = await req.json().catch(() => ({}));
-            const filename = body.filename;
-            if (!filename) {
-              return Response.json({ error: "filename required" }, { status: 400 });
+            if (url2.pathname === "/api/hooks/enable" && req.method === "POST") {
+              const body = await req.json().catch(() => ({}));
+              const useGlobal = !!body.global;
+              const target = useGlobal ? getGlobalSettingsPath() : getLocalHooksPath();
+              const res = await addHook(target);
+              return Response.json(res);
             }
-            const pdir = getPendingProjectDir(project);
-            const filePath = join18(pdir, filename);
-            if (existsSync19(filePath)) {
+            if (url2.pathname === "/api/hooks/disable" && req.method === "POST") {
+              const body = await req.json().catch(() => ({}));
+              const useGlobal = !!body.global;
+              const target = useGlobal ? getGlobalSettingsPath() : getLocalHooksPath();
+              const res = await removeHook(target);
+              return Response.json(res);
+            }
+            if (url2.pathname === "/api/add" && req.method === "POST") {
+              if (!project) {
+                return Response.json({ error: "No project configured. Run dora init or dora journal init first." }, { status: 400 });
+              }
+              const body = await req.json();
+              const title = String(body.title || "Untitled decision").trim();
+              const pushback = Number(body.pushback ?? 4);
+              const tags = Array.isArray(body.tags) ? body.tags.map((t) => String(t).trim()).filter(Boolean) : [];
+              const rationale = String(body.rationale || title).trim();
               try {
-                await Bun.file(filePath).unlink();
-              } catch {}
-              return Response.json({ ok: true });
+                const result = await writePendingEntry(project, { title, pushback, tags, rationale });
+                return Response.json({ ok: true, ...result });
+              } catch (e) {
+                return Response.json({ error: e.message }, { status: 500 });
+              }
             }
-            return Response.json({ error: "not found" }, { status: 404 });
-          }
-          if (url2.pathname.startsWith("/api/")) {
-            return Response.json({ error: "Not found" }, { status: 404 });
+            if (url2.pathname === "/api/refresh" && req.method === "POST") {
+              const { committed, staged } = await loadAllEntries(project || null);
+              return Response.json({ ok: true, committed, staged });
+            }
+            if (url2.pathname === "/api/delete-staged" && req.method === "POST") {
+              if (!project) {
+                return Response.json({ error: "No project" }, { status: 400 });
+              }
+              const body = await req.json().catch(() => ({}));
+              const filename = body.filename;
+              if (!filename) {
+                return Response.json({ error: "filename required" }, { status: 400 });
+              }
+              const pdir = getPendingProjectDir(project);
+              const filePath = join18(pdir, filename);
+              if (existsSync19(filePath)) {
+                try {
+                  await Bun.file(filePath).unlink();
+                } catch {}
+                return Response.json({ ok: true });
+              }
+              return Response.json({ error: "not found" }, { status: 404 });
+            }
+            if (url2.pathname.startsWith("/api/")) {
+              return Response.json({ error: "Not found" }, { status: 404 });
+            }
+            return new Response("Not found", { status: 404 });
           }
-          return new Response("Not found", { status: 404 });
-        }
-      });
+        });
+      } catch (err) {
+        removePid(port);
+        console.error(`  Failed to start dashboard on port ${port}: ${err?.message || err}`);
+        process.exit(1);
+      }
       const url = `http://${host === "0.0.0.0" ? "localhost" : host}:${server.port}`;
-      writePid(process.pid);
+      writePid(process.pid, port);
       const msg = `
   ${import_picocolors16.default.blue("\u25C9")}  dora local dashboard
   ${import_picocolors16.default.dim("Project:")} ${project ? import_picocolors16.default.white(project) : import_picocolors16.default.yellow("none (run dora init)")}
@@ -4669,7 +4676,7 @@ var init_ui = __esm(() => {
         }
       }
       const cleanup = () => {
-        removePid();
+        removePid(port);
         console.error(`
   Stopping dashboard...`);
         server.stop();
@@ -8085,7 +8092,7 @@ var main = defineCommand({
   meta: {
     name: "doraval",
     version: import__package.default.version,
-    description: "The context engineering toolkit for coding agents"
+    description: "The context engineering toolkit for coding agent orchestrators"
   },
   subCommands: {
     validate: () => Promise.resolve().then(() => (init_validate_top(), exports_validate_top)).then((m) => m.default),

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@hacksmith/doraval",
-  "version": "0.2.45",
+  "version": "0.2.46",
   "author": "Saif",
   "repository": {
     "type": "git",
@@ -13,7 +13,7 @@
     "doraval": "bin/doraval-wrapper.js",
     "dora": "bin/doraval-wrapper.js"
   },
-  "description": "The context engineering toolkit for coding agents",
+  "description": "The context engineering toolkit for coding agent orchestrators",
   "engines": {
     "bun": ">=1.2.0",
     "node": ">=14.18.0"