@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/tools/inspect/schema.d.ts

@@ -0,0 +1,302 @@
+/**
+ * JSON Schema definition for the `inspect` tool.
+ *
+ * The inspect tool performs static analysis of a project or file and returns
+ * structured information about its structure, APIs, database schema, components,
+ * layout, accessibility, or a scaffold plan.
+ */
+export declare const INSPECT_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["project", "api", "api_spec", "api_validate", "api_sync", "database", "components", "layout", "accessibility", "scaffold", "component_state", "render_triggers", "hooks", "overflow", "sizing", "stacking", "responsive", "events", "tailwind", "client_boundary", "error_boundary"];
+            readonly description: string;
+        };
+        readonly projectRoot: {
+            readonly type: "string";
+            readonly description: "Root directory for the analysis. Defaults to the current working directory.";
+        };
+        readonly file: {
+            readonly type: "string";
+            readonly description: "Path to a specific file. Required for component, layout, and accessibility modes.";
+        };
+        readonly framework: {
+            readonly type: "string";
+            readonly enum: readonly ["auto", "nextjs", "express", "fastify", "hono"];
+            readonly description: "Web framework for api mode. auto detects from package.json. Default: auto.";
+        };
+        readonly schemaPath: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly moduleName: {
+            readonly type: "string";
+            readonly description: "Module name for scaffold mode. Used to name generated files.";
+        };
+        readonly dryRun: {
+            readonly type: "boolean";
+            readonly description: "scaffold mode: return file plan without writing. Default true.";
+        };
+        readonly output: {
+            readonly type: "object";
+            readonly description: "Output formatting options.";
+            readonly properties: {
+                readonly format: {
+                    readonly type: "string";
+                    readonly enum: readonly ["summary", "detailed", "json"];
+                    readonly description: "summary: condensed overview; detailed: full analysis; json: raw JSON. Default: detailed.";
+                };
+                readonly max_tokens: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "Hard token cap for the response.";
+                };
+            };
+        };
+    };
+    readonly required: readonly ["mode"];
+};
+export type InspectMode = 'project' | 'api' | 'api_spec' | 'api_validate' | 'api_sync' | 'database' | 'components' | 'layout' | 'accessibility' | 'scaffold' | 'component_state' | 'render_triggers' | 'hooks' | 'overflow' | 'sizing' | 'stacking' | 'responsive' | 'events' | 'tailwind' | 'client_boundary' | 'error_boundary';
+export type ApiFramework = 'auto' | 'nextjs' | 'express' | 'fastify' | 'hono';
+export type OutputFormat = 'summary' | 'detailed' | 'json';
+export interface InspectOutput {
+    format?: OutputFormat;
+    max_tokens?: number;
+}
+export interface InspectInput {
+    mode: InspectMode;
+    projectRoot?: string;
+    file?: string;
+    framework?: ApiFramework;
+    schemaPath?: string;
+    specPath?: string;
+    moduleName?: string;
+    dryRun?: boolean;
+    output?: InspectOutput;
+}
+export interface ProjectInfo {
+    type: 'nodejs' | 'rust' | 'python' | 'go' | 'make' | 'unknown';
+    name?: string;
+    version?: string;
+    packageManager: 'npm' | 'bun' | 'yarn' | 'pnpm' | 'none';
+    scripts: Record<string, string>;
+    dependencies: number;
+    devDependencies: number;
+    hasTypeScript: boolean;
+    testFramework?: string;
+    isMonorepo: boolean;
+    entryPoints: string[];
+}
+export interface ApiRoute {
+    method: string;
+    path: string;
+    file: string;
+    line: number;
+}
+export interface DbField {
+    name: string;
+    type: string;
+    isRelation: boolean;
+    isOptional: boolean;
+}
+export interface DbModel {
+    name: string;
+    fields: DbField[];
+}
+export interface DbEnum {
+    name: string;
+    values: string[];
+}
+export interface DatabaseInfo {
+    models: DbModel[];
+    enums: DbEnum[];
+}
+export interface ComponentInfo {
+    name: string;
+    kind: 'function' | 'arrow' | 'class';
+    line: number;
+    props: string[];
+    hooks: string[];
+    children: string[];
+}
+export interface LayoutInfo {
+    file: string;
+    displays: string[];
+    flex: string[];
+    grid: string[];
+    sizing: string[];
+    overflow: string[];
+}
+export interface A11yIssue {
+    line: number;
+    code: string;
+    message: string;
+    wcag: string;
+}
+export interface ScaffoldFile {
+    path: string;
+    content: string;
+}
+export interface ScaffoldPlan {
+    moduleName: string;
+    dryRun: boolean;
+    files: ScaffoldFile[];
+}
+export interface OpenApiParameter {
+    name: string;
+    in: 'path' | 'query';
+    required: boolean;
+    schema: {
+        type: string;
+    };
+}
+export interface OpenApiOperation {
+    operationId: string;
+    parameters?: OpenApiParameter[];
+    responses: Record<string, {
+        description: string;
+    }>;
+}
+export interface OpenApiPathItem {
+    [method: string]: OpenApiOperation;
+}
+export interface ApiSpec {
+    openapi: '3.0.0';
+    info: {
+        title: string;
+        version: string;
+    };
+    paths: Record<string, OpenApiPathItem>;
+}
+export interface ApiValidateResult {
+    valid: boolean;
+    missing_from_spec: string[];
+    missing_from_code: string[];
+    mismatched_methods: Array<{
+        path: string;
+        spec_methods: string[];
+        code_methods: string[];
+    }>;
+}
+export interface FetchCall {
+    url: string;
+    file: string;
+    line: number;
+}
+export interface ApiSyncResult {
+    fetch_calls: FetchCall[];
+    unmatched_fetches: FetchCall[];
+    unmatched_routes: ApiRoute[];
+    drift_detected: boolean;
+}
+export interface StateVar {
+    name: string;
+    kind: 'useState' | 'useReducer' | 'useContext';
+    line: number;
+}
+export interface ComponentStateInfo {
+    file: string;
+    stateVars: StateVar[];
+    count: number;
+}
+export interface RenderTrigger {
+    kind: 'state_setter' | 'effect_dep' | 'memo_dep' | 'callback_dep' | 'memo_boundary';
+    name: string;
+    line: number;
+}
+export interface RenderTriggersInfo {
+    file: string;
+    triggers: RenderTrigger[];
+    count: number;
+}
+export interface HookDep {
+    hookKind: 'useEffect' | 'useMemo' | 'useCallback';
+    line: number;
+    deps: string[];
+    missing: string[];
+}
+export interface HooksInfo {
+    file: string;
+    hooks: HookDep[];
+    missingDepsCount: number;
+}
+export interface OverflowIssue {
+    line: number;
+    kind: 'hidden_clip' | 'scroll_no_height';
+    snippet: string;
+}
+export interface OverflowInfo {
+    file: string;
+    issues: OverflowIssue[];
+    count: number;
+}
+export interface SizingItem {
+    line: number;
+    kind: 'fixed_px' | 'fixed_rem' | 'percentage' | 'flex' | 'grid' | 'viewport';
+    value: string;
+    flagged: boolean;
+}
+export interface SizingInfo {
+    file: string;
+    items: SizingItem[];
+    hardcodedCount: number;
+}
+export interface ZIndexItem {
+    line: number;
+    value: string;
+    context: string;
+}
+export interface StackingInfo {
+    file: string;
+    zIndexItems: ZIndexItem[];
+    potentialConflicts: Array<{
+        values: string[];
+        lines: number[];
+    }>;
+}
+export interface BreakpointUsage {
+    prefix: string;
+    count: number;
+    classes: string[];
+}
+export interface ResponsiveInfo {
+    file: string;
+    breakpoints: BreakpointUsage[];
+    hasMobileFirst: boolean;
+}
+export interface EventHandler {
+    line: number;
+    event: string;
+    hasPreventDefault: boolean;
+    hasStopPropagation: boolean;
+    isDelegated: boolean;
+}
+export interface EventsInfo {
+    file: string;
+    handlers: EventHandler[];
+    count: number;
+}
+export interface TailwindConflict {
+    line: number;
+    classes: string[];
+    reason: string;
+}
+export interface TailwindInfo {
+    file: string;
+    conflicts: TailwindConflict[];
+    count: number;
+}
+export interface ClientBoundaryInfo {
+    file: string;
+    directive: 'use client' | 'use server' | null;
+    importsServerOnly: boolean;
+    serverOnlyImports: string[];
+}
+export interface ErrorBoundaryInfo {
+    file: string;
+    hasErrorBoundary: boolean;
+    boundaryComponents: string[];
+    coveredRoutes: string[];
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/platform/tools/inspect/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/inspect/schema.ts"],"names":[],"mappings":"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"}

package/dist/platform/tools/inspect/schema.js

@@ -0,0 +1,72 @@
+/**
+ * JSON Schema definition for the `inspect` tool.
+ *
+ * The inspect tool performs static analysis of a project or file and returns
+ * structured information about its structure, APIs, database schema, components,
+ * layout, accessibility, or a scaffold plan.
+ */
+export const INSPECT_TOOL_SCHEMA = {
+    type: 'object',
+    properties: {
+        mode: {
+            type: 'string',
+            enum: ['project', 'api', 'api_spec', 'api_validate', 'api_sync', 'database', 'components', 'layout', 'accessibility', 'scaffold', 'component_state', 'render_triggers', 'hooks', 'overflow', 'sizing', 'stacking', 'responsive', 'events', 'tailwind', 'client_boundary', 'error_boundary'],
+            description: 'Analysis mode. project: detect project type and structure; api: scan route definitions;'
+                + ' api_spec: generate OpenAPI 3.0 spec from discovered routes;'
+                + ' api_validate: compare existing OpenAPI spec against discovered routes;'
+                + ' api_sync: detect frontend/backend type drift via fetch() call analysis;'
+                + ' database: parse schema models; components: extract React components;'
+                + ' layout: analyze CSS/Tailwind layout; accessibility: detect a11y issues;'
+                + ' scaffold: generate module skeleton;'
+                + ' component_state: trace useState/useReducer/useContext; render_triggers: find re-render causes;'
+                + ' hooks: analyze hook dependency arrays; overflow: find CSS overflow issues;'
+                + ' sizing: analyze sizing strategy; stacking: z-index and stacking context;'
+                + ' responsive: Tailwind breakpoint analysis; events: event handling analysis;'
+                + ' tailwind: detect class conflicts; client_boundary: Next.js directive analysis;'
+                + ' error_boundary: error boundary coverage.',
+        },
+        projectRoot: {
+            type: 'string',
+            description: 'Root directory for the analysis. Defaults to the current working directory.',
+        },
+        file: {
+            type: 'string',
+            description: 'Path to a specific file. Required for component, layout, and accessibility modes.',
+        },
+        framework: {
+            type: 'string',
+            enum: ['auto', 'nextjs', 'express', 'fastify', 'hono'],
+            description: 'Web framework for api mode. auto detects from package.json. Default: auto.',
+        },
+        schemaPath: {
+            type: 'string',
+            description: 'Path to database schema file (Prisma/Drizzle). For database mode. '
+                + 'Defaults to prisma/schema.prisma.',
+        },
+        moduleName: {
+            type: 'string',
+            description: 'Module name for scaffold mode. Used to name generated files.',
+        },
+        dryRun: {
+            type: 'boolean',
+            description: 'scaffold mode: return file plan without writing. Default true.',
+        },
+        output: {
+            type: 'object',
+            description: 'Output formatting options.',
+            properties: {
+                format: {
+                    type: 'string',
+                    enum: ['summary', 'detailed', 'json'],
+                    description: 'summary: condensed overview; detailed: full analysis; json: raw JSON. Default: detailed.',
+                },
+                max_tokens: {
+                    type: 'integer',
+                    minimum: 1,
+                    description: 'Hard token cap for the response.',
+                },
+            },
+        },
+    },
+    required: ['mode'],
+};

package/dist/platform/tools/inspect/shared.d.ts

@@ -0,0 +1,21 @@
+import type { InspectMode } from './schema.js';
+export declare const VALID_MODES: InspectMode[];
+export declare const JSON_OUTPUT_INDENT = 2;
+export type InspectToolResult = {
+    success: boolean;
+    output?: string;
+    error?: string;
+};
+export declare function resolvePath(projectRoot: string, inputPath: string): string;
+export declare function requireExistingFilePath(projectRoot: string, inputPath: string, notFoundPrefix: string): string;
+export declare function summarizeInspectValue(mode: InspectMode, value: unknown): unknown;
+export declare function serializeInspectOutput(value: unknown, format: string, mode: InspectMode): string;
+export declare function walk(dir: string, filter: (p: string) => boolean, skipDirs?: Set<string>, depth?: number): Promise<string[]>;
+export declare function safeRead(filePath: string): string;
+export declare function createInspectFailure(error: string): InspectToolResult;
+export declare function createInspectSuccess(output: unknown, format: string, mode: InspectMode): InspectToolResult;
+export declare function readRequiredFile(projectRoot: string, inputFile: string | undefined, mode: string, errorMessage: string): {
+    filePath: string;
+    content: string;
+} | InspectToolResult;
+//# sourceMappingURL=shared.d.ts.map

package/dist/platform/tools/inspect/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/inspect/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EAqBZ,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,WAAW,EAAE,WAAW,EAsBpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAGpC,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAM9G;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAsLhF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAGhG;AAED,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,EAC9B,QAAQ,GAAE,GAAG,CAAC,MAAM,CAA+E,EACnG,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAErE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAE1G;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAM3D"}

package/dist/platform/tools/inspect/shared.js

@@ -0,0 +1,273 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+import { readdir } from 'node:fs/promises';
+export const VALID_MODES = [
+    'project',
+    'api',
+    'api_spec',
+    'api_validate',
+    'api_sync',
+    'database',
+    'components',
+    'layout',
+    'accessibility',
+    'scaffold',
+    'component_state',
+    'render_triggers',
+    'hooks',
+    'overflow',
+    'sizing',
+    'stacking',
+    'responsive',
+    'events',
+    'tailwind',
+    'client_boundary',
+    'error_boundary',
+];
+export const JSON_OUTPUT_INDENT = 2;
+const SUMMARY_SAMPLE_LIMIT = 5;
+export function resolvePath(projectRoot, inputPath) {
+    const resolved = resolve(inputPath.startsWith('/') ? inputPath : join(projectRoot, inputPath));
+    const rel = relative(projectRoot, resolved);
+    if (rel.startsWith('..')) {
+        throw new Error(`Path '${inputPath}' resolves outside the project root`);
+    }
+    return resolved;
+}
+export function requireExistingFilePath(projectRoot, inputPath, notFoundPrefix) {
+    const filePath = resolvePath(projectRoot, inputPath);
+    if (!existsSync(filePath)) {
+        throw new Error(`${notFoundPrefix}: ${filePath}`);
+    }
+    return filePath;
+}
+function takeSample(items, limit = SUMMARY_SAMPLE_LIMIT) {
+    return Array.isArray(items) ? items.slice(0, limit) : [];
+}
+export function summarizeInspectValue(mode, value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return value;
+    const record = value;
+    switch (mode) {
+        case 'project':
+            return {
+                type: record.type ?? null,
+                name: record.name ?? null,
+                packageManager: record.packageManager ?? null,
+                hasTypeScript: record.hasTypeScript ?? false,
+                testFramework: record.testFramework ?? null,
+                dependencyCount: record.dependencies ?? 0,
+                devDependencyCount: record.devDependencies ?? 0,
+                entryPoints: takeSample(record.entryPoints),
+            };
+        case 'api':
+            return {
+                count: record.count ?? 0,
+                routes: takeSample(record.routes).map((route) => ({
+                    method: route.method ?? null,
+                    path: route.path ?? null,
+                    file: route.file ?? null,
+                })),
+            };
+        case 'database': {
+            const models = takeSample(record.models).map((model) => ({
+                name: model.name ?? null,
+                fieldCount: Array.isArray(model.fields) ? model.fields.length : 0,
+            }));
+            const enums = takeSample(record.enums).map((entry) => ({
+                name: entry.name ?? null,
+                valueCount: Array.isArray(entry.values) ? entry.values.length : 0,
+            }));
+            return {
+                modelCount: Array.isArray(record.models) ? record.models.length : 0,
+                enumCount: Array.isArray(record.enums) ? record.enums.length : 0,
+                models,
+                enums,
+            };
+        }
+        case 'components':
+            return {
+                count: record.count ?? 0,
+                components: takeSample(record.components).map((component) => ({
+                    name: component.name ?? null,
+                    kind: component.kind ?? null,
+                    propCount: Array.isArray(component.props) ? component.props.length : 0,
+                    hookCount: Array.isArray(component.hooks) ? component.hooks.length : 0,
+                })),
+            };
+        case 'layout':
+            return {
+                file: record.file ?? null,
+                displays: takeSample(record.displays),
+                flex: takeSample(record.flex),
+                grid: takeSample(record.grid),
+                sizing: takeSample(record.sizing),
+                overflow: takeSample(record.overflow),
+            };
+        case 'accessibility':
+            return {
+                count: record.count ?? 0,
+                issues: takeSample(record.issues).map((issue) => ({
+                    code: issue.code ?? null,
+                    line: issue.line ?? null,
+                    wcag: issue.wcag ?? null,
+                })),
+            };
+        case 'api_spec':
+            return {
+                openapi: record.openapi ?? null,
+                pathCount: record.paths && typeof record.paths === 'object' ? Object.keys(record.paths).length : 0,
+                paths: takeSample(Object.keys(record.paths ?? {})),
+            };
+        case 'api_validate':
+            return {
+                valid: record.valid ?? false,
+                missingFromSpec: takeSample(record.missing_from_spec),
+                missingFromCode: takeSample(record.missing_from_code),
+            };
+        case 'api_sync':
+            return {
+                driftDetected: record.drift_detected ?? false,
+                fetchCallCount: Array.isArray(record.fetch_calls) ? record.fetch_calls.length : 0,
+                unmatchedFetches: takeSample(record.unmatched_fetches).map((call) => ({
+                    url: call.url ?? null,
+                    file: call.file ?? null,
+                })),
+                unmatchedRoutes: takeSample(record.unmatched_routes),
+            };
+        case 'scaffold':
+            return {
+                moduleName: record.moduleName ?? null,
+                dryRun: record.dryRun ?? false,
+                fileCount: Array.isArray(record.files) ? record.files.length : 0,
+                files: takeSample(record.files).map((file) => file.path ?? null),
+            };
+        case 'component_state':
+            return {
+                count: record.count ?? 0,
+                stateVars: takeSample(record.stateVars).map((item) => ({
+                    kind: item.kind ?? null,
+                    name: item.name ?? null,
+                })),
+            };
+        case 'render_triggers':
+            return {
+                count: record.count ?? 0,
+                triggers: takeSample(record.triggers).map((trigger) => ({
+                    kind: trigger.kind ?? null,
+                    cause: trigger.cause ?? null,
+                })),
+            };
+        case 'hooks':
+            return {
+                count: Array.isArray(record.hooks) ? record.hooks.length : 0,
+                hooks: takeSample(record.hooks).map((hook) => ({
+                    hookKind: hook.hookKind ?? null,
+                    deps: takeSample(hook.deps),
+                })),
+            };
+        case 'overflow':
+            return {
+                count: record.count ?? 0,
+                issues: takeSample(record.issues).map((issue) => ({
+                    kind: issue.kind ?? null,
+                    line: issue.line ?? null,
+                })),
+            };
+        case 'sizing':
+            return {
+                count: Array.isArray(record.items) ? record.items.length : 0,
+                items: takeSample(record.items).map((item) => ({
+                    kind: item.kind ?? null,
+                    line: item.line ?? null,
+                })),
+            };
+        case 'stacking':
+            return {
+                count: Array.isArray(record.zIndexItems) ? record.zIndexItems.length : 0,
+                zIndexItems: takeSample(record.zIndexItems).map((item) => ({
+                    value: item.value ?? null,
+                    line: item.line ?? null,
+                })),
+            };
+        case 'responsive':
+            return {
+                hasMobileFirst: record.hasMobileFirst ?? false,
+                breakpointCount: Array.isArray(record.breakpoints) ? record.breakpoints.length : 0,
+                breakpoints: takeSample(record.breakpoints).map((bp) => bp.prefix ?? null),
+            };
+        case 'events':
+            return {
+                count: record.count ?? 0,
+                handlers: takeSample(record.handlers).map((handler) => ({
+                    event: handler.event ?? null,
+                    line: handler.line ?? null,
+                })),
+            };
+        case 'tailwind':
+            return {
+                count: record.count ?? 0,
+                conflicts: takeSample(record.conflicts).map((conflict) => ({
+                    reason: conflict.reason ?? null,
+                    classes: takeSample(conflict.classes),
+                })),
+            };
+        case 'client_boundary':
+            return {
+                directive: record.directive ?? null,
+                importsServerOnly: record.importsServerOnly ?? false,
+                serverOnlyImports: takeSample(record.serverOnlyImports),
+            };
+        case 'error_boundary':
+            return {
+                hasErrorBoundary: record.hasErrorBoundary ?? false,
+                boundaryComponents: takeSample(record.boundaryComponents),
+            };
+        default:
+            return value;
+    }
+}
+export function serializeInspectOutput(value, format, mode) {
+    const shaped = format === 'summary' ? summarizeInspectValue(mode, value) : value;
+    return JSON.stringify(shaped, null, format === 'json' ? JSON_OUTPUT_INDENT : 0);
+}
+export async function walk(dir, filter, skipDirs = new Set(['.git', 'node_modules', 'dist', '.next', '.cache', '__pycache__']), depth = 0) {
+    if (depth > 10)
+        return [];
+    const results = [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (!skipDirs.has(entry.name)) {
+                const sub = await walk(full, filter, skipDirs, depth + 1);
+                results.push(...sub);
+            }
+        }
+        else if (filter(full)) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+export function safeRead(filePath) {
+    try {
+        return readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+export function createInspectFailure(error) {
+    return { success: false, error };
+}
+export function createInspectSuccess(output, format, mode) {
+    return { success: true, output: serializeInspectOutput(output, format, mode) };
+}
+export function readRequiredFile(projectRoot, inputFile, mode, errorMessage) {
+    if (!inputFile) {
+        return createInspectFailure(`file is required for ${mode} mode`);
+    }
+    const filePath = requireExistingFilePath(projectRoot, inputFile, errorMessage);
+    return { filePath, content: safeRead(filePath) };
+}