edsger 0.77.0 → 0.79.0

package/dist/commands/api-docs/index.js

@@ -1,41 +0,0 @@
-/**
- * CLI command: edsger api-docs <productId> --run-id <id>
- *               edsger api-docs --repo-id <id> --run-id <id>
- *
- * Clones the repository, asks Claude to determine its API surface, and persists
- * a generated API reference (Markdown + optional OpenAPI document) onto the
- * pending api_doc_runs row. The desktop UI creates the pending row first then
- * invokes the CLI with --run-id; the CLI flips status running →
- * success/failed and writes the artifact via the api-docs MCP toolkit.
- */
-import { runApiDocsPhase } from '../../phases/api-docs/index.js';
-import { logError, logInfo, logSuccess } from '../../utils/logger.js';
-export async function runApiDocs(productId, options) {
-    const { runId, repoId, guidance, verbose } = options;
-    if (!productId && !repoId) {
-        throw new Error('Either a product ID or --repo-id is required for api-docs');
-    }
-    if (!runId) {
-        throw new Error('--run-id is required (the pending api_doc_runs row id)');
-    }
-    if (productId) {
-        logInfo(`Starting API docs generation for product ${productId}`);
-    }
-    else {
-        logInfo(`Starting API docs generation for repository ${repoId}`);
-    }
-    const result = await runApiDocsPhase({
-        productId,
-        repoId,
-        runId,
-        guidance,
-        verbose,
-    });
-    if (result.status === 'success') {
-        logSuccess(result.message);
-    }
-    else {
-        logError(result.message);
-        process.exit(1);
-    }
-}

package/dist/commands/app-store/index.d.ts

@@ -1,12 +0,0 @@
-import { type CliOptions } from '../../types/index.js';
-/**
- * Run AI-powered app store asset generation for a product.
- * Generates professional screenshots and optimized listing content.
- */
-export declare const runAppStoreGeneration: (options: CliOptions & {
-    appStoreProductId: string;
-    store?: string;
-    locale?: string;
-    screenshotsOnly?: boolean;
-    listingsOnly?: boolean;
-}) => Promise<void>;

package/dist/commands/app-store/index.js

@@ -1,69 +0,0 @@
-import { generateAppStoreAssets, } from '../../phases/app-store-generation/index.js';
-import { isPlaywrightAvailable } from '../../services/video/screenshot-generator.js';
-import { deregisterSession, registerSession, } from '../../system/session-manager.js';
-import { logError, logInfo, logSuccess } from '../../utils/logger.js';
-import { ensurePlaywright, validateConfiguration, } from '../../utils/validation.js';
-/**
- * Run AI-powered app store asset generation for a product.
- * Generates professional screenshots and optimized listing content.
- */
-export const runAppStoreGeneration = async (options) => {
-    const productId = options.appStoreProductId;
-    if (!productId) {
-        throw new Error('Product ID is required for app store generation');
-    }
-    const config = validateConfiguration(options);
-    // Pre-flight check: ensure Playwright is installed when screenshots are needed
-    if (!options.listingsOnly) {
-        await ensurePlaywright(isPlaywrightAvailable);
-    }
-    const storeFromOption = options.store === 'google' ? 'google' : 'all';
-    const targetStore = options.store === 'apple' ? 'apple' : storeFromOption;
-    // Register CLI session for log persistence
-    await registerSession({ command: 'app-store', productId });
-    logInfo(`Starting app store asset generation for product: ${productId}`);
-    try {
-        const result = await generateAppStoreAssets({
-            productId,
-            targetStore,
-            locale: options.locale,
-            screenshotsOnly: options.screenshotsOnly,
-            listingsOnly: options.listingsOnly,
-            verbose: options.verbose,
-        }, config);
-        if (result.status === 'success') {
-            logSuccess('App store generation completed successfully!');
-            const listingLocales = Object.keys(result.listings);
-            if (listingLocales.length > 0) {
-                logInfo(`\nListings generated for: ${listingLocales.join(', ')}`);
-                for (const locale of listingLocales) {
-                    const listing = result.listings[locale];
-                    logInfo(`  [${locale}] ${listing.app_name} - ${listing.subtitle || listing.short_description || ''}`);
-                }
-            }
-            const allScreenshots = Object.values(result.screenshots).flat();
-            if (allScreenshots.length > 0) {
-                logInfo(`\nScreenshots: ${allScreenshots.length} generated (${Object.keys(result.screenshots).join(', ')})`);
-                const byDevice = new Map();
-                for (const ss of allScreenshots) {
-                    byDevice.set(ss.device_type, (byDevice.get(ss.device_type) || 0) + 1);
-                }
-                for (const [device, count] of byDevice) {
-                    logInfo(`  ${device}: ${count} screenshots`);
-                }
-            }
-            logInfo('\nView and edit results in the App Store tab of your product dashboard.');
-        }
-        else {
-            logError(`App store generation failed: ${result.summary}`);
-            process.exitCode = 1;
-        }
-    }
-    catch (error) {
-        logError(`App store generation failed: ${error instanceof Error ? error.message : String(error)}`);
-        process.exitCode = 1;
-    }
-    finally {
-        await deregisterSession();
-    }
-};

package/dist/commands/architecture-diagram/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * CLI command: edsger architecture-diagram <productId> --diagram-id <id>
- * Maps a component/dependency diagram into the diagrams tables
- * (type='architecture').
- */
-import { type DiagramCommandOptions } from '../diagram-shared/index.js';
-export type ArchitectureDiagramCliOptions = DiagramCommandOptions;
-export declare function runArchitectureDiagram(productId: string | undefined, options: ArchitectureDiagramCliOptions): Promise<void>;

package/dist/commands/architecture-diagram/index.js

@@ -1,10 +0,0 @@
-/**
- * CLI command: edsger architecture-diagram <productId> --diagram-id <id>
- * Maps a component/dependency diagram into the diagrams tables
- * (type='architecture').
- */
-import { runArchitectureDiagramPhase } from '../../phases/architecture-diagram/index.js';
-import { runDiagramCommand, } from '../diagram-shared/index.js';
-export function runArchitectureDiagram(productId, options) {
-    return runDiagramCommand('architecture-diagram', productId, options, runArchitectureDiagramPhase);
-}

package/dist/commands/build/detect-project.d.ts

@@ -1,52 +0,0 @@
-/**
- * AI-powered build plan generation.
- *
- * Separation of concerns:
- *   AI  → analyzes repo structure + product context → outputs a BuildPlan (JSON)
- *   Code → executes the plan deterministically (install deps, find scheme)
- *
- * The AI never executes commands. It only reads the directory tree we give it.
- */
-/** A shell command the build runner should execute. */
-export interface InstallStep {
-    cmd: string;
-    args: string[];
-    /** Working directory relative to repo root. Empty string = repo root. */
-    cwd: string;
-}
-/** The AI's analysis of how to build this repo. */
-export interface BuildPlan {
-    /** Detected project framework */
-    projectType: 'react-native' | 'flutter' | 'expo' | 'native' | 'xcodegen' | 'tuist' | 'spm' | 'other';
-    /** Ordered list of commands to install dependencies / generate projects */
-    installSteps: InstallStep[];
-    /** Expected Xcode project path (relative to repo root) after deps are installed */
-    projectPath: string;
-    /** Hint for the scheme name (may be empty — code will discover via xcodebuild -list) */
-    schemeHint: string;
-    /** Why the AI made these decisions */
-    reasoning: string;
-}
-export interface AnalyzeParams {
-    /** Absolute path to the cloned repository */
-    repoPath: string;
-    /** Product name from the database */
-    productName: string;
-    /** Product description from the database */
-    productDescription?: string;
-}
-/** Injectable for testing */
-export type AnalyzeBuildPlanFn = (params: AnalyzeParams) => Promise<BuildPlan | null>;
-/**
- * Build a concise directory tree string for the repository.
- * Only goes `maxDepth` levels deep and skips vendored directories.
- */
-export declare function buildDirectoryTree(rootDir: string, maxDepth?: number): string;
-/** Validate that the AI only proposed safe, expected commands. */
-export declare function validateInstallSteps(steps: InstallStep[]): InstallStep[];
-export declare function parseBuildPlan(response: string): BuildPlan | null;
-/**
- * Ask AI to analyze the repo and produce a build plan.
- * The AI sees only the directory tree — it cannot execute commands.
- */
-export declare function analyzeBuildPlan(params: AnalyzeParams): Promise<BuildPlan | null>;

package/dist/commands/build/detect-project.js

@@ -1,277 +0,0 @@
-/**
- * AI-powered build plan generation.
- *
- * Separation of concerns:
- *   AI  → analyzes repo structure + product context → outputs a BuildPlan (JSON)
- *   Code → executes the plan deterministically (install deps, find scheme)
- *
- * The AI never executes commands. It only reads the directory tree we give it.
- */
-import { query } from '@anthropic-ai/claude-agent-sdk';
-import { readdirSync, statSync } from 'fs';
-import { join } from 'path';
-import { DEFAULT_MODEL } from '../../constants.js';
-import { logInfo, logWarning } from '../../utils/logger.js';
-// ── Directory tree helper ──────────────────────────────────────────
-const SKIP_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'Pods',
-    'DerivedData',
-    'build',
-    '.build',
-    'Carthage',
-    '.next',
-    '.expo',
-]);
-/**
- * Build a concise directory tree string for the repository.
- * Only goes `maxDepth` levels deep and skips vendored directories.
- */
-export function buildDirectoryTree(rootDir, maxDepth = 3) {
-    const lines = [];
-    function walk(dir, prefix, depth) {
-        if (depth > maxDepth)
-            return;
-        let entries;
-        try {
-            entries = readdirSync(dir).sort();
-        }
-        catch {
-            return;
-        }
-        const filtered = entries.filter((e) => {
-            if (SKIP_DIRS.has(e))
-                return false;
-            if (depth > 0 &&
-                e.startsWith('.') &&
-                !e.endsWith('.xcworkspace') &&
-                !e.endsWith('.xcodeproj'))
-                return false;
-            return true;
-        });
-        for (let i = 0; i < filtered.length; i++) {
-            const entry = filtered[i];
-            const fullPath = join(dir, entry);
-            const isLast = i === filtered.length - 1;
-            const connector = isLast ? '└── ' : '├── ';
-            const childPrefix = isLast ? '    ' : '│   ';
-            let isDir = false;
-            try {
-                isDir = statSync(fullPath).isDirectory();
-            }
-            catch {
-                continue;
-            }
-            lines.push(`${prefix}${connector}${entry}${isDir ? '/' : ''}`);
-            if (isDir) {
-                walk(fullPath, prefix + childPrefix, depth + 1);
-            }
-        }
-    }
-    walk(rootDir, '', 0);
-    return lines.join('\n');
-}
-// ── Allowed commands whitelist ─────────────────────────────────────
-const ALLOWED_COMMANDS = new Set([
-    'npm',
-    'yarn',
-    'pnpm',
-    'bun',
-    'pod',
-    'flutter',
-    'xcodegen',
-    'tuist',
-    'swift',
-    'bundle', // ruby bundler (for `bundle exec pod install`)
-]);
-/** Validate that the AI only proposed safe, expected commands. */
-export function validateInstallSteps(steps) {
-    return steps.filter((step) => {
-        if (!ALLOWED_COMMANDS.has(step.cmd)) {
-            logWarning(`Skipping disallowed command: ${step.cmd}`);
-            return false;
-        }
-        return true;
-    });
-}
-// ── Response parser ────────────────────────────────────────────────
-function extractTextFromContent(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-content) {
-    let text = '';
-    for (const item of content) {
-        if (item.type === 'text') {
-            text += item.text;
-        }
-    }
-    return text;
-}
-export function parseBuildPlan(response) {
-    try {
-        const jsonMatch = response.match(/```json\s*\n([\s\S]*?)\n\s*```/);
-        const jsonStr = jsonMatch ? jsonMatch[1] : response;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        let parsed;
-        try {
-            parsed = JSON.parse(jsonStr);
-        }
-        catch {
-            const objMatch = jsonStr.match(/\{[\s\S]*"project_path"[\s\S]*"project_type"[\s\S]*\}/);
-            if (objMatch) {
-                parsed = JSON.parse(objMatch[0]);
-            }
-            else {
-                throw new Error('No valid JSON found');
-            }
-        }
-        const plan = parsed.build_plan || parsed;
-        const projectPath = String(plan.project_path || '');
-        if (!projectPath)
-            return null;
-        const installSteps = Array.isArray(plan.install_steps)
-            ? plan.install_steps.map(
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            (s) => ({
-                cmd: String(s.cmd || ''),
-                args: Array.isArray(s.args) ? s.args.map(String) : [],
-                cwd: String(s.cwd || ''),
-            }))
-            : [];
-        return {
-            projectType: plan.project_type || 'other',
-            installSteps: validateInstallSteps(installSteps),
-            projectPath,
-            schemeHint: String(plan.scheme_hint || ''),
-            reasoning: String(plan.reasoning || ''),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-// ── System prompt ──────────────────────────────────────────────────
-const SYSTEM_PROMPT = `You are an expert iOS/macOS build engineer. You are given a repository directory tree and product context. Your ONLY job is to analyze the structure and output a build plan as JSON.
-
-You must NOT execute any commands. You only analyze the directory tree provided and return a plan.
-
-Determine:
-1. **project_type**: What kind of project is this?
-   - "react-native": has package.json with react-native dependency, ios/ directory
-   - "expo": has package.json with expo, app.json/app.config.js
-   - "flutter": has pubspec.yaml, ios/ directory
-   - "xcodegen": has project.yml (XcodeGen config)
-   - "tuist": has Project.swift or Tuist/ directory
-   - "spm": has Package.swift, no .xcodeproj
-   - "native": has .xcodeproj or .xcworkspace already committed
-   - "other": none of the above
-
-2. **install_steps**: Ordered commands needed before building. Each step has:
-   - "cmd": the executable (npm, yarn, pnpm, bun, pod, flutter, xcodegen, tuist, swift, bundle)
-   - "args": array of arguments
-   - "cwd": working directory relative to repo root ("" for repo root, "ios" for ios/ subdirectory)
-
-   Common patterns:
-   - React Native: [npm ci] then [pod install in ios/]
-   - React Native with yarn.lock: [yarn install --frozen-lockfile] then [pod install in ios/]
-   - Flutter: [flutter pub get] then [pod install in ios/]
-   - xcodegen: [xcodegen generate]
-   - tuist: [tuist generate]
-   - Native with Podfile: [pod install in directory containing Podfile]
-   - Native with Gemfile: [bundle install] then [bundle exec pod install]
-   - Native without deps: [] (empty)
-
-3. **project_path**: The Xcode project to build (relative to repo root).
-   - After pod install, prefer .xcworkspace over .xcodeproj
-   - For React Native: typically "ios/<AppName>.xcworkspace"
-   - For native: wherever the .xcworkspace/.xcodeproj is
-
-4. **scheme_hint**: Best guess for the scheme name. Often matches the app name.
-   Leave empty "" if unsure — the build system will discover it via xcodebuild -list.
-
-5. **reasoning**: Brief explanation of your analysis.
-
-In monorepos with multiple apps, use the product name/description to pick the right one.
-
-Respond with ONLY a JSON block, no other text:`;
-// ── Main AI call ───────────────────────────────────────────────────
-/**
- * Ask AI to analyze the repo and produce a build plan.
- * The AI sees only the directory tree — it cannot execute commands.
- */
-export async function analyzeBuildPlan(params) {
-    const { repoPath, productName, productDescription } = params;
-    const tree = buildDirectoryTree(repoPath);
-    const prompt = `Analyze this repository and produce a build plan.
-
-**Product name:** ${productName}
-**Product description:** ${productDescription || 'N/A'}
-
-**Repository structure:**
-\`\`\`
-${tree}
-\`\`\`
-
-\`\`\`json
-{
-  "build_plan": {
-    "project_type": "<react-native|flutter|expo|native|xcodegen|tuist|spm|other>",
-    "install_steps": [
-      { "cmd": "<executable>", "args": ["<arg1>", "<arg2>"], "cwd": "<relative dir or empty>" }
-    ],
-    "project_path": "<relative path to .xcworkspace or .xcodeproj>",
-    "scheme_hint": "<scheme name or empty>",
-    "reasoning": "<brief explanation>"
-  }
-}
-\`\`\``;
-    logInfo('Analyzing repository with AI...');
-    let resultText = '';
-    try {
-        for await (const message of query({
-            prompt,
-            options: {
-                systemPrompt: SYSTEM_PROMPT,
-                model: DEFAULT_MODEL,
-                maxTurns: 1,
-            },
-        })) {
-            if (message.type === 'assistant') {
-                resultText += extractTextFromContent(message.message?.content ?? []);
-                continue;
-            }
-            if (message.type === 'result') {
-                if (message.subtype === 'success' && message.result) {
-                    resultText = message.result;
-                }
-            }
-        }
-        const plan = parseBuildPlan(resultText);
-        if (plan) {
-            logInfo(`AI analysis complete:`);
-            logInfo(`  Type:    ${plan.projectType}`);
-            logInfo(`  Project: ${plan.projectPath}`);
-            if (plan.schemeHint) {
-                logInfo(`  Scheme:  ${plan.schemeHint}`);
-            }
-            if (plan.installSteps.length > 0) {
-                logInfo(`  Install steps:`);
-                for (const step of plan.installSteps) {
-                    const cwdSuffix = step.cwd ? ` (in ${step.cwd}/)` : '';
-                    logInfo(`    - ${step.cmd} ${step.args.join(' ')}${cwdSuffix}`);
-                }
-            }
-            if (plan.reasoning) {
-                logInfo(`  Reasoning: ${plan.reasoning}`);
-            }
-        }
-        else {
-            logWarning('AI did not return a valid build plan');
-        }
-        return plan;
-    }
-    catch (error) {
-        logWarning(`AI analysis failed: ${error instanceof Error ? error.message : String(error)}`);
-        return null;
-    }
-}

package/dist/commands/build/index.d.ts

@@ -1,66 +0,0 @@
-import { type AppStoreConfig, type BuildConfig } from '../../api/app-store.js';
-import { type ProductInfo } from '../../api/products.js';
-import { type CliOptions } from '../../types/index.js';
-import { type AnalyzeBuildPlanFn } from './detect-project.js';
-export interface BuildOptions extends CliOptions {
-    buildProductId: string;
-    scheme?: string;
-    project?: string;
-    configuration?: string;
-    platform?: string;
-    upload?: boolean;
-    reselect?: boolean;
-    skipArchive?: boolean;
-    ipa?: string;
-}
-export interface XcodeProject {
-    path: string;
-    type: 'workspace' | 'project';
-}
-export type Platform = 'ios' | 'macos';
-/**
- * Injectable dependencies for runBuild — enables unit testing
- * without real MCP, GitHub, git, or xcodebuild calls.
- */
-export interface BuildDeps {
-    fetchConfigs: (productId: string, verbose?: boolean) => Promise<AppStoreConfig[]>;
-    fetchProduct: (productId: string, verbose?: boolean) => Promise<ProductInfo>;
-    fetchGitHub: (productId: string, verbose?: boolean) => Promise<{
-        configured: boolean;
-        token?: string;
-        owner?: string;
-        repo?: string;
-        message?: string;
-    }>;
-    cloneRepo: (workspaceRoot: string, dirName: string, owner: string, repo: string, token: string) => {
-        repoPath: string;
-    };
-    getWorkspaceRoot: () => string;
-    saveBuildConfig: (configId: string, buildConfig: BuildConfig, verbose?: boolean) => Promise<AppStoreConfig | null>;
-    checkoutDefaultBranch: (repoPath: string) => void;
-    /** AI analysis: read repo structure → output a BuildPlan (no execution) */
-    analyzeBuildPlan: AnalyzeBuildPlanFn;
-    /** Scan for .xcworkspace / .xcodeproj files */
-    findProjects: (rootDir: string) => XcodeProject[];
-    /** Manual fallback: run xcodebuild -list to discover schemes */
-    findSchemes: (repoPath: string, projectPath: string, projectType: 'workspace' | 'project') => string[];
-    runCommand: (cmd: string, args: string[], opts?: {
-        cwd?: string;
-        env?: NodeJS.ProcessEnv;
-        timeout?: number;
-    }) => Promise<void>;
-    isXcodeAvailable: () => boolean;
-}
-/** Default (real) implementations of all dependencies. */
-export declare function createDefaultDeps(): BuildDeps;
-export declare function findXcodeProjects(rootDir: string): XcodeProject[];
-export declare function discoverSchemes(repoPath: string, projectPath: string, projectType: 'workspace' | 'project'): string[];
-export declare function generateExportOptionsPlist(teamId: string, exportMethod: string): string;
-export declare function writeApiKeyFile(keyId: string, privateKey: string): string;
-export declare function cleanupApiKeyFile(keyId: string): void;
-export declare function destinationForPlatform(platform: Platform): string;
-/**
- * Run the full build pipeline. Accepts an optional `deps` parameter
- * for dependency injection in tests; falls back to real implementations.
- */
-export declare function runBuild(options: BuildOptions, deps?: BuildDeps): Promise<void>;