@supacloud/compiler 0.23.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -96,6 +96,24 @@ protocol migration are documented in `docs/fa-consumer-governance.md` in the
96
96
  repository. `context <module> --json` reports `routeContracts` and standalone
97
97
  command execution plans; these are declarations and obligations, not runtime proof.
98
98
 
99
+ ## Migration Assessment
100
+
101
+ `migration-assess` creates a local, read-only compatibility report from the
102
+ installed tested tuple, generated contract manifest, compiler drift checks and
103
+ an optional OpenAPI baseline/current pair:
104
+
105
+ ```bash
106
+ bunx supacloud-compiler migration-assess --json \
107
+ --baseline-openapi artifacts/openapi-baseline.json \
108
+ --current-openapi artifacts/openapi-current.json
109
+ ```
110
+
111
+ The report distinguishes compatible changes, review items, breaking changes and
112
+ evidence that is not yet proven. It records artifact hashes and never writes
113
+ files, databases or remote environments. Rendering is explicitly independent:
114
+ CSR/SPA, SvelteKit, Nuxt, SSR, edge and trusted-server arrangements are valid;
115
+ SSR is never a migration prerequisite.
116
+
99
117
  SupaCloud 应用静态编译器:读取 `@supacloud/app` 装饰器元数据的原生 TypeScript AST,构建 ApplicationGraph,做静态校验,并生成**无反射、无容器**的工厂代码与 manifest。
100
118
 
101
119
  本包不依赖 `@supacloud/app`:AST 只按装饰器名匹配(`Module`/`Injectable`/`Inject`/`Command`/`Query`/`Controller`/`Get`/`Post`/`Put`/`Patch`/`Delete`/`defineModule`/`InjectionToken`),不校验 import 来源。