feat(l10): autonomous idle frontier-contemplation — the always-on life learns on its own (#758)
* feat(l10): autonomous idle frontier-contemplation — the always-on life learns on its own Frontier survey move #2, path (c): give the always-on idle life a stream of experience via SYMBOLIC intake (not the afferent→field seam, which is deferred pending a commensurability ruling — docs/analysis/afferent-field-ingest-scope-2026-06-15.md). The idle heartbeat converges (idle_tick drains a finite backlog + saturates is-a closure, then does nothing forever); this makes it autonomously MINE its frontier with no user turn. Reuse-heavy (the mechanism largely existed): a gated idle pass wires ADR-0080 contemplation into the always-on loop. - core/config.py: contemplate_frontier_during_idle (default off → no behavior change). - chat/runtime.py: idle_tick pass 2b — when on, runs core.contemplation.run_contemplation() (mines the checked-in frontier-compare reports) and persists a reviewable ContemplationRun to <engine_state>/contemplation_runs/idle_<substrate_hash>.json. IDEMPOTENT per frontier (an already-mined frontier is not re-persisted → the life converges, no churn) and MEMOIZED per session (the static frontier is mined once, not re-read every beat). SPECULATIVE-only (ADR-0080: ContemplationFinding.__post_init__ RAISES if not SPECULATIVE → wrong=0 by construction; never ratified here — the HITL path is untouched). IdleTickResult gains frontier_findings. - chat/always_on.py: run_continuous did_work + HeartbeatRecord count frontier work, so the heartbeat/soak convergence (H3) stays honest. - core/cli.py: `core always-on --contemplate-frontier` (explicit learning-daemon mode) + honest per-beat log ("+N findings"). Adversarial 3-lens review (wrong=0/convergence, determinism/trust-boundary, test-vacuity) found 7; fixed the real ones: the MEDIUM torn-write (write_contemplation_run is now atomic temp+os.replace — the indefinite-uptime daemon expects SIGKILL mid-write, and the skip-guard would never repair a torn canonical file), the gitignore breadth (contemplation_runs/ at any engine-state root), the 64-bit filename truncation (full substrate_hash), and the re-mine-every-beat cost (session memoization). Deferred + documented: the shared contemplation miner embeds absolute report paths in finding CONTENT — a portability wrinkle that does NOT affect wrong=0/convergence/soak determinism (those key on the content-only substrate_hash) and touches shared code + its test surface; a follow-up. Tests (non-vacuous): 7 — off-by-default (no behavior change), mines-when-enabled, findings-SPECULATIVE (wrong=0), converges-idempotent, heartbeat-mines-then-converges, mines-once-per-session (memoization), atomic-no-orphan. 55 idle/contemplation/always-on + 96 invariants/contemplation + 28 smoke green; `core always-on --contemplate-frontier` mines end-to-end. engine_state contemplation_runs are per-life runtime state (gitignored). * fix(l10): isolate idle frontier pass + persist frontier_findings (#758) Three review blockers on the autonomous idle frontier-contemplation pass: 1. Daemon isolation. idle_tick's pass 2b called run_contemplation / write_contemplation_run bare inside the always-on loop (run_continuous wraps idle_tick in nothing but an exit-checkpoint finally), so a malformed frontier report or a transient FS fault would propagate out and KILL the continuous life. Wrap the optional pass best-effort (the exit-checkpoint boundary idiom): degrade to 0 findings + RuntimeWarning, leave did_work untouched, let a later beat retry. 2. Durable did_work explanation. HeartbeatRecord carried frontier_findings but serialize_report omitted it and AlwaysOnReport had no run total, so lived_life.json could show did_work=true with facts=0/proposals=0 and no persisted cause. Persist frontier_findings per-record + total_frontier_findings. 3. Honest HITL claim. The docstring/CLI/config said findings are "reviewable via the HITL path", but the existing HITL queue + workbench reader scan <repo>/contemplation/runs while the pass writes <engine_state>/contemplation_runs/. Narrow the claim to "persisted reviewable artifact, not yet in the HITL queue" (wiring that discovery is a follow-up). Tests: 4 new non-vacuous regressions (mining-failure degrade, write-failure degrade, always-on loop survives frontier failure, lived_life persists frontier_findings) — all fail against the unpatched pass. 38 L10/always-on/ workbench tests green.
This commit is contained in:
parent
ee970d8306
commit
efd280d45f
8 changed files with 386 additions and 6 deletions
2
.gitignore
vendored
2
.gitignore
vendored
|
|
@ -61,6 +61,8 @@ engine_state/recognizers.jsonl
|
|||
engine_state/discovery_candidates.jsonl
|
||||
engine_state/lived_life.json
|
||||
engine_state/always_on.lock
|
||||
# per-life idle frontier-contemplation runs — any engine-state root (incl. CORE_ENGINE_STATE_DIR).
|
||||
contemplation_runs/
|
||||
|
||||
# Private outreach / personal packet — never tracked
|
||||
01_Anthropic/
|
||||
|
|
|
|||
|
|
@ -89,6 +89,7 @@ class HeartbeatRecord:
|
|||
proposals_created: int # reviewable proposals emitted this beat (proposal-only)
|
||||
pending_proposals: int
|
||||
did_work: bool
|
||||
frontier_findings: int = 0 # ADR-0080 SPECULATIVE findings mined this beat (0 unless enabled)
|
||||
|
||||
|
||||
@dataclass(frozen=True, slots=True)
|
||||
|
|
@ -111,6 +112,7 @@ class AlwaysOnReport:
|
|||
final_checkpoint_ok: bool
|
||||
total_facts_consolidated: int
|
||||
total_proposals_created: int
|
||||
total_frontier_findings: int = 0 # ADR-0080 SPECULATIVE findings mined across the run
|
||||
# The identity-determining pack ids of the run's config, so a reader can recompute the
|
||||
# SAME identity (the resume verdict) instead of assuming default packs. Empty = default.
|
||||
identity_pack_ids: dict[str, str] = field(default_factory=dict)
|
||||
|
|
@ -133,6 +135,7 @@ def serialize_report(report: AlwaysOnReport) -> dict[str, Any]:
|
|||
"final_checkpoint_ok": report.final_checkpoint_ok,
|
||||
"total_facts_consolidated": report.total_facts_consolidated,
|
||||
"total_proposals_created": report.total_proposals_created,
|
||||
"total_frontier_findings": report.total_frontier_findings,
|
||||
"identity_pack_ids": dict(report.identity_pack_ids),
|
||||
"records": [
|
||||
{
|
||||
|
|
@ -143,6 +146,9 @@ def serialize_report(report: AlwaysOnReport) -> dict[str, Any]:
|
|||
"proposals_created": r.proposals_created,
|
||||
"pending_proposals": r.pending_proposals,
|
||||
"did_work": r.did_work,
|
||||
# Durable explanation of did_work when the beat's only work was a frontier
|
||||
# mine (facts/proposals both 0) — else did_work has no persisted cause.
|
||||
"frontier_findings": r.frontier_findings,
|
||||
}
|
||||
for r in report.records
|
||||
],
|
||||
|
|
@ -227,6 +233,7 @@ def run_continuous(
|
|||
result.facts_consolidated > 0
|
||||
or result.proposals_created > 0
|
||||
or result.candidates_contemplated > 0
|
||||
or getattr(result, "frontier_findings", 0) > 0
|
||||
)
|
||||
record = HeartbeatRecord(
|
||||
tick=tick,
|
||||
|
|
@ -236,6 +243,7 @@ def run_continuous(
|
|||
proposals_created=result.proposals_created,
|
||||
pending_proposals=result.pending_proposals,
|
||||
did_work=did_work,
|
||||
frontier_findings=getattr(result, "frontier_findings", 0),
|
||||
)
|
||||
records.append(record)
|
||||
if on_heartbeat is not None:
|
||||
|
|
@ -265,6 +273,7 @@ def run_continuous(
|
|||
final_checkpoint_ok=final_checkpoint_ok,
|
||||
total_facts_consolidated=sum(r.facts_consolidated for r in records),
|
||||
total_proposals_created=sum(r.proposals_created for r in records),
|
||||
total_frontier_findings=sum(r.frontier_findings for r in records),
|
||||
identity_pack_ids=identity_pack_ids,
|
||||
)
|
||||
if report_path is not None:
|
||||
|
|
|
|||
|
|
@ -546,6 +546,13 @@ class IdleTickResult:
|
|||
#: Step D — derived facts consolidated into the held self this tick (0 unless
|
||||
#: ``config.consolidate_determinations`` and the closure had a new layer to add).
|
||||
facts_consolidated: int = 0
|
||||
#: ADR-0080 — SPECULATIVE frontier findings autonomously mined + persisted this tick
|
||||
#: (0 unless ``config.contemplate_frontier_during_idle`` AND a NOT-yet-mined frontier;
|
||||
#: a mined frontier converges to 0). Persisted as a reviewable artifact under
|
||||
#: ``<engine_state>/contemplation_runs/`` for later review tooling — NOT yet surfaced in
|
||||
#: the existing HITL queue / workbench contemplation reader (those scan
|
||||
#: ``<repo>/contemplation/runs``; wiring that discovery is a follow-up). Never ratified here.
|
||||
frontier_findings: int = 0
|
||||
#: IT — read-only proposal-review summary (None unless ``config.review_pending_proposals``).
|
||||
#: Surfaces pending comprehension-failure proposals for review; mutates nothing.
|
||||
proposal_review: ProposalReviewIdleSummary | None = None
|
||||
|
|
@ -718,6 +725,10 @@ class ChatRuntime:
|
|||
None if no_load_state else EngineStateStore(engine_state_path)
|
||||
)
|
||||
self._recognizer_registry: RecognizerRegistry = RecognizerRegistry()
|
||||
# Memoized frontier mine (ADR-0080 idle pass): the frontier reports are static within
|
||||
# a session, so a converged life mines once instead of re-reading every idle beat. A
|
||||
# reboot re-mines (a fresh runtime), picking up any frontier change across downtime.
|
||||
self._frontier_run_cache: Any = None
|
||||
self._turn_count: int = 0
|
||||
self._pending_candidates: list[DiscoveryCandidate] = []
|
||||
self._pending_recognizer_examples: list[
|
||||
|
|
@ -925,6 +936,54 @@ class ChatRuntime:
|
|||
facts_consolidated = consolidate_once(self._context).consolidated
|
||||
did_work = True
|
||||
|
||||
# 2b. Frontier-contemplation pass (ADR-0080 into the idle loop) — autonomously MINE
|
||||
# the frontier-compare reports into persisted SPECULATIVE reviewable findings, so
|
||||
# the always-on life proposes its OWN frontier with no user turn. Idempotent per
|
||||
# frontier (an already-mined frontier is NOT re-persisted → the life converges, no
|
||||
# churn); SPECULATIVE-only (ADR-0080: never COHERENT/ratified → the HITL path is
|
||||
# untouched). Persists per-life under the engine-state dir.
|
||||
#
|
||||
# This is an OPTIONAL background pass on an indefinite-uptime life: a malformed
|
||||
# frontier report (parse error) or a transient filesystem fault must DEGRADE to
|
||||
# "no findings this beat", never crash the continuous loop. So the whole pass is
|
||||
# best-effort (the exit-checkpoint boundary idiom) — on failure it warns, leaves
|
||||
# did_work untouched, and a later beat retries (the run-cache stays unset on a
|
||||
# mining failure; a write failure simply re-attempts while the target is absent).
|
||||
frontier_findings = 0
|
||||
if (
|
||||
self.config.contemplate_frontier_during_idle
|
||||
and self._engine_state_store is not None
|
||||
):
|
||||
try:
|
||||
from core.contemplation.runner import (
|
||||
run_contemplation,
|
||||
write_contemplation_run,
|
||||
)
|
||||
|
||||
# Mine once per session (the frontier is static within a run); a reboot re-mines.
|
||||
if self._frontier_run_cache is None:
|
||||
self._frontier_run_cache = run_contemplation()
|
||||
run = self._frontier_run_cache
|
||||
target = (
|
||||
self._engine_state_store.path
|
||||
/ "contemplation_runs"
|
||||
/ f"idle_{run.substrate_hash}.json"
|
||||
)
|
||||
if run.findings and not target.exists():
|
||||
write_contemplation_run(run, target)
|
||||
frontier_findings = len(run.findings)
|
||||
did_work = True
|
||||
except Exception as exc: # noqa: BLE001 — optional idle pass is best-effort
|
||||
# An optional frontier mine must never crash the always-on life. Degrade to
|
||||
# "no findings this beat" and surface the cause; the loop, its closure
|
||||
# evidence, and the rest of idle_tick continue uninterrupted.
|
||||
warnings.warn(
|
||||
"idle frontier-contemplation pass skipped "
|
||||
f"(degraded to 0 findings): {exc!r}",
|
||||
RuntimeWarning,
|
||||
stacklevel=2,
|
||||
)
|
||||
|
||||
# 3. Proposal-review sub-pass (IT) — READ-ONLY. Surfaces pending comprehension-failure
|
||||
# proposals (the contemplation pass's N5 artifacts) for review. It NEVER mutates an
|
||||
# artifact, NEVER sets ``did_work`` (no state change → no checkpoint), NEVER ratifies
|
||||
|
|
@ -950,6 +1009,7 @@ class ChatRuntime:
|
|||
proposals_created=created,
|
||||
pending_proposals=self._count_pending_proposals(),
|
||||
facts_consolidated=facts_consolidated,
|
||||
frontier_findings=frontier_findings,
|
||||
proposal_review=proposal_review,
|
||||
)
|
||||
|
||||
|
|
|
|||
26
core/cli.py
26
core/cli.py
|
|
@ -353,9 +353,11 @@ def cmd_always_on(args: argparse.Namespace) -> int:
|
|||
return
|
||||
vc = "—" if record.versor_condition is None else f"{record.versor_condition:.2e}"
|
||||
if record.did_work:
|
||||
findings = getattr(record, "frontier_findings", 0)
|
||||
findings_part = f" +{findings} findings" if findings else ""
|
||||
print(
|
||||
f"[beat {record.tick}] learned +{record.facts_consolidated} facts "
|
||||
f"+{record.proposals_created} proposals · closure {vc}",
|
||||
f"+{record.proposals_created} proposals{findings_part} · closure {vc}",
|
||||
file=sys.stderr,
|
||||
)
|
||||
elif record.tick % _ALWAYS_ON_ALIVE_EVERY == 0:
|
||||
|
|
@ -369,9 +371,18 @@ def cmd_always_on(args: argparse.Namespace) -> int:
|
|||
f"core always-on: continuous-life heartbeat · interval {interval}s · {bound}",
|
||||
file=sys.stderr,
|
||||
)
|
||||
daemon_config = _runtime_config_from_args(args)
|
||||
if getattr(args, "contemplate_frontier", False):
|
||||
import dataclasses
|
||||
|
||||
# A learning daemon: autonomously mine the frontier into persisted SPECULATIVE
|
||||
# findings each idle beat (ADR-0080). Opt-in — the default daemon stays idle.
|
||||
daemon_config = dataclasses.replace(
|
||||
daemon_config, contemplate_frontier_during_idle=True
|
||||
)
|
||||
try:
|
||||
result = run_daemon(
|
||||
config=_runtime_config_from_args(args),
|
||||
config=daemon_config,
|
||||
interval=interval,
|
||||
max_beats=max_beats,
|
||||
no_load_state=bool(getattr(args, "no_load_state", False)),
|
||||
|
|
@ -4260,6 +4271,17 @@ def build_parser() -> argparse.ArgumentParser:
|
|||
default=False,
|
||||
help="suppress per-beat logging; print only the final summary",
|
||||
)
|
||||
always_on.add_argument(
|
||||
"--contemplate-frontier",
|
||||
action="store_true",
|
||||
default=False,
|
||||
dest="contemplate_frontier",
|
||||
help=(
|
||||
"learning daemon: autonomously mine the frontier into persisted SPECULATIVE "
|
||||
"findings under <engine_state>/contemplation_runs/ each idle beat (ADR-0080; "
|
||||
"never ratified — reviewable artifact, not yet in the HITL queue). Default off."
|
||||
),
|
||||
)
|
||||
always_on.set_defaults(func=cmd_always_on)
|
||||
|
||||
test = subparsers.add_parser("test", help="run pytest with curated suite aliases or direct passthrough")
|
||||
|
|
|
|||
|
|
@ -323,6 +323,16 @@ class RuntimeConfig:
|
|||
# OFF by default — idle ticks don't pay for the scan unless a deployment wants the surface.
|
||||
review_pending_proposals: bool = False
|
||||
|
||||
# Autonomous frontier contemplation (ADR-0080 into the idle loop) — when on, idle_tick
|
||||
# autonomously MINES its frontier-compare reports into persisted SPECULATIVE reviewable
|
||||
# findings (core.contemplation), so the always-on life proposes its own frontier without
|
||||
# a user turn. Idempotent per frontier (a mined frontier converges → no churn); the
|
||||
# findings are SPECULATIVE-only (ADR-0080: never COHERENT, never self-ratify), persisted
|
||||
# under <engine_state>/contemplation_runs/ as a reviewable artifact for later review
|
||||
# tooling — NOT yet surfaced in the existing HITL queue (a follow-up). OFF by default —
|
||||
# a deliberate learning-daemon mode.
|
||||
contemplate_frontier_during_idle: bool = False
|
||||
|
||||
# Step E (ESTIMATION) — when on, a converse query the engine would otherwise REFUSE
|
||||
# (told p(a,b), asked p(b,a)) may be answered with a DISCLOSED [approximate] estimate
|
||||
# IF the predicate-class has earned the SERVE license on the ratified, committed
|
||||
|
|
|
|||
|
|
@ -2,6 +2,7 @@ from __future__ import annotations
|
|||
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
from typing import Iterable
|
||||
|
||||
|
|
@ -177,12 +178,16 @@ def contemplate_contradiction_reports(
|
|||
|
||||
|
||||
def write_contemplation_run(run: ContemplationRun, path: str | Path) -> None:
|
||||
# Atomic write (temp + os.replace): the always-on life is an indefinite-uptime process
|
||||
# where a SIGKILL/crash mid-write is expected, and the idle-pass skip-guard would NEVER
|
||||
# repair a torn canonical file. A crash leaves only the orphan .tmp; the canonical path
|
||||
# is either absent (re-mined next boot) or complete — never a half-written artifact.
|
||||
target = Path(path)
|
||||
target.parent.mkdir(parents=True, exist_ok=True)
|
||||
target.write_text(
|
||||
json.dumps(run.as_dict(), ensure_ascii=False, indent=2, sort_keys=True) + "\n",
|
||||
encoding="utf-8",
|
||||
)
|
||||
payload = json.dumps(run.as_dict(), ensure_ascii=False, indent=2, sort_keys=True) + "\n"
|
||||
tmp = target.with_name(f".{target.name}.{os.getpid()}.tmp")
|
||||
tmp.write_text(payload, encoding="utf-8")
|
||||
os.replace(tmp, target)
|
||||
|
||||
|
||||
__all__ = [
|
||||
|
|
|
|||
100
docs/analysis/afferent-field-ingest-scope-2026-06-15.md
Normal file
100
docs/analysis/afferent-field-ingest-scope-2026-06-15.md
Normal file
|
|
@ -0,0 +1,100 @@
|
|||
# Afferent → Field Ingest Seam — Scope & Decision Brief
|
||||
|
||||
**Status:** scope (decision-gated; field-touching, CLAUDE.md sanctioned-site implication) ·
|
||||
**Context:** frontier survey move #2, after the always-on process (#747/#748/#752) + its
|
||||
long-horizon soak (#757) closed the *idle* lived-spine. This is the proposed next edge:
|
||||
give the always-on life a **stream of experience** by folding compiled afferent
|
||||
observations into the live cognitive field.
|
||||
|
||||
## The gap it would close
|
||||
|
||||
The always-on heartbeat lives, holds closure, and resumes — but it is a continuously
|
||||
**idling** life: `idle_tick` drains a finite backlog + saturates deductive closure, then
|
||||
does no work forever (proven by the convergence gate H3 in `evals/l10_always_on`). There is
|
||||
**no afferent input channel** into the idle loop. Separately, the sensorium is fully built
|
||||
as a compiler/frame/merge substrate but is **never wired to the field** — ADR-0208's own
|
||||
pipeline arrow (`ObservationFrame → … → field / recall / cognition`) stops at the merge.
|
||||
This seam is the missing edge in `listen → comprehend → … → replay`.
|
||||
|
||||
## What is confirmed (geometric feasibility)
|
||||
|
||||
- **Units carry a field-shaped target.** `CompilationUnitLike` (sensorium/compiler/protocol.py:28)
|
||||
exposes `versor: np.ndarray` — a real CL(4,1) multivector — alongside `versor_condition`.
|
||||
A live `ObservationFrame`'s units therefore expose targets in the field's algebra.
|
||||
- **The sanctioned pull pattern applies directly, closure-preserving BY CONSTRUCTION.** The
|
||||
exemplar is `session/context.py::_session_anchor_pull`:
|
||||
```
|
||||
R = word_transition_rotor(field_state.F, target) # rotor toward target
|
||||
R_step = rotor_power(R, α) # fractional, stays on Spin manifold
|
||||
pulled = versor_apply(R_step, field_state.F) # apply — no post-hoc unitize
|
||||
```
|
||||
It explicitly *replaced* the rejected `_slerp_toward` (which broke closure and needed a
|
||||
forbidden post-hoc `unitize_versor`). An afferent pull toward `unit.versor` is structurally
|
||||
identical → preserves `versor_condition < 1e-6` by construction, adds no normalization site.
|
||||
- **Home:** `session/context.py` (the already-sanctioned site that owns the field), a new
|
||||
opt-in `observe(frame)` that pulls the field toward each unit's versor by a fractional
|
||||
step. Default off → serving + existing behavior byte-unchanged.
|
||||
|
||||
## The load-bearing wrinkle (the decision)
|
||||
|
||||
**Closure-preservation is necessary but NOT sufficient.** The sanctioned anchor-pull moves
|
||||
the field toward a **session concept-attractor** — a target in the *cognitive* semantic
|
||||
frame, carrying meaning ("the field anchors toward the session's concept"). An afferent
|
||||
unit's versor is in the *same algebra* (CL(4,1)) but:
|
||||
|
||||
> **Is the sensorium's CGA embedding semantically COMMENSURABLE with the cognitive field —
|
||||
> or merely same-algebra, different meaning?**
|
||||
|
||||
- If **commensurable**: pulling the field toward `unit.versor` is genuine perception →
|
||||
cognitive state (decoding doctrine: the observation is real, the field moves toward it).
|
||||
The seam is clean and meaningful.
|
||||
- If **not** (same algebra, unrelated embedding): the pull is geometrically valid but
|
||||
**semantically empty** — the field drifts toward an arbitrary point. That is exactly the
|
||||
*degenerate fit* the field-as-standing-hand doctrine forbids ("geometrically-realizable
|
||||
structure only; never force a degenerate fit").
|
||||
|
||||
This question is unestablished in the code: the sensorium compiles units into CL(4,1) but
|
||||
nothing today asserts that embedding shares the cognitive field's semantic frame (they were
|
||||
built as **disjoint** tracks — CLAUDE.md: the afferent arc "is disjoint from the GSM8K
|
||||
serving path"). Wiring afferent → field is the *first* connection of the two.
|
||||
|
||||
## Decisions for ratification (Shay reviews the design)
|
||||
|
||||
1. **Commensurability ruling (the crux).** Is the sensorium CGA embedding intended to be
|
||||
commensurable with the cognitive field? Three honest paths:
|
||||
- **(a) Commensurable by construction** — if the modality packs project into the *same*
|
||||
concept manifold the cognition field uses, the pull is meaningful → build the seam.
|
||||
(Needs: evidence/assertion that the projection shares the frame, e.g. a shared
|
||||
concept-attractor basis, before any pull is wired.)
|
||||
- **(b) Bridge required** — define an explicit, falsifiable map from a unit's versor to a
|
||||
cognitive-field target (a grounded embedding), so the pull is toward a *meant* point.
|
||||
Larger; an ADR + a commensurability gate.
|
||||
- **(c) Not yet** — keep the tracks disjoint; the always-on life stays idle-converging for
|
||||
now; the stream-of-experience comes from a different intake (the autonomous
|
||||
determination-frontier — roadmap Step 5 — which feeds *symbolic* new questions, not
|
||||
afferent versors). Lower geometric risk, advances the telos via comprehension.
|
||||
|
||||
2. **Sanctioned-site clause.** If (a)/(b): extend `session/context.py`'s CLAUDE.md clause to
|
||||
cover afferent-observation pull (closure-preserving by construction AND semantic =
|
||||
perception→field), with the same bright-line justification. A CLAUDE.md amendment.
|
||||
|
||||
3. **ADR.** Completing ADR-0208's arrow (`ObservationFrame → field`) is the first
|
||||
afferent→cognitive-core connection; it likely warrants an ADR (extend 0208 or new),
|
||||
given the tracks were deliberately disjoint.
|
||||
|
||||
4. **Falsifiable gate (regardless of path).** Any pull that "preserves closure" is only
|
||||
proven if a test fails when it doesn't: a soak guard (sibling to `evals/l10_always_on`)
|
||||
asserting (i) `versor_condition < 1e-6` every observed beat, (ii) the same frame sequence
|
||||
→ byte-identical field digest (determinism), (iii) a *commensurability* assertion — the
|
||||
field moves **toward** the observation (`dist(F, target)` decreases), not arbitrarily.
|
||||
|
||||
## Recommendation
|
||||
|
||||
The geometry is clean; the **semantics are the gate**. Recommend **ruling on decision 1
|
||||
first** — do not wire a field pull until the commensurability question is answered, or the
|
||||
seam risks a closure-valid-but-meaningless fit. If commensurability isn't yet established
|
||||
(likely), the higher-leverage telos move is path **(c)**: the autonomous
|
||||
determination-frontier intake (feed the idle heartbeat *symbolic* new questions it can
|
||||
`determine` + commit wrong=0 / propose HITL) — which needs no field-embedding ruling and
|
||||
directly converts the idle life into a learning one. The afferent→field seam then follows
|
||||
once the embedding frame is established.
|
||||
172
tests/test_idle_frontier_contemplation.py
Normal file
172
tests/test_idle_frontier_contemplation.py
Normal file
|
|
@ -0,0 +1,172 @@
|
|||
"""ADR-0080 idle frontier-contemplation — the always-on life autonomously mines its
|
||||
frontier into reviewable SPECULATIVE findings, with NO user turn.
|
||||
|
||||
Gated (``contemplate_frontier_during_idle``, default off → no behavior change); idempotent
|
||||
per frontier (an already-mined frontier converges → no churn); SPECULATIVE-only (ADR-0080:
|
||||
never COHERENT, never ratified here — the HITL path is untouched).
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import dataclasses
|
||||
import json
|
||||
|
||||
import pytest
|
||||
|
||||
from chat.always_on import run_continuous, serialize_report
|
||||
from chat.runtime import ChatRuntime
|
||||
from core.config import RuntimeConfig
|
||||
|
||||
|
||||
def _runtime(tmp_path, *, frontier: bool) -> ChatRuntime:
|
||||
config = dataclasses.replace(
|
||||
RuntimeConfig(), contemplate_frontier_during_idle=frontier
|
||||
)
|
||||
return ChatRuntime(config=config, engine_state_path=tmp_path / "es")
|
||||
|
||||
|
||||
def _run_files(tmp_path) -> list:
|
||||
d = tmp_path / "es" / "contemplation_runs"
|
||||
return sorted(d.glob("idle_*.json")) if d.exists() else []
|
||||
|
||||
|
||||
def test_idle_frontier_off_by_default(tmp_path) -> None:
|
||||
# Default config (flag off): no mining, no run persisted — behavior unchanged.
|
||||
result = _runtime(tmp_path, frontier=False).idle_tick()
|
||||
assert result.frontier_findings == 0
|
||||
assert _run_files(tmp_path) == []
|
||||
|
||||
|
||||
def test_idle_frontier_mines_when_enabled(tmp_path) -> None:
|
||||
result = _runtime(tmp_path, frontier=True).idle_tick()
|
||||
assert result.frontier_findings >= 1 # autonomously mined a finding, no user turn
|
||||
assert len(_run_files(tmp_path)) == 1 # persisted one reviewable run
|
||||
# Atomic write: a complete artifact, no orphan temp left at the canonical path.
|
||||
runs_dir = tmp_path / "es" / "contemplation_runs"
|
||||
assert not list(runs_dir.glob(".*.tmp"))
|
||||
json.loads(_run_files(tmp_path)[0].read_text(encoding="utf-8")) # valid (not torn)
|
||||
|
||||
|
||||
def test_idle_frontier_mines_once_per_session(tmp_path, monkeypatch) -> None:
|
||||
# A converged life must not re-read/parse/hash the frontier every beat (indefinite
|
||||
# uptime): the static frontier is mined ONCE per session and memoized.
|
||||
import core.contemplation.runner as runner_mod
|
||||
|
||||
real = runner_mod.run_contemplation
|
||||
calls = {"n": 0}
|
||||
|
||||
def _spy():
|
||||
calls["n"] += 1
|
||||
return real()
|
||||
|
||||
monkeypatch.setattr(runner_mod, "run_contemplation", _spy)
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
rt.idle_tick()
|
||||
rt.idle_tick()
|
||||
rt.idle_tick()
|
||||
assert calls["n"] == 1
|
||||
|
||||
|
||||
def test_idle_frontier_findings_are_speculative(tmp_path) -> None:
|
||||
# wrong=0 / ADR-0080: an autonomously-mined finding is SPECULATIVE, never COHERENT.
|
||||
_runtime(tmp_path, frontier=True).idle_tick()
|
||||
run = json.loads(_run_files(tmp_path)[0].read_text(encoding="utf-8"))
|
||||
findings = run["findings"]
|
||||
assert findings
|
||||
assert all(f["epistemic_status"] == "speculative" for f in findings)
|
||||
|
||||
|
||||
def test_idle_frontier_converges_idempotent(tmp_path) -> None:
|
||||
# A mined frontier is not re-mined — the life converges (no churn), the wrong=0 invariant
|
||||
# for a continuous life: an idle beat over an exhausted frontier does no work.
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
first = rt.idle_tick()
|
||||
second = rt.idle_tick()
|
||||
assert first.frontier_findings >= 1
|
||||
assert second.frontier_findings == 0 # already mined this frontier
|
||||
assert len(_run_files(tmp_path)) == 1 # no duplicate run persisted
|
||||
|
||||
|
||||
def test_heartbeat_mines_then_converges(tmp_path) -> None:
|
||||
# The always-on heartbeat over a frontier-contemplating life: beat 0 mines (did_work via
|
||||
# frontier_findings), then the saturated life settles to rest.
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
report = run_continuous(rt, heartbeats=4)
|
||||
assert report.records[0].did_work is True # beat 0 mined the frontier
|
||||
assert report.records[-1].did_work is False # converged to rest
|
||||
assert len(_run_files(tmp_path)) == 1
|
||||
|
||||
|
||||
def test_idle_frontier_pass_degrades_on_mining_failure(tmp_path, monkeypatch) -> None:
|
||||
# The frontier mine is an OPTIONAL pass on an indefinite-uptime life: a failure in
|
||||
# run_contemplation (e.g. a malformed frontier report) must DEGRADE to 0 findings and
|
||||
# warn, NEVER crash idle_tick. A converged continuous life cannot be killed by an
|
||||
# optional background pass.
|
||||
import core.contemplation.runner as runner_mod
|
||||
|
||||
def _boom():
|
||||
raise ValueError("malformed frontier report")
|
||||
|
||||
monkeypatch.setattr(runner_mod, "run_contemplation", _boom)
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
with pytest.warns(RuntimeWarning, match="idle frontier-contemplation pass skipped"):
|
||||
result = rt.idle_tick() # must NOT raise
|
||||
assert result.frontier_findings == 0 # degraded, no findings this beat
|
||||
assert _run_files(tmp_path) == [] # nothing persisted on failure
|
||||
|
||||
|
||||
def test_idle_frontier_pass_degrades_on_write_failure(tmp_path, monkeypatch) -> None:
|
||||
# A transient filesystem fault mid-persist must also degrade, not crash. The run-cache
|
||||
# is mined, but the write fails → 0 findings + warning, loop survives.
|
||||
import core.contemplation.runner as runner_mod
|
||||
|
||||
def _boom(*_args, **_kwargs):
|
||||
raise OSError("disk full")
|
||||
|
||||
monkeypatch.setattr(runner_mod, "write_contemplation_run", _boom)
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
with pytest.warns(RuntimeWarning, match="idle frontier-contemplation pass skipped"):
|
||||
result = rt.idle_tick() # must NOT raise
|
||||
assert result.frontier_findings == 0
|
||||
|
||||
|
||||
def test_always_on_loop_survives_frontier_failure(tmp_path, monkeypatch) -> None:
|
||||
# End-to-end: the always-on heartbeat completes all beats and persists its final
|
||||
# checkpoint even when every frontier mine fails — the continuous life is not killed.
|
||||
import core.contemplation.runner as runner_mod
|
||||
|
||||
monkeypatch.setattr(
|
||||
runner_mod,
|
||||
"run_contemplation",
|
||||
lambda: (_ for _ in ()).throw(ValueError("boom")),
|
||||
)
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
with pytest.warns(RuntimeWarning):
|
||||
report = run_continuous(rt, heartbeats=3)
|
||||
assert report.heartbeats == 3 # ran to completion, no crash
|
||||
assert report.final_checkpoint_ok is True
|
||||
assert report.total_frontier_findings == 0
|
||||
assert all(r.frontier_findings == 0 for r in report.records)
|
||||
|
||||
|
||||
def test_lived_life_persists_frontier_findings(tmp_path) -> None:
|
||||
# did_work must have a durable explanation: when the only work of a beat is a frontier
|
||||
# mine (facts/proposals both 0), the persisted lived-life record must still show the
|
||||
# cause — frontier_findings per-record AND a run total — not an unexplained did_work.
|
||||
rt = _runtime(tmp_path, frontier=True)
|
||||
report_path = tmp_path / "es" / "lived_life.json"
|
||||
report = run_continuous(rt, heartbeats=2, report_path=report_path)
|
||||
|
||||
assert report.total_frontier_findings >= 1
|
||||
beat0 = report.records[0]
|
||||
assert beat0.did_work is True
|
||||
# The mine — not facts/proposals — is what made beat 0 work; the record proves it.
|
||||
assert beat0.facts_consolidated == 0
|
||||
assert beat0.proposals_created == 0
|
||||
assert beat0.frontier_findings >= 1
|
||||
|
||||
persisted = json.loads(report_path.read_text(encoding="utf-8"))
|
||||
assert persisted["total_frontier_findings"] >= 1
|
||||
assert persisted["records"][0]["frontier_findings"] >= 1
|
||||
# serialize_report (the workbench projection) carries the same durable explanation.
|
||||
assert serialize_report(report)["records"][0]["frontier_findings"] >= 1
|
||||
Loading…
Reference in a new issue