pikelet-wasm 0.7.0 → 0.8.0

package/complete/builder.d.ts

@@ -1,5 +1,5 @@
 /**
- * pikelet-wasm/complete/builder — Node-only assembly of complete .pancake
+ * pikelet-wasm/complete/builder — Node-only assembly of complete .pikelet
  * artifacts (spec/COMPLETE_PROFILE.md). The wire-format constants here are
  * the same objects the reader uses (complete/format.mjs).
  */
@@ -15,8 +15,8 @@ export declare function canonicalJson(value: unknown): string;
 export declare const align16: (n: number) => number;
 
 /** Manifest profile strings and the header formatVersion each one implies. */
-export declare const PROFILE_V1: 'pancake-complete-v1';
-export declare const PROFILE_V2: 'pancake-complete-v2';
+export declare const PROFILE_V1: 'pikelet-complete-v1';
+export declare const PROFILE_V2: 'pikelet-complete-v2';
 export declare const FORMAT_VERSIONS: Record<string, number>;
 /** Corpus layout name for format 2 (per-record digests behind a page table). */
 export declare const CORPUS_LAYOUT_V2: 'records-v2';
@@ -52,7 +52,7 @@ export declare function buildInlineTransformerEncoderSegment(input: {
  * buildCorpusSegment() corpus); mismatches throw. Segments with a kind this
  * spec does not name must carry an explicit kindNumber (readers skip them).
  */
-export declare function assemblePancakeFile(
+export declare function assemblePikeletFile(
   manifestFields: Record<string, unknown> & { profile: string; corpus: { records: number } & Record<string, unknown> },
   segments: Array<{ kind: string; bytes: Buffer | Uint8Array; kindNumber?: number }>,
   outPath: string

package/complete/builder.mjs

@@ -228,7 +228,7 @@ export function buildLexicalSegment(texts) {
   };
 }
 
-// Corpus layout v1 (format 1, profile pancake-complete-v1): count + offsets +
+// Corpus layout v1 (format 1, profile pikelet-complete-v1): count + offsets +
 // records, integrity by whole-segment digest only. Kept for producing
 // format-1 files (compatibility fixtures, readers that predate format 2);
 // new artifacts use buildCorpusSegment() below.
@@ -248,7 +248,7 @@ export function buildCorpusSegmentFromBuffers(records) {
   return out;
 }
 
-// Corpus layout v2 (format 2, profile pancake-complete-v2): per-record
+// Corpus layout v2 (format 2, profile pikelet-complete-v2): per-record
 // integrity that a reader can check on the single range read that hydrates
 // a record, without fetching the rest of the segment (contract 4.1 / 7):
 //
@@ -352,7 +352,7 @@ export async function measureRecommendedRerank({
     async read(offset, length) { return bytes.subarray(offset, offset + length); },
     async close() {},
   };
-  const sketch = await artifactModule.PancakeSketchArtifact.open(source);
+  const sketch = await artifactModule.PikeletSketchArtifact.open(source);
   try {
     const count = sketch.count;
     if (count === 0) throw new Error('cannot measure rerank on an empty sketch');
@@ -432,16 +432,16 @@ function selfQueriesFromSnapshot(graph, maxQueries) {
   return queries;
 }
 
-// Container format version follows the profile string: pancake-complete-v1
-// files carry corpus layout v1 and header version 1; pancake-complete-v2
+// Container format version follows the profile string: pikelet-complete-v1
+// files carry corpus layout v1 and header version 1; pikelet-complete-v2
 // files carry corpus layout records-v2 (buildCorpusSegment) and header
 // version 2, so readers that predate per-record integrity reject them
 // explicitly instead of misreading the corpus tables.
-export const PROFILE_V1 = 'pancake-complete-v1';
-export const PROFILE_V2 = 'pancake-complete-v2';
+export const PROFILE_V1 = 'pikelet-complete-v1';
+export const PROFILE_V2 = 'pikelet-complete-v2';
 export const FORMAT_VERSIONS = { [PROFILE_V1]: 1, [PROFILE_V2]: 2 };
 
-export function assemblePancakeFile(manifestFields, segments, outPath) {
+export function assemblePikeletFile(manifestFields, segments, outPath) {
   const formatVersion = FORMAT_VERSIONS[manifestFields.profile];
   if (!formatVersion) {
     throw new Error(`manifest.profile must be ${PROFILE_V1} or ${PROFILE_V2}, got ${manifestFields.profile}`);

package/complete/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * pikelet-wasm/complete — reader for complete .pancake artifacts
- * (spec/COMPLETE_PROFILE.md, profile pancake-complete-v1). Opens any kind
+ * pikelet-wasm/complete — reader for complete .pikelet artifacts
+ * (spec/COMPLETE_PROFILE.md, profile pikelet-complete-v1). Opens any kind
  * (1 student-inline, 2 declared-external, 3 inline-transformer) from a file
  * path in Node or a range source anywhere.
  */
@@ -74,7 +74,7 @@ export interface CompleteSearch {
     identity: string;
     /** Container header formatVersion (1 or 2). */
     formatVersion: number;
-    /** Manifest profile: 'pancake-complete-v1' | 'pancake-complete-v2'. */
+    /** Manifest profile: 'pikelet-complete-v1' | 'pikelet-complete-v2'. */
     profile: string;
     /**
      * Human-readable pack name from the identity-verified manifest
@@ -158,6 +158,13 @@ export interface CompleteSearch {
     parallelism?: number;
     gap?: number;
     maxRangeBytes?: number;
+    /**
+     * A matchQuality: 'none' verdict withholds results by default. Set
+     * true to see the raw retrieval anyway (e.g. to inspect why the
+     * classifier abstained) — matchQuality and confidence are unaffected,
+     * this only controls whether results is populated. Default false.
+     */
+    showAbstained?: boolean;
   }): Promise<CompleteQueryResult>;
   /** Hydrate one corpus record by id (verified per record on format 2). */
   record(id: number): Promise<Record<string, unknown>>;
@@ -166,7 +173,7 @@ export interface CompleteSearch {
   close(): Promise<void>;
 }
 
-export declare function openPancakeFile(
+export declare function openPikeletFile(
   input: string | CompleteRangeSource,
   options?: {
     /**
@@ -284,6 +291,3 @@ export declare function buildInlineTestVectors(embedder: unknown, texts?: string
   text: string; windows: number; embedding: number[]; tolerance: number;
 }>>;
 export declare function verifyInlineTestVectors(embedder: unknown): Promise<{ checked: number }>;
-
-/** Documented alias for openPancakeFile — the project renamed to Pikelet; the reader's original export stays for compatibility. */
-export declare const openPikeletFile: typeof openPancakeFile;