@indigoai-us/hq-cli 5.1.0

package/dist/commands/initial-upload.js

@@ -0,0 +1,205 @@
+/**
+ * Initial HQ file upload for first-time cloud setup.
+ *
+ * After Clerk auth and Claude token setup, this command uploads the user's
+ * local HQ files to the cloud so the first session has access to the workspace.
+ *
+ * Respects the same ignore rules as sync (shouldIgnore from utils/sync.ts):
+ *   - .git/, node_modules/, .claude/, dist/, cdk.out/, etc.
+ *   - .log files, .env files, .DS_Store, Thumbs.db
+ *
+ * Exports `runInitialUpload` so it can be called programmatically from the
+ * create-hq installer (US-004) or other commands.
+ */
+import * as readline from 'readline';
+import chalk from 'chalk';
+import { apiRequest } from '../utils/api-client.js';
+import { walkDir, uploadFile, computeLocalManifest, readSyncState, writeSyncState, } from '../utils/sync.js';
+/**
+ * Prompt the user with a yes/no question on stdin.
+ * Returns true for 'y'/'yes', false for 'n'/'no'.
+ * Defaults to defaultAnswer if user just presses Enter.
+ */
+export function promptYesNo(question, defaultAnswer = true) {
+    const hint = defaultAnswer ? '[Y/n]' : '[y/N]';
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${question} ${hint} `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            if (trimmed === '') {
+                resolve(defaultAnswer);
+            }
+            else {
+                resolve(trimmed === 'y' || trimmed === 'yes');
+            }
+        });
+    });
+}
+/**
+ * Prompt the user to choose between merge and replace.
+ * Returns 'merge' or 'replace'.
+ */
+export function promptMergeOrReplace() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question('Choose [m]erge or [r]eplace: ', (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            if (trimmed === 'r' || trimmed === 'replace') {
+                resolve('replace');
+            }
+            else {
+                resolve('merge');
+            }
+        });
+    });
+}
+/**
+ * Delete all remote files (used when user chooses 'replace').
+ */
+async function deleteRemoteFiles() {
+    const resp = await apiRequest('DELETE', '/api/files/all');
+    if (!resp.ok) {
+        throw new Error(`Failed to clear remote files: ${resp.error ?? `HTTP ${resp.status}`}`);
+    }
+}
+/**
+ * Write a progress line that overwrites the previous line.
+ * Falls back to newline output if stdout is not a TTY (e.g., in tests or pipes).
+ */
+export function writeProgress(current, total) {
+    const pct = total > 0 ? Math.round((current / total) * 100) : 0;
+    const line = `Uploading: ${current}/${total} files (${pct}%)`;
+    if (process.stdout.isTTY) {
+        process.stdout.write(`\r${line}`);
+    }
+}
+/**
+ * Run the initial HQ file upload.
+ *
+ * This is the core function that:
+ * 1. Lists remote files via GET /api/files/list
+ * 2. If remote has files, asks user to merge or replace
+ * 3. Walks local files (respecting ignore rules)
+ * 4. Uploads all files with progress indicator
+ * 5. Updates sync state
+ *
+ * @param hqRoot - Absolute path to the HQ root directory
+ * @param options - Optional overrides (for testing / programmatic use)
+ * @returns Upload result with counts and any errors
+ */
+export async function runInitialUpload(hqRoot, options) {
+    const quiet = options?.quiet ?? false;
+    const log = (msg) => {
+        if (!quiet)
+            console.log(msg);
+    };
+    // 1. Check remote state
+    log(chalk.blue('Checking cloud storage...'));
+    let remoteFiles = [];
+    try {
+        const resp = await apiRequest('GET', '/api/files/list');
+        if (resp.ok && resp.data) {
+            remoteFiles = resp.data.files ?? [];
+        }
+    }
+    catch {
+        // If the endpoint doesn't exist yet or fails, treat as empty
+    }
+    // 2. Handle existing remote files
+    if (remoteFiles.length > 0) {
+        log('');
+        log(chalk.yellow(`Cloud storage already has ${remoteFiles.length} file${remoteFiles.length !== 1 ? 's' : ''}.`));
+        let action;
+        if (options?.onConflict) {
+            action = options.onConflict;
+        }
+        else {
+            log('  merge  — Upload local files, keeping existing remote files');
+            log('  replace — Delete all remote files first, then upload');
+            log('');
+            action = await promptMergeOrReplace();
+        }
+        if (action === 'skip') {
+            log(chalk.dim('Skipping upload.'));
+            return { totalFiles: 0, uploaded: 0, failed: 0, errors: [], skipped: true };
+        }
+        if (action === 'replace') {
+            log(chalk.dim('Clearing remote files...'));
+            await deleteRemoteFiles();
+            log(chalk.dim('Remote files cleared.'));
+        }
+        else {
+            log(chalk.dim('Merging: existing remote files will be preserved.'));
+        }
+    }
+    // 3. Walk local files
+    log(chalk.blue('Scanning local HQ files...'));
+    const localFiles = walkDir(hqRoot);
+    if (localFiles.length === 0) {
+        log(chalk.yellow('No files found to upload.'));
+        return { totalFiles: 0, uploaded: 0, failed: 0, errors: [], skipped: false };
+    }
+    log(chalk.dim(`  Found ${localFiles.length} file${localFiles.length !== 1 ? 's' : ''} to upload`));
+    log('');
+    // 4. Upload with progress
+    const errors = [];
+    let uploaded = 0;
+    for (let i = 0; i < localFiles.length; i++) {
+        const filePath = localFiles[i];
+        if (!quiet) {
+            writeProgress(i + 1, localFiles.length);
+        }
+        try {
+            await uploadFile(filePath, hqRoot);
+            uploaded++;
+        }
+        catch (err) {
+            errors.push(`${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Clear the progress line
+    if (!quiet && process.stdout.isTTY) {
+        process.stdout.write('\r' + ' '.repeat(60) + '\r');
+    }
+    // 5. Report results
+    if (errors.length === 0) {
+        log(chalk.green(`Uploaded ${uploaded}/${localFiles.length} files successfully.`));
+    }
+    else {
+        log(chalk.green(`Uploaded ${uploaded}/${localFiles.length} files.`));
+        log(chalk.yellow(`  ${errors.length} error${errors.length !== 1 ? 's' : ''}:`));
+        for (const err of errors.slice(0, 5)) {
+            log(chalk.red(`    - ${err}`));
+        }
+        if (errors.length > 5) {
+            log(chalk.dim(`    ... and ${errors.length - 5} more`));
+        }
+    }
+    // 6. Update sync state
+    const manifest = computeLocalManifest(hqRoot);
+    const state = readSyncState(hqRoot);
+    state.lastSync = new Date().toISOString();
+    state.fileCount = manifest.length;
+    state.errors = errors;
+    writeSyncState(hqRoot, state);
+    if (errors.length === 0) {
+        log('');
+        log(chalk.green('Sync status: in sync'));
+    }
+    return {
+        totalFiles: localFiles.length,
+        uploaded,
+        failed: errors.length,
+        errors,
+        skipped: false,
+    };
+}
+//# sourceMappingURL=initial-upload.js.map

package/dist/commands/initial-upload.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,6 @@
+/**
+ * hq modules list command (US-005)
+ */
+import { Command } from 'commander';
+export declare function registerListCommand(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD1D"}

package/dist/commands/list.js

@@ -0,0 +1,55 @@
+/**
+ * hq modules list command (US-005)
+ */
+import * as path from 'path';
+import { findHqRoot, readManifest, readLock, getModulesDir } from '../utils/manifest.js';
+import { isRepo, getCurrentCommit, isBehindRemote } from '../utils/git.js';
+export function registerListCommand(program) {
+    program
+        .command('list')
+        .alias('ls')
+        .description('List all modules and their status')
+        .action(async () => {
+        try {
+            const hqRoot = findHqRoot();
+            const manifest = readManifest(hqRoot);
+            if (!manifest || manifest.modules.length === 0) {
+                console.log('No modules in manifest. Use "hq modules add" to add modules.');
+                return;
+            }
+            const modulesDir = getModulesDir(hqRoot);
+            const lock = readLock(hqRoot);
+            console.log('Modules:\n');
+            for (const module of manifest.modules) {
+                const moduleDir = path.join(modulesDir, module.name);
+                const installed = await isRepo(moduleDir);
+                console.log(`  ${module.name}`);
+                console.log(`    Repo:     ${module.repo}`);
+                console.log(`    Branch:   ${module.branch || 'main'}`);
+                console.log(`    Strategy: ${module.strategy}`);
+                console.log(`    Paths:    ${module.paths.map(p => `${p.src} -> ${p.dest}`).join(', ')}`);
+                if (installed) {
+                    const commit = await getCurrentCommit(moduleDir);
+                    const shortCommit = commit.slice(0, 7);
+                    const lockedCommit = lock?.locked[module.name];
+                    const isLocked = lockedCommit === commit;
+                    console.log(`    Status:   ✓ installed @ ${shortCommit}${isLocked ? ' (locked)' : ''}`);
+                    // Check if behind upstream
+                    const { behind, commits } = await isBehindRemote(moduleDir);
+                    if (behind) {
+                        console.log(`    Updates:  ${commits} commit(s) behind remote`);
+                    }
+                }
+                else {
+                    console.log(`    Status:   ✗ not installed`);
+                }
+                console.log();
+            }
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,6 @@
+/**
+ * hq modules sync command (US-004)
+ */
+import { Command } from 'commander';
+export declare function registerSyncCommand(program: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsEpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwE1D"}

package/dist/commands/sync.js

@@ -0,0 +1,104 @@
+/**
+ * hq modules sync command (US-004)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { findHqRoot, readManifest, readLock, writeLock, getModulesDir, } from '../utils/manifest.js';
+import { cloneRepo, fetchRepo, pullRepo, getCurrentCommit, checkoutCommit, isRepo, ensureGitignore, } from '../utils/git.js';
+import { linkSync } from '../strategies/link.js';
+import { mergeSync } from '../strategies/merge.js';
+async function syncModule(module, moduleDir, hqRoot, locked, lockData) {
+    const repoExists = await isRepo(moduleDir);
+    // Clone or fetch
+    if (!repoExists) {
+        console.log(`  Cloning ${module.name}...`);
+        await cloneRepo(module.repo, moduleDir, module.branch);
+    }
+    else {
+        console.log(`  Fetching ${module.name}...`);
+        await fetchRepo(moduleDir);
+        // Checkout locked commit if --locked
+        if (locked && lockData?.locked[module.name]) {
+            await checkoutCommit(moduleDir, lockData.locked[module.name]);
+        }
+        else {
+            await pullRepo(moduleDir);
+        }
+    }
+    // Apply sync strategy
+    console.log(`  Syncing with strategy: ${module.strategy}`);
+    let result;
+    switch (module.strategy) {
+        case 'link':
+            result = await linkSync(module, moduleDir, hqRoot);
+            break;
+        case 'merge':
+        case 'copy':
+            result = await mergeSync(module, moduleDir, hqRoot);
+            break;
+        default:
+            result = {
+                module: module.name,
+                success: false,
+                action: 'skipped',
+                message: `Unknown strategy: ${module.strategy}`,
+            };
+    }
+    return result;
+}
+export function registerSyncCommand(program) {
+    program
+        .command('sync')
+        .description('Sync all modules from manifest')
+        .option('--locked', 'Use locked versions from modules.lock')
+        .action(async (options) => {
+        try {
+            const hqRoot = findHqRoot();
+            const manifest = readManifest(hqRoot);
+            if (!manifest || manifest.modules.length === 0) {
+                console.log('No modules in manifest. Use "hq modules add" to add modules.');
+                return;
+            }
+            const modulesDir = getModulesDir(hqRoot);
+            if (!fs.existsSync(modulesDir)) {
+                fs.mkdirSync(modulesDir, { recursive: true });
+            }
+            // Ensure modules/ is gitignored
+            ensureGitignore(hqRoot, 'modules/');
+            const lockData = options.locked ? readLock(hqRoot) : null;
+            const results = [];
+            const newLock = { version: '1', locked: {} };
+            console.log(`Syncing ${manifest.modules.length} module(s)...\n`);
+            for (const module of manifest.modules) {
+                console.log(`[${module.name}]`);
+                const moduleDir = path.join(modulesDir, module.name);
+                const result = await syncModule(module, moduleDir, hqRoot, options.locked ?? false, lockData);
+                results.push(result);
+                // Record commit for lock file
+                if (result.success) {
+                    const commit = await getCurrentCommit(moduleDir);
+                    newLock.locked[module.name] = commit;
+                }
+                const status = result.success ? '✓' : '✗';
+                const msg = result.message || `${result.filesChanged ?? 0} files`;
+                console.log(`  ${status} ${result.action}: ${msg}\n`);
+            }
+            // Write lock file (US-008)
+            if (!options.locked) {
+                writeLock(hqRoot, newLock);
+            }
+            // Summary
+            const success = results.filter(r => r.success).length;
+            const failed = results.filter(r => !r.success).length;
+            console.log(`Done: ${success} succeeded, ${failed} failed`);
+            if (failed > 0) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,7 @@
+/**
+ * hq modules update command (US-008)
+ * Updates lock for specific module
+ */
+import { Command } from 'commander';
+export declare function registerUpdateCommand(program: Command): void;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D5D"}

package/dist/commands/update.js

@@ -0,0 +1,60 @@
+/**
+ * hq modules update command (US-008)
+ * Updates lock for specific module
+ */
+import * as path from 'path';
+import { findHqRoot, readManifest, readLock, writeLock, getModulesDir } from '../utils/manifest.js';
+import { fetchRepo, pullRepo, getCurrentCommit, isRepo } from '../utils/git.js';
+export function registerUpdateCommand(program) {
+    program
+        .command('update [module-name]')
+        .description('Update lock for a specific module (or all if no name given)')
+        .action(async (moduleName) => {
+        try {
+            const hqRoot = findHqRoot();
+            const manifest = readManifest(hqRoot);
+            if (!manifest || manifest.modules.length === 0) {
+                console.log('No modules in manifest.');
+                return;
+            }
+            let lock = readLock(hqRoot);
+            if (!lock) {
+                lock = { version: '1', locked: {} };
+            }
+            const modulesDir = getModulesDir(hqRoot);
+            const modulesToUpdate = moduleName
+                ? manifest.modules.filter(m => m.name === moduleName)
+                : manifest.modules;
+            if (moduleName && modulesToUpdate.length === 0) {
+                console.error(`Module "${moduleName}" not found in manifest.`);
+                process.exit(1);
+            }
+            for (const module of modulesToUpdate) {
+                const moduleDir = path.join(modulesDir, module.name);
+                if (!await isRepo(moduleDir)) {
+                    console.log(`  ${module.name}: not installed, skipping`);
+                    continue;
+                }
+                console.log(`  ${module.name}: fetching...`);
+                await fetchRepo(moduleDir);
+                await pullRepo(moduleDir);
+                const commit = await getCurrentCommit(moduleDir);
+                const oldCommit = lock.locked[module.name];
+                lock.locked[module.name] = commit;
+                if (oldCommit === commit) {
+                    console.log(`  ${module.name}: already up to date @ ${commit.slice(0, 7)}`);
+                }
+                else {
+                    console.log(`  ${module.name}: updated ${oldCommit?.slice(0, 7) || 'none'} -> ${commit.slice(0, 7)}`);
+                }
+            }
+            writeLock(hqRoot, lock);
+            console.log('\nLock file updated.');
+        }
+        catch (error) {
+            console.error('Error:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * HQ CLI - Module management and cloud sync for HQ
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * HQ CLI - Module management and cloud sync for HQ
+ */
+import { Command } from "commander";
+import { registerAddCommand } from "./commands/add.js";
+import { registerSyncCommand } from "./commands/sync.js";
+import { registerListCommand } from "./commands/list.js";
+import { registerUpdateCommand } from "./commands/update.js";
+import { registerCloudCommands } from "./commands/cloud.js";
+import { registerAuthCommand } from "./commands/auth.js";
+import { registerCloudSetupCommand } from "./commands/cloud-setup.js";
+const program = new Command();
+program
+    .name("hq")
+    .description("HQ management CLI — modules and cloud sync")
+    .version("5.1.0");
+// Module management subcommand group
+const modulesCmd = program
+    .command("modules")
+    .description("Module management commands");
+registerAddCommand(modulesCmd);
+registerSyncCommand(modulesCmd);
+registerListCommand(modulesCmd);
+registerUpdateCommand(modulesCmd);
+// Cloud sync subcommand group
+const syncCmd = program
+    .command("sync")
+    .description("Cloud sync commands — sync HQ files via API proxy");
+registerCloudCommands(syncCmd);
+// Authentication commands (hq auth login|logout|status)
+registerAuthCommand(program);
+// Cloud session management (hq cloud setup-token|status)
+registerCloudSetupCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,4CAA4C,CAAC;KACzD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,qCAAqC;AACrC,MAAM,UAAU,GAAG,OAAO;KACvB,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,4BAA4B,CAAC,CAAC;AAE7C,kBAAkB,CAAC,UAAU,CAAC,CAAC;AAC/B,mBAAmB,CAAC,UAAU,CAAC,CAAC;AAChC,mBAAmB,CAAC,UAAU,CAAC,CAAC;AAChC,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAElC,8BAA8B;AAC9B,MAAM,OAAO,GAAG,OAAO;KACpB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,mDAAmD,CAAC,CAAC;AAEpE,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,wDAAwD;AACxD,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,yDAAyD;AACzD,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAEnC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/strategies/link.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Link Sync Strategy (US-006)
+ * Symlinks module paths into HQ tree
+ */
+import type { ModuleDefinition, SyncResult } from '../types.js';
+export declare function linkSync(module: ModuleDefinition, moduleDir: string, hqRoot: string): Promise<SyncResult>;
+//# sourceMappingURL=link.d.ts.map

package/dist/strategies/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/strategies/link.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhE,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAgDrB"}

package/dist/strategies/link.js

@@ -0,0 +1,51 @@
+/**
+ * Link Sync Strategy (US-006)
+ * Symlinks module paths into HQ tree
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export async function linkSync(module, moduleDir, hqRoot) {
+    let filesChanged = 0;
+    for (const mapping of module.paths) {
+        const srcPath = path.join(moduleDir, mapping.src);
+        const destPath = path.join(hqRoot, mapping.dest);
+        // Validate source exists
+        if (!fs.existsSync(srcPath)) {
+            return {
+                module: module.name,
+                success: false,
+                action: 'skipped',
+                message: `Source path not found: ${mapping.src}`,
+            };
+        }
+        // Ensure dest parent directory exists
+        const destDir = path.dirname(destPath);
+        if (!fs.existsSync(destDir)) {
+            fs.mkdirSync(destDir, { recursive: true });
+        }
+        // Handle existing dest
+        if (fs.existsSync(destPath)) {
+            const stat = fs.lstatSync(destPath);
+            if (stat.isSymbolicLink()) {
+                // Remove existing symlink and recreate
+                fs.unlinkSync(destPath);
+            }
+            else {
+                // Real file exists - warn and skip
+                console.warn(`  Warning: Real file exists at ${mapping.dest}, skipping`);
+                continue;
+            }
+        }
+        // Create relative symlink for portability
+        const relativeSrc = path.relative(destDir, srcPath);
+        fs.symlinkSync(relativeSrc, destPath);
+        filesChanged++;
+    }
+    return {
+        module: module.name,
+        success: true,
+        action: 'synced',
+        filesChanged,
+    };
+}
+//# sourceMappingURL=link.js.map

package/dist/strategies/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/strategies/link.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAwB,EACxB,SAAiB,EACjB,MAAc;IAEd,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjD,yBAAyB;QACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,0BAA0B,OAAO,CAAC,GAAG,EAAE;aACjD,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,uBAAuB;QACvB,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC1B,uCAAuC;gBACvC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,mCAAmC;gBACnC,OAAO,CAAC,IAAI,CAAC,kCAAkC,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC;gBACzE,SAAS;YACX,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtC,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,QAAQ;QAChB,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/strategies/merge.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Merge Sync Strategy (US-007)
+ * Copies files from module into HQ, tracks state for conflict detection
+ */
+import type { ModuleDefinition, SyncResult } from '../types.js';
+export declare function mergeSync(module: ModuleDefinition, moduleDir: string, hqRoot: string): Promise<SyncResult>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/strategies/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/strategies/merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AA8D3E,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAmErB"}