@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

package/dist/semantic_graph/npm_enrich.js

@@ -0,0 +1,173 @@
+/**
+ * PND-020 Phase 3 -- npm registry enrichment.
+ *
+ * Replaces the "<name> npm package, dependencies. Auto-ingested;
+ * review..." placeholder in package.json-ingested nodes with the
+ * real description from registry.npmjs.org. Cached forever locally
+ * at ~/.yujin-forge/cache/npm-meta/<pkg>.json so the second ingest
+ * of the same project is offline + instant.
+ *
+ * Why local (and not the worker as the spec originally said):
+ * worker is dormant per Pablo (2026-06-08); per BYOK plain there
+ * is no Yujin infra in the hot path. `npm install` already hits
+ * the same registry, so the LLM-helping enrichment is fair game.
+ *
+ * Failure mode: graceful. A fetch error returns the placeholder
+ * unchanged; the chat keeps working.
+ *
+ * Gate: YF_NPM_ENRICH=0 disables.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+const CACHE_DIR = 'cache/npm-meta';
+const REGISTRY_URL = 'https://registry.npmjs.org';
+const FETCH_TIMEOUT_MS = 4000;
+/** Cap concurrent registry hits so we don't hammer npm. */
+const MAX_CONCURRENT = 5;
+function configRoot() {
+    if (process.env['YUJIN_FORGE_HOME'])
+        return process.env['YUJIN_FORGE_HOME'];
+    if (process.env['YF_CONFIG_DIR'])
+        return process.env['YF_CONFIG_DIR'];
+    const xdg = process.env['XDG_CONFIG_HOME'];
+    if (xdg && process.platform === 'linux')
+        return path.join(xdg, 'yujin-forge');
+    return path.join(os.homedir(), '.yujin-forge');
+}
+function cachePath(pkgName) {
+    /* Slashes in scoped names need to be flattened to a safe file name. */
+    const safe = pkgName.replace(/[/\\]/g, '__');
+    return path.join(configRoot(), CACHE_DIR, safe + '.json');
+}
+export function enrichmentEnabled() {
+    const v = process.env['YF_NPM_ENRICH'];
+    if (v === '0' || v === 'false' || v === 'no')
+        return false;
+    return true;
+}
+/** Read a single package's cached meta. Returns null on miss. */
+export async function readCachedMeta(pkgName) {
+    try {
+        const raw = await fs.readFile(cachePath(pkgName), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.name === 'string' && typeof parsed.fetched_at === 'string') {
+            return {
+                name: parsed.name,
+                version: typeof parsed.version === 'string' ? parsed.version : '',
+                description: typeof parsed.description === 'string' ? parsed.description : '',
+                ...(typeof parsed.homepage === 'string' ? { homepage: parsed.homepage } : {}),
+                ...(typeof parsed.repository === 'string' ? { repository: parsed.repository } : {}),
+                keywords: Array.isArray(parsed.keywords) ? parsed.keywords.filter((k) => typeof k === 'string') : [],
+                fetched_at: parsed.fetched_at,
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCachedMeta(meta) {
+    const p = cachePath(meta.name);
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, JSON.stringify(meta, null, 2) + '\n', 'utf-8');
+}
+/** Fetch + parse the registry metadata for a single package. Returns
+ *  null on any failure (404, network, timeout, malformed JSON). */
+export async function fetchPackageMeta(pkgName, opts = {}) {
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    const url = REGISTRY_URL + '/' + pkgName.split('/').map(encodeURIComponent).join('/') + '/latest';
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), opts.timeout_ms ?? FETCH_TIMEOUT_MS);
+    try {
+        const r = await fetchImpl(url, { signal: ctl.signal });
+        if (!r.ok)
+            return null;
+        const body = (await r.json());
+        const description = typeof body['description'] === 'string'
+            ? body['description'].slice(0, 200)
+            : '';
+        const version = typeof body['version'] === 'string' ? body['version'] : '';
+        const homepage = typeof body['homepage'] === 'string' ? body['homepage'] : undefined;
+        const repoRaw = body['repository'];
+        const repository = typeof repoRaw === 'string'
+            ? repoRaw
+            : (repoRaw && typeof repoRaw === 'object' && typeof repoRaw.url === 'string'
+                ? repoRaw.url
+                : undefined);
+        const keywords = Array.isArray(body['keywords'])
+            ? body['keywords'].filter((k) => typeof k === 'string')
+            : [];
+        return {
+            name: pkgName,
+            version,
+            description,
+            ...(homepage ? { homepage } : {}),
+            ...(repository ? { repository } : {}),
+            keywords,
+            fetched_at: new Date().toISOString(),
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Get meta for one package: cache-first; only hits the network on
+ *  miss. Returns null on miss + fetch fail. */
+export async function getPackageMeta(pkgName, opts = {}) {
+    if (!opts.force) {
+        const cached = await readCachedMeta(pkgName);
+        if (cached)
+            return cached;
+    }
+    const fresh = await fetchPackageMeta(pkgName, opts);
+    if (!fresh)
+        return null;
+    await writeCachedMeta(fresh).catch(() => undefined);
+    return fresh;
+}
+export async function enrichNodes(nodes, opts = {}) {
+    if (nodes.length === 0)
+        return { enriched: 0, missed: 0 };
+    if (!enrichmentEnabled())
+        return { enriched: 0, missed: nodes.length };
+    const concurrency = Math.max(1, Math.min(opts.concurrency ?? MAX_CONCURRENT, 16));
+    let enriched = 0, missed = 0, cursor = 0;
+    async function worker() {
+        while (cursor < nodes.length) {
+            const idx = cursor++;
+            const n = nodes[idx];
+            if (!n)
+                continue;
+            const meta = await getPackageMeta(n.name, opts);
+            if (!meta || !meta.description) {
+                missed++;
+                continue;
+            }
+            n.purpose = meta.description;
+            /* Keywords are crisp 1-3 word tags; merge into solves but
+             * cap to keep the system prompt small. */
+            const newSolves = new Set(n.solves);
+            for (const k of meta.keywords.slice(0, 5))
+                newSolves.add(k);
+            n.solves = Array.from(newSolves).slice(0, 8);
+            /* If homepage / repository are useful for the LLM to look up,
+             * surface them in api_surface (the chat injection already
+             * trims if over budget). */
+            if (meta.homepage)
+                n.api_surface.push('home: ' + meta.homepage);
+            if (meta.repository)
+                n.api_surface.push('repo: ' + meta.repository);
+            enriched++;
+        }
+    }
+    await Promise.all(Array.from({ length: concurrency }, () => worker()));
+    return { enriched, missed };
+}
+//# sourceMappingURL=npm_enrich.js.map

package/dist/semantic_graph/npm_enrich.js.map

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

package/dist/semantic_graph/render.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Yujin Forge -- local-side semantic graph renderer.
+ *
+ * Mirrors the worker renderer in
+ *   packages/hito4-server/src/core/semantic_graph_ranker.ts::renderNodes
+ * so the "PROJECT KNOWLEDGE GRAPH" section the LLM sees is
+ * structurally identical whether nodes come from the local SQLite
+ * (default) or the D1 worker (hybrid sync). Token budget honoured
+ * by trimming the per-kind list, not by reordering -- weight order
+ * is preserved.
+ *
+ * ASCII-only.
+ */
+import type { GraphNode } from './types.js';
+export interface RenderOptions {
+    /** Char budget approximating a token budget (1 token ~= 4 chars). */
+    char_budget?: number;
+    /** Override Date.now for tests. */
+    now?: () => string;
+}
+export interface RenderResult {
+    /** The PROJECT KNOWLEDGE GRAPH section, with footer. '' when no
+     *  nodes (caller should treat as "no graph this turn"). */
+    rendered_text: string;
+    estimated_tokens: number;
+}
+export declare function renderLocalGraphSection(nodes: GraphNode[], opts?: RenderOptions): RenderResult;
+//# sourceMappingURL=render.d.ts.map

package/dist/semantic_graph/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/semantic_graph/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkB5C,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B;+DAC2D;IAC3D,aAAa,EAAK,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CA+ClG"}

package/dist/semantic_graph/render.js

@@ -0,0 +1,70 @@
+const FOOTER = `
+
+When the user's request touches one of the primitives listed in the
+PROJECT KNOWLEDGE GRAPH above, USE that primitive. Do not propose
+installing a new equivalent. Do not write a custom replacement. If
+unclear whether a primitive covers the use case, ASK the user
+before proposing alternatives.`;
+const LABELS = {
+    library: 'LIBRARIES IN PACKAGE.JSON',
+    component: 'COMPONENTS IN src/',
+    protocol: 'PROTOCOLS IMPLEMENTED',
+    module: 'MODULES',
+};
+const ORDER = ['library', 'component', 'protocol', 'module'];
+export function renderLocalGraphSection(nodes, opts = {}) {
+    if (nodes.length === 0)
+        return { rendered_text: '', estimated_tokens: 0 };
+    const budget = opts.char_budget ?? 2000;
+    const now = (opts.now ?? (() => new Date().toISOString()))();
+    const byKind = {};
+    for (const n of nodes) {
+        if (!byKind[n.kind])
+            byKind[n.kind] = [];
+        byKind[n.kind].push(n);
+    }
+    const lines = [];
+    lines.push('=== PROJECT KNOWLEDGE GRAPH (local, current as of ' + now + ') ===');
+    lines.push('');
+    lines.push('This project ALREADY HAS these primitives. NEVER suggest reinventing.');
+    lines.push('If the user request touches one of these, USE the existing primitive');
+    lines.push('rather than writing an equivalent.');
+    lines.push('');
+    let length = lines.join('\n').length;
+    for (const kind of ORDER) {
+        const arr = byKind[kind] || [];
+        if (arr.length === 0)
+            continue;
+        const header = LABELS[kind] + ':';
+        if (length + header.length + 1 > budget)
+            break;
+        lines.push(header);
+        length += header.length + 1;
+        let added = 0;
+        for (const n of arr) {
+            const line = '  - ' + n.id
+                + (n.version ? '@' + n.version : '')
+                + '  ' + n.purpose
+                + (n.do_not_invent.length ? '  (DO NOT INVENT: ' + n.do_not_invent.join('; ') + ')' : '');
+            if (length + line.length + 1 > budget) {
+                const remaining = arr.length - added;
+                if (remaining > 0) {
+                    const trail = '  ... +' + remaining + ' more (call yujin.graph.list-relevant for the rest)';
+                    if (length + trail.length + 1 <= budget) {
+                        lines.push(trail);
+                        length += trail.length + 1;
+                    }
+                }
+                break;
+            }
+            lines.push(line);
+            length += line.length + 1;
+            added++;
+        }
+        lines.push('');
+        length += 1;
+    }
+    const text = lines.join('\n') + FOOTER;
+    return { rendered_text: text, estimated_tokens: Math.ceil(text.length / 4) };
+}
+//# sourceMappingURL=render.js.map

package/dist/semantic_graph/render.js.map

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

package/dist/semantic_graph/store.d.ts

@@ -0,0 +1,44 @@
+import { type GraphNode, type GraphEdge, type GraphSummary, type GraphNodeKind } from './types.js';
+export interface UpsertNodesResult {
+    inserted: number;
+    updated: number;
+}
+export interface UpsertEdgesResult {
+    inserted: number;
+    updated: number;
+}
+export declare function upsertNodes(project_slug: string, nodes: GraphNode[]): Promise<UpsertNodesResult>;
+export declare function upsertEdges(project_slug: string, edges: GraphEdge[]): Promise<UpsertEdgesResult>;
+export interface RelevantQuery {
+    /** Free-text hint. Today: simple LIKE over name|purpose|solves. */
+    text?: string;
+    kinds?: GraphNodeKind[];
+    limit?: number;
+    /** Floor on confidence -- 'auto' filters out 'claimed'; 'verified'
+     *  filters out 'auto' and 'claimed'. */
+    min_confidence?: 'claimed' | 'auto' | 'verified';
+}
+export declare function listRelevant(project_slug: string, q: RelevantQuery): Promise<GraphNode[]>;
+export declare function getNode(project_slug: string, id: string): Promise<GraphNode | null>;
+export declare function listEdgesFrom(project_slug: string, from_id: string): Promise<GraphEdge[]>;
+/** GRAPH-2 (dogfood 2026-06-10) -- list ALL edges of a project.
+ *  Hasta hoy solo habia listEdgesFrom(from_id): para dibujar el
+ *  grafo completo el LLM tenia que leer el .db con sqlite a mano
+ *  (lento). Este es el read que respalda yujin.graph.list-edges. */
+export declare function listAllEdges(project_slug: string): Promise<GraphEdge[]>;
+export declare function summarize(project_slug: string): Promise<GraphSummary>;
+/** GRAPH (dogfood 2026-06-10) -- delete edges whose from_id or
+ *  to_id does not match an existing node ("dangling"). A laxy
+ *  import scanner can emit edges to ids that were never registered
+ *  as nodes (libs of workspace sub-packages, or junk parsed from
+ *  comments/strings). Returns how many were removed. Idempotent. */
+export declare function pruneDanglingEdges(project_slug: string): Promise<{
+    removed: number;
+}>;
+/** Wipe both tables for a project (yf graph forget). */
+export declare function forgetGraph(project_slug: string): Promise<void>;
+/** Test seam preserved for compatibility -- the store no longer
+ *  caches open handles, so this is a no-op. Existing tests still
+ *  call it (and harmlessly so). */
+export declare function _closeAllForTest(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/semantic_graph/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/semantic_graph/store.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EACjD,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAiHpB,MAAM,WAAW,iBAAiB;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AACzE,MAAM,WAAW,iBAAiB;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AAEzE,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmDtG;AAED,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgCtG;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,IAAI,CAAC,EAAK,MAAM,CAAC;IACjB,KAAK,CAAC,EAAI,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAI,MAAM,CAAC;IACjB;4CACwC;IACxC,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;CAClD;AAID,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA2B/F;AAED,wBAAsB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAOzF;AAED,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAO/F;AAED;;;oEAGoE;AACpE,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAO7E;AAED,wBAAsB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsB3E;AAED;;;;oEAIoE;AACpE,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAY3F;AAED,wDAAwD;AACxD,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrE;AAyCD;;mCAEmC;AACnC,wBAAgB,gBAAgB,IAAI,IAAI,CAAgB"}