@yagni-app/code-staging 1.1.2-staging.1365.1 → 1.1.2-staging.1368.1

package/dist/extension/decisionRubric.d.ts

@@ -15,6 +15,17 @@ export declare const DECISION_KIND_DESCRIPTION: string;
 export declare const RECORD_WHEN: string;
 /** When not to: the negative half, one sentence. */
 export declare const RECORD_NEVER: string;
-/** The rubric as one paragraph for persona bodies and task templates. */
-export declare const RECORD_DECISION_RUBRIC = "Record a decision only when it is consequential: a product-intent, architecture, or team-convention call that another engineer would need to know and that is not already written down, especially one a human just settled by answering a question or correcting you. Never record taste, styling, naming of a local variable, formatting, a workaround, a restatement of the code change, or anything the user is still experimenting with; when in doubt, do not record it.";
+/**
+ * How the decision text itself must read. The ledger shows the decision as
+ * the headline and the question beneath it, so an answer-shaped decision
+ * ("No. Surface the decline.") reads as a fragment on every surface that
+ * renders it.
+ */
+export declare const DECISION_STATEMENT: string;
+/**
+ * The rubric as one paragraph for persona bodies and task templates: when,
+ * never, and how the decision text must read, so every surface that records
+ * a decision produces one the headline-first ledger can render whole.
+ */
+export declare const RECORD_DECISION_RUBRIC = "Record a decision only when it is consequential: a product-intent, architecture, or team-convention call that another engineer would need to know and that is not already written down, especially one a human just settled by answering a question or correcting you. Never record taste, styling, naming of a local variable, formatting, a workaround, a restatement of the code change, or anything the user is still experimenting with; when in doubt, do not record it. Write the decision as a standalone statement that reads without the question: name the subject and what was chosen (\"Checkout surfaces a declined card to the customer instead of retrying it\"), never a bare yes or no or an answer that only makes sense under the question.";
 //# sourceMappingURL=decisionRubric.d.ts.map

package/dist/extension/decisionRubric.js

@@ -21,6 +21,20 @@ export const RECORD_WHEN = "Record a decision only when it is consequential: a p
 export const RECORD_NEVER = "Never record taste, styling, naming of a local variable, formatting, a workaround, " +
     "a restatement of the code change, or anything the user is still experimenting with; " +
     "when in doubt, do not record it.";
-/** The rubric as one paragraph for persona bodies and task templates. */
-export const RECORD_DECISION_RUBRIC = `${RECORD_WHEN} ${RECORD_NEVER}`;
+/**
+ * How the decision text itself must read. The ledger shows the decision as
+ * the headline and the question beneath it, so an answer-shaped decision
+ * ("No. Surface the decline.") reads as a fragment on every surface that
+ * renders it.
+ */
+export const DECISION_STATEMENT = "Write the decision as a standalone statement that reads without the question: name " +
+    "the subject and what was chosen (\"Checkout surfaces a declined card to the customer " +
+    "instead of retrying it\"), never a bare yes or no or an answer that only makes sense " +
+    "under the question.";
+/**
+ * The rubric as one paragraph for persona bodies and task templates: when,
+ * never, and how the decision text must read, so every surface that records
+ * a decision produces one the headline-first ledger can render whole.
+ */
+export const RECORD_DECISION_RUBRIC = `${RECORD_WHEN} ${RECORD_NEVER} ${DECISION_STATEMENT}`;
 //# sourceMappingURL=decisionRubric.js.map

package/dist/extension/recordDecisionTool.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { Type } from "typebox";
-import { DECISION_KIND_DESCRIPTION, RECORD_NEVER, RECORD_WHEN, } from "./decisionRubric.js";
+import { DECISION_KIND_DESCRIPTION, DECISION_STATEMENT, RECORD_NEVER, RECORD_WHEN, } from "./decisionRubric.js";
 import { consumeFlywheelAttribution } from "./flywheel.js";
 import { sendOrSpool } from "./spool.js";
 /**
@@ -31,7 +31,7 @@ export async function recordDecision(opts, params, signal) {
 }
 const parameters = Type.Object({
     question: Type.String({ description: "The question that was decided, as another engineer would ask it." }),
-    decision: Type.String({ description: "The answer or direction taken." }),
+    decision: Type.String({ description: `The direction taken. ${DECISION_STATEMENT}` }),
     kind: Type.Union([Type.Literal("product"), Type.Literal("architecture"), Type.Literal("convention")], { description: `What sort of call this is: ${DECISION_KIND_DESCRIPTION}.` }),
     rationale: Type.String({ description: "Why: the durable reasoning a teammate would want six months later." }),
     repo: Type.Optional(Type.String()),
@@ -60,6 +60,7 @@ export function makeRecordDecisionTool(opts) {
             RECORD_WHEN,
             RECORD_NEVER,
             "Record the durable decision and its 'why', not a restatement of the code change; name its kind honestly.",
+            DECISION_STATEMENT,
         ],
         parameters,
         async execute(_toolCallId, params, signal, onUpdate, _ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagni-app/code-staging",
-  "version": "1.1.2-staging.1365.1",
+  "version": "1.1.2-staging.1368.1",
   "description": "YAGNI Code: a terminal coding agent that already knows your company. One YAGNI login routes the model and grounds the agent in your team's context.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "YAGNI, Inc. <jack@yagni.app> (https://yagni.app)",
@@ -58,5 +58,5 @@
     "turndown": "^7.2.4",
     "typebox": "^1.3.15"
   },
-  "yagniSourceSha": "696c88e118688cb45dca88c0b821ff90e1db2c4c"
+  "yagniSourceSha": "a5f338426410c8549a0b85f6e0ac39fd3fdd3e78"
 }