sisyphi 1.2.18 → 1.2.19

package/dist/daemon.js

@@ -1058,6 +1058,31 @@ var init_spawn_helpers = __esm({
   }
 });
 
+// src/cli/help-rubric.ts
+var ROOT_AFTER_HELP;
+var init_help_rubric = __esm({
+  "src/cli/help-rubric.ts"() {
+    "use strict";
+    ROOT_AFTER_HELP = `
+I/O contract: flags and positional args on input, JSON on stdout (JSONL for streams).
+
+Exit codes:
+  0   success
+  1   permanent error (fallback)
+  2   usage error (bad args/shape)
+  3   not found
+  4   ambiguous (multiple matches \u2014 see error.candidates)
+  5   conflict (already-exists, wrong-state)
+  60  transient (retry-safe: daemon down, timeout, lock contention)
+
+Errors:
+  {"ok": false,
+   "error": {"code": "<stable-enum>", "kind": "<usage|not_found|ambiguous|conflict|transient|permanent>",
+             "message": "...", "received"?: ..., "expected"?: ..., "next"?: "...", "candidates"?: [...]}}
+`;
+  }
+});
+
 // src/daemon/help-inject.ts
 import { execSync } from "child_process";
 function injectHelp(text) {
@@ -1078,6 +1103,12 @@ function injectHelp(text) {
   };
   return text.replace(/\{\{HELP:([^}]+)\}\}/g, (_m, cmd) => {
     const c = cmd.trim();
+    if (c === ".") {
+      const root = renderHelp("").replace(ROOT_AFTER_HELP.trim(), "").trimEnd();
+      return `<cli-guide bash="sis -h">
+${root}
+</cli-guide>`;
+    }
     return `<cli-guide bash="sis ${c} -h">
 ${renderHelp(c)}
 </cli-guide>`;
@@ -1087,6 +1118,7 @@ var init_help_inject = __esm({
   "src/daemon/help-inject.ts"() {
     "use strict";
     init_spawn_helpers();
+    init_help_rubric();
   }
 });