@deftai/directive-core 0.55.0

package/dist/content-contracts/skills/greptile-detector.d.ts

@@ -0,0 +1,56 @@
+/** Greptile / SLizard findings detector — TypeScript reference (#910 + #1035 + #1039). */
+interface DetectResult {
+    tier1_p0: number;
+    tier1_p1: number;
+    tier2_p0: number;
+    tier2_p1: number;
+    tier25_p0: number;
+    tier25_p1: number;
+    tier3_sentinel: boolean;
+    p0_count: number;
+    p1_count: number;
+    has_blocking: boolean;
+}
+export declare function parseConfidence(body: string): number | null;
+export declare function detect(body: string): DetectResult;
+export declare function parseLastReviewedShaMarkdownLink(body: string): string | null;
+export declare function parseLastReviewedShaNaiveInline(body: string): string | null;
+export declare const BODY_TIER2_P1_ONLY = "Greptile review of head 1234567\n\nConfidence Score: 4/5\n\nLast reviewed commit: [fix: foo bar](https://github.com/deftai/directive/commit/abcdef1234567)\n\nComments:\n\n- **P1 -- wrong exception type for state/limit validation in populate()**\n  The current code raises ValueError but the contract calls for InvalidRepoError.\n- **P2 -- minor wording in error message**\n  Consider `--repo` instead of `the repo flag`.\n";
+export declare const BODY_TIER3_NOT_SAFE_ONLY = "Greptile review of head 7654321\n\nConfidence Score: 3/5\n\nLast reviewed commit: [refactor: thing](https://github.com/deftai/directive/commit/0011223344556)\n\nSummary: Not safe to merge until the mocked-import test defect and the two\npreviously filed P1s are resolved.\n";
+export declare const BODY_TIER3_COUNT_PROSE_ONLY = "Greptile review of head deadbeef\n\nConfidence Score: 4/5\n\nLast reviewed commit: [chore: bump](https://github.com/deftai/directive/commit/deadbeefcafe123)\n\nThree P1 findings (two from prior review, one new): wrong exception type for\nstate/limit validation in populate(), misleading skip message, and an\nunguarded import that will fail on Windows.\n";
+export declare const BODY_NEGATION_GUARDED = "Greptile review of head ffffffff\n\nConfidence Score: 5/5\n\nLast reviewed commit: [feat: clean](https://github.com/deftai/directive/commit/ffffffffabc1234)\n\nSummary: No P0 findings. Zero P1 findings. The PR is ready for merge.\n";
+export declare const BODY_CLEAN = "Greptile review of head 1111111\n\nConfidence Score: 5/5\n\nLast reviewed commit: [docs: tweak](https://github.com/deftai/directive/commit/1111111aaa2222b)\n\nNo P0 or P1 issues found. The change looks clean and well-tested.\n";
+export declare const BODY_TIER1_BADGES_ONLY = "Greptile review of head 2222222\n\nConfidence Score: 3/5\n\nLast reviewed commit: [fix: thing](https://github.com/deftai/directive/commit/2222222ccc3333d)\n\n<img alt=\"P1\" src=\"https://example.com/p1.png\"> wrong exception type in populate()\n<img alt=\"P1\" src=\"https://example.com/p1.png\"> misleading skip message\n<img alt=\"P0\" src=\"https://example.com/p0.png\"> data-loss risk in cache eviction\n";
+export declare const BODY_SLIZARD_HEADING_P1: string;
+export declare const BODY_SLIZARD_HEADING_NEGATION: string;
+export declare const BODY_CONFIDENCE_HEADING_ONLY: string;
+export declare const BODY_FENCED_IMG_P0: string;
+export declare const BODY_FENCED_NOT_SAFE: string;
+export declare const BODY_UNFENCED_IMG_P0: string;
+export declare const BODY_HTML_CODE_IMG_P0: string;
+export declare const BODY_ESCAPED_BRACKET_LINK_TEXT: string;
+export declare const BODY_AC4_MARKDOWN_LINK_CLEAN: string;
+export declare const BODY_AC4_INLINE_SHA_CLEAN: string;
+export declare const BODY_AC4_THIRD_CONFIDENCE_FORM: string;
+export declare const BODY_AC4_EMPTY = "";
+export declare const BODY_AC4_TRUNCATED: string;
+export declare function evaluateCleanGate(params: {
+    lastReviewedSha: string | null;
+    headSha: string;
+    hasBlocking: boolean;
+    confidence: number | null;
+    ciFailures: number;
+    errored: boolean;
+    terminalCheckRun?: boolean;
+}): [boolean, string | null];
+type PollExitClass = "CLEAN" | "NEW_P0P1" | "ERRORED" | "STALL" | "RUNNING";
+export declare function simulatePollLoop(params: {
+    body: string;
+    headSha: string;
+    ciFailures?: number;
+    maxPolls?: number;
+    stallThreshold?: number;
+    terminalCheckRun?: boolean;
+}): [PollExitClass, number, string | null, string[]];
+export {};
+//# sourceMappingURL=greptile-detector.d.ts.map

package/dist/content-contracts/skills/greptile-detector.js

@@ -0,0 +1,368 @@
+/** Greptile / SLizard findings detector — TypeScript reference (#910 + #1035 + #1039). */
+const CODE_FENCE_RE = /`{3}.*?`{3}/gs;
+const HTML_CODE_RE = /<(code|pre)\b[^>]*>.*?<\/\1>/gis;
+function stripCodeFences(text) {
+    const fencedStripped = text.replace(CODE_FENCE_RE, " ");
+    return fencedStripped.replace(HTML_CODE_RE, " ");
+}
+const TIER2_RE = /^[\s\-*]*\*\*P([01])\b[^*]*\*\*/gm;
+const TIER2_NEGATIONS = ["No ", "Zero ", "0 ", "no "];
+const TIER25_RE = /^#{1,6}\s+P([01])\s*[\u00b7\u2027\u2022-]\s/gm;
+const TIER3_COUNT_RE = /\b(?:One|Two|Three|Four|Five|Six|Seven|Eight|Nine|Ten|\d+)\s+P[01]\s+findings?\b/gi;
+const TIER3_LINE_RE = /^\s*P[01]\s+--\s/gm;
+const TIER3_NEGATIONS = ["No ", "Zero ", "no ", "NO "];
+const CONFIDENCE_INLINE_RE = /Confidence Score:\s*(\d+)\s*\/\s*5/;
+const CONFIDENCE_HEADING_RE = /^#{1,6}\s*Confidence Score:\s*(\d+)\s*\/\s*5\s*$/m;
+const NAIVE_INLINE_SHA_RE = /Last reviewed commit:\s*([0-9a-f]{7,40})/;
+const MARKDOWN_LINK_SHA_RE = /Last reviewed commit:\s*\[.*?\]\(https?:\/\/github\.com\/[^/]+\/[^/]+\/commit\/(?<sha>[0-9a-f]{7,40})/;
+function lineFor(body, pos) {
+    const lineStart = body.lastIndexOf("\n", pos - 1) + 1;
+    const lineEnd = body.indexOf("\n", pos);
+    return body.slice(lineStart, lineEnd === -1 ? undefined : lineEnd);
+}
+export function parseConfidence(body) {
+    let m = CONFIDENCE_INLINE_RE.exec(body);
+    if (m === null) {
+        m = CONFIDENCE_HEADING_RE.exec(body);
+    }
+    return m ? Number.parseInt(m[1] ?? "0", 10) : null;
+}
+export function detect(body) {
+    body = stripCodeFences(body);
+    const tier1_p0 = (body.match(/<img alt="P0"/g) ?? []).length;
+    const tier1_p1 = (body.match(/<img alt="P1"/g) ?? []).length;
+    let tier2_p0 = 0;
+    let tier2_p1 = 0;
+    for (const m of body.matchAll(TIER2_RE)) {
+        const line = lineFor(body, m.index ?? 0);
+        if (TIER2_NEGATIONS.some((neg) => line.includes(neg))) {
+            continue;
+        }
+        if (m[1] === "0") {
+            tier2_p0 += 1;
+        }
+        else {
+            tier2_p1 += 1;
+        }
+    }
+    let tier25_p0 = 0;
+    let tier25_p1 = 0;
+    for (const m of body.matchAll(TIER25_RE)) {
+        const line = lineFor(body, m.index ?? 0);
+        if (TIER2_NEGATIONS.some((neg) => line.includes(neg))) {
+            continue;
+        }
+        if (m[1] === "0") {
+            tier25_p0 += 1;
+        }
+        else {
+            tier25_p1 += 1;
+        }
+    }
+    let tier3_sentinel = false;
+    if (body.includes("Not safe to merge")) {
+        tier3_sentinel = true;
+    }
+    if (!tier3_sentinel) {
+        for (const m of body.matchAll(TIER3_COUNT_RE)) {
+            const line = lineFor(body, m.index ?? 0);
+            if (TIER3_NEGATIONS.some((neg) => line.includes(neg))) {
+                continue;
+            }
+            if (/^\s*0\b/.test(m[0])) {
+                continue;
+            }
+            tier3_sentinel = true;
+            break;
+        }
+    }
+    if (!tier3_sentinel) {
+        for (const m of body.matchAll(TIER3_LINE_RE)) {
+            const line = lineFor(body, m.index ?? 0);
+            if (TIER3_NEGATIONS.some((neg) => line.includes(neg))) {
+                continue;
+            }
+            tier3_sentinel = true;
+            break;
+        }
+    }
+    const p0_count = Math.max(tier1_p0, tier2_p0, tier25_p0);
+    const p1_count = Math.max(tier1_p1, tier2_p1, tier25_p1);
+    const has_blocking = p0_count + p1_count > 0 || tier3_sentinel;
+    return {
+        tier1_p0,
+        tier1_p1,
+        tier2_p0,
+        tier2_p1,
+        tier25_p0,
+        tier25_p1,
+        tier3_sentinel,
+        p0_count,
+        p1_count,
+        has_blocking,
+    };
+}
+export function parseLastReviewedShaMarkdownLink(body) {
+    const m = MARKDOWN_LINK_SHA_RE.exec(body);
+    return m?.groups?.sha ?? null;
+}
+export function parseLastReviewedShaNaiveInline(body) {
+    const m = NAIVE_INLINE_SHA_RE.exec(body);
+    return m?.[1] ?? null;
+}
+const ESCAPED_BRACKET_SHA = "a1b2c3d4e5f60718293a4b5c6d7e8f9001122334";
+export const BODY_TIER2_P1_ONLY = `Greptile review of head 1234567
+
+Confidence Score: 4/5
+
+Last reviewed commit: [fix: foo bar](https://github.com/deftai/directive/commit/abcdef1234567)
+
+Comments:
+
+- **P1 -- wrong exception type for state/limit validation in populate()**
+  The current code raises ValueError but the contract calls for InvalidRepoError.
+- **P2 -- minor wording in error message**
+  Consider \`--repo\` instead of \`the repo flag\`.
+`;
+export const BODY_TIER3_NOT_SAFE_ONLY = `Greptile review of head 7654321
+
+Confidence Score: 3/5
+
+Last reviewed commit: [refactor: thing](https://github.com/deftai/directive/commit/0011223344556)
+
+Summary: Not safe to merge until the mocked-import test defect and the two
+previously filed P1s are resolved.
+`;
+export const BODY_TIER3_COUNT_PROSE_ONLY = `Greptile review of head deadbeef
+
+Confidence Score: 4/5
+
+Last reviewed commit: [chore: bump](https://github.com/deftai/directive/commit/deadbeefcafe123)
+
+Three P1 findings (two from prior review, one new): wrong exception type for
+state/limit validation in populate(), misleading skip message, and an
+unguarded import that will fail on Windows.
+`;
+export const BODY_NEGATION_GUARDED = `Greptile review of head ffffffff
+
+Confidence Score: 5/5
+
+Last reviewed commit: [feat: clean](https://github.com/deftai/directive/commit/ffffffffabc1234)
+
+Summary: No P0 findings. Zero P1 findings. The PR is ready for merge.
+`;
+export const BODY_CLEAN = `Greptile review of head 1111111
+
+Confidence Score: 5/5
+
+Last reviewed commit: [docs: tweak](https://github.com/deftai/directive/commit/1111111aaa2222b)
+
+No P0 or P1 issues found. The change looks clean and well-tested.
+`;
+export const BODY_TIER1_BADGES_ONLY = `Greptile review of head 2222222
+
+Confidence Score: 3/5
+
+Last reviewed commit: [fix: thing](https://github.com/deftai/directive/commit/2222222ccc3333d)
+
+<img alt="P1" src="https://example.com/p1.png"> wrong exception type in populate()
+<img alt="P1" src="https://example.com/p1.png"> misleading skip message
+<img alt="P0" src="https://example.com/p0.png"> data-loss risk in cache eviction
+`;
+export const BODY_SLIZARD_HEADING_P1 = "SLizard review of head 3333333\n" +
+    "\n" +
+    "## Confidence Score: 3/5\n" +
+    "\n" +
+    "Decision: request_changes\n" +
+    "Severity counts: P0: 0, P1: 1\n" +
+    "\n" +
+    "### P1 \u00b7 Inaccurate description claim about ROADMAP.md `## Active` section\n" +
+    "The PR body claims the ROADMAP.md '## Active' section but the section\n" +
+    "does not exist at HEAD; verify the claim before merge.\n" +
+    "\n" +
+    "Last reviewed commit: [fix: stuff](https://github.com/deftai/directive/commit/3333333abcdef12)\n";
+export const BODY_SLIZARD_HEADING_NEGATION = "SLizard review of head 4444444\n" +
+    "\n" +
+    "## Confidence Score: 5/5\n" +
+    "\n" +
+    "Decision: comment\n" +
+    "Severity counts: P0: 0, P1: 0\n" +
+    "\n" +
+    "### No P1 \u00b7 findings -- clean review\n" +
+    "\n" +
+    "Last reviewed commit: [docs: thing](https://github.com/deftai/directive/commit/4444444abcdef12)\n";
+export const BODY_CONFIDENCE_HEADING_ONLY = "SLizard review of head 5555555\n" +
+    "\n" +
+    "## Confidence Score: 3/5\n" +
+    "\n" +
+    "Some body text without inline confidence prose.\n" +
+    "\n" +
+    "Last reviewed commit: [fix: x](https://github.com/deftai/directive/commit/5555555abcdef12)\n";
+export const BODY_FENCED_IMG_P0 = "Greptile review of head 6666666\n" +
+    "\n" +
+    "Confidence Score: 5/5\n" +
+    "\n" +
+    "The PR updates the Tier 1 badge counter. The detector counts badges via:\n" +
+    "\n" +
+    "```python\n" +
+    "tier1_p0 = body.count('<img alt=\"P0\"')\n" +
+    "tier1_p1 = body.count('<img alt=\"P1\"')\n" +
+    "```\n" +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean and well-tested.\n" +
+    "\n" +
+    "Last reviewed commit: [fix: detector](https://github.com/deftai/directive/commit/6666666abcdef12)\n";
+export const BODY_FENCED_NOT_SAFE = "Greptile review of head 7777777\n" +
+    "\n" +
+    "Confidence Score: 5/5\n" +
+    "\n" +
+    "The PR documents the Tier 3 hard-block sentinel. The relevant snippet:\n" +
+    "\n" +
+    "```python\n" +
+    'if "Not safe to merge" in body:\n' +
+    "    tier3_sentinel = True\n" +
+    "```\n" +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean.\n" +
+    "\n" +
+    "Last reviewed commit: [docs: detector](https://github.com/deftai/directive/commit/7777777abcdef12)\n";
+export const BODY_UNFENCED_IMG_P0 = "Greptile review of head 8888888\n" +
+    "\n" +
+    "Confidence Score: 2/5\n" +
+    "\n" +
+    '<img alt="P0" src="https://example.com/p0.png"> data-loss risk in cache eviction\n' +
+    "\n" +
+    "Last reviewed commit: [fix: bug](https://github.com/deftai/directive/commit/8888888abcdef12)\n";
+export const BODY_HTML_CODE_IMG_P0 = "Greptile review of head 9999999\n" +
+    "\n" +
+    "Confidence Score: 5/5\n" +
+    "\n" +
+    "The detector counts badges via <code>body.count('&lt;img alt=\"P0\"')</code>\n" +
+    'and <pre><img alt="P1" src="x"></pre> in the prompt fixtures.\n' +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean.\n" +
+    "\n" +
+    "Last reviewed commit: [chore: x](https://github.com/deftai/directive/commit/9999999abcdef12)\n";
+export const BODY_ESCAPED_BRACKET_LINK_TEXT = "Greptile review of head a1b2c3d\n" +
+    "\n" +
+    "## Confidence Score: 5/5\n" +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean and well-tested.\n" +
+    "\n" +
+    "Last reviewed commit: [docs: add \\[Unreleased\\] entry]" +
+    `(https://github.com/deftai/directive/commit/${ESCAPED_BRACKET_SHA})\n`;
+const HEAD_SHA = "abcdef1234567";
+export const BODY_AC4_MARKDOWN_LINK_CLEAN = "Greptile review of head 1234567\n" +
+    "\n" +
+    "## Confidence Score: 5/5\n" +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean and well-tested.\n" +
+    "\n" +
+    `Last reviewed commit: [fix: foo](https://github.com/deftai/directive/commit/${HEAD_SHA})\n`;
+export const BODY_AC4_INLINE_SHA_CLEAN = "Greptile review of head 1234567\n" +
+    "\n" +
+    "## Confidence Score: 5/5\n" +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean.\n" +
+    "\n" +
+    `Last reviewed commit: ${HEAD_SHA}\n`;
+export const BODY_AC4_THIRD_CONFIDENCE_FORM = "Greptile review of head 1234567\n" +
+    "\n" +
+    "| Metric            | Value |\n" +
+    "| ----------------- | ----- |\n" +
+    "| Confidence Score  | 5 of 5 |\n" +
+    "\n" +
+    "No P0 or P1 issues found. The change looks clean.\n" +
+    "\n" +
+    `Last reviewed commit: [fix: foo](https://github.com/deftai/directive/commit/${HEAD_SHA})\n`;
+export const BODY_AC4_EMPTY = "";
+export const BODY_AC4_TRUNCATED = "Greptile review of head 1234567\n" + "\n" + "## Confidence Score:";
+export function evaluateCleanGate(params) {
+    const { lastReviewedSha, headSha, hasBlocking, confidence, ciFailures, errored, terminalCheckRun = true, } = params;
+    if (lastReviewedSha === null || lastReviewedSha !== headSha) {
+        return [false, "sha_match"];
+    }
+    if (hasBlocking) {
+        return [false, "has_blocking"];
+    }
+    if (confidence === null || confidence <= 3) {
+        return [false, "confidence"];
+    }
+    if (ciFailures > 0) {
+        return [false, "ci_failures"];
+    }
+    if (errored) {
+        return [false, "errored"];
+    }
+    if (!terminalCheckRun) {
+        return [false, "terminal_check_run"];
+    }
+    return [true, null];
+}
+function formatPollLogLine(params) {
+    const { i, cap, lastReviewedSha, headSha, confidence, hasBlocking, p0Count, p1Count, errored, ciFailures, isClean, cleanGateHoldout, } = params;
+    return (`[poll ${i}/${cap}] last_reviewed_sha=${lastReviewedSha} ` +
+        `head=${headSha} sha_match=${lastReviewedSha === headSha} ` +
+        `confidence=${confidence} has_blocking=${hasBlocking} ` +
+        `p0=${p0Count} p1=${p1Count} errored=${errored} ` +
+        `ci_failures=${ciFailures} is_clean=${isClean} ` +
+        `clean_gate_holdout=${cleanGateHoldout}`);
+}
+export function simulatePollLoop(params) {
+    const { body, headSha, ciFailures = 0, maxPolls = 5, stallThreshold = 3, terminalCheckRun = true, } = params;
+    const erroredSentinel = "Greptile encountered an error while reviewing this PR";
+    const lastReviewedSha = parseLastReviewedShaMarkdownLink(body);
+    const confidence = parseConfidence(body);
+    const findings = detect(body);
+    const hasBlocking = findings.has_blocking;
+    const errored = body.trim() === erroredSentinel;
+    let stallStreak = 0;
+    const logLines = [];
+    let lastHoldout = null;
+    for (let i = 1; i <= maxPolls; i += 1) {
+        const [isClean, cleanGateHoldout] = evaluateCleanGate({
+            lastReviewedSha,
+            headSha,
+            hasBlocking,
+            confidence,
+            ciFailures,
+            errored,
+            terminalCheckRun,
+        });
+        lastHoldout = cleanGateHoldout;
+        logLines.push(formatPollLogLine({
+            i,
+            cap: maxPolls,
+            lastReviewedSha,
+            headSha,
+            confidence,
+            hasBlocking,
+            p0Count: findings.p0_count,
+            p1Count: findings.p1_count,
+            errored,
+            ciFailures,
+            isClean,
+            cleanGateHoldout,
+        }));
+        if (isClean) {
+            return ["CLEAN", i, cleanGateHoldout, logLines];
+        }
+        if (hasBlocking && lastReviewedSha === headSha) {
+            return ["NEW_P0P1", i, cleanGateHoldout, logLines];
+        }
+        if (errored) {
+            return ["ERRORED", i, cleanGateHoldout, logLines];
+        }
+        if (!hasBlocking) {
+            stallStreak += 1;
+        }
+        else {
+            stallStreak = 0;
+        }
+        if (stallStreak >= stallThreshold) {
+            return ["STALL", i, cleanGateHoldout, logLines];
+        }
+    }
+    return ["RUNNING", maxPolls, lastHoldout, logLines];
+}
+//# sourceMappingURL=greptile-detector.js.map

package/dist/content-contracts/skills/helpers.d.ts

@@ -0,0 +1,24 @@
+/** Repo root — five levels up from packages/core/src/content-contracts/skills */
+export declare const REPO_ROOT: string;
+export declare function repoPath(...segments: string[]): string;
+/**
+ * Resolve a repo-root-relative content path across both contexts (#1875 C1).
+ * The content/ move relocated shippable content under content/ in the SOURCE
+ * repo; the C1 flatten strips that prefix in a CONSUMER deposit. Probe content/
+ * first (SOURCE layout), then fall back to the repo root so root-resident
+ * harness entries (AGENTS.md) and the flattened consumer layout still resolve.
+ */
+export declare function resolveRepoPath(relPath: string): string;
+export declare function readRepoFile(relPath: string): string;
+export declare function repoFileExists(relPath: string): boolean;
+export declare function readSkill(relPath: string): string;
+export declare function readAgentsMd(): string;
+/** Slice the first `## Returning Sessions` section body out of AGENTS.md. */
+export declare function returningSessionsSection(): string;
+export declare function listSkillMdFiles(): string[];
+export declare const RFC2119_LEGEND = "!=MUST, ~=SHOULD";
+export declare const PLATFORM_DETECTION_HEADING = "## Platform Detection";
+export declare const USER_MD_GATE_HEADING = "## USER.md Gate";
+export declare const DEPRECATED_SKILL_REDIRECT_STUBS: Set<string>;
+export declare const REQUIRED_OSES: Set<string>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/content-contracts/skills/helpers.js

@@ -0,0 +1,73 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Repo root — five levels up from packages/core/src/content-contracts/skills */
+export const REPO_ROOT = join(import.meta.dirname, "..", "..", "..", "..", "..");
+// skills -> content-contracts -> src -> core -> packages -> repo root (5 levels)
+export function repoPath(...segments) {
+    return join(REPO_ROOT, ...segments);
+}
+/**
+ * Resolve a repo-root-relative content path across both contexts (#1875 C1).
+ * The content/ move relocated shippable content under content/ in the SOURCE
+ * repo; the C1 flatten strips that prefix in a CONSUMER deposit. Probe content/
+ * first (SOURCE layout), then fall back to the repo root so root-resident
+ * harness entries (AGENTS.md) and the flattened consumer layout still resolve.
+ */
+export function resolveRepoPath(relPath) {
+    const underContent = join(REPO_ROOT, "content", relPath);
+    if (existsSync(underContent)) {
+        return underContent;
+    }
+    return repoPath(relPath);
+}
+export function readRepoFile(relPath) {
+    return readFileSync(resolveRepoPath(relPath), "utf8");
+}
+export function repoFileExists(relPath) {
+    return existsSync(resolveRepoPath(relPath));
+}
+export function readSkill(relPath) {
+    return readRepoFile(relPath);
+}
+export function readAgentsMd() {
+    return readRepoFile("AGENTS.md");
+}
+/** Slice the first `## Returning Sessions` section body out of AGENTS.md. */
+export function returningSessionsSection() {
+    const text = readAgentsMd();
+    const start = text.indexOf("## Returning Sessions");
+    if (start === -1) {
+        throw new Error("AGENTS.md: missing '## Returning Sessions' section (#696)");
+    }
+    const rest = text.slice(start + "## Returning Sessions".length);
+    const nextHeading = rest.indexOf("\n## ");
+    return nextHeading === -1 ? rest : rest.slice(0, nextHeading);
+}
+export function listSkillMdFiles() {
+    const skillsDir = resolveRepoPath("skills");
+    const results = [];
+    for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            const skillMd = join(skillsDir, entry.name, "SKILL.md");
+            if (existsSync(skillMd)) {
+                results.push(join("skills", entry.name, "SKILL.md"));
+            }
+        }
+    }
+    return results.sort();
+}
+export const RFC2119_LEGEND = "!=MUST, ~=SHOULD";
+export const PLATFORM_DETECTION_HEADING = "## Platform Detection";
+export const USER_MD_GATE_HEADING = "## USER.md Gate";
+export const DEPRECATED_SKILL_REDIRECT_STUBS = new Set([
+    "deft-build",
+    "deft-interview",
+    "deft-pre-pr",
+    "deft-review-cycle",
+    "deft-roadmap-refresh",
+    "deft-setup",
+    "deft-swarm",
+    "deft-sync",
+]);
+export const REQUIRED_OSES = new Set(["darwin", "linux", "windows"]);
+//# sourceMappingURL=helpers.js.map

package/dist/content-contracts/skills/skill-frontmatter.d.ts

@@ -0,0 +1,7 @@
+import { REQUIRED_OSES } from "./helpers.js";
+export { REQUIRED_OSES };
+/** Discover every `SKILL.md` in the repo (repo-relative paths). */
+export declare function skillMdRelPaths(): string[];
+/** Extract declared OS tokens from a skill's YAML frontmatter, or `null` if absent. */
+export declare function declaredOses(relPath: string): string[] | null;
+//# sourceMappingURL=skill-frontmatter.d.ts.map

package/dist/content-contracts/skills/skill-frontmatter.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { REPO_ROOT, REQUIRED_OSES } from "./helpers.js";
+export { REQUIRED_OSES };
+const OS_LINE = /^os\s*:\s*\[(?<body>[^\]]*)\]\s*$/m;
+const OS_TOKEN = /['"]([^'"]+)['"]/g;
+const EXCLUDED_PARTS = new Set([".git", ".venv", "venv", "node_modules", "__pycache__"]);
+function frontmatter(text) {
+    if (!text.startsWith("---")) {
+        return null;
+    }
+    const closing = /^---\s*$/m.exec(text.slice(3));
+    if (closing === null) {
+        return null;
+    }
+    return text.slice(3, 3 + (closing.index ?? 0));
+}
+function parseOsArray(fm) {
+    const match = OS_LINE.exec(fm);
+    if (match === null) {
+        return null;
+    }
+    const body = match.groups?.body ?? "";
+    return [...body.matchAll(OS_TOKEN)].map((m) => m[1] ?? "");
+}
+function pathHasExcludedPart(filePath) {
+    const parts = filePath.split(/[/\\]/);
+    return parts.some((part) => EXCLUDED_PARTS.has(part));
+}
+function discoverSkillMdFiles(dir, results) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (EXCLUDED_PARTS.has(entry.name)) {
+                continue;
+            }
+            discoverSkillMdFiles(fullPath, results);
+        }
+        else if (entry.name === "SKILL.md") {
+            if (!pathHasExcludedPart(fullPath)) {
+                results.push(relative(REPO_ROOT, fullPath).replace(/\\/g, "/"));
+            }
+        }
+    }
+}
+/** Discover every `SKILL.md` in the repo (repo-relative paths). */
+export function skillMdRelPaths() {
+    const results = [];
+    discoverSkillMdFiles(REPO_ROOT, results);
+    return results.sort();
+}
+/** Extract declared OS tokens from a skill's YAML frontmatter, or `null` if absent. */
+export function declaredOses(relPath) {
+    const fullPath = join(REPO_ROOT, relPath);
+    if (!existsSync(fullPath)) {
+        return null;
+    }
+    const text = readFileSync(fullPath, "utf8");
+    const fm = frontmatter(text);
+    if (fm === null) {
+        return null;
+    }
+    return parseOsArray(fm);
+}
+//# sourceMappingURL=skill-frontmatter.js.map

package/dist/content-contracts/standards/_helpers.d.ts

@@ -0,0 +1,49 @@
+/** Repo root (deft framework checkout). */
+export declare function repoRoot(): string;
+/**
+ * Resolve a repo-root-relative content path across both contexts (#1875 C1).
+ *
+ * The content/ move relocated every shippable asset under a single content/
+ * root in the SOURCE repo; the C1 flatten strips that prefix in a CONSUMER
+ * deposit. These content-contract tests address content by its consumer-relative
+ * path (e.g. `coding/coding.md`, `strategies/README.md`). Probe content/ first
+ * so the SOURCE layout resolves, then fall back to the repo root so root-resident
+ * entries (harness-entry main.md/AGENTS.md, repo-dev tests/, README.md, etc.)
+ * and the flattened consumer layout both still resolve. Mirrors
+ * scripts/_content_root.py + content-root.ts::contentRoot.
+ */
+export declare function resolveContentPath(relPath: string): string;
+export declare function readText(relPath: string): string;
+export declare function readAbs(absPath: string): string;
+export declare function pathExists(relPath: string): boolean;
+export interface KnownFailure {
+    check?: string;
+    file?: string;
+    composite_key?: string;
+    xfail?: boolean;
+    exempt?: boolean;
+}
+export declare function loadKnownFailures(): KnownFailure[];
+export declare function xfailFiles(check: string): Set<string>;
+export declare function exemptFiles(check: string): Set<string>;
+export declare function xfailComposite(check: string): Set<string>;
+export declare function isMigrationArtifact(rel: string): boolean;
+/** All .md paths relative to repo root. */
+export declare function allMdFiles(excludeTrees?: string[]): string[];
+export declare function mdFilesInDir(dirname: string): string[];
+export declare function contentAfterBanner(text: string): string;
+export declare function locateSection(text: string, heading: string): number;
+export declare function internalLinks(relPath: string): Array<{
+    target: string;
+    resolved: string;
+}>;
+export declare function seeAlsoLinks(): Array<{
+    source: string;
+    target: string;
+    resolved: string;
+}>;
+export declare function parseStrategyFilenames(): string[];
+export declare function loadJson(relPath: string): unknown;
+export declare function isDir(relPath: string): boolean;
+export declare function isFile(relPath: string): boolean;
+//# sourceMappingURL=_helpers.d.ts.map