@gettrace/cli 2.0.6 → 2.0.8

package/scripts/postinstall.js

@@ -34,8 +34,10 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 
 // The extension IDs that are allowed to use this native host.
 const ALLOWED_EXTENSION_IDS = [
-    // Development / unpacked extension ID
+    // Development / unpacked extension ID (macOS)
     'jefgjgdcelekglimbmgplkaaabdfpgfm',
+    // Development / unpacked extension ID (Windows)
+    'fppbikhdjehmiidhjholkiaeeieoilfb',
     // Add the published CWS extension ID here when you have it:
     // 'PRODUCTION_EXTENSION_ID',
 ];
@@ -49,11 +51,18 @@ if (process.env.TRACE_EXTENSION_IDS) {
 
 const HOST_NAME = 'dev.gettrace.host';
 
-// Install native host files into ~/.local/share/trace/native-host/ so that
-// Chrome (and other browsers) can always read them. Files on ~/Desktop,
-// ~/Documents, ~/Downloads require explicit macOS TCC (Privacy) permission
-// which Chrome does not have by default. ~/.local/share/ is always accessible.
-const INSTALL_DIR    = join(homedir(), '.local', 'share', 'trace', 'native-host');
+// Install native host files into platform-specific directories
+// macOS/Linux: ~/.local/share/trace/native-host/ (no TCC permission issues)
+// Windows: %LOCALAPPDATA%\trace\native-host\ (standard Windows app data location)
+function getInstallDir() {
+    if (platform() === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
+        return join(localAppData, 'trace', 'native-host');
+    }
+    return join(homedir(), '.local', 'share', 'trace', 'native-host');
+}
+
+const INSTALL_DIR    = getInstallDir();
 const HOST_ENTRY     = join(INSTALL_DIR, 'host-entry');
 const HOST_CJS_DEST  = join(INSTALL_DIR, 'host.cjs');
 
@@ -96,6 +105,84 @@ function generateHostEntry() {
         writeFileSync(join(INSTALL_DIR, 'package.json'), readFileSync(pkgSrc), { mode: 0o644 });
     }
 
+    // On Windows, create a .bat launcher that Chrome can execute
+    if (platform() === 'win32') {
+        generateWindowsHostEntry(nodePath, tracePath);
+    } else {
+        generateUnixHostEntry(nodePath, tracePath);
+    }
+}
+
+function generateWindowsHostEntry(nodePath, tracePath) {
+    const HOST_BAT = join(INSTALL_DIR, 'host-entry.bat');
+    const HOST_JS = join(INSTALL_DIR, 'host-entry.js');
+    
+    // Create the JavaScript loader file
+    const jsContent = [
+        `// Auto-generated by @gettrace/cli postinstall — do not edit manually`,
+        `// Generated: ${new Date().toISOString()}`,
+        `// Node:  ${nodePath}`,
+        tracePath ? `// Trace: ${tracePath}` : `// Trace: (resolves from PATH)`,
+        `'use strict';`,
+        ``,
+        `// Fix PATH before anything else — Chrome launches with a minimal environment`,
+        tracePath
+            ? `process.env.PATH = '${dirname(tracePath).replace(/\\/g, '\\\\')};${dirname(nodePath).replace(/\\/g, '\\\\')};' + (process.env.PATH || 'C:\\\\Windows\\\\System32');`
+            : `process.env.PATH = '${dirname(nodePath).replace(/\\/g, '\\\\')};;' + (process.env.PATH || 'C:\\\\Windows\\\\System32');`,
+        ``,
+        ...(() => {
+            const monorepoAgent = resolve(
+                __dirname, '..', '..', 'packages', 'trace-agent', 'dist', 'node', 'index.js'
+            );
+            const localCli = resolve(__dirname, '..', 'dist', 'index.js');
+            if (existsSync(monorepoAgent) && existsSync(localCli)) {
+                return [
+                    `// Dev mode: use local CLI build instead of the global npm package`,
+                    `process.env.TRACE_DEV_MODE = '1';`,
+                    `process.env.TRACE_CLI_PATH = '${localCli.replace(/\\/g, '\\\\')}';`,
+                    ``,
+                ];
+            }
+            return [];
+        })(),
+        `// Diagnostic logging — written synchronously so we catch crashes before async`,
+        `const fs = require('fs');`,
+        `const path = require('path');`,
+        `const logPath = path.join('${homedir().replace(/\\/g, '\\\\')}', 'trace-native-host.log');`,
+        `function log(msg) {`,
+        `    const line = new Date().toISOString() + ' ' + msg + '\\n';`,
+        `    try { fs.appendFileSync(logPath, line); } catch(_) {}`,
+        `}`,
+        ``,
+        `log('[host-entry] started, node=' + process.version + ' pid=' + process.pid);`,
+        ``,
+        `try {`,
+        `    require('${HOST_CJS_DEST.replace(/\\/g, '\\\\')}');`,
+        `    log('[host-entry] host.cjs loaded OK');`,
+        `} catch (err) {`,
+        `    log('[host-entry] FATAL: ' + (err.stack || err));`,
+        `    process.exit(1);`,
+        `}`,
+    ].join('\n');
+    
+    writeFileSync(HOST_JS, jsContent, { encoding: 'utf8' });
+    
+    // Create the .bat launcher that Chrome will execute
+    const batContent = [
+        `@echo off`,
+        `REM Auto-generated by @gettrace/cli postinstall`,
+        `REM Node: ${nodePath}`,
+        `"${nodePath}" "${HOST_JS}" %*`,
+    ].join('\r\n');
+    
+    writeFileSync(HOST_BAT, batContent, { encoding: 'utf8' });
+    
+    console.log(`✓ Generated Windows native host: ${HOST_BAT}`);
+    console.log(`  Node binary: ${nodePath}`);
+    if (tracePath) console.log(`  Trace binary: ${tracePath}`);
+}
+
+function generateUnixHostEntry(nodePath, tracePath) {
     // Log paths — write to home dir only (always writable by Chrome)
     const logPath1 = `${homedir()}/trace-native-host.log`;
 
@@ -112,16 +199,6 @@ function generateHostEntry() {
             ? `process.env.PATH = '${dirname(tracePath)}:${dirname(nodePath)}:' + (process.env.PATH || '/usr/bin:/bin');`
             : `process.env.PATH = '${dirname(nodePath)}:/opt/homebrew/bin:/usr/local/bin:' + (process.env.PATH || '/usr/bin:/bin');`,
         ``,
-        // Inject dev mode env vars ONLY when running from the trace monorepo
-        // (the dev workflow). Detect that by the presence of the local agent
-        // build that dev-mode resolution actually targets:
-        // <repo>/packages/trace-agent/dist/node/index.js. In a published npm
-        // install this path does not exist (the package lives under
-        // node_modules/@gettrace/cli), so production NEVER enables dev mode.
-        //
-        // NOTE: do NOT key this off `<pkg>/dist/index.js` — the published CLI
-        // ships that file too, which previously made every install spuriously
-        // enable dev mode and fail to locate the agent.
         ...(() => {
             const monorepoAgent = resolve(
                 __dirname, '..', '..', 'packages', 'trace-agent', 'dist', 'node', 'index.js'
@@ -179,10 +256,15 @@ function getNativeHostDir() {
 }
 
 function buildManifest() {
+    // On Windows, Chrome needs to execute a .bat file; Unix uses the shebang script
+    const executablePath = platform() === 'win32' 
+        ? join(INSTALL_DIR, 'host-entry.bat')
+        : HOST_ENTRY;
+        
     return JSON.stringify({
         name: HOST_NAME,
         description: 'Trace native host — spawns trace dev in the user\'s project directory',
-        path: HOST_ENTRY,  // Points to the generated entry file with hardcoded node path
+        path: executablePath,
         type: 'stdio',
         allowed_origins: ALLOWED_EXTENSION_IDS.map(id => `chrome-extension://${id}/`),
     }, null, 2);
@@ -190,15 +272,23 @@ function buildManifest() {
 
 function registerOnWindows() {
     const manifest = buildManifest();
-    const manifestPath = join(homedir(), 'AppData', 'Local', 'Trace', `${HOST_NAME}.json`);
+    // Store manifest in the same directory as the host files for consistency
+    const manifestPath = join(INSTALL_DIR, `${HOST_NAME}.json`);
     mkdirSync(dirname(manifestPath), { recursive: true });
     writeFileSync(manifestPath, manifest, 'utf8');
+    console.log(`✓ Native host manifest: ${manifestPath}`);
+    
     const regKey = `HKCU\\Software\\Google\\Chrome\\NativeMessagingHosts\\${HOST_NAME}`;
     try {
-        execSync(`reg add "${regKey}" /ve /t REG_SZ /d "${manifestPath}" /f`, { stdio: 'pipe' });
-        console.log(`✓ Native host registered (Windows registry)`);
+        // Use double backslashes for Windows paths in registry
+        const manifestPathWin = manifestPath.replace(/\//g, '\\');
+        execSync(`reg add "${regKey}" /ve /t REG_SZ /d "${manifestPathWin}" /f`, { stdio: 'pipe' });
+        console.log(`✓ Native host registered in Windows registry`);
+        console.log(`  Registry key: ${regKey}`);
+        console.log(`  Manifest path: ${manifestPathWin}`);
     } catch (e) {
         console.warn('⚠ Could not register native host in Windows registry:', e.message);
+        console.warn('  Try running as Administrator or manually import the registry key');
     }
 }
 

package/dist/ast.d.ts

@@ -1,48 +0,0 @@
-export interface ClassNameEdit {
-    /** Current className string to replace. Matched literally; partial match used as fallback. */
-    oldValue?: string;
-    /** New className string to write into the attribute. */
-    newValue: string;
-    /** Source line (1-indexed) from Fiber resolvedLine. Narrows the search strongly. */
-    lineHint?: number;
-}
-export interface ASTEditResult {
-    success: boolean;
-    code?: string;
-    error?: string;
-    /** Which scoring strategy produced the winning match. */
-    strategy?: 'line_exact' | 'line_proximity' | 'value_exact' | 'value_partial';
-    /** Line number of the matched JSXOpeningElement. */
-    matchedLine?: number;
-}
-export interface CSSRuleEdit {
-    /** CSS selector to find (exact match). Appends new rule if not found. */
-    selector: string;
-    /** Properties to set. Existing properties are updated; new ones are appended. */
-    properties: Record<string, string>;
-}
-/**
- * Parse JSX/TSX source and replace a className attribute value.
- *
- * Matching priority (higher score wins):
- *   1. Line-exact   — node is within ±1 line of lineHint AND className contains oldValue  (+100 line, +80 value)
- *   2. Line-nearby  — node is within ±5 lines of lineHint                                 (+50 line)
- *   3. Value-exact  — className === oldValue (any line)                                    (+80 value)
- *   4. Value-partial— className.includes(oldValue) (any line)                              (+40 value)
- *   5. Any          — first className found (when no oldValue given)                       (+20)
- *
- * Returns { success: false } without modifying source if no match scores > 0.
- */
-export declare function editJSXClassName(source: string, edit: ClassNameEdit): ASTEditResult;
-/**
- * Edit CSS properties within a specific selector block.
- *
- * - If the selector exists: updates existing properties in-place, appends new ones.
- * - If the selector does not exist: appends a new rule at the end of the file.
- * - Leaves all properties not mentioned in `edit.properties` untouched.
- * - Strips any existing `!important` from injected values (clean code output).
- *
- * Uses a regex-based approach — a full CSS AST is overkill for targeted property
- * edits and would add another large dep.
- */
-export declare function editCSSRule(source: string, edit: CSSRuleEdit): ASTEditResult;

package/dist/ast.js

@@ -1,203 +0,0 @@
-// ============================================================
-// TRACE AST ENGINE
-// Precise, AST-based source code modification for JSX/TSX files.
-//
-// Complements fuzzyReplace (EDIT_FILE) with guaranteed-correct
-// structural edits that survive Prettier reformatting and
-// dynamic className expressions that string matching cannot handle.
-//
-// Two exported functions:
-//   editJSXClassName — update a className attribute in JSX/TSX
-//   editCSSRule      — patch properties inside a CSS selector block
-//
-// Deps (runtime): @babel/parser, @babel/traverse, @babel/generator, @babel/types
-// Used by: EDIT_CLASSNAME handler in index.ts
-// ============================================================
-import { parse } from '@babel/parser';
-import { createRequire } from 'module';
-import * as t from '@babel/types';
-// @babel/traverse and @babel/generator ship CJS-only bundles.
-// Use createRequire so they work inside an ESM project (module:NodeNext).
-const _require = createRequire(import.meta.url);
-const _traverse = _require('@babel/traverse');
-const _generate = _require('@babel/generator');
-const traverse = (_traverse.default ?? _traverse);
-const generate = (_generate.default ?? _generate);
-// ── JSX className editing ─────────────────────────────────────────────────
-/**
- * Parse JSX/TSX source and replace a className attribute value.
- *
- * Matching priority (higher score wins):
- *   1. Line-exact   — node is within ±1 line of lineHint AND className contains oldValue  (+100 line, +80 value)
- *   2. Line-nearby  — node is within ±5 lines of lineHint                                 (+50 line)
- *   3. Value-exact  — className === oldValue (any line)                                    (+80 value)
- *   4. Value-partial— className.includes(oldValue) (any line)                              (+40 value)
- *   5. Any          — first className found (when no oldValue given)                       (+20)
- *
- * Returns { success: false } without modifying source if no match scores > 0.
- */
-export function editJSXClassName(source, edit) {
-    let ast;
-    try {
-        ast = parse(source, {
-            sourceType: 'module',
-            plugins: ['jsx', 'typescript'],
-            errorRecovery: true, // tolerate minor syntax errors in source file
-        });
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        return { success: false, error: `Parse error: ${msg}` };
-    }
-    const candidates = [];
-    traverse(ast, {
-        JSXOpeningElement(nodePath) {
-            for (const attr of nodePath.node.attributes) {
-                if (!t.isJSXAttribute(attr))
-                    continue;
-                if (!t.isJSXIdentifier(attr.name, { name: 'className' }))
-                    continue;
-                const line = attr.loc?.start.line ?? 0;
-                let score = 0;
-                // ── Score by line proximity ──
-                if (edit.lineHint && line > 0) {
-                    const dist = Math.abs(line - edit.lineHint);
-                    if (dist <= 1)
-                        score += 100;
-                    else if (dist <= 5)
-                        score += 50;
-                    else if (dist <= 15)
-                        score += 15;
-                }
-                // ── Score by value match ──
-                const currentValue = _extractClassNameString(attr.value);
-                if (edit.oldValue) {
-                    if (currentValue === edit.oldValue)
-                        score += 80;
-                    else if (currentValue?.includes(edit.oldValue))
-                        score += 40;
-                    // Dynamic expression (null) — can't verify value, give small score
-                    else if (currentValue === null && edit.lineHint)
-                        score += 20;
-                }
-                else {
-                    // No oldValue specified — any className is a candidate
-                    score += 20;
-                }
-                if (score > 0) {
-                    candidates.push({ nodePath, attrNode: attr, score, line });
-                }
-            }
-        },
-    });
-    if (candidates.length === 0) {
-        return { success: false, error: 'No className attribute found matching the given hints.' };
-    }
-    // Pick the highest-scoring candidate
-    candidates.sort((a, b) => b.score - a.score);
-    const best = candidates[0];
-    // Classify strategy for caller transparency
-    let strategy;
-    if (best.score >= 180)
-        strategy = 'line_exact';
-    else if (best.score >= 100)
-        strategy = 'line_proximity';
-    else if (best.score >= 80)
-        strategy = 'value_exact';
-    else
-        strategy = 'value_partial';
-    // Apply the edit — replace with StringLiteral
-    best.attrNode.value = t.stringLiteral(edit.newValue);
-    // Generate source back. retainLines keeps line numbers stable so diffs
-    // are minimal; jsescOption minimal avoids unnecessary unicode escaping.
-    const output = generate(ast, { retainLines: true, jsescOption: { minimal: true } }, source);
-    return {
-        success: true,
-        code: output.code,
-        strategy,
-        matchedLine: best.line,
-    };
-}
-/**
- * Extract a plain string from a className JSXAttribute value.
- * Returns null for dynamic expressions (template literals with interpolations,
- * variables, function calls) — these cannot safely be string-replaced.
- */
-function _extractClassNameString(value) {
-    if (!value)
-        return '';
-    if (t.isStringLiteral(value))
-        return value.value;
-    if (t.isJSXExpressionContainer(value)) {
-        const expr = value.expression;
-        if (t.isStringLiteral(expr))
-            return expr.value;
-        // Simple template literal with no expressions: `bg-red-500 p-4`
-        if (t.isTemplateLiteral(expr) && expr.expressions.length === 0) {
-            return expr.quasis[0]?.value.cooked ?? null;
-        }
-    }
-    return null; // dynamic — caller should use EDIT_FILE fuzzy replacer instead
-}
-// ── CSS rule editing ──────────────────────────────────────────────────────
-/**
- * Edit CSS properties within a specific selector block.
- *
- * - If the selector exists: updates existing properties in-place, appends new ones.
- * - If the selector does not exist: appends a new rule at the end of the file.
- * - Leaves all properties not mentioned in `edit.properties` untouched.
- * - Strips any existing `!important` from injected values (clean code output).
- *
- * Uses a regex-based approach — a full CSS AST is overkill for targeted property
- * edits and would add another large dep.
- */
-export function editCSSRule(source, edit) {
-    // Clean properties: strip !important (Trace injected them for browser specificity;
-    // they don't belong in authored source files)
-    const props = {};
-    for (const [k, v] of Object.entries(edit.properties)) {
-        props[k] = v.replace(/\s*!important\s*$/, '').trim();
-    }
-    // Escape selector for use in RegExp
-    const escapedSel = edit.selector.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const ruleRegex = new RegExp(`(${escapedSel}\\s*\\{)([^}]*)(\\})`, 'ms');
-    const match = ruleRegex.exec(source);
-    if (!match) {
-        // Selector not found — append new rule
-        const newRule = _buildCSSRule(edit.selector, props);
-        return {
-            success: true,
-            code: source.trimEnd() + '\n\n' + newRule + '\n',
-            strategy: 'value_partial', // reuse field to signal "appended"
-        };
-    }
-    const [full, open, body, close] = match;
-    let patchedBody = body;
-    for (const [prop, val] of Object.entries(props)) {
-        // Match `prop:` with optional surrounding whitespace
-        const propRegex = new RegExp(`([ \\t]*${prop.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*:\\s*)[^;\\n]+;?`, 'm');
-        if (propRegex.test(patchedBody)) {
-            patchedBody = patchedBody.replace(propRegex, `$1${val};`);
-        }
-        else {
-            // Append missing property before closing brace
-            const indent = _detectIndent(patchedBody);
-            patchedBody = patchedBody.trimEnd() + `\n${indent}${prop}: ${val};`;
-        }
-    }
-    return {
-        success: true,
-        code: source.replace(full, open + patchedBody + close),
-        strategy: 'value_exact',
-    };
-}
-function _buildCSSRule(selector, props) {
-    const lines = Object.entries(props).map(([k, v]) => `  ${k}: ${v};`).join('\n');
-    return `${selector} {\n${lines}\n}`;
-}
-function _detectIndent(body) {
-    // Detect the indentation used by existing properties in this block
-    const match = body.match(/^([ \t]+)\S/m);
-    return match ? match[1] : '  ';
-}
-//# sourceMappingURL=ast.js.map

package/dist/ast.js.map

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

package/dist/file-lock.d.ts

@@ -1,23 +0,0 @@
-/**
- * Per-file async write-lock for the Trace IDE bridge.
- *
- * Problem: Node.js is single-threaded but WebSocket message handlers are
- * async. Two EDIT_FILE messages arriving in quick succession will both
- * start processing, and if a second message begins its read after the first
- * has written but before the first's `await autoFormat` resolves, the second
- * write lands on correctly-updated content. The real risk is a future where
- * parallelism is added — e.g., multiple WS connections dispatching concurrent
- * edits to the same file — where without a lock, the second write overwrites
- * the first silently.
- *
- * Solution: Promise-chain semaphore keyed on the absolute file path.
- * Each caller waits for the previous write to the same file to fully complete
- * (including the async autoFormat step) before starting its own write.
- *
- * Usage:
- *   await withFileLock(filePath, async () => {
- *     fs.writeFileSync(filePath, newContent, 'utf-8');
- *     await autoFormat(filePath, projectPath);
- *   });
- */
-export declare function withFileLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;

package/dist/file-lock.js

@@ -1,47 +0,0 @@
-/**
- * Per-file async write-lock for the Trace IDE bridge.
- *
- * Problem: Node.js is single-threaded but WebSocket message handlers are
- * async. Two EDIT_FILE messages arriving in quick succession will both
- * start processing, and if a second message begins its read after the first
- * has written but before the first's `await autoFormat` resolves, the second
- * write lands on correctly-updated content. The real risk is a future where
- * parallelism is added — e.g., multiple WS connections dispatching concurrent
- * edits to the same file — where without a lock, the second write overwrites
- * the first silently.
- *
- * Solution: Promise-chain semaphore keyed on the absolute file path.
- * Each caller waits for the previous write to the same file to fully complete
- * (including the async autoFormat step) before starting its own write.
- *
- * Usage:
- *   await withFileLock(filePath, async () => {
- *     fs.writeFileSync(filePath, newContent, 'utf-8');
- *     await autoFormat(filePath, projectPath);
- *   });
- */
-// Map: absolute filePath → the Promise representing the current (or last) write.
-const _locks = new Map();
-export async function withFileLock(filePath, fn) {
-    // Grab any in-progress write for this file (or a resolved no-op if none).
-    const prior = _locks.get(filePath) ?? Promise.resolve();
-    // Create a "hold" promise that keeps this slot in the chain alive
-    // until our fn() completes and we call release().
-    let release;
-    const hold = new Promise(resolve => (release = resolve));
-    // Register this write as the current holder for this path.
-    // Anyone queueing after us will wait on `hold`.
-    _locks.set(filePath, hold);
-    try {
-        await prior; // Wait for any preceding write to finish
-        return await fn(); // Execute our write (includes autoFormat await)
-    }
-    finally {
-        release(); // Unblock the next write in the chain
-        // Clean up the map if nothing queued behind us
-        if (_locks.get(filePath) === hold) {
-            _locks.delete(filePath);
-        }
-    }
-}
-//# sourceMappingURL=file-lock.js.map

package/dist/file-lock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../src/file-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iFAAiF;AACjF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,QAAgB,EAChB,EAAoB;IAEpB,0EAA0E;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAExD,kEAAkE;IAClE,kDAAkD;IAClD,IAAI,OAAoB,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAE/D,2DAA2D;IAC3D,gDAAgD;IAChD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE3B,IAAI,CAAC;QACD,MAAM,KAAK,CAAC,CAAO,yCAAyC;QAC5D,OAAO,MAAM,EAAE,EAAE,CAAC,CAAC,gDAAgD;IACvE,CAAC;YAAS,CAAC;QACP,OAAO,EAAE,CAAC,CAAS,sCAAsC;QACzD,+CAA+C;QAC/C,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/format.d.ts

@@ -1,20 +0,0 @@
-/**
- * Auto-format a project file after agent writes.
- *
- * Cascade: Prettier → ESLint --fix
- *
- * - Prettier handles JS/TS/CSS/HTML/JSON/Markdown formatting.
- * - ESLint --fix handles import ordering, unused imports, and React-specific
- *   rules that Prettier does not enforce (runs only if Prettier is absent or
- *   fails its own config check).
- *
- * Both are discovered from the *project's own* node_modules — not a global
- * install — so they respect the project's configured rules and parser options.
- *
- * Errors from either formatter are intentionally swallowed: a format failure
- * must never block an agent's write. The function returns:
- *   'prettier'  — Prettier ran successfully
- *   'eslint'    — ESLint ran successfully (Prettier was absent/failed)
- *   null        — file type is not formattable, or no formatter found
- */
-export declare function autoFormat(filePath: string, projectPath: string): Promise<string | null>;

package/dist/format.js

@@ -1,68 +0,0 @@
-/**
- * Auto-format a project file after agent writes.
- *
- * Cascade: Prettier → ESLint --fix
- *
- * - Prettier handles JS/TS/CSS/HTML/JSON/Markdown formatting.
- * - ESLint --fix handles import ordering, unused imports, and React-specific
- *   rules that Prettier does not enforce (runs only if Prettier is absent or
- *   fails its own config check).
- *
- * Both are discovered from the *project's own* node_modules — not a global
- * install — so they respect the project's configured rules and parser options.
- *
- * Errors from either formatter are intentionally swallowed: a format failure
- * must never block an agent's write. The function returns:
- *   'prettier'  — Prettier ran successfully
- *   'eslint'    — ESLint ran successfully (Prettier was absent/failed)
- *   null        — file type is not formattable, or no formatter found
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { exec } from 'child_process';
-import { promisify } from 'util';
-const execAsync = promisify(exec);
-const JS_EXTS = new Set(['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs', '.mts', '.cts']);
-const CSS_EXTS = new Set(['.css', '.scss', '.less']);
-const HTML_EXTS = new Set(['.html', '.htm', '.vue', '.svelte']);
-const ALL_FORMATTABLE = new Set([
-    ...JS_EXTS, ...CSS_EXTS, ...HTML_EXTS,
-    '.json', '.md', '.yaml', '.yml',
-]);
-export async function autoFormat(filePath, projectPath) {
-    const ext = path.extname(filePath).toLowerCase();
-    if (!ALL_FORMATTABLE.has(ext))
-        return null;
-    // ── 1. Prettier (first choice) ────────────────────────────────────────────
-    // Handles JS/TS/CSS/HTML/JSON/Markdown. Respects .prettierrc / prettier.config.js.
-    const prettierBin = path.join(projectPath, 'node_modules', '.bin', 'prettier');
-    if (fs.existsSync(prettierBin)) {
-        try {
-            await execAsync(`"${prettierBin}" --write "${filePath}"`, { cwd: projectPath });
-            return 'prettier';
-        }
-        catch {
-            // Prettier config error or unparseable file — fall through to ESLint.
-        }
-    }
-    // ── 2. ESLint --fix (JS/TS only) ─────────────────────────────────────────
-    // Handles import ordering (eslint-plugin-import), unused imports
-    // (eslint-plugin-unused-imports), and React-specific rules that Prettier
-    // does not enforce. Runs after Prettier so lint rules don't fight formatting.
-    if (JS_EXTS.has(ext)) {
-        const eslintBin = path.join(projectPath, 'node_modules', '.bin', 'eslint');
-        if (fs.existsSync(eslintBin)) {
-            try {
-                // --fix mutates the file; lint violations that can't be auto-fixed
-                // are reported to stderr (ignored here) but the file is still improved.
-                await execAsync(`"${eslintBin}" --fix "${filePath}"`, { cwd: projectPath });
-                return 'eslint';
-            }
-            catch {
-                // Lint violations are expected — fixable ones were still applied.
-            }
-        }
-    }
-    return null;
-}
-//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACxF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACrD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAChE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC5B,GAAG,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS;IACrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,WAAmB;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,6EAA6E;IAC7E,mFAAmF;IACnF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/E,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACD,MAAM,SAAS,CAAC,IAAI,WAAW,cAAc,QAAQ,GAAG,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;YAChF,OAAO,UAAU,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACL,sEAAsE;QAC1E,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,iEAAiE;IACjE,yEAAyE;IACzE,8EAA8E;IAC9E,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3E,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACD,mEAAmE;gBACnE,wEAAwE;gBACxE,MAAM,SAAS,CAAC,IAAI,SAAS,YAAY,QAAQ,GAAG,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;gBAC5E,OAAO,QAAQ,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACL,kEAAkE;YACtE,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};