@indigoai-us/hq-cli 5.77.13 → 5.78.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (307) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/assets/scaffold/core/scripts/archive-old-threads.sh +86 -0
  3. package/assets/scaffold/core/scripts/backfill-company-skill-mirrors.sh +73 -0
  4. package/assets/scaffold/core/scripts/backfill-workspace-mirror.sh +51 -0
  5. package/assets/scaffold/core/scripts/codex-skill-bridge.sh +550 -0
  6. package/assets/scaffold/core/scripts/detect-stale-core-policy-mirror.sh +185 -0
  7. package/assets/scaffold/core/scripts/hq-status-summary.sh +187 -0
  8. package/assets/scaffold/core/scripts/ontology-readme-drift.sh +264 -0
  9. package/assets/scaffold/core/scripts/qmd-reindex-after-sync.sh +93 -0
  10. package/assets/scaffold/core/scripts/rebuild-all-indexes.sh +69 -0
  11. package/assets/scaffold/core/scripts/rebuild-companies-index.sh +206 -0
  12. package/assets/scaffold/core/scripts/rebuild-company-knowledge-index.sh +127 -0
  13. package/assets/scaffold/core/scripts/rebuild-orchestrator-index.sh +86 -0
  14. package/assets/scaffold/core/scripts/rebuild-projects-index.sh +105 -0
  15. package/assets/scaffold/core/scripts/rebuild-public-knowledge-index.sh +83 -0
  16. package/assets/scaffold/core/scripts/rebuild-reports-index.sh +114 -0
  17. package/assets/scaffold/core/scripts/rebuild-social-drafts-index.sh +135 -0
  18. package/assets/scaffold/core/scripts/rebuild-threads-index.sh +82 -0
  19. package/assets/scaffold/core/scripts/rebuild-workers-index.sh +97 -0
  20. package/assets/scaffold/core/scripts/resize-screenshot.sh +47 -0
  21. package/assets/scaffold/core/scripts/token-usage-report.sh +254 -0
  22. package/assets/scaffold/core/scripts/worktree.sh +136 -0
  23. package/dist/commands/agents.js +28 -12
  24. package/dist/commands/api-keys.js +100 -20
  25. package/dist/commands/core.d.ts +90 -0
  26. package/dist/commands/core.js +279 -0
  27. package/dist/commands/files-browse.d.ts +21 -0
  28. package/dist/commands/files-browse.js +145 -24
  29. package/dist/commands/files.js +33 -7
  30. package/dist/commands/members.js +16 -5
  31. package/dist/commands/pack-install.d.ts +14 -0
  32. package/dist/commands/pack-install.js +51 -2
  33. package/dist/commands/pkg-install.js +43 -0
  34. package/dist/commands/run.js +8 -0
  35. package/dist/commands/secrets.js +125 -65
  36. package/dist/main.js +6 -0
  37. package/dist/utils/api-key-command-gate.d.ts +45 -0
  38. package/dist/utils/api-key-command-gate.js +51 -0
  39. package/dist/utils/hq-roots.d.ts +91 -0
  40. package/dist/utils/hq-roots.js +212 -0
  41. package/dist/utils/resolve-vault-credential.d.ts +63 -3
  42. package/dist/utils/resolve-vault-credential.js +152 -6
  43. package/dist/utils/run-bundled-script.d.ts +66 -0
  44. package/dist/utils/run-bundled-script.js +80 -0
  45. package/dist/utils/vault-api.d.ts +21 -0
  46. package/dist/utils/vault-api.js +74 -3
  47. package/package.json +7 -1
  48. package/.claude/policies/hq-cli-interactive-reads-use-sts-vend.md +0 -49
  49. package/.github/workflows/ci.yml +0 -46
  50. package/.github/workflows/publish.yml +0 -36
  51. package/.github/workflows/scripts/smoke-test-pkg.sh +0 -97
  52. package/e2e/cli.test.ts +0 -128
  53. package/eslint.config.js +0 -37
  54. package/pnpm-workspace.yaml +0 -4
  55. package/scripts/chmod-bins.mjs +0 -49
  56. package/scripts/generate-dsn.mjs +0 -26
  57. package/scripts/generate-scan-packages-table.mjs +0 -113
  58. package/scripts/smoke-sources-signals.sh +0 -103
  59. package/src/bin/hq-auth-refresh.ts +0 -43
  60. package/src/cli-version.ts +0 -13
  61. package/src/commands/__fixtures__/make-tar.ts +0 -126
  62. package/src/commands/_patterns.ts +0 -10
  63. package/src/commands/add.ts +0 -75
  64. package/src/commands/agents.test.ts +0 -527
  65. package/src/commands/agents.ts +0 -923
  66. package/src/commands/api-keys.test.ts +0 -291
  67. package/src/commands/api-keys.ts +0 -382
  68. package/src/commands/artifact-verify.test.ts +0 -177
  69. package/src/commands/auth.test.ts +0 -82
  70. package/src/commands/auth.ts +0 -213
  71. package/src/commands/billing.test.ts +0 -158
  72. package/src/commands/billing.ts +0 -146
  73. package/src/commands/channels.test.ts +0 -74
  74. package/src/commands/channels.ts +0 -91
  75. package/src/commands/cloud-demote.test.ts +0 -401
  76. package/src/commands/cloud-demote.ts +0 -278
  77. package/src/commands/cloud-provision.test.ts +0 -1117
  78. package/src/commands/cloud-provision.ts +0 -942
  79. package/src/commands/cloud.pull-all.test.ts +0 -711
  80. package/src/commands/cloud.pull-per-company.test.ts +0 -188
  81. package/src/commands/cloud.push-all.test.ts +0 -485
  82. package/src/commands/cloud.scope-excluded-warning.test.ts +0 -22
  83. package/src/commands/cloud.selectors.test.ts +0 -208
  84. package/src/commands/cloud.status.test.ts +0 -160
  85. package/src/commands/cloud.test.ts +0 -41
  86. package/src/commands/cloud.ts +0 -2130
  87. package/src/commands/company.test.ts +0 -202
  88. package/src/commands/company.ts +0 -148
  89. package/src/commands/creators.test.ts +0 -60
  90. package/src/commands/creators.ts +0 -117
  91. package/src/commands/crm.test.ts +0 -179
  92. package/src/commands/crm.ts +0 -236
  93. package/src/commands/db-migrate.ts +0 -55
  94. package/src/commands/db-provision.ts +0 -114
  95. package/src/commands/db-sql.ts +0 -124
  96. package/src/commands/db-status.ts +0 -108
  97. package/src/commands/db.ts +0 -26
  98. package/src/commands/dm.test.ts +0 -748
  99. package/src/commands/dm.ts +0 -1226
  100. package/src/commands/feedback.test.ts +0 -413
  101. package/src/commands/feedback.ts +0 -169
  102. package/src/commands/files-browse.test.ts +0 -1249
  103. package/src/commands/files-browse.ts +0 -1506
  104. package/src/commands/files-delete.test.ts +0 -484
  105. package/src/commands/files-recovery.test.ts +0 -370
  106. package/src/commands/files.test.ts +0 -722
  107. package/src/commands/files.ts +0 -1446
  108. package/src/commands/group-grants.test.ts +0 -330
  109. package/src/commands/group-grants.ts +0 -455
  110. package/src/commands/groups.test.ts +0 -44
  111. package/src/commands/groups.ts +0 -368
  112. package/src/commands/integrations.test.ts +0 -633
  113. package/src/commands/integrations.ts +0 -507
  114. package/src/commands/list.ts +0 -85
  115. package/src/commands/login.ts +0 -52
  116. package/src/commands/logout.ts +0 -30
  117. package/src/commands/marketplace-install.test.ts +0 -543
  118. package/src/commands/marketplace-security.test.ts +0 -646
  119. package/src/commands/mcp-registration.test.ts +0 -2787
  120. package/src/commands/mcp-registration.ts +0 -2612
  121. package/src/commands/mcp-status.test.ts +0 -483
  122. package/src/commands/mcp-status.ts +0 -575
  123. package/src/commands/mcp-status.us011.test.ts +0 -243
  124. package/src/commands/meetings.test.ts +0 -522
  125. package/src/commands/meetings.ts +0 -789
  126. package/src/commands/members.test.ts +0 -1474
  127. package/src/commands/members.ts +0 -1181
  128. package/src/commands/onboard-identity-guard.test.ts +0 -99
  129. package/src/commands/onboard-identity-guard.ts +0 -103
  130. package/src/commands/onboard-join.test.ts +0 -96
  131. package/src/commands/onboard-join.ts +0 -101
  132. package/src/commands/onboard-warning.test.ts +0 -26
  133. package/src/commands/onboard-warning.ts +0 -12
  134. package/src/commands/onboard.ts +0 -267
  135. package/src/commands/outposts-heartbeat.test.ts +0 -299
  136. package/src/commands/outposts-heartbeat.ts +0 -310
  137. package/src/commands/outposts-replica-sync.test.ts +0 -272
  138. package/src/commands/outposts-self-deploy.test.ts +0 -243
  139. package/src/commands/outposts.test.ts +0 -1039
  140. package/src/commands/outposts.ts +0 -1935
  141. package/src/commands/pack-install-secret-authorization.test.ts +0 -115
  142. package/src/commands/pack-install.test.ts +0 -1469
  143. package/src/commands/pack-install.ts +0 -2247
  144. package/src/commands/pack-update-cache.test.ts +0 -149
  145. package/src/commands/packs.test.ts +0 -88
  146. package/src/commands/packs.ts +0 -622
  147. package/src/commands/people.test.ts +0 -807
  148. package/src/commands/people.ts +0 -422
  149. package/src/commands/pkg-install.dispatch.test.ts +0 -71
  150. package/src/commands/pkg-install.ts +0 -215
  151. package/src/commands/pkg-list.test.ts +0 -79
  152. package/src/commands/pkg-list.ts +0 -13
  153. package/src/commands/pkg-remove.ts +0 -71
  154. package/src/commands/pkg-update.ts +0 -189
  155. package/src/commands/publish.test.ts +0 -650
  156. package/src/commands/publish.ts +0 -580
  157. package/src/commands/reindex.test.ts +0 -259
  158. package/src/commands/reindex.ts +0 -274
  159. package/src/commands/rescue.test.ts +0 -39
  160. package/src/commands/rescue.ts +0 -210
  161. package/src/commands/run.env-local.test.ts +0 -88
  162. package/src/commands/run.test.ts +0 -45
  163. package/src/commands/run.ts +0 -184
  164. package/src/commands/safe-extract.test.ts +0 -459
  165. package/src/commands/safe-extract.ts +0 -444
  166. package/src/commands/secrets-scope.test.ts +0 -56
  167. package/src/commands/secrets-scope.ts +0 -32
  168. package/src/commands/secrets.parse-destination.test.ts +0 -38
  169. package/src/commands/secrets.test.ts +0 -2037
  170. package/src/commands/secrets.ts +0 -2240
  171. package/src/commands/signals.ts +0 -351
  172. package/src/commands/skill.test.ts +0 -770
  173. package/src/commands/skill.ts +0 -796
  174. package/src/commands/sources.ts +0 -362
  175. package/src/commands/sync-mode.test.ts +0 -366
  176. package/src/commands/sync-mode.ts +0 -387
  177. package/src/commands/sync-narrow.test.ts +0 -633
  178. package/src/commands/sync-narrow.ts +0 -555
  179. package/src/commands/sync.ts +0 -165
  180. package/src/commands/team-sync.ts +0 -628
  181. package/src/commands/update.ts +0 -71
  182. package/src/commands/whoami.ts +0 -83
  183. package/src/commands/workers.test.ts +0 -158
  184. package/src/commands/workers.ts +0 -301
  185. package/src/index.test.ts +0 -32
  186. package/src/index.ts +0 -20
  187. package/src/lib/db/control-plane.test.ts +0 -59
  188. package/src/lib/db/control-plane.ts +0 -113
  189. package/src/lib/db/local.test.ts +0 -81
  190. package/src/lib/db/local.ts +0 -148
  191. package/src/lib/db/migrate.test.ts +0 -133
  192. package/src/lib/db/migrate.ts +0 -137
  193. package/src/lib/db/paths.test.ts +0 -112
  194. package/src/lib/db/paths.ts +0 -128
  195. package/src/lib/db/remote-engine.test.ts +0 -44
  196. package/src/lib/db/remote-engine.ts +0 -148
  197. package/src/lib/db/remote-sql.test.ts +0 -32
  198. package/src/lib/db/remote-sql.ts +0 -62
  199. package/src/lib/db/sql.test.ts +0 -106
  200. package/src/lib/db/sql.ts +0 -192
  201. package/src/lib/hq-cloud-dep.smoke.test.ts +0 -75
  202. package/src/lib/local-tree-diff.test.ts +0 -301
  203. package/src/lib/local-tree-diff.ts +0 -362
  204. package/src/lib/narrow-hint-banner.test.ts +0 -235
  205. package/src/lib/narrow-hint-banner.ts +0 -212
  206. package/src/lib/plan-limit-nag.test.ts +0 -317
  207. package/src/lib/plan-limit-nag.ts +0 -264
  208. package/src/main.ts +0 -371
  209. package/src/node-preflight.test.ts +0 -60
  210. package/src/node-preflight.ts +0 -67
  211. package/src/outpost/session-heartbeat-bounds.test.ts +0 -195
  212. package/src/outpost/session-heartbeat-guard.test.ts +0 -105
  213. package/src/outpost/session-heartbeat-publisher.test.ts +0 -178
  214. package/src/outpost/session-heartbeat-publisher.ts +0 -186
  215. package/src/outpost/session-heartbeat-retain-guard.test.ts +0 -126
  216. package/src/outpost/session-heartbeat.test.ts +0 -459
  217. package/src/outpost/session-heartbeat.ts +0 -877
  218. package/src/packaging.test.ts +0 -109
  219. package/src/run/__fixtures__/discover-schemas/example.env.schema +0 -4
  220. package/src/run/discover-schemas.test.ts +0 -153
  221. package/src/run/discover-schemas.ts +0 -79
  222. package/src/run/hq-plugin.test.ts +0 -371
  223. package/src/run/hq-plugin.ts +0 -277
  224. package/src/run/varlock-shape.test.ts +0 -57
  225. package/src/schemas/hq-package.schema.json +0 -155
  226. package/src/sentry-before-send.test.ts +0 -359
  227. package/src/sentry-before-send.ts +0 -221
  228. package/src/sentry-epipe.test.ts +0 -37
  229. package/src/sentry-release.test.ts +0 -54
  230. package/src/sentry.test.ts +0 -24
  231. package/src/sentry.ts +0 -54
  232. package/src/strategies/link.ts +0 -62
  233. package/src/strategies/merge.ts +0 -142
  234. package/src/types.ts +0 -146
  235. package/src/utils/__fixtures__/scan-packages.generated-block.sh +0 -23
  236. package/src/utils/auth-error.test.ts +0 -40
  237. package/src/utils/auth-error.ts +0 -42
  238. package/src/utils/billing-gate.test.ts +0 -95
  239. package/src/utils/billing-gate.ts +0 -228
  240. package/src/utils/breadcrumb-buffer.ts +0 -18
  241. package/src/utils/cli-telemetry.test.ts +0 -153
  242. package/src/utils/cli-telemetry.ts +0 -61
  243. package/src/utils/cognito-session.machine.test.ts +0 -109
  244. package/src/utils/cognito-session.refresh.test.ts +0 -84
  245. package/src/utils/cognito-session.test.ts +0 -328
  246. package/src/utils/cognito-session.ts +0 -448
  247. package/src/utils/company-selection-error.test.ts +0 -42
  248. package/src/utils/company-selection-error.ts +0 -45
  249. package/src/utils/contribution-table.ts +0 -83
  250. package/src/utils/environmental-error.test.ts +0 -45
  251. package/src/utils/environmental-error.ts +0 -39
  252. package/src/utils/epipe.test.ts +0 -28
  253. package/src/utils/epipe.ts +0 -29
  254. package/src/utils/expected-cli-error.test.ts +0 -28
  255. package/src/utils/expected-cli-error.ts +0 -39
  256. package/src/utils/feedback-diagnostics.test.ts +0 -183
  257. package/src/utils/feedback-diagnostics.ts +0 -123
  258. package/src/utils/feedback-screenshots.test.ts +0 -134
  259. package/src/utils/feedback-screenshots.ts +0 -124
  260. package/src/utils/feedback-versions.test.ts +0 -98
  261. package/src/utils/feedback-versions.ts +0 -68
  262. package/src/utils/git.ts +0 -74
  263. package/src/utils/integrity.ts +0 -59
  264. package/src/utils/intercepted-process-exit.test.ts +0 -37
  265. package/src/utils/intercepted-process-exit.ts +0 -36
  266. package/src/utils/login-provider.test.ts +0 -42
  267. package/src/utils/login-provider.ts +0 -30
  268. package/src/utils/manifest.test.ts +0 -167
  269. package/src/utils/manifest.ts +0 -131
  270. package/src/utils/pack-contributions.test.ts +0 -603
  271. package/src/utils/pack-contributions.ts +0 -450
  272. package/src/utils/people.ts +0 -215
  273. package/src/utils/registry-client.ts +0 -204
  274. package/src/utils/registry.ts +0 -90
  275. package/src/utils/resolve-vault-credential.test.ts +0 -69
  276. package/src/utils/resolve-vault-credential.ts +0 -60
  277. package/src/utils/sandbox-runner-client.test.ts +0 -279
  278. package/src/utils/sandbox-runner-client.ts +0 -260
  279. package/src/utils/secrets-cache.ts +0 -183
  280. package/src/utils/sentry-identity.ts +0 -45
  281. package/src/utils/settle-with-timeout.test.ts +0 -21
  282. package/src/utils/settle-with-timeout.ts +0 -22
  283. package/src/utils/user-yaml-error.test.ts +0 -24
  284. package/src/utils/user-yaml-error.ts +0 -30
  285. package/src/utils/vault-api.test.ts +0 -536
  286. package/src/utils/vault-api.ts +0 -382
  287. package/src/utils/version-check.test.ts +0 -176
  288. package/src/utils/version-check.ts +0 -155
  289. package/src/utils/version-gate.test.ts +0 -1024
  290. package/src/utils/version-gate.ts +0 -702
  291. package/test/commands/db-tenant-isolation.test.ts +0 -94
  292. package/test/commands/db.test.ts +0 -85
  293. package/test/commands/signals.test.ts +0 -207
  294. package/test/commands/sources.test.ts +0 -231
  295. package/test/e2e/smoke-install-mcp.sh +0 -113
  296. package/test/fixtures/hq-pack-smoke-mcp/mcp/smoke-http.json +0 -1
  297. package/test/fixtures/hq-pack-smoke-mcp/package.yaml +0 -11
  298. package/test/fixtures/signals/action_item/sample.md +0 -16
  299. package/test/fixtures/signals/summary/sample.md +0 -12
  300. package/test/fixtures/sources/meetings/sample.md +0 -25
  301. package/test/helpers/cli-runner.ts +0 -150
  302. package/test/helpers/s3-list-mock.ts +0 -79
  303. package/test/helpers/vault-service-mock.ts +0 -295
  304. package/test/sources-signals/smoke.test.ts +0 -228
  305. package/tsconfig.json +0 -20
  306. package/vitest.config.ts +0 -11
  307. package/vitest.e2e.config.ts +0 -7
@@ -1,146 +0,0 @@
1
- /**
2
- * `hq billing` — inspect billing state and mint a card-capture link from the
3
- * terminal. Backs the paid-provisioning gate (agents & Outposts): a user can
4
- * check whether a card is on file, and proactively hand out the same Stripe
5
- * hosted card-capture link that a `402 billing_required` would surface.
6
- *
7
- * Targets the hq-pro billing control plane on `DEFAULT_VAULT_API_URL` via the
8
- * shared `vaultApiFetch` helper — the same routes the console billing surfaces
9
- * call.
10
- *
11
- * Subcommands:
12
- * hq billing status [--company <slug>] — subscription + card on file
13
- * hq billing checkout [--company <slug>] [--personal] — mint a card-capture link
14
- */
15
-
16
- import { Command } from "commander";
17
- import chalk from "chalk";
18
- import { ensureCognitoToken } from "../utils/cognito-session.js";
19
- import { vaultApiFetch, getCompanyUid } from "../utils/vault-api.js";
20
- import { mintPaymentLink, type BillingSetupAction } from "../utils/billing-gate.js";
21
-
22
- /** Shape of `GET /v1/billing/summary` we render. */
23
- interface BillingSummary {
24
- subscriptionStatus: string | null;
25
- defaultPaymentMethod: {
26
- present: boolean;
27
- brand: string | null;
28
- last4: string | null;
29
- };
30
- [key: string]: unknown;
31
- }
32
-
33
- function fail(err: unknown): never {
34
- console.error(
35
- chalk.red("Error:"),
36
- err instanceof Error ? err.message : String(err),
37
- );
38
- process.exit(1);
39
- }
40
-
41
- async function getBillingSummary(
42
- token: string,
43
- companyUid: string,
44
- ): Promise<BillingSummary> {
45
- const res = await vaultApiFetch({
46
- token,
47
- path: "/v1/billing/summary",
48
- query: { companyUid },
49
- });
50
- if (!res.ok) {
51
- const body = (await res.json().catch(() => ({}))) as {
52
- error?: string;
53
- message?: string;
54
- };
55
- throw new Error(body.error ?? body.message ?? res.statusText);
56
- }
57
- return (await res.json()) as BillingSummary;
58
- }
59
-
60
- export function registerBillingCommand(program: Command): void {
61
- const billing = program
62
- .command("billing")
63
- .description("Inspect billing and mint a card-capture link")
64
- .option("--company <slug>", "Company slug (resolves to companyUid)");
65
-
66
- const companyOf = (sub: Command): string | undefined =>
67
- (sub.opts().company as string | undefined) ??
68
- (billing.opts().company as string | undefined);
69
-
70
- billing
71
- .command("status")
72
- .description("Show subscription status and whether a card is on file")
73
- .option("--company <slug>", "Company slug (resolves to companyUid)")
74
- .option("--json", "Emit raw JSON")
75
- .action(async function (this: Command, opts: { json?: boolean }) {
76
- try {
77
- const token = await ensureCognitoToken();
78
- const companyUid = await getCompanyUid(token, companyOf(this));
79
- const summary = await getBillingSummary(token, companyUid);
80
- if (opts.json) {
81
- process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
82
- return;
83
- }
84
- const sub = summary.subscriptionStatus ?? "none";
85
- console.log(`${chalk.bold("Subscription")}: ${sub}`);
86
- const pm = summary.defaultPaymentMethod;
87
- if (pm?.present) {
88
- const detail =
89
- pm.brand && pm.last4 ? `${pm.brand} ••••${pm.last4}` : "on file";
90
- console.log(`${chalk.bold("Card")}: ${detail}`);
91
- } else {
92
- console.log(
93
- `${chalk.bold("Card")}: ${chalk.yellow("no card on file")} — ` +
94
- `run \`hq billing checkout\` to add one before provisioning paid resources.`,
95
- );
96
- }
97
- } catch (err) {
98
- fail(err);
99
- }
100
- });
101
-
102
- billing
103
- .command("checkout")
104
- .description("Mint a Stripe card-capture link (shareable) to add a card")
105
- .option("--company <slug>", "Company slug (resolves to companyUid)")
106
- .option(
107
- "--personal",
108
- "Mint the link for your personal payer (Outposts) instead of a company",
109
- )
110
- .option("--json", "Emit raw JSON")
111
- .action(async function (
112
- this: Command,
113
- opts: { personal?: boolean; json?: boolean },
114
- ) {
115
- try {
116
- const token = await ensureCognitoToken();
117
- let setup: BillingSetupAction;
118
- if (opts.personal) {
119
- setup = {
120
- payerType: "person",
121
- path: "/v1/billing/checkout/person",
122
- method: "POST",
123
- };
124
- } else {
125
- const companyUid = await getCompanyUid(token, companyOf(this));
126
- setup = {
127
- payerType: "company",
128
- path: "/v1/billing/checkout/org",
129
- method: "POST",
130
- body: { companyUid },
131
- };
132
- }
133
- const url = await mintPaymentLink(token, setup);
134
- if (opts.json) {
135
- process.stdout.write(JSON.stringify({ url }, null, 2) + "\n");
136
- return;
137
- }
138
- console.log(
139
- "Add a card here (safe to share with whoever owns billing):\n " +
140
- chalk.cyan(url),
141
- );
142
- } catch (err) {
143
- fail(err);
144
- }
145
- });
146
- }
@@ -1,74 +0,0 @@
1
- import { describe, expect, it, beforeAll } from "vitest";
2
- import chalk from "chalk";
3
- import { describeChannel, formatChannelsList } from "./channels.js";
4
- import type { ChannelSummary } from "./dm.js";
5
-
6
- // Disable chalk's ANSI colouring so assertions read the plain rendered text
7
- // (chalk is a singleton, so this also affects the module under test).
8
- beforeAll(() => {
9
- chalk.level = 0;
10
- });
11
-
12
- describe("describeChannel", () => {
13
- it("shows a named channel with a `hq dm <slug>` hint", () => {
14
- const c: ChannelSummary = {
15
- channelId: "chn_v",
16
- name: "VYG Dev",
17
- slug: "vyg-dev",
18
- scope: "company",
19
- };
20
- const out = describeChannel(c);
21
- expect(out).toContain("VYG Dev");
22
- expect(out).toContain("(company)");
23
- expect(out).toContain('hq dm vyg-dev "…"');
24
- });
25
-
26
- it("identifies an unnamed group DM by its members", () => {
27
- const c: ChannelSummary = {
28
- channelId: "chn_grp",
29
- scope: "group",
30
- memberCount: 3,
31
- members: [
32
- { personUid: "prs_a", displayName: "Stefan" },
33
- { personUid: "prs_b", displayName: "Hassaan" },
34
- ],
35
- };
36
- const out = describeChannel(c);
37
- expect(out).toContain("Stefan, Hassaan");
38
- expect(out).toContain("(group DM)");
39
- });
40
-
41
- it("falls back to a member count when a group has no resolved names", () => {
42
- const c: ChannelSummary = { channelId: "g", scope: "group", memberCount: 4 };
43
- expect(describeChannel(c)).toContain("4-person group");
44
- });
45
- });
46
-
47
- describe("formatChannelsList", () => {
48
- it("renders an empty-state line when there are no channels", () => {
49
- expect(formatChannelsList([])).toMatch(/No channels yet/);
50
- });
51
-
52
- it("headers with the count and lists each channel", () => {
53
- const channels: ChannelSummary[] = [
54
- { channelId: "chn_v", name: "VYG Dev", slug: "vyg-dev", scope: "company" },
55
- {
56
- channelId: "chn_grp",
57
- scope: "group",
58
- memberCount: 2,
59
- members: [{ personUid: "prs_a", displayName: "Stefan" }],
60
- },
61
- ];
62
- const out = formatChannelsList(channels);
63
- expect(out).toMatch(/2 channels:/);
64
- expect(out).toContain("VYG Dev");
65
- expect(out).toContain("Stefan");
66
- });
67
-
68
- it("uses the singular 'channel' for one", () => {
69
- const out = formatChannelsList([
70
- { channelId: "chn_v", name: "VYG Dev", slug: "vyg-dev", scope: "company" },
71
- ]);
72
- expect(out).toMatch(/1 channel:/);
73
- });
74
- });
@@ -1,91 +0,0 @@
1
- import { Command } from "commander";
2
- import chalk from "chalk";
3
- import { ensureCognitoToken } from "../utils/cognito-session.js";
4
- import { vaultApiFetch } from "../utils/vault-api.js";
5
- import { channelSlug, type ChannelSummary } from "./dm.js";
6
-
7
- /**
8
- * Human label for a channel row. Named channels (personal/company) show their
9
- * name + a `hq dm <slug>` hint; unnamed group DMs are identified by their
10
- * members (caller excluded), matching how HQ Sync renders them. Pure →
11
- * unit-testable.
12
- */
13
- export function describeChannel(c: ChannelSummary): string {
14
- if (c.scope === "group") {
15
- const names = (c.members ?? [])
16
- .map((m) => m.displayName)
17
- .filter((n): n is string => !!n);
18
- const who =
19
- names.length > 0
20
- ? names.join(", ")
21
- : `${c.memberCount ?? "?"}-person group`;
22
- // Group DMs are unnamed, so their channel id is the only way to address them
23
- // for reading (`hq dm channel <id>`). Surface it so it can be copied.
24
- const readHint = chalk.dim(`— hq dm channel ${c.channelId}`);
25
- return `${who} ${chalk.dim("(group DM)")} ${readHint}`;
26
- }
27
- const slug = c.slug ?? (c.name ? channelSlug(c.name) : "");
28
- const scopeTag = c.scope ? chalk.dim(`(${c.scope})`) : "";
29
- const hint = slug ? chalk.dim(`— hq dm ${slug} "…"`) : "";
30
- return `${chalk.bold(c.name ?? slug ?? c.channelId)} ${scopeTag} ${hint}`.trim();
31
- }
32
-
33
- /**
34
- * Render the caller's channels for `hq channels`. Pure (takes the already
35
- * fetched list) so the formatting is unit-testable without network/auth.
36
- */
37
- export function formatChannelsList(channels: ChannelSummary[]): string {
38
- if (channels.length === 0) {
39
- return chalk.dim(
40
- "No channels yet. Group DMs and named channels you're in will appear here.",
41
- );
42
- }
43
- const lines = [
44
- chalk.green(
45
- `${channels.length} channel${channels.length === 1 ? "" : "s"}:`,
46
- ),
47
- ];
48
- for (const c of channels) {
49
- lines.push(` ${describeChannel(c)}`);
50
- }
51
- return lines.join("\n");
52
- }
53
-
54
- async function runChannelsList(): Promise<void> {
55
- try {
56
- const token = await ensureCognitoToken();
57
- const res = await vaultApiFetch({ token, path: "/v1/notify/channels" });
58
- if (!res.ok) {
59
- if (res.status === 401) {
60
- console.error(chalk.red("Not authenticated — run `hq login` and try again."));
61
- } else {
62
- const err = (await res.json().catch(() => ({}))) as Record<string, string>;
63
- console.error(
64
- chalk.red(`Could not list channels: ${err.error ?? err.message ?? res.statusText}`),
65
- );
66
- }
67
- process.exit(1);
68
- }
69
- const data = (await res.json()) as { channels?: ChannelSummary[] };
70
- console.log(formatChannelsList(data.channels ?? []));
71
- } catch (err) {
72
- console.error(
73
- chalk.red("Error:"),
74
- err instanceof Error ? err.message : String(err),
75
- );
76
- process.exit(1);
77
- }
78
- }
79
-
80
- export function registerChannelsCommand(program: Command): void {
81
- const channels = program
82
- .command("channels")
83
- .description("List the DM channels you're in (name them with `hq dm <name> \"…\"`).");
84
-
85
- channels
86
- .command("list", { isDefault: true })
87
- .description("List your DM channels — named channels and group DMs.")
88
- .action(async () => {
89
- await runChannelsList();
90
- });
91
- }