kibi-agent-core 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # kibi-agent-core
 
+## 0.9.0
+
+### Minor Changes
+
+- 180196c: The requirements signoff view now reads well on every host, not only in the hosts that draw Kibi's fenced block.
+  - `kibi signoff` prints plain Markdown by default (`--format chat`): headings, quoted statements and lists that render in any chat window, and in messaging tools for agents whose replies go through one (cloud and project sessions). The path of the self-contained page `.kb/briefs/signoff/latest.html` goes to stderr, so an agent can attach or publish it next to the message. `--format md` keeps the fenced block for the OpenCode terminal card, and `KIBI_SIGNOFF_FORMAT` sets the default per host.
+  - After a session writes a requirement, the Claude Code, Codex, Cursor and ZCode stop hooks ask once for the signoff view before the work is reported done, unless `kibi signoff` already ran since. A requirement the agent wrote is put to the person through the view, not retold in the agent's words.
+  - `/kibi-signoff` is a new command in Claude Code, Cursor and ZCode.
+  - The `kibi-decisions` and `kibi-commit-review` skills (1.2.0) say how to show the view on each host, and `kibi-usage` (2.22.0) points to `kibi signoff` when it says to leave `approved_by` to the person. The OpenCode guidance asks for `--format md` so the terminal card still renders.
+  - The Claude Code plugin README shows the `.claude/settings.json` snippet that loads the plugin in cloud sessions.
+
+## 0.8.1
+
+### Patch Changes
+
+- f4c5822: After a migration, the `kb_apply_plan` digest of the remaining plan now says when an automatic action in it is blocked: it waits for the actions in its `dependsOn` and needs no approval until a later plan shows it ready. Before, a blocked automatic action looked like something left to approve. The Claude hook's firm-edit question no longer prints a double full stop after a requirement title that ends in one.
+
+  The digest's `next` text appends a count of blocked automatic actions when there are any. `firmEditConfirmation` in `kibi-agent-core/decision-guard` trims a trailing full stop from the named requirements before closing the sentence.
+
 ## 0.8.0
 
 ### Minor Changes

package/dist/decision-guard.d.ts

@@ -55,7 +55,7 @@ export type DecisionSession = {
     sessionId: string | undefined;
 };
 /** Session markers the decision guard keeps. */
-export type DecisionFlag = "source-edited" | "kb-recorded" | "rule-prompt" | "capture-asked";
+export type DecisionFlag = "source-edited" | "kb-recorded" | "rule-prompt" | "capture-asked" | "requirement-recorded" | "signoff-asked";
 /** Set a session marker; best effort. */
 export declare function markDecisionFlag(session: DecisionSession, flag: DecisionFlag): void;
 export declare function hasDecisionFlag(session: DecisionSession, flag: DecisionFlag): boolean;
@@ -77,6 +77,21 @@ export declare function requestWords(session: DecisionSession): string[];
  * not been asked yet (claiming the ask).
  */
 export declare function claimCaptureReminder(session: DecisionSession): boolean;
+/** Where `kibi signoff` keeps the latest view, relative to the workspace. */
+export declare const SIGNOFF_LATEST_JSON: string;
+/**
+ * Whether a kb_upsert call's input writes a requirement (not a dry run).
+ * Hosts pass the MCP arguments, sometimes wrapped in `arguments`.
+ */
+export declare function isRequirementUpsert(toolInput: unknown): boolean;
+/**
+ * Whether the stop should ask for a signoff view: the session wrote a
+ * requirement, `kibi signoff` has not written a view since, and the session
+ * has not been asked yet (claiming the ask).
+ */
+export declare function claimSignoffReminder(session: DecisionSession, workspaceRoot: string): boolean;
+/** Stop-time note for a session that recorded requirements without a signoff view. */
+export declare function signoffReminder(): string;
 /** Firm requirements the agent was already told about this session. */
 export declare function settledFirmRequirements(session: DecisionSession): Set<string>;
 /** Remember that the agent was told about these firm requirements. */

package/dist/decision-guard.js

@@ -52,7 +52,9 @@ export function firmEditConfirmation(where, requirements) {
         ? ` (+${requirements.length - shown.length} more)`
         : "";
     const noun = requirements.length === 1 ? "a firm requirement" : "firm requirements";
-    return `Kibi: this edit changes ${where}, which implements ${noun} recorded in the knowledge base: ${shown.join("; ")}${more}. Allow it if the change keeps ${requirements.length === 1 ? "that requirement" : "them"}, or if you mean to change ${requirements.length === 1 ? "the requirement" : "them"} too.`;
+    // A title that ends in a full stop would read "preference.. Allow".
+    const named = `${shown.join("; ")}${more}`.replace(/\.+$/, "");
+    return `Kibi: this edit changes ${where}, which implements ${noun} recorded in the knowledge base: ${named}. Allow it if the change keeps ${requirements.length === 1 ? "that requirement" : "them"}, or if you mean to change ${requirements.length === 1 ? "the requirement" : "them"} too.`;
 }
 // implements REQ-claude-firm-edit-confirmation
 /** What the agent is told when its edit was put to the person. */
@@ -210,6 +212,57 @@ export function claimCaptureReminder(session) {
         !hasDecisionFlag(session, "kb-recorded") &&
         claimDecisionFlag(session, "capture-asked"));
 }
+// implements REQ-kibi-signoff-views
+/** Where `kibi signoff` keeps the latest view, relative to the workspace. */
+export const SIGNOFF_LATEST_JSON = path.join(".kb", "briefs", "signoff", "latest.json");
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+// implements REQ-kibi-signoff-views
+/**
+ * Whether a kb_upsert call's input writes a requirement (not a dry run).
+ * Hosts pass the MCP arguments, sometimes wrapped in `arguments`.
+ */
+export function isRequirementUpsert(toolInput) {
+    const input = record(toolInput);
+    const args = record(input?.arguments) ?? record(input?.args) ?? input;
+    return args?.type === "req" && args.dryRun !== true;
+}
+function mtimeMs(file) {
+    if (!file)
+        return undefined;
+    try {
+        return fs.statSync(file).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+}
+// implements REQ-kibi-signoff-views
+/**
+ * Whether the stop should ask for a signoff view: the session wrote a
+ * requirement, `kibi signoff` has not written a view since, and the session
+ * has not been asked yet (claiming the ask).
+ */
+export function claimSignoffReminder(session, workspaceRoot) {
+    const recorded = mtimeMs(sessionPath(session, "requirement-recorded"));
+    if (recorded === undefined)
+        return false;
+    const shown = mtimeMs(path.join(workspaceRoot, SIGNOFF_LATEST_JSON));
+    if (shown !== undefined && shown >= recorded)
+        return false;
+    return claimDecisionFlag(session, "signoff-asked");
+}
+// implements REQ-kibi-signoff-views
+/** Stop-time note for a session that recorded requirements without a signoff view. */
+export function signoffReminder() {
+    return [
+        "Kibi: this session recorded or changed requirements, and the person has not seen them as a signoff view.",
+        "Before reporting the work done or asking to commit, run `kibi signoff` and put its output in the reply unchanged; a requirement the agent wrote waits for the person's approval, so ask for it with this view, never in your own words. When replies go through a messaging tool, pass the output there, and attach or publish `.kb/briefs/signoff/latest.html` when the host can show a page (kibi-decisions, resources/signoff-views.md).",
+    ].join("\n");
+}
 function readSettled(file) {
     if (!file)
         return [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kibi-agent-core",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Shared low-latency hook helpers for Kibi agent adapters",
   "type": "module",
   "main": "./dist/index.js",
@@ -66,6 +66,6 @@
     "@types/node": "^25.9.8",
     "semver": "^7.8.5",
     "typescript": "^5.7.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.1"
   }
 }