workos 0.5.4 → 0.6.0

package/dist/lib/events.d.ts

@@ -122,6 +122,17 @@ export interface InstallerEvents {
         message: string;
         stack?: string;
     };
+    'agent:retry': {
+        attempt: number;
+        maxRetries: number;
+    };
+    'validation:retry:start': {
+        attempt: number;
+    };
+    'validation:retry:complete': {
+        attempt: number;
+        passed: boolean;
+    };
     'validation:start': {
         framework: string;
     };

package/dist/lib/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAuFtC,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,IAAI,CAA+B,KAAQ,EAAE,OAA2B;QACtE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAA+B,KAAQ,EAAE,QAA+C;QACxF,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAA+B,KAAQ,EAAE,QAA+C;QACzF,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAA+B,KAAQ,EAAE,QAA+C;QAC1F,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,qBAAqB,EAAE,CAAC;AACrC,CAAC","sourcesContent":["import { EventEmitter } from 'events';\n\nexport interface InstallerEvents {\n  status: { message: string };\n  output: { text: string; isError?: boolean };\n  'file:write': { path: string; content: string };\n  'file:edit': { path: string; oldContent: string; newContent: string };\n  'prompt:request': { id: string; message: string; options?: string[] };\n  'prompt:response': { id: string; value: string };\n  'confirm:request': { id: string; message: string; warning?: string; files?: string[] };\n  'confirm:response': { id: string; confirmed: boolean };\n  'credentials:request': { requiresApiKey: boolean };\n  'credentials:response': { apiKey: string; clientId: string };\n  complete: { success: boolean; summary?: string };\n  error: { message: string; stack?: string };\n\n  'state:enter': { state: string };\n  'state:exit': { state: string };\n  'auth:checking': Record<string, never>;\n  'auth:required': Record<string, never>;\n  'auth:success': Record<string, never>;\n  'auth:failure': { message: string };\n  'detection:start': Record<string, never>;\n  'detection:complete': { integration: string };\n  'detection:none': Record<string, never>;\n  'git:checking': Record<string, never>;\n  'git:clean': Record<string, never>;\n  'git:dirty': { files: string[] };\n  'git:dirty:confirmed': Record<string, never>;\n  'git:dirty:cancelled': Record<string, never>;\n  'credentials:gathering': { requiresApiKey: boolean };\n  'credentials:found': Record<string, never>;\n  // Credential discovery events\n  'credentials:env:detected': { files: string[] };\n  'credentials:env:prompt': { files: string[] };\n  'credentials:env:scanning': Record<string, never>;\n  'credentials:env:found': { sourcePath: string };\n  'credentials:env:notfound': Record<string, never>;\n  // Device auth events\n  'device:started': { verificationUri: string; verificationUriComplete: string; userCode: string };\n  'device:polling': Record<string, never>;\n  'device:success': { email?: string };\n  'device:timeout': Record<string, never>;\n  'device:error': { message: string };\n  // Staging API events\n  'staging:fetching': Record<string, never>;\n  'staging:success': Record<string, never>;\n  'staging:error': { message: string; statusCode?: number };\n  'config:start': Record<string, never>;\n  'config:complete': Record<string, never>;\n  'agent:start': Record<string, never>;\n  'agent:progress': { step: string; detail?: string };\n  'agent:success': { summary?: string };\n  'agent:failure': { message: string; stack?: string };\n\n  'validation:start': { framework: string };\n  'validation:issues': { issues: import('./validation/types.js').ValidationIssue[] };\n  'validation:complete': { passed: boolean; issueCount: number; durationMs: number };\n\n  // Branch check events\n  'branch:checking': Record<string, never>;\n  'branch:protected': { branch: string };\n  'branch:prompt': { branch: string };\n  'branch:created': { branch: string };\n  'branch:create:failed': { error: string };\n  'branch:skipped': Record<string, never>;\n\n  // Post-install events\n  'postinstall:changes': { files: string[] };\n  'postinstall:nochanges': Record<string, never>;\n  'postinstall:commit:prompt': Record<string, never>;\n  'postinstall:commit:generating': Record<string, never>;\n  'postinstall:commit:committing': { message: string };\n  'postinstall:commit:success': { message: string };\n  'postinstall:commit:failed': { error: string };\n  'postinstall:pr:prompt': Record<string, never>;\n  'postinstall:pr:generating': Record<string, never>;\n  'postinstall:pr:pushing': Record<string, never>;\n  'postinstall:pr:creating': Record<string, never>;\n  'postinstall:pr:success': { url: string };\n  'postinstall:pr:failed': { error: string };\n  'postinstall:push:failed': { error: string };\n  'postinstall:manual': { instructions: string };\n}\n\nexport type InstallerEventName = keyof InstallerEvents;\n\nexport class InstallerEventEmitter extends EventEmitter {\n  emit<K extends InstallerEventName>(event: K, payload: InstallerEvents[K]): boolean {\n    return super.emit(event, payload);\n  }\n\n  on<K extends InstallerEventName>(event: K, listener: (payload: InstallerEvents[K]) => void): this {\n    return super.on(event, listener);\n  }\n\n  off<K extends InstallerEventName>(event: K, listener: (payload: InstallerEvents[K]) => void): this {\n    return super.off(event, listener);\n  }\n\n  once<K extends InstallerEventName>(event: K, listener: (payload: InstallerEvents[K]) => void): this {\n    return super.once(event, listener);\n  }\n}\n\nexport function createInstallerEventEmitter(): InstallerEventEmitter {\n  return new InstallerEventEmitter();\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA2FtC,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,IAAI,CAA+B,KAAQ,EAAE,OAA2B;QACtE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAA+B,KAAQ,EAAE,QAA+C;QACxF,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAA+B,KAAQ,EAAE,QAA+C;QACzF,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAA+B,KAAQ,EAAE,QAA+C;QAC1F,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,qBAAqB,EAAE,CAAC;AACrC,CAAC","sourcesContent":["import { EventEmitter } from 'events';\n\nexport interface InstallerEvents {\n  status: { message: string };\n  output: { text: string; isError?: boolean };\n  'file:write': { path: string; content: string };\n  'file:edit': { path: string; oldContent: string; newContent: string };\n  'prompt:request': { id: string; message: string; options?: string[] };\n  'prompt:response': { id: string; value: string };\n  'confirm:request': { id: string; message: string; warning?: string; files?: string[] };\n  'confirm:response': { id: string; confirmed: boolean };\n  'credentials:request': { requiresApiKey: boolean };\n  'credentials:response': { apiKey: string; clientId: string };\n  complete: { success: boolean; summary?: string };\n  error: { message: string; stack?: string };\n\n  'state:enter': { state: string };\n  'state:exit': { state: string };\n  'auth:checking': Record<string, never>;\n  'auth:required': Record<string, never>;\n  'auth:success': Record<string, never>;\n  'auth:failure': { message: string };\n  'detection:start': Record<string, never>;\n  'detection:complete': { integration: string };\n  'detection:none': Record<string, never>;\n  'git:checking': Record<string, never>;\n  'git:clean': Record<string, never>;\n  'git:dirty': { files: string[] };\n  'git:dirty:confirmed': Record<string, never>;\n  'git:dirty:cancelled': Record<string, never>;\n  'credentials:gathering': { requiresApiKey: boolean };\n  'credentials:found': Record<string, never>;\n  // Credential discovery events\n  'credentials:env:detected': { files: string[] };\n  'credentials:env:prompt': { files: string[] };\n  'credentials:env:scanning': Record<string, never>;\n  'credentials:env:found': { sourcePath: string };\n  'credentials:env:notfound': Record<string, never>;\n  // Device auth events\n  'device:started': { verificationUri: string; verificationUriComplete: string; userCode: string };\n  'device:polling': Record<string, never>;\n  'device:success': { email?: string };\n  'device:timeout': Record<string, never>;\n  'device:error': { message: string };\n  // Staging API events\n  'staging:fetching': Record<string, never>;\n  'staging:success': Record<string, never>;\n  'staging:error': { message: string; statusCode?: number };\n  'config:start': Record<string, never>;\n  'config:complete': Record<string, never>;\n  'agent:start': Record<string, never>;\n  'agent:progress': { step: string; detail?: string };\n  'agent:success': { summary?: string };\n  'agent:failure': { message: string; stack?: string };\n  'agent:retry': { attempt: number; maxRetries: number };\n\n  'validation:retry:start': { attempt: number };\n  'validation:retry:complete': { attempt: number; passed: boolean };\n\n  'validation:start': { framework: string };\n  'validation:issues': { issues: import('./validation/types.js').ValidationIssue[] };\n  'validation:complete': { passed: boolean; issueCount: number; durationMs: number };\n\n  // Branch check events\n  'branch:checking': Record<string, never>;\n  'branch:protected': { branch: string };\n  'branch:prompt': { branch: string };\n  'branch:created': { branch: string };\n  'branch:create:failed': { error: string };\n  'branch:skipped': Record<string, never>;\n\n  // Post-install events\n  'postinstall:changes': { files: string[] };\n  'postinstall:nochanges': Record<string, never>;\n  'postinstall:commit:prompt': Record<string, never>;\n  'postinstall:commit:generating': Record<string, never>;\n  'postinstall:commit:committing': { message: string };\n  'postinstall:commit:success': { message: string };\n  'postinstall:commit:failed': { error: string };\n  'postinstall:pr:prompt': Record<string, never>;\n  'postinstall:pr:generating': Record<string, never>;\n  'postinstall:pr:pushing': Record<string, never>;\n  'postinstall:pr:creating': Record<string, never>;\n  'postinstall:pr:success': { url: string };\n  'postinstall:pr:failed': { error: string };\n  'postinstall:push:failed': { error: string };\n  'postinstall:manual': { instructions: string };\n}\n\nexport type InstallerEventName = keyof InstallerEvents;\n\nexport class InstallerEventEmitter extends EventEmitter {\n  emit<K extends InstallerEventName>(event: K, payload: InstallerEvents[K]): boolean {\n    return super.emit(event, payload);\n  }\n\n  on<K extends InstallerEventName>(event: K, listener: (payload: InstallerEvents[K]) => void): this {\n    return super.on(event, listener);\n  }\n\n  off<K extends InstallerEventName>(event: K, listener: (payload: InstallerEvents[K]) => void): this {\n    return super.off(event, listener);\n  }\n\n  once<K extends InstallerEventName>(event: K, listener: (payload: InstallerEvents[K]) => void): this {\n    return super.once(event, listener);\n  }\n}\n\nexport function createInstallerEventEmitter(): InstallerEventEmitter {\n  return new InstallerEventEmitter();\n}\n"]}

package/dist/lib/validation/build-validator.d.ts

@@ -7,3 +7,15 @@ export interface BuildResult {
     stderr: string;
 }
 export declare function runBuildValidation(projectDir: string, timeoutMs?: number): Promise<BuildResult>;
+export declare function detectPackageManager(projectDir: string): 'pnpm' | 'yarn' | 'npm';
+export declare function hasBuildScriptInPackageJson(projectDir: string): Promise<boolean>;
+export interface BuildCommand {
+    command: string;
+    args: string[];
+}
+/**
+ * Detect the build command for a project by checking ecosystem markers.
+ * Returns null if no build system detected — caller should skip build validation.
+ */
+export declare function detectBuildCommand(projectDir: string): Promise<BuildCommand | null>;
+export declare function parseBuildErrors(output: string): string[];

package/dist/lib/validation/build-validator.js

@@ -1,5 +1,5 @@
 import { spawn } from 'child_process';
-import { existsSync } from 'fs';
+import { existsSync, readdirSync } from 'fs';
 import { readFile } from 'fs/promises';
 import { join } from 'path';
 export async function runBuildValidation(projectDir, timeoutMs = 60000) {
@@ -79,14 +79,14 @@ export async function runBuildValidation(projectDir, timeoutMs = 60000) {
         });
     });
 }
-function detectPackageManager(projectDir) {
+export function detectPackageManager(projectDir) {
     if (existsSync(join(projectDir, 'pnpm-lock.yaml')))
         return 'pnpm';
     if (existsSync(join(projectDir, 'yarn.lock')))
         return 'yarn';
     return 'npm';
 }
-async function hasBuildScriptInPackageJson(projectDir) {
+export async function hasBuildScriptInPackageJson(projectDir) {
     try {
         const content = await readFile(join(projectDir, 'package.json'), 'utf-8');
         const pkg = JSON.parse(content);
@@ -96,7 +96,38 @@ async function hasBuildScriptInPackageJson(projectDir) {
         return false;
     }
 }
-function parseBuildErrors(output) {
+/**
+ * Detect the build command for a project by checking ecosystem markers.
+ * Returns null if no build system detected — caller should skip build validation.
+ */
+export async function detectBuildCommand(projectDir) {
+    const pm = detectPackageManager(projectDir);
+    if (await hasBuildScriptInPackageJson(projectDir)) {
+        const args = pm === 'npm' ? ['run', 'build'] : ['build'];
+        return { command: pm, args };
+    }
+    if (existsSync(join(projectDir, 'go.mod'))) {
+        return { command: 'go', args: ['build', './...'] };
+    }
+    if (existsSync(join(projectDir, 'mix.exs'))) {
+        return { command: 'mix', args: ['compile'] };
+    }
+    try {
+        const files = readdirSync(projectDir);
+        if (files.some((f) => f.endsWith('.csproj'))) {
+            return { command: 'dotnet', args: ['build'] };
+        }
+    }
+    catch {
+        // Can't read directory
+    }
+    if (existsSync(join(projectDir, 'build.gradle.kts')) || existsSync(join(projectDir, 'build.gradle'))) {
+        const gradlew = existsSync(join(projectDir, 'gradlew')) ? './gradlew' : 'gradle';
+        return { command: gradlew, args: ['build'] };
+    }
+    return null;
+}
+export function parseBuildErrors(output) {
     const errors = [];
     // TypeScript errors: "file.ts(line,col): error TS..."
     const tsErrors = output.match(/[\w./]+\.\w+\(\d+,\d+\):\s*error\s+TS\d+:.+/g);

package/dist/lib/validation/build-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-validator.js","sourceRoot":"","sources":["../../../src/lib/validation/build-validator.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process';\nimport { existsSync } from 'fs';\nimport { readFile } from 'fs/promises';\nimport { join } from 'path';\nimport type { ValidationIssue } from './types.js';\n\nexport interface BuildResult {\n  success: boolean;\n  issues: ValidationIssue[];\n  durationMs: number;\n  stdout: string;\n  stderr: string;\n}\n\nexport async function runBuildValidation(projectDir: string, timeoutMs: number = 60000): Promise<BuildResult> {\n  const startTime = Date.now();\n  const pm = detectPackageManager(projectDir);\n  const hasBuildScript = await hasBuildScriptInPackageJson(projectDir);\n\n  if (!hasBuildScript) {\n    return {\n      success: true,\n      issues: [],\n      durationMs: Date.now() - startTime,\n      stdout: '',\n      stderr: '',\n    };\n  }\n\n  return new Promise((resolve) => {\n    const args = pm === 'npm' ? ['run', 'build'] : ['build'];\n    const proc = spawn(pm, args, {\n      cwd: projectDir,\n      shell: true,\n      timeout: timeoutMs,\n    });\n\n    let stdout = '';\n    let stderr = '';\n\n    proc.stdout?.on('data', (data: Buffer) => {\n      stdout += data.toString();\n    });\n    proc.stderr?.on('data', (data: Buffer) => {\n      stderr += data.toString();\n    });\n\n    proc.on('close', (code) => {\n      const issues: ValidationIssue[] = [];\n\n      if (code !== 0) {\n        // Parse errors from output\n        const errors = parseBuildErrors(stdout + stderr);\n        for (const error of errors) {\n          issues.push({\n            type: 'file',\n            severity: 'error',\n            message: `Build error: ${error}`,\n            hint: 'Fix the error and run build again',\n          });\n        }\n\n        // Fallback if no specific errors parsed\n        if (issues.length === 0) {\n          issues.push({\n            type: 'file',\n            severity: 'error',\n            message: 'Build failed',\n            hint: `Run \\`${pm} ${args.join(' ')}\\` to see full output`,\n          });\n        }\n      }\n\n      resolve({\n        success: code === 0,\n        issues,\n        durationMs: Date.now() - startTime,\n        stdout,\n        stderr,\n      });\n    });\n\n    proc.on('error', (err) => {\n      resolve({\n        success: false,\n        issues: [\n          {\n            type: 'file',\n            severity: 'warning',\n            message: `Could not run build: ${err.message}`,\n            hint: 'Build validation skipped',\n          },\n        ],\n        durationMs: Date.now() - startTime,\n        stdout: '',\n        stderr: '',\n      });\n    });\n  });\n}\n\nfunction detectPackageManager(projectDir: string): 'pnpm' | 'yarn' | 'npm' {\n  if (existsSync(join(projectDir, 'pnpm-lock.yaml'))) return 'pnpm';\n  if (existsSync(join(projectDir, 'yarn.lock'))) return 'yarn';\n  return 'npm';\n}\n\nasync function hasBuildScriptInPackageJson(projectDir: string): Promise<boolean> {\n  try {\n    const content = await readFile(join(projectDir, 'package.json'), 'utf-8');\n    const pkg = JSON.parse(content) as { scripts?: { build?: string } };\n    return !!pkg.scripts?.build;\n  } catch {\n    return false;\n  }\n}\n\nfunction parseBuildErrors(output: string): string[] {\n  const errors: string[] = [];\n\n  // TypeScript errors: \"file.ts(line,col): error TS...\"\n  const tsErrors = output.match(/[\\w./]+\\.\\w+\\(\\d+,\\d+\\):\\s*error\\s+TS\\d+:.+/g);\n  if (tsErrors) {\n    errors.push(...tsErrors.slice(0, 5)); // Limit to first 5\n  }\n\n  // Next.js errors: \"Error: ...\"\n  const nextErrors = output.match(/Error:\\s+.+/g);\n  if (nextErrors) {\n    errors.push(...nextErrors.slice(0, 5));\n  }\n\n  // ESLint errors: \"file.ts line:col error ...\"\n  const eslintErrors = output.match(/[\\w./]+:\\d+:\\d+\\s+error\\s+.+/g);\n  if (eslintErrors) {\n    errors.push(...eslintErrors.slice(0, 5));\n  }\n\n  return errors;\n}\n"]}
+{"version":3,"file":"build-validator.js","sourceRoot":"","sources":["../../../src/lib/validation/build-validator.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process';\nimport { existsSync, readdirSync } from 'fs';\nimport { readFile } from 'fs/promises';\nimport { join } from 'path';\nimport type { ValidationIssue } from './types.js';\n\nexport interface BuildResult {\n  success: boolean;\n  issues: ValidationIssue[];\n  durationMs: number;\n  stdout: string;\n  stderr: string;\n}\n\nexport async function runBuildValidation(projectDir: string, timeoutMs: number = 60000): Promise<BuildResult> {\n  const startTime = Date.now();\n  const pm = detectPackageManager(projectDir);\n  const hasBuildScript = await hasBuildScriptInPackageJson(projectDir);\n\n  if (!hasBuildScript) {\n    return {\n      success: true,\n      issues: [],\n      durationMs: Date.now() - startTime,\n      stdout: '',\n      stderr: '',\n    };\n  }\n\n  return new Promise((resolve) => {\n    const args = pm === 'npm' ? ['run', 'build'] : ['build'];\n    const proc = spawn(pm, args, {\n      cwd: projectDir,\n      shell: true,\n      timeout: timeoutMs,\n    });\n\n    let stdout = '';\n    let stderr = '';\n\n    proc.stdout?.on('data', (data: Buffer) => {\n      stdout += data.toString();\n    });\n    proc.stderr?.on('data', (data: Buffer) => {\n      stderr += data.toString();\n    });\n\n    proc.on('close', (code) => {\n      const issues: ValidationIssue[] = [];\n\n      if (code !== 0) {\n        // Parse errors from output\n        const errors = parseBuildErrors(stdout + stderr);\n        for (const error of errors) {\n          issues.push({\n            type: 'file',\n            severity: 'error',\n            message: `Build error: ${error}`,\n            hint: 'Fix the error and run build again',\n          });\n        }\n\n        // Fallback if no specific errors parsed\n        if (issues.length === 0) {\n          issues.push({\n            type: 'file',\n            severity: 'error',\n            message: 'Build failed',\n            hint: `Run \\`${pm} ${args.join(' ')}\\` to see full output`,\n          });\n        }\n      }\n\n      resolve({\n        success: code === 0,\n        issues,\n        durationMs: Date.now() - startTime,\n        stdout,\n        stderr,\n      });\n    });\n\n    proc.on('error', (err) => {\n      resolve({\n        success: false,\n        issues: [\n          {\n            type: 'file',\n            severity: 'warning',\n            message: `Could not run build: ${err.message}`,\n            hint: 'Build validation skipped',\n          },\n        ],\n        durationMs: Date.now() - startTime,\n        stdout: '',\n        stderr: '',\n      });\n    });\n  });\n}\n\nexport function detectPackageManager(projectDir: string): 'pnpm' | 'yarn' | 'npm' {\n  if (existsSync(join(projectDir, 'pnpm-lock.yaml'))) return 'pnpm';\n  if (existsSync(join(projectDir, 'yarn.lock'))) return 'yarn';\n  return 'npm';\n}\n\nexport async function hasBuildScriptInPackageJson(projectDir: string): Promise<boolean> {\n  try {\n    const content = await readFile(join(projectDir, 'package.json'), 'utf-8');\n    const pkg = JSON.parse(content) as { scripts?: { build?: string } };\n    return !!pkg.scripts?.build;\n  } catch {\n    return false;\n  }\n}\n\nexport interface BuildCommand {\n  command: string;\n  args: string[];\n}\n\n/**\n * Detect the build command for a project by checking ecosystem markers.\n * Returns null if no build system detected — caller should skip build validation.\n */\nexport async function detectBuildCommand(projectDir: string): Promise<BuildCommand | null> {\n  const pm = detectPackageManager(projectDir);\n  if (await hasBuildScriptInPackageJson(projectDir)) {\n    const args = pm === 'npm' ? ['run', 'build'] : ['build'];\n    return { command: pm, args };\n  }\n\n  if (existsSync(join(projectDir, 'go.mod'))) {\n    return { command: 'go', args: ['build', './...'] };\n  }\n\n  if (existsSync(join(projectDir, 'mix.exs'))) {\n    return { command: 'mix', args: ['compile'] };\n  }\n\n  try {\n    const files = readdirSync(projectDir);\n    if (files.some((f) => f.endsWith('.csproj'))) {\n      return { command: 'dotnet', args: ['build'] };\n    }\n  } catch {\n    // Can't read directory\n  }\n\n  if (existsSync(join(projectDir, 'build.gradle.kts')) || existsSync(join(projectDir, 'build.gradle'))) {\n    const gradlew = existsSync(join(projectDir, 'gradlew')) ? './gradlew' : 'gradle';\n    return { command: gradlew, args: ['build'] };\n  }\n\n  return null;\n}\n\nexport function parseBuildErrors(output: string): string[] {\n  const errors: string[] = [];\n\n  // TypeScript errors: \"file.ts(line,col): error TS...\"\n  const tsErrors = output.match(/[\\w./]+\\.\\w+\\(\\d+,\\d+\\):\\s*error\\s+TS\\d+:.+/g);\n  if (tsErrors) {\n    errors.push(...tsErrors.slice(0, 5)); // Limit to first 5\n  }\n\n  // Next.js errors: \"Error: ...\"\n  const nextErrors = output.match(/Error:\\s+.+/g);\n  if (nextErrors) {\n    errors.push(...nextErrors.slice(0, 5));\n  }\n\n  // ESLint errors: \"file.ts line:col error ...\"\n  const eslintErrors = output.match(/[\\w./]+:\\d+:\\d+\\s+error\\s+.+/g);\n  if (eslintErrors) {\n    errors.push(...eslintErrors.slice(0, 5));\n  }\n\n  return errors;\n}\n"]}

package/dist/lib/validation/index.d.ts

@@ -1,3 +1,4 @@
-export { validateInstallation, type ValidateOptions } from './validator.js';
+export { validateInstallation, validatePackages, validateEnvVars, validateFiles, validateFrameworkSpecific, type ValidateOptions, } from './validator.js';
 export { runBuildValidation, type BuildResult } from './build-validator.js';
-export type { ValidationResult, ValidationRules, ValidationIssue, ValidationSeverity, ValidationIssueType, PackageRule, EnvVarRule, FileRule, VariantRules, } from './types.js';
+export { runQuickChecks, runTypecheckValidation, quickCheckValidateAndFormat } from './quick-checks.js';
+export type { ValidationResult, ValidationRules, ValidationIssue, ValidationSeverity, ValidationIssueType, PackageRule, EnvVarRule, FileRule, VariantRules, QuickCheckResult, QuickChecksOutput, } from './types.js';

package/dist/lib/validation/index.js

@@ -1,3 +1,4 @@
-export { validateInstallation } from './validator.js';
+export { validateInstallation, validatePackages, validateEnvVars, validateFiles, validateFrameworkSpecific, } from './validator.js';
 export { runBuildValidation } from './build-validator.js';
+export { runQuickChecks, runTypecheckValidation, quickCheckValidateAndFormat } from './quick-checks.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/validation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAoB,MAAM,sBAAsB,CAAC","sourcesContent":["export { validateInstallation, type ValidateOptions } from './validator.js';\nexport { runBuildValidation, type BuildResult } from './build-validator.js';\nexport type {\n  ValidationResult,\n  ValidationRules,\n  ValidationIssue,\n  ValidationSeverity,\n  ValidationIssueType,\n  PackageRule,\n  EnvVarRule,\n  FileRule,\n  VariantRules,\n} from './types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,yBAAyB,GAE1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAoB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["export {\n  validateInstallation,\n  validatePackages,\n  validateEnvVars,\n  validateFiles,\n  validateFrameworkSpecific,\n  type ValidateOptions,\n} from './validator.js';\nexport { runBuildValidation, type BuildResult } from './build-validator.js';\nexport { runQuickChecks, runTypecheckValidation, quickCheckValidateAndFormat } from './quick-checks.js';\nexport type {\n  ValidationResult,\n  ValidationRules,\n  ValidationIssue,\n  ValidationSeverity,\n  ValidationIssueType,\n  PackageRule,\n  EnvVarRule,\n  FileRule,\n  VariantRules,\n  QuickCheckResult,\n  QuickChecksOutput,\n} from './types.js';\n"]}

package/dist/lib/validation/quick-checks.d.ts

@@ -0,0 +1,19 @@
+import type { QuickCheckResult, QuickChecksOutput } from './types.js';
+/**
+ * Run fast deterministic checks: typecheck first, then build.
+ * Short-circuits: if typecheck fails, skip build (build will fail too).
+ */
+export declare function runQuickChecks(projectDir: string, options?: {
+    skipBuild?: boolean;
+    timeoutMs?: number;
+}): Promise<QuickChecksOutput>;
+/**
+ * Run typecheck only (tsc --noEmit or framework equivalent).
+ * Faster than full build — catches type errors in ~5s.
+ */
+export declare function runTypecheckValidation(projectDir: string, timeoutMs?: number): Promise<QuickCheckResult>;
+/**
+ * Validation callback suitable for RetryConfig.validateAndFormat.
+ * Returns null if checks pass, or an agent-ready error prompt if they fail.
+ */
+export declare function quickCheckValidateAndFormat(workingDirectory: string): Promise<string | null>;

package/dist/lib/validation/quick-checks.js

@@ -0,0 +1,191 @@
+import { spawn } from 'child_process';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { detectBuildCommand, detectPackageManager, parseBuildErrors } from './build-validator.js';
+const DEFAULT_TYPECHECK_TIMEOUT_MS = 30_000;
+const DEFAULT_BUILD_TIMEOUT_MS = 60_000;
+/**
+ * Run fast deterministic checks: typecheck first, then build.
+ * Short-circuits: if typecheck fails, skip build (build will fail too).
+ */
+export async function runQuickChecks(projectDir, options) {
+    const startTime = Date.now();
+    const results = [];
+    const typecheckResult = await runTypecheckValidation(projectDir, options?.timeoutMs ?? DEFAULT_TYPECHECK_TIMEOUT_MS);
+    results.push(typecheckResult);
+    if (typecheckResult.passed && !options?.skipBuild) {
+        results.push(await runBuildQuickCheck(projectDir, options?.timeoutMs ?? DEFAULT_BUILD_TIMEOUT_MS));
+    }
+    const passed = results.every((r) => r.passed);
+    return {
+        passed,
+        results,
+        agentRetryPrompt: passed ? null : formatForAgent(results),
+        totalDurationMs: Date.now() - startTime,
+    };
+}
+function passResult(phase, startTime) {
+    return { passed: true, phase, issues: [], agentPrompt: null, durationMs: Date.now() - startTime };
+}
+/**
+ * Run typecheck only (tsc --noEmit or framework equivalent).
+ * Faster than full build — catches type errors in ~5s.
+ */
+export async function runTypecheckValidation(projectDir, timeoutMs = DEFAULT_TYPECHECK_TIMEOUT_MS) {
+    const startTime = Date.now();
+    const typecheckCmd = await detectTypecheckCommand(projectDir);
+    if (!typecheckCmd) {
+        return passResult('typecheck', startTime);
+    }
+    const { exitCode, stdout, stderr } = await spawnCommand(typecheckCmd.command, typecheckCmd.args, projectDir, timeoutMs);
+    if (exitCode === 0) {
+        return passResult('typecheck', startTime);
+    }
+    const output = stdout + stderr;
+    const errors = parseTypecheckErrors(output);
+    const issues = errors.map((error) => ({
+        type: 'file',
+        severity: 'error',
+        message: `Type error: ${error}`,
+        hint: 'Fix the type error and run typecheck again',
+    }));
+    if (issues.length === 0) {
+        issues.push({
+            type: 'file',
+            severity: 'error',
+            message: 'Typecheck failed',
+            hint: `Run \`${typecheckCmd.command} ${typecheckCmd.args.join(' ')}\` to see full output`,
+        });
+    }
+    return {
+        passed: false,
+        phase: 'typecheck',
+        issues,
+        agentPrompt: formatTypecheckErrors(errors, output),
+        durationMs: Date.now() - startTime,
+    };
+}
+async function runBuildQuickCheck(projectDir, timeoutMs) {
+    const startTime = Date.now();
+    const buildCmd = await detectBuildCommand(projectDir);
+    if (!buildCmd) {
+        return passResult('build', startTime);
+    }
+    const { exitCode, stdout, stderr } = await spawnCommand(buildCmd.command, buildCmd.args, projectDir, timeoutMs);
+    if (exitCode === 0) {
+        return passResult('build', startTime);
+    }
+    const output = stdout + stderr;
+    const errors = parseBuildErrors(output);
+    const issues = errors.length > 0
+        ? errors.map((e) => ({
+            type: 'file',
+            severity: 'error',
+            message: `Build error: ${e}`,
+            hint: 'Fix the error and run build again',
+        }))
+        : [
+            {
+                type: 'file',
+                severity: 'error',
+                message: 'Build failed',
+                hint: `Run \`${buildCmd.command} ${buildCmd.args.join(' ')}\` to see full output`,
+            },
+        ];
+    return {
+        passed: false,
+        phase: 'build',
+        issues,
+        agentPrompt: formatBuildErrors(issues),
+        durationMs: Date.now() - startTime,
+    };
+}
+async function detectTypecheckCommand(projectDir) {
+    const pm = detectPackageManager(projectDir);
+    try {
+        const content = await readFile(join(projectDir, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(content);
+        const scriptName = pkg.scripts?.typecheck ? 'typecheck' : pkg.scripts?.['type-check'] ? 'type-check' : null;
+        if (scriptName) {
+            const args = pm === 'npm' ? ['run', scriptName] : [scriptName];
+            return { command: pm, args };
+        }
+    }
+    catch {
+        // No package.json or malformed
+    }
+    try {
+        await readFile(join(projectDir, 'tsconfig.json'), 'utf-8');
+        return { command: 'npx', args: ['tsc', '--noEmit'] };
+    }
+    catch {
+        return null;
+    }
+}
+function parseTypecheckErrors(output) {
+    // Match both TS error formats:
+    //   src/file.ts(line,col): error TS2345: ...
+    //   src/file.ts:line:col - error TS2345: ...  (tsc --pretty)
+    const pattern = /[\w./]+\.\w+(?:\(\d+,\d+\):\s*|:\d+:\d+\s*-\s*)error\s+TS\d+:.+/g;
+    const matches = output.match(pattern);
+    return matches ? [...new Set(matches)].slice(0, 10) : [];
+}
+function formatTypecheckErrors(errors, rawOutput) {
+    if (errors.length === 0) {
+        // Couldn't parse specific errors — give raw output
+        const truncated = rawOutput.slice(0, 2000);
+        return `The typecheck failed. Here is the output:\n\n${truncated}\n\nFix the type errors shown above.`;
+    }
+    const lines = errors.map((error) => {
+        // Extract file:line info and error description
+        const fileMatch = error.match(/([\w./]+\.\w+)[:(]\d+/);
+        const tsMatch = error.match(/error\s+(TS\d+):\s*(.+)/);
+        if (fileMatch && tsMatch) {
+            return `- ${fileMatch[1]}: ${tsMatch[2]} (${tsMatch[1]})`;
+        }
+        return `- ${error}`;
+    });
+    return `The typecheck failed with ${errors.length} error${errors.length === 1 ? '' : 's'}:\n\n${lines.join('\n')}\n\nFix these type errors in the indicated files.`;
+}
+function formatBuildErrors(issues) {
+    const errorMessages = issues.map((i) => `- ${i.message}`);
+    return `The build failed:\n\n${errorMessages.join('\n')}\n\nFix these build errors.`;
+}
+function formatForAgent(results) {
+    return results
+        .filter((r) => !r.passed && r.agentPrompt)
+        .map((r) => r.agentPrompt)
+        .join('\n\n');
+}
+/**
+ * Validation callback suitable for RetryConfig.validateAndFormat.
+ * Returns null if checks pass, or an agent-ready error prompt if they fail.
+ */
+export async function quickCheckValidateAndFormat(workingDirectory) {
+    const result = await runQuickChecks(workingDirectory);
+    return result.passed ? null : result.agentRetryPrompt;
+}
+function spawnCommand(command, args, cwd, timeoutMs) {
+    return new Promise((resolve) => {
+        const proc = spawn(command, args, {
+            cwd,
+            shell: true,
+            timeout: timeoutMs,
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            resolve({ exitCode: code ?? 1, stdout, stderr });
+        });
+        proc.on('error', () => {
+            resolve({ exitCode: 1, stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=quick-checks.js.map

package/dist/lib/validation/quick-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-checks.js","sourceRoot":"","sources":["../../../src/lib/validation/quick-checks.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process';\nimport { readFile } from 'fs/promises';\nimport { join } from 'path';\nimport type { QuickCheckResult, QuickChecksOutput, ValidationIssue } from './types.js';\nimport { detectBuildCommand, detectPackageManager, parseBuildErrors } from './build-validator.js';\n\nconst DEFAULT_TYPECHECK_TIMEOUT_MS = 30_000;\nconst DEFAULT_BUILD_TIMEOUT_MS = 60_000;\n\n/**\n * Run fast deterministic checks: typecheck first, then build.\n * Short-circuits: if typecheck fails, skip build (build will fail too).\n */\nexport async function runQuickChecks(\n  projectDir: string,\n  options?: { skipBuild?: boolean; timeoutMs?: number },\n): Promise<QuickChecksOutput> {\n  const startTime = Date.now();\n  const results: QuickCheckResult[] = [];\n\n  const typecheckResult = await runTypecheckValidation(projectDir, options?.timeoutMs ?? DEFAULT_TYPECHECK_TIMEOUT_MS);\n  results.push(typecheckResult);\n\n  if (typecheckResult.passed && !options?.skipBuild) {\n    results.push(await runBuildQuickCheck(projectDir, options?.timeoutMs ?? DEFAULT_BUILD_TIMEOUT_MS));\n  }\n\n  const passed = results.every((r) => r.passed);\n\n  return {\n    passed,\n    results,\n    agentRetryPrompt: passed ? null : formatForAgent(results),\n    totalDurationMs: Date.now() - startTime,\n  };\n}\n\nfunction passResult(phase: QuickCheckResult['phase'], startTime: number): QuickCheckResult {\n  return { passed: true, phase, issues: [], agentPrompt: null, durationMs: Date.now() - startTime };\n}\n\n/**\n * Run typecheck only (tsc --noEmit or framework equivalent).\n * Faster than full build — catches type errors in ~5s.\n */\nexport async function runTypecheckValidation(\n  projectDir: string,\n  timeoutMs: number = DEFAULT_TYPECHECK_TIMEOUT_MS,\n): Promise<QuickCheckResult> {\n  const startTime = Date.now();\n  const typecheckCmd = await detectTypecheckCommand(projectDir);\n\n  if (!typecheckCmd) {\n    return passResult('typecheck', startTime);\n  }\n\n  const { exitCode, stdout, stderr } = await spawnCommand(\n    typecheckCmd.command,\n    typecheckCmd.args,\n    projectDir,\n    timeoutMs,\n  );\n\n  if (exitCode === 0) {\n    return passResult('typecheck', startTime);\n  }\n\n  const output = stdout + stderr;\n  const errors = parseTypecheckErrors(output);\n  const issues: ValidationIssue[] = errors.map((error) => ({\n    type: 'file',\n    severity: 'error',\n    message: `Type error: ${error}`,\n    hint: 'Fix the type error and run typecheck again',\n  }));\n\n  if (issues.length === 0) {\n    issues.push({\n      type: 'file',\n      severity: 'error',\n      message: 'Typecheck failed',\n      hint: `Run \\`${typecheckCmd.command} ${typecheckCmd.args.join(' ')}\\` to see full output`,\n    });\n  }\n\n  return {\n    passed: false,\n    phase: 'typecheck',\n    issues,\n    agentPrompt: formatTypecheckErrors(errors, output),\n    durationMs: Date.now() - startTime,\n  };\n}\n\nasync function runBuildQuickCheck(projectDir: string, timeoutMs: number): Promise<QuickCheckResult> {\n  const startTime = Date.now();\n  const buildCmd = await detectBuildCommand(projectDir);\n\n  if (!buildCmd) {\n    return passResult('build', startTime);\n  }\n\n  const { exitCode, stdout, stderr } = await spawnCommand(buildCmd.command, buildCmd.args, projectDir, timeoutMs);\n\n  if (exitCode === 0) {\n    return passResult('build', startTime);\n  }\n\n  const output = stdout + stderr;\n  const errors = parseBuildErrors(output);\n  const issues: ValidationIssue[] =\n    errors.length > 0\n      ? errors.map((e) => ({\n          type: 'file',\n          severity: 'error',\n          message: `Build error: ${e}`,\n          hint: 'Fix the error and run build again',\n        }))\n      : [\n          {\n            type: 'file',\n            severity: 'error',\n            message: 'Build failed',\n            hint: `Run \\`${buildCmd.command} ${buildCmd.args.join(' ')}\\` to see full output`,\n          },\n        ];\n\n  return {\n    passed: false,\n    phase: 'build',\n    issues,\n    agentPrompt: formatBuildErrors(issues),\n    durationMs: Date.now() - startTime,\n  };\n}\n\ninterface TypecheckCommand {\n  command: string;\n  args: string[];\n}\n\nasync function detectTypecheckCommand(projectDir: string): Promise<TypecheckCommand | null> {\n  const pm = detectPackageManager(projectDir);\n\n  try {\n    const content = await readFile(join(projectDir, 'package.json'), 'utf-8');\n    const pkg = JSON.parse(content) as { scripts?: Record<string, string> };\n\n    const scriptName = pkg.scripts?.typecheck ? 'typecheck' : pkg.scripts?.['type-check'] ? 'type-check' : null;\n    if (scriptName) {\n      const args = pm === 'npm' ? ['run', scriptName] : [scriptName];\n      return { command: pm, args };\n    }\n  } catch {\n    // No package.json or malformed\n  }\n\n  try {\n    await readFile(join(projectDir, 'tsconfig.json'), 'utf-8');\n    return { command: 'npx', args: ['tsc', '--noEmit'] };\n  } catch {\n    return null;\n  }\n}\n\nfunction parseTypecheckErrors(output: string): string[] {\n  // Match both TS error formats:\n  //   src/file.ts(line,col): error TS2345: ...\n  //   src/file.ts:line:col - error TS2345: ...  (tsc --pretty)\n  const pattern = /[\\w./]+\\.\\w+(?:\\(\\d+,\\d+\\):\\s*|:\\d+:\\d+\\s*-\\s*)error\\s+TS\\d+:.+/g;\n  const matches = output.match(pattern);\n  return matches ? [...new Set(matches)].slice(0, 10) : [];\n}\n\nfunction formatTypecheckErrors(errors: string[], rawOutput: string): string {\n  if (errors.length === 0) {\n    // Couldn't parse specific errors — give raw output\n    const truncated = rawOutput.slice(0, 2000);\n    return `The typecheck failed. Here is the output:\\n\\n${truncated}\\n\\nFix the type errors shown above.`;\n  }\n\n  const lines = errors.map((error) => {\n    // Extract file:line info and error description\n    const fileMatch = error.match(/([\\w./]+\\.\\w+)[:(]\\d+/);\n    const tsMatch = error.match(/error\\s+(TS\\d+):\\s*(.+)/);\n\n    if (fileMatch && tsMatch) {\n      return `- ${fileMatch[1]}: ${tsMatch[2]} (${tsMatch[1]})`;\n    }\n    return `- ${error}`;\n  });\n\n  return `The typecheck failed with ${errors.length} error${errors.length === 1 ? '' : 's'}:\\n\\n${lines.join('\\n')}\\n\\nFix these type errors in the indicated files.`;\n}\n\nfunction formatBuildErrors(issues: ValidationIssue[]): string {\n  const errorMessages = issues.map((i) => `- ${i.message}`);\n  return `The build failed:\\n\\n${errorMessages.join('\\n')}\\n\\nFix these build errors.`;\n}\n\nfunction formatForAgent(results: QuickCheckResult[]): string {\n  return results\n    .filter((r) => !r.passed && r.agentPrompt)\n    .map((r) => r.agentPrompt!)\n    .join('\\n\\n');\n}\n\n/**\n * Validation callback suitable for RetryConfig.validateAndFormat.\n * Returns null if checks pass, or an agent-ready error prompt if they fail.\n */\nexport async function quickCheckValidateAndFormat(workingDirectory: string): Promise<string | null> {\n  const result = await runQuickChecks(workingDirectory);\n  return result.passed ? null : result.agentRetryPrompt;\n}\n\nfunction spawnCommand(\n  command: string,\n  args: string[],\n  cwd: string,\n  timeoutMs: number,\n): Promise<{ exitCode: number; stdout: string; stderr: string }> {\n  return new Promise((resolve) => {\n    const proc = spawn(command, args, {\n      cwd,\n      shell: true,\n      timeout: timeoutMs,\n    });\n\n    let stdout = '';\n    let stderr = '';\n\n    proc.stdout?.on('data', (data: Buffer) => {\n      stdout += data.toString();\n    });\n    proc.stderr?.on('data', (data: Buffer) => {\n      stderr += data.toString();\n    });\n\n    proc.on('close', (code) => {\n      resolve({ exitCode: code ?? 1, stdout, stderr });\n    });\n\n    proc.on('error', () => {\n      resolve({ exitCode: 1, stdout, stderr });\n    });\n  });\n}\n"]}

package/dist/lib/validation/types.d.ts

@@ -38,4 +38,19 @@ export interface ValidationRules {
     files: FileRule[];
     variants?: Record<string, VariantRules>;
 }
+export interface QuickCheckResult {
+    passed: boolean;
+    phase: 'typecheck' | 'build';
+    issues: ValidationIssue[];
+    /** Formatted for agent consumption — actionable, not just error messages */
+    agentPrompt: string | null;
+    durationMs: number;
+}
+export interface QuickChecksOutput {
+    passed: boolean;
+    results: QuickCheckResult[];
+    /** Combined agent-ready prompt summarizing all failures */
+    agentRetryPrompt: string | null;
+    totalDurationMs: number;
+}
 export type { BuildResult } from './build-validator.js';

package/dist/lib/validation/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/validation/types.ts"],"names":[],"mappings":"","sourcesContent":["export type ValidationSeverity = 'error' | 'warning';\nexport type ValidationIssueType = 'package' | 'env' | 'file' | 'pattern';\n\nexport interface ValidationIssue {\n  type: ValidationIssueType;\n  severity: ValidationSeverity;\n  message: string;\n  hint?: string; // How to fix\n}\n\nexport interface ValidationResult {\n  passed: boolean;\n  framework: string;\n  issues: ValidationIssue[];\n  durationMs: number;\n}\n\n// Rule definitions (matches JSON schema)\nexport interface PackageRule {\n  name: string;\n  location?: 'dependencies' | 'devDependencies' | 'any'; // default: 'any'\n}\n\nexport interface EnvVarRule {\n  name: string;\n  required?: boolean; // default: true\n  alternates?: string[]; // alternate env var names (e.g., VITE_WORKOS_CLIENT_ID)\n}\n\nexport interface FileRule {\n  path: string; // glob pattern, e.g., \"middleware.ts\" or \"app/**/callback/**/route.ts\"\n  mustContain?: string[]; // strings that must appear in file\n  mustContainAny?: string[]; // at least one must appear\n}\n\nexport interface VariantRules {\n  files?: FileRule[];\n  packages?: PackageRule[];\n  envVars?: EnvVarRule[];\n}\n\nexport interface ValidationRules {\n  framework: string;\n  packages: PackageRule[];\n  envVars: EnvVarRule[];\n  files: FileRule[];\n  variants?: Record<string, VariantRules>;\n}\n\n// Re-export BuildResult from build-validator\nexport type { BuildResult } from './build-validator.js';\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/validation/types.ts"],"names":[],"mappings":"","sourcesContent":["export type ValidationSeverity = 'error' | 'warning';\nexport type ValidationIssueType = 'package' | 'env' | 'file' | 'pattern';\n\nexport interface ValidationIssue {\n  type: ValidationIssueType;\n  severity: ValidationSeverity;\n  message: string;\n  hint?: string; // How to fix\n}\n\nexport interface ValidationResult {\n  passed: boolean;\n  framework: string;\n  issues: ValidationIssue[];\n  durationMs: number;\n}\n\n// Rule definitions (matches JSON schema)\nexport interface PackageRule {\n  name: string;\n  location?: 'dependencies' | 'devDependencies' | 'any'; // default: 'any'\n}\n\nexport interface EnvVarRule {\n  name: string;\n  required?: boolean; // default: true\n  alternates?: string[]; // alternate env var names (e.g., VITE_WORKOS_CLIENT_ID)\n}\n\nexport interface FileRule {\n  path: string; // glob pattern, e.g., \"middleware.ts\" or \"app/**/callback/**/route.ts\"\n  mustContain?: string[]; // strings that must appear in file\n  mustContainAny?: string[]; // at least one must appear\n}\n\nexport interface VariantRules {\n  files?: FileRule[];\n  packages?: PackageRule[];\n  envVars?: EnvVarRule[];\n}\n\nexport interface ValidationRules {\n  framework: string;\n  packages: PackageRule[];\n  envVars: EnvVarRule[];\n  files: FileRule[];\n  variants?: Record<string, VariantRules>;\n}\n\nexport interface QuickCheckResult {\n  passed: boolean;\n  phase: 'typecheck' | 'build';\n  issues: ValidationIssue[];\n  /** Formatted for agent consumption — actionable, not just error messages */\n  agentPrompt: string | null;\n  durationMs: number;\n}\n\nexport interface QuickChecksOutput {\n  passed: boolean;\n  results: QuickCheckResult[];\n  /** Combined agent-ready prompt summarizing all failures */\n  agentRetryPrompt: string | null;\n  totalDurationMs: number;\n}\n\n// Re-export BuildResult from build-validator\nexport type { BuildResult } from './build-validator.js';\n"]}

package/dist/lib/validation/validator.d.ts

@@ -1,6 +1,13 @@
-import type { ValidationResult } from './types.js';
+import type { ValidationResult, ValidationRules, ValidationIssue } from './types.js';
 export interface ValidateOptions {
     variant?: string;
     runBuild?: boolean;
 }
 export declare function validateInstallation(framework: string, projectDir: string, options?: ValidateOptions): Promise<ValidationResult>;
+export declare function validatePackages(rules: ValidationRules, projectDir: string): Promise<ValidationIssue[]>;
+export declare function validateEnvVars(rules: ValidationRules, projectDir: string): Promise<ValidationIssue[]>;
+export declare function validateFiles(rules: ValidationRules, projectDir: string): Promise<ValidationIssue[]>;
+/**
+ * Framework-specific cross-validations that require reading multiple sources.
+ */
+export declare function validateFrameworkSpecific(framework: string, projectDir: string): Promise<ValidationIssue[]>;

package/dist/lib/validation/validator.js

@@ -17,11 +17,11 @@ export async function validateInstallation(framework, projectDir, options = {})
         };
     }
     // Run validations
-    await validatePackages(rules, projectDir, issues);
-    await validateEnvVars(rules, projectDir, issues);
-    await validateFiles(rules, projectDir, issues);
+    issues.push(...(await validatePackages(rules, projectDir)));
+    issues.push(...(await validateEnvVars(rules, projectDir)));
+    issues.push(...(await validateFiles(rules, projectDir)));
     // Run framework-specific cross-validations
-    await validateFrameworkSpecific(framework, projectDir, issues);
+    issues.push(...(await validateFrameworkSpecific(framework, projectDir)));
     // Run build validation if enabled
     if (options.runBuild !== false) {
         const buildResult = await runBuildValidation(projectDir);
@@ -55,17 +55,18 @@ async function loadRules(framework, variant) {
         return null; // No rules for this framework yet
     }
 }
-async function validatePackages(rules, projectDir, issues) {
+export async function validatePackages(rules, projectDir) {
+    const issues = [];
     const pkgPath = join(projectDir, 'package.json');
     if (!existsSync(pkgPath))
-        return;
+        return issues;
     let pkg;
     try {
         pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));
     }
     catch {
         // Malformed package.json - skip package validation
-        return;
+        return issues;
     }
     const deps = (pkg.dependencies || {});
     const devDeps = (pkg.devDependencies || {});
@@ -82,8 +83,10 @@ async function validatePackages(rules, projectDir, issues) {
             });
         }
     }
+    return issues;
 }
-async function validateEnvVars(rules, projectDir, issues) {
+export async function validateEnvVars(rules, projectDir) {
+    const issues = [];
     const envPath = join(projectDir, '.env.local');
     let envContent = '';
     try {
@@ -98,7 +101,7 @@ async function validateEnvVars(rules, projectDir, issues) {
                 hint: 'Create .env.local with required environment variables',
             });
         }
-        return;
+        return issues;
     }
     for (const rule of rules.envVars) {
         // Check primary name and any alternates
@@ -119,8 +122,10 @@ async function validateEnvVars(rules, projectDir, issues) {
             });
         }
     }
+    return issues;
 }
-async function validateFiles(rules, projectDir, issues) {
+export async function validateFiles(rules, projectDir) {
+    const issues = [];
     for (const rule of rules.files) {
         let matches;
         try {
@@ -177,11 +182,13 @@ async function validateFiles(rules, projectDir, issues) {
             }
         }
     }
+    return issues;
 }
 /**
  * Framework-specific cross-validations that require reading multiple sources.
  */
-async function validateFrameworkSpecific(framework, projectDir, issues) {
+export async function validateFrameworkSpecific(framework, projectDir) {
+    const issues = [];
     // Universal cross-validations
     await validateCredentialFormats(projectDir, issues);
     await validateDuplicateEnvVars(projectDir, issues);
@@ -204,6 +211,7 @@ async function validateFrameworkSpecific(framework, projectDir, issues) {
             await validateCookiePasswordLength(projectDir, issues, 'WORKOS_COOKIE_PASSWORD');
             break;
     }
+    return issues;
 }
 /**
  * Validates that the Next.js redirect URI matches an existing callback route.