@intentius/chant-lexicon-terraform 0.124.86 → 0.124.88

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 (72) hide show
  1. package/dist/action-ops.d.ts.map +1 -1
  2. package/dist/action-ops.js +3 -1
  3. package/dist/chant-floors.d.ts +30 -0
  4. package/dist/chant-floors.d.ts.map +1 -0
  5. package/dist/chant-floors.js +29 -0
  6. package/dist/components/capability-plugin.d.ts +15 -1
  7. package/dist/components/capability-plugin.d.ts.map +1 -1
  8. package/dist/components/capability-plugin.js +13 -5
  9. package/dist/components/compose-group.d.ts +5 -1
  10. package/dist/components/compose-group.d.ts.map +1 -1
  11. package/dist/components/compose-group.js +7 -4
  12. package/dist/engine-timings.d.ts +249 -0
  13. package/dist/engine-timings.d.ts.map +1 -0
  14. package/dist/engine-timings.js +569 -0
  15. package/dist/integrity.json +2 -2
  16. package/dist/live-roots.d.ts +93 -0
  17. package/dist/live-roots.d.ts.map +1 -0
  18. package/dist/live-roots.js +206 -0
  19. package/dist/manifest.json +1 -1
  20. package/dist/migration-history.d.ts +105 -0
  21. package/dist/migration-history.d.ts.map +1 -0
  22. package/dist/migration-history.js +159 -0
  23. package/dist/module-catalog/index.d.ts +1 -0
  24. package/dist/module-catalog/index.d.ts.map +1 -1
  25. package/dist/module-catalog/index.js +3 -1
  26. package/dist/op/activities/live-detect.d.ts +15 -0
  27. package/dist/op/activities/live-detect.d.ts.map +1 -1
  28. package/dist/op/activities/live-detect.js +94 -0
  29. package/dist/op/activities/terraform.d.ts +1 -65
  30. package/dist/op/activities/terraform.d.ts.map +1 -1
  31. package/dist/op/activities/terraform.js +4 -54
  32. package/dist/op/command-hook.d.ts +88 -0
  33. package/dist/op/command-hook.d.ts.map +1 -0
  34. package/dist/op/command-hook.js +115 -0
  35. package/dist/registry/index.d.ts +1 -0
  36. package/dist/registry/index.d.ts.map +1 -1
  37. package/dist/registry/index.js +1 -0
  38. package/dist/state/exec.d.ts +23 -0
  39. package/dist/state/exec.d.ts.map +1 -1
  40. package/dist/state/exec.js +38 -0
  41. package/dist/state-ops.d.ts.map +1 -1
  42. package/dist/state-ops.js +3 -1
  43. package/dist/terragrunt/index.d.ts +3 -1
  44. package/dist/terragrunt/index.d.ts.map +1 -1
  45. package/dist/terragrunt/index.js +3 -1
  46. package/dist/terragrunt/place.d.ts +27 -0
  47. package/dist/terragrunt/place.d.ts.map +1 -0
  48. package/dist/terragrunt/place.js +52 -0
  49. package/package.json +2 -2
  50. package/src/action-ops.ts +3 -1
  51. package/src/chant-floors.ts +32 -0
  52. package/src/components/capability-plugin.ts +27 -6
  53. package/src/components/compose-group.test.ts +29 -0
  54. package/src/components/compose-group.ts +12 -5
  55. package/src/components/terraform-apply-command-hook.test.ts +43 -0
  56. package/src/engine-timings.test.ts +203 -0
  57. package/src/engine-timings.ts +718 -0
  58. package/src/live-roots.test.ts +80 -0
  59. package/src/live-roots.ts +244 -0
  60. package/src/migration-history.test.ts +83 -0
  61. package/src/migration-history.ts +199 -0
  62. package/src/module-catalog/index.ts +4 -1
  63. package/src/op/activities/live-detect.ts +87 -0
  64. package/src/op/activities/terraform.ts +12 -111
  65. package/src/op/command-hook.ts +182 -0
  66. package/src/registry/index.ts +1 -0
  67. package/src/state/engine-env.test.ts +18 -0
  68. package/src/state/exec.ts +38 -0
  69. package/src/state-ops.ts +3 -1
  70. package/src/terragrunt/index.ts +3 -1
  71. package/src/terragrunt/place.test.ts +42 -0
  72. package/src/terragrunt/place.ts +75 -0
@@ -1 +1 @@
1
- {"version":3,"file":"action-ops.d.ts","sourceRoot":"","sources":["../src/action-ops.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"action-ops.d.ts","sourceRoot":"","sources":["../src/action-ops.ts"],"names":[],"mappings":"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"}
@@ -47,6 +47,7 @@ import { terraformChangeSetPart } from "./change-set.js";
47
47
  import { DEFAULT_LOCK_TIMEOUT, lockTimeoutArgs } from "./lock-timeout.js";
48
48
  import { lastLines, runBinary } from "./state/exec.js";
49
49
  import { gatedStateOp, StateOpError, StateOpWaitingError } from "./state-ops.js";
50
+ import { actorFromEnv } from "@intentius/chant/actor";
50
51
  /** The op an action's request waits at. */
51
52
  export const ACTION_OP = "tf-action";
52
53
  /** The request kind of an action. */
@@ -224,7 +225,8 @@ export async function invokeAction(input) {
224
225
  }
225
226
  }
226
227
  }
227
- const actorOf = (env) => env.GITHUB_ACTOR || env.GITLAB_USER_LOGIN || env.USER || env.USERNAME || "unknown";
228
+ /** Who asks when the caller names nobody: core's actor fallback (#4911). */
229
+ const actorOf = (env) => actorFromEnv(env);
228
230
  function stepInvoke(input) {
229
231
  const cwd = input.cwd ?? process.cwd();
230
232
  const commit = input.commit ?? (process.env.GITHUB_SHA || process.env.CI_COMMIT_SHA || undefined);
@@ -0,0 +1,30 @@
1
+ /**
2
+ * The chant floors of the terraform lexicon's parts (#4916): for each part a
3
+ * product may feature-detect on, the first chant release whose lexicon has
4
+ * it. Lexicons release with chant at the same version, so each is a chant
5
+ * version, and chant core's floor table (`@intentius/chant/floor-table`)
6
+ * lists them beside core's, which `chant dev dead-guards` reads.
7
+ *
8
+ * Only this file is read for the table: the `_FLOOR` constants elsewhere in
9
+ * the lexicon name versions of other tools (`NEXUS_HOSTED_FLOOR` in
10
+ * ./registry/targets/nexus.ts is a Nexus version). The entries that serve a
11
+ * part re-export its floor by name, so the table names those subpaths too.
12
+ *
13
+ * This file imports nothing, so an entry that must stay light (./module-catalog)
14
+ * can re-export from it.
15
+ */
16
+ /**
17
+ * The first chant whose terraform lexicon has `moduleConsumers`, the scan of
18
+ * every registry module call a root makes, with `readRegistryCatalog` and
19
+ * `deprecatedPins` beside it on `./registry` (#4599).
20
+ */
21
+ export declare const MODULE_CONSUMERS_FLOOR = "0.124.55";
22
+ /**
23
+ * The first chant whose terraform lexicon has `usedSources`, every module
24
+ * source and provider address a root uses, with `moduleSourceForms`,
25
+ * `providerAddressForms` and `lockedProviders` on `./registry` (#3924).
26
+ */
27
+ export declare const USED_SOURCES_FLOOR = "0.124.55";
28
+ /** The first chant whose terraform lexicon has `./module-catalog`, the known-module catalog TF047 reads (#4560). */
29
+ export declare const MODULE_CATALOG_FLOOR = "0.124.55";
30
+ //# sourceMappingURL=chant-floors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chant-floors.d.ts","sourceRoot":"","sources":["../src/chant-floors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,oHAAoH;AACpH,eAAO,MAAM,oBAAoB,aAAa,CAAC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * The chant floors of the terraform lexicon's parts (#4916): for each part a
3
+ * product may feature-detect on, the first chant release whose lexicon has
4
+ * it. Lexicons release with chant at the same version, so each is a chant
5
+ * version, and chant core's floor table (`@intentius/chant/floor-table`)
6
+ * lists them beside core's, which `chant dev dead-guards` reads.
7
+ *
8
+ * Only this file is read for the table: the `_FLOOR` constants elsewhere in
9
+ * the lexicon name versions of other tools (`NEXUS_HOSTED_FLOOR` in
10
+ * ./registry/targets/nexus.ts is a Nexus version). The entries that serve a
11
+ * part re-export its floor by name, so the table names those subpaths too.
12
+ *
13
+ * This file imports nothing, so an entry that must stay light (./module-catalog)
14
+ * can re-export from it.
15
+ */
16
+ /**
17
+ * The first chant whose terraform lexicon has `moduleConsumers`, the scan of
18
+ * every registry module call a root makes, with `readRegistryCatalog` and
19
+ * `deprecatedPins` beside it on `./registry` (#4599).
20
+ */
21
+ export const MODULE_CONSUMERS_FLOOR = "0.124.55";
22
+ /**
23
+ * The first chant whose terraform lexicon has `usedSources`, every module
24
+ * source and provider address a root uses, with `moduleSourceForms`,
25
+ * `providerAddressForms` and `lockedProviders` on `./registry` (#3924).
26
+ */
27
+ export const USED_SOURCES_FLOOR = "0.124.55";
28
+ /** The first chant whose terraform lexicon has `./module-catalog`, the known-module catalog TF047 reads (#4560). */
29
+ export const MODULE_CATALOG_FLOOR = "0.124.55";
@@ -149,6 +149,7 @@ import { type PlanShapeArtifact } from "@intentius/chant/components/covered-roun
149
149
  import { type CapabilityPlugin } from "@intentius/chant/components/capability-plugin";
150
150
  import type { EngineOutputSource, EnginePlannedOutputs } from "@intentius/chant/components/verbs/member-outputs";
151
151
  import { type TerraformCommandHook } from "../op/activities/terraform.js";
152
+ import { type ComposeGroupDeps } from "./compose-group.js";
152
153
  import { type TerraformStateRead } from "../state-reads.js";
153
154
  /** The `terraform-apply` step's input. */
154
155
  export interface TerraformApplyStepInput {
@@ -213,9 +214,22 @@ export interface TerraformApplyDeps {
213
214
  * and `output` of each upstream its `reads` name. The hook sees the
214
215
  * command's name, args, directory and environment, may add variables to
215
216
  * it, and its `after` gets the exit code, duration and output. Roots a
216
- * wave runs at once (chant#4864) each see their own commands.
217
+ * wave runs at once (chant#4864) each see their own commands. A composed
218
+ * group's `init`, `plan`, `show` and `apply` (`terraform.compose`) go
219
+ * through it too, as commands for all the group's roots: `members` names
220
+ * them and `root` is the first (chant#4887). `engineTimings()`
221
+ * (`../engine-timings.ts`) is a hook that times each root and collects the
222
+ * engine's spans.
217
223
  */
218
224
  onCommand?: TerraformCommandHook;
225
+ /**
226
+ * The composed group's deps (`terraform.compose`), such as the project,
227
+ * the identities and the environment its run takes, in place of the
228
+ * defaults (chant#4887). A product that spread `composeGroup(...)`'s
229
+ * methods over this capability passes its deps here instead, so the
230
+ * group's commands go through `onCommand` too.
231
+ */
232
+ compose?: ComposeGroupDeps;
219
233
  }
220
234
  export type { TerraformCommand, TerraformCommandHook, TerraformCommandResult, TerraformCommandRun } from "../op/activities/terraform.js";
221
235
  /** What `terraform-apply` returns. `outputs` is what a dependent's `stackOutput()` reads. */
@@ -1 +1 @@
1
- {"version":3,"file":"capability-plugin.d.ts","sourceRoot":"","sources":["../../src/components/capability-plugin.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"capability-plugin.d.ts","sourceRoot":"","sources":["../../src/components/capability-plugin.ts"],"names":[],"mappings":"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"}
@@ -159,7 +159,7 @@ import { terraformDefaultLockGrain, terraformLockGrainRefusal, terraformLockRows
159
159
  import { rootRowKey } from "@intentius/chant/lifecycle/lock-rows";
160
160
  import { rootTexts } from "../compose/hcl.js";
161
161
  import { declaredVariables } from "../compose/root.js";
162
- import { terraformComposeGroup } from "./compose-group.js";
162
+ import { composeGroup, terraformComposeGroup } from "./compose-group.js";
163
163
  import { markPlaceholderDriven, placeholderVars, waitingHole } from "./placeholder-preview.js";
164
164
  import { terraformReleaseInputs } from "./release-inputs.js";
165
165
  import { terraformTraceFacts } from "./trace-facts.js";
@@ -563,15 +563,23 @@ export function terraformApplyCapabilityWith(deps = {}) {
563
563
  return cap;
564
564
  // chant#4865: each method that runs the engine for a root runs it through the product's hook, as commands for that root.
565
565
  const scope = (method, step) => ({ root: typeof step?.root === "string" ? step.root : "", method });
566
+ // chant#4887: a composed group's commands run once for all its members; the hook sees them as commands for each, `root` the first.
567
+ const groupScope = (method, members) => {
568
+ const roots = [...new Set(members.map((m) => (typeof m.step?.root === "string" ? m.step.root : "")).filter((r) => r !== ""))].sort();
569
+ return { root: roots[0] ?? "", members: roots, method };
570
+ };
566
571
  return {
567
572
  ...cap,
568
573
  plan: (ctx, step) => withTerraformCommandHook(hook, scope("plan", step), () => cap.plan(ctx, step)),
569
574
  run: (ctx, step) => withTerraformCommandHook(hook, scope("run", step), () => cap.run(ctx, step)),
570
575
  outputs: (ctx, step) => withTerraformCommandHook(hook, scope("outputs", step), () => cap.outputs(ctx, step)),
576
+ planGroup: (ctx, members) => withTerraformCommandHook(hook, groupScope("plan", members), () => cap.planGroup(ctx, members)),
577
+ runGroup: (ctx, run, members) => withTerraformCommandHook(hook, groupScope("run", members), () => cap.runGroup(ctx, run, members)),
571
578
  };
572
579
  }
573
580
  /** The step's methods with `deps.resolveRoot`, before {@link terraformApplyCapabilityWith} puts its command hook around them. */
574
581
  function terraformApplyMethods(deps) {
582
+ const group = deps.compose ? composeGroup(deps.compose) : terraformComposeGroup;
575
583
  return {
576
584
  kind: "terraform-apply",
577
585
  // A root's apply has no undo short of applying the previous configuration,
@@ -638,11 +646,11 @@ function terraformApplyMethods(deps) {
638
646
  },
639
647
  // #4447 (ws-107): a group core forms of components that read each other plans and applies as one composed run
640
648
  // when `terraform.compose.enabled` is set (./compose-group.ts). Delegates, so the methods are read when called.
641
- groupReads: (ctx, members) => terraformComposeGroup.groupReads(ctx, members),
649
+ groupReads: (ctx, members) => group.groupReads(ctx, members),
642
650
  // #4542: a member pointed at a release's recorded copy plans alone, since a composition reads the declared roots.
643
651
  groupFallback: async (ctx, members) => members.some((m) => typeof m.step.dir === "string")
644
652
  ? { kind: "release-copy", reason: "a member deploys a release's recorded copy of its root, which a composition does not read" }
645
- : terraformComposeGroup.groupFallback(ctx, members),
653
+ : group.groupFallback(ctx, members),
646
654
  // #4542: the root's files, which a release cut records and a promote under it plans.
647
655
  releaseInputs: (input, ctx) => terraformReleaseInputs(input, ctx),
648
656
  // #4552: resource under choudoufu, the root under Terraform, tofu and Terragrunt, which refuse resource by name.
@@ -673,13 +681,13 @@ function terraformApplyMethods(deps) {
673
681
  for (const m of members)
674
682
  if (m.input)
675
683
  withContextCwd(m.ctx ?? ctx, m.input);
676
- return terraformComposeGroup.planGroup(ctx, members);
684
+ return group.planGroup(ctx, members);
677
685
  },
678
686
  runGroup: (ctx, run, members) => {
679
687
  for (const m of members)
680
688
  if (m.input)
681
689
  withContextCwd(m.ctx ?? ctx, m.input);
682
- return terraformComposeGroup.runGroup(ctx, run, members);
690
+ return group.runGroup(ctx, run, members);
683
691
  },
684
692
  async run(ctx, step) {
685
693
  const input = await filledInput(deps.resolveRoot, ctx, step);
@@ -80,7 +80,11 @@ export interface ComposeGroupDeps {
80
80
  * `declaredTargetCloudIdentity` from the project root.
81
81
  */
82
82
  identity?: (projectRoot: string, env: string) => Promise<TargetCloudIdentityLookup | undefined>;
83
- /** How `choudoufu version` runs. Default `runBinary`. */
83
+ /**
84
+ * How the binary runs: `choudoufu version`, and the composed run's own
85
+ * commands when `runner` is not given. Default `runBinary`. Either way each
86
+ * run goes through the step's command hook (chant#4887).
87
+ */
84
88
  exec?: BinaryExec;
85
89
  /** A root's outputs as its state holds them, for a member whose part of the working state could not be shown. Default `terraformOutputs`. */
86
90
  outputs?: (root: string) => Promise<Record<string, unknown>>;
@@ -1 +1 @@
1
- {"version":3,"file":"compose-group.d.ts","sourceRoot":"","sources":["../../src/components/compose-group.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"compose-group.d.ts","sourceRoot":"","sources":["../../src/components/compose-group.ts"],"names":[],"mappings":"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"}
@@ -45,6 +45,7 @@ import { declaredTargetCloudIdentity } from "@intentius/chant/workspace/ci-cloud
45
45
  import { COMPOSE_STEP_KIND, composeOff, compositionIfEnabled, identityKey, rootHclReads } from "../compose.js";
46
46
  import { terraformBinary, terraformOutputs } from "../op/activities/terraform.js";
47
47
  import { runBinary } from "../state/exec.js";
48
+ import { hookedBinaryExec } from "../op/command-hook.js";
48
49
  import { estateVersionFallback, EstateRun } from "../compose/estate.js";
49
50
  import { ComposedRun } from "../compose/run.js";
50
51
  import { relPath, rootTexts } from "../compose/hcl.js";
@@ -55,11 +56,12 @@ async function loadProject(cwd) {
55
56
  const terraform = config.terraform;
56
57
  return { projectRoot, terraform: { ...(terraform ?? {}), roots: terraform?.roots ?? {} } };
57
58
  }
58
- function defaultRunner(o, log) {
59
+ function defaultRunner(o, exec, log) {
59
60
  if (o.composition.estate) {
60
- return new EstateRun({ projectRoot: o.projectRoot, composition: o.composition, terraform: o.terraform, env: o.env, work: o.work, ...(log ? { log } : {}) });
61
+ return new EstateRun({ projectRoot: o.projectRoot, composition: o.composition, terraform: o.terraform, env: o.env, work: o.work, exec, ...(log ? { log } : {}) });
61
62
  }
62
63
  return new ComposedRun({
64
+ exec,
63
65
  projectRoot: o.projectRoot,
64
66
  composition: o.composition,
65
67
  terraform: o.terraform,
@@ -262,7 +264,8 @@ export class ComposedPlanMovedError extends Error {
262
264
  /** The group methods, with `deps` in place of the defaults. */
263
265
  export function composeGroup(deps = {}) {
264
266
  const project = deps.project ?? loadProject;
265
- const exec = deps.exec ?? runBinary;
267
+ // chant#4887: the composed group's commands go through the step's command hook, as a plain root's do.
268
+ const exec = hookedBinaryExec(deps.exec ?? runBinary);
266
269
  const envOf = () => deps.env ?? process.env;
267
270
  const log = deps.log ?? ((line) => console.error(line));
268
271
  const readOutputs = deps.outputs ?? ((root) => terraformOutputs({ root }));
@@ -299,7 +302,7 @@ export function composeGroup(deps = {}) {
299
302
  env: envOf(),
300
303
  work,
301
304
  };
302
- const runner = deps.runner ? deps.runner(o) : defaultRunner(o, log);
305
+ const runner = deps.runner ? deps.runner(o) : defaultRunner(o, exec, log);
303
306
  try {
304
307
  return await fn(runner);
305
308
  }
@@ -0,0 +1,249 @@
1
+ import type { TerraformCommandHook } from "./op/command-hook.js";
2
+ /** One resource instance's time, from its plan or apply span. */
3
+ export interface EngineResourceTiming {
4
+ address: string;
5
+ type?: string;
6
+ action?: string;
7
+ /** The provider instance it is planned with. */
8
+ provider?: string;
9
+ ms: number;
10
+ /** The part of it spent refreshing the resource. */
11
+ refresh_ms?: number;
12
+ }
13
+ /** One provider RPC's time. */
14
+ export interface EngineProviderCall {
15
+ /** The RPC method: `PlanResourceChange`, `ReadResource`, `GetProviderSchema`... */
16
+ method: string;
17
+ provider?: string;
18
+ type?: string;
19
+ /** The resource instance it was made for, when it was made for one. */
20
+ address?: string;
21
+ ms: number;
22
+ }
23
+ /** A choudoufu aggregate span: resources or calls summed past its span budget. */
24
+ export interface EngineAggregate {
25
+ /** The name of the spans it stands for, such as `Plan resource instance changes`, or `other`. */
26
+ of: string;
27
+ /** `resource_instance` or `provider_call`. */
28
+ kind?: string;
29
+ type?: string;
30
+ provider?: string;
31
+ method?: string;
32
+ count: number;
33
+ /** How many of them also have a span of their own. */
34
+ detailed: number;
35
+ /** Their total time. */
36
+ ms: number;
37
+ max_ms: number;
38
+ /** The slowest member: an address, or a resource type. */
39
+ slowest?: string;
40
+ /** For `other`: how many groups it folds. */
41
+ groups?: number;
42
+ }
43
+ /** A wait for a state lock, from the engine's `State lock wait` span. */
44
+ export interface EngineLockWait {
45
+ backend?: string;
46
+ operation?: string;
47
+ attempts?: number;
48
+ ms: number;
49
+ }
50
+ /** One root's timings. The field names are the ones terragucci's report has written since its schema's minor 3. */
51
+ export interface EngineRootTimings {
52
+ /** The root's engine commands together: init, plan and show, and on an apply the apply and output. */
53
+ seconds: number;
54
+ /** The engine's plan runs alone. Absent when the root never reached one. */
55
+ plan_seconds?: number;
56
+ /** The engine's apply runs alone. Absent when the root was not applied. */
57
+ apply_seconds?: number;
58
+ /**
59
+ * Where the times come from: `binary`, each run of the binary was timed;
60
+ * `terragrunt`, Terragrunt ran the binary and its run report gives the
61
+ * unit's times. Absent means `binary`.
62
+ */
63
+ source?: "binary" | "terragrunt";
64
+ /** How many spans the binary sent for the commands counted. */
65
+ spans: number;
66
+ /** `resources`: a span per resource instance; `aggregate`: summed by type only; `none`: nothing per resource. */
67
+ detail: "resources" | "aggregate" | "none";
68
+ /** Why the lists are empty or partial. */
69
+ note?: string;
70
+ /** The slowest resource instances, slowest first. */
71
+ resources: EngineResourceTiming[];
72
+ provider_calls: EngineProviderCall[];
73
+ /** Provider start-up, by provider. */
74
+ provider_init: {
75
+ provider: string;
76
+ count: number;
77
+ ms: number;
78
+ max_ms: number;
79
+ }[];
80
+ /** Waits for a state lock. */
81
+ lock_waits: EngineLockWait[];
82
+ aggregates: EngineAggregate[];
83
+ }
84
+ /** A run's slowest roots and resources. */
85
+ export interface EngineRunTimings {
86
+ /** Every timed root, slowest first. */
87
+ roots: {
88
+ root: string;
89
+ seconds: number;
90
+ plan_seconds?: number;
91
+ apply_seconds?: number;
92
+ source?: EngineRootTimings["source"];
93
+ detail: EngineRootTimings["detail"];
94
+ }[];
95
+ /** The slowest resource instances across the run. */
96
+ resources: {
97
+ root: string;
98
+ address: string;
99
+ type?: string;
100
+ ms: number;
101
+ }[];
102
+ /** Why the run has no per-root timings, when it has none. */
103
+ note?: string;
104
+ }
105
+ export type SpanValue = string | number | boolean;
106
+ /** One span as the binary sent it, with only what the report reads. */
107
+ export interface CollectedSpan {
108
+ spanId: string;
109
+ parentSpanId?: string;
110
+ name: string;
111
+ start: bigint;
112
+ end: bigint;
113
+ attributes: Record<string, SpanValue>;
114
+ error?: boolean;
115
+ }
116
+ /** The spans of an `ExportTraceServiceRequest` in protobuf. */
117
+ export declare function decodeTracesProto(buf: Buffer): CollectedSpan[];
118
+ /** The spans of an `ExportTraceServiceRequest` in OTLP/JSON. */
119
+ export declare function decodeTracesJson(body: unknown): CollectedSpan[];
120
+ /** The header whose token says which run of the binary a batch of spans came from. */
121
+ export declare const ENGINE_RUN_HEADER = "x-chant-run";
122
+ /** Where a batch is forwarded: the product's own collector. */
123
+ export interface SpanForward {
124
+ url: string;
125
+ headers?: Record<string, string>;
126
+ }
127
+ /**
128
+ * A loopback OTLP/HTTP trace endpoint for one run. It never holds the
129
+ * process open, and a request it cannot read is answered and dropped. Spans
130
+ * are kept by the key {@link SpanReceiver.exporter} was given.
131
+ */
132
+ export declare class SpanReceiver {
133
+ private readonly forward?;
134
+ private readonly fetchFn;
135
+ private server?;
136
+ private url;
137
+ private readonly runs;
138
+ private readonly spans;
139
+ private readonly forwards;
140
+ /** Batches that could not be read, with why. */
141
+ readonly unreadable: string[];
142
+ /** `forward`: a collector that also gets every batch the binary sends, unchanged. */
143
+ constructor(forward?: SpanForward | undefined, fetchFn?: typeof fetch);
144
+ /** Start listening. Undefined when it is up; the problem when it could not start. */
145
+ listen(): Promise<string | undefined>;
146
+ get listening(): boolean;
147
+ /** The variables one run of the binary gets so its spans come here, kept under `key`; none when the receiver is not listening. */
148
+ exporter(key: string): Record<string, string>;
149
+ /** The spans the runs exported under `key` sent. */
150
+ spansOf(key: string): CollectedSpan[];
151
+ private handle;
152
+ private relay;
153
+ /** Stop listening, once every forwarded batch is answered. Returns the forwards that failed. */
154
+ close(): Promise<string[]>;
155
+ }
156
+ /** How many of each list a root's timings keep. */
157
+ export declare const TOP = 10;
158
+ export interface RootFacts {
159
+ /** The binary's name, for the notes. */
160
+ binary: string;
161
+ /** The root's wall time, init and show included. */
162
+ seconds: number;
163
+ /** The binary's plan run. Absent when the root never reached it. */
164
+ planSeconds?: number;
165
+ /** A tf-apply wave's apply run. Absent when the root was not applied. */
166
+ applySeconds?: number;
167
+ /** `terragrunt`: Terragrunt ran the binary, so the times are its run report's; the spans are its plan's, through a `TG_TF_PATH` wrapper the product sets. */
168
+ source?: "binary" | "terragrunt";
169
+ }
170
+ /** A root's timings from the spans its plan sent. */
171
+ export declare function rootTimings(spans: CollectedSpan[], facts: RootFacts): EngineRootTimings;
172
+ /** The run's slowest roots and resources, from each root's timings. */
173
+ export declare function runTimings(roots: {
174
+ path: string;
175
+ timings?: EngineRootTimings;
176
+ }[], note?: string): EngineRunTimings;
177
+ /** `850ms`, `3.2s`, `2m05s`. */
178
+ export declare function duration(msValue: number): string;
179
+ /** One engine command a root ran, as {@link EngineTimings} timed it. */
180
+ export interface EngineCommandTiming {
181
+ /** The subcommand: `init`, `plan`, `show`, `apply`, `output`, `live-plan-set`... */
182
+ command: string;
183
+ /** The step method it ran in: `plan`, `run` or `outputs`. */
184
+ method: string;
185
+ seconds: number;
186
+ code: number | null;
187
+ }
188
+ /** A root's timings with the commands they came from. */
189
+ export interface EngineRoot extends EngineRootTimings {
190
+ root: string;
191
+ /** Each engine command the root ran, in order; an upstream's reads for it are left out. */
192
+ commands: EngineCommandTiming[];
193
+ /** The engine's init runs alone. */
194
+ init_seconds?: number;
195
+ /** For a member of a composed group: every member, this one included. Its times and spans are the group's. */
196
+ composed?: string[];
197
+ }
198
+ export interface EngineTimingsOptions {
199
+ /** A collector each batch of the engine's spans is forwarded to, unchanged: the product's own, when it sends a trace. */
200
+ forward?: SpanForward;
201
+ fetch?: typeof fetch;
202
+ /**
203
+ * The product's own hook, run first for each command (its trace span, say).
204
+ * Its variables are laid under the receiver's, and its `after` runs before
205
+ * the timing is kept.
206
+ */
207
+ inner?: TerraformCommandHook;
208
+ /** The commands whose spans count. Default `plan` and `apply`. */
209
+ spanCommands?: readonly string[];
210
+ /** The binary's name, for the notes. Default the name each command ran. */
211
+ binary?: string;
212
+ /** Leave the span receiver off: commands are still timed. */
213
+ noSpans?: boolean;
214
+ }
215
+ /**
216
+ * The engine timings of one run (chant#4887): {@link EngineTimings.onCommand}
217
+ * goes in `terraformApplyCapabilityWith({ onCommand })`, and once the wave
218
+ * ran, {@link EngineTimings.roots} gives each root's timings and
219
+ * {@link EngineTimings.run} the run's slowest roots and resources. Call
220
+ * {@link EngineTimings.close} once, after the last command.
221
+ */
222
+ export declare class EngineTimings {
223
+ private readonly options;
224
+ private readonly receiver;
225
+ /** Why the engine's spans are not collected, when the receiver could not listen. Commands are timed all the same. */
226
+ readonly problem?: string;
227
+ private readonly commands;
228
+ private readonly groups;
229
+ private readonly binaries;
230
+ private readonly spanCommands;
231
+ private constructor();
232
+ /** Start the receiver (unless `noSpans`) and answer the timings. Never throws: a receiver that cannot listen leaves `problem` set. */
233
+ static start(options?: EngineTimingsOptions): Promise<EngineTimings>;
234
+ /** Batches of spans that could not be read, with why. */
235
+ get unreadable(): readonly string[];
236
+ /** The hook to pass as `onCommand`. */
237
+ readonly onCommand: TerraformCommandHook;
238
+ /** One root's timings, or undefined when it ran no command. */
239
+ root(root: string): EngineRoot | undefined;
240
+ /** Every root that ran a command, by root. */
241
+ roots(): Record<string, EngineRoot>;
242
+ /** The run's slowest roots and resources; a composed group's resources count once. */
243
+ run(note?: string): EngineRunTimings;
244
+ /** Stop the receiver, once every forwarded batch is answered. Returns the forwards that failed. */
245
+ close(): Promise<string[]>;
246
+ }
247
+ /** {@link EngineTimings.start}: the engine timings of one run, whose `onCommand` goes in `terraformApplyCapabilityWith`. */
248
+ export declare function engineTimings(options?: EngineTimingsOptions): Promise<EngineTimings>;
249
+ //# sourceMappingURL=engine-timings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-timings.d.ts","sourceRoot":"","sources":["../src/engine-timings.ts"],"names":[],"mappings":"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"}