pi-usereq 0.88.0 → 0.89.0

package/README.md

@@ -1,4 +1,4 @@
-# PI-useReq/pi-usereq (0.88.0)
+# PI-useReq/pi-usereq (0.89.0)
 
 <p align="center">
   <img src="https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.11+">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-usereq",
-  "version": "0.88.0",
+  "version": "0.89.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Ogekuri/PI-useReq.git"

package/src/core/command-report-entry.ts

@@ -126,6 +126,20 @@ export function buildCommandReportErrorEntryData(
   };
 }
 
+/**
+ * @brief Serializes one durable command report entry into its complete plain-text form.
+ * @details Joins the `pi-usereq <command>: execution report` header with every per-operation outcome line using newline separators so notification `%%OUTPUT%%` substitution carries exactly the report content rendered in the transcript. Runtime is O(n) in aggregate report-line length. No external state is mutated.
+ * @param[in] data {CommandReportEntryData} Report entry payload to serialize.
+ * @return {string} Complete execution-report text starting with the report header.
+ * @satisfies REQ-436, REQ-448
+ */
+export function buildCommandReportEntryText(data: CommandReportEntryData): string {
+  return [
+    `pi-usereq ${data.command}: execution report`,
+    ...data.lines,
+  ].join("\n");
+}
+
 /**
  * @brief Appends one durable command report entry to the active session when the host supports custom entries.
  * @details Probes the optional `pi.appendEntry(...)` surface before use so legacy hosts and offline harnesses without custom-entry support skip persistence silently; supported hosts persist the payload as a `custom` session entry that survives session restore while remaining excluded from LLM context. Runtime is O(1) plus delegated session-entry persistence. Side effects include session-file entry persistence on supported hosts.

package/src/index.ts

@@ -179,9 +179,9 @@ import {
 import { ensureBundledResourcesAccessible, readBundledPromptDescription } from "./core/resources.js";
 import {
   appendCommandReportEntry,
+  buildCommandReportEntryText,
   buildCommandReportErrorEntryData,
   buildReqReferencesCommandReportEntryData,
-  buildReqReferencesCommandReportLines,
   registerCommandReportEntryRenderer,
 } from "./core/command-report-entry.js";
 import { ReqError } from "./core/errors.js";
@@ -3586,7 +3586,7 @@ function registerReqResetCommand(
 
 /**
  * @brief Registers the specialized `req-references` slash command.
- * @details Registers the non-agentic references-maintenance command that rejects non-`idle` invocations by transitioning workflow state to `error` before direct execution, otherwise reuses slash-command-owned git validation, transitions workflow state through `checking|running|idle`, regenerates `REFERENCES.md` directly from configured source directories, stages only the generated file, creates the fixed-message git commit, verifies repository cleanliness, appends one durable `pi-usereq.command-report` session entry recording the executed operations with their outcomes so the report renders in the transcript and survives session restore, emits execution notifications that conform to the operations actually performed — one stating whether the references file was updated or already matched the generated content and one stating whether the fixed-message commit was created or skipped — regardless of the update and commit outcomes, dispatches prompt-end notification effects carrying the per-operation process output as `%%OUTPUT%%`, all without starting an LLM session or creating a worktree. Runtime is dominated by git subprocess execution plus source-summary generation. Side effects include command registration, status-controller mutation, filesystem writes, git index/history mutation, session-entry persistence, user notifications, and optional prompt-end notify, sound, and Pushover dispatch.
+ * @details Registers the non-agentic references-maintenance command that rejects non-`idle` invocations by transitioning workflow state to `error` before direct execution, otherwise reuses slash-command-owned git validation, transitions workflow state through `checking|running|idle`, regenerates `REFERENCES.md` directly from configured source directories, stages only the generated file, creates the fixed-message git commit, verifies repository cleanliness, appends one durable `pi-usereq.command-report` session entry recording the executed operations with their outcomes so the report renders in the transcript and survives session restore, emits execution notifications that conform to the operations actually performed — one stating whether the references file was updated or already matched the generated content and one stating whether the fixed-message commit was created or skipped — regardless of the update and commit outcomes, dispatches prompt-end notification effects carrying the complete execution-report text (header plus per-operation outcome lines) as `%%OUTPUT%%` for completed and failed runs, all without starting an LLM session or creating a worktree. Runtime is dominated by git subprocess execution plus source-summary generation. Side effects include command registration, status-controller mutation, filesystem writes, git index/history mutation, session-entry persistence, user notifications, and optional prompt-end notify, sound, and Pushover dispatch.
  * @param[in] pi {ExtensionAPI} Active extension API instance.
  * @param[in,out] statusController {PiUsereqStatusController} Mutable status controller.
  * @return {void} No return value.
@@ -3647,7 +3647,7 @@ function registerReqReferencesCommand(
           promptArgs: args,
           basePath: projectBase,
           completionTimeMs: Math.max(0, Date.now() - commandStartMs),
-          agentOutput: buildReqReferencesCommandReportLines(executionResult).join("\n"),
+          agentOutput: buildCommandReportEntryText(buildReqReferencesCommandReportEntryData(executionResult)),
         });
         notifyContextRetentionReminder(statusController, ctx);
       } catch (error) {
@@ -3662,7 +3662,7 @@ function registerReqReferencesCommand(
           promptArgs: args,
           basePath: projectBase,
           completionTimeMs: Math.max(0, Date.now() - commandStartMs),
-          agentOutput: message,
+          agentOutput: buildCommandReportEntryText(buildCommandReportErrorEntryData("req-references", message)),
         });
         throw error;
       }