@try-works/dsh-recursive-mode 0.4.5 → 0.4.7

package/lib/errors.d.ts

@@ -61,12 +61,30 @@ export declare const TOOL_ERRORS: {
         readonly problem: "this gate has no default artifact, so one must be named";
         readonly next: "pass artifact: <file> so the answer has somewhere durable to land";
     };
+    readonly RELAY_ONLY_FOR_RUN_START: {
+        readonly code: "RM1150";
+        readonly klass: "input";
+        readonly problem: "relay applies only to the run-start gate, which is the only gate that asks the user-questions channel";
+        readonly next: "drop relay for this gate and answer it with one of its own labels, or call recursive_ask with gate: run-start when the decision is whether to start the run";
+    };
     readonly MISSING_RUN_ID: {
         readonly code: "RM1101";
         readonly klass: "input";
         readonly problem: "runId is required";
         readonly next: "call recursive_status with no runId to see the latest run id in this workspace";
     };
+    /**
+     * A run id is the NAME of the run directory and is joined onto the run layer
+     * as one path segment, so a path-shaped id is refused before any directory is
+     * created. See `run-id.ts` for the rule and for why it is not the runtime that
+     * learns to accept a path.
+     */
+    readonly BAD_RUN_ID: {
+        readonly code: "RM1107";
+        readonly klass: "input";
+        readonly problem: "runId is not a single directory name";
+        readonly next: "pass the run directory name such as 03-something, then call recursive_init again";
+    };
     readonly MISSING_ARTIFACT: {
         readonly code: "RM1102";
         readonly klass: "input";
@@ -133,18 +151,46 @@ export declare const TOOL_ERRORS: {
         readonly problem: "the run has unresolved delegated work, so this phase cannot lock yet";
         readonly next: "call recursive_status to see the pending delegation, have the child write its reply.md, then lock again";
     };
+    /**
+     * THE ORDERING DEFECT, AS A CODE. `recursive_ask gate=run-start` used to raise "start this run or hold?"
+     * over a Phase 0 document that was still the scaffold `recursive_init` wrote — placeholder requirements,
+     * unchecked lists, `FAIL` gates — and nothing put that document in front of the person either. The owner:
+     * *"i was never shown the spec before that so how could i approve if i havent seen it"*. Approving an
+     * unfilled template is not a decision about a spec, so the gate refuses to be raised until there is one.
+     */
+    readonly RUN_START_SPEC_UNFILLED: {
+        readonly code: "RM4404";
+        readonly klass: "state";
+        readonly problem: "the Phase 0 requirements document is still the unfilled template, so there is no run spec for a person to approve";
+        readonly next: "fill the requirements document in (define the requirement ids and their acceptance criteria, and complete the TODO list) and then call recursive_ask with gate: run-start again";
+    };
     readonly RUN_START_NO_CHANNEL: {
         readonly code: "RM5502";
         readonly klass: "runtime";
         readonly problem: "the run-start gate needs an answer, and this composition mounts no user-questions channel to ask one directly";
         readonly next: string;
     };
+    /**
+     * ⚠ RM5503 USED TO LIE. Its text asserted "so no person was asked" for EVERY cause, because the caller
+     * that produced it had already thrown the cause away — and a live session showed the cost: the gate
+     * failed 22.9 s into the call with a reason nobody could see, and its `Next:` clause prescribed the very
+     * call that had just failed, so no route to start a run remained. The problem statement now claims only
+     * what the gate knows (no decision came back), and the cause travels in the `detail` the caller
+     * supplies. `RUN_START_ANSWER_UNUSABLE` carries the one case this entry must NOT cover: a person was
+     * reached and their answer was not an approval.
+     */
     readonly RUN_START_UNANSWERED: {
         readonly code: "RM5503";
         readonly klass: "runtime";
-        readonly problem: "the user-questions channel mounted in this composition refused the run-start question, so no person was asked";
+        readonly problem: "the run-start question reached no decision: the mounted user-questions channel failed before a person answered it";
         readonly next: string;
     };
+    readonly RUN_START_ANSWER_UNUSABLE: {
+        readonly code: "RM5504";
+        readonly klass: "runtime";
+        readonly problem: "a person was asked to start this run and their answer was not one of the labels the run-start gate offered";
+        readonly next: "call recursive_ask again and have the person choose exactly \"Start run\" or \"Hold\"; a skipped or custom answer is not an approval, and no relayed answer can replace a decision the person made";
+    };
     readonly RUNTIME_REFUSED: {
         readonly code: "RM5501";
         readonly klass: "runtime";