@intentius/chant 0.57.0 → 0.59.0

package/dist/op/builders.d.ts

@@ -1,7 +1,14 @@
 import { OpResource } from "./resource.js";
 import type { OpConfig, PhaseDefinition, StepDefinition, ActivityStep, GateStep, EffectStep } from "./types.js";
 import { type EffectReceiptDeclaration } from "../effect-receipt.js";
-import { type StepOutputRef } from "./step-output-ref.js";
+import { type StepOutputRef, type WithStepRefs } from "./step-output-ref.js";
+import type { ChantBuildArgs } from "./activities/build.js";
+import type { ShellCmdArgs } from "./activities/shell.js";
+import type { WaitForStackArgs } from "./activities/wait.js";
+import type { EnvTeardownArgs } from "./activities/env-teardown.js";
+import type { HttpCheckArgs } from "./activities/http-check.js";
+import type { PolicyGateArgs } from "./activities/policy.js";
+import type { GuardValidateArgs } from "./activities/guard-validate.js";
 /** An `activity()` result — the plain `ActivityStep` shape plus the `.out` reference sugar (#1290). */
 export interface NamedActivityStep extends ActivityStep {
     /**
@@ -13,7 +20,7 @@ export interface NamedActivityStep extends ActivityStep {
     readonly out: Record<string, StepOutputRef>;
 }
 /**
- * Declare a named, phased Temporal workflow.
+ * Declare a named, phased Op.
  *
  * @example
  * ```ts
@@ -26,6 +33,10 @@ export interface NamedActivityStep extends ActivityStep {
  *   ],
  * });
  * ```
+ *
+ * A `schedule` may be supplied for an Op that runs on a cadence (#2120); its
+ * cron is validated here, at construction, so a typo fails on `chant build`
+ * rather than becoming a schedule that silently never fires.
  */
 export declare function Op(config: OpConfig): InstanceType<typeof OpResource>;
 /** Define a named execution phase containing one or more steps. */
@@ -47,8 +58,13 @@ export declare function activity(fn: string, args?: Record<string, unknown>, opt
     profile?: ActivityStep["profile"];
     id?: string;
 }): NamedActivityStep;
-/** Insert a human gate — the workflow pauses until the named signal is received. */
-export declare function gate(signalName: string, opts?: {
+/**
+ * Insert a human gate. A gate is a fact on the gate ledger, not a wait: a run
+ * that reaches this step with no resolution newer than its pending fact
+ * records the pending fact and ends `gated`. `chant approve <op> <gate>`
+ * writes the resolution, and the next run walks through carrying the approver.
+ */
+export declare function gate(name: string, opts?: {
     timeout?: string;
     description?: string;
 }): GateStep;
@@ -67,9 +83,10 @@ export declare function gate(signalName: string, opts?: {
  * would sever the step from the declaration that lint, plan, and the lexicon
  * row all key on.
  *
- * A gate authored inside `steps` pauses only when the effect will fire (the
- * matched path never reaches it). The receipt-store activities (`receiptRead`,
- * `receiptWrite`) are provided by the receipt row's lexicon (#1835, aws).
+ * A gate authored inside `steps` is reached only when the effect will fire
+ * (the matched path never reaches it). The receipt-store activities
+ * (`receiptRead`, `receiptWrite`) are provided by the receipt row's lexicon
+ * (#1835, aws).
  *
  * @example
  * ```ts
@@ -100,8 +117,22 @@ export declare function takeProfileAndId(opts: (Record<string, unknown> & {
     profile?: ActivityStep["profile"];
     id?: string;
 };
-/** Run an npm build script in the given project directory. `opts.script` selects the script (default `build`, e.g. `build:aws`); `opts.env` adds env vars. */
-export declare const build: (path: string, opts?: Record<string, unknown>) => ActivityStep;
+/**
+ * Extra opts every typed base-activity wrapper below accepts alongside its
+ * activity's own fields: the step's `profile` override and its `id` (which
+ * routes to the step, never into args, so `.out` works — chant #1290).
+ */
+type StepOpts = {
+    profile?: ActivityStep["profile"];
+    id?: string;
+};
+/**
+ * Run an npm build script in the given project directory. `opts` is
+ * {@link ChantBuildArgs} itself, minus the positional `path` — `script`
+ * selects the npm script (default `build`, e.g. `build:aws`), `env` adds
+ * env vars.
+ */
+export declare const build: (path: string, opts?: WithStepRefs<Omit<ChantBuildArgs, "path">> & StepOpts) => NamedActivityStep;
 /** Run `kubectl apply -f <manifest>`. Defaults to the `longInfra` profile (override via `opts.profile`). */
 export declare const kubectlApply: (manifest: string, opts?: Record<string, unknown>) => ActivityStep;
 /** Run `helm upgrade --install`. Defaults to the `longInfra` profile (override via `opts.profile`). */
@@ -123,23 +154,30 @@ export declare const helmInstallPinned: (name: string, contentDigest: string, op
     profile?: ActivityStep["profile"];
     [k: string]: unknown;
 }) => ActivityStep;
-/** Poll for stack readiness (kubectl rollout, CloudFormation complete, etc). Defaults to the `k8sWait` profile (override via `opts.profile`). */
-export declare const waitForStack: (name: string, opts?: Record<string, unknown>) => ActivityStep;
+/**
+ * Poll until a Kubernetes Deployment/StatefulSet is fully rolled out. `opts` is
+ * {@link WaitForStackArgs} itself, minus the positional `name`. Defaults to the
+ * `k8sWait` profile (override via `opts.profile`).
+ */
+export declare const waitForStack: (name: string, opts?: WithStepRefs<Omit<WaitForStackArgs, "name">> & StepOpts) => NamedActivityStep;
 /** Poll any operator-backed Kubernetes resource until it reports ready, driven by a data-only readiness spec (CRD-aware; #365). Defaults to the `k8sWait` profile (override via `opts.profile`). */
 export declare const waitForReady: (kind: string, name: string, opts?: Record<string, unknown>) => ActivityStep;
 /** Trigger and wait for a GitLab CI pipeline to complete. Defaults to the `longInfra` profile (override via `opts.profile`). */
 export declare const gitlabPipeline: (name: string, opts?: Record<string, unknown>) => ActivityStep;
-/** Take a chant lifecycle snapshot for the given environment. */
-export declare const lifecycleSnapshot: (env: string) => ActivityStep;
+/**
+ * Take a chant lifecycle snapshot for the given environment.
+ * {@link LifecycleSnapshotArgs} has only `env`, which is positional here, so
+ * `opts` carries nothing but the step's `id` (for `.out`).
+ */
+export declare const lifecycleSnapshot: (env: string, opts?: {
+    id?: string;
+}) => NamedActivityStep;
 /**
  * Run an arbitrary shell command. Tag long-running commands with a `profile`
  * (e.g. `longInfra` for a multi-GB image push) so they get the right
- * start-to-close timeout under both the local executor and Temporal.
+ * start-to-close timeout on whichever runtime hosts the run.
  */
-export declare const shell: (cmd: string, opts?: {
-    env?: Record<string, string>;
-    profile?: ActivityStep["profile"];
-}) => ActivityStep;
+export declare const shell: (cmd: string, opts?: WithStepRefs<Omit<ShellCmdArgs, "cmd">> & StepOpts) => NamedActivityStep;
 /**
  * Ensure a `generated-once` secret exists in the target store (#1829, epic
  * #1365). The op-step surface over the same engine as the `ensure-secret`
@@ -158,8 +196,14 @@ export declare const ensureSecret: (name: string, keys: string[], opts?: {
     profile?: ActivityStep["profile"];
     [k: string]: unknown;
 }) => ActivityStep;
-/** Run `chant teardown` in the given project directory. Uses `longInfra` profile. */
-export declare const teardown: (path: string) => ActivityStep;
+/**
+ * Run `chant teardown` in the given project directory. Fixed `longInfra`
+ * profile (not overridable). {@link ChantTeardownArgs} has only `path`
+ * (positional), so `opts` is just the step's `id` (for `.out`).
+ */
+export declare const teardown: (path: string, opts?: {
+    id?: string;
+}) => NamedActivityStep;
 /**
  * Tear down one environment's marker-owned resources — the durable form of
  * `chant lifecycle teardown <env> --yes` (#1222). The activity runs core's
@@ -182,11 +226,11 @@ export declare const teardown: (path: string) => ActivityStep;
  * ]),
  * ```
  *
- * `opts` also accepts `path` (the chant project directory, default the
- * worker's cwd). Defaults to the `longInfra` profile (override via
+ * `opts` also accepts `path` (the chant project directory, default the chant
+ * process's cwd). Defaults to the `longInfra` profile (override via
  * `opts.profile`).
  */
-export declare const envTeardown: (env: string, opts?: Record<string, unknown>) => ActivityStep;
+export declare const envTeardown: (env: string, opts?: WithStepRefs<Omit<EnvTeardownArgs, "env">> & StepOpts) => NamedActivityStep;
 /**
  * Create a local k3d cluster (vanilla Kubernetes in Docker). Idempotent: skips
  * creation if a cluster of the same name already exists. Defaults to the
@@ -284,7 +328,7 @@ export declare const flociGcpDown: (opts?: Record<string, unknown>) => ActivityS
  * Defaults to the `fastIdempotent` profile. `opts` accepts `method`, `status`
  * (default any 2xx), `contains` (body substring), `retries`, `intervalMs`.
  */
-export declare const httpCheck: (url: string, opts?: Record<string, unknown>) => ActivityStep;
+export declare const httpCheck: (url: string, opts?: WithStepRefs<Omit<HttpCheckArgs, "url">> & StepOpts) => NamedActivityStep;
 /**
  * Ensure an Azure resource group exists before an ARM apply. `az deployment
  * group create` (the `arm` apply target) fails without its group, so place this
@@ -502,13 +546,24 @@ export declare const spritesDown: (args?: {
 }) => ActivityStep;
 /**
  * Gate an apply on organizational policy: build the project and run its
- * `lint.policies` over the resolved resources, blocking the workflow on any
- * violation. Place it before the apply phase. `env` (or `ownership.env`) lets a
+ * `lint.policies` over the resolved resources, failing the step on any
+ * violation so no later phase runs. Place it before the apply phase. `env` (or `ownership.env`) lets a
  * policy branch on environment. Single-attempt (`policyCheck` profile) — a
  * deterministic violation is not retried.
  */
-export declare const policyGate: (opts?: {
-    env?: string;
-    path?: string;
-}) => ActivityStep;
+export declare const policyGate: (opts?: WithStepRefs<PolicyGateArgs> & {
+    id?: string;
+}) => NamedActivityStep;
+/**
+ * Run an external CloudFormation Guard rules pack against the project's built
+ * CloudFormation template (chant #522). `opts` is {@link GuardValidateArgs}
+ * itself, minus the positional `rules`; `template` defaults (inside the
+ * activity) to `<path>/template.json`. Fixed `policyCheck` profile — same
+ * reasoning as {@link policyGate}: a deterministic policy check is
+ * single-attempt — and not overridable.
+ */
+export declare const guardValidate: (rules: string, opts?: WithStepRefs<Omit<GuardValidateArgs, "rules">> & {
+    id?: string;
+}) => NamedActivityStep;
+export {};
 //# sourceMappingURL=builders.d.ts.map

package/dist/op/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/op/builders.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/op/builders.ts"],"names":[],"mappings":"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"}

package/dist/op/change-signal.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The wake gate between a substrate's change signal and `chant operator`'s
+ * sleep (#1981, epic #1487).
+ *
+ * A lexicon that implements `subscribeChanges` (`../lexicon.ts`) can say
+ * "something moved". This module is everything the loop does with that: it
+ * shortens the current sleep, at most once per floor. It is deliberately the
+ * only place a signal touches, so the rule that a signal is a trigger and
+ * never a fact is a property of the code rather than a convention. Nothing
+ * here has a parameter, a return value or a field that could carry what
+ * changed.
+ *
+ * ## Backpressure: the floor
+ *
+ * A watch on a busy namespace is not a trickle. A rollout, a Job sweep or a
+ * controller resyncing its whole world produces hundreds of events in a
+ * second, and each one is a truthful "something moved". Waking a tick per
+ * event would turn a convergence loop into a load generator pointed at the
+ * cluster it is meant to be watching.
+ *
+ * So the gate coalesces. Signals are collapsed into a single pending flag, and
+ * a pending flag wakes the sleep no earlier than {@link
+ * ChangeSignalGateOptions.floorMs} after the last round *started*. A storm of
+ * a thousand signals inside one floor window costs exactly one early wake, and
+ * a substrate that never stops sending settles into ticking on the floor
+ * rather than on the interval, which is the fastest the loop is ever allowed
+ * to run.
+ *
+ * The floor is measured from the start of the last round, not from the last
+ * signal, so a steady stream can never push the wake further out (that would
+ * be a debounce, and a debounce starves: the busier the cluster, the later the
+ * tick). Measuring from the round start makes the guarantee a rate limit,
+ * never more than one signal-driven tick per floor, which is the property the
+ * loop actually needs.
+ */
+/**
+ * The shortest gap between two rounds a change signal may produce. Signals
+ * arriving inside this window of the last round's start are coalesced into one
+ * wake at the end of it.
+ *
+ * Five seconds: long enough that a rollout's event storm costs one tick rather
+ * than dozens, short enough that "wakes within a second or so of a change"
+ * holds for the quiet case a signal exists for. The timer
+ * (`DEFAULT_OPERATOR_INTERVAL_MS`, 60s) is unchanged and remains the ceiling.
+ */
+export declare const DEFAULT_SIGNAL_FLOOR_MS = 5000;
+/** Why {@link ChangeSignalGate.wait} returned. */
+export type WakeReason = 
+/** The full interval elapsed. An ordinary timer-driven round. */
+"timer"
+/** A substrate signalled and the floor had passed. An early round. */
+ | "signal"
+/** The operator is stopping. */
+ | "aborted";
+export interface ChangeSignalGateOptions {
+    /** @default DEFAULT_SIGNAL_FLOOR_MS */
+    floorMs?: number;
+    /** Injectable clock, for tests. @default Date.now */
+    now?: () => number;
+}
+/**
+ * One operator loop's wake gate. Not reusable across loops: it carries the
+ * time the current loop last started a round, which is what the floor is
+ * measured from.
+ */
+export interface ChangeSignalGate {
+    /**
+     * A substrate said something moved. Takes nothing and returns nothing, and
+     * that is the enforcement of "a trigger, never a fact": there is no
+     * argument for a watch event to ride in on.
+     *
+     * Safe to call at any time, including while no `wait` is in flight (the flag
+     * is remembered and honoured by the next one) and after the loop has
+     * stopped (it does nothing).
+     */
+    signal(): void;
+    /** The loop is starting a round now. Resets the pending flag and the floor. */
+    roundStarted(): void;
+    /**
+     * Sleep up to `intervalMs`, resolving early when a signal has passed the
+     * floor. Resolves rather than throws on abort, like the timer-only sleep it
+     * replaces, so Ctrl-C never surfaces as a loop failure.
+     */
+    wait(intervalMs: number, abortSignal?: AbortSignal): Promise<WakeReason>;
+    /** How many signals have arrived, coalesced or not. Diagnostics and tests. */
+    readonly signalCount: number;
+    /** How many of those actually shortened a sleep. Diagnostics and tests. */
+    readonly wakeCount: number;
+}
+export declare function createChangeSignalGate(options?: ChangeSignalGateOptions): ChangeSignalGate;
+//# sourceMappingURL=change-signal.d.ts.map

package/dist/op/change-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-signal.d.ts","sourceRoot":"","sources":["../../src/op/change-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAE7C,kDAAkD;AAClD,MAAM,MAAM,UAAU;AACpB,iEAAiE;AAC/D,OAAO;AACT,sEAAsE;GACpE,QAAQ;AACV,gCAAgC;GAC9B,SAAS,CAAC;AAEd,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,MAAM,IAAI,IAAI,CAAC;IACf,+EAA+E;IAC/E,YAAY,IAAI,IAAI,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CA0E9F"}

package/dist/op/composites/apply-op.d.ts

@@ -0,0 +1,118 @@
+/**
+ * ApplyOp composite — the code → cloud workflow as an Op.
+ *
+ * Compute the plan, then apply via the target's native mechanism. Authority
+ * stays with the platform (the CloudFormation stack, the Kubernetes API
+ * server, the ARM resource group) — chant never hosts a state file.
+ *
+ * Phases: build → plan → [approve] → apply. Deletes ride the native
+ * prune path, whose bound is per target: the ownership marker on `kubectl`,
+ * the ownership tag on `arm` (chant #1448 — previously `--mode Complete`, which
+ * removed resources chant never applied), the ownership label on `gcp`
+ * (chant #1449), the metadata marker (machines) and managed app
+ * (volumes/ips/certs/secrets) on `fly` (chant #1449), and the stack itself on
+ * `cloudformation`, which a resource CFN did not create is not in. All of
+ * them are owned-only. See {@link DeleteMode}.
+ *
+ * A gate is a fact, not a wait (#2119): the local executor reads the gate
+ * ledger, and a run that finds no resolution ends `gated` with the `chant
+ * approve <op> <gate>` line to run. Approve, run again, and the same Op
+ * converges — no durable workflow engine is involved.
+ *
+ * @example
+ * ```typescript
+ * // additive, local executor
+ * export const { op } = ApplyOp({ name: "prod-apply", env: "prod", target: "kubectl" });
+ *
+ * // gated destructive apply — `chant approve prod-apply approve-apply`, then re-run
+ * export const { op } = ApplyOp({
+ *   name: "prod-apply",
+ *   env: "prod",
+ *   target: "kubectl",
+ *   delete: "gated",
+ *   gate: { gate: "approve-apply", description: "Approve prod apply with deletes" },
+ * });
+ * ```
+ *
+ * @see #112 — stateless-authoritative state model + live import
+ */
+import type { OpResource } from "../resource.js";
+import { type ApplyTarget, type DeleteMode } from "../activities/apply.js";
+export interface ApplyOpConfig {
+    /** Op name (kebab-case). */
+    name: string;
+    /** Environment — CFN stack name / ARM resource group / kube context env;
+     * a log label on `gcp` and `fly`. */
+    env: string;
+    /** Native apply mechanism. Default: "kubectl". */
+    target?: ApplyTarget;
+    /** Built manifest/template path. Default per target: `dist` (dir) for kubectl,
+     * `template.json` (file) for CloudFormation/ARM, `dist/gcp.yaml` for gcp,
+     * `dist/fly.json` for fly. Must match your build output. */
+    output?: string;
+    /** Project directory to build. Default: ".". */
+    path?: string;
+    /** Delete handling. Default: "never". */
+    delete?: DeleteMode;
+    /**
+     * Effect handling (#1834, epic #1703 decision 6). `"gated"` routes the run
+     * through the approval gate whenever the plan proposes an effect, so the Plan
+     * phase's effect-will-fire rows (#1832) are reviewed before any effect
+     * runs. A run that reaches the gate unapproved ends `gated` and is answered
+     * by `chant approve`, the same shape `delete: "gated"` has. The generic
+     * apply itself never writes a receipt regardless (#1832); only an
+     * `effect()` step does, on success, last.
+     */
+    effects?: "gated";
+    /**
+     * Approval gate before the apply. Implied when `delete: "gated"`; may also be
+     * set explicitly. Omit `gate` to default to `approve-<name>`. The gate
+     * is resolved by `chant approve` on the ledger (#2119), which the next run
+     * reads; nothing waits in the meantime.
+     *
+     * `signalName` is the key `gate` carried through 0.58.0 (#2202): still read,
+     * removed in 0.60.0.
+     */
+    gate?: {
+        gate?: string;
+        /** @deprecated Renamed to `gate` in #2202. Accepted through 0.59.0, removed in 0.60.0. */
+        signalName?: string;
+        timeout?: string;
+        description?: string;
+    };
+    /**
+     * Saga-style rollback on partial apply failure, run as an `onFailure` phase.
+     *
+     * Compensation is total or refused (#1449): it only builds when the target
+     * has a rollback to run — a mapped native one (`cloudformation`, the aws
+     * lexicon's `rollbackStack`) or an explicit `{ command }`. Asking for it
+     * (`true`, or an object without a `command`) on any other target fails at
+     * build time rather than warning at rollback time.
+     *
+     * Defaults on for a destructive apply (`delete !== "never"`) when the target
+     * has a native rollback; a destructive apply on a target without one gets no
+     * compensation phase unless a `{ command }` supplies the rollback. Pass
+     * `false` to disable.
+     */
+    compensate?: boolean | {
+        command?: string;
+    };
+    /**
+     * kubectl target only (chant #1075). Let the server-side apply take
+     * ownership of fields another field manager already owns, instead of failing
+     * with a conflict naming them.
+     *
+     * Off unless set, and chant never turns it on by itself — a conflict means
+     * something else in the cluster believes it owns that field, and deciding
+     * otherwise is a deliberate act. Set it when chant is meant to be the
+     * authority for those fields (adopting objects a previous `kubectl apply`
+     * created is the usual case).
+     */
+    forceConflicts?: boolean;
+}
+export interface ApplyOpResources {
+    /** Op resource — the build→plan→[approve]→apply Op. */
+    op: InstanceType<typeof OpResource>;
+}
+export declare function ApplyOp(config: ApplyOpConfig): ApplyOpResources;
+//# sourceMappingURL=apply-op.d.ts.map

package/dist/op/composites/apply-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-op.d.ts","sourceRoot":"","sources":["../../../src/op/composites/apply-op.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAoC,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE1G,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb;yCACqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;gEAE4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,0FAA0F;QAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,EAAE,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;CACrC;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAiG/D"}

package/dist/op/composites/converge-op.d.ts

@@ -0,0 +1,120 @@
+/**
+ * ConvergeOp composite (#1484, epic #1487 feature 1) — the executable
+ * runbook. Observe, classify against a typed rule table, dispatch to
+ * declared ops within a per-tick budget, record, rest. Peer to `WatchOp` /
+ * `ReconcileOp` / `ApplyOp` — same `{ op }` shape, with the cadence on the
+ * Op itself (#2120).
+ *
+ * Phases: `Observe` (snapshot + a quick live diff, exactly `WatchOp`'s own
+ * shape, for the `Drift` outcome and per-phase visibility) ->
+ * `Converge` (one `convergeTick` activity call —
+ * ../activities/converge.ts — that does classify + dispatch + record;
+ * see that module's doc for why this can't be split into further static
+ * phases). `Observe`'s drift signal threads into `Converge`'s args via a
+ * step-output reference (#1290), not a search-attribute round-trip.
+ *
+ * @example
+ * ```typescript
+ * import { ConvergeOp, eq, gt, run, report, when } from "@intentius/chant/op";
+ * import type { ConvergeSymptom } from "@intentius/chant/lifecycle/symptoms";
+ *
+ * export const { op } = ConvergeOp({
+ *   name: "fountain-converge",
+ *   env: "staging",
+ *   dial: "apply",
+ *   schedule: "*\/10 * * * *",
+ *   rules: [
+ *     when<ConvergeSymptom>(eq("status", "drifted"), run("fountain-apply"), {
+ *       id: "drift-apply",
+ *       why: "Live config drifted from declared source; re-apply converges it back.",
+ *     }),
+ *     when<ConvergeSymptom>(gt("adoptCount", 0), report("unowned resources present"), {
+ *       id: "adopt-report",
+ *       why: "An unowned resource is reported for a human to review — never auto-claimed.",
+ *     }),
+ *     when<ConvergeSymptom>(eq("status", "unknown"), report("environment could not be fully observed"), {
+ *       id: "unknown-report",
+ *       why: "unknown never remediates — a partial read is a hole to report, not a guess to act on.",
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @see #1484, #1487
+ */
+import type { OpResource } from "../resource.js";
+import { type ConvergeRule } from "../converge-rule.js";
+import type { ConvergeSymptom } from "../../lifecycle/symptoms.js";
+/**
+ * Authority level for this ConvergeOp's environment — issue #1484's own
+ * Autonomy table (dial × verb class):
+ *
+ * | verb class  | observe     | reconcile        | apply                 |
+ * |-------------|-------------|------------------|------------------------|
+ * | read-only   | free-run    | free-run         | free-run               |
+ * | mutating    | report only | open PR          | run, gated per op      |
+ * | destructive | refused     | refused          | always gated           |
+ *
+ * `ConvergeOp` adds no authority an environment did not already grant.
+ * Default `"observe"` — not autonomous by default (issue: "a ConvergeOp in
+ * an observe environment is a report generator").
+ *
+ * **v1 implements a conservative subset of this table**, not the whole
+ * thing (pre-merge review of #1954 caught the gap between what the code did
+ * and what this table says — this doc now matches the issue, and the code
+ * matches this doc):
+ *
+ * | verb class  | observe     | reconcile                          | apply                              |
+ * |-------------|-------------|-------------------------------------|--------------------------------------|
+ * | read-only   | free-run    | free-run                            | free-run                             |
+ * | mutating    | report only | **refused at build (OPS014)**       | run                                   |
+ * | destructive | refused     | refused                              | **refused at build (OPS014), v1**   |
+ *
+ * - **`reconcile` × mutating is "open PR" in the issue's table — not yet
+ *   implemented.** Building that channel (reusing `ReconcileOp`'s
+ *   `onDrift: "pull-request" | "issue" | "report"`) is out of v1 scope — see
+ *   `../converge-rule.ts`'s `ReportAction` doc and epic #1487's
+ *   onDrift-channel open question. Until it exists, a rule that would
+ *   dispatch a mutating op under `reconcile` is refused at build
+ *   (`OPS014`), not silently escalated to "run directly" the way `apply`
+ *   would. A runtime backstop in `convergeTick`
+ *   (`../activities/converge.ts`) re-checks the same thing at dispatch
+ *   time, for a rule table that reached the tick without going through that
+ *   build.
+ * - **`apply` × destructive is refused outright in v1, gate or not.** The
+ *   issue's table says "always gated", but the dispatch executor can't
+ *   honor a gate: `dispatchOp` shells `chant run <op>`, and a gated run ends
+ *   pending approval (#2119) rather than continuing — so
+ *   "destructive + apply + gated" reads as a path to dispatch but was a
+ *   dead cell: it could never actually succeed. `OPS014` refuses the rule
+ *   instead of shipping a path guaranteed to fail every time it's exercised.
+ *   Gated dispatch that waits for the approval is #1485's design to own.
+ */
+export type ConvergeDial = "observe" | "reconcile" | "apply";
+export interface ConvergeOpConfig {
+    /** Op name (kebab-case). Names the Op's output directory and is what `chant run` takes. */
+    name: string;
+    /** Environment to converge (e.g. "staging"). */
+    env: string;
+    /** @default "observe" */
+    dial?: ConvergeDial;
+    /** Max number of `run` dispatches per tick — the issue's "the worst tick is bounded" (Accessible Ops factor VI). Rules matched beyond the budget are recorded, not run. @default 3 */
+    budget?: number;
+    /** The rule table — build with `when()`/`eq()`/`run()`/`report()` from `@intentius/chant/op`. Non-empty; every rule id must be unique. */
+    rules: ConvergeRule<ConvergeSymptom>[];
+    /**
+     * Cron expression. When set, it lands on the Op as `schedule` — the cadence
+     * `chant operator` ticks this Op on and the CI generators render; omit for
+     * one-shot `chant run` on the local executor, also the test story (issue:
+     * "one-shot runnable locally for a single tick").
+     */
+    schedule?: string;
+    /** Run `chant lifecycle diff --live` in the Observe phase (queries live state). @default true */
+    live?: boolean;
+}
+export interface ConvergeOpResources {
+    /** Op resource — the observe-then-converge Op. */
+    op: InstanceType<typeof OpResource>;
+}
+export declare function ConvergeOp(config: ConvergeOpConfig): ConvergeOpResources;
+//# sourceMappingURL=converge-op.d.ts.map

package/dist/op/composites/converge-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converge-op.d.ts","sourceRoot":"","sources":["../../../src/op/composites/converge-op.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,sLAAsL;IACtL,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0IAA0I;IAC1I,KAAK,EAAE,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,EAAE,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;CACrC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAwFxE"}

package/dist/op/composites/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The Op composites (#2120) — the named verbs an operator authors instead of
+ * hand-writing phases: watch, reconcile, apply, converge, and the three audit
+ * runners.
+ *
+ * They lived in a hosting lexicon while a cadence meant a scheduler resource;
+ * now that the cadence is `OpConfig.schedule` they are runtime-neutral, each
+ * returns `{ op }`, and nothing here imports a hosting lexicon. A project that
+ * wants a real scheduler resource pairs one with the Op by hand (the pattern
+ * `lexicons/cedar/src/dogwood/replay-op.ts` documents).
+ */
+export { WatchOp } from "./watch-op.js";
+export type { WatchOpConfig, WatchOpResources } from "./watch-op.js";
+export { ReconcileOp } from "./reconcile-op.js";
+export type { ReconcileOpConfig, ReconcileOpResources } from "./reconcile-op.js";
+export { ApplyOp } from "./apply-op.js";
+export type { ApplyOpConfig, ApplyOpResources } from "./apply-op.js";
+export { ConvergeOp } from "./converge-op.js";
+export type { ConvergeOpConfig, ConvergeOpResources, ConvergeDial } from "./converge-op.js";
+export { WorkflowAuditOp } from "./workflow-audit-op.js";
+export type { WorkflowAuditOpConfig, WorkflowAuditOpResources } from "./workflow-audit-op.js";
+export { PipelineAuditOp } from "./pipeline-audit-op.js";
+export type { PipelineAuditOpConfig, PipelineAuditOpResources } from "./pipeline-audit-op.js";
+export { LexiconUpgradeOp, IN_SCOPE_LEXICONS } from "./lexicon-upgrade-op.js";
+export type { LexiconUpgradeOpConfig, LexiconUpgradeOpResources } from "./lexicon-upgrade-op.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/op/composites/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/composites/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}