@brainervirus/workit-core 1.1.1 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainervirus/workit-core",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "private": false,
   "description": "Workit shared core — task, policy, evidence, review, decision, worker, and writer state for agentic coding workflows",
   "keywords": [

package/src/core/external-action.ts

@@ -225,6 +225,23 @@ export const externalActionDescriptor = (operation: string, payload: unknown): s
       : {}),
   });
 
+/**
+ * Plan reservations never execute a git commit. A git.commit whose resolved
+ * payload carries a plan_steps array records the listed chain once and lets
+ * each listed single commit execute later under that authorization. Adapters
+ * must return plan success without running the commit effect, both for prior
+ * approvals and standing auto-approval; otherwise the reservation fails as a
+ * single commit requiring a message. Returns the listed count, else null.
+ */
+export const planReservationLength = (
+  operation: string,
+  descriptorPayload: unknown,
+): number | null => {
+  if (operation !== "git.commit") return null;
+  const payload = (descriptorPayload ?? {}) as { plan_steps?: unknown };
+  return Array.isArray(payload.plan_steps) ? payload.plan_steps.length : null;
+};
+
 /** Compact host-facing help for the fixed optional-action surface. */
 export const externalActionHelp =
   "Fixed actions: git.branch_setup {action?,sdd_dir?,target_branch(required unless reapply_stash; the working branch to create or switch to),stash?}; git.commit {message}; git.push {branch?}; hosting.pull_request {title,body?,draft?,target_branch?,babysit?}; hosting.merge {target_branch?,source_branch?}; youtrack.update {issueId,markdown,minutes?}; youtrack.time {issueId,minutes,text?,dateMs?}; youtrack.meeting {issueId,minutes,text}; changelog.apply {entries?,path?,normalize_only?}; context.read {kind,range?,issueId?,issueUrl?,issueRef?,mode?,specPath?,planPath?}. context.read is read-only and needs no approval; all other operations require native approval (CLI uses a TTY; caller-unattested MCP cannot mutate).";

package/src/core/support-matrix.ts

@@ -7,7 +7,10 @@
 export const SUPPORT_MATRIX = {
   bun: "1.4.1",
   node: { minimum: "24", current: "24.20.0" },
-  opencode: { minimum: "1.15.0", current: "1.18.30" },
+  // The object-form dual entry (server() + setup()) only loads from
+  // 1.18.29+; the supported floor is 1.18.30 so no host can pass doctor while
+  // being unable to load the entry shape.
+  opencode: { minimum: "1.18.30", current: "1.18.30" },
   // Codex is a qualification host, not a runtime dependency: the CLI version
   // below is the one live qualification evidence covers. The doctor warns when
   // an installed CLI drifts ahead so a fresh install never silently outruns

package/src/core.ts

@@ -125,6 +125,7 @@ export {
   externalActionRef,
   externalActionDescriptor,
   externalActionHelp,
+  planReservationLength,
   externalActionRequest,
   matchesNativeExternalAction,
   nativeExternalActionObservation,