@mstar-harness/opencode 2.0.2 → 2.0.3

package/CHANGELOG.md

@@ -6,6 +6,14 @@ The monorepo root [CHANGELOG.md](../../CHANGELOG.md) summarizes cross-surface re
 
 ## [Unreleased]
 
+## [2.0.3] - 2026-08-09
+
+### Bundled harness skills (`harness-skills/` at publish)
+
+- Version alignment with harness **2.0.3** (no OpenCode package API change).
+
+See root [CHANGELOG.md](../../CHANGELOG.md) **2.0.3**.
+
 ## [2.0.2] - 2026-08-08
 
 ### Fixed

package/dist/mstar.js

@@ -223,6 +223,43 @@ function assertDefaultBranchProtected(branch, opts = {}) {
   }
   return { ok: violations.length === 0, violations };
 }
+var ASSIGNMENT_HEADING_RE = /^#{1,6}\s+Assignment\s*$/m;
+var ASSIGNMENT_FIELD_RE = /^[ \t]*(?:[-*][ \t]+)?\*{0,2}(Execute as|Delegation|Task category)\*{0,2}[ \t]*:[ \t]*(\S.*)$/gm;
+function isAssignmentShaped(assignmentText) {
+  return ASSIGNMENT_HEADING_RE.test(assignmentText) || assignmentText.match(ASSIGNMENT_FIELD_RE) !== null;
+}
+function composeDispatchGate(text, opts = {}) {
+  const silent = {
+    ok: true,
+    violations: [],
+    shaped: false,
+    enforcement: { hard: false, source: "none" }
+  };
+  try {
+    if (!isAssignmentShaped(text))
+      return silent;
+    const violations = [];
+    const writable = opts.writable !== false;
+    violations.push(...validateAssignmentFields(text, { writable }).violations);
+    const agent = (opts.agent ?? "").trim();
+    if (agent !== "") {
+      violations.push(...antiRecursionPrecheck(agent, parseAssignmentFields(text).executeAs ?? "").violations);
+    }
+    if (writable) {
+      const forms = parseAssignmentBranchForms(text);
+      const branch = forms.createForm?.name ?? forms.workingBranch ?? forms.directOn?.branch ?? process.env.MSTAR_WORKING_BRANCH;
+      if (branch !== undefined && branch.trim() !== "") {
+        const directOnException = parseBranchPolicyDirectOnBranch(text) === branch.trim();
+        violations.push(...assertDefaultBranchProtected(branch.trim(), { directOnException }).violations);
+      }
+    }
+    const enforcement = parseEnforcementFlag(assignmentHeaderRegion(text));
+    const gate = { ok: violations.length === 0, violations };
+    return { ...applyEnforcement(gate, { hard: enforcement.hard }), shaped: true, enforcement };
+  } catch {
+    return silent;
+  }
+}
 function antiRecursionPrecheck(subagentType, executeAs) {
   const binding = subagentType.trim().toLowerCase();
   const role = executeAs.trim().toLowerCase();
@@ -633,48 +670,25 @@ function validateStatusWrite(targetPath, opts = {}) {
     return null;
   }
 }
-var ASSIGNMENT_HEADING_RE = /^#{1,6}\s+Assignment\s*$/m;
-var ASSIGNMENT_FIELD_RE = /^[ \t]*(?:[-*][ \t]+)?\*{0,2}(Execute as|Delegation|Task category)\*{0,2}[ \t]*:[ \t]*(\S.*)$/gm;
-function isAssignmentShaped(assignmentText) {
-  if (typeof assignmentText !== "string")
-    return false;
-  return ASSIGNMENT_HEADING_RE.test(assignmentText) || assignmentText.match(ASSIGNMENT_FIELD_RE) !== null;
-}
 function validateDispatchAssignment(assignmentText, opts = {}) {
   const log = opts.log ?? defaultStatusLogger;
   try {
-    if (typeof assignmentText !== "string" || !isAssignmentShaped(assignmentText)) {
+    if (typeof assignmentText !== "string") {
       return { ok: true, violations: [] };
     }
-    const violations = [];
-    const fields = parseAssignmentFields(assignmentText);
-    const writable = isReadOnlyAssignmentRole(fields.executeAs ?? "") ? false : undefined;
-    violations.push(...validateAssignmentFields(assignmentText, { writable }).violations);
-    const binding = opts.subagentType ?? "";
-    if (binding.trim() !== "") {
-      violations.push(...antiRecursionPrecheck(binding, fields.executeAs ?? "").violations);
-    }
-    if (writable !== false) {
-      const forms = parseAssignmentBranchForms(assignmentText);
-      const branch = forms.createForm?.name ?? forms.workingBranch ?? forms.directOn?.branch ?? process.env.MSTAR_WORKING_BRANCH;
-      if (branch !== undefined && branch.trim() !== "") {
-        const directOnException = parseBranchPolicyDirectOnBranch(assignmentText) === branch.trim();
-        violations.push(...assertDefaultBranchProtected(branch.trim(), { directOnException }).violations);
-      }
-    }
-    const result = { ok: violations.length === 0, violations };
-    const enforcement = parseEnforcementFlag(assignmentHeaderRegion(assignmentText));
-    if (!result.ok) {
-      for (const violation of result.violations) {
+    const writable = isReadOnlyAssignmentRole(parseAssignmentFields(assignmentText).executeAs ?? "") ? false : undefined;
+    const composed = composeDispatchGate(assignmentText, { agent: opts.subagentType ?? "", writable });
+    if (!composed.ok) {
+      for (const violation of composed.violations) {
         const fix = violation.fix ? ` (fix: ${violation.fix})` : "";
-        if (enforcement.hard) {
+        if (composed.enforcement.hard) {
           log("error", `assignment validation (hard gate): [${violation.severity}] ${violation.code}: ${violation.message}${fix} — hardBlocked per Enforcement: hard; refusal requires a host refusal channel (skill: mstar-dispatch-gates)`);
         } else {
           log("warn", `assignment validation: [${violation.severity}] ${violation.code}: ${violation.message}${fix}`);
         }
       }
     }
-    return applyEnforcement(result, { hard: enforcement.hard });
+    return composed;
   } catch (error) {
     log("error", `assignment validation aborted: ${error.message}`);
     return null;

package/harness-skills/mstar-host/references/omp.md

@@ -208,6 +208,17 @@ Cannot emit required **N** → **`Blocked`**.
 | Plugin commands | `/iteration-start`, `/iteration-drive`, `/iteration-loop` (filename-based) |
 | Session entry | `/skill:pm` → `mstar-harness-core` via pm **Read next** |
 
+## In-process engine binding (omp ≥ 17.2.11)
+
+- **Surfaces** (repo root = plugin root): `hooks/pre/mstar-gates.ts` — one `tool_call` pre-hook that returns `{ block: true, reason }` (structured refusal the model sees as the tool error) or `undefined` (pass); `tools/mstar_{status_validate,dispatch_validate,lease_verify,path_resolve,iteration_gate,worktree_check}/index.ts` — six model-callable validator tools (engine validators only, Zod params via `pi.zod`).
+- **Enforcement semantics**: block ONLY under `Enforcement: hard`. The status gate reads the harness compass frontmatter (`enforcement: hard`, active/locked iterations only); the dispatch gate reads each Assignment's own header flag (`assignmentHeaderRegion` — a body example never hardens). Soft / no flag → silent pass. Rollback = unset the flag. Never global.
+- **Engine dependency**: the adapters import the published engine package (root `package.json` `dependencies` entry). omp git/npm plugin installs run `bun install <spec>` in the plugins tree → declared deps installed; a bare `-l` / `omp plugin link` symlink install without `node_modules` cannot resolve the modules.
+- **Graceful degradation (explicit)**: module load failure → `mstar_*` tools skipped, hook absent (no blocking), `commands/*.md` shell-out fallback intact. Caveat: a partial failure is SILENT — no in-band signal that gates are off; verify with `omp -p '/extensions'`.
+- **`MSTAR_HARNESS_DIR` override**: the hook and tools discover `{HARNESS_DIR}` via `resolveHarnessDir`, which probes only `.mstar/` → `.agents/` → `.plans/`/`plans/` roots. Repos using a non-standard harness root (e.g. this plugin repo's own `.harness/`) MUST export `MSTAR_HARNESS_DIR` (absolute path) in the omp session env — without it the status gate does not cover those roots and tools like `mstar_path_resolve` / `mstar_lease_verify` error out (parity with the opencode binding).
+- **Edit-path limitation**: the status gate validates the on-disk file for `edit` events (pre-edit state) — a corrupting edit is caught by the next write or `mstar_status_validate` (known v1 limitation, parity with opencode).
+- **`mstar_iteration_gate` engine requirement**: the tool requires an engine build exporting `parseCompassFrontmatter` (next published release). On older engines the tool reports an explicit upgrade error instead of loading — no silent absence; CLI fallback: `mstar iteration gate`.
+- **Reload**: edits are picked up by a new session (`?mtime` cache-buster); in-session `/reload-plugins` (omp ≥ 17.2.11) applies them without a new session.
+
 ## Files, shell, and approvals
 
 - Prefer host search/edit tools over shell find/sed when available.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/opencode",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Morning Star harness OpenCode plugin — skills bootstrap + engine-backed runtime hooks (status lint, dispatch validation, Enforcement: hard gates).",
   "license": "MIT",
   "repository": {
@@ -36,6 +36,6 @@
     "access": "public"
   },
   "devDependencies": {
-    "@mstar-harness/engine": "2.0.2"
+    "@mstar-harness/engine": "2.0.3"
   }
 }