kibi-cli 0.2.3 → 0.2.6

package/dist/query/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/query/service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,UAS9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAqClE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACpB,MAAM,CAkBR"}

package/dist/query/service.js

@@ -0,0 +1,149 @@
+/*
+ * Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ * Copyright (C) 2026 Piotr Franczyk
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ */
+import { escapeAtom, parseEntityFromBinding, parseEntityFromList, parseListOfLists, } from "../prolog/codec.js";
+export const VALID_ENTITY_TYPES = [
+    "req",
+    "scenario",
+    "test",
+    "adr",
+    "flag",
+    "event",
+    "symbol",
+    "fact",
+];
+/**
+ * Build a Prolog query goal from filters.
+ */
+export function buildEntityQueryGoal(filters) {
+    const { type, id, sourceFile, tags } = filters;
+    if (sourceFile) {
+        const safeSource = escapeAtom(sourceFile);
+        if (type) {
+            const safeType = escapeAtom(type);
+            return `findall([Id,'${safeType}',Props], (kb_entities_by_source('${safeSource}', SourceIds), member(Id, SourceIds), kb_entity(Id, '${safeType}', Props)), Results)`;
+        }
+        return `findall([Id,Type,Props], (kb_entities_by_source('${safeSource}', SourceIds), member(Id, SourceIds), kb_entity(Id, Type, Props)), Results)`;
+    }
+    if (id && type) {
+        const safeId = escapeAtom(id);
+        const safeType = escapeAtom(type);
+        return `findall(['${safeId}','${safeType}',Props], kb_entity('${safeId}', '${safeType}', Props), Results)`;
+    }
+    if (id) {
+        const safeId = escapeAtom(id);
+        return `findall(['${safeId}',Type,Props], kb_entity('${safeId}', Type, Props), Results)`;
+    }
+    if (tags && tags.length > 0) {
+        if (type) {
+            const safeType = escapeAtom(type);
+            return `findall([Id,'${safeType}',Props], kb_entity(Id, '${safeType}', Props), Results)`;
+        }
+        return "findall([Id,Type,Props], kb_entity(Id, Type, Props), Results)";
+    }
+    if (type) {
+        const safeType = escapeAtom(type);
+        return `findall([Id,'${safeType}',Props], kb_entity(Id, '${safeType}', Props), Results)`;
+    }
+    return "findall([Id,Type,Props], kb_entity(Id, Type, Props), Results)";
+}
+/**
+ * Execute a filtered entity query against the KB.
+ */
+export async function queryEntities(prolog, filters) {
+    const { tags, limit = 100, offset = 0 } = filters;
+    const goal = buildEntityQueryGoal(filters);
+    const queryResult = await prolog.query(goal);
+    let entities = [];
+    if (queryResult.success) {
+        if (queryResult.bindings.Results) {
+            const entitiesData = parseListOfLists(queryResult.bindings.Results);
+            for (const data of entitiesData) {
+                const entity = parseEntityFromList(data);
+                entities.push(entity);
+            }
+        }
+        else if (queryResult.bindings.Result) {
+            const entity = parseEntityFromBinding(queryResult.bindings.Result);
+            entities = [entity];
+        }
+    }
+    else {
+        throw new Error(queryResult.error || "Query failed with unknown error");
+    }
+    // Apply tag filtering client-side if specified
+    if (tags && tags.length > 0) {
+        entities = dedupeEntities(entities.filter((entity) => hasAnyTag(entity, tags)));
+    }
+    const totalCount = entities.length;
+    const paginated = entities.slice(offset, offset + limit);
+    return { entities: paginated, totalCount };
+}
+/**
+ * Validate entity type.
+ */
+export function validateEntityType(type) {
+    return VALID_ENTITY_TYPES.includes(type);
+}
+/**
+ * Get validation error message for invalid type.
+ */
+export function getInvalidTypeError(type) {
+    return `Invalid type '${type}'. Valid types: ${VALID_ENTITY_TYPES.join(", ")}. Use a single type value, or omit this parameter to query all entities.`;
+}
+/**
+ * Build human-readable summary text for query results.
+ */
+export function buildQuerySummaryText(result, filters) {
+    const { entities, totalCount } = result;
+    const { type, offset, limit } = filters;
+    if (totalCount === 0) {
+        return `No entities found${type ? ` of type '${type}'` : ""}.`;
+    }
+    const details = entities
+        .map((e) => {
+        const id = String(e.id || "").replace(/^file:\/\/.*\//, "");
+        const title = String(e.title || "");
+        const status = String(e.status || "");
+        return `${id} (${title}, status=${status})`;
+    })
+        .join(", ");
+    return `Found ${totalCount} entities${type ? ` of type '${type}'` : ""}. Showing ${entities.length} (offset ${offset}, limit ${limit}): ${details}`;
+}
+function hasAnyTag(entity, requestedTags) {
+    const expected = new Set(requestedTags.map(normalizeTagValue));
+    const rawTags = entity.tags;
+    if (!Array.isArray(rawTags) || rawTags.length === 0) {
+        return false;
+    }
+    for (const tag of rawTags) {
+        if (expected.has(normalizeTagValue(tag))) {
+            return true;
+        }
+    }
+    return false;
+}
+function normalizeTagValue(tag) {
+    return String(tag).trim();
+}
+function dedupeEntities(entities) {
+    const seen = new Set();
+    const deduped = [];
+    for (const entity of entities) {
+        const id = String(entity.id ?? "");
+        const type = String(entity.type ?? "");
+        const key = `${type}::${id}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(entity);
+    }
+    return deduped;
+}

package/dist/relationships/shards.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Represents a relationship record stored in shard files.
+ */
+export interface RelationshipRecord {
+    id: string;
+    type: string;
+    from: string;
+    to: string;
+    created_at: string;
+    created_by: string;
+    source: string;
+    confidence?: number;
+}
+/**
+ * Gets the path to the relationships directory for a given KB root.
+ */
+export declare function getRelationshipsDir(kbRoot: string): string;
+/**
+ * Computes the shard name (first 2 chars of SHA256) for a given entity ID.
+ */
+export declare function shardForFromId(fromId: string): string;
+/**
+ * Computes the shard path for a given entity ID.
+ * Uses first 2 chars of SHA256(entityId) as shard name.
+ */
+export declare function computeShardPath(kbRoot: string, entityId: string): string;
+/**
+ * Reads a relationship shard file.
+ * Returns empty array if file doesn't exist.
+ * Throws on parse errors.
+ */
+export declare function readShard(shardPath: string): RelationshipRecord[];
+/**
+ * Writes a relationship shard file.
+ * Creates parent directories if needed.
+ */
+export declare function writeShard(shardPath: string, records: RelationshipRecord[]): void;
+/**
+ * Appends a relationship to the appropriate shard.
+ * Returns the shard path and record ID.
+ */
+export declare function appendRelationship(kbRoot: string, relationship: Omit<RelationshipRecord, "id">): {
+    shardPath: string;
+    recordId: string;
+};
+/**
+ * Lists all shard files in the relationships directory.
+ */
+export declare function listShards(kbRoot: string): string[];
+/**
+ * Reads all relationships from all shards.
+ */
+export declare function readAllShards(kbRoot: string): RelationshipRecord[];
+/**
+ * Removes dangling relationships that reference non-existent entities.
+ */
+export declare function pruneDangling(records: RelationshipRecord[], validEntityIds: Set<string>): RelationshipRecord[];
+/**
+ * Generates a deterministic relationship ID.
+ */
+export declare function relationshipIdFor(type: string, from: string, to: string): string;
+/**
+ * Merges existing and incoming relationship records.
+ * Deduplicates by (type, from, to) tuple.
+ * On conflict, keeps the record with newer created_at timestamp.
+ */
+export declare function mergeRecords(existing: RelationshipRecord[], incoming: RelationshipRecord[]): RelationshipRecord[];
+//# sourceMappingURL=shards.d.ts.map

package/dist/relationships/shards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shards.d.ts","sourceRoot":"","sources":["../../src/relationships/shards.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqFjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,IAAI,CAoBN;AAqCD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAC3C;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA4BzC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAUlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,kBAAkB,EAAE,CAKtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CAMR;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,kBAAkB,EAAE,CAgCtB"}

package/dist/relationships/shards.js

@@ -0,0 +1,263 @@
+/*
+ * Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ * Copyright (C) 2026 Piotr Franczyk
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { load as parseYAML } from "js-yaml";
+/**
+ * Gets the path to the relationships directory for a given KB root.
+ */
+export function getRelationshipsDir(kbRoot) {
+    return path.join(kbRoot, "relationships");
+}
+/**
+ * Computes the shard name (first 2 chars of SHA256) for a given entity ID.
+ */
+export function shardForFromId(fromId) {
+    const hash = crypto.createHash("sha256").update(fromId).digest("hex");
+    return hash.slice(0, 2);
+}
+/**
+ * Computes the shard path for a given entity ID.
+ * Uses first 2 chars of SHA256(entityId) as shard name.
+ */
+export function computeShardPath(kbRoot, entityId) {
+    const shardName = shardForFromId(entityId);
+    return path.join(getRelationshipsDir(kbRoot), `${shardName}.yaml`);
+}
+/**
+ * Reads a relationship shard file.
+ * Returns empty array if file doesn't exist.
+ * Throws on parse errors.
+ */
+export function readShard(shardPath) {
+    if (!fs.existsSync(shardPath)) {
+        return [];
+    }
+    const content = fs.readFileSync(shardPath, "utf8");
+    if (!content.trim()) {
+        return [];
+    }
+    const parsed = parseYAML(content);
+    if (!parsed || !Array.isArray(parsed.relationships)) {
+        throw new Error(`Invalid shard file: missing 'relationships' array at ${shardPath}`);
+    }
+    return parsed.relationships.map((record, index) => {
+        if (typeof record !== "object" || record === null) {
+            throw new Error(`Invalid record at ${shardPath}[${index}]: expected object`);
+        }
+        const rec = record;
+        // Validate required fields
+        if (typeof rec.id !== "string" || !rec.id) {
+            throw new Error(`Missing or invalid 'id' at ${shardPath}[${index}]`);
+        }
+        if (typeof rec.type !== "string" || !rec.type) {
+            throw new Error(`Missing or invalid 'type' at ${shardPath}[${index}]`);
+        }
+        if (typeof rec.from !== "string" || !rec.from) {
+            throw new Error(`Missing or invalid 'from' at ${shardPath}[${index}]`);
+        }
+        if (typeof rec.to !== "string" || !rec.to) {
+            throw new Error(`Missing or invalid 'to' at ${shardPath}[${index}]`);
+        }
+        // Handle created_at - YAML may auto-convert ISO dates to Date objects
+        let createdAt;
+        if (rec.created_at instanceof Date) {
+            createdAt = rec.created_at.toISOString().replace(/\.000Z$/, 'Z');
+        }
+        else if (typeof rec.created_at === "string" && rec.created_at) {
+            createdAt = rec.created_at;
+        }
+        else {
+            throw new Error(`Missing or invalid 'created_at' at ${shardPath}[${index}]`);
+        }
+        if (typeof rec.created_by !== "string" || !rec.created_by) {
+            throw new Error(`Missing or invalid 'created_by' at ${shardPath}[${index}]`);
+        }
+        if (typeof rec.source !== "string" || !rec.source) {
+            throw new Error(`Missing or invalid 'source' at ${shardPath}[${index}]`);
+        }
+        const result = {
+            id: rec.id,
+            type: rec.type,
+            from: rec.from,
+            to: rec.to,
+            created_at: createdAt,
+            created_by: rec.created_by,
+            source: rec.source,
+        };
+        if (rec.confidence !== undefined) {
+            if (typeof rec.confidence !== "number") {
+                throw new Error(`Invalid 'confidence' at ${shardPath}[${index}]: expected number`);
+            }
+            result.confidence = rec.confidence;
+        }
+        return result;
+    });
+}
+/**
+ * Writes a relationship shard file.
+ * Creates parent directories if needed.
+ */
+export function writeShard(shardPath, records) {
+    const dir = path.dirname(shardPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Sort and dedupe records
+    const sorted = sortRecords(records);
+    const seen = new Set();
+    const unique = [];
+    for (const record of sorted) {
+        const key = `${record.type}|${record.from}|${record.to}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        unique.push(record);
+    }
+    const yamlContent = serializeToYAML(unique);
+    fs.writeFileSync(shardPath, yamlContent, "utf8");
+}
+/**
+ * Serializes records to YAML format.
+ */
+function serializeToYAML(records) {
+    const lines = ["relationships:"];
+    for (const record of records) {
+        lines.push(`  - id: ${record.id}`);
+        lines.push(`    type: ${record.type}`);
+        lines.push(`    from: ${record.from}`);
+        lines.push(`    to: ${record.to}`);
+        lines.push(`    created_at: "${record.created_at}"`);
+        lines.push(`    created_by: ${record.created_by}`);
+        lines.push(`    source: ${record.source}`);
+        if (record.confidence !== undefined) {
+            lines.push(`    confidence: ${record.confidence}`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+/**
+ * Sorts records deterministically by from, then type, then to.
+ */
+function sortRecords(records) {
+    return [...records].sort((a, b) => {
+        const fromCompare = a.from.localeCompare(b.from);
+        if (fromCompare !== 0)
+            return fromCompare;
+        const typeCompare = a.type.localeCompare(b.type);
+        if (typeCompare !== 0)
+            return typeCompare;
+        return a.to.localeCompare(b.to);
+    });
+}
+/**
+ * Appends a relationship to the appropriate shard.
+ * Returns the shard path and record ID.
+ */
+export function appendRelationship(kbRoot, relationship) {
+    const shardPath = computeShardPath(kbRoot, relationship.from);
+    const existing = readShard(shardPath);
+    // Generate deterministic ID
+    const recordId = relationshipIdFor(relationship.type, relationship.from, relationship.to);
+    // Check if relationship already exists
+    const exists = existing.some((r) => r.type === relationship.type &&
+        r.from === relationship.from &&
+        r.to === relationship.to);
+    if (!exists) {
+        const newRecord = {
+            ...relationship,
+            id: recordId,
+        };
+        writeShard(shardPath, [...existing, newRecord]);
+    }
+    return { shardPath, recordId };
+}
+/**
+ * Lists all shard files in the relationships directory.
+ */
+export function listShards(kbRoot) {
+    const relationshipsDir = getRelationshipsDir(kbRoot);
+    if (!fs.existsSync(relationshipsDir)) {
+        return [];
+    }
+    return fs
+        .readdirSync(relationshipsDir)
+        .filter((f) => f.endsWith(".yaml"))
+        .map((f) => path.join(relationshipsDir, f));
+}
+/**
+ * Reads all relationships from all shards.
+ */
+export function readAllShards(kbRoot) {
+    const shards = listShards(kbRoot);
+    const allRecords = [];
+    for (const shardPath of shards) {
+        const records = readShard(shardPath);
+        allRecords.push(...records);
+    }
+    return allRecords;
+}
+/**
+ * Removes dangling relationships that reference non-existent entities.
+ */
+export function pruneDangling(records, validEntityIds) {
+    return records.filter((record) => validEntityIds.has(record.from) && validEntityIds.has(record.to));
+}
+/**
+ * Generates a deterministic relationship ID.
+ */
+export function relationshipIdFor(type, from, to) {
+    const hash = crypto
+        .createHash("sha256")
+        .update(`${type}|${from}|${to}`)
+        .digest("hex");
+    return `rel-${hash.slice(0, 12)}`;
+}
+/**
+ * Merges existing and incoming relationship records.
+ * Deduplicates by (type, from, to) tuple.
+ * On conflict, keeps the record with newer created_at timestamp.
+ */
+export function mergeRecords(existing, incoming) {
+    const recordMap = new Map();
+    // Helper to create key from record
+    const makeKey = (r) => `${r.type}|${r.from}|${r.to}`;
+    // Add existing records
+    for (const record of existing) {
+        recordMap.set(makeKey(record), record);
+    }
+    // Merge incoming records
+    for (const record of incoming) {
+        const key = makeKey(record);
+        const existingRecord = recordMap.get(key);
+        if (!existingRecord) {
+            // New record
+            recordMap.set(key, record);
+        }
+        else {
+            // Conflict - keep newer based on created_at
+            const existingTime = new Date(existingRecord.created_at).getTime();
+            const incomingTime = new Date(record.created_at).getTime();
+            if (incomingTime >= existingTime) {
+                recordMap.set(key, record);
+            }
+        }
+    }
+    return Array.from(recordMap.values());
+}

package/dist/traceability/git-staged.d.ts

@@ -10,6 +10,9 @@ export interface StagedFile {
     hunkRanges: HunkRange[];
     content?: string;
 }
+type ExecFn = (cmd: string, opts: {
+    encoding: "utf8";
+}) => string;
 /**
  * Parse null-separated name-status output from git
  */
@@ -24,6 +27,6 @@ export declare function parseHunksFromDiff(diffText: string, isNewFile?: boolean
 /**
  * Get staged files with statuses, hunks and content.
  */
-export declare function getStagedFiles(): StagedFile[];
+export declare function getStagedFiles(exec?: ExecFn): StagedFile[];
 export default getStagedFiles;
 //# sourceMappingURL=git-staged.d.ts.map

package/dist/traceability/git-staged.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-staged.d.ts","sourceRoot":"","sources":["../../src/traceability/git-staged.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAS5C;AA8BD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,SAAS,EAAE,CAoBb;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAmF7C;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"git-staged.d.ts","sourceRoot":"","sources":["../../src/traceability/git-staged.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC;AAalE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAS5C;AAsCD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,UAAQ,GAChB,SAAS,EAAE,CAoBb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAiB,GAAG,UAAU,EAAE,CA4FpE;AAED,eAAe,cAAc,CAAC"}

package/dist/traceability/git-staged.js

@@ -1,7 +1,7 @@
 import { execSync } from "node:child_process";
-function runGit(cmd) {
+function runGit(cmd, exec) {
     try {
-        return execSync(cmd, { encoding: "utf8" });
+        return exec(cmd, { encoding: "utf8" });
     }
     catch (err) {
         // wrap common errors
@@ -35,6 +35,12 @@ const SUPPORTED_EXT = new Set([
     ".cjs",
 ]);
 const ENTITY_MARKDOWN_DIRS = ["/requirements/", "/scenarios/", "/tests/"];
+function shouldLogTraceDebug() {
+    return Boolean(process.env.KIBI_TRACE || process.env.KIBI_DEBUG);
+}
+function escapePath(p) {
+    return p.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
 function hasSupportedExt(p) {
     for (const ext of SUPPORTED_EXT) {
         if (p.endsWith(ext))
@@ -80,11 +86,11 @@ export function parseHunksFromDiff(diffText, isNewFile = false) {
 /**
  * Get staged files with statuses, hunks and content.
  */
-export function getStagedFiles() {
+export function getStagedFiles(exec = execSync) {
     // 1. get staged name-status -z
     let nameStatus;
     try {
-        nameStatus = runGit("git diff --cached --name-status -z --diff-filter=ACMRD");
+        nameStatus = runGit("git diff --cached --name-status -z --diff-filter=ACMRD", exec);
     }
     catch (err) {
         throw new Error(`failed to list staged files: ${String(err)}`);
@@ -95,8 +101,9 @@ export function getStagedFiles() {
         const statusRaw = entry.status;
         const status = statusRaw[0] || "M";
         if (status === "D") {
-            // deleted files: skip but log via console.debug
-            console.debug(`Skipping deleted file (staged): ${entry.parts.join(" -> ")}`);
+            if (shouldLogTraceDebug()) {
+                console.debug(`Skipping deleted file (staged): ${entry.parts.join(" -> ")}`);
+            }
             continue;
         }
         // handle renames: parts = [old, new]
@@ -109,17 +116,21 @@ export function getStagedFiles() {
             }
         }
         if (!hasSupportedExt(path) && !isEntityMarkdown(path)) {
-            console.debug(`Skipping unsupported extension: ${path}`);
+            if (shouldLogTraceDebug()) {
+                console.debug(`Skipping unsupported extension: ${path}`);
+            }
             continue;
         }
         // 4. compute hunks using git diff --cached -U0 -- <path>
         let diffText = "";
         try {
             // use new path for diff; quote the path to handle spaces
-            diffText = runGit(`git diff --cached -U0 -- "${path.replace(/"/g, '\\"')}"`);
+            diffText = runGit(`git diff --cached -U0 -- "${escapePath(path)}"`, exec);
         }
         catch (err) {
-            console.debug(`Failed to get diff for ${path}: ${String(err)}`);
+            if (shouldLogTraceDebug()) {
+                console.debug(`Failed to get diff for ${path}: ${String(err)}`);
+            }
             diffText = "";
         }
         // determine if new file: status 'A' or diff contains /dev/null in old file path
@@ -128,13 +139,15 @@ export function getStagedFiles() {
         // 5. read staged content using git show :<path>
         let content;
         try {
-            content = runGit(`git show :"${path.replace(/"/g, '\\"')}"`);
+            content = runGit(`git show :"${escapePath(path)}"`, exec);
         }
         catch (err) {
             // binary or deleted in index
             const e = err;
             const em = e?.message ? String(e.message) : String(err);
-            console.debug(`Skipping binary/deleted or unreadable staged file ${path}: ${em}`);
+            if (shouldLogTraceDebug()) {
+                console.debug(`Skipping binary/deleted or unreadable staged file ${path}: ${em}`);
+            }
             continue;
         }
         // If we had a new-file sentinel (end = MAX_SAFE_INTEGER) set a realistic end as content lines

package/dist/types/changeset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changeset.d.ts","sourceRoot":"","sources":["../../src/types/changeset.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,gBAAgB,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"changeset.d.ts","sourceRoot":"","sources":["../../src/types/changeset.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,gBAAgB,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,eAAe,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,eAAe,SAAS,CAAC"}

package/dist/types/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AA6CA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,GAAG,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAC/C,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,MAAM,GACd,WAAW,GACX,QAAQ,GACR,UAAU,GACV,GAAG,GACH,IAAI,GACJ,KAAK,GACL,MAAM,GACN,IAAI,CAAC"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,GAAG,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAC/C,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACjD,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AACrD,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,MAAM,GACd,WAAW,GACX,QAAQ,GACR,UAAU,GACV,GAAG,GACH,IAAI,GACJ,KAAK,GACL,MAAM,GACN,IAAI,CAAC"}

package/dist/types/relationships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/types/relationships.ts"],"names":[],"mappings":"AA6CA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EACA,YAAY,GACZ,cAAc,GACd,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/types/relationships.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EACA,YAAY,GACZ,cAAc,GACd,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/utils/branch-resolver.d.ts

@@ -56,6 +56,10 @@ export declare function copyCleanSnapshot(sourcePath: string, targetPath: string
  */
 export declare function getVolatileArtifactPatterns(): string[];
 /**
+ * @deprecated defaultBranch is deprecated. Branch lifecycle now follows git naturally
+ * without requiring a configured default. This function is kept for backward compatibility
+ * but should not be used for new code.
+ *
  * Resolve the default branch using the following precedence:
  * 1. Configured defaultBranch from config (if set and valid)
  * 2. Git remote HEAD (refs/remotes/origin/HEAD)

package/dist/utils/branch-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branch-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/branch-resolver.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,uBAAuB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,sBAAsB,GAC9B,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,CAAC;AA8BpB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,GAAE,MAAsB,GACpC,sBAAsB,CAmHxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,aAAa,GAAE,MAAsB,GAAG,OAAO,CAa7E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,GACZ,MAAM,CAuBR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBvD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAUN;AA6BD;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAMtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAsB,EAC3B,MAAM,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqCtD"}
+{"version":3,"file":"branch-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/branch-resolver.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,uBAAuB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,sBAAsB,GAC9B,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,CAAC;AA8BpB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,GAAE,MAAsB,GACpC,sBAAsB,CAmHxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,aAAa,GAAE,MAAsB,GAAG,OAAO,CAa7E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,GACZ,MAAM,CAuBR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBvD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAUN;AA6BD;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAMtD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAsB,EAC3B,MAAM,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqCtD"}

package/dist/utils/branch-resolver.js

@@ -261,6 +261,10 @@ export function getVolatileArtifactPatterns() {
     ];
 }
 /**
+ * @deprecated defaultBranch is deprecated. Branch lifecycle now follows git naturally
+ * without requiring a configured default. This function is kept for backward compatibility
+ * but should not be used for new code.
+ *
  * Resolve the default branch using the following precedence:
  * 1. Configured defaultBranch from config (if set and valid)
  * 2. Git remote HEAD (refs/remotes/origin/HEAD)