@mp-lb/arcnet 0.7.14 → 0.7.16

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.
package/README.md CHANGED
@@ -34,3 +34,12 @@ Deployment workflow templates read the exact Node version from the project root
34
34
  version file before installing a deployment workflow, and keep the deployed
35
35
  runtime on a compatible Node major. Generated secrets-validation workflows use
36
36
  the same file when present; standalone projects without it retain Node 22.
37
+
38
+ ### Google Cloud organization
39
+
40
+ The `mp-lb` environment sets `gcp-organization` and passes it to the
41
+ `gcp-project` module through `organization-id`. New projects are created in
42
+ that organization. Existing projects require a reviewed migration: inspect
43
+ inherited policies, keep project IDs and Terraform state locations unchanged,
44
+ and verify deployments after moving. Updating ArcNet can propose a project
45
+ parent change; review the plan before deployment.
@@ -1 +1 @@
1
- {"version":3,"file":"createCli.d.ts","sourceRoot":"","sources":["../src/createCli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,eAAO,MAAM,SAAS,eAqNrB,CAAC"}
1
+ {"version":3,"file":"createCli.d.ts","sourceRoot":"","sources":["../src/createCli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,eAAO,MAAM,SAAS,eAsNrB,CAAC"}
package/dist/createCli.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { createDesktopCommands } from "./desktop/createDesktopCommands.js";
1
2
  import { Command } from "commander";
2
3
  import { appendFileSync, existsSync, readFileSync, realpathSync, } from "node:fs";
3
4
  import { join } from "node:path";
@@ -32,6 +33,7 @@ export const createCli = () => {
32
33
  process.stdout.write(renderResult(result, cli.opts()) + "\n");
33
34
  };
34
35
  createSecretsCommands(cli, output);
36
+ createDesktopCommands(cli, output);
35
37
  cli
36
38
  .command("variables")
37
39
  .description("Manage non-secret Forum variable snapshots.")
@@ -1 +1 @@
1
- {"version":3,"file":"createCli.js","sourceRoot":"","sources":["../src/createCli.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"createCli.js","sourceRoot":"","sources":["../src/createCli.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Command } from "commander";
2
+ export declare const createDesktopCommands: (cli: Command, output: (result: unknown) => void) => void;
3
+ //# sourceMappingURL=createDesktopCommands.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"createDesktopCommands.d.ts","sourceRoot":"","sources":["../../src/desktop/createDesktopCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,qBAAqB,GAChC,KAAK,OAAO,EACZ,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,SAelC,CAAC"}
@@ -0,0 +1,12 @@
1
+ import { verifyDesktopRelease } from "./verifyDesktopRelease.js";
2
+ export const createDesktopCommands = (cli, output) => {
3
+ const desktop = cli
4
+ .command("desktop")
5
+ .description("Configure and validate signed macOS desktop releases.");
6
+ desktop
7
+ .command("verify")
8
+ .description("Verify the latest DMG, ZIP, and update manifest are publicly downloadable.")
9
+ .requiredOption("--repository <owner/repo>", "Public releases repository")
10
+ .action(async (options) => output(await verifyDesktopRelease(options.repository)));
11
+ };
12
+ //# sourceMappingURL=createDesktopCommands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"createDesktopCommands.js","sourceRoot":"","sources":["../../src/desktop/createDesktopCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,GAAY,EACZ,MAAiC,EACjC,EAAE;IACF,MAAM,OAAO,GAAG,GAAG;SAChB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,uDAAuD,CAAC,CAAC;IAExE,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,4EAA4E,CAC7E;SACA,cAAc,CAAC,2BAA2B,EAAE,4BAA4B,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,MAAM,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AACN,CAAC,CAAC"}
@@ -0,0 +1,7 @@
1
+ export declare const verifyDesktopRelease: (repository: string) => Promise<{
2
+ operation: string;
3
+ tag: string;
4
+ assets: string[];
5
+ message: string;
6
+ }>;
7
+ //# sourceMappingURL=verifyDesktopRelease.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifyDesktopRelease.d.ts","sourceRoot":"","sources":["../../src/desktop/verifyDesktopRelease.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,GAAU,YAAY,MAAM;;;;;EA8D5D,CAAC"}
@@ -0,0 +1,38 @@
1
+ import { z } from "zod";
2
+ export const verifyDesktopRelease = async (repository) => {
3
+ z.string()
4
+ .regex(/^[\w.-]+\/[\w.-]+$/)
5
+ .parse(repository);
6
+ const response = await fetch(`https://api.github.com/repos/${repository}/releases/latest`, { headers: { Accept: "application/vnd.github+json" } });
7
+ if (!response.ok)
8
+ throw new Error(`Public release is unavailable: HTTP ${response.status}.`);
9
+ const release = z
10
+ .object({
11
+ tag_name: z.string(),
12
+ assets: z.array(z.object({
13
+ name: z.string(),
14
+ size: z.number().positive(),
15
+ browser_download_url: z.url(),
16
+ })),
17
+ })
18
+ .parse(await response.json());
19
+ const assets = release.assets.filter((asset) => /\.(dmg|zip|yml)$/.test(asset.name));
20
+ if (![".dmg", ".zip", ".yml"].every((extension) => assets.some((asset) => asset.name.endsWith(extension))))
21
+ throw new Error("Release must contain a DMG, ZIP, and update manifest.");
22
+ for (const asset of assets) {
23
+ if (!asset.browser_download_url.startsWith(`https://github.com/${repository}/releases/download/`))
24
+ throw new Error("Unexpected release asset host or repository.");
25
+ const download = await fetch(asset.browser_download_url, {
26
+ method: "HEAD",
27
+ });
28
+ if (!download.ok)
29
+ throw new Error(`Public download failed for ${asset.name}: HTTP ${download.status}.`);
30
+ }
31
+ return {
32
+ operation: "desktop.verify",
33
+ tag: release.tag_name,
34
+ assets: assets.map((asset) => asset.name),
35
+ message: "Release assets are publicly downloadable. Signing and notarization must also pass in the release workflow.",
36
+ };
37
+ };
38
+ //# sourceMappingURL=verifyDesktopRelease.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifyDesktopRelease.js","sourceRoot":"","sources":["../../src/desktop/verifyDesktopRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,UAAkB,EAAE,EAAE;IAC/D,CAAC,CAAC,MAAM,EAAE;SACP,KAAK,CAAC,oBAAoB,CAAC;SAC3B,KAAK,CAAC,UAAU,CAAC,CAAC;IAErB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,gCAAgC,UAAU,kBAAkB,EAC5D,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,EAAE,CACvD,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE;QACd,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE7E,MAAM,OAAO,GAAG,CAAC;SACd,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,oBAAoB,EAAE,CAAC,CAAC,GAAG,EAAE;SAC9B,CAAC,CACH;KACF,CAAC;SACD,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7C,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CACpC,CAAC;IAEF,IACE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACvD;QAED,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAE3E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,CAAC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CACpC,sBAAsB,UAAU,qBAAqB,CACtD;YAED,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,oBAAoB,EAAE;YACvD,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;YACd,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,CAAC,IAAI,UAAU,QAAQ,CAAC,MAAM,GAAG,CACrE,CAAC;IACN,CAAC;IAED,OAAO;QACL,SAAS,EAAE,gBAAgB;QAC3B,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QACzC,OAAO,EACL,4GAA4G;KAC/G,CAAC;AACJ,CAAC,CAAC"}
@@ -7,6 +7,6 @@ export const isAllowedSecretsCiRef = (repository, action, consumer, environment)
7
7
  return true;
8
8
  return (action === "export" &&
9
9
  consumer === "desktop" &&
10
- /^refs\/tags\/v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(environment.GITHUB_REF ?? ""));
10
+ /^refs\/tags\/(?:desktop-)?v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(environment.GITHUB_REF ?? ""));
11
11
  };
12
12
  //# sourceMappingURL=isAllowedSecretsCiRef.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"isAllowedSecretsCiRef.js","sourceRoot":"","sources":["../../src/secrets/isAllowedSecretsCiRef.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,UAAkB,EAClB,MAAkC,EAClC,QAA4B,EAC5B,WAA8B,EAC9B,EAAE;IACF,IAAI,WAAW,CAAC,cAAc,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,WAAW,CAAC,iBAAiB,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,WAAW,CAAC,UAAU,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAE9D,OAAO,CACL,MAAM,KAAK,QAAQ;QACnB,QAAQ,KAAK,SAAS;QACtB,kDAAkD,CAAC,IAAI,CACrD,WAAW,CAAC,UAAU,IAAI,EAAE,CAC7B,CACF,CAAC;AACJ,CAAC,CAAC"}
1
+ {"version":3,"file":"isAllowedSecretsCiRef.js","sourceRoot":"","sources":["../../src/secrets/isAllowedSecretsCiRef.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,UAAkB,EAClB,MAAkC,EAClC,QAA4B,EAC5B,WAA8B,EAC9B,EAAE;IACF,IAAI,WAAW,CAAC,cAAc,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,WAAW,CAAC,iBAAiB,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,WAAW,CAAC,UAAU,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAE9D,OAAO,CACL,MAAM,KAAK,QAAQ;QACnB,QAAQ,KAAK,SAAS;QACtB,+DAA+D,CAAC,IAAI,CAClE,WAAW,CAAC,UAAU,IAAI,EAAE,CAC7B,CACF,CAAC;AACJ,CAAC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"readRemoteSource.d.ts","sourceRoot":"","sources":["../../src/secrets/readRemoteSource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAUhD,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,+BAAyB;;;;CA0D1B,CAAC"}
1
+ {"version":3,"file":"readRemoteSource.d.ts","sourceRoot":"","sources":["../../src/secrets/readRemoteSource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAUhD,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,+BAAyB;;;;CA4E1B,CAAC"}
@@ -14,10 +14,14 @@ export const readRemoteSource = (source, root, environment = process.env) => {
14
14
  env.DOCTRINE_TOKEN = env[source.tokenEnv];
15
15
  }
16
16
  const args = [source.path, "--store", source.store];
17
+ let stage = "read initial file metadata";
17
18
  try {
18
19
  const before = infoSchema.parse(JSON.parse(secretCommand("fm", ["file", "info", ...args, "--json"], root, undefined, env)));
20
+ stage = "read encrypted file contents";
19
21
  const text = secretCommand("fm", ["file", "read", ...args], root, undefined, env);
22
+ stage = "read final file metadata";
20
23
  const after = infoSchema.parse(JSON.parse(secretCommand("fm", ["file", "info", ...args, "--json"], root, undefined, env)));
24
+ stage = "verify file identity, path, and revision";
21
25
  if (before.id !== after.id ||
22
26
  before.revisionNumber !== after.revisionNumber ||
23
27
  after.path !== source.path ||
@@ -25,8 +29,17 @@ export const readRemoteSource = (source, root, environment = process.env) => {
25
29
  throw new Error("Source changed");
26
30
  return { text, fileId: after.id, revision: after.revisionNumber };
27
31
  }
28
- catch {
29
- throw new Error(`Cannot read stable Forum source ${source.name}; check access, identity and concurrent edits.`);
32
+ catch (error) {
33
+ const reason = error instanceof z.ZodError || error instanceof SyntaxError
34
+ ? "Forum returned invalid file metadata"
35
+ : stage.startsWith("verify")
36
+ ? "file identity, path, or revision changed"
37
+ : error instanceof Error &&
38
+ error.message.startsWith("fm ") &&
39
+ error.message.includes("output withheld to protect credentials")
40
+ ? error.message
41
+ : "Forum command failed";
42
+ throw new Error(`Cannot ${stage} for Forum source ${source.name} (${source.store}:${source.path}): ${reason}. Retry the command; if it persists, check Forum access and concurrent edits. Subprocess output withheld to protect credentials.`);
30
43
  }
31
44
  };
32
45
  //# sourceMappingURL=readRemoteSource.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"readRemoteSource.js","sourceRoot":"","sources":["../../src/secrets/readRemoteSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAoB,EACpB,IAAY,EACZ,WAAW,GAAG,OAAO,CAAC,GAAG,EACzB,EAAE;IACF,MAAM,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IAE/B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC1E,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAC7B,IAAI,CAAC,KAAK,CACR,aAAa,CACX,IAAI,EACJ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,EACnC,IAAI,EACJ,SAAS,EACT,GAAG,CACJ,CACF,CACF,CAAC;QAEF,MAAM,IAAI,GAAG,aAAa,CACxB,IAAI,EACJ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,GAAG,CACJ,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAC5B,IAAI,CAAC,KAAK,CACR,aAAa,CACX,IAAI,EACJ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,EACnC,IAAI,EACJ,SAAS,EACT,GAAG,CACJ,CACF,CACF,CAAC;QAEF,IACE,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE;YACtB,MAAM,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;YAC9C,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;YAC1B,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAEhE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,CAAC,IAAI,gDAAgD,CAC/F,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
1
+ {"version":3,"file":"readRemoteSource.js","sourceRoot":"","sources":["../../src/secrets/readRemoteSource.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"secretCommand.d.ts","sourceRoot":"","sources":["../../src/secrets/secretCommand.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,GACxB,SAAS,MAAM,EACf,MAAM,MAAM,EAAE,EACd,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,uBAAiB,KAChB,MAgBF,CAAC"}
1
+ {"version":3,"file":"secretCommand.d.ts","sourceRoot":"","sources":["../../src/secrets/secretCommand.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,GACxB,SAAS,MAAM,EACf,MAAM,MAAM,EAAE,EACd,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,uBAAiB,KAChB,MA6BF,CAAC"}
@@ -10,8 +10,17 @@ export const secretCommand = (command, args, root, input, env = process.env) =>
10
10
  maxBuffer: 16 * 1024 * 1024,
11
11
  timeout: 120000,
12
12
  });
13
- if (result.error || result.status !== 0)
14
- throw new Error(`${command} ${args[0] ?? ""} failed; output withheld to protect credentials. Check authentication and permissions.`);
13
+ if (result.error || result.status !== 0) {
14
+ const code = result.error?.code;
15
+ const reason = code === "ENOENT"
16
+ ? "executable or working directory not found; check PATH"
17
+ : code === "EACCES"
18
+ ? "executable or working directory permission denied"
19
+ : code === "ETIMEDOUT"
20
+ ? "command timed out"
21
+ : `exit ${result.status ?? "unknown"}${result.signal ? `, signal ${result.signal}` : ""}`;
22
+ throw new Error(`${command} ${args[0] ?? ""} failed (${reason}); output withheld to protect credentials. Check authentication and permissions.`);
23
+ }
15
24
  return result.stdout;
16
25
  };
17
26
  //# sourceMappingURL=secretCommand.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"secretCommand.js","sourceRoot":"","sources":["../../src/secrets/secretCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAAe,EACf,IAAc,EACd,IAAY,EACZ,KAAc,EACd,GAAG,GAAG,OAAO,CAAC,GAAG,EACT,EAAE;IACV,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG,EAAE,IAAI;QACT,GAAG;QACH,KAAK;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;QAC3B,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,wFAAwF,CACpH,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC"}
1
+ {"version":3,"file":"secretCommand.js","sourceRoot":"","sources":["../../src/secrets/secretCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAAe,EACf,IAAc,EACd,IAAY,EACZ,KAAc,EACd,GAAG,GAAG,OAAO,CAAC,GAAG,EACT,EAAE;IACV,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG,EAAE,IAAI;QACT,GAAG;QACH,KAAK;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;QAC3B,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GAAI,MAAM,CAAC,KAA2C,EAAE,IAAI,CAAC;QAEvE,MAAM,MAAM,GACV,IAAI,KAAK,QAAQ;YACf,CAAC,CAAC,uDAAuD;YACzD,CAAC,CAAC,IAAI,KAAK,QAAQ;gBACjB,CAAC,CAAC,mDAAmD;gBACrD,CAAC,CAAC,IAAI,KAAK,WAAW;oBACpB,CAAC,CAAC,mBAAmB;oBACrB,CAAC,CAAC,QAAQ,MAAM,CAAC,MAAM,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAElG,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,MAAM,kFAAkF,CAChI,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC"}
@@ -91,6 +91,18 @@ Refresh encrypted snapshots from Forum and regenerate validation CI; no decrypti
91
91
  | --- | --- |
92
92
  | `--config <file>` | Secrets source configuration |
93
93
 
94
+ ## `arcnet desktop`
95
+
96
+ Configure and validate signed macOS desktop releases.
97
+
98
+ ### `arcnet desktop verify`
99
+
100
+ Verify the latest DMG, ZIP, and update manifest are publicly downloadable.
101
+
102
+ | Option | Description |
103
+ | --- | --- |
104
+ | `--repository <owner/repo>` | Public releases repository |
105
+
94
106
  ## `arcnet variables`
95
107
 
96
108
  Manage non-secret Forum variable snapshots.
@@ -35,6 +35,15 @@ version file before installing a deployment workflow, and keep the deployed
35
35
  runtime on a compatible Node major. Generated secrets-validation workflows use
36
36
  the same file when present; standalone projects without it retain Node 22.
37
37
 
38
+ ### Google Cloud organization
39
+
40
+ The `mp-lb` environment sets `gcp-organization` and passes it to the
41
+ `gcp-project` module through `organization-id`. New projects are created in
42
+ that organization. Existing projects require a reviewed migration: inspect
43
+ inherited policies, keep project IDs and Terraform state locations unchanged,
44
+ and verify deployments after moving. Updating ArcNet can propose a project
45
+ parent change; review the plan before deployment.
46
+
38
47
  # ArcNet command reference
39
48
 
40
49
  Generated from the CLI command tree.
@@ -128,6 +137,18 @@ Refresh encrypted snapshots from Forum and regenerate validation CI; no decrypti
128
137
  | --- | --- |
129
138
  | `--config <file>` | Secrets source configuration |
130
139
 
140
+ ## `arcnet desktop`
141
+
142
+ Configure and validate signed macOS desktop releases.
143
+
144
+ ### `arcnet desktop verify`
145
+
146
+ Verify the latest DMG, ZIP, and update manifest are publicly downloadable.
147
+
148
+ | Option | Description |
149
+ | --- | --- |
150
+ | `--repository <owner/repo>` | Public releases repository |
151
+
131
152
  ## `arcnet variables`
132
153
 
133
154
  Manage non-secret Forum variable snapshots.
@@ -2,6 +2,7 @@ name: mp-lb
2
2
  region: asia-southeast1
3
3
  aws-region: ap-southeast-1
4
4
  gcp-project: arcnet-{slug}
5
+ gcp-organization: "540384988879"
5
6
  network-project: arcnet-platform
6
7
  billing-account: 01D217-1685AF-7C9109
7
8
  dns:
@@ -62,6 +63,7 @@ module-defaults:
62
63
  network-project: ""
63
64
  billing-account: "{billing-account}"
64
65
  gcp-project:
66
+ organization-id: "{gcp-organization}"
65
67
  project-id: "{gcp-project}"
66
68
  billing-account: "{billing-account}"
67
69
  gcp-budget:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mp-lb/arcnet",
3
- "version": "0.7.14",
3
+ "version": "0.7.16",
4
4
  "description": "ArcNet project installation and deployment CLI.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -36,7 +36,7 @@
36
36
  },
37
37
  "dependencies": {
38
38
  "@mp-lb/forum-secrets": "0.2.1",
39
- "@mp-lb/zapper": "0.21.8",
39
+ "@mp-lb/zapper": "0.21.10",
40
40
  "commander": "14.0.3",
41
41
  "yaml": "2.8.1",
42
42
  "zod": "4.4.1"
@@ -46,7 +46,7 @@
46
46
  },
47
47
  "scripts": {
48
48
  "build": "rm -rf dist && tsc --project tsconfig.json && chmod +x dist/cli.js",
49
- "typecheck": "tsc --project tsconfig.json --noEmit",
49
+ "typecheck": "tsc --project tsconfig.scripts.json --noEmit",
50
50
  "test": "pnpm build && node --import tsx --test test/*.test.ts && pnpm docs:check",
51
51
  "docs:gen": "pnpm --filter @mp-lb/cli-docs build && tsx scripts/generateDocs.ts",
52
52
  "docs:check": "pnpm --filter @mp-lb/cli-docs build && tsx scripts/generateDocs.ts --check"
package/src/createCli.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { createDesktopCommands } from "./desktop/createDesktopCommands.js";
1
2
  import { Command } from "commander";
2
3
  import {
3
4
  appendFileSync,
@@ -44,6 +45,7 @@ export const createCli = () => {
44
45
  };
45
46
 
46
47
  createSecretsCommands(cli, output);
48
+ createDesktopCommands(cli, output);
47
49
 
48
50
  cli
49
51
  .command("variables")
@@ -0,0 +1,21 @@
1
+ import { Command } from "commander";
2
+ import { verifyDesktopRelease } from "./verifyDesktopRelease.js";
3
+
4
+ export const createDesktopCommands = (
5
+ cli: Command,
6
+ output: (result: unknown) => void,
7
+ ) => {
8
+ const desktop = cli
9
+ .command("desktop")
10
+ .description("Configure and validate signed macOS desktop releases.");
11
+
12
+ desktop
13
+ .command("verify")
14
+ .description(
15
+ "Verify the latest DMG, ZIP, and update manifest are publicly downloadable.",
16
+ )
17
+ .requiredOption("--repository <owner/repo>", "Public releases repository")
18
+ .action(async (options) =>
19
+ output(await verifyDesktopRelease(options.repository)),
20
+ );
21
+ };
@@ -0,0 +1,65 @@
1
+ import { z } from "zod";
2
+
3
+ export const verifyDesktopRelease = async (repository: string) => {
4
+ z.string()
5
+ .regex(/^[\w.-]+\/[\w.-]+$/)
6
+ .parse(repository);
7
+
8
+ const response = await fetch(
9
+ `https://api.github.com/repos/${repository}/releases/latest`,
10
+ { headers: { Accept: "application/vnd.github+json" } },
11
+ );
12
+
13
+ if (!response.ok)
14
+ throw new Error(`Public release is unavailable: HTTP ${response.status}.`);
15
+
16
+ const release = z
17
+ .object({
18
+ tag_name: z.string(),
19
+ assets: z.array(
20
+ z.object({
21
+ name: z.string(),
22
+ size: z.number().positive(),
23
+ browser_download_url: z.url(),
24
+ }),
25
+ ),
26
+ })
27
+ .parse(await response.json());
28
+
29
+ const assets = release.assets.filter((asset) =>
30
+ /\.(dmg|zip|yml)$/.test(asset.name),
31
+ );
32
+
33
+ if (
34
+ ![".dmg", ".zip", ".yml"].every((extension) =>
35
+ assets.some((asset) => asset.name.endsWith(extension)),
36
+ )
37
+ )
38
+ throw new Error("Release must contain a DMG, ZIP, and update manifest.");
39
+
40
+ for (const asset of assets) {
41
+ if (
42
+ !asset.browser_download_url.startsWith(
43
+ `https://github.com/${repository}/releases/download/`,
44
+ )
45
+ )
46
+ throw new Error("Unexpected release asset host or repository.");
47
+
48
+ const download = await fetch(asset.browser_download_url, {
49
+ method: "HEAD",
50
+ });
51
+
52
+ if (!download.ok)
53
+ throw new Error(
54
+ `Public download failed for ${asset.name}: HTTP ${download.status}.`,
55
+ );
56
+ }
57
+
58
+ return {
59
+ operation: "desktop.verify",
60
+ tag: release.tag_name,
61
+ assets: assets.map((asset) => asset.name),
62
+ message:
63
+ "Release assets are publicly downloadable. Signing and notarization must also pass in the release workflow.",
64
+ };
65
+ };
@@ -11,7 +11,7 @@ export const isAllowedSecretsCiRef = (
11
11
  return (
12
12
  action === "export" &&
13
13
  consumer === "desktop" &&
14
- /^refs\/tags\/v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(
14
+ /^refs\/tags\/(?:desktop-)?v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(
15
15
  environment.GITHUB_REF ?? "",
16
16
  )
17
17
  );
@@ -24,6 +24,8 @@ export const readRemoteSource = (
24
24
 
25
25
  const args = [source.path, "--store", source.store];
26
26
 
27
+ let stage = "read initial file metadata";
28
+
27
29
  try {
28
30
  const before = infoSchema.parse(
29
31
  JSON.parse(
@@ -37,6 +39,8 @@ export const readRemoteSource = (
37
39
  ),
38
40
  );
39
41
 
42
+ stage = "read encrypted file contents";
43
+
40
44
  const text = secretCommand(
41
45
  "fm",
42
46
  ["file", "read", ...args],
@@ -45,6 +49,8 @@ export const readRemoteSource = (
45
49
  env,
46
50
  );
47
51
 
52
+ stage = "read final file metadata";
53
+
48
54
  const after = infoSchema.parse(
49
55
  JSON.parse(
50
56
  secretCommand(
@@ -57,6 +63,7 @@ export const readRemoteSource = (
57
63
  ),
58
64
  );
59
65
 
66
+ stage = "verify file identity, path, and revision";
60
67
  if (
61
68
  before.id !== after.id ||
62
69
  before.revisionNumber !== after.revisionNumber ||
@@ -65,9 +72,20 @@ export const readRemoteSource = (
65
72
  )
66
73
  throw new Error("Source changed");
67
74
  return { text, fileId: after.id, revision: after.revisionNumber };
68
- } catch {
75
+ } catch (error) {
76
+ const reason =
77
+ error instanceof z.ZodError || error instanceof SyntaxError
78
+ ? "Forum returned invalid file metadata"
79
+ : stage.startsWith("verify")
80
+ ? "file identity, path, or revision changed"
81
+ : error instanceof Error &&
82
+ error.message.startsWith("fm ") &&
83
+ error.message.includes("output withheld to protect credentials")
84
+ ? error.message
85
+ : "Forum command failed";
86
+
69
87
  throw new Error(
70
- `Cannot read stable Forum source ${source.name}; check access, identity and concurrent edits.`,
88
+ `Cannot ${stage} for Forum source ${source.name} (${source.store}:${source.path}): ${reason}. Retry the command; if it persists, check Forum access and concurrent edits. Subprocess output withheld to protect credentials.`,
71
89
  );
72
90
  }
73
91
  };
@@ -18,9 +18,22 @@ export const secretCommand = (
18
18
  timeout: 120000,
19
19
  });
20
20
 
21
- if (result.error || result.status !== 0)
21
+ if (result.error || result.status !== 0) {
22
+ const code = (result.error as NodeJS.ErrnoException | undefined)?.code;
23
+
24
+ const reason =
25
+ code === "ENOENT"
26
+ ? "executable or working directory not found; check PATH"
27
+ : code === "EACCES"
28
+ ? "executable or working directory permission denied"
29
+ : code === "ETIMEDOUT"
30
+ ? "command timed out"
31
+ : `exit ${result.status ?? "unknown"}${result.signal ? `, signal ${result.signal}` : ""}`;
32
+
22
33
  throw new Error(
23
- `${command} ${args[0] ?? ""} failed; output withheld to protect credentials. Check authentication and permissions.`,
34
+ `${command} ${args[0] ?? ""} failed (${reason}); output withheld to protect credentials. Check authentication and permissions.`,
24
35
  );
36
+ }
37
+
25
38
  return result.stdout;
26
39
  };