@private.me/xcontinuity 2.1.0

package/AGENTS.md

@@ -0,0 +1,123 @@
+# AI Agent Context -- @private.me/xcontinuity v2.1.0
+
+This file provides guidance for AI coding assistants working on the @private.me/xcontinuity package.
+
+## Package Purpose
+
+Cryptographic state continuity substrate for AI agents. Enables agents to persist, restore, and incrementally update state across sessions using XorIDA threshold sharing. The novel contribution is **Reverse-XorIDA**: exploiting XorIDA's linearity over GF(2) to perform incremental state updates at O(delta) cost instead of re-splitting entire state.
+
+## Standard Pattern
+
+```typescript
+import {
+  SessionManager,
+  MemoryStateStore,
+} from '@private.me/xcontinuity';
+
+// Create a session
+const store = new MemoryStateStore();
+const session = await SessionManager.create({
+  agentId: 'agent-001',
+  store,
+});
+
+// Update and snapshot state
+session.updateState({ key: 'value', counter: 42 });
+const snap = await session.snapshot('checkpoint-1');
+
+// Restore later
+const restored = await session.restore(snap.value.stateId);
+```
+
+## Core Concepts
+
+1. **AgentState** — Flat key-value map (`Record<string, StateValue>`)
+2. **StateSnapshot** — Serialized state with SHA-256 checksum
+3. **SplitState** — XorIDA threshold shares of a snapshot
+4. **Reverse-XorIDA** — Incremental share update via GF(2) XOR of deltas
+5. **Chronicle** — Ordered state history with contradiction detection
+6. **SessionManager** — Stateful controller combining all layers
+7. **TrustStore** (v2.0.0) — Trust-annotated entries with provenance, tiers, and events
+8. **Provenance** (v2.0.0) — Ed25519 signed entries with hash chain linking
+9. **Trust Tiers** (v2.0.0) — ratified/inherited/quarantined with TTL decay
+10. **MissionGuard** (v2.0.0) — Human-anchored constraint evaluation
+11. **EnforcementLoop** (v2.0.0) — Reject/rewrite/escalate with violation tracking
+12. **Adjudicator** (v2.0.0) — Deterministic conflict resolution (policy or consensus)
+
+## Trust Substrate Pattern (v2.0.0)
+
+```typescript
+import {
+  SessionManager, MemoryStateStore, TrustStore,
+  MissionAuthority, MissionGuard, EnforcementLoop,
+} from '@private.me/xcontinuity';
+
+const trustStore = new TrustStore({ defaultMaxAge: 7 * 24 * 60 * 60 * 1000 });
+const authority = new MissionAuthority();
+const guard = new MissionGuard(authority);
+const enforcement = new EnforcementLoop(guard);
+
+const session = SessionManager.create({
+  agentId: 'agent-001',
+  store: new MemoryStateStore(),
+  trustStore,
+  missionGuard: guard,
+  enforcementLoop: enforcement,
+});
+
+// Writes now go through trust substrate
+session.updateState({ key: 'value' });
+```
+
+## Anti-Patterns
+
+### Don't skip Result checking
+```typescript
+// WRONG
+const result = await session.snapshot();
+console.log(result.value); // Crashes if !result.ok
+
+// RIGHT
+const result = await session.snapshot();
+if (!result.ok) { handleError(result.error); return; }
+console.log(result.value);
+```
+
+### Don't mutate state directly
+```typescript
+// WRONG
+session.currentState.key = 'new'; // No effect
+
+// RIGHT
+session.updateState({ key: 'new' });
+```
+
+### Don't operate on closed sessions
+```typescript
+// WRONG
+session.close();
+await session.snapshot(); // Returns error Result
+
+// RIGHT
+const snap = await session.snapshot(); // Before close
+session.close();
+```
+
+## Testing
+
+```bash
+pnpm --filter @private.me/xcontinuity test
+```
+
+## Purchase & Pricing
+
+- Free tier: 100K operations per month free (no credit card required)
+- Pro Tier: unlimited operations via subscription
+- Subscribe to xcontinuity: `/subscribe?product=xcontinuity`
+- See [pricing](../../docs/pricing-reference.md) for current rates
+- Error structure follows structured error format with `ContinuityError` codes
+
+## Resources
+
+- README: ./README.md
+- Tests: `pnpm --filter @private.me/xcontinuity test`

package/LICENSE.md

@@ -0,0 +1,26 @@
+# License
+
+**Copyright © 2024-2026 Standard Clouds, Inc. All rights reserved.**
+
+This software is proprietary and confidential. Unauthorized copying, distribution, or use of this software, via any medium, is strictly prohibited.
+
+**Licensed under:** Proprietary
+**Company:** Standard Clouds, Inc. dba PRIVATE.ME
+**Registry:** Private npm registry
+
+For licensing inquiries: contact@private.me
+
+## Export Control Notice
+
+This software contains encryption technology that may be subject to U.S. export control laws (EAR 15 CFR 730-774). By downloading or using this software, you agree to comply with all applicable export laws and regulations. Export or re-export to embargoed countries or sanctioned entities is prohibited.
+
+## Additional Terms
+
+By using this software, you also agree to:
+
+- **Terms of Service**: https://private.me/terms
+- **Privacy Policy**: https://private.me/privacy
+
+## Third-Party Dependencies
+
+This package includes or depends upon open-source software that is subject to separate license terms. See the package.json file for a list of dependencies and their respective licenses.

package/MIGRATING.md

@@ -0,0 +1,77 @@
+# Migrating to @private.me/xcontinuity v2.1.0
+
+## v1.x → v2.0.0
+
+### Breaking Changes
+
+None — v2.0.0 is fully backward compatible with v1.x. All existing APIs continue to work unchanged.
+
+### New Features (opt-in)
+
+**Trust Substrate** — 6-layer trust-annotated state management:
+
+```typescript
+import {
+  SessionManager, MemoryStateStore, TrustStore,
+  MissionAuthority, MissionGuard, EnforcementLoop,
+} from '@private.me/xcontinuity';
+
+// v1.x code continues to work as-is:
+const session = SessionManager.create({ agentId: 'agent-1', store: new MemoryStateStore() });
+
+// v2.0.0 adds optional trust integration:
+const trustStore = new TrustStore({ defaultMaxAge: 30 * 24 * 60 * 60 * 1000 });
+const session2 = SessionManager.create({
+  agentId: 'agent-1',
+  store: new MemoryStateStore(),
+  trustStore,  // opt-in
+});
+```
+
+**New modules (all optional):**
+- Provenance (Ed25519 signed entries)
+- Trust Tiers (ratified/inherited/quarantined)
+- Adjudicator (PolicyAdjudicator, ConsensusAdjudicator)
+- TrustStore (ratification, hypothesis mode)
+- Mission & Enforcement (human-anchored goals)
+- 7 algebraic extensions (undoDelta, branchState, etc.)
+
+### VERSION constant
+
+```typescript
+import { VERSION } from '@private.me/xcontinuity';
+// v1.x: '1.0.0'
+// v2.0.0: '2.0.0'
+```
+
+## v2.0.0 → v2.1.0
+
+### Breaking Changes
+
+None — v2.1.0 is fully backward compatible with v2.0.0.
+
+### New Features (opt-in)
+
+**Cascade / Sub-Agent Architecture** — parent-child session hierarchies:
+
+```typescript
+import { CascadeSession, SubAgentCoordinator } from '@private.me/xcontinuity';
+
+const root = new CascadeSession(rootSession, trustStore);
+const child = root.spawnChild('analyst', new MemoryStateStore(), {
+  propagation: 'inherit',
+  maxChildTier: 'inherited',
+});
+```
+
+**New exports:**
+- `CascadeSession` — parent-child session wrapper
+- `SubAgentCoordinator` — multi-agent lifecycle management
+- `DEFAULT_CASCADE_POLICY` — default cascade configuration
+- `DEFAULT_COORDINATOR_CONFIG` — default coordinator configuration
+
+### Sub-path import
+
+```typescript
+import { CascadeSession } from '@private.me/xcontinuity/cascade';
+```