@punica/editor 1.6.14 → 1.6.15
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/package.json
CHANGED
|
@@ -1,6 +1,28 @@
|
|
|
1
1
|
declare module 'punica' {
|
|
2
2
|
export namespace kernel {
|
|
3
|
-
|
|
3
|
+
/**
|
|
4
|
+
* High-level kind of an event.
|
|
5
|
+
*
|
|
6
|
+
* `'audit'` is not just a label: it is the publisher's declaration that
|
|
7
|
+
* this event is a durable record, and the substrate **persists it** (see
|
|
8
|
+
* `docs/events.md` § Durability). Every other kind is persisted only if
|
|
9
|
+
* the event *name* matches one of the substrate's critical-event patterns,
|
|
10
|
+
* which is a fine default for lifecycle and failure events but cannot be
|
|
11
|
+
* relied on by a caller — an extension recording "a human promoted model
|
|
12
|
+
* version 3 to production" has no name it could choose to make that record
|
|
13
|
+
* survive a restart. Declaring `kind: 'audit'` is that mechanism.
|
|
14
|
+
*
|
|
15
|
+
* Use it for records that must outlive the session and would be a problem
|
|
16
|
+
* to lose: governed actions, approvals, promotions, irreversible writes.
|
|
17
|
+
* Do not use it for progress or telemetry — the audit ring is retained and
|
|
18
|
+
* queried, so volume there costs something real.
|
|
19
|
+
*/
|
|
20
|
+
export type KernelEventKind =
|
|
21
|
+
| 'result'
|
|
22
|
+
| 'progress'
|
|
23
|
+
| 'error'
|
|
24
|
+
| 'info'
|
|
25
|
+
| 'audit';
|
|
4
26
|
|
|
5
27
|
/**
|
|
6
28
|
* Standard event envelope for correlation, auditing and tracing.
|