chia-explorer 0.1.5 → 0.2.0

package/dist/chips/index.d.ts

@@ -0,0 +1,68 @@
+import { type AuthorRef } from './parser.js';
+export interface ChipSummary {
+    number: number | null;
+    title: string | null;
+    status: string | null;
+    category: string | null;
+    sub_category: string | null;
+    type: string | null;
+    authors: AuthorRef[];
+    editors: AuthorRef[];
+    description: string | null;
+    abstract: string | null;
+    created: string | null;
+    updated: string | null;
+    comments_uri: string | null;
+    requires: string | null;
+    replaces: string | null;
+    superseded_by: string | null;
+    source_url: string;
+    filename: string;
+}
+export interface MergedChip extends ChipSummary {
+    source: 'merged';
+    ref: 'main';
+    body?: string;
+}
+export interface DraftChip extends ChipSummary {
+    source: 'draft';
+    ref: string;
+    pr: PrContext;
+    modifies_existing: boolean;
+    body?: string;
+}
+export interface PrContext {
+    number: number;
+    url: string;
+    title: string;
+    state: string;
+    draft: boolean;
+    author: string | null;
+    requested_reviewers: string[];
+    created_at: string;
+    updated_at: string;
+    head_sha: string;
+    head_ref: string;
+    base_ref: string;
+}
+export declare function listMergedChips(): Promise<ChipSummary[]>;
+export declare function getMergedChip(number: number, options?: {
+    includeBody?: boolean;
+}): Promise<MergedChip | null>;
+export declare function listChipDrafts(): Promise<DraftChip[]>;
+export declare function getChipFromPr(prNumber: number, options?: {
+    includeBody?: boolean;
+}): Promise<DraftChip | null>;
+export declare function findChipByNumber(number: number, options?: {
+    includeBody?: boolean;
+}): Promise<{
+    merged: MergedChip | null;
+    drafts: DraftChip[];
+}>;
+export interface SearchOptions {
+    status?: string;
+    source?: 'merged' | 'draft' | 'both';
+    limit?: number;
+}
+export declare function searchChips(query: string, options?: SearchOptions): Promise<Array<MergedChip | DraftChip>>;
+export { resetCache } from '../github/cache.js';

package/dist/chips/index.js

@@ -0,0 +1,214 @@
+import { FileNotFoundError, fetchRawFile, githubApi } from '../github/client.js';
+import { getCached } from '../github/cache.js';
+import { buildChipFileName, extractAbstract, extractChipPathInfo, parseChipFrontMatter, } from './parser.js';
+const REPO = 'Chia-Network/chips';
+const DEFAULT_REF = 'main';
+const CHIPS_DIR = 'CHIPs';
+const LISTING_TTL_MS = 5 * 60_000;
+const CONTENT_TTL_MS = 10 * 60_000;
+const PR_LIST_TTL_MS = 2 * 60_000;
+function summarize(fm, body, ref, filename) {
+    return {
+        number: fm.number,
+        title: fm.title,
+        status: fm.status,
+        category: fm.category,
+        sub_category: fm.sub_category,
+        type: fm.type,
+        authors: fm.authors,
+        editors: fm.editors,
+        description: fm.description,
+        abstract: extractAbstract(body),
+        created: fm.created,
+        updated: fm.updated,
+        comments_uri: fm.comments_uri,
+        requires: fm.requires,
+        replaces: fm.replaces,
+        superseded_by: fm.superseded_by,
+        source_url: `https://github.com/${REPO}/blob/${ref}/${filename}`,
+        filename,
+    };
+}
+async function listChipFilenames() {
+    return getCached(`chips:contents:${DEFAULT_REF}`, async () => {
+        const entries = await githubApi(`/repos/${REPO}/contents/${CHIPS_DIR}?ref=${DEFAULT_REF}`);
+        return entries
+            .filter((e) => e.type === 'file' && /^chip-\d{1,5}\.md$/i.test(e.name))
+            .map((e) => e.path)
+            .sort();
+    }, LISTING_TTL_MS);
+}
+async function fetchChipFile(ref, path) {
+    return getCached(`chips:raw:${ref}:${path}`, () => fetchRawFile(REPO, ref, path), CONTENT_TTL_MS);
+}
+export async function listMergedChips() {
+    const paths = await listChipFilenames();
+    const summaries = await Promise.all(paths.map(async (path) => {
+        const body = await fetchChipFile(DEFAULT_REF, path);
+        const fm = parseChipFrontMatter(body);
+        return summarize(fm, body, DEFAULT_REF, path);
+    }));
+    summaries.sort((a, b) => (a.number ?? 0) - (b.number ?? 0));
+    return summaries;
+}
+export async function getMergedChip(number, options = {}) {
+    const filename = `${CHIPS_DIR}/${buildChipFileName(number)}`;
+    try {
+        const body = await fetchChipFile(DEFAULT_REF, filename);
+        const fm = parseChipFrontMatter(body);
+        const summary = summarize(fm, body, DEFAULT_REF, filename);
+        const chip = {
+            ...summary,
+            source: 'merged',
+            ref: 'main',
+        };
+        if (options.includeBody)
+            chip.body = body;
+        return chip;
+    }
+    catch (err) {
+        if (err instanceof FileNotFoundError)
+            return null;
+        throw err;
+    }
+}
+async function listOpenChipPrs() {
+    return getCached(`chips:prs:open`, () => githubApi(`/repos/${REPO}/pulls?state=open&per_page=100&sort=updated&direction=desc`), PR_LIST_TTL_MS);
+}
+async function listPrChipFiles(prNumber) {
+    return getCached(`chips:pr-files:${prNumber}`, () => githubApi(`/repos/${REPO}/pulls/${prNumber}/files?per_page=100`), PR_LIST_TTL_MS);
+}
+function prContext(pr) {
+    return {
+        number: pr.number,
+        url: pr.html_url,
+        title: pr.title,
+        state: pr.state,
+        draft: pr.draft,
+        author: pr.user?.login ?? null,
+        requested_reviewers: pr.requested_reviewers.map((r) => r.login),
+        created_at: pr.created_at,
+        updated_at: pr.updated_at,
+        head_sha: pr.head.sha,
+        head_ref: pr.head.ref,
+        base_ref: pr.base.ref,
+    };
+}
+async function buildDraftFromPr(pr, file, options = {}) {
+    if (file.status === 'removed')
+        return null;
+    const info = extractChipPathInfo(file.filename);
+    if (!info)
+        return null;
+    let body;
+    try {
+        body = await fetchChipFile(pr.head.sha, file.filename);
+    }
+    catch (err) {
+        if (err instanceof FileNotFoundError)
+            return null;
+        throw err;
+    }
+    const fm = parseChipFrontMatter(body);
+    const summary = summarize(fm, body, pr.head.sha, file.filename);
+    if (summary.number == null)
+        summary.number = info.number;
+    const draft = {
+        ...summary,
+        source: 'draft',
+        ref: pr.head.sha,
+        pr: prContext(pr),
+        modifies_existing: file.status === 'modified' || file.status === 'renamed',
+    };
+    if (options.includeBody)
+        draft.body = body;
+    return draft;
+}
+export async function listChipDrafts() {
+    const prs = await listOpenChipPrs();
+    const results = [];
+    for (const pr of prs) {
+        const files = await listPrChipFiles(pr.number).catch(() => []);
+        const chipFiles = files.filter((f) => extractChipPathInfo(f.filename));
+        for (const file of chipFiles) {
+            const draft = await buildDraftFromPr(pr, file).catch(() => null);
+            if (draft)
+                results.push(draft);
+        }
+    }
+    return results;
+}
+export async function getChipFromPr(prNumber, options = {}) {
+    const prs = await listOpenChipPrs();
+    const pr = prs.find((p) => p.number === prNumber);
+    if (!pr)
+        return null;
+    const files = await listPrChipFiles(prNumber);
+    for (const file of files) {
+        if (!extractChipPathInfo(file.filename))
+            continue;
+        const draft = await buildDraftFromPr(pr, file, options);
+        if (draft)
+            return draft;
+    }
+    return null;
+}
+export async function findChipByNumber(number, options = {}) {
+    const merged = await getMergedChip(number, options);
+    const allDrafts = await listChipDrafts();
+    const drafts = [];
+    for (const d of allDrafts) {
+        if (d.number !== number)
+            continue;
+        if (options.includeBody) {
+            const full = await getChipFromPr(d.pr.number, { includeBody: true });
+            if (full)
+                drafts.push(full);
+            else
+                drafts.push(d);
+        }
+        else {
+            drafts.push(d);
+        }
+    }
+    return { merged, drafts };
+}
+function matchesQuery(s, q) {
+    const needle = q.toLowerCase();
+    const haystacks = [];
+    if (s.title)
+        haystacks.push(s.title);
+    if (s.description)
+        haystacks.push(s.description);
+    if (s.abstract)
+        haystacks.push(s.abstract);
+    for (const a of s.authors)
+        haystacks.push(a.name);
+    if (s.number != null)
+        haystacks.push(String(s.number));
+    return haystacks.some((h) => h.toLowerCase().includes(needle));
+}
+export async function searchChips(query, options = {}) {
+    const source = options.source ?? 'both';
+    const limit = options.limit ?? 20;
+    const statusFilter = options.status?.toLowerCase();
+    const pool = [];
+    if (source === 'merged' || source === 'both') {
+        const merged = await listMergedChips();
+        for (const m of merged) {
+            pool.push({ ...m, source: 'merged', ref: 'main' });
+        }
+    }
+    if (source === 'draft' || source === 'both') {
+        const drafts = await listChipDrafts();
+        pool.push(...drafts);
+    }
+    const filtered = pool.filter((c) => {
+        if (statusFilter && (c.status?.toLowerCase() ?? '') !== statusFilter)
+            return false;
+        return matchesQuery(c, query);
+    });
+    return filtered.slice(0, limit);
+}
+export { resetCache } from '../github/cache.js';
+//# sourceMappingURL=index.js.map

package/dist/chips/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chips/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,aAAa,CAAC;AAErB,MAAM,IAAI,GAAG,oBAAoB,CAAC;AAClC,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,SAAS,GAAG,OAAO,CAAC;AAC1B,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AAClC,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,CAAC;AACnC,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AA8ElC,SAAS,SAAS,CAAC,EAAmB,EAAE,IAAY,EAAE,GAAW,EAAE,QAAgB;IACjF,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC;QAC/B,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,OAAO,EAAE,EAAE,CAAC,OAAO;QACnB,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,aAAa,EAAE,EAAE,CAAC,aAAa;QAC/B,UAAU,EAAE,sBAAsB,IAAI,SAAS,GAAG,IAAI,QAAQ,EAAE;QAChE,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,OAAO,SAAS,CACd,kBAAkB,WAAW,EAAE,EAC/B,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,SAAS,CAC7B,UAAU,IAAI,aAAa,SAAS,QAAQ,WAAW,EAAE,CAC1D,CAAC;QACF,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE,CAAC;IACZ,CAAC,EACD,cAAc,CACf,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY;IACpD,OAAO,SAAS,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CACH,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,UAAqC,EAAE;IAEvC,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAe;YACvB,GAAG,OAAO;YACV,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,MAAM;SACZ,CAAC;QACF,IAAI,OAAO,CAAC,WAAW;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,iBAAiB;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,OAAO,SAAS,CACd,gBAAgB,EAChB,GAAG,EAAE,CACH,SAAS,CACP,UAAU,IAAI,4DAA4D,CAC3E,EACH,cAAc,CACf,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,OAAO,SAAS,CACd,kBAAkB,QAAQ,EAAE,EAC5B,GAAG,EAAE,CAAC,SAAS,CAAkB,UAAU,IAAI,UAAU,QAAQ,qBAAqB,CAAC,EACvF,cAAc,CACf,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,EAAc;IAC/B,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,GAAG,EAAE,EAAE,CAAC,QAAQ;QAChB,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI;QAC9B,mBAAmB,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/D,UAAU,EAAE,EAAE,CAAC,UAAU;QACzB,UAAU,EAAE,EAAE,CAAC,UAAU;QACzB,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG;QACrB,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG;QACrB,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG;KACtB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,EAAc,EACd,IAAmB,EACnB,UAAqC,EAAE;IAEvC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,iBAAiB;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzD,MAAM,KAAK,GAAc;QACvB,GAAG,OAAO;QACV,MAAM,EAAE,OAAO;QACf,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG;QAChB,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC;QACjB,iBAAiB,EAAE,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;KAC3E,CAAC;IACF,IAAI,OAAO,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAqB,CAAC,CAAC;QAClF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACjE,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,UAAqC,EAAE;IAEvC,MAAM,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,SAAS;QAClD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,UAAqC,EAAE;IAEvC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QAClC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBACvB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAQD,SAAS,YAAY,CAAC,CAAc,EAAE,CAAS;IAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,KAAK;QAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,WAAW;QAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC,CAAC,QAAQ;QAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;QAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,UAAyB,EAAE;IAE3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAEnD,MAAM,IAAI,GAAkC,EAAE,CAAC;IAC/C,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,GAAG,EAAE,MAAe,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;QACnF,OAAO,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/chips/parser.d.ts

@@ -0,0 +1,30 @@
+export interface AuthorRef {
+    name: string;
+    url: string | null;
+}
+export interface ChipFrontMatter {
+    number: number | null;
+    title: string | null;
+    description: string | null;
+    authors: AuthorRef[];
+    editors: AuthorRef[];
+    comments_uri: string | null;
+    status: string | null;
+    category: string | null;
+    sub_category: string | null;
+    type: string | null;
+    created: string | null;
+    updated: string | null;
+    requires: string | null;
+    replaces: string | null;
+    superseded_by: string | null;
+    extra: Record<string, string>;
+}
+export declare function parseAuthors(raw: string): AuthorRef[];
+export declare function parseChipFrontMatter(markdown: string): ChipFrontMatter;
+export declare function extractAbstract(markdown: string): string | null;
+export declare function buildChipFileName(number: number): string;
+export declare function extractChipPathInfo(path: string): {
+    number: number;
+    filename: string;
+} | null;

package/dist/chips/parser.js

@@ -0,0 +1,208 @@
+const KEY_MAP = {
+    'chip number': 'number',
+    'chip-number': 'number',
+    number: 'number',
+    title: 'title',
+    description: 'description',
+    author: 'authors',
+    authors: 'authors',
+    editor: 'editors',
+    editors: 'editors',
+    'comments-uri': 'comments_uri',
+    comments_uri: 'comments_uri',
+    status: 'status',
+    category: 'category',
+    'sub-category': 'sub_category',
+    sub_category: 'sub_category',
+    type: 'type',
+    created: 'created',
+    updated: 'updated',
+    requires: 'requires',
+    replaces: 'replaces',
+    'superseded-by': 'superseded_by',
+    superseded_by: 'superseded_by',
+};
+function stripTablePipes(line) {
+    let s = line.trim();
+    if (s.startsWith('|'))
+        s = s.slice(1);
+    if (s.endsWith('|'))
+        s = s.slice(0, -1);
+    return s;
+}
+function isSeparatorRow(cells) {
+    if (cells.length === 0)
+        return false;
+    return cells.every((c) => /^:?-+:?$/.test(c.trim()));
+}
+function isBlankOrNone(value) {
+    const v = value.trim().toLowerCase();
+    return v === '' || v === 'none' || v === '-' || v === 'n/a';
+}
+export function parseAuthors(raw) {
+    const trimmed = raw.trim();
+    if (isBlankOrNone(trimmed))
+        return [];
+    const out = [];
+    const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+    const seen = [];
+    let match;
+    while ((match = linkPattern.exec(trimmed)) !== null) {
+        out.push({ name: match[1].trim(), url: match[2].trim() });
+        seen.push({ start: match.index, end: match.index + match[0].length });
+    }
+    if (out.length > 0)
+        return out;
+    for (const part of trimmed.split(',')) {
+        const name = part.trim();
+        if (name)
+            out.push({ name, url: null });
+    }
+    return out;
+}
+function parseChipNumber(raw) {
+    const m = raw.trim().match(/^\d+/);
+    if (!m)
+        return null;
+    const n = Number(m[0]);
+    return Number.isFinite(n) ? n : null;
+}
+function assignField(fm, field, value) {
+    switch (field) {
+        case 'number':
+            fm.number = parseChipNumber(value);
+            return;
+        case 'authors':
+            fm.authors = parseAuthors(value);
+            return;
+        case 'editors':
+            fm.editors = parseAuthors(value);
+            return;
+        case 'extra':
+            return;
+    }
+    const normalized = isBlankOrNone(value) ? null : value;
+    switch (field) {
+        case 'title':
+            fm.title = normalized;
+            return;
+        case 'description':
+            fm.description = normalized;
+            return;
+        case 'comments_uri':
+            fm.comments_uri = normalized;
+            return;
+        case 'status':
+            fm.status = normalized;
+            return;
+        case 'category':
+            fm.category = normalized;
+            return;
+        case 'sub_category':
+            fm.sub_category = normalized;
+            return;
+        case 'type':
+            fm.type = normalized;
+            return;
+        case 'created':
+            fm.created = normalized;
+            return;
+        case 'updated':
+            fm.updated = normalized;
+            return;
+        case 'requires':
+            fm.requires = normalized;
+            return;
+        case 'replaces':
+            fm.replaces = normalized;
+            return;
+        case 'superseded_by':
+            fm.superseded_by = normalized;
+            return;
+    }
+}
+function emptyFrontMatter() {
+    return {
+        number: null,
+        title: null,
+        description: null,
+        authors: [],
+        editors: [],
+        comments_uri: null,
+        status: null,
+        category: null,
+        sub_category: null,
+        type: null,
+        created: null,
+        updated: null,
+        requires: null,
+        replaces: null,
+        superseded_by: null,
+        extra: {},
+    };
+}
+export function parseChipFrontMatter(markdown) {
+    const fm = emptyFrontMatter();
+    const lines = markdown.split(/\r?\n/);
+    for (const raw of lines) {
+        if (/^##\s/.test(raw))
+            break;
+        if (/^#\s/.test(raw))
+            continue;
+        const trimmed = raw.trim();
+        if (!trimmed)
+            continue;
+        if (!trimmed.includes('|'))
+            continue;
+        const cells = stripTablePipes(trimmed)
+            .split('|')
+            .map((c) => c.trim());
+        if (cells.length < 2)
+            continue;
+        if (isSeparatorRow(cells))
+            continue;
+        const key = cells[0].toLowerCase();
+        const value = cells.slice(1).join('|').trim();
+        const mapped = KEY_MAP[key];
+        if (!mapped) {
+            if (key)
+                fm.extra[key] = value;
+            continue;
+        }
+        assignField(fm, mapped, value);
+    }
+    return fm;
+}
+export function extractAbstract(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        if (/^##\s+abstract\s*$/i.test(lines[i].trim()))
+            break;
+        i++;
+    }
+    if (i >= lines.length)
+        return null;
+    i++;
+    const buf = [];
+    while (i < lines.length) {
+        const line = lines[i];
+        if (/^#{1,6}\s/.test(line.trim()))
+            break;
+        buf.push(line);
+        i++;
+    }
+    const text = buf.join('\n').trim();
+    return text || null;
+}
+export function buildChipFileName(number) {
+    return `chip-${String(number).padStart(4, '0')}.md`;
+}
+const CHIP_FILE_PATTERN = /CHIPs\/chip-(\d{1,5})\.md$/i;
+export function extractChipPathInfo(path) {
+    const m = CHIP_FILE_PATTERN.exec(path);
+    if (!m)
+        return null;
+    return { number: Number(m[1]), filename: path };
+}
+//# sourceMappingURL=parser.js.map

package/dist/chips/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/chips/parser.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,GAA0C;IACrD,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,cAAc;IAC9B,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,cAAc;IAC9B,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,eAAe,EAAE,eAAe;IAChC,aAAa,EAAE,eAAe;CAC/B,CAAC;AAEF,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,cAAc,CAAC,KAAe;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,0BAA0B,CAAC;IAC/C,MAAM,IAAI,GAA0C,EAAE,CAAC;IACvD,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,EAAmB,EAAE,KAA4B,EAAE,KAAa;IACnF,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ;YACX,EAAE,CAAC,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO;QACT,KAAK,SAAS;YACZ,EAAE,CAAC,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO;QACT,KAAK,SAAS;YACZ,EAAE,CAAC,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO;QACT,KAAK,OAAO;YACV,OAAO;IACX,CAAC;IACD,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC;YACtB,OAAO;QACT,KAAK,aAAa;YAChB,EAAE,CAAC,WAAW,GAAG,UAAU,CAAC;YAC5B,OAAO;QACT,KAAK,cAAc;YACjB,EAAE,CAAC,YAAY,GAAG,UAAU,CAAC;YAC7B,OAAO;QACT,KAAK,QAAQ;YACX,EAAE,CAAC,MAAM,GAAG,UAAU,CAAC;YACvB,OAAO;QACT,KAAK,UAAU;YACb,EAAE,CAAC,QAAQ,GAAG,UAAU,CAAC;YACzB,OAAO;QACT,KAAK,cAAc;YACjB,EAAE,CAAC,YAAY,GAAG,UAAU,CAAC;YAC7B,OAAO;QACT,KAAK,MAAM;YACT,EAAE,CAAC,IAAI,GAAG,UAAU,CAAC;YACrB,OAAO;QACT,KAAK,SAAS;YACZ,EAAE,CAAC,OAAO,GAAG,UAAU,CAAC;YACxB,OAAO;QACT,KAAK,SAAS;YACZ,EAAE,CAAC,OAAO,GAAG,UAAU,CAAC;YACxB,OAAO;QACT,KAAK,UAAU;YACb,EAAE,CAAC,QAAQ,GAAG,UAAU,CAAC;YACzB,OAAO;QACT,KAAK,UAAU;YACb,EAAE,CAAC,QAAQ,GAAG,UAAU,CAAC;YACzB,OAAO;QACT,KAAK,eAAe;YAClB,EAAE,CAAC,aAAa,GAAG,UAAU,CAAC;YAC9B,OAAO;IACX,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM;QAC7B,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACrC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC;aACnC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC/B,IAAI,cAAc,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,GAAG;gBAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;YAAE,MAAM;QACxD,CAAC,EAAE,CAAC;IACN,CAAC;IACD,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACnC,CAAC,EAAE,CAAC;IACJ,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,MAAM;QACzC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,EAAE,CAAC;IACN,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;AACtD,CAAC;AAED,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAExD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/github/cache.d.ts

@@ -0,0 +1,3 @@
+export declare function getCached<T>(key: string, loader: () => Promise<T>, ttlMs?: number): Promise<T>;
+export declare function invalidate(key: string): void;
+export declare function resetCache(): void;

package/dist/github/cache.js

@@ -0,0 +1,18 @@
+const DEFAULT_TTL_MS = 5 * 60_000;
+const cache = new Map();
+export async function getCached(key, loader, ttlMs = DEFAULT_TTL_MS) {
+    const now = Date.now();
+    const entry = cache.get(key);
+    if (entry && entry.expiresAt > now)
+        return entry.value;
+    const value = await loader();
+    cache.set(key, { value, expiresAt: now + ttlMs });
+    return value;
+}
+export function invalidate(key) {
+    cache.delete(key);
+}
+export function resetCache() {
+    cache.clear();
+}
+//# sourceMappingURL=cache.js.map

package/dist/github/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/github/cache.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,CAAC,GAAG,MAAM,CAAC;AAOlC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,MAAwB,EACxB,QAAgB,cAAc;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAyB,CAAC;IACrD,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/github/client.d.ts

@@ -0,0 +1,5 @@
+export declare function githubApi<T>(path: string): Promise<T>;
+export declare function fetchRawFile(repo: string, ref: string, path: string): Promise<string>;
+export declare class FileNotFoundError extends Error {
+    constructor(message: string);
+}

package/dist/github/client.js

@@ -0,0 +1,68 @@
+const GITHUB_API_BASE = 'https://api.github.com';
+const RAW_BASE = 'https://raw.githubusercontent.com';
+const REQUEST_TIMEOUT_MS = 10_000;
+const USER_AGENT = 'chia-explorer-mcp';
+function authHeaders() {
+    const headers = {
+        accept: 'application/vnd.github+json',
+        'x-github-api-version': '2022-11-28',
+        'user-agent': USER_AGENT,
+    };
+    const token = process.env.GITHUB_TOKEN;
+    if (token)
+        headers['authorization'] = `Bearer ${token}`;
+    return headers;
+}
+function rateLimitMessage(res, body) {
+    if (res.status !== 403 && res.status !== 429)
+        return null;
+    const remaining = res.headers.get('x-ratelimit-remaining');
+    const reset = res.headers.get('x-ratelimit-reset');
+    if (remaining === '0' || /rate limit/i.test(body)) {
+        const resetAt = reset ? new Date(Number(reset) * 1000).toISOString() : 'unknown';
+        const tokenHint = process.env.GITHUB_TOKEN
+            ? ''
+            : ' Set GITHUB_TOKEN to raise the limit from 60/hr to 5000/hr.';
+        return `github rate limit exhausted (resets at ${resetAt}).${tokenHint}`;
+    }
+    return null;
+}
+export async function githubApi(path) {
+    const url = path.startsWith('http') ? path : `${GITHUB_API_BASE}${path}`;
+    const res = await fetch(url, {
+        headers: authHeaders(),
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        const rateLimit = rateLimitMessage(res, body);
+        if (rateLimit)
+            throw new Error(rateLimit);
+        const detail = body ? `: ${body.slice(0, 200)}` : '';
+        throw new Error(`github ${res.status} ${res.statusText}${detail}`);
+    }
+    return (await res.json());
+}
+export async function fetchRawFile(repo, ref, path) {
+    const url = `${RAW_BASE}/${repo}/${ref}/${path}`;
+    const res = await fetch(url, {
+        headers: { 'user-agent': USER_AGENT },
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    if (res.status === 404) {
+        throw new FileNotFoundError(`raw file not found: ${repo}@${ref}/${path}`);
+    }
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        const detail = body ? `: ${body.slice(0, 200)}` : '';
+        throw new Error(`raw.githubusercontent ${res.status} ${res.statusText}${detail}`);
+    }
+    return await res.text();
+}
+export class FileNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FileNotFoundError';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"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"}

package/dist/schemas/chips.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const chipNumberSchema: z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>, z.ZodNumber>;
+export declare const chipStatusFilterSchema: z.ZodOptional<z.ZodString>;
+export declare const chipCategoryFilterSchema: z.ZodOptional<z.ZodString>;
+export declare const includeBodySchema: z.ZodDefault<z.ZodBoolean>;
+export declare const searchQuerySchema: z.ZodString;
+export declare const searchSourceSchema: z.ZodDefault<z.ZodEnum<["merged", "draft", "both"]>>;
+export declare const searchLimitSchema: z.ZodDefault<z.ZodNumber>;