@koda-sl/baker-cli 0.277.0-dev.b34dd6132 → 0.277.0-dev.fc47c292d

package/README.md

@@ -1560,8 +1560,8 @@ and how outcomes travel back to the ad platforms. Their answers add up to one Op
 **The agent proposes; a person answers.** Use this when the client has *already* told us something
 the assessment asks about — a call transcript, an architecture document, a security questionnaire, a
 thread — so nobody is asked twice for something they already said. A proposal carries the sentence it
-came from, is never scored, never counts as progress, and sits on the client's Readiness page until
-somebody accepts or corrects it.
+came from, is never scored, never counts as progress, and reaches the client's Readiness page only
+when the Session publishes, where somebody accepts or corrects it.
 
 #### `baker readiness questions`
 
@@ -1583,7 +1583,7 @@ Propose one answer.
 ```bash
 baker readiness suggest --question B2.6 --value drops-fixable \
   --quote "Unknown fields get dropped today, but Luisa can add them to the schema in a sprint" \
-  --said-by "Ana (client)" --source "Discovery call, 12 March" --confidence stated
+  --said-by "Ana (client)" --source-kind call --source "Discovery call, 12 March" --confidence stated
 ```
 
 | Flag | Required | |
@@ -1592,13 +1592,16 @@ baker readiness suggest --question B2.6 --value drops-fixable \
 | `--value` | | Option value for a one-answer question, or their own words for a written one |
 | `--selections` | | Option values for a multi-select, comma separated |
 | `--other-text` | | Free text for the option that opens a box; only valid when that option is chosen |
+| `--owner` | | Who owns it on their side; only the four questions that ask accept one |
 | `--quote` | yes | Their sentence, verbatim |
-| `--said-by` | yes | Who said it — a transcript carries both sides, and ours is not their answer |
+| `--said-by` | | Who said it |
+| `--source-kind` | yes | `call`, `document`, `message`, `email`, `crm`, `site` |
 | `--source` | yes | How a person would name it: "Call with Marc, 12 March" |
+| `--source-url` | | A link a reviewer can open |
 | `--confidence` | yes | `stated` (they said this) or `implied` (you are inferring it) |
 
-Proposing twice against the same question replaces the first. A batch read wrong is cleared from the
-Readiness page in one click.
+Proposing twice against the same question replaces the first. Staged proposals are reversed by
+discarding the Session.
 
 #### `baker readiness status`
 

package/dist/cli.js

@@ -6409,6 +6409,7 @@ var marketplaceRemoveResponseSchema = z19.object({
 
 // ../api/src/readiness.ts
 import { z as z20 } from "zod";
+var READINESS_SOURCE_KINDS = ["call", "document", "message", "email", "crm", "site"];
 var READINESS_CONFIDENCES = ["stated", "implied"];
 var readinessQuestionsRequestSchema = z20.strictObject({
   /** One section, or every section when omitted. */
@@ -6445,28 +6446,26 @@ var readinessSuggestRequestSchema = z20.strictObject({
   selections: z20.array(z20.string().min(1)).optional(),
   /** What they typed into an option that opens a box. */
   otherText: z20.string().min(1).optional(),
+  /** Whoever on their side owns this, when the question asks. */
+  owner: z20.string().min(1).optional(),
   quote: z20.string().min(1),
-  /**
-   * Who said it. Required, not optional: a transcript carries both sides, and
-   * ours is not an answer — "we would need write access", said by us, becomes
-   * the client's consent the moment it is recorded as one. Nothing in the text
-   * can tell the two apart, so the only defence is making the agent name the
-   * speaker every time.
-   */
-  saidBy: z20.string().min(1),
+  /** Who said it. A transcript carries both sides, and ours is not an answer. */
+  saidBy: z20.string().min(1).optional(),
+  sourceKind: z20.enum(READINESS_SOURCE_KINDS),
   /** How a person would name it: "Call with Marc, 12 March". */
   source: z20.string().min(1),
+  sourceUrl: z20.string().url().optional(),
   confidence: z20.enum(READINESS_CONFIDENCES)
 });
 var readinessSuggestResponseSchema = z20.object({
   questionId: z20.string(),
-  /** How many proposals this Session has made, so the agent can pace itself. */
-  proposed: z20.number(),
+  /** How many proposals this Session is holding, so the agent can pace itself. */
+  staged: z20.number(),
   replaced: z20.boolean()
 });
 var readinessStatusRequestSchema = z20.strictObject({});
 var readinessStatusResponseSchema = z20.object({
-  proposed: z20.array(
+  staged: z20.array(
     z20.object({
       questionId: z20.string(),
       value: z20.string().optional(),
@@ -49922,6 +49921,11 @@ var suggestArgs = {
     description: "What they said for the option that opens a box. Only valid when that option is chosen",
     required: false
   },
+  owner: {
+    type: "string",
+    description: "Who on their side owns this. Only the four questions that ask for one accept it",
+    required: false
+  },
   quote: {
     type: "string",
     description: "Their sentence, verbatim. Required: a proposal is only as good as the words behind it",
@@ -49929,7 +49933,12 @@ var suggestArgs = {
   },
   "said-by": {
     type: "string",
-    description: "Who said it. Required: a transcript carries both sides, and our own words are not their answer \u2014 drop the proposal when the speaker was us",
+    description: "Who said it. On a call transcript this is not optional in practice: half of it is us, and our own proposal is not their answer",
+    required: false
+  },
+  "source-kind": {
+    type: "string",
+    description: `Where it came from: ${READINESS_SOURCE_KINDS.join(" | ")}`,
     required: true
   },
   source: {
@@ -49937,6 +49946,7 @@ var suggestArgs = {
     description: 'How a person would name it: "Call with Marc, 12 March"',
     required: true
   },
+  "source-url": { type: "string", description: "A link a reviewer can open to check it", required: false },
   confidence: {
     type: "string",
     description: "stated = they said this; implied = you are reading it off something adjacent. Say implied when you mean implied",
@@ -49945,7 +49955,7 @@ var suggestArgs = {
 };
 registerSchema({
   command: "readiness.suggest",
-  description: "Propose one assessment answer from something the client already told us, with the sentence it came from. A person accepts it; it is never an answer on its own.",
+  description: "Propose one assessment answer from something the client already told us, with the sentence it came from. Staged on the Session; a person accepts it.",
   args: suggestArgs
 });
 var suggestCommand = defineCommand175({
@@ -49953,14 +49963,14 @@ var suggestCommand = defineCommand175({
     name: "suggest",
     description: `Propose one answer to an assessment question, from something the client already told us.
 
-This does NOT answer the question. It records a proposal on the Readiness page, where a person accepts
-or corrects it. Nothing you propose counts as an answer, as progress, or moves the verdict.
+This does NOT answer the question. It stages a proposal that reaches the Readiness page when the
+Session publishes, where a person accepts or corrects it. Nothing you stage here moves the verdict.
 
 Two rules worth more than the rest:
   - Quote them. --quote takes their sentence, not your summary of it. A reviewer checks the claim
     against the words, and a paraphrase gives them nothing to check.
   - A transcript carries both sides. "We would need write access to Tag Manager" said by US is not
-    their consent. --said-by is required for exactly that reason: drop the proposal when it was us.
+    their consent. Pass --said-by, and drop the proposal when the speaker was us.
 
 Say --confidence implied when you are inferring rather than repeating. The questions that cost the
 most to get wrong \u2014 what legal permits, what access is grantable \u2014 are the ones an eager reader
@@ -49969,12 +49979,12 @@ infers from a passing remark.
 Examples:
   baker readiness suggest --question B2.6 --value drops-fixable \\
     --quote "Unknown fields get dropped today, but Luisa can add them to the schema in a sprint" \\
-    --said-by "Ana (client)" --source "Discovery call, 12 March" --confidence stated
+    --said-by "Ana (client)" --source-kind call --source "Discovery call, 12 March" --confidence stated
 
   baker readiness suggest --question A1 --selections google-ads,meta,other \\
     --other-text "A Q4 burst on Spotify through a media agency" \\
     --quote "We run Google and Meta, plus a Spotify burst in Q4 that the agency buys" \\
-    --said-by "Ana (client)" --source "Media plan 2026.pdf" --confidence stated`
+    --said-by "Ana (client)" --source-kind document --source "Media plan 2026.pdf" --confidence stated`
   },
   args: suggestArgs,
   run: async ({ args }) => {
@@ -49984,9 +49994,12 @@ Examples:
         value: args.value === void 0 ? void 0 : String(args.value),
         selections: parseList2(args.selections),
         otherText: args["other-text"] === void 0 ? void 0 : String(args["other-text"]),
+        owner: args.owner === void 0 ? void 0 : String(args.owner),
         quote: String(args.quote),
-        saidBy: String(args["said-by"]),
+        saidBy: args["said-by"] === void 0 ? void 0 : String(args["said-by"]),
+        sourceKind: parseEnum(args["source-kind"], READINESS_SOURCE_KINDS, "source-kind"),
         source: String(args.source),
+        sourceUrl: args["source-url"] === void 0 ? void 0 : String(args["source-url"]),
         confidence: parseEnum(args.confidence, READINESS_CONFIDENCES, "confidence")
       };
       const response = await apiPost("/api/readiness/suggest", body);