@creeperhost/modlens-mcp 1.6.19 → 1.6.21

package/dist/tools/primers.d.ts

@@ -1,8 +1,24 @@
-declare const DEFAULT_PRIMER_HOSTS: string[];
-/** Exported for use in setup wizard. */
-export { DEFAULT_PRIMER_HOSTS };
-/** Ingest one or more primers into the database. */
-export declare function ingestPrimer(entries: {
+import type { Prisma } from "@prisma/client";
+export { DEFAULT_PRIMER_HOSTS } from "../primer-content.js";
+type VersionRange = {
+    fromVersion: string;
+    toVersion: string;
+    fromDataVersion: number | null;
+    toDataVersion: number | null;
+};
+declare const summarySelect: {
+    id: true;
+    fromVersion: true;
+    toVersion: true;
+    fromDataVersion: true;
+    toDataVersion: true;
+    modloader: true;
+    title: true;
+    summary: true;
+    url: true;
+    tags: true;
+};
+export interface PrimerInput {
     fromVersion: string;
     toVersion: string;
     modloader?: string;
@@ -13,24 +29,119 @@ export declare function ingestPrimer(entries: {
     tags?: string[];
     source?: string;
     fetchContent?: boolean;
-}[]): Promise<object>;
-/** Get a single primer by ID. */
-export declare function getPrimer(id: number): Promise<object>;
-/**
- * Get primers for a version range.
- * Returns all primers where the primer's version range overlaps with [fromVersion, toVersion].
- * If both data versions are resolvable, uses numeric comparison.
- * Otherwise falls back to exact string match on fromVersion/toVersion.
- */
-export declare function getPrimersByVersionRange(fromVersion: string, toVersion: string, modloader?: string): Promise<object>;
-/** Search primers using full-text search on title, summary, and content. */
-export declare function searchPrimers(query: string, modloader?: string, fromVersion?: string, toVersion?: string, limit?: number): Promise<object>;
-/** List all primers with optional filters. */
-export declare function listPrimers(modloader?: string, limit?: number): Promise<object>;
-/** Delete a primer by ID. */
+}
+/** A requested fetch must succeed before the entry is written. */
+export declare function ingestPrimer(entries: PrimerInput[]): Promise<{
+    ingested: number;
+    failed: number;
+    primers: {
+        id: number;
+        title: string;
+        fromVersion: string;
+        toVersion: string;
+        contentStatus: string;
+    }[];
+    errors: {
+        url: string;
+        error: string;
+    }[];
+}>;
+export interface GetPrimerOptions {
+    fetchContent?: boolean;
+    refresh?: boolean;
+    startLine?: number;
+    maxLines?: number;
+}
+/** Return cached Markdown, fetching it if missing. Pagination never truncates the stored guide. */
+export declare function getPrimer(id: number, options?: GetPrimerOptions): Promise<object>;
+export interface PrimerRangeOptions {
+    includeContent?: boolean;
+    fetchContent?: boolean;
+    maxChars?: number;
+    cursor?: string;
+}
+type PrimerSummary = Omit<Prisma.PrimerGetPayload<{
+    select: typeof summarySelect;
+}>, "tags"> & {
+    tags: string[];
+};
+type PrimerRangeResult = {
+    queryRange: VersionRange;
+    count: number;
+    primers: PrimerSummary[];
+};
+type BundledPrimer = PrimerSummary & {
+    content: string | null;
+    contentStatus: "ready" | "missing" | "fetch_failed";
+    startOffset: number;
+    endOffset: number;
+    totalChars: number;
+    truncated: boolean;
+    error?: string;
+};
+type BundledPrimerRange = Omit<PrimerRangeResult, "primers"> & {
+    primers: BundledPrimer[];
+    failed: number;
+    missing: number;
+    contentChars: number;
+    maxChars: number;
+    truncated: boolean;
+    nextCursor: string | null;
+};
+/** Each transition strictly overlaps the requested migration; loader queries also include vanilla changes. */
+export declare function getPrimersByVersionRange(fromVersion: string, toVersion: string, modloader: string | undefined, options: PrimerRangeOptions & {
+    includeContent: true;
+}): Promise<BundledPrimerRange>;
+export declare function getPrimersByVersionRange(fromVersion: string, toVersion: string, modloader?: string, options?: PrimerRangeOptions): Promise<PrimerRangeResult | BundledPrimerRange>;
+export declare function searchPrimers(query: string, modloader?: string, fromVersion?: string, toVersion?: string, limit?: number): Promise<{
+    query: string;
+    count: number;
+    primers: (Omit<{
+        id: number;
+        modloader: string;
+        url: string;
+        tags: string[];
+        title: string;
+        summary: string | null;
+        fromVersion: string;
+        toVersion: string;
+        fromDataVersion: number | null;
+        toDataVersion: number | null;
+    }, "tags"> & {
+        tags: string[];
+    })[];
+}>;
+export declare function listPrimers(modloader?: string, limit?: number): Promise<{
+    count: number;
+    primers: (Omit<{
+        id: number;
+        modloader: string;
+        url: string;
+        tags: string[];
+        title: string;
+        summary: string | null;
+        fromVersion: string;
+        toVersion: string;
+        fromDataVersion: number | null;
+        toDataVersion: number | null;
+    }, "tags"> & {
+        tags: string[];
+    })[];
+}>;
 export declare function deletePrimer(id: number): Promise<object>;
-/** Populate the primers table with known NeoForge/Forge/Fabric migration guides. */
-export declare function seedDefaultPrimers(): Promise<object>;
+/** Populate the corrected catalogue, fetch missing bodies, and report individual failures for retry. */
+export declare function seedDefaultPrimers(fetchContent?: boolean): Promise<{
+    ingested: number;
+    ready: number;
+    failed: number;
+    primers: {
+        id: number;
+        title: string;
+        url: string;
+        contentStatus: string;
+        error?: string;
+    }[];
+}>;
 export declare function semanticSearchPrimers(query: string, limit?: number): Promise<object>;
 export declare function backfillPrimerEmbeddings(): Promise<object>;
 //# sourceMappingURL=primers.d.ts.map

package/dist/tools/primers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primers.d.ts","sourceRoot":"","sources":["../../src/tools/primers.ts"],"names":[],"mappings":"AAqBA,QAAA,MAAM,oBAAoB,UAazB,CAAC;AA6BF,wCAAwC;AACxC,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA+DhC,oDAAoD;AACpD,wBAAsB,YAAY,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6DpB;AAED,iCAAiC;AACjC,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3D;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,SAAK,GACX,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED,8CAA8C;AAC9C,wBAAsB,WAAW,CAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,SAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,6BAA6B;AAC7B,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9D;AAsGD,oFAAoF;AACpF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1D;AAkBD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBtF;AAID,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiBhE"}
+{"version":3,"file":"primers.d.ts","sourceRoot":"","sources":["../../src/tools/primers.ts"],"names":[],"mappings":"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"}