@intentius/chant 0.106.4 → 0.107.1

package/src/op/types.ts

@@ -9,6 +9,7 @@ import type { EffectReceiptRef } from "./receipt-store";
 import type { ActivityProfileName } from "./activity-profiles";
 import type { StepOutputRef } from "./step-output-ref";
 import type { GateApproval } from "./gate-approval";
+import type { GatePoint } from "./gate-point";
 
 export interface OpConfig {
   /** Kebab-case identifier. Names the Op's output directory (`dist/ops/<name>/`), and is the name `chant run <name>` and another Op's `depends` refer to. */
@@ -276,6 +277,16 @@ export interface GateStepBase {
    * `./gate-approval.ts`.
    */
   approval?: GateApproval;
+  /**
+   * A declared decision point this gate asks (#3170), by name or as a
+   * {@link GatePoint}. Reaching the gate asks the point: its deciders and
+   * quorum decide, the answer is an answer record, and `chant workspace
+   * points answer` answers an open question. The run passes the gate on an
+   * answer in `pass`, and the resolution it writes cites the record. A gate
+   * with a point takes no `approval`: the point's quorum is the gate's. See
+   * `./gate-point.ts`.
+   */
+  point?: string | GatePoint;
 }
 
 /**

package/src/workspace/status-gates.ts

@@ -72,8 +72,18 @@ export interface StatusGate {
    * `--sign`. Null when any approval counts.
    */
   signed: { class: string | null } | null;
-  /** The command that approves it, run in the member's directory. */
+  /**
+   * The command that approves it, run in the member's directory. For a gate
+   * that asks a decision point (#3170), the `chant workspace points answer`
+   * line for its open question.
+   */
   approve: string;
+  /**
+   * The open question the gate waits on, when it asks a decision point
+   * (#3170): the point, the answer record's id and its path. Absent on a
+   * gate `chant approve` passes.
+   */
+  answer?: { point: string; id: string; path: string };
 }
 
 /** The rule for a gate, by name, as `identity.gates` at base sets it (#3163). Null when it sets none. */
@@ -171,7 +181,8 @@ function decide(component: string, standing: PendingGateRecord, all: GateResolut
     approvals: approvals.map(approvalOf),
     needed,
     signed: rule === null ? null : { class: rule.requirement.class },
-    approve: approveCommand(component, gate, env, planDigest, rule !== null),
+    approve: standing.answer ? `chant workspace points answer ${standing.answer.id} --answer <value> --by <name>` : approveCommand(component, gate, env, planDigest, rule !== null),
+    ...(standing.answer ? { answer: { point: standing.answer.point, id: standing.answer.id, path: standing.answer.path } } : {}),
   };
 }
 

package/src/workspace/status.schema.json

@@ -848,7 +848,17 @@
             }
           ]
         },
-        "approve": { "type": "string", "description": "The chant approve line for the gate, run in the member's directory: chant approve <component> <gate>, with --env <env> when env is not null and --plan <planDigest> when planDigest is not null (#2832), so the line approves the plan this read showed, and --sign when signed is not null (#3163). The caller adds --actor <principal>." }
+        "approve": { "type": "string", "description": "The chant approve line for the gate, run in the member's directory: chant approve <component> <gate>, with --env <env> when env is not null and --plan <planDigest> when planDigest is not null (#2832), so the line approves the plan this read showed, and --sign when signed is not null (#3163). The caller adds --actor <principal>. For a gate that asks a decision point (#3170), the chant workspace points answer line for the question in answer." },
+        "answer": {
+          "type": "object",
+          "description": "The open question the gate waits on, when it asks a decision point (#3170): absent on a gate chant approve passes. Answered with chant workspace points answer <id>; the run that passes the gate then cites the answer record on the ledger.",
+          "required": ["point", "id", "path"],
+          "properties": {
+            "point": { "type": "string" },
+            "id": { "type": "string", "description": "The answer record's id." },
+            "path": { "type": "string", "description": "The answer record, from the repository root." }
+          }
+        }
       }
     },
     "environment": {