chatroom-cli 1.30.1 → 1.32.1

package/dist/infrastructure/services/workspace/command-discovery.js

@@ -0,0 +1,193 @@
+/**
+ * Command Discovery — scans workspace package.json and turbo.json for available commands.
+ *
+ * Discovers:
+ * - Root package.json "scripts" entries (run via detected package manager)
+ * - Root turbo.json "tasks" entries (run via detected package manager's turbo)
+ * - Monorepo sub-package scripts (run via --filter / workspace syntax)
+ * - Per-package turbo task variants (run via --filter)
+ *
+ * Detects the package manager from lockfiles:
+ * - pnpm-lock.yaml → pnpm
+ * - yarn.lock → yarn
+ * - bun.lockb / bun.lock → bun
+ * - package-lock.json → npm (default fallback)
+ *
+ * Returns a flat list of commands with name, script, and source.
+ */
+import { access } from 'node:fs/promises';
+import { readFile } from 'node:fs/promises';
+import { join, relative, basename } from 'node:path';
+import { resolveSubWorkspaces } from './workspace-resolver.js';
+/** Max length for command name and script to prevent abuse. */
+const MAX_NAME_LENGTH = 256;
+const MAX_SCRIPT_LENGTH = 4096;
+// ─── Package Manager Detection ─────────────────────────────────────────────
+/**
+ * Lockfile names in priority order.
+ * First match wins — pnpm > yarn > bun > npm.
+ */
+const LOCKFILE_MAP = [
+    { file: 'pnpm-lock.yaml', manager: 'pnpm' },
+    { file: 'yarn.lock', manager: 'yarn' },
+    { file: 'bun.lockb', manager: 'bun' },
+    { file: 'bun.lock', manager: 'bun' },
+    { file: 'package-lock.json', manager: 'npm' },
+];
+/**
+ * Detect the package manager for a workspace by checking for lockfiles.
+ * Returns 'npm' as the default if no lockfile is found.
+ */
+export async function detectPackageManager(workingDir) {
+    for (const { file, manager } of LOCKFILE_MAP) {
+        try {
+            await access(join(workingDir, file));
+            return manager;
+        }
+        catch {
+            // File doesn't exist — try next
+        }
+    }
+    return 'npm'; // Default fallback
+}
+// ─── Command Prefix Helpers ─────────────────────────────────────────────────
+/**
+ * Get the command prefix for running package.json scripts.
+ * e.g. "pnpm run", "yarn run", "bun run", "npm run"
+ */
+export function getScriptRunPrefix(pm) {
+    return `${pm} run`;
+}
+/**
+ * Get the command prefix for running turbo tasks.
+ * Uses the package manager to invoke turbo (avoids requiring global install).
+ */
+export function getTurboRunPrefix(pm) {
+    switch (pm) {
+        case 'pnpm':
+            return 'pnpm turbo run';
+        case 'yarn':
+            return 'yarn turbo run';
+        case 'bun':
+            return 'bun turbo run';
+        case 'npm':
+        default:
+            return 'npx turbo run';
+    }
+}
+/**
+ * Get the command for running a script in a specific workspace package.
+ * Uses the package manager's filter/workspace syntax.
+ */
+export function getFilteredScriptCommand(pm, packageName, scriptName) {
+    switch (pm) {
+        case 'pnpm':
+            return `pnpm --filter ${packageName} run ${scriptName}`;
+        case 'yarn':
+            return `yarn workspace ${packageName} run ${scriptName}`;
+        case 'bun':
+            return `bun --filter ${packageName} run ${scriptName}`;
+        case 'npm':
+        default:
+            return `npm --workspace=${packageName} run ${scriptName}`;
+    }
+}
+/**
+ * Get the command for running a turbo task filtered to a specific package.
+ */
+export function getFilteredTurboCommand(pm, packageName, taskName) {
+    const prefix = getTurboRunPrefix(pm);
+    return `${prefix} ${taskName} --filter=${packageName}`;
+}
+// ─── Discovery ──────────────────────────────────────────────────────────────
+/**
+ * Discover available commands from a workspace directory.
+ * Reads package.json scripts and turbo.json tasks from root and all sub-packages.
+ * Detects the package manager from lockfiles to use the correct runner.
+ */
+export async function discoverCommands(workingDir) {
+    const commands = [];
+    const pm = await detectPackageManager(workingDir);
+    const scriptPrefix = getScriptRunPrefix(pm);
+    const turboPrefix = getTurboRunPrefix(pm);
+    // Collect turbo task names for per-package variants
+    const turboTaskNames = [];
+    // 1. Parse root package.json — read name and scripts in a single pass
+    let rootPackageName = basename(workingDir);
+    try {
+        const pkgPath = join(workingDir, 'package.json');
+        const pkgContent = await readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(pkgContent);
+        if (pkg.name)
+            rootPackageName = pkg.name;
+        if (pkg.scripts && typeof pkg.scripts === 'object') {
+            const rootSw = { type: 'npm', path: '.', name: rootPackageName };
+            for (const [name, script] of Object.entries(pkg.scripts)) {
+                if (typeof script === 'string' && name.length <= MAX_NAME_LENGTH && script.length <= MAX_SCRIPT_LENGTH) {
+                    commands.push({
+                        name: `${pm}: ${name}`,
+                        script: `${scriptPrefix} ${name}`,
+                        source: 'package.json',
+                        subWorkspace: rootSw,
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // package.json doesn't exist or is invalid — skip
+    }
+    const rootSubWorkspace = { type: 'npm', path: '.', name: rootPackageName };
+    // 2. Parse turbo.json tasks (root-level, all packages)
+    try {
+        const turboPath = join(workingDir, 'turbo.json');
+        const turboContent = await readFile(turboPath, 'utf-8');
+        const turbo = JSON.parse(turboContent);
+        if (turbo.tasks && typeof turbo.tasks === 'object') {
+            for (const taskName of Object.keys(turbo.tasks)) {
+                if (taskName.length <= MAX_NAME_LENGTH) {
+                    turboTaskNames.push(taskName);
+                    commands.push({
+                        name: `turbo: ${taskName}`,
+                        script: `${turboPrefix} ${taskName}`,
+                        source: 'turbo.json',
+                        subWorkspace: rootSubWorkspace,
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // turbo.json doesn't exist or is invalid — skip
+    }
+    // 3. Discover sub-workspace packages for monorepo support
+    const subWorkspaces = await resolveSubWorkspaces(workingDir, pm);
+    for (const pkg of subWorkspaces) {
+        const wsPath = relative(workingDir, pkg.dir) || '.';
+        const pkgSubWorkspace = { type: 'npm', path: wsPath, name: pkg.name };
+        // 3a. Per-package turbo task variants (filtered)
+        for (const taskName of turboTaskNames) {
+            commands.push({
+                name: `turbo: ${taskName} (${pkg.name})`,
+                script: getFilteredTurboCommand(pm, pkg.name, taskName),
+                source: 'turbo.json',
+                subWorkspace: pkgSubWorkspace,
+            });
+        }
+        // 3b. Per-package script commands
+        for (const [scriptName, scriptValue] of Object.entries(pkg.scripts)) {
+            if (typeof scriptValue === 'string' &&
+                scriptName.length <= MAX_NAME_LENGTH &&
+                scriptValue.length <= MAX_SCRIPT_LENGTH) {
+                commands.push({
+                    name: `${pkg.name}: ${scriptName}`,
+                    script: getFilteredScriptCommand(pm, pkg.name, scriptName),
+                    source: 'package.json',
+                    subWorkspace: pkgSubWorkspace,
+                });
+            }
+        }
+    }
+    return commands;
+}
+//# sourceMappingURL=command-discovery.js.map

package/dist/infrastructure/services/workspace/command-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-discovery.js","sourceRoot":"","sources":["../../../../src/infrastructure/services/workspace/command-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAwB/D,+DAA+D;AAC/D,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,YAAY,GAAqD;IACrE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE;IAC3C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;IACtC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE;IACrC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE;IACpC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IAC3D,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,YAAY,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,mBAAmB;AACnC,CAAC;AAED,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAkB;IACnD,OAAO,GAAG,EAAE,MAAM,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC;QAC1B,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK,CAAC;QACX;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAkB,EAClB,WAAmB,EACnB,UAAkB;IAElB,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,MAAM;YACT,OAAO,iBAAiB,WAAW,QAAQ,UAAU,EAAE,CAAC;QAC1D,KAAK,MAAM;YACT,OAAO,kBAAkB,WAAW,QAAQ,UAAU,EAAE,CAAC;QAC3D,KAAK,KAAK;YACR,OAAO,gBAAgB,WAAW,QAAQ,UAAU,EAAE,CAAC;QACzD,KAAK,KAAK,CAAC;QACX;YACE,OAAO,mBAAmB,WAAW,QAAQ,UAAU,EAAE,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,EAAkB,EAClB,WAAmB,EACnB,QAAgB;IAEhB,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,GAAG,MAAM,IAAI,QAAQ,aAAa,WAAW,EAAE,CAAC;AACzD,CAAC;AAED,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAE1C,oDAAoD;IACpD,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,sEAAsE;IACtE,IAAI,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAwD,CAAC;QAE1F,IAAI,GAAG,CAAC,IAAI;YAAE,eAAe,GAAG,GAAG,CAAC,IAAI,CAAC;QAEzC,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,MAAM,GAAqB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;YACnF,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;oBACvG,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE;wBACtB,MAAM,EAAE,GAAG,YAAY,IAAI,IAAI,EAAE;wBACjC,MAAM,EAAE,cAAc;wBACtB,YAAY,EAAE,MAAM;qBACrB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IAED,MAAM,gBAAgB,GAAqB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAE7F,uDAAuD;IACvD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAwC,CAAC;QAE9E,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,IAAI,QAAQ,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;oBACvC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC9B,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,UAAU,QAAQ,EAAE;wBAC1B,MAAM,EAAE,GAAG,WAAW,IAAI,QAAQ,EAAE;wBACpC,MAAM,EAAE,YAAY;wBACpB,YAAY,EAAE,gBAAgB;qBAC/B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IAED,0DAA0D;IAC1D,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEjE,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QACpD,MAAM,eAAe,GAAqB,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAExF,iDAAiD;QACjD,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU,QAAQ,KAAK,GAAG,CAAC,IAAI,GAAG;gBACxC,MAAM,EAAE,uBAAuB,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;gBACvD,MAAM,EAAE,YAAY;gBACpB,YAAY,EAAE,eAAe;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,IACE,OAAO,WAAW,KAAK,QAAQ;gBAC/B,UAAU,CAAC,MAAM,IAAI,eAAe;gBACpC,WAAW,CAAC,MAAM,IAAI,iBAAiB,EACvC,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE;oBAClC,MAAM,EAAE,wBAAwB,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC;oBAC1D,MAAM,EAAE,cAAc;oBACtB,YAAY,EAAE,eAAe;iBAC9B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/infrastructure/services/workspace/command-discovery.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Command Discovery — Tests
+ *
+ * Tests monorepo command generation across all package managers.
+ */
+export {};
+//# sourceMappingURL=command-discovery.test.d.ts.map

package/dist/infrastructure/services/workspace/command-discovery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-discovery.test.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/workspace/command-discovery.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/infrastructure/services/workspace/command-discovery.test.js

@@ -0,0 +1,182 @@
+/**
+ * Command Discovery — Tests
+ *
+ * Tests monorepo command generation across all package managers.
+ */
+import { describe, expect, test, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, writeFile, mkdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { discoverCommands, detectPackageManager, getFilteredScriptCommand, getFilteredTurboCommand, getTurboRunPrefix, getScriptRunPrefix, } from './command-discovery.js';
+let testDir;
+beforeEach(async () => {
+    testDir = await mkdtemp(join(tmpdir(), 'command-discovery-'));
+});
+afterEach(async () => {
+    await rm(testDir, { recursive: true, force: true });
+});
+// ─── Helpers ────────────────────────────────────────────────────────────────
+async function createPackageJson(dir, pkg) {
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, 'package.json'), JSON.stringify(pkg, null, 2));
+}
+// ─── Package Manager Detection ──────────────────────────────────────────────
+describe('detectPackageManager', () => {
+    test('detects pnpm from pnpm-lock.yaml', async () => {
+        await createPackageJson(testDir, { name: 'root' });
+        await writeFile(join(testDir, 'pnpm-lock.yaml'), '');
+        expect(await detectPackageManager(testDir)).toBe('pnpm');
+    });
+    test('detects yarn from yarn.lock', async () => {
+        await createPackageJson(testDir, { name: 'root' });
+        await writeFile(join(testDir, 'yarn.lock'), '');
+        expect(await detectPackageManager(testDir)).toBe('yarn');
+    });
+    test('detects bun from bun.lockb', async () => {
+        await createPackageJson(testDir, { name: 'root' });
+        await writeFile(join(testDir, 'bun.lockb'), '');
+        expect(await detectPackageManager(testDir)).toBe('bun');
+    });
+    test('detects npm from package-lock.json', async () => {
+        await createPackageJson(testDir, { name: 'root' });
+        await writeFile(join(testDir, 'package-lock.json'), '{}');
+        expect(await detectPackageManager(testDir)).toBe('npm');
+    });
+    test('defaults to npm when no lockfile found', async () => {
+        await createPackageJson(testDir, { name: 'root' });
+        expect(await detectPackageManager(testDir)).toBe('npm');
+    });
+    test('pnpm has priority over yarn', async () => {
+        await createPackageJson(testDir, { name: 'root' });
+        await writeFile(join(testDir, 'pnpm-lock.yaml'), '');
+        await writeFile(join(testDir, 'yarn.lock'), '');
+        expect(await detectPackageManager(testDir)).toBe('pnpm');
+    });
+});
+// ─── Command Prefix Helpers ─────────────────────────────────────────────────
+describe('command prefixes', () => {
+    test('getScriptRunPrefix returns correct prefixes', () => {
+        expect(getScriptRunPrefix('pnpm')).toBe('pnpm run');
+        expect(getScriptRunPrefix('yarn')).toBe('yarn run');
+        expect(getScriptRunPrefix('bun')).toBe('bun run');
+        expect(getScriptRunPrefix('npm')).toBe('npm run');
+    });
+    test('getTurboRunPrefix returns correct prefixes', () => {
+        expect(getTurboRunPrefix('pnpm')).toBe('pnpm turbo run');
+        expect(getTurboRunPrefix('yarn')).toBe('yarn turbo run');
+        expect(getTurboRunPrefix('bun')).toBe('bun turbo run');
+        expect(getTurboRunPrefix('npm')).toBe('npx turbo run');
+    });
+    test('getFilteredScriptCommand for all PMs', () => {
+        expect(getFilteredScriptCommand('pnpm', 'my-pkg', 'build')).toBe('pnpm --filter my-pkg run build');
+        expect(getFilteredScriptCommand('yarn', 'my-pkg', 'build')).toBe('yarn workspace my-pkg run build');
+        expect(getFilteredScriptCommand('bun', 'my-pkg', 'build')).toBe('bun --filter my-pkg run build');
+        expect(getFilteredScriptCommand('npm', 'my-pkg', 'build')).toBe('npm --workspace=my-pkg run build');
+    });
+    test('getFilteredTurboCommand for all PMs', () => {
+        expect(getFilteredTurboCommand('pnpm', 'my-pkg', 'build')).toBe('pnpm turbo run build --filter=my-pkg');
+        expect(getFilteredTurboCommand('yarn', 'my-pkg', 'build')).toBe('yarn turbo run build --filter=my-pkg');
+        expect(getFilteredTurboCommand('bun', 'my-pkg', 'build')).toBe('bun turbo run build --filter=my-pkg');
+        expect(getFilteredTurboCommand('npm', 'my-pkg', 'build')).toBe('npx turbo run build --filter=my-pkg');
+    });
+});
+// ─── Full Discovery (monorepo) ──────────────────────────────────────────────
+describe('discoverCommands — monorepo', () => {
+    test('discovers root + turbo + per-package commands in pnpm monorepo', async () => {
+        // Create lockfile
+        await writeFile(join(testDir, 'pnpm-lock.yaml'), '');
+        // Root package.json
+        await createPackageJson(testDir, {
+            name: 'root',
+            scripts: { test: 'turbo run test', dev: 'turbo run dev' },
+        });
+        // Turbo config
+        await writeFile(join(testDir, 'turbo.json'), JSON.stringify({ tasks: { build: {}, typecheck: {} } }));
+        // pnpm-workspace.yaml
+        await writeFile(join(testDir, 'pnpm-workspace.yaml'), "packages:\n  - 'packages/*'\n");
+        // Sub-package
+        await createPackageJson(join(testDir, 'packages/cli'), {
+            name: 'my-cli',
+            scripts: { build: 'tsc', test: 'vitest' },
+        });
+        const commands = await discoverCommands(testDir);
+        // Root scripts
+        expect(commands).toContainEqual({
+            name: 'pnpm: test',
+            script: 'pnpm run test',
+            source: 'package.json', subWorkspace: { type: 'npm', path: '.', name: 'root' },
+        });
+        // Root turbo tasks
+        expect(commands).toContainEqual({
+            name: 'turbo: build',
+            script: 'pnpm turbo run build',
+            source: 'turbo.json', subWorkspace: { type: 'npm', path: '.', name: 'root' },
+        });
+        // Filtered turbo tasks
+        expect(commands).toContainEqual({
+            name: 'turbo: build (my-cli)',
+            script: 'pnpm turbo run build --filter=my-cli',
+            source: 'turbo.json', subWorkspace: { type: 'npm', path: 'packages/cli', name: 'my-cli' },
+        });
+        // Per-package script commands
+        expect(commands).toContainEqual({
+            name: 'my-cli: build',
+            script: 'pnpm --filter my-cli run build',
+            source: 'package.json', subWorkspace: { type: 'npm', path: 'packages/cli', name: 'my-cli' },
+        });
+        expect(commands).toContainEqual({
+            name: 'my-cli: test',
+            script: 'pnpm --filter my-cli run test',
+            source: 'package.json', subWorkspace: { type: 'npm', path: 'packages/cli', name: 'my-cli' },
+        });
+    });
+    test('discovers commands in yarn monorepo', async () => {
+        await writeFile(join(testDir, 'yarn.lock'), '');
+        await createPackageJson(testDir, {
+            name: 'root',
+            workspaces: ['apps/*'],
+            scripts: { lint: 'eslint .' },
+        });
+        await writeFile(join(testDir, 'turbo.json'), JSON.stringify({ tasks: { build: {} } }));
+        await createPackageJson(join(testDir, 'apps/web'), {
+            name: '@my/web',
+            scripts: { dev: 'next dev' },
+        });
+        const commands = await discoverCommands(testDir);
+        // Root
+        expect(commands).toContainEqual({
+            name: 'yarn: lint',
+            script: 'yarn run lint',
+            source: 'package.json', subWorkspace: { type: 'npm', path: '.', name: 'root' },
+        });
+        // Turbo filtered
+        expect(commands).toContainEqual({
+            name: 'turbo: build (@my/web)',
+            script: 'yarn turbo run build --filter=@my/web',
+            source: 'turbo.json', subWorkspace: { type: 'npm', path: 'apps/web', name: '@my/web' },
+        });
+        // Per-package
+        expect(commands).toContainEqual({
+            name: '@my/web: dev',
+            script: 'yarn workspace @my/web run dev',
+            source: 'package.json', subWorkspace: { type: 'npm', path: 'apps/web', name: '@my/web' },
+        });
+    });
+    test('works with no workspace packages (single-package project)', async () => {
+        await writeFile(join(testDir, 'package-lock.json'), '{}');
+        await createPackageJson(testDir, {
+            name: 'single-app',
+            scripts: { start: 'node index.js' },
+        });
+        const commands = await discoverCommands(testDir);
+        expect(commands).toContainEqual({
+            name: 'npm: start',
+            script: 'npm run start',
+            source: 'package.json', subWorkspace: { type: 'npm', path: '.', name: 'single-app' },
+        });
+        // No workspace-specific commands
+        const filtered = commands.filter((c) => c.name.includes('('));
+        expect(filtered).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=command-discovery.test.js.map

package/dist/infrastructure/services/workspace/command-discovery.test.js.map

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

package/dist/infrastructure/services/workspace/file-tree-scanner.d.ts

@@ -0,0 +1,47 @@
+/**
+ * File tree scanner for workspace directories.
+ *
+ * NOTE: "workspace" here refers to a chatroom workspace (the workingDir / project root),
+ * not a package manager sub-workspace (e.g., monorepo packages). For sub-workspace
+ * resolution, see workspace-resolver.ts.
+ *
+ * Uses `git ls-files` for fast scanning that respects .gitignore.
+ * Falls back to tracked + untracked files approach.
+ * Produces a flat array of FileTreeEntry objects.
+ */
+export type FileTreeEntry = {
+    path: string;
+    type: 'file' | 'directory';
+    size?: number;
+};
+export type FileTree = {
+    entries: FileTreeEntry[];
+    scannedAt: number;
+    rootDir: string;
+};
+export type ScanOptions = {
+    maxEntries?: number;
+};
+/**
+ * Scans the file tree of a workspace directory.
+ *
+ * Uses `git ls-files` for tracked files and
+ * `git ls-files --others --exclude-standard` for untracked files.
+ * This is fast and respects .gitignore natively.
+ *
+ * @param rootDir - Absolute path to the workspace root
+ * @param options - Optional: maxEntries cap (default 10,000)
+ * @returns FileTree with flat array of entries
+ */
+export declare function scanFileTree(rootDir: string, options?: ScanOptions): Promise<FileTree>;
+/** Check if a path contains an always-excluded directory segment. */
+export declare function isExcluded(filePath: string): boolean;
+/** Check if a path matches any exclude pattern (case-insensitive). */
+export declare function matchesExcludePattern(filePath: string): boolean;
+/**
+ * Build FileTreeEntry array from file paths.
+ * Derives directory entries from the file paths.
+ * Caps at maxEntries total (files + directories).
+ */
+export declare function buildEntries(filePaths: string[], rootDir: string, maxEntries: number): FileTreeEntry[];
+//# sourceMappingURL=file-tree-scanner.d.ts.map

package/dist/infrastructure/services/workspace/file-tree-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tree-scanner.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/workspace/file-tree-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAyCF;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAsDD,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,aAAa,EAAE,CA6BjB"}

package/dist/infrastructure/services/workspace/file-tree-scanner.js

@@ -0,0 +1,159 @@
+/**
+ * File tree scanner for workspace directories.
+ *
+ * NOTE: "workspace" here refers to a chatroom workspace (the workingDir / project root),
+ * not a package manager sub-workspace (e.g., monorepo packages). For sub-workspace
+ * resolution, see workspace-resolver.ts.
+ *
+ * Uses `git ls-files` for fast scanning that respects .gitignore.
+ * Falls back to tracked + untracked files approach.
+ * Produces a flat array of FileTreeEntry objects.
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+// ─── Constants ──────────────────────────────────────────────────────────────
+const DEFAULT_MAX_ENTRIES = 10_000;
+/** Directories to always exclude (even outside git repos or if git misbehaves). */
+const ALWAYS_EXCLUDE = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    'coverage',
+    '__pycache__',
+    '.turbo',
+    // Additional common patterns that cause noise in file pickers
+    '.cache',
+    '.tmp',
+    'tmp',
+    '.DS_Store',
+]);
+/** Patterns to exclude at the file level (any path component matching these globs). */
+const EXCLUDE_PATTERNS = [
+    /node_modules/i,
+    /\.git/i,
+    /dist/i,
+    /build/i,
+    /\.next/i,
+    /coverage/i,
+    /__pycache__/i,
+    /\.turbo/i,
+    /\.cache/i,
+    /\.tmp/i,
+    /tmp/i,
+    /\.DS_Store/i,
+];
+// ─── Scanner ────────────────────────────────────────────────────────────────
+/**
+ * Scans the file tree of a workspace directory.
+ *
+ * Uses `git ls-files` for tracked files and
+ * `git ls-files --others --exclude-standard` for untracked files.
+ * This is fast and respects .gitignore natively.
+ *
+ * @param rootDir - Absolute path to the workspace root
+ * @param options - Optional: maxEntries cap (default 10,000)
+ * @returns FileTree with flat array of entries
+ */
+export async function scanFileTree(rootDir, options) {
+    const maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const scannedAt = Date.now();
+    const filePaths = await getGitFiles(rootDir);
+    // Filter out always-excluded directories and patterns
+    const filteredPaths = filePaths.filter((p) => !isExcluded(p) && !matchesExcludePattern(p));
+    // Derive directories from file paths and build entries
+    const entries = buildEntries(filteredPaths, rootDir, maxEntries);
+    return {
+        entries,
+        scannedAt,
+        rootDir,
+    };
+}
+// ─── Internal Helpers ───────────────────────────────────────────────────────
+/**
+ * Gets all files using git ls-files (tracked + untracked).
+ * Returns relative paths from rootDir.
+ */
+async function getGitFiles(rootDir) {
+    const env = {
+        ...process.env,
+        GIT_TERMINAL_PROMPT: '0',
+        GIT_PAGER: 'cat',
+        NO_COLOR: '1',
+    };
+    try {
+        // Get tracked files
+        const tracked = await execAsync('git ls-files', {
+            cwd: rootDir,
+            env,
+            maxBuffer: 10 * 1024 * 1024, // 10MB buffer for large repos
+        });
+        // Get untracked files (respects .gitignore)
+        const untracked = await execAsync('git ls-files --others --exclude-standard', {
+            cwd: rootDir,
+            env,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        const trackedFiles = parseLines(tracked.stdout);
+        const untrackedFiles = parseLines(untracked.stdout);
+        // Combine and deduplicate
+        const allFiles = new Set([...trackedFiles, ...untrackedFiles]);
+        return Array.from(allFiles);
+    }
+    catch {
+        // Not a git repo or git not available — return empty
+        return [];
+    }
+}
+/** Parse newline-separated output into non-empty lines. */
+function parseLines(output) {
+    return output
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+/** Check if a path contains an always-excluded directory segment. */
+export function isExcluded(filePath) {
+    const segments = filePath.split('/');
+    return segments.some((segment) => ALWAYS_EXCLUDE.has(segment));
+}
+/** Check if a path matches any exclude pattern (case-insensitive). */
+export function matchesExcludePattern(filePath) {
+    return EXCLUDE_PATTERNS.some((pattern) => pattern.test(filePath));
+}
+/**
+ * Build FileTreeEntry array from file paths.
+ * Derives directory entries from the file paths.
+ * Caps at maxEntries total (files + directories).
+ */
+export function buildEntries(filePaths, rootDir, maxEntries) {
+    // Collect unique directories
+    const directories = new Set();
+    for (const filePath of filePaths) {
+        const parts = filePath.split('/');
+        // Add all parent directories
+        for (let i = 1; i < parts.length; i++) {
+            directories.add(parts.slice(0, i).join('/'));
+        }
+    }
+    // Build entries: directories first, then files
+    const entries = [];
+    // Add directory entries
+    const sortedDirs = Array.from(directories).sort();
+    for (const dir of sortedDirs) {
+        if (entries.length >= maxEntries)
+            break;
+        entries.push({ path: dir, type: 'directory' });
+    }
+    // Add file entries
+    const sortedFiles = filePaths.slice().sort();
+    for (const file of sortedFiles) {
+        if (entries.length >= maxEntries)
+            break;
+        entries.push({ path: file, type: 'file' });
+    }
+    return entries;
+}
+//# sourceMappingURL=file-tree-scanner.js.map

package/dist/infrastructure/services/workspace/file-tree-scanner.js.map

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

package/dist/infrastructure/services/workspace/file-tree-scanner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-tree-scanner.test.d.ts.map

package/dist/infrastructure/services/workspace/file-tree-scanner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tree-scanner.test.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/workspace/file-tree-scanner.test.ts"],"names":[],"mappings":""}