@indigoai-us/hq-cli 5.273.0-alpha.0 → 5.274.0

package/dist/commands/daemon.js

@@ -18,7 +18,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { major as semverMajor, valid as validSemver } from "semver";
 import { DEFAULT_SERVICES, SERVICE_DESCRIPTIONS, enabledServices, hqCloudUnits } from "../lib/daemon/catalog.js";
-import { applyServiceToggle, effectiveSyncOwner, readDaemonConfig, writeDaemonConfig } from "../lib/daemon/config.js";
+import { applyServiceToggle, readDaemonConfig, writeDaemonConfig } from "../lib/daemon/config.js";
 import { daemonUnitInstalled } from "../lib/daemon/handoff.js";
 import { adoptLegacyUnits, readAdoptedUnits, restoreLegacyUnits } from "../lib/daemon/migrate.js";
 import { ROOT_REFUSAL, SYSTEM_UNIT_DIR, daemonRootRefusal, installDaemonUnit, installScopeFor, uninstallDaemonUnit, } from "../lib/daemon/install.js";
@@ -27,10 +27,7 @@ import { isDaemonProcess, runningDaemonPid } from "../lib/daemon/lock.js";
 import { bundledHqCloud } from "../lib/daemon/hq-cloud.js";
 import { MACHINE_TYPE_MARKER_PATH, detectMachineType, homeFromPasswd, } from "../lib/daemon/machine-type.js";
 import { daemonPaths } from "../lib/daemon/paths.js";
-import { processCommandLine } from "../lib/daemon/lock.js";
 import { writeControlRequest } from "../lib/daemon/requests.js";
-import { isSyncRunnerCommandLine, readWatchRunnerOwnerStatus, watchRunnerOwnerStatusPath } from "../lib/daemon/sync-runner.js";
-import { getSyncModeForCompany, setSyncMode } from "./sync-mode.js";
 import { resolveDefaultHqRoot } from "../utils/cognito-session.js";
 class DaemonCommandError extends Error {
 }
@@ -99,7 +96,6 @@ async function loadDefaults(over) {
         windowsUser: over.windowsUser ?? (platform === "win32" ? mesh.resolveWindowsUser(env) : ""),
         windowsHeadlessLauncher: over.windowsHeadlessLauncher ?? (platform === "win32" ? mesh.resolveWindowsHeadlessLauncher(env) : undefined),
         systemUnitDir: over.systemUnitDir ?? SYSTEM_UNIT_DIR,
-        syncModeClient: over.syncModeClient,
     };
 }
 function detect(d, flag, config) {
@@ -376,135 +372,6 @@ function queueRequest(d, request, what) {
     const running = runningDaemonPid(paths.lockPath, d.daemonAlive) !== null;
     d.out(running ? `Asked the daemon to ${what}.` : `Queued "${what}"; the daemon is not running, so it applies when it starts.`);
 }
-function daemonSyncModeClient(d) {
-    if (d.syncModeClient)
-        return d.syncModeClient();
-    return (async () => {
-        const [{ VaultClient }, { buildVaultConfig, ensureCognitoToken }] = await Promise.all([
-            import("@indigoai-us/hq-cloud"),
-            import("../utils/cognito-session.js"),
-        ]);
-        const token = await ensureCognitoToken();
-        return new VaultClient(buildVaultConfig(token));
-    })();
-}
-function daemonSyncStatus(d) {
-    const host = currentHost(d);
-    const { paths } = host;
-    const config = readDaemonConfig(paths.configPath);
-    const daemonPid = runningDaemonPid(paths.lockPath, d.daemonAlive);
-    const daemonState = daemonPid === null ? null : readState(paths);
-    const syncUnit = daemonState?.units.find((unit) => unit.id === "sync");
-    const hqRoot = config.hqRoot ?? d.env.HQ_ROOT?.trim();
-    let ownerStatusCandidate = null;
-    if (hqRoot) {
-        try {
-            ownerStatusCandidate = readWatchRunnerOwnerStatus(watchRunnerOwnerStatusPath(hqRoot, d.home, d.env));
-        }
-        catch (error) {
-            const detail = error instanceof Error ? error.message : String(error);
-            d.err(`Could not read sync runner owner status; treating it as unavailable: ${detail}`);
-        }
-    }
-    const ownerCommandLine = ownerStatusCandidate
-        ? processCommandLine(ownerStatusCandidate.pid, { platform: d.platform, run: d.run })
-        : null;
-    const ownerStatus = ownerCommandLine && isSyncRunnerCommandLine(ownerCommandLine)
-        ? ownerStatusCandidate
-        : null;
-    return {
-        running: syncUnit?.status === "running",
-        paused: config.syncPaused === true,
-        syncOwner: effectiveSyncOwner(config, host.detected.type),
-        owner: ownerStatus?.owner ?? (syncUnit?.status === "running" ? "hq-daemon" : null),
-        runnerPid: ownerStatus?.pid ?? syncUnit?.pid ?? null,
-        hqCloudVersion: ownerStatus?.version ?? null,
-        lastHeartbeat: syncUnit?.lastHeartbeatAt ?? ownerStatus?.heartbeatAt ?? null,
-        lastPassResult: syncUnit?.lastPassResult ?? null,
-        unitStatus: syncUnit?.status ?? "not-running",
-        reason: syncUnit?.reason ?? null,
-        logPath: paths.unitLogPath("sync"),
-    };
-}
-async function runDaemonSyncStatus(d, opts) {
-    const status = daemonSyncStatus(d);
-    if (opts.json) {
-        d.out(JSON.stringify(status, null, 2));
-        return;
-    }
-    d.out(`Sync ${status.running ? "running" : status.unitStatus}${status.paused ? " (paused)" : ""}.`);
-    d.out(`Configured sync owner: ${status.syncOwner}.`);
-    d.out(`Owner: ${status.owner ?? "none"}; runner pid: ${status.runnerPid ?? "none"}; hq-cloud: ${status.hqCloudVersion ?? "unknown"}.`);
-    if (status.reason)
-        d.out(`Reason: ${status.reason}`);
-    d.out(`Log: ${status.logPath}`);
-}
-function queueDaemonSyncControl(d, request) {
-    const host = currentHost(d);
-    writeControlRequest(host.paths.requestsDir, request);
-    handOver(d, host);
-    return runningDaemonPid(host.paths.lockPath, d.daemonAlive) !== null;
-}
-async function runDaemonSyncNow(d, opts) {
-    const host = currentHost(d);
-    const config = readDaemonConfig(host.paths.configPath);
-    if (config.syncPaused)
-        throw new DaemonCommandError("sync is paused; run `hq daemon sync resume` first");
-    if (!enabledServices(host.detected.type, config).includes("sync")) {
-        throw new DaemonCommandError("sync is disabled for this machine; run `hq daemon enable sync` first");
-    }
-    const running = queueDaemonSyncControl(d, { action: "restart", unit: "sync" });
-    const result = { accepted: true, action: "restart-sync-runner", daemonRunning: running };
-    d.out(opts.json ? JSON.stringify(result, null, 2) : running ? "Asked the daemon to start a fresh sync pass." : "Queued a fresh sync pass for the next daemon start.");
-}
-async function runDaemonSyncPause(d, paused, opts) {
-    const host = currentHost(d);
-    const config = readDaemonConfig(host.paths.configPath);
-    if (config.syncPaused !== paused)
-        writeDaemonConfig(host.paths.configPath, { ...config, syncPaused: paused });
-    const daemonRunning = queueDaemonSyncControl(d, { action: "reconcile" });
-    const result = { paused, persisted: true, daemonRunning };
-    d.out(opts.json ? JSON.stringify(result, null, 2) : `Sync ${paused ? "paused" : "resumed"}${daemonRunning ? "" : "; the setting will apply when the daemon starts"}.`);
-}
-async function runDaemonSyncTakeOwnership(d, opts) {
-    const host = currentHost(d);
-    const config = readDaemonConfig(host.paths.configPath);
-    if (config.syncOwner !== "daemon")
-        writeDaemonConfig(host.paths.configPath, { ...config, syncOwner: "daemon" });
-    const daemonRunning = queueDaemonSyncControl(d, { action: "reconcile" });
-    const result = { syncOwner: "daemon", persisted: true, daemonRunning };
-    d.out(opts.json ? JSON.stringify(result, null, 2) : `Daemon sync ownership persisted${daemonRunning ? "; asked the daemon to reconcile" : "; it applies when the daemon starts"}.`);
-}
-async function runDaemonSyncModeGet(d, companySlug, opts) {
-    const result = await getSyncModeForCompany({ companySlug, vaultClient: await daemonSyncModeClient(d) });
-    const value = {
-        companySlug: result.companySlug,
-        membershipId: result.membershipId,
-        mode: result.config.syncMode,
-        isDefault: result.config.isDefault,
-        ...(result.config.updatedAt ? { updatedAt: result.config.updatedAt } : {}),
-    };
-    d.out(opts.json ? JSON.stringify(value, null, 2) : `${value.companySlug}: ${value.mode}${value.isDefault ? " (default)" : ""}`);
-}
-async function runDaemonSyncModeSet(d, companySlug, mode, opts) {
-    if (mode !== "all" && mode !== "shared") {
-        throw new DaemonCommandError(`Invalid sync mode '${mode}'. Use all or shared.`);
-    }
-    const result = await setSyncMode({
-        mode,
-        companySlug,
-        vaultClient: await daemonSyncModeClient(d),
-    });
-    const value = {
-        companySlug: result.companySlug,
-        membershipId: result.membershipId,
-        previousMode: result.previousMode,
-        mode: result.newMode,
-        isDefault: result.newConfig.isDefault,
-        ...(result.newConfig.updatedAt ? { updatedAt: result.newConfig.updatedAt } : {}),
-    };
-    d.out(opts.json ? JSON.stringify(value, null, 2) : `${value.companySlug}: ${value.previousMode} → ${value.mode}`);
-}
 async function runToggle(d, action, services) {
     const host = currentHost(d);
     const { paths } = host;
@@ -736,45 +603,6 @@ export function registerDaemonCommand(program, over = {}) {
         .description("Show the machine type and each service's state")
         .option("--json", "Print machine-readable JSON")
         .action(wrap((d, opts) => runStatus(d, opts)));
-    const sync = daemon
-        .command("sync")
-        .description("Inspect and control the daemon's company sync runner");
-    sync
-        .command("status")
-        .description("Show sync ownership, heartbeat, last pass and log path")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, opts) => runDaemonSyncStatus(d, opts)));
-    sync
-        .command("now")
-        .description("Start a fresh sync pass immediately")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, opts) => runDaemonSyncNow(d, opts)));
-    sync
-        .command("pause")
-        .description("Pause daemon sync until resumed")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, opts) => runDaemonSyncPause(d, true, opts)));
-    sync
-        .command("resume")
-        .description("Resume daemon sync after a pause")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, opts) => runDaemonSyncPause(d, false, opts)));
-    sync
-        .command("take-ownership")
-        .description("Persist daemon ownership of desktop sync and reconcile")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, opts) => runDaemonSyncTakeOwnership(d, opts)));
-    const mode = sync.command("mode").description("Read or change a company's sync footprint");
-    mode
-        .command("get <company>")
-        .description("Read a company's current all/shared sync mode")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, company, opts) => runDaemonSyncModeGet(d, company, opts)));
-    mode
-        .command("set <company> <mode>")
-        .description("Set a company's sync mode to all or shared")
-        .option("--json", "Print machine-readable JSON")
-        .action(wrap((d, company, mode, opts) => runDaemonSyncModeSet(d, company, mode, opts)));
     daemon
         .command("logs [unit]")
         .description("Print the supervisor log, or one service's log")

package/dist/commands/deploy-comments.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerDeployCommentsCommand(deploy: Command): void;
+//# sourceMappingURL=deploy-comments.d.ts.map

package/dist/commands/deploy-comments.js

@@ -0,0 +1,159 @@
+import { deployApiRequest } from "../lib/deploy-api.js";
+import { DEFAULT_HQ_ROOT, ensureCognitoToken } from "../utils/cognito-session.js";
+import { readActiveCompanySlug } from "./skill.js";
+class DeployCommentsError extends Error {
+}
+function callerOrgHeaders(companyFlag) {
+    const slug = companyFlag ?? readActiveCompanySlug(DEFAULT_HQ_ROOT);
+    if (slug === undefined)
+        return {};
+    if (!/^[a-z0-9][a-z0-9-]{0,62}$/.test(slug)) {
+        throw new DeployCommentsError("The company slug is not valid.");
+    }
+    return { "X-Org-Slug": slug };
+}
+function errorCode(body, status) {
+    const code = body.error?.code;
+    return typeof code === "string" && /^[A-Z0-9_]+$/.test(code) ? code : `HTTP_${status}`;
+}
+async function responseError(response) {
+    const body = await response.json().catch(() => ({}));
+    const code = errorCode(body, response.status);
+    if (response.status === 401 || response.status === 403) {
+        return new DeployCommentsError(`You need to be the app owner or an org admin to read its comments. (${code})`);
+    }
+    if (response.status === 404) {
+        return new DeployCommentsError(`App was not found in the current org. (${code})`);
+    }
+    if (response.status === 429) {
+        const value = response.headers.get("Retry-After");
+        const retryAfter = value && /^\d+$/.test(value) ? value : "unknown";
+        return new DeployCommentsError(`Comment reads are rate limited. Retry-After: ${retryAfter} seconds. (${code})`);
+    }
+    return new DeployCommentsError(`Could not read deploy comments (HTTP ${response.status}, ${code}).`);
+}
+async function deployJson(token, route, orgHeaders) {
+    let response;
+    try {
+        response = await deployApiRequest(token, route, "GET", undefined, orgHeaders);
+    }
+    catch {
+        throw new DeployCommentsError("Could not reach hq-deploy.");
+    }
+    if (!response.ok)
+        throw await responseError(response);
+    try {
+        return await response.json();
+    }
+    catch {
+        throw new DeployCommentsError("hq-deploy returned an invalid response.");
+    }
+}
+async function resolveAppId(token, appNameOrId, orgHeaders) {
+    const result = await deployJson(token, "/api/apps", orgHeaders);
+    const apps = Array.isArray(result.apps) ? result.apps : [];
+    const byId = apps.find((app) => app && typeof app.id === "string" && app.id === appNameOrId);
+    const matches = byId
+        ? [byId]
+        : apps.filter((app) => app && typeof app.id === "string" && app.name === appNameOrId);
+    const ids = [...new Set(matches.map((app) => app.id).filter((id) => typeof id === "string"))];
+    if (ids.length === 0)
+        throw new DeployCommentsError("App was not found in the current org.");
+    if (ids.length > 1)
+        throw new DeployCommentsError("More than one app has that name in the current org; use its app id.");
+    return ids[0];
+}
+async function listComments(token, appId, orgHeaders) {
+    const route = `/api/apps/${encodeURIComponent(appId)}/manage/comments`;
+    const result = await deployJson(token, route, orgHeaders);
+    if (typeof result.commentsEnabled !== "boolean" || !Array.isArray(result.comments)) {
+        throw new DeployCommentsError("hq-deploy returned an incomplete comments response.");
+    }
+    return { commentsEnabled: result.commentsEnabled, comments: result.comments };
+}
+function displayText(value) {
+    return [...String(value ?? "")].map((character) => {
+        const code = character.codePointAt(0) ?? 0;
+        return isUnsafeTerminalCodePoint(code)
+            ? `\\u${code.toString(16).padStart(4, "0")}`
+            : character;
+    }).join("");
+}
+function isUnsafeTerminalCodePoint(code) {
+    return code <= 0x1f
+        || (code >= 0x7f && code <= 0x9f)
+        || (code >= 0x202a && code <= 0x202e)
+        || (code >= 0x2066 && code <= 0x2069);
+}
+function safeJson(value) {
+    return JSON.stringify(value, null, 2).replace(/[\u007f-\u009f\u202a-\u202e\u2066-\u2069]/gu, (character) => `\\u${(character.codePointAt(0) ?? 0).toString(16).padStart(4, "0")}`);
+}
+function printCommentLine(comment) {
+    const firstLine = comment.body.split(/\r\n|\r|\n/, 1)[0] ?? "";
+    console.log([
+        displayText(comment.id),
+        displayText(comment.status),
+        displayText(comment.createdAt),
+        displayText(comment.author?.name || "Unknown author"),
+        displayText(comment.anchor?.mode || "unknown"),
+        displayText(firstLine),
+    ].join("  |  "));
+}
+async function run(action) {
+    try {
+        await action();
+    }
+    catch (error) {
+        console.error(error instanceof DeployCommentsError ? error.message : "Deploy comments command failed.");
+        process.exitCode = 1;
+    }
+}
+async function listAction(appNameOrId, options) {
+    const status = options.status ?? "all";
+    if (status !== "open" && status !== "resolved" && status !== "all") {
+        throw new DeployCommentsError("--status must be open, resolved, or all.");
+    }
+    const token = await ensureCognitoToken();
+    const orgHeaders = callerOrgHeaders(options.company);
+    const appId = await resolveAppId(token, appNameOrId, orgHeaders);
+    const result = await listComments(token, appId, orgHeaders);
+    const comments = status === "all"
+        ? result.comments
+        : result.comments.filter((comment) => comment.status === status);
+    if (options.json) {
+        console.log(safeJson({ commentsEnabled: result.commentsEnabled, comments }));
+        return;
+    }
+    if (comments.length === 0) {
+        console.log("No comments.");
+        return;
+    }
+    for (const comment of comments)
+        printCommentLine(comment);
+}
+async function readAction(appNameOrId, commentId, company) {
+    const token = await ensureCognitoToken();
+    const orgHeaders = callerOrgHeaders(company);
+    const appId = await resolveAppId(token, appNameOrId, orgHeaders);
+    const result = await listComments(token, appId, orgHeaders);
+    const comment = result.comments.find((entry) => entry.id === commentId);
+    if (!comment)
+        throw new DeployCommentsError(`Comment '${displayText(commentId)}' was not found on that app.`);
+    console.log(safeJson(comment));
+}
+export function registerDeployCommentsCommand(deploy) {
+    const comments = deploy.command("comments").description("List and read comments on your deployed apps");
+    comments
+        .command("list <app>")
+        .description("List comments on an app in your org")
+        .option("--company <slug>", "use this company instead of the active company")
+        .option("--json", "print the API comment array as JSON")
+        .option("--status <status>", "filter by open, resolved, or all", "all")
+        .action((app, options) => run(() => listAction(app, options)));
+    comments
+        .command("read <app> <commentId>")
+        .description("Read a comment on an app in your org")
+        .option("--company <slug>", "use this company instead of the active company")
+        .action((app, commentId, options) => run(() => readAction(app, commentId, options.company)));
+}
+//# sourceMappingURL=deploy-comments.js.map

package/dist/commands/lanes-checks.d.ts

@@ -4,7 +4,6 @@ import type { LaneCompanyRef, QuestionRecord } from "../lib/lanes/types.js";
 export interface LaneChecksDeps {
     hqRoot: () => string;
     resolveCompany: (company?: string) => Promise<LaneCompanyRef>;
-    trackerEnabled: (company: LaneCompanyRef) => boolean | Promise<boolean>;
     now: () => Date;
     stopLane?: (laneId: string, reason: string) => Promise<void>;
     sessionState?: (root: string, sessionId: string, now: Date) => string | null;