@modelprofile.com/flexharness 18.1.0 → 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 (68) hide show
  1. package/dist_ts/00_commitinfo_data.js +1 -1
  2. package/dist_ts/classes.flexharness.cachewarm.js +3 -3
  3. package/dist_ts/classes.flexharness.callbacks.d.ts +37 -0
  4. package/dist_ts/classes.flexharness.callbacks.js +129 -2
  5. package/dist_ts/classes.flexharness.compaction.js +2 -2
  6. package/dist_ts/classes.flexharness.configurations.js +4 -4
  7. package/dist_ts/classes.flexharness.core.d.ts +39 -4
  8. package/dist_ts/classes.flexharness.core.js +467 -134
  9. package/dist_ts/classes.flexharness.d.ts +4 -0
  10. package/dist_ts/classes.flexharness.deletion.d.ts +13 -0
  11. package/dist_ts/classes.flexharness.deletion.js +122 -40
  12. package/dist_ts/classes.flexharness.imports.js +26 -21
  13. package/dist_ts/classes.flexharness.js +9 -1
  14. package/dist_ts/classes.flexharness.lifecycle.js +9 -3
  15. package/dist_ts/classes.flexharness.projects.js +2 -2
  16. package/dist_ts/classes.flexharness.prompts.js +14 -8
  17. package/dist_ts/classes.flexharness.reversions.js +3 -3
  18. package/dist_ts/classes.flexharness.runs.js +18 -2
  19. package/dist_ts/classes.flexharness.sessions.d.ts +1 -1
  20. package/dist_ts/classes.flexharness.sessions.js +18 -18
  21. package/dist_ts/classes.flexharness.slashcommands.js +3 -3
  22. package/dist_ts/classes.flexharness.subagents.js +37 -16
  23. package/dist_ts/classes.flexharness.tooldispatch.js +3 -3
  24. package/dist_ts/classes.scoperecovery.d.ts +36 -0
  25. package/dist_ts/classes.scoperecovery.js +228 -0
  26. package/dist_ts/classes.stores.d.ts +14 -1
  27. package/dist_ts/classes.stores.js +150 -17
  28. package/dist_ts/index.d.ts +1 -0
  29. package/dist_ts/index.js +2 -1
  30. package/dist_ts/interfaces.d.ts +84 -0
  31. package/dist_ts/interfaces.flexharness.d.ts +36 -0
  32. package/dist_ts/interfaces.js +1 -1
  33. package/dist_ts/utils.harnessoptions.d.ts +2 -0
  34. package/dist_ts/utils.harnessoptions.js +16 -11
  35. package/dist_ts_stores_nosqldb/classes.nosqldbstores.d.ts +3 -2
  36. package/dist_ts_stores_nosqldb/classes.nosqldbstores.js +33 -2
  37. package/dist_ts_stores_nosqldb/classes.recordstore.d.ts +10 -1
  38. package/dist_ts_stores_nosqldb/classes.recordstore.js +75 -7
  39. package/package.json +3 -3
  40. package/readme.md +42 -4
  41. package/ts/00_commitinfo_data.ts +1 -1
  42. package/ts/classes.flexharness.cachewarm.ts +2 -2
  43. package/ts/classes.flexharness.callbacks.ts +142 -1
  44. package/ts/classes.flexharness.compaction.ts +1 -1
  45. package/ts/classes.flexharness.configurations.ts +3 -3
  46. package/ts/classes.flexharness.core.ts +463 -133
  47. package/ts/classes.flexharness.deletion.ts +161 -52
  48. package/ts/classes.flexharness.imports.ts +26 -21
  49. package/ts/classes.flexharness.lifecycle.ts +8 -2
  50. package/ts/classes.flexharness.projects.ts +1 -1
  51. package/ts/classes.flexharness.prompts.ts +11 -7
  52. package/ts/classes.flexharness.reversions.ts +2 -2
  53. package/ts/classes.flexharness.runs.ts +16 -1
  54. package/ts/classes.flexharness.sessions.ts +17 -17
  55. package/ts/classes.flexharness.slashcommands.ts +2 -2
  56. package/ts/classes.flexharness.subagents.ts +40 -15
  57. package/ts/classes.flexharness.tooldispatch.ts +2 -2
  58. package/ts/classes.flexharness.ts +13 -0
  59. package/ts/classes.scoperecovery.ts +290 -0
  60. package/ts/classes.stores.ts +150 -16
  61. package/ts/index.ts +2 -0
  62. package/ts/interfaces.flexharness.ts +38 -0
  63. package/ts/interfaces.ts +89 -0
  64. package/ts/readme.md +42 -4
  65. package/ts/utils.harnessoptions.ts +18 -12
  66. package/ts_stores_nosqldb/classes.nosqldbstores.ts +52 -2
  67. package/ts_stores_nosqldb/classes.recordstore.ts +78 -8
  68. package/ts_stores_nosqldb/readme.md +10 -0
@@ -0,0 +1,228 @@
1
+ import * as plugins from './plugins.js';
2
+ import { FlexHarnessStoreCommitUncertainError, FlexHarnessStoreConflictError, FlexHarnessStoreFormatError, FlexHarnessValidationError, } from './errors.js';
3
+ import { assertFlexScopeSnapshot, assertJsonSerializable, cloneSerializable, } from './utils.json.js';
4
+ import { assertExactKeys, assertRecord } from './utils.storecodecs.js';
5
+ import { validateExpectedRevision, validateIdentifier, validateSnapshotSave, } from './utils.storerules.js';
6
+ function assertRecoverySessionIds(value) {
7
+ if (!Array.isArray(value)
8
+ || value.some((id) => typeof id !== 'string' || !id.trim())
9
+ || new Set(value).size !== value.length) {
10
+ throw new FlexHarnessStoreFormatError('recoverySessionIds must contain unique non-empty string ids.');
11
+ }
12
+ }
13
+ /** Strict sidecar validation shared by recovery-store adapters; scope snapshots stay schema 1. */
14
+ export function assertFlexScopeRecoverySnapshot(value) {
15
+ assertJsonSerializable(value, '$scopeRecovery');
16
+ assertRecord(value, '$scopeRecovery');
17
+ assertExactKeys(value, [
18
+ 'schemaVersion', 'revision', 'catalogueRevision', 'catalogueDigest', 'recoverySessionIds',
19
+ ], '$scopeRecovery');
20
+ if (value.schemaVersion !== 1) {
21
+ throw new FlexHarnessStoreFormatError('Scope recovery schemaVersion must be 1.');
22
+ }
23
+ for (const key of ['revision', 'catalogueRevision']) {
24
+ if (!Number.isSafeInteger(value[key]) || Number(value[key]) < 0) {
25
+ throw new FlexHarnessStoreFormatError(`Scope recovery ${key} must be a non-negative safe integer.`);
26
+ }
27
+ }
28
+ if (typeof value.catalogueDigest !== 'string' || !/^[a-f0-9]{64}$/.test(value.catalogueDigest)) {
29
+ throw new FlexHarnessStoreFormatError('Scope recovery catalogueDigest must be a lowercase SHA-256 digest.');
30
+ }
31
+ assertRecoverySessionIds(value.recoverySessionIds);
32
+ }
33
+ /** Checks the sidecar CAS admission rule and copies the caller-owned value before a backend awaits. */
34
+ export function validateFlexScopeRecoverySave(snapshot, expectedRevision) {
35
+ assertFlexScopeRecoverySnapshot(snapshot);
36
+ validateExpectedRevision(expectedRevision);
37
+ if (snapshot.revision !== expectedRevision + 1) {
38
+ throw new FlexHarnessStoreFormatError(`Scope recovery revision ${snapshot.revision} must equal expected revision ${expectedRevision} plus one.`);
39
+ }
40
+ return cloneSerializable(snapshot);
41
+ }
42
+ function canonicalCatalogueJson(value) {
43
+ if (Array.isArray(value))
44
+ return `[${value.map(canonicalCatalogueJson).join(',')}]`;
45
+ if (value !== null && typeof value === 'object') {
46
+ const fields = value;
47
+ return `{${Object.keys(fields).sort().map((key) => `${JSON.stringify(key)}:${canonicalCatalogueJson(fields[key])}`).join(',')}}`;
48
+ }
49
+ const serialized = JSON.stringify(value);
50
+ if (serialized === undefined) {
51
+ throw new FlexHarnessStoreFormatError('Scope catalogue is not canonical JSON.');
52
+ }
53
+ return serialized;
54
+ }
55
+ function catalogueDigest(snapshot) {
56
+ const canonical = canonicalCatalogueJson({
57
+ catalogueRevision: snapshot?.revision ?? 0,
58
+ snapshot: snapshot ?? null,
59
+ });
60
+ return plugins.crypto.createHash('sha256').update(canonical).digest('hex');
61
+ }
62
+ /**
63
+ * Adds session-local recovery to any durable scope CAS store without changing its snapshots.
64
+ *
65
+ * The host must exclusively own the namespace, including qualification and every legacy writer;
66
+ * there must be no simultaneous legacy writer, even through another wrapper/process. The helper
67
+ * lane serializes this sidecar adapter's operations per storage key, not distributed ownership.
68
+ * Clear an obligation only after the session effects/recovery are conclusively durable; an
69
+ * uncertain session operation must retain its obligation, never attempt a clear.
70
+ * Qualification requires both the snapshot proof and authoritative all-domain write provenance;
71
+ * a legacy projection/event/job write can invalidate provenance without changing the scope.
72
+ * Normal load/save keep the legacy contract: a legacy save leaves the old proof stale by revision.
73
+ * A catalogue save commits the scope first and its matching proof second, preserving obligations;
74
+ * a failure in that gap is CommitUncertain and never implicitly qualifies the resulting catalogue.
75
+ */
76
+ export class RecoverableFlexScopeStore {
77
+ scopes;
78
+ recoveryStore;
79
+ static lanes = new WeakMap();
80
+ sessionLocal = {
81
+ releaseOwnership: (storageKey) => this.recoveryStore.deactivateWriteProvenance(storageKey),
82
+ loadCatalogue: (storageKey) => this.loadCatalogue(storageKey),
83
+ saveCatalogue: (storageKey, snapshot, expectedRevision) => this.saveCatalogue(storageKey, snapshot, expectedRevision),
84
+ setRecoveryRequired: (storageKey, sessionId, required) => this.setRecoveryRequired(storageKey, sessionId, required),
85
+ qualifyCatalogue: (storageKey, snapshot, recoverySessionIds) => this.qualifyCatalogue(storageKey, snapshot, recoverySessionIds),
86
+ };
87
+ constructor(scopes, recoveryStore) {
88
+ this.scopes = scopes;
89
+ this.recoveryStore = recoveryStore;
90
+ }
91
+ inLane(storageKey, operation) {
92
+ validateIdentifier(storageKey, 'storageKey');
93
+ let lanes = RecoverableFlexScopeStore.lanes.get(this.recoveryStore);
94
+ if (!lanes) {
95
+ lanes = new Map();
96
+ RecoverableFlexScopeStore.lanes.set(this.recoveryStore, lanes);
97
+ }
98
+ const result = (lanes.get(storageKey) ?? Promise.resolve()).then(operation);
99
+ const barrier = result.then(() => undefined, () => undefined);
100
+ lanes.set(storageKey, barrier);
101
+ void barrier.then(() => {
102
+ if (lanes.get(storageKey) === barrier)
103
+ lanes.delete(storageKey);
104
+ });
105
+ return result;
106
+ }
107
+ load(storageKey) {
108
+ return this.scopes.load(storageKey);
109
+ }
110
+ save(storageKey, snapshot, expectedRevision) {
111
+ return this.inLane(storageKey, () => {
112
+ this.recoveryStore.deactivateWriteProvenance(storageKey);
113
+ return this.scopes.save(storageKey, snapshot, expectedRevision);
114
+ });
115
+ }
116
+ async readEvidence(storageKey) {
117
+ const provenance = await this.recoveryStore.loadWriteProvenance(storageKey);
118
+ const snapshot = await this.scopes.load(storageKey);
119
+ if (snapshot !== undefined)
120
+ assertFlexScopeSnapshot(snapshot);
121
+ const recovery = await this.recoveryStore.load(storageKey);
122
+ if (recovery !== undefined)
123
+ assertFlexScopeRecoverySnapshot(recovery);
124
+ const qualified = provenance && (recovery === undefined
125
+ ? snapshot === undefined
126
+ : recovery.catalogueRevision === (snapshot?.revision ?? 0)
127
+ && recovery.catalogueDigest === catalogueDigest(snapshot));
128
+ if (!qualified)
129
+ this.recoveryStore.deactivateWriteProvenance(storageKey);
130
+ return {
131
+ snapshot: snapshot === undefined ? undefined : cloneSerializable(snapshot),
132
+ recovery: recovery === undefined ? undefined : cloneSerializable(recovery),
133
+ qualified,
134
+ };
135
+ }
136
+ loadCatalogue(storageKey) {
137
+ return this.inLane(storageKey, async () => {
138
+ const evidence = await this.readEvidence(storageKey);
139
+ return {
140
+ snapshot: evidence.snapshot,
141
+ qualified: evidence.qualified,
142
+ recoverySessionIds: evidence.recovery?.recoverySessionIds ?? [],
143
+ };
144
+ });
145
+ }
146
+ assertQualified(storageKey, evidence) {
147
+ if (!evidence.qualified) {
148
+ throw new FlexHarnessStoreFormatError(`Scope catalogue "${storageKey}" requires explicit qualification before catalogue writes or recovery clears.`);
149
+ }
150
+ }
151
+ saveProof(storageKey, snapshot, recovery, recoverySessionIds) {
152
+ const expectedRevision = recovery?.revision ?? 0;
153
+ return this.recoveryStore.save(storageKey, {
154
+ schemaVersion: 1,
155
+ revision: expectedRevision + 1,
156
+ catalogueRevision: snapshot?.revision ?? 0,
157
+ catalogueDigest: catalogueDigest(snapshot),
158
+ recoverySessionIds,
159
+ }, expectedRevision);
160
+ }
161
+ async saveCatalogue(storageKey, snapshot, expectedRevision) {
162
+ const validated = validateSnapshotSave(snapshot, expectedRevision, assertFlexScopeSnapshot);
163
+ return this.inLane(storageKey, async () => {
164
+ const evidence = await this.readEvidence(storageKey);
165
+ this.assertQualified(storageKey, evidence);
166
+ await this.scopes.save(storageKey, validated, expectedRevision);
167
+ try {
168
+ await this.saveProof(storageKey, validated, evidence.recovery, evidence.recovery?.recoverySessionIds ?? []);
169
+ }
170
+ catch (cause) {
171
+ throw new FlexHarnessStoreCommitUncertainError(storageKey, 'write', { cause });
172
+ }
173
+ });
174
+ }
175
+ async setRecoveryRequired(storageKey, sessionId, required) {
176
+ validateIdentifier(sessionId, 'sessionId');
177
+ if (typeof required !== 'boolean') {
178
+ throw new FlexHarnessValidationError('required must be a boolean.');
179
+ }
180
+ return this.inLane(storageKey, async () => {
181
+ const evidence = await this.readEvidence(storageKey);
182
+ if (!required)
183
+ this.assertQualified(storageKey, evidence);
184
+ const ids = evidence.recovery?.recoverySessionIds ?? [];
185
+ if (ids.includes(sessionId) === required)
186
+ return;
187
+ const recoverySessionIds = required ? [...ids, sessionId] : ids.filter((id) => id !== sessionId);
188
+ if (evidence.qualified) {
189
+ await this.saveProof(storageKey, evidence.snapshot, evidence.recovery, recoverySessionIds);
190
+ }
191
+ else {
192
+ // Adding an obligation is safe without qualification, but it must not create a proof of
193
+ // the unqualified snapshot. An absent proof remains the proof of an absent catalogue.
194
+ const expectedRevision = evidence.recovery?.revision ?? 0;
195
+ await this.recoveryStore.save(storageKey, {
196
+ schemaVersion: 1,
197
+ revision: expectedRevision + 1,
198
+ catalogueRevision: evidence.recovery?.catalogueRevision ?? 0,
199
+ catalogueDigest: evidence.recovery?.catalogueDigest ?? catalogueDigest(undefined),
200
+ recoverySessionIds,
201
+ }, expectedRevision);
202
+ }
203
+ });
204
+ }
205
+ async qualifyCatalogue(storageKey, snapshot, recoverySessionIds) {
206
+ assertFlexScopeSnapshot(snapshot);
207
+ assertRecoverySessionIds(recoverySessionIds);
208
+ const validated = cloneSerializable(snapshot);
209
+ const ids = [...recoverySessionIds];
210
+ return this.inLane(storageKey, async () => {
211
+ const evidence = await this.readEvidence(storageKey);
212
+ if (evidence.snapshot === undefined || catalogueDigest(evidence.snapshot) !== catalogueDigest(validated)) {
213
+ throw new FlexHarnessStoreConflictError(storageKey, validated.revision, evidence.snapshot?.revision ?? 0);
214
+ }
215
+ // The exclusive owner supplies the complete unresolved set after canonical qualification.
216
+ // Publish the proof inactive: a crash/failure before witness qualification cannot bless it.
217
+ this.recoveryStore.deactivateWriteProvenance(storageKey);
218
+ try {
219
+ await this.saveProof(storageKey, validated, evidence.recovery, ids);
220
+ await this.recoveryStore.qualifyWriteProvenance(storageKey);
221
+ }
222
+ catch (cause) {
223
+ throw new FlexHarnessStoreCommitUncertainError(storageKey, 'write', { cause });
224
+ }
225
+ });
226
+ }
227
+ }
228
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zY29wZXJlY292ZXJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5zY29wZXJlY292ZXJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFDTCxvQ0FBb0MsRUFDcEMsNkJBQTZCLEVBQzdCLDJCQUEyQixFQUMzQiwwQkFBMEIsR0FDM0IsTUFBTSxhQUFhLENBQUM7QUFRckIsT0FBTyxFQUNMLHVCQUF1QixFQUN2QixzQkFBc0IsRUFDdEIsaUJBQWlCLEdBQ2xCLE1BQU0saUJBQWlCLENBQUM7QUFDekIsT0FBTyxFQUFFLGVBQWUsRUFBRSxZQUFZLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUN2RSxPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLGtCQUFrQixFQUNsQixvQkFBb0IsR0FDckIsTUFBTSx1QkFBdUIsQ0FBQztBQUUvQixTQUFTLHdCQUF3QixDQUFDLEtBQWM7SUFDOUMsSUFDRSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDO1dBQ2xCLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLE9BQU8sRUFBRSxLQUFLLFFBQVEsSUFBSSxDQUFDLEVBQUUsQ0FBQyxJQUFJLEVBQUUsQ0FBQztXQUN4RCxJQUFJLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQyxJQUFJLEtBQUssS0FBSyxDQUFDLE1BQU0sRUFDdkMsQ0FBQztRQUNELE1BQU0sSUFBSSwyQkFBMkIsQ0FBQyw4REFBOEQsQ0FBQyxDQUFDO0lBQ3hHLENBQUM7QUFDSCxDQUFDO0FBRUQsa0dBQWtHO0FBQ2xHLE1BQU0sVUFBVSwrQkFBK0IsQ0FDN0MsS0FBYztJQUVkLHNCQUFzQixDQUFDLEtBQUssRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDO0lBQ2hELFlBQVksQ0FBQyxLQUFLLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQztJQUN0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
@@ -1,5 +1,16 @@
1
+ import { RecoverableFlexScopeStore } from './classes.scoperecovery.js';
1
2
  import type { IFlexAgentEventStoreProvider, IFlexHarnessStores, IFlexPermissionStore, IFlexProjectManagementSnapshot, IFlexProjectManagementStore, IFlexProjectManagementTombstone, IFlexProjectManagementWriteContext, IFlexProjectionStore, IFlexResultStore, IFlexScopeStore, IFlexToolJobStoreProvider, TFlexProjectManagementRecord } from './interfaces.js';
3
+ declare class InMemoryWriteProvenance {
4
+ private readonly generations;
5
+ private readonly active;
6
+ deactivate(storageKey: string): void;
7
+ load(storageKey: string): boolean;
8
+ qualify(storageKey: string): void;
9
+ touch(storageKey: string): void;
10
+ }
2
11
  export declare class InMemoryFlexProjectManagementStore implements IFlexProjectManagementStore {
12
+ private readonly writes?;
13
+ constructor(writes?: InMemoryWriteProvenance | undefined);
3
14
  private readonly snapshots;
4
15
  load(storageKey: string, sessionId: string): Promise<TFlexProjectManagementRecord | undefined>;
5
16
  save(storageKey: string, sessionId: string, snapshot: IFlexProjectManagementSnapshot, expectedRevision: number, writeContext: IFlexProjectManagementWriteContext): Promise<void>;
@@ -7,7 +18,8 @@ export declare class InMemoryFlexProjectManagementStore implements IFlexProjectM
7
18
  purgeNamespace(storageKey: string): Promise<void>;
8
19
  }
9
20
  export declare class InMemoryFlexHarnessStores implements IFlexHarnessStores {
10
- readonly scopes: IFlexScopeStore;
21
+ private readonly writes;
22
+ readonly scopes: RecoverableFlexScopeStore;
11
23
  readonly projections: IFlexProjectionStore;
12
24
  readonly permissions: IFlexPermissionStore;
13
25
  readonly agentEvents: IFlexAgentEventStoreProvider;
@@ -34,3 +46,4 @@ export declare class JsonFileFlexHarnessStores implements IFlexHarnessStores {
34
46
  constructor(options: IJsonFileFlexHarnessStoresOptions);
35
47
  dispose(): Promise<void>;
36
48
  }
49
+ export {};