@indigoai-us/hq-cli 5.59.0 → 5.60.0

package/dist/commands/meetings.js

@@ -1,5 +1,5 @@
 
-!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]="f2fc6ee0-c7c4-5012-85ce-aea36030aa92")}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]="6bb33e65-134a-5b0a-917b-ca084d4c8366")}catch(e){}}();
 import chalk from "chalk";
 import { ensureCognitoToken } from "../utils/cognito-session.js";
 import { vaultApiFetch, getCompanyUid } from "../utils/vault-api.js";
@@ -13,6 +13,17 @@ function formatDuration(seconds) {
         return `${m}m ${s}s`;
     return `${s}s`;
 }
+function safeFormatDuration(seconds) {
+    return typeof seconds === "number" && Number.isFinite(seconds) ? formatDuration(seconds) : "-";
+}
+function safeFormatDate(iso, options) {
+    if (typeof iso !== "string" || iso.length === 0)
+        return "-";
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return "-";
+    return options ? date.toLocaleString("en-US", options) : date.toLocaleString();
+}
 function formatTimestamp(ts) {
     const m = Math.floor(ts / 60);
     const s = Math.floor(ts % 60);
@@ -32,6 +43,38 @@ function statusBadge(status) {
             return chalk.dim(status);
     }
 }
+function isMarkdownShape(x) {
+    if (!x || typeof x !== "object")
+        return false;
+    const candidate = x;
+    return candidate.sourceShape === "markdown" || Boolean(candidate.source?.frontmatter);
+}
+function hasSignals(signals) {
+    return Boolean(signals &&
+        typeof signals === "object" &&
+        !Array.isArray(signals) &&
+        Object.keys(signals).length > 0);
+}
+function renderSignals(signals) {
+    console.log(chalk.bold("Signals"));
+    for (const [key, value] of Object.entries(signals)) {
+        if (value === null || value === undefined) {
+            console.log(`  ${key}: -`);
+        }
+        else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            console.log(`  ${key}: ${String(value)}`);
+        }
+        else {
+            const rendered = JSON.stringify(value, null, 2)
+                .split("\n")
+                .map((line) => `    ${line}`)
+                .join("\n");
+            console.log(`  ${key}:`);
+            console.log(rendered);
+        }
+    }
+    console.log();
+}
 async function resolveShortId(token, prefix, query) {
     if (prefix.includes("-") && prefix.length > 8)
         return prefix;
@@ -99,25 +142,28 @@ function printMeetingTable(meetings) {
         const id = m.meetingId.slice(0, 8);
         const fullTitle = displayTitle(m);
         const title = fullTitle.length > TITLE_W ? fullTitle.slice(0, TITLE_W - 1) + "…" : fullTitle;
-        const date = new Date(m.startTime).toLocaleDateString("en-US", {
+        const date = safeFormatDate(m.startTime, {
             month: "short",
             day: "numeric",
             hour: "2-digit",
             minute: "2-digit",
         });
-        const dur = formatDuration(m.duration);
+        const dur = safeFormatDuration(m.duration);
+        const status = m.status ? statusBadge(m.status) : chalk.dim("-");
+        const parts = typeof m.participantCount === "number" ? String(m.participantCount) : "-";
         const flags = [
             m.hasTranscript ? "T" : "",
             m.hasNotes ? "N" : "",
+            m.hasSignals ? "S" : "",
         ].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,
+            status.padEnd(STATUS_W + 10), // chalk adds escape chars
+            parts.padEnd(PARTS_W),
+            flags.padEnd(FLAGS_W),
         ].join("  "));
     }
 }
@@ -188,16 +234,34 @@ export function registerMeetingsCommand(program) {
                 console.log(JSON.stringify(detail, null, 2));
                 return;
             }
-            console.log(chalk.bold(`\n${detail.title}\n`));
+            if (isMarkdownShape(detail)) {
+                const fm = detail.source.frontmatter ?? {};
+                console.log(chalk.bold(`\n${fm.title || "(untitled)"}\n`));
+                console.log(`  ID:          ${chalk.cyan(detail.meetingId)}`);
+                console.log(`  Status:      ${fm.bot_status || "-"}`);
+                console.log(`  Date:        ${safeFormatDate(fm.scheduled_start_time || fm.created_at)}`);
+                console.log(`  Platform:    ${fm.meeting_platform || "-"}`);
+                console.log(`  Origin:      ${fm.origin || "-"}`);
+                console.log(`  Company:     ${fm.company_id || "-"}`);
+                if (fm.meeting_url)
+                    console.log(`  Meeting URL: ${fm.meeting_url}`);
+                if (hasSignals(detail.signals)) {
+                    console.log(`  Signals:     ${Object.keys(detail.signals).length}`);
+                }
+                console.log(chalk.dim(`\n  This meeting is stored as a markdown document. Use \`hq meetings transcript ${detail.meetingId.slice(0, 8)}\` to view the full document.`));
+                console.log();
+                return;
+            }
+            console.log(chalk.bold(`\n${detail.title ?? "(untitled)"}\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(`  Status:   ${detail.status ? statusBadge(detail.status) : chalk.dim("-")}`);
+            console.log(`  Date:     ${safeFormatDate(detail.startTime)}`);
+            console.log(`  Duration: ${safeFormatDuration(detail.duration)}`);
+            console.log(`  Source:   ${detail.sourceApp ?? "-"} (${detail.botProvider ?? "-"})`);
             console.log(`  Shared:   ${detail.isShared ? "yes" : "no"}`);
-            if (detail.participants.length > 0) {
+            if ((detail.participants?.length ?? 0) > 0) {
                 console.log(chalk.bold("\n  Participants:"));
-                for (const p of detail.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}`);
@@ -325,6 +389,26 @@ export function registerMeetingsCommand(program) {
             if (!res.ok)
                 await handleApiError(res);
             const detail = (await res.json());
+            if (isMarkdownShape(detail)) {
+                const documentUrl = detail.source.presigned_url;
+                if (!documentUrl) {
+                    console.error(chalk.red("No document available for this meeting."));
+                    process.exit(1);
+                }
+                const docRes = await fetch(documentUrl);
+                if (!docRes.ok) {
+                    console.error(chalk.red(`Failed to download meeting document (${docRes.status})`));
+                    process.exit(1);
+                }
+                const markdown = await docRes.text();
+                if (meetings.opts().json) {
+                    console.log(JSON.stringify({ meetingId: detail.meetingId, sourceShape: "markdown", markdown }, null, 2));
+                    return;
+                }
+                console.log(chalk.bold(`\nTranscript: ${detail.source.frontmatter?.title || "(untitled)"}\n`));
+                console.log(markdown);
+                return;
+            }
             if (!detail.documentUrl) {
                 console.error(chalk.red("No document URL available for this meeting."));
                 process.exit(1);
@@ -375,6 +459,35 @@ export function registerMeetingsCommand(program) {
             if (!res.ok)
                 await handleApiError(res);
             const detail = (await res.json());
+            if (isMarkdownShape(detail)) {
+                if (hasSignals(detail.signals)) {
+                    if (meetings.opts().json) {
+                        console.log(JSON.stringify(detail.signals, null, 2));
+                        return;
+                    }
+                    console.log(chalk.bold(`\nMeeting Notes: ${detail.source.frontmatter?.title || "(untitled)"}\n`));
+                    renderSignals(detail.signals);
+                    return;
+                }
+                const documentUrl = detail.source.presigned_url;
+                if (!documentUrl) {
+                    console.log(chalk.yellow("No notes available for this meeting."));
+                    return;
+                }
+                const docRes = await fetch(documentUrl);
+                if (!docRes.ok) {
+                    console.error(chalk.red(`Failed to download meeting document (${docRes.status})`));
+                    process.exit(1);
+                }
+                const markdown = await docRes.text();
+                if (meetings.opts().json) {
+                    console.log(JSON.stringify({ meetingId: detail.meetingId, sourceShape: "markdown", markdown }, null, 2));
+                    return;
+                }
+                console.log(chalk.bold(`\nMeeting Notes: ${detail.source.frontmatter?.title || "(untitled)"}\n`));
+                console.log(markdown);
+                return;
+            }
             if (!detail.documentUrl) {
                 console.error(chalk.red("No document URL available for this meeting."));
                 process.exit(1);
@@ -437,4 +550,4 @@ export function registerMeetingsCommand(program) {
     });
 }
 //# sourceMappingURL=meetings.js.map
-//# debugId=f2fc6ee0-c7c4-5012-85ce-aea36030aa92
+//# debugId=6bb33e65-134a-5b0a-917b-ca084d4c8366

package/dist/commands/secrets.js

@@ -1,5 +1,5 @@
 
-!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]="12b04dfd-a264-56c7-bfbb-a448c35689b3")}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]="3b78d543-70d6-52e2-b19f-fa2650534e97")}catch(e){}}();
 import chalk from "chalk";
 import * as readline from "node:readline";
 import { spawn } from "node:child_process";
@@ -218,7 +218,11 @@ export function scrubSandboxOutput(text, secretNames = []) {
 }
 function renderSandboxJobResult(job, secretNames) {
     if (job.output) {
-        process.stdout.write(scrubSandboxOutput(job.output, secretNames));
+        const output = scrubSandboxOutput(job.output, secretNames);
+        process.stdout.write(output);
+        if (output.length > 0 && !output.endsWith("\n")) {
+            process.stdout.write("\n");
+        }
     }
 }
 function normalizePolicyRecord(secretPath, data) {
@@ -1254,4 +1258,4 @@ export function registerSecretsCommand(program) {
     });
 }
 //# sourceMappingURL=secrets.js.map
-//# debugId=12b04dfd-a264-56c7-bfbb-a448c35689b3
+//# debugId=3b78d543-70d6-52e2-b19f-fa2650534e97

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.59.0",
+  "version": "5.60.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {

package/src/commands/meetings.test.ts

@@ -45,6 +45,7 @@ beforeEach(() => {
 
 afterEach(() => {
   vi.restoreAllMocks();
+  vi.unstubAllGlobals();
 });
 
 function buildProgram(): Command {
@@ -298,7 +299,7 @@ describe("meetings set-company", () => {
       "acme",
     ]);
 
-    const output = logSpy.mock.calls.map(([line]) => String(line)).join("\n");
+    const output = logSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
     expect(output).not.toContain("Applied to 1 meetings");
     expect(output).not.toContain("Refiled 0 transcripts");
     expect(output).not.toContain("Future occurrences of this recurring series will inherit this attribution.");
@@ -345,8 +346,121 @@ describe("meetings list — null-safe rendering", () => {
       program.parseAsync(["node", "hq", "meetings", "list", "--company", "indigo"]),
     ).resolves.toBeDefined();
 
-    const printed = logSpy.mock.calls.map(([line]) => String(line)).join("\n");
+    const printed = logSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
     expect(printed).toContain("Meetings (2)");
     expect(printed).toContain("(untitled)");
   });
 });
+
+describe("meetings — markdown shape rendering", () => {
+  const markdownMeetingId = "589bfd78-aaaa-bbbb-cccc-1234567890ab";
+  const markdownUrl = "https://example.test/meeting.md";
+
+  function markdownDetail(signals: Record<string, unknown> = {}) {
+    return {
+      meetingId: markdownMeetingId,
+      sourceShape: "markdown",
+      source: {
+        path: "meetings/meeting.md",
+        presigned_url: markdownUrl,
+        frontmatter: {
+          title: "Markdown Standup",
+          channel: "eng",
+          origin: "recall",
+          company_id: "cmp_indigo",
+          meeting_url: "https://meet.example.test/standup",
+          meeting_platform: "google_meet",
+          calendar_event_id: null,
+          scheduled_start_time: "2026-02-03T15:30:00Z",
+          created_at: "2026-02-03T15:00:00Z",
+          updated_at: "2026-02-03T16:00:00Z",
+          ingested_at: "2026-02-03T16:05:00Z",
+          recall_bot_id: null,
+          bot_status: "done",
+          auto_scheduled: true,
+        },
+      },
+      signals,
+    };
+  }
+
+  it("lists markdown meetings without invalid legacy field output", async () => {
+    vi.mocked(vaultApiFetch).mockResolvedValueOnce(
+      jsonRes({
+        meetings: [
+          {
+            meetingId: markdownMeetingId,
+            sourceShape: "markdown",
+            title: "Markdown Standup",
+            startTime: "2026-02-03T15:30:00Z",
+            channel: "eng",
+            ingested_at: "2026-02-03T16:05:00Z",
+            hasSignals: true,
+            companyId: "cmp_indigo",
+            attributed: true,
+          },
+        ],
+      }),
+    );
+
+    const program = buildProgram();
+    await program.parseAsync(["node", "hq", "meetings", "list"]);
+
+    const output = logSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
+    expect(output).toContain("Markdown Standup");
+    expect(output).toContain(" S ");
+    expect(output).not.toContain("NaN");
+    expect(output).not.toContain("undefined");
+    expect(output).not.toContain("Invalid Date");
+  });
+
+  it("gets markdown details from frontmatter without reading participants", async () => {
+    vi.mocked(vaultApiFetch).mockResolvedValueOnce(jsonRes(markdownDetail({ action_items: ["Ship fix"] })));
+
+    const program = buildProgram();
+    await expect(
+      program.parseAsync(["node", "hq", "meetings", "get", markdownMeetingId]),
+    ).resolves.toBeDefined();
+
+    const output = logSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
+    expect(output).toContain("Markdown Standup");
+    expect(output).toContain("Status:      done");
+    expect(output).toContain("Platform:    google_meet");
+    expect(output).toContain("Origin:      recall");
+    expect(output).toContain("Company:     cmp_indigo");
+    expect(output).toContain("Meeting URL: https://meet.example.test/standup");
+    expect(output).toContain("Signals:     1");
+    expect(output).toContain("stored as a markdown document");
+  });
+
+  it("prints markdown transcript text from the presigned source URL", async () => {
+    vi.mocked(vaultApiFetch).mockResolvedValueOnce(jsonRes(markdownDetail()));
+    const fetchMock = vi.fn(async () => new Response("# Markdown transcript\n\nHello team."));
+    vi.stubGlobal("fetch", fetchMock);
+
+    const program = buildProgram();
+    await program.parseAsync(["node", "hq", "meetings", "transcript", markdownMeetingId]);
+
+    expect(fetchMock).toHaveBeenCalledWith(markdownUrl);
+    const output = logSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
+    expect(output).toContain("Transcript: Markdown Standup");
+    expect(output).toContain("# Markdown transcript");
+    expect(output).toContain("Hello team.");
+  });
+
+  it("falls back to the markdown document for notes when markdown signals are empty", async () => {
+    vi.mocked(vaultApiFetch).mockResolvedValueOnce(jsonRes(markdownDetail({})));
+    vi.stubGlobal("fetch", vi.fn(async () => new Response("# Notes\n\nFollow up next week.")));
+
+    const program = buildProgram();
+    await program.parseAsync(["node", "hq", "meetings", "notes", markdownMeetingId]);
+
+    const output = logSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
+    const errors = errSpy.mock.calls.map(([line]) => (line === undefined ? "" : String(line))).join("\n");
+    expect(output).toContain("Meeting Notes: Markdown Standup");
+    expect(output).toContain("# Notes");
+    expect(output).toContain("Follow up next week.");
+    expect(output).not.toContain("No document URL available");
+    expect(errors).not.toContain("No document URL available");
+  });
+});

package/src/commands/meetings.ts

@@ -5,35 +5,67 @@ import { vaultApiFetch, getCompanyUid } from "../utils/vault-api.js";
 
 interface MeetingListItem {
   meetingId: string;
-  title: string;
-  startTime: string;
-  endTime: string;
-  duration: number;
-  participantCount: number;
-  status: string;
-  hasTranscript: boolean;
-  hasNotes: boolean;
+  sourceShape?: "markdown" | "json";
+  title?: string | null;
+  startTime?: string;
+  endTime?: string;
+  duration?: number;
+  participantCount?: number;
+  status?: string;
+  hasTranscript?: boolean;
+  hasNotes?: boolean;
+  channel?: string;
+  ingested_at?: string;
+  hasSignals?: boolean;
+  companyId?: string;
+  attributed?: boolean;
 }
 
 interface MeetingDetail {
   meetingId: string;
-  title: string;
-  startTime: string;
-  endTime: string;
-  duration: number;
-  participants: Array<{ email: string; name: string | null; role: string }>;
-  calendarEventId: string | null;
-  botProvider: string;
-  sourceApp: string;
-  companyId: string;
-  status: string;
-  recallBotId: string | null;
-  isShared: boolean;
-  createdAt: string;
-  updatedAt: string;
-  documentUrl: string;
-  hasTranscript: boolean;
-  hasNotes: boolean;
+  sourceShape?: "markdown" | "json";
+  title?: string;
+  startTime?: string;
+  endTime?: string;
+  duration?: number;
+  participants?: Array<{ email: string; name: string | null; role: string }>;
+  calendarEventId?: string | null;
+  botProvider?: string;
+  sourceApp?: string;
+  companyId?: string;
+  status?: string;
+  recallBotId?: string | null;
+  isShared?: boolean;
+  createdAt?: string;
+  updatedAt?: string;
+  documentUrl?: string;
+  hasTranscript?: boolean;
+  hasNotes?: boolean;
+  source?: MarkdownMeetingSource;
+  signals?: Record<string, unknown>;
+}
+
+interface MarkdownMeetingFrontmatter {
+  title?: string;
+  channel?: string;
+  origin?: string;
+  company_id?: string;
+  meeting_url?: string;
+  meeting_platform?: string;
+  calendar_event_id?: string | null;
+  scheduled_start_time?: string;
+  created_at?: string;
+  updated_at?: string;
+  ingested_at?: string;
+  recall_bot_id?: string | null;
+  bot_status?: string;
+  auto_scheduled?: boolean;
+}
+
+interface MarkdownMeetingSource {
+  path?: string;
+  presigned_url?: string;
+  frontmatter?: MarkdownMeetingFrontmatter;
 }
 
 interface TranscriptSegment {
@@ -78,6 +110,17 @@ function formatDuration(seconds: number): string {
   return `${s}s`;
 }
 
+function safeFormatDuration(seconds: unknown): string {
+  return typeof seconds === "number" && Number.isFinite(seconds) ? formatDuration(seconds) : "-";
+}
+
+function safeFormatDate(iso: unknown, options?: Intl.DateTimeFormatOptions): string {
+  if (typeof iso !== "string" || iso.length === 0) return "-";
+  const date = new Date(iso);
+  if (Number.isNaN(date.getTime())) return "-";
+  return options ? date.toLocaleString("en-US", options) : date.toLocaleString();
+}
+
 function formatTimestamp(ts: number): string {
   const m = Math.floor(ts / 60);
   const s = Math.floor(ts % 60);
@@ -99,6 +142,45 @@ function statusBadge(status: string): string {
   }
 }
 
+function isMarkdownShape(x: unknown): x is MeetingDetail & {
+  source: MarkdownMeetingSource;
+} {
+  if (!x || typeof x !== "object") return false;
+  const candidate = x as {
+    sourceShape?: string;
+    source?: { frontmatter?: unknown };
+  };
+  return candidate.sourceShape === "markdown" || Boolean(candidate.source?.frontmatter);
+}
+
+function hasSignals(signals: unknown): signals is Record<string, unknown> {
+  return Boolean(
+    signals &&
+      typeof signals === "object" &&
+      !Array.isArray(signals) &&
+      Object.keys(signals).length > 0,
+  );
+}
+
+function renderSignals(signals: Record<string, unknown>): void {
+  console.log(chalk.bold("Signals"));
+  for (const [key, value] of Object.entries(signals)) {
+    if (value === null || value === undefined) {
+      console.log(`  ${key}: -`);
+    } else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      console.log(`  ${key}: ${String(value)}`);
+    } else {
+      const rendered = JSON.stringify(value, null, 2)
+        .split("\n")
+        .map((line) => `    ${line}`)
+        .join("\n");
+      console.log(`  ${key}:`);
+      console.log(rendered);
+    }
+  }
+  console.log();
+}
+
 async function resolveShortId(
   token: string,
   prefix: string,
@@ -181,16 +263,19 @@ function printMeetingTable(meetings: MeetingListItem[]): void {
     const id = m.meetingId.slice(0, 8);
     const fullTitle = displayTitle(m);
     const title = fullTitle.length > TITLE_W ? fullTitle.slice(0, TITLE_W - 1) + "…" : fullTitle;
-    const date = new Date(m.startTime).toLocaleDateString("en-US", {
+    const date = safeFormatDate(m.startTime, {
       month: "short",
       day: "numeric",
       hour: "2-digit",
       minute: "2-digit",
     });
-    const dur = formatDuration(m.duration);
+    const dur = safeFormatDuration(m.duration);
+    const status = m.status ? statusBadge(m.status) : chalk.dim("-");
+    const parts = typeof m.participantCount === "number" ? String(m.participantCount) : "-";
     const flags = [
       m.hasTranscript ? "T" : "",
       m.hasNotes ? "N" : "",
+      m.hasSignals ? "S" : "",
     ].filter(Boolean).join("") || "-";
 
     console.log(
@@ -199,9 +284,9 @@ function printMeetingTable(meetings: MeetingListItem[]): void {
         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,
+        status.padEnd(STATUS_W + 10), // chalk adds escape chars
+        parts.padEnd(PARTS_W),
+        flags.padEnd(FLAGS_W),
       ].join("  "),
     );
   }
@@ -286,17 +371,39 @@ export function registerMeetingsCommand(program: Command): void {
           return;
         }
 
-        console.log(chalk.bold(`\n${detail.title}\n`));
+        if (isMarkdownShape(detail)) {
+          const fm = detail.source.frontmatter ?? {};
+          console.log(chalk.bold(`\n${fm.title || "(untitled)"}\n`));
+          console.log(`  ID:          ${chalk.cyan(detail.meetingId)}`);
+          console.log(`  Status:      ${fm.bot_status || "-"}`);
+          console.log(`  Date:        ${safeFormatDate(fm.scheduled_start_time || fm.created_at)}`);
+          console.log(`  Platform:    ${fm.meeting_platform || "-"}`);
+          console.log(`  Origin:      ${fm.origin || "-"}`);
+          console.log(`  Company:     ${fm.company_id || "-"}`);
+          if (fm.meeting_url) console.log(`  Meeting URL: ${fm.meeting_url}`);
+          if (hasSignals(detail.signals)) {
+            console.log(`  Signals:     ${Object.keys(detail.signals).length}`);
+          }
+          console.log(
+            chalk.dim(
+              `\n  This meeting is stored as a markdown document. Use \`hq meetings transcript ${detail.meetingId.slice(0, 8)}\` to view the full document.`,
+            ),
+          );
+          console.log();
+          return;
+        }
+
+        console.log(chalk.bold(`\n${detail.title ?? "(untitled)"}\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(`  Status:   ${detail.status ? statusBadge(detail.status) : chalk.dim("-")}`);
+        console.log(`  Date:     ${safeFormatDate(detail.startTime)}`);
+        console.log(`  Duration: ${safeFormatDuration(detail.duration)}`);
+        console.log(`  Source:   ${detail.sourceApp ?? "-"} (${detail.botProvider ?? "-"})`);
         console.log(`  Shared:   ${detail.isShared ? "yes" : "no"}`);
 
-        if (detail.participants.length > 0) {
+        if ((detail.participants?.length ?? 0) > 0) {
           console.log(chalk.bold("\n  Participants:"));
-          for (const p of detail.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}`);
@@ -447,6 +554,32 @@ export function registerMeetingsCommand(program: Command): void {
         if (!res.ok) await handleApiError(res);
 
         const detail = (await res.json()) as MeetingDetail;
+
+        if (isMarkdownShape(detail)) {
+          const documentUrl = detail.source.presigned_url;
+          if (!documentUrl) {
+            console.error(chalk.red("No document available for this meeting."));
+            process.exit(1);
+          }
+
+          const docRes = await fetch(documentUrl);
+          if (!docRes.ok) {
+            console.error(chalk.red(`Failed to download meeting document (${docRes.status})`));
+            process.exit(1);
+          }
+
+          const markdown = await docRes.text();
+
+          if (meetings.opts().json) {
+            console.log(JSON.stringify({ meetingId: detail.meetingId, sourceShape: "markdown", markdown }, null, 2));
+            return;
+          }
+
+          console.log(chalk.bold(`\nTranscript: ${detail.source.frontmatter?.title || "(untitled)"}\n`));
+          console.log(markdown);
+          return;
+        }
+
         if (!detail.documentUrl) {
           console.error(chalk.red("No document URL available for this meeting."));
           process.exit(1);
@@ -503,6 +636,42 @@ export function registerMeetingsCommand(program: Command): void {
         if (!res.ok) await handleApiError(res);
 
         const detail = (await res.json()) as MeetingDetail;
+
+        if (isMarkdownShape(detail)) {
+          if (hasSignals(detail.signals)) {
+            if (meetings.opts().json) {
+              console.log(JSON.stringify(detail.signals, null, 2));
+              return;
+            }
+            console.log(chalk.bold(`\nMeeting Notes: ${detail.source.frontmatter?.title || "(untitled)"}\n`));
+            renderSignals(detail.signals);
+            return;
+          }
+
+          const documentUrl = detail.source.presigned_url;
+          if (!documentUrl) {
+            console.log(chalk.yellow("No notes available for this meeting."));
+            return;
+          }
+
+          const docRes = await fetch(documentUrl);
+          if (!docRes.ok) {
+            console.error(chalk.red(`Failed to download meeting document (${docRes.status})`));
+            process.exit(1);
+          }
+
+          const markdown = await docRes.text();
+
+          if (meetings.opts().json) {
+            console.log(JSON.stringify({ meetingId: detail.meetingId, sourceShape: "markdown", markdown }, null, 2));
+            return;
+          }
+
+          console.log(chalk.bold(`\nMeeting Notes: ${detail.source.frontmatter?.title || "(untitled)"}\n`));
+          console.log(markdown);
+          return;
+        }
+
         if (!detail.documentUrl) {
           console.error(chalk.red("No document URL available for this meeting."));
           process.exit(1);

package/src/commands/secrets.test.ts

@@ -264,6 +264,95 @@ describe("secrets sandbox", () => {
     expect(stdoutSpy).toHaveBeenCalledWith("token [REDACTED]\nAPI_KEY=[REDACTED]\n");
   });
 
+  it("terminates sandbox output with exactly one newline when output is present", async () => {
+    pollJobSpy.mockResolvedValueOnce({
+      jobId: "job_123",
+      status: "succeeded",
+      output: "123",
+      exitCode: 0,
+      success: true,
+    });
+
+    const program = buildProgram();
+    await program.parseAsync([
+      "node",
+      "hq",
+      "secrets",
+      "sandbox",
+      "--only",
+      "API_KEY",
+      "--",
+      "my-skill",
+    ]);
+
+    expect(stdoutSpy.mock.calls.flat().join("")).toBe("123\n");
+
+    stdoutSpy.mockClear();
+    pollJobSpy.mockResolvedValueOnce({
+      jobId: "job_123",
+      status: "succeeded",
+      output: "123\n",
+      exitCode: 0,
+      success: true,
+    });
+
+    await buildProgram().parseAsync([
+      "node",
+      "hq",
+      "secrets",
+      "sandbox",
+      "--only",
+      "API_KEY",
+      "--",
+      "my-skill",
+    ]);
+
+    expect(stdoutSpy.mock.calls.flat().join("")).toBe("123\n");
+
+    stdoutSpy.mockClear();
+    pollJobSpy.mockResolvedValueOnce({
+      jobId: "job_123",
+      status: "succeeded",
+      output: "",
+      exitCode: 0,
+      success: true,
+    });
+
+    await buildProgram().parseAsync([
+      "node",
+      "hq",
+      "secrets",
+      "sandbox",
+      "--only",
+      "API_KEY",
+      "--",
+      "my-skill",
+    ]);
+
+    expect(stdoutSpy).not.toHaveBeenCalled();
+
+    stdoutSpy.mockClear();
+    pollJobSpy.mockResolvedValueOnce({
+      jobId: "job_123",
+      status: "succeeded",
+      exitCode: 0,
+      success: true,
+    });
+
+    await buildProgram().parseAsync([
+      "node",
+      "hq",
+      "secrets",
+      "sandbox",
+      "--only",
+      "API_KEY",
+      "--",
+      "my-skill",
+    ]);
+
+    expect(stdoutSpy).not.toHaveBeenCalled();
+  });
+
   it("exits non-zero when the sandbox command fails", async () => {
     pollJobSpy.mockResolvedValueOnce({
       jobId: "job_123",

package/src/commands/secrets.ts

@@ -369,7 +369,11 @@ export function scrubSandboxOutput(text: string, secretNames: string[] = []): st
 
 function renderSandboxJobResult(job: SandboxRunnerJob, secretNames: string[]): void {
   if (job.output) {
-    process.stdout.write(scrubSandboxOutput(job.output, secretNames));
+    const output = scrubSandboxOutput(job.output, secretNames);
+    process.stdout.write(output);
+    if (output.length > 0 && !output.endsWith("\n")) {
+      process.stdout.write("\n");
+    }
   }
 }