@bastani/atomic 0.5.21-0 → 0.5.21

package/.agents/skills/workflow-creator/SKILL.md

@@ -218,6 +218,28 @@ Any of the named shapes above (positional or structured) accepts `-d` / `--detac
 
 **Builtin workflows are reserved** — local/global workflows cannot shadow them. Pick distinct names.
 
+### Declaring SDK compatibility (`minSDKVersion`)
+
+Opt-in version gate for workflows that depend on a specific SDK release. **Default is unset — do not add it to new workflows unless you have a concrete reason.**
+
+```ts
+defineWorkflow({
+  name: "uses-new-api",
+  minSDKVersion: "0.6.0", // refuse to load on older CLI
+})
+```
+
+| Behaviour | Unset (default) | Set to a version newer than the installed CLI |
+|---|---|---|
+| Loader | Always loads | Refuses to load, returns `IncompatibleSDKError` |
+| `atomic workflow -l` | Normal row | `⚠ needs v<X> (installed v<Y>)` — dim name, visible |
+| Picker | Normal row | `⚠ update required` glyph + preview explains the gap; Enter is disabled |
+| `atomic workflow -n <name>` | Runs | Errors with an upgrade hint, non-zero exit |
+
+When to set it: the workflow calls into a newly-added SDK surface (new `stage()` option, new helper export, new provider method) that older installs don't ship. Omit it for workflows that use only stable APIs — most workflows qualify.
+
+The point of the field is to convert a silent "workflow vanished after upgrade" failure into a visible, actionable row the user can fix. See `references/discovery-and-verification.md` for semver semantics and the visible-diagnostic contract.
+
 ### Structural Rules
 
 Hard constraints enforced by the builder, loader, and runtime:

package/.agents/skills/workflow-creator/references/discovery-and-verification.md

@@ -108,6 +108,81 @@ At load time, the runtime verifies:
 - The export has `__brand === "WorkflowDefinition"`
 - The definition has a `name` and a `run` callback
 
+## SDK version compatibility
+
+Workflows may opt in to a minimum Atomic CLI version by declaring
+`minSDKVersion` on `defineWorkflow()`. The field is **optional and
+unset by default** — workflows that don't declare it are treated as
+compatible with every CLI release.
+
+```ts
+export default defineWorkflow({
+    name: "uses-new-stage-option",
+    description: "...",
+    minSDKVersion: "0.6.0",
+  })
+  .for<"claude">()
+  .run(async (ctx) => { /* ... */ })
+  .compile();
+```
+
+### When to set it
+
+Set `minSDKVersion` when the workflow uses an SDK surface that older
+CLIs don't ship — for example a new `ctx.stage()` option, a newly
+exported helper, or a new provider method. The version you declare is
+the **earliest release you tested against**, not a future wish list.
+
+Skip it when the workflow only touches stable APIs. Most workflows
+qualify. A needlessly high `minSDKVersion` is worse than no gate —
+it'll lock users out for no reason.
+
+### Accepted format
+
+`MAJOR.MINOR.PATCH` with an optional numeric prerelease, matching the
+shape of Atomic's own releases:
+
+| Example | Parses | Notes |
+|---|---|---|
+| `"0.6.0"` | ✅ | Standard release |
+| `"1.2.3"` | ✅ | Standard release |
+| `"0.6.0-0"` | ✅ | Prerelease; ranks below the equivalent stable release (semver-compliant) |
+| `"0.6"` | ❌ | Missing patch; treated as unparseable and ignored |
+| `"latest"` | ❌ | Unparseable; ignored |
+
+Unparseable strings are silently accepted (the workflow loads as if
+`minSDKVersion` were unset) so a typo never blocks a workflow —
+the visible load error path is friendlier than a hard refusal with no
+context.
+
+### What happens when the gate trips
+
+A workflow whose `minSDKVersion` exceeds the installed CLI is kept in
+discovery but marked **incompatible** — it never silently vanishes:
+
+| Surface | Behaviour |
+|---|---|
+| `WorkflowLoader.loadWorkflow()` | Returns `{ ok: false, stage: "load", error: IncompatibleSDKError }` carrying `requiredVersion` + `currentVersion` |
+| `loadWorkflowsMetadata()` | Yields an entry with `status: { kind: "incompatible", requiredVersion, currentVersion, message }` |
+| `atomic workflow -l` | Row is dimmed, with an inline `⚠ needs v<X> (installed v<Y>)` badge after the name |
+| `atomic workflow -a <agent>` picker | Row shows a `⚠` gutter glyph; preview pane explains the version gap and remediation; Enter does not advance to the prompt phase; bottom hint dims `↵ select` to `↵ unavailable` |
+| `atomic workflow -n <name> -a <agent>` | Exits non-zero, prints the `IncompatibleSDKError` message (`requires Atomic SDK v<X>, but v<Y> is installed. Update Atomic, or re-save the workflow against the current SDK.`) |
+
+Load failures that aren't version-related (syntax error, missing
+`.compile()`, invalid default export) follow the same visible-entry
+contract but surface as `status: { kind: "error", stage, message }`
+with a `✗ broken` badge.
+
+### Why this exists
+
+The previous default was to silently drop any workflow that failed to
+load. That turned the "I bumped `@bastani/atomic` and a user/global
+workflow quietly stopped showing up" scenario into a ghost bug — the
+user had no breadcrumb to follow. The `minSDKVersion` field lets
+workflow authors opt in to a clear upgrade path, and the visible
+diagnostic rows make the failure discoverable even for workflows that
+never declared the field.
+
 ## TypeScript configuration
 
 Standard module resolution handles all imports. The project's `tsconfig.json` should use `"moduleResolution": "bundler"` (Bun's default).

package/dist/sdk/components/workflow-picker-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-picker-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/workflow-picker-panel.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-picker-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/workflow-picker-panel.tsx"],"names":[],"mappings":"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"}

package/dist/sdk/define-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/sdk/define-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAsCpB;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACrF,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAG,iBAAiB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,KAAK,CAAgE;gBAEjE,OAAO,EAAE,eAAe;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAIjD;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAW5D;;;;;OAKG;IACH,OAAO,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CAmCpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,EAEnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAK/C"}
+{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/sdk/define-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAsCpB;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACrF,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAG,iBAAiB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,KAAK,CAAgE;gBAEjE,OAAO,EAAE,eAAe;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAIjD;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAW5D;;;;;OAKG;IACH,OAAO,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CAoCpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,EAEnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAK/C"}

package/dist/sdk/errors.d.ts

@@ -19,6 +19,18 @@ export declare class InvalidWorkflowError extends Error {
     readonly path: string;
     constructor(path: string);
 }
+/**
+ * Thrown when a workflow declares a `minSDKVersion` newer than the
+ * bundled CLI. Carries both versions so the CLI can render an
+ * actionable "update atomic or re-save the workflow" hint rather than
+ * a generic load error.
+ */
+export declare class IncompatibleSDKError extends Error {
+    readonly path: string;
+    readonly requiredVersion: string;
+    readonly currentVersion: string;
+    constructor(path: string, requiredVersion: string, currentVersion: string);
+}
 /** Extract a human-readable message from an unknown thrown value. */
 export declare function errorMessage(error: unknown): string;
 //# sourceMappingURL=errors.d.ts.map

package/dist/sdk/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK;gBAApC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK;CAIjE;AAED,qEAAqE;AACrE,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAUzC;AAED,8EAA8E;AAC9E,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAOzC;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK;gBAApC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK;CAIjE;AAED,qEAAqE;AACrE,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAUzC;AAED,8EAA8E;AAC9E,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAOzC;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,MAAM;aACZ,eAAe,EAAE,MAAM;aACvB,cAAc,EAAE,MAAM;gBAFtB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM;CAQzC;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/sdk/runtime/discovery.d.ts

@@ -61,29 +61,72 @@ export declare function discoverWorkflows(projectRoot?: string, agentFilter?: Ag
  * Find a specific workflow by name and agent.
  */
 export declare function findWorkflow(name: string, agent: AgentType, projectRoot?: string): Promise<DiscoveredWorkflow | null>;
+/**
+ * Load status for a {@link WorkflowWithMetadata} entry.
+ *
+ * - `ok`            — the workflow compiled cleanly and is ready to run.
+ * - `incompatible`  — the workflow declared a `minSDKVersion` newer
+ *                     than the bundled CLI. The CLI renders it with an
+ *                     "update required" badge so users see the mismatch
+ *                     rather than a silent disappearance.
+ * - `error`         — any other load failure (syntax error, missing
+ *                     `.compile()`, invalid default export, etc.).
+ *                     Rendered with a "failed to load" badge plus the
+ *                     underlying message.
+ */
+export type WorkflowMetadataStatus = {
+    kind: "ok";
+} | {
+    kind: "incompatible";
+    requiredVersion: string;
+    currentVersion: string;
+    message: string;
+} | {
+    kind: "error";
+    stage: "resolve" | "validate" | "load";
+    message: string;
+};
 /**
  * A discovered workflow enriched with the metadata the picker needs to
- * render it: the human description and the declared input schema.
+ * render it: the human description, the declared input schema, and the
+ * load status.
  *
  * Populated by {@link loadWorkflowsMetadata}, which runs each discovered
- * workflow through {@link WorkflowLoader.loadWorkflow} and extracts just
- * the display-relevant fields — the full compiled definition is
- * discarded after extraction so re-imports during execution are cheap.
+ * workflow through {@link WorkflowLoader.loadWorkflow} and extracts the
+ * display-relevant fields — the full compiled definition is discarded
+ * after extraction so re-imports during execution are cheap.
+ *
+ * Broken entries still materialise with empty `description` / `inputs`
+ * and a non-`ok` {@link status}, so the picker can render them as
+ * visible "update required" / "failed to load" rows instead of
+ * silently omitting them (the previous behaviour, which made user and
+ * global workflows vanish whenever the base SDK shape drifted between
+ * releases).
  */
 export interface WorkflowWithMetadata extends DiscoveredWorkflow {
-    /** Workflow description, empty string when none was declared. */
+    /** Workflow description, empty string when none was declared or the workflow failed to load. */
     description: string;
-    /** Picker-ready input schema; free-form workflows materialize a prompt field. */
+    /** Picker-ready input schema; empty for free-form or failed-to-load workflows. */
     inputs: readonly WorkflowInput[];
+    /** Load outcome — non-`ok` entries are rendered as visible diagnostics in the picker/list. */
+    status: WorkflowMetadataStatus;
 }
 /**
- * Load metadata (description + picker-ready inputs) for a batch of discovered workflows.
+ * Load metadata (description + picker-ready inputs + status) for a batch
+ * of discovered workflows.
+ *
+ * **Failed workflows are kept in the returned list**, not dropped. Each
+ * broken entry carries a {@link WorkflowMetadataStatus} explaining the
+ * failure so the picker and `atomic workflow -l` can surface it as an
+ * actionable diagnostic. This is the only way end users discover that a
+ * workflow from an older SDK release has gone incompatible after an
+ * `atomic` upgrade — silent filtering would leave them with a missing
+ * entry and no breadcrumb.
  *
- * Workflows that fail to import are **skipped silently** so one broken
- * entry can never prevent the picker from rendering. Callers that need
- * to surface load errors (e.g. `atomic workflow -n broken`) should use
- * {@link WorkflowLoader.loadWorkflow} directly — that path produces
- * structured error reports.
+ * Callers that want to execute a workflow should still route through
+ * {@link WorkflowLoader.loadWorkflow} — this function throws away the
+ * compiled definition so re-running the loader on a confirmed pick is
+ * unavoidable.
  */
 export declare function loadWorkflowsMetadata(discovered: DiscoveredWorkflow[]): Promise<WorkflowWithMetadata[]>;
 //# sourceMappingURL=discovery.d.ts.map

package/dist/sdk/runtime/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxC;AAUD,eAAO,MAAM,MAAM,EAAE,SAAS,EAAsC,CAAC;AAGrE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QASpB,CAAC;AAkGb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,GAAE,MAAsB,EACnC,WAAW,CAAC,EAAE,SAAS,EACvB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAoD/B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAGpC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,kBAAkB,EAAE,GAC/B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAejC"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxC;AAUD,eAAO,MAAM,MAAM,EAAE,SAAS,EAAsC,CAAC;AAGrE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QASpB,CAAC;AAkGb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,GAAE,MAAsB,EACnC,WAAW,CAAC,EAAE,SAAS,EACvB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAoD/B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAGpC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,gGAAgG;IAChG,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,8FAA8F;IAC9F,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,kBAAkB,EAAE,GAC/B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA2CjC"}

package/dist/sdk/runtime/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMzD,yBAAiB,cAAc,CAAC;IAK9B,kCAAkC;IAClC,KAAY,EAAE,CAAC,CAAC,IAAI;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC;IAE3C,2DAA2D;IAC3D,KAAY,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI;QACzC,EAAE,EAAE,KAAK,CAAC;QACV,KAAK,EAAE,CAAC,CAAC;QACT,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,KAAY,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAMrE,+DAA+D;IAC/D,KAAY,IAAI,GAAG,kBAAkB,CAAC;IAEtC,mCAAmC;IACnC,KAAY,QAAQ,GAAG,IAAI,CAAC;IAE5B,6EAA6E;IAC7E,KAAY,iBAAiB,GAAG,OAAO,aAAa,EAAE,iBAAiB,CAAC;IAExE,oCAAoC;IACpC,KAAY,SAAS,GAAG,QAAQ,GAAG;QACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;KAC/B,CAAC;IAEF,mDAAmD;IACnD,KAAY,MAAM,GAAG,SAAS,GAAG;QAC/B,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;IAMF,UAAiB,MAAM;QACrB,kCAAkC;QAClC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,KAAK,IAAI,CAAC;QACzD,uDAAuD;QACvD,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;QAC/C,iCAAiC;QACjC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAC3F;IAMD,uCAAuC;IACvC,SAAsB,OAAO,CAC3B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAoB3C;IAsBD;;;OAGG;IACH,SAAsB,QAAQ,CAC5B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAiB7C;IAMD;;;OAGG;IACH,SAAsB,IAAI,CACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqCtC;IAMD;;;;;OAKG;IACH,SAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC,CA6B/D;CACF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAazD,yBAAiB,cAAc,CAAC;IAK9B,kCAAkC;IAClC,KAAY,EAAE,CAAC,CAAC,IAAI;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC;IAE3C,2DAA2D;IAC3D,KAAY,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI;QACzC,EAAE,EAAE,KAAK,CAAC;QACV,KAAK,EAAE,CAAC,CAAC;QACT,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,KAAY,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAMrE,+DAA+D;IAC/D,KAAY,IAAI,GAAG,kBAAkB,CAAC;IAEtC,mCAAmC;IACnC,KAAY,QAAQ,GAAG,IAAI,CAAC;IAE5B,6EAA6E;IAC7E,KAAY,iBAAiB,GAAG,OAAO,aAAa,EAAE,iBAAiB,CAAC;IAExE,oCAAoC;IACpC,KAAY,SAAS,GAAG,QAAQ,GAAG;QACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;KAC/B,CAAC;IAEF,mDAAmD;IACnD,KAAY,MAAM,GAAG,SAAS,GAAG;QAC/B,UAAU,EAAE,kBAAkB,CAAC;KAChC,CAAC;IAMF,UAAiB,MAAM;QACrB,kCAAkC;QAClC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,KAAK,IAAI,CAAC;QACzD,uDAAuD;QACvD,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;QAC/C,iCAAiC;QACjC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAC3F;IAMD,uCAAuC;IACvC,SAAsB,OAAO,CAC3B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAoB3C;IAsBD;;;OAGG;IACH,SAAsB,QAAQ,CAC5B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAiB7C;IAMD;;;OAGG;IACH,SAAsB,IAAI,CACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyDtC;IAMD;;;;;OAKG;IACH,SAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC,CA6B/D;CACF"}

package/dist/sdk/runtime/version-compat.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tiny semver comparator used to check a workflow's declared
+ * `minSDKVersion` against the bundled CLI {@link VERSION}.
+ *
+ * Accepts the subset of semver we actually ship: `MAJOR.MINOR.PATCH`
+ * with an optional numeric prerelease (e.g. `0.5.21`, `0.5.21-0`).
+ * Anything more exotic (build metadata, alpha tags) is treated as a
+ * plain string and compared lexicographically on the prerelease tail,
+ * which is good enough for "is the installed CLI new enough?".
+ *
+ * Isolated from the `semver` npm package so the workflow loader stays
+ * dependency-free — this check runs for every discovered workflow on
+ * every CLI launch.
+ */
+/**
+ * Return a negative number if `a < b`, positive if `a > b`, 0 if equal.
+ * Unparseable inputs compare as equal so we never block a workflow over
+ * a typo in its `minSDKVersion` — the visible load error is friendlier
+ * than a hard refusal.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * True when the current CLI is new enough to run a workflow that
+ * declared `minRequired`. A null/undefined requirement always
+ * satisfies — workflows that don't opt in are treated as compatible.
+ */
+export declare function satisfiesMinVersion(current: string, minRequired: string | null | undefined): boolean;
+//# sourceMappingURL=version-compat.d.ts.map

package/dist/sdk/runtime/version-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compat.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/version-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAGT"}

package/dist/sdk/types.d.ts

@@ -293,6 +293,22 @@ export interface WorkflowOptions<I extends readonly WorkflowInput[] = readonly W
      * and enforce them on `ctx.inputs`.
      */
     inputs?: I;
+    /**
+     * Minimum Atomic CLI version this workflow is known to work with.
+     *
+     * When set, the CLI refuses to load the workflow on an older install
+     * and surfaces an actionable "update required" entry in the picker
+     * and `atomic workflow -l` output instead of silently dropping it.
+     *
+     * Leave unset (the default) to opt out entirely — the workflow will
+     * be treated as compatible with every CLI version. Use this when you
+     * consume a new SDK feature (new provider API, a new field on the
+     * stage options, etc.) that older installs can't honour.
+     *
+     * Accepts `MAJOR.MINOR.PATCH` with an optional numeric prerelease
+     * (`0.6.0`, `0.6.0-0`). Invalid strings are ignored.
+     */
+    minSDKVersion?: string;
 }
 /**
  * A compiled workflow definition — the sealed output of defineWorkflow().compile().
@@ -303,6 +319,11 @@ export interface WorkflowDefinition<A extends AgentType = AgentType, N extends s
     readonly description: string;
     /** Declared input schema — empty array for free-form workflows. */
     readonly inputs: readonly WorkflowInput[];
+    /**
+     * Minimum Atomic SDK version required. `null` when the workflow
+     * declared no requirement — treated as compatible with every CLI.
+     */
+    readonly minSDKVersion: string | null;
     /** The workflow's entry point. Called by the executor with a WorkflowContext. */
     readonly run: (ctx: WorkflowContext<A, N>) => Promise<void>;
 }

package/dist/sdk/types.d.ts.map

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

package/dist/sdk/workflows/index.d.ts

@@ -17,7 +17,7 @@ export { validateOpenCodeWorkflow } from "../providers/opencode.ts";
 export type { TmuxResult, TmuxSession, SessionType } from "../runtime/tmux.ts";
 export { SOCKET_NAME, isTmuxInstalled, getMuxBinary, resetMuxBinaryCache, isInsideTmux, isInsideAtomicSocket, createSession, createWindow, createPane, sendLiteralText, sendSpecialKey, sendKeysAndSubmit, capturePane, capturePaneVisible, capturePaneScrollback, killSession, killWindow, sessionExists, listSessions, attachSession, spawnMuxAttach, switchClient, getCurrentSession, attachOrSwitch, detachAndAttachAtomic, selectWindow, setSessionEnv, getSessionEnv, parseSessionName, waitForOutput, tmuxRun, normalizeTmuxCapture, normalizeTmuxLines, paneLooksReady, paneHasActiveTask, paneIsIdle, waitForPaneReady, attemptSubmitRounds, } from "../runtime/tmux.ts";
 export { AGENTS, discoverWorkflows, findWorkflow, loadWorkflowsMetadata, WORKFLOWS_GITIGNORE, } from "../runtime/discovery.ts";
-export type { DiscoveredWorkflow, WorkflowWithMetadata, } from "../runtime/discovery.ts";
+export type { DiscoveredWorkflow, WorkflowWithMetadata, WorkflowMetadataStatus, } from "../runtime/discovery.ts";
 export { WorkflowLoader } from "../runtime/loader.ts";
 export { executeWorkflow } from "../runtime/executor.ts";
 export type { WorkflowRunOptions } from "../runtime/executor.ts";

package/dist/sdk/workflows/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5I,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5I,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,QAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.21-0",
+  "version": "0.5.21",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",

package/src/commands/cli/workflow-command.test.ts

@@ -300,7 +300,11 @@ describe("workflowCommand --list", () => {
     expect(cap.stdout).not.toContain("copilot-only");
   });
 
-  test("excludes workflows missing .compile() from the list", async () => {
+  test("shows workflows missing .compile() with a broken marker", async () => {
+    // Broken workflows used to vanish from the list silently. Surfacing
+    // them with a visible "✗ broken" badge is the remediation for the
+    // "my workflow disappeared after upgrading" class of bug reports —
+    // the user can now see the file still exists and needs a fix.
     await writeCompiledWorkflow({ name: "good", agent: "copilot" });
     await writeCompiledWorkflow({
       name: "not-compiled",
@@ -324,10 +328,11 @@ export default defineWorkflow({ name: "not-compiled" })
 
     expect(code).toBe(0);
     expect(cap.stdout).toContain("good");
-    expect(cap.stdout).not.toContain("not-compiled");
+    expect(cap.stdout).toContain("not-compiled");
+    expect(cap.stdout).toContain("✗ broken");
   });
 
-  test("excludes workflows with type errors from the list", async () => {
+  test("shows workflows with type errors with a broken marker", async () => {
     await writeCompiledWorkflow({ name: "valid", agent: "copilot" });
     await writeCompiledWorkflow({
       name: "broken-syntax",
@@ -345,7 +350,8 @@ export default defineWorkflow({ name: "not-compiled" })
 
     expect(code).toBe(0);
     expect(cap.stdout).toContain("valid");
-    expect(cap.stdout).not.toContain("broken-syntax");
+    expect(cap.stdout).toContain("broken-syntax");
+    expect(cap.stdout).toContain("✗ broken");
   });
 
   test("renders the empty state when no workflows exist and no agent filter is set", async () => {

package/src/commands/cli/workflow-inputs.test.ts

@@ -172,6 +172,7 @@ function fakeDefinition(
     name,
     description,
     inputs,
+    minSDKVersion: null,
     run: async () => {},
   } as WorkflowDefinition;
 }

package/src/commands/cli/workflow.test.ts

@@ -6,7 +6,10 @@ import {
   renderWorkflowList,
 } from "./workflow.ts";
 import type { WorkflowInput } from "../../sdk/workflows/index.ts";
-import type { DiscoveredWorkflow } from "../../sdk/workflows/index.ts";
+import type {
+  DiscoveredWorkflow,
+  WorkflowWithMetadata,
+} from "../../sdk/workflows/index.ts";
 
 // ─── Colour handling ────────────────────────────────────────────────────────
 // The renderer emits ANSI sequences when the host terminal claims truecolor
@@ -190,12 +193,16 @@ function wf(
   name: string,
   agent: DiscoveredWorkflow["agent"],
   source: DiscoveredWorkflow["source"],
-): DiscoveredWorkflow {
+  status: WorkflowWithMetadata["status"] = { kind: "ok" },
+): WorkflowWithMetadata {
   return {
     name,
     agent,
     source,
     path: `/tmp/fake/${source}/${name}/${agent}/index.ts`,
+    description: "",
+    inputs: [],
+    status,
   };
 }
 
@@ -216,7 +223,7 @@ describe("renderWorkflowList", () => {
   });
 
   test("groups entries by source → provider and sorts names", () => {
-    const workflows: DiscoveredWorkflow[] = [
+    const workflows: WorkflowWithMetadata[] = [
       wf("zebra", "claude", "local"),
       wf("apple", "claude", "local"),
       wf("middle", "opencode", "local"),

package/src/commands/cli/workflow.ts

@@ -27,6 +27,7 @@ import type {
   AgentType,
   DiscoveredWorkflow,
   WorkflowInput,
+  WorkflowMetadataStatus,
   WorkflowWithMetadata,
 } from "../../sdk/workflows/index.ts";
 import { WorkflowPickerPanel } from "../../sdk/components/workflow-picker-panel.tsx";
@@ -227,8 +228,11 @@ export async function workflowCommand(options: {
       options.agent as AgentType | undefined,
       { merge: false },
     );
-    // Filter out workflows that fail to load (type errors, missing
-    // .compile(), etc.) so the list only shows workflows ready to run.
+    // Keep workflows that failed to load in the list — their status is
+    // surfaced inline as a "needs update" or "broken" tag so the user
+    // can see that a workflow still exists on disk even after an SDK
+    // bump invalidated it. Silent filtering was the original cause of
+    // the "workflow vanished after upgrade" report.
     const workflows = await loadWorkflowsMetadata(discovered);
     process.stdout.write(renderWorkflowList(workflows));
     return 0;
@@ -477,9 +481,13 @@ async function runNamedMode(
       `  ~/.atomic/workflows/${name}/${agent}/index.ts ${COLORS.dim}(global)${COLORS.reset}`,
     );
 
-    const available = await loadWorkflowsMetadata(
-      await discoverWorkflows(cwd, agent),
-    );
+    // Only suggest runnable alternatives — broken/incompatible workflows
+    // are visible via `atomic workflow -l` where their status is surfaced;
+    // listing them here would mask the real problem (the name the user
+    // typed does not exist) behind a dead-end suggestion.
+    const available = (
+      await loadWorkflowsMetadata(await discoverWorkflows(cwd, agent))
+    ).filter((w) => w.status.kind === "ok");
     if (available.length > 0) {
       console.error(`\nAvailable ${agent} workflows:`);
       for (const wf of available) {
@@ -608,6 +616,29 @@ const SOURCE_COLORS: Record<DiscoveredWorkflow["source"], PaletteKey> = {
   builtin: "info",  // sky    — ships with atomic, foundational
 };
 
+/**
+ * Per-row status badge shown in `atomic workflow -l` output. `ok` rows
+ * render with no badge (the list is already dense; flagging only
+ * non-ok rows keeps the happy path untouched). Incompatible rows
+ * include the required version so the user can compare at a glance;
+ * error rows stay terse and defer detail to `atomic workflow -n
+ * <name>` which surfaces the structured loader message.
+ */
+function renderStatusBadge(
+  paint: ReturnType<typeof createPainter>,
+  status: WorkflowMetadataStatus,
+): string {
+  if (status.kind === "ok") return "";
+  if (status.kind === "incompatible") {
+    return (
+      "  " +
+      paint("warning", "⚠ needs v" + status.requiredVersion) +
+      paint("dim", `  (installed v${status.currentVersion})`)
+    );
+  }
+  return "  " + paint("error", "✗ broken");
+}
+
 /**
  * Render `atomic workflow --list` output as a printable string.
  *
@@ -635,7 +666,7 @@ const SOURCE_COLORS: Record<DiscoveredWorkflow["source"], PaletteKey> = {
  * Exported for testing — the pure-function shape makes coverage for the
  * renderer trivial without spinning up a full CLI invocation.
  */
-export function renderWorkflowList(workflows: DiscoveredWorkflow[]): string {
+export function renderWorkflowList(workflows: WorkflowWithMetadata[]): string {
   const paint = createPainter();
   const lines: string[] = [];
 
@@ -653,9 +684,11 @@ export function renderWorkflowList(workflows: DiscoveredWorkflow[]): string {
     return lines.join("\n") + "\n";
   }
 
-  // Group by source → agent → sorted names. This gives the renderer O(1)
-  // lookups at both nesting levels and keeps the output deterministic.
-  type ByAgent = Map<AgentType, string[]>;
+  // Group by source → agent → sorted entries. Entries carry the full
+  // metadata (name + status) so the row renderer can append a status
+  // badge to non-ok rows without another lookup.
+  type EntrySummary = { name: string; status: WorkflowMetadataStatus };
+  type ByAgent = Map<AgentType, EntrySummary[]>;
   const bySource = new Map<DiscoveredWorkflow["source"], ByAgent>();
   for (const wf of workflows) {
     let byAgent = bySource.get(wf.source);
@@ -663,13 +696,13 @@ export function renderWorkflowList(workflows: DiscoveredWorkflow[]): string {
       byAgent = new Map();
       bySource.set(wf.source, byAgent);
     }
-    const names = byAgent.get(wf.agent) ?? [];
-    names.push(wf.name);
-    byAgent.set(wf.agent, names);
+    const entries = byAgent.get(wf.agent) ?? [];
+    entries.push({ name: wf.name, status: wf.status });
+    byAgent.set(wf.agent, entries);
   }
   for (const byAgent of bySource.values()) {
-    for (const names of byAgent.values()) {
-      names.sort((a, b) => a.localeCompare(b));
+    for (const entries of byAgent.values()) {
+      entries.sort((a, b) => a.name.localeCompare(b.name));
     }
   }
 
@@ -702,8 +735,8 @@ export function renderWorkflowList(workflows: DiscoveredWorkflow[]): string {
     );
 
     for (const agent of AGENT_ORDER) {
-      const names = byAgent.get(agent);
-      if (!names || names.length === 0) continue;
+      const entries = byAgent.get(agent);
+      if (!entries || entries.length === 0) continue;
 
       // Provider heading: bold accent blue — a clearly different layer from
       // both the semantic source heading above and the neutral entries below.
@@ -712,8 +745,14 @@ export function renderWorkflowList(workflows: DiscoveredWorkflow[]): string {
         "    " + paint("accent", AGENT_DISPLAY_NAMES[agent], { bold: true }),
       );
 
-      for (const name of names) {
-        lines.push("      " + paint("text", name));
+      for (const entry of entries) {
+        // Dim the name on non-ok rows so the eye lands on the status
+        // badge rather than the workflow name — the badge is where the
+        // actionable info lives, and the name is already unrunnable.
+        const nameCol: PaletteKey = entry.status.kind === "ok" ? "text" : "dim";
+        lines.push(
+          "      " + paint(nameCol, entry.name) + renderStatusBadge(paint, entry.status),
+        );
       }
     }
   }

package/src/sdk/components/workflow-picker-panel.tsx

@@ -42,7 +42,10 @@ import { useState, useEffect, useMemo, useRef, useCallback, useContext, createCo
 import { useLatest } from "./hooks.ts";
 import { resolveTheme, type TerminalTheme } from "../runtime/theme.ts";
 import type { AgentType, WorkflowInput } from "../types.ts";
-import type { WorkflowWithMetadata } from "../runtime/discovery.ts";
+import type {
+  WorkflowWithMetadata,
+  WorkflowMetadataStatus,
+} from "../runtime/discovery.ts";
 import { ErrorBoundary } from "./error-boundary.tsx";
 
 // ─── Theme ──────────────────────────────────────
@@ -258,6 +261,38 @@ export function buildRows(entries: ListEntry[], query: string): ListRow[] {
   return rows;
 }
 
+// ─── Status helpers ─────────────────────────────
+// Non-ok entries stay visible in the picker so the user sees that a
+// workflow from an older SDK release (or one with a load error) still
+// exists on disk — the previous behaviour silently dropped them, which
+// made user/global workflows appear to vanish after an atomic upgrade.
+
+/** Unicode glyph that prefixes a non-ok entry and heads its preview. */
+const STATUS_ICON: Record<WorkflowMetadataStatus["kind"], string> = {
+  ok: " ",
+  incompatible: "⚠",
+  error: "✗",
+};
+
+/** Compact single-word label used in list rows and the bottom hint. */
+const STATUS_LABEL: Record<WorkflowMetadataStatus["kind"], string> = {
+  ok: "",
+  incompatible: "update",
+  error: "broken",
+};
+
+/** Map each status kind to its semantic palette slot. */
+const STATUS_COLOR: Record<WorkflowMetadataStatus["kind"], keyof PickerTheme> = {
+  ok: "success",
+  incompatible: "warning",
+  error: "error",
+};
+
+/** Non-ok rows are inert — Enter / run commands must not transition the picker. */
+function isRunnable(wf: WorkflowWithMetadata): boolean {
+  return wf.status.kind === "ok";
+}
+
 // ─── Validation ─────────────────────────────────
 
 export function isFieldValid(field: WorkflowInput, value: string): boolean {
@@ -385,6 +420,24 @@ const WorkflowList = memo(function WorkflowList({
         const entryIdx = entryIndexByRow.get(i) ?? -1;
         const isFocused = entryIdx === focusedEntryIdx;
         const wf = row.entry.workflow;
+        const statusKind = wf.status.kind;
+        const runnable = statusKind === "ok";
+        // Status indicator sits between the focus marker and the name so
+        // every row shares a 4-character gutter — ok rows render a blank
+        // gutter, so the list stays visually flush while non-ok rows
+        // always occupy a fixed slot (no layout jitter when filtering).
+        const statusIcon = STATUS_ICON[statusKind];
+        const statusCol = theme[STATUS_COLOR[statusKind]];
+        // Non-ok rows fade the name so the "diagnostic, not selectable"
+        // read is immediate even when the user hasn't reached the row
+        // yet — the eye catches the warning glyph + dim text together.
+        const nameCol = runnable
+          ? isFocused
+            ? theme.text
+            : theme.textMuted
+          : isFocused
+            ? theme.textMuted
+            : theme.textDim;
 
         return (
           <box
@@ -399,7 +452,10 @@ const WorkflowList = memo(function WorkflowList({
               <span fg={isFocused ? theme.primary : theme.textDim}>
                 {isFocused ? "▸ " : "  "}
               </span>
-              <span fg={isFocused ? theme.text : theme.textMuted}>
+              <span fg={statusCol}>
+                {statusIcon + " "}
+              </span>
+              <span fg={nameCol}>
                 {wf.name}
               </span>
             </text>
@@ -459,6 +515,59 @@ const ArgumentRow = memo(function ArgumentRow({
   );
 });
 
+/**
+ * Diagnostic block for non-ok workflows. Replaces the description +
+ * arguments sections in the preview pane so the user sees *why* a row
+ * is inert and what to do about it, instead of an empty-looking panel.
+ */
+const StatusDiagnostic = memo(function StatusDiagnostic({
+  status,
+}: {
+  status: Exclude<WorkflowMetadataStatus, { kind: "ok" }>;
+}) {
+  const theme = usePickerTheme();
+  const color = theme[STATUS_COLOR[status.kind]];
+  const icon = STATUS_ICON[status.kind];
+
+  // Headline + sub-copy split: the headline is terse (three words) so
+  // it reads at a glance even on a narrow right pane; the sub-copy
+  // explains *why* and the third paragraph tells the user what to do.
+  const headline =
+    status.kind === "incompatible"
+      ? "update required"
+      : "failed to load";
+  const detail =
+    status.kind === "incompatible"
+      ? `Needs Atomic v${status.requiredVersion}. Installed: v${status.currentVersion}.`
+      : status.message;
+  const remediation =
+    status.kind === "incompatible"
+      ? "Update Atomic, or re-save the workflow against the current SDK."
+      : "Open the workflow file and fix the error above.";
+
+  return (
+    <box flexDirection="column">
+      <text>
+        <span fg={color}>
+          <strong>{icon + " " + headline}</strong>
+        </span>
+      </text>
+
+      <box height={1} />
+
+      <text>
+        <span fg={theme.textMuted}>{detail}</span>
+      </text>
+
+      <box height={1} />
+
+      <text>
+        <span fg={theme.textDim}>{remediation}</span>
+      </text>
+    </box>
+  );
+});
+
 const Preview = memo(function Preview({
   wf,
 }: {
@@ -466,6 +575,7 @@ const Preview = memo(function Preview({
 }) {
   const theme = usePickerTheme();
   const args = wf.inputs;
+  const status = wf.status;
 
   return (
     <box
@@ -493,21 +603,27 @@ const Preview = memo(function Preview({
 
       <box height={2} />
 
-      <text>
-        <span fg={theme.textMuted}>
-          {wf.description || "(no description)"}
-        </span>
-      </text>
-
-      {args.length > 0 && (
+      {status.kind === "ok" ? (
         <>
-          <box height={2} />
-          <SectionLabel label="ARGUMENTS" />
-          <box height={1} />
-          {args.map((f) => (
-            <ArgumentRow key={f.name} field={f} />
-          ))}
+          <text>
+            <span fg={theme.textMuted}>
+              {wf.description || "(no description)"}
+            </span>
+          </text>
+
+          {args.length > 0 && (
+            <>
+              <box height={2} />
+              <SectionLabel label="ARGUMENTS" />
+              <box height={1} />
+              {args.map((f) => (
+                <ArgumentRow key={f.name} field={f} />
+              ))}
+            </>
+          )}
         </>
+      ) : (
+        <StatusDiagnostic status={status} />
       )}
     </box>
   );
@@ -1022,6 +1138,14 @@ const PICK_HINTS: Hint[] = [
   { key: "↵", label: "select" },
   { key: "esc", label: "quit" },
 ];
+// Shown instead of PICK_HINTS when the focused row is non-ok — the dim
+// `↵ unavailable` reads immediately as "this row is navigable but not
+// runnable", which matches the muted row colour and preview diagnostic.
+const PICK_HINTS_UNAVAILABLE: Hint[] = [
+  { key: "↑↓", label: "navigate" },
+  { key: "↵", label: "unavailable", dim: true },
+  { key: "esc", label: "quit" },
+];
 const CONFIRM_HINTS: Hint[] = [
   { key: "y", label: "submit" },
   { key: "n", label: "cancel" },
@@ -1134,7 +1258,26 @@ const Statusline = memo(function Statusline({
       {focusedWf ? (
         <box paddingLeft={1} paddingRight={1} alignItems="center">
           <text>
-            <span fg={theme.text}>{focusedWf.name}</span>
+            {focusedWf.status.kind !== "ok" ? (
+              <span fg={theme[STATUS_COLOR[focusedWf.status.kind]]}>
+                {STATUS_ICON[focusedWf.status.kind] + " "}
+              </span>
+            ) : null}
+            <span
+              fg={
+                focusedWf.status.kind === "ok" ? theme.text : theme.textMuted
+              }
+            >
+              {focusedWf.name}
+            </span>
+            {focusedWf.status.kind !== "ok" ? (
+              <>
+                <span fg={theme.textDim}>{"  ·  "}</span>
+                <span fg={theme[STATUS_COLOR[focusedWf.status.kind]]}>
+                  {STATUS_LABEL[focusedWf.status.kind]}
+                </span>
+              </>
+            ) : null}
           </text>
         </box>
       ) : null}
@@ -1247,7 +1390,10 @@ function usePickerKeyboard(state: PickerKeyboardState): void {
     if (key.name === "return") {
       key.stopPropagation();
       const wf = focusedWfRef.current;
-      if (wf) {
+      // Silently swallow Enter on incompatible / broken entries — the
+      // preview pane already explains the failure; advancing into the
+      // prompt phase would be misleading since the workflow can't run.
+      if (wf && isRunnable(wf)) {
         const initial: Record<string, string> = {};
         for (const f of wf.inputs) {
           initial[f.name] =
@@ -1408,10 +1554,13 @@ export function WorkflowPicker({
     setConfirmOpen,
   });
 
+  const focusedIsRunnable = focusedWf ? isRunnable(focusedWf) : true;
   const hints = confirmOpen
     ? CONFIRM_HINTS
     : phase === "pick"
-      ? PICK_HINTS
+      ? focusedIsRunnable
+        ? PICK_HINTS
+        : PICK_HINTS_UNAVAILABLE
       : isFormValid
         ? PROMPT_HINTS_VALID
         : PROMPT_HINTS_INVALID;

package/src/sdk/define-workflow.ts

@@ -152,6 +152,7 @@ export class WorkflowBuilder<A extends AgentType = AgentType, N extends string =
       name: this.options.name,
       description: this.options.description ?? "",
       inputs,
+      minSDKVersion: this.options.minSDKVersion ?? null,
       run: runFn,
     };
   }

package/src/sdk/errors.ts

@@ -38,6 +38,26 @@ export class InvalidWorkflowError extends Error {
   }
 }
 
+/**
+ * Thrown when a workflow declares a `minSDKVersion` newer than the
+ * bundled CLI. Carries both versions so the CLI can render an
+ * actionable "update atomic or re-save the workflow" hint rather than
+ * a generic load error.
+ */
+export class IncompatibleSDKError extends Error {
+  constructor(
+    public readonly path: string,
+    public readonly requiredVersion: string,
+    public readonly currentVersion: string,
+  ) {
+    super(
+      `${path} requires Atomic SDK v${requiredVersion}, but v${currentVersion} is installed.\n` +
+      `  Update Atomic, or re-save the workflow against the current SDK.`,
+    );
+    this.name = "IncompatibleSDKError";
+  }
+}
+
 /** Extract a human-readable message from an unknown thrown value. */
 export function errorMessage(error: unknown): string {
   return error instanceof Error ? error.message : String(error);

package/src/sdk/runtime/discovery.ts

@@ -17,6 +17,7 @@ import { homedir } from "node:os";
 import ignore from "ignore";
 import type { AgentType, WorkflowInput } from "../types.ts";
 import { WorkflowLoader } from "./loader.ts";
+import { IncompatibleSDKError } from "../errors.ts";
 
 export interface DiscoveredWorkflow {
   name: string;
@@ -248,47 +249,120 @@ export async function findWorkflow(
   return all.find((w) => w.name === name) ?? null;
 }
 
+/**
+ * Load status for a {@link WorkflowWithMetadata} entry.
+ *
+ * - `ok`            — the workflow compiled cleanly and is ready to run.
+ * - `incompatible`  — the workflow declared a `minSDKVersion` newer
+ *                     than the bundled CLI. The CLI renders it with an
+ *                     "update required" badge so users see the mismatch
+ *                     rather than a silent disappearance.
+ * - `error`         — any other load failure (syntax error, missing
+ *                     `.compile()`, invalid default export, etc.).
+ *                     Rendered with a "failed to load" badge plus the
+ *                     underlying message.
+ */
+export type WorkflowMetadataStatus =
+  | { kind: "ok" }
+  | {
+      kind: "incompatible";
+      requiredVersion: string;
+      currentVersion: string;
+      message: string;
+    }
+  | {
+      kind: "error";
+      stage: "resolve" | "validate" | "load";
+      message: string;
+    };
+
 /**
  * A discovered workflow enriched with the metadata the picker needs to
- * render it: the human description and the declared input schema.
+ * render it: the human description, the declared input schema, and the
+ * load status.
  *
  * Populated by {@link loadWorkflowsMetadata}, which runs each discovered
- * workflow through {@link WorkflowLoader.loadWorkflow} and extracts just
- * the display-relevant fields — the full compiled definition is
- * discarded after extraction so re-imports during execution are cheap.
+ * workflow through {@link WorkflowLoader.loadWorkflow} and extracts the
+ * display-relevant fields — the full compiled definition is discarded
+ * after extraction so re-imports during execution are cheap.
+ *
+ * Broken entries still materialise with empty `description` / `inputs`
+ * and a non-`ok` {@link status}, so the picker can render them as
+ * visible "update required" / "failed to load" rows instead of
+ * silently omitting them (the previous behaviour, which made user and
+ * global workflows vanish whenever the base SDK shape drifted between
+ * releases).
  */
 export interface WorkflowWithMetadata extends DiscoveredWorkflow {
-  /** Workflow description, empty string when none was declared. */
+  /** Workflow description, empty string when none was declared or the workflow failed to load. */
   description: string;
-  /** Picker-ready input schema; free-form workflows materialize a prompt field. */
+  /** Picker-ready input schema; empty for free-form or failed-to-load workflows. */
   inputs: readonly WorkflowInput[];
+  /** Load outcome — non-`ok` entries are rendered as visible diagnostics in the picker/list. */
+  status: WorkflowMetadataStatus;
 }
 
 /**
- * Load metadata (description + picker-ready inputs) for a batch of discovered workflows.
+ * Load metadata (description + picker-ready inputs + status) for a batch
+ * of discovered workflows.
  *
- * Workflows that fail to import are **skipped silently** so one broken
- * entry can never prevent the picker from rendering. Callers that need
- * to surface load errors (e.g. `atomic workflow -n broken`) should use
- * {@link WorkflowLoader.loadWorkflow} directly — that path produces
- * structured error reports.
+ * **Failed workflows are kept in the returned list**, not dropped. Each
+ * broken entry carries a {@link WorkflowMetadataStatus} explaining the
+ * failure so the picker and `atomic workflow -l` can surface it as an
+ * actionable diagnostic. This is the only way end users discover that a
+ * workflow from an older SDK release has gone incompatible after an
+ * `atomic` upgrade — silent filtering would leave them with a missing
+ * entry and no breadcrumb.
+ *
+ * Callers that want to execute a workflow should still route through
+ * {@link WorkflowLoader.loadWorkflow} — this function throws away the
+ * compiled definition so re-running the loader on a confirmed pick is
+ * unavoidable.
  */
 export async function loadWorkflowsMetadata(
   discovered: DiscoveredWorkflow[],
 ): Promise<WorkflowWithMetadata[]> {
-  const results = await Promise.all(
-    discovered.map(async (wf): Promise<WorkflowWithMetadata | null> => {
+  return Promise.all(
+    discovered.map(async (wf): Promise<WorkflowWithMetadata> => {
       const loaded = await WorkflowLoader.loadWorkflow(wf);
-      if (!loaded.ok) return null;
+      if (loaded.ok) {
+        return {
+          ...wf,
+          description: loaded.value.definition.description,
+          inputs: loaded.value.definition.inputs,
+          status: { kind: "ok" },
+        };
+      }
+
+      // Incompatible SDK version is a first-class status so the UI can
+      // show a dedicated "update required" hint. Every other failure
+      // maps to a generic `error` variant — the picker renders the
+      // message but doesn't try to interpret it further.
+      if (loaded.error instanceof IncompatibleSDKError) {
+        return {
+          ...wf,
+          description: "",
+          inputs: [],
+          status: {
+            kind: "incompatible",
+            requiredVersion: loaded.error.requiredVersion,
+            currentVersion: loaded.error.currentVersion,
+            message: loaded.message,
+          },
+        };
+      }
+
       return {
         ...wf,
-        description: loaded.value.definition.description,
-        inputs: loaded.value.definition.inputs,
+        description: "",
+        inputs: [],
+        status: {
+          kind: "error",
+          stage: loaded.stage,
+          message: loaded.message,
+        },
       };
     }),
   );
-  return results.filter(
-    (r): r is WorkflowWithMetadata => r !== null,
-  );
 }
 

package/src/sdk/runtime/loader.ts

@@ -12,10 +12,17 @@
 
 import type { WorkflowDefinition, AgentType } from "../types.ts";
 import type { DiscoveredWorkflow } from "./discovery.ts";
-import { errorMessage, WorkflowNotCompiledError, InvalidWorkflowError } from "../errors.ts";
+import {
+  errorMessage,
+  WorkflowNotCompiledError,
+  InvalidWorkflowError,
+  IncompatibleSDKError,
+} from "../errors.ts";
 import { validateCopilotWorkflow } from "../providers/copilot.ts";
 import { validateOpenCodeWorkflow } from "../providers/opencode.ts";
 import { validateClaudeWorkflow } from "../providers/claude.ts";
+import { satisfiesMinVersion } from "./version-compat.ts";
+import { VERSION } from "../../version.ts";
 
 export namespace WorkflowLoader {
   // ---------------------------------------------------------------------------
@@ -180,9 +187,29 @@ export namespace WorkflowLoader {
         };
       }
 
+      const def = definition as WorkflowDefinition;
+
+      // Refuse workflows whose declared minSDKVersion is newer than the
+      // bundled CLI — the workflow author opted in to a version gate
+      // exactly so the loader could surface a clear upgrade hint
+      // instead of letting a shape-drift error bubble up at run time.
+      if (!satisfiesMinVersion(VERSION, def.minSDKVersion)) {
+        const err = new IncompatibleSDKError(
+          validated.path,
+          def.minSDKVersion ?? "",
+          VERSION,
+        );
+        return {
+          ok: false,
+          stage: "load",
+          error: err,
+          message: err.message,
+        };
+      }
+
       return {
         ok: true,
-        value: { ...validated, definition: definition as WorkflowDefinition },
+        value: { ...validated, definition: def },
       };
     } catch (error) {
       return {

package/src/sdk/runtime/version-compat.ts

@@ -0,0 +1,68 @@
+/**
+ * Tiny semver comparator used to check a workflow's declared
+ * `minSDKVersion` against the bundled CLI {@link VERSION}.
+ *
+ * Accepts the subset of semver we actually ship: `MAJOR.MINOR.PATCH`
+ * with an optional numeric prerelease (e.g. `0.5.21`, `0.5.21-0`).
+ * Anything more exotic (build metadata, alpha tags) is treated as a
+ * plain string and compared lexicographically on the prerelease tail,
+ * which is good enough for "is the installed CLI new enough?".
+ *
+ * Isolated from the `semver` npm package so the workflow loader stays
+ * dependency-free — this check runs for every discovered workflow on
+ * every CLI launch.
+ */
+
+interface ParsedVersion {
+  major: number;
+  minor: number;
+  patch: number;
+  prerelease: string;
+}
+
+function parseVersion(v: string): ParsedVersion | null {
+  const match = /^(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/.exec(v.trim());
+  if (!match) return null;
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    prerelease: match[4] ?? "",
+  };
+}
+
+/**
+ * Return a negative number if `a < b`, positive if `a > b`, 0 if equal.
+ * Unparseable inputs compare as equal so we never block a workflow over
+ * a typo in its `minSDKVersion` — the visible load error is friendlier
+ * than a hard refusal.
+ */
+export function compareVersions(a: string, b: string): number {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  if (!pa || !pb) return 0;
+
+  if (pa.major !== pb.major) return pa.major - pb.major;
+  if (pa.minor !== pb.minor) return pa.minor - pb.minor;
+  if (pa.patch !== pb.patch) return pa.patch - pb.patch;
+
+  // Per semver, a version without a prerelease outranks one with a
+  // prerelease at the same MAJOR.MINOR.PATCH (1.0.0 > 1.0.0-0).
+  if (pa.prerelease === "" && pb.prerelease !== "") return 1;
+  if (pa.prerelease !== "" && pb.prerelease === "") return -1;
+  if (pa.prerelease === pb.prerelease) return 0;
+  return pa.prerelease < pb.prerelease ? -1 : 1;
+}
+
+/**
+ * True when the current CLI is new enough to run a workflow that
+ * declared `minRequired`. A null/undefined requirement always
+ * satisfies — workflows that don't opt in are treated as compatible.
+ */
+export function satisfiesMinVersion(
+  current: string,
+  minRequired: string | null | undefined,
+): boolean {
+  if (!minRequired) return true;
+  return compareVersions(current, minRequired) >= 0;
+}

package/src/sdk/types.ts

@@ -366,6 +366,22 @@ export interface WorkflowOptions<
    * and enforce them on `ctx.inputs`.
    */
   inputs?: I;
+  /**
+   * Minimum Atomic CLI version this workflow is known to work with.
+   *
+   * When set, the CLI refuses to load the workflow on an older install
+   * and surfaces an actionable "update required" entry in the picker
+   * and `atomic workflow -l` output instead of silently dropping it.
+   *
+   * Leave unset (the default) to opt out entirely — the workflow will
+   * be treated as compatible with every CLI version. Use this when you
+   * consume a new SDK feature (new provider API, a new field on the
+   * stage options, etc.) that older installs can't honour.
+   *
+   * Accepts `MAJOR.MINOR.PATCH` with an optional numeric prerelease
+   * (`0.6.0`, `0.6.0-0`). Invalid strings are ignored.
+   */
+  minSDKVersion?: string;
 }
 
 /**
@@ -377,6 +393,11 @@ export interface WorkflowDefinition<A extends AgentType = AgentType, N extends s
   readonly description: string;
   /** Declared input schema — empty array for free-form workflows. */
   readonly inputs: readonly WorkflowInput[];
+  /**
+   * Minimum Atomic SDK version required. `null` when the workflow
+   * declared no requirement — treated as compatible with every CLI.
+   */
+  readonly minSDKVersion: string | null;
   /** The workflow's entry point. Called by the executor with a WorkflowContext. */
   readonly run: (ctx: WorkflowContext<A, N>) => Promise<void>;
 }

package/src/sdk/workflows/index.ts

@@ -105,6 +105,7 @@ export {
 export type {
   DiscoveredWorkflow,
   WorkflowWithMetadata,
+  WorkflowMetadataStatus,
 } from "../runtime/discovery.ts";
 
 // Runtime — workflow loader pipeline