@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,401 +0,0 @@
1
- /**
2
- * Unit tests for `hq cloud demote company <slug>` (cloud-demote.ts).
3
- *
4
- * Mirrors the cloud-provision test layout: tmp HQ root per test, helpers
5
- * seed manifests + company yaml + .hq/config.json, then the orchestrator
6
- * runs with an injected `findCompanyBySlug`.
7
- *
8
- * Coverage:
9
- * - flipCompanyYamlCloudOff — atomic mutation, preserves other keys
10
- * - stripManifestCloudForSlug — removes cloud_uid + bucket_name only
11
- * - demoteCompany — full orchestrator (verify + side-effects + JSON shape)
12
- */
13
-
14
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
15
- import * as fs from "node:fs";
16
- import * as os from "node:os";
17
- import * as path from "node:path";
18
- import * as yaml from "js-yaml";
19
-
20
- import {
21
- ProvisionError,
22
- manifestPath,
23
- companyDirPath,
24
- companyConfigPath,
25
- type VaultEntity,
26
- } from "./cloud-provision.js";
27
- import {
28
- demoteCompany,
29
- flipCompanyYamlCloudOff,
30
- stripManifestCloudForSlug,
31
- type DemoteResult,
32
- } from "./cloud-demote.js";
33
-
34
- // ── Test fixtures ────────────────────────────────────────────────────────────
35
-
36
- let tmpRoot: string;
37
-
38
- function seedManifest(
39
- root: string,
40
- companies: Record<string, Record<string, unknown> | null> = {
41
- acme: {
42
- name: "Acme",
43
- cloud_uid: "cmp_old",
44
- bucket_name: "hq-vault-cmp-old",
45
- status: "active",
46
- },
47
- },
48
- ): void {
49
- const mPath = manifestPath(root);
50
- fs.mkdirSync(path.dirname(mPath), { recursive: true });
51
- fs.writeFileSync(mPath, yaml.dump({ companies }));
52
- }
53
-
54
- function seedCompanyDir(root: string, slug: string, yamlBody?: string): void {
55
- const dir = companyDirPath(root, slug);
56
- fs.mkdirSync(dir, { recursive: true });
57
- if (yamlBody !== undefined) {
58
- fs.writeFileSync(path.join(dir, "company.yaml"), yamlBody);
59
- }
60
- }
61
-
62
- function seedCompanyConfig(root: string, slug: string): void {
63
- const cPath = companyConfigPath(root, slug);
64
- fs.mkdirSync(path.dirname(cPath), { recursive: true });
65
- fs.writeFileSync(
66
- cPath,
67
- JSON.stringify(
68
- {
69
- companyUid: "cmp_old",
70
- companySlug: slug,
71
- bucketName: "hq-vault-cmp-old",
72
- vaultApiUrl: "https://v",
73
- },
74
- null,
75
- 2,
76
- ),
77
- );
78
- }
79
-
80
- function readManifest(root: string): { companies?: Record<string, unknown> } {
81
- return yaml.load(fs.readFileSync(manifestPath(root), "utf-8")) as {
82
- companies?: Record<string, unknown>;
83
- };
84
- }
85
-
86
- function readCompanyYaml(root: string, slug: string): Record<string, unknown> {
87
- return yaml.load(
88
- fs.readFileSync(path.join(companyDirPath(root, slug), "company.yaml"), "utf-8"),
89
- ) as Record<string, unknown>;
90
- }
91
-
92
- beforeEach(() => {
93
- tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "hq-demote-test-"));
94
- });
95
-
96
- afterEach(() => {
97
- fs.rmSync(tmpRoot, { recursive: true, force: true });
98
- vi.restoreAllMocks();
99
- });
100
-
101
- // ── flipCompanyYamlCloudOff ──────────────────────────────────────────────────
102
-
103
- describe("flipCompanyYamlCloudOff", () => {
104
- it("flips cloud: true → false and preserves other keys", () => {
105
- seedCompanyDir(tmpRoot, "acme", "cloud: true\nname: Acme\nfoo: bar\n");
106
- const changed = flipCompanyYamlCloudOff(tmpRoot, "acme");
107
- expect(changed).toBe(true);
108
- const after = readCompanyYaml(tmpRoot, "acme");
109
- expect(after.cloud).toBe(false);
110
- expect(after.name).toBe("Acme");
111
- expect(after.foo).toBe("bar");
112
- });
113
-
114
- it("is idempotent when cloud is already false", () => {
115
- seedCompanyDir(tmpRoot, "acme", "cloud: false\nname: Acme\n");
116
- const changed = flipCompanyYamlCloudOff(tmpRoot, "acme");
117
- expect(changed).toBe(false);
118
- expect(readCompanyYaml(tmpRoot, "acme").cloud).toBe(false);
119
- });
120
-
121
- it("inserts cloud: false when the field is missing", () => {
122
- seedCompanyDir(tmpRoot, "acme", "name: Acme\n");
123
- const changed = flipCompanyYamlCloudOff(tmpRoot, "acme");
124
- expect(changed).toBe(true);
125
- expect(readCompanyYaml(tmpRoot, "acme").cloud).toBe(false);
126
- });
127
-
128
- it("returns false when company.yaml does not exist", () => {
129
- seedCompanyDir(tmpRoot, "acme"); // no yaml
130
- const changed = flipCompanyYamlCloudOff(tmpRoot, "acme");
131
- expect(changed).toBe(false);
132
- });
133
-
134
- it("does not leave a .tmp file behind on success", () => {
135
- seedCompanyDir(tmpRoot, "acme", "cloud: true\n");
136
- flipCompanyYamlCloudOff(tmpRoot, "acme");
137
- const dir = companyDirPath(tmpRoot, "acme");
138
- const tmps = fs.readdirSync(dir).filter((f) => f.includes(".tmp."));
139
- expect(tmps).toEqual([]);
140
- });
141
- });
142
-
143
- // ── stripManifestCloudForSlug ────────────────────────────────────────────────
144
-
145
- describe("stripManifestCloudForSlug", () => {
146
- it("removes cloud_uid + bucket_name from the slug entry", () => {
147
- seedManifest(tmpRoot);
148
- const changed = stripManifestCloudForSlug(tmpRoot, "acme");
149
- expect(changed).toBe(true);
150
- const m = readManifest(tmpRoot);
151
- const entry = m.companies?.acme as Record<string, unknown>;
152
- expect(entry.cloud_uid).toBeUndefined();
153
- expect(entry.bucket_name).toBeUndefined();
154
- // Other fields preserved.
155
- expect(entry.name).toBe("Acme");
156
- expect(entry.status).toBe("active");
157
- });
158
-
159
- it("preserves other companies untouched", () => {
160
- seedManifest(tmpRoot, {
161
- acme: { cloud_uid: "cmp_a", bucket_name: "b-a" },
162
- voyage: { cloud_uid: "cmp_v", bucket_name: "b-v" },
163
- });
164
- stripManifestCloudForSlug(tmpRoot, "acme");
165
- const m = readManifest(tmpRoot);
166
- const voyage = m.companies?.voyage as Record<string, unknown>;
167
- expect(voyage.cloud_uid).toBe("cmp_v");
168
- expect(voyage.bucket_name).toBe("b-v");
169
- });
170
-
171
- it("is idempotent — second call reports no change", () => {
172
- seedManifest(tmpRoot, { acme: { name: "Acme" } });
173
- expect(stripManifestCloudForSlug(tmpRoot, "acme")).toBe(false);
174
- });
175
-
176
- it("returns false when the manifest does not exist", () => {
177
- // No seed.
178
- expect(stripManifestCloudForSlug(tmpRoot, "acme")).toBe(false);
179
- });
180
-
181
- it("returns false when the slug is missing from the manifest", () => {
182
- seedManifest(tmpRoot, { other: { cloud_uid: "x" } });
183
- expect(stripManifestCloudForSlug(tmpRoot, "acme")).toBe(false);
184
- });
185
- });
186
-
187
- // ── demoteCompany orchestrator ───────────────────────────────────────────────
188
-
189
- function tombstonedEntity(slug: string): VaultEntity {
190
- return {
191
- uid: "cmp_old",
192
- type: "company",
193
- slug,
194
- name: slug,
195
- bucketName: "hq-vault-cmp-old",
196
- status: "active",
197
- // @ts-expect-error — `deleted` is added on hq-pro side; VaultEntity
198
- // doesn't declare it, but the verify path reads it dynamically.
199
- deleted: true,
200
- };
201
- }
202
-
203
- function liveEntity(slug: string): VaultEntity {
204
- return {
205
- uid: "cmp_old",
206
- type: "company",
207
- slug,
208
- name: slug,
209
- bucketName: "hq-vault-cmp-old",
210
- status: "active",
211
- };
212
- }
213
-
214
- describe("demoteCompany — happy path", () => {
215
- it("removes config, flips yaml, strips manifest, returns full result", async () => {
216
- seedManifest(tmpRoot);
217
- seedCompanyDir(tmpRoot, "acme", "cloud: true\nname: Acme\n");
218
- seedCompanyConfig(tmpRoot, "acme");
219
-
220
- const result: DemoteResult = await demoteCompany({
221
- slug: "acme",
222
- hqRoot: tmpRoot,
223
- vaultApiUrl: "https://v",
224
- vaultClient: {
225
- findCompanyBySlug: async () => tombstonedEntity("acme"),
226
- // unused on the demote path, but the type requires it
227
- createCompanyEntity: async () => {
228
- throw new Error("must not call createCompanyEntity from demote");
229
- },
230
- },
231
- resolveAccessToken: async () => "tok",
232
- });
233
-
234
- expect(result).toEqual<DemoteResult>({
235
- ok: true,
236
- company_slug: "acme",
237
- config_removed: true,
238
- yaml_flipped: true,
239
- manifest_stripped: true,
240
- cloud_was_deleted: true,
241
- });
242
-
243
- // Side-effects landed.
244
- expect(fs.existsSync(companyConfigPath(tmpRoot, "acme"))).toBe(false);
245
- expect(readCompanyYaml(tmpRoot, "acme").cloud).toBe(false);
246
- const entry = readManifest(tmpRoot).companies?.acme as Record<string, unknown>;
247
- expect(entry.cloud_uid).toBeUndefined();
248
- expect(entry.bucket_name).toBeUndefined();
249
- });
250
-
251
- it("is idempotent — re-running on an already-demoted company is a no-op", async () => {
252
- // Already in post-demote state.
253
- seedManifest(tmpRoot, { acme: { name: "Acme" } });
254
- seedCompanyDir(tmpRoot, "acme", "cloud: false\nname: Acme\n");
255
-
256
- const result = await demoteCompany({
257
- slug: "acme",
258
- hqRoot: tmpRoot,
259
- vaultApiUrl: "https://v",
260
- vaultClient: {
261
- findCompanyBySlug: async () => tombstonedEntity("acme"),
262
- createCompanyEntity: async () => {
263
- throw new Error("unused");
264
- },
265
- },
266
- resolveAccessToken: async () => "tok",
267
- });
268
-
269
- expect(result.ok).toBe(true);
270
- expect(result.config_removed).toBe(false);
271
- expect(result.yaml_flipped).toBe(false);
272
- expect(result.manifest_stripped).toBe(false);
273
- });
274
- });
275
-
276
- describe("demoteCompany — safety check", () => {
277
- it("refuses to demote when the cloud entity is NOT deleted (no --force)", async () => {
278
- seedManifest(tmpRoot);
279
- seedCompanyDir(tmpRoot, "acme", "cloud: true\nname: Acme\n");
280
- seedCompanyConfig(tmpRoot, "acme");
281
-
282
- await expect(
283
- demoteCompany({
284
- slug: "acme",
285
- hqRoot: tmpRoot,
286
- vaultApiUrl: "https://v",
287
- vaultClient: {
288
- findCompanyBySlug: async () => liveEntity("acme"),
289
- createCompanyEntity: async () => {
290
- throw new Error("unused");
291
- },
292
- },
293
- resolveAccessToken: async () => "tok",
294
- }),
295
- ).rejects.toMatchObject({
296
- code: 2,
297
- message: expect.stringMatching(/not.*deleted/i),
298
- });
299
-
300
- // No side-effects.
301
- expect(fs.existsSync(companyConfigPath(tmpRoot, "acme"))).toBe(true);
302
- expect(readCompanyYaml(tmpRoot, "acme").cloud).toBe(true);
303
- });
304
-
305
- it("refuses to demote when the cloud entity does not exist (no --force)", async () => {
306
- seedManifest(tmpRoot);
307
- seedCompanyDir(tmpRoot, "acme", "cloud: true\nname: Acme\n");
308
- seedCompanyConfig(tmpRoot, "acme");
309
-
310
- await expect(
311
- demoteCompany({
312
- slug: "acme",
313
- hqRoot: tmpRoot,
314
- vaultApiUrl: "https://v",
315
- vaultClient: {
316
- findCompanyBySlug: async () => null,
317
- createCompanyEntity: async () => {
318
- throw new Error("unused");
319
- },
320
- },
321
- resolveAccessToken: async () => "tok",
322
- }),
323
- ).rejects.toMatchObject({ code: 2 });
324
- });
325
-
326
- it("--force skips the verify and demotes anyway, recording cloud_was_deleted=null", async () => {
327
- seedManifest(tmpRoot);
328
- seedCompanyDir(tmpRoot, "acme", "cloud: true\nname: Acme\n");
329
- seedCompanyConfig(tmpRoot, "acme");
330
-
331
- const find = vi.fn(async () => liveEntity("acme"));
332
- const result = await demoteCompany({
333
- slug: "acme",
334
- hqRoot: tmpRoot,
335
- vaultApiUrl: "https://v",
336
- force: true,
337
- vaultClient: {
338
- findCompanyBySlug: find,
339
- createCompanyEntity: async () => {
340
- throw new Error("unused");
341
- },
342
- },
343
- resolveAccessToken: async () => "tok",
344
- });
345
-
346
- expect(result.ok).toBe(true);
347
- expect(result.cloud_was_deleted).toBeNull();
348
- // --force MUST skip the network call entirely.
349
- expect(find).not.toHaveBeenCalled();
350
- });
351
-
352
- it("validateSlug rejects bad slugs with code 2", async () => {
353
- await expect(
354
- demoteCompany({
355
- slug: "personal", // reserved
356
- hqRoot: tmpRoot,
357
- vaultApiUrl: "https://v",
358
- force: true,
359
- vaultClient: {
360
- findCompanyBySlug: async () => null,
361
- createCompanyEntity: async () => {
362
- throw new Error("unused");
363
- },
364
- },
365
- resolveAccessToken: async () => "tok",
366
- }),
367
- ).rejects.toBeInstanceOf(ProvisionError);
368
- });
369
-
370
- it("--force on a slug missing from the manifest throws code 2 (no silent no-op)", async () => {
371
- seedManifest(tmpRoot, { other: { name: "Other" } });
372
- seedCompanyDir(tmpRoot, "acme", "cloud: true\n");
373
- await expect(
374
- demoteCompany({
375
- slug: "acme",
376
- hqRoot: tmpRoot,
377
- vaultApiUrl: "https://v",
378
- force: true,
379
- }),
380
- ).rejects.toMatchObject({
381
- code: 2,
382
- message: expect.stringMatching(/not found.*manifest/i),
383
- });
384
- });
385
-
386
- it("--force when company directory is missing throws code 2 (no silent no-op)", async () => {
387
- seedManifest(tmpRoot); // seeds acme entry
388
- // No seedCompanyDir — directory is missing.
389
- await expect(
390
- demoteCompany({
391
- slug: "acme",
392
- hqRoot: tmpRoot,
393
- vaultApiUrl: "https://v",
394
- force: true,
395
- }),
396
- ).rejects.toMatchObject({
397
- code: 2,
398
- message: expect.stringMatching(/does not exist/i),
399
- });
400
- });
401
- });
@@ -1,278 +0,0 @@
1
- /**
2
- * `hq cloud demote company <slug>` — convert a cloud-backed company back to
3
- * local-only after hq-pro has soft-tombstoned its entity (Settings → Delete
4
- * company in hq-console).
5
- *
6
- * Inverse of `hq cloud provision company <slug>`. Both commands live here in
7
- * hq-cli so the file-touching contract (manifest patch + per-folder config
8
- * write + company.yaml mutation) is single-sourced. AppBar HQ Sync's Path A
9
- * shells out to this command on the `deleted=true` branch instead of
10
- * re-implementing the file mutations in Rust.
11
- *
12
- * Side-effects (all atomic + idempotent):
13
- * 1. Remove `companies/<slug>/.hq/config.json`.
14
- * 2. Flip `cloud: true → false` in `companies/<slug>/company.yaml`. Without
15
- * this flip the next `provisionCompany` would re-mint a fresh cloud
16
- * company — exactly what the user just deleted.
17
- * 3. Strip `cloud_uid` + `bucket_name` from `companies/manifest.yaml`'s
18
- * `companies.<slug>` entry. The slug entry + other fields stay.
19
- *
20
- * Safety check (default on): `findCompanyBySlug` MUST return an entity with
21
- * `deleted: true`. A live entity, or no entity at all, refuses with code 2.
22
- * `--force` skips the network call (AppBar passes it because Path A just
23
- * checked).
24
- *
25
- * Exit codes (mirrors cloud-provision):
26
- * 0 — success or idempotent no-op.
27
- * 1 — vault HTTP failure during the safety check.
28
- * 2 — validation (bad slug, missing dir/manifest, cloud not deleted).
29
- */
30
-
31
- import * as fs from "node:fs";
32
- import * as path from "node:path";
33
- import * as yaml from "js-yaml";
34
- import { parseUserYaml } from "../utils/user-yaml-error.js";
35
- import { Command } from "commander";
36
- import chalk from "chalk";
37
-
38
- import {
39
- ProvisionError,
40
- companyConfigPath,
41
- companyDirPath,
42
- createDefaultVaultClient,
43
- manifestPath,
44
- validateManifestAndDir,
45
- validateSlug,
46
- type VaultClient,
47
- } from "./cloud-provision.js";
48
- import {
49
- DEFAULT_HQ_ROOT,
50
- DEFAULT_VAULT_API_URL,
51
- ensureCognitoToken,
52
- } from "../utils/cognito-session.js";
53
-
54
- // ── Types ────────────────────────────────────────────────────────────────────
55
-
56
- /** Final stdout JSON shape. AppBar parses this. */
57
- export interface DemoteResult {
58
- ok: boolean;
59
- company_slug: string;
60
- /** True if `.hq/config.json` was actually deleted (false if absent). */
61
- config_removed: boolean;
62
- /** True if `company.yaml`'s `cloud` was changed (true→false or absent→false). */
63
- yaml_flipped: boolean;
64
- /** True if manifest had `cloud_uid` / `bucket_name` to strip. */
65
- manifest_stripped: boolean;
66
- /**
67
- * `true` when the cloud entity verified as `deleted=true`. `null` when
68
- * `--force` was used and the verify was skipped. (`false` is unreachable —
69
- * a non-deleted entity throws code 2 before reaching the result.)
70
- */
71
- cloud_was_deleted: boolean | null;
72
- }
73
-
74
- export interface DemoteCompanyOptions {
75
- slug: string;
76
- hqRoot: string;
77
- vaultApiUrl: string;
78
- /** Skip the `findCompanyBySlug` safety check. AppBar uses this. */
79
- force?: boolean;
80
- /** Injected vault HTTP client (override for tests). */
81
- vaultClient?: VaultClient;
82
- /** Injected access-token resolver (override for tests). */
83
- resolveAccessToken?: () => Promise<string>;
84
- }
85
-
86
- // ── Helpers ──────────────────────────────────────────────────────────────────
87
-
88
- /**
89
- * Flip `cloud: true → false` in `companies/<slug>/company.yaml`. All other
90
- * keys + ordering preserved (js-yaml round-trip). Atomic (tmp + rename).
91
- *
92
- * Returns true if the file was changed, false if no-op (file missing, or
93
- * `cloud` was already `false`).
94
- *
95
- * NOTE: js-yaml doesn't preserve comments, but this matches what
96
- * `patchManifest` already does — accepted trade-off.
97
- */
98
- export function flipCompanyYamlCloudOff(hqRoot: string, slug: string): boolean {
99
- const yPath = path.join(companyDirPath(hqRoot, slug), "company.yaml");
100
- if (!fs.existsSync(yPath)) return false;
101
- const raw = fs.readFileSync(yPath, "utf-8");
102
- const parsed = parseUserYaml<Record<string, unknown> | null>(raw, yPath) ?? {};
103
- if (parsed.cloud === false) return false;
104
- parsed.cloud = false;
105
- const dump = yaml.dump(parsed, { lineWidth: -1, noRefs: true });
106
- const tmp = `${yPath}.tmp.${process.pid}`;
107
- fs.writeFileSync(tmp, dump);
108
- fs.renameSync(tmp, yPath);
109
- return true;
110
- }
111
-
112
- /**
113
- * Remove `cloud_uid` + `bucket_name` from `companies.<slug>` in
114
- * `companies/manifest.yaml`. The slug entry is preserved (other fields like
115
- * `name`/`status`/`path` stay). Atomic (tmp + rename).
116
- *
117
- * Returns true if the file was changed, false if no-op (manifest missing,
118
- * slug missing, or both fields already absent).
119
- */
120
- export function stripManifestCloudForSlug(hqRoot: string, slug: string): boolean {
121
- const mPath = manifestPath(hqRoot);
122
- if (!fs.existsSync(mPath)) return false;
123
- const raw = fs.readFileSync(mPath, "utf-8");
124
- const parsed = parseUserYaml<{ companies?: Record<string, unknown> } | null>(raw, mPath) ?? {};
125
- const companies = parsed.companies;
126
- if (!companies || !(slug in companies)) return false;
127
- const entry = companies[slug];
128
- if (!entry || typeof entry !== "object") return false;
129
- const obj = entry as Record<string, unknown>;
130
- const hadCloudUid = "cloud_uid" in obj;
131
- const hadBucketName = "bucket_name" in obj;
132
- if (!hadCloudUid && !hadBucketName) return false;
133
- delete obj.cloud_uid;
134
- delete obj.bucket_name;
135
- const dump = yaml.dump(parsed, { lineWidth: -1, noRefs: true });
136
- const tmp = `${mPath}.tmp.${process.pid}`;
137
- fs.writeFileSync(tmp, dump);
138
- fs.renameSync(tmp, mPath);
139
- return true;
140
- }
141
-
142
- // ── Orchestrator ─────────────────────────────────────────────────────────────
143
-
144
- /**
145
- * Run the full demote flow. Returns a `DemoteResult` on success; throws
146
- * `ProvisionError` (codes 1 or 2) on any failure.
147
- */
148
- export async function demoteCompany(
149
- options: DemoteCompanyOptions,
150
- ): Promise<DemoteResult> {
151
- validateSlug(options.slug);
152
- // Fails with code 2 if the manifest is missing/malformed, the slug is not
153
- // present under `.companies`, or `companies/<slug>/` doesn't exist on disk.
154
- // Without this, a `--force` demote against a missing or renamed slug would
155
- // be a silent no-op (all helpers return false but we'd still report ok=true).
156
- validateManifestAndDir(options.hqRoot, options.slug);
157
-
158
- let cloudWasDeleted: boolean | null = null;
159
-
160
- if (!options.force) {
161
- const accessToken = options.resolveAccessToken
162
- ? await options.resolveAccessToken()
163
- : await ensureCognitoToken();
164
- const client =
165
- options.vaultClient ??
166
- createDefaultVaultClient(options.vaultApiUrl, accessToken);
167
- let entity;
168
- try {
169
- entity = await client.findCompanyBySlug(options.slug);
170
- } catch (err) {
171
- if (err instanceof ProvisionError) throw err;
172
- throw new ProvisionError(
173
- 1,
174
- `Vault GET by-slug failed: ${err instanceof Error ? err.message : String(err)}`,
175
- );
176
- }
177
- if (!entity) {
178
- throw new ProvisionError(
179
- 2,
180
- `Refusing to demote '${options.slug}': no cloud entity found. Pass --force to demote anyway.`,
181
- );
182
- }
183
- // `deleted` is added by hq-pro and isn't in the static VaultEntity type.
184
- const deleted = (entity as unknown as { deleted?: boolean }).deleted === true;
185
- if (!deleted) {
186
- throw new ProvisionError(
187
- 2,
188
- `Refusing to demote '${options.slug}': cloud entity is not deleted (uid=${entity.uid}). Pass --force to demote anyway.`,
189
- );
190
- }
191
- cloudWasDeleted = true;
192
- }
193
-
194
- const cPath = companyConfigPath(options.hqRoot, options.slug);
195
- let configRemoved = false;
196
- if (fs.existsSync(cPath)) {
197
- fs.rmSync(cPath);
198
- configRemoved = true;
199
- }
200
-
201
- const yamlFlipped = flipCompanyYamlCloudOff(options.hqRoot, options.slug);
202
- const manifestStripped = stripManifestCloudForSlug(options.hqRoot, options.slug);
203
-
204
- return {
205
- ok: true,
206
- company_slug: options.slug,
207
- config_removed: configRemoved,
208
- yaml_flipped: yamlFlipped,
209
- manifest_stripped: manifestStripped,
210
- cloud_was_deleted: cloudWasDeleted,
211
- };
212
- }
213
-
214
- // ── Commander wiring ─────────────────────────────────────────────────────────
215
-
216
- /**
217
- * Register `demote company <slug>` under the `cloud` command group. Wired in
218
- * `src/index.ts` alongside `registerCloudProvisionCommands(cloudCmd)`.
219
- */
220
- export function registerCloudDemoteCommands(program: Command): void {
221
- const demoteCmd = program
222
- .command("demote")
223
- .description("Demote a cloud-backed entity back to local-only");
224
-
225
- demoteCmd
226
- .command("company")
227
- .description(
228
- "Demote a cloud-backed company to local-only after the cloud entity " +
229
- "has been soft-tombstoned in hq-console. Removes .hq/config.json, " +
230
- "flips company.yaml `cloud: false`, and strips the manifest cloud refs.",
231
- )
232
- .argument("<slug>", "Company slug")
233
- .option(
234
- "--hq-root <path>",
235
- `Local HQ tree root (default: ${DEFAULT_HQ_ROOT})`,
236
- DEFAULT_HQ_ROOT,
237
- )
238
- .option(
239
- "--vault-api-url <url>",
240
- `Vault API URL (default: ${DEFAULT_VAULT_API_URL})`,
241
- DEFAULT_VAULT_API_URL,
242
- )
243
- .option(
244
- "--force",
245
- "Skip the safety check that the cloud entity is actually deleted=true. " +
246
- "AppBar HQ Sync passes this because its Path A just verified.",
247
- )
248
- .action(
249
- async (
250
- slug: string,
251
- options: { hqRoot: string; vaultApiUrl: string; force?: boolean },
252
- ) => {
253
- try {
254
- const result = await demoteCompany({
255
- slug,
256
- hqRoot: options.hqRoot,
257
- vaultApiUrl: options.vaultApiUrl,
258
- force: options.force,
259
- });
260
- process.stdout.write(JSON.stringify(result) + "\n");
261
- process.exit(0);
262
- } catch (err) {
263
- if (err instanceof ProvisionError) {
264
- process.stderr.write(
265
- chalk.red(`[hq cloud demote] ${err.message}\n`),
266
- );
267
- process.exit(err.code);
268
- }
269
- process.stderr.write(
270
- chalk.red(
271
- `[hq cloud demote] Unexpected error: ${err instanceof Error ? err.message : String(err)}\n`,
272
- ),
273
- );
274
- process.exit(1);
275
- }
276
- },
277
- );
278
- }