@indigoai-us/hq-cli 5.77.14 → 5.79.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 (309) hide show
  1. package/CHANGELOG.md +31 -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/meetings.js +16 -9
  31. package/dist/commands/members.js +16 -5
  32. package/dist/commands/pack-install.d.ts +14 -0
  33. package/dist/commands/pack-install.js +42 -2
  34. package/dist/commands/pkg-install.js +39 -2
  35. package/dist/commands/run.js +6 -2
  36. package/dist/commands/secrets.js +120 -65
  37. package/dist/main.js +6 -0
  38. package/dist/utils/api-key-command-gate.d.ts +45 -0
  39. package/dist/utils/api-key-command-gate.js +51 -0
  40. package/dist/utils/hq-roots.d.ts +91 -0
  41. package/dist/utils/hq-roots.js +212 -0
  42. package/dist/utils/resolve-vault-credential.d.ts +63 -3
  43. package/dist/utils/resolve-vault-credential.js +152 -6
  44. package/dist/utils/run-bundled-script.d.ts +66 -0
  45. package/dist/utils/run-bundled-script.js +80 -0
  46. package/dist/utils/vault-api.d.ts +21 -0
  47. package/dist/utils/vault-api.js +74 -3
  48. package/package.json +7 -1
  49. package/.claude/policies/hq-cli-interactive-reads-use-sts-vend.md +0 -49
  50. package/.github/workflows/ci.yml +0 -46
  51. package/.github/workflows/publish.yml +0 -36
  52. package/.github/workflows/scripts/smoke-test-pkg.sh +0 -97
  53. package/e2e/cli.test.ts +0 -128
  54. package/eslint.config.js +0 -37
  55. package/pnpm-workspace.yaml +0 -4
  56. package/scripts/chmod-bins.mjs +0 -49
  57. package/scripts/generate-dsn.mjs +0 -26
  58. package/scripts/generate-scan-packages-table.mjs +0 -113
  59. package/scripts/smoke-sources-signals.sh +0 -103
  60. package/src/bin/hq-auth-refresh.ts +0 -43
  61. package/src/cli-version.ts +0 -13
  62. package/src/commands/__fixtures__/make-tar.ts +0 -126
  63. package/src/commands/_patterns.ts +0 -10
  64. package/src/commands/add.ts +0 -75
  65. package/src/commands/agents.test.ts +0 -527
  66. package/src/commands/agents.ts +0 -923
  67. package/src/commands/api-keys.test.ts +0 -291
  68. package/src/commands/api-keys.ts +0 -382
  69. package/src/commands/artifact-verify.test.ts +0 -177
  70. package/src/commands/auth.test.ts +0 -82
  71. package/src/commands/auth.ts +0 -213
  72. package/src/commands/billing.test.ts +0 -158
  73. package/src/commands/billing.ts +0 -146
  74. package/src/commands/channels.test.ts +0 -74
  75. package/src/commands/channels.ts +0 -91
  76. package/src/commands/cloud-demote.test.ts +0 -401
  77. package/src/commands/cloud-demote.ts +0 -278
  78. package/src/commands/cloud-provision.test.ts +0 -1117
  79. package/src/commands/cloud-provision.ts +0 -942
  80. package/src/commands/cloud.pull-all.test.ts +0 -711
  81. package/src/commands/cloud.pull-per-company.test.ts +0 -188
  82. package/src/commands/cloud.push-all.test.ts +0 -485
  83. package/src/commands/cloud.scope-excluded-warning.test.ts +0 -22
  84. package/src/commands/cloud.selectors.test.ts +0 -208
  85. package/src/commands/cloud.status.test.ts +0 -160
  86. package/src/commands/cloud.test.ts +0 -41
  87. package/src/commands/cloud.ts +0 -2130
  88. package/src/commands/company.test.ts +0 -202
  89. package/src/commands/company.ts +0 -148
  90. package/src/commands/creators.test.ts +0 -60
  91. package/src/commands/creators.ts +0 -117
  92. package/src/commands/crm.test.ts +0 -179
  93. package/src/commands/crm.ts +0 -236
  94. package/src/commands/db-migrate.ts +0 -55
  95. package/src/commands/db-provision.ts +0 -114
  96. package/src/commands/db-sql.ts +0 -124
  97. package/src/commands/db-status.ts +0 -108
  98. package/src/commands/db.ts +0 -26
  99. package/src/commands/dm.test.ts +0 -748
  100. package/src/commands/dm.ts +0 -1226
  101. package/src/commands/feedback.test.ts +0 -413
  102. package/src/commands/feedback.ts +0 -169
  103. package/src/commands/files-browse.test.ts +0 -1249
  104. package/src/commands/files-browse.ts +0 -1506
  105. package/src/commands/files-delete.test.ts +0 -484
  106. package/src/commands/files-recovery.test.ts +0 -370
  107. package/src/commands/files.test.ts +0 -722
  108. package/src/commands/files.ts +0 -1446
  109. package/src/commands/group-grants.test.ts +0 -330
  110. package/src/commands/group-grants.ts +0 -455
  111. package/src/commands/groups.test.ts +0 -44
  112. package/src/commands/groups.ts +0 -368
  113. package/src/commands/integrations.test.ts +0 -633
  114. package/src/commands/integrations.ts +0 -507
  115. package/src/commands/list.ts +0 -85
  116. package/src/commands/login.ts +0 -52
  117. package/src/commands/logout.ts +0 -30
  118. package/src/commands/marketplace-install.test.ts +0 -543
  119. package/src/commands/marketplace-security.test.ts +0 -646
  120. package/src/commands/mcp-registration.test.ts +0 -2787
  121. package/src/commands/mcp-registration.ts +0 -2612
  122. package/src/commands/mcp-status.test.ts +0 -483
  123. package/src/commands/mcp-status.ts +0 -575
  124. package/src/commands/mcp-status.us011.test.ts +0 -243
  125. package/src/commands/meetings.test.ts +0 -522
  126. package/src/commands/meetings.ts +0 -789
  127. package/src/commands/members.test.ts +0 -1474
  128. package/src/commands/members.ts +0 -1181
  129. package/src/commands/onboard-identity-guard.test.ts +0 -99
  130. package/src/commands/onboard-identity-guard.ts +0 -103
  131. package/src/commands/onboard-join.test.ts +0 -96
  132. package/src/commands/onboard-join.ts +0 -101
  133. package/src/commands/onboard-warning.test.ts +0 -26
  134. package/src/commands/onboard-warning.ts +0 -12
  135. package/src/commands/onboard.ts +0 -267
  136. package/src/commands/outposts-heartbeat.test.ts +0 -299
  137. package/src/commands/outposts-heartbeat.ts +0 -310
  138. package/src/commands/outposts-replica-sync.test.ts +0 -272
  139. package/src/commands/outposts-self-deploy.test.ts +0 -243
  140. package/src/commands/outposts.test.ts +0 -1039
  141. package/src/commands/outposts.ts +0 -1935
  142. package/src/commands/pack-install-secret-authorization.test.ts +0 -115
  143. package/src/commands/pack-install.test.ts +0 -1469
  144. package/src/commands/pack-install.ts +0 -2256
  145. package/src/commands/pack-update-cache.test.ts +0 -149
  146. package/src/commands/packs-update-api-key.test.ts +0 -105
  147. package/src/commands/packs.test.ts +0 -88
  148. package/src/commands/packs.ts +0 -622
  149. package/src/commands/people.test.ts +0 -807
  150. package/src/commands/people.ts +0 -422
  151. package/src/commands/pkg-install.dispatch.test.ts +0 -103
  152. package/src/commands/pkg-install.ts +0 -221
  153. package/src/commands/pkg-list.test.ts +0 -79
  154. package/src/commands/pkg-list.ts +0 -13
  155. package/src/commands/pkg-remove.ts +0 -71
  156. package/src/commands/pkg-update.ts +0 -189
  157. package/src/commands/publish.test.ts +0 -650
  158. package/src/commands/publish.ts +0 -580
  159. package/src/commands/reindex.test.ts +0 -259
  160. package/src/commands/reindex.ts +0 -274
  161. package/src/commands/rescue.test.ts +0 -39
  162. package/src/commands/rescue.ts +0 -210
  163. package/src/commands/run.env-local.test.ts +0 -88
  164. package/src/commands/run.test.ts +0 -45
  165. package/src/commands/run.ts +0 -190
  166. package/src/commands/safe-extract.test.ts +0 -459
  167. package/src/commands/safe-extract.ts +0 -444
  168. package/src/commands/secrets-scope.test.ts +0 -56
  169. package/src/commands/secrets-scope.ts +0 -32
  170. package/src/commands/secrets.parse-destination.test.ts +0 -38
  171. package/src/commands/secrets.test.ts +0 -2050
  172. package/src/commands/secrets.ts +0 -2249
  173. package/src/commands/signals.ts +0 -351
  174. package/src/commands/skill.test.ts +0 -770
  175. package/src/commands/skill.ts +0 -796
  176. package/src/commands/sources.ts +0 -362
  177. package/src/commands/sync-mode.test.ts +0 -366
  178. package/src/commands/sync-mode.ts +0 -387
  179. package/src/commands/sync-narrow.test.ts +0 -633
  180. package/src/commands/sync-narrow.ts +0 -555
  181. package/src/commands/sync.ts +0 -165
  182. package/src/commands/team-sync.ts +0 -628
  183. package/src/commands/update.ts +0 -71
  184. package/src/commands/whoami.ts +0 -83
  185. package/src/commands/workers.test.ts +0 -158
  186. package/src/commands/workers.ts +0 -301
  187. package/src/index.test.ts +0 -32
  188. package/src/index.ts +0 -20
  189. package/src/lib/db/control-plane.test.ts +0 -59
  190. package/src/lib/db/control-plane.ts +0 -113
  191. package/src/lib/db/local.test.ts +0 -81
  192. package/src/lib/db/local.ts +0 -148
  193. package/src/lib/db/migrate.test.ts +0 -133
  194. package/src/lib/db/migrate.ts +0 -137
  195. package/src/lib/db/paths.test.ts +0 -112
  196. package/src/lib/db/paths.ts +0 -128
  197. package/src/lib/db/remote-engine.test.ts +0 -44
  198. package/src/lib/db/remote-engine.ts +0 -148
  199. package/src/lib/db/remote-sql.test.ts +0 -32
  200. package/src/lib/db/remote-sql.ts +0 -62
  201. package/src/lib/db/sql.test.ts +0 -106
  202. package/src/lib/db/sql.ts +0 -192
  203. package/src/lib/hq-cloud-dep.smoke.test.ts +0 -75
  204. package/src/lib/local-tree-diff.test.ts +0 -301
  205. package/src/lib/local-tree-diff.ts +0 -362
  206. package/src/lib/narrow-hint-banner.test.ts +0 -235
  207. package/src/lib/narrow-hint-banner.ts +0 -212
  208. package/src/lib/plan-limit-nag.test.ts +0 -317
  209. package/src/lib/plan-limit-nag.ts +0 -264
  210. package/src/main.ts +0 -371
  211. package/src/node-preflight.test.ts +0 -60
  212. package/src/node-preflight.ts +0 -67
  213. package/src/outpost/session-heartbeat-bounds.test.ts +0 -195
  214. package/src/outpost/session-heartbeat-guard.test.ts +0 -105
  215. package/src/outpost/session-heartbeat-publisher.test.ts +0 -178
  216. package/src/outpost/session-heartbeat-publisher.ts +0 -186
  217. package/src/outpost/session-heartbeat-retain-guard.test.ts +0 -126
  218. package/src/outpost/session-heartbeat.test.ts +0 -459
  219. package/src/outpost/session-heartbeat.ts +0 -877
  220. package/src/packaging.test.ts +0 -109
  221. package/src/run/__fixtures__/discover-schemas/example.env.schema +0 -4
  222. package/src/run/discover-schemas.test.ts +0 -153
  223. package/src/run/discover-schemas.ts +0 -79
  224. package/src/run/hq-plugin.test.ts +0 -371
  225. package/src/run/hq-plugin.ts +0 -277
  226. package/src/run/varlock-shape.test.ts +0 -57
  227. package/src/schemas/hq-package.schema.json +0 -155
  228. package/src/sentry-before-send.test.ts +0 -359
  229. package/src/sentry-before-send.ts +0 -221
  230. package/src/sentry-epipe.test.ts +0 -37
  231. package/src/sentry-release.test.ts +0 -54
  232. package/src/sentry.test.ts +0 -24
  233. package/src/sentry.ts +0 -54
  234. package/src/strategies/link.ts +0 -62
  235. package/src/strategies/merge.ts +0 -142
  236. package/src/types.ts +0 -146
  237. package/src/utils/__fixtures__/scan-packages.generated-block.sh +0 -23
  238. package/src/utils/auth-error.test.ts +0 -40
  239. package/src/utils/auth-error.ts +0 -42
  240. package/src/utils/billing-gate.test.ts +0 -95
  241. package/src/utils/billing-gate.ts +0 -228
  242. package/src/utils/breadcrumb-buffer.ts +0 -18
  243. package/src/utils/cli-telemetry.test.ts +0 -153
  244. package/src/utils/cli-telemetry.ts +0 -61
  245. package/src/utils/cognito-session.machine.test.ts +0 -109
  246. package/src/utils/cognito-session.refresh.test.ts +0 -84
  247. package/src/utils/cognito-session.test.ts +0 -328
  248. package/src/utils/cognito-session.ts +0 -448
  249. package/src/utils/company-selection-error.test.ts +0 -42
  250. package/src/utils/company-selection-error.ts +0 -45
  251. package/src/utils/contribution-table.ts +0 -83
  252. package/src/utils/environmental-error.test.ts +0 -45
  253. package/src/utils/environmental-error.ts +0 -39
  254. package/src/utils/epipe.test.ts +0 -28
  255. package/src/utils/epipe.ts +0 -29
  256. package/src/utils/expected-cli-error.test.ts +0 -28
  257. package/src/utils/expected-cli-error.ts +0 -39
  258. package/src/utils/feedback-diagnostics.test.ts +0 -183
  259. package/src/utils/feedback-diagnostics.ts +0 -123
  260. package/src/utils/feedback-screenshots.test.ts +0 -134
  261. package/src/utils/feedback-screenshots.ts +0 -124
  262. package/src/utils/feedback-versions.test.ts +0 -98
  263. package/src/utils/feedback-versions.ts +0 -68
  264. package/src/utils/git.ts +0 -74
  265. package/src/utils/integrity.ts +0 -59
  266. package/src/utils/intercepted-process-exit.test.ts +0 -37
  267. package/src/utils/intercepted-process-exit.ts +0 -36
  268. package/src/utils/login-provider.test.ts +0 -42
  269. package/src/utils/login-provider.ts +0 -30
  270. package/src/utils/manifest.test.ts +0 -167
  271. package/src/utils/manifest.ts +0 -131
  272. package/src/utils/pack-contributions.test.ts +0 -603
  273. package/src/utils/pack-contributions.ts +0 -450
  274. package/src/utils/people.ts +0 -215
  275. package/src/utils/registry-client.ts +0 -204
  276. package/src/utils/registry.ts +0 -90
  277. package/src/utils/resolve-vault-credential.test.ts +0 -69
  278. package/src/utils/resolve-vault-credential.ts +0 -60
  279. package/src/utils/sandbox-runner-client.test.ts +0 -279
  280. package/src/utils/sandbox-runner-client.ts +0 -260
  281. package/src/utils/secrets-cache.ts +0 -183
  282. package/src/utils/sentry-identity.ts +0 -45
  283. package/src/utils/settle-with-timeout.test.ts +0 -21
  284. package/src/utils/settle-with-timeout.ts +0 -22
  285. package/src/utils/user-yaml-error.test.ts +0 -24
  286. package/src/utils/user-yaml-error.ts +0 -30
  287. package/src/utils/vault-api.test.ts +0 -536
  288. package/src/utils/vault-api.ts +0 -382
  289. package/src/utils/version-check.test.ts +0 -176
  290. package/src/utils/version-check.ts +0 -155
  291. package/src/utils/version-gate.test.ts +0 -1024
  292. package/src/utils/version-gate.ts +0 -702
  293. package/test/commands/db-tenant-isolation.test.ts +0 -94
  294. package/test/commands/db.test.ts +0 -85
  295. package/test/commands/signals.test.ts +0 -207
  296. package/test/commands/sources.test.ts +0 -231
  297. package/test/e2e/smoke-install-mcp.sh +0 -113
  298. package/test/fixtures/hq-pack-smoke-mcp/mcp/smoke-http.json +0 -1
  299. package/test/fixtures/hq-pack-smoke-mcp/package.yaml +0 -11
  300. package/test/fixtures/signals/action_item/sample.md +0 -16
  301. package/test/fixtures/signals/summary/sample.md +0 -12
  302. package/test/fixtures/sources/meetings/sample.md +0 -25
  303. package/test/helpers/cli-runner.ts +0 -150
  304. package/test/helpers/s3-list-mock.ts +0 -79
  305. package/test/helpers/vault-service-mock.ts +0 -295
  306. package/test/sources-signals/smoke.test.ts +0 -228
  307. package/tsconfig.json +0 -20
  308. package/vitest.config.ts +0 -11
  309. 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
- });