@intentic/cli 1.0.2

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 (174) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +80 -0
  3. package/dist/add-app/add-app.command.d.ts +3 -0
  4. package/dist/add-app/add-app.command.d.ts.map +1 -0
  5. package/dist/add-app/add-app.command.js +50 -0
  6. package/dist/add-app/add-app.command.js.map +1 -0
  7. package/dist/adopt/adopt.command.d.ts +3 -0
  8. package/dist/adopt/adopt.command.d.ts.map +1 -0
  9. package/dist/adopt/adopt.command.js +77 -0
  10. package/dist/adopt/adopt.command.js.map +1 -0
  11. package/dist/adopt/adopt.d.ts +21 -0
  12. package/dist/adopt/adopt.d.ts.map +1 -0
  13. package/dist/adopt/adopt.js +31 -0
  14. package/dist/adopt/adopt.js.map +1 -0
  15. package/dist/app.d.ts +2 -0
  16. package/dist/app.d.ts.map +1 -0
  17. package/dist/app.js +46 -0
  18. package/dist/app.js.map +1 -0
  19. package/dist/apply/access.d.ts +16 -0
  20. package/dist/apply/access.d.ts.map +1 -0
  21. package/dist/apply/access.js +72 -0
  22. package/dist/apply/access.js.map +1 -0
  23. package/dist/apply/apply-lock.d.ts +12 -0
  24. package/dist/apply/apply-lock.d.ts.map +1 -0
  25. package/dist/apply/apply-lock.js +102 -0
  26. package/dist/apply/apply-lock.js.map +1 -0
  27. package/dist/apply/apply.command.d.ts +3 -0
  28. package/dist/apply/apply.command.d.ts.map +1 -0
  29. package/dist/apply/apply.command.js +144 -0
  30. package/dist/apply/apply.command.js.map +1 -0
  31. package/dist/apply/migrate.d.ts +20 -0
  32. package/dist/apply/migrate.d.ts.map +1 -0
  33. package/dist/apply/migrate.js +112 -0
  34. package/dist/apply/migrate.js.map +1 -0
  35. package/dist/cli.d.ts +3 -0
  36. package/dist/cli.d.ts.map +1 -0
  37. package/dist/cli.js +5 -0
  38. package/dist/cli.js.map +1 -0
  39. package/dist/demo.d.ts +2 -0
  40. package/dist/demo.d.ts.map +1 -0
  41. package/dist/demo.js +281 -0
  42. package/dist/demo.js.map +1 -0
  43. package/dist/deployments/deployments.command.d.ts +3 -0
  44. package/dist/deployments/deployments.command.d.ts.map +1 -0
  45. package/dist/deployments/deployments.command.js +19 -0
  46. package/dist/deployments/deployments.command.js.map +1 -0
  47. package/dist/deployments/deployments.d.ts +14 -0
  48. package/dist/deployments/deployments.d.ts.map +1 -0
  49. package/dist/deployments/deployments.js +83 -0
  50. package/dist/deployments/deployments.js.map +1 -0
  51. package/dist/env.config.d.ts +25 -0
  52. package/dist/env.config.d.ts.map +1 -0
  53. package/dist/env.config.js +31 -0
  54. package/dist/env.config.js.map +1 -0
  55. package/dist/host-ssh-tunnel/host-ssh-tunnel.command.d.ts +3 -0
  56. package/dist/host-ssh-tunnel/host-ssh-tunnel.command.d.ts.map +1 -0
  57. package/dist/host-ssh-tunnel/host-ssh-tunnel.command.js +39 -0
  58. package/dist/host-ssh-tunnel/host-ssh-tunnel.command.js.map +1 -0
  59. package/dist/host-ssh-tunnel/host-ssh-tunnel.d.ts +14 -0
  60. package/dist/host-ssh-tunnel/host-ssh-tunnel.d.ts.map +1 -0
  61. package/dist/host-ssh-tunnel/host-ssh-tunnel.js +21 -0
  62. package/dist/host-ssh-tunnel/host-ssh-tunnel.js.map +1 -0
  63. package/dist/index.d.ts +5 -0
  64. package/dist/index.d.ts.map +1 -0
  65. package/dist/index.js +5 -0
  66. package/dist/index.js.map +1 -0
  67. package/dist/init/init.command.d.ts +3 -0
  68. package/dist/init/init.command.d.ts.map +1 -0
  69. package/dist/init/init.command.js +45 -0
  70. package/dist/init/init.command.js.map +1 -0
  71. package/dist/init/init.d.ts +7 -0
  72. package/dist/init/init.d.ts.map +1 -0
  73. package/dist/init/init.js +39 -0
  74. package/dist/init/init.js.map +1 -0
  75. package/dist/init/scaffold-app.d.ts +2 -0
  76. package/dist/init/scaffold-app.d.ts.map +1 -0
  77. package/dist/init/scaffold-app.js +27 -0
  78. package/dist/init/scaffold-app.js.map +1 -0
  79. package/dist/lib/artifact.d.ts +10 -0
  80. package/dist/lib/artifact.d.ts.map +1 -0
  81. package/dist/lib/artifact.js +29 -0
  82. package/dist/lib/artifact.js.map +1 -0
  83. package/dist/lib/cf-tunnel.d.ts +11 -0
  84. package/dist/lib/cf-tunnel.d.ts.map +1 -0
  85. package/dist/lib/cf-tunnel.js +30 -0
  86. package/dist/lib/cf-tunnel.js.map +1 -0
  87. package/dist/lib/known-hosts.d.ts +3 -0
  88. package/dist/lib/known-hosts.d.ts.map +1 -0
  89. package/dist/lib/known-hosts.js +18 -0
  90. package/dist/lib/known-hosts.js.map +1 -0
  91. package/dist/lib/output.d.ts +14 -0
  92. package/dist/lib/output.d.ts.map +1 -0
  93. package/dist/lib/output.js +56 -0
  94. package/dist/lib/output.js.map +1 -0
  95. package/dist/lib/run-log.d.ts +3 -0
  96. package/dist/lib/run-log.d.ts.map +1 -0
  97. package/dist/lib/run-log.js +62 -0
  98. package/dist/lib/run-log.js.map +1 -0
  99. package/dist/lib/templates.d.ts +2 -0
  100. package/dist/lib/templates.d.ts.map +1 -0
  101. package/dist/lib/templates.js +6 -0
  102. package/dist/lib/templates.js.map +1 -0
  103. package/dist/lib/version.d.ts +2 -0
  104. package/dist/lib/version.d.ts.map +1 -0
  105. package/dist/lib/version.js +3 -0
  106. package/dist/lib/version.js.map +1 -0
  107. package/dist/logs/logs.command.d.ts +3 -0
  108. package/dist/logs/logs.command.d.ts.map +1 -0
  109. package/dist/logs/logs.command.js +86 -0
  110. package/dist/logs/logs.command.js.map +1 -0
  111. package/dist/monorepo/monorepo.command.d.ts +3 -0
  112. package/dist/monorepo/monorepo.command.d.ts.map +1 -0
  113. package/dist/monorepo/monorepo.command.js +28 -0
  114. package/dist/monorepo/monorepo.command.js.map +1 -0
  115. package/dist/pipelines/adopt-pipelines.d.ts +35 -0
  116. package/dist/pipelines/adopt-pipelines.d.ts.map +1 -0
  117. package/dist/pipelines/adopt-pipelines.js +77 -0
  118. package/dist/pipelines/adopt-pipelines.js.map +1 -0
  119. package/dist/pipelines/control-plane-sync.d.ts +24 -0
  120. package/dist/pipelines/control-plane-sync.d.ts.map +1 -0
  121. package/dist/pipelines/control-plane-sync.js +62 -0
  122. package/dist/pipelines/control-plane-sync.js.map +1 -0
  123. package/dist/plan/plan.command.d.ts +3 -0
  124. package/dist/plan/plan.command.d.ts.map +1 -0
  125. package/dist/plan/plan.command.js +33 -0
  126. package/dist/plan/plan.command.js.map +1 -0
  127. package/dist/resolve/resolve.command.d.ts +3 -0
  128. package/dist/resolve/resolve.command.d.ts.map +1 -0
  129. package/dist/resolve/resolve.command.js +78 -0
  130. package/dist/resolve/resolve.command.js.map +1 -0
  131. package/dist/resolve/resolve.d.ts +4 -0
  132. package/dist/resolve/resolve.d.ts.map +1 -0
  133. package/dist/resolve/resolve.js +33 -0
  134. package/dist/resolve/resolve.js.map +1 -0
  135. package/dist/restore/restore.command.d.ts +3 -0
  136. package/dist/restore/restore.command.d.ts.map +1 -0
  137. package/dist/restore/restore.command.js +68 -0
  138. package/dist/restore/restore.command.js.map +1 -0
  139. package/dist/sandbox-tunnel/sandbox-tunnel.command.d.ts +3 -0
  140. package/dist/sandbox-tunnel/sandbox-tunnel.command.d.ts.map +1 -0
  141. package/dist/sandbox-tunnel/sandbox-tunnel.command.js +62 -0
  142. package/dist/sandbox-tunnel/sandbox-tunnel.command.js.map +1 -0
  143. package/dist/sandbox-tunnel/sandbox-tunnel.d.ts +18 -0
  144. package/dist/sandbox-tunnel/sandbox-tunnel.d.ts.map +1 -0
  145. package/dist/sandbox-tunnel/sandbox-tunnel.js +37 -0
  146. package/dist/sandbox-tunnel/sandbox-tunnel.js.map +1 -0
  147. package/dist/secrets/generated-secrets.d.ts +6 -0
  148. package/dist/secrets/generated-secrets.d.ts.map +1 -0
  149. package/dist/secrets/generated-secrets.js +26 -0
  150. package/dist/secrets/generated-secrets.js.map +1 -0
  151. package/dist/secrets/secret-store.d.ts +14 -0
  152. package/dist/secrets/secret-store.d.ts.map +1 -0
  153. package/dist/secrets/secret-store.js +111 -0
  154. package/dist/secrets/secret-store.js.map +1 -0
  155. package/dist/secrets/secrets.command.d.ts +6 -0
  156. package/dist/secrets/secrets.command.d.ts.map +1 -0
  157. package/dist/secrets/secrets.command.js +106 -0
  158. package/dist/secrets/secrets.command.js.map +1 -0
  159. package/dist/secrets/secrets.d.ts +7 -0
  160. package/dist/secrets/secrets.d.ts.map +1 -0
  161. package/dist/secrets/secrets.js +14 -0
  162. package/dist/secrets/secrets.js.map +1 -0
  163. package/package.json +69 -0
  164. package/templates/access.md.eta +21 -0
  165. package/templates/demo/Dockerfile.eta +5 -0
  166. package/templates/demo/deploy.config.ts.eta +23 -0
  167. package/templates/demo/env.eta +2 -0
  168. package/templates/env-example.eta +6 -0
  169. package/templates/scaffold/Dockerfile.eta +7 -0
  170. package/templates/scaffold/deploy.config.selfhost.ts.eta +18 -0
  171. package/templates/scaffold/deploy.config.ts.eta +22 -0
  172. package/templates/scaffold/server.js.eta +9 -0
  173. package/templates/workflows/apply.yaml.eta +28 -0
  174. package/templates/workflows/resolve.yaml.eta +26 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Artur Kurowski
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,80 @@
1
+ # @intentic/cli
2
+
3
+ The **runnable product** — the `intentic` CLI (`bin: intentic`). It turns a local intent file into a
4
+ desired-state artifact and executes it, with no remote control plane required. Depends on
5
+ `@intentic/engine`, `@intentic/providers`, `@intentic/need-resolver`, `@intentic/state-resolver`, `@intentic/graph`.
6
+
7
+ ## Local control plane
8
+
9
+ The "control plane" is two local git repos: an **intent** repo holding `deploy.config.ts`, and a
10
+ **desired-state** repo holding the generated artifact (`desired-state.json`) and the
11
+ execution record (`status.json`). `intentic init` scaffolds both.
12
+
13
+ ## Commands
14
+
15
+ Built on [stricli](https://github.com/bloomberg/stricli) with generated `--help` / `--version`.
16
+
17
+ - `intentic init [--dir .]` — scaffold the `intent` and `desired-state` git repos (intent seeded
18
+ with a starter `deploy.config.ts`).
19
+ - `intentic resolve [--config deploy.config.ts] [--out desired-state.json]` —
20
+ load the intent, resolve it to a `DesiredStateGraph`, and write it, along with `.env.example` (the
21
+ user-supplied secrets) and `.secrets.json` (the intentic-generated ones). No infra access.
22
+ - `intentic plan [--artifact desired-state.json]` — read-only preview of what `apply` would
23
+ create/update.
24
+ - `intentic apply [--artifact desired-state.json] [--max-iterations 5]` — reconcile the artifact
25
+ until state reads true, writing `status.json` beside it. Reads user-supplied secrets from `.env`
26
+ beside the artifact (or the environment) and generates the platform admin secrets it owns (see
27
+ below). On success it prints an **Access** summary and writes `access.md` beside the artifact: the
28
+ URL, the `intentic` username, and the password (the generated value on stdout; a pointer to
29
+ `.secrets.json` in the committed `access.md`) for Forgejo and Komodo, plus each app-environment URL.
30
+
31
+ ## Secrets
32
+
33
+ Secrets split by who provides them:
34
+
35
+ - **User-supplied** (`source: env`) — credentials to systems intentic does **not** create:
36
+ `HOST_SSH_KEY`, `CLOUDFLARE_API_TOKEN`, and each environment's `*_DATABASE_URL`. You set these in
37
+ `.env` beside the artifact (or the ambient environment). The required set is more than what your
38
+ `deploy.config.ts` names, so `resolve` derives it from the graph and writes `desired-state/.env.example`.
39
+ - **intentic-generated** (`source: generated`) — admin credentials for the services intentic itself
40
+ provisions: `FORGEJO_ADMIN_PASSWORD`, `KOMODO_ADMIN_PASSWORD`, `KOMODO_WEBHOOK_SECRET`. `resolve`
41
+ generates each one (shell-safe hex) the first time and persists it to gitignored
42
+ `desired-state/.secrets.json`, reusing it forever after (`plan`/`apply` reuse it too; Forgejo/Komodo
43
+ bake the password in on first init and won't re-key, so it must be stable). intentic **owns** this
44
+ file — it's authoritative, so put platform keys here, not in `.env`; to pin your own value, edit
45
+ `.secrets.json`. The Forgejo/Komodo password is what you log in with, as user `intentic`.
46
+
47
+ Both `.env` and `.secrets.json` are gitignored, so no secret lands in the PR-managed repo.
48
+
49
+ ## Workflow
50
+
51
+ ```sh
52
+ intentic init
53
+ cd intent && intentic resolve --out ../desired-state/desired-state.json
54
+ cp ../desired-state/.env.example ../desired-state/.env # fill in the user-supplied values resolve listed
55
+ cd .. && intentic apply # generates the platform secrets, prints the logins
56
+ ```
57
+
58
+ > A `deploy.config.ts` imports `@intentic/sdk` + `@intentic/graph`, so the project it lives in must have
59
+ > them installed. `apply` reconciles the per-host platform (Forgejo/Komodo/runner, Cloudflare tunnel + DNS)
60
+ > as ordinary nodes in the artifact — a future "PR-managed" phase (a remote Forgejo watching the intent
61
+ > repo) would layer on top of this same flow.
62
+
63
+ ## Key files
64
+
65
+ - [src/cli.ts](src/cli.ts) / [src/app.ts](src/app.ts) — the stricli app and command wiring.
66
+ - [src/init.ts](src/init.ts) / [src/resolve.ts](src/resolve.ts) / [src/apply.ts](src/apply.ts) — the `init`/`resolve`/`apply` commands (plan lives alongside resolve/apply).
67
+ - [src/artifact.ts](src/artifact.ts) — `readArtifact`/`writeArtifact`/`writeStatus` (the desired-state files).
68
+ - [src/secrets.ts](src/secrets.ts) / [src/generated-secrets.ts](src/generated-secrets.ts) — the user-supplied vs intentic-generated secret split.
69
+ - [src/output.ts](src/output.ts) — honors `INTENTIC_OUTPUT` (`text`/`json`/`ndjson`); maps `EngineEvent`s to the chosen format.
70
+ - [src/adopt.ts](src/adopt.ts) / [src/adopt-pipelines.ts](src/adopt-pipelines.ts) — push the intent/desired-state repos into Forgejo + wire Actions.
71
+ - [src/access.ts](src/access.ts) — the post-apply Access summary + `access.md`; [src/known-hosts.ts](src/known-hosts.ts) — TOFU host-key pinning.
72
+
73
+ ## Conventions
74
+
75
+ - Runs the engine as the **only** place providers are constructed (via `createProviders`); it owns reading `.env` and generating `.secrets.json`.
76
+ - Subprocess-friendly: a backend can drive it and parse `INTENTIC_OUTPUT=ndjson`/`json` instead of scraping prose (the platform's `provision.ts` does exactly this).
77
+ - Co-located unit tests + a gated [src/cli.e2e.test.ts](src/cli.e2e.test.ts) (real infra, opt-in).
78
+
79
+ **Key exports:** `loadIntent`; `readArtifact` / `writeArtifact` / `writeStatus`; `scaffold`; the
80
+ `CONFIG_FILE` / `ARTIFACT_FILE` / `STATUS_FILE` constants. See [ARCHITECTURE.md](../../ARCHITECTURE.md).
@@ -0,0 +1,3 @@
1
+ import { type CommandContext } from "@stricli/core";
2
+ export declare const addAppCommand: import("@stricli/core").Command<CommandContext>;
3
+ //# sourceMappingURL=add-app.command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"add-app.command.d.ts","sourceRoot":"","sources":["../../src/add-app/add-app.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AA8BlE,eAAO,MAAM,aAAa,iDAiCxB,CAAC"}
@@ -0,0 +1,50 @@
1
+ import { addAppsToMonorepo, DEFAULT_TEMPLATE_REF, DEFAULT_TEMPLATE_SOURCE } from "@intentic/scaffold";
2
+ import { buildCommand } from "@stricli/core";
3
+ import { loadConfig } from "../env.config.js";
4
+ import { createOutput } from "../lib/output.js";
5
+ const parseApps = (raw) => raw
6
+ .split(",")
7
+ .map((entry) => entry.trim())
8
+ .filter(Boolean)
9
+ .map((entry) => {
10
+ const colon = entry.indexOf(":");
11
+ if (colon === -1) {
12
+ return { template: entry, name: entry };
13
+ }
14
+ return { template: entry.slice(0, colon), name: entry.slice(colon + 1) };
15
+ });
16
+ export const addAppCommand = buildCommand({
17
+ docs: { brief: "Add one or more app instances into an existing monorepo at <dir>" },
18
+ parameters: {
19
+ flags: {
20
+ dir: { kind: "parsed", parse: String, brief: "The monorepo repo directory to add the apps into" },
21
+ apps: {
22
+ kind: "parsed",
23
+ parse: String,
24
+ brief: "Comma-separated entries: template key or template:name, e.g. api,web:shop-web,api:admin-api",
25
+ },
26
+ source: { kind: "parsed", parse: String, optional: true, brief: `Template source git URL (default: ${DEFAULT_TEMPLATE_SOURCE})` },
27
+ ref: { kind: "parsed", parse: String, optional: true, brief: `Template source branch/tag (default: ${DEFAULT_TEMPLATE_REF})` },
28
+ },
29
+ },
30
+ async func(flags) {
31
+ const out = createOutput(this.process.stdout, loadConfig().intenticOutput);
32
+ const apps = parseApps(flags.apps);
33
+ if (apps.length === 0) {
34
+ throw new Error("no apps specified — pass --apps api,web:shop-web");
35
+ }
36
+ const progress = addAppsToMonorepo({
37
+ repoDir: flags.dir,
38
+ source: flags.source ?? DEFAULT_TEMPLATE_SOURCE,
39
+ ref: flags.ref ?? DEFAULT_TEMPLATE_REF,
40
+ apps,
41
+ });
42
+ for await (const message of progress) {
43
+ out.text(message);
44
+ }
45
+ const labels = apps.map((a) => (a.name === a.template ? a.template : `${a.template}:${a.name}`));
46
+ out.text(`added ${labels.join(", ")} to ${flags.dir}`);
47
+ out.result({ dir: flags.dir, apps });
48
+ },
49
+ });
50
+ //# sourceMappingURL=add-app.command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"add-app.command.js","sourceRoot":"","sources":["../../src/add-app/add-app.command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { type CommandContext } from "@stricli/core";
2
+ export declare const adopt: import("@stricli/core").Command<CommandContext>;
3
+ //# sourceMappingURL=adopt.command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adopt.command.d.ts","sourceRoot":"","sources":["../../src/adopt/adopt.command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAkBlE,eAAO,MAAM,KAAK,iDAkFhB,CAAC"}
@@ -0,0 +1,77 @@
1
+ import { dirname, join } from "node:path";
2
+ import { forgejoApi } from "@intentic/providers";
3
+ import { secretDigest, writeSyncState } from "@intentic/scaffold";
4
+ import { buildCommand } from "@stricli/core";
5
+ import { loadConfig } from "../env.config.js";
6
+ import { ARTIFACT_FILE, ARTIFACT_PATH, CONFIG_FILE, INTENT_DIR, loadEnvFile, readArtifact, TARGET_DIR } from "../lib/artifact.js";
7
+ import { createOutput } from "../lib/output.js";
8
+ import { withRunLog } from "../lib/run-log.js";
9
+ import { version } from "../lib/version.js";
10
+ import { collectSecretValues, GIT_TOKEN_SECRET, GIT_USER_SECRET, setRepoSecrets, writeControlPlaneWorkflows, } from "../pipelines/adopt-pipelines.js";
11
+ import { forgejoIdentity } from "../pipelines/control-plane-sync.js";
12
+ import { readGeneratedSecrets } from "../secrets/generated-secrets.js";
13
+ import { adoptRepos } from "./adopt.js";
14
+ export const adopt = buildCommand({
15
+ docs: { brief: "Push the local intent and desired-state repos to the provisioned Forgejo" },
16
+ parameters: {
17
+ flags: { artifact: { kind: "parsed", parse: String, optional: true, brief: `Path to the artifact (default: ${ARTIFACT_PATH})` } },
18
+ },
19
+ async func(flags) {
20
+ const out = createOutput(withRunLog(this.process.stdout, "adopt"), loadConfig().intenticOutput);
21
+ const artifact = flags.artifact ?? ARTIFACT_PATH;
22
+ const targetDir = dirname(artifact);
23
+ const intentDir = join(dirname(targetDir), INTENT_DIR);
24
+ loadEnvFile(targetDir);
25
+ const graph = await readArtifact(artifact);
26
+ if (!Object.values(graph.resources).some((node) => node.type === "forgejo")) {
27
+ out.text("no forgejo in the artifact (no control plane) — nothing to adopt");
28
+ out.result({ repos: [], reason: "no control plane" });
29
+ return;
30
+ }
31
+ const { domain, user, adminPasswordRef: ref } = forgejoIdentity(graph);
32
+ const generatedValues = await readGeneratedSecrets(targetDir);
33
+ const password = ref.source === "generated" ? generatedValues[ref.key] : process.env[ref.key];
34
+ if (password === undefined || password === "") {
35
+ throw new Error(`forgejo admin password (${ref.source} secret ${ref.key}) is not available`);
36
+ }
37
+ const desiredStateSecrets = collectSecretValues(graph, process.env, generatedValues);
38
+ const inputs = {
39
+ cliVersion: version,
40
+ user,
41
+ domain,
42
+ configFile: CONFIG_FILE,
43
+ artifactFile: ARTIFACT_FILE,
44
+ intentRepo: INTENT_DIR,
45
+ desiredStateRepo: TARGET_DIR,
46
+ applySecretKeys: Object.keys(desiredStateSecrets).toSorted(),
47
+ forgejoPasswordKey: ref.key,
48
+ };
49
+ await writeControlPlaneWorkflows(intentDir, targetDir, inputs);
50
+ const baseUrl = `https://${domain}`;
51
+ const repos = await adoptRepos({
52
+ baseUrl,
53
+ user,
54
+ password,
55
+ repos: [
56
+ { dir: intentDir, name: INTENT_DIR },
57
+ { dir: targetDir, name: TARGET_DIR },
58
+ ],
59
+ log: out.log,
60
+ });
61
+ const intentSecrets = { [GIT_USER_SECRET]: user, [GIT_TOKEN_SECRET]: password };
62
+ if (desiredStateSecrets["CLOUDFLARE_API_TOKEN"] !== undefined) {
63
+ intentSecrets["CLOUDFLARE_API_TOKEN"] = desiredStateSecrets["CLOUDFLARE_API_TOKEN"];
64
+ }
65
+ await setRepoSecrets({ api: forgejoApi, baseUrl, user, password, owner: user, name: INTENT_DIR, secrets: intentSecrets });
66
+ await setRepoSecrets({ api: forgejoApi, baseUrl, user, password, owner: user, name: TARGET_DIR, secrets: desiredStateSecrets });
67
+ const pushedAt = new Date().toISOString();
68
+ await writeSyncState(targetDir, Object.fromEntries(Object.entries(desiredStateSecrets).map(([key, value]) => [key, { digest: secretDigest(value), pushedAt }])));
69
+ out.text(`set ${Object.keys(intentSecrets).length} secret(s) on ${user}/${INTENT_DIR}, ${Object.keys(desiredStateSecrets).length} on ${user}/${TARGET_DIR}`);
70
+ out.result({
71
+ repos,
72
+ intentSecrets: Object.keys(intentSecrets).toSorted(),
73
+ desiredStateSecrets: Object.keys(desiredStateSecrets).toSorted(),
74
+ });
75
+ },
76
+ });
77
+ //# sourceMappingURL=adopt.command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adopt.command.js","sourceRoot":"","sources":["../../src/adopt/adopt.command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { ForgejoApi } from "@intentic/providers";
2
+ import { type GitRunner } from "@intentic/scaffold";
3
+ export type { GitRunner };
4
+ export interface AdoptRepo {
5
+ readonly dir: string;
6
+ readonly name: string;
7
+ }
8
+ export interface AdoptOptions {
9
+ readonly baseUrl: string;
10
+ readonly user: string;
11
+ readonly password: string;
12
+ readonly repos: readonly AdoptRepo[];
13
+ readonly log: (message: string) => void;
14
+ readonly api?: ForgejoApi;
15
+ readonly git?: GitRunner;
16
+ }
17
+ export declare const adoptRepos: (options: AdoptOptions) => Promise<{
18
+ readonly name: string;
19
+ readonly cloneUrl: string;
20
+ }[]>;
21
+ //# sourceMappingURL=adopt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/adopt/adopt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEhE,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,SAAS;IAEtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAEzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;CAC5B;AAKD,eAAO,MAAM,UAAU,GAAU,SAAS,YAAY,KAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,CA4BtH,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { forgejoApi } from "@intentic/providers";
2
+ import { defaultGit } from "@intentic/scaffold";
3
+ export const adoptRepos = async (options) => {
4
+ const api = options.api ?? forgejoApi;
5
+ const git = options.git ?? defaultGit;
6
+ const { baseUrl, user, password, repos, log } = options;
7
+ const email = `${user}@${new URL(baseUrl).host}`;
8
+ const authHeader = `AUTHORIZATION: basic ${Buffer.from(`${user}:${password}`).toString("base64")}`;
9
+ const pushed = [];
10
+ for (const { dir, name } of repos) {
11
+ const existing = await api.findRepo({ baseUrl, user, password, owner: user, name });
12
+ if (existing === undefined) {
13
+ await api.createRepo({ baseUrl, user, password, owner: user, ownerIsOrg: false, name, private: true, autoInit: false });
14
+ log(`created ${user}/${name} in Forgejo`);
15
+ }
16
+ await git(dir, ["add", "-A"]);
17
+ const status = await git(dir, ["status", "--porcelain"]);
18
+ if (status.stdout.trim() !== "") {
19
+ await git(dir, ["-c", `user.name=${user}`, "-c", `user.email=${email}`, "commit", "-m", "intentic adopt"]);
20
+ }
21
+ await git(dir, ["branch", "-M", "main"]);
22
+ const cloneUrl = `${baseUrl}/${user}/${name}.git`;
23
+ const remotes = (await git(dir, ["remote"])).stdout.split("\n").map((line) => line.trim());
24
+ await git(dir, remotes.includes("origin") ? ["remote", "set-url", "origin", cloneUrl] : ["remote", "add", "origin", cloneUrl]);
25
+ await git(dir, ["-c", `http.extraHeader=${authHeader}`, "push", "-u", "origin", "main"]);
26
+ log(`pushed ${dir} → ${cloneUrl}`);
27
+ pushed.push({ name, cloneUrl });
28
+ }
29
+ return pushed;
30
+ };
31
+ //# sourceMappingURL=adopt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/adopt/adopt.ts"],"names":[],"mappings":"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"}
package/dist/app.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ export declare const app: import("@stricli/core").Application<import("@stricli/core").CommandContext>;
2
+ //# sourceMappingURL=app.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,GAAG,6EAyBf,CAAC"}
package/dist/app.js ADDED
@@ -0,0 +1,46 @@
1
+ import { buildApplication, buildRouteMap, text_en } from "@stricli/core";
2
+ import { addAppCommand } from "./add-app/add-app.command.js";
3
+ import { adopt } from "./adopt/adopt.command.js";
4
+ import { apply } from "./apply/apply.command.js";
5
+ import { deploymentsCommand } from "./deployments/deployments.command.js";
6
+ import { loadConfig } from "./env.config.js";
7
+ import { hostSshTunnel } from "./host-ssh-tunnel/host-ssh-tunnel.command.js";
8
+ import { init } from "./init/init.command.js";
9
+ import { version } from "./lib/version.js";
10
+ import { logsCommand } from "./logs/logs.command.js";
11
+ import { monorepoCommand } from "./monorepo/monorepo.command.js";
12
+ import { planCommand } from "./plan/plan.command.js";
13
+ import { resolveCommand } from "./resolve/resolve.command.js";
14
+ import { restore } from "./restore/restore.command.js";
15
+ import { sandboxTunnel } from "./sandbox-tunnel/sandbox-tunnel.command.js";
16
+ import { secretsCommand } from "./secrets/secrets.command.js";
17
+ const formatException = (exc) => {
18
+ if (exc instanceof Error) {
19
+ return loadConfig().intenticDebug ? (exc.stack ?? exc.message) : exc.message;
20
+ }
21
+ return String(exc);
22
+ };
23
+ export const app = buildApplication(buildRouteMap({
24
+ routes: {
25
+ init,
26
+ monorepo: monorepoCommand,
27
+ addApp: addAppCommand,
28
+ resolve: resolveCommand,
29
+ plan: planCommand,
30
+ apply,
31
+ adopt,
32
+ restore,
33
+ secrets: secretsCommand,
34
+ deployments: deploymentsCommand,
35
+ logs: logsCommand,
36
+ sandboxTunnel,
37
+ hostSshTunnel,
38
+ },
39
+ docs: { brief: "intentic — intent-driven deployment" },
40
+ }), {
41
+ name: "intentic",
42
+ versionInfo: { currentVersion: version },
43
+ scanner: { caseStyle: "allow-kebab-for-camel" },
44
+ localization: { loadText: (locale) => (locale.startsWith("en") ? { ...text_en, formatException } : undefined) },
45
+ });
46
+ //# sourceMappingURL=app.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAM9D,MAAM,eAAe,GAAG,CAAC,GAAY,EAAU,EAAE;IAC7C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,UAAU,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC;AAIF,MAAM,CAAC,MAAM,GAAG,GAAG,gBAAgB,CAC/B,aAAa,CAAC;IACV,MAAM,EAAE;QACJ,IAAI;QACJ,QAAQ,EAAE,eAAe;QACzB,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,WAAW;QACjB,KAAK;QACL,KAAK;QACL,OAAO;QACP,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE,WAAW;QACjB,aAAa;QACb,aAAa;KAChB;IACD,IAAI,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE;CACzD,CAAC,EACF;IACI,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE;IACxC,OAAO,EAAE,EAAE,SAAS,EAAE,uBAAuB,EAAE;IAC/C,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;CAClH,CACJ,CAAC"}
@@ -0,0 +1,16 @@
1
+ import { type DesiredStateGraph, type SecretSource } from "@intentic/graph";
2
+ export interface AccessEntry {
3
+ readonly id: string;
4
+ readonly label: string;
5
+ readonly url: string;
6
+ readonly username?: string;
7
+ readonly password?: {
8
+ readonly source: SecretSource;
9
+ readonly key: string;
10
+ readonly value?: string;
11
+ };
12
+ }
13
+ export declare const collectAccess: (graph: DesiredStateGraph, outputs: Readonly<Record<string, Readonly<Record<string, unknown>>>>, env: Readonly<Record<string, string | undefined>>) => AccessEntry[];
14
+ export declare const formatAccessSummary: (entries: readonly AccessEntry[]) => string;
15
+ export declare const writeAccessFile: (path: string, entries: readonly AccessEntry[]) => Promise<void>;
16
+ //# sourceMappingURL=access.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/apply/access.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAa,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAgBvF,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAG3B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxG;AAKD,eAAO,MAAM,aAAa,GACtB,OAAO,iBAAiB,EACxB,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EACpE,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KAClD,WAAW,EAuBb,CAAC;AAeF,eAAO,MAAM,mBAAmB,GAAI,SAAS,SAAS,WAAW,EAAE,KAAG,MASrE,CAAC;AAWF,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,EAAE,SAAS,SAAS,WAAW,EAAE,KAAG,OAAO,CAAC,IAAI,CAMjG,CAAC"}
@@ -0,0 +1,72 @@
1
+ import { writeFile } from "node:fs/promises";
2
+ import { secretRef } from "@intentic/graph";
3
+ import { renderTemplate } from "../lib/templates.js";
4
+ const SERVICE_LABELS = {
5
+ forgejo: "Forgejo (git)",
6
+ komodo: "Komodo (deploys)",
7
+ signoz: "SignOz (observability)",
8
+ outline: "Outline (wiki)",
9
+ paperless: "Paperless-ngx (documents)",
10
+ openproject: "OpenProject (projects)",
11
+ invoiceninja: "Invoice Ninja (invoicing)",
12
+ infisical: "Infisical (secrets)",
13
+ };
14
+ export const collectAccess = (graph, outputs, env) => {
15
+ const entries = [];
16
+ for (const node of Object.values(graph.resources)) {
17
+ if (node.type !== "deployment" && SERVICE_LABELS[node.type] === undefined) {
18
+ continue;
19
+ }
20
+ const url = outputs[node.id]?.["url"];
21
+ if (typeof url !== "string") {
22
+ continue;
23
+ }
24
+ const username = node.inputs["adminUser"];
25
+ const ref = secretRef(node.inputs["adminPassword"]);
26
+ const value = ref?.source === "generated" ? env[ref.key] : undefined;
27
+ const password = ref === undefined ? undefined : { source: ref.source, key: ref.key, ...(value !== undefined ? { value } : {}) };
28
+ entries.push({
29
+ id: node.id,
30
+ label: SERVICE_LABELS[node.type] ?? node.id,
31
+ url,
32
+ ...(typeof username === "string" ? { username } : {}),
33
+ ...(password !== undefined ? { password } : {}),
34
+ });
35
+ }
36
+ return entries;
37
+ };
38
+ const summaryPassword = (password) => {
39
+ if (password === undefined) {
40
+ return "";
41
+ }
42
+ if (password.source === "generated") {
43
+ return password.value !== undefined
44
+ ? ` password: ${password.value} (saved in .secrets.json)`
45
+ : " password: (generated — see .secrets.json)";
46
+ }
47
+ return ` password: $${password.key}`;
48
+ };
49
+ export const formatAccessSummary = (entries) => {
50
+ const lines = ["", "Access:"];
51
+ for (const entry of entries) {
52
+ lines.push(` ${entry.label} ${entry.url}`);
53
+ if (entry.username !== undefined) {
54
+ lines.push(` user: ${entry.username}${summaryPassword(entry.password)}`);
55
+ }
56
+ }
57
+ return lines.join("\n");
58
+ };
59
+ const markdownPassword = (password) => {
60
+ if (password === undefined) {
61
+ return "";
62
+ }
63
+ return password.source === "generated" ? "generated (see `.secrets.json`)" : `\`$${password.key}\``;
64
+ };
65
+ export const writeAccessFile = async (path, entries) => {
66
+ const services = entries
67
+ .filter((entry) => entry.username !== undefined)
68
+ .map((entry) => ({ label: entry.label, url: entry.url, username: entry.username, password: markdownPassword(entry.password) }));
69
+ const apps = entries.filter((entry) => entry.username === undefined).map((entry) => ({ id: entry.id, url: entry.url }));
70
+ await writeFile(path, renderTemplate("access.md", { services, apps }));
71
+ };
72
+ //# sourceMappingURL=access.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/apply/access.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { SshExecutor, SshTarget } from "@intentic/providers";
2
+ export interface ApplyLock {
3
+ readonly verify: () => Promise<void>;
4
+ readonly renew: () => Promise<void>;
5
+ readonly release: () => Promise<void>;
6
+ }
7
+ export declare const acquireApplyLock: (executor: SshExecutor, targets: readonly SshTarget[], options?: {
8
+ readonly ttlSeconds?: number;
9
+ readonly holder?: string;
10
+ readonly log?: (message: string) => void;
11
+ }) => Promise<ApplyLock>;
12
+ //# sourceMappingURL=apply-lock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply-lock.d.ts","sourceRoot":"","sources":["../../src/apply/apply-lock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAa,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAe7E,MAAM,WAAW,SAAS;IAEtB,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAqED,eAAO,MAAM,gBAAgB,GACzB,UAAU,WAAW,EACrB,SAAS,SAAS,SAAS,EAAE,EAC7B,UAAS;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,KACnH,OAAO,CAAC,SAAS,CA4DnB,CAAC"}
@@ -0,0 +1,102 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { hostname } from "node:os";
3
+ const LOCK_DIR = "/opt/intentic/apply.lock.d";
4
+ const DEFAULT_TTL_SECONDS = 30 * 60;
5
+ const lockKey = (target) => `${target.address}:${target.port}`;
6
+ const orderedHosts = (targets) => {
7
+ const byKey = new Map();
8
+ for (const target of targets) {
9
+ byKey.set(lockKey(target), target);
10
+ }
11
+ return [...byKey.values()].toSorted((a, b) => lockKey(a).localeCompare(lockKey(b)));
12
+ };
13
+ const defaultHolder = () => `${hostname()}:${process.pid}`.replace(/[^A-Za-z0-9_.:@-]/g, "-");
14
+ const header = (op, nonce, ttl) => `#APPLYLOCK ${op} ${nonce} ${ttl}\n`;
15
+ const acquireScript = (holder, nonce, ttl) => `${header("acquire", nonce, ttl)}mkdir -p /opt/intentic 2>/dev/null
16
+ [ -w /opt/intentic ] || { echo "CANNOT_WRITE /opt/intentic"; exit 1; }
17
+ LOCK=${LOCK_DIR}
18
+ META=$LOCK/meta.json
19
+ write() {
20
+ printf '{"holder":"%s","nonce":"%s","expiresAt":%s}\\n' '${holder}' '${nonce}' "$(( $(date +%s) + ${ttl} ))" > "$META"
21
+ chmod 600 "$META" 2>/dev/null || true
22
+ }
23
+ if mkdir "$LOCK" 2>/dev/null; then write; echo ACQUIRED; exit 0; fi
24
+ NOW=$(date +%s)
25
+ EXP=$(sed -n 's/.*"expiresAt":\\([0-9]*\\).*/\\1/p' "$META" 2>/dev/null); [ -z "$EXP" ] && EXP=0
26
+ CUR=$(sed -n 's/.*"holder":"\\([^"]*\\)".*/\\1/p' "$META" 2>/dev/null)
27
+ if [ "$NOW" -ge "$EXP" ]; then write; echo TOOKOVER; exit 0; fi
28
+ echo "HELD $CUR"; exit 1`;
29
+ const verifyScript = (nonce, ttl) => `${header("verify", nonce, ttl)}CUR=$(sed -n 's/.*"nonce":"\\([^"]*\\)".*/\\1/p' ${LOCK_DIR}/meta.json 2>/dev/null)
30
+ [ "$CUR" = '${nonce}' ] && echo OK || echo "LOST $CUR"`;
31
+ const renewScript = (holder, nonce, ttl) => `${header("renew", nonce, ttl)}LOCK=${LOCK_DIR}
32
+ META=$LOCK/meta.json
33
+ CUR=$(sed -n 's/.*"nonce":"\\([^"]*\\)".*/\\1/p' "$META" 2>/dev/null)
34
+ if [ "$CUR" = '${nonce}' ]; then printf '{"holder":"%s","nonce":"%s","expiresAt":%s}\\n' '${holder}' '${nonce}' "$(( $(date +%s) + ${ttl} ))" > "$META"; echo OK; else echo "LOST $CUR"; fi`;
35
+ const releaseScript = (nonce, ttl) => `${header("release", nonce, ttl)}LOCK=${LOCK_DIR}
36
+ META=$LOCK/meta.json
37
+ CUR=$(sed -n 's/.*"nonce":"\\([^"]*\\)".*/\\1/p' "$META" 2>/dev/null)
38
+ if [ "$CUR" = '${nonce}' ]; then rm -f "$META"; rmdir "$LOCK" 2>/dev/null; echo RELEASED; else echo "SKIP $CUR"; fi`;
39
+ const run = async (executor, target, command) => {
40
+ const session = await executor.connect(target);
41
+ try {
42
+ return await session.exec(command);
43
+ }
44
+ finally {
45
+ await session.dispose();
46
+ }
47
+ };
48
+ export const acquireApplyLock = async (executor, targets, options = {}) => {
49
+ const ttl = options.ttlSeconds ?? DEFAULT_TTL_SECONDS;
50
+ const holder = options.holder ?? defaultHolder();
51
+ const nonce = randomBytes(16).toString("hex");
52
+ const log = options.log ?? (() => { });
53
+ const held = [];
54
+ const releaseAll = async () => {
55
+ for (const target of held) {
56
+ try {
57
+ await run(executor, target, releaseScript(nonce, ttl));
58
+ }
59
+ catch (error) {
60
+ log(`apply-lock: failed to release ${lockKey(target)} (it frees after its TTL): ${String(error)}`);
61
+ }
62
+ }
63
+ };
64
+ for (const target of orderedHosts(targets)) {
65
+ let result;
66
+ try {
67
+ result = await run(executor, target, acquireScript(holder, nonce, ttl));
68
+ }
69
+ catch (error) {
70
+ log(`apply-lock: ${lockKey(target)} is not reachable, skipping its lock: ${String(error)}`);
71
+ continue;
72
+ }
73
+ const outcome = result.stdout.trim();
74
+ if (outcome.startsWith("ACQUIRED") || outcome.startsWith("TOOKOVER")) {
75
+ held.push(target);
76
+ continue;
77
+ }
78
+ await releaseAll();
79
+ if (outcome.startsWith("CANNOT_WRITE")) {
80
+ throw new Error(`cannot create /opt/intentic on ${lockKey(target)} — the deploy user lacks write permission on it. Re-run this host's connect script (connect.sh for the sandbox's own machine, connect-host.sh for an enrolled host) — it provisions /opt/intentic for the service user; or create it as root: mkdir -p /opt/intentic && chown <deploy-user> /opt/intentic`);
81
+ }
82
+ const who = outcome.replace(/^HELD\s*/, "");
83
+ throw new Error(`another intentic run holds the apply lock on ${lockKey(target)}${who !== "" ? ` (held by ${who})` : ""} — wait for it to finish, or if it crashed the lock frees after its TTL`);
84
+ }
85
+ return {
86
+ verify: async () => {
87
+ for (const target of held) {
88
+ const result = await run(executor, target, verifyScript(nonce, ttl));
89
+ if (!result.stdout.trim().startsWith("OK")) {
90
+ throw new Error(`apply lock on ${lockKey(target)} was taken over by another run — aborting before mutating to avoid concurrent writers`);
91
+ }
92
+ }
93
+ },
94
+ renew: async () => {
95
+ for (const target of held) {
96
+ await run(executor, target, renewScript(holder, nonce, ttl));
97
+ }
98
+ },
99
+ release: releaseAll,
100
+ };
101
+ };
102
+ //# sourceMappingURL=apply-lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply-lock.js","sourceRoot":"","sources":["../../src/apply/apply-lock.ts"],"names":[],"mappings":"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"}