@indigoai-us/hq-cli 5.77.14 → 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 (308) hide show
  1. package/CHANGELOG.md +23 -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 +42 -2
  33. package/dist/commands/pkg-install.js +39 -2
  34. package/dist/commands/run.js +6 -2
  35. package/dist/commands/secrets.js +120 -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 -2256
  144. package/src/commands/pack-update-cache.test.ts +0 -149
  145. package/src/commands/packs-update-api-key.test.ts +0 -105
  146. package/src/commands/packs.test.ts +0 -88
  147. package/src/commands/packs.ts +0 -622
  148. package/src/commands/people.test.ts +0 -807
  149. package/src/commands/people.ts +0 -422
  150. package/src/commands/pkg-install.dispatch.test.ts +0 -103
  151. package/src/commands/pkg-install.ts +0 -221
  152. package/src/commands/pkg-list.test.ts +0 -79
  153. package/src/commands/pkg-list.ts +0 -13
  154. package/src/commands/pkg-remove.ts +0 -71
  155. package/src/commands/pkg-update.ts +0 -189
  156. package/src/commands/publish.test.ts +0 -650
  157. package/src/commands/publish.ts +0 -580
  158. package/src/commands/reindex.test.ts +0 -259
  159. package/src/commands/reindex.ts +0 -274
  160. package/src/commands/rescue.test.ts +0 -39
  161. package/src/commands/rescue.ts +0 -210
  162. package/src/commands/run.env-local.test.ts +0 -88
  163. package/src/commands/run.test.ts +0 -45
  164. package/src/commands/run.ts +0 -190
  165. package/src/commands/safe-extract.test.ts +0 -459
  166. package/src/commands/safe-extract.ts +0 -444
  167. package/src/commands/secrets-scope.test.ts +0 -56
  168. package/src/commands/secrets-scope.ts +0 -32
  169. package/src/commands/secrets.parse-destination.test.ts +0 -38
  170. package/src/commands/secrets.test.ts +0 -2050
  171. package/src/commands/secrets.ts +0 -2249
  172. package/src/commands/signals.ts +0 -351
  173. package/src/commands/skill.test.ts +0 -770
  174. package/src/commands/skill.ts +0 -796
  175. package/src/commands/sources.ts +0 -362
  176. package/src/commands/sync-mode.test.ts +0 -366
  177. package/src/commands/sync-mode.ts +0 -387
  178. package/src/commands/sync-narrow.test.ts +0 -633
  179. package/src/commands/sync-narrow.ts +0 -555
  180. package/src/commands/sync.ts +0 -165
  181. package/src/commands/team-sync.ts +0 -628
  182. package/src/commands/update.ts +0 -71
  183. package/src/commands/whoami.ts +0 -83
  184. package/src/commands/workers.test.ts +0 -158
  185. package/src/commands/workers.ts +0 -301
  186. package/src/index.test.ts +0 -32
  187. package/src/index.ts +0 -20
  188. package/src/lib/db/control-plane.test.ts +0 -59
  189. package/src/lib/db/control-plane.ts +0 -113
  190. package/src/lib/db/local.test.ts +0 -81
  191. package/src/lib/db/local.ts +0 -148
  192. package/src/lib/db/migrate.test.ts +0 -133
  193. package/src/lib/db/migrate.ts +0 -137
  194. package/src/lib/db/paths.test.ts +0 -112
  195. package/src/lib/db/paths.ts +0 -128
  196. package/src/lib/db/remote-engine.test.ts +0 -44
  197. package/src/lib/db/remote-engine.ts +0 -148
  198. package/src/lib/db/remote-sql.test.ts +0 -32
  199. package/src/lib/db/remote-sql.ts +0 -62
  200. package/src/lib/db/sql.test.ts +0 -106
  201. package/src/lib/db/sql.ts +0 -192
  202. package/src/lib/hq-cloud-dep.smoke.test.ts +0 -75
  203. package/src/lib/local-tree-diff.test.ts +0 -301
  204. package/src/lib/local-tree-diff.ts +0 -362
  205. package/src/lib/narrow-hint-banner.test.ts +0 -235
  206. package/src/lib/narrow-hint-banner.ts +0 -212
  207. package/src/lib/plan-limit-nag.test.ts +0 -317
  208. package/src/lib/plan-limit-nag.ts +0 -264
  209. package/src/main.ts +0 -371
  210. package/src/node-preflight.test.ts +0 -60
  211. package/src/node-preflight.ts +0 -67
  212. package/src/outpost/session-heartbeat-bounds.test.ts +0 -195
  213. package/src/outpost/session-heartbeat-guard.test.ts +0 -105
  214. package/src/outpost/session-heartbeat-publisher.test.ts +0 -178
  215. package/src/outpost/session-heartbeat-publisher.ts +0 -186
  216. package/src/outpost/session-heartbeat-retain-guard.test.ts +0 -126
  217. package/src/outpost/session-heartbeat.test.ts +0 -459
  218. package/src/outpost/session-heartbeat.ts +0 -877
  219. package/src/packaging.test.ts +0 -109
  220. package/src/run/__fixtures__/discover-schemas/example.env.schema +0 -4
  221. package/src/run/discover-schemas.test.ts +0 -153
  222. package/src/run/discover-schemas.ts +0 -79
  223. package/src/run/hq-plugin.test.ts +0 -371
  224. package/src/run/hq-plugin.ts +0 -277
  225. package/src/run/varlock-shape.test.ts +0 -57
  226. package/src/schemas/hq-package.schema.json +0 -155
  227. package/src/sentry-before-send.test.ts +0 -359
  228. package/src/sentry-before-send.ts +0 -221
  229. package/src/sentry-epipe.test.ts +0 -37
  230. package/src/sentry-release.test.ts +0 -54
  231. package/src/sentry.test.ts +0 -24
  232. package/src/sentry.ts +0 -54
  233. package/src/strategies/link.ts +0 -62
  234. package/src/strategies/merge.ts +0 -142
  235. package/src/types.ts +0 -146
  236. package/src/utils/__fixtures__/scan-packages.generated-block.sh +0 -23
  237. package/src/utils/auth-error.test.ts +0 -40
  238. package/src/utils/auth-error.ts +0 -42
  239. package/src/utils/billing-gate.test.ts +0 -95
  240. package/src/utils/billing-gate.ts +0 -228
  241. package/src/utils/breadcrumb-buffer.ts +0 -18
  242. package/src/utils/cli-telemetry.test.ts +0 -153
  243. package/src/utils/cli-telemetry.ts +0 -61
  244. package/src/utils/cognito-session.machine.test.ts +0 -109
  245. package/src/utils/cognito-session.refresh.test.ts +0 -84
  246. package/src/utils/cognito-session.test.ts +0 -328
  247. package/src/utils/cognito-session.ts +0 -448
  248. package/src/utils/company-selection-error.test.ts +0 -42
  249. package/src/utils/company-selection-error.ts +0 -45
  250. package/src/utils/contribution-table.ts +0 -83
  251. package/src/utils/environmental-error.test.ts +0 -45
  252. package/src/utils/environmental-error.ts +0 -39
  253. package/src/utils/epipe.test.ts +0 -28
  254. package/src/utils/epipe.ts +0 -29
  255. package/src/utils/expected-cli-error.test.ts +0 -28
  256. package/src/utils/expected-cli-error.ts +0 -39
  257. package/src/utils/feedback-diagnostics.test.ts +0 -183
  258. package/src/utils/feedback-diagnostics.ts +0 -123
  259. package/src/utils/feedback-screenshots.test.ts +0 -134
  260. package/src/utils/feedback-screenshots.ts +0 -124
  261. package/src/utils/feedback-versions.test.ts +0 -98
  262. package/src/utils/feedback-versions.ts +0 -68
  263. package/src/utils/git.ts +0 -74
  264. package/src/utils/integrity.ts +0 -59
  265. package/src/utils/intercepted-process-exit.test.ts +0 -37
  266. package/src/utils/intercepted-process-exit.ts +0 -36
  267. package/src/utils/login-provider.test.ts +0 -42
  268. package/src/utils/login-provider.ts +0 -30
  269. package/src/utils/manifest.test.ts +0 -167
  270. package/src/utils/manifest.ts +0 -131
  271. package/src/utils/pack-contributions.test.ts +0 -603
  272. package/src/utils/pack-contributions.ts +0 -450
  273. package/src/utils/people.ts +0 -215
  274. package/src/utils/registry-client.ts +0 -204
  275. package/src/utils/registry.ts +0 -90
  276. package/src/utils/resolve-vault-credential.test.ts +0 -69
  277. package/src/utils/resolve-vault-credential.ts +0 -60
  278. package/src/utils/sandbox-runner-client.test.ts +0 -279
  279. package/src/utils/sandbox-runner-client.ts +0 -260
  280. package/src/utils/secrets-cache.ts +0 -183
  281. package/src/utils/sentry-identity.ts +0 -45
  282. package/src/utils/settle-with-timeout.test.ts +0 -21
  283. package/src/utils/settle-with-timeout.ts +0 -22
  284. package/src/utils/user-yaml-error.test.ts +0 -24
  285. package/src/utils/user-yaml-error.ts +0 -30
  286. package/src/utils/vault-api.test.ts +0 -536
  287. package/src/utils/vault-api.ts +0 -382
  288. package/src/utils/version-check.test.ts +0 -176
  289. package/src/utils/version-check.ts +0 -155
  290. package/src/utils/version-gate.test.ts +0 -1024
  291. package/src/utils/version-gate.ts +0 -702
  292. package/test/commands/db-tenant-isolation.test.ts +0 -94
  293. package/test/commands/db.test.ts +0 -85
  294. package/test/commands/signals.test.ts +0 -207
  295. package/test/commands/sources.test.ts +0 -231
  296. package/test/e2e/smoke-install-mcp.sh +0 -113
  297. package/test/fixtures/hq-pack-smoke-mcp/mcp/smoke-http.json +0 -1
  298. package/test/fixtures/hq-pack-smoke-mcp/package.yaml +0 -11
  299. package/test/fixtures/signals/action_item/sample.md +0 -16
  300. package/test/fixtures/signals/summary/sample.md +0 -12
  301. package/test/fixtures/sources/meetings/sample.md +0 -25
  302. package/test/helpers/cli-runner.ts +0 -150
  303. package/test/helpers/s3-list-mock.ts +0 -79
  304. package/test/helpers/vault-service-mock.ts +0 -295
  305. package/test/sources-signals/smoke.test.ts +0 -228
  306. package/tsconfig.json +0 -20
  307. package/vitest.config.ts +0 -11
  308. package/vitest.e2e.config.ts +0 -7
@@ -1,807 +0,0 @@
1
- /**
2
- * Unit tests for the `hq people` capability:
3
- * - utils/people.ts — parse, list, search, resolve (pure + filesystem)
4
- * - people.ts — active-company resolution + wired list/search/resolve
5
- */
6
-
7
- import * as fs from "fs";
8
- import * as os from "os";
9
- import * as path from "path";
10
- import { Command } from "commander";
11
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
12
-
13
- import {
14
- assertSafeCompanySlug,
15
- companyPeopleDir,
16
- parsePersonMeta,
17
- listCompanyPeople,
18
- searchPeople,
19
- resolveNameToEmail,
20
- type PersonRecord,
21
- } from "../utils/people.js";
22
- import { isExpectedUserError } from "../utils/expected-cli-error.js";
23
- import {
24
- activeMemberToPersonRecord,
25
- mergePeople,
26
- registerPeopleCommand,
27
- resolveCompanySlug,
28
- type FetchPeopleRoster,
29
- } from "./people.js";
30
- import type { ActiveMember } from "./members.js";
31
-
32
- // ---------------------------------------------------------------------------
33
- // Filesystem fixture helpers
34
- // ---------------------------------------------------------------------------
35
-
36
- let tmpRoot: string;
37
-
38
- function makePerson(
39
- company: string,
40
- slug: string,
41
- meta: Record<string, unknown> | string,
42
- ): void {
43
- const dir = path.join(tmpRoot, "companies", company, "people", slug);
44
- fs.mkdirSync(dir, { recursive: true });
45
- const body =
46
- typeof meta === "string"
47
- ? meta
48
- : Object.entries(meta)
49
- .map(([k, v]) =>
50
- Array.isArray(v)
51
- ? `${k}: [${v.join(", ")}]`
52
- : `${k}: ${JSON.stringify(v)}`,
53
- )
54
- .join("\n");
55
- fs.writeFileSync(path.join(dir, "meta.yaml"), body + "\n");
56
- }
57
-
58
- function writeCompaniesManifest(
59
- companies: Record<string, Record<string, unknown> | null>,
60
- ): void {
61
- const dir = path.join(tmpRoot, "companies");
62
- fs.mkdirSync(dir, { recursive: true });
63
- const yamlBody =
64
- "companies:\n" +
65
- Object.entries(companies)
66
- .map(([slug, entry]) => {
67
- if (!entry) return ` ${slug}:`;
68
- const fields = Object.entries(entry)
69
- .map(([k, v]) => ` ${k}: ${JSON.stringify(v)}`)
70
- .join("\n");
71
- return ` ${slug}:\n${fields}`;
72
- })
73
- .join("\n") +
74
- "\n";
75
- fs.writeFileSync(path.join(dir, "manifest.yaml"), yamlBody);
76
- }
77
-
78
- beforeEach(() => {
79
- tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-people-"));
80
- });
81
-
82
- afterEach(() => {
83
- fs.rmSync(tmpRoot, { recursive: true, force: true });
84
- vi.restoreAllMocks();
85
- });
86
-
87
- // ---------------------------------------------------------------------------
88
- // assertSafeCompanySlug
89
- // ---------------------------------------------------------------------------
90
-
91
- describe("assertSafeCompanySlug", () => {
92
- it("accepts ordinary slugs", () => {
93
- expect(() => assertSafeCompanySlug("indigo")).not.toThrow();
94
- expect(() => assertSafeCompanySlug("acme-co_1.2")).not.toThrow();
95
- });
96
-
97
- it("rejects path-traversal and separators", () => {
98
- expect(() => assertSafeCompanySlug("..")).toThrow();
99
- expect(() => assertSafeCompanySlug("a/b")).toThrow();
100
- expect(() => assertSafeCompanySlug("../etc")).toThrow();
101
- expect(() => assertSafeCompanySlug("")).toThrow();
102
- });
103
-
104
- it("rejects reserved slugs", () => {
105
- expect(() => assertSafeCompanySlug("personal")).toThrow(/reserved/);
106
- });
107
- });
108
-
109
- // ---------------------------------------------------------------------------
110
- // parsePersonMeta
111
- // ---------------------------------------------------------------------------
112
-
113
- describe("parsePersonMeta", () => {
114
- it("parses a full record and trims fields", () => {
115
- const rec = parsePersonMeta(
116
- "name: Jane Smith\nemail: jane@example.com\ntype: internal\nrole: Head of Eng\ntags: [eng, lead]\n",
117
- "jane-smith",
118
- "/x/meta.yaml",
119
- );
120
- expect(rec).toEqual({
121
- slug: "jane-smith",
122
- name: "Jane Smith",
123
- email: "jane@example.com",
124
- type: "internal",
125
- role: "Head of Eng",
126
- tags: ["eng", "lead"],
127
- source: "/x/meta.yaml",
128
- });
129
- });
130
-
131
- it("returns null when name is missing or blank", () => {
132
- expect(parsePersonMeta("email: a@b.com\n", "x", "/x")).toBeNull();
133
- expect(parsePersonMeta("name: ' '\n", "x", "/x")).toBeNull();
134
- });
135
-
136
- it("returns null for empty / non-object docs", () => {
137
- expect(parsePersonMeta("", "x", "/x")).toBeNull();
138
- expect(parsePersonMeta("- a\n- b\n", "x", "/x")).toBeNull();
139
- });
140
-
141
- it("throws on unparseable yaml", () => {
142
- const error = (() => {
143
- try {
144
- parsePersonMeta("name: [unterminated\n", "x", "/x");
145
- } catch (err) {
146
- return err;
147
- }
148
- throw new Error("expected malformed YAML to throw");
149
- })();
150
-
151
- expect(isExpectedUserError(error)).toBe(true);
152
- expect((error as Error).message).toContain("Invalid YAML in /x:2:1");
153
- });
154
- });
155
-
156
- // ---------------------------------------------------------------------------
157
- // listCompanyPeople
158
- // ---------------------------------------------------------------------------
159
-
160
- describe("listCompanyPeople", () => {
161
- it("returns [] when the company has no people directory", () => {
162
- writeCompaniesManifest({ acme: { status: "active" } });
163
- expect(listCompanyPeople(tmpRoot, "acme")).toEqual([]);
164
- });
165
-
166
- it("reads people, skips _scaffolding, nameless, and meta-less folders, sorted by name", () => {
167
- makePerson("acme", "zed", { name: "Zed Zebra", email: "zed@acme.com" });
168
- makePerson("acme", "ann", { name: "Ann Apple", email: "ann@acme.com" });
169
- makePerson("acme", "_example", { name: "Template Person" });
170
- makePerson("acme", "nameless", { email: "noone@acme.com" });
171
- // folder with no meta.yaml
172
- fs.mkdirSync(path.join(tmpRoot, "companies", "acme", "people", "empty"), {
173
- recursive: true,
174
- });
175
-
176
- const people = listCompanyPeople(tmpRoot, "acme");
177
- expect(people.map((p) => p.name)).toEqual(["Ann Apple", "Zed Zebra"]);
178
- });
179
-
180
- it("never reads outside the named company (tenancy)", () => {
181
- makePerson("acme", "ann", { name: "Ann Apple", email: "ann@acme.com" });
182
- makePerson("other", "bob", { name: "Bob Other", email: "bob@other.com" });
183
- const people = listCompanyPeople(tmpRoot, "acme");
184
- expect(people.map((p) => p.name)).toEqual(["Ann Apple"]);
185
- });
186
-
187
- it("rejects an unsafe company slug", () => {
188
- expect(() => listCompanyPeople(tmpRoot, "../other")).toThrow();
189
- });
190
- });
191
-
192
- // ---------------------------------------------------------------------------
193
- // searchPeople
194
- // ---------------------------------------------------------------------------
195
-
196
- const SAMPLE: PersonRecord[] = [
197
- { slug: "jane-smith", name: "Jane Smith", email: "jane@example.com", source: "a" },
198
- { slug: "john-doe", name: "John Doe", email: "john@acme.com", source: "b" },
199
- { slug: "janet-lee", name: "Janet Lee", source: "c" },
200
- ];
201
-
202
- describe("searchPeople", () => {
203
- it("matches on name (case-insensitive)", () => {
204
- // "jane" is a substring of both "Jane Smith" and "Janet Lee".
205
- expect(searchPeople(SAMPLE, "jane").map((p) => p.slug)).toEqual([
206
- "jane-smith",
207
- "janet-lee",
208
- ]);
209
- expect(searchPeople(SAMPLE, "smith").map((p) => p.slug)).toEqual([
210
- "jane-smith",
211
- ]);
212
- expect(searchPeople(SAMPLE, "JAN").map((p) => p.slug)).toEqual([
213
- "jane-smith",
214
- "janet-lee",
215
- ]);
216
- });
217
-
218
- it("matches on email", () => {
219
- expect(searchPeople(SAMPLE, "acme.com").map((p) => p.slug)).toEqual([
220
- "john-doe",
221
- ]);
222
- });
223
-
224
- it("matches on slug", () => {
225
- expect(searchPeople(SAMPLE, "janet-lee").map((p) => p.slug)).toEqual([
226
- "janet-lee",
227
- ]);
228
- });
229
-
230
- it("returns nothing for an empty/whitespace keyword", () => {
231
- expect(searchPeople(SAMPLE, "")).toEqual([]);
232
- expect(searchPeople(SAMPLE, " ")).toEqual([]);
233
- });
234
-
235
- it("returns nothing when no one matches", () => {
236
- expect(searchPeople(SAMPLE, "zzz")).toEqual([]);
237
- });
238
- });
239
-
240
- // ---------------------------------------------------------------------------
241
- // resolveNameToEmail
242
- // ---------------------------------------------------------------------------
243
-
244
- describe("resolveNameToEmail", () => {
245
- it("resolves an exact name to its email", () => {
246
- expect(resolveNameToEmail(SAMPLE, "Jane Smith")).toEqual({
247
- status: "found",
248
- email: "jane@example.com",
249
- person: SAMPLE[0],
250
- });
251
- });
252
-
253
- it("is case-insensitive on exact name", () => {
254
- const r = resolveNameToEmail(SAMPLE, "jane smith");
255
- expect(r.status).toBe("found");
256
- });
257
-
258
- it("prefers an exact name over looser substring matches", () => {
259
- const people: PersonRecord[] = [
260
- { slug: "jan", name: "Jan", email: "jan@x.com", source: "a" },
261
- { slug: "jana", name: "Janabc", email: "jana@x.com", source: "b" },
262
- ];
263
- expect(resolveNameToEmail(people, "Jan")).toMatchObject({
264
- status: "found",
265
- email: "jan@x.com",
266
- });
267
- });
268
-
269
- it("resolves via slug when name doesn't match exactly", () => {
270
- expect(resolveNameToEmail(SAMPLE, "john-doe")).toMatchObject({
271
- status: "found",
272
- email: "john@acme.com",
273
- });
274
- });
275
-
276
- it("reports ambiguity when a substring matches several", () => {
277
- const r = resolveNameToEmail(SAMPLE, "jan");
278
- expect(r.status).toBe("ambiguous");
279
- if (r.status === "ambiguous") {
280
- expect(r.matches.map((m) => m.slug)).toEqual(["jane-smith", "janet-lee"]);
281
- }
282
- });
283
-
284
- it("reports no_email when the sole match has no email", () => {
285
- expect(resolveNameToEmail(SAMPLE, "Janet Lee")).toMatchObject({
286
- status: "no_email",
287
- });
288
- });
289
-
290
- it("reports not_found when nothing matches", () => {
291
- expect(resolveNameToEmail(SAMPLE, "Nobody")).toEqual({
292
- status: "not_found",
293
- });
294
- expect(resolveNameToEmail(SAMPLE, " ")).toEqual({ status: "not_found" });
295
- });
296
- });
297
-
298
- // ---------------------------------------------------------------------------
299
- // resolveCompanySlug
300
- // ---------------------------------------------------------------------------
301
-
302
- describe("resolveCompanySlug", () => {
303
- it("passes through an explicit, valid slug", () => {
304
- expect(resolveCompanySlug(tmpRoot, "indigo")).toBe("indigo");
305
- });
306
-
307
- it("rejects an explicit unsafe slug", () => {
308
- expect(() => resolveCompanySlug(tmpRoot, "../escape")).toThrow();
309
- });
310
-
311
- it("defaults to the sole company in the manifest", () => {
312
- writeCompaniesManifest({ indigo: { status: "active" } });
313
- expect(resolveCompanySlug(tmpRoot, undefined)).toBe("indigo");
314
- });
315
-
316
- it("ignores archived companies when defaulting", () => {
317
- writeCompaniesManifest({
318
- indigo: { status: "active" },
319
- old: { status: "archived" },
320
- });
321
- expect(resolveCompanySlug(tmpRoot, undefined)).toBe("indigo");
322
- });
323
-
324
- it("requires --company when several companies exist", () => {
325
- writeCompaniesManifest({ a: { status: "active" }, b: { status: "active" } });
326
- expect(() => resolveCompanySlug(tmpRoot, undefined)).toThrow(
327
- /Multiple companies/,
328
- );
329
- });
330
-
331
- it("errors clearly when the manifest is absent", () => {
332
- expect(() => resolveCompanySlug(tmpRoot, undefined)).toThrow(
333
- /manifest\.yaml not found/,
334
- );
335
- });
336
- });
337
-
338
- // ---------------------------------------------------------------------------
339
- // companyPeopleDir
340
- // ---------------------------------------------------------------------------
341
-
342
- describe("companyPeopleDir", () => {
343
- it("builds the scoped path", () => {
344
- expect(companyPeopleDir("/hq", "indigo")).toBe(
345
- path.join("/hq", "companies", "indigo", "people"),
346
- );
347
- });
348
- });
349
-
350
- // ---------------------------------------------------------------------------
351
- // Membership roster fallback helpers
352
- // ---------------------------------------------------------------------------
353
-
354
- function rosterPerson(overrides: Partial<PersonRecord>): PersonRecord {
355
- return {
356
- slug: "ada-lovelace",
357
- name: "Ada Lovelace",
358
- email: "ada@acme.com",
359
- type: "internal",
360
- source: "test roster",
361
- ...overrides,
362
- };
363
- }
364
-
365
- describe("activeMemberToPersonRecord", () => {
366
- const base: ActiveMember = {
367
- membershipKey: "m_1",
368
- personUid: "prs_123",
369
- companyUid: "co_123",
370
- role: "admin",
371
- status: "active",
372
- };
373
-
374
- it("maps membership person fields into an internal person record", () => {
375
- expect(
376
- activeMemberToPersonRecord({
377
- ...base,
378
- personName: " Ada Lovelace ",
379
- personEmail: " ada@acme.com ",
380
- personSlug: " ada ",
381
- }),
382
- ).toEqual({
383
- slug: "ada",
384
- name: "Ada Lovelace",
385
- email: "ada@acme.com",
386
- role: "admin",
387
- type: "internal",
388
- source: "hq-pro membership: /membership/company/co_123",
389
- });
390
- });
391
-
392
- it("falls back from name to email to slug, and slugifies names", () => {
393
- expect(
394
- activeMemberToPersonRecord({
395
- ...base,
396
- personName: "Grace Hopper",
397
- personEmail: "grace@acme.com",
398
- }),
399
- ).toMatchObject({ name: "Grace Hopper", slug: "grace-hopper" });
400
-
401
- expect(
402
- activeMemberToPersonRecord({
403
- ...base,
404
- personEmail: "only-email@acme.com",
405
- }),
406
- ).toMatchObject({ name: "only-email@acme.com", slug: "only-email-acme-com" });
407
-
408
- expect(
409
- activeMemberToPersonRecord({
410
- ...base,
411
- personSlug: "only-slug",
412
- }),
413
- ).toMatchObject({ name: "only-slug", slug: "only-slug" });
414
- });
415
-
416
- it("returns null when all name-like fields are empty", () => {
417
- expect(
418
- activeMemberToPersonRecord({
419
- ...base,
420
- personName: " ",
421
- personEmail: "",
422
- personSlug: " ",
423
- }),
424
- ).toBeNull();
425
- });
426
- });
427
-
428
- describe("mergePeople", () => {
429
- it("deduplicates by email, slug, then name with primary records winning", () => {
430
- const primary = [
431
- rosterPerson({
432
- slug: "local-email",
433
- name: "Local Email",
434
- email: "same@acme.com",
435
- role: "CEO",
436
- }),
437
- rosterPerson({ slug: "same-slug", name: "Local Slug", email: undefined }),
438
- rosterPerson({ slug: "", name: "Same Name", email: undefined }),
439
- ];
440
- const extra = [
441
- rosterPerson({
442
- slug: "remote-email",
443
- name: "Remote Email",
444
- email: "SAME@acme.com",
445
- }),
446
- rosterPerson({ slug: "SAME-SLUG", name: "Remote Slug", email: undefined }),
447
- rosterPerson({ slug: "", name: "same name", email: undefined }),
448
- rosterPerson({ slug: "new-person", name: "New Person", email: undefined }),
449
- ];
450
-
451
- expect(mergePeople(primary, extra)).toEqual([
452
- ...primary,
453
- rosterPerson({ slug: "new-person", name: "New Person", email: undefined }),
454
- ]);
455
- });
456
- });
457
-
458
- // ---------------------------------------------------------------------------
459
- // Wired CLI surface (list / search / resolve)
460
- // ---------------------------------------------------------------------------
461
-
462
- function buildProgram(deps?: { fetchRoster?: FetchPeopleRoster }): Command {
463
- const program = new Command();
464
- program.exitOverride(); // throw instead of process.exit on commander errors
465
- registerPeopleCommand(program, deps);
466
- return program;
467
- }
468
-
469
- async function run(
470
- args: string[],
471
- deps: { fetchRoster?: FetchPeopleRoster } = {
472
- fetchRoster: async () => [],
473
- },
474
- ): Promise<void> {
475
- await buildProgram(deps).parseAsync(["node", "hq", ...args]);
476
- }
477
-
478
- describe("hq people (wired)", () => {
479
- let logSpy: ReturnType<typeof vi.spyOn>;
480
- let errSpy: ReturnType<typeof vi.spyOn>;
481
- let exitSpy: ReturnType<typeof vi.spyOn>;
482
-
483
- beforeEach(() => {
484
- writeCompaniesManifest({ acme: { status: "active" } });
485
- makePerson("acme", "jane-smith", {
486
- name: "Jane Smith",
487
- email: "jane@acme.com",
488
- role: "CEO",
489
- type: "internal",
490
- });
491
- makePerson("acme", "john-doe", {
492
- name: "John Doe",
493
- email: "john@acme.com",
494
- type: "internal",
495
- });
496
- logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
497
- errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
498
- exitSpy = vi.spyOn(process, "exit").mockImplementation(((): never => {
499
- throw new Error("__exit__");
500
- }) as never);
501
- });
502
-
503
- it("list --json emits both people", async () => {
504
- await run(["people", "list", "--company", "acme", "--hq-root", tmpRoot, "--json"]);
505
- const out = JSON.parse(logSpy.mock.calls[0][0] as string);
506
- expect(out.map((p: PersonRecord) => p.name).sort()).toEqual([
507
- "Jane Smith",
508
- "John Doe",
509
- ]);
510
- });
511
-
512
- it("list includes roster people, sorts them, and deduplicates with local winning", async () => {
513
- const fetchRoster = vi.fn<FetchPeopleRoster>(async () => [
514
- rosterPerson({
515
- slug: "remote-jane",
516
- name: "Remote Jane",
517
- email: "JANE@acme.com",
518
- role: "member",
519
- }),
520
- rosterPerson({
521
- slug: "ada-lovelace",
522
- name: "Ada Lovelace",
523
- email: "ada@acme.com",
524
- role: "admin",
525
- }),
526
- ]);
527
-
528
- await run(
529
- ["people", "list", "--company", "acme", "--hq-root", tmpRoot, "--json"],
530
- { fetchRoster },
531
- );
532
-
533
- expect(fetchRoster).toHaveBeenCalledTimes(1);
534
- expect(fetchRoster).toHaveBeenCalledWith(tmpRoot, "acme");
535
- const out = JSON.parse(logSpy.mock.calls[0][0] as string);
536
- expect(out.map((p: PersonRecord) => p.name)).toEqual([
537
- "Ada Lovelace",
538
- "Jane Smith",
539
- "John Doe",
540
- ]);
541
- expect(out.find((p: PersonRecord) => p.email === "jane@acme.com")).toMatchObject({
542
- name: "Jane Smith",
543
- role: "CEO",
544
- });
545
- });
546
-
547
- it("list --local-only skips roster fetch", async () => {
548
- const fetchRoster = vi.fn<FetchPeopleRoster>(async () => [
549
- rosterPerson({ slug: "ada-lovelace", name: "Ada Lovelace" }),
550
- ]);
551
-
552
- await run(
553
- [
554
- "people",
555
- "list",
556
- "--company",
557
- "acme",
558
- "--hq-root",
559
- tmpRoot,
560
- "--json",
561
- "--local-only",
562
- ],
563
- { fetchRoster },
564
- );
565
-
566
- expect(fetchRoster).not.toHaveBeenCalled();
567
- const out = JSON.parse(logSpy.mock.calls[0][0] as string);
568
- expect(out.map((p: PersonRecord) => p.name).sort()).toEqual([
569
- "Jane Smith",
570
- "John Doe",
571
- ]);
572
- });
573
-
574
- it("search narrows to the matching person", async () => {
575
- await run([
576
- "people",
577
- "search",
578
- "jane",
579
- "--company",
580
- "acme",
581
- "--hq-root",
582
- tmpRoot,
583
- "--json",
584
- ]);
585
- const out = JSON.parse(logSpy.mock.calls[0][0] as string);
586
- expect(out).toHaveLength(1);
587
- expect(out[0].email).toBe("jane@acme.com");
588
- });
589
-
590
- it("search local hit does not fetch the roster", async () => {
591
- const fetchRoster = vi.fn<FetchPeopleRoster>();
592
- await run(
593
- [
594
- "people",
595
- "search",
596
- "jane",
597
- "--company",
598
- "acme",
599
- "--hq-root",
600
- tmpRoot,
601
- "--json",
602
- ],
603
- { fetchRoster },
604
- );
605
- expect(fetchRoster).not.toHaveBeenCalled();
606
- });
607
-
608
- it("search finds a teammate from the roster on a local miss", async () => {
609
- const fetchRoster = vi.fn<FetchPeopleRoster>(async () => [
610
- rosterPerson({ slug: "ada-lovelace", name: "Ada Lovelace" }),
611
- ]);
612
-
613
- await run(
614
- [
615
- "people",
616
- "search",
617
- "ada",
618
- "--company",
619
- "acme",
620
- "--hq-root",
621
- tmpRoot,
622
- "--json",
623
- ],
624
- { fetchRoster },
625
- );
626
-
627
- expect(fetchRoster).toHaveBeenCalledTimes(1);
628
- expect(fetchRoster).toHaveBeenCalledWith(tmpRoot, "acme");
629
- const out = JSON.parse(logSpy.mock.calls[0][0] as string);
630
- expect(out).toHaveLength(1);
631
- expect(out[0]).toMatchObject({
632
- name: "Ada Lovelace",
633
- email: "ada@acme.com",
634
- });
635
- });
636
-
637
- it("search local miss with fetch failure reports the original empty JSON and logs a note", async () => {
638
- const fetchRoster = vi.fn<FetchPeopleRoster>(async () => {
639
- throw new Error("offline");
640
- });
641
-
642
- await run(
643
- [
644
- "people",
645
- "search",
646
- "ada",
647
- "--company",
648
- "acme",
649
- "--hq-root",
650
- tmpRoot,
651
- "--json",
652
- ],
653
- { fetchRoster },
654
- );
655
-
656
- expect(fetchRoster).toHaveBeenCalledTimes(1);
657
- expect(JSON.parse(logSpy.mock.calls[0][0] as string)).toEqual([]);
658
- expect(errSpy).toHaveBeenCalledWith(
659
- expect.stringContaining("Could not fetch people roster"),
660
- );
661
- });
662
-
663
- it("search --local-only skips fetch on a miss", async () => {
664
- const fetchRoster = vi.fn<FetchPeopleRoster>();
665
- await run(
666
- [
667
- "people",
668
- "search",
669
- "ada",
670
- "--company",
671
- "acme",
672
- "--hq-root",
673
- tmpRoot,
674
- "--json",
675
- "--local-only",
676
- ],
677
- { fetchRoster },
678
- );
679
-
680
- expect(fetchRoster).not.toHaveBeenCalled();
681
- expect(JSON.parse(logSpy.mock.calls[0][0] as string)).toEqual([]);
682
- });
683
-
684
- it("resolve prints the bare email on stdout", async () => {
685
- await run([
686
- "people",
687
- "resolve",
688
- "Jane Smith",
689
- "--company",
690
- "acme",
691
- "--hq-root",
692
- tmpRoot,
693
- ]);
694
- expect(logSpy).toHaveBeenCalledWith("jane@acme.com");
695
- });
696
-
697
- it("resolve local hit does not fetch the roster", async () => {
698
- const fetchRoster = vi.fn<FetchPeopleRoster>();
699
- await run(
700
- [
701
- "people",
702
- "resolve",
703
- "Jane Smith",
704
- "--company",
705
- "acme",
706
- "--hq-root",
707
- tmpRoot,
708
- ],
709
- { fetchRoster },
710
- );
711
- expect(fetchRoster).not.toHaveBeenCalled();
712
- });
713
-
714
- it("resolve finds a teammate that exists only in the fetched roster", async () => {
715
- const fetchRoster = vi.fn<FetchPeopleRoster>(async () => [
716
- rosterPerson({ slug: "ada-lovelace", name: "Ada Lovelace" }),
717
- ]);
718
-
719
- await run(
720
- [
721
- "people",
722
- "resolve",
723
- "Ada Lovelace",
724
- "--company",
725
- "acme",
726
- "--hq-root",
727
- tmpRoot,
728
- ],
729
- { fetchRoster },
730
- );
731
-
732
- expect(fetchRoster).toHaveBeenCalledTimes(1);
733
- expect(fetchRoster).toHaveBeenCalledWith(tmpRoot, "acme");
734
- expect(logSpy).toHaveBeenCalledWith("ada@acme.com");
735
- });
736
-
737
- it("resolve local miss with fetch failure reports unchanged not_found JSON and logs a note", async () => {
738
- const fetchRoster = vi.fn<FetchPeopleRoster>(async () => {
739
- throw new Error("not signed in");
740
- });
741
-
742
- await expect(
743
- run(
744
- [
745
- "people",
746
- "resolve",
747
- "Ada Lovelace",
748
- "--company",
749
- "acme",
750
- "--hq-root",
751
- tmpRoot,
752
- "--json",
753
- ],
754
- { fetchRoster },
755
- ),
756
- ).rejects.toThrow("__exit__");
757
-
758
- expect(fetchRoster).toHaveBeenCalledTimes(1);
759
- expect(JSON.parse(logSpy.mock.calls[0][0] as string)).toEqual({
760
- status: "not_found",
761
- });
762
- expect(errSpy).toHaveBeenCalledWith(
763
- expect.stringContaining("Could not fetch people roster"),
764
- );
765
- expect(exitSpy).toHaveBeenCalledWith(1);
766
- });
767
-
768
- it("resolve --local-only skips fetch on a miss", async () => {
769
- const fetchRoster = vi.fn<FetchPeopleRoster>();
770
- await expect(
771
- run(
772
- [
773
- "people",
774
- "resolve",
775
- "Ada Lovelace",
776
- "--company",
777
- "acme",
778
- "--hq-root",
779
- tmpRoot,
780
- "--json",
781
- "--local-only",
782
- ],
783
- { fetchRoster },
784
- ),
785
- ).rejects.toThrow("__exit__");
786
-
787
- expect(fetchRoster).not.toHaveBeenCalled();
788
- expect(JSON.parse(logSpy.mock.calls[0][0] as string)).toEqual({
789
- status: "not_found",
790
- });
791
- });
792
-
793
- it("resolve exits non-zero when not found", async () => {
794
- await expect(
795
- run([
796
- "people",
797
- "resolve",
798
- "Nobody",
799
- "--company",
800
- "acme",
801
- "--hq-root",
802
- tmpRoot,
803
- ]),
804
- ).rejects.toThrow("__exit__");
805
- expect(exitSpy).toHaveBeenCalledWith(1);
806
- });
807
- });