@nusoft/nuos-build-catalogue 0.10.0 → 0.10.2

package/dist/search/format.js

@@ -0,0 +1,23 @@
+/**
+ * Output formatter — human-readable table or JSON.
+ */
+export function formatHumanReadable(hits) {
+    if (hits.length === 0)
+        return '(no results)';
+    return hits
+        .map((h, i) => {
+        const idTag = h.idInKind ? ` ${h.idInKind}` : '';
+        const status = h.status ? ` [${h.status}]` : '';
+        const heading = h.headings ? ` › ${h.headings}` : '';
+        const lines = h.startLine ? `:${h.startLine}-${h.endLine}` : '';
+        return [
+            `${(i + 1).toString().padStart(2)}. ${h.path}${lines}`,
+            `    ${h.fileKind}${idTag}${status}${heading}  (score ${h.score.toFixed(4)})`,
+            `    ${h.snippet}`,
+        ].join('\n');
+    })
+        .join('\n\n');
+}
+export function formatJson(hits) {
+    return JSON.stringify({ hits }, null, 2);
+}

package/dist/search/query.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Search — embed the query, call NuVector.searchKnowledge, format results.
+ */
+import type { NuVector } from '@nusoft/nuvector';
+import type { Embedder } from '../embedder/types.js';
+export interface SearchOptions {
+    query: string;
+    limit?: number;
+    kind?: string;
+    status?: string;
+}
+export interface SearchHit {
+    chunkId: string;
+    path: string;
+    fileKind: string;
+    idInKind: string;
+    status: string;
+    date: string;
+    headings: string;
+    startLine: number;
+    endLine: number;
+    score: number;
+    snippet: string;
+}
+export declare function runSearch(store: NuVector, embedder: Embedder, options: SearchOptions): Promise<{
+    hits: SearchHit[];
+    embedMs: number;
+    searchMs: number;
+}>;

package/dist/search/query.js

@@ -0,0 +1,71 @@
+/**
+ * Search — embed the query, call NuVector.searchKnowledge, format results.
+ */
+import { TENANT } from '../store/open.js';
+export async function runSearch(store, embedder, options) {
+    const limit = options.limit ?? 10;
+    const t1 = Date.now();
+    const [queryEmbedding] = await embedder.embed([options.query]);
+    const embedMs = Date.now() - t1;
+    const t2 = Date.now();
+    // Use retrieveContext (not searchKnowledge — that's the NuWiki four-layer
+    // entry point and only returns Layer 1 article summaries). For arbitrary
+    // document chunks like the catalogue indexer's, retrieveContext + kind
+    // filter is the correct method.
+    const result = await store.retrieveContext({
+        embedding: queryEmbedding,
+        tenant: TENANT,
+        topK: Math.max(limit * 3, 30),
+        filters: { kind: 'document_chunk' },
+    });
+    const searchMs = Date.now() - t2;
+    const items = (result?.items ?? []);
+    let hits = items.map((it) => {
+        const meta = it.metadata ?? {};
+        return {
+            chunkId: String(it.ref ?? ''),
+            path: String(meta.path ?? ''),
+            fileKind: String(meta.file_kind ?? ''),
+            idInKind: String(meta.id_in_kind ?? ''),
+            status: String(meta.status ?? ''),
+            date: String(meta.date ?? ''),
+            headings: String(meta.headings ?? ''),
+            startLine: Number(meta.start_line ?? 0),
+            endLine: Number(meta.end_line ?? 0),
+            score: Number(it.score ?? 0),
+            snippet: makeSnippet(String(it.text ?? it.summary ?? ''), options.query),
+        };
+    });
+    if (options.kind) {
+        hits = hits.filter((h) => h.fileKind === options.kind);
+    }
+    if (options.status) {
+        hits = hits.filter((h) => h.status.toLowerCase().includes(options.status.toLowerCase()));
+    }
+    return { hits: hits.slice(0, limit), embedMs, searchMs };
+}
+function makeSnippet(text, query) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    if (flat.length <= 200)
+        return flat;
+    const tokens = query
+        .toLowerCase()
+        .split(/\s+/u)
+        .filter((t) => t.length > 2);
+    let bestIdx = -1;
+    for (const tok of tokens) {
+        const idx = flat.toLowerCase().indexOf(tok);
+        if (idx >= 0) {
+            bestIdx = idx;
+            break;
+        }
+    }
+    if (bestIdx === -1) {
+        return flat.slice(0, 200) + '…';
+    }
+    const start = Math.max(0, bestIdx - 60);
+    const end = Math.min(flat.length, bestIdx + 140);
+    const prefix = start > 0 ? '…' : '';
+    const suffix = end < flat.length ? '…' : '';
+    return prefix + flat.slice(start, end) + suffix;
+}

package/dist/store/open.d.ts

@@ -0,0 +1,14 @@
+/**
+ * NuVector store factory — opens the file-backed store at the configured
+ * location, creating it if missing. The verification gate (scripts/
+ * verify-persistence.ts) confirmed file-backed persistence works in
+ * @nusoft/nuvector@0.1.0; see WU 110 notes for the verdict and known
+ * API quirks.
+ */
+import { NuVector } from '@nusoft/nuvector';
+export declare const TENANT = "nuos_build_catalogue";
+export interface StoreConfig {
+    storagePath: string;
+    dimensions: number;
+}
+export declare function openStore(config: StoreConfig): Promise<NuVector>;

package/dist/store/open.js

@@ -0,0 +1,16 @@
+/**
+ * NuVector store factory — opens the file-backed store at the configured
+ * location, creating it if missing. The verification gate (scripts/
+ * verify-persistence.ts) confirmed file-backed persistence works in
+ * @nusoft/nuvector@0.1.0; see WU 110 notes for the verdict and known
+ * API quirks.
+ */
+import { NuVector } from '@nusoft/nuvector';
+export const TENANT = 'nuos_build_catalogue';
+export async function openStore(config) {
+    return NuVector.open({
+        storage: config.storagePath,
+        dimensions: config.dimensions,
+        tenant: TENANT,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nusoft/nuos-build-catalogue",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "NuOS build-catalogue tooling: semantic search (WU 110) + migration runner that lifts markdown artefacts into JSON-backed workflow records (WU 111, Phase G).",
   "type": "module",
   "bin": {
@@ -16,7 +16,8 @@
     "access": "restricted"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc && chmod +x dist/cli.js",
+    "prepublishOnly": "npm run build",
     "verify-storage": "tsx scripts/verify-persistence.ts",
     "test": "tsx --test tests/chunk.test.ts tests/metadata.test.ts tests/crawl.test.ts tests/migrate.test.ts tests/commands-read.test.ts tests/regenerate.test.ts tests/commands-write.test.ts tests/ac-parse.test.ts tests/create.test.ts tests/init.test.ts",
     "typecheck": "tsc --noEmit",