@mstar-harness/engine 3.1.1 → 3.1.3

package/dist/status.d.ts

@@ -136,6 +136,26 @@ export declare function validateStatusV2(docOrPath: StatusV2Doc | string, opts?:
  * closed on v1 input with the `mstar migrate` hint.
  */
 export declare const validateStatus: typeof validateStatusV2;
+/**
+ * Root-file workflow upsert, to be called ONLY while the caller holds the
+ * root `withStatusWriteLock(statusPath)` (see `registerWorkflow` and the
+ * audit promote path, which call this from inside their lock — the root
+ * lock is the serialization point for read-check-replace-verify).
+ *
+ * Idempotent upsert by entry `id`, bumping root `updated_at`. A
+ * missing/empty root file is initialized from the v2 template (never a v1
+ * tree); a v1 root is refused with the `mstar migrate` hint (no silent
+ * mutation of an un-migrated tree). The final document is validated with
+ * `validateStatusV2` (including the removal-at-terminal snapshot invariant
+ * against `dirname(statusPath)`) before the write — an entry whose
+ * snapshot is missing or terminal is refused and nothing is written.
+ *
+ * The caller must validate the entry (`validateWorkflowEntry`) before
+ * acquiring the lock; this helper asserts it as a safety net (cheap —
+ * an invalid entry would fail `validateStatusV2` anyway, but the explicit
+ * gate keeps the pre-lock fail-fast contract of `registerWorkflow`).
+ */
+export declare function registerWorkflowEntryLocked(statusPath: string, entry: WorkflowEntry): StatusV2Doc;
 /**
  * Register one active workflow entry in the v2 root file (plan Task 3).
  * Idempotent upsert by entry `id` under the root-file `withStatusWriteLock`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/engine",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "description": "Morning Star Harness Workflow Engine — deterministic workflow enforcement library (path, status, lease, dispatch, sdd, iteration, lint gates).",
   "license": "MIT",
   "repository": {
@@ -16,13 +16,17 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/engine.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./src/audit": {
+      "types": "./dist/audit.d.ts",
+      "default": "./dist/audit.js"
+    }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build src/index.ts --target node --outfile dist/engine.js && bunx tsc",
+    "build": "rm -rf dist && bun build src/index.ts --target node --outfile dist/engine.js && bun build src/audit.ts --target node --outfile dist/audit.js && bunx tsc",
     "test": "bun test",
     "prepublishOnly": "bun run build"
   },