@driftgate/contracts 0.1.0-rc.1

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.
Files changed (6) hide show
  1. package/COMPATIBILITY_POLICY.md +36 -0
  2. package/dist/index.d.ts +6767 -0
  3. package/dist/index.js +1255 -0
  4. package/dist/index.js.map +1 -0
  5. package/package.json +39 -0
  6. package/src/index.ts +1408 -0
package/COMPATIBILITY_POLICY.md ADDED
@@ -0,0 +1,36 @@
1
+ # Contracts Compatibility Policy
2
+
3
+ `@driftgate/contracts` is the authoritative cross-service contract package for V1.
4
+
5
+ ## Versioning
6
+
7
+ - `CONTRACT_VERSION` follows semantic versioning.
8
+ - Breaking schema changes require a major version bump.
9
+ - Additive schema changes require a minor version bump.
10
+ - Patch bumps are allowed only for non-shape fixes (comments/docs/metadata).
11
+
12
+ ## Breaking Changes
13
+
14
+ The following are breaking and must not land without major version bump:
15
+
16
+ - Removing an exported schema or type.
17
+ - Renaming exported schema/type identifiers.
18
+ - Tightening required fields in existing schemas.
19
+ - Changing enum values by removal or rename.
20
+
21
+ ## Compatibility Gate
22
+
23
+ `tools/ci/contracts.sh` enforces a minimum export surface for V1:
24
+
25
+ - `AuthSessionSchema`
26
+ - `WorkspaceRoleBindingSchema`
27
+ - `WorkflowVersionSchema`
28
+ - `RunStateSchema`
29
+ - `PolicyDecisionSchema`
30
+ - `PolicyExitGateEvidenceSchema`
31
+ - `EntitlementDecisionSchema`
32
+ - `ArtifactManifestItemSchema`
33
+ - `ControlFailureSchema`
34
+ - `CONTRACT_VERSION`
35
+
36
+ The gate is intentionally conservative for bootstrap and can be tightened as schema snapshots are introduced.