@mstar-harness/engine 2.3.0 → 2.4.0

package/dist/engine.js

@@ -3468,13 +3468,56 @@ var FIVE_QUESTION_SECTIONS = [
   { key: "evidence", label: "Evidence", question: "what a correct result looks like (success criteria / evidence)" },
   { key: "references", label: "References", question: "additional resources to open when the main path is not enough" }
 ];
+function stripFrontmatter(text) {
+  const lines = text.replace(/^\uFEFF/, "").split(/\r?\n/);
+  if (lines.length === 0 || lines[0].trim() !== "---")
+    return text;
+  for (let i = 1;i < lines.length; i++) {
+    if (lines[i].trim() === "---")
+      return lines.slice(i + 1).join(`
+`);
+  }
+  return text;
+}
 var HEADING_RE = /^#{1,6}\s+[^\r\n]+$/;
-function lintFiveQuestion(bodyText) {
-  const headings = bodyText.split(/\r?\n/).filter((line) => HEADING_RE.test(line)).map((line) => line.replace(/^#{1,6}\s+/, "").trim().toLowerCase());
+function collectHeadings(bodyText) {
+  const headings = [];
+  let inFence = false;
+  for (const line of bodyText.split(/\r?\n/)) {
+    if (line.startsWith("```") || line.startsWith("~~~")) {
+      inFence = !inFence;
+      continue;
+    }
+    if (!inFence && HEADING_RE.test(line)) {
+      headings.push(line.replace(/^#{1,6}\s+/, "").trim().toLowerCase());
+    }
+  }
+  return headings;
+}
+var RUNTIME_HEADING_ALIASES = {
+  workflow: ["process", "playbook"],
+  "decision-rules": [
+    "hard rules",
+    "core rules",
+    "rule",
+    "gate",
+    "not to do",
+    "red flags",
+    "反模式",
+    "红线",
+    "规则",
+    "门禁"
+  ],
+  evidence: ["output format", "证据"],
+  references: ["dependencies", "关系"]
+};
+function lintFiveQuestion(bodyText, mode = "authoring") {
+  const headings = collectHeadings(bodyText);
   const violations = [];
   for (const section of FIVE_QUESTION_SECTIONS) {
     const label = section.label.toLowerCase();
-    const covered = headings.some((heading) => heading.includes(label));
+    const aliases = mode === "runtime" ? RUNTIME_HEADING_ALIASES[section.key] ?? [] : [];
+    const covered = headings.some((heading) => heading.includes(label) || aliases.some((alias) => heading.includes(alias)));
     if (!covered) {
       violations.push(violation11("low", `skill-authoring.five-question.${section.key}`, `body does not answer "${section.question}" — no "${section.label}" section (mstar-skill-authoring § Body 必须回答的 5 问 / § 默认 Body 结构)`, `add a "## ${section.label}" section covering ${section.question}`));
     }
@@ -3503,6 +3546,7 @@ export {
   techDebtRollup,
   taskReportExists,
   taskBrief,
+  stripFrontmatter,
   singleReviewSnapshot,
   sddWorkspace,
   scopeGuard,
@@ -3575,6 +3619,7 @@ export {
   SddScriptError,
   SHARED_FAMILIES,
   SEVERITY_ORDER,
+  RUNTIME_HEADING_ALIASES,
   ROLE_MAPPING,
   QC_REVIEWER_PARAMS,
   KNOWLEDGE_SEVERITIES,

package/dist/index.d.ts

@@ -48,5 +48,5 @@ export type { DevTrackParam, QcReviewerParam, RoleFamily, RoleMappingEntry, Role
 export { DEV_TRACK_PARAMS, QC_REVIEWER_PARAMS, ROLE_MAPPING, SHARED_FAMILIES, lintLoadOrder, validateRoleMapping, } from "./roles.js";
 export type { DetectResult, HostAdapter, HostId, SkillRootPaths, ToolSignal } from "./host.js";
 export { detectHost, resolveSkillRoot } from "./host.js";
-export type { FiveQuestionSection } from "./skill-authoring.js";
-export { FIVE_QUESTION_SECTIONS, lintFiveQuestion, lintFrontmatter, resolveAssetPath, } from "./skill-authoring.js";
+export type { FiveQuestionMode, FiveQuestionSection } from "./skill-authoring.js";
+export { FIVE_QUESTION_SECTIONS, RUNTIME_HEADING_ALIASES, lintFiveQuestion, lintFrontmatter, resolveAssetPath, stripFrontmatter, } from "./skill-authoring.js";

package/dist/skill-authoring.d.ts

@@ -36,19 +36,43 @@ export type FiveQuestionSection = {
     question: string;
 };
 export declare const FIVE_QUESTION_SECTIONS: readonly FiveQuestionSection[];
+/** Strip a leading `---`-fenced YAML frontmatter block, returning the body
+ * (the five-question lint takes the body; the frontmatter lint takes the
+ * full doc). Returns the input unchanged when there is no closing fence —
+ * an unparseable block is treated as body rather than destroyed. Canonical
+ * helper shared by the CLI, drift-lint Guard 5 and the engine corpus test. */
+export declare function stripFrontmatter(text: string): string;
+/** Lint mode: `authoring` (canonical headings only — greenfield / strict)
+ * or `runtime` (canonical plus the locked `RUNTIME_HEADING_ALIASES` table
+ * — shipped `mstar-*` topic skills). */
+export type FiveQuestionMode = "authoring" | "runtime";
+/**
+ * Locked runtime alias table (plan 20260816-audit-001-five-question-runtime-
+ * alignment, Step 2): heading synonyms that answer the same question for
+ * shipped topic skills, verified against the corpus at `81480e7`. Tokens are
+ * case-insensitive heading substrings (any heading level); the `decision-rules`
+ * breadth is bounded by the corpus regression test pinning current state.
+ * `load-order` has no aliases — the canonical label covers 15/16 skills and
+ * `mstar-host` closes its gap with a corpus edit instead. Chinese tokens are
+ * `\uXXXX` escapes (ASCII-only src literals; runtime value is identical).
+ */
+export declare const RUNTIME_HEADING_ALIASES: Readonly<Record<string, readonly string[]>>;
 /**
  * Lint a SKILL.md body for the 5-question contract (mstar-skill-authoring
  * § Body 必须回答的 5 问). Heuristic: each of the five questions must be
  * answered by the presence of its canonical section heading (case-
  * insensitive substring match on heading text, any heading level — so
  * "## Load Order (Required)" and "### Workflow — main path" both match).
- * Content judgment (whether the answer is actually narrow / procedural)
- * stays prompt. Advisory: violations are `low` severity (v1 non-blocking).
+ * `mode: "runtime"` additionally accepts the locked `RUNTIME_HEADING_ALIASES`
+ * synonyms for shipped topic skills; `authoring` (default) stays canonical-
+ * only — greenfield skills still must use the canonical headings. Content
+ * judgment (whether the answer is actually narrow / procedural) stays prompt.
+ * Advisory: violations are `low` severity (v1 non-blocking).
  *
  * Violations: `skill-authoring.five-question.<key>` for each uncovered
  * question.
  */
-export declare function lintFiveQuestion(bodyText: string): GateResult;
+export declare function lintFiveQuestion(bodyText: string, mode?: FiveQuestionMode): GateResult;
 /**
  * Resolve a skill-relative asset path (mstar-skill-authoring § Skill-
  * relative script and asset paths: name assets as skill `<name>` →

package/package.json

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