@trenchwork/erosolar 1.1.16

package/dist/workspace.js

@@ -0,0 +1,135 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { safeWorkspaceContext, validateWorkspaceOptions } from './workspace.validator.js';
+import { reportStatus, reportStatusError } from './utils/statusReporter.js';
+const PRIORITY_DOCS = ['README.md']; // Removed package.json to save context
+const IGNORED_DIRS = new Set([
+    '.git', 'node_modules', 'dist', '.erosolar', 'build', 'coverage', '.next', 'out',
+    '__pycache__', '.pytest_cache', '.mypy_cache', 'venv', '.venv', 'env',
+    'target', 'bin', 'obj', '.idea', '.vscode', '.DS_Store'
+]);
+const IGNORED_FILES = new Set(['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml']);
+const DEFAULT_TREE_DEPTH = 1; // Reduced from 2 to 1 for critical context savings
+const DEFAULT_MAX_ENTRIES = 30; // Further reduced from 50 to 30 - emergency reduction
+const DEFAULT_DOC_LIMIT = 200; // Further reduced from 300 to 200 - emergency reduction
+const DEBUG_CONTEXT_ERRORS = Boolean(process.env['DEBUG_CONTEXT_ERRORS']);
+export function resolveWorkspaceCaptureOptions(env = process.env) {
+    return {
+        treeDepth: parsePositiveInt(env['EROSOLAR_CONTEXT_TREE_DEPTH']),
+        maxEntries: parsePositiveInt(env['EROSOLAR_CONTEXT_MAX_ENTRIES']),
+        docExcerptLimit: parsePositiveInt(env['EROSOLAR_CONTEXT_DOC_LIMIT']),
+    };
+}
+export function buildWorkspaceContext(root, options = {}) {
+    // CRITICAL: Validate options BEFORE building context
+    const optionsValidation = validateWorkspaceOptions(options);
+    if (!optionsValidation.valid) {
+        // Only log in debug mode to avoid polluting chat
+        if (process.env['DEBUG_CONTEXT']) {
+            reportStatus(`[Workspace Context] Invalid options: ${optionsValidation.errors.join(', ')}`);
+        }
+        throw new Error(`Invalid workspace options: ${optionsValidation.errors.join(', ')}`);
+    }
+    // Warnings only in debug mode
+    if (optionsValidation.warnings.length > 0 && process.env['DEBUG_CONTEXT']) {
+        console.warn('[Workspace Context] Warnings:', optionsValidation.warnings);
+    }
+    const treeDepth = options.treeDepth ?? DEFAULT_TREE_DEPTH;
+    const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const docLimit = options.docExcerptLimit ?? DEFAULT_DOC_LIMIT;
+    try {
+        const treeLines = formatFileTree(root, treeDepth, maxEntries);
+        const docSnippets = capturePriorityDocs(root, docLimit);
+        const sections = [`cwd: ${root}`];
+        if (treeLines.length) {
+            sections.push('files:', ...treeLines);
+        }
+        if (docSnippets.length) {
+            sections.push(docSnippets.join('\n\n'));
+        }
+        const rawContent = sections.filter((section) => section.trim().length > 0).join('\n');
+        const safe = safeWorkspaceContext(rawContent, {
+            truncate: true,
+            throwOnError: false,
+        });
+        if (process.env['DEBUG_CONTEXT']) {
+            console.log('[Workspace Context] Stats:', safe.stats);
+        }
+        if (!safe.content.trim()) {
+            if (DEBUG_CONTEXT_ERRORS) {
+                console.warn('[Workspace Context] Captured context is empty after filtering.');
+            }
+            return null;
+        }
+        return safe.content;
+    }
+    catch (error) {
+        // Only log errors in debug mode to avoid polluting chat
+        if (DEBUG_CONTEXT_ERRORS || process.env['DEBUG_CONTEXT']) {
+            const message = error instanceof Error ? error.message : String(error);
+            reportStatus(`[Workspace Context] Failed to build context: ${message}`);
+            reportStatusError(error, '[Workspace Context] Error');
+        }
+        return null;
+    }
+}
+function capturePriorityDocs(root, docLimit) {
+    return PRIORITY_DOCS.filter((name) => existsSync(join(root, name))).map((name) => {
+        try {
+            const content = readFileSync(join(root, name), 'utf8');
+            // Safety: Hard limit to prevent context explosion
+            const safeLimit = Math.min(docLimit, 300);
+            const snippet = content.length > safeLimit ? `${content.slice(0, safeLimit)}\n...` : content;
+            return `--- ${name} ---\n${snippet.trim()}`;
+        }
+        catch {
+            return `--- ${name} ---\n[Could not read file]`;
+        }
+    });
+}
+function formatFileTree(root, maxDepth, maxEntries) {
+    const lines = [];
+    const walk = (dir, depth, prefix) => {
+        if (depth > maxDepth || lines.length >= maxEntries) {
+            return;
+        }
+        const entries = safeReadDir(dir)
+            .filter((entry) => !IGNORED_DIRS.has(entry.name))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (entry.isFile() && IGNORED_FILES.has(entry.name)) {
+                continue;
+            }
+            if (lines.length >= maxEntries) {
+                break;
+            }
+            const isDir = entry.isDirectory();
+            lines.push(`${prefix}${entry.name}${isDir ? '/' : ''}`);
+            if (isDir && depth < maxDepth) {
+                walk(join(dir, entry.name), depth + 1, `${prefix}  `);
+            }
+        }
+    };
+    walk(root, 0, '');
+    return lines;
+}
+function safeReadDir(dir) {
+    try {
+        return readdirSync(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (DEBUG_CONTEXT_ERRORS) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`[Workspace Context] Skipping ${dir}: ${message}`);
+        }
+        return [];
+    }
+}
+function parsePositiveInt(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) && value > 0 ? value : undefined;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/dist/workspace.validator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Workspace Context Validator - Enforces strict safety limits
+ *
+ * CRITICAL: Prevents context explosion by validating all workspace context
+ * before it's sent to the LLM. Multiple safety layers ensure we never
+ * exceed token limits.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    stats: ContextStats;
+}
+export interface ContextStats {
+    totalChars: number;
+    totalLines: number;
+    estimatedTokens: number;
+    fileEntries: number;
+    docChars: number;
+}
+export interface WorkspaceContextSafe {
+    content: string;
+    stats: ContextStats;
+}
+/**
+ * Validate workspace context options BEFORE building context
+ */
+export declare function validateWorkspaceOptions(options: {
+    treeDepth?: number;
+    maxEntries?: number;
+    docExcerptLimit?: number;
+}): ValidationResult;
+/**
+ * Validate workspace context AFTER building - CRITICAL SAFETY CHECK
+ * This is the final line of defense against context explosion
+ */
+export declare function validateWorkspaceContext(content: string): ValidationResult;
+/**
+ * Safe truncation - if content exceeds limits, truncate intelligently
+ */
+export declare function truncateWorkspaceContext(content: string): WorkspaceContextSafe;
+/**
+ * Validate and enforce limits in a single call - RECOMMENDED USAGE
+ */
+export declare function safeWorkspaceContext(content: string | null, options?: {
+    truncate?: boolean;
+    throwOnError?: boolean;
+}): WorkspaceContextSafe;
+//# sourceMappingURL=workspace.validator.d.ts.map

package/dist/workspace.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.validator.d.ts","sourceRoot":"","sources":["../src/workspace.validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;CACrB;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,gBAAgB,CAuDnB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAuE1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CA2C9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,oBAAoB,CAiDtB"}

package/dist/workspace.validator.js

@@ -0,0 +1,215 @@
+/**
+ * Workspace Context Validator - Enforces strict safety limits
+ *
+ * CRITICAL: Prevents context explosion by validating all workspace context
+ * before it's sent to the LLM. Multiple safety layers ensure we never
+ * exceed token limits.
+ */
+import { ContextOverflowError, ResourceLimitError } from './core/errors/errorTypes.js';
+import { logDebug } from './utils/debugLogger.js';
+// ABSOLUTE MAXIMUM LIMITS - Never exceed these under any circumstances
+const ABSOLUTE_MAX_CHARS = 5000; // ~1,250 tokens (4 chars per token)
+const ABSOLUTE_MAX_LINES = 100; // Maximum lines in any context
+const ABSOLUTE_MAX_FILE_ENTRIES = 50; // Maximum files in tree
+const ABSOLUTE_MAX_DOC_CHARS = 300; // Maximum chars per priority doc
+const WARNING_THRESHOLD = 0.7; // Warn at 70% of max
+/**
+ * Estimate token count (rough: 1 token ≈ 4 characters)
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Validate workspace context options BEFORE building context
+ */
+export function validateWorkspaceOptions(options) {
+    const errors = [];
+    const warnings = [];
+    // Validate tree depth
+    if (options.treeDepth !== undefined) {
+        if (options.treeDepth < 0) {
+            errors.push('treeDepth cannot be negative');
+        }
+        if (options.treeDepth > 2) {
+            errors.push(`treeDepth ${options.treeDepth} exceeds maximum of 2`);
+        }
+        if (options.treeDepth > 1) {
+            warnings.push('treeDepth > 1 can significantly increase context size');
+        }
+    }
+    // Validate max entries
+    if (options.maxEntries !== undefined) {
+        if (options.maxEntries < 0) {
+            errors.push('maxEntries cannot be negative');
+        }
+        if (options.maxEntries > ABSOLUTE_MAX_FILE_ENTRIES) {
+            errors.push(`maxEntries ${options.maxEntries} exceeds maximum of ${ABSOLUTE_MAX_FILE_ENTRIES}`);
+        }
+        if (options.maxEntries > 40) {
+            warnings.push('maxEntries > 40 may use significant context');
+        }
+    }
+    // Validate doc excerpt limit
+    if (options.docExcerptLimit !== undefined) {
+        if (options.docExcerptLimit < 0) {
+            errors.push('docExcerptLimit cannot be negative');
+        }
+        if (options.docExcerptLimit > ABSOLUTE_MAX_DOC_CHARS) {
+            errors.push(`docExcerptLimit ${options.docExcerptLimit} exceeds maximum of ${ABSOLUTE_MAX_DOC_CHARS}`);
+        }
+        if (options.docExcerptLimit > 250) {
+            warnings.push('docExcerptLimit > 250 may use significant context');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats: {
+            totalChars: 0,
+            totalLines: 0,
+            estimatedTokens: 0,
+            fileEntries: options.maxEntries ?? 0,
+            docChars: options.docExcerptLimit ?? 0,
+        },
+    };
+}
+/**
+ * Validate workspace context AFTER building - CRITICAL SAFETY CHECK
+ * This is the final line of defense against context explosion
+ */
+export function validateWorkspaceContext(content) {
+    const errors = [];
+    const warnings = [];
+    // Count basic metrics
+    const totalChars = content.length;
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    const estimatedTokens = estimateTokens(content);
+    // Count file entries (lines that look like file paths)
+    const fileEntries = lines.filter(line => line.trim() && !line.startsWith('---') && !line.startsWith('cwd:')).length;
+    // Count chars in priority docs section
+    const docMatch = content.match(/--- .* ---[\s\S]*?(?=\n\n|$)/g);
+    const docChars = docMatch ? docMatch.join('').length : 0;
+    const stats = {
+        totalChars,
+        totalLines,
+        estimatedTokens,
+        fileEntries,
+        docChars,
+    };
+    // CRITICAL: Check absolute maximum character limit
+    if (totalChars > ABSOLUTE_MAX_CHARS) {
+        const error = new ContextOverflowError(totalChars, ABSOLUTE_MAX_CHARS, 'chars', true);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // CRITICAL: Check absolute maximum line limit
+    if (totalLines > ABSOLUTE_MAX_LINES) {
+        const error = new ContextOverflowError(totalLines, ABSOLUTE_MAX_LINES, 'lines', true);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // CRITICAL: Check absolute maximum file entries
+    if (fileEntries > ABSOLUTE_MAX_FILE_ENTRIES) {
+        const error = new ResourceLimitError('file entries', fileEntries, ABSOLUTE_MAX_FILE_ENTRIES, false);
+        errors.push(`Context exceeds ABSOLUTE maximum: ${error.message}`);
+    }
+    // WARNING: Approaching limits
+    if (totalChars > ABSOLUTE_MAX_CHARS * WARNING_THRESHOLD) {
+        warnings.push(`Context size ${totalChars} chars is ${Math.round(totalChars / ABSOLUTE_MAX_CHARS * 100)}% of maximum. ` +
+            `Consider reducing treeDepth, maxEntries, or docExcerptLimit.`);
+    }
+    if (estimatedTokens > 1000) {
+        warnings.push(`Estimated ${estimatedTokens} tokens in workspace context. This is high and may impact performance.`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats,
+    };
+}
+/**
+ * Safe truncation - if content exceeds limits, truncate intelligently
+ */
+export function truncateWorkspaceContext(content) {
+    const validation = validateWorkspaceContext(content);
+    // If valid, return as-is
+    if (validation.valid) {
+        return {
+            content,
+            stats: validation.stats,
+        };
+    }
+    // CRITICAL: Content exceeds limits, must truncate
+    const lines = content.split('\n');
+    const truncatedLines = [];
+    let charCount = 0;
+    // Keep up to absolute maximums
+    for (const line of lines) {
+        if (truncatedLines.length >= ABSOLUTE_MAX_LINES) {
+            break;
+        }
+        if (charCount + line.length > ABSOLUTE_MAX_CHARS) {
+            break;
+        }
+        truncatedLines.push(line);
+        charCount += line.length + 1; // +1 for newline
+    }
+    // Add truncation notice
+    if (truncatedLines.length < lines.length) {
+        truncatedLines.push('');
+        truncatedLines.push('[Workspace context truncated to prevent context overflow]');
+        truncatedLines.push(`[Showing ${truncatedLines.length} of ${lines.length} lines]`);
+    }
+    const truncatedContent = truncatedLines.join('\n');
+    const stats = validateWorkspaceContext(truncatedContent).stats;
+    return {
+        content: truncatedContent,
+        stats,
+    };
+}
+/**
+ * Validate and enforce limits in a single call - RECOMMENDED USAGE
+ */
+export function safeWorkspaceContext(content, options) {
+    const { truncate = true, throwOnError = false } = options ?? {};
+    if (!content) {
+        return {
+            content: '',
+            stats: {
+                totalChars: 0,
+                totalLines: 0,
+                estimatedTokens: 0,
+                fileEntries: 0,
+                docChars: 0,
+            },
+        };
+    }
+    const validation = validateWorkspaceContext(content);
+    // Log warnings to debug
+    if (validation.warnings.length > 0) {
+        logDebug('[Workspace Context Validator] Warnings:');
+        for (const warning of validation.warnings) {
+            logDebug(`  - ${warning}`);
+        }
+    }
+    // Handle errors
+    if (!validation.valid) {
+        logDebug('[Workspace Context Validator] CRITICAL ERRORS:');
+        for (const error of validation.errors) {
+            logDebug(`  - ${error}`);
+        }
+        if (throwOnError) {
+            throw new Error(`Workspace context validation failed:\n${validation.errors.join('\n')}`);
+        }
+        if (truncate) {
+            logDebug('[Workspace Context Validator] Auto-truncating to safe limits...');
+            return truncateWorkspaceContext(content);
+        }
+    }
+    return {
+        content,
+        stats: validation.stats,
+    };
+}
+//# sourceMappingURL=workspace.validator.js.map

package/dist/workspace.validator.js.map

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

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "@trenchwork/erosolar",
+  "version": "1.1.16",
+  "description": "DeepSeek AI-powered CLI agent for code assistance and automation",
+  "deepseek": {
+    "rulebookSchema": "src/contracts/schemas/agent-rules.schema.json"
+  },
+  "main": "dist/bin/deepseek.js",
+  "exports": {
+    ".": "./dist/bin/deepseek.js",
+    "./lean": "./dist/leanAgent.js",
+    "./capabilities": "./dist/capabilities/index.js",
+    "./orchestration": "./dist/orchestration/index.js"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "scripts/postinstall.cjs",
+    "README.md",
+    "agents",
+    "LICENSE"
+  ],
+  "bin": {
+    "erosolar": "dist/bin/erosolar.js",
+    "trenchwork": "dist/bin/erosolar.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.cjs",
+    "prebuild": "npm run clean",
+    "clean": "node -e \"const { rmSync } = require('fs'); for (const target of ['dist', '.tsbuildinfo']) { try { rmSync(target, { recursive: true, force: true, maxRetries: 10 }); } catch (error) { console.warn('Clean warning:', error.code, 'for', target); } }\"",
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "build:prod": "NODE_ENV=production MINIFY=true npm run build",
+    "optimize": "node scripts/optimize-build.mjs",
+    "release": "chmod +x scripts/create-release.sh && scripts/create-release.sh patch",
+    "release:minor": "chmod +x scripts/create-release.sh && scripts/create-release.sh minor",
+    "release:major": "chmod +x scripts/create-release.sh && scripts/create-release.sh major",
+    "release:cno": "chmod +x scripts/cno-unified-release-loop.sh && scripts/cno-unified-release-loop.sh",
+    "release:cno:continuous": "chmod +x scripts/cno-unified-release-loop.sh && scripts/cno-unified-release-loop.sh continuous",
+    "release:cno:patch": "chmod +x scripts/cno-unified-release-loop.sh && scripts/cno-unified-release-loop.sh patch",
+    "release:cno:minor": "chmod +x scripts/cno-unified-release-loop.sh && scripts/cno-unified-release-loop.sh minor",
+    "release:cno:major": "chmod +x scripts/cno-unified-release-loop.sh && scripts/cno-unified-release-loop.sh major",
+    "prepublishOnly": "npm run build",
+    "pretest": "npm run build",
+    "postbuild": "node scripts/postbuild.mjs",
+    "cli": "node dist/bin/deepseek.js",
+    "dev": "node --loader ts-node/esm src/bin/deepseek.ts",
+    "dev:watch": "node --watch --loader ts-node/esm src/bin/deepseek.ts",
+    "start": "node dist/bin/deepseek.js",
+    "test": "jest --config jest.config.cjs",
+    "test:watch": "jest --config jest.config.cjs --watch",
+    "test:coverage": "jest --config jest.config.cjs --coverage",
+    "demo:chinese-cno": "npx tsx examples/chineseCnoDemo.ts",
+    "demo:max-chinese-cno": "npx tsx examples/maxChineseCnoDemo.ts",
+    "demo:cno-release": "./scripts/demo-cno-release.sh",
+    "lint": "eslint src/**/*.ts --max-warnings 200",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "type-check": "tsc --noEmit",
+    "fuzz:helia": "node Erosolar_Browser/scripts/gen-agent-prompt.mjs",
+    "fuzz:helia:run": "npm run fuzz:helia && cd Erosolar_Browser && npx electron ."
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "agent",
+    "llm",
+    "anthropic",
+    "openai",
+    "google",
+    "deepseek",
+    "code-assistant",
+    "automation",
+    "developer-tools"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Aroxora/deepseek-coder-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Aroxora/deepseek-coder-cli/issues"
+  },
+  "homepage": "https://github.com/Aroxora/deepseek-coder-cli#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/preset-react": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@eslint/js": "^9.39.2",
+    "@types/glob": "^8.1.0",
+    "@types/gradient-string": "^1.1.6",
+    "@types/jest": "30.0.0",
+    "@types/node": "25.0.2",
+    "@types/react": "^19.2.0",
+    "@typescript-eslint/eslint-plugin": "8.49.0",
+    "@typescript-eslint/parser": "8.49.0",
+    "@xterm/headless": "^6.0.0",
+    "babel-jest": "^30.2.0",
+    "eslint": "9.39.2",
+    "eslint-plugin-import": "^2.32.0",
+    "firebase-tools": "^15.16.0",
+    "ink-testing-library": "^4.0.0",
+    "jest": "30.2.0",
+    "node-pty": "^1.1.0",
+    "nodemailer": "^8.0.7",
+    "ts-jest": "29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript-eslint": "^8.50.0"
+  },
+  "overrides": {
+    "uuid": "^14.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.2",
+    "@google/genai": "^1.33.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "cli-spinners": "^3.3.0",
+    "gradient-string": "^3.0.0",
+    "ink": "^7.0.1",
+    "ink-spinner": "^5.0.0",
+    "nanospinner": "1.2.2",
+    "open": "^11.0.0",
+    "openai": "^6.10.0",
+    "ora": "^9.0.0",
+    "react": "^19.2.0",
+    "react-devtools-core": "^7.0.1",
+    "typescript": "5.9.3"
+  }
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * Postinstall:
+ *   1. chmod the bin entrypoints so they're executable on POSIX (no-op on Windows).
+ *   2. On Windows, print a friendly one-time notice about PowerShell execution
+ *      policy and the canonical command forms so users don't get blocked the
+ *      first time they type `erosolar` in PowerShell.
+ *
+ * Errors are intentionally swallowed: a postinstall must never fail an
+ * `npm install` for a non-essential courtesy step.
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const BINS = [
+  'dist/bin/deepseek.js',
+  'dist/bin/erosolar.js',
+  'dist/bin/lean.js',
+];
+
+for (const rel of BINS) {
+  try {
+    fs.chmodSync(path.resolve(__dirname, '..', rel), 0o755);
+  } catch {
+    // Missing files (clean tree pre-build) and Windows chmod no-ops both land here.
+  }
+}
+
+if (process.platform === 'win32' && !process.env['EROSOLAR_QUIET_POSTINSTALL']) {
+  // Single, scannable message — no banners, no marketing. Users see this once
+  // per global install and can move on.
+  const lines = [
+    '',
+    'Erosolar Coder installed. Two notes for Windows:',
+    '',
+    '  • Commands available on PATH: erosolar  ·  deepseek  ·  lean',
+    '    These work in Command Prompt and PowerShell via the .cmd shims',
+    '    npm installs automatically.',
+    '',
+    '  • If PowerShell says "running scripts is disabled on this system",',
+    '    run this (once, no admin needed) and reopen the shell:',
+    '',
+    '      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser',
+    '',
+    '    Or invoke the .cmd shim directly: erosolar.cmd',
+    '',
+  ];
+  // Use stderr so the notice is visible even when npm is captured to stdout
+  // by automation. The notice is short and bounded.
+  try {
+    process.stderr.write(lines.join(os.EOL) + os.EOL);
+  } catch {
+    // Even the notice itself is non-essential.
+  }
+}