@indigoai-us/hq-cli 5.1.0

package/dist/strategies/merge.js

@@ -0,0 +1,110 @@
+/**
+ * Merge Sync Strategy (US-007)
+ * Copies files from module into HQ, tracks state for conflict detection
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { readState, writeState } from '../utils/manifest.js';
+function hashFile(filePath) {
+    const content = fs.readFileSync(filePath);
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+function copyRecursive(srcDir, destDir, state, moduleName, hqRoot, filesChanged) {
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            copyRecursive(srcPath, destPath, state, moduleName, hqRoot, filesChanged);
+        }
+        else {
+            const relativeDest = path.relative(hqRoot, destPath).replace(/\\/g, '/');
+            const newHash = hashFile(srcPath);
+            // Check if file exists and has been modified by user
+            if (fs.existsSync(destPath)) {
+                const existingHash = hashFile(destPath);
+                const lastSyncedHash = state.files[relativeDest]?.hash;
+                if (lastSyncedHash && existingHash !== lastSyncedHash && existingHash !== newHash) {
+                    // User modified the file since last sync - skip (conflict)
+                    console.warn(`  Conflict: ${relativeDest} has local changes, skipping`);
+                    continue;
+                }
+                if (existingHash === newHash) {
+                    // File unchanged, skip
+                    continue;
+                }
+            }
+            // Copy file
+            fs.copyFileSync(srcPath, destPath);
+            filesChanged.count++;
+            // Track in state
+            state.files[relativeDest] = {
+                hash: newHash,
+                syncedAt: new Date().toISOString(),
+                fromModule: moduleName,
+            };
+        }
+    }
+}
+export async function mergeSync(module, moduleDir, hqRoot) {
+    let state = readState(hqRoot);
+    if (!state) {
+        state = { version: '1', files: {} };
+    }
+    const filesChanged = { count: 0 };
+    for (const mapping of module.paths) {
+        const srcPath = path.join(moduleDir, mapping.src);
+        const destPath = path.join(hqRoot, mapping.dest);
+        if (!fs.existsSync(srcPath)) {
+            return {
+                module: module.name,
+                success: false,
+                action: 'skipped',
+                message: `Source path not found: ${mapping.src}`,
+            };
+        }
+        const srcStat = fs.statSync(srcPath);
+        if (srcStat.isDirectory()) {
+            copyRecursive(srcPath, destPath, state, module.name, hqRoot, filesChanged);
+        }
+        else {
+            // Single file
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            const relativeDest = path.relative(hqRoot, destPath).replace(/\\/g, '/');
+            const newHash = hashFile(srcPath);
+            if (fs.existsSync(destPath)) {
+                const existingHash = hashFile(destPath);
+                const lastSyncedHash = state.files[relativeDest]?.hash;
+                if (lastSyncedHash && existingHash !== lastSyncedHash && existingHash !== newHash) {
+                    console.warn(`  Conflict: ${relativeDest} has local changes, skipping`);
+                    continue;
+                }
+                if (existingHash === newHash) {
+                    continue;
+                }
+            }
+            fs.copyFileSync(srcPath, destPath);
+            filesChanged.count++;
+            state.files[relativeDest] = {
+                hash: newHash,
+                syncedAt: new Date().toISOString(),
+                fromModule: module.name,
+            };
+        }
+    }
+    writeState(hqRoot, state);
+    return {
+        module: module.name,
+        success: true,
+        action: 'synced',
+        filesChanged: filesChanged.count,
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/strategies/merge.js.map

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

package/dist/sync-worker.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Background sync worker for "hq sync start".
+ *
+ * Forked as a detached child process. Polls for changes at a configurable
+ * interval and runs a full bidirectional sync each cycle.
+ *
+ * Usage (internal — called by cloud.ts):
+ *   node sync-worker.js <hqRoot> <intervalMs>
+ */
+export {};
+//# sourceMappingURL=sync-worker.d.ts.map

package/dist/sync-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-worker.d.ts","sourceRoot":"","sources":["../src/sync-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/sync-worker.js

@@ -0,0 +1,77 @@
+/**
+ * Background sync worker for "hq sync start".
+ *
+ * Forked as a detached child process. Polls for changes at a configurable
+ * interval and runs a full bidirectional sync each cycle.
+ *
+ * Usage (internal — called by cloud.ts):
+ *   node sync-worker.js <hqRoot> <intervalMs>
+ */
+import { fullSync, readSyncState, writeSyncState, computeLocalManifest } from './utils/sync.js';
+const hqRoot = process.argv[2];
+const intervalMs = parseInt(process.argv[3] ?? '30000', 10);
+if (!hqRoot) {
+    process.exit(1);
+}
+/** Run one sync cycle. */
+async function syncCycle() {
+    try {
+        const result = await fullSync(hqRoot);
+        // Update state
+        const manifest = computeLocalManifest(hqRoot);
+        const state = readSyncState(hqRoot);
+        state.running = true;
+        state.pid = process.pid;
+        state.lastSync = new Date().toISOString();
+        state.fileCount = manifest.length;
+        state.errors = result.errors;
+        writeSyncState(hqRoot, state);
+    }
+    catch {
+        // Log errors to state, but keep running
+        try {
+            const state = readSyncState(hqRoot);
+            state.errors = ['Sync cycle failed — will retry next interval'];
+            writeSyncState(hqRoot, state);
+        }
+        catch {
+            // Can't even write state — just continue
+        }
+    }
+}
+/** Main loop. */
+async function run() {
+    // Handle graceful shutdown
+    process.on('SIGTERM', () => {
+        try {
+            const state = readSyncState(hqRoot);
+            state.running = false;
+            state.pid = undefined;
+            writeSyncState(hqRoot, state);
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        process.exit(0);
+    });
+    process.on('SIGINT', () => {
+        try {
+            const state = readSyncState(hqRoot);
+            state.running = false;
+            state.pid = undefined;
+            writeSyncState(hqRoot, state);
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        process.exit(0);
+    });
+    // Run first sync immediately
+    await syncCycle();
+    // Then poll at the configured interval
+    setInterval(() => {
+        void syncCycle();
+    }, intervalMs);
+}
+void run();
+//# sourceMappingURL=sync-worker.js.map

package/dist/sync-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-worker.js","sourceRoot":"","sources":["../src/sync-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEhG,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,0BAA0B;AAC1B,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEtC,eAAe;QACf,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,KAAK,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;QACxC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,MAAM,GAAG,CAAC,8CAA8C,CAAC,CAAC;YAChE,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,KAAK,UAAU,GAAG;IAChB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;YACtB,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC;YACtB,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;YACtB,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC;YACtB,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,SAAS,EAAE,CAAC;IAElB,uCAAuC;IACvC,WAAW,CAAC,GAAG,EAAE;QACf,KAAK,SAAS,EAAE,CAAC;IACnB,CAAC,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC;AAED,KAAK,GAAG,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HQ Module Manifest Types (US-001)
+ */
+export type SyncStrategy = 'link' | 'merge' | 'copy';
+export type AccessLevel = 'public' | 'team' | `role:${string}`;
+export interface PathMapping {
+    src: string;
+    dest: string;
+}
+export interface ModuleDefinition {
+    name: string;
+    repo: string;
+    branch?: string;
+    strategy: SyncStrategy;
+    paths: PathMapping[];
+    access?: AccessLevel;
+}
+export interface ModulesManifest {
+    version: '1';
+    modules: ModuleDefinition[];
+}
+export interface ModuleLock {
+    version: '1';
+    locked: Record<string, string>;
+}
+export interface SyncState {
+    version: '1';
+    files: Record<string, {
+        hash: string;
+        syncedAt: string;
+        fromModule: string;
+    }>;
+}
+export interface SyncResult {
+    module: string;
+    success: boolean;
+    action: 'cloned' | 'fetched' | 'synced' | 'skipped';
+    message?: string;
+    filesChanged?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,MAAM,EAAE,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * HQ Module Manifest Types (US-001)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/api-client.d.ts

@@ -0,0 +1,26 @@
+/**
+ * API client for hq-cloud.
+ * Reads stored credentials and attaches Authorization header to all requests.
+ *
+ * Base URL resolution order:
+ * 1. HQ_CLOUD_API_URL environment variable
+ * 2. ~/.hq/config.json "apiUrl" field
+ * 3. Default production URL
+ */
+/**
+ * Resolve the hq-cloud API base URL.
+ */
+export declare function getApiUrl(): string;
+/** Standard response shape from the API */
+export interface ApiResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    data?: T;
+    error?: string;
+}
+/**
+ * Make an authenticated request to the hq-cloud API.
+ * Throws if not logged in. Returns parsed JSON response.
+ */
+export declare function apiRequest<T = unknown>(method: string, urlPath: string, body?: unknown): Promise<ApiResponse<T>>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/utils/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/utils/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAqBlC;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA+CzB"}

package/dist/utils/api-client.js

@@ -0,0 +1,87 @@
+/**
+ * API client for hq-cloud.
+ * Reads stored credentials and attaches Authorization header to all requests.
+ *
+ * Base URL resolution order:
+ * 1. HQ_CLOUD_API_URL environment variable
+ * 2. ~/.hq/config.json "apiUrl" field
+ * 3. Default production URL
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { readCredentials } from './credentials.js';
+/** Default API base URL (production) */
+const DEFAULT_API_URL = 'https://api.hq.indigoai.com';
+/** Path to optional config file */
+const CONFIG_PATH = path.join(os.homedir(), '.hq', 'config.json');
+/**
+ * Resolve the hq-cloud API base URL.
+ */
+export function getApiUrl() {
+    // 1. Environment variable takes precedence
+    if (process.env['HQ_CLOUD_API_URL']) {
+        return process.env['HQ_CLOUD_API_URL'].replace(/\/+$/, '');
+    }
+    // 2. Config file
+    try {
+        if (fs.existsSync(CONFIG_PATH)) {
+            const raw = fs.readFileSync(CONFIG_PATH, 'utf-8');
+            const config = JSON.parse(raw);
+            if (config.apiUrl) {
+                return config.apiUrl.replace(/\/+$/, '');
+            }
+        }
+    }
+    catch {
+        // Ignore config read errors
+    }
+    // 3. Default
+    return DEFAULT_API_URL;
+}
+/**
+ * Make an authenticated request to the hq-cloud API.
+ * Throws if not logged in. Returns parsed JSON response.
+ */
+export async function apiRequest(method, urlPath, body) {
+    const creds = readCredentials();
+    if (!creds) {
+        throw new Error('Not logged in. Run "hq auth login" first.');
+    }
+    const baseUrl = getApiUrl();
+    const url = `${baseUrl}${urlPath.startsWith('/') ? urlPath : '/' + urlPath}`;
+    const headers = {
+        'Authorization': `Bearer ${creds.token}`,
+        'Content-Type': 'application/json',
+    };
+    const fetchOptions = {
+        method,
+        headers,
+    };
+    if (body !== undefined && method !== 'GET') {
+        fetchOptions.body = JSON.stringify(body);
+    }
+    const response = await fetch(url, fetchOptions);
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch {
+        // Response may not be JSON
+    }
+    if (!response.ok) {
+        return {
+            ok: false,
+            status: response.status,
+            error: data?.message
+                ?? data?.error
+                ?? `HTTP ${response.status}`,
+        };
+    }
+    return {
+        ok: true,
+        status: response.status,
+        data,
+    };
+}
+//# sourceMappingURL=api-client.js.map

package/dist/utils/api-client.js.map

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

package/dist/utils/credentials.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Credential storage for HQ CLI authentication.
+ * Stores Clerk auth tokens in ~/.hq/credentials.json.
+ */
+/** Stored credential shape */
+export interface HqCredentials {
+    /** Clerk session token (JWT) */
+    token: string;
+    /** Clerk user ID */
+    userId: string;
+    /** User's email (for display) */
+    email?: string;
+    /** When the token was stored (ISO string) */
+    storedAt: string;
+    /** When the token expires (ISO string, if known) */
+    expiresAt?: string;
+}
+/**
+ * Set the base directory for config files. Intended for testing only.
+ */
+export declare function _setConfigHome(dir: string | null): void;
+/**
+ * Read stored credentials. Returns null if not logged in or file is missing/corrupt.
+ */
+export declare function readCredentials(): HqCredentials | null;
+/**
+ * Write credentials to disk. Creates ~/.hq if needed.
+ * File permissions are set to owner-only (0o600).
+ */
+export declare function writeCredentials(creds: HqCredentials): void;
+/**
+ * Clear stored credentials (logout).
+ * Returns true if credentials were removed, false if none existed.
+ */
+export declare function clearCredentials(): boolean;
+/**
+ * Get the credentials file path (for display/debugging).
+ */
+export declare function getCredentialsPath(): string;
+/**
+ * Check if credentials are expired (if expiresAt is set).
+ */
+export declare function isExpired(creds: HqCredentials): boolean;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/utils/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEvD;AA8BD;;GAEG;AACH,wBAAgB,eAAe,IAAI,aAAa,GAAG,IAAI,CAetD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAI3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAO1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAKvD"}

package/dist/utils/credentials.js

@@ -0,0 +1,101 @@
+/**
+ * Credential storage for HQ CLI authentication.
+ * Stores Clerk auth tokens in ~/.hq/credentials.json.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Override for the config directory base path.
+ * Set via HQ_CONFIG_HOME env var or _setConfigHome (for testing).
+ * When null, defaults to os.homedir().
+ */
+let configHomeOverride = null;
+/**
+ * Set the base directory for config files. Intended for testing only.
+ */
+export function _setConfigHome(dir) {
+    configHomeOverride = dir;
+}
+/**
+ * Get the ~/.hq config directory path.
+ * Respects HQ_CONFIG_HOME env var, _setConfigHome override, or defaults to ~/.hq.
+ */
+function getConfigDir() {
+    const base = configHomeOverride
+        ?? process.env['HQ_CONFIG_HOME']
+        ?? os.homedir();
+    return path.join(base, '.hq');
+}
+/**
+ * Get the credentials file path.
+ */
+function getCredentialsFilePath() {
+    return path.join(getConfigDir(), 'credentials.json');
+}
+/**
+ * Ensure the config directory exists with restricted permissions.
+ */
+function ensureConfigDir() {
+    const dir = getConfigDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Read stored credentials. Returns null if not logged in or file is missing/corrupt.
+ */
+export function readCredentials() {
+    try {
+        const credPath = getCredentialsFilePath();
+        if (!fs.existsSync(credPath)) {
+            return null;
+        }
+        const raw = fs.readFileSync(credPath, 'utf-8');
+        const creds = JSON.parse(raw);
+        if (!creds.token || !creds.userId) {
+            return null;
+        }
+        return creds;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write credentials to disk. Creates ~/.hq if needed.
+ * File permissions are set to owner-only (0o600).
+ */
+export function writeCredentials(creds) {
+    ensureConfigDir();
+    const content = JSON.stringify(creds, null, 2);
+    fs.writeFileSync(getCredentialsFilePath(), content, { mode: 0o600 });
+}
+/**
+ * Clear stored credentials (logout).
+ * Returns true if credentials were removed, false if none existed.
+ */
+export function clearCredentials() {
+    const credPath = getCredentialsFilePath();
+    if (!fs.existsSync(credPath)) {
+        return false;
+    }
+    fs.unlinkSync(credPath);
+    return true;
+}
+/**
+ * Get the credentials file path (for display/debugging).
+ */
+export function getCredentialsPath() {
+    return getCredentialsFilePath();
+}
+/**
+ * Check if credentials are expired (if expiresAt is set).
+ */
+export function isExpired(creds) {
+    if (!creds.expiresAt) {
+        return false;
+    }
+    return new Date(creds.expiresAt) <= new Date();
+}
+//# sourceMappingURL=credentials.js.map

package/dist/utils/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAgBzB;;;;GAIG;AACH,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,kBAAkB,GAAG,GAAG,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY;IACnB,MAAM,IAAI,GAAG,kBAAkB;WAC1B,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;WAC7B,EAAE,CAAC,OAAO,EAAE,CAAC;IAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,kBAAkB,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,eAAe,EAAE,CAAC;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,EAAE,CAAC,aAAa,CAAC,sBAAsB,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,13 @@
+export declare function cloneRepo(repoUrl: string, targetDir: string, branch?: string): Promise<void>;
+export declare function fetchRepo(repoDir: string): Promise<void>;
+export declare function pullRepo(repoDir: string): Promise<void>;
+export declare function getCurrentCommit(repoDir: string): Promise<string>;
+export declare function checkoutCommit(repoDir: string, commitSha: string): Promise<void>;
+export declare function isRepo(dir: string): Promise<boolean>;
+export declare function getRemoteUrl(repoDir: string): Promise<string | null>;
+export declare function isBehindRemote(repoDir: string): Promise<{
+    behind: boolean;
+    commits: number;
+}>;
+export declare function ensureGitignore(hqRoot: string, entry: string): void;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlG;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9D;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7D;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvE;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtF;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS1E;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CASnG;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAUnE"}

package/dist/utils/git.js

@@ -0,0 +1,70 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { simpleGit } from 'simple-git';
+export async function cloneRepo(repoUrl, targetDir, branch) {
+    const git = simpleGit();
+    const options = branch ? ['--branch', branch] : [];
+    await git.clone(repoUrl, targetDir, options);
+}
+export async function fetchRepo(repoDir) {
+    const git = simpleGit(repoDir);
+    await git.fetch(['--all']);
+}
+export async function pullRepo(repoDir) {
+    const git = simpleGit(repoDir);
+    await git.pull();
+}
+export async function getCurrentCommit(repoDir) {
+    const git = simpleGit(repoDir);
+    const log = await git.log({ maxCount: 1 });
+    return log.latest?.hash ?? '';
+}
+export async function checkoutCommit(repoDir, commitSha) {
+    const git = simpleGit(repoDir);
+    await git.checkout(commitSha);
+}
+export async function isRepo(dir) {
+    if (!fs.existsSync(dir))
+        return false;
+    try {
+        const git = simpleGit(dir);
+        return await git.checkIsRepo();
+    }
+    catch {
+        return false;
+    }
+}
+export async function getRemoteUrl(repoDir) {
+    try {
+        const git = simpleGit(repoDir);
+        const remotes = await git.getRemotes(true);
+        const origin = remotes.find(r => r.name === 'origin');
+        return origin?.refs?.fetch ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function isBehindRemote(repoDir) {
+    try {
+        const git = simpleGit(repoDir);
+        await git.fetch();
+        const status = await git.status();
+        return { behind: status.behind > 0, commits: status.behind };
+    }
+    catch {
+        return { behind: false, commits: 0 };
+    }
+}
+export function ensureGitignore(hqRoot, entry) {
+    const gitignorePath = path.join(hqRoot, '.gitignore');
+    let content = '';
+    if (fs.existsSync(gitignorePath)) {
+        content = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+    if (!content.includes(entry)) {
+        content = content.trimEnd() + '\n' + entry + '\n';
+        fs.writeFileSync(gitignorePath, content);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

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