interface PackageJsonSummary {
    name: string;
    version?: string;
    scripts: Record<string, string>;
    dependencies: Record<string, string>;
    devDependencies: Record<string, string>;
}
interface TsConfigSummary {
    compilerOptions: Record<string, unknown> | null;
    paths: Record<string, string[]> | null;
}
interface WorkspaceMetadata {
    /** Absolute path to the workspace */
    path: string;
    /** Package name from package.json */
    name: string | null;
    /** Detected framework (Next.js, Express, React, etc.) */
    framework: string | null;
    /** Whether the workspace has tests */
    hasTests: boolean;
    /** Test command from scripts */
    testCommand: string | null;
    /** Lint command from scripts */
    lintCommand: string | null;
    /** Type check command from scripts */
    typecheckCommand: string | null;
    /** Build command from scripts */
    buildCommand: string | null;
    /** Parsed package.json summary (null if not found) */
    packageJson: PackageJsonSummary | null;
    /** Parsed tsconfig.json summary (null if not found) */
    tsConfig: TsConfigSummary | null;
    /** First 50 lines of README.md (null if not found) */
    readme: string | null;
    /** Contents of .env.example (null if not found) */
    envExample: string | null;
    /** Key dependencies relevant to the workspace */
    keyDependencies: Record<string, string>;
}
/**
 * Get workspace metadata for a given directory path.
 *
 * @param args.workspacePath - Path to the workspace (absolute or relative to projectRoot)
 * @param args.projectRoot - Optional project root for resolving relative paths
 * @returns Structured workspace metadata
 */
export declare function getWorkspaceFiles(args: Record<string, unknown>): Promise<WorkspaceMetadata>;
export {};
//# sourceMappingURL=workspace-files.d.ts.map