kibi-opencode 0.14.0 → 0.15.1

package/dist/brief-delivery-reasons.js

@@ -1,132 +0,0 @@
-// Inlined from kibi-cli/operational-artifacts to avoid heavy module resolution
-function isOperationalArtifactPath(pathLike) {
-    const normalized = pathLike.replaceAll("\\", "/");
-    return /(^|\/)\.sisyphus\//.test(normalized);
-}
-const ORDER = {
-    conflict_detected: 0,
-    validation_issue: 1,
-    entity_modified: 2,
-    entity_added: 3,
-    entity_removed: 4,
-    relationship_changed: 5,
-};
-const TYPE_NAMES = {
-    REQ: "requirement",
-    FACT: "fact",
-    TEST: "test",
-    SCEN: "scenario",
-    SYM: "code traceability",
-    ADR: "decision",
-    FLAG: "runtime flag",
-    EVENT: "event",
-};
-function prefixName(id) {
-    const prefix = id.split("-")[0]?.toUpperCase() ?? id;
-    return TYPE_NAMES[prefix] ?? prefix;
-}
-function mk(kind, text, entityIds) {
-    return { kind, text, entityIds };
-}
-function entityItems(kind, ids) {
-    if (!ids.length)
-        return [];
-    const verb = kind === "entity_added" ? "Added" : kind === "entity_modified" ? "Updated" : "Removed";
-    const grouped = new Map();
-    for (const id of [...ids].sort()) {
-        const prefix = id.split("-")[0]?.toUpperCase() ?? id;
-        const group = grouped.get(prefix);
-        if (group) {
-            group.push(id);
-        }
-        else {
-            grouped.set(prefix, [id]);
-        }
-    }
-    return [...grouped.entries()].map(([, groupedIds]) => {
-        const noun = prefixName(groupedIds[0] ?? "");
-        const text = groupedIds.length === 1
-            ? `${verb} ${noun} ${groupedIds[0]}`
-            : `${verb} ${groupedIds.length} ${noun}s (${groupedIds.join(", ")})`;
-        return mk(kind, text, groupedIds);
-    });
-}
-function toastSummary(items) {
-    const first = items[0]?.text?.trim() ?? "";
-    const second = items[1]?.text?.trim() ?? "";
-    if (first && second)
-        return `${first}, ${second}`;
-    return first || second || undefined;
-}
-function toastWhy(items) {
-    if (items.some((i) => i.kind === "conflict_detected"))
-        return "There is a knowledge conflict to resolve before using the brief.";
-    if (items.some((i) => i.kind === "validation_issue"))
-        return "Validation issues need attention before the update is treated as settled.";
-    const hasEntities = items.some((i) => i.kind === "entity_added" || i.kind === "entity_modified" || i.kind === "entity_removed");
-    const hasRelationships = items.some((i) => i.kind === "relationship_changed");
-    if (hasEntities && hasRelationships)
-        return "Requirements and facts were updated.";
-    if (hasEntities)
-        return "Entities were updated.";
-    if (hasRelationships)
-        return "Relationships were updated.";
-    return undefined;
-}
-export function buildDeliveryReasons(input) {
-    const items = [];
-    if (input.conflictReasons?.length)
-        items.push(mk("conflict_detected", input.conflictReasons[0]?.trim() || "Conflict detected", []));
-    if (input.validationCount > 0)
-        items.push(mk("validation_issue", `${input.validationCount} validation issue${input.validationCount === 1 ? "" : "s"} detected`, []));
-    items.push(...entityItems("entity_modified", input.entitiesModified));
-    items.push(...entityItems("entity_added", input.entitiesAdded));
-    items.push(...entityItems("entity_removed", input.entitiesRemoved));
-    if (input.relationshipsChanged > 0)
-        items.push(mk("relationship_changed", `Updated ${input.relationshipsChanged} relationships`, []));
-    if (!items.length)
-        return undefined;
-    items.sort((a, b) => ORDER[a.kind] - ORDER[b.kind]);
-    return { version: 1, items, toast: { title: "Kibi Knowledge Update", summary: toastSummary(items) ?? "", whyItMatters: toastWhy(items) ?? "" } };
-}
-function isOperationalByEntityIds(item) {
-    if (item.entityIds.length === 0)
-        return false;
-    return item.entityIds.every((id) => {
-        const dashIdx = id.indexOf("-");
-        if (dashIdx < 0)
-            return false;
-        const name = id.slice(dashIdx + 1);
-        // Entity names with file extensions are likely from operational artifact files
-        return /\.[a-zA-Z0-9]+$/.test(name);
-    });
-}
-function isOperationalItem(item, allItems) {
-    if (item.kind === "relationship_changed") {
-        // relationship_changed items have no entityIds; treat as operational when
-        // all entity-level items in the set are operational (they're relationship side-effects)
-        const entityItems = allItems.filter((i) => i.kind === "entity_added" || i.kind === "entity_modified" || i.kind === "entity_removed");
-        return entityItems.length > 0 && entityItems.every(isOperationalByEntityIds);
-    }
-    return isOperationalByEntityIds(item);
-}
-export function renderToastSummary(reasons) {
-    const domainItems = reasons.items.filter((i) => !isOperationalItem(i, reasons.items));
-    if (domainItems.length === 0) {
-        return undefined; // suppress: specific-or-silent policy
-    }
-    return {
-        title: "Kibi Knowledge Update",
-        summary: toastSummary(domainItems) ?? "",
-        whyItMatters: toastWhy(domainItems) ?? "",
-    };
-}
-export function renderFullBriefReasons(reasons) {
-    const domainItems = reasons.items.filter((i) => !isOperationalItem(i, reasons.items));
-    const lines = ["## What changed", ...domainItems.map((r) => `- ${r.text}`)];
-    const whyItMatters = toastWhy(domainItems);
-    if (whyItMatters) {
-        lines.push("", "## Why it matters", whyItMatters);
-    }
-    return lines.join("\n");
-}

package/dist/brief-intent.d.ts

@@ -1,41 +0,0 @@
-import type { RepoPosture } from "./repo-posture.js";
-import type { RiskClass } from "./risk-classifier.js";
-export interface BriefIntentParams {
-    riskClass: RiskClass;
-    posture: RepoPosture;
-    maintenanceDegraded: boolean;
-    workspaceRoot: string;
-    branch: string;
-    sourceFiles: string[];
-    focusFilePath?: string;
-    seedIds?: string[];
-}
-export interface BriefIntentResult {
-    eligible: boolean;
-    reason: string;
-    fingerprint: string;
-    sourceFiles: string[];
-    seedIds: string[];
-}
-export interface BriefIntentInputs {
-    riskClass: RiskClass;
-    posture: RepoPosture;
-    maintenanceDegraded: boolean;
-    worktreeRoot: string;
-    branch: string;
-    sourceFiles: string[];
-    focusFilePath?: string;
-    seedIds?: string[];
-}
-export declare function deriveBriefIntent(params: BriefIntentParams): BriefIntentResult;
-export declare function computeBriefIntent(inputs: BriefIntentInputs): BriefIntentResult;
-export interface BriefingContextParams {
-    sourceFiles: string[];
-    seedIds?: string[];
-    changedEntityIds?: string[];
-}
-export interface BriefingContextResult {
-    sourceFiles: string[];
-    seedIds: string[];
-}
-export declare function buildBriefingContext(params: BriefingContextParams): BriefingContextResult;

package/dist/brief-intent.js

@@ -1,142 +0,0 @@
-// implements REQ-opencode-kibi-briefing-v2, REQ-opencode-smart-enforcement-v1
-// Inlined from kibi-cli/operational-artifacts to avoid heavy module resolution
-function isOperationalArtifactPath(pathLike) {
-    const normalized = pathLike.replaceAll("\\", "/");
-    return /(^|\/)\.sisyphus\//.test(normalized);
-}
-import { getSourceLinkedRequirementIds } from "./source-linked-guidance.js";
-const ELIGIBLE_RISK_CLASSES = new Set([
-    "behavior_candidate",
-    "traceability_candidate",
-]);
-const STRICT_ELIGIBLE_POSTURES = new Set([
-    "root_active",
-    "hybrid_root_plus_vendored",
-]);
-function sortAndDedup(files) {
-    return [...new Set(files)].sort();
-}
-function deriveSeedIds(params) {
-    if (params.seedIds !== undefined && params.seedIds.length > 0) {
-        return buildBriefingContext({
-            sourceFiles: params.sourceFiles,
-            seedIds: params.seedIds,
-        }).seedIds.slice(0, 3);
-    }
-    const focusFile = params.focusFilePath ?? params.sourceFiles[0];
-    if (!focusFile) {
-        return [];
-    }
-    return buildBriefingContext({
-        sourceFiles: params.sourceFiles,
-        seedIds: getSourceLinkedRequirementIds(params.workspaceRoot, focusFile),
-    }).seedIds.slice(0, 3);
-}
-// implements REQ-opencode-kibi-briefing-v2, REQ-opencode-smart-enforcement-v1
-export function deriveBriefIntent(params) {
-    const sortedSourceFiles = sortAndDedup(params.sourceFiles);
-    const nonOperationalSourceFiles = sortedSourceFiles.filter((f) => !isOperationalArtifactPath(f));
-    const fingerprint = `brief:${params.workspaceRoot}\0${params.branch}\0${params.riskClass}\0${nonOperationalSourceFiles.join("\0")}`;
-    const seedIds = deriveSeedIds(params);
-    if (sortedSourceFiles.length === 0) {
-        return {
-            eligible: false,
-            reason: "Ineligible: no source files in session",
-            fingerprint,
-            sourceFiles: sortedSourceFiles,
-            seedIds: [],
-        };
-    }
-    if (nonOperationalSourceFiles.length === 0) {
-        return {
-            eligible: false,
-            reason: "All source changes are operational task-tracking artifacts",
-            fingerprint,
-            sourceFiles: sortedSourceFiles,
-            seedIds: [],
-        };
-    }
-    if (!ELIGIBLE_RISK_CLASSES.has(params.riskClass)) {
-        return {
-            eligible: false,
-            reason: `Ineligible: riskClass ${params.riskClass} is not auto-brief eligible`,
-            fingerprint,
-            sourceFiles: sortedSourceFiles,
-            seedIds,
-        };
-    }
-    if (!STRICT_ELIGIBLE_POSTURES.has(params.posture)) {
-        return {
-            eligible: false,
-            reason: `Ineligible: posture ${params.posture} is not authoritative`,
-            fingerprint,
-            sourceFiles: sortedSourceFiles,
-            seedIds,
-        };
-    }
-    if (params.maintenanceDegraded) {
-        return {
-            eligible: false,
-            reason: "Ineligible: maintenance is degraded",
-            fingerprint,
-            sourceFiles: sortedSourceFiles,
-            seedIds,
-        };
-    }
-    return {
-        eligible: true,
-        reason: "Eligible for auto-briefing",
-        fingerprint,
-        sourceFiles: nonOperationalSourceFiles,
-        seedIds,
-    };
-}
-export function computeBriefIntent(
-// implements REQ-opencode-kibi-briefing-v2
-inputs) {
-    return deriveBriefIntent({
-        riskClass: inputs.riskClass,
-        posture: inputs.posture,
-        maintenanceDegraded: inputs.maintenanceDegraded,
-        workspaceRoot: inputs.worktreeRoot,
-        branch: inputs.branch,
-        sourceFiles: inputs.sourceFiles,
-        ...(inputs.focusFilePath !== undefined
-            ? { focusFilePath: inputs.focusFilePath }
-            : {}),
-        ...(inputs.seedIds !== undefined ? { seedIds: inputs.seedIds } : {}),
-    });
-}
-export function buildBriefingContext(
-// implements REQ-opencode-kibi-briefing-v6
-params) {
-    const sourceFiles = [...new Set(params.sourceFiles)].sort();
-    const seen = new Set();
-    const seeds = [];
-    // Take first 3 changed entity IDs in original order, dedupe, sort
-    if (params.changedEntityIds) {
-        for (const id of params.changedEntityIds.slice(0, 3)) {
-            if (!seen.has(id)) {
-                seeds.push(id);
-                seen.add(id);
-            }
-        }
-    }
-    // Fill remaining slots from seedIds in original order
-    if (params.seedIds) {
-        for (const id of params.seedIds) {
-            if (seeds.length >= 5)
-                break;
-            if (!seen.has(id)) {
-                seeds.push(id);
-                seen.add(id);
-            }
-        }
-    }
-    // Sort final seedIds alphabetically
-    seeds.sort((a, b) => a.localeCompare(b));
-    return {
-        sourceFiles,
-        seedIds: seeds,
-    };
-}

package/dist/briefing-runtime.d.ts

@@ -1,24 +0,0 @@
-import type { BriefIntentResult } from "./brief-intent.js";
-export type BriefingWorkspaceCtx = {
-    workspaceRoot: string;
-    branch: string;
-    directory?: string;
-    workspace?: string;
-    ttlMs?: number;
-};
-export type BriefingCitation = {
-    id: string;
-    type?: string;
-    title?: string;
-    source?: string;
-    textRef?: string;
-};
-export type BriefingRuntimeResult = {
-    state: "ready" | "tldr_fallback" | "no_briefing";
-    promptBlock: string;
-    tldr: string;
-    citations: BriefingCitation[];
-    showManualCue: boolean;
-    toastMessage: string;
-};
-export declare function fetchBriefingResult(client: unknown, workspaceCtx: BriefingWorkspaceCtx, intentResult: BriefIntentResult): Promise<BriefingRuntimeResult>;

package/dist/briefing-runtime.js

@@ -1,277 +0,0 @@
-// implements REQ-opencode-kibi-briefing-v2
-const DEFAULT_TTL_MS = 300_000;
-const WORKER_TITLE = "Kibi Auto Brief Worker";
-const READY_TOAST = "Kibi brief ready — summary added to guidance.";
-const TLDR_FALLBACK_TOAST = "Kibi brief summary added — use /brief-kibi for full details.";
-const UNAVAILABLE_TOAST = "Kibi brief unavailable — keeping /brief-kibi manual path.";
-const DEFAULT_WHY_IT_MATTERS = "This update changes how current project knowledge should be interpreted.";
-const PROMPT_INSTRUCTION = "Call only kb_briefing_generate once with the provided sourceFiles and seedIds. If briefingState is ready, copy only cited fields. If briefingState is no_briefing, return empty promptBlock/citations and keep manual cue availability. Never invent claims.";
-const PROMPT_FORMAT = {
-    type: "json_schema",
-    schema: {
-        type: "object",
-        properties: {
-            briefingState: { type: "string" },
-            tldr: { type: "string" },
-            promptBlock: { type: "string" },
-            citations: { type: "array", items: { type: "object" } },
-            activationState: { type: "string" },
-            confidence: { type: "string" },
-            freshness: { type: "string" },
-        },
-        required: ["briefingState"],
-    },
-};
-const workerSessionIds = new Map();
-const workerSessionPromises = new Map();
-const resultCache = new Map();
-const inFlightResults = new Map();
-function noBriefingResult() {
-    return {
-        state: "no_briefing",
-        promptBlock: "",
-        tldr: "",
-        citations: [],
-        showManualCue: true,
-        toastMessage: UNAVAILABLE_TOAST,
-    };
-}
-function workspaceSessionKey(workspaceCtx) {
-    return `${workspaceCtx.workspaceRoot}\0${workspaceCtx.branch}`;
-}
-function asRecord(value) {
-    return typeof value === "object" && value !== null
-        ? value
-        : null;
-}
-function asString(value) {
-    return typeof value === "string" ? value : "";
-}
-function sanitizePromptBlock(value) {
-    return asString(value).trim();
-}
-function sanitizeCitations(value) {
-    if (!Array.isArray(value)) {
-        return [];
-    }
-    const citations = [];
-    for (const item of value) {
-        const record = asRecord(item);
-        if (!record) {
-            continue;
-        }
-        const id = asString(record.id).trim();
-        if (!id) {
-            continue;
-        }
-        const citation = { id };
-        const type = asString(record.type).trim();
-        const title = asString(record.title).trim();
-        const source = asString(record.source).trim();
-        const textRef = asString(record.textRef).trim();
-        if (type) {
-            citation.type = type;
-        }
-        if (title) {
-            citation.title = title;
-        }
-        if (source) {
-            citation.source = source;
-        }
-        if (textRef) {
-            citation.textRef = textRef;
-        }
-        citations.push(citation);
-    }
-    return citations;
-}
-function hasBriefingState(value) {
-    const record = asRecord(value);
-    return record !== null && "briefingState" in record;
-}
-function extractParts(response) {
-    const root = asRecord(response);
-    if (!root) {
-        return [];
-    }
-    const data = asRecord(root.data);
-    const parts = data?.parts ?? root.parts;
-    return Array.isArray(parts) ? parts : [];
-}
-function parsePromptPayload(response) {
-    const parts = extractParts(response);
-    for (let index = parts.length - 1; index >= 0; index -= 1) {
-        const part = asRecord(parts[index]);
-        if (!part || part.type !== "text") {
-            continue;
-        }
-        const text = asString(part.text);
-        if (!text) {
-            continue;
-        }
-        try {
-            const parsed = JSON.parse(text);
-            if (hasBriefingState(parsed)) {
-                return parsed;
-            }
-        }
-        catch {
-            // Ignore malformed text parts and continue searching from the end.
-        }
-    }
-    return null;
-}
-function normalizeResult(payload) {
-    if (!payload) {
-        return noBriefingResult();
-    }
-    const briefingState = asString(payload.briefingState).trim();
-    const tldr = asString(payload.tldr).trim();
-    const promptBlock = sanitizePromptBlock(payload.promptBlock);
-    if (briefingState === "ready" && promptBlock) {
-        return {
-            state: "ready",
-            promptBlock,
-            tldr,
-            citations: sanitizeCitations(payload.citations),
-            showManualCue: false,
-            toastMessage: READY_TOAST,
-        };
-    }
-    if (briefingState === "ready" && tldr) {
-        return {
-            state: "tldr_fallback",
-            promptBlock: `- What changed: ${tldr}\n- Why it matters: ${DEFAULT_WHY_IT_MATTERS}`,
-            tldr,
-            citations: [],
-            showManualCue: true,
-            toastMessage: TLDR_FALLBACK_TOAST,
-        };
-    }
-    return noBriefingResult();
-}
-function getSessionApi(client) {
-    const root = asRecord(client);
-    const session = asRecord(root?.session);
-    if (!session) {
-        return null;
-    }
-    const create = session.create;
-    const prompt = session.prompt;
-    if (typeof create !== "function" || typeof prompt !== "function") {
-        return null;
-    }
-    return {
-        create: create,
-        prompt: prompt,
-    };
-}
-function extractSessionId(response) {
-    const root = asRecord(response);
-    if (!root) {
-        return null;
-    }
-    const directId = asString(root.id).trim();
-    if (directId) {
-        return directId;
-    }
-    const data = asRecord(root.data);
-    const dataId = asString(data?.id).trim();
-    return dataId || null;
-}
-async function getWorkerSessionId(sessionApi, workspaceCtx) {
-    const key = workspaceSessionKey(workspaceCtx);
-    const existing = workerSessionIds.get(key);
-    if (existing) {
-        return existing;
-    }
-    const pending = workerSessionPromises.get(key);
-    if (pending) {
-        return pending;
-    }
-    const promise = (async () => {
-        const response = await sessionApi.create({
-            directory: workspaceCtx.workspaceRoot,
-            title: WORKER_TITLE,
-        });
-        const sessionId = extractSessionId(response);
-        if (!sessionId) {
-            throw new Error("Failed to resolve worker session ID");
-        }
-        workerSessionIds.set(key, sessionId);
-        return sessionId;
-    })().finally(() => {
-        workerSessionPromises.delete(key);
-    });
-    workerSessionPromises.set(key, promise);
-    return promise;
-}
-async function loadBriefingResult(sessionApi, workspaceCtx, intentResult) {
-    const sessionID = await getWorkerSessionId(sessionApi, workspaceCtx);
-    const response = await sessionApi.prompt({
-        sessionID,
-        tools: { kb_briefing_generate: true },
-        format: PROMPT_FORMAT,
-        parts: [
-            {
-                type: "text",
-                text: PROMPT_INSTRUCTION,
-            },
-            {
-                type: "text",
-                text: JSON.stringify({
-                    sourceFiles: intentResult.sourceFiles,
-                    seedIds: intentResult.seedIds,
-                }),
-            },
-        ],
-    });
-    return normalizeResult(parsePromptPayload(response));
-}
-// implements REQ-opencode-kibi-briefing-v2
-export async function fetchBriefingResult(client, workspaceCtx, intentResult) {
-    const ttlMs = workspaceCtx.ttlMs ?? DEFAULT_TTL_MS;
-    const cached = resultCache.get(intentResult.fingerprint);
-    const now = Date.now();
-    if (cached && now - cached.timestamp <= ttlMs) {
-        return cached.result;
-    }
-    if (cached) {
-        resultCache.delete(intentResult.fingerprint);
-    }
-    const pending = inFlightResults.get(intentResult.fingerprint);
-    if (pending) {
-        return pending;
-    }
-    const sessionApi = getSessionApi(client);
-    if (!sessionApi || !intentResult.eligible) {
-        const result = noBriefingResult();
-        resultCache.set(intentResult.fingerprint, {
-            result,
-            timestamp: now,
-        });
-        return result;
-    }
-    const promise = (async () => {
-        try {
-            const result = await loadBriefingResult(sessionApi, workspaceCtx, intentResult);
-            resultCache.set(intentResult.fingerprint, {
-                result,
-                timestamp: Date.now(),
-            });
-            return result;
-        }
-        catch {
-            const result = noBriefingResult();
-            resultCache.set(intentResult.fingerprint, {
-                result,
-                timestamp: Date.now(),
-            });
-            return result;
-        }
-    })().finally(() => {
-        inFlightResults.delete(intentResult.fingerprint);
-    });
-    inFlightResults.set(intentResult.fingerprint, promise);
-    return promise;
-}

package/dist/graph-narrator.d.ts

@@ -1,25 +0,0 @@
-export interface GraphNarrativeResult {
-    headline: string;
-    tldr: string;
-    domains: Array<{
-        name: string;
-        changes: string[];
-    }>;
-    relationshipChanges: string[];
-    validationStatus: string;
-}
-export declare function generateGraphNarrative(client: unknown, workspaceCtx: {
-    workspaceRoot: string;
-    branch: string;
-}, changedEntityIds: string[], changedRelationships: Array<{
-    from: string;
-    to: string;
-    type: string;
-}>, checkResult: {
-    count: number;
-    violations: Array<{
-        rule: string;
-        entityId: string;
-        description: string;
-    }>;
-}): Promise<GraphNarrativeResult | null>;