@ai-rpg-engine/campaign-memory 2.1.7 → 2.5.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.
package/dist/journal.js CHANGED
@@ -1,13 +1,19 @@
1
1
  // CampaignJournal — persistent record of significant campaign events
2
- let nextRecordId = 1;
3
- function generateId() {
4
- return `cr_${nextRecordId++}`;
5
- }
2
+ import { CAMPAIGN_MEMORY_VERSION } from './types.js';
3
+ import { validateCampaignRecord } from './validate.js';
6
4
  export class CampaignJournal {
7
5
  records = new Map();
6
+ /**
7
+ * Per-instance ID counter. Record IDs depend only on (this journal's history),
8
+ * never on cross-instance order — see CP-01. Two journals number independently.
9
+ */
10
+ nextRecordId = 1;
11
+ generateId() {
12
+ return `cr_${this.nextRecordId++}`;
13
+ }
8
14
  /** Record a significant event. Returns the created record with generated ID. */
9
15
  record(entry) {
10
- const record = { id: generateId(), ...entry };
16
+ const record = { id: this.generateId(), ...entry };
11
17
  this.records.set(record.id, record);
12
18
  return record;
13
19
  }
@@ -45,25 +51,85 @@ export class CampaignJournal {
45
51
  size() {
46
52
  return this.records.size;
47
53
  }
48
- /** Serializable state for persistence */
54
+ /**
55
+ * Serializable state for persistence, wrapped in a versioned envelope (CM-01)
56
+ * so a future record-schema change has a number to migrate on.
57
+ */
49
58
  serialize() {
50
- return Array.from(this.records.values()).sort((a, b) => a.tick - b.tick);
59
+ return {
60
+ version: CAMPAIGN_MEMORY_VERSION,
61
+ records: Array.from(this.records.values()).sort((a, b) => a.tick - b.tick),
62
+ };
51
63
  }
52
- /** Restore from serialized state */
53
- static deserialize(records) {
64
+ /**
65
+ * Restore from serialized state. Accepts the versioned envelope written by
66
+ * `serialize()` AND the legacy bare-array format (saves written before
67
+ * CAMPAIGN_MEMORY_VERSION existed) — legacy saves upgrade to the envelope on
68
+ * their next serialize().
69
+ *
70
+ * CA-06: guards malformed input with a clear, actionable error instead of letting a raw
71
+ * TypeError escape ("records is not iterable", "cannot read 'id' of null"). The thrown
72
+ * Error names the offending element index/field and how to fix it.
73
+ *
74
+ * CM-01 extends the guard below the top level: an envelope stamped with a
75
+ * NEWER schema version is rejected (upgrade the package), and every record is
76
+ * validated field-by-field (tick, category, significance, witnesses, …) so a
77
+ * corrupt record fails HERE instead of NaN-sorting inside query() or throwing
78
+ * deep in buildFinaleOutline().
79
+ */
80
+ static deserialize(input) {
81
+ let records;
82
+ if (Array.isArray(input)) {
83
+ // Legacy pre-versioning format: a bare array of records.
84
+ records = input;
85
+ }
86
+ else if (typeof input === 'object' && input !== null) {
87
+ const version = input.version;
88
+ if (typeof version !== 'number' || !Number.isFinite(version)) {
89
+ throw new Error(`CampaignJournal.deserialize: envelope version must be a number (got ${typeof version}) — expected the { version, records } value returned by serialize(), or a legacy array of records`);
90
+ }
91
+ if (version > CAMPAIGN_MEMORY_VERSION) {
92
+ throw new Error(`CampaignJournal.deserialize: save version ${version} is newer than supported version ${CAMPAIGN_MEMORY_VERSION} — upgrade @ai-rpg-engine/campaign-memory to load this save`);
93
+ }
94
+ const envRecords = input.records;
95
+ if (!Array.isArray(envRecords)) {
96
+ throw new Error(`CampaignJournal.deserialize: envelope records must be an array (got ${envRecords === null ? 'null' : typeof envRecords})`);
97
+ }
98
+ records = envRecords;
99
+ }
100
+ else {
101
+ throw new Error(`CampaignJournal.deserialize: expected an array of records or a { version, records } envelope (got ${input === null ? 'null' : typeof input}) — pass the value returned by serialize()`);
102
+ }
54
103
  const journal = new CampaignJournal();
55
- for (const record of records) {
56
- journal.records.set(record.id, record);
104
+ const restored = [];
105
+ for (let i = 0; i < records.length; i++) {
106
+ const record = records[i];
107
+ if (typeof record !== 'object' || record === null) {
108
+ throw new Error(`CampaignJournal.deserialize: record[${i}] must be an object (got ${record === null ? 'null' : typeof record})`);
109
+ }
110
+ if (typeof record.id !== 'string') {
111
+ throw new Error(`CampaignJournal.deserialize: record[${i}] is missing a string "id" — each record needs an id like "cr_1"`);
112
+ }
113
+ // CM-01: full per-record substructure validation (tick, category,
114
+ // significance, witnesses, …) via the shared validator.
115
+ const errors = validateCampaignRecord(record);
116
+ if (errors.length > 0) {
117
+ const detail = errors.map((e) => `${e.field} ${e.message}`).join('; ');
118
+ throw new Error(`CampaignJournal.deserialize: record[${i}] is invalid — ${detail}`);
119
+ }
120
+ const valid = record;
121
+ journal.records.set(valid.id, valid);
122
+ restored.push(valid);
57
123
  }
58
- // Ensure ID counter is ahead of existing records
124
+ // Advance THIS instance's counter past the highest restored id (CP-01).
59
125
  let maxNum = 0;
60
- for (const r of records) {
126
+ for (const r of restored) {
61
127
  const match = r.id.match(/^cr_(\d+)$/);
62
128
  if (match) {
63
129
  maxNum = Math.max(maxNum, parseInt(match[1], 10));
64
130
  }
65
131
  }
66
- nextRecordId = maxNum + 1;
132
+ journal.nextRecordId = maxNum + 1;
67
133
  return journal;
68
134
  }
69
135
  }
@@ -1 +1 @@
1
- {"version":3,"file":"journal.js","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"journal.js","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"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"}
@@ -23,9 +23,24 @@ export declare class NpcMemoryBank {
23
23
  knownSubjects(): string[];
24
24
  /** Get the full memory entry for a subject */
25
25
  getEntry(subjectId: string): NpcMemoryEntry | undefined;
26
- /** Serializable state */
26
+ /** Serializable state, stamped with the current schema version (CM-02). */
27
27
  serialize(): NpcMemoryState;
28
- /** Restore from serialized state */
28
+ /**
29
+ * Restore from serialized state.
30
+ *
31
+ * CA-06: guards malformed state with a clear, actionable error instead of building a
32
+ * half-formed bank that throws a raw TypeError on the next call. The thrown Error names
33
+ * the offending field and how to fix it.
34
+ *
35
+ * CM-02 extends the guard below the top level:
36
+ * - schema version check — a save stamped with a NEWER version than this
37
+ * package supports is rejected (upgrade the package); a save with no
38
+ * version is legacy v1 and loads normally.
39
+ * - per-subject validation — relationship axes, memory fragments, and
40
+ * interaction counters are checked, so a corrupt subject entry fails HERE
41
+ * (naming the subject and field) rather than as a raw TypeError deep in
42
+ * recall()/consolidate().
43
+ */
29
44
  static deserialize(state: NpcMemoryState, config?: CampaignMemoryConfig): NpcMemoryBank;
30
45
  private getOrCreateEntry;
31
46
  }
@@ -1 +1 @@
1
- {"version":3,"file":"memory-bank.d.ts","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAUpB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAK3D,oDAAoD;IACpD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IA8BjF,8CAA8C;IAC9C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAMpD,oEAAoE;IACpE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAkB9E,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE;IA2B5C,gDAAgD;IAChD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAa9D,gFAAgF;IAChF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAyBtC,+CAA+C;IAC/C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASpC,qDAAqD;IACrD,aAAa,IAAI,MAAM,EAAE;IAIzB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUvD,yBAAyB;IACzB,SAAS,IAAI,cAAc;IAI3B,oCAAoC;IACpC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAQvF,OAAO,CAAC,gBAAgB;CAYzB"}
1
+ {"version":3,"file":"memory-bank.d.ts","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAWpB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAK3D,oDAAoD;IACpD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IA8BjF,8CAA8C;IAC9C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAMpD,oEAAoE;IACpE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAkB9E,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE;IA2B5C,gDAAgD;IAChD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAa9D,gFAAgF;IAChF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAyBtC,+CAA+C;IAC/C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASpC,qDAAqD;IACrD,aAAa,IAAI,MAAM,EAAE;IAIzB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUvD,2EAA2E;IAC3E,SAAS,IAAI,cAAc;IAO3B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAgDvF,OAAO,CAAC,gBAAgB;CAYzB"}
@@ -1,5 +1,6 @@
1
1
  // NpcMemoryBank — per-NPC memory with relationship tracking and consolidation
2
- import { createDefaultRelationship } from './types.js';
2
+ import { CAMPAIGN_MEMORY_VERSION, createDefaultRelationship } from './types.js';
3
+ import { validateMemoryFragment, validateRelationshipAxes } from './validate.js';
3
4
  const DEFAULT_CONFIG = {
4
5
  fadeThreshold: 0.3,
5
6
  dimThreshold: 0.1,
@@ -152,14 +153,60 @@ export class NpcMemoryBank {
152
153
  memories: entry.memories.map((m) => ({ ...m })),
153
154
  };
154
155
  }
155
- /** Serializable state */
156
+ /** Serializable state, stamped with the current schema version (CM-02). */
156
157
  serialize() {
157
- return JSON.parse(JSON.stringify(this.state));
158
+ return {
159
+ version: CAMPAIGN_MEMORY_VERSION,
160
+ ...JSON.parse(JSON.stringify(this.state)),
161
+ };
158
162
  }
159
- /** Restore from serialized state */
163
+ /**
164
+ * Restore from serialized state.
165
+ *
166
+ * CA-06: guards malformed state with a clear, actionable error instead of building a
167
+ * half-formed bank that throws a raw TypeError on the next call. The thrown Error names
168
+ * the offending field and how to fix it.
169
+ *
170
+ * CM-02 extends the guard below the top level:
171
+ * - schema version check — a save stamped with a NEWER version than this
172
+ * package supports is rejected (upgrade the package); a save with no
173
+ * version is legacy v1 and loads normally.
174
+ * - per-subject validation — relationship axes, memory fragments, and
175
+ * interaction counters are checked, so a corrupt subject entry fails HERE
176
+ * (naming the subject and field) rather than as a raw TypeError deep in
177
+ * recall()/consolidate().
178
+ */
160
179
  static deserialize(state, config) {
180
+ if (typeof state !== 'object' || state === null || Array.isArray(state)) {
181
+ throw new Error(`NpcMemoryBank.deserialize: expected a state object (got ${state === null ? 'null' : Array.isArray(state) ? 'array' : typeof state}) — pass the value returned by serialize()`);
182
+ }
183
+ const version = state.version;
184
+ if (version !== undefined) {
185
+ if (typeof version !== 'number' || !Number.isFinite(version)) {
186
+ throw new Error(`NpcMemoryBank.deserialize: state.version must be a number (got ${typeof version}) — legacy saves omit it entirely`);
187
+ }
188
+ if (version > CAMPAIGN_MEMORY_VERSION) {
189
+ throw new Error(`NpcMemoryBank.deserialize: state version ${version} is newer than supported version ${CAMPAIGN_MEMORY_VERSION} — upgrade @ai-rpg-engine/campaign-memory to load this save`);
190
+ }
191
+ }
192
+ if (typeof state.entityId !== 'string') {
193
+ throw new Error('NpcMemoryBank.deserialize: state is missing a string "entityId" — this is the NPC the bank belongs to');
194
+ }
195
+ const subjects = state.subjects;
196
+ if (typeof subjects !== 'object' || subjects === null || Array.isArray(subjects)) {
197
+ throw new Error(`NpcMemoryBank.deserialize: state.subjects must be an object mapping subjectId → entry (got ${subjects === undefined ? 'undefined' : subjects === null ? 'null' : Array.isArray(subjects) ? 'array' : typeof subjects})`);
198
+ }
199
+ for (const [subjectId, entry] of Object.entries(subjects)) {
200
+ validateSubjectEntry(subjectId, entry);
201
+ }
161
202
  const bank = new NpcMemoryBank(state.entityId, config);
162
- bank.state = JSON.parse(JSON.stringify(state));
203
+ // Store WITHOUT the version stamp — the runtime state has no use for it,
204
+ // and serialize() re-stamps the current version (which also upgrades
205
+ // legacy saves on their next write).
206
+ bank.state = {
207
+ entityId: state.entityId,
208
+ subjects: JSON.parse(JSON.stringify(subjects)),
209
+ };
163
210
  return bank;
164
211
  }
165
212
  // --- Internal ---
@@ -179,4 +226,37 @@ export class NpcMemoryBank {
179
226
  function clamp(value, min, max) {
180
227
  return Math.max(min, Math.min(max, value));
181
228
  }
229
+ /**
230
+ * CM-02 per-subject guard. Throws an Error naming the offending subject and
231
+ * field. Reuses the validate.js helpers so the boundary check and the public
232
+ * validators cannot drift apart.
233
+ */
234
+ function validateSubjectEntry(subjectId, entry) {
235
+ const at = `subjects["${subjectId}"]`;
236
+ if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
237
+ throw new Error(`NpcMemoryBank.deserialize: ${at} must be an entry object (got ${entry === null ? 'null' : Array.isArray(entry) ? 'array' : typeof entry})`);
238
+ }
239
+ const e = entry;
240
+ const relErrors = validateRelationshipAxes(e.relationship);
241
+ if (relErrors.length > 0) {
242
+ const first = relErrors[0];
243
+ throw new Error(`NpcMemoryBank.deserialize: ${at}.relationship${first.field === 'root' ? '' : '.' + first.field} ${first.message}`);
244
+ }
245
+ if (!Array.isArray(e.memories)) {
246
+ throw new Error(`NpcMemoryBank.deserialize: ${at}.memories must be an array of memory fragments (got ${e.memories === null ? 'null' : typeof e.memories})`);
247
+ }
248
+ for (let i = 0; i < e.memories.length; i++) {
249
+ const fragErrors = validateMemoryFragment(e.memories[i]);
250
+ if (fragErrors.length > 0) {
251
+ const first = fragErrors[0];
252
+ throw new Error(`NpcMemoryBank.deserialize: ${at}.memories[${i}]${first.field === 'root' ? '' : '.' + first.field} ${first.message}`);
253
+ }
254
+ }
255
+ if (typeof e.lastInteractionTick !== 'number' || Number.isNaN(e.lastInteractionTick)) {
256
+ throw new Error(`NpcMemoryBank.deserialize: ${at}.lastInteractionTick must be a number (got ${typeof e.lastInteractionTick})`);
257
+ }
258
+ if (typeof e.interactionCount !== 'number' || Number.isNaN(e.interactionCount)) {
259
+ throw new Error(`NpcMemoryBank.deserialize: ${at}.interactionCount must be a number (got ${typeof e.interactionCount})`);
260
+ }
261
+ }
182
262
  //# sourceMappingURL=memory-bank.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"memory-bank.js","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"memory-bank.js","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAW9E,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEjF,MAAM,cAAc,GAAmC;IACrD,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,KAAK;IAChB,qBAAqB,EAAE,EAAE;CAC1B,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,KAAK,CAAiB;IACtB,MAAM,CAAiC;IAE/C,YAAY,QAAgB,EAAE,MAA6B;QACzD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,kEAAkE;IAClE,QAAQ,CAAC,MAAsB,EAAE,QAAgB,EAAE,eAAuB;QACxE,yEAAyE;QACzE,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ;YACtD,CAAC,CAAC,MAAM,CAAC,QAAQ;YACjB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAEnB,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC/C,KAAK,CAAC,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC;QACxC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAEzB,0BAA0B;QAC1B,MAAM,QAAQ,GAAmB;YAC/B,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC5C,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAC3D,aAAa,EAAE,OAAO;YACtB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;QAEF,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9B,iEAAiE;QACjE,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YAC9D,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YACvD,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,yBAAyB,EAAE,CAAC;QAC/C,OAAO,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IACnC,CAAC;IAED,oEAAoE;IACpE,kBAAkB,CAAC,SAAiB,EAAE,MAAiC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;QAE7B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,CAAC,KAAkB;QACvB,IAAI,OAAO,GAAqB,EAAE,CAAC;QAEnC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK;gBAAE,OAAO,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAY,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YACrD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,gDAAgD;IAChD,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAE5D,IAAI,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACpD,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gFAAgF;IAChF,WAAW,CAAC,WAAmB;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;gBACvC,IAAI,OAAO,IAAI,CAAC;oBAAE,SAAS;gBAE3B,iBAAiB;gBACjB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;gBAC3E,GAAG,CAAC,IAAI,GAAG,WAAW,CAAC;gBAEvB,6BAA6B;gBAC7B,IAAI,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;oBAC5C,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC;gBAC5B,CAAC;qBAAM,IAAI,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;oBACpD,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC;gBAC9B,CAAC;YACH,CAAC;YAED,4DAA4D;YAC5D,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,CACnD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,SAAS,CAAC,QAAgB;QACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACxD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qDAAqD;IACrD,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,SAAiB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,OAAO;YACL,GAAG,KAAK;YACR,YAAY,EAAE,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE;YACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,SAAS;QACP,OAAO;YACL,OAAO,EAAE,uBAAuB;YAChC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,KAAqB,EAAE,MAA6B;QACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,2DAA2D,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,4CAA4C,CAC/K,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAI,KAA+B,CAAC,OAAO,CAAC;QACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,kEAAkE,OAAO,OAAO,mCAAmC,CACpH,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,GAAG,uBAAuB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,4CAA4C,OAAO,oCAAoC,uBAAuB,6DAA6D,CAC5K,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAI,KAAgC,CAAC,QAAQ,CAAC;QAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CACb,8FACE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QACjH,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC,EAAE,CAAC;YACrF,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,yEAAyE;QACzE,qEAAqE;QACrE,qCAAqC;QACrC,IAAI,CAAC,KAAK,GAAG;YACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;SAC/C,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB;IAEX,gBAAgB,CAAC,SAAiB;QACxC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG;gBAC/B,SAAS;gBACT,YAAY,EAAE,yBAAyB,EAAE;gBACzC,QAAQ,EAAE,EAAE;gBACZ,mBAAmB,EAAE,CAAC;gBACtB,gBAAgB,EAAE,CAAC;aACpB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;CACF;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,SAAiB,EAAE,KAAc;IAC7D,MAAM,EAAE,GAAG,aAAa,SAAS,IAAI,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,iCAAiC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAC5I,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAE3C,MAAM,SAAS,GAAG,wBAAwB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC3D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,gBAAgB,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CACnH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,uDAAuD,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,GAAG,CAC3I,CAAC;IACJ,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,sBAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,aAAa,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CACrH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,CAAC,mBAAmB,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,8CAA8C,OAAO,CAAC,CAAC,mBAAmB,GAAG,CAC9G,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,gBAAgB,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,2CAA2C,OAAO,CAAC,CAAC,gBAAgB,GAAG,CACxG,CAAC;IACJ,CAAC;AACH,CAAC"}
package/dist/types.d.ts CHANGED
@@ -1,3 +1,12 @@
1
+ /**
2
+ * Current campaign-memory schema version (CM-01/CM-02). Stamped into every
3
+ * value returned by `NpcMemoryBank.serialize()` / `CampaignJournal.serialize()`
4
+ * and checked by both `deserialize()`s: saves with a NEWER version are rejected
5
+ * with an actionable error; saves with no version (written before this constant
6
+ * existed) load as legacy v1. Mirrors character-profile's PROFILE_VERSION so a
7
+ * future schema change has a number to migrate on.
8
+ */
9
+ export declare const CAMPAIGN_MEMORY_VERSION = 1;
1
10
  /** Multi-axis relationship model beyond boolean hostile */
2
11
  export type RelationshipAxes = {
3
12
  /** -1 (distrust) to 1 (trust) */
@@ -45,9 +54,24 @@ export type NpcMemoryEntry = {
45
54
  };
46
55
  /** Full NPC memory state */
47
56
  export type NpcMemoryState = {
57
+ /**
58
+ * Schema version, stamped by `NpcMemoryBank.serialize()`. Optional because
59
+ * legacy saves (pre-versioning) lack it — `deserialize()` treats a missing
60
+ * version as v1 and re-stamps on the next serialize.
61
+ */
62
+ version?: number;
48
63
  entityId: string;
49
64
  subjects: Record<string, NpcMemoryEntry>;
50
65
  };
66
+ /**
67
+ * Versioned journal save envelope, returned by `CampaignJournal.serialize()`.
68
+ * `CampaignJournal.deserialize()` also accepts a bare `CampaignRecord[]`
69
+ * (the legacy pre-versioning format).
70
+ */
71
+ export type SerializedJournal = {
72
+ version: number;
73
+ records: CampaignRecord[];
74
+ };
51
75
  /** Query filters for NPC memories */
52
76
  export type MemoryQuery = {
53
77
  aboutEntity?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,kBAAkB,GAClB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,uBAAuB,GACvB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,oBAAoB,GAAG;IACjC,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAQ5C,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EAE/C,CAAC;AAEX,wBAAgB,yBAAyB,IAAI,gBAAgB,CAE5D"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js CHANGED
@@ -1,4 +1,13 @@
1
1
  // Campaign memory types — persistent NPC memory and relationship model
2
+ /**
3
+ * Current campaign-memory schema version (CM-01/CM-02). Stamped into every
4
+ * value returned by `NpcMemoryBank.serialize()` / `CampaignJournal.serialize()`
5
+ * and checked by both `deserialize()`s: saves with a NEWER version are rejected
6
+ * with an actionable error; saves with no version (written before this constant
7
+ * existed) load as legacy v1. Mirrors character-profile's PROFILE_VERSION so a
8
+ * future schema change has a number to migrate on.
9
+ */
10
+ export const CAMPAIGN_MEMORY_VERSION = 1;
2
11
  export const VALID_CATEGORIES = [
3
12
  'action', 'combat', 'kill', 'betrayal', 'gift', 'theft',
4
13
  'debt', 'discovery', 'alliance', 'insult', 'rescue', 'death',
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AA4GvE,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO;IACvD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;IAC5D,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB;IAC9D,wBAAwB,EAAE,gBAAgB;IAC1C,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB;IACnE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,uBAAuB;IAC9F,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,OAAO,EAAE,OAAO,EAAE,KAAK;CACf,CAAC;AAEX,MAAM,UAAU,yBAAyB;IACvC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AA4HzC,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO;IACvD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;IAC5D,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB;IAC9D,wBAAwB,EAAE,gBAAgB;IAC1C,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB;IACnE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,uBAAuB;IAC9F,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,OAAO,EAAE,OAAO,EAAE,KAAK;CACf,CAAC;AAEX,MAAM,UAAU,yBAAyB;IACvC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ai-rpg-engine/campaign-memory",
3
- "version": "2.1.7",
3
+ "version": "2.5.0",
4
4
  "description": "Persistent NPC memory, relationship axes, and campaign journal for AI RPG Engine",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",