@intentius/chant 0.124.17 → 0.124.19

package/src/__golden__/wave-loop/op-wide.json

@@ -0,0 +1,440 @@
+{
+  "jobs": [
+    {
+      "label": "decide, approved and spent",
+      "job": {
+        "wave": 3,
+        "decide": true
+      },
+      "result": {
+        "exitCode": 0,
+        "applied": [],
+        "failed": [],
+        "moved": [],
+        "hooks": [],
+        "decision": {
+          "wave": 3,
+          "name": "prod",
+          "op": "migrations",
+          "gate": "migrations-wave-3",
+          "policy": "always",
+          "approval": "ledger",
+          "policySource": "base",
+          "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+          "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+          "members": [
+            {
+              "member": "t3",
+              "planDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+              "op": "migrate"
+            },
+            {
+              "member": "t1",
+              "planDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+              "op": "migrate"
+            },
+            {
+              "member": "t2",
+              "planDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+              "op": "migrate"
+            }
+          ],
+          "status": "approved",
+          "spend": "base",
+          "via": "ledger",
+          "approvedBy": "alice",
+          "approvedAt": "2026-10-10T00:00:00Z",
+          "spentAt": "2026-10-11T00:00:00.000Z"
+        }
+      },
+      "ledger": {
+        "appended": [],
+        "resolved": [],
+        "applied": [
+          {
+            "version": 1,
+            "kind": "applied",
+            "op": "migrations",
+            "gate": "migrations-wave-3",
+            "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+            "approvedAt": "2026-10-10T00:00:00Z",
+            "approvedBy": "alice",
+            "timestamp": "2026-10-11T00:00:00.000Z",
+            "wave": {
+              "number": 3,
+              "name": "prod"
+            }
+          }
+        ]
+      },
+      "calls": 3,
+      "logs": 2
+    },
+    {
+      "label": "share 2",
+      "job": {
+        "wave": 3,
+        "share": 2
+      },
+      "result": {
+        "exitCode": 0,
+        "applied": [
+          "t3"
+        ],
+        "failed": [],
+        "moved": [],
+        "hooks": [],
+        "decision": {
+          "wave": 3,
+          "name": "prod",
+          "op": "migrations",
+          "gate": "migrations-wave-3",
+          "policy": "always",
+          "approval": "ledger",
+          "policySource": "base",
+          "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+          "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+          "members": [
+            {
+              "member": "t3",
+              "planDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+              "op": "migrate"
+            },
+            {
+              "member": "t1",
+              "planDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+              "op": "migrate"
+            },
+            {
+              "member": "t2",
+              "planDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+              "op": "migrate"
+            }
+          ],
+          "status": "approved",
+          "spend": "base",
+          "via": "ledger",
+          "approvedBy": "alice",
+          "approvedAt": "2026-10-10T00:00:00Z",
+          "spentAt": "2026-10-11T00:00:00.000Z"
+        }
+      },
+      "ledger": {
+        "appended": [],
+        "resolved": [],
+        "applied": [
+          {
+            "version": 1,
+            "kind": "applied",
+            "op": "migrations",
+            "gate": "migrations-wave-3",
+            "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+            "approvedAt": "2026-10-10T00:00:00Z",
+            "approvedBy": "alice",
+            "timestamp": "2026-10-11T00:00:00.000Z",
+            "wave": {
+              "number": 3,
+              "name": "prod"
+            }
+          }
+        ]
+      },
+      "calls": 2,
+      "logs": 0
+    },
+    {
+      "label": "share 1, t2 moved",
+      "job": {
+        "wave": 3,
+        "share": 1
+      },
+      "result": {
+        "exitCode": 4,
+        "applied": [
+          "t1"
+        ],
+        "failed": [],
+        "moved": [
+          "t2"
+        ],
+        "hooks": [],
+        "decision": {
+          "wave": 3,
+          "name": "prod",
+          "op": "migrations",
+          "gate": "migrations-wave-3",
+          "policy": "always",
+          "approval": "ledger",
+          "policySource": "base",
+          "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+          "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+          "members": [
+            {
+              "member": "t3",
+              "planDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+              "op": "migrate"
+            },
+            {
+              "member": "t1",
+              "planDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+              "op": "migrate"
+            },
+            {
+              "member": "t2",
+              "planDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+              "op": "migrate"
+            }
+          ],
+          "status": "approved",
+          "spend": "base",
+          "via": "ledger",
+          "approvedBy": "alice",
+          "approvedAt": "2026-10-10T00:00:00Z",
+          "spentAt": "2026-10-11T00:00:00.000Z"
+        }
+      },
+      "ledger": {
+        "appended": [],
+        "resolved": [],
+        "applied": [
+          {
+            "version": 1,
+            "kind": "applied",
+            "op": "migrations",
+            "gate": "migrations-wave-3",
+            "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+            "approvedAt": "2026-10-10T00:00:00Z",
+            "approvedBy": "alice",
+            "timestamp": "2026-10-11T00:00:00.000Z",
+            "wave": {
+              "number": 3,
+              "name": "prod"
+            }
+          }
+        ]
+      },
+      "calls": 3,
+      "logs": 1
+    }
+  ],
+  "calls": [
+    {
+      "argv": [
+        "tool",
+        "plan",
+        "t3",
+        "--out",
+        ".chant/op-waves/migrations/wave-3/t3.plan.json"
+      ]
+    },
+    {
+      "argv": [
+        "tool",
+        "plan",
+        "t1",
+        "--out",
+        ".chant/op-waves/migrations/wave-3/t1.plan.json"
+      ]
+    },
+    {
+      "argv": [
+        "tool",
+        "plan",
+        "t2",
+        "--out",
+        ".chant/op-waves/migrations/wave-3/t2.plan.json"
+      ]
+    },
+    {
+      "argv": [
+        "tool",
+        "plan",
+        "t3",
+        "--out",
+        ".chant/op-waves/migrations/wave-3/t3.plan.json"
+      ]
+    },
+    {
+      "argv": [
+        "tool",
+        "apply",
+        "t3",
+        "--plan",
+        ".chant/op-waves/migrations/wave-3/t3.plan.json"
+      ],
+      "env": {
+        "CHANT_HOOKS": ".chant/op-waves/migrations/wave-3/t3.hooks.json",
+        "CHANT_APPLY_OUTCOME": ".chant/op-waves/migrations/wave-3/t3.hooks-outcome.json"
+      },
+      "read": {
+        "CHANT_HOOKS": {
+          "version": 1,
+          "opWaves": "migrations",
+          "op": "migrate",
+          "wave": "prod",
+          "number": 3,
+          "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+          "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+          "approved": true,
+          "runBy": "chant",
+          "runs": [
+            {
+              "target": "t3",
+              "op": "migrate",
+              "plan": ".chant/op-waves/migrations/wave-3/t3.plan.json"
+            }
+          ],
+          "runsFile": ".chant/op-waves/migrations/wave-3/runs.json",
+          "hooks": {},
+          "outcomes": []
+        }
+      }
+    },
+    {
+      "argv": [
+        "tool",
+        "plan",
+        "t1",
+        "--out",
+        ".chant/op-waves/migrations/wave-3/t1.plan.json"
+      ]
+    },
+    {
+      "argv": [
+        "tool",
+        "plan",
+        "t2",
+        "--out",
+        ".chant/op-waves/migrations/wave-3/t2.plan.json"
+      ]
+    },
+    {
+      "argv": [
+        "tool",
+        "apply",
+        "t1",
+        "--plan",
+        ".chant/op-waves/migrations/wave-3/t1.plan.json"
+      ],
+      "env": {
+        "CHANT_HOOKS": ".chant/op-waves/migrations/wave-3/t1.hooks.json",
+        "CHANT_APPLY_OUTCOME": ".chant/op-waves/migrations/wave-3/t1.hooks-outcome.json"
+      },
+      "read": {
+        "CHANT_HOOKS": {
+          "version": 1,
+          "opWaves": "migrations",
+          "op": "migrate",
+          "wave": "prod",
+          "number": 3,
+          "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+          "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+          "approved": true,
+          "runBy": "chant",
+          "runs": [
+            {
+              "target": "t1",
+              "op": "migrate",
+              "plan": ".chant/op-waves/migrations/wave-3/t1.plan.json"
+            }
+          ],
+          "runsFile": ".chant/op-waves/migrations/wave-3/runs.json",
+          "hooks": {},
+          "outcomes": []
+        }
+      }
+    }
+  ],
+  "logs": [
+    "wave 3 (prod): gate always (read at bbbbbbbbbbbb), digest jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e: approved by alice",
+    "wave 3 (prod) applies under the approval by alice at 2026-10-10T00:00:00Z, which is now spent",
+    "t2: its plan moved since wave 3 was decided, so it was not applied. decided: sha256:2222222222222222222222222222222222222222222222222222222222222222; planned now: sha256:9999999999999999999999999999999999999999999999999999999999999999"
+  ],
+  "files": {
+    ".chant/op-waves/migrations/wave-3/t1.hooks.json": {
+      "version": 1,
+      "opWaves": "migrations",
+      "op": "migrate",
+      "wave": "prod",
+      "number": 3,
+      "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+      "approved": true,
+      "runBy": "chant",
+      "runs": [
+        {
+          "target": "t1",
+          "op": "migrate",
+          "plan": ".chant/op-waves/migrations/wave-3/t1.plan.json"
+        }
+      ],
+      "runsFile": ".chant/op-waves/migrations/wave-3/runs.json",
+      "hooks": {},
+      "outcomes": []
+    },
+    ".chant/op-waves/migrations/wave-3/t1.plan.json": {
+      "planDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
+    },
+    ".chant/op-waves/migrations/wave-3/t2.plan.json": {
+      "planDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999"
+    },
+    ".chant/op-waves/migrations/wave-3/t3.hooks.json": {
+      "version": 1,
+      "opWaves": "migrations",
+      "op": "migrate",
+      "wave": "prod",
+      "number": 3,
+      "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+      "approved": true,
+      "runBy": "chant",
+      "runs": [
+        {
+          "target": "t3",
+          "op": "migrate",
+          "plan": ".chant/op-waves/migrations/wave-3/t3.plan.json"
+        }
+      ],
+      "runsFile": ".chant/op-waves/migrations/wave-3/runs.json",
+      "hooks": {},
+      "outcomes": []
+    },
+    ".chant/op-waves/migrations/wave-3/t3.plan.json": {
+      "planDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333"
+    },
+    ".chant/op-waves/migrations/wave-3.json": {
+      "wave": 3,
+      "name": "prod",
+      "op": "migrations",
+      "gate": "migrations-wave-3",
+      "policy": "always",
+      "approval": "ledger",
+      "policySource": "base",
+      "base": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "digest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e",
+      "members": [
+        {
+          "member": "t3",
+          "planDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+          "op": "migrate"
+        },
+        {
+          "member": "t1",
+          "planDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+          "op": "migrate"
+        },
+        {
+          "member": "t2",
+          "planDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+          "op": "migrate"
+        }
+      ],
+      "status": "approved",
+      "spend": "base",
+      "via": "ledger",
+      "approvedBy": "alice",
+      "approvedAt": "2026-10-10T00:00:00Z",
+      "spentAt": "2026-10-11T00:00:00.000Z"
+    }
+  }
+}

package/src/cli/commands/import-live.test.ts

@@ -143,6 +143,30 @@ describe("liveImportFromPlugins (#114)", () => {
     expect(result.error).toContain("No resources exported");
   });
 
+  // #3911 — an exporter that refuses (the sql lexicon naming objects it cannot
+  // declare) is the import's error, not a warning behind "No resources exported".
+  test("an exporter's failure is the error when nothing else exported, and --skip-undeclarable reaches it", async () => {
+    let seen: unknown;
+    const refusing: LexiconPlugin = {
+      ...fakeExporter("sql", sampleIR),
+      async exportResources(opts: { skipUndeclarable?: boolean }) {
+        seen = opts.skipUndeclarable;
+        if (!opts.skipUndeclarable) throw new Error("the server has an object of a kind chant cannot declare:\n  - aggregate app.total(integer)");
+        return { ...sampleIR, warnings: ["aggregate app.total(integer) is left out (--skip-undeclarable)"] };
+      },
+    };
+    const failed = await liveImportFromPlugins([refusing], { environment: "prod", output: outputDir, force: true });
+    expect(failed.success).toBe(false);
+    expect(failed.error).toContain("sql: live export failed");
+    expect(failed.error).toContain("  - aggregate app.total(integer)");
+    expect(seen).toBeUndefined();
+
+    const skipped = await liveImportFromPlugins([refusing], { environment: "prod", output: outputDir, force: true, skipUndeclarable: true });
+    expect(skipped.success).toBe(true);
+    expect(seen).toBe(true);
+    expect(skipped.warnings).toContain("aggregate app.total(integer) is left out (--skip-undeclarable)");
+  });
+
   // #932 — a multi-stack reconcile imports each stack from its own live
   // CloudFormation stack; the `stack` option must reach `exportResources` so
   // the right stack is queried (not one env-named stack for all of them).

package/src/cli/commands/import.ts

@@ -645,6 +645,8 @@ export interface LiveImportOptions {
   owned?: boolean;
   /** Keep server-defaulted fields instead of stripping to declared shape. */
   verbatim?: boolean;
+  /** Import what can be declared, and warn about the live objects no declaration can hold instead of failing. */
+  skipUndeclarable?: boolean;
 }
 
 /**
@@ -745,6 +747,8 @@ export async function liveImportFromPlugins(
   // Collect IR from every exporter, tagging which lexicon produced output.
   let irParts: ExportedTemplate[] = [];
   let generatorLexicon: LexiconPlugin | undefined;
+  // An exporter that fails (an sql import refusing objects it cannot declare, #3911) is the error when nothing else exported.
+  const failures: string[] = [];
   for (const plugin of exporters) {
     let ir: ExportedTemplate;
     try {
@@ -754,9 +758,10 @@ export async function liveImportFromPlugins(
         selector: options.selector,
         owned: options.owned,
         verbatim: options.verbatim,
+        ...(options.skipUndeclarable ? { skipUndeclarable: true } : {}),
       });
     } catch (err) {
-      warnings.push(`${plugin.name}: live export failed — ${err instanceof Error ? err.message : String(err)}`);
+      failures.push(`${plugin.name}: live export failed — ${err instanceof Error ? err.message : String(err)}`);
       continue;
     }
     // What the exporter left out or could not carry (#3336).
@@ -771,9 +776,10 @@ export async function liveImportFromPlugins(
       success: false,
       generatedFiles: [],
       warnings,
-      error: `No resources exported from environment "${options.environment}".`,
+      error: failures.length > 0 ? failures.join("\n") : `No resources exported from environment "${options.environment}".`,
     };
   }
+  warnings.push(...failures);
 
   if (exporters.length > 1 && irParts.length > 1) {
     warnings.push("Multiple lexicons exported resources; generated with the first. Use --lexicon to target one.");

package/src/cli/handlers/graph.test.ts

@@ -249,6 +249,29 @@ describe("runGraph", () => {
       expect(JSON.parse(stdoutBuf.join("\n")).meta).toEqual({ collector: { pipelines: [] } });
     });
 
+    // #3910 — a lexicon's graphEdges answer becomes edges and dangling refs.
+    test("--format ir carries what a lexicon's graphEdges reports", async () => {
+      lintClean(); discovered();
+      loadPluginsMock.mockResolvedValue([{
+        name: "gitlab",
+        serializer: {},
+        graphEdges: () => ({
+          references: [
+            { from: "pod", to: "vpc", kind: "needs", viaAttr: "needs" },
+            { from: "pod", to: "group/other", kind: "triggers", viaAttr: "trigger", crossPipeline: true, dangling: true },
+          ],
+          pipelines: { ".gitlab-ci.yml": ["pod", "vpc"] },
+        }),
+      }, { name: "broken", serializer: {}, graphEdges: () => { throw new Error("boom"); } }]);
+      resolveLexMock.mockResolvedValue(["gitlab", "broken"]);
+      const exit = await runGraph({ args: makeArgs({ format: "ir" }), plugins: [], serializers: [] });
+      expect(exit).toBe(0);
+      const ir = JSON.parse(stdoutBuf.join("\n"));
+      expect(ir.edges).toContainEqual({ from: "pod", to: "vpc", kind: "needs", viaAttr: "needs" });
+      expect(ir.dangling).toEqual([{ from: "pod", kind: "triggers", path: "trigger", value: "group/other", crossPipeline: true }]);
+      expect(ir.groups.byPipeline).toEqual({ ".gitlab-ci.yml": ["pod", "vpc"] });
+    });
+
     test("--format ir has no meta when no lexicon reports anything", async () => {
       lintClean(); discovered();
       loadPluginsMock.mockResolvedValue([{ name: "gcp", serializer: {}, graphMeta: () => undefined }, { name: "k8s", serializer: {} }]);

package/src/cli/handlers/graph.ts

@@ -2,7 +2,7 @@ import { dirname, resolve } from "node:path";
 import { discoverOps } from "../../op/discover";
 import { discover } from "../../discovery/index";
 import { partitionByLexicon, computeStackGraph, build, mergeBuildRootEntities } from "../../build";
-import { buildGraphIr, buildLiveGraphIr, collectUnobserved, overlayGraphs, sourceOverlayGraphs, GRAPH_IR_VERSION, type GraphIR, type IRPipeline, type LiveObservation } from "../../graph-ir";
+import { applyLexiconGraphEdges, buildGraphIr, buildLiveGraphIr, collectUnobserved, overlayGraphs, sourceOverlayGraphs, GRAPH_IR_VERSION, type GraphIR, type IRPipeline, type LexiconGraphEdges, type LiveObservation } from "../../graph-ir";
 import { behaviourOverlay } from "../../behaviour-overlay";
 import type { SerializerResult } from "../../serializer";
 import { applyBehaviourOverlay, behaviourRequestFromIr } from "../../behaviour-graph";
@@ -726,6 +726,26 @@ function withGraphMeta(ir: GraphIR, plugins: LexiconPlugin[], entities: Map<stri
   return Object.keys(added).length === 0 ? ir : { ...ir, meta: { ...(ir.meta ?? {}), ...added } };
 }
 
+/**
+ * Add the edges the lexicons' `graphEdges` hooks resolve (#3910): CI
+ * dependencies written as strings (`needs`, `uses:`, `trigger:`, `include:`,
+ * `extends`), which the AttrRef walk in `buildGraphIr` cannot see. A hook that
+ * throws costs its own edges and a warning, not the graph.
+ */
+function withLexiconEdges(ir: GraphIR, plugins: LexiconPlugin[], entities: Map<string, import("../../declarable").Declarable>): GraphIR {
+  const reports: LexiconGraphEdges[] = [];
+  for (const p of plugins) {
+    if (!p.graphEdges) continue;
+    try {
+      const report = p.graphEdges(entities);
+      if (report) reports.push(report);
+    } catch (err) {
+      console.error(formatWarning({ message: `the ${p.name} lexicon's graphEdges failed (${err instanceof Error ? err.message : String(err)}); its edges are left out` }));
+    }
+  }
+  return reports.length === 0 ? ir : applyLexiconGraphEdges(ir, reports);
+}
+
 /** Returned instead of a graph when the prediction cannot be attempted honestly. */
 const REFUSED = Symbol("behaviour-refused");
 
@@ -867,6 +887,7 @@ async function runGraphView(
     const plugins = ctx.plugins.length > 0
       ? ctx.plugins
       : await loadPlugins(await projectLexiconsOrNone(projectPath));
+    ir = withLexiconEdges(ir, plugins as LexiconPlugin[], result.entities);
     const predicted = await predictOntoIr(ir, plugins as LexiconPlugin[], ctx.args, {
       // No environment on the declared path: the file is not deployed anywhere
       // yet, and naming one would claim it was.

package/src/cli/handlers/misc.ts

@@ -349,7 +349,7 @@ export async function runImport(ctx: CommandContext): Promise<number> {
     const { config } = await loadChantConfig(resolve("."));
     if (config.stacks && config.stacks.length > 0) {
       const perStack = await importFromLiveStacks(
-        { environment: args.migrateFrom, lexicon: args.lexicon, force: args.force, selector, owned: args.owned, verbatim: args.verbatim },
+        { environment: args.migrateFrom, lexicon: args.lexicon, force: args.force, selector, owned: args.owned, verbatim: args.verbatim, skipUndeclarable: args.skipUndeclarable },
         config.stacks,
       );
       let anyFailure = false;
@@ -369,6 +369,7 @@ export async function runImport(ctx: CommandContext): Promise<number> {
       selector,
       owned: args.owned,
       verbatim: args.verbatim,
+      skipUndeclarable: args.skipUndeclarable,
     });
 
     printImportResult(result);

package/src/cli/main.test.ts

@@ -16,6 +16,11 @@ describe("parseArgs", () => {
     expect(() => parseArgs(["graph", "--traffic"])).toThrow(/--traffic needs a level/);
   });
 
+  test("--skip-undeclarable reaches live import (#3911)", () => {
+    expect(parseArgs(["import", "--from", "prod"]).skipUndeclarable).toBeUndefined();
+    expect(parseArgs(["import", "--from", "prod", "--skip-undeclarable"]).skipUndeclarable).toBe(true);
+  });
+
   test("--fold and --no-fold set the tri-state fold option (#1134)", () => {
     expect(parseArgs(["build", "src"]).fold).toBeUndefined();
     expect(parseArgs(["build", "src", "--fold"]).fold).toBe(true);

package/src/cli/parse-args.ts

@@ -33,6 +33,7 @@ const BOOLEAN_FLAGS = new Set([
   "--explain",
   "--owned",
   "--verbatim",
+  "--skip-undeclarable",
   "--apply-rewrites",
   "--write",
   "--strict",
@@ -216,6 +217,8 @@ export function parseArgs(args: string[]): ParsedArgs {
       if (!result.namespace || result.namespace.startsWith("-")) throw new Error("--namespace needs a namespace: --namespace <ns>");
     } else if (arg === "--verbatim") {
       result.verbatim = true;
+    } else if (arg === "--skip-undeclarable") {
+      result.skipUndeclarable = true;
     } else if (arg === "--state") {
       result.statePath = args[++i];
     } else if (arg === "--select") {

package/src/cli/registry.ts

@@ -158,6 +158,8 @@ export interface ParsedArgs {
   confirmProd?: boolean;
   /** `chant import --verbatim` — keep server-defaulted fields in live import */
   verbatim?: boolean;
+  /** `chant import --skip-undeclarable` — import what can be declared and warn about the live objects that cannot, instead of failing */
+  skipUndeclarable?: boolean;
   /** `chant lifecycle … --src <dir>` — build root override for lifecycle commands */
   src?: string;
   /** `--env <name>` — active environment: sets CHANT_ENV so env-aware source