@indigoai-us/hq-cli 5.14.0 → 5.15.0

package/dist/commands/meetings.js

@@ -0,0 +1,374 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8237a835-5842-52be-bb27-c4ffb7944d89")}catch(e){}}();
+import chalk from "chalk";
+import { ensureCognitoToken } from "../utils/cognito-session.js";
+import { vaultApiFetch } from "../utils/vault-api.js";
+function formatDuration(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    if (h > 0)
+        return `${h}h ${m}m`;
+    if (m > 0)
+        return `${m}m ${s}s`;
+    return `${s}s`;
+}
+function formatTimestamp(ts) {
+    const m = Math.floor(ts / 60);
+    const s = Math.floor(ts % 60);
+    return `${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+function statusBadge(status) {
+    switch (status) {
+        case "completed":
+            return chalk.green(status);
+        case "recording":
+            return chalk.red(status);
+        case "processing":
+            return chalk.yellow(status);
+        case "failed":
+            return chalk.red(status);
+        default:
+            return chalk.dim(status);
+    }
+}
+async function resolveShortId(token, prefix, query) {
+    if (prefix.includes("-") && prefix.length > 8)
+        return prefix;
+    const res = await vaultApiFetch({ token, path: "/v1/meetings", query });
+    if (!res.ok)
+        return prefix;
+    const data = (await res.json());
+    const matches = data.meetings.filter((m) => m.meetingId.startsWith(prefix));
+    if (matches.length === 1)
+        return matches[0].meetingId;
+    if (matches.length > 1) {
+        console.error(chalk.red(`Ambiguous ID prefix "${prefix}" — matches ${matches.length} meetings. Use a longer prefix.`));
+        process.exit(1);
+    }
+    return prefix;
+}
+async function handleApiError(res) {
+    const body = (await res.json().catch(() => ({})));
+    if (res.status === 401) {
+        console.error(chalk.red("Not authenticated — run `hq login` first"));
+    }
+    else if (res.status === 403) {
+        console.error(chalk.red(body.error ?? "Not authorized"));
+    }
+    else if (res.status === 404) {
+        console.error(chalk.red(body.error ?? "Not found"));
+    }
+    else {
+        console.error(chalk.red(`API error (${res.status}): ${body.error ?? res.statusText}`));
+    }
+    process.exit(1);
+}
+function printMeetingTable(meetings) {
+    if (meetings.length === 0) {
+        console.log(chalk.dim("  No meetings found."));
+        return;
+    }
+    const ID_W = 8;
+    const TITLE_W = Math.min(40, Math.max(10, ...meetings.map((m) => m.title.length)));
+    const DATE_W = 16;
+    const DUR_W = 8;
+    const STATUS_W = 12;
+    const PARTS_W = 6;
+    const FLAGS_W = 5;
+    console.log(chalk.bold([
+        "ID".padEnd(ID_W),
+        "TITLE".padEnd(TITLE_W),
+        "DATE".padEnd(DATE_W),
+        "DUR".padEnd(DUR_W),
+        "STATUS".padEnd(STATUS_W),
+        "PARTS".padEnd(PARTS_W),
+        "FLAGS",
+    ].join("  ")));
+    for (const m of meetings) {
+        const id = m.meetingId.slice(0, 8);
+        const title = m.title.length > TITLE_W ? m.title.slice(0, TITLE_W - 1) + "…" : m.title;
+        const date = new Date(m.startTime).toLocaleDateString("en-US", {
+            month: "short",
+            day: "numeric",
+            hour: "2-digit",
+            minute: "2-digit",
+        });
+        const dur = formatDuration(m.duration);
+        const flags = [
+            m.hasTranscript ? "T" : "",
+            m.hasNotes ? "N" : "",
+        ].filter(Boolean).join("") || "-";
+        console.log([
+            chalk.cyan(id.padEnd(ID_W)),
+            title.padEnd(TITLE_W),
+            chalk.dim(date.padEnd(DATE_W)),
+            dur.padEnd(DUR_W),
+            statusBadge(m.status).padEnd(STATUS_W + 10), // chalk adds escape chars
+            String(m.participantCount).padEnd(PARTS_W),
+            flags,
+        ].join("  "));
+    }
+}
+export function registerMeetingsCommand(program) {
+    const meetings = program
+        .command("meetings")
+        .description("View and search meeting recordings, transcripts, and notes")
+        .option("--company <slug>", "Company slug (for multi-company users)")
+        .option("--json", "Output raw JSON instead of formatted text");
+    // ── hq meetings list ──────────────────────────────────────────────
+    meetings
+        .command("list")
+        .description("List recorded meetings (newest first)")
+        .option("--limit <n>", "Number of meetings to return (default: 20)")
+        .option("--next <token>", "Pagination token from a previous response")
+        .action(async (opts) => {
+        try {
+            const token = await ensureCognitoToken();
+            const query = {};
+            const companySlug = meetings.opts().company;
+            if (opts.limit)
+                query.limit = opts.limit;
+            if (opts.next)
+                query.nextToken = opts.next;
+            if (companySlug)
+                query.companyId = companySlug;
+            const res = await vaultApiFetch({ token, path: "/v1/meetings", query });
+            if (!res.ok)
+                await handleApiError(res);
+            const data = (await res.json());
+            if (meetings.opts().json) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            console.log(chalk.bold(`\nMeetings (${data.meetings.length}):\n`));
+            printMeetingTable(data.meetings);
+            if (data.nextToken) {
+                console.log(chalk.dim(`\n  More results available. Run with --next ${data.nextToken}`));
+            }
+            console.log();
+        }
+        catch (err) {
+            console.error(chalk.red("Error:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    // ── hq meetings get <id> ──────────────────────────────────────────
+    meetings
+        .command("get <meetingId>")
+        .description("Show meeting details")
+        .action(async (rawId) => {
+        try {
+            const token = await ensureCognitoToken();
+            const query = {};
+            const companySlug = meetings.opts().company;
+            if (companySlug)
+                query.companyId = companySlug;
+            const meetingId = await resolveShortId(token, rawId, query);
+            const res = await vaultApiFetch({
+                token,
+                path: `/v1/meetings/${encodeURIComponent(meetingId)}`,
+                query,
+            });
+            if (!res.ok)
+                await handleApiError(res);
+            const detail = (await res.json());
+            if (meetings.opts().json) {
+                console.log(JSON.stringify(detail, null, 2));
+                return;
+            }
+            console.log(chalk.bold(`\n${detail.title}\n`));
+            console.log(`  ID:       ${chalk.cyan(detail.meetingId)}`);
+            console.log(`  Status:   ${statusBadge(detail.status)}`);
+            console.log(`  Date:     ${new Date(detail.startTime).toLocaleString()}`);
+            console.log(`  Duration: ${formatDuration(detail.duration)}`);
+            console.log(`  Source:   ${detail.sourceApp} (${detail.botProvider})`);
+            console.log(`  Shared:   ${detail.isShared ? "yes" : "no"}`);
+            if (detail.participants.length > 0) {
+                console.log(chalk.bold("\n  Participants:"));
+                for (const p of detail.participants) {
+                    const name = p.name ?? p.email;
+                    const role = p.role === "organizer" ? chalk.yellow(" (organizer)") : "";
+                    console.log(`    - ${name}${role}`);
+                }
+            }
+            const flags = [];
+            if (detail.hasTranscript)
+                flags.push("transcript");
+            if (detail.hasNotes)
+                flags.push("notes");
+            if (flags.length > 0) {
+                console.log(chalk.dim(`\n  Available: ${flags.join(", ")}. Use \`hq meetings transcript ${detail.meetingId.slice(0, 8)}\` or \`hq meetings notes ${detail.meetingId.slice(0, 8)}\`.`));
+            }
+            console.log();
+        }
+        catch (err) {
+            console.error(chalk.red("Error:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    // ── hq meetings search <query> ─────────────────────────────────────
+    meetings
+        .command("search <query>")
+        .description("Search meetings by title or participant name")
+        .action(async (query) => {
+        try {
+            const token = await ensureCognitoToken();
+            const params = { q: query };
+            const companySlug = meetings.opts().company;
+            if (companySlug)
+                params.companyId = companySlug;
+            const res = await vaultApiFetch({
+                token,
+                path: "/v1/meetings/search",
+                query: params,
+            });
+            if (!res.ok)
+                await handleApiError(res);
+            const data = (await res.json());
+            if (meetings.opts().json) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            console.log(chalk.bold(`\nSearch results for "${data.query}" (${data.results.length}):\n`));
+            printMeetingTable(data.results);
+            console.log();
+        }
+        catch (err) {
+            console.error(chalk.red("Error:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    // ── hq meetings transcript <id> ────────────────────────────────────
+    meetings
+        .command("transcript <meetingId>")
+        .description("Print the meeting transcript")
+        .action(async (rawId) => {
+        try {
+            const token = await ensureCognitoToken();
+            const query = {};
+            const companySlug = meetings.opts().company;
+            if (companySlug)
+                query.companyId = companySlug;
+            const meetingId = await resolveShortId(token, rawId, query);
+            const res = await vaultApiFetch({
+                token,
+                path: `/v1/meetings/${encodeURIComponent(meetingId)}`,
+                query,
+            });
+            if (!res.ok)
+                await handleApiError(res);
+            const detail = (await res.json());
+            if (!detail.documentUrl) {
+                console.error(chalk.red("No document URL available for this meeting."));
+                process.exit(1);
+            }
+            const docRes = await fetch(detail.documentUrl);
+            if (!docRes.ok) {
+                console.error(chalk.red(`Failed to download meeting document (${docRes.status})`));
+                process.exit(1);
+            }
+            const doc = (await docRes.json());
+            if (meetings.opts().json) {
+                console.log(JSON.stringify(doc.transcript, null, 2));
+                return;
+            }
+            if (!doc.transcript || doc.transcript.length === 0) {
+                console.log(chalk.yellow("No transcript available for this meeting."));
+                return;
+            }
+            console.log(chalk.bold(`\nTranscript: ${doc.title}\n`));
+            for (const seg of doc.transcript) {
+                const time = formatTimestamp(seg.startTime);
+                console.log(`${chalk.dim(time)}  ${chalk.cyan(seg.speaker)}`);
+                console.log(`        ${seg.text}\n`);
+            }
+        }
+        catch (err) {
+            console.error(chalk.red("Error:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    // ── hq meetings notes <id> ─────────────────────────────────────────
+    meetings
+        .command("notes <meetingId>")
+        .description("Print AI-generated meeting notes")
+        .action(async (rawId) => {
+        try {
+            const token = await ensureCognitoToken();
+            const query = {};
+            const companySlug = meetings.opts().company;
+            if (companySlug)
+                query.companyId = companySlug;
+            const meetingId = await resolveShortId(token, rawId, query);
+            const res = await vaultApiFetch({
+                token,
+                path: `/v1/meetings/${encodeURIComponent(meetingId)}`,
+                query,
+            });
+            if (!res.ok)
+                await handleApiError(res);
+            const detail = (await res.json());
+            if (!detail.documentUrl) {
+                console.error(chalk.red("No document URL available for this meeting."));
+                process.exit(1);
+            }
+            const docRes = await fetch(detail.documentUrl);
+            if (!docRes.ok) {
+                console.error(chalk.red(`Failed to download meeting document (${docRes.status})`));
+                process.exit(1);
+            }
+            const doc = (await docRes.json());
+            if (meetings.opts().json) {
+                console.log(JSON.stringify(doc.notes, null, 2));
+                return;
+            }
+            if (!doc.notes) {
+                console.log(chalk.yellow("No notes available for this meeting."));
+                return;
+            }
+            const notes = doc.notes;
+            console.log(chalk.bold(`\nMeeting Notes: ${doc.title}\n`));
+            console.log(chalk.bold("Summary"));
+            console.log(`  ${notes.summary}\n`);
+            if (notes.keyPoints.length > 0) {
+                console.log(chalk.bold("Key Points"));
+                for (const point of notes.keyPoints) {
+                    console.log(`  • ${point}`);
+                }
+                console.log();
+            }
+            if (notes.decisions.length > 0) {
+                console.log(chalk.bold("Decisions"));
+                for (const d of notes.decisions) {
+                    console.log(`  ✓ ${d}`);
+                }
+                console.log();
+            }
+            if (notes.actionItems.length > 0) {
+                console.log(chalk.bold("Action Items"));
+                for (const item of notes.actionItems) {
+                    const assignee = item.assignee ? chalk.dim(` → ${item.assignee}`) : "";
+                    console.log(`  □ ${item.task}${assignee}`);
+                }
+                console.log();
+            }
+            if (notes.participantContributions.length > 0) {
+                console.log(chalk.bold("Participant Contributions"));
+                for (const p of notes.participantContributions) {
+                    console.log(`  ${p.name} (${p.speakingTimePercent}%)`);
+                    console.log(`    ${chalk.dim(p.topicsSummary)}`);
+                }
+                console.log();
+            }
+            console.log(chalk.dim(`Generated by ${notes.model} at ${notes.generatedAt}`));
+            console.log();
+        }
+        catch (err) {
+            console.error(chalk.red("Error:"), err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=meetings.js.map
+//# debugId=8237a835-5842-52be-bb27-c4ffb7944d89

package/dist/commands/pack-install.d.ts

@@ -26,16 +26,44 @@
  *   3. Parse + validate package.yaml (10 checks from spec)
  *   4. Evaluate `conditional` predicate — skip if exits non-zero
  *   5. Confirm hooks if `contributes.hooks` non-empty (unless --allow-hooks)
- *   6. Move into packages/{name}/
- *   7. Append entry to modules.yaml with strategy: package
- *   8. Run scan-packages.sh to wire contributions into host paths
+ *   6. Move into core/packages/{name}/
+ *   7. Run core/scripts/scan-packages.sh to wire contributions into host paths
+ *
+ * Installed packs are tracked by filesystem presence — there's no separate
+ * registry file under the v12 layout. (`hq update <pack>` re-resolves source
+ * from each pack's package.yaml; rationale lives in the layout-fix PR.)
  */
+import type { PackManifest } from '../types.js';
 /**
  * sourceMatchesPackPattern — exported for the dispatcher in pkg-install.ts
  * so it can decide whether to route to the new content-pack handler or fall
  * back to the legacy registry flow.
  */
 export declare function sourceMatchesPackPattern(source: string): boolean;
+/**
+ * Install the fetched payload to `<hqRoot>/core/packages/<pkg.name>/` (HQ
+ * v12+ layout). The HQ template (`hq-core` / `hq-core-staging`) ships
+ * `core/packages/` as the canonical pack root; writing to top-level
+ * `packages/` would leave an orphan tree alongside the real one.
+ *
+ * Re-installs replace the existing destination so stale contributions don't
+ * linger (the post-install `scan-packages.sh` would otherwise wire them
+ * back into host paths).
+ *
+ * Exported for tests in pack-install.test.ts — see that file for the
+ * contract this function pins.
+ */
+export declare function installToPackages(payloadDir: string, pkg: PackManifest, hqRoot: string): string;
+/**
+ * Run `<hqRoot>/core/scripts/scan-packages.sh` to wire the newly installed
+ * pack's contributions into the host paths (skills, hooks, policies, etc.).
+ * Skipping with a dim warning if the script is missing keeps fresh HQs (or
+ * older templates) usable — the next session start picks them up via its
+ * own scan.
+ *
+ * Exported for tests.
+ */
+export declare function runScanPackages(hqRoot: string): void;
 export interface InstallPackOptions {
     allowHooks?: boolean;
     followBranch?: boolean;

package/dist/commands/pack-install.js

@@ -26,12 +26,15 @@
  *   3. Parse + validate package.yaml (10 checks from spec)
  *   4. Evaluate `conditional` predicate — skip if exits non-zero
  *   5. Confirm hooks if `contributes.hooks` non-empty (unless --allow-hooks)
- *   6. Move into packages/{name}/
- *   7. Append entry to modules.yaml with strategy: package
- *   8. Run scan-packages.sh to wire contributions into host paths
+ *   6. Move into core/packages/{name}/
+ *   7. Run core/scripts/scan-packages.sh to wire contributions into host paths
+ *
+ * Installed packs are tracked by filesystem presence — there's no separate
+ * registry file under the v12 layout. (`hq update <pack>` re-resolves source
+ * from each pack's package.yaml; rationale lives in the layout-fix PR.)
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9c0fc9f1-9a26-5a3f-a795-7254534316d5")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5dea7752-f10c-553c-a419-cf05441b3c13")}catch(e){}}();
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
@@ -42,7 +45,7 @@ import chalk from 'chalk';
 import semverSatisfies from 'semver/functions/satisfies.js';
 import semverValid from 'semver/functions/valid.js';
 import semverValidRange from 'semver/ranges/valid.js';
-import { findHqRoot, readManifest, writeManifest, } from '../utils/manifest.js';
+import { findHqRoot } from '../utils/manifest.js';
 function classify(source) {
     if (source.startsWith('@'))
         return 'npm';
@@ -415,10 +418,23 @@ function evalConditional(expr) {
     return r.status === 0;
 }
 // ---------------------------------------------------------------------------
-// Move into packages/ + update modules.yaml + scan
+// Move into core/packages/ + run core/scripts/scan-packages.sh
 // ---------------------------------------------------------------------------
-function installToPackages(payloadDir, pkg, hqRoot) {
-    const packagesDir = path.join(hqRoot, 'packages');
+/**
+ * Install the fetched payload to `<hqRoot>/core/packages/<pkg.name>/` (HQ
+ * v12+ layout). The HQ template (`hq-core` / `hq-core-staging`) ships
+ * `core/packages/` as the canonical pack root; writing to top-level
+ * `packages/` would leave an orphan tree alongside the real one.
+ *
+ * Re-installs replace the existing destination so stale contributions don't
+ * linger (the post-install `scan-packages.sh` would otherwise wire them
+ * back into host paths).
+ *
+ * Exported for tests in pack-install.test.ts — see that file for the
+ * contract this function pins.
+ */
+export function installToPackages(payloadDir, pkg, hqRoot) {
+    const packagesDir = path.join(hqRoot, 'core', 'packages');
     fs.mkdirSync(packagesDir, { recursive: true });
     const destDir = path.join(packagesDir, pkg.name);
     if (fs.existsSync(destDir)) {
@@ -430,28 +446,19 @@ function installToPackages(payloadDir, pkg, hqRoot) {
     execFileSync('rsync', ['-a', srcSlashed, destSlashed], { stdio: 'inherit' });
     return destDir;
 }
-function updateModulesYaml(hqRoot, pkg, fetched) {
-    const manifest = readManifest(hqRoot) ?? { version: '1', modules: [] };
-    // Drop any existing entry for this pack (idempotent re-install)
-    manifest.modules = manifest.modules.filter((m) => m.name !== pkg.name);
-    const entry = {
-        name: pkg.name,
-        strategy: 'package',
-        source: fetched.resolvedSource,
-        version: pkg.version,
-        installed_at: path.posix.join('packages', pkg.name),
-        installed_at_iso: new Date().toISOString(),
-        access: pkg.access === 'public' ? 'public' : undefined,
-    };
-    if (fetched.resolvedSha)
-        entry.resolved_sha = fetched.resolvedSha;
-    manifest.modules.push(entry);
-    writeManifest(hqRoot, manifest);
-}
-function runScanPackages(hqRoot) {
-    const script = path.join(hqRoot, 'scripts', 'scan-packages.sh');
+/**
+ * Run `<hqRoot>/core/scripts/scan-packages.sh` to wire the newly installed
+ * pack's contributions into the host paths (skills, hooks, policies, etc.).
+ * Skipping with a dim warning if the script is missing keeps fresh HQs (or
+ * older templates) usable — the next session start picks them up via its
+ * own scan.
+ *
+ * Exported for tests.
+ */
+export function runScanPackages(hqRoot) {
+    const script = path.join(hqRoot, 'core', 'scripts', 'scan-packages.sh');
     if (!fs.existsSync(script)) {
-        console.log(chalk.dim(`  (scripts/scan-packages.sh not present — skipping auto-wire; ` +
+        console.log(chalk.dim(`  (core/scripts/scan-packages.sh not present — skipping auto-wire; ` +
             `will run on next session start)`));
         return;
     }
@@ -502,7 +509,12 @@ export async function installPack(source, opts = {}) {
             return;
         }
         const destDir = installToPackages(fetched.payloadDir, pkg, hqRoot);
-        updateModulesYaml(hqRoot, pkg, fetched);
+        // Under the v12 HQ layout, packs live at `core/packages/<name>/` and are
+        // tracked by filesystem presence alone — no `modules.yaml` write. That
+        // removes the side effect that created a top-level `modules/` directory
+        // alongside the canonical `core/`. `hq update <pack>` will re-resolve a
+        // pack's source from its on-disk package.yaml or prompt for it, but that
+        // tradeoff is intentional — see the layout-fix PR for rationale.
         runScanPackages(hqRoot);
         console.log(chalk.green(`\n✓ Installed ${pkg.name}@${pkg.version} → ${path.relative(hqRoot, destDir)}/`));
         console.log(chalk.dim(`  Wired ${Object.values(pkg.contributes).flat().filter(Boolean).length} ` +
@@ -513,4 +525,4 @@ export async function installPack(source, opts = {}) {
     }
 }
 //# sourceMappingURL=pack-install.js.map
-//# debugId=9c0fc9f1-9a26-5a3f-a795-7254534316d5
+//# debugId=5dea7752-f10c-553c-a419-cf05441b3c13

package/dist/index.js

@@ -3,7 +3,7 @@
  * HQ CLI - Module management, package management, and cloud sync for HQ
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9cc0bf93-9c18-53aa-addd-954425115886")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="15889dc3-5d7e-5fb9-8df3-33d5aebdc945")}catch(e){}}();
 import { Command } from "commander";
 import { initSentry, Sentry } from "./sentry.js";
 import { registerAddCommand } from "./commands/add.js";
@@ -29,6 +29,7 @@ import { registerGroupsCommand } from "./commands/groups.js";
 import { registerFilesCommand } from "./commands/files.js";
 import { registerMembersCommand } from "./commands/members.js";
 import { registerFeedbackCommand } from "./commands/feedback.js";
+import { registerMeetingsCommand } from "./commands/meetings.js";
 import { sanitizeArgv } from "./utils/feedback-diagnostics.js";
 import { maybeWarnNewVersion, refreshVersionCache, } from "./utils/version-check.js";
 import { CLI_VERSION } from "./cli-version.js";
@@ -102,6 +103,8 @@ registerMembersCommand(program);
 registerOnboardCommand(program);
 // Feedback (subcommand group — hq feedback bug|feature)
 registerFeedbackCommand(program);
+// Meetings (subcommand group — hq meetings list|get|search|transcript|notes)
+registerMeetingsCommand(program);
 (async () => {
     try {
         Sentry.addBreadcrumb({
@@ -120,4 +123,4 @@ registerFeedbackCommand(program);
     }
 })();
 //# sourceMappingURL=index.js.map
-//# debugId=9cc0bf93-9c18-53aa-addd-954425115886
+//# debugId=15889dc3-5d7e-5fb9-8df3-33d5aebdc945

package/dist/utils/cognito-session.d.ts

@@ -21,6 +21,31 @@
 import { type CognitoAuthConfig, type VaultServiceConfig } from "@indigoai-us/hq-cloud";
 export declare const DEFAULT_COGNITO: CognitoAuthConfig;
 export declare const DEFAULT_VAULT_API_URL: string;
+/**
+ * Resolve the default HQ tree root for cloud-aware subcommands.
+ *
+ * Priority order:
+ *   1. `$HQ_ROOT` env var (explicit user override)
+ *   2. Walk up from `process.cwd()` to the nearest dir containing BOTH a
+ *      `core.yaml` file AND a `companies/` directory (root-unique marker
+ *      pair — see note below).
+ *   3. Fall back to `~/hq` (the historical default)
+ *
+ * Why both markers?
+ *   The HQ root has `core.yaml` AND a sibling `companies/` directory. The
+ *   synced `core/` subtree (which is itself part of the root's personal-vault
+ *   scope) ALSO contains a `core.yaml` (the template's version-source-of-
+ *   truth), but does NOT contain `companies/`. Single-marker `core.yaml`
+ *   detection would stop at `<hqRoot>/core/` when the CLI is launched from
+ *   somewhere inside that subtree, and downstream `companies/` lookups would
+ *   silently miss the real content. Requiring `companies/` as well guarantees
+ *   we resolve to the actual HQ root (Codex P2 on hq#146).
+ *
+ * Evaluated once at module load — commander.js `.option()` callers pin the
+ * value at registration time, which matches the user's actual cwd at process
+ * start. Re-importable as a function for tests and command-time resolution.
+ */
+export declare function resolveDefaultHqRoot(): string;
 export declare const DEFAULT_HQ_ROOT: string;
 /**
  * Return a non-expired Cognito access token, refreshing or browser-logging-in

package/dist/utils/cognito-session.js

@@ -19,7 +19,8 @@
  *   HQ_VAULT_API_URL           — vault-service API Gateway URL
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="71d8f748-f249-50df-aa1f-eae381ea608d")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6a8ac157-0903-513d-b4c5-45fb532b8026")}catch(e){}}();
+import * as fs from "fs";
 import * as os from "os";
 import * as path from "path";
 import chalk from "chalk";
@@ -41,7 +42,53 @@ export const DEFAULT_COGNITO = {
         : "Google",
 };
 export const DEFAULT_VAULT_API_URL = process.env.HQ_VAULT_API_URL ?? "https://hqapi.getindigo.ai";
-export const DEFAULT_HQ_ROOT = path.join(os.homedir(), "hq");
+/**
+ * Resolve the default HQ tree root for cloud-aware subcommands.
+ *
+ * Priority order:
+ *   1. `$HQ_ROOT` env var (explicit user override)
+ *   2. Walk up from `process.cwd()` to the nearest dir containing BOTH a
+ *      `core.yaml` file AND a `companies/` directory (root-unique marker
+ *      pair — see note below).
+ *   3. Fall back to `~/hq` (the historical default)
+ *
+ * Why both markers?
+ *   The HQ root has `core.yaml` AND a sibling `companies/` directory. The
+ *   synced `core/` subtree (which is itself part of the root's personal-vault
+ *   scope) ALSO contains a `core.yaml` (the template's version-source-of-
+ *   truth), but does NOT contain `companies/`. Single-marker `core.yaml`
+ *   detection would stop at `<hqRoot>/core/` when the CLI is launched from
+ *   somewhere inside that subtree, and downstream `companies/` lookups would
+ *   silently miss the real content. Requiring `companies/` as well guarantees
+ *   we resolve to the actual HQ root (Codex P2 on hq#146).
+ *
+ * Evaluated once at module load — commander.js `.option()` callers pin the
+ * value at registration time, which matches the user's actual cwd at process
+ * start. Re-importable as a function for tests and command-time resolution.
+ */
+export function resolveDefaultHqRoot() {
+    if (process.env.HQ_ROOT)
+        return path.resolve(process.env.HQ_ROOT);
+    let cur = path.resolve(process.cwd());
+    while (cur !== path.dirname(cur)) {
+        if (isHqRoot(cur))
+            return cur;
+        cur = path.dirname(cur);
+    }
+    return path.join(os.homedir(), "hq");
+}
+/** True iff `dir` looks like an HQ root (has core.yaml + companies/ dir). */
+function isHqRoot(dir) {
+    if (!fs.existsSync(path.join(dir, "core.yaml")))
+        return false;
+    try {
+        return fs.statSync(path.join(dir, "companies")).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export const DEFAULT_HQ_ROOT = resolveDefaultHqRoot();
 /**
  * Return a non-expired Cognito access token, refreshing or browser-logging-in
  * as needed. Cache lives at ~/.hq/cognito-tokens.json.
@@ -108,4 +155,4 @@ export async function refreshCachedSession() {
     }
 }
 //# sourceMappingURL=cognito-session.js.map
-//# debugId=71d8f748-f249-50df-aa1f-eae381ea608d
+//# debugId=6a8ac157-0903-513d-b4c5-45fb532b8026