singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
singularity-forge/docs/adr
History
Mikael Hugo f192dbfca0 docs: add ADR-076 for UOK memory integration decisions 
Document the three-phase integration of SF memory system with UOK:

Phase 1: Unit outcome recording (recordUnitOutcomeInMemory)
- Records success/failure patterns with 0.9/0.5 confidence
- Fire-and-forget async, never blocks execution

Phase 2: Dispatch ranking enhancement (enhanceUnitRankingWithMemory)
- Queries memory for similar patterns
- Boosts matching candidates by up to 15% (conservative limit)
- Deterministic embeddings ensure reproducible ranking

Phase 3: Gate context enrichment (enrichGateResultWithMemory)
- Diagnostic only; never changes gate pass/fail logic
- Helps operators understand recurring issues

All memory operations gracefully degrade if DB unavailable.
56 test cases validate integration across all phases.

Relates to ADR-0075 (UOK gates), ADR-008 (SF tools).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-05-07 02:05:01 +02:00
..
0000-purpose-to-software-compiler.md docs: align sf purpose doctrine and docs 2026-05-06 00:38:36 +02:00
0001-promote-only-sf-state.md fix: version sf extension runtime sources 2026-05-04 23:27:20 +02:00
0002-sf-schedule-pull-based.md fix: harden sf autonomous runtime 2026-05-06 06:02:46 +02:00
0075-uok-gate-architecture.md sf snapshot: uncommitted changes after 61m inactivity 2026-05-06 10:04:20 +02:00
0076-uok-memory-integration.md docs: add ADR-076 for UOK memory integration decisions 2026-05-07 02:05:01 +02:00
README.md docs: align sf purpose doctrine and docs 2026-05-06 00:38:36 +02:00

README.md

docs/adr/

Accepted architecture decision records (ADRs).

Start with ADR-0000: SF Is a Purpose-to-Software Compiler. It is the foundational product/architecture decision; later ADRs refine pieces of that contract.

What belongs here

  • Final, accepted architectural decisions that affect the project.
  • Decisions that have been promoted from .sf/DECISIONS.md.

What does NOT belong here

  • Draft decisions still under discussion.
  • Implementation plans (use docs/plans/).
  • Specifications (use docs/specs/).

Naming convention

0001-<slug>.md — zero-padded four digits, auto-numbered by sf plan promote --to docs/adr. 0000-* is reserved for foundational doctrine that later ADRs depend on.

See also