@chidchanun/bcp 0.2.18 → 0.3.0

package/docs/platform-manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "framework": "bcp",
-  "version": "0.2.18",
+  "version": "0.3.0",
   "releaseState": "unreleased",
-  "baseline": "deployment-platform-v2",
+  "baseline": "application-platform",
   "runtime": {
     "node": ">=24.11.0",
     "react": "19",
@@ -27,6 +27,7 @@
     "bcp/plugins",
     "bcp/observability",
     "bcp/deployment",
+    "bcp/application",
     "bcp/server",
     "bcp/server-only",
     "bcp/middleware"
@@ -95,6 +96,25 @@
     "compiledAuthRuntime": true,
     "compiledServerRuntime": true,
     "compiledMiddlewareRuntime": true,
+    "applicationPlatform": true,
+    "applicationDefinitions": true,
+    "applicationRuntime": true,
+    "applicationConfigSchemas": true,
+    "applicationServiceRegistry": true,
+    "applicationPluginComposition": true,
+    "applicationModuleComposition": true,
+    "applicationResourceLifecycle": true,
+    "applicationReadiness": true,
+    "applicationDiagnostics": true,
+    "applicationLifecycleRollback": true,
+    "applicationLifecycleIdempotency": true,
+    "compiledApplicationRuntime": true,
+    "stabilityApiFreeze": true,
+    "apiFreezeSnapshot": true,
+    "apiCompatibilityGate": true,
+    "releaseReadinessReport": true,
+    "packageExportParity": true,
+    "deploymentLifecycleIdempotency": true,
     "backgroundJobsPlatform": true,
     "jobQueueAdapterContract": true,
     "inMemoryJobQueue": true,
@@ -224,17 +244,20 @@
     "s3-compatible"
   ],
   "compatibility": {
-    "previousBaseline": "0.2.17",
+    "previousBaseline": "0.2.19",
     "intentionalBreakingChangesFromPreviousBaseline": false,
-    "migrationGuide": "migration-0.2.md"
+    "migrationGuide": "migration-0.3.md"
   },
   "documentation": {
     "navigationManifest": "docs-web-manifest.json",
     "platformManifest": "platform-manifest.json",
     "apiManifest": "api-manifest.json",
+    "apiFreezeSnapshot": "api-freeze-snapshot.json",
     "platformContract": "platform-contract.md",
     "documentationPlatform": "documentation-platform.md",
     "apiReference": "api-reference.md",
+    "stabilityApiFreeze": "stability-api-freeze.md",
+    "applicationPlatform": "application-platform.md",
     "environmentValidation": "environment-validation.md",
     "applicationPackaging": "application-packaging.md",
     "authentication": "authentication.md",
@@ -252,7 +275,7 @@
     "testingPlatform": "testing-platform.md",
     "pluginModulePlatform": "plugin-module-platform.md",
     "cachePlatformV2": "cache-platform-v2.md",
-    "migrationGuide": "migration-0.2.md",
-    "releaseNotes": "releases/0.2.18.md"
+    "migrationGuide": "migration-0.3.md",
+    "releaseNotes": "releases/0.3.0.md"
   }
 }

package/docs/releases/0.2.19.md

@@ -0,0 +1,125 @@
+# BCP Framework 0.2.19
+
+Status: **unreleased**
+
+Milestone: **Stability & API Freeze**
+
+`0.2.19` is the final `0.2.x` stabilization milestone before the next `0.3.0` application-platform baseline.
+
+## Highlights
+
+- freezes the documented `bcp/*` public entrypoint set;
+- freezes the supported CLI command set;
+- freezes prepared npm export resolution including browser boundaries;
+- adds deterministic API snapshot generation;
+- adds an API compatibility gate to RC validation;
+- adds a release-readiness report;
+- adds prepared-package Stability & API Freeze smoke coverage;
+- adds deployment lifecycle idempotency regression coverage;
+- keeps compatibility with `0.2.18` with no intentional breaking changes.
+
+## API freeze snapshot
+
+New source of truth:
+
+```text
+docs/api-freeze-snapshot.json
+```
+
+Generate intentionally with:
+
+```bash
+npm run api:snapshot
+```
+
+Validate without changing the snapshot:
+
+```bash
+npm run api:check
+```
+
+The compatibility check prepares the publish package and compares the current package/CLI/API ownership contract against the committed snapshot.
+
+## Release readiness
+
+New commands:
+
+```bash
+npm run release:readiness
+npm run release:readiness:report
+```
+
+The persisted report is written locally to:
+
+```text
+.bcp-framework/release-readiness.json
+```
+
+Readiness includes package/lock/manifests version parity, freeze/baseline metadata, release-note/docs presence and public API parity.
+
+## RC pipeline
+
+`release:check` now includes:
+
+```text
+typecheck
+full test suite
+API compatibility check
+release readiness check
+release metadata check
+```
+
+`test:package` / `package:check` also include `stability-api-freeze-package-smoke.mjs`.
+
+## Compatibility
+
+```text
+previous baseline: 0.2.18
+intentional breaking changes: false
+freeze state: frozen
+```
+
+The existing public package surface remains unchanged from `0.2.18`:
+
+```text
+bcp
+bcp/island
+bcp/cache
+bcp/config
+bcp/validation
+bcp/error
+bcp/database
+bcp/auth
+bcp/jobs
+bcp/workflow
+bcp/events
+bcp/realtime
+bcp/testing
+bcp/plugins
+bcp/observability
+bcp/deployment
+bcp/server
+bcp/server-only
+bcp/middleware
+```
+
+## Validation before release
+
+Run on the exact release commit:
+
+```bash
+npm run typecheck
+npm run test:unit
+npm run test:integration
+npm run test:e2e
+npm run test:package
+npm run api:check
+npm run release:readiness
+npm run rc:check
+```
+
+Do not tag or publish until the complete RC sequence passes.
+
+## Next baseline
+
+`0.3.0` is the next planned BCP Application Platform baseline. Intentional public API changes should be made there with explicit migration and compatibility metadata rather than silently changing the frozen `0.2.19` contract.

package/docs/releases/0.3.0.md

@@ -0,0 +1,129 @@
+# BCP Framework 0.3.0 — Application Platform
+
+`0.3.0` establishes the first BCP Application Platform baseline on top of the infrastructure and API freeze completed in `0.2.x`.
+
+> **Release state:** unreleased until the complete RC gate passes, `v0.3.0` is tagged and both npm packages are published successfully.
+
+## Highlights
+
+- Adds the server-only `bcp/application` public entrypoint.
+- Adds `defineApp()` for validated application definitions.
+- Adds `createApp()` for a unified application composition root.
+- Reuses the existing Plugin Platform service registry and hook bus.
+- Reuses existing plugin/module definitions without conversion.
+- Reuses Deployment Platform resources, readiness, diagnostics, signal handling and shutdown hooks.
+- Adds typed application-level config parsing.
+- Adds deterministic application lifecycle ordering.
+- Adds startup rollback and terminal cleanup through the deployment resource graph.
+- Adds concurrent/repeated start and shutdown idempotency coverage.
+- Publishes `application.mjs` as a compiled production runtime.
+- Adds prepared-package smoke coverage for the new entrypoint and lifecycle.
+
+## Public API
+
+```ts
+import {
+    ApplicationLifecycleError,
+    createApp,
+    defineApp,
+} from "bcp/application";
+```
+
+Key types:
+
+```text
+Application
+ApplicationConfigParser
+ApplicationConfigSchema
+ApplicationContext
+ApplicationDefinition
+ApplicationState
+```
+
+## Application composition
+
+```ts
+const app =
+    createApp({
+        name: "orders-api",
+        version: "1.0.0",
+        plugins: [
+            authPlugin,
+            jobsPlugin,
+        ],
+        resources: [
+            databaseResource,
+            workerResource,
+        ],
+    });
+
+await app.start();
+```
+
+The application exposes the shared platform objects directly:
+
+```text
+app.services
+app.hooks
+app.plugins
+app.deployment
+```
+
+Existing provider-native database, cache, job, workflow, event and realtime instances can be stored in the service registry or wrapped in deployment resources as appropriate.
+
+## Lifecycle
+
+Startup:
+
+```text
+application.setup
+plugin setup/start
+resources start in registration order
+application.start
+```
+
+Shutdown:
+
+```text
+application.stop
+resources stop in reverse order
+plugin stop/dispose
+application.dispose
+```
+
+Startup failures roll back already-started resources in reverse order.
+
+## Compatibility
+
+The `0.2.19` Stability & API Freeze release is the compatibility baseline for `0.3.0`.
+
+`0.3.0` intentionally adds:
+
+```text
+bcp/application
+```
+
+No existing `0.2.19` public entrypoint is intentionally removed.
+
+The API snapshot/compatibility tooling is updated to establish the reviewed `0.3.0` package baseline after the new entrypoint is added.
+
+## Validation
+
+Before tagging:
+
+```bash
+npm run typecheck
+npm run test:unit
+npm run test:integration
+npm run test:e2e
+npm run test:package
+npm run api:check
+npm run release:readiness
+npm run rc:check
+```
+
+Do not publish until these commands pass on the exact final release commit.
+
+## Next milestone
+
+`0.3.1 — Dependency Injection & Service Container` is planned to add typed service tokens, singleton/scoped/transient lifetimes, request scopes, factories and testing overrides on top of the shared Application Platform service composition model.