@pattern-stack/codegen 0.11.0 → 0.12.1

package/CHANGELOG.md

@@ -4,6 +4,93 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.12.1] — 2026-05-31
+
+Track D (provider/adapter integration codegen) discoverability fix. The 0.12.0
+generator wiring is correct and shipped — provider + adapter emission runs as a
+post-step of `codegen entity new` whenever `definitions/providers/*.yaml` exist
+— but nothing in the CLI surfaced that, so consumers searched `--help` for a
+`provider` / `integration` / `gen` command, found none, and mistook a working
+feature for a publish gap. Docs-and-help only; no generator behavior changed.
+
+### Changed
+
+- **`codegen entity new --help`** now documents every post-generation step it
+  runs (event / bridge / orchestration / **provider + adapter (Track D)**
+  codegen), including Track D's trigger (`definitions/providers/*.yaml`), output
+  paths (`<backendSrc>/integrations/{providers,}`), emit-once semantics, and an
+  explicit note that there is no standalone `provider` / `integration` / `gen`
+  command — Track D is driven entirely by re-running `entity new`.
+- **`codegen entity` summary hints** now surface a Track D regen hint when the
+  project has a providers directory — a discoverability path that does not
+  require reading `entity new --help`.
+- **Integration domain skill** (`protocols-and-ports.md`, `SKILL.md`) documents
+  the Track D invocation, the skip-when-no-providers-dir behavior, and that the
+  generated scaffold (not the `.d.ts`) is ground truth for adapter port shape.
+
+## [0.12.0] — 2026-05-31
+
+Integration codegen retarget (RFC-0001): a **provider/adapter/surface** model
+for integration codegen, plus a **surface-package framework**. Additive over
+0.11.0 — new declarative inputs and emitted artifacts; existing entity codegen
+is unchanged. The one breaking item (the ADR-033.2 per-entity provider tuples)
+has no consumers. Consumers adopt by adding `definitions/providers/*.yaml` and
+regenerating. Ships alongside four independently-versioned **surface packages**
+(`@pattern-stack/codegen-{crm,calendar,mail,transcript}`) at `0.1.1`. (Their
+initial `0.1.0` release peer-depended on `@pattern-stack/codegen` `^0.11.0`,
+which predates the `./subsystems` export they require; `0.1.1` corrects the peer
+to `^0.12.0`. The peer source fix merged with 0.12.0 but the version bump was
+missed — this completes it.)
+
+### ⚠ BREAKING CHANGES
+
+- **ADR-033.2 per-entity provider tuples removed.** The
+  `<entity>-integration-source.providers.ts` emission (`<ENTITY>_PROVIDERS`
+  const + `<Entity>Provider` type) is deleted. Its replacement is the
+  surface-scoped, codegen-owned typed view at
+  `src/integrations/<surface>/types.generated.ts` (`<Surface>Provider` /
+  `<Surface>Entity` unions + a `(provider, entity)` validity map) — a single
+  source of provider truth. ADR-033.2 is superseded by RFC-0001. No published
+  consumers depend on the tuples.
+
+### Added
+
+- **Track C — surface-package framework (ADR-036).** First-class L2 *surface
+  packages* shipping type-shaped ports + DI tokens + an L3 composing port per
+  integration surface:
+  - **L1** — `IEntityChangeSourceRegistry` (entity-keyed change-source
+    resolver) + `MemoryEntityChangeSourceRegistry` + the
+    `ENTITY_CHANGE_SOURCE_REGISTRY` token, in the integration subsystem;
+    exported across the package boundary via `@pattern-stack/codegen/subsystems`.
+  - **`@pattern-stack/codegen-crm`** — L2 CRM ports (`IFieldDefinitionReader`,
+    `IPicklistReader`, `IAssociationReader`), the `CrmCapabilities` descriptor,
+    and the L3 entity-agnostic **`CrmPort`** composing port + `assertCrmAdapter`
+    conformance helper (on the `/testing` subpath).
+  - **`@pattern-stack/codegen-{calendar,mail,transcript}`** — incremental-read
+    interaction surfaces (`CalendarPort` / `MailPort` / `TranscriptPort`,
+    canonical types, capability descriptors). Independently versioned (`0.1.1`).
+- **Track D — provider/adapter integration codegen (RFC-0001).**
+  - `definitions/providers/<provider>.yaml` — providers as first-class
+    declarative artifacts (slug, auth strategy, client, surfaces); Zod schema +
+    validator with a **pre-flight import-path check** (a missing
+    strategy/client export fails `cdp gen`, not NestJS boot), surface
+    cross-check, and slug-uniqueness.
+  - Emits, per provider × surface: a `<provider>.provider.module.ts`, an
+    **emit-once** `<provider>-<surface>.adapter.ts` scaffold (sentinel-guarded,
+    author-owned after first emit), fully codegen-owned adapter modules +
+    barrels, a per-surface registry (`<SURFACE>_ADAPTER_CONTRIBUTIONS` →
+    `<SURFACE>_ENTITY_SOURCES`, folding into the L1 registry), and the
+    `types.generated.ts` typed view.
+  - Optional entity-YAML **`surface:`** field — the declarative input the
+    provider/adapter emission groups entities by.
+- **`context:` output-folder grouping (#403).** An optional top-level entity
+  `context:` nests its generated module folder under that segment
+  (`<modules>/<context>/<plural>/`); no context → flat (byte-identical to
+  before).
+- **Multi-package release.** `just publish` publishes the root plus every
+  opted-in `packages/*` (those declaring `publishConfig.access: public`) at its
+  own independent version, skipping versions already on npm.
+
 ## [0.11.0] — 2026-05-30
 
 Vocabulary rename per **ADR-0005 (swe-brain `.ai-docs/decisions/ADR-0005-rename-sync-to-integration.md`)**:

package/dist/runtime/subsystems/index.d.ts

@@ -19,6 +19,12 @@ export { IObservability } from './observability/observability.protocol.js';
 export { OBSERVABILITY, OBSERVABILITY_MODULE_OPTIONS } from './observability/observability.tokens.js';
 export { ObservabilityModule, ObservabilityModuleOptions } from './observability/observability.module.js';
 export { ObservabilityError } from './observability/observability-errors.js';
+export { IChangeSource } from './integration/integration-change-source.protocol.js';
+export { CursorSnapshot } from './integration/integration-cursor-store.protocol.js';
+export { IntegrationRunSummary } from './integration/integration-run-recorder.protocol.js';
+export { IEntityChangeSourceRegistry, UnknownEntityError } from './integration/entity-change-source-registry.protocol.js';
+export { MemoryEntityChangeSourceRegistry } from './integration/entity-change-source-registry.memory.js';
+export { ENTITY_CHANGE_SOURCE_REGISTRY } from './integration/integration.tokens.js';
 export { AuthCredentials, AuthResolveOptions, IAuthStrategy } from './auth/protocols/auth-strategy.js';
 export { IEncryptionKey } from './auth/protocols/encryption-key.js';
 export { IOAuthStateStore, OAuthStateError, OAuthStateRecord } from './auth/protocols/oauth-state-store.js';
@@ -36,8 +42,6 @@ export { MemoryOAuthStateStore } from './auth/backends/state-store.memory-backen
 export { DrizzleOAuthStateStore } from './auth/backends/state-store.drizzle-backend.js';
 export { AuthController } from './auth/controllers/auth.controller.js';
 export { AuthModule } from './auth/auth.module.js';
-export { CursorSnapshot } from './integration/integration-cursor-store.protocol.js';
-export { IntegrationRunSummary } from './integration/integration-run-recorder.protocol.js';
 export { StatusHistogram } from './bridge/bridge.protocol.js';
 import '../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
@@ -47,7 +51,7 @@ import 'drizzle-orm/pg-core';
 import 'drizzle-orm';
 import '../../job-orchestrator.protocol-CHOEqBDk.js';
 import './events/generated/types.js';
-import '../base-classes/tenant-context.js';
 import './integration/integration-field-diff.protocol.js';
 import 'zod';
+import '../base-classes/tenant-context.js';
 import './bridge/bridge-delivery.schema.js';