@astrale-os/sdk 0.5.0-beta.96 → 0.5.0-beta.97

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.5.0-beta.97](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.96...sdk-v0.5.0-beta.97) (2026-08-31)
+
+
+### Bug Fixes
+
+* **tooling:** admit stable local state machines ([#374](https://github.com/astrale-os/sdk/issues/374)) ([7ebd1b5](https://github.com/astrale-os/sdk/commit/7ebd1b54e282e1b85587e8d33d3faa22b5421cc6))
+
 ## [0.5.0-beta.96](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.95...sdk-v0.5.0-beta.96) (2026-08-31)
 
 

package/dist/tooling/linter/implementations/source/state-machine.d.ts

@@ -7,7 +7,7 @@ export type StateMachineResolution = Readonly<{
 }> | Readonly<{
     kind: 'ambiguous' | 'absent';
 }>;
-export type MachineExportStatus = 'exported' | 'private' | 'not-a-declaration';
+export type MachineExportStatus = 'exported' | 'private' | 'mutable' | 'not-a-declaration';
 /** Resolve a direct or static local alias of the SDK stateMachine constructor. */
 export declare function stateMachineConstructorOrigin(file: SourceFile, expression: ts.Expression, seen?: ReadonlySet<string>): StateMachineOrigin;
 /** Resolve one local binding to an exported SDK stateMachine authority. */

package/dist/tooling/linter/implementations/source/state-machine.js

@@ -42,6 +42,19 @@ export function stateMachineIdentity(project, file, expression, seen = new Set()
             const identity = `${file.path}\0${value.text}`;
             if (seen.has(identity))
                 return { kind: 'ambiguous' };
+            const initializer = unwrap(declaration.initializer);
+            if (ts.isCallExpression(initializer)) {
+                const origin = stateMachineConstructorOrigin(file, initializer.expression);
+                if (origin === 'ambiguous')
+                    return { kind: 'ambiguous' };
+                if (origin === 'resolved') {
+                    if (!declaration.constant)
+                        return { kind: 'ambiguous' };
+                    return machineExportStatus(file, initializer) === 'exported'
+                        ? { kind: 'resolved', identity: machineIdentity(file, value.text) }
+                        : { kind: 'absent' };
+                }
+            }
             const next = new Set(seen);
             next.add(identity);
             const resolution = stateMachineIdentity(project, file, declaration.initializer, next);
@@ -213,6 +226,8 @@ export function machineExportStatus(file, call) {
             const directlyExported = ts
                 .getModifiers(statement)
                 ?.some(({ kind }) => kind === ts.SyntaxKind.ExportKeyword);
+            if ((statement.declarationList.flags & ts.NodeFlags.Const) === 0)
+                return 'mutable';
             if (directlyExported || locallyExported(file, declaration.name.text))
                 return 'exported';
             return 'private';
@@ -356,7 +371,9 @@ function localMachineOrigin(file, name) {
                 declaration.initializer !== undefined &&
                 ts.isCallExpression(unwrap(declaration.initializer))) {
                 const call = unwrap(declaration.initializer);
-                return stateMachineConstructorOrigin(file, call.expression);
+                const origin = stateMachineConstructorOrigin(file, call.expression);
+                const constant = (statement.declarationList.flags & ts.NodeFlags.Const) !== 0;
+                return constant || origin === 'absent' ? origin : 'ambiguous';
             }
         }
     }

package/dist/tooling/linter/implementations/source/states.js

@@ -40,7 +40,9 @@ export const stateRules = [
                     if (exportStatus !== 'exported') {
                         evidence.push(violation(machine.file, machine.call, exportStatus === 'private'
                             ? 'State machine relation must be exported as its Schema module StateMachine authority.'
-                            : 'State machine relation must be assigned to one exported top-level binding.'));
+                            : exportStatus === 'mutable'
+                                ? 'State machine relation must be declared const as its stable Schema module authority.'
+                                : 'State machine relation must be assigned to one exported top-level binding.'));
                     }
                     evidence.push(...admitStaticRelation(machine.file, machine.call));
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/sdk",
-  "version": "0.5.0-beta.96",
+  "version": "0.5.0-beta.97",
   "description": "Schema-first SDK for defining, composing, and deploying Astrale domains",
   "keywords": [
     "astrale",