@mstar-harness/engine 3.1.3 → 3.2.1

package/dist/audit.d.ts

@@ -1,5 +1,5 @@
 import type { GateResult } from "./core.js";
-/** Priority values (mstar-audit SKILL § Plan files Status block). */
+/** Priority values (mstar-audit SKILL.md § Plan output (all variants) Status block). */
 export declare const AUDIT_PRIORITIES: readonly ["P1", "P2", "P3"];
 export type AuditPriority = (typeof AUDIT_PRIORITIES)[number];
 /** Effort values (Morning Star agent-oriented effort scale). */
@@ -8,12 +8,12 @@ export type AuditEffort = (typeof AUDIT_EFFORTS)[number];
 /** Risk values. */
 export declare const AUDIT_RISKS: readonly ["LOW", "MED", "HIGH"];
 export type AuditRisk = (typeof AUDIT_RISKS)[number];
-/** Category codes (finding-format.md § Category codes + SKILL Status block). */
+/** Category codes (finding-format.md § Category codes + mstar-audit SKILL.md § Plan output (all variants) Status block). */
 export declare const AUDIT_CATEGORIES: readonly ["bug", "security", "perf", "tests", "tech-debt", "migration", "dx", "docs", "direction"];
 export type AuditCategory = (typeof AUDIT_CATEGORIES)[number];
 /**
  * Validate the audit Status block(s) of a plan file against the field
- * contract (mstar-audit SKILL § Plan files):
+ * contract (mstar-audit SKILL.md § Plan output (all variants) Status block):
  * - `Priority`: P1 | P2 | P3
  * - `Effort`: XS | S | M | L | XL
  * - `Risk`: LOW | MED | HIGH
@@ -89,7 +89,7 @@ export type ScaffoldAuditPlanResult = {
 };
 /**
  * Scaffold an audit plan directory (`{PLAN_DIR}/audit-<date>/` layout,
- * mstar-audit SKILL § Phase 4): numbered `NNN-<slug>.md` plan files from
+ * mstar-audit SKILL.md § Plan output (all variants)): numbered `NNN-<slug>.md` plan files from
  * findings plus a README.md index. Numbering is monotonic — when the
  * directory already contains `NNN-*.md` files (same-date re-run), the new
  * batch continues after the highest existing number instead of restarting
@@ -107,7 +107,7 @@ export type PromoteAuditPlansOptions = {
 };
 /**
  * Promote selected audit plans into the v2 workflow lifecycle as a
- * `type: "plan"` workflow (mstar-audit Handoff): write the workflow
+ * `type: "plan"` workflow (mstar-audit SKILL.md § Plan output (all variants) — handoff): write the workflow
  * snapshot FIRST (with one Todo PlanRow per selected file), then register
  * the workflow entry — `validateStatusV2` validates the full status doc
  * including the per-snapshot existence check, so the snapshot must exist

package/dist/audit.js

@@ -381,14 +381,14 @@ function validateAuditStatusBlocks(planText) {
   const violations = [];
   const blocks = parseStatusBlocks(planText);
   if (blocks.length === 0) {
-    violations.push(violation2("medium", "audit.status.missing-block", "no `## Status` block found — audit plan files carry the Status block fields (mstar-audit SKILL § Plan files)", "add a `## Status` block with Priority, Effort, Risk, Depends on, Category, Planned at"));
+    violations.push(violation2("medium", "audit.status.missing-block", "no `## Status` block found — audit plan files carry the Status block fields (mstar-audit SKILL.md § Plan output)", "add a `## Status` block with Priority, Effort, Risk, Depends on, Category, Planned at"));
     return { ok: false, violations };
   }
   blocks.forEach((block, index) => {
     const label = blocks.length > 1 ? ` #${index + 1}` : "";
     for (const field of AUDIT_STATUS_FIELDS) {
       if (!block.fields.has(field)) {
-        violations.push(violation2("medium", "audit.status.missing-field", `Status block${label} missing required field "${field}" (mstar-audit SKILL § Plan files)`, `add \`- **${field}**: <value>\` to the Status block`));
+        violations.push(violation2("medium", "audit.status.missing-field", `Status block${label} missing required field "${field}" (mstar-audit SKILL.md § Plan output)`, `add \`- **${field}**: <value>\` to the Status block`));
       }
     }
     const check = (field, pattern, code, expected) => {
@@ -396,7 +396,7 @@ function validateAuditStatusBlocks(planText) {
       if (value === undefined)
         return;
       if (!pattern.test(value)) {
-        violations.push(violation2("medium", code, `Status block${label} "${field}" = "${value}" — expected ${expected} (mstar-audit SKILL § Plan files)`, `fix \`- **${field}**:\` to one of: ${expected}`));
+        violations.push(violation2("medium", code, `Status block${label} "${field}" = "${value}" — expected ${expected} (mstar-audit SKILL.md § Plan output)`, `fix \`- **${field}**:\` to one of: ${expected}`));
       }
     };
     check("Priority", /^P[123]$/, "audit.status.invalid-priority", "P1 | P2 | P3");

package/dist/core.d.ts

@@ -1,7 +1,7 @@
 /**
  * Severity levels used across harness validation results.
  *
- * Machine SSOT — `mstar-plan-artifacts/references/status-and-residuals.md`
+ * Machine SSOT — `mstar-artifacts/references/status-and-residuals.md`
  * § "Residual findings: `severity` (SSOT, machine field)" defines the same
  * five lowercase-English values; `warning` / `Major` / any other value are
  * forbidden in JSON severity fields.

package/dist/engine.js

@@ -3468,14 +3468,14 @@ function validateAuditStatusBlocks(planText) {
   const violations = [];
   const blocks = parseStatusBlocks(planText);
   if (blocks.length === 0) {
-    violations.push(violation9("medium", "audit.status.missing-block", "no `## Status` block found — audit plan files carry the Status block fields (mstar-audit SKILL § Plan files)", "add a `## Status` block with Priority, Effort, Risk, Depends on, Category, Planned at"));
+    violations.push(violation9("medium", "audit.status.missing-block", "no `## Status` block found — audit plan files carry the Status block fields (mstar-audit SKILL.md § Plan output)", "add a `## Status` block with Priority, Effort, Risk, Depends on, Category, Planned at"));
     return { ok: false, violations };
   }
   blocks.forEach((block, index) => {
     const label = blocks.length > 1 ? ` #${index + 1}` : "";
     for (const field of AUDIT_STATUS_FIELDS) {
       if (!block.fields.has(field)) {
-        violations.push(violation9("medium", "audit.status.missing-field", `Status block${label} missing required field "${field}" (mstar-audit SKILL § Plan files)`, `add \`- **${field}**: <value>\` to the Status block`));
+        violations.push(violation9("medium", "audit.status.missing-field", `Status block${label} missing required field "${field}" (mstar-audit SKILL.md § Plan output)`, `add \`- **${field}**: <value>\` to the Status block`));
       }
     }
     const check = (field, pattern, code, expected) => {
@@ -3483,7 +3483,7 @@ function validateAuditStatusBlocks(planText) {
       if (value === undefined)
         return;
       if (!pattern.test(value)) {
-        violations.push(violation9("medium", code, `Status block${label} "${field}" = "${value}" — expected ${expected} (mstar-audit SKILL § Plan files)`, `fix \`- **${field}**:\` to one of: ${expected}`));
+        violations.push(violation9("medium", code, `Status block${label} "${field}" = "${value}" — expected ${expected} (mstar-audit SKILL.md § Plan output)`, `fix \`- **${field}**:\` to one of: ${expected}`));
       }
     };
     check("Priority", /^P[123]$/, "audit.status.invalid-priority", "P1 | P2 | P3");
@@ -4309,7 +4309,7 @@ function planQualityBar(planText) {
     if (token !== null) {
       const text = trimmed.length > 80 ? `${trimmed.slice(0, 77)}...` : trimmed;
       findings.push({ token, line: i + 1, text });
-      violations.push(violation11("medium", "lint.plan-quality.placeholder", `placeholder token "${token}" at line ${i + 1}: "${text}"`, "replace the placeholder with concrete content before locking the plan (mstar-plan-artifacts/references/plan-quality-bar.md; templates/plan.main.md placeholder scan)"));
+      violations.push(violation11("medium", "lint.plan-quality.placeholder", `placeholder token "${token}" at line ${i + 1}: "${text}"`, "replace the placeholder with concrete content before locking the plan (mstar-artifacts/references/plan-quality-bar.md; templates/plan.main.md placeholder scan)"));
     }
   }
   return { ok: violations.length === 0, violations, findings };

package/dist/lint.d.ts

@@ -18,7 +18,7 @@
  *   completion evidence must include the TDD triple (test file(s), command,
  *   output) in `task-N-report.md`; `mstar-sdd/references/file-handoffs.md` —
  *   fix subagents append covering test file(s), command run, output.
- * - Plan quality bar: `mstar-plan-artifacts/references/plan-quality-bar.md`
+ * - Plan quality bar: `mstar-artifacts/references/plan-quality-bar.md`
  *   § Quality checklist + `templates/plan.main.md` self-review
  *   ("Placeholder scan: no TBD").
  * - Skill frontmatter contract: `mstar-skill-authoring` SKILL.md § Frontmatter
@@ -180,7 +180,7 @@ export type PlanQualityResult = GateResult & {
     findings: PlanQualityFinding[];
 };
 /**
- * Plan quality bar — placeholder scan (mstar-plan-artifacts
+ * Plan quality bar — placeholder scan (mstar-artifacts
  * `references/plan-quality-bar.md` § Quality checklist + `templates/
  * plan.main.md` self-review "Placeholder scan: no TBD"). Every placeholder
  * token found becomes one `lint.plan-quality.placeholder` violation whose

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/engine",
-  "version": "3.1.3",
+  "version": "3.2.1",
   "description": "Morning Star Harness Workflow Engine — deterministic workflow enforcement library (path, status, lease, dispatch, sdd, iteration, lint gates).",
   "license": "MIT",
   "repository": {