@slowcook-ai/cli 0.19.0-alpha.8 → 0.19.0

package/dist/commands/refine/git-attention.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @slowcook 0.19.0-alpha.43 — git-history attention layer for the refine
+ * history-index.
+ *
+ * Motivated by the "Attention Is All You Need" thread (memory:
+ * project_bounded_attention_validation_2026_04_25): a brownfield repo IS
+ * the product of a sequential process (git commits). Versioning history
+ * — diffs, commit messages, PR descriptions, specs — is a strong signal
+ * for which existing components/props/tests/routes/migrations are most
+ * relevant to a new story, BUT raw commit history is noisy. We extract
+ * four narrower signals:
+ *
+ *   1. Rename chains       — `git log --follow` so look-ups don't miss
+ *                            historical names (e.g. ReactionsPage →
+ *                            MemberReactionsPage).
+ *   2. Change-coupling     — file pairs that co-change in the same
+ *                            commits; surfaces architectural couplings
+ *                            file-system layout misses.
+ *   3. Recent PRs per file — PR descriptions are higher-quality "Keys"
+ *                            than raw commit messages because they're
+ *                            intent-shaped, not change-shaped.
+ *   4. PR+spec corpus      — flat searchable index of PR descriptions
+ *                            and spec yaml summaries so downstream agents
+ *                            can keyword-retrieve prior intent before
+ *                            writing new code.
+ *
+ * Deliberately deterministic (no embeddings). Embedding upgrade is a
+ * future Phase 3 step; this lower-cost version ships the contract first.
+ *
+ * All four are graceful-degradation: missing git history, missing gh,
+ * unauthenticated gh, no PRs, no specs — each path returns an empty
+ * structure plus a warning string. The orchestrator NEVER throws.
+ */
+export interface CoChangeEntry {
+    /** repo-relative path of the co-changing file */
+    file: string;
+    /** fraction of this file's co-change events that landed on `file` (0..1, 2dp) */
+    strength: number;
+}
+export interface PRRecord {
+    number: number;
+    title: string;
+    body: string;
+    merged_at: string | null;
+    files: string[];
+}
+export interface PRSpecCorpusEntry {
+    source: "pr" | "spec";
+    /** Stable id: "pr#123" or "spec:story-007". */
+    id: string;
+    title: string;
+    /** First ~500 chars of the body / spec summary. */
+    excerpt: string;
+    /** Files touched (empty for specs). */
+    files_touched: string[];
+    /** ISO date or "" if not applicable. */
+    date: string;
+    /** Lower-cased, stopword-stripped tokens for cheap keyword retrieval. */
+    tokens: string[];
+}
+export interface GitAttentionData {
+    enriched_at: string;
+    /** current_file -> historical paths it was renamed from, newest-first. */
+    rename_chains: Record<string, string[]>;
+    /** file -> top-K co-changing files (by frequency in same commits). */
+    co_changes: Record<string, CoChangeEntry[]>;
+    /** file -> last 5 PRs that touched it (newest-first; merged before open). */
+    recent_prs_by_file: Record<string, PRRecord[]>;
+    /** Flat searchable corpus of PR descriptions + spec yaml summaries. */
+    pr_spec_corpus: PRSpecCorpusEntry[];
+    /** Non-fatal degradation notices ("gh not installed", "git history shallow", etc.). */
+    warnings: string[];
+}
+export interface GitAttentionOptions {
+    repoRoot: string;
+    /** Files we want enrichment for (typically the union of components/api/tests/migrations from the history index). */
+    trackedFiles: string[];
+    /** Months of git log to consider for co-change. Default 6. */
+    coChangeWindowMonths?: number;
+    /** Skip commits with more files than this (mass refactor filter). Default 50. */
+    coChangeMaxFilesPerCommit?: number;
+    /** How many co-changes to keep per file. Default 5. */
+    coChangesPerFile?: number;
+    /** How many recent PRs to fetch from gh. Default 50. */
+    prsToFetch?: number;
+    /** Injectable for tests: override `git -C <root> ...` */
+    gitExec?: (cmd: string) => string;
+    /** Injectable for tests: override `gh ...` */
+    ghExec?: (cmd: string) => string;
+}
+export declare function computeGitAttention(opts: GitAttentionOptions): GitAttentionData;
+export declare function computeRenameChains(files: string[], git: (cmd: string) => string): Record<string, string[]>;
+/**
+ * Parse `git log --follow --name-status -M` output for a single file.
+ * Each rename is a line `R<score>\told\tnew`. Returns OLD paths in the
+ * order git reports them (newest commit first, so most-recent rename
+ * is index 0).
+ */
+export declare function parseRenameChain(stdout: string, currentFile: string): string[];
+export interface CoChangeBuildOptions {
+    windowMonths: number;
+    maxFilesPerCommit: number;
+    topPerFile: number;
+}
+export declare function computeCoChanges(trackedFiles: string[], git: (cmd: string) => string, opts: CoChangeBuildOptions): Record<string, CoChangeEntry[]>;
+export declare function parseLogIntoCommits(stdout: string): Array<{
+    sha: string;
+    files: string[];
+}>;
+export declare function fetchRecentPRs(gh: (cmd: string) => string, limit: number): PRRecord[];
+export declare function parseGhPRList(stdout: string): PRRecord[];
+export declare function indexPRsByFile(prs: PRRecord[], files: string[]): Record<string, PRRecord[]>;
+/**
+ * Lowercase, stopword-stripped, deduped token list capped at 60. Cheap
+ * substitute for embeddings — agents can intersect query tokens with
+ * each corpus entry's `tokens` to rank relevance without an LLM call.
+ *
+ * Embedding upgrade is Phase 3 (slowcook 0.14.0+, evidence-gated). Until
+ * then this is what we ship.
+ */
+export declare function tokeniseForCorpus(text: string): string[];
+export declare function buildPRSpecCorpus(prs: PRRecord[], repoRoot: string): PRSpecCorpusEntry[];
+//# sourceMappingURL=git-attention.d.ts.map

package/dist/commands/refine/git-attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-attention.d.ts","sourceRoot":"","sources":["../../../src/commands/refine/git-attention.ts"],"names":[],"mappings":"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"}

package/dist/commands/refine/git-attention.js

@@ -0,0 +1,378 @@
+/**
+ * @slowcook 0.19.0-alpha.43 — git-history attention layer for the refine
+ * history-index.
+ *
+ * Motivated by the "Attention Is All You Need" thread (memory:
+ * project_bounded_attention_validation_2026_04_25): a brownfield repo IS
+ * the product of a sequential process (git commits). Versioning history
+ * — diffs, commit messages, PR descriptions, specs — is a strong signal
+ * for which existing components/props/tests/routes/migrations are most
+ * relevant to a new story, BUT raw commit history is noisy. We extract
+ * four narrower signals:
+ *
+ *   1. Rename chains       — `git log --follow` so look-ups don't miss
+ *                            historical names (e.g. ReactionsPage →
+ *                            MemberReactionsPage).
+ *   2. Change-coupling     — file pairs that co-change in the same
+ *                            commits; surfaces architectural couplings
+ *                            file-system layout misses.
+ *   3. Recent PRs per file — PR descriptions are higher-quality "Keys"
+ *                            than raw commit messages because they're
+ *                            intent-shaped, not change-shaped.
+ *   4. PR+spec corpus      — flat searchable index of PR descriptions
+ *                            and spec yaml summaries so downstream agents
+ *                            can keyword-retrieve prior intent before
+ *                            writing new code.
+ *
+ * Deliberately deterministic (no embeddings). Embedding upgrade is a
+ * future Phase 3 step; this lower-cost version ships the contract first.
+ *
+ * All four are graceful-degradation: missing git history, missing gh,
+ * unauthenticated gh, no PRs, no specs — each path returns an empty
+ * structure plus a warning string. The orchestrator NEVER throws.
+ */
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+export function computeGitAttention(opts) {
+    const warnings = [];
+    const git = opts.gitExec ?? defaultGit(opts.repoRoot);
+    const gh = opts.ghExec ?? defaultGh();
+    let isRepo = true;
+    try {
+        git("rev-parse --git-dir");
+    }
+    catch (e) {
+        isRepo = false;
+        warnings.push(`Not a git repo (${e.message.slice(0, 80)}); git-history signals skipped.`);
+    }
+    let rename_chains = {};
+    let co_changes = {};
+    if (isRepo) {
+        try {
+            rename_chains = computeRenameChains(opts.trackedFiles, git);
+        }
+        catch (e) {
+            warnings.push(`Rename detection failed: ${e.message.slice(0, 120)}`);
+        }
+        try {
+            co_changes = computeCoChanges(opts.trackedFiles, git, {
+                windowMonths: opts.coChangeWindowMonths ?? 6,
+                maxFilesPerCommit: opts.coChangeMaxFilesPerCommit ?? 50,
+                topPerFile: opts.coChangesPerFile ?? 5,
+            });
+        }
+        catch (e) {
+            warnings.push(`Co-change matrix failed: ${e.message.slice(0, 120)}`);
+        }
+    }
+    let prs = [];
+    let recent_prs_by_file = {};
+    try {
+        prs = fetchRecentPRs(gh, opts.prsToFetch ?? 50);
+        recent_prs_by_file = indexPRsByFile(prs, opts.trackedFiles);
+    }
+    catch (e) {
+        warnings.push(`gh pr list failed (PR-as-Key signal skipped): ${e.message.slice(0, 120)}`);
+    }
+    let pr_spec_corpus = [];
+    try {
+        pr_spec_corpus = buildPRSpecCorpus(prs, opts.repoRoot);
+    }
+    catch (e) {
+        warnings.push(`PR+spec corpus build failed: ${e.message.slice(0, 120)}`);
+    }
+    return {
+        enriched_at: new Date().toISOString(),
+        rename_chains,
+        co_changes,
+        recent_prs_by_file,
+        pr_spec_corpus,
+        warnings,
+    };
+}
+// ─── git/gh execution shims ─────────────────────────────────────────────
+function defaultGit(repoRoot) {
+    return (cmd) => execSync(`git -C "${repoRoot}" ${cmd}`, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        maxBuffer: 50 * 1024 * 1024,
+    });
+}
+function defaultGh() {
+    return (cmd) => execSync(`gh ${cmd}`, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        maxBuffer: 50 * 1024 * 1024,
+    });
+}
+// ─── rename chains ──────────────────────────────────────────────────────
+export function computeRenameChains(files, git) {
+    const out = {};
+    for (const file of files) {
+        if (file.includes('"') || file.includes("`"))
+            continue; // refuse shell-injection candidates
+        let stdout = "";
+        try {
+            stdout = git(`log --follow --name-status -M --pretty=format:"" -- "${file}"`);
+        }
+        catch {
+            continue; // per-file failures are fine (file may not be tracked)
+        }
+        const chain = parseRenameChain(stdout, file);
+        if (chain.length > 0)
+            out[file] = chain;
+    }
+    return out;
+}
+/**
+ * Parse `git log --follow --name-status -M` output for a single file.
+ * Each rename is a line `R<score>\told\tnew`. Returns OLD paths in the
+ * order git reports them (newest commit first, so most-recent rename
+ * is index 0).
+ */
+export function parseRenameChain(stdout, currentFile) {
+    const renames = [];
+    for (const rawLine of stdout.split("\n")) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (!line.startsWith("R"))
+            continue;
+        const parts = line.split("\t");
+        if (parts.length < 3)
+            continue;
+        const oldPath = parts[1];
+        if (oldPath === currentFile)
+            continue;
+        if (renames.includes(oldPath))
+            continue;
+        renames.push(oldPath);
+    }
+    return renames;
+}
+export function computeCoChanges(trackedFiles, git, opts) {
+    const since = isoDaysAgo(opts.windowMonths * 30);
+    const stdout = git(`log --name-only --pretty=format:"COMMIT %H" --since="${since}"`);
+    const commits = parseLogIntoCommits(stdout);
+    const tracked = new Set(trackedFiles);
+    const counts = new Map();
+    for (const file of trackedFiles)
+        counts.set(file, new Map());
+    for (const commit of commits) {
+        if (commit.files.length === 0 || commit.files.length > opts.maxFilesPerCommit)
+            continue;
+        if (!commit.files.some((f) => tracked.has(f)))
+            continue;
+        for (const a of commit.files) {
+            if (!tracked.has(a))
+                continue;
+            const aMap = counts.get(a);
+            for (const b of commit.files) {
+                if (b === a)
+                    continue;
+                aMap.set(b, (aMap.get(b) ?? 0) + 1);
+            }
+        }
+    }
+    const out = {};
+    for (const [file, others] of counts) {
+        if (others.size === 0)
+            continue;
+        const total = Array.from(others.values()).reduce((s, n) => s + n, 0);
+        const sorted = Array.from(others.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, opts.topPerFile)
+            .map(([f, c]) => ({ file: f, strength: round2(c / Math.max(total, 1)) }));
+        out[file] = sorted;
+    }
+    return out;
+}
+export function parseLogIntoCommits(stdout) {
+    const commits = [];
+    let current = null;
+    for (const rawLine of stdout.split("\n")) {
+        const line = rawLine.trim();
+        if (line.startsWith("COMMIT ")) {
+            if (current)
+                commits.push(current);
+            current = { sha: line.slice("COMMIT ".length), files: [] };
+        }
+        else if (line.length > 0 && current) {
+            current.files.push(line);
+        }
+    }
+    if (current)
+        commits.push(current);
+    return commits;
+}
+function isoDaysAgo(days) {
+    const d = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+    return d.toISOString().slice(0, 10);
+}
+function round2(x) {
+    return Math.round(x * 100) / 100;
+}
+// ─── recent PRs via gh ──────────────────────────────────────────────────
+export function fetchRecentPRs(gh, limit) {
+    const stdout = gh(`pr list --state all --limit ${limit} --json number,title,body,mergedAt,files`);
+    return parseGhPRList(stdout);
+}
+export function parseGhPRList(stdout) {
+    let raw;
+    try {
+        raw = JSON.parse(stdout);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const filesField = o.files;
+        const files = Array.isArray(filesField)
+            ? filesField
+                .map((f) => f && typeof f === "object"
+                ? f.path
+                : null)
+                .filter((p) => typeof p === "string")
+            : [];
+        out.push({
+            number: typeof o.number === "number" ? o.number : 0,
+            title: typeof o.title === "string" ? o.title : "",
+            body: typeof o.body === "string" ? o.body : "",
+            merged_at: typeof o.mergedAt === "string" ? o.mergedAt : null,
+            files,
+        });
+    }
+    return out;
+}
+export function indexPRsByFile(prs, files) {
+    const out = {};
+    const tracked = new Set(files);
+    for (const pr of prs) {
+        for (const f of pr.files) {
+            if (!tracked.has(f))
+                continue;
+            (out[f] ??= []).push(pr);
+        }
+    }
+    for (const key of Object.keys(out)) {
+        out[key].sort((a, b) => {
+            if (a.merged_at === b.merged_at)
+                return b.number - a.number;
+            if (!a.merged_at)
+                return -1; // open PRs first
+            if (!b.merged_at)
+                return 1;
+            return a.merged_at < b.merged_at ? 1 : -1;
+        });
+        out[key] = out[key].slice(0, 5);
+    }
+    return out;
+}
+// ─── PR + spec corpus ───────────────────────────────────────────────────
+const STOPWORDS = new Set([
+    "the", "and", "for", "with", "that", "this", "from", "into", "over", "under",
+    "when", "where", "what", "how", "why", "not", "but", "you", "your", "our", "its",
+    "are", "was", "were", "has", "have", "had", "can", "may", "might", "will", "would",
+    "should", "could", "does", "did", "done", "than", "then", "also", "just", "like",
+    "use", "using", "used", "make", "made", "get", "got", "set", "new", "old", "add",
+    "added", "fix", "fixed", "update", "updated", "remove", "removed", "pull",
+    "request", "merge", "branch", "commit", "file", "files", "code", "main", "alpha",
+    "beta", "wip", "tbd", "docs", "doc", "feat", "chore", "refactor", "src", "test", "tests",
+]);
+/**
+ * Lowercase, stopword-stripped, deduped token list capped at 60. Cheap
+ * substitute for embeddings — agents can intersect query tokens with
+ * each corpus entry's `tokens` to rank relevance without an LLM call.
+ *
+ * Embedding upgrade is Phase 3 (slowcook 0.14.0+, evidence-gated). Until
+ * then this is what we ship.
+ */
+export function tokeniseForCorpus(text) {
+    const raw = text.toLowerCase().match(/[a-z][a-z0-9_-]{2,}/g) ?? [];
+    const seen = new Set();
+    const out = [];
+    for (const tok of raw) {
+        if (STOPWORDS.has(tok))
+            continue;
+        if (seen.has(tok))
+            continue;
+        seen.add(tok);
+        out.push(tok);
+        if (out.length >= 60)
+            break;
+    }
+    return out;
+}
+export function buildPRSpecCorpus(prs, repoRoot) {
+    const out = [];
+    for (const pr of prs) {
+        out.push({
+            source: "pr",
+            id: `pr#${pr.number}`,
+            title: pr.title,
+            excerpt: trimExcerpt(pr.body, 500),
+            files_touched: pr.files,
+            date: pr.merged_at ?? "",
+            tokens: tokeniseForCorpus(`${pr.title}\n${pr.body}\n${pr.files.join(" ")}`),
+        });
+    }
+    const specsDir = join(repoRoot, "specs");
+    if (existsSync(specsDir)) {
+        let entries = [];
+        try {
+            entries = readdirSync(specsDir)
+                .filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"))
+                .sort();
+        }
+        catch {
+            return out;
+        }
+        for (const name of entries) {
+            const full = join(specsDir, name);
+            let raw = "";
+            try {
+                raw = readFileSync(full, "utf8");
+            }
+            catch {
+                continue;
+            }
+            let title = "";
+            let summary = "";
+            try {
+                const parsed = YAML.parse(raw);
+                if (parsed && typeof parsed === "object") {
+                    title = typeof parsed.title === "string" ? parsed.title : "";
+                    summary = typeof parsed.summary === "string" ? parsed.summary : "";
+                }
+            }
+            catch {
+                // malformed yaml — index raw text anyway
+            }
+            out.push({
+                source: "spec",
+                id: `spec:${name.replace(/\.(yaml|yml)$/, "")}`,
+                title,
+                excerpt: summary || trimExcerpt(raw, 500),
+                files_touched: [],
+                date: "",
+                tokens: tokeniseForCorpus(`${title}\n${summary}\n${raw}`),
+            });
+        }
+    }
+    return out;
+}
+function trimExcerpt(text, limit) {
+    const trimmed = (text || "").trim();
+    if (trimmed.length <= limit)
+        return trimmed;
+    return trimmed.slice(0, limit) + " …";
+}
+//# sourceMappingURL=git-attention.js.map

package/dist/commands/refine/git-attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-attention.js","sourceRoot":"","sources":["../../../src/commands/refine/git-attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,MAAM,CAAC;AAgExB,MAAM,UAAU,mBAAmB,CAAC,IAAyB;IAC3D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;IAEtC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,KAAK,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,mBAAoB,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,iCAAiC,CAAC,CAAC;IACvG,CAAC;IAED,IAAI,aAAa,GAA6B,EAAE,CAAC;IACjD,IAAI,UAAU,GAAoC,EAAE,CAAC;IAErD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,4BAA6B,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC;YACH,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;gBACpD,YAAY,EAAE,IAAI,CAAC,oBAAoB,IAAI,CAAC;gBAC5C,iBAAiB,EAAE,IAAI,CAAC,yBAAyB,IAAI,EAAE;gBACvD,UAAU,EAAE,IAAI,CAAC,gBAAgB,IAAI,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,4BAA6B,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,IAAI,GAAG,GAAe,EAAE,CAAC;IACzB,IAAI,kBAAkB,GAA+B,EAAE,CAAC;IACxD,IAAI,CAAC;QACH,GAAG,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAChD,kBAAkB,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CACX,iDAAkD,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,GAAwB,EAAE,CAAC;IAC7C,IAAI,CAAC;QACH,cAAc,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,gCAAiC,CAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,aAAa;QACb,UAAU;QACV,kBAAkB;QAClB,cAAc;QACd,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,CAAC,GAAW,EAAE,EAAE,CACrB,QAAQ,CAAC,WAAW,QAAQ,KAAK,GAAG,EAAE,EAAE;QACtC,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;AACP,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAW,EAAE,EAAE,CACrB,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE;QACpB,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;AACP,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,mBAAmB,CACjC,KAAe,EACf,GAA4B;IAE5B,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,oCAAoC;QAC5F,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,wDAAwD,IAAI,GAAG,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,uDAAuD;QACnE,CAAC;QACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,WAAmB;IAClE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,WAAW;YAAE,SAAS;QACtC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACxC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAUD,MAAM,UAAU,gBAAgB,CAC9B,YAAsB,EACtB,GAA4B,EAC5B,IAA0B;IAE1B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,GAAG,CAAC,wDAAwD,KAAK,GAAG,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,YAAY;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB;YAAE,SAAS;QACxF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACtB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc;IAEd,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,IAAI,OAAO,GAA4C,IAAI,CAAC;IAC5D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,IAAI,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC7D,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACnC,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,cAAc,CAC5B,EAA2B,EAC3B,KAAa;IAEb,MAAM,MAAM,GAAG,EAAE,CAAC,+BAA+B,KAAK,0CAA0C,CAAC,CAAC;IAClG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QAChD,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC;QAC3B,MAAM,KAAK,GAAa,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YAC/C,CAAC,CAAC,UAAU;iBACP,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBACxB,CAAC,CAAG,CAA6B,CAAC,IAAgB;gBAClD,CAAC,CAAC,IAAI,CACT;iBACA,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACnD,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACjD,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YAC9C,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;YAC7D,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,GAAe,EACf,KAAe;IAEf,MAAM,GAAG,GAA+B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC9B,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;gBAAE,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YAC5D,IAAI,CAAC,CAAC,CAAC,SAAS;gBAAE,OAAO,CAAC,CAAC,CAAC,CAAC,iBAAiB;YAC9C,IAAI,CAAC,CAAC,CAAC,SAAS;gBAAE,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2EAA2E;AAE3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,OAAO;IACnE,MAAM,EAAC,OAAO,EAAC,MAAM,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,EAAC,KAAK;IACtE,KAAK,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO;IACxE,QAAQ,EAAC,OAAO,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM;IACvE,KAAK,EAAC,OAAO,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK,EAAC,KAAK;IACtE,OAAO,EAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,EAAC,SAAS,EAAC,QAAQ,EAAC,SAAS,EAAC,MAAM;IAClE,SAAS,EAAC,OAAO,EAAC,QAAQ,EAAC,QAAQ,EAAC,MAAM,EAAC,OAAO,EAAC,MAAM,EAAC,MAAM,EAAC,OAAO;IACxE,MAAM,EAAC,KAAK,EAAC,KAAK,EAAC,MAAM,EAAC,KAAK,EAAC,MAAM,EAAC,OAAO,EAAC,UAAU,EAAC,KAAK,EAAC,MAAM,EAAC,OAAO;CAC/E,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACd,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;YAAE,MAAM;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,GAAe,EACf,QAAgB;IAEhB,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,IAAI;YACZ,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE;YACrB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;YAClC,aAAa,EAAE,EAAE,CAAC,KAAK;YACvB,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,EAAE;YACxB,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC;iBAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACxD,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAClC,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmC,CAAC;gBACjE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACzC,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;YACD,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,MAAM;gBACd,EAAE,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,EAAE;gBAC/C,KAAK;gBACL,OAAO,EAAE,OAAO,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;gBACzC,aAAa,EAAE,EAAE;gBACjB,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,iBAAiB,CAAC,GAAG,KAAK,KAAK,OAAO,KAAK,GAAG,EAAE,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,MAAM,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,OAAO,CAAC;IAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC"}

package/dist/commands/refine/history-index.d.ts

@@ -17,6 +17,7 @@
  * Pure functions over the filesystem. No LLM. Generated on every refine
  * invocation so it's always current.
  */
+import type { GitAttentionData } from "./git-attention.js";
 export interface ComponentEntry {
     /** PascalCase component name (the default-export or first named export). */
     name: string;
@@ -59,6 +60,30 @@ export interface TestFileEntry {
     /** describe / it titles found in the file (best-effort regex). */
     test_names: string[];
 }
+/**
+ * A mock page or component, captured so refine can answer
+ * "match the mock" without making the PM cite paths.
+ *
+ * 0.19.0-α.23 — added because real PM issues describe user pain
+ * ("registration should look like the mock"), and the indexer
+ * previously only saw production `src/`. Refine then either
+ * hallucinated a design or had to ask. Surfacing mock files in
+ * context closes the loop: PM says "as mock" → refine reads the
+ * actual mock excerpt → spec mirrors it.
+ *
+ * The excerpt is bounded to the first ~1.5KB so refine's prompt
+ * doesn't blow up on a 5KB mock file.
+ */
+export interface MockEntry {
+    /** repo-relative path. */
+    file: string;
+    /** Route inferred from app/router-shape file location, or null for components. */
+    route: string | null;
+    /** Component or page name (best-effort extraction, falls back to file basename). */
+    name: string;
+    /** First ~1500 chars of the file (after trimming whitespace) so refine sees the actual JSX/markup. */
+    excerpt: string;
+}
 export interface HistoryIndex {
     generated_at: string;
     generator: "slowcook-refine-history-index@0.17.0";
@@ -67,6 +92,14 @@ export interface HistoryIndex {
     migrations: MigrationEntry[];
     test_helpers: TestHelperEntry[];
     test_files: TestFileEntry[];
+    /** 0.19.0-α.23 — mock surface (design source-of-truth). */
+    mock_surface: MockEntry[];
+    /**
+     * 0.19.0-α.43 — git-history attention layer. Set when enrichment ran
+     * (refine emits with it on by default; pure-filesystem callers / tests
+     * may leave it undefined). See git-attention.ts for the four sub-signals.
+     */
+    git_attention?: GitAttentionData;
 }
 interface BuildOptions {
     repoRoot: string;
@@ -77,8 +110,41 @@ interface BuildOptions {
         migrations?: string;
         tests?: string;
         helpers?: string;
+        /** Default: `mock/src` (matches slowcook init scaffold). */
+        mockRoot?: string;
     };
 }
 export declare function buildHistoryIndex(opts: BuildOptions): HistoryIndex;
+export declare const TYPEORM_MIGRATION_FALLBACK_DIRS: string[];
+/**
+ * The columns `DatabaseCreateTable` (delgoosh's helper) adds implicitly on
+ * EVERY table. Knowing these prevents the migration gate from raising a
+ * false-positive "missing column" verdict when the spec references e.g.
+ * `created_at` and the migration uses the helper.
+ *
+ * Kept conservative: only columns added by the helper at delgoosh-monorepo's
+ * version (id, created_at, updated_at, deleted_at). Future TypeORM helpers
+ * with different defaults need their own entry — or, longer-term, slowcook
+ * should infer this from the helper's source.
+ */
+export declare const TYPEORM_HELPER_IMPLICIT_COLUMNS: string[];
+export declare function scanMigrations(repoRoot: string, dir: string): MigrationEntry[];
+/**
+ * Parse a single TypeORM migration TS file into the same MigrationEntry shape
+ * the SQL parser produces. Sees two patterns:
+ *
+ *   1. `await queryRunner.query(\`CREATE TABLE x ...\`)` — extract the SQL
+ *      template body and run it through the existing SQL parsers.
+ *   2. `await DatabaseCreateTable(queryRunner, 'tbl', [{name:'a'},{name:'b'}])`
+ *      — extract `tbl` + each column's name + the implicit-columns helpers
+ *      add (id, created_at, updated_at, deleted_at).
+ *
+ * Pattern 2 is delgoosh-monorepo-specific; pattern 1 covers raw SQL writers.
+ * EXPORTED for unit testing.
+ */
+export declare function parseTypeOrmMigration(name: string, body: string): MigrationEntry;
+export declare function extractCreateTables(sql: string): string[];
+export declare function extractColumnsAdded(sql: string): Record<string, string[]>;
+export declare function scanMockSurface(repoRoot: string, mockRoot: string): MockEntry[];
 export {};
 //# sourceMappingURL=history-index.d.ts.map

package/dist/commands/refine/history-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history-index.d.ts","sourceRoot":"","sources":["../../../src/commands/refine/history-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kEAAkE;IAClE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,sCAAsC,CAAC;IAClD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAoClE"}
+{"version":3,"file":"history-index.d.ts","sourceRoot":"","sources":["../../../src/commands/refine/history-index.ts"],"names":[],"mappings":"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"}