@popoverai/dotrequirements 0.38.4 → 0.39.0

package/dist/commands/solution/brief.d.ts

@@ -12,7 +12,8 @@
  * images and demo scripts `next` saves in the checkout (SIGHT-9.3, 13.1).
  */
 export type Brief = {
-    kind: "step" | "review";
+    /** `request`: what the solution's agent asked it, which it answers (CONVO-11). */
+    kind: "step" | "review" | "request";
     /** The outcome the agent took; `label` is its name too. */
     step: {
         label: string;

package/dist/commands/solution/change.d.ts

@@ -0,0 +1,12 @@
+import { type WhereOptions } from "./run-file.js";
+/**
+ * `dotreq solution change --comment "<what changed and why>"`: a made
+ * outcome's drafter, asked by the solution's agent to change it, records
+ * the change in place (VERB-8). Its commits are pushed first, as before any
+ * record (VERB-8.1, SOLBRANCH-3); the outcome stays made, and its history
+ * says what changed and why, at the solution's agent's request.
+ */
+export declare function changeCommand(options: WhereOptions & {
+    comment?: string;
+}): Promise<void>;
+//# sourceMappingURL=change.d.ts.map

package/dist/commands/solution/change.js

@@ -0,0 +1,29 @@
+import { api } from "../../convex.js";
+import { solutionClient } from "./client.js";
+import { pushBeforeRecord } from "./pushing.js";
+import { requireWhere } from "./run-file.js";
+/**
+ * `dotreq solution change --comment "<what changed and why>"`: a made
+ * outcome's drafter, asked by the solution's agent to change it, records
+ * the change in place (VERB-8). Its commits are pushed first, as before any
+ * record (VERB-8.1, SOLBRANCH-3); the outcome stays made, and its history
+ * says what changed and why, at the solution's agent's request.
+ */
+export async function changeCommand(options) {
+    const comment = options.comment?.trim();
+    // VERB-8.3: what it says is all the history shows of the change.
+    if (!comment) {
+        throw new Error("Say what changed and why with --comment: what you say is what the outcome's history shows of the change.");
+    }
+    const where = requireWhere(options);
+    const client = solutionClient();
+    await pushBeforeRecord(client, where);
+    const { done } = await client.mutation(api.solutions.mutations.changeInPlace, {
+        solutionId: where.solutionId,
+        agent: where.agent,
+        ...(where.outcome ? { outcome: where.outcome } : {}),
+        comment,
+    });
+    console.log(done);
+}
+//# sourceMappingURL=change.js.map

package/dist/commands/solution/index.js

@@ -2,6 +2,7 @@ import { Option } from "commander";
 import { approvalCompleteCommand } from "./approval.js";
 import { askCommand } from "./ask.js";
 import { authorCommand } from "./author.js";
+import { changeCommand } from "./change.js";
 import { checkoutCommand, pushCommand } from "./checkout.js";
 import { REQUEST_CONTRACT } from "./contract.js";
 import { createCommand } from "./create.js";
@@ -269,6 +270,11 @@ export function registerSolution(program) {
     whereOptions(solution
         .command("things <name>", HIDDEN)
         .description("What an outcome or an input holds now, or the outcomes a checkpoint presents: one reference a line")).action(wrap(thingsCommand));
+    whereOptions(solution
+        .command("change", HIDDEN)
+        .description("Record a change you made in place to a made outcome, as the solution's agent asked: what changed and why. The outcome stays made"))
+        .option("--comment <text>", "What changed and why: what the outcome's history shows of the change (required)")
+        .action(wrap(changeCommand));
     whereOptions(solution
         .command("stall <reason>", HIDDEN)
         .description("Your work cannot go on, and no decision would fix that: what has to change before it can be started again"))

package/dist/convex.d.ts

@@ -101,6 +101,7 @@ export declare const api: {
             ask: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;
             completeApproval: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;
             stall: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;
+            changeInPlace: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;
             answer: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;
             approveCheckpoint: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;
             removeRehearsal: import("convex/server").FunctionReference<"mutation", "public", any, any, string | undefined>;

package/dist/convex.js

@@ -115,6 +115,8 @@ export const api = {
             // DECIDE-4: the action on the option the owner chose, taken once.
             completeApproval: mutation("solutions/mutations:completeApproval"),
             stall: mutation("solutions/mutations:stall"),
+            // VERB-8: a made outcome's drafter's change in place.
+            changeInPlace: mutation("solutions/mutations:changeInPlace"),
             answer: mutation("solutions/mutations:answer"),
             // A rehearsal's scripted approval of a checkpoint (CHECKPOINT-1.1).
             approveCheckpoint: mutation("solutions/mutations:approveCheckpoint"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popoverai/dotrequirements",
-  "version": "0.38.4",
+  "version": "0.39.0",
   "description": "Requirements as testable, human-readable data — CLI and test harness for spec-driven development with AI coding agents",
   "type": "module",
   "bin": {