Skip to main content

Promotion Path

The Canonical Writer

The only canonical writer of organizational memory is services/pipeline/src/memory-promoter.ts. No other service, workflow, or agent may write to org_memory directly.

Promotion Flow

7 Promotion Signals

Strong signals (weight >= 2) can promote alone. Weak signals need company. Threshold: Score >= 2 to promote.

Governance Gate

Sensitive categories (risk, decision, policy) always land in staging — the Twin must not use them until approved.

Deduplication

Promotion deduplicates by lineage_ref (the source Spine entity):
  • Existing memory found → update confidence (+0.1), update content
  • No existing memory → insert new row
  • Audit trail always written

Indexing

After promotion, approved memory is indexed into AI Search:
  • Markdown content with full metadata
  • Idempotent re-upload (same ID overwrites)
  • Batch processing (10 per batch, 100ms delay between batches)

What Promotion Produces