@thoughtflow/codebase 0.2.0

package/dist/tools/workspace/codebase-research.tool.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodebaseResearchTool = void 0;
+const zod_1 = require("zod");
+const core_1 = require("@thoughtflow/core");
+const codebase_index_class_1 = require("../../libs/codebase-index.class");
+const ACTIONS = ["search", "dependencies", "duplicates", "stats"];
+class CodebaseResearchTool extends core_1.ToolBase {
+    rootDir;
+    name = "codebaseResearch";
+    readonly = true;
+    description = "Task-flow helper over CodebaseIndex and dependency analysis. " +
+        "search: code/path/symbol search. dependencies: build import graph for provided files. " +
+        "duplicates: check whether proposed symbols already exist. stats: index metadata.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            action: zod_1.z.enum(ACTIONS),
+            query: zod_1.z.string().optional(),
+            mode: zod_1.z.enum(["hybrid", "content", "path", "symbol"]).optional(),
+            files: zod_1.z.array(zod_1.z.string()).optional(),
+            symbols: zod_1.z.array(zod_1.z.string()).optional(),
+            limit: zod_1.z.number().int().min(1).max(200).optional(),
+            reindex: zod_1.z.boolean().optional(),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const action = input["action"];
+        const index = await codebase_index_class_1.CodebaseIndex.forRoot(this.rootDir);
+        if (!index.isIndexed() || input["reindex"] === true) {
+            index.rebuild();
+        }
+        if (action === "stats") {
+            return {
+                success: true,
+                output: JSON.stringify(index.getStats()),
+            };
+        }
+        if (action === "search") {
+            const query = String(input["query"] ?? "").trim();
+            const mode = input["mode"] ?? "hybrid";
+            const limit = Number(input["limit"] ?? 20);
+            const hits = index.search({
+                query: query || undefined,
+                mode,
+                limit,
+                offset: 0,
+            });
+            return {
+                success: true,
+                output: JSON.stringify({ count: hits.length, hits }),
+            };
+        }
+        if (action === "dependencies") {
+            const files = input["files"] ?? [];
+            if (files.length === 0) {
+                return { success: false, error: "dependencies action requires non-empty 'files'" };
+            }
+            const analyzer = new core_1.DependencyAnalyzer();
+            const report = analyzer.analyzeFromFiles(this.rootDir, files);
+            return {
+                success: true,
+                output: JSON.stringify(report),
+            };
+        }
+        const symbols = input["symbols"] ?? [];
+        if (symbols.length === 0) {
+            return { success: false, error: "duplicates action requires non-empty 'symbols'" };
+        }
+        const duplicates = {};
+        for (const symbol of symbols) {
+            const hits = index.search({
+                query: symbol,
+                mode: "symbol",
+                limit: 50,
+                offset: 0,
+            });
+            if (hits.length > 0) {
+                duplicates[symbol] = hits;
+            }
+        }
+        return {
+            success: true,
+            output: JSON.stringify({ duplicateCount: Object.keys(duplicates).length, duplicates }),
+        };
+    }
+}
+exports.CodebaseResearchTool = CodebaseResearchTool;
+//# sourceMappingURL=codebase-research.tool.js.map

package/dist/tools/workspace/codebase-research.tool.js.map

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

package/dist/tools/workspace/project-scanner.tool.d.ts

@@ -0,0 +1,55 @@
+import { ToolBase, ToolContext, ToolExecutionResult } from "@thoughtflow/core";
+export type TechCategory = "language" | "framework" | "database" | "infra" | "testing" | "build";
+export interface TechRule {
+    id: string;
+    name: string;
+    category: TechCategory;
+    /** Files whose existence signals this tech (relative to scanned dir). */
+    fileMarkers: string[];
+    /** Directories whose existence signals this tech. */
+    dirMarkers: string[];
+    /** package.json / composer.json dependency names that signal this tech. */
+    packageDeps?: string[];
+    /** Directories to skip when this tech is detected. */
+    ignoreDirs: string[];
+    /** Important files worth reading (only shown when they exist). */
+    keyFiles: string[];
+    /** Glob patterns for find_files exploration. */
+    explorePatterns: string[];
+    /** Short actionable hints for the LLM. */
+    hints: string[];
+}
+export interface MonorepoRule {
+    id: string;
+    name: string;
+    /** Files in root that indicate this monorepo tool. */
+    fileMarkers: string[];
+    /** Conventional sub-dirs that contain sub-projects (e.g. apps, libs). */
+    workspaceDirs: string[];
+    ignoreDirs: string[];
+    hints: string[];
+}
+export declare const TECH_RULES: TechRule[];
+export declare const MONOREPO_RULES: MonorepoRule[];
+export declare class ProjectScannerTool extends ToolBase {
+    private readonly rootDir;
+    readonly name = "projectScanner";
+    readonly readonly = true;
+    readonly description: string;
+    constructor(rootDir: string);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+    private scan;
+    private scanWorkspaceDir;
+    /**
+     * Fallback: scan top-level dirs that have their own config file
+     * (looks like independent projects grouped in a directory).
+     */
+    private detectPlainSubProjects;
+    private detectTechs;
+    private detectByExtension;
+    private readPackageJson;
+    private readDeps;
+    private format;
+    private formatSection;
+}
+//# sourceMappingURL=project-scanner.tool.d.ts.map

package/dist/tools/workspace/project-scanner.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scanner.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/project-scanner.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAmB,MAAM,mBAAmB,CAAC;AAQhG,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,yEAAyE;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,yEAAyE;IACzE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAQD,eAAO,MAAM,UAAU,EAAE,QAAQ,EAqiBhC,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,YAAY,EA4CxC,CAAC;AA8BF,qBAAa,kBAAmB,SAAQ,QAAQ;IAWlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,SAM4B;gBAEnB,OAAO,EAAE,MAAM;IAatC,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,OAAO,CAAC,IAAI;IAiDZ,OAAO,CAAC,gBAAgB;IA2BxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA0C9B,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,QAAQ;IAsChB,OAAO,CAAC,MAAM;IAmDd,OAAO,CAAC,aAAa;CAiDtB"}