@phenixstar/talon 1.0.0

package/dist/cli/dependency-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.d.ts","sourceRoot":"","sources":["../../src/cli/dependency-checker.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;AAW9C,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvD;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU1E;AAwFD,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAgBhD;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAYtE;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,IAAI,OAAO,CAGvC;AAED,sCAAsC;AACtC,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/cli/dependency-checker.js

@@ -0,0 +1,165 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+import { execSync } from 'node:child_process';
+import os from 'node:os';
+import fs from 'node:fs';
+/** Run a command silently and return stdout, or null on failure */
+function execSilent(cmd) {
+    try {
+        return execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10_000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse a version string like "v22.11.0" or "Docker version 27.5.1, build abc" into semver parts */
+export function parseVersion(raw) {
+    const match = raw.match(/(\d+\.\d+(?:\.\d+)?)/);
+    return match ? match[1] : null;
+}
+/** Compare two semver strings: returns true if actual >= required */
+export function versionSatisfies(actual, required) {
+    const aParts = actual.split('.').map(Number);
+    const rParts = required.split('.').map(Number);
+    for (let i = 0; i < Math.max(aParts.length, rParts.length); i++) {
+        const a = aParts[i] ?? 0;
+        const r = rParts[i] ?? 0;
+        if (a > r)
+            return true;
+        if (a < r)
+            return false;
+    }
+    return true;
+}
+function getInstallHint(dep) {
+    const platform = os.platform();
+    const hints = {
+        docker: {
+            linux: 'sudo apt install docker.io  OR  https://docs.docker.com/engine/install/',
+            darwin: 'brew install --cask docker  OR  https://docker.com/products/docker-desktop',
+            win32: 'winget install Docker.DockerDesktop  OR  https://docker.com/products/docker-desktop',
+        },
+        'docker-compose': {
+            linux: 'Docker Compose v2 is included with Docker Engine 20.10+',
+            darwin: 'Included with Docker Desktop',
+            win32: 'Included with Docker Desktop',
+        },
+        node: {
+            linux: 'curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install nodejs',
+            darwin: 'brew install node@22  OR  https://nodejs.org/en/download',
+            win32: 'winget install OpenJS.NodeJS.LTS  OR  https://nodejs.org/en/download',
+        },
+        git: {
+            linux: 'sudo apt install git',
+            darwin: 'brew install git  OR  xcode-select --install',
+            win32: 'winget install Git.Git',
+        },
+    };
+    const depHints = hints[dep];
+    if (!depHints)
+        return `Install ${dep} manually`;
+    return depHints[platform] ?? depHints['linux'] ?? `Install ${dep} manually`;
+}
+function checkDocker() {
+    const raw = execSilent('docker --version');
+    const version = raw ? parseVersion(raw) : null;
+    return {
+        name: 'Docker',
+        required: true,
+        installed: version !== null,
+        version,
+        minVersion: '20.10',
+        versionOk: version !== null && versionSatisfies(version, '20.10'),
+        installHint: getInstallHint('docker'),
+    };
+}
+function checkDockerCompose() {
+    const raw = execSilent('docker compose version');
+    const version = raw ? parseVersion(raw) : null;
+    return {
+        name: 'Docker Compose',
+        required: true,
+        installed: version !== null,
+        version,
+        minVersion: '2.0',
+        versionOk: version !== null && versionSatisfies(version, '2.0'),
+        installHint: getInstallHint('docker-compose'),
+    };
+}
+function checkNode() {
+    const raw = execSilent('node --version');
+    const version = raw ? parseVersion(raw) : null;
+    return {
+        name: 'Node.js',
+        required: true,
+        installed: version !== null,
+        version,
+        minVersion: '22.0',
+        versionOk: version !== null && versionSatisfies(version, '22.0'),
+        installHint: getInstallHint('node'),
+    };
+}
+function checkGit() {
+    const raw = execSilent('git --version');
+    const version = raw ? parseVersion(raw) : null;
+    return {
+        name: 'git',
+        required: true,
+        installed: version !== null,
+        version,
+        minVersion: '2.0',
+        versionOk: version !== null && versionSatisfies(version, '2.0'),
+        installHint: getInstallHint('git'),
+    };
+}
+/** Check if Docker daemon is running (not just installed) */
+export function isDockerRunning() {
+    return execSilent('docker info') !== null;
+}
+/** Check available disk space in GB */
+export function checkDiskSpaceGb() {
+    const platform = os.platform();
+    if (platform === 'win32') {
+        const raw = execSilent('wmic logicaldisk where "DeviceID=\'C:\'" get FreeSpace /value');
+        if (!raw)
+            return null;
+        const match = raw.match(/FreeSpace=(\d+)/);
+        if (!match)
+            return null;
+        return Math.floor(Number(match[1]) / (1024 * 1024 * 1024));
+    }
+    const raw = execSilent('df -BG . 2>/dev/null | tail -1');
+    if (!raw)
+        return null;
+    const parts = raw.split(/\s+/);
+    const avail = parts[3];
+    if (!avail)
+        return null;
+    return parseInt(avail.replace('G', ''), 10);
+}
+/** Run all dependency checks for the given run mode */
+export function checkAllDependencies(mode) {
+    if (mode === 'docker') {
+        return [checkDocker(), checkDockerCompose(), checkGit()];
+    }
+    // Bare-metal mode needs Node.js + git, Docker optional
+    const docker = checkDocker();
+    return [
+        { ...docker, required: false },
+        checkNode(),
+        checkGit(),
+    ];
+}
+/** Detect recommended run mode based on available tools */
+export function detectRunMode() {
+    const dockerAvailable = execSilent('docker --version') !== null;
+    return dockerAvailable ? 'docker' : 'bare-metal';
+}
+/** Check if repos directory exists */
+export function hasReposDir() {
+    return fs.existsSync('repos') && fs.statSync('repos').isDirectory();
+}
+//# sourceMappingURL=dependency-checker.js.map

package/dist/cli/dependency-checker.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":""}

package/dist/cli/doctor.js

@@ -0,0 +1,127 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+/**
+ * Talon Doctor — Post-setup validation.
+ *
+ * Checks dependencies, .env configuration, Docker status,
+ * and disk space. Reports all results with clear status indicators.
+ * Invoked via `./talon doctor`.
+ */
+import chalk from 'chalk';
+import fs from 'node:fs';
+import { execSync } from 'node:child_process';
+import { showBanner, showDependencyTable } from './setup-renderer.js';
+import { readEnvFile } from './env-configurator.js';
+import { checkAllDependencies, isDockerRunning, checkDiskSpaceGb } from './dependency-checker.js';
+function checkEnvFile() {
+    if (!fs.existsSync('.env')) {
+        return { name: '.env file', ok: false, message: 'Not found — run ./talon setup' };
+    }
+    const env = readEnvFile('.env');
+    if (env.size === 0) {
+        return { name: '.env file', ok: false, message: 'Empty — run ./talon setup' };
+    }
+    const hasAuth = env.has('ANTHROPIC_API_KEY')
+        || env.has('CLAUDE_CODE_OAUTH_TOKEN')
+        || env.get('CLAUDE_CODE_USE_BEDROCK') === '1'
+        || env.get('CLAUDE_CODE_USE_VERTEX') === '1'
+        || env.get('ROUTER') === 'true';
+    if (!hasAuth) {
+        return { name: '.env file', ok: false, message: 'No auth credentials configured — run ./talon setup' };
+    }
+    return { name: '.env file', ok: true, message: `${env.size} variables configured` };
+}
+function checkDockerDaemon() {
+    if (!isDockerRunning()) {
+        return { name: 'Docker daemon', ok: false, message: 'Not running — start with: sudo systemctl start docker' };
+    }
+    return { name: 'Docker daemon', ok: true, message: 'Running' };
+}
+function checkDockerImages() {
+    try {
+        const output = execSync('docker compose images 2>/dev/null', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 10_000,
+        });
+        const lines = output.trim().split('\n').filter(l => l.trim().length > 0);
+        // First line is header
+        const imageCount = Math.max(0, lines.length - 1);
+        if (imageCount === 0) {
+            return { name: 'Docker images', ok: false, message: 'Not built — will build on first ./talon start' };
+        }
+        return { name: 'Docker images', ok: true, message: `${imageCount} images built` };
+    }
+    catch {
+        return { name: 'Docker images', ok: false, message: 'Not built — will build on first ./talon start' };
+    }
+}
+function checkReposDir() {
+    if (!fs.existsSync('repos')) {
+        return { name: 'repos/ directory', ok: false, message: 'Not found — create it and clone a target repo' };
+    }
+    try {
+        const entries = fs.readdirSync('repos').filter(e => {
+            const stat = fs.statSync(`repos/${e}`);
+            return stat.isDirectory();
+        });
+        if (entries.length === 0) {
+            return { name: 'repos/ directory', ok: false, message: 'Empty — clone a target repo into repos/' };
+        }
+        return { name: 'repos/ directory', ok: true, message: `${entries.length} repo(s): ${entries.join(', ')}` };
+    }
+    catch {
+        return { name: 'repos/ directory', ok: false, message: 'Cannot read — check permissions' };
+    }
+}
+function checkDiskSpace() {
+    const gb = checkDiskSpaceGb();
+    if (gb === null) {
+        return { name: 'Disk space', ok: true, message: 'Could not determine (skipped)' };
+    }
+    if (gb < 10) {
+        return { name: 'Disk space', ok: false, message: `${gb}GB available (10GB recommended)` };
+    }
+    return { name: 'Disk space', ok: true, message: `${gb}GB available` };
+}
+function main() {
+    showBanner();
+    console.log(chalk.bold('  Running diagnostics...\n'));
+    // 1. Dependency check
+    const deps = checkAllDependencies('docker');
+    showDependencyTable(deps);
+    // 2. System checks
+    const checks = [
+        checkEnvFile(),
+        checkDockerDaemon(),
+        checkDockerImages(),
+        checkReposDir(),
+        checkDiskSpace(),
+    ];
+    console.log(chalk.bold('  System Checks:\n'));
+    let hasFailure = false;
+    for (const check of checks) {
+        const icon = check.ok ? chalk.green('✓') : chalk.red('✗');
+        const msg = check.ok ? check.message : chalk.red(check.message);
+        console.log(`  ${icon} ${check.name}: ${msg}`);
+        if (!check.ok)
+            hasFailure = true;
+    }
+    // 3. Summary
+    const depFailures = deps.filter(d => d.required && (!d.installed || !d.versionOk));
+    const totalIssues = depFailures.length + checks.filter(c => !c.ok).length;
+    console.log();
+    if (totalIssues === 0) {
+        console.log(chalk.green('  All checks passed. Ready to run:\n'));
+        console.log(chalk.cyan('    ./talon start URL=<url> REPO=<name>\n'));
+    }
+    else {
+        console.log(chalk.yellow(`  ${totalIssues} issue(s) found. Fix them and run ./talon doctor again.\n`));
+    }
+    process.exit(hasFailure || depFailures.length > 0 ? 1 : 0);
+}
+main();
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/env-configurator.d.ts

@@ -0,0 +1,27 @@
+export interface EnvEntry {
+    key: string;
+    value: string;
+}
+interface ParsedLine {
+    type: 'entry' | 'comment' | 'blank';
+    raw: string;
+    key?: string;
+    value?: string;
+}
+/** Parse a .env file into structured lines, preserving comments and blanks */
+export declare function parseEnvFile(content: string): ParsedLine[];
+/** Read an existing .env file into a key-value map */
+export declare function readEnvFile(envPath: string): Map<string, string>;
+/** Merge new values into existing, preserving user-set values not in newValues */
+export declare function mergeEnv(existing: Map<string, string>, newValues: readonly EnvEntry[]): Map<string, string>;
+/** Backup existing .env to .env.backup.<timestamp> */
+export declare function backupEnvFile(envPath: string): string | null;
+/** Write a Map of env vars to a .env file with section headers */
+export declare function writeEnvFile(envPath: string, values: Map<string, string>): void;
+export type AuthMode = 'api-key' | 'oauth' | 'bedrock' | 'vertex' | 'router';
+/** Get required env keys for a given auth mode */
+export declare function getRequiredKeys(mode: AuthMode): string[];
+/** Validate that all required keys for the auth mode are present and non-empty */
+export declare function validateEnv(values: Map<string, string>, mode: AuthMode): string[];
+export {};
+//# sourceMappingURL=env-configurator.d.ts.map

package/dist/cli/env-configurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-configurator.d.ts","sourceRoot":"","sources":["../../src/cli/env-configurator.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAa1D;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWhE;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrB;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAyC/E;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7E,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAQxD;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CASjF"}

package/dist/cli/env-configurator.js

@@ -0,0 +1,115 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+import fs from 'node:fs';
+import path from 'node:path';
+/** Parse a .env file into structured lines, preserving comments and blanks */
+export function parseEnvFile(content) {
+    return content.split('\n').map(raw => {
+        const trimmed = raw.trim();
+        if (trimmed === '')
+            return { type: 'blank', raw };
+        if (trimmed.startsWith('#'))
+            return { type: 'comment', raw };
+        const match = trimmed.match(/^([^=]+?)=(.*)$/);
+        if (!match)
+            return { type: 'comment', raw };
+        const key = match[1].trim();
+        const value = match[2].trim().replace(/^["']|["']$/g, '');
+        return { type: 'entry', raw, key, value };
+    });
+}
+/** Read an existing .env file into a key-value map */
+export function readEnvFile(envPath) {
+    const map = new Map();
+    if (!fs.existsSync(envPath))
+        return map;
+    const content = fs.readFileSync(envPath, 'utf-8');
+    for (const line of parseEnvFile(content)) {
+        if (line.type === 'entry' && line.key && line.value !== undefined) {
+            map.set(line.key, line.value);
+        }
+    }
+    return map;
+}
+/** Merge new values into existing, preserving user-set values not in newValues */
+export function mergeEnv(existing, newValues) {
+    const merged = new Map(existing);
+    for (const { key, value } of newValues) {
+        merged.set(key, value);
+    }
+    return merged;
+}
+/** Backup existing .env to .env.backup.<timestamp> */
+export function backupEnvFile(envPath) {
+    if (!fs.existsSync(envPath))
+        return null;
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const backupPath = `${envPath}.backup.${timestamp}`;
+    fs.copyFileSync(envPath, backupPath);
+    return backupPath;
+}
+/** Write a Map of env vars to a .env file with section headers */
+export function writeEnvFile(envPath, values) {
+    // Group keys by section
+    const sections = [
+        { header: 'Authentication', keys: ['ANTHROPIC_API_KEY', 'CLAUDE_CODE_OAUTH_TOKEN'] },
+        { header: 'AWS Bedrock', keys: ['CLAUDE_CODE_USE_BEDROCK', 'AWS_REGION', 'AWS_BEARER_TOKEN_BEDROCK'] },
+        { header: 'Google Vertex AI', keys: ['CLAUDE_CODE_USE_VERTEX', 'CLOUD_ML_REGION', 'ANTHROPIC_VERTEX_PROJECT_ID', 'GOOGLE_APPLICATION_CREDENTIALS'] },
+        { header: 'Model Configuration', keys: ['ANTHROPIC_SMALL_MODEL', 'ANTHROPIC_MEDIUM_MODEL', 'ANTHROPIC_LARGE_MODEL'] },
+        { header: 'Router', keys: ['ROUTER', 'TALON_ROUTER_KEY', 'ANTHROPIC_BASE_URL', 'ANTHROPIC_AUTH_TOKEN', 'ROUTER_DEFAULT'] },
+        { header: 'Provider API Keys', keys: ['OPENAI_API_KEY', 'OPENROUTER_API_KEY', 'GROQ_API_KEY', 'XAI_API_KEY', 'KIMI_API_KEY', 'MINIMAX_HIGHSPEED_API_KEY', 'ZAI_CODING_PLAN_API_KEY'] },
+        { header: 'Runtime', keys: ['CLAUDE_CODE_MAX_OUTPUT_TOKENS', 'TALON_MAX_TURNS', 'TALON_PERMISSION_MODE', 'PIPELINE_TESTING'] },
+    ];
+    const written = new Set();
+    const lines = ['# Talon Configuration', `# Generated by ./talon setup on ${new Date().toISOString().slice(0, 10)}`, ''];
+    for (const section of sections) {
+        const sectionEntries = section.keys.filter(k => values.has(k));
+        if (sectionEntries.length === 0)
+            continue;
+        lines.push(`# ${section.header}`);
+        for (const key of sectionEntries) {
+            const val = values.get(key);
+            lines.push(`${key}=${val}`);
+            written.add(key);
+        }
+        lines.push('');
+    }
+    // Write any remaining keys not in known sections
+    const remaining = [...values.entries()].filter(([k]) => !written.has(k));
+    if (remaining.length > 0) {
+        lines.push('# Other');
+        for (const [key, val] of remaining) {
+            lines.push(`${key}=${val}`);
+        }
+        lines.push('');
+    }
+    const dir = path.dirname(envPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(envPath, lines.join('\n'), 'utf-8');
+}
+/** Get required env keys for a given auth mode */
+export function getRequiredKeys(mode) {
+    switch (mode) {
+        case 'api-key': return ['ANTHROPIC_API_KEY'];
+        case 'oauth': return ['CLAUDE_CODE_OAUTH_TOKEN'];
+        case 'bedrock': return ['CLAUDE_CODE_USE_BEDROCK', 'AWS_REGION', 'AWS_BEARER_TOKEN_BEDROCK', 'ANTHROPIC_SMALL_MODEL', 'ANTHROPIC_MEDIUM_MODEL', 'ANTHROPIC_LARGE_MODEL'];
+        case 'vertex': return ['CLAUDE_CODE_USE_VERTEX', 'CLOUD_ML_REGION', 'ANTHROPIC_VERTEX_PROJECT_ID', 'GOOGLE_APPLICATION_CREDENTIALS', 'ANTHROPIC_SMALL_MODEL', 'ANTHROPIC_MEDIUM_MODEL', 'ANTHROPIC_LARGE_MODEL'];
+        case 'router': return ['ROUTER'];
+    }
+}
+/** Validate that all required keys for the auth mode are present and non-empty */
+export function validateEnv(values, mode) {
+    const missing = [];
+    for (const key of getRequiredKeys(mode)) {
+        const val = values.get(key);
+        if (!val || val.trim() === '') {
+            missing.push(key);
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=env-configurator.js.map

package/dist/cli/env-configurator.js.map

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

package/dist/cli/setup-renderer.d.ts

@@ -0,0 +1,23 @@
+export declare function showBanner(): void;
+export interface SummaryConfig {
+    authMode: string;
+    envPath: string;
+    runMode: string;
+    values: Array<{
+        key: string;
+        value: string;
+        masked?: boolean;
+    }>;
+}
+export declare function showSummary(config: SummaryConfig): void;
+export declare function showSuccess(envPath: string): void;
+export declare function showError(message: string): void;
+export interface DepStatus {
+    name: string;
+    installed: boolean;
+    version: string | null;
+    versionOk: boolean;
+    required: boolean;
+}
+export declare function showDependencyTable(deps: readonly DepStatus[]): void;
+//# sourceMappingURL=setup-renderer.d.ts.map

package/dist/cli/setup-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-renderer.d.ts","sourceRoot":"","sources":["../../src/cli/setup-renderer.ts"],"names":[],"mappings":"AAaA,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAkBvD;AAOD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CASjD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAqBpE"}

package/dist/cli/setup-renderer.js

@@ -0,0 +1,71 @@
+// Copyright (C) 2025 PhenixStar (Alaa Qweider)
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License version 3
+// as published by the Free Software Foundation.
+import chalk from 'chalk';
+import boxen from 'boxen';
+import gradient from 'gradient-string';
+import figlet from 'figlet';
+const TALON_GRADIENT = gradient(['#ff6b6b', '#feca57', '#48dbfb']);
+export function showBanner() {
+    const ascii = figlet.textSync('TALON', { font: 'ANSI Shadow' });
+    console.log(TALON_GRADIENT(ascii));
+    console.log(chalk.dim('  AI Penetration Testing Framework — Setup Wizard\n'));
+}
+export function showSummary(config) {
+    const lines = [
+        `${chalk.bold('Auth Mode:')} ${config.authMode}`,
+        `${chalk.bold('Run Mode:')}  ${config.runMode}`,
+        '',
+        chalk.bold('Environment Variables:'),
+        ...config.values.map(({ key, value, masked }) => {
+            const display = masked ? maskValue(value) : value;
+            return `  ${chalk.cyan(key)}=${display}`;
+        }),
+    ];
+    console.log(boxen(lines.join('\n'), {
+        title: 'Configuration Summary',
+        padding: 1,
+        borderColor: 'cyan',
+        borderStyle: 'round',
+    }));
+}
+function maskValue(value) {
+    if (value.length <= 8)
+        return '••••••••';
+    return value.slice(0, 4) + '••••' + value.slice(-4);
+}
+export function showSuccess(envPath) {
+    console.log();
+    console.log(chalk.green('  ✓ Configuration saved to ') + chalk.bold(envPath));
+    console.log();
+    console.log(chalk.bold('  Next steps:'));
+    console.log(chalk.dim('  1.') + ' Clone a target repo:  ' + chalk.cyan('git clone <url> ./repos/<name>'));
+    console.log(chalk.dim('  2.') + ' Run a pentest:       ' + chalk.cyan('./talon start URL=<url> REPO=<name>'));
+    console.log(chalk.dim('  3.') + ' Monitor progress:    ' + chalk.cyan('http://localhost:8233'));
+    console.log();
+}
+export function showError(message) {
+    console.error(chalk.red(`\n  ✗ ${message}\n`));
+}
+export function showDependencyTable(deps) {
+    console.log(chalk.bold('\n  Dependency Check:\n'));
+    for (const dep of deps) {
+        const icon = dep.installed && dep.versionOk
+            ? chalk.green('✓')
+            : dep.required
+                ? chalk.red('✗')
+                : chalk.yellow('⚠');
+        const version = dep.version ? chalk.dim(` (${dep.version})`) : '';
+        const status = !dep.installed
+            ? chalk.dim(' — not found')
+            : !dep.versionOk
+                ? chalk.yellow(' — version too old')
+                : '';
+        const req = dep.required ? '' : chalk.dim(' [optional]');
+        console.log(`  ${icon} ${dep.name}${version}${status}${req}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=setup-renderer.js.map

package/dist/cli/setup-renderer.js.map

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

package/dist/cli/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":""}