footprintjs 9.46.1 → 9.48.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 (110) hide show
  1. package/AGENTS.md +6 -5
  2. package/CLAUDE.md +10 -10
  3. package/README.md +1 -1
  4. package/dist/advanced.js +95 -90
  5. package/dist/esm/advanced.d.ts +16 -10
  6. package/dist/esm/advanced.js +14 -9
  7. package/dist/esm/index.d.ts +4 -2
  8. package/dist/esm/index.js +5 -3
  9. package/dist/esm/lib/builder/FlowChartBuilder.js +5 -4
  10. package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +1 -1
  11. package/dist/esm/lib/engine/traversal/FlowchartTraverser.d.ts +1 -1
  12. package/dist/esm/lib/engine/traversal/FlowchartTraverser.js +4 -3
  13. package/dist/esm/lib/engine/types.d.ts +1 -1
  14. package/dist/esm/lib/engine/types.js +1 -1
  15. package/dist/esm/lib/ids/reservedIds.d.ts +34 -0
  16. package/dist/esm/lib/ids/reservedIds.js +45 -0
  17. package/dist/esm/lib/ids/runtimeStageId.d.ts +13 -31
  18. package/dist/esm/lib/ids/runtimeStageId.js +12 -43
  19. package/dist/esm/lib/memory/DiagnosticCollector.d.ts +1 -1
  20. package/dist/esm/lib/memory/DiagnosticCollector.js +1 -1
  21. package/dist/esm/lib/memory/EventLog.d.ts +1 -1
  22. package/dist/esm/lib/memory/EventLog.js +2 -2
  23. package/dist/esm/lib/memory/StageContext.d.ts +2 -1
  24. package/dist/esm/lib/memory/StageContext.js +1 -1
  25. package/dist/esm/lib/memory/backtrack.d.ts +3 -2
  26. package/dist/esm/lib/memory/backtrack.js +4 -10
  27. package/dist/esm/lib/memory/frameTypes.d.ts +98 -0
  28. package/dist/esm/lib/memory/frameTypes.js +14 -0
  29. package/dist/esm/lib/memory/index.d.ts +4 -2
  30. package/dist/esm/lib/memory/index.js +1 -2
  31. package/dist/esm/lib/memory/runPolicy.d.ts +2 -1
  32. package/dist/esm/lib/memory/runPolicy.js +1 -1
  33. package/dist/esm/lib/memory/scrub.d.ts +3 -1
  34. package/dist/esm/lib/memory/scrub.js +4 -2
  35. package/dist/esm/lib/memory/types.d.ts +41 -98
  36. package/dist/esm/lib/memory/types.js +7 -8
  37. package/dist/esm/lib/memory/verbs.d.ts +1 -1
  38. package/dist/esm/lib/memory/verbs.js +2 -2
  39. package/dist/esm/lib/runner/ExecutionRuntime.d.ts +2 -1
  40. package/dist/esm/lib/runner/ExecutionRuntime.js +1 -1
  41. package/dist/esm/lib/runner/FlowChartExecutor.d.ts +2 -1
  42. package/dist/esm/lib/runner/FlowChartExecutor.js +1 -1
  43. package/dist/esm/lib/runner/getSubtreeSnapshot.d.ts +1 -1
  44. package/dist/esm/lib/runner/getSubtreeSnapshot.js +1 -1
  45. package/dist/esm/lib/slice/keysReadSources.d.ts +3 -3
  46. package/dist/esm/lib/slice/keysReadSources.js +3 -4
  47. package/dist/esm/lib/time-travel/bundles.d.ts +3 -3
  48. package/dist/esm/lib/time-travel/bundles.js +2 -2
  49. package/dist/esm/lib/time-travel/commitStops.d.ts +2 -2
  50. package/dist/esm/lib/time-travel/commitStops.js +1 -1
  51. package/dist/esm/lib/time-travel/tagStops.js +1 -1
  52. package/dist/esm/lib/time-travel/types.d.ts +23 -14
  53. package/dist/esm/lib/time-travel/types.js +9 -9
  54. package/dist/esm/trace.d.ts +7 -4
  55. package/dist/esm/trace.js +6 -5
  56. package/dist/esm/write.d.ts +47 -0
  57. package/dist/esm/write.js +46 -0
  58. package/dist/index.js +5 -3
  59. package/dist/lib/builder/FlowChartBuilder.js +5 -4
  60. package/dist/lib/engine/traversal/FlowchartTraverser.js +6 -5
  61. package/dist/lib/engine/types.js +1 -1
  62. package/dist/lib/ids/reservedIds.js +49 -0
  63. package/dist/lib/ids/runtimeStageId.js +26 -58
  64. package/dist/lib/memory/DiagnosticCollector.js +1 -1
  65. package/dist/lib/memory/EventLog.js +2 -2
  66. package/dist/lib/memory/StageContext.js +1 -1
  67. package/dist/lib/memory/backtrack.js +4 -10
  68. package/dist/lib/memory/frameTypes.js +15 -0
  69. package/dist/lib/memory/index.js +2 -5
  70. package/dist/lib/memory/runPolicy.js +1 -1
  71. package/dist/lib/memory/scrub.js +4 -2
  72. package/dist/lib/memory/types.js +6 -11
  73. package/dist/lib/memory/verbs.js +2 -2
  74. package/dist/lib/runner/ExecutionRuntime.js +1 -1
  75. package/dist/lib/runner/FlowChartExecutor.js +1 -1
  76. package/dist/lib/runner/getSubtreeSnapshot.js +1 -1
  77. package/dist/lib/slice/keysReadSources.js +3 -4
  78. package/dist/lib/time-travel/bundles.js +2 -2
  79. package/dist/lib/time-travel/commitStops.js +1 -1
  80. package/dist/lib/time-travel/tagStops.js +1 -1
  81. package/dist/lib/time-travel/types.js +9 -9
  82. package/dist/trace.js +36 -34
  83. package/dist/types/advanced.d.ts +16 -10
  84. package/dist/types/index.d.ts +4 -2
  85. package/dist/types/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +1 -1
  86. package/dist/types/lib/engine/traversal/FlowchartTraverser.d.ts +1 -1
  87. package/dist/types/lib/engine/types.d.ts +1 -1
  88. package/dist/types/lib/ids/reservedIds.d.ts +34 -0
  89. package/dist/types/lib/ids/runtimeStageId.d.ts +13 -31
  90. package/dist/types/lib/memory/DiagnosticCollector.d.ts +1 -1
  91. package/dist/types/lib/memory/EventLog.d.ts +1 -1
  92. package/dist/types/lib/memory/StageContext.d.ts +2 -1
  93. package/dist/types/lib/memory/backtrack.d.ts +3 -2
  94. package/dist/types/lib/memory/frameTypes.d.ts +98 -0
  95. package/dist/types/lib/memory/index.d.ts +4 -2
  96. package/dist/types/lib/memory/runPolicy.d.ts +2 -1
  97. package/dist/types/lib/memory/scrub.d.ts +3 -1
  98. package/dist/types/lib/memory/types.d.ts +41 -98
  99. package/dist/types/lib/memory/verbs.d.ts +1 -1
  100. package/dist/types/lib/runner/ExecutionRuntime.d.ts +2 -1
  101. package/dist/types/lib/runner/FlowChartExecutor.d.ts +2 -1
  102. package/dist/types/lib/runner/getSubtreeSnapshot.d.ts +1 -1
  103. package/dist/types/lib/slice/keysReadSources.d.ts +3 -3
  104. package/dist/types/lib/time-travel/bundles.d.ts +3 -3
  105. package/dist/types/lib/time-travel/commitStops.d.ts +2 -2
  106. package/dist/types/lib/time-travel/types.d.ts +23 -14
  107. package/dist/types/trace.d.ts +7 -4
  108. package/dist/types/write.d.ts +47 -0
  109. package/dist/write.js +52 -0
  110. package/package.json +15 -1
@@ -34,8 +34,11 @@ export { buildRuntimeStageId, createExecutionCounter, parseRuntimeStageId, split
34
34
  export { BRANCH_SEGMENT_MARKER, buildBranchSegment, hasBranchSegmentMarker, isBranchSegment, parseBranchSegment, } from './lib/ids/branchSegment.js';
35
35
  export type { WalkerItem, WalkerOptions } from './lib/engine/walkSubflowSpec.js';
36
36
  export { walkSubflowSpec } from './lib/engine/walkSubflowSpec.js';
37
- export { pathSegments } from './lib/memory/utils.js';
38
- export { UnknownVerbError } from './lib/memory/index.js';
37
+ export { pathSegments } from './lib/memory/paths.js';
38
+ export { UnknownVerbError } from './lib/memory/verbs.js';
39
+ export type { CommitBundle, MemoryPatch, TraceEntry } from './lib/memory/types.js';
40
+ export type { ExecutionTree } from './lib/memory/types.js';
41
+ export { applySmartMerge } from './lib/memory/verbs.js';
39
42
  export type { ValueBasis, ValueBasisOptions, ValueWithBasis, WriterBasis, WriterWithBasis, } from './lib/memory/commitLogUtils.js';
40
43
  export { buildCommitIndex, commitIndexOf, commitValueAt, commitValueAtWithBasis, findCommit, findCommits, findLastWriter, findLastWriterWithBasis, inferLegacyPhases, recordsPhases, } from './lib/memory/commitLogUtils.js';
41
44
  export type { CommitPhase } from './lib/memory/types.js';
@@ -47,8 +50,8 @@ export type { UntrackedSource } from './lib/memory/types.js';
47
50
  export type { ArrayProvenance, AttributionBasis, ElementBirth, FedBasis, ForwardEdge, ForwardNode, ForwardRead, ForwardSlice, ForwardSliceJSON, HonestyNote, HonestyNoteCode, KeyMoment, KeysReadSource, KeyTimeline, MissingProvenanceReason, MissingSliceReason, ReadsCoverage, SliceJSON, StateKey, VariableSlice, } from './lib/slice/index.js';
48
51
  export type { ForwardSliceForKeyOptions, KeyTimelineOptions, SliceForKeyOptions } from './lib/slice/index.js';
49
52
  export { arrayProvenance, elementProvenance, formatForwardSlice, formatSlice, formatTimeline, forwardSliceForKey, forwardSliceToJSON, keysReadFromExecutionTree, keysReadFromMap, keyTimeline, normaliseStateKey, resolveKeysReadSource, sliceForKey, sliceToJSON, } from './lib/slice/index.js';
50
- export type { HonestyCode } from './lib/memory/index.js';
51
- export { HONESTY_CODES } from './lib/memory/index.js';
53
+ export type { HonestyCode } from './lib/memory/honesty.js';
54
+ export { HONESTY_CODES } from './lib/memory/honesty.js';
52
55
  export { BoundaryStateStore } from './lib/recorder/BoundaryStateStore.js';
53
56
  export { KeyedStore } from './lib/recorder/KeyedStore.js';
54
57
  export { SequenceStore } from './lib/recorder/SequenceStore.js';
@@ -0,0 +1,47 @@
1
+ /**
2
+ * footprintjs/write — the public way to write a record.
3
+ *
4
+ * A record is what a run wrote: a frozen base and an append-only log of bundles, one per step
5
+ * (docs/guides/record-contract.md). This door hands out the classes the engine itself writes one
6
+ * with — there is no wrapper, so a record written here and one a flowchart wrote come from the same
7
+ * code and the same bytes:
8
+ *
9
+ * - `SharedMemory` — the heap: live state, one generation per commit (copy-on-write);
10
+ * - `EventLog` — the log: the fold base and the bundles, frozen as they are recorded;
11
+ * - `RecordFrame` — one step's frame: what it read (`read`, `noteRead`), what it staged
12
+ * (`write`, with a redaction verdict's bytes as `WriteScrub`), and its
13
+ * commit onto the heap and the log (`commit`, named by a `CommitStamp`).
14
+ *
15
+ * The step's encoding is two dials (`RecordEncoding`): `commitValues` (`'full'` | `'delta'`) and
16
+ * `writeProvenance` (`'off'` | `'reads-prefix'`, `WriteProvenanceMode`).
17
+ *
18
+ * Every type this door names is the record's own: nothing here loads or names the engine
19
+ * (test/architecture/write-door.test.ts). Its names and the bytes they write are promised under the
20
+ * record fixtures' re-pin policy (test/fixtures/README.md): a refactor never moves a byte.
21
+ *
22
+ * @example
23
+ * ```typescript
24
+ * import { EventLog, RecordFrame, SharedMemory } from 'footprintjs/write';
25
+ * import { stateAt } from 'footprintjs/trace';
26
+ *
27
+ * const state = new SharedMemory(undefined, { count: 0 }); // the heap, seeded
28
+ * const log = new EventLog(state.getState()); // its fold base is the seed
29
+ *
30
+ * const frame = new RecordFrame(state, log); // one step, at the root
31
+ * frame.useEncoding({ commitValues: 'full', writeProvenance: 'reads-prefix' });
32
+ * const count = frame.read([], 'count') as number;
33
+ * frame.noteRead([], 'count'); // the bundle names the read
34
+ * frame.write(frame.at([], 'count'), count + 1, 'set');
35
+ * frame.commit(() => ({ stage: 'Increment', stageId: 'increment', runtimeStageId: 'increment#0' }));
36
+ *
37
+ * stateAt({ initialState: log.getInitialState(), commitLog: log.list() }, 0).state; // { count: 1 }
38
+ * ```
39
+ *
40
+ * @module write
41
+ */
42
+ export { EventLog } from './lib/memory/EventLog.js';
43
+ export { SharedMemory } from './lib/memory/SharedMemory.js';
44
+ export type { CommitStamp } from './lib/memory/recordCommit.js';
45
+ export type { RecordEncoding, WriteScrub, WriteVerb } from './lib/memory/RecordFrame.js';
46
+ export { RecordFrame } from './lib/memory/RecordFrame.js';
47
+ export type { WriteProvenanceMode } from './lib/memory/types.js';
package/dist/write.js ADDED
@@ -0,0 +1,52 @@
1
+ "use strict";
2
+ /**
3
+ * footprintjs/write — the public way to write a record.
4
+ *
5
+ * A record is what a run wrote: a frozen base and an append-only log of bundles, one per step
6
+ * (docs/guides/record-contract.md). This door hands out the classes the engine itself writes one
7
+ * with — there is no wrapper, so a record written here and one a flowchart wrote come from the same
8
+ * code and the same bytes:
9
+ *
10
+ * - `SharedMemory` — the heap: live state, one generation per commit (copy-on-write);
11
+ * - `EventLog` — the log: the fold base and the bundles, frozen as they are recorded;
12
+ * - `RecordFrame` — one step's frame: what it read (`read`, `noteRead`), what it staged
13
+ * (`write`, with a redaction verdict's bytes as `WriteScrub`), and its
14
+ * commit onto the heap and the log (`commit`, named by a `CommitStamp`).
15
+ *
16
+ * The step's encoding is two dials (`RecordEncoding`): `commitValues` (`'full'` | `'delta'`) and
17
+ * `writeProvenance` (`'off'` | `'reads-prefix'`, `WriteProvenanceMode`).
18
+ *
19
+ * Every type this door names is the record's own: nothing here loads or names the engine
20
+ * (test/architecture/write-door.test.ts). Its names and the bytes they write are promised under the
21
+ * record fixtures' re-pin policy (test/fixtures/README.md): a refactor never moves a byte.
22
+ *
23
+ * @example
24
+ * ```typescript
25
+ * import { EventLog, RecordFrame, SharedMemory } from 'footprintjs/write';
26
+ * import { stateAt } from 'footprintjs/trace';
27
+ *
28
+ * const state = new SharedMemory(undefined, { count: 0 }); // the heap, seeded
29
+ * const log = new EventLog(state.getState()); // its fold base is the seed
30
+ *
31
+ * const frame = new RecordFrame(state, log); // one step, at the root
32
+ * frame.useEncoding({ commitValues: 'full', writeProvenance: 'reads-prefix' });
33
+ * const count = frame.read([], 'count') as number;
34
+ * frame.noteRead([], 'count'); // the bundle names the read
35
+ * frame.write(frame.at([], 'count'), count + 1, 'set');
36
+ * frame.commit(() => ({ stage: 'Increment', stageId: 'increment', runtimeStageId: 'increment#0' }));
37
+ *
38
+ * stateAt({ initialState: log.getInitialState(), commitLog: log.list() }, 0).state; // { count: 1 }
39
+ * ```
40
+ *
41
+ * @module write
42
+ */
43
+ Object.defineProperty(exports, "__esModule", { value: true });
44
+ exports.RecordFrame = exports.SharedMemory = exports.EventLog = void 0;
45
+ // The heap and the log.
46
+ var EventLog_js_1 = require("./lib/memory/EventLog.js");
47
+ Object.defineProperty(exports, "EventLog", { enumerable: true, get: function () { return EventLog_js_1.EventLog; } });
48
+ var SharedMemory_js_1 = require("./lib/memory/SharedMemory.js");
49
+ Object.defineProperty(exports, "SharedMemory", { enumerable: true, get: function () { return SharedMemory_js_1.SharedMemory; } });
50
+ var RecordFrame_js_1 = require("./lib/memory/RecordFrame.js");
51
+ Object.defineProperty(exports, "RecordFrame", { enumerable: true, get: function () { return RecordFrame_js_1.RecordFrame; } });
52
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid3JpdGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvd3JpdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBd0NHOzs7QUFFSCx3QkFBd0I7QUFDeEIsd0RBQW9EO0FBQTNDLHVHQUFBLFFBQVEsT0FBQTtBQUNqQixnRUFBNEQ7QUFBbkQsK0dBQUEsWUFBWSxPQUFBO0FBS3JCLDhEQUEwRDtBQUFqRCw2R0FBQSxXQUFXLE9BQUEiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIGZvb3RwcmludGpzL3dyaXRlIOKAlCB0aGUgcHVibGljIHdheSB0byB3cml0ZSBhIHJlY29yZC5cbiAqXG4gKiBBIHJlY29yZCBpcyB3aGF0IGEgcnVuIHdyb3RlOiBhIGZyb3plbiBiYXNlIGFuZCBhbiBhcHBlbmQtb25seSBsb2cgb2YgYnVuZGxlcywgb25lIHBlciBzdGVwXG4gKiAoZG9jcy9ndWlkZXMvcmVjb3JkLWNvbnRyYWN0Lm1kKS4gVGhpcyBkb29yIGhhbmRzIG91dCB0aGUgY2xhc3NlcyB0aGUgZW5naW5lIGl0c2VsZiB3cml0ZXMgb25lXG4gKiB3aXRoIOKAlCB0aGVyZSBpcyBubyB3cmFwcGVyLCBzbyBhIHJlY29yZCB3cml0dGVuIGhlcmUgYW5kIG9uZSBhIGZsb3djaGFydCB3cm90ZSBjb21lIGZyb20gdGhlIHNhbWVcbiAqIGNvZGUgYW5kIHRoZSBzYW1lIGJ5dGVzOlxuICpcbiAqICAgLSBgU2hhcmVkTWVtb3J5YCDigJQgdGhlIGhlYXA6IGxpdmUgc3RhdGUsIG9uZSBnZW5lcmF0aW9uIHBlciBjb21taXQgKGNvcHktb24td3JpdGUpO1xuICogICAtIGBFdmVudExvZ2AgICAgIOKAlCB0aGUgbG9nOiB0aGUgZm9sZCBiYXNlIGFuZCB0aGUgYnVuZGxlcywgZnJvemVuIGFzIHRoZXkgYXJlIHJlY29yZGVkO1xuICogICAtIGBSZWNvcmRGcmFtZWAgIOKAlCBvbmUgc3RlcCdzIGZyYW1lOiB3aGF0IGl0IHJlYWQgKGByZWFkYCwgYG5vdGVSZWFkYCksIHdoYXQgaXQgc3RhZ2VkXG4gKiAgICAgICAgICAgICAgICAgICAgICAoYHdyaXRlYCwgd2l0aCBhIHJlZGFjdGlvbiB2ZXJkaWN0J3MgYnl0ZXMgYXMgYFdyaXRlU2NydWJgKSwgYW5kIGl0c1xuICogICAgICAgICAgICAgICAgICAgICAgY29tbWl0IG9udG8gdGhlIGhlYXAgYW5kIHRoZSBsb2cgKGBjb21taXRgLCBuYW1lZCBieSBhIGBDb21taXRTdGFtcGApLlxuICpcbiAqIFRoZSBzdGVwJ3MgZW5jb2RpbmcgaXMgdHdvIGRpYWxzIChgUmVjb3JkRW5jb2RpbmdgKTogYGNvbW1pdFZhbHVlc2AgKGAnZnVsbCdgIHwgYCdkZWx0YSdgKSBhbmRcbiAqIGB3cml0ZVByb3ZlbmFuY2VgIChgJ29mZidgIHwgYCdyZWFkcy1wcmVmaXgnYCwgYFdyaXRlUHJvdmVuYW5jZU1vZGVgKS5cbiAqXG4gKiBFdmVyeSB0eXBlIHRoaXMgZG9vciBuYW1lcyBpcyB0aGUgcmVjb3JkJ3Mgb3duOiBub3RoaW5nIGhlcmUgbG9hZHMgb3IgbmFtZXMgdGhlIGVuZ2luZVxuICogKHRlc3QvYXJjaGl0ZWN0dXJlL3dyaXRlLWRvb3IudGVzdC50cykuIEl0cyBuYW1lcyBhbmQgdGhlIGJ5dGVzIHRoZXkgd3JpdGUgYXJlIHByb21pc2VkIHVuZGVyIHRoZVxuICogcmVjb3JkIGZpeHR1cmVzJyByZS1waW4gcG9saWN5ICh0ZXN0L2ZpeHR1cmVzL1JFQURNRS5tZCk6IGEgcmVmYWN0b3IgbmV2ZXIgbW92ZXMgYSBieXRlLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBpbXBvcnQgeyBFdmVudExvZywgUmVjb3JkRnJhbWUsIFNoYXJlZE1lbW9yeSB9IGZyb20gJ2Zvb3RwcmludGpzL3dyaXRlJztcbiAqIGltcG9ydCB7IHN0YXRlQXQgfSBmcm9tICdmb290cHJpbnRqcy90cmFjZSc7XG4gKlxuICogY29uc3Qgc3RhdGUgPSBuZXcgU2hhcmVkTWVtb3J5KHVuZGVmaW5lZCwgeyBjb3VudDogMCB9KTsgLy8gdGhlIGhlYXAsIHNlZWRlZFxuICogY29uc3QgbG9nID0gbmV3IEV2ZW50TG9nKHN0YXRlLmdldFN0YXRlKCkpOyAgICAgICAgICAgICAgLy8gaXRzIGZvbGQgYmFzZSBpcyB0aGUgc2VlZFxuICpcbiAqIGNvbnN0IGZyYW1lID0gbmV3IFJlY29yZEZyYW1lKHN0YXRlLCBsb2cpOyAgICAgICAgICAgICAgIC8vIG9uZSBzdGVwLCBhdCB0aGUgcm9vdFxuICogZnJhbWUudXNlRW5jb2RpbmcoeyBjb21taXRWYWx1ZXM6ICdmdWxsJywgd3JpdGVQcm92ZW5hbmNlOiAncmVhZHMtcHJlZml4JyB9KTtcbiAqIGNvbnN0IGNvdW50ID0gZnJhbWUucmVhZChbXSwgJ2NvdW50JykgYXMgbnVtYmVyO1xuICogZnJhbWUubm90ZVJlYWQoW10sICdjb3VudCcpOyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgLy8gdGhlIGJ1bmRsZSBuYW1lcyB0aGUgcmVhZFxuICogZnJhbWUud3JpdGUoZnJhbWUuYXQoW10sICdjb3VudCcpLCBjb3VudCArIDEsICdzZXQnKTtcbiAqIGZyYW1lLmNvbW1pdCgoKSA9PiAoeyBzdGFnZTogJ0luY3JlbWVudCcsIHN0YWdlSWQ6ICdpbmNyZW1lbnQnLCBydW50aW1lU3RhZ2VJZDogJ2luY3JlbWVudCMwJyB9KSk7XG4gKlxuICogc3RhdGVBdCh7IGluaXRpYWxTdGF0ZTogbG9nLmdldEluaXRpYWxTdGF0ZSgpLCBjb21taXRMb2c6IGxvZy5saXN0KCkgfSwgMCkuc3RhdGU7IC8vIHsgY291bnQ6IDEgfVxuICogYGBgXG4gKlxuICogQG1vZHVsZSB3cml0ZVxuICovXG5cbi8vIFRoZSBoZWFwIGFuZCB0aGUgbG9nLlxuZXhwb3J0IHsgRXZlbnRMb2cgfSBmcm9tICcuL2xpYi9tZW1vcnkvRXZlbnRMb2cuanMnO1xuZXhwb3J0IHsgU2hhcmVkTWVtb3J5IH0gZnJvbSAnLi9saWIvbWVtb3J5L1NoYXJlZE1lbW9yeS5qcyc7XG5cbi8vIE9uZSBzdGVwJ3MgZnJhbWUsIGFuZCB3aGF0IGl0IHRha2VzOiB0aGUgZGlhbHMsIHRoZSB2ZXJicywgYSB2ZXJkaWN0J3MgYnl0ZXMsIHRoZSBuYW1lcyBvbiBpdHMgYnVuZGxlLlxuZXhwb3J0IHR5cGUgeyBDb21taXRTdGFtcCB9IGZyb20gJy4vbGliL21lbW9yeS9yZWNvcmRDb21taXQuanMnO1xuZXhwb3J0IHR5cGUgeyBSZWNvcmRFbmNvZGluZywgV3JpdGVTY3J1YiwgV3JpdGVWZXJiIH0gZnJvbSAnLi9saWIvbWVtb3J5L1JlY29yZEZyYW1lLmpzJztcbmV4cG9ydCB7IFJlY29yZEZyYW1lIH0gZnJvbSAnLi9saWIvbWVtb3J5L1JlY29yZEZyYW1lLmpzJztcbmV4cG9ydCB0eXBlIHsgV3JpdGVQcm92ZW5hbmNlTW9kZSB9IGZyb20gJy4vbGliL21lbW9yeS90eXBlcy5qcyc7XG4iXX0=
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "footprintjs",
3
- "version": "9.46.1",
3
+ "version": "9.48.0",
4
4
  "description": "Explainable backend flows — automatic causal traces, decision evidence, and MCP tool generation for AI agents",
5
5
  "license": "MIT",
6
6
  "author": "Sanjay Krishna Anbalagan",
@@ -124,6 +124,16 @@
124
124
  "default": "./dist/trace.js"
125
125
  }
126
126
  },
127
+ "./write": {
128
+ "import": {
129
+ "types": "./dist/esm/write.d.ts",
130
+ "default": "./dist/esm/write.js"
131
+ },
132
+ "require": {
133
+ "types": "./dist/types/write.d.ts",
134
+ "default": "./dist/write.js"
135
+ }
136
+ },
127
137
  "./detach": {
128
138
  "import": {
129
139
  "types": "./dist/esm/detach.d.ts",
@@ -157,6 +167,9 @@
157
167
  "trace": [
158
168
  "./dist/types/trace.d.ts"
159
169
  ],
170
+ "write": [
171
+ "./dist/types/write.d.ts"
172
+ ],
160
173
  "detach": [
161
174
  "./dist/types/detach.d.ts"
162
175
  ],
@@ -197,6 +210,7 @@
197
210
  "eslint-plugin-simple-import-sort": "^8.0.0",
198
211
  "fast-check": "^4.4.0",
199
212
  "footprintjs-baseline": "npm:footprintjs@9.28.0",
213
+ "footprintjs-published": "npm:footprintjs@^9.46.1",
200
214
  "husky": "^9.1.7",
201
215
  "lint-staged": "^16.3.2",
202
216
  "markdown-it": "^14.3.1",