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