homegraph 1.5.0 → 1.5.2

package/dist/spec/utils.d.ts

@@ -1,155 +0,0 @@
-/**
- * Spec utility functions — replaces `file_utils.py`, `meta.py`, and
- * `truncate.py` from Python Commit4Spec.
- *
- * Covers file I/O, meta.json read/write, text/diff truncation, and budget
- * computation. All functions are synchronous and use Node.js built-ins.
- *
- * @module spec/utils
- */
-export interface SpecEntry {
-    specId: string;
-    entryType: 'directory' | 'file';
-    path: string;
-}
-export interface SpecMeta {
-    repoPath: string;
-    specStoragePath: string;
-    currentCommitID?: string;
-    createdAt?: string;
-    updatedAt: string;
-}
-export interface BudgetProfile {
-    tier: 'tiny' | 'small' | 'medium' | 'large' | 'vlarge';
-    maxFragments: number;
-    maxContents: number;
-    contentBudget: number;
-}
-/** Root directory for spec data, relative to the repository root. */
-export declare const SPEC_DATA_DIR = ".homegraph/commit4spec";
-/**
- * Read a UTF-8 file synchronously.
- *
- * Returns `null` for ENOENT (not found), EISDIR (is a directory), or EACCES
- * (permission denied). Other errors propagate.
- */
-export declare function readFileContent(filePath: string): string | null;
-/**
- * Write a UTF-8 file synchronously, creating parent directories as needed.
- *
- * Parent directories are created with `fs.mkdirSync({ recursive: true })`.
- * If the parent exists but is not a directory the underlying error propagates.
- */
-export declare function writeFileContent(filePath: string, content: string): void;
-/**
- * Discover specs in a storage directory.
- *
- * A "spec" is any `.md` file OR any subdirectory. For `.md` files the
- * `specId` is the basename without the extension. For subdirectories the
- * `specId` is the directory name.
- *
- * Returns an empty array when `specStoragePath` does not exist or is not a
- * directory.
- */
-export declare function discoverSpecs(specStoragePath: string): SpecEntry[];
-/**
- * Resolve the database path.
- *
- * Priority:
- * 1. If `explicitDbPath` is given, return it as-is (no side effects).
- * 2. If `repoPath` is given, default to `{repoPath}/${SPEC_DATA_DIR}/commit4spec.db`
- *    and ensure `${SPEC_DATA_DIR}/.gitignore` exists containing `"*"`.
- * 3. If neither is given, return `"./commit4spec.db"`.
- */
-export declare function resolveDbPath(repoPath?: string, explicitDbPath?: string): string;
-/**
- * Read `${SPEC_DATA_DIR}/meta.json` from `repoPath`.
- *
- * Returns `null` when the file is missing, unreadable, or contains invalid
- * JSON or a JSON value that is not a plain object.
- */
-export declare function readMeta(repoPath: string): SpecMeta | null;
-/**
- * Write `${SPEC_DATA_DIR}/meta.json` to `repoPath`.
- *
- * If existing meta has a `createdAt` field it is preserved; otherwise the
- * current time is used as the creation timestamp. `updatedAt` is always set
- * to the current time. The `${SPEC_DATA_DIR}` directory is created if it does
- * not exist.
- *
- * Returns the full `SpecMeta` that was written.
- */
-export declare function writeMeta(repoPath: string, specStoragePath: string, currentCommitID?: string): SpecMeta;
-/**
- * Truncate a unified diff at a sensible boundary.
- *
- * The algorithm prefers semantic boundaries to keep diffs readable:
- *
- * 1. If the diff is shorter than `maxChars` (default 3800), return it unchanged.
- * 2. Try: find the **last** `@@` hunk header in the trailing 50% portion of
- *    the diff and cut right before it.
- * 3. Fallback: find the **last** newline in the trailing 80% portion and cut
- *    after it.
- * 4. Hard fallback: cut exactly at `maxChars`.
- *
- * Always appends `"  …(truncated)"` when truncation occurs.
- *
- * @param diff    - The unified diff text to truncate.
- * @param maxChars - Maximum allowed characters (including suffix). Default 3800.
- * @returns The (possibly truncated) diff text.
- */
-export declare function truncateCodeDiff(diff: string, maxChars?: number): string;
-/**
- * Truncate plain text with newline-awareness.
- *
- * When the text is longer than `maxChars`, it is cut at the last newline
- * found before `maxChars` (minus the suffix length). If no suitable newline
- * exists, a hard cut is made.
- *
- * The suffix `"  …(truncated)"` is appended only when truncation occurs.
- *
- * @param text     - The text to truncate.
- * @param maxChars - Maximum allowed characters (including suffix).
- * @returns The (possibly truncated) text.
- */
-export declare function truncateText(text: string, maxChars: number): string;
-/**
- * Truncate a subtitles array.
- *
- * 1. If the array has more than `maxEntries`, it is sliced to `maxEntries`.
- * 2. Each remaining entry that exceeds `maxChars` is individually truncated
- *    via `truncateText`.
- *
- * Entries that already fit within both limits are left unchanged.
- *
- * @param subtitles  - Array of subtitle strings.
- * @param maxChars   - Maximum characters per entry (including suffix).
- * @param maxEntries - Maximum number of entries to keep.
- * @returns The truncated subtitles array (always a new array).
- */
-export declare function truncateSubtitles(subtitles: string[], maxChars: number, maxEntries: number): string[];
-/**
- * Compute a budget profile based on spec and optional fragment counts.
- *
- * The profile determines how many fragments, contents, and characters the
- * pipeline should budget when building LLM prompts. Higher counts produce
- * tighter budgets to keep prompts manageable.
- *
- * Thresholds (matching `truncate.py:38-57`):
- *
- * | specCount | tier    | maxFragments | maxContents | contentBudget |
- * |-----------|---------|--------------|-------------|---------------|
- * | ≤ 3       | tiny    | 12           | 16          | 48000         |
- * | ≤ 8       | small   | 10           | 14          | 40000         |
- * | ≤ 15      | medium  | 8            | 12          | 32000         |
- * | ≤ 30      | large   | 6            | 10          | 24000         |
- * | > 30      | vlarge  | 0            | 0           | 16000         |
- *
- * The `vlarge` tier disables fragment/contents inclusion entirely (0 values).
- *
- * @param specCount     - Number of specs in the knowledge graph.
- * @param fragmentCount - (Unused) reserved for future per-fragment weighting.
- * @returns The budget profile for the given scale.
- */
-export declare function computeBudgetProfile(specCount: number, _fragmentCount?: number): BudgetProfile;
-//# sourceMappingURL=utils.d.ts.map

package/dist/spec/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/spec/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,qEAAqE;AACrE,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAStD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS/D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMxE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,EAAE,CA6BlE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAiChF;AAMD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CA8C1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,QAAQ,CAsBV;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,GAAG,MAAM,CA6C9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAMV;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GACtB,aAAa,CAcf"}

package/dist/spec/utils.js

@@ -1,411 +0,0 @@
-"use strict";
-/**
- * Spec utility functions — replaces `file_utils.py`, `meta.py`, and
- * `truncate.py` from Python Commit4Spec.
- *
- * Covers file I/O, meta.json read/write, text/diff truncation, and budget
- * computation. All functions are synchronous and use Node.js built-ins.
- *
- * @module spec/utils
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SPEC_DATA_DIR = void 0;
-exports.readFileContent = readFileContent;
-exports.writeFileContent = writeFileContent;
-exports.discoverSpecs = discoverSpecs;
-exports.resolveDbPath = resolveDbPath;
-exports.readMeta = readMeta;
-exports.writeMeta = writeMeta;
-exports.truncateCodeDiff = truncateCodeDiff;
-exports.truncateText = truncateText;
-exports.truncateSubtitles = truncateSubtitles;
-exports.computeBudgetProfile = computeBudgetProfile;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const errors_1 = require("../errors");
-// =============================================================================
-// Constants
-// =============================================================================
-/** Root directory for spec data, relative to the repository root. */
-exports.SPEC_DATA_DIR = '.homegraph/commit4spec';
-const TRUNCATION_SUFFIX = '  …(truncated)';
-const TRUNCATION_SUFFIX_LENGTH = TRUNCATION_SUFFIX.length;
-// =============================================================================
-// File I/O
-// =============================================================================
-/**
- * Read a UTF-8 file synchronously.
- *
- * Returns `null` for ENOENT (not found), EISDIR (is a directory), or EACCES
- * (permission denied). Other errors propagate.
- */
-function readFileContent(filePath) {
-    try {
-        return fs.readFileSync(filePath, 'utf-8');
-    }
-    catch (err) {
-        if (err.code === 'ENOENT' || err.code === 'EISDIR' || err.code === 'EACCES') {
-            return null;
-        }
-        throw err;
-    }
-}
-/**
- * Write a UTF-8 file synchronously, creating parent directories as needed.
- *
- * Parent directories are created with `fs.mkdirSync({ recursive: true })`.
- * If the parent exists but is not a directory the underlying error propagates.
- */
-function writeFileContent(filePath, content) {
-    const dir = path.dirname(filePath);
-    if (dir && dir !== '.') {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(filePath, content, 'utf-8');
-}
-// =============================================================================
-// Spec discovery
-// =============================================================================
-/**
- * Discover specs in a storage directory.
- *
- * A "spec" is any `.md` file OR any subdirectory. For `.md` files the
- * `specId` is the basename without the extension. For subdirectories the
- * `specId` is the directory name.
- *
- * Returns an empty array when `specStoragePath` does not exist or is not a
- * directory.
- */
-function discoverSpecs(specStoragePath) {
-    let entries;
-    try {
-        entries = fs.readdirSync(specStoragePath, { withFileTypes: true });
-    }
-    catch (err) {
-        // Non-existent or not a directory → empty list
-        return [];
-    }
-    const result = [];
-    for (const entry of entries) {
-        if (entry.isDirectory()) {
-            result.push({
-                specId: entry.name,
-                entryType: 'directory',
-                path: path.join(specStoragePath, entry.name),
-            });
-        }
-        else if (entry.isFile() && entry.name.endsWith('.md')) {
-            result.push({
-                specId: entry.name.slice(0, -3), // strip ".md"
-                entryType: 'file',
-                path: path.join(specStoragePath, entry.name),
-            });
-        }
-        // Symlinks, other file types, and dot-files are silently skipped.
-    }
-    return result;
-}
-// =============================================================================
-// Database path resolution
-// =============================================================================
-/**
- * Resolve the database path.
- *
- * Priority:
- * 1. If `explicitDbPath` is given, return it as-is (no side effects).
- * 2. If `repoPath` is given, default to `{repoPath}/${SPEC_DATA_DIR}/commit4spec.db`
- *    and ensure `${SPEC_DATA_DIR}/.gitignore` exists containing `"*"`.
- * 3. If neither is given, return `"./commit4spec.db"`.
- */
-function resolveDbPath(repoPath, explicitDbPath) {
-    if (explicitDbPath) {
-        return explicitDbPath;
-    }
-    if (repoPath) {
-        const commit4specDir = path.join(repoPath, exports.SPEC_DATA_DIR);
-        const gitignorePath = path.join(commit4specDir, '.gitignore');
-        const dbPath = path.join(commit4specDir, 'commit4spec.db');
-        // Ensure ${SPEC_DATA_DIR} directory exists
-        try {
-            fs.mkdirSync(commit4specDir, { recursive: true });
-        }
-        catch {
-            // Directory may already exist; ok.
-        }
-        // Write .gitignore if it doesn't exist
-        if (!fs.existsSync(gitignorePath)) {
-            try {
-                fs.writeFileSync(gitignorePath, '*\n', 'utf-8');
-            }
-            catch (err) {
-                (0, errors_1.logWarn)(`Failed to write ${exports.SPEC_DATA_DIR}/.gitignore`, {
-                    path: gitignorePath,
-                    error: err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-        return dbPath;
-    }
-    return './commit4spec.db';
-}
-// =============================================================================
-// Meta read / write
-// =============================================================================
-/**
- * Read `${SPEC_DATA_DIR}/meta.json` from `repoPath`.
- *
- * Returns `null` when the file is missing, unreadable, or contains invalid
- * JSON or a JSON value that is not a plain object.
- */
-function readMeta(repoPath) {
-    const metaPath = path.join(repoPath, exports.SPEC_DATA_DIR, 'meta.json');
-    let raw;
-    try {
-        raw = fs.readFileSync(metaPath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        (0, errors_1.logWarn)(`Ignoring ${exports.SPEC_DATA_DIR}/meta.json: not valid JSON`, {
-            path: metaPath,
-        });
-        return null;
-    }
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        (0, errors_1.logWarn)(`Ignoring ${exports.SPEC_DATA_DIR}/meta.json: top-level value must be a JSON object`, { path: metaPath });
-        return null;
-    }
-    const obj = parsed;
-    // Validate required string fields
-    if (typeof obj.repoPath !== 'string' || typeof obj.specStoragePath !== 'string') {
-        (0, errors_1.logWarn)(`Ignoring ${exports.SPEC_DATA_DIR}/meta.json: repoPath and specStoragePath must be strings`, { path: metaPath });
-        return null;
-    }
-    return {
-        repoPath: obj.repoPath,
-        specStoragePath: obj.specStoragePath,
-        currentCommitID: typeof obj.currentCommitID === 'string' ? obj.currentCommitID : undefined,
-        createdAt: typeof obj.createdAt === 'string' ? obj.createdAt : undefined,
-        updatedAt: typeof obj.updatedAt === 'string' ? obj.updatedAt : new Date().toISOString(),
-    };
-}
-/**
- * Write `${SPEC_DATA_DIR}/meta.json` to `repoPath`.
- *
- * If existing meta has a `createdAt` field it is preserved; otherwise the
- * current time is used as the creation timestamp. `updatedAt` is always set
- * to the current time. The `${SPEC_DATA_DIR}` directory is created if it does
- * not exist.
- *
- * Returns the full `SpecMeta` that was written.
- */
-function writeMeta(repoPath, specStoragePath, currentCommitID) {
-    const metaDir = path.join(repoPath, exports.SPEC_DATA_DIR);
-    const metaPath = path.join(metaDir, 'meta.json');
-    const now = new Date().toISOString();
-    // Preserve createdAt from existing meta; use now for new files
-    const existing = readMeta(repoPath);
-    const createdAt = (existing?.createdAt) || now;
-    const meta = {
-        repoPath,
-        specStoragePath,
-        currentCommitID,
-        createdAt,
-        updatedAt: now,
-    };
-    fs.mkdirSync(metaDir, { recursive: true });
-    fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2) + '\n', 'utf-8');
-    return meta;
-}
-// =============================================================================
-// Truncation utilities
-// =============================================================================
-/**
- * Truncate a unified diff at a sensible boundary.
- *
- * The algorithm prefers semantic boundaries to keep diffs readable:
- *
- * 1. If the diff is shorter than `maxChars` (default 3800), return it unchanged.
- * 2. Try: find the **last** `@@` hunk header in the trailing 50% portion of
- *    the diff and cut right before it.
- * 3. Fallback: find the **last** newline in the trailing 80% portion and cut
- *    after it.
- * 4. Hard fallback: cut exactly at `maxChars`.
- *
- * Always appends `"  …(truncated)"` when truncation occurs.
- *
- * @param diff    - The unified diff text to truncate.
- * @param maxChars - Maximum allowed characters (including suffix). Default 3800.
- * @returns The (possibly truncated) diff text.
- */
-function truncateCodeDiff(diff, maxChars = 3800) {
-    if (diff.length <= maxChars) {
-        return diff;
-    }
-    const suffix = TRUNCATION_SUFFIX;
-    const effectiveMax = maxChars - TRUNCATION_SUFFIX_LENGTH;
-    if (effectiveMax <= 0) {
-        return diff.slice(0, Math.max(0, maxChars - 1)) + suffix;
-    }
-    // Step 2: find last "@@" hunk header in trailing 50%
-    const halfPoint = Math.floor(diff.length * 0.5);
-    // We search for "\n@@" or "@@" at the very start.  Use a regex that
-    // matches a line starting with "@@" (after optional leading whitespace in
-    // some edge cases, but standard diffs have "@@" at column 0).
-    const hunkHeaderRe = /(^|\n)@@/g;
-    let lastHunkHeaderPos = -1;
-    let match;
-    // Reset lastIndex and scan from the beginning; we only accept matches whose
-    // index is >= halfPoint.
-    hunkHeaderRe.lastIndex = 0;
-    while ((match = hunkHeaderRe.exec(diff)) !== null) {
-        const cap = match[1]; // the newline-or-start anchor
-        const pos = match.index + (cap ? cap.length : 0); // position of "@@"
-        if (pos >= halfPoint && pos <= effectiveMax) {
-            lastHunkHeaderPos = pos;
-        }
-    }
-    if (lastHunkHeaderPos > 0) {
-        return diff.slice(0, lastHunkHeaderPos) + suffix;
-    }
-    // Step 3: find last "\n" in trailing 80%
-    const eightyPoint = Math.floor(diff.length * 0.2);
-    for (let i = effectiveMax - 1; i >= eightyPoint; i--) {
-        if (diff[i] === '\n' && i < effectiveMax) {
-            return diff.slice(0, i + 1) + suffix;
-        }
-    }
-    // Step 4: hard cut
-    return diff.slice(0, effectiveMax) + suffix;
-}
-/**
- * Truncate plain text with newline-awareness.
- *
- * When the text is longer than `maxChars`, it is cut at the last newline
- * found before `maxChars` (minus the suffix length). If no suitable newline
- * exists, a hard cut is made.
- *
- * The suffix `"  …(truncated)"` is appended only when truncation occurs.
- *
- * @param text     - The text to truncate.
- * @param maxChars - Maximum allowed characters (including suffix).
- * @returns The (possibly truncated) text.
- */
-function truncateText(text, maxChars) {
-    if (text.length <= maxChars) {
-        return text;
-    }
-    const suffix = TRUNCATION_SUFFIX;
-    const effectiveMax = maxChars - TRUNCATION_SUFFIX_LENGTH;
-    if (effectiveMax <= 0) {
-        return text.slice(0, Math.max(0, maxChars - 1)) + suffix;
-    }
-    // Try to find the last newline within the budget
-    for (let i = effectiveMax - 1; i >= 0; i--) {
-        if (text[i] === '\n') {
-            return text.slice(0, i) + suffix;
-        }
-    }
-    // Hard cut
-    return text.slice(0, effectiveMax) + suffix;
-}
-/**
- * Truncate a subtitles array.
- *
- * 1. If the array has more than `maxEntries`, it is sliced to `maxEntries`.
- * 2. Each remaining entry that exceeds `maxChars` is individually truncated
- *    via `truncateText`.
- *
- * Entries that already fit within both limits are left unchanged.
- *
- * @param subtitles  - Array of subtitle strings.
- * @param maxChars   - Maximum characters per entry (including suffix).
- * @param maxEntries - Maximum number of entries to keep.
- * @returns The truncated subtitles array (always a new array).
- */
-function truncateSubtitles(subtitles, maxChars, maxEntries) {
-    // Cap entry count
-    const capped = subtitles.length > maxEntries ? subtitles.slice(0, maxEntries) : [...subtitles];
-    // Truncate each entry
-    return capped.map((entry) => truncateText(entry, maxChars));
-}
-// =============================================================================
-// Budget profile
-// =============================================================================
-/**
- * Compute a budget profile based on spec and optional fragment counts.
- *
- * The profile determines how many fragments, contents, and characters the
- * pipeline should budget when building LLM prompts. Higher counts produce
- * tighter budgets to keep prompts manageable.
- *
- * Thresholds (matching `truncate.py:38-57`):
- *
- * | specCount | tier    | maxFragments | maxContents | contentBudget |
- * |-----------|---------|--------------|-------------|---------------|
- * | ≤ 3       | tiny    | 12           | 16          | 48000         |
- * | ≤ 8       | small   | 10           | 14          | 40000         |
- * | ≤ 15      | medium  | 8            | 12          | 32000         |
- * | ≤ 30      | large   | 6            | 10          | 24000         |
- * | > 30      | vlarge  | 0            | 0           | 16000         |
- *
- * The `vlarge` tier disables fragment/contents inclusion entirely (0 values).
- *
- * @param specCount     - Number of specs in the knowledge graph.
- * @param fragmentCount - (Unused) reserved for future per-fragment weighting.
- * @returns The budget profile for the given scale.
- */
-function computeBudgetProfile(specCount, _fragmentCount) {
-    if (specCount <= 3) {
-        return { tier: 'tiny', maxFragments: 12, maxContents: 16, contentBudget: 48000 };
-    }
-    if (specCount <= 8) {
-        return { tier: 'small', maxFragments: 10, maxContents: 14, contentBudget: 40000 };
-    }
-    if (specCount <= 15) {
-        return { tier: 'medium', maxFragments: 8, maxContents: 12, contentBudget: 32000 };
-    }
-    if (specCount <= 30) {
-        return { tier: 'large', maxFragments: 6, maxContents: 10, contentBudget: 24000 };
-    }
-    return { tier: 'vlarge', maxFragments: 0, maxContents: 0, contentBudget: 16000 };
-}
-//# sourceMappingURL=utils.js.map

package/dist/spec/utils.js.map

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

package/scripts/add-lang/bench.sh

@@ -1,60 +0,0 @@
-#!/usr/bin/env bash
-# Add-lang benchmark for ONE repo:
-#   clone -> wipe+index (with the homegraph on PATH) -> verify extraction ->
-#   with/without retrieval A/B (reuses scripts/agent-eval/run-all.sh).
-#
-# Assumes the homegraph dev build is already built + linked on PATH — the skill
-# runs `npm run build && ./scripts/local-install.sh` ONCE before looping repos.
-# The A/B is skipped if extraction fails its critical checks (don't burn $ on a
-# broken extractor); set FORCE_AB=1 to run it anyway.
-#
-# Usage: bench.sh <lang> <repo-name> <repo-url> "<question>" [headless|tmux|all]
-# Env:   CORPUS   corpus dir (default /tmp/homegraph-corpus, shared with agent-eval)
-set -uo pipefail
-
-LANG_TOKEN="${1:?usage: bench.sh <lang> <repo-name> <repo-url> \"<question>\" [mode]}"
-NAME="${2:?repo-name required}"
-URL="${3:?repo-url required}"
-Q="${4:?question required}"
-MODE="${5:-headless}"
-
-HARNESS="$(cd "$(dirname "$0")" && pwd)"
-AGENT_EVAL="$(cd "$HARNESS/../agent-eval" && pwd)"
-CORPUS="${CORPUS:-/tmp/homegraph-corpus}"
-REPO="$CORPUS/$NAME"
-
-command -v homegraph >/dev/null || { echo "no homegraph on PATH (build + ./scripts/local-install.sh first)"; exit 1; }
-
-echo "==================== add-lang bench: $NAME ($LANG_TOKEN) ===================="
-echo "homegraph: $(command -v homegraph) -> $(homegraph --version 2>/dev/null || echo '?')"
-
-# 1. Ensure the repo (shallow clone, reuse if present).
-mkdir -p "$CORPUS"
-if [ -d "$REPO/.git" ]; then
-  echo "→ reusing checkout: $REPO"
-else
-  echo "→ cloning $URL"
-  git clone --depth 1 "$URL" "$REPO" || { echo "git clone failed"; exit 1; }
-fi
-
-# 2. Wipe + index with the binary under test.
-echo "→ wiping .homegraph and indexing"
-rm -rf "$REPO/.homegraph"
-( cd "$REPO" && homegraph init -i ) || { echo "indexing failed"; exit 1; }
-
-# 3. Verify extraction (cheap guard before the paid A/B).
-echo "→ verifying extraction"
-node "$HARNESS/verify-extraction.mjs" "$REPO" "$LANG_TOKEN"
-VERIFY=$?
-
-# 4. Retrieval A/B (skipped if extraction is broken, unless FORCE_AB=1).
-if [ "$VERIFY" -ne 0 ] && [ "${FORCE_AB:-0}" != "1" ]; then
-  echo "→ SKIPPING A/B — extraction failed critical checks (set FORCE_AB=1 to override)"
-else
-  echo "→ retrieval A/B (mode=$MODE)"
-  bash "$AGENT_EVAL/run-all.sh" "$REPO" "$Q" "$MODE"
-fi
-
-echo "==================== bench complete: $NAME (verify exit=$VERIFY) ===================="
-# Exit reflects extraction: 0 = pass/warn, 1 = critical fail, 2 = couldn't read status.
-exit "$VERIFY"