@ze-norm/cli 0.14.1 → 0.14.2

package/dist/commands/interactive-agent.d.ts

@@ -6,7 +6,7 @@ import type { ChildProcess, SpawnOptions } from "node:child_process";
  * the daemon does NOT run the agent headlessly. Instead it launches the active
  * coding agent — Claude Code by default, or Codex when the user runs with
  * `--agent codex` — as a *live interactive session*, seeded with the
- * `/zenorm <specId>` handoff. The agent owns the terminal directly (inherited
+ * harness-native ZeNorm skill handoff. The agent owns the terminal directly (inherited
  * stdio), so the operator works with it interactively until they close it; when
  * the agent exits, the daemon releases the worker and moves on to the next task.
  *

package/dist/commands/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAcA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4F/D"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAcA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F/D"}

package/dist/commands/pull.js

@@ -39,9 +39,11 @@ export async function pullCommand(argv) {
         log.debug("Listing specs to resolve by key", { specRef });
         const { specs } = await client.get("/v1/specs");
         spec = specs.find((s) => s.key === specRef);
-    }
-    if (!spec) {
-        throw new CliError(`Spec "${specRef}" not found by key or id. Run \`zenorm list\` to see available specs.`);
+        if (!spec) {
+            const available = specs.map((s) => s.key).join(", ");
+            throw new CliError(`Spec "${specRef}" not found by key or id.` +
+                (available ? ` Available spec keys: ${available}` : " The workspace has no specs."));
+        }
     }
     // Fetch grilled blocks (goals, constraints, acceptance criteria, tasks).
     let blocksMd = "";

package/dist/commands/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAyOA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/D"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AA2OA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/D"}

package/dist/commands/task.js

@@ -33,7 +33,9 @@ async function resolveSpecId(client, specRef) {
     const { specs } = await client.get("/v1/specs");
     const spec = specs.find((s) => s.key === specRef);
     if (!spec) {
-        throw new CliError(`Spec "${specRef}" not found by key or id. Run \`zenorm list\` to see available specs.`);
+        const available = specs.map((s) => s.key).join(", ");
+        throw new CliError(`Spec "${specRef}" not found by key or id.` +
+            (available ? ` Available spec keys: ${available}` : " The workspace has no specs."));
     }
     return spec.id;
 }

package/dist/commands/work.d.ts

@@ -23,8 +23,9 @@ export interface TaskRunner {
  * Build the handoff prompt that hands the agent the WHOLE SPEC the claimed task
  * belongs to, so a single agent session implements every available task for that
  * spec with shared context — instead of one fresh session per task. The
- * `/zenorm <specId>` trigger is what the `zenorm` dispatcher SKILL.md keys on
- * (spec mode → `execute-task` walks every `planned`/`todo` task in order).
+ * harness-native ZeNorm invocation (`/zenorm` for Claude Code, `$zenorm`
+ * for Codex) triggers the dispatcher in spec mode, where `execute-task` walks
+ * every `planned`/`todo` task in order.
  *
  * The claim only flips THIS one task to `active` server-side (the lease that
  * proves there is work for this repo and guards against a second daemon). The
@@ -35,14 +36,14 @@ export interface TaskRunner {
  *
  * Exported for unit testing.
  */
-export declare function buildHandoffPrompt(task: SpecTaskRecord): string;
+export declare function buildHandoffPrompt(task: SpecTaskRecord, agent: SupportedAgent): string;
 /**
  * The interactive (coding-agent mode) handoff prompt. Same spec-mode handoff as
  * the headless prompt, MINUS the "work non-interactively" instruction: in this
  * mode the agent runs as a live session the operator drives, so it SHOULD pause
  * for input. Exported for unit testing.
  */
-export declare function buildInteractiveHandoffPrompt(task: SpecTaskRecord): string;
+export declare function buildInteractiveHandoffPrompt(task: SpecTaskRecord, agent: SupportedAgent): string;
 /**
  * The headless subprocess invocation for a given agent + task. Pure (no
  * side effects) so it can be unit-tested directly without spawning anything.

package/dist/commands/work.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../src/commands/work.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAC;AAehC;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,8BAA+B,CAAC;AACtD,KAAK,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAuCxD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAeD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAS/D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAG1E;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAwDrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA2BrC;AAQD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,YAAY,KAClB,YAAY,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AAuB5F;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBxE;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,UAAU;IAI1C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAOvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAI5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAM1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAxBnC,SAAgB,SAAS,EAAE,cAAc,CAAC;gBAGvB,KAAK,EAAE,cAAc,EAErB,OAAO,GAAE,OAAe,EAExB,KAAK,CAAC,EAAE,MAAM,YAAA,EAOd,WAAW,UAAQ,EAInB,SAAS,GAAE,WAA2B,EAMtC,eAAe,CAAC,EAAE,iBAAiB,YAAA;IAKtD,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;OAGG;IACH,OAAO,CAAC,WAAW;IAkCnB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAiCtB;;;;;;;;;;;;OAYG;YACW,oBAAoB;IAwClC;;;;OAIG;IACH,OAAO,CAAC,SAAS;CA+ClB;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,UAAU;IAI3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,SAAgB,SAAS,EAAE,cAAc,CAAC;gBAGvB,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE,MAAM,YAAA;IAKjC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAOzC;AAUD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmD3E;AA4BD,UAAU,UAAU;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IAGtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAwFD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GACvC,OAAO,CAGT;AAoED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA2HlB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Df"}
+{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../src/commands/work.ts"],"names":[],"mappings":"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"}

package/dist/commands/work.js

@@ -61,8 +61,9 @@ const AGENT_INSTALL_HINT = {
  * Build the handoff prompt that hands the agent the WHOLE SPEC the claimed task
  * belongs to, so a single agent session implements every available task for that
  * spec with shared context — instead of one fresh session per task. The
- * `/zenorm <specId>` trigger is what the `zenorm` dispatcher SKILL.md keys on
- * (spec mode → `execute-task` walks every `planned`/`todo` task in order).
+ * harness-native ZeNorm invocation (`/zenorm` for Claude Code, `$zenorm`
+ * for Codex) triggers the dispatcher in spec mode, where `execute-task` walks
+ * every `planned`/`todo` task in order.
  *
  * The claim only flips THIS one task to `active` server-side (the lease that
  * proves there is work for this repo and guards against a second daemon). The
@@ -73,10 +74,10 @@ const AGENT_INSTALL_HINT = {
  *
  * Exported for unit testing.
  */
-export function buildHandoffPrompt(task) {
+export function buildHandoffPrompt(task, agent) {
     const zenormCli = process.env["ZENORM_CLI"]?.trim() || "zenorm";
     return [
-        ...handoffPromptBody(task, zenormCli),
+        ...handoffPromptBody(task, zenormCli, agent),
         // Headless runs have no operator to wait on — tell the agent to drive
         // straight through without pausing for input. The interactive variant
         // (buildInteractiveHandoffPrompt) deliberately omits this line.
@@ -89,14 +90,14 @@ export function buildHandoffPrompt(task) {
  * mode the agent runs as a live session the operator drives, so it SHOULD pause
  * for input. Exported for unit testing.
  */
-export function buildInteractiveHandoffPrompt(task) {
+export function buildInteractiveHandoffPrompt(task, agent) {
     const zenormCli = process.env["ZENORM_CLI"]?.trim() || "zenorm";
-    return handoffPromptBody(task, zenormCli).join("\n");
+    return handoffPromptBody(task, zenormCli, agent).join("\n");
 }
 /** Shared spec-mode handoff lines for both the headless and interactive prompts. */
-function handoffPromptBody(task, zenormCli) {
+function handoffPromptBody(task, zenormCli, agent) {
     return [
-        `/zenorm ${task.specId}`,
+        buildSkillInvocation(agent, task.specId),
         "",
         `Execute ALL available tasks for ZeNorm spec ${task.specId} in THIS one`,
         "session (spec mode — walk every `planned`/`todo` task in list order). Do not",
@@ -112,6 +113,19 @@ function handoffPromptBody(task, zenormCli) {
         `\`${zenormCli} task complete <task-id>\` flow as you finish it.`,
     ];
 }
+/** Build the explicit skill invocation understood by the selected harness. */
+function buildSkillInvocation(agent, specId) {
+    switch (agent) {
+        case "claude":
+            return `/zenorm ${specId}`;
+        case "codex":
+            return `$zenorm ${specId}`;
+        default: {
+            const never = agent;
+            throw new CliError(`No ZeNorm skill invocation defined for agent "${String(never)}".`);
+        }
+    }
+}
 /**
  * The headless subprocess invocation for a given agent + task. Pure (no
  * side effects) so it can be unit-tested directly without spawning anything.
@@ -125,7 +139,7 @@ function handoffPromptBody(task, zenormCli) {
  * Exported for unit testing.
  */
 export function buildAgentCommand(agent, task, model) {
-    const prompt = buildHandoffPrompt(task);
+    const prompt = buildHandoffPrompt(task, agent);
     switch (agent) {
         case "claude":
             // stream-json requires --verbose; it does NOT make the transcript verbose
@@ -208,7 +222,7 @@ export function buildAgentCommand(agent, task, model) {
  * Exported for unit testing.
  */
 export function buildInteractiveAgentCommand(agent, task, model) {
-    const prompt = buildInteractiveHandoffPrompt(task);
+    const prompt = buildInteractiveHandoffPrompt(task, agent);
     switch (agent) {
         case "claude":
             return {

package/dist/zenorm-skills/skills/zenorm/SKILL.md

@@ -2,9 +2,11 @@
 name: zenorm
 description: >-
   Dispatcher for explicit ZeNorm spec-driven work. Use when the user invokes
-  `/zenorm ...`, or explicitly asks to execute, implement, run, continue, or
-  sync a ZeNorm spec or task — e.g. "implement spec AUTH-123", "run this
-  ZeNorm spec", "continue spec Z-9", "do ZeNorm task <uuid>", "sync zenorm",
+  the harness-native ZeNorm skill command (`/zenorm ...` in Claude Code,
+  `$zenorm ...` in Codex, or `@zenorm ...` in Cursor), or explicitly asks to
+  execute, implement, run, continue, or sync a ZeNorm spec or task — e.g.
+  "implement spec AUTH-123", "run this ZeNorm spec", "continue spec Z-9",
+  "do ZeNorm task UUID", "sync zenorm",
   "wrap up the ZeNorm session". It routes to the right focused skill:
   full-spec execution, single-task execution, or session sync-back, and owns
   the session id and the final outcome flush. Do NOT trigger merely because a
@@ -20,7 +22,8 @@ child skills rely on: the **session id** and the **single final sync**.
 
 ## Routing
 
-`$ARGUMENTS` is everything after `/zenorm`. Run the resolver — it strips
+`$ARGUMENTS` is everything after the harness-native skill invocation
+(`/zenorm`, `$zenorm`, or `@zenorm`). Run the resolver — it strips
 verbs, classifies the target, and resolves spec keys of ANY shape (code,
 slug, or UUID) against the CLI so you do not guess:
 
@@ -42,7 +45,7 @@ for looking unfamiliar. The resolver already checked it against the CLI.
 
 The `--dispatched` flag tells `execute-task` that *you* (the dispatcher) own
 the final `zenorm-sync`, so it will not run its own. This keeps sync
-single-owner: exactly one sync per `/zenorm` invocation, no double posts. (If
+single-owner: exactly one sync per ZeNorm skill invocation, no double posts. (If
 a user runs `execute-task` directly without going through you, it has no
 `--dispatched` flag and syncs itself — that path stays correct too.)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ze-norm/cli",
   "private": false,
-  "version": "0.14.1",
+  "version": "0.14.2",
   "license": "SEE LICENSE IN README.md",
   "type": "module",
   "repository": {