@vkenliu/adit-cloud 0.2.0

package/dist/http/client.js

@@ -0,0 +1,229 @@
+/**
+ * HTTP client for adit-cloud API.
+ *
+ * Handles Bearer auth, automatic token refresh, and exponential
+ * backoff retry on network errors and 429 rate limits.
+ */
+import { isTokenExpired, saveCredentials } from "../auth/credentials.js";
+import { CloudAuthError, CloudNetworkError, CloudApiError } from "./errors.js";
+const MAX_RETRIES = 5;
+const MAX_REDIRECTS = 5;
+const INITIAL_BACKOFF_MS = 2000;
+export class CloudClient {
+    credentials;
+    serverUrl;
+    constructor(serverUrl, credentials) {
+        this.serverUrl = serverUrl.replace(/\/$/, ""); // Strip trailing slash
+        this.credentials = credentials;
+    }
+    /** GET request with auth */
+    async get(path) {
+        return this.request("GET", path);
+    }
+    /** HEAD request with auth — returns headers only */
+    async head(path) {
+        // Refresh token if expired before making the request (skip for static tokens)
+        if (this.credentials.authType !== "token" && isTokenExpired(this.credentials)) {
+            await this.refreshToken();
+        }
+        const url = `${this.serverUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.credentials.accessToken}`,
+        };
+        const response = await fetch(url, { method: "HEAD", headers });
+        if (response.status === 401 || response.status === 403) {
+            // Static tokens cannot be refreshed — fail immediately
+            if (this.credentials.authType === "token") {
+                throw new CloudAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+            }
+            if (response.status === 401) {
+                await this.refreshToken();
+                // Retry once with new token
+                const retry = await fetch(url, {
+                    method: "HEAD",
+                    headers: {
+                        Authorization: `Bearer ${this.credentials.accessToken}`,
+                    },
+                });
+                if (!retry.ok) {
+                    throw new CloudApiError(`HEAD ${path}: ${retry.status} ${retry.statusText}`, retry.status);
+                }
+                return headersToRecord(retry.headers);
+            }
+            throw new CloudAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        if (!response.ok) {
+            throw new CloudApiError(`HEAD ${path}: ${response.status} ${response.statusText}`, response.status);
+        }
+        return headersToRecord(response.headers);
+    }
+    /** POST request with auth and JSON body */
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    /** PATCH request with auth */
+    async patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+    /** DELETE request with auth */
+    async delete(path) {
+        await this.request("DELETE", path);
+    }
+    /** Get the current credentials (may have been refreshed) */
+    getCredentials() {
+        return this.credentials;
+    }
+    async request(method, path, body, redirectCount = 0) {
+        // Refresh token if expired before making the request (skip for static tokens)
+        if (this.credentials.authType !== "token" && isTokenExpired(this.credentials)) {
+            await this.refreshToken();
+        }
+        let lastError;
+        let currentUrl = `${this.serverUrl}${path}`;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const backoffMs = INITIAL_BACKOFF_MS * Math.pow(2, attempt - 1);
+                await sleep(backoffMs);
+            }
+            try {
+                let url = currentUrl;
+                const headers = {
+                    Authorization: `Bearer ${this.credentials.accessToken}`,
+                    "Content-Type": "application/json",
+                };
+                const response = await fetch(url, {
+                    method,
+                    headers,
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                });
+                // Handle 401 — static tokens cannot be refreshed, fail immediately
+                if (response.status === 401 && this.credentials.authType === "token") {
+                    throw new CloudAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+                }
+                // Handle 401 — try refreshing token once (device auth only)
+                if (response.status === 401 && attempt === 0) {
+                    await this.refreshToken();
+                    continue; // Retry with new token
+                }
+                // Handle 429 rate limit — respect Retry-After header
+                if (response.status === 429) {
+                    const retryAfter = response.headers.get("Retry-After");
+                    if (retryAfter) {
+                        const waitMs = parseInt(retryAfter, 10) * 1000;
+                        if (!isNaN(waitMs) && waitMs > 0) {
+                            await sleep(Math.min(waitMs, 60_000));
+                        }
+                    }
+                    continue; // Retry
+                }
+                // Handle redirects
+                if (response.status >= 300 && response.status < 400) {
+                    const location = response.headers.get("Location");
+                    if (!location) {
+                        throw new CloudApiError(`Redirect missing Location header`, response.status);
+                    }
+                    if (redirectCount >= MAX_REDIRECTS) {
+                        throw new CloudNetworkError(`Too many redirects (max ${MAX_REDIRECTS}) for ${method} ${path}`);
+                    }
+                    // Parse Location URL
+                    const redirectUrl = new URL(location, url);
+                    // For 303, always use GET method
+                    const effectiveMethod = response.status === 303 ? "GET" : method;
+                    // Update URL and continue the loop
+                    currentUrl = redirectUrl.toString();
+                    method = effectiveMethod;
+                    // Clear body for GET/HEAD redirects after 303
+                    if (response.status === 303 || effectiveMethod === "GET" || effectiveMethod === "HEAD") {
+                        body = undefined;
+                    }
+                    // Increment redirect count for the next iteration
+                    return this.request(method, path, body, redirectCount + 1);
+                }
+                if (!response.ok) {
+                    // Read body as text first (always safe), then try to parse as JSON.
+                    // This avoids the "Body is unusable: Body has already been read"
+                    // error that occurs when response.json() fails on an empty body
+                    // and then response.text() tries to read the already-consumed stream.
+                    let responseBody;
+                    try {
+                        const text = await response.text();
+                        try {
+                            responseBody = JSON.parse(text);
+                        }
+                        catch {
+                            responseBody = text || null;
+                        }
+                    }
+                    catch {
+                        responseBody = null;
+                    }
+                    if (response.status === 401 || response.status === 403) {
+                        throw new CloudAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+                    }
+                    throw new CloudApiError(`API error: ${response.status} ${response.statusText}`, response.status, responseBody);
+                }
+                // 204 No Content
+                if (response.status === 204) {
+                    return undefined;
+                }
+                return (await response.json());
+            }
+            catch (error) {
+                // Don't retry auth errors
+                if (error instanceof CloudAuthError)
+                    throw error;
+                if (error instanceof CloudApiError)
+                    throw error;
+                // Network error — retry with backoff
+                lastError =
+                    error instanceof Error
+                        ? error
+                        : new Error(String(error));
+            }
+        }
+        throw new CloudNetworkError(`Request failed after ${MAX_RETRIES} retries: ${method} ${path}`, lastError);
+    }
+    /** Refresh the access token using the refresh token */
+    async refreshToken() {
+        if (this.credentials.authType === "token") {
+            throw new CloudAuthError("Cannot refresh a static token. Re-authenticate with a new token or use 'adit cloud login'.");
+        }
+        try {
+            const response = await fetch(`${this.serverUrl}/api/auth/token/refresh`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    refreshToken: this.credentials.refreshToken,
+                }),
+            });
+            if (!response.ok) {
+                throw new CloudAuthError(`Token refresh failed: ${response.status}. Please re-authenticate with 'adit cloud login'.`);
+            }
+            const data = (await response.json());
+            this.credentials = {
+                ...this.credentials,
+                accessToken: data.accessToken,
+                refreshToken: data.refreshToken,
+                expiresAt: data.expiresAt,
+            };
+            // Persist the refreshed credentials
+            saveCredentials(this.credentials);
+        }
+        catch (error) {
+            if (error instanceof CloudAuthError)
+                throw error;
+            throw new CloudAuthError(`Token refresh failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function headersToRecord(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+//# sourceMappingURL=client.js.map

package/dist/http/client.js.map

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

package/dist/http/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Typed error classes for cloud API operations.
+ */
+/** Authentication failure (401, expired token, revoked) */
+export declare class CloudAuthError extends Error {
+    constructor(message: string);
+}
+/** Network-level failure (timeout, DNS, connection refused) */
+export declare class CloudNetworkError extends Error {
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+/** Server returned a non-2xx response */
+export declare class CloudApiError extends Error {
+    readonly status: number;
+    readonly body?: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/http/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2DAA2D;AAC3D,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,+DAA+D;AAC/D,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED,yCAAyC;AACzC,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAM5D"}

package/dist/http/errors.js

@@ -0,0 +1,31 @@
+/**
+ * Typed error classes for cloud API operations.
+ */
+/** Authentication failure (401, expired token, revoked) */
+export class CloudAuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CloudAuthError";
+    }
+}
+/** Network-level failure (timeout, DNS, connection refused) */
+export class CloudNetworkError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "CloudNetworkError";
+        this.cause = cause;
+    }
+}
+/** Server returned a non-2xx response */
+export class CloudApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "CloudApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2DAA2D;AAC3D,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,KAAK,CAAS;IAEvB,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAS;IACf,IAAI,CAAW;IAExB,YAAY,OAAe,EAAE,MAAc,EAAE,IAAc;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @vkenliu/adit-cloud — Cloud sync client for ADIT.
+ *
+ * Provides device authorization, HTTP client with auto-refresh,
+ * cursor-based incremental sync engine, and conflict resolution.
+ */
+export { loadCloudConfig, DEFAULT_SERVER_URL, type CloudConfig, type ProjectLinkConfig } from "./config.js";
+export { loadCredentials, saveCredentials, clearCredentials, isTokenExpired, credentialsFromEnvToken, incrementSyncErrors, clearSyncErrors, isSyncDisabled, type CloudCredentials, } from "./auth/credentials.js";
+export { requestDeviceCode, pollForToken, type DeviceCodeResponse, type TokenResponse, type DeviceAuthOptions, } from "./auth/device-auth.js";
+export { CloudClient } from "./http/client.js";
+export { CloudAuthError, CloudNetworkError, CloudApiError, } from "./http/errors.js";
+export { SyncEngine, type SyncResult, type SyncConflict, } from "./sync/engine.js";
+export { buildSyncBatch, countUnsyncedRecords, batchRecordCount, type SyncBatch, } from "./sync/serializer.js";
+export { triggerAutoSync } from "./sync/auto-sync.js";
+export { triggerTranscriptUpload, registerTranscript, processTranscriptUploads, uploadChunk, uploadFull, checkUploadStatus, lookupUploadByPath, type TranscriptManagerOptions, type TranscriptProcessResult, type SyncUploadType, type SyncUploadResponse, type SyncUploadStatus, type UploadChunkParams, } from "./transcript/index.js";
+export { type TranscriptUploadConfig } from "./config.js";
+export { linkCommand, intentCommand, formatIntentList, formatIntentDetail, triggerProjectLinkSync, checkQuality, formatQualityFeedback, collectRemoteUrl, collectBranches, collectCommitLogs, collectCommitCount, collectDefaultBranch, collectCurrentBranch, projectNameFromRemoteUrl, discoverDocuments, loadDocSettings, getProjectLinkCache, upsertProjectLinkCache, clearProjectLinkCache, type LinkResult, type IntentResult, type LinkOptions, type IntentOptions, type IntentSummary, type IntentDetail, type TaskSlice, type StepTiming, type GitBranch, type GitCommit, type DiscoveredDocument, type ProjectLinkCache, type QualifyResponse, } from "./project-link/index.js";
+export { bulkTaskUpdateCommand } from "./project-link/bulk-task.js";
+export type { BulkTaskFilter, BulkTaskUpdate, BulkTaskUpdateOptions, BulkTaskUpdateResult, } from "./project-link/types.js";
+//# 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":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG5G,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,SAAS,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @vkenliu/adit-cloud — Cloud sync client for ADIT.
+ *
+ * Provides device authorization, HTTP client with auto-refresh,
+ * cursor-based incremental sync engine, and conflict resolution.
+ */
+// Config
+export { loadCloudConfig, DEFAULT_SERVER_URL } from "./config.js";
+// Auth
+export { loadCredentials, saveCredentials, clearCredentials, isTokenExpired, credentialsFromEnvToken, incrementSyncErrors, clearSyncErrors, isSyncDisabled, } from "./auth/credentials.js";
+export { requestDeviceCode, pollForToken, } from "./auth/device-auth.js";
+// HTTP
+export { CloudClient } from "./http/client.js";
+export { CloudAuthError, CloudNetworkError, CloudApiError, } from "./http/errors.js";
+// Sync
+export { SyncEngine, } from "./sync/engine.js";
+export { buildSyncBatch, countUnsyncedRecords, batchRecordCount, } from "./sync/serializer.js";
+export { triggerAutoSync } from "./sync/auto-sync.js";
+// Transcript / file upload
+export { triggerTranscriptUpload, registerTranscript, processTranscriptUploads, uploadChunk, uploadFull, checkUploadStatus, lookupUploadByPath, } from "./transcript/index.js";
+// Project Link
+export { linkCommand, intentCommand, formatIntentList, formatIntentDetail, triggerProjectLinkSync, checkQuality, formatQualityFeedback, collectRemoteUrl, collectBranches, collectCommitLogs, collectCommitCount, collectDefaultBranch, collectCurrentBranch, projectNameFromRemoteUrl, discoverDocuments, loadDocSettings, getProjectLinkCache, upsertProjectLinkCache, clearProjectLinkCache, } from "./project-link/index.js";
+// Bulk Task Update
+export { bulkTaskUpdateCommand } from "./project-link/bulk-task.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAA4C,MAAM,aAAa,CAAC;AAE5G,OAAO;AACP,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,cAAc,GAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,YAAY,GAIb,MAAM,uBAAuB,CAAC;AAE/B,OAAO;AACP,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO;AACP,OAAO,EACL,UAAU,GAGX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,2BAA2B;AAC3B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,kBAAkB,GAOnB,MAAM,uBAAuB,CAAC;AAI/B,eAAe;AACf,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GActB,MAAM,yBAAyB,CAAC;AAEjC,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/project-link/auto-link.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Automatic project-link sync — fire-and-forget on session-start.
+ *
+ * Spawns a detached child process to run the full project-link flow
+ * (branches, commits, documents) in the background. The process is
+ * independent of the hook — it won't be killed by the 10-second
+ * hook timeout and won't block the AI agent.
+ *
+ * Precondition checks (all must pass to trigger):
+ * 1. Auto-sync not disabled via ADIT_PROJECT_LINK_AUTO_SYNC=false
+ * 2. Valid credentials exist (env token or stored credentials)
+ * 3. Server URL is resolvable
+ * 4. Cached project-link data is stale (older than staleHours)
+ *
+ * The detached process runs `npx adit cloud link --json --skip-qualify`
+ * with inherited environment, so credentials and config are available.
+ */
+import type Database from "better-sqlite3";
+/**
+ * Trigger a background project-link sync if credentials exist and
+ * the cached link data is stale.
+ *
+ * This function is designed to be called as fire-and-forget:
+ *   triggerProjectLinkSync(db, projectId, projectRoot).catch(() => {})
+ *
+ * It spawns a fully detached child process that outlives the hook
+ * process, so the 10-second hook timeout does not apply.
+ */
+export declare function triggerProjectLinkSync(db: Database.Database, projectId: string, projectRoot: string): Promise<void>;
+//# sourceMappingURL=auto-link.d.ts.map

package/dist/project-link/auto-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-link.d.ts","sourceRoot":"","sources":["../../src/project-link/auto-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAS3C;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Df"}

package/dist/project-link/auto-link.js

@@ -0,0 +1,91 @@
+/**
+ * Automatic project-link sync — fire-and-forget on session-start.
+ *
+ * Spawns a detached child process to run the full project-link flow
+ * (branches, commits, documents) in the background. The process is
+ * independent of the hook — it won't be killed by the 10-second
+ * hook timeout and won't block the AI agent.
+ *
+ * Precondition checks (all must pass to trigger):
+ * 1. Auto-sync not disabled via ADIT_PROJECT_LINK_AUTO_SYNC=false
+ * 2. Valid credentials exist (env token or stored credentials)
+ * 3. Server URL is resolvable
+ * 4. Cached project-link data is stale (older than staleHours)
+ *
+ * The detached process runs `npx adit cloud link --json --skip-qualify`
+ * with inherited environment, so credentials and config are available.
+ */
+import { spawn } from "node:child_process";
+import { loadCloudConfig, DEFAULT_SERVER_URL } from "../config.js";
+import { loadCredentials, credentialsFromEnvToken, isSyncDisabled, } from "../auth/credentials.js";
+import { getProjectLinkCache } from "./cache.js";
+/**
+ * Trigger a background project-link sync if credentials exist and
+ * the cached link data is stale.
+ *
+ * This function is designed to be called as fire-and-forget:
+ *   triggerProjectLinkSync(db, projectId, projectRoot).catch(() => {})
+ *
+ * It spawns a fully detached child process that outlives the hook
+ * process, so the 10-second hook timeout does not apply.
+ */
+export async function triggerProjectLinkSync(db, projectId, projectRoot) {
+    const cloudConfig = loadCloudConfig();
+    // 0. Check if project-link auto-sync is enabled
+    if (!cloudConfig.projectLink.autoSync)
+        return;
+    // 1. Circuit breaker — skip if cloud sync is disabled due to failures
+    if (isSyncDisabled())
+        return;
+    // 2. Check credentials exist (env token or stored) and resolve server URL
+    let serverUrl = null;
+    const storedCredentials = loadCredentials();
+    if (process.env.ADIT_AUTH_TOKEN) {
+        serverUrl = cloudConfig.serverUrl ?? DEFAULT_SERVER_URL;
+        const clientId = storedCredentials?.clientId ?? (await import("@vkenliu/adit-core")).loadConfig().clientId;
+        const creds = credentialsFromEnvToken(serverUrl, clientId);
+        if (!creds)
+            return;
+    }
+    else {
+        if (!storedCredentials)
+            return;
+        serverUrl = cloudConfig.serverUrl ?? storedCredentials.serverUrl;
+        // Single-server binding: don't send credentials to wrong server
+        if (cloudConfig.serverUrl && storedCredentials.serverUrl !== cloudConfig.serverUrl) {
+            return;
+        }
+    }
+    if (!serverUrl)
+        return;
+    // 3. Check staleness — skip if cached data is fresh enough
+    const cache = getProjectLinkCache(db, projectId, serverUrl);
+    if (cache?.lastBranchSyncAt) {
+        const staleMs = cloudConfig.projectLink.staleHours * 60 * 60 * 1000;
+        const lastSyncTime = new Date(cache.lastBranchSyncAt).getTime();
+        // Guard against corrupted date strings that produce NaN
+        if (!Number.isNaN(lastSyncTime)) {
+            const elapsed = Date.now() - lastSyncTime;
+            if (elapsed < staleMs)
+                return;
+        }
+    }
+    // 4. Spawn detached child process to run the full link flow.
+    //    Uses `npx adit cloud link` which handles its own
+    //    credential loading, database opening, and error handling.
+    try {
+        const child = spawn("npx", ["adit", "cloud", "link", "--json", "--skip-qualify"], {
+            cwd: projectRoot,
+            stdio: ["ignore", "ignore", "ignore"],
+            detached: true,
+        });
+        child.unref();
+        child.on("error", () => {
+            // fail-open
+        });
+    }
+    catch {
+        // fail-open — spawn itself may throw (e.g. npx not found)
+    }
+}
+//# sourceMappingURL=auto-link.js.map

package/dist/project-link/auto-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-link.js","sourceRoot":"","sources":["../../src/project-link/auto-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAqB,EACrB,SAAiB,EACjB,WAAmB;IAEnB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IAEtC,gDAAgD;IAChD,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ;QAAE,OAAO;IAE9C,sEAAsE;IACtE,IAAI,cAAc,EAAE;QAAE,OAAO;IAE7B,0EAA0E;IAC1E,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,MAAM,iBAAiB,GAAG,eAAe,EAAE,CAAC;IAE5C,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACxD,MAAM,QAAQ,GAAG,iBAAiB,EAAE,QAAQ,IAAI,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC;QAC3G,MAAM,KAAK,GAAG,uBAAuB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK;YAAE,OAAO;IACrB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,iBAAiB;YAAE,OAAO;QAC/B,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,iBAAiB,CAAC,SAAS,CAAC;QAEjE,gEAAgE;QAChE,IAAI,WAAW,CAAC,SAAS,IAAI,iBAAiB,CAAC,SAAS,KAAK,WAAW,CAAC,SAAS,EAAE,CAAC;YACnF,OAAO;QACT,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,2DAA2D;IAC3D,MAAM,KAAK,GAAG,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACpE,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,wDAAwD;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;YAC1C,IAAI,OAAO,GAAG,OAAO;gBAAE,OAAO;QAChC,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,sDAAsD;IACtD,+DAA+D;IAC/D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CACjB,KAAK,EACL,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EACrD;YACE,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;YACrC,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;QACF,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,YAAY;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC"}

package/dist/project-link/bulk-task.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bulk task status update command.
+ *
+ * Implements the bulk task status update functionality by calling
+ * the /api/task-slices/bulk endpoint.
+ */
+import { CloudClient } from "../http/client.js";
+import type { BulkTaskUpdateOptions, BulkTaskUpdateResult } from "./types.js";
+/**
+ * Bulk task status update command
+ *
+ * Updates task status in bulk using the /api/task-slices/bulk endpoint.
+ */
+export declare function bulkTaskUpdateCommand(client: CloudClient, _projectId: string, options: BulkTaskUpdateOptions): Promise<BulkTaskUpdateResult>;
+//# sourceMappingURL=bulk-task.d.ts.map

package/dist/project-link/bulk-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-task.d.ts","sourceRoot":"","sources":["../../src/project-link/bulk-task.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA2F9E;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAwC/B"}

package/dist/project-link/bulk-task.js

@@ -0,0 +1,107 @@
+/**
+ * Bulk task status update command.
+ *
+ * Implements the bulk task status update functionality by calling
+ * the /api/task-slices/bulk endpoint.
+ */
+import { CloudAuthError, CloudNetworkError, CloudApiError } from "../http/errors.js";
+/**
+ * Build the request body for bulk task update API
+ */
+function buildRequestBody(options) {
+    const { intentId, taskId, status, filters } = options;
+    // If specific task IDs are provided, create updates for each
+    const updates = taskId && taskId.length > 0
+        ? taskId.map(taskId => ({
+            taskId,
+            status: status ?? "completed",
+        }))
+        : // Otherwise, create a single update to apply to all tasks
+            [
+                {
+                    taskId: "*", // This will be handled by the server to update all tasks
+                    status: status ?? "completed",
+                },
+            ];
+    // Build the request body
+    const body = {
+        intentId,
+        updates,
+    };
+    // Add filters if provided
+    if (filters) {
+        body.filters = {};
+        if (filters.phase !== undefined)
+            body.filters.phase = filters.phase;
+        if (filters.status !== undefined)
+            body.filters.status = filters.status;
+        if (filters.featureTag !== undefined)
+            body.filters.featureTag = filters.featureTag;
+        if (filters.wave !== undefined)
+            body.filters.wave = filters.wave;
+    }
+    return body;
+}
+/**
+ * Validate options and prepare for API call
+ */
+function validateOptions(options) {
+    if (!options.intentId) {
+        throw new Error("intentId is required");
+    }
+    // Validate intentId format (basic UUID check)
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(options.intentId)) {
+        throw new Error("Invalid intentId format");
+    }
+    // Validate status if provided
+    if (options.status && !["pending", "approved", "in_progress", "completed", "rejected"].includes(options.status)) {
+        throw new Error(`Invalid status: ${options.status}. Must be one of: pending, approved, in_progress, completed, rejected`);
+    }
+    // Validate filters
+    if (options.filters) {
+        const { filters } = options;
+        if (filters.phase && (filters.phase < 1 || filters.phase > 99)) {
+            throw new Error("Phase must be between 1 and 99");
+        }
+        if (filters.status && !["pending", "approved", "in_progress", "completed", "rejected"].includes(filters.status)) {
+            throw new Error(`Invalid filter status: ${filters.status}. Must be one of: pending, approved, in_progress, completed, rejected`);
+        }
+        if (filters.wave && filters.wave < 1) {
+            throw new Error("Wave must be greater than 0");
+        }
+    }
+}
+/**
+ * Bulk task status update command
+ *
+ * Updates task status in bulk using the /api/task-slices/bulk endpoint.
+ */
+export async function bulkTaskUpdateCommand(client, _projectId, options) {
+    try {
+        // Validate options first
+        validateOptions(options);
+        // Build request body
+        const body = buildRequestBody(options);
+        // Make the API request
+        const result = await client.patch(`/api/task-slices/bulk`, body);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof CloudAuthError) {
+            throw error;
+        }
+        if (error instanceof CloudNetworkError) {
+            throw error;
+        }
+        if (error instanceof CloudApiError) {
+            // Enhance API error with more context
+            throw new CloudApiError(`Bulk task update failed: ${error.message}`, error.status, error.body);
+        }
+        // Re-throw validation errors
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new CloudApiError("Bulk task update failed with unknown error", 500);
+    }
+}
+//# sourceMappingURL=bulk-task.js.map

package/dist/project-link/bulk-task.js.map

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