plumb-tools 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shashank Gupta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# plumb-tools
+
+LLM-free TypeScript architecture and boundary analysis toolset. Provides the static-analysis engine behind [`plumb-mcp-server`](https://www.npmjs.com/package/plumb-mcp-server) and the [Plumb](https://plumb.sgupta.dev) case study.
+
+No API key required. No inference. Returns grounded structural facts that an agent or a human can reason over.
+
+---
+
+## What it does
+
+Three exported `AnalysisTool` implementations, each wrapping a well-known OSS static-analysis tool:
+
+| Export | Underlying tool | What it returns |
+|---|---|---|
+| `dependencyGraphTool` | dependency-cruiser | Flat edge list: every import in the repo with `from`, `to`, `importPath`, `line`, `external`, `dynamic` |
+| `publicSurfaceTool` | ts-morph | Per-package public API surface: the set of modules reachable from each `src/index.ts` entrypoint |
+| `detectCyclesTool` | madge | Circular dependency rings as lists of repo-relative file paths |
+
+These three tools are composed by the agent layer (in `plumb-mcp-server` and the Plumb arch-reviewer agent) to classify dependency edges and surface architectural boundary violations.
+
+---
+
+## Installation
+
+```sh
+pnpm add plumb-tools
+# or
+npm install plumb-tools
+```
+
+Requires Node.js 18+.
+
+---
+
+## Library usage
+
+```ts
+import {
+  analyzeDependencies,
+  analyzePublicSurface,
+  detectCycles,
+} from 'plumb-tools';
+
+const repoPath = '/absolute/path/to/your/repo';
+
+const graph = await analyzeDependencies({ repoPath });
+// graph.edges: DependencyEdge[]
+
+const surface = await analyzePublicSurface({ repoPath });
+// surface.packages: PackageSurface[]
+
+const cycles = await detectCycles({ repoPath });
+// cycles.cycles: DependencyCycle[]
+```
+
+You can also invoke the pre-wired `AnalysisTool` objects directly (these are what `plumb-mcp-server` registers as MCP tools):
+
+```ts
+import { dependencyGraphTool, publicSurfaceTool, detectCyclesTool } from 'plumb-tools';
+
+const result = await dependencyGraphTool.execute({ repoPath });
+```
+
+---
+
+## Exported types
+
+```ts
+// dependency graph
+type DependencyEdge = { from: string; to: string | null; importPath: string; line: number | null; external: boolean; dynamic: boolean };
+type DependencyGraphFacts = { repoPath: string; modules: string[]; edges: DependencyEdge[]; generatedWith: { tool: 'dependency-cruiser'; version: string } };
+
+// public surface
+type PackageSurface = { packageRoot: string; entrypoint: string | null; publicModules: string[] };
+type PublicSurfaceFacts = { repoPath: string; packages: PackageSurface[]; generatedWith: string };
+type ImportSurfaceClass = 'via-entrypoint' | 'bypasses-entrypoint' | 'intra-package' | 'not-a-package-import';
+
+// cycles
+type DependencyCycle = { members: string[] };
+type CycleFacts = { repoPath: string; cycles: DependencyCycle[]; generatedWith: string };
+```
+
+---
+
+## Known limitations
+
+- The `doNotFollow` field on `dependencyGraphTool`'s input schema is accepted but not forwarded to dependency-cruiser at runtime. It is a documented stub.
+- No timeout or file-count limit is imposed on analysis. Point it at a developer-sized repository; avoid enormous monorepos or pathologically deep trees.
+- `analyzePublicSurface` only recognises packages that have a `src/index.ts` entrypoint. Packages without one get `entrypoint: null` and `publicModules: []`.
+
+---
+
+## License
+
+MIT — see `LICENSE`.

package/dist/analyze-dependencies.d.ts

@@ -0,0 +1,23 @@
+export interface DependencyEdge {
+    from: string;
+    to: string | null;
+    importPath: string;
+    line: number | null;
+    external: boolean;
+    dynamic: boolean;
+}
+export interface DependencyGraphFacts {
+    repoPath: string;
+    modules: string[];
+    edges: DependencyEdge[];
+    generatedWith: {
+        tool: 'dependency-cruiser';
+        version: string;
+    };
+}
+export interface AnalyzeOptions {
+    doNotFollow?: string;
+}
+export declare function findImportLine(absSourcePath: string, importPath: string): number | null;
+export declare function analyzeDependencies(repoPath: string, options?: AnalyzeOptions): Promise<DependencyGraphFacts>;
+//# sourceMappingURL=analyze-dependencies.d.ts.map

package/dist/analyze-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-dependencies.d.ts","sourceRoot":"","sources":["../src/analyze-dependencies.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAInB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmCvF;AAoCD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA+C/B"}

package/dist/analyze-dependencies.js

@@ -0,0 +1,127 @@
+import { cruise } from 'dependency-cruiser';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// dependency-cruiser does not emit per-import line numbers. Scan the source
+// for the specifier as an import/export/require/dynamic-import token — first
+// matching line wins.
+//
+// WHY anchored to import syntax: a bare quoted-string search would match any
+// comment or string literal that mentions the path. Anchoring to the actual
+// import/export/require call sites means only real module references are cited.
+//
+// Returns null when the specifier cannot be found, or when the file cannot be
+// read — so callers see an honest "unknown" rather than a misleading line 1.
+export function findImportLine(absSourcePath, importPath) {
+    let lines;
+    try {
+        lines = readFileSync(absSourcePath, 'utf-8').split('\n');
+    }
+    catch {
+        return null;
+    }
+    const escaped = importPath.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Matches:
+    //   import ... from 'path'       (static import)
+    //   export ... from 'path'       (re-export)
+    //   require('path')              (CommonJS)
+    //   import('path')               (dynamic import)
+    // Both single and double quotes are accepted.
+    //
+    // Comment-aware: a line whose non-whitespace content begins with '//' or
+    // '*' (line comment or block-comment continuation) is skipped even if it
+    // contains a syntactically valid import expression.  This prevents a
+    // commented-out import like `// import 'x'` from being mis-cited.
+    const re = new RegExp(`(?:^|\\b)(?:import|export|require)\\b[^'"]*['"]${escaped}['"]` +
+        `|(?:^|\\b)import\\s*\\(['"]${escaped}['"]\\)`);
+    const idx = lines.findIndex((l) => {
+        const trimmed = l.trimStart();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*'))
+            return false;
+        return re.test(l);
+    });
+    if (idx < 0) {
+        console.warn(`[tools] findImportLine: could not locate import of '${importPath}' in ${absSourcePath}`);
+        return null;
+    }
+    return idx + 1;
+}
+function isExternal(dep) {
+    return (dep.coreModule ||
+        dep.couldNotResolve ||
+        (!dep.dependencyTypes.includes('local') &&
+            !dep.dependencyTypes.includes('localmodule')));
+}
+function readDcVersion() {
+    try {
+        let dir = dirname(fileURLToPath(import.meta.resolve('dependency-cruiser')));
+        for (;;) {
+            try {
+                const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf-8'));
+                if (pkg.name === 'dependency-cruiser' && pkg.version != null) {
+                    return pkg.version;
+                }
+            }
+            catch {
+                // not a package root — keep walking up
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // ignore — return fallback below
+    }
+    return 'unknown';
+}
+export async function analyzeDependencies(repoPath, options) {
+    // Phase 1: doNotFollow reserved; dependency-cruiser config is hardcoded for now.
+    void options;
+    const raw = await cruise(['.'], {
+        baseDir: repoPath,
+        // Follow everything except node_modules; they still appear as edges (external: true).
+        doNotFollow: { path: 'node_modules' },
+    });
+    const result = raw.output;
+    const edgeList = [];
+    const seen = new Set();
+    for (const mod of result.modules) {
+        if (mod.source.includes('node_modules'))
+            continue;
+        seen.add(mod.source);
+        for (const dep of mod.dependencies) {
+            const ext = isExternal(dep);
+            edgeList.push({
+                from: mod.source,
+                to: ext ? null : dep.resolved,
+                importPath: dep.module,
+                line: findImportLine(join(repoPath, mod.source), dep.module),
+                external: ext,
+                dynamic: dep.dynamic,
+            });
+        }
+    }
+    // Deterministic order: primary key = from-file, secondary = line number
+    // (nulls sort last within a file).
+    edgeList.sort((a, b) => {
+        const c = a.from.localeCompare(b.from);
+        if (c !== 0)
+            return c;
+        if (a.line === null && b.line === null)
+            return 0;
+        if (a.line === null)
+            return 1;
+        if (b.line === null)
+            return -1;
+        return a.line - b.line;
+    });
+    return {
+        repoPath,
+        modules: [...seen].sort(),
+        edges: edgeList,
+        generatedWith: { tool: 'dependency-cruiser', version: readDcVersion() },
+    };
+}
+//# sourceMappingURL=analyze-dependencies.js.map

package/dist/analyze-dependencies.js.map

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

package/dist/analyze-public-surface.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { AnalysisTool } from './tool.js';
+export interface PackageSurface {
+    packageRoot: string;
+    entrypoint: string | null;
+    publicModules: string[];
+}
+export interface PublicSurfaceFacts {
+    repoPath: string;
+    packages: PackageSurface[];
+    generatedWith: string;
+}
+export type ImportSurfaceClass = 'via-entrypoint' | 'bypasses-entrypoint' | 'intra-package' | 'not-a-package-import' | 'unknown';
+export declare function analyzePublicSurface(repoPath: string): Promise<PublicSurfaceFacts>;
+export declare function classifyImport(facts: PublicSurfaceFacts, fromFile: string, resolvedTarget: string | null): ImportSurfaceClass;
+export declare const PublicSurfaceInputSchema: z.ZodObject<{
+    repoPath: z.ZodString;
+}, z.core.$strip>;
+export type PublicSurfaceInput = z.infer<typeof PublicSurfaceInputSchema>;
+export declare const publicSurfaceTool: AnalysisTool<PublicSurfaceInput, PublicSurfaceFacts>;
+//# sourceMappingURL=analyze-public-surface.d.ts.map

package/dist/analyze-public-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-public-surface.d.ts","sourceRoot":"","sources":["../src/analyze-public-surface.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,qBAAqB,GACrB,eAAe,GACf,sBAAsB,GACtB,SAAS,CAAC;AAmFd,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAwD7B;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,kBAAkB,CA6BpB;AAED,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,kBAAkB,EAAE,kBAAkB,CAQlF,CAAC"}

package/dist/analyze-public-surface.js

@@ -0,0 +1,157 @@
+import { Project } from 'ts-morph';
+import { readFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { globSync } from 'node:fs';
+function readTsMorphVersion() {
+    try {
+        let dir = dirname(fileURLToPath(import.meta.resolve('ts-morph')));
+        for (;;) {
+            try {
+                const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf-8'));
+                if (pkg.name === 'ts-morph' && pkg.version != null) {
+                    return pkg.version;
+                }
+            }
+            catch {
+                // not a package root — keep walking up
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'unknown';
+}
+// Collect all repo-relative module paths reachable via re-export chains from entrypoint.
+// Only follows `export * from '...'` and `export { ... } from '...'` declarations.
+function collectPublicModules(project, entrypointAbsPath, repoPath) {
+    const visited = new Set();
+    const queue = [entrypointAbsPath];
+    while (queue.length > 0) {
+        const absPath = queue.shift();
+        if (absPath === undefined || visited.has(absPath))
+            continue;
+        visited.add(absPath);
+        const sf = project.getSourceFile(absPath);
+        if (sf === undefined) {
+            console.warn(`[tools] analyzePublicSurface: source file not found in project: ${absPath}`);
+            continue;
+        }
+        for (const exportDecl of sf.getExportDeclarations()) {
+            const moduleSpecifier = exportDecl.getModuleSpecifierValue();
+            if (moduleSpecifier === undefined)
+                continue;
+            const resolved = exportDecl.getModuleSpecifierSourceFile();
+            if (resolved === undefined) {
+                console.warn(`[tools] analyzePublicSurface: could not resolve re-export '${moduleSpecifier}' in ${absPath}`);
+                continue;
+            }
+            const resolvedPath = resolved.getFilePath();
+            if (!visited.has(resolvedPath)) {
+                queue.push(resolvedPath);
+            }
+        }
+    }
+    const result = [];
+    for (const absPath of visited) {
+        if (absPath.startsWith(repoPath + '/')) {
+            result.push(absPath.slice(repoPath.length + 1));
+        }
+    }
+    result.sort();
+    return result;
+}
+// Defensive: use basename so the predicate works whether Node passes a bare
+// segment ("node_modules") or a path-joined form — behaviour is identical on
+// current Node (bare segments), but this avoids a silent gap if that changes.
+const excludeNodeModules = (name) => basename(String(name)) === 'node_modules';
+export async function analyzePublicSurface(repoPath) {
+    // Discover all src/index.ts files to identify packages.
+    const entrypointPaths = globSync('**/src/index.ts', {
+        cwd: repoPath,
+        exclude: excludeNodeModules,
+    });
+    // Build one ts-morph project over the repo so cross-file resolution works.
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: {
+            allowJs: false,
+            resolveJsonModule: false,
+        },
+    });
+    // Add all discovered entrypoints and their transitive local dependencies.
+    for (const rel of entrypointPaths) {
+        project.addSourceFileAtPath(join(repoPath, rel));
+    }
+    // Also add every .ts file under those package roots so resolution succeeds.
+    const tsFiles = globSync('**/src/**/*.ts', {
+        cwd: repoPath,
+        exclude: excludeNodeModules,
+    });
+    for (const rel of tsFiles) {
+        const absPath = join(repoPath, rel);
+        if (project.getSourceFile(absPath) === undefined) {
+            project.addSourceFileAtPath(absPath);
+        }
+    }
+    const tsMorphVersion = readTsMorphVersion();
+    const packages = [];
+    for (const entrypointRel of entrypointPaths.sort()) {
+        // packageRoot is the directory above src/index.ts, repo-relative POSIX.
+        // entrypointRel looks like "shared/src/index.ts" → packageRoot = "shared"
+        const packageRoot = entrypointRel.replace(/\/src\/index\.ts$/, '');
+        const entrypointAbsPath = join(repoPath, entrypointRel);
+        const publicModules = collectPublicModules(project, entrypointAbsPath, repoPath);
+        packages.push({
+            packageRoot,
+            entrypoint: entrypointRel,
+            publicModules,
+        });
+    }
+    return {
+        repoPath,
+        packages,
+        generatedWith: `ts-morph@${tsMorphVersion}`,
+    };
+}
+export function classifyImport(facts, fromFile, resolvedTarget) {
+    if (resolvedTarget === null)
+        return 'unknown';
+    // Find the package P whose packageRoot contains resolvedTarget.
+    // Use the longest matching packageRoot to handle nested packages correctly
+    // (e.g. "remotes/analytics" must win over a hypothetical "remotes" package).
+    const targetPackage = facts.packages
+        .filter((p) => resolvedTarget === p.entrypoint ||
+        resolvedTarget.startsWith(p.packageRoot + '/'))
+        .reduce((best, p) => best === undefined || p.packageRoot.length > best.packageRoot.length
+        ? p
+        : best, undefined);
+    if (targetPackage === undefined)
+        return 'not-a-package-import';
+    // fromFile is inside P if it starts with packageRoot + '/'.
+    const fromIsInside = fromFile.startsWith(targetPackage.packageRoot + '/');
+    if (fromIsInside)
+        return 'intra-package';
+    // fromFile is outside P.
+    if (resolvedTarget === targetPackage.entrypoint)
+        return 'via-entrypoint';
+    return 'bypasses-entrypoint';
+}
+export const PublicSurfaceInputSchema = z.object({
+    repoPath: z.string(),
+});
+export const publicSurfaceTool = {
+    name: 'public-surface',
+    description: 'Analyses a repository to discover packages (directories containing src/index.ts) and their public module surface using ts-morph. Returns structural facts only — no findings, no LLM calls.',
+    inputSchema: PublicSurfaceInputSchema,
+    run(input) {
+        return analyzePublicSurface(input.repoPath);
+    },
+};
+//# sourceMappingURL=analyze-public-surface.js.map

package/dist/analyze-public-surface.js.map

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

package/dist/detect-cycles.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { AnalysisTool } from './tool.js';
+export interface DependencyCycle {
+    members: string[];
+}
+export interface CycleFacts {
+    repoPath: string;
+    cycles: DependencyCycle[];
+    generatedWith: string;
+}
+export declare function detectCycles(repoPath: string): Promise<CycleFacts>;
+export declare const DetectCyclesInputSchema: z.ZodObject<{
+    repoPath: z.ZodString;
+}, z.core.$strip>;
+export type DetectCyclesInput = z.infer<typeof DetectCyclesInputSchema>;
+export declare const detectCyclesTool: AnalysisTool<DetectCyclesInput, CycleFacts>;
+//# sourceMappingURL=detect-cycles.d.ts.map

package/dist/detect-cycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-cycles.d.ts","sourceRoot":"","sources":["../src/detect-cycles.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AA2BD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBxE;AAED,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,iBAAiB,EAAE,UAAU,CAQxE,CAAC"}

package/dist/detect-cycles.js

@@ -0,0 +1,63 @@
+import madge from 'madge';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+function readMadgeVersion() {
+    try {
+        let dir = dirname(fileURLToPath(import.meta.resolve('madge')));
+        for (;;) {
+            try {
+                const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf-8'));
+                if (pkg.name === 'madge' && pkg.version != null) {
+                    return pkg.version;
+                }
+            }
+            catch {
+                // not a package root — keep walking up
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'unknown';
+}
+export async function detectCycles(repoPath) {
+    let result;
+    try {
+        result = await madge(repoPath, {
+            fileExtensions: ['ts', 'tsx'],
+            detectiveOptions: {
+                ts: { skipTypeImports: true },
+            },
+        });
+    }
+    catch (err) {
+        console.warn('[tools] detectCycles: madge failed', err);
+        return { repoPath, cycles: [], generatedWith: `madge@${readMadgeVersion()}` };
+    }
+    const rawCycles = result.circular();
+    const cycles = rawCycles.map((members) => ({ members }));
+    return {
+        repoPath,
+        cycles,
+        generatedWith: `madge@${readMadgeVersion()}`,
+    };
+}
+export const DetectCyclesInputSchema = z.object({
+    repoPath: z.string(),
+});
+export const detectCyclesTool = {
+    name: 'detect-cycles',
+    description: 'Detects circular dependencies in a TypeScript repository using madge. Returns module-level cycles as lists of repo-relative file paths. Produces structural facts only — no findings, no LLM calls.',
+    inputSchema: DetectCyclesInputSchema,
+    run(input) {
+        return detectCycles(input.repoPath);
+    },
+};
+//# sourceMappingURL=detect-cycles.js.map

package/dist/detect-cycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-cycles.js","sourceRoot":"","sources":["../src/detect-cycles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/D,SAAS,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAGtE,CAAC;gBACF,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;oBAChD,OAAO,GAAG,CAAC,OAAO,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;YACzC,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM;YAC1B,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,MAA2B,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAC7B,cAAc,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;YAC7B,gBAAgB,EAAE;gBAChB,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;aAC9B;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,SAAS,gBAAgB,EAAE,EAAE,EAAE,CAAC;IAChF,CAAC;IAED,MAAM,SAAS,GAAe,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChD,MAAM,MAAM,GAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAE5E,OAAO;QACL,QAAQ;QACR,MAAM;QACN,aAAa,EAAE,SAAS,gBAAgB,EAAE,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,qMAAqM;IACvM,WAAW,EAAE,uBAAuB;IACpC,GAAG,CAAC,KAAwB;QAC1B,OAAO,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Typed wrappers around static-analysis tools live here (later phases).
+ * This package never depends on an LLM provider.
+ */
+export declare const version = "0.1.0";
+export type { AnalyzeOptions, DependencyEdge, DependencyGraphFacts, } from './analyze-dependencies.js';
+export { analyzeDependencies, findImportLine } from './analyze-dependencies.js';
+export type { AnalysisTool, DependencyGraphInput } from './tool.js';
+export { dependencyGraphTool, DependencyGraphInputSchema } from './tool.js';
+export type { PackageSurface, PublicSurfaceFacts, ImportSurfaceClass, PublicSurfaceInput, } from './analyze-public-surface.js';
+export { analyzePublicSurface, classifyImport, publicSurfaceTool, PublicSurfaceInputSchema, } from './analyze-public-surface.js';
+export type { DependencyCycle, CycleFacts, DetectCyclesInput, } from './detect-cycles.js';
+export { detectCycles, detectCyclesTool, DetectCyclesInputSchema, } from './detect-cycles.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,YAAY,EACV,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAE5E,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Typed wrappers around static-analysis tools live here (later phases).
+ * This package never depends on an LLM provider.
+ */
+export const version = '0.1.0';
+export { analyzeDependencies, findImportLine } from './analyze-dependencies.js';
+export { dependencyGraphTool, DependencyGraphInputSchema } from './tool.js';
+export { analyzePublicSurface, classifyImport, publicSurfaceTool, PublicSurfaceInputSchema, } from './analyze-public-surface.js';
+export { detectCycles, detectCyclesTool, DetectCyclesInputSchema, } from './detect-cycles.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAO/B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhF,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAQ5E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { DependencyGraphFacts } from './analyze-dependencies.js';
+export interface AnalysisTool<TInput, TOutput> {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType<TInput>;
+    run(input: TInput): Promise<TOutput>;
+}
+export declare const DependencyGraphInputSchema: z.ZodObject<{
+    repoPath: z.ZodString;
+    doNotFollow: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DependencyGraphInput = z.infer<typeof DependencyGraphInputSchema>;
+export declare const dependencyGraphTool: AnalysisTool<DependencyGraphInput, DependencyGraphFacts>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,MAAM,WAAW,YAAY,CAAC,MAAM,EAAE,OAAO;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,oBAAoB,EAAE,oBAAoB,CASxF,CAAC"}

package/dist/tool.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { analyzeDependencies } from './analyze-dependencies.js';
+export const DependencyGraphInputSchema = z.object({
+    repoPath: z.string(),
+    doNotFollow: z.string().optional(),
+});
+export const dependencyGraphTool = {
+    name: 'dependency-graph',
+    description: 'Analyses module dependencies in a repository using dependency-cruiser and returns raw edges (from, to, importPath, line, external, dynamic). Produces facts only — no findings.',
+    inputSchema: DependencyGraphInputSchema,
+    run(input) {
+        const opts = input.doNotFollow !== undefined ? { doNotFollow: input.doNotFollow } : undefined;
+        return analyzeDependencies(input.repoPath, opts);
+    },
+};
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAYhE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAA6D;IAC3F,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,iLAAiL;IACnL,WAAW,EAAE,0BAA0B;IACvC,GAAG,CAAC,KAA2B;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9F,OAAO,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "plumb-tools",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "description": "LLM-free TypeScript architecture and boundary analysis toolset: dependency-cruiser dependency graph, ts-morph public-surface mapping, and madge cycle detection",
+  "author": "Shashank Gupta",
+  "license": "MIT",
+  "keywords": [
+    "architecture",
+    "dependency-analysis",
+    "typescript",
+    "monorepo",
+    "boundaries",
+    "dependency-cruiser",
+    "madge",
+    "ts-morph",
+    "static-analysis"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "dependency-cruiser": "^17.4.3",
+    "madge": "^8.0.0",
+    "ts-morph": "^28.0.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/madge": "^5.0.3"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json"
+  }
+}