@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,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
- }