@company-semantics/contracts 18.1.1 → 18.2.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.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/src/org/structure-facts.ts +9 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@company-semantics/contracts",
3
- "version": "18.1.1",
3
+ "version": "18.2.0",
4
4
  "private": false,
5
5
  "repository": {
6
6
  "type": "git",
package/src/org/structure-facts.ts CHANGED
@@ -76,6 +76,15 @@ export const FactProvenanceSchema = z.object({
76
76
  * for an original. Enables append+supersede without destructive updates.
77
77
  */
78
78
  supersedesFactId: z.string().uuid().nullable().optional(),
79
+ /**
80
+ * Human-meaningful WHY for a deliberate human edit — a free-text audit
81
+ * record of intent, capped at 2000 chars to mirror the delegation-note /
82
+ * unit-owner reason API cap. `null`/absent for machine-sourced facts (sync,
83
+ * import, inference). It is an audit record of intent, NOT an authorization
84
+ * grant: it explains why a fact was set, never who may act on it
85
+ * (ADR-CTRL-180).
86
+ */
87
+ reason: z.string().max(2000).nullable().optional(),
79
88
  });
80
89
  export type FactProvenance = z.infer<typeof FactProvenanceSchema>;
81
90