@mstar-harness/engine 2.2.0 → 2.3.0

package/dist/engine.js

@@ -674,7 +674,7 @@ function parseAssignmentBranchForms(assignmentText) {
   if (fields.branchPolicy !== undefined && fields.branchPolicy !== "") {
     const direct = fields.branchPolicy.match(/^direct\s+on\s+(\S+)/i);
     if (direct) {
-      const strict = fields.branchPolicy.match(/^direct\s+on\s+(\S+)(?:\s*(?:[—–]|--|-)\s*(.+))?$/);
+      const strict = fields.branchPolicy.match(/^direct\s+on\s+(\S+)(?:\s*(?:[\u2014\u2013]|--|-)\s*(.+))?$/);
       forms.directOn = { branch: direct[1].trim(), reason: strict ? (strict[2] ?? "").trim() : "" };
     }
   }
@@ -2552,6 +2552,7 @@ function renderIndex(params) {
   if (rejectedRows !== "") {
     sections.push("", "## Findings considered and rejected", "", rejectedRows);
   }
+  sections.push("", "## Red-team dispositions", "", "- <finding>: <survived / refuted / hallucination-dropped / uncovered-kept>, <one-line reason>");
   return `${sections.join(`
 `)}
 `;
@@ -3080,11 +3081,31 @@ function findTemporaryMarkers(fileText) {
   }
   return { ok: violations.length === 0, violations, markers };
 }
+var TASK_ARTIFACT_RE = /\btask-\d+(?:-(?:brief|report|fix-report|diff)|\.diff)\b/g;
+var SDD_DEEPLINK_RE = /\.(?:mstar|agents)\/sdd\/([^\s/<>{}\[\]"'\*\?]+)/g;
+function findEphemeralCitations(skillText) {
+  const citations = [];
+  const lines = skillText.split(/\r?\n/);
+  for (let i = 0;i < lines.length; i++) {
+    const found = [];
+    for (const m of lines[i].matchAll(TASK_ARTIFACT_RE)) {
+      found.push({ index: m.index, match: m[0], kind: "task-artifact" });
+    }
+    for (const m of lines[i].matchAll(SDD_DEEPLINK_RE)) {
+      found.push({ index: m.index, match: m[0], kind: "sdd-deeplink" });
+    }
+    found.sort((a, b) => a.index - b.index);
+    for (const f of found) {
+      citations.push({ line: i + 1, match: f.match, kind: f.kind });
+    }
+  }
+  return citations;
+}
 var TEST_FILE_PATH_RE = /[\w./-]+\.(?:test|spec)\.[a-z0-9]+/i;
 var TEST_FILE_PHRASE_RE = /\btest files?\b/i;
 var COMMAND_PROMPT_RE = /^\s*[$>]\s*\S/;
 var RUNNER_RE = /\b(?:bun|pnpm|npm|yarn|npx|bunx)\s+(?:test|run|exec)\b|\b(?:npx|bunx)\s+[\w./-]+\b|\b(?:tsc|vitest|jest|mocha|pytest)\b|\bgo\s+test\b|\bcargo\s+test\b/i;
-var OUTPUT_TOKEN_RE = /[✓✔✗✘]|\b(?:PASS|FAIL)\b|\b\d+\s+(?:pass(?:es|ed)?|fail(?:s|ed|ing)?|skipped|tests?|ok)\b|\bok\s+\d+\b|\ball\s+ok\b|exit(?:ed)?\s+(?:with\s+)?(?:code\s+)?\d+/i;
+var OUTPUT_TOKEN_RE = /[\u2713\u2714\u2717\u2718]|\b(?:PASS|FAIL)\b|\b\d+\s+(?:pass(?:es|ed)?|fail(?:s|ed|ing)?|skipped|tests?|ok)\b|\bok\s+\d+\b|\ball\s+ok\b|exit(?:ed)?\s+(?:with\s+)?(?:code\s+)?\d+/i;
 function assertSddTddTriple(reportText) {
   const violations = [];
   const lines = reportText.split(/\r?\n/);
@@ -3526,6 +3547,7 @@ export {
   findingsCleanupGate,
   findTemporaryMarkers,
   findSimplifyMarkers,
+  findEphemeralCitations,
   executionModeToN,
   evaluatePhaseGate,
   emitGitignoreSnippet,

package/dist/index.d.ts

@@ -42,8 +42,8 @@ export type { AuditCategory, AuditEffort, AuditFinding, AuditPriority, AuditRisk
 export { AUDIT_CATEGORIES, AUDIT_EFFORTS, AUDIT_PRIORITIES, AUDIT_RISKS, redactSecrets, scaffoldAuditPlan, validateAuditStatusBlocks, } from "./audit.js";
 export type { ReferenceCheckResult } from "./compound.js";
 export { KNOWLEDGE_BUG_PROBLEM_TYPES, KNOWLEDGE_CATEGORY_MAP, KNOWLEDGE_KNOWLEDGE_PROBLEM_TYPES, KNOWLEDGE_PROBLEM_TYPES, KNOWLEDGE_REQUIRED_FIELDS, KNOWLEDGE_RESOLUTION_TYPES, KNOWLEDGE_SEVERITIES, assertIndexRows, compoundRefreshScope, referenceExists, scopeGuard, validateSchemaYaml, } from "./compound.js";
-export type { PlanQualityFinding, PlanQualityResult, SimplifyMarker, TemporaryMarker, TemporaryMarkerResult, } from "./lint.js";
-export { assertSddTddTriple, findSimplifyMarkers, findTemporaryMarkers, lintSkillFrontmatter, lintStrategySections, planQualityBar, } from "./lint.js";
+export type { EphemeralCitation, PlanQualityFinding, PlanQualityResult, SimplifyMarker, TemporaryMarker, TemporaryMarkerResult, } from "./lint.js";
+export { assertSddTddTriple, findEphemeralCitations, findSimplifyMarkers, findTemporaryMarkers, lintSkillFrontmatter, lintStrategySections, planQualityBar, } from "./lint.js";
 export type { DevTrackParam, QcReviewerParam, RoleFamily, RoleMappingEntry, RoleMappingOptions, } from "./roles.js";
 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";

package/dist/lint.d.ts

@@ -27,6 +27,10 @@
  *   contract (not a workflow summary), third person.
  * - STRATEGY.md structure: `mstar-strategy` SKILL.md § STRATEGY.md structure —
  *   six required sections.
+ * - Ephemeral citations: knowledge `conventions/skill-content-porting-discipline.md`
+ *   §3 ("No ephemeral citations in durable skill text") + session evaluation
+ *   2026-08-16 discrimination contract — concrete task-artifact references
+ *   and SDD deeplinks are ephemeral; placeholder forms are not.
  *
  * Enforcement depth: roadmap §8.5 C4 — v1 lints are non-blocking
  * `ValidationResult`s; callers surface them as warnings.
@@ -95,6 +99,45 @@ export type TemporaryMarkerResult = GateResult & {
  * carry); do not special-case it without a real FP report.
  */
 export declare function findTemporaryMarkers(fileText: string): TemporaryMarkerResult;
+/**
+ * An ephemeral citation found in durable skill text: a concrete reference to
+ * a per-task artifact or an SDD deeplink that survives nothing (knowledge
+ * conventions/skill-content-porting-discipline.md §3 — "No ephemeral
+ * citations in durable skill text": a calibration line citing an SDD task
+ * report violates standalone + survives nothing; instances/examples cite
+ * in-repo artifacts only).
+ */
+export type EphemeralCitation = {
+    /** 1-based line number of the citation. */
+    line: number;
+    /** The matched citation token (artifact name or deeplink prefix). */
+    match: string;
+    /** `task-artifact`: `task-<digits>-(brief|report|fix-report|diff)`;
+     * `sdd-deeplink`: `.mstar/sdd/` / `.agents/sdd/` + a concrete first
+     * segment. */
+    kind: "task-artifact" | "sdd-deeplink";
+};
+/**
+ * Find ephemeral citations in skill text (knowledge
+ * conventions/skill-content-porting-discipline.md §3 + session evaluation
+ * 2026-08-16 discrimination contract).
+ *
+ * Discrimination (HARD — zero false positives on the skills corpus):
+ * - `task-<digits>-(brief|report|fix-report|diff)` with 1+ digits is a
+ *   concrete instance → reported (`task-2-report`, `task-1.diff`).
+ *   Placeholders (`task-N-brief`, `task-N-report`, `<plan-id>`,
+ *   `{SDD_DIR}/task-N-report.md`) never match.
+ * - `.mstar/sdd/<segment>` / `.agents/sdd/<segment>` with a concrete first
+ *   segment (`20260815-x`) → reported; `<plan-id>` / `{SDD_DIR}` segments
+ *   are template forms → never match.
+ *
+ * Discovery only — a finder returning an array, same shape as
+ * `findSimplifyMarkers`, NOT a GateResult; callers wrap findings into
+ * `ViolationResult`s (codes `skill.ephemeral.task-artifact` /
+ * `skill.ephemeral.sdd-deeplink`). Citations are reported line by line in
+ * 1-based line order, source order within a line.
+ */
+export declare function findEphemeralCitations(skillText: string): EphemeralCitation[];
 /**
  * Assert the SDD TDD triple is present in a `task-N-report.md` text
  * (mstar-coding-behavior § Integration Notes — "completion evidence must

package/package.json

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