kibi-plugin-builtin 0.2.0

package/dist/symbols/ts-morph-granularity.js

@@ -0,0 +1,98 @@
+/*
+ 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 { Project } from "ts-morph";
+import { chooseScriptKind, isPrivateClassMember } from "./ts-morph-shared.js";
+/**
+ * Collect exported (and unique bare method) symbol candidates used by
+ * coarse-vs-granular symbol validation.
+ */
+// implements REQ-capability-plugin-builtin-parity-v1
+export function collectGranularityCandidates(filePath, content) {
+    const source = new Project({
+        skipAddingFilesFromTsConfig: true,
+    }).createSourceFile(`${filePath}::granularity`, content, {
+        overwrite: true,
+        scriptKind: chooseScriptKind(filePath),
+    });
+    const found = [];
+    const methodCounts = new Map();
+    const bareMethods = new Map();
+    for (const fn of source.getFunctions()) {
+        const name = fn.getName();
+        if (fn.isExported() && name)
+            found.push({ name, kind: "function" });
+    }
+    for (const cls of source.getClasses()) {
+        if (!cls.isExported())
+            continue;
+        const className = cls.getName();
+        if (className)
+            found.push({ name: className, kind: "class" });
+        for (const method of cls.getMethods()) {
+            if (isPrivateClassMember(method))
+                continue;
+            const name = method.getName();
+            if (className)
+                found.push({ name: `${className}.${name}`, kind: "method" });
+            bareMethods.set(name, { name, kind: "method" });
+            methodCounts.set(name, (methodCounts.get(name) ?? 0) + 1);
+        }
+        for (const property of cls.getProperties()) {
+            if (isPrivateClassMember(property))
+                continue;
+            const name = property.getName();
+            if (className)
+                found.push({ name: `${className}.${name}`, kind: "property" });
+        }
+        for (const accessor of [
+            ...cls.getGetAccessors(),
+            ...cls.getSetAccessors(),
+        ]) {
+            if (isPrivateClassMember(accessor))
+                continue;
+            const name = accessor.getName();
+            if (className)
+                found.push({ name: `${className}.${name}`, kind: "accessor" });
+        }
+    }
+    for (const [name, count] of methodCounts) {
+        const method = bareMethods.get(name);
+        if (count === 1 && method)
+            found.push(method);
+    }
+    for (const item of source.getInterfaces()) {
+        if (item.isExported())
+            found.push({ name: item.getName(), kind: "interface" });
+    }
+    for (const item of source.getTypeAliases()) {
+        if (item.isExported())
+            found.push({ name: item.getName(), kind: "type" });
+    }
+    for (const item of source.getEnums()) {
+        if (item.isExported())
+            found.push({ name: item.getName(), kind: "enum" });
+    }
+    for (const statement of source.getVariableStatements()) {
+        if (!statement.isExported())
+            continue;
+        for (const declaration of statement.getDeclarations()) {
+            found.push({ name: declaration.getName(), kind: "variable" });
+        }
+    }
+    return found.sort((left, right) => left.name.localeCompare(right.name));
+}

package/dist/symbols/ts-morph-shared.d.ts

@@ -0,0 +1,15 @@
+import { Scope, ScriptKind, SyntaxKind } from "ts-morph";
+export declare const SUPPORTED_SOURCE_EXTENSIONS: Set<string>;
+export declare function chooseScriptKind(filePath: string): ScriptKind;
+export declare function formatMethodSymbolName(className: string | undefined, methodName: string): string;
+/**
+ * Duck-typed private-member check used by ts-morph AST walks and CLI tests.
+ * Accepts either `hasModifier(PrivateKeyword)` or `getScope() === "Private"`.
+ */
+export declare function isPrivateClassMember(member: {
+    getName?: () => string;
+    hasModifier?(kind: SyntaxKind): boolean;
+    getScope?: () => Scope | string | number;
+}): boolean;
+export declare function onlyCandidate<T>(candidates: readonly T[]): T | undefined;
+//# sourceMappingURL=ts-morph-shared.d.ts.map

package/dist/symbols/ts-morph-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-morph-shared.d.ts","sourceRoot":"","sources":["../../src/symbols/ts-morph-shared.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGzD,eAAO,MAAM,2BAA2B,aAStC,CAAC;AAGH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAY7D;AAGD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;GAGG;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IACvB,WAAW,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CAC1C,GAAG,OAAO,CAYV;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAGxE"}

package/dist/symbols/ts-morph-shared.js

@@ -0,0 +1,71 @@
+/*
+ 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 { Scope, ScriptKind, SyntaxKind } from "ts-morph";
+// implements REQ-capability-plugin-builtin-parity-v1
+export const SUPPORTED_SOURCE_EXTENSIONS = new Set([
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".mts",
+    ".cts",
+    ".mjs",
+    ".cjs",
+]);
+// implements REQ-capability-plugin-builtin-parity-v1
+export function chooseScriptKind(filePath) {
+    const lower = filePath.toLowerCase();
+    if (lower.endsWith(".tsx"))
+        return ScriptKind.TSX;
+    if (lower.endsWith(".ts") ||
+        lower.endsWith(".mts") ||
+        lower.endsWith(".cts")) {
+        return ScriptKind.TS;
+    }
+    if (lower.endsWith(".jsx"))
+        return ScriptKind.JSX;
+    return ScriptKind.JS;
+}
+// implements REQ-capability-plugin-builtin-parity-v1
+export function formatMethodSymbolName(className, methodName) {
+    return className ? `${className}.${methodName}` : methodName;
+}
+/**
+ * Duck-typed private-member check used by ts-morph AST walks and CLI tests.
+ * Accepts either `hasModifier(PrivateKeyword)` or `getScope() === "Private"`.
+ */
+// implements REQ-capability-plugin-builtin-parity-v1
+export function isPrivateClassMember(member) {
+    const name = typeof member.getName === "function" ? member.getName() : "";
+    if (name.startsWith("#")) {
+        return true;
+    }
+    if (typeof member.hasModifier === "function") {
+        return member.hasModifier(SyntaxKind.PrivateKeyword);
+    }
+    if (typeof member.getScope === "function") {
+        return member.getScope() === Scope.Private;
+    }
+    return false;
+}
+// implements REQ-capability-plugin-builtin-parity-v1
+export function onlyCandidate(candidates) {
+    if (candidates.length !== 1)
+        return undefined;
+    return candidates[0];
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "kibi-plugin-builtin",
+  "version": "0.2.0",
+  "description": "Default Kibi capability plugins: TS symbol extraction, ontology pack, and semantic classifier",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "CHANGELOG.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "bun test --timeout 15000 .",
+    "prepack": "npm run build && node ../../scripts/verify-package-contract.mjs kibi-plugin-builtin"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "AGPL-3.0-or-later",
+  "author": "Piotr Franczyk",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Looted/kibi.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "kibi-plugin-sdk": "^0.2.0",
+    "ts-morph": "^23.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "typescript": "^5.7.0"
+  }
+}