@deftai/directive-core 0.55.0

package/dist/intake/markdown-scanners.js

@@ -0,0 +1,247 @@
+/**
+ * Linear-time markdown scanners for issue body parsing (#1784 / #1248).
+ * Avoids nested/polynomial regex on issue bodies (ReDoS-safe).
+ */
+/** Strip fenced and inline code spans before cross-ref / plan-item extraction. */
+export function stripCodeBlocks(body) {
+    if (body.length === 0) {
+        return "";
+    }
+    let text = stripFencedCodeBlocks(body);
+    text = stripInlineCode(text);
+    return text;
+}
+function stripFencedCodeBlocks(text) {
+    let out = "";
+    let i = 0;
+    while (i < text.length) {
+        const fence = detectFenceOpen(text, i);
+        if (fence === null) {
+            out += text[i];
+            i += 1;
+            continue;
+        }
+        const close = findFenceClose(text, fence.end, fence.delimiter);
+        i = close >= 0 ? close : text.length;
+    }
+    return out;
+}
+function detectFenceOpen(text, index) {
+    if (text.startsWith("```", index)) {
+        return { delimiter: "```", end: index + 3 };
+    }
+    if (text.startsWith("~~~", index)) {
+        return { delimiter: "~~~", end: index + 3 };
+    }
+    return null;
+}
+function findFenceClose(text, start, delimiter) {
+    let i = start;
+    while (i < text.length) {
+        if (text.startsWith(delimiter, i)) {
+            return i + delimiter.length;
+        }
+        i += 1;
+    }
+    return -1;
+}
+function stripInlineCode(text) {
+    let out = "";
+    let i = 0;
+    while (i < text.length) {
+        if (text[i] === "`") {
+            const end = text.indexOf("`", i + 1);
+            if (end < 0 || text.slice(i + 1, end).includes("\n")) {
+                out += text[i];
+                i += 1;
+                continue;
+            }
+            i = end + 1;
+            continue;
+        }
+        out += text[i];
+        i += 1;
+    }
+    return out;
+}
+/** Parse GitHub-flavoured task-list checkboxes line-by-line. */
+export function parseCheckboxItems(text) {
+    const items = [];
+    const seen = new Set();
+    for (const line of text.split("\n")) {
+        const match = matchCheckboxLine(line);
+        if (match === null) {
+            continue;
+        }
+        const title = match.title.trim();
+        if (title.length === 0 || seen.has(title)) {
+            continue;
+        }
+        seen.add(title);
+        items.push({
+            title,
+            status: match.checked ? "completed" : "proposed",
+        });
+    }
+    return items;
+}
+function matchCheckboxLine(line) {
+    let i = 0;
+    while (i < line.length && (line[i] === " " || line[i] === "\t")) {
+        i += 1;
+    }
+    if (i >= line.length || !"-*+".includes(line[i])) {
+        return null;
+    }
+    i += 1;
+    while (i < line.length && (line[i] === " " || line[i] === "\t")) {
+        i += 1;
+    }
+    if (!line.startsWith("[", i)) {
+        return null;
+    }
+    const close = line.indexOf("]", i + 1);
+    if (close < 0) {
+        return null;
+    }
+    const marker = line.slice(i + 1, close);
+    if (marker !== " " && marker !== "x" && marker !== "X") {
+        return null;
+    }
+    let rest = line.slice(close + 1);
+    if (rest.startsWith(" ")) {
+        rest = rest.slice(1);
+    }
+    rest = rest.trimEnd();
+    return { checked: marker.toLowerCase() === "x", title: rest };
+}
+/** Find an Acceptance Criteria heading (case-insensitive). */
+export function findAcHeading(text) {
+    let offset = 0;
+    for (const line of text.split("\n")) {
+        const match = matchAcHeadingLine(line);
+        if (match !== null) {
+            return { level: match.level, sectionStart: offset + match.end };
+        }
+        offset += line.length + 1;
+    }
+    return null;
+}
+function matchAcHeadingLine(line) {
+    if (!line.startsWith("#")) {
+        return null;
+    }
+    let level = 0;
+    while (level < line.length && line[level] === "#") {
+        level += 1;
+    }
+    if (level < 1 || level > 6) {
+        return null;
+    }
+    if (level >= line.length || line[level] !== " ") {
+        return null;
+    }
+    const headingText = line
+        .slice(level + 1)
+        .trim()
+        .toLowerCase();
+    if (!/\bacceptance\s+criteria\b/.test(headingText)) {
+        return null;
+    }
+    return { level, end: line.length };
+}
+/** Slice text until the next heading at the same or higher level. */
+export function sliceAcSection(text, heading) {
+    const after = text.slice(heading.sectionStart);
+    let offset = 0;
+    for (const line of after.split("\n")) {
+        if (offset > 0 && isHeadingAtOrAbove(line, heading.level)) {
+            return after.slice(0, offset);
+        }
+        offset += line.length + 1;
+    }
+    return after;
+}
+function isHeadingAtOrAbove(line, level) {
+    if (!line.startsWith("#")) {
+        return false;
+    }
+    let hashes = 0;
+    while (hashes < line.length && line[hashes] === "#") {
+        hashes += 1;
+    }
+    if (hashes < 1 || hashes > level) {
+        return false;
+    }
+    return hashes <= level && (hashes >= line.length || line[hashes] === " ");
+}
+/** Parse bullet/numbered list items within a section. */
+export function parseListItems(sectionText) {
+    const items = [];
+    const seen = new Set();
+    for (const line of sectionText.split("\n")) {
+        const bullet = matchListItemLine(line);
+        if (bullet === null) {
+            continue;
+        }
+        let title = bullet.trim();
+        let status = "proposed";
+        const cb = matchLeadingCheckbox(title);
+        if (cb !== null) {
+            title = cb.title.trim();
+            if (cb.checked) {
+                status = "completed";
+            }
+        }
+        if (title.length === 0 || seen.has(title)) {
+            continue;
+        }
+        seen.add(title);
+        items.push({ title, status });
+    }
+    return items;
+}
+function matchListItemLine(line) {
+    let i = 0;
+    while (i < line.length && (line[i] === " " || line[i] === "\t")) {
+        i += 1;
+    }
+    if (i >= line.length) {
+        return null;
+    }
+    if ("-*+".includes(line[i])) {
+        i += 1;
+        while (i < line.length && (line[i] === " " || line[i] === "\t")) {
+            i += 1;
+        }
+        return line.slice(i).trimEnd();
+    }
+    const numMatch = /^\d+[.)]/.exec(line.slice(i));
+    if (numMatch === null) {
+        return null;
+    }
+    i += numMatch[0].length;
+    while (i < line.length && (line[i] === " " || line[i] === "\t")) {
+        i += 1;
+    }
+    return line.slice(i).trimEnd();
+}
+function matchLeadingCheckbox(title) {
+    if (!title.startsWith("[")) {
+        return null;
+    }
+    const close = title.indexOf("]");
+    if (close < 0) {
+        return null;
+    }
+    const marker = title.slice(1, close);
+    if (marker !== " " && marker !== "x" && marker !== "X") {
+        return null;
+    }
+    let rest = title.slice(close + 1);
+    if (rest.startsWith(" ")) {
+        rest = rest.slice(1);
+    }
+    return { checked: marker.toLowerCase() === "x", title: rest };
+}
+//# sourceMappingURL=markdown-scanners.js.map

package/dist/intake/parity-scenarios.d.ts

@@ -0,0 +1,22 @@
+/** Shared parity fixture inputs for intake golden-diff (#1784). */
+export declare const SAMPLE_ISSUE_BODY: string;
+export declare const SAMPLE_ISSUE: {
+    readonly number: 500;
+    readonly title: "Widget support";
+    readonly url: "https://github.com/owner/repo/issues/500";
+    readonly body: string;
+    readonly labels: readonly [{
+        readonly name: "enhancement";
+    }];
+};
+export declare const SAMPLE_VBRIEF: {
+    readonly plan: {
+        readonly title: "Emit me";
+        readonly narratives: {
+            readonly Description: "Hello world";
+        };
+    };
+};
+export declare const PARITY_SCENARIO_NAMES: readonly ["issue-ingest-build-vbrief", "issue-ingest-cross-refs", "issue-emit-render-body", "reconcile-classify", "candidates-validate-reject", "github-auth-invalid-mode"];
+export type ParityScenarioName = (typeof PARITY_SCENARIO_NAMES)[number];
+//# sourceMappingURL=parity-scenarios.d.ts.map

package/dist/intake/parity-scenarios.js

@@ -0,0 +1,32 @@
+/** Shared parity fixture inputs for intake golden-diff (#1784). */
+export const SAMPLE_ISSUE_BODY = [
+    "## Summary",
+    "Add widget support to the dashboard.",
+    "",
+    "## Acceptance Criteria",
+    "- [ ] Widget renders in the sidebar",
+    "- [ ] Widget exposes a click handler",
+    "- [x] Spec doc updated",
+].join("\n");
+export const SAMPLE_ISSUE = {
+    number: 500,
+    title: "Widget support",
+    url: "https://github.com/owner/repo/issues/500",
+    body: SAMPLE_ISSUE_BODY,
+    labels: [{ name: "enhancement" }],
+};
+export const SAMPLE_VBRIEF = {
+    plan: {
+        title: "Emit me",
+        narratives: { Description: "Hello world" },
+    },
+};
+export const PARITY_SCENARIO_NAMES = [
+    "issue-ingest-build-vbrief",
+    "issue-ingest-cross-refs",
+    "issue-emit-render-body",
+    "reconcile-classify",
+    "candidates-validate-reject",
+    "github-auth-invalid-mode",
+];
+//# sourceMappingURL=parity-scenarios.js.map

package/dist/intake/platform-capabilities.d.ts

@@ -0,0 +1,11 @@
+/** Minimal runtime capability probe for github_auth_modes (#1557a / #1784). */
+export declare const RUNTIME_MODE_LOCAL_UNSANDBOXED = "local-unsandboxed";
+export declare const RUNTIME_MODE_CURSOR_NATIVE_SANDBOX = "cursor-native-sandbox";
+export declare const RUNTIME_MODE_CLOUD_HEADLESS = "cloud-headless";
+export declare const KNOWN_RUNTIME_MODES: Set<string>;
+export interface RuntimeCapabilityReport {
+    readonly runtimeMode: string;
+}
+export declare function probeRuntimeCapabilities(environ?: NodeJS.ProcessEnv): RuntimeCapabilityReport;
+export declare function getPlatformCapabilities(): RuntimeCapabilityReport;
+//# sourceMappingURL=platform-capabilities.d.ts.map

package/dist/intake/platform-capabilities.js

@@ -0,0 +1,34 @@
+/** Minimal runtime capability probe for github_auth_modes (#1557a / #1784). */
+export const RUNTIME_MODE_LOCAL_UNSANDBOXED = "local-unsandboxed";
+export const RUNTIME_MODE_CURSOR_NATIVE_SANDBOX = "cursor-native-sandbox";
+export const RUNTIME_MODE_CLOUD_HEADLESS = "cloud-headless";
+export const KNOWN_RUNTIME_MODES = new Set([
+    RUNTIME_MODE_LOCAL_UNSANDBOXED,
+    RUNTIME_MODE_CURSOR_NATIVE_SANDBOX,
+    RUNTIME_MODE_CLOUD_HEADLESS,
+]);
+const TRUTHY = new Set(["1", "true", "yes", "on"]);
+function isTruthy(value) {
+    return value !== undefined && TRUTHY.has(value.trim().toLowerCase());
+}
+function classifyRuntimeMode(environ = process.env) {
+    for (const key of ["GROK_BUILD", "GITHUB_ACTIONS", "CI", "BUILDKITE", "DEFT_AGENT_RUNTIME"]) {
+        if (isTruthy(environ[key])) {
+            return RUNTIME_MODE_CLOUD_HEADLESS;
+        }
+    }
+    if (isTruthy(environ.CURSOR_SANDBOX) || isTruthy(environ.CURSOR_SANDBOX_LANDLOCK_STATUS)) {
+        return RUNTIME_MODE_CURSOR_NATIVE_SANDBOX;
+    }
+    if (isTruthy(environ.CURSOR_AGENT) || isTruthy(environ.CURSOR_COMPOSER)) {
+        return RUNTIME_MODE_CLOUD_HEADLESS;
+    }
+    return RUNTIME_MODE_LOCAL_UNSANDBOXED;
+}
+export function probeRuntimeCapabilities(environ = process.env) {
+    return { runtimeMode: classifyRuntimeMode(environ) };
+}
+export function getPlatformCapabilities() {
+    return probeRuntimeCapabilities();
+}
+//# sourceMappingURL=platform-capabilities.js.map

package/dist/intake/reconcile-issues-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function mainEntry(argv?: string[]): number;
+//# sourceMappingURL=reconcile-issues-cli.d.ts.map

package/dist/intake/reconcile-issues-cli.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { reconcileMain } from "./reconcile-issues.js";
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--apply-lifecycle-fixes")
+            out.applyLifecycleFixes = true;
+        else if (arg === "--report-unlinked")
+            out.reportUnlinked = true;
+        else if (arg === "--vbrief-dir")
+            out.vbriefDir = argv[++i];
+        else if (arg === "--repo")
+            out.repo = argv[++i];
+        else if (arg === "--project-root")
+            out.projectRoot = argv[++i];
+        else if (arg === "--format")
+            out.format = argv[++i];
+        else if (arg === "--max-open-issues")
+            out.maxOpenIssues = Number.parseInt(argv[++i], 10);
+    }
+    return out;
+}
+export function mainEntry(argv = process.argv.slice(2)) {
+    return reconcileMain(parseArgs(argv));
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+    process.exit(mainEntry());
+}
+//# sourceMappingURL=reconcile-issues-cli.js.map

package/dist/intake/reconcile-issues.d.ts

@@ -0,0 +1,60 @@
+import { type CallOptions, type CompletedProcess } from "../scm/call.js";
+export declare const LIFECYCLE_FOLDERS: readonly ["proposed", "pending", "active", "completed", "cancelled"];
+export declare const TERMINAL_LIFECYCLE_FOLDERS: Set<string>;
+export declare const GITHUB_ISSUE_REF_TYPES: Set<string>;
+export declare const CANCELLED_STATE_REASONS: Set<string>;
+export declare const ISSUE_FETCH_LIMIT = 1000;
+export declare const GRAPHQL_BATCH_SIZE = 200;
+export declare const DEFAULT_MAX_OPEN_ISSUES = 1000;
+/** GitHub issue state plus optional stateReason (#1290). */
+export declare class IssueState {
+    readonly value: string;
+    readonly stateReason: string | null;
+    constructor(state: string, stateReason?: string | null);
+    toString(): string;
+}
+export declare function stateReasonOf(value: unknown): string | null;
+export declare function isTerminalLifecyclePath(relPath: string): boolean;
+export declare function extractReferencesFromVbrief(data: Record<string, unknown>): Record<string, unknown>[];
+export declare function parseIssueNumber(ref: Record<string, unknown>): number | null;
+export declare function scanVbriefDir(vbriefDir: string): Map<number, string[]>;
+export type ScmCallFn = (source: string, verb: string, args: readonly string[] | null, options?: CallOptions) => CompletedProcess;
+export interface FetchIssuesOptions {
+    readonly cwd?: string | null;
+    readonly scmCall?: ScmCallFn;
+}
+export declare function fetchOpenIssues(repo: string, options?: FetchIssuesOptions): Record<string, unknown>[] | null;
+export declare function fetchAllOpenIssues(repo: string, options?: FetchIssuesOptions): Record<string, unknown>[] | null;
+export interface FetchIssueStatesOptions extends FetchIssuesOptions {
+    readonly batchSize?: number;
+}
+export declare function fetchIssueStates(repo: string, issueNumbers: ReadonlySet<number>, options?: FetchIssueStatesOptions): Map<number, IssueState> | null;
+export interface ReconcileReport {
+    linked: Record<string, unknown>[];
+    no_open_issue: Record<string, unknown>[];
+    unlinked?: Record<string, unknown>[];
+    summary: Record<string, number>;
+}
+export declare function reconcile(issueToVbriefs: Map<number, string[]>, issueStateMap: Map<number, IssueState | string>): ReconcileReport;
+export declare function reconcileWithUnlinked(issueToVbriefs: Map<number, string[]>, openIssues: Record<string, unknown>[]): ReconcileReport;
+export declare function parsePlanRef(data: Record<string, unknown>): number | null;
+export declare function parseParentIssue(data: Record<string, unknown>): number | null;
+export declare function parseDecompositionOrigin(data: Record<string, unknown>): number | null;
+export declare function resolveLifecycleAnchor(data: Record<string, unknown>): [number | null, string];
+export declare function scanLifecycleAnchors(vbriefDir: string): Record<string, unknown>[];
+export declare function buildLifecycleReport(anchors: Record<string, unknown>[], issueStateMap: Map<number, IssueState | string>, log?: boolean): ReconcileReport;
+export declare function formatJson(report: ReconcileReport): string;
+export declare function formatMarkdown(report: ReconcileReport): string;
+export declare function applyLifecycleFixes(vbriefDir: string, report: ReconcileReport, projectRoot?: string | null): [number, number, string[]];
+export declare function detectRepo(): string | null;
+export interface ReconcileCliArgs {
+    vbriefDir?: string;
+    repo?: string | null;
+    projectRoot?: string | null;
+    format?: "json" | "markdown";
+    applyLifecycleFixes?: boolean;
+    reportUnlinked?: boolean;
+    maxOpenIssues?: number;
+}
+export declare function reconcileMain(args: ReconcileCliArgs): number;
+//# sourceMappingURL=reconcile-issues.d.ts.map