clitrigger 0.1.0

package/dist/server/services/tunnel-manager.js

@@ -0,0 +1,265 @@
+import { spawn, execFile } from 'child_process';
+import { EventEmitter } from 'events';
+import { existsSync } from 'fs';
+import { join } from 'path';
+export class TunnelManager extends EventEmitter {
+    process = null;
+    url = null;
+    status = 'stopped';
+    cloudflaredPath = 'cloudflared';
+    /**
+     * Start a quick (unnamed) cloudflared tunnel.
+     * Runs: cloudflared tunnel --url http://localhost:<port>
+     * Parses stderr for the generated trycloudflare.com URL.
+     */
+    async startTunnel(port) {
+        if (this.status === 'running' || this.status === 'starting') {
+            throw new Error('Tunnel is already running or starting');
+        }
+        const installed = await this.isCloudflaredInstalled();
+        if (!installed) {
+            throw new Error('cloudflared is not installed. Install it with: winget install cloudflare.cloudflared (Windows) or brew install cloudflared (macOS)');
+        }
+        this.status = 'starting';
+        this.url = null;
+        return new Promise((resolve, reject) => {
+            const proc = spawn(this.cloudflaredPath, ['tunnel', '--url', `http://localhost:${port}`], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                shell: true,
+            });
+            this.process = proc;
+            const urlPattern = /https:\/\/[a-zA-Z0-9-]+\.trycloudflare\.com/;
+            let resolved = false;
+            // A timeout so we don't hang forever waiting for a URL
+            const timeout = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    this.status = 'error';
+                    this.emit('error', new Error('Timed out waiting for tunnel URL'));
+                    reject(new Error('Timed out waiting for tunnel URL (30s)'));
+                }
+            }, 30_000);
+            const handleOutput = (data) => {
+                const text = data.toString();
+                const match = text.match(urlPattern);
+                if (match && !resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    this.url = match[0];
+                    this.status = 'running';
+                    this.emit('url', this.url);
+                    resolve(this.url);
+                }
+            };
+            // cloudflared outputs the URL to stderr
+            proc.stderr?.on('data', handleOutput);
+            // Also check stdout just in case
+            proc.stdout?.on('data', handleOutput);
+            proc.on('error', (err) => {
+                clearTimeout(timeout);
+                this.status = 'error';
+                this.process = null;
+                this.emit('error', err);
+                if (!resolved) {
+                    resolved = true;
+                    reject(err);
+                }
+            });
+            proc.on('exit', (code) => {
+                clearTimeout(timeout);
+                this.process = null;
+                if (this.status === 'running') {
+                    this.status = 'stopped';
+                    this.url = null;
+                    this.emit('exit', code);
+                }
+                else if (!resolved) {
+                    resolved = true;
+                    this.status = 'error';
+                    reject(new Error(`cloudflared exited with code ${code} before producing a URL`));
+                }
+            });
+        });
+    }
+    /**
+     * Start a named cloudflared tunnel.
+     * Runs: cloudflared tunnel run <tunnelName>
+     * The URL comes from the tunnel's DNS configuration (not parsed from output).
+     */
+    async startNamedTunnel(tunnelName, port) {
+        if (this.status === 'running' || this.status === 'starting') {
+            throw new Error('Tunnel is already running or starting');
+        }
+        const installed = await this.isCloudflaredInstalled();
+        if (!installed) {
+            throw new Error('cloudflared is not installed. Install it with: winget install cloudflare.cloudflared (Windows) or brew install cloudflared (macOS)');
+        }
+        this.status = 'starting';
+        this.url = null;
+        return new Promise((resolve, reject) => {
+            const proc = spawn(this.cloudflaredPath, ['tunnel', '--url', `http://localhost:${port}`, 'run', tunnelName], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                shell: true,
+            });
+            this.process = proc;
+            let resolved = false;
+            // For named tunnels, look for a connection registration message
+            const connPattern = /connection.*registered|Registered tunnel connection/i;
+            const urlPattern = /https:\/\/[a-zA-Z0-9.-]+/;
+            const timeout = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    // Named tunnels may not output a URL, but the tunnel is running
+                    this.status = 'running';
+                    const inferredUrl = `https://${tunnelName}.cfargotunnel.com`;
+                    this.url = inferredUrl;
+                    this.emit('url', inferredUrl);
+                    resolve(inferredUrl);
+                }
+            }, 15_000);
+            const handleOutput = (data) => {
+                const text = data.toString();
+                if (connPattern.test(text) && !resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    // Try to find a URL in the output
+                    const match = text.match(urlPattern);
+                    this.url = match ? match[0] : `https://${tunnelName}.cfargotunnel.com`;
+                    this.status = 'running';
+                    this.emit('url', this.url);
+                    resolve(this.url);
+                }
+            };
+            proc.stderr?.on('data', handleOutput);
+            proc.stdout?.on('data', handleOutput);
+            proc.on('error', (err) => {
+                clearTimeout(timeout);
+                this.status = 'error';
+                this.process = null;
+                this.emit('error', err);
+                if (!resolved) {
+                    resolved = true;
+                    reject(err);
+                }
+            });
+            proc.on('exit', (code) => {
+                clearTimeout(timeout);
+                this.process = null;
+                if (this.status === 'running') {
+                    this.status = 'stopped';
+                    this.url = null;
+                    this.emit('exit', code);
+                }
+                else if (!resolved) {
+                    resolved = true;
+                    this.status = 'error';
+                    reject(new Error(`cloudflared exited with code ${code}`));
+                }
+            });
+        });
+    }
+    /**
+     * Stop the running cloudflared tunnel process.
+     */
+    async stopTunnel() {
+        if (!this.process) {
+            this.status = 'stopped';
+            this.url = null;
+            return;
+        }
+        return new Promise((resolve) => {
+            const proc = this.process;
+            const forceKillTimeout = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch {
+                    // Process may already be dead
+                }
+            }, 5_000);
+            proc.once('exit', () => {
+                clearTimeout(forceKillTimeout);
+                this.process = null;
+                this.status = 'stopped';
+                this.url = null;
+                resolve();
+            });
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch {
+                // Process may already be dead
+                clearTimeout(forceKillTimeout);
+                this.process = null;
+                this.status = 'stopped';
+                this.url = null;
+                resolve();
+            }
+        });
+    }
+    /**
+     * Get the current tunnel status and URL.
+     */
+    getTunnelStatus() {
+        return { status: this.status, url: this.url };
+    }
+    /**
+     * Resolve the full path to cloudflared, checking PATH first,
+     * then common Windows installation locations (winget, Program Files).
+     */
+    resolveCloudflaredPath() {
+        // 1) Try PATH first (works if cloudflared is globally accessible)
+        //    execFileSync would throw, so we just return the bare name and let the caller test it.
+        //    We'll verify in isCloudflaredInstalled.
+        if (process.platform === 'win32') {
+            const home = process.env.USERPROFILE || process.env.HOME || '';
+            const candidates = [
+                // winget package location
+                join(home, 'AppData', 'Local', 'Microsoft', 'WinGet', 'Packages', 'Cloudflare.cloudflared_Microsoft.Winget.Source_8wekyb3d8bbwe', 'cloudflared.exe'),
+                // winget links
+                join(home, 'AppData', 'Local', 'Microsoft', 'WinGet', 'Links', 'cloudflared.exe'),
+                // common manual install locations
+                join('C:', 'Program Files', 'cloudflared', 'cloudflared.exe'),
+                join('C:', 'Program Files (x86)', 'cloudflared', 'cloudflared.exe'),
+            ];
+            for (const candidate of candidates) {
+                if (existsSync(candidate)) {
+                    return candidate;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if cloudflared is installed by running 'cloudflared --version'.
+     * Falls back to known installation paths on Windows if not found in PATH.
+     */
+    async isCloudflaredInstalled() {
+        // First try the current cloudflaredPath (default: 'cloudflared' = from PATH)
+        const inPath = await new Promise((resolve) => {
+            execFile('cloudflared', ['--version'], { shell: true }, (error) => {
+                resolve(!error);
+            });
+        });
+        if (inPath) {
+            this.cloudflaredPath = 'cloudflared';
+            return true;
+        }
+        // Fallback: try known installation paths
+        const resolved = this.resolveCloudflaredPath();
+        if (resolved) {
+            const works = await new Promise((resolve) => {
+                execFile(resolved, ['--version'], (error) => {
+                    resolve(!error);
+                });
+            });
+            if (works) {
+                this.cloudflaredPath = resolved;
+                return true;
+            }
+        }
+        return false;
+    }
+}
+export const tunnelManager = new TunnelManager();
+//# sourceMappingURL=tunnel-manager.js.map

package/dist/server/services/tunnel-manager.js.map

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

package/dist/server/services/worktree-manager.d.ts

@@ -0,0 +1,117 @@
+export declare class WorktreeManager {
+    /**
+     * Sanitize a todo title into a valid branch name.
+     * Converts Korean/special chars to a safe slug, prefixed with "feature/".
+     */
+    sanitizeBranchName(title: string): string;
+    /**
+     * Check if a directory is inside a git repository.
+     */
+    isGitRepository(dirPath: string): Promise<boolean>;
+    /**
+     * Check if a directory is a valid git worktree (has .git file and can run git status).
+     */
+    isValidWorktree(worktreePath: string): Promise<boolean>;
+    /**
+     * Create a worktree for a todo item.
+     * Worktree path: <projectPath>/../worktrees/<branchName>
+     * Returns the absolute worktree path.
+     */
+    createWorktree(projectPath: string, branchName: string): Promise<string>;
+    /**
+     * Install npm dependencies in a worktree (root + client).
+     * Failures are logged but do not block worktree creation.
+     */
+    private installDependencies;
+    /**
+     * Remove a worktree and prune.
+     */
+    removeWorktree(projectPath: string, worktreePath: string): Promise<void>;
+    /**
+     * Remove a worktree, delete its branch, and clean up the DB record.
+     * Returns info about what was cleaned up.
+     */
+    cleanupWorktree(projectPath: string, worktreePath: string, branchName: string): Promise<{
+        worktreeRemoved: boolean;
+        branchDeleted: boolean;
+    }>;
+    /**
+     * Squash merge a source branch into a target worktree's branch.
+     * This takes all commits from sourceBranch and applies them as a single commit on the target.
+     */
+    squashMergeBranch(targetWorktreePath: string, sourceBranch: string): Promise<void>;
+    /**
+     * List all worktrees for a project.
+     */
+    listWorktrees(projectPath: string): Promise<Array<{
+        path: string;
+        branch: string;
+    }>>;
+    /**
+     * Get git status for a directory (repo or worktree).
+     * Returns branch info and file statuses.
+     */
+    /**
+     * Get git log (commit history) for a directory.
+     */
+    getGitLog(dirPath: string, options?: {
+        skip?: number;
+        limit?: number;
+    }): Promise<{
+        commits: Array<{
+            hash: string;
+            parentHashes: string[];
+            refs: string[];
+            message: string;
+            author: string;
+            date: string;
+        }>;
+        hasMore: boolean;
+    }>;
+    /**
+     * Get git refs (branches, tags, stash count) for a directory.
+     */
+    getGitRefs(dirPath: string): Promise<{
+        branches: Array<{
+            name: string;
+            current: boolean;
+            remote: boolean;
+        }>;
+        tags: string[];
+        stashCount: number;
+    }>;
+    gitStage(dirPath: string, files: string[]): Promise<void>;
+    gitUnstage(dirPath: string, files: string[]): Promise<void>;
+    gitCommit(dirPath: string, message: string): Promise<string>;
+    gitPull(dirPath: string, remote?: string, branch?: string): Promise<string>;
+    gitPush(dirPath: string, remote?: string, branch?: string, setUpstream?: boolean): Promise<string>;
+    gitFetch(dirPath: string, remote?: string, prune?: boolean): Promise<void>;
+    gitCreateBranch(dirPath: string, branchName: string, startPoint?: string): Promise<void>;
+    gitDeleteBranch(dirPath: string, branchName: string, force?: boolean): Promise<void>;
+    gitCheckout(dirPath: string, branchName: string): Promise<void>;
+    gitMerge(dirPath: string, sourceBranch: string): Promise<string>;
+    gitStashPush(dirPath: string, message?: string): Promise<void>;
+    gitStashPop(dirPath: string, index?: number): Promise<void>;
+    gitStashList(dirPath: string): Promise<Array<{
+        index: number;
+        message: string;
+    }>>;
+    gitDiscard(dirPath: string, files: string[]): Promise<void>;
+    gitDiscardAll(dirPath: string): Promise<void>;
+    gitCreateTag(dirPath: string, tagName: string, message?: string, commit?: string): Promise<void>;
+    gitDeleteTag(dirPath: string, tagName: string): Promise<void>;
+    gitDiff(dirPath: string, file?: string, staged?: boolean): Promise<string>;
+    getGitStatus(dirPath: string): Promise<{
+        branch: string;
+        tracking: string | null;
+        ahead: number;
+        behind: number;
+        files: Array<{
+            path: string;
+            index: string;
+            working_dir: string;
+        }>;
+    }>;
+}
+export declare const worktreeManager: WorktreeManager;
+//# sourceMappingURL=worktree-manager.d.ts.map

package/dist/server/services/worktree-manager.d.ts.map

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