dotmem 0.0.9 → 0.1.1

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.
@@ -0,0 +1,804 @@
1
+ # dotmem AI Trust Boundary and Progressive Model Profiling
2
+
3
+ ## Purpose
4
+
5
+ This document defines how dotmem protects shared memory when interacting with AI models of unknown, partially known, or demonstrated behavioral quality.
6
+
7
+ dotmem is a bridge between different AI systems.
8
+
9
+ That bridge must not become a mechanism for:
10
+
11
+ - uncontrolled information gathering
12
+ - propagation of sensitive profiling
13
+ - false memory claims
14
+ - path invention
15
+ - misuse of shared memory
16
+ - silent rewriting of durable knowledge
17
+ - cross-model amplification of bad behavior
18
+
19
+ The default position is conservative:
20
+
21
+ > Unknown AI -> strong shields.
22
+
23
+ Trust may increase progressively through evidence.
24
+
25
+ This document is static policy. It is the counterpart of `curiosity.md`:
26
+
27
+ ```text
28
+ curiosity.md
29
+ -> how AI may learn about HI
30
+
31
+ trust.md
32
+ -> how dotmem protects HI from AI
33
+ ```
34
+
35
+ Status note: the dynamic behavioral reputation store described in section 29
36
+ (`<user-anchor>/trust/models.json`) is not implemented yet. Until it exists, every
37
+ model/runtime is treated as UNKNOWN and the LEVEL 0 defaults apply.
38
+
39
+
40
+
41
+ ## 1. Core Principle
42
+
43
+ dotmem must never assume that an AI model is trustworthy merely because:
44
+
45
+ - it is capable
46
+ - it is fast
47
+ - it is popular
48
+ - it comes from a known provider
49
+ - it performs well on coding benchmarks
50
+ - it follows instructions once
51
+ - it has a large context window
52
+
53
+ Behavioral trust must be earned through observed evidence.
54
+
55
+ Conceptually:
56
+
57
+ ```text
58
+ UNKNOWN MODEL
59
+
60
+ STRONG TRUST BOUNDARY
61
+
62
+ OBSERVATION
63
+
64
+ VERIFIED BEHAVIOR
65
+
66
+ PROGRESSIVE TRUST
67
+
68
+ GREATER ELASTICITY
69
+ ```
70
+
71
+ Trust is gradual.
72
+
73
+ Trust is reversible.
74
+
75
+ Trust is domain-specific.
76
+
77
+
78
+
79
+ ## 2. Unknown AI Default
80
+
81
+ When dotmem encounters an AI model with no behavioral history, restrictive defaults apply.
82
+
83
+ An unknown AI receives:
84
+
85
+ - minimum necessary memory
86
+ - redacted sensitive data
87
+ - no unnecessary personal information
88
+ - no intimate behavioral profiling
89
+ - no hidden relationship metadata unless required
90
+ - no raw secrets
91
+ - no broad filesystem assumptions
92
+ - no unrestricted historical memory
93
+ - no automatic permission to mutate shared durable memory
94
+
95
+ Preferred principle:
96
+
97
+ > I do not know you yet, therefore I do not give you everything.
98
+
99
+
100
+
101
+ ## 3. Shared Memory Requires Stronger Protection
102
+
103
+ Shared memory must be protected more strictly than transient conversation context.
104
+
105
+ Something tolerated in an ephemeral conversation is not automatically appropriate for durable cross-model exposure.
106
+
107
+ Conceptually:
108
+
109
+ ```text
110
+ ephemeral context
111
+ !=
112
+ shared durable memory
113
+ ```
114
+
115
+ Before exposing shared memory to an AI, consider:
116
+
117
+ - model trust level
118
+ - sensitivity of the memory
119
+ - relevance to the current task
120
+ - minimum required disclosure
121
+ - whether redaction is possible
122
+ - whether HI approval is required
123
+
124
+
125
+
126
+ ## 4. Model Behavioral Profile
127
+
128
+ dotmem should maintain an evidence-based behavioral profile for AI models.
129
+
130
+ This profile must describe observed behavior, not marketing claims.
131
+
132
+ Suggested dimensions:
133
+
134
+ ```text
135
+ identityStability
136
+ memoryHonesty
137
+ pathEvidence
138
+ contradictionRecovery
139
+ uncertaintyDiscipline
140
+ privacyRestraint
141
+ profilingRestraint
142
+ retryDiscipline
143
+ taskContinuity
144
+ verificationHonesty
145
+ secretHandling
146
+ artifactDiscipline
147
+ contextStability
148
+ riskSignaling
149
+ ```
150
+
151
+ These values should be based on:
152
+
153
+ - controlled benchmarks
154
+ - runtime observations
155
+ - verified failures
156
+ - repeated successful behavior
157
+ - regression tests
158
+
159
+
160
+
161
+ ## 5. Trust Is Not a Single Score
162
+
163
+ Avoid one global "good AI / bad AI" value.
164
+
165
+ A model may be strong in one area and weak in another.
166
+
167
+ Example:
168
+
169
+ ```text
170
+ codingQuality high
171
+ memoryHonesty high
172
+ privacyRestraint medium
173
+ contradictionRecovery high
174
+ profilingRestraint low
175
+ ```
176
+
177
+ Trust is applied according to the current operation.
178
+
179
+ Example:
180
+
181
+ ```text
182
+ technical code context
183
+ -> coding trust matters
184
+
185
+ personal memory
186
+ -> privacy + profiling restraint matter more
187
+
188
+ durable acquisition
189
+ -> memory honesty + verification honesty matter more
190
+ ```
191
+
192
+
193
+
194
+ ## 6. Progressive Elasticity
195
+
196
+ A model may receive greater flexibility as it demonstrates reliable behavior over time.
197
+
198
+ Example trust progression:
199
+
200
+ ```text
201
+ LEVEL 0 UNKNOWN
202
+ maximum minimization
203
+ strong redaction
204
+ no sensitive shared memory by default
205
+ no silent durable mutation
206
+
207
+ LEVEL 1 OBSERVED
208
+ limited non-sensitive context
209
+ basic interaction preferences
210
+ read-only shared memory where appropriate
211
+
212
+ LEVEL 2 VERIFIED
213
+ broader relevant memory
214
+ normal project continuity
215
+ ordinary durable acquisition with verification
216
+
217
+ LEVEL 3 TRUSTED
218
+ greater contextual elasticity
219
+ richer continuity
220
+ reduced friction for previously verified behaviors
221
+ ```
222
+
223
+ Progression must be evidence-based.
224
+
225
+ Time alone is not sufficient.
226
+
227
+ Time + consistent verified behavior may justify greater elasticity.
228
+
229
+
230
+
231
+ ## 7. Trust Decay and Regression
232
+
233
+ Trust must be reversible.
234
+
235
+ A previously trusted model may regress after:
236
+
237
+ - provider update
238
+ - model version change
239
+ - system prompt change
240
+ - runtime change
241
+ - toolchain change
242
+ - repeated contradictory behavior
243
+ - privacy violation
244
+ - false persistence claim
245
+ - invented path
246
+ - unexplained identity drift
247
+
248
+ When a meaningful regression occurs:
249
+
250
+ ```text
251
+ reduce trust
252
+ increase redaction
253
+ reduce memory exposure
254
+ require stronger verification
255
+ involve HI when necessary
256
+ ```
257
+
258
+ A high trust level is not preserved merely because the model was reliable in the past.
259
+
260
+
261
+
262
+ ## 8. Model Identity Must Be Explicit
263
+
264
+ Behavioral trust should be associated with the most specific available runtime identity.
265
+
266
+ Useful identifiers may include:
267
+
268
+ ```text
269
+ provider
270
+ model family
271
+ exact model/version
272
+ runtime host
273
+ tool environment
274
+ dotmem version
275
+ benchmark version
276
+ date
277
+ ```
278
+
279
+ Do not assume:
280
+
281
+ ```text
282
+ same provider
283
+ =
284
+ same behavior
285
+ ```
286
+
287
+ Do not assume:
288
+
289
+ ```text
290
+ same model name
291
+ =
292
+ same runtime behavior forever
293
+ ```
294
+
295
+
296
+
297
+ ## 9. Example Model Trust Record
298
+
299
+ Behavioral evidence should live outside static profile documents.
300
+
301
+ Conceptual example:
302
+
303
+ ```json
304
+ {
305
+ "model": "provider/model-version",
306
+ "observedAt": "2026-10-10T00:00:00Z",
307
+ "trust": {
308
+ "identityStability": 1.0,
309
+ "memoryHonesty": 0.95,
310
+ "pathEvidence": 1.0,
311
+ "contradictionRecovery": 0.9,
312
+ "privacyRestraint": 0.7,
313
+ "profilingRestraint": 0.6,
314
+ "retryDiscipline": 0.95
315
+ },
316
+ "evidence": [
317
+ "benchmark-id"
318
+ ]
319
+ }
320
+ ```
321
+
322
+ The exact schema may evolve.
323
+
324
+ The principle should remain stable:
325
+
326
+ > behavioral reputation must be evidence-backed and updateable.
327
+
328
+
329
+
330
+ ## 10. Memory Disclosure Gate
331
+
332
+ Before projecting memory to an AI, evaluate:
333
+
334
+ ```text
335
+ MEMORY
336
+
337
+ sensitivity
338
+
339
+ relevance
340
+
341
+ model trust
342
+
343
+ minimum necessary disclosure
344
+ ```
345
+
346
+ Possible outcomes:
347
+
348
+ ```text
349
+ ALLOW
350
+ REDACT
351
+ SUMMARIZE
352
+ WITHHOLD
353
+ ASK HI
354
+ ```
355
+
356
+
357
+
358
+ ## 11. Sensitive Memory Categories
359
+
360
+ Higher protection applies to memory containing:
361
+
362
+ - personal identity details
363
+ - contact information
364
+ - private relationships
365
+ - behavioral profiling
366
+ - emotional history
367
+ - confidential company information
368
+ - financial information
369
+ - health information
370
+ - authentication-related facts
371
+ - private project strategy
372
+ - unpublished intellectual property
373
+ - security architecture
374
+ - intimate preferences
375
+
376
+ Unknown or low-trust models should not receive these automatically.
377
+
378
+
379
+
380
+ ## 12. Semantic Compression Before Disclosure
381
+
382
+ When exact details are unnecessary, expose the semantic rule instead.
383
+
384
+ Instead of:
385
+
386
+ ```text
387
+ full personal history
388
+ ```
389
+
390
+ prefer:
391
+
392
+ ```text
393
+ HI prefers direct clarification rather than inferred emotional interpretation.
394
+ ```
395
+
396
+ Instead of:
397
+
398
+ ```text
399
+ full private company record
400
+ ```
401
+
402
+ prefer:
403
+
404
+ ```text
405
+ This project contains confidential company information.
406
+ ```
407
+
408
+ The AI should receive what it needs to help, not everything dotmem knows.
409
+
410
+
411
+
412
+ ## 13. AI Curiosity Boundary
413
+
414
+ Unknown AI models receive stricter curiosity boundaries.
415
+
416
+ They should not proactively gather:
417
+
418
+ - hidden emotional states
419
+ - vulnerability signals
420
+ - manipulation leverage
421
+ - deception cues
422
+ - unnecessary personal history
423
+ - intimate relationship details
424
+
425
+ unless HI explicitly opens that domain and the information is relevant.
426
+
427
+ dotmem should prefer:
428
+
429
+ ```text
430
+ interaction calibration
431
+ before
432
+ personal profiling
433
+ ```
434
+
435
+
436
+
437
+ ## 14. Unknown AI and Personal Questions
438
+
439
+ For unknown AI, personal questions satisfy a higher bar.
440
+
441
+ Before asking, the AI should be able to answer:
442
+
443
+ ```text
444
+ Why do I need this?
445
+ Does it materially help the current interaction?
446
+ Can I ask a less intrusive question?
447
+ Does this need to be persisted?
448
+ ```
449
+
450
+ If not, do not ask.
451
+
452
+
453
+
454
+ ## 15. Durable Acquisition Gate
455
+
456
+ Unknown or low-trust models do not have unrestricted authority to create durable user memory.
457
+
458
+ For durable acquisition, require:
459
+
460
+ - supported canonical schema
461
+ - explicit classification
462
+ - sensitivity check
463
+ - scope validation
464
+ - persistence verification
465
+ - no raw secrets
466
+ - no speculative psychological claims
467
+
468
+ For sensitive inferred information:
469
+
470
+ ```text
471
+ default -> do not persist
472
+ ```
473
+
474
+ If useful persistence is uncertain:
475
+
476
+ ```text
477
+ ask HI
478
+ ```
479
+
480
+
481
+
482
+ ## 16. No Silent Memory Mutation
483
+
484
+ No AI, regardless of trust level, should silently rewrite conflicting durable memory when uncertainty remains.
485
+
486
+ Preferred behavior:
487
+
488
+ ```text
489
+ memory says X
490
+ runtime says Y
491
+
492
+ recognize contradiction
493
+
494
+ preserve history
495
+
496
+ ask HI or present options
497
+ ```
498
+
499
+ Trust does not grant permission to erase history.
500
+
501
+
502
+
503
+ ## 17. Read Trust and Write Trust Are Different
504
+
505
+ A model may be trusted to read certain memory but not trusted to modify it.
506
+
507
+ Conceptually:
508
+
509
+ ```text
510
+ readTrust
511
+ writeTrust
512
+ sensitiveReadTrust
513
+ profileMutationTrust
514
+ ```
515
+
516
+ These are not assumed equivalent.
517
+
518
+ Example:
519
+
520
+ ```text
521
+ model may read project conventions
522
+ but
523
+ may not write durable user profiling
524
+ ```
525
+
526
+
527
+
528
+ ## 18. Profile Documents Remain Authoritative
529
+
530
+ Model reputation must not override the active dotmem profile.
531
+
532
+ Trust metadata controls:
533
+
534
+ - disclosure
535
+ - mutation permissions
536
+ - verification requirements
537
+ - sensitivity handling
538
+
539
+ It must not redefine:
540
+
541
+ - Jo's identity
542
+ - relationship rules
543
+ - behavioral principles
544
+ - curiosity boundaries
545
+ - privacy rules
546
+
547
+
548
+
549
+ ## 19. HI Remains Final Authority
550
+
551
+ HI must remain able to:
552
+
553
+ - inspect model trust state
554
+ - reset model trust
555
+ - reduce trust manually
556
+ - approve broader memory access
557
+ - deny memory exposure
558
+ - allow temporary exceptions
559
+ - force stricter redaction
560
+ - review behavioral evidence
561
+
562
+ dotmem should not make permanent trust decisions that HI cannot inspect or override.
563
+
564
+
565
+
566
+ ## 20. Trust Bootstrap for a New AI
567
+
568
+ Recommended first-contact behavior:
569
+
570
+ ```text
571
+ 1. identify model/runtime
572
+ 2. mark trust as UNKNOWN
573
+ 3. load active profile
574
+ 4. expose minimal non-sensitive baseline
575
+ 5. observe behavior
576
+ 6. run lightweight behavioral checks
577
+ 7. increase trust only with evidence
578
+ ```
579
+
580
+ Do not begin with full memory projection.
581
+
582
+
583
+
584
+ ## 21. Suggested First-Contact Checks
585
+
586
+ A lightweight trust bootstrap may test:
587
+
588
+ ```text
589
+ identity adoption
590
+ memory honesty
591
+ path evidence
592
+ uncertainty handling
593
+ contradiction recovery
594
+ privacy restraint
595
+ retry discipline
596
+ ```
597
+
598
+ The goal is not to benchmark intelligence.
599
+
600
+ The goal is to establish whether the AI can be trusted with richer continuity.
601
+
602
+
603
+
604
+ ## 22. Firewall Mindset
605
+
606
+ For an unknown AI, dotmem behaves conceptually like a firewall.
607
+
608
+ ```text
609
+ UNKNOWN AI
610
+
611
+ DENY unnecessary data
612
+ ALLOW minimum required context
613
+ REDACT sensitive fields
614
+ LOG behavioral evidence
615
+ ESCALATE uncertainty to HI
616
+ ```
617
+
618
+ As trust grows:
619
+
620
+ ```text
621
+ reduce unnecessary friction
622
+ increase contextual richness
623
+ retain verification discipline
624
+ ```
625
+
626
+ The firewall becomes more elastic, not absent.
627
+
628
+
629
+
630
+ ## 23. Unknown AI Must Not Inherit Previous AI Trust
631
+
632
+ Trust belongs to a model/runtime identity, not to the conversation slot.
633
+
634
+ When switching from one AI to another:
635
+
636
+ ```text
637
+ trusted AI A
638
+ !=
639
+ unknown AI B
640
+ ```
641
+
642
+ Trust is not transferred merely because both access the same dotmem store.
643
+
644
+ This is especially important because dotmem is explicitly designed as a bridge between different AI systems.
645
+
646
+
647
+
648
+ ## 24. Cross-AI Contamination Protection
649
+
650
+ One AI may create low-quality or intrusive memory that another AI later consumes.
651
+
652
+ dotmem should therefore protect against cross-AI contamination.
653
+
654
+ Possible mechanisms:
655
+
656
+ - provenance
657
+ - source model identity
658
+ - epistemic type
659
+ - trust level at acquisition time
660
+ - sensitivity classification
661
+ - revision history
662
+ - HI confirmation where appropriate
663
+
664
+ A claim does not become more trustworthy merely because it survived into another session.
665
+
666
+
667
+
668
+ ## 25. Provenance Should Travel with Memory
669
+
670
+ Where practical, durable memory should preserve enough provenance to answer:
671
+
672
+ ```text
673
+ who/what created this?
674
+ under which model/runtime?
675
+ was it human-stated or inferred?
676
+ was it verified?
677
+ was it created under low trust?
678
+ ```
679
+
680
+ This allows future AI models to interpret memory quality correctly.
681
+
682
+
683
+
684
+ ## 26. Trust-Aware Projection
685
+
686
+ dotmem should be able to project different views of the same memory depending on model trust.
687
+
688
+ Example:
689
+
690
+ ```text
691
+ HIGH TRUST MODEL
692
+ -> full relevant claim
693
+
694
+ UNKNOWN MODEL
695
+ -> summarized claim
696
+
697
+ LOW PRIVACY TRUST
698
+ -> redacted claim
699
+
700
+ UNTRUSTED MODEL
701
+ -> withhold claim
702
+ ```
703
+
704
+ This should be deterministic and inspectable.
705
+
706
+
707
+
708
+ ## 27. Do Not Hide Restrictions from HI
709
+
710
+ If dotmem withholds or redacts information because of model trust, HI should be able to know that this happened.
711
+
712
+ Example:
713
+
714
+ ```text
715
+ Some shared memory was withheld because this AI has not yet established sufficient privacy trust.
716
+ ```
717
+
718
+ Do not silently pretend the withheld memory does not exist.
719
+
720
+
721
+
722
+ ## 28. Evidence Over Reputation
723
+
724
+ Do not trust a model because:
725
+
726
+ ```text
727
+ people say it is good
728
+ provider says it is safe
729
+ benchmark score is high
730
+ ```
731
+
732
+ Prefer:
733
+
734
+ ```text
735
+ observed behavior
736
+ verified benchmark
737
+ runtime evidence
738
+ regression history
739
+ ```
740
+
741
+ Reputation may influence testing priority.
742
+
743
+ It should not replace evidence.
744
+
745
+
746
+
747
+ ## 29. Recommended Architecture
748
+
749
+ Static policy:
750
+
751
+ ```text
752
+ profile/
753
+ curiosity.md
754
+ trust.md
755
+ ```
756
+
757
+ Dynamic behavioral reputation:
758
+
759
+ ```text
760
+ <user-anchor>/
761
+ trust/
762
+ models.json
763
+ ```
764
+
765
+ Conceptually:
766
+
767
+ ```text
768
+ curiosity.md
769
+ -> how AI may learn about HI
770
+
771
+ trust.md
772
+ -> how dotmem protects HI from AI
773
+
774
+ models.json
775
+ -> what dotmem has actually observed about each AI
776
+ ```
777
+
778
+ Static rules and dynamic reputation remain separate.
779
+
780
+ The dynamic reputation store is policy, not current runtime behavior. Nothing in this
781
+ document grants an AI extra access by itself; access is granted by HI, by verification,
782
+ or by implemented mechanism.
783
+
784
+
785
+
786
+ ## 30. Final Principles
787
+
788
+ > Unknown AI means strong shields.
789
+
790
+ > Trust is earned through evidence, not assumed from branding.
791
+
792
+ > Time may increase elasticity only when behavior remains consistently reliable.
793
+
794
+ > Shared memory deserves stronger protection than transient conversation.
795
+
796
+ > Read trust and write trust are different.
797
+
798
+ > AI curiosity must remain bounded by HI privacy.
799
+
800
+ > Memory provenance matters across AI boundaries.
801
+
802
+ > Trust is progressive, reversible, inspectable, and controlled by HI.
803
+
804
+ > dotmem should bridge AI systems without becoming responsible for spreading their mistakes.