@vkenliu/adit-cloud 0.2.0

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

@@ -0,0 +1,350 @@
+/**
+ * Project link command handler — orchestrates the 6-step link flow.
+ *
+ * Steps:
+ *   1. Check credentials (handled by caller)
+ *   2. Negotiate project ID with server
+ *   3. Upload git metadata (branches + commits)
+ *   4. Discover project documents
+ *   5. Upload documents (with user confirmation in interactive mode)
+ *   6. Quality check (and optional AI summary generation)
+ */
+import { collectRemoteUrl, collectDefaultBranch, collectBranches, collectCommitLogs, collectCommitCount, resolveCommitBranches, projectNameFromRemoteUrl, } from "./git-collector.js";
+import { discoverDocuments, loadDocSettings } from "./doc-discovery.js";
+import { getProjectLinkCache, upsertProjectLinkCache, clearProjectLinkCache, updateCachedCommitSha, updateCachedDocHashes, updateCachedQualified, } from "./cache.js";
+import { checkQuality, formatQualityFeedback } from "./qualify.js";
+/** Maximum number of commits per upload batch */
+const COMMIT_BATCH_SIZE = 1000;
+/** Minimum staleness before re-uploading branches (1 hour) */
+const BRANCH_STALE_MS = 60 * 60 * 1000;
+/**
+ * Execute the project link flow.
+ *
+ * The caller is responsible for:
+ * - Loading credentials and verifying authentication
+ * - Creating the CloudClient with a valid server URL
+ * - Opening the database
+ *
+ * Returns a LinkResult summarizing what was done.
+ */
+export async function linkCommand(db, client, projectRoot, projectId, serverUrl, options = {}) {
+    // In JSON mode, suppress progress output
+    const log = options.json ? (() => { }) : console.log.bind(console);
+    // Step timing tracker
+    const totalStart = performance.now();
+    const stepTimings = [];
+    function startStep() {
+        return performance.now();
+    }
+    function endStep(stepName, stepStart) {
+        stepTimings.push({ step: stepName, durationMs: Math.round(performance.now() - stepStart) });
+    }
+    // Handle --force: clear local cache and server data
+    if (options.force) {
+        log("Clearing cached link data...");
+        clearProjectLinkCache(db, projectId, serverUrl);
+        try {
+            await client.delete(`/api/project-link/reset?projectId=${encodeURIComponent(projectId)}`);
+            log("Server link data cleared.");
+        }
+        catch {
+            // Server reset may fail if no link exists yet — that's fine
+        }
+    }
+    // Load or initialize cache
+    let cache = getProjectLinkCache(db, projectId, serverUrl);
+    // ──────────────────────────────────────────────────────────
+    // Step 2: Negotiate project ID
+    // ──────────────────────────────────────────────────────────
+    log("\n[Step 1/6] Negotiating project ID with server...");
+    const step1Start = startStep();
+    const remoteUrl = await collectRemoteUrl(projectRoot);
+    const projectName = projectNameFromRemoteUrl(remoteUrl);
+    let confirmedProjectId = cache?.confirmedProjectId ?? null;
+    if (!confirmedProjectId || options.force) {
+        const negotiate = await client.post("/api/project-link/negotiate", { projectId, remoteUrl, projectName });
+        confirmedProjectId = negotiate.confirmedProjectId;
+        if (negotiate.status === "id_mismatch") {
+            log(`  Server found existing project with different ID. Adopting: ${confirmedProjectId}`);
+        }
+        log(`  Project confirmed: ${negotiate.projectName} (${confirmedProjectId.slice(0, 12)}...)`);
+        // Initialize or update cache
+        const now = new Date().toISOString();
+        if (!cache) {
+            cache = {
+                projectId,
+                serverUrl,
+                confirmedProjectId,
+                lastCommitSha: null,
+                lastBranchSyncAt: null,
+                lastDocSyncAt: null,
+                docHashes: {},
+                qualified: false,
+                initializedAt: now,
+                updatedAt: now,
+            };
+            upsertProjectLinkCache(db, cache);
+        }
+        else {
+            cache.confirmedProjectId = confirmedProjectId;
+            cache.updatedAt = now;
+            upsertProjectLinkCache(db, cache);
+        }
+    }
+    else {
+        log(`  Project confirmed: ${projectName} (${confirmedProjectId.slice(0, 12)}...)`);
+    }
+    // At this point cache is guaranteed non-null: either loaded from DB
+    // (else branch) or freshly created (if branch). Assert for TypeScript.
+    if (!cache) {
+        throw new Error("Internal error: project link cache not initialized after negotiate");
+    }
+    // Use the confirmed project ID for all subsequent API calls
+    const effectiveProjectId = confirmedProjectId;
+    endStep("Negotiate project ID", step1Start);
+    // ──────────────────────────────────────────────────────────
+    // Step 3: Upload git metadata (branches + commits)
+    // ──────────────────────────────────────────────────────────
+    log("\n[Step 2/6] Uploading git metadata...");
+    const step2Start = startStep();
+    // 3a. Branches — collect once and reuse for commit branch resolution
+    const branchesStale = !cache.lastBranchSyncAt ||
+        (Date.now() - new Date(cache.lastBranchSyncAt).getTime() > BRANCH_STALE_MS) ||
+        options.force;
+    const allBranches = await collectBranches(projectRoot);
+    const defaultBranch = await collectDefaultBranch(projectRoot);
+    let branchCount = 0;
+    if (branchesStale) {
+        if (options.dryRun) {
+            log(`  [dry-run] Would upload ${allBranches.length} branches, default: ${defaultBranch ?? "unknown"}`);
+            branchCount = allBranches.length;
+        }
+        else {
+            const initResponse = await client.post("/api/project-link/init", {
+                projectId: effectiveProjectId,
+                remoteUrl,
+                defaultBranch,
+                branches: allBranches.map((b) => ({
+                    name: b.name,
+                    headSha: b.headSha,
+                })),
+            });
+            branchCount = initResponse.projectLink.branchCount;
+            cache.lastBranchSyncAt = new Date().toISOString();
+            upsertProjectLinkCache(db, cache);
+            log(`  ${branchCount} branches, default: ${defaultBranch ?? "unknown"}`);
+        }
+    }
+    else {
+        log("  Branches up to date (synced < 1 hour ago)");
+    }
+    // 3b. Commits
+    let commitCount = 0;
+    if (!options.skipCommits) {
+        // Collect commits and resolve per-commit branch assignment by checking
+        // which branches each commit is reachable from. Non-default branches
+        // take priority so merged feature-branch commits keep their origin.
+        const commits = await collectCommitLogs(projectRoot, {
+            sinceCommitSha: cache.lastCommitSha,
+        });
+        const totalCommits = await collectCommitCount(projectRoot);
+        // Resolve branch for each commit using collected branch data
+        if (commits.length > 0) {
+            await resolveCommitBranches(projectRoot, commits, allBranches, defaultBranch);
+        }
+        if (commits.length === 0) {
+            log("  No new commits to upload.");
+            commitCount = totalCommits;
+        }
+        else if (options.dryRun) {
+            log(`  [dry-run] Would upload ${commits.length} commits (${totalCommits} total)`);
+            commitCount = totalCommits;
+        }
+        else {
+            // Upload in batches
+            let uploaded = 0;
+            for (let i = 0; i < commits.length; i += COMMIT_BATCH_SIZE) {
+                const batch = commits.slice(i, i + COMMIT_BATCH_SIZE);
+                const response = await client.post("/api/project-link/commits", {
+                    projectId: effectiveProjectId,
+                    sinceCommitSha: cache.lastCommitSha,
+                    commits: batch.map((c) => ({
+                        sha: c.sha,
+                        authorName: c.authorName,
+                        authorEmail: c.authorEmail,
+                        date: c.date,
+                        message: c.message,
+                        branch: c.branch,
+                    })),
+                });
+                uploaded += response.accepted;
+                commitCount = response.totalCommits;
+                // Show progress for large uploads
+                if (commits.length > COMMIT_BATCH_SIZE) {
+                    const done = Math.min(i + COMMIT_BATCH_SIZE, commits.length);
+                    log(`  Uploading commits... ${done}/${commits.length}`);
+                }
+            }
+            // Update cache with latest commit SHA
+            if (commits.length > 0) {
+                updateCachedCommitSha(db, effectiveProjectId, serverUrl, commits[0].sha);
+                cache.lastCommitSha = commits[0].sha;
+            }
+            log(`  ${uploaded} new commits uploaded (${commitCount} total)`);
+        }
+    }
+    else {
+        log("  Skipping commit history (--skip-commits)");
+    }
+    endStep("Upload git metadata", step2Start);
+    // ──────────────────────────────────────────────────────────
+    // Step 4: Discover project documents
+    // ──────────────────────────────────────────────────────────
+    let documentCount = 0;
+    let discoveredDocs = [];
+    const step3Start = startStep();
+    if (!options.skipDocs) {
+        log("\n[Step 3/6] Discovering project documents...");
+        const docSettings = loadDocSettings(projectRoot);
+        discoveredDocs = discoverDocuments(projectRoot, cache.docHashes, docSettings);
+        if (discoveredDocs.length === 0) {
+            log("  No documents found matching patterns.");
+        }
+        else {
+            log(`  Found ${discoveredDocs.length} document${discoveredDocs.length !== 1 ? "s" : ""}:`);
+            for (const doc of discoveredDocs) {
+                const sizeKB = (doc.sizeBytes / 1024).toFixed(1);
+                const tag = doc.status === "new" ? "[NEW]    " :
+                    doc.status === "changed" ? "[CHANGED]" :
+                        "[SKIP]   ";
+                log(`    ${tag} ${doc.sourcePath} (${sizeKB} KB)`);
+            }
+            // Warn if many documents matched
+            if (discoveredDocs.length > 50) {
+                log(`\n  Warning: ${discoveredDocs.length} documents found. Consider narrowing patterns in settings.json`);
+            }
+        }
+        // ──────────────────────────────────────────────────────────
+        // Step 5: Upload documents
+        // ──────────────────────────────────────────────────────────
+        const toUpload = discoveredDocs.filter((d) => d.status !== "unchanged");
+        if (toUpload.length === 0) {
+            log("\n[Step 4/6] All documents up to date.");
+            documentCount = discoveredDocs.length;
+        }
+        else if (options.dryRun) {
+            log(`\n[Step 4/6] [dry-run] Would upload ${toUpload.length} document${toUpload.length !== 1 ? "s" : ""}`);
+            documentCount = discoveredDocs.length;
+        }
+        else {
+            log(`\n[Step 4/6] Uploading ${toUpload.length} document${toUpload.length !== 1 ? "s" : ""}...`);
+            const response = await client.post("/api/project-link/documents", {
+                projectId: effectiveProjectId,
+                documents: toUpload.map((d) => ({
+                    fileName: d.fileName,
+                    sourcePath: d.sourcePath,
+                    content: d.content,
+                    contentHash: d.contentHash,
+                })),
+            });
+            const s = response.summary;
+            log(`  ${s.total} documents processed (${s.created} new, ${s.updated} updated, ${s.unchanged} unchanged)`);
+            documentCount = discoveredDocs.length;
+            // Update cached hashes
+            const newHashes = { ...cache.docHashes };
+            for (const doc of discoveredDocs) {
+                newHashes[doc.sourcePath] = doc.contentHash;
+            }
+            updateCachedDocHashes(db, effectiveProjectId, serverUrl, newHashes);
+            cache.docHashes = newHashes;
+        }
+    }
+    else {
+        log("\n[Step 3/6] Skipping document upload (--skip-docs)");
+        log("\n[Step 4/6] Skipping document upload (--skip-docs)");
+    }
+    endStep("Discover & upload documents", step3Start);
+    // ──────────────────────────────────────────────────────────
+    // Step 6: Quality check
+    // ──────────────────────────────────────────────────────────
+    let qualified = cache.qualified;
+    let score = null;
+    const step5Start = startStep();
+    if (!options.skipDocs && !options.dryRun && !options.skipQualify) {
+        log("\n[Step 5/6] Checking document quality...");
+        const qualifyResult = await checkQuality(client, effectiveProjectId);
+        qualified = qualifyResult.qualified;
+        score = qualifyResult.score;
+        if (qualified) {
+            log(`  Documents qualified (score: ${score.toFixed(2)})`);
+        }
+        else {
+            log(`  Documents not yet qualified (score: ${score.toFixed(2)})`);
+            const feedback = formatQualityFeedback(qualifyResult);
+            if (feedback) {
+                log(feedback);
+            }
+            // In CLI context: show the summary prompt for the user
+            if (qualifyResult.feedback?.summaryPrompt) {
+                log("");
+                log("  To improve quality, generate a project summary by running this");
+                log("  prompt in your AI coding CLI, then re-run '/adit link':");
+                log("");
+                log(`  "${qualifyResult.feedback.summaryPrompt}"`);
+            }
+        }
+        updateCachedQualified(db, effectiveProjectId, serverUrl, qualified);
+        cache.qualified = qualified;
+    }
+    else {
+        log("\n[Step 5/6] Skipping quality check");
+    }
+    endStep("Quality check", step5Start);
+    const totalDurationMs = Math.round(performance.now() - totalStart);
+    // ──────────────────────────────────────────────────────────
+    // Final: Summary
+    // ──────────────────────────────────────────────────────────
+    const qualifiedLabel = qualified ? "qualified" : "not qualified";
+    log("");
+    log("══════════════════════════════════════════");
+    log("Project link complete!");
+    log(`Project:    ${projectName}`);
+    log(`Server:     ${serverUrl}`);
+    log(`Branches:   ${branchCount}`);
+    log(`Commits:    ${commitCount}`);
+    log(`Documents:  ${documentCount} (${qualifiedLabel})`);
+    log("──────────────────────────────────────────");
+    for (const t of stepTimings) {
+        log(`  ${t.step.padEnd(28)} ${formatDuration(t.durationMs)}`);
+    }
+    log(`  ${"Total".padEnd(28)} ${formatDuration(totalDurationMs)}`);
+    log("══════════════════════════════════════════");
+    return {
+        projectId: effectiveProjectId,
+        projectName,
+        serverUrl,
+        branchCount,
+        commitCount,
+        documentCount,
+        qualified,
+        score,
+        stepTimings,
+        totalDurationMs,
+    };
+}
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ *
+ * Examples: "42ms", "1.2s", "2m 3s"
+ */
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const seconds = ms / 1000;
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = Math.round(seconds % 60);
+    return `${minutes}m ${remainingSeconds}s`;
+}
+//# sourceMappingURL=link-command.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Document quality check and feedback formatting.
+ *
+ * Calls the server's qualify endpoint to evaluate whether uploaded
+ * project documents provide sufficient context for IDD planning.
+ * If not qualified, formats the server's feedback for display and
+ * returns the summaryPrompt for the AI agent to use.
+ */
+import type { CloudClient } from "../http/client.js";
+import type { QualifyResponse } from "./types.js";
+/**
+ * Check document quality with the server.
+ *
+ * Returns the server's qualify response including score, qualification
+ * status, and feedback with a summary prompt if not qualified.
+ */
+export declare function checkQuality(client: CloudClient, projectId: string): Promise<QualifyResponse>;
+/**
+ * Format quality feedback for human-readable display.
+ *
+ * Returns a multi-line string describing what's missing and
+ * suggestions for improvement. Returns null if already qualified.
+ */
+export declare function formatQualityFeedback(response: QualifyResponse): string | null;
+//# sourceMappingURL=qualify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualify.d.ts","sourceRoot":"","sources":["../../src/project-link/qualify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAuB9E"}

package/dist/project-link/qualify.js

@@ -0,0 +1,45 @@
+/**
+ * Document quality check and feedback formatting.
+ *
+ * Calls the server's qualify endpoint to evaluate whether uploaded
+ * project documents provide sufficient context for IDD planning.
+ * If not qualified, formats the server's feedback for display and
+ * returns the summaryPrompt for the AI agent to use.
+ */
+/**
+ * Check document quality with the server.
+ *
+ * Returns the server's qualify response including score, qualification
+ * status, and feedback with a summary prompt if not qualified.
+ */
+export async function checkQuality(client, projectId) {
+    return client.get(`/api/project-link/qualify?projectId=${encodeURIComponent(projectId)}`);
+}
+/**
+ * Format quality feedback for human-readable display.
+ *
+ * Returns a multi-line string describing what's missing and
+ * suggestions for improvement. Returns null if already qualified.
+ */
+export function formatQualityFeedback(response) {
+    if (response.qualified || !response.feedback)
+        return null;
+    const lines = [];
+    lines.push(`  Score: ${response.score.toFixed(2)} (needs 0.60 to qualify)`);
+    lines.push("");
+    if (response.feedback.missing.length > 0) {
+        lines.push("  Missing:");
+        for (const item of response.feedback.missing) {
+            lines.push(`    - ${item}`);
+        }
+        lines.push("");
+    }
+    if (response.feedback.suggestions.length > 0) {
+        lines.push("  Suggestions:");
+        for (const item of response.feedback.suggestions) {
+            lines.push(`    - ${item}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=qualify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualify.js","sourceRoot":"","sources":["../../src/project-link/qualify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAmB,EACnB,SAAiB;IAEjB,OAAO,MAAM,CAAC,GAAG,CACf,uCAAuC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CACvE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAyB;IAC7D,IAAI,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}