Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5b2712f5e6 | ||
|
|
124b77e95b | ||
|
|
1b7995e093 | ||
|
|
fcd835883e | ||
|
|
37ce68eff8 | ||
|
|
2fa0a5f144 | ||
|
|
c3ef29c59d | ||
|
|
f079aa2cc9 | ||
|
|
c03c953a45 | ||
|
|
90ae1c2612 | ||
|
|
cb1b8303fe | ||
|
|
3c54782634 | ||
|
|
478ce45755 | ||
|
|
a96ed90b90 | ||
|
|
713f85a0e3 | ||
|
|
504935828b | ||
|
|
8e78bc936f | ||
|
|
a34762d512 | ||
|
|
772402ed39 | ||
|
|
80a1fd0a2d | ||
|
|
3fb28e2461 | ||
|
|
94ba2c97a3 | ||
|
|
94a4774853 | ||
|
|
efb2c6b9a1 | ||
|
|
99115889d7 | ||
|
|
2a971578e1 | ||
|
|
ec434f2a70 | ||
|
|
d9c50c66c9 | ||
|
|
a382c15562 | ||
|
|
186fdd1410 | ||
|
|
aa9750c59f | ||
|
|
ab114d260b | ||
|
|
b7865a76bb | ||
|
|
04b0f4ac96 | ||
|
|
9b328c9af1 | ||
|
|
bc0f244934 | ||
|
|
29570f404a | ||
|
|
927548e9a0 | ||
|
|
781b286f5b | ||
|
|
d1ccd7ebec | ||
|
|
3adfa1b1ed | ||
|
|
da4eece9e0 | ||
|
|
2e1f0c8cab |
No files matched your search
@@ -1,6 +1,6 @@
|
||||
# Rune
|
||||
|
||||
**Current release: v0.66.71**
|
||||
**Current release: v0.68.0**
|
||||
|
||||
**Rune is a persistent personal agent designed to accumulate experience, develop reusable competence, and remain recognisably the same agent even when its underlying foundation model changes.**
|
||||
|
||||
|
||||
+13
-1
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"_comment": "GENERATED by rune.spine \u2014 compatibility view for legacy umbrella consumers. DO NOT EDIT: structural truth lives in store/spine/current.json; edits here are flagged by spine drift.",
|
||||
"_generated_by_spine": true,
|
||||
"generated_at": "2026-09-15T18:24:01Z",
|
||||
"generated_at": "2026-09-16T03:45:21Z",
|
||||
"umbrellas": {
|
||||
"capability": {
|
||||
"description": "Tool selection and execution authority",
|
||||
@@ -12,6 +12,7 @@
|
||||
"capability_broker",
|
||||
"connection_pool",
|
||||
"evidence_probe",
|
||||
"forge",
|
||||
"forge_client",
|
||||
"intent_continuity",
|
||||
"local_tool_runtime",
|
||||
@@ -216,7 +217,10 @@
|
||||
"attention_capsule",
|
||||
"auto_context",
|
||||
"auto_tasks",
|
||||
"behaviour_ledger",
|
||||
"build_basis",
|
||||
"capability_fit",
|
||||
"capability_ledger",
|
||||
"cognitive_budgeter",
|
||||
"complexity_scorer",
|
||||
"construction_activation",
|
||||
@@ -234,16 +238,24 @@
|
||||
"drift_resume",
|
||||
"event_wait",
|
||||
"failure_recovery",
|
||||
"graph_projection",
|
||||
"impact_preview",
|
||||
"iteration",
|
||||
"layout_contract",
|
||||
"programme_continuation",
|
||||
"project_registry",
|
||||
"release_notes",
|
||||
"salience_gate",
|
||||
"scaffold",
|
||||
"spine",
|
||||
"stage_guards",
|
||||
"structural_migration",
|
||||
"structural_model",
|
||||
"structural_store",
|
||||
"testing_mode",
|
||||
"toolchain",
|
||||
"tui_backlog",
|
||||
"wait_guard",
|
||||
"witness"
|
||||
],
|
||||
"depends_on": [
|
||||
|
||||
@@ -104,15 +104,15 @@
|
||||
},
|
||||
{
|
||||
"path": "src/rune/attention_capsule.py",
|
||||
"role": "AttentionCapsule — the typed ledger of admitted blocks the model receives (to_messages re-derives the runtime payload)",
|
||||
"role": "AttentionCapsule \u2014 the typed ledger of admitted blocks the model receives (to_messages re-derives the runtime payload)",
|
||||
"disposition": "retain-authority",
|
||||
"evidence": "P1-02 (#25): the capsule IS the product the model receives — the broker renders admitted blocks into it, the safety override mutates its user block in place (re-measured), runtime.run consumes capsule.to_messages(), and the trace v4 capsule_messages/capsule_content_hashes prove the logged capsule EXACTLY equals the sent payload. Legacy create_capsule/to_prompt (string-trim fake budgeting) deprecated with no live callers."
|
||||
"evidence": "P1-02 (#25): the capsule IS the product the model receives \u2014 the broker renders admitted blocks into it, the safety override mutates its user block in place (re-measured), runtime.run consumes capsule.to_messages(), and the trace v4 capsule_messages/capsule_content_hashes prove the logged capsule EXACTLY equals the sent payload. Legacy create_capsule/to_prompt (string-trim fake budgeting) deprecated with no live callers."
|
||||
},
|
||||
{
|
||||
"path": "src/rune/inference_trace.py",
|
||||
"role": "Durable per-run inference trace (tokens served/estimated, output, latency, per-block visibility)",
|
||||
"disposition": "migrate-adapter",
|
||||
"evidence": "P0-07 (#23): persists what ContextBroker (#19) assembled and what the transport served — builds FROM the broker trace, never re-measures; store state/inference_traces.jsonl."
|
||||
"evidence": "P0-07 (#23): persists what ContextBroker (#19) assembled and what the transport served \u2014 builds FROM the broker trace, never re-measures; store state/inference_traces.jsonl."
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -160,13 +160,13 @@
|
||||
"path": "src/rune/capability_broker.py",
|
||||
"role": "Authoritative capability selector (select_for_job + verified floor + find_capability escape hatch)",
|
||||
"disposition": "retain-authority",
|
||||
"evidence": "P1-01 (#24): select_for_job is the single selection authority — its ordered decision feeds LocalToolRuntime(tools=) at both construction sites and the _contributor_tools prompt block; degrade-not-crash falls back to full TOOLS with a tier-1 record_failure."
|
||||
"evidence": "P1-01 (#24): select_for_job is the single selection authority \u2014 its ordered decision feeds LocalToolRuntime(tools=) at both construction sites and the _contributor_tools prompt block; degrade-not-crash falls back to full TOOLS with a tier-1 record_failure."
|
||||
},
|
||||
{
|
||||
"path": "memory/index/capability_cards.json",
|
||||
"role": "Capability-card index (rebuilt on empty/stale/corrupt; native cards synthesized from TOOLS metadata)",
|
||||
"disposition": "migrate-adapter",
|
||||
"evidence": "P1-01 (#24): load_cards validates and rebuilds — the packaged empty array no longer passes as an index; cards carry risk/preconditions/side_effects copied from tool_executor.TOOLS."
|
||||
"evidence": "P1-01 (#24): load_cards validates and rebuilds \u2014 the packaged empty array no longer passes as an index; cards carry risk/preconditions/side_effects copied from tool_executor.TOOLS."
|
||||
},
|
||||
{
|
||||
"path": "src/rune/local_tool_runtime.py",
|
||||
@@ -486,12 +486,6 @@
|
||||
"disposition": "retain-authority",
|
||||
"evidence": "Defines the owner-approved canary-first Gitea sequence."
|
||||
},
|
||||
{
|
||||
"path": "src/rune/plugins/build_mode/__init__.py",
|
||||
"role": "Checkpoint/ledger state-machine primitive used by current governed builds",
|
||||
"disposition": "migrate-adapter",
|
||||
"evidence": "Persists checkpoints but encodes an older phase order."
|
||||
},
|
||||
{
|
||||
"path": "src/rune/build_mode.py",
|
||||
"role": "Separate BuildManager and worktree engine",
|
||||
@@ -504,6 +498,9 @@
|
||||
"disposition": "archive-candidate",
|
||||
"evidence": "Reports fixed success strings for phases without executing their claimed effects."
|
||||
}
|
||||
],
|
||||
"notes": [
|
||||
"T17 17U: plugin BuildStateMachine deleted (zero importers; second parallel orchestrator)"
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -540,4 +537,4 @@
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
# Rune Semantic Release Policy (T20 §20B)
|
||||
|
||||
Pre-1.0 convention. Scaffolding "V1" does NOT mean Rune 1.0.
|
||||
|
||||
## Bump kinds
|
||||
|
||||
**PATCH** (0.66.80 → 0.66.81):
|
||||
- bug fix, correction, implementation/internal maintenance
|
||||
- no meaningful new user/system capability
|
||||
|
||||
**MINOR** (0.66.80 → 0.67.0):
|
||||
- meaningful new Rune capability
|
||||
- new subsystem functionality
|
||||
- materially expanded system behaviour
|
||||
- significant new supported workflow
|
||||
|
||||
**MAJOR**: reserved for Rune 1.0+ compatibility/public-contract semantics.
|
||||
|
||||
## How the machinery expresses this (no manual version edits)
|
||||
|
||||
The existing machinery already maps commit shape → bump kind:
|
||||
- `semver_bump.next_version` (PR titles): feat→minor, else patch
|
||||
- `version_convergence.highest_warranted_bump` (push ranges):
|
||||
feat/breaking→minor, fix/perf→patch, else None
|
||||
|
||||
**Tranche-level rule (20B)**: a feature tranche lands its feature
|
||||
commits (`feat(...)`), and the convergence machinery bumps MINOR at
|
||||
the tranche's release boundary. Patch-only follow-ups (fix/perf)
|
||||
warrant only PATCH — the machinery cannot accidentally re-minor
|
||||
because `highest_warranted_bump` takes the max over the *post-
|
||||
boundary* range, and a fix-only range yields "patch".
|
||||
|
||||
## Why T20 → 0.67.0
|
||||
|
||||
T20 is a feature-level tranche (Rune-wide retrofit: structural
|
||||
taxonomy, capability/behaviour ledgers, rune graph, /testing backlog,
|
||||
Spine modernization, semantic release). The release is classified
|
||||
MINOR under this policy, earned through the governed convergence
|
||||
machinery — never a manual version edit.
|
||||
|
||||
## T20 0.67.0 release record
|
||||
T20 classified MINOR under this policy: Rune-wide retrofit (structural
|
||||
taxonomy, capability/behaviour ledgers, rune graph, /testing backlog,
|
||||
Spine modernization, semantic release) = new subsystem functionality +
|
||||
materially expanded system behaviour. Earned through the governed
|
||||
convergence machinery (feat-bearing range → minor), never a manual edit.
|
||||
|
||||
## Root cause record (T20, 2026-09-16)
|
||||
semver_bump re-derived the bump kind from the SYNTHESIZED title text —
|
||||
"minor: converged release" matched nothing → patch. Feature tranches
|
||||
T18/T19/T20 downgraded to 0.66.77-83. Fixed: MINOR_PREFIX_RE carries the
|
||||
convergence kind through; first push after the fix with a feat-bearing
|
||||
range lands 0.67.0 through the normal machinery.
|
||||
@@ -0,0 +1,79 @@
|
||||
# SCAFFOLDING IMPLEMENTATION AUDIT + V1 GAP MATRIX (T18 §18B)
|
||||
|
||||
_Every claim classified against evidence. Scale: LIVE_PROVEN (production
|
||||
evidence) / TEST_PROVEN (suite green, no production exercise) /
|
||||
IMPLEMENTED_UNPROVEN / PARTIAL / PLANNED / ABSENT / LEGACY / DUPLICATE._
|
||||
|
||||
## Kernel claims
|
||||
|
||||
| Claim | Status | Evidence |
|
||||
|---|---|---|
|
||||
| Contract lifecycle + legal transitions | LIVE_PROVEN | 28 contracts driven through real flow; refusal envelopes observed |
|
||||
| classify_mode (one classifier) | LIVE_PROVEN | gates TUI /build (17G), operator hook, tests 62+ |
|
||||
| Conversational intent layer | TEST_PROVEN | 22+ held-outs incl. unseen paraphrases; 17R live exercise (one real conversational proof) |
|
||||
| Programme continuation | LIVE_PROVEN | 17E 4-stage proof on real bridge; restart/dup/failure held-outs |
|
||||
| Event-driven waits (builder) | LIVE_PROVEN | T15 15Q real model build; T17E async stage |
|
||||
| Event-driven waits (CI) | LIVE_PROVEN | T16 16D deadline path ×2 + T17 natural wake (mode=event, 112.5s) |
|
||||
| Event replay (before-registration) | TEST_PROVEN + production-realistic exercise | 17C 4.6s vs real completed CI; natural-cycle confirmation: the 17Z wake arrived mid-wait, replay path itself not yet hit naturally |
|
||||
| Cross-user bridge delivery | LIVE_PROVEN | 17C repro as runner user (2.05s) + production deploys |
|
||||
| Provider boundary | TEST_PROVEN (structural guard) + observed loud-failure | 16F/G suites; no silent fallback observed in production runs |
|
||||
| Builder cannot self-certify | LIVE_PROVEN | T14 closure refusals ×2; phase-gated close |
|
||||
| Completion truth evidence-driven | LIVE_PROVEN | contract checkpoints; verify_test_truth refusals |
|
||||
| Interruption/resume | LIVE_PROVEN | T14E SIGKILL; 17E restart held-outs |
|
||||
| Impact preview (visible, pre-build) | ABSENT → T18 | nothing renders structured impact before build today |
|
||||
| Structural project model (first-class) | PARTIAL | stores are spine-shaped (entities/rels) but projects model CONTRACTS, not architecture; no domain/subsystem/interface nesting for arbitrary projects |
|
||||
| Structural queries/impact closure for projects | PARTIAL | spine.impact_frontier exists for Rune; project stores lack query API |
|
||||
| Research→Build Basis (durable, versioned) | ABSENT → T18 | research output today stays in transient context/artifacts |
|
||||
| Research-depth decision at construction entry | PARTIAL | ADAPT routes task classes; no explicit construction-stage research gate |
|
||||
| OUTWARD prior-art-first pass | PARTIAL | stage exists in Research Core; not strengthened to precedent-first ordering |
|
||||
| Schema versioning + consent-gated migration | PARTIAL | stores carry schema_version=1; no migration machinery/consent flow |
|
||||
| Environment/runtime model | PARTIAL | deployment_surface exists in Spine; project scaffolds don't model envs |
|
||||
| Workspace lifecycle (worktree per contract) | PARTIAL | BuildManager worktrees exist (legacy adapter); not wired to contracts |
|
||||
| Forge abstraction | ABSENT (Gitea-coupled scripts) | deploy/qualify call Gitea API directly |
|
||||
| Structural drift for project scaffolds | PARTIAL | drift_resume (16P) covers checkpoint-vs-reality; no file/entity-level drift detection |
|
||||
| Graph projection for visualisation | ABSENT → T18 | Spine has snapshots; no stable read-only graph projection |
|
||||
| Memory/Substrate | ABSENT (BY DESIGN — out of scope) | rule L |
|
||||
|
||||
## V1 North Star gap matrix (this tranche's targets)
|
||||
|
||||
| North Star capability | Gap | T18 action |
|
||||
|---|---|---|
|
||||
| Research-led construction (early research, Build Basis) | ABSENT Build Basis | 18C: build_basis.py + ADAPT depth hook |
|
||||
| OUTWARD precedent-first | PARTIAL | 18D: strengthen stage contract + real research run |
|
||||
| First-class structural Scaffold | PARTIAL (contract-shaped) | 18E: structural_model.py over structural_store core |
|
||||
| Structure→scope→governance | PARTIAL | 18F: queries + impact closure feeding contracts |
|
||||
| Visible impact preview | ABSENT | 18G: impact_preview projection |
|
||||
| Structural drift | PARTIAL | 18H: extend drift_resume with entity-level checks |
|
||||
| Schema versioning + consent | PARTIAL | 18I: migration + consent flow + tests |
|
||||
| Environment/runtime model | PARTIAL | 18J: env entities + verification distinction |
|
||||
| Workspace lifecycle | PARTIAL (legacy adapter) | 18K: workspace contract on the BuildManager adapter |
|
||||
| Forge boundary | ABSENT | 18L: forge.py adapter interface (Gitea impl) |
|
||||
| Full route convergence | PARTIAL (classify shared; backends differ) | 18M: audit + smallest fix |
|
||||
| Generalisation (not phrase list) | TEST_PROVEN | 18N: adversarial paraphrase families |
|
||||
| Self-scaffold | PARTIAL (contracts only) | 18O: structural model of Scaffolding itself |
|
||||
| Upgrade-via-Scaffold proof | ABSENT | 18P: one real upgrade driven by the scaffold |
|
||||
| Graph projection | ABSENT | 18Q: versioned read-only projection |
|
||||
|
||||
## T19 additions (post-T18 classifications)
|
||||
|
||||
| Capability | Status | Evidence |
|
||||
|---|---|---|
|
||||
| Project/Scaffold Registry | TEST_PROVEN | registry tests; boundaries proven (no truth in index, no Spine leak) |
|
||||
| /build governance fail-closed | LIVE_PROVEN | 19A: T18 degradation paths removed; failure-path held-outs |
|
||||
| Capability Ledgers | TEST_PROVEN | lifecycle+history+packet tests |
|
||||
| Surgical context packets | LIVE_PROVEN | 19R: packet bound exactly 1 file for a real change |
|
||||
| Behaviour/Test Specs + hardening lifecycle | TEST_PROVEN | ledger suites incl. generation history |
|
||||
| Selective invalidation | TEST_PROVEN | 19S-2/5/9/10 held-outs |
|
||||
| Predictive vs descriptive impact | TEST_PROVEN | delta persistence tests |
|
||||
| Post-change obligations | TEST_PROVEN | machine-derived from structural truth |
|
||||
| /testing backend + aggregate | TEST_PROVEN + LIVE (19R) | testing_mode suites; command wired in real TUI |
|
||||
| Observation→closure (user-confirm gate) | TEST_PROVEN | closure requires retest AND user confirm |
|
||||
| Forge failure never rewrites truth | TEST_PROVEN | 19S-14 held-out |
|
||||
| Self-hosted T19 change | LIVE_PROVEN | contract 19r-testing-command, 11-step scaffold-driven flow |
|
||||
|
||||
## Kernel exceptions required (rule B record)
|
||||
|
||||
None yet. Every T18 plan so far EXTENDS (new modules consuming
|
||||
structural_store) rather than modifying frozen kernel behavior. Any
|
||||
exception discovered during implementation will be recorded here with
|
||||
evidence that the V1 requirement could not be met otherwise.
|
||||
@@ -0,0 +1,153 @@
|
||||
# SCAFFOLDING V1 DEFINITION (T18 §18B)
|
||||
|
||||
_Plane-English + technical definition of Scaffolding as it ACTUALLY
|
||||
exists at tranche T18 start (master 29570f4). Companion artifact:
|
||||
SCAFFOLDING_IMPLEMENTATION_AUDIT (evidence classification per claim)._
|
||||
|
||||
## What Scaffolding is (plain English)
|
||||
|
||||
Scaffolding is Rune's **construction authority**: the governed process
|
||||
by which software gets built or changed. It takes an authorized need,
|
||||
classifies what kind of construction it is, proportionally governs the
|
||||
work through a durable contract (with legal lifecycle transitions),
|
||||
derives scope from structural reality, drives builders, waits on events
|
||||
(not sleeps), refuses self-certified completion, verifies from
|
||||
canonical reality, and records evidence on durable objects so any
|
||||
future session can resume without a transcript.
|
||||
|
||||
It is NOT a scheduler, NOT a memory system, NOT a provider selector,
|
||||
NOT a research engine, NOT a release system. It is the layer that
|
||||
decides *whether, how, and with what obligations* construction happens
|
||||
— and whether it actually finished.
|
||||
|
||||
## What it owns
|
||||
|
||||
- **Construction classification** (`construction_mode.classify_mode` —
|
||||
the ONE classifier: NOT_CONSTRUCTION / LOCAL_CHANGE /
|
||||
EXISTING_PROJECT_CHANGE / PROJECT_BUILD / UNKNOWN; never silently
|
||||
chooses; unknown surfaces probe questions)
|
||||
- **Conversational interpretation** (`construction_intent.py` —
|
||||
meaning/referents/authorization; DISCUSSION→PROPOSAL→USER_APPROVED;
|
||||
feeds the ONE classifier, never deepens)
|
||||
- **Project Scaffold + Contracts** (`scaffold.py` — legal phase map
|
||||
draft→approved→building→verifying→…→closed/failed/abandoned; scope;
|
||||
obligations; checkpoints; predicted-vs-observed at close)
|
||||
- **Programme continuation** (`programme_continuation.py` —
|
||||
run_construction_programme: stages 1:1 to contracts, persist→canary→
|
||||
next; "task done ≠ programme done")
|
||||
- **Impact/scope machinery** (construction_decision, completeness
|
||||
gates, affected-surface propagation)
|
||||
- **Stage guards** (`stage_guards.py` — readiness blocks, liveness
|
||||
proves progress, exit canary proves effect; verify_test_truth refuses
|
||||
false greens)
|
||||
- **Failure taxonomy** (`failure_recovery.py` — 7 classes incl.
|
||||
PROVIDER_UNAVAILABLE; retry budgets; PERMANENT/APPROVAL never retry)
|
||||
- **Builder interface** (`construction_interface.py` — ONE builder
|
||||
boundary; JSON envelopes; builder identity recorded-but-inert;
|
||||
discover_active_contract; capabilities())
|
||||
|
||||
## What it does NOT own
|
||||
|
||||
- **Provider/model selection** (provider layer owns; ambient context
|
||||
via `provider_context.require_model`; structural guard test)
|
||||
- **Research competence** (Research Core owns; Scaffolding invokes and
|
||||
consumes — see 18C integration)
|
||||
- **Asynchronous wait/resume machinery** (W/R event bridge owns;
|
||||
`event_wait.py` is the repo-side adapter: event drives continuation,
|
||||
watchdog detects failure, durable record is truth)
|
||||
- **Release/deployment** (deploy_stage/promotion/qualify + Gitea
|
||||
workflows own it; Scaffolding records evidence)
|
||||
- **Rune's structural self-model** (Spine owns — `spine.py` over
|
||||
`structural_store.py`; Scaffolding stores use the SAME generic core)
|
||||
- **Long-horizon relevance/memory** (future Substrate — not built;
|
||||
seam exists: construction_projection + construction_commands)
|
||||
- **The TUI** (client; sends text, renders projections)
|
||||
|
||||
## How the flows work
|
||||
|
||||
**New build (PROJECT_BUILD)**: conversational/explicit intent →
|
||||
classify_mode (+ project-existence evidence) → activate() bootstraps a
|
||||
provisional Project Scaffold (identity before repository, UNKNOWN
|
||||
fields explicit) → contract draft→approved (user provenance) →
|
||||
building (builder under event wait) → verifying (exit canary;
|
||||
independent evidence) → closed with predicted-vs-observed.
|
||||
|
||||
**Existing-project change**: intent → classify (scoped/file/target
|
||||
evidence; proportional) → attach to existing authority → light or full
|
||||
contract by depth → same lifecycle, proportionate ceremony.
|
||||
|
||||
**Research-led construction (V1 target — CORRECTED 2026-09-15, Nick):**
|
||||
|
||||
> THE RESEARCH PLAN ITSELF IS CONTEXTUALLY GENERATED. There is NO
|
||||
> permanent research-topic checklist. For every request:
|
||||
> REQUEST/INTENT → understand target/current reality → identify material
|
||||
> unknowns/decisions/risks → generate a context-specific research plan →
|
||||
> perform proportional INWARD/OUTWARD/deeper research. OUTWARD asks what
|
||||
> already exists relevant to THIS specific intent (adopt/adapt/combine/
|
||||
> reject/gaps/innovation). The categories researched are selected from
|
||||
> context; deeper technical research is driven by unresolved questions
|
||||
> and consequence level, never performed mechanically.
|
||||
|
||||
`build_basis.generate_research_plan()` implements this: topics are
|
||||
synthesized from THIS intent's material unknowns/decisions/risks;
|
||||
the held-out suite proves unrelated intents produce materially
|
||||
different plans and that no canned category list exists.
|
||||
|
||||
**Future upgrades (V1 target)**: authorized need → research-depth
|
||||
decision (ADAPT) → Research Core pass → durable Build Basis →
|
||||
structural Scaffold consult/construct → impact closure + visible
|
||||
preview → contract with structurally-derived scope → isolated
|
||||
workspace → governed build/verify → merge/release → structural
|
||||
Scaffold updated. (Parts of this chain are new in T18 — see audit.)
|
||||
|
||||
**Interruption/resume**: SIGKILL-safe. Durable contract + programme
|
||||
records + wait records are the truth; fresh process resumes from
|
||||
identity alone; duplicate signals idempotent (live-proven T14E/T17E).
|
||||
|
||||
**Deployment/release participation**: Scaffolding does not run the
|
||||
pipeline; it consumes qualified CI/deploy evidence, records deployed
|
||||
identity on contracts, and refuses closure without it where contracted.
|
||||
|
||||
## T19 layer model (the general engineering system)
|
||||
|
||||
> "The Scaffold should let the LLM operate with surgical precision
|
||||
> locally, while preserving global awareness of what else must be
|
||||
> checked or changed."
|
||||
>
|
||||
> "Lower active cognitive load without losing the whole idea."
|
||||
|
||||
- **STRUCTURAL MODEL** tells Rune what the project contains / how it connects.
|
||||
- **CAPABILITY LEDGER** provides compact local re-entry context (stable IDs
|
||||
across moves; history preserved through supersede/retire).
|
||||
- **BEHAVIOUR VALIDATION LEDGER** tells Rune what intended behaviour is
|
||||
actually confirmed — generation-aware, selective invalidation, automated
|
||||
green never implies USER_CONFIRMED.
|
||||
- **PROJECT REGISTRY** tells Rune which Scaffolds/projects exist
|
||||
(discovery/index only — not structural truth, not Spine).
|
||||
- **ITERATION ENGINE** (predictive→descriptive impact, impact-delta
|
||||
records, machine-derived obligations) makes quicksand protection
|
||||
STANDARD behaviour of every construction route.
|
||||
- **/TESTING** is a dependency-aware hardening programme: dynamic queue,
|
||||
fix-for-B-may-reopen-A, closure requires retest AND user confirmation.
|
||||
- **FORGE** provides workflow/history projection (failure never rewrites
|
||||
canonical validation truth).
|
||||
- **FUTURE SUBSTRATE** will coordinate sequencing/current focus/pause-
|
||||
resume but does NOT own structural or validation truth.
|
||||
|
||||
## How Spine relates
|
||||
|
||||
Spine = Rune's canonical structural self-model (structural_store
|
||||
generic core, maturity ladder, impact_frontier). Scaffolding's project
|
||||
stores share the SAME generic core (zero Rune constants) — one graph
|
||||
discipline, two scopes: Spine models Rune; project Scaffolds model
|
||||
their projects. No duplicate truth: a project's structural model lives
|
||||
in its own store; Rune's lives in Spine. Later retrofit will modernise
|
||||
Spine using the discipline V1 generalises (18K relationship).
|
||||
|
||||
## How Substrate will interact (without owning internals)
|
||||
|
||||
Read: versioned outbound projection (construction_projection,
|
||||
SCHEMA_VERSION=1). Write: bounded validated commands
|
||||
(construction_commands — 6 commands, lifecycle-validated, idempotent,
|
||||
no direct storage mutation). Substrate asks; Scaffolding decides.
|
||||
Memory graph explicitly out of scope (T18 rule L).
|
||||
@@ -22,7 +22,9 @@ and deploys Rune itself to `/mnt/workdrive/rune-code/current`.
|
||||
| Construction (build lifecycle) | `src/rune/scaffold.py` + `construction_*.py` | scaffold store (`<dir>/.rune/scaffold`) |
|
||||
| Builder sessions | `scripts/t15_builder_session.py` (event-driven successor; T14 is legacy) | contract + wait records |
|
||||
| Provider/model selection | `rune_operator` final decider; ambient context via `provider_context.require_model` | `state/model_routing_profiles.json` |
|
||||
| Wait/resume (any long op) | `src/rune/event_wait.py` + W/R daemon (out-of-repo snapshot at `~/.local/share/mimo-wait-resume`, data root `/mnt/workdrive/wr-bridge`) | waits/events/leases/resumes JSON |
|
||||
| Wait/resume (any long op) | `src/rune/event_wait.py` + W/R daemon (out-of-repo snapshot at `~/.local/share/mimo-wait-resume`, data root `/mnt/workdrive/wr-bridge` — PIN `RUNE_WR_ROOT`: unpinned consumers get a loud warning, never a silent split-brain) | waits/events/leases/resumes JSON |
|
||||
| Programme continuation | `src/rune/programme_continuation.py` (WIRED T17: `run_construction_programme` binds stages to Scaffolding contracts) | scaffold store `programmes/` |
|
||||
| Conversational construction | `src/rune/construction_intent.py` (meaning/referents/authorization) → `construction_mode.classify_mode` (the ONE classifier) | intents are transient; contracts durable |
|
||||
| CI qualification verdict | `scripts/deploy_qualify.py` (two legs, fail-closed) | Gitea commit status + runs |
|
||||
| Release/deploy | `scripts/deploy_stage.py` → `deploy_promotion.py` (monotonic, flock) | deploy root + `current`/`last-good` symlinks |
|
||||
| Research | `scripts/research_task_tree.py` (authority; labels are projection) | `research/issue-<N>/` |
|
||||
@@ -45,8 +47,8 @@ and deploys Rune itself to `/mnt/workdrive/rune-code/current`.
|
||||
|
||||
## Unfinished / blocked / deprecated
|
||||
|
||||
- programme_continuation.py: implemented + tested but UNWIRED (no
|
||||
production caller) — the "continue problem" machinery awaits routing.
|
||||
- programme_continuation.py: WIRED (T17 17D — run_construction_programme
|
||||
is the canonical multi-stage driver; 17E live-proven).
|
||||
- maintenance.yml canary-suite job: loops `shared/canary_*.py` — wrong
|
||||
dir (real canaries in `src/rune/`), job likely no-ops (LEGACY).
|
||||
- daemon out-of-repo: the W/R daemon is deployed from
|
||||
|
||||
+2
-2
@@ -1,4 +1,4 @@
|
||||
{
|
||||
"BLE001": 354,
|
||||
"S110": 80
|
||||
"BLE001": 350,
|
||||
"S110": 78
|
||||
}
|
||||
+1
-1
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
||||
|
||||
[project]
|
||||
name = "rune"
|
||||
version = "0.66.71"
|
||||
version = "0.68.0"
|
||||
description = "Rune — a stateful coding assistant with persistent memory, orchestration, and TUI"
|
||||
requires-python = ">=3.10"
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"errorCount": 117,
|
||||
"warningCount": 443,
|
||||
"informationCount": 0
|
||||
"errorCount": 117,
|
||||
"warningCount": 454,
|
||||
"informationCount": 0
|
||||
}
|
||||
+33
-28
@@ -1,29 +1,34 @@
|
||||
{
|
||||
"typeCheckingMode": "standard",
|
||||
"pythonVersion": "3.14",
|
||||
"reportMissingImports": "warning",
|
||||
"reportMissingModuleSource": "none",
|
||||
"reportMissingTypeStubs": "none",
|
||||
"reportUnknownArgumentType": "none",
|
||||
"reportUnknownParameterType": "none",
|
||||
"reportUnknownVariableType": "none",
|
||||
"reportUnknownMemberType": "none",
|
||||
"reportMissingTypeArgument": "none",
|
||||
"reportUntypedFunctionDecorator": "none",
|
||||
"reportUntypedClassDecorator": "none",
|
||||
"reportUntypedBaseClass": "none",
|
||||
"reportPrivateUsage": "none",
|
||||
"reportOptionalMemberAccess": "warning",
|
||||
"reportUnnecessaryIsInstance": "warning",
|
||||
"reportUnnecessaryComparison": "warning",
|
||||
"reportUnnecessaryTypeIgnoreComment": "warning",
|
||||
"reportPossiblyUnboundVariable": "error",
|
||||
"reportUndefinedVariable": "error",
|
||||
"reportAttributeAccessIssue": "warning",
|
||||
"include": ["src/rune"],
|
||||
"exclude": [
|
||||
"src/rune/__pycache__",
|
||||
"**/node_modules",
|
||||
"**/__pycache__"
|
||||
]
|
||||
}
|
||||
"typeCheckingMode": "standard",
|
||||
"pythonVersion": "3.14",
|
||||
"reportMissingImports": "warning",
|
||||
"reportMissingModuleSource": "none",
|
||||
"reportMissingTypeStubs": "none",
|
||||
"reportUnknownArgumentType": "none",
|
||||
"reportUnknownParameterType": "none",
|
||||
"reportUnknownVariableType": "none",
|
||||
"reportUnknownMemberType": "none",
|
||||
"reportMissingTypeArgument": "none",
|
||||
"reportUntypedFunctionDecorator": "none",
|
||||
"reportUntypedClassDecorator": "none",
|
||||
"reportUntypedBaseClass": "none",
|
||||
"reportPrivateUsage": "none",
|
||||
"reportOptionalMemberAccess": "warning",
|
||||
"reportUnnecessaryIsInstance": "warning",
|
||||
"reportUnnecessaryComparison": "warning",
|
||||
"reportUnnecessaryTypeIgnoreComment": "warning",
|
||||
"reportPossiblyUnboundVariable": "error",
|
||||
"reportUndefinedVariable": "error",
|
||||
"reportAttributeAccessIssue": "warning",
|
||||
"include": [
|
||||
"src/rune"
|
||||
],
|
||||
"exclude": [
|
||||
"src/rune/__pycache__",
|
||||
"**/node_modules",
|
||||
"**/__pycache__"
|
||||
],
|
||||
"extraPaths": [
|
||||
"scripts"
|
||||
]
|
||||
}
|
||||
+2
-2
@@ -70,7 +70,7 @@ pluggy==1.6.0
|
||||
# via
|
||||
# diff-cover
|
||||
# pytest
|
||||
propcache==0.5.2
|
||||
propcache==0.5.4
|
||||
# via
|
||||
# aiohttp
|
||||
# yarl
|
||||
@@ -118,5 +118,5 @@ typing-extensions==4.16.0
|
||||
# textual-autocomplete
|
||||
websockets==17.1
|
||||
# via rune (pyproject.toml)
|
||||
yarl==1.24.5
|
||||
yarl==1.25.1
|
||||
# via aiohttp
|
||||
@@ -18,6 +18,13 @@ from __future__ import annotations
|
||||
import re
|
||||
import sys
|
||||
|
||||
# T20 §20B: push-convergence synthesizes PR titles as "<kind>: converged
|
||||
# release (push-to-master bump)" where kind comes from
|
||||
# version_convergence.highest_warranted_bump. The title text must carry
|
||||
# that decision — "minor:" was re-classified as patch here, downgrading
|
||||
# every feature tranche (observed: feat ranges bumped 0.66.77-83 not 0.67.0).
|
||||
MINOR_PREFIX_RE = re.compile(r"^\s*minor\b", re.IGNORECASE)
|
||||
|
||||
BREAKING_RE = re.compile(r"^\s*\w+(\([^)]*\))?!:")
|
||||
FEAT_RE = re.compile(r"^\s*feat(\([^)]*\))?")
|
||||
|
||||
@@ -25,6 +32,8 @@ FEAT_RE = re.compile(r"^\s*feat(\([^)]*\))?")
|
||||
def next_version(version: str, title: str) -> str:
|
||||
if BREAKING_RE.match(title) or "BREAKING CHANGE" in title:
|
||||
kind = "major"
|
||||
elif MINOR_PREFIX_RE.match(title):
|
||||
kind = "minor" # synthesized convergence title carries the kind
|
||||
elif FEAT_RE.match(title):
|
||||
kind = "minor"
|
||||
else:
|
||||
|
||||
@@ -6,7 +6,7 @@ This is the main entry point for the Rune program.
|
||||
import json
|
||||
from pathlib import Path
|
||||
|
||||
__version__ = "0.66.71"
|
||||
__version__ = "0.68.0"
|
||||
|
||||
# One build identity (handoff 2026-09-10 §4): the semantic version above is
|
||||
# the repo-level truth (auto-bumped at merge); the DEPLOYED revision (exact
|
||||
|
||||
@@ -0,0 +1,251 @@
|
||||
"""behaviour_ledger.py — T19 §19F/19G/19I: the canonical Behaviour
|
||||
Validation Ledger.
|
||||
|
||||
PRIMARY UNIT: the VERSIONED BEHAVIOUR / TEST SPECIFICATION — not "a
|
||||
test run in some session". Automated verification and real-world/user
|
||||
confirmation are DISTINCT truths (rule 19F): tests green ≠ user-
|
||||
confirmed.
|
||||
|
||||
GENERATION-AWARE HISTORY (rule 19G, mandatory): when a dependency
|
||||
changes, affected behaviours become RETEST_REQUIRED while their prior
|
||||
confirmation history stays queryable — confidence does not silently
|
||||
carry forward, and it does not silently disappear either.
|
||||
|
||||
SELECTIVE INVALIDATION (rule 19I): only behaviours whose structural
|
||||
dependencies changed are invalidated; every invalidation carries a
|
||||
reason; unrelated hardened confirmations are preserved.
|
||||
|
||||
Storage: <project_store>/behaviour_ledger.json (versioned document).
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
LEDGER_SCHEMA_VERSION = 1
|
||||
|
||||
# hardening lifecycle (rule 19G semantics)
|
||||
UNVALIDATED = "UNVALIDATED" # not yet validated
|
||||
IMPLEMENTED = "IMPLEMENTED" # implementation exists
|
||||
AUTO_VERIFIED = "AUTO_VERIFIED" # automated verification passed
|
||||
REAL_WORLD_PASSED = "REAL_WORLD_PASSED" # manual/real test passed
|
||||
TEST_FAILED = "TEST_FAILED" # test failed
|
||||
PARTIAL = "PARTIAL" # inconclusive
|
||||
USER_CONFIRMED = "USER_CONFIRMED" # hardened
|
||||
RETEST_REQUIRED = "RETEST_REQUIRED" # confidence invalidated
|
||||
ACCEPTED_LIMITATION = "ACCEPTED_LIMITATION" # explicitly approved gap
|
||||
NOT_APPLICABLE = "NOT_APPLICABLE"
|
||||
|
||||
STATES = (UNVALIDATED, IMPLEMENTED, AUTO_VERIFIED, REAL_WORLD_PASSED,
|
||||
TEST_FAILED, PARTIAL, USER_CONFIRMED, RETEST_REQUIRED,
|
||||
ACCEPTED_LIMITATION, NOT_APPLICABLE)
|
||||
|
||||
# states that represent STANDING CONFIDENCE (selective invalidation
|
||||
# may reopen exactly these; everything else is already open or n/a)
|
||||
CONFIRMED_STATES = (AUTO_VERIFIED, REAL_WORLD_PASSED, USER_CONFIRMED)
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
|
||||
|
||||
class BehaviourLedger:
|
||||
def __init__(self, store_dir: Path | str):
|
||||
self.path = Path(store_dir) / "behaviour_ledger.json"
|
||||
self.doc = self._load()
|
||||
|
||||
def _load(self) -> dict:
|
||||
if self.path.is_file():
|
||||
import json
|
||||
return json.loads(self.path.read_text())
|
||||
return {"schema_version": LEDGER_SCHEMA_VERSION,
|
||||
"behaviours": {}, "updated_at": _now()}
|
||||
|
||||
def save(self) -> None:
|
||||
import json
|
||||
self.doc["updated_at"] = _now()
|
||||
self.path.parent.mkdir(parents=True, exist_ok=True)
|
||||
self.path.write_text(json.dumps(self.doc, indent=1, sort_keys=True))
|
||||
|
||||
# -- specification ------------------------------------------------------
|
||||
|
||||
def define(self, *, behaviour_id: str, owning_project: str,
|
||||
intended_behaviour: str, origin_intent: str = "",
|
||||
pass_criteria: str = "", fail_criteria: str = "",
|
||||
procedure: str = "",
|
||||
owner_component: str = "",
|
||||
dependencies: list[str] | None = None,
|
||||
automated_ref: str = "",
|
||||
environment: str = "") -> dict:
|
||||
bid = (behaviour_id if behaviour_id.startswith("behaviour:")
|
||||
else f"behaviour:{behaviour_id}")
|
||||
if bid in self.doc["behaviours"]:
|
||||
raise ValueError(f"behaviour exists: {bid}")
|
||||
rec = {
|
||||
"behaviour_id": bid,
|
||||
"owning_project": owning_project,
|
||||
"intended_behaviour": intended_behaviour,
|
||||
"origin_intent": origin_intent,
|
||||
"pass_criteria": pass_criteria,
|
||||
"fail_criteria": fail_criteria,
|
||||
"procedure": procedure,
|
||||
"owner_component": owner_component, # structural entity id
|
||||
"dependencies": list(dependencies or []), # structural ids
|
||||
"automated_ref": automated_ref,
|
||||
"environment": environment,
|
||||
"state": UNVALIDATED,
|
||||
"evidence": [], # [{at, generation, kind, detail}]
|
||||
"history": [], # every state transition, never lost
|
||||
"invalidations": [], # [{at, generation, because}]
|
||||
"limitations": [],
|
||||
"created_at": _now(),
|
||||
"updated_at": _now(),
|
||||
}
|
||||
self.doc["behaviours"][bid] = rec
|
||||
return rec
|
||||
|
||||
def get(self, behaviour_id: str) -> dict | None:
|
||||
return self.doc["behaviours"].get(
|
||||
behaviour_id if behaviour_id.startswith("behaviour:")
|
||||
else f"behaviour:{behaviour_id}")
|
||||
|
||||
# -- state transitions (all recorded in history — rule 19G) -------------
|
||||
|
||||
def _transition(self, rec: dict, new_state: str, *, kind: str,
|
||||
detail: str = "", generation: str = "") -> None:
|
||||
if new_state not in STATES:
|
||||
raise ValueError(f"unknown validation state {new_state!r}")
|
||||
rec["history"].append({
|
||||
"at": _now(), "from": rec["state"], "to": new_state,
|
||||
"kind": kind, "detail": detail[:200],
|
||||
"generation": generation})
|
||||
rec["state"] = new_state
|
||||
rec["updated_at"] = _now()
|
||||
|
||||
def record_auto_verification(self, behaviour_id: str, *,
|
||||
passed: bool, detail: str = "",
|
||||
generation: str = "") -> dict:
|
||||
"""Automated verification. GREEN NEVER IMPLIES USER_CONFIRMED
|
||||
(rule 19W-22): the ceiling here is AUTO_VERIFIED."""
|
||||
rec = self.get(behaviour_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown behaviour {behaviour_id!r}")
|
||||
rec["evidence"].append({"at": _now(), "kind": "automated",
|
||||
"passed": passed,
|
||||
"detail": detail[:200],
|
||||
"generation": generation})
|
||||
self._transition(rec, AUTO_VERIFIED if passed else TEST_FAILED,
|
||||
kind="automated_verification", detail=detail,
|
||||
generation=generation)
|
||||
return rec
|
||||
|
||||
def record_real_world(self, behaviour_id: str, *, passed: bool,
|
||||
detail: str = "", generation: str = "",
|
||||
confirmed_by: str = "user") -> dict:
|
||||
"""Real-world/manual test result (testing mode). USER_CONFIRMED
|
||||
requires an explicit confirmed_by='user' pass (rule 19M)."""
|
||||
rec = self.get(behaviour_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown behaviour {behaviour_id!r}")
|
||||
rec["evidence"].append({"at": _now(), "kind": "real_world",
|
||||
"passed": passed,
|
||||
"detail": detail[:200],
|
||||
"generation": generation,
|
||||
"by": confirmed_by})
|
||||
if passed:
|
||||
state = (USER_CONFIRMED if confirmed_by == "user"
|
||||
else REAL_WORLD_PASSED)
|
||||
else:
|
||||
state = TEST_FAILED
|
||||
self._transition(rec, state, kind="real_world", detail=detail,
|
||||
generation=generation)
|
||||
return rec
|
||||
|
||||
def accept_limitation(self, behaviour_id: str, *, note: str,
|
||||
approved_by: str = "user") -> dict:
|
||||
rec = self.get(behaviour_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown behaviour {behaviour_id!r}")
|
||||
rec["limitations"].append({"at": _now(), "note": note[:200],
|
||||
"approved_by": approved_by})
|
||||
self._transition(rec, ACCEPTED_LIMITATION, kind="accept_limitation",
|
||||
detail=note, )
|
||||
return rec
|
||||
|
||||
# -- selective invalidation (rule 19I) -----------------------------------
|
||||
|
||||
def invalidate_for_change(self, *, changed_entities: set[str],
|
||||
generation: str = "",
|
||||
reasons: dict[str, str] | None = None
|
||||
) -> list[dict]:
|
||||
"""Mark RETEST_REQUIRED exactly those confirmed behaviours whose
|
||||
structural dependencies intersect the changed closure. Every
|
||||
invalidation carries a reason; unrelated confirmations stay.
|
||||
Returns the invalidated records."""
|
||||
reasons = reasons or {}
|
||||
invalidated = []
|
||||
for rec in self.doc["behaviours"].values():
|
||||
if rec["state"] not in CONFIRMED_STATES:
|
||||
continue
|
||||
overlap = set(rec.get("dependencies") or []) & changed_entities
|
||||
if rec.get("owner_component") in changed_entities:
|
||||
overlap.add(rec["owner_component"])
|
||||
if not overlap:
|
||||
continue # unrelated hardened behaviour: PRESERVED (19S-5)
|
||||
because = reasons.get(
|
||||
rec["behaviour_id"],
|
||||
f"structural change touched: {sorted(overlap)}")
|
||||
rec["invalidations"].append({
|
||||
"at": _now(), "generation": generation,
|
||||
"because": because[:200],
|
||||
"was": rec["state"],
|
||||
"changed_entities": sorted(overlap)})
|
||||
# HISTORY IS PRESERVED — prior confirmation stays queryable
|
||||
self._transition(rec, RETEST_REQUIRED,
|
||||
kind="selective_invalidation",
|
||||
detail=f"was {rec['state']}; {because}",
|
||||
generation=generation)
|
||||
invalidated.append(rec)
|
||||
return invalidated
|
||||
|
||||
def retest_history(self, behaviour_id: str) -> list[dict]:
|
||||
"""Generation-aware history: all confirmations + invalidations
|
||||
for one behaviour, oldest first (rule 19S-12)."""
|
||||
rec = self.get(behaviour_id)
|
||||
if rec is None:
|
||||
return []
|
||||
events = []
|
||||
for h in rec["history"]:
|
||||
events.append({"at": h["at"], "generation": h.get("generation"),
|
||||
"event": f"{h['from']}→{h['to']}",
|
||||
"kind": h["kind"], "detail": h.get("detail", "")})
|
||||
return events
|
||||
|
||||
# -- queue (testing mode, 19L/M) ------------------------------------------
|
||||
|
||||
def outstanding(self, *, component: str | None = None,
|
||||
project: str | None = None) -> list[dict]:
|
||||
"""Eligible testing items: anything not confirmed/accepted/n.a.
|
||||
Dynamic — the queue re-derives from states after every fix
|
||||
(rule 19M)."""
|
||||
out = []
|
||||
for rec in self.doc["behaviours"].values():
|
||||
if rec["state"] in (USER_CONFIRMED, ACCEPTED_LIMITATION,
|
||||
NOT_APPLICABLE):
|
||||
continue
|
||||
if project and rec.get("owning_project") != project:
|
||||
continue
|
||||
if component and rec.get("owner_component") != component:
|
||||
continue
|
||||
out.append(rec)
|
||||
out.sort(key=lambda r: (0 if r["state"] == TEST_FAILED else 1,
|
||||
r["behaviour_id"]))
|
||||
return out
|
||||
|
||||
def summary(self) -> dict:
|
||||
counts: dict[str, int] = {}
|
||||
for rec in self.doc["behaviours"].values():
|
||||
counts[rec["state"]] = counts.get(rec["state"], 0) + 1
|
||||
return {"total": len(self.doc["behaviours"]),
|
||||
"states": counts,
|
||||
"outstanding": len(self.outstanding())}
|
||||
@@ -0,0 +1,287 @@
|
||||
"""build_basis.py — T18 §18C: durable versioned RESEARCH BASIS for
|
||||
construction (V1 rule F: RESEARCH INFORMS STRUCTURE).
|
||||
|
||||
Research output must not disappear in transient model context. A Build
|
||||
Basis is a durable, schema-versioned document that captures WHAT
|
||||
research decided and WHY, with references — not research dumps. It is
|
||||
created after the research-depth decision and before/with the
|
||||
Construction Contract, and is attachable to:
|
||||
|
||||
- a Project Scaffold (project-level basis)
|
||||
- a Construction Contract (per-contract basis, via evidence_ref)
|
||||
- future structural entities where useful
|
||||
|
||||
Research Core ownership (rule C): this module NEVER researches. It
|
||||
records the depth decision (derived FROM adaptive_router's route — no
|
||||
second router), references the canonical pipeline's qualified output
|
||||
(stages ISSUE→…→QUALIFY, artifacts in research/issue-<N>/), and
|
||||
structures the adopt/adapt/combine/reject/innovate decisions (rule E).
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from typing import Any
|
||||
|
||||
SCHEMA_VERSION = 1
|
||||
|
||||
# Research depth tiers — derived from adaptive_router ROUTES, never a
|
||||
# second router (rule C/A). Each tier records WHY it was chosen.
|
||||
DEPTH_NONE = "NONE" # tiny obvious local change; local evidence only
|
||||
DEPTH_INWARD = "INWARD" # repo-internal understanding suffices
|
||||
DEPTH_OUTWARD = "OUTWARD" # precedent/prior-art discovery required
|
||||
DEPTH_FULL = "FULL" # full pipeline incl. adversarial+synthesis
|
||||
|
||||
DEPTH_TIERS = (DEPTH_NONE, DEPTH_INWARD, DEPTH_OUTWARD, DEPTH_FULL)
|
||||
|
||||
# route → default depth (recorded as decision evidence; caller may
|
||||
# justify an exception, which is recorded as such — never silent)
|
||||
_ROUTE_DEFAULT_DEPTH = {
|
||||
"LOCAL_FIX": DEPTH_NONE,
|
||||
"STANDARD_CHANGE": DEPTH_INWARD,
|
||||
"RESEARCHED_CHANGE": DEPTH_FULL,
|
||||
}
|
||||
|
||||
|
||||
def research_depth(route: str, *, mode: str = "",
|
||||
justification: str = "") -> dict:
|
||||
"""The research-depth DECISION for a construction need. Derived from
|
||||
the canonical route authority (adaptive_router); `justification` is
|
||||
REQUIRED when deviating from the route default — recorded, never
|
||||
silent (rule D: record why research depth was chosen)."""
|
||||
default = _ROUTE_DEFAULT_DEPTH.get(route, DEPTH_INWARD)
|
||||
depth = default
|
||||
why = f"route {route} default"
|
||||
if justification and justification.strip():
|
||||
# an explicit justification selects a tier by name if given;
|
||||
# otherwise it annotates the default
|
||||
candidate = justification.strip().split(":", 1)[0].strip()
|
||||
if candidate in DEPTH_TIERS:
|
||||
depth = candidate
|
||||
why = justification.strip()
|
||||
else:
|
||||
why = f"route {route} default; note: {justification.strip()}"
|
||||
elif route not in _ROUTE_DEFAULT_DEPTH:
|
||||
why = f"route {route!r} unknown — INWARD floor (never silent NONE)"
|
||||
depth = DEPTH_INWARD
|
||||
return {"depth": depth, "why": why, "route": route, "mode": mode,
|
||||
"decided_at": _now()}
|
||||
|
||||
|
||||
# OUTWARD precedent-first ordering contract (rule E): the questions the
|
||||
# prior-art pass MUST answer before deeper material is consulted.
|
||||
OUTWARD_PRIOR_ART_QUESTIONS = (
|
||||
"what already exists addressing this intent",
|
||||
"what open-source systems/products/workflows attempt it",
|
||||
"what architectural patterns already work",
|
||||
"what standards/conventions exist",
|
||||
"what can be directly ADOPTED",
|
||||
"what can be ADAPTED",
|
||||
"what can be COMBINED",
|
||||
"what should be REJECTED",
|
||||
"where is genuine INNOVATION required",
|
||||
)
|
||||
|
||||
_DISPOSITIONS = ("ADOPT", "ADAPT", "COMBINE", "REJECT", "INNOVATE")
|
||||
|
||||
|
||||
def new_basis(*, question: str, depth_decision: dict,
|
||||
issue_ref: str = "") -> dict:
|
||||
"""Create an empty-but-valid Build Basis. References only — full
|
||||
research dumps live in the Research Core's artifact dirs (rule 18C:
|
||||
do not store unnecessary dumps)."""
|
||||
return {
|
||||
"schema_version": SCHEMA_VERSION,
|
||||
"kind": "build_basis",
|
||||
"created_at": _now(),
|
||||
"question": question,
|
||||
"issue_ref": issue_ref, # e.g. research/issue-164 or Gitea issue
|
||||
"depth": depth_decision,
|
||||
"inward": {"findings": [], "refs": []},
|
||||
"outward": {"prior_art_questions_answered": [],
|
||||
"findings": [], "refs": []},
|
||||
"deeper": {"used": False, "findings": [], "refs": []},
|
||||
"dispositions": [], # [{item, disposition: ADOPT/…, why, ref}]
|
||||
"alternatives_considered": [],
|
||||
"uncertainty": [],
|
||||
"risks": [],
|
||||
"implications": {"architecture": [], "structural": [],
|
||||
"migration": [], "verification": []},
|
||||
}
|
||||
|
||||
|
||||
def set_dispositions(basis: dict, dispositions: list[dict]) -> list[str]:
|
||||
"""Record the adopt/adapt/combine/reject/innovate decisions (rule E).
|
||||
Returns validation errors; the basis stays unqualified until valid."""
|
||||
basis["dispositions"] = [
|
||||
{"item": d.get("item", ""), "disposition": d.get("disposition", ""),
|
||||
"why": d.get("why", ""), "ref": d.get("ref", "")}
|
||||
for d in dispositions
|
||||
]
|
||||
return validate_basis(basis)
|
||||
|
||||
|
||||
def validate_basis(basis: dict) -> list[str]:
|
||||
"""Qualification gate. A basis is QUALIFIED when it carries a depth
|
||||
decision with why, at least one outward prior-art answer when depth
|
||||
is OUTWARD/FULL, and every disposition uses a legal disposition."""
|
||||
errors: list[str] = []
|
||||
if basis.get("schema_version") != SCHEMA_VERSION:
|
||||
errors.append(f"schema_version {basis.get('schema_version')!r}")
|
||||
depth = (basis.get("depth") or {}).get("depth")
|
||||
if depth not in DEPTH_TIERS:
|
||||
errors.append(f"depth {depth!r} not in {DEPTH_TIERS}")
|
||||
if not (basis.get("depth") or {}).get("why"):
|
||||
errors.append("depth decision lacks WHY (rule D)")
|
||||
if depth in (DEPTH_OUTWARD, DEPTH_FULL):
|
||||
outward = basis.get("outward") or {}
|
||||
if not (outward.get("prior_art_questions_answered")
|
||||
or outward.get("findings") or outward.get("refs")):
|
||||
errors.append("OUTWARD/FULL depth requires prior-art evidence")
|
||||
if depth == DEPTH_INWARD:
|
||||
inward = basis.get("inward") or {}
|
||||
if not (inward.get("findings") or inward.get("refs")
|
||||
or basis.get("dispositions")):
|
||||
errors.append("INWARD depth requires recorded evidence "
|
||||
"(findings/refs) — an empty basis is not "
|
||||
"qualified")
|
||||
for d in basis.get("dispositions", []):
|
||||
if d.get("disposition") not in _DISPOSITIONS:
|
||||
errors.append(f"illegal disposition {d.get('disposition')!r} "
|
||||
f"for {d.get('item','')[:40]!r}")
|
||||
return errors
|
||||
|
||||
|
||||
def is_qualified(basis: dict) -> bool:
|
||||
return not validate_basis(basis)
|
||||
|
||||
|
||||
def attach_evidence_ref(basis: dict) -> str:
|
||||
"""The evidence_ref string a contract carries to point at this basis
|
||||
(durable pointer, not a copy — stores stay independent)."""
|
||||
return (f"build_basis:{basis.get('issue_ref') or 'adhoc'}:"
|
||||
f"{basis.get('created_at')}")
|
||||
|
||||
|
||||
def summary(basis: dict) -> dict:
|
||||
"""Compact projection for prompts/previews (no private reasoning —
|
||||
structured conclusions only, rule 18G)."""
|
||||
return {
|
||||
"schema_version": basis.get("schema_version"),
|
||||
"question": basis.get("question"),
|
||||
"issue_ref": basis.get("issue_ref"),
|
||||
"depth": basis.get("depth"),
|
||||
"qualified": is_qualified(basis),
|
||||
"validation": validate_basis(basis),
|
||||
"dispositions": [
|
||||
{"item": d.get("item", "")[:80],
|
||||
"disposition": d.get("disposition")}
|
||||
for d in basis.get("dispositions", [])
|
||||
],
|
||||
"uncertainty_count": len(basis.get("uncertainty", [])),
|
||||
"risks_count": len(basis.get("risks", [])),
|
||||
"implications": {k: len(v) for k, v in
|
||||
(basis.get("implications") or {}).items()},
|
||||
}
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
|
||||
|
||||
def to_json(basis: dict) -> str:
|
||||
import json
|
||||
return json.dumps(basis, indent=1, sort_keys=True)
|
||||
|
||||
|
||||
def from_json(text: str) -> dict:
|
||||
import json
|
||||
return json.loads(text)
|
||||
|
||||
|
||||
_ = Any # typing import kept for forward annotations
|
||||
|
||||
|
||||
# ── T18 §18D CORRECTION (Nick, 2026-09-15): THE RESEARCH PLAN ITSELF IS
|
||||
# CONTEXTUALLY GENERATED. The prior-art categories researched for the
|
||||
# structural-model task (architecture graphs, monorepo tooling, etc.)
|
||||
# were CONTEXTUAL to that task — they must never become a fixed topic
|
||||
# list. For every request the plan is derived from:
|
||||
# intent → target/current reality → material unknowns/decisions/risks
|
||||
# → context-specific research topics → proportional depth.
|
||||
# There is NO permanent research-topic checklist anywhere in Scaffolding.
|
||||
|
||||
def generate_research_plan(*, intent: str, target: str = "",
|
||||
current_reality: str = "",
|
||||
unknowns: list[str] | None = None,
|
||||
decisions: list[str] | None = None,
|
||||
risks: list[str] | None = None,
|
||||
depth: str | None = None) -> dict:
|
||||
"""Generate a CONTEXT-SPECIFIC research plan for one construction
|
||||
intent. Topics are synthesized from the material unknowns/decisions/
|
||||
risks of THIS intent — the function has no topic vocabulary and no
|
||||
permanent category list. Depth, when not supplied, is chosen by
|
||||
consequence heuristics recorded in the plan (why is always present)."""
|
||||
unknowns = [u for u in (unknowns or []) if u.strip()]
|
||||
decisions = [d for d in (decisions or []) if d.strip()]
|
||||
risks = [r for r in (risks or []) if r.strip()]
|
||||
topics: list[dict] = []
|
||||
# each material unknown becomes a research topic aimed at resolving it
|
||||
for u in unknowns:
|
||||
topics.append({
|
||||
"topic": f"resolve unknown: {u}",
|
||||
"kind": "unknown-resolution",
|
||||
"why": f"material unknown blocks confident construction: {u[:80]}",
|
||||
})
|
||||
for d in decisions:
|
||||
topics.append({
|
||||
"topic": f"inform decision: {d}",
|
||||
"kind": "decision-support",
|
||||
"why": f"consequential decision needs precedent/evidence: {d[:80]}",
|
||||
})
|
||||
for r in risks:
|
||||
topics.append({
|
||||
"topic": f"de-risk: {r}",
|
||||
"kind": "risk-investigation",
|
||||
"why": f"identified risk needs verification/mitigation evidence: {r[:80]}",
|
||||
})
|
||||
# precedent question (rule E) attaches ONLY when outward evidence is
|
||||
# plausibly relevant — an unknown/decision about external prior art.
|
||||
needs_outward = any(
|
||||
w in " ".join(unknowns + decisions).lower()
|
||||
for w in ("exist", "existing", "prior art", "precedent", "standard",
|
||||
"convention", "library", "tool", "framework", "approach"))
|
||||
if needs_outward:
|
||||
topics.append({
|
||||
"topic": ("what already exists that is relevant to THIS intent "
|
||||
"(adopt/adapt/combine/reject/innovate)"),
|
||||
"kind": "prior-art",
|
||||
"why": "material unknown references existing practice — "
|
||||
"precedent discovery required before deeper research",
|
||||
})
|
||||
if depth is None:
|
||||
# consequence heuristics: novel/architectural/unsafe → deeper
|
||||
consequential = any(
|
||||
w in (intent + " " + " ".join(risks)).lower()
|
||||
for w in ("architecture", "migration", "replace", "rewrite",
|
||||
"security", "schema", "delete", "deploy", "breaking"))
|
||||
depth = DEPTH_FULL if (consequential and topics) else (
|
||||
DEPTH_OUTWARD if needs_outward and topics else (
|
||||
DEPTH_INWARD if topics else DEPTH_NONE))
|
||||
why = ("consequence heuristics: consequential keywords + research "
|
||||
"topics present" if depth == DEPTH_FULL else
|
||||
"precedent-relevant unknowns present" if depth == DEPTH_OUTWARD
|
||||
else "local understanding suffices" if depth == DEPTH_INWARD
|
||||
else "no material unknowns — local evidence only")
|
||||
else:
|
||||
why = "depth supplied by caller (recorded, caller accountable)"
|
||||
return {
|
||||
"intent": intent,
|
||||
"target": target,
|
||||
"current_reality_note": current_reality[:200],
|
||||
"depth": {"depth": depth, "why": why},
|
||||
"topics": topics,
|
||||
"plan_generated_at": _now(),
|
||||
# the plan ITSELF is evidence that research was contextual, not
|
||||
# checklist-driven: two different intents must produce disjoint
|
||||
# topic sets unless they share genuine unknowns
|
||||
}
|
||||
@@ -231,7 +231,7 @@ def main() -> int:
|
||||
)
|
||||
check(
|
||||
"Rune minor version advertises provisioning and restore verification",
|
||||
'__version__ = "0.66.71"' in rune_version,
|
||||
'__version__ = "0.68.0"' in rune_version,
|
||||
failures,
|
||||
)
|
||||
# #169 policy update: auto-bump on merge is sanctioned (Nick directive:
|
||||
|
||||
@@ -0,0 +1,187 @@
|
||||
"""capability_ledger.py — T19 §19D: compact versioned Capability
|
||||
Ledgers — local re-entry context packets.
|
||||
|
||||
PURPOSE (rule 19D): a fresh LLM rehydrates the meaning of a target area
|
||||
after compaction/context loss/model swap/long absence WITHOUT rereading
|
||||
the repository. Not a second source tree, not a second Scaffold, not
|
||||
prose dumps — structured, proportional, operationally-used records.
|
||||
|
||||
Identity rule: capability IDs are STABLE across file moves (name-based,
|
||||
not path-based); history is preserved on supersede/retire (rule 19Q).
|
||||
|
||||
Storage: <project_store>/capability_ledger.json — versioned document,
|
||||
provenance-aware (rule G). Historical versions remain traceable via
|
||||
the history list.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
LEDGER_SCHEMA_VERSION = 1
|
||||
|
||||
MATURITY = ("proposed", "implemented", "verified", "hardened",
|
||||
"retest_required", "retired", "superseded")
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
|
||||
|
||||
class CapabilityLedger:
|
||||
def __init__(self, store_dir: Path | str):
|
||||
self.path = Path(store_dir) / "capability_ledger.json"
|
||||
self.doc = self._load()
|
||||
|
||||
def _load(self) -> dict:
|
||||
if self.path.is_file():
|
||||
import json
|
||||
return json.loads(self.path.read_text())
|
||||
return {"schema_version": LEDGER_SCHEMA_VERSION,
|
||||
"capabilities": {}, "history": [],
|
||||
"updated_at": _now()}
|
||||
|
||||
def save(self) -> None:
|
||||
import json
|
||||
self.doc["updated_at"] = _now()
|
||||
self.path.parent.mkdir(parents=True, exist_ok=True)
|
||||
self.path.write_text(json.dumps(self.doc, indent=1, sort_keys=True))
|
||||
|
||||
# -- lifecycle --------------------------------------------------------
|
||||
|
||||
def define(self, *, capability_id: str, name: str, purpose: str,
|
||||
owning_project: str, component: str,
|
||||
source_locations: list[str] | None = None,
|
||||
contract: str = "", state_touched: str = "",
|
||||
dependencies: list[str] | None = None,
|
||||
consumers: list[str] | None = None,
|
||||
invariants: list[str] | None = None,
|
||||
behaviour_specs: list[str] | None = None,
|
||||
constraints: str = "",
|
||||
generation: str = "") -> dict:
|
||||
"""Create a capability record (auto-invoked by Scaffolding when a
|
||||
meaningful capability is created — rule 19Q)."""
|
||||
cid = f"capability:{capability_id}"
|
||||
if cid in self.doc["capabilities"]:
|
||||
raise ValueError(f"capability exists: {cid}")
|
||||
rec = {
|
||||
"capability_id": cid,
|
||||
"name": name,
|
||||
"purpose": purpose,
|
||||
"owning_project": owning_project,
|
||||
"component": component, # structural entity id
|
||||
"source_locations": list(source_locations or []),
|
||||
"contract": contract,
|
||||
"state_touched": state_touched,
|
||||
"dependencies": list(dependencies or []),
|
||||
"consumers": list(consumers or []),
|
||||
"invariants": list(invariants or []),
|
||||
"behaviour_specs": list(behaviour_specs or []),
|
||||
"maturity": "implemented",
|
||||
"constraints": constraints,
|
||||
"generation": generation,
|
||||
"limitations": [],
|
||||
"created_at": _now(),
|
||||
"updated_at": _now(),
|
||||
}
|
||||
self.doc["capabilities"][cid] = rec
|
||||
return rec
|
||||
|
||||
def get(self, capability_id: str) -> dict | None:
|
||||
return self.doc["capabilities"].get(
|
||||
capability_id if ":" in capability_id
|
||||
else f"capability:{capability_id}")
|
||||
|
||||
def material_change(self, capability_id: str, *, note: str,
|
||||
generation: str = "",
|
||||
source_locations: list[str] | None = None) -> dict:
|
||||
"""Record a material change (auto-invoked after construction —
|
||||
rule 19Q.2). History entry keeps traceability; dependents' harden
|
||||
state is the behaviour ledger's job (via structural closure)."""
|
||||
rec = self.get(capability_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown capability {capability_id!r}")
|
||||
hist = {"at": _now(), "event": "material_change",
|
||||
"note": note[:200], "generation": generation,
|
||||
"prior_maturity": rec["maturity"]}
|
||||
self.doc["history"].append({"capability_id": rec["capability_id"],
|
||||
**hist})
|
||||
rec["updated_at"] = _now()
|
||||
if generation:
|
||||
rec["generation"] = generation
|
||||
if source_locations is not None:
|
||||
rec["source_locations"] = list(source_locations)
|
||||
return rec
|
||||
|
||||
def move(self, capability_id: str, new_locations: list[str]) -> dict:
|
||||
"""File move: STABLE IDENTITY SURVIVES (rule 19S-6); the move is
|
||||
recorded, history preserved."""
|
||||
rec = self.get(capability_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown capability {capability_id!r}")
|
||||
old = list(rec["source_locations"])
|
||||
rec["source_locations"] = list(new_locations)
|
||||
rec["updated_at"] = _now()
|
||||
self.doc["history"].append({
|
||||
"capability_id": rec["capability_id"], "at": _now(),
|
||||
"event": "moved", "from": old, "to": list(new_locations)})
|
||||
return rec
|
||||
|
||||
def supersede(self, capability_id: str, by: str, *,
|
||||
note: str = "") -> dict:
|
||||
rec = self.get(capability_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown capability {capability_id!r}")
|
||||
rec["maturity"] = "superseded"
|
||||
rec["superseded_by"] = (by if ":" in by else f"capability:{by}")
|
||||
rec["updated_at"] = _now()
|
||||
self.doc["history"].append({
|
||||
"capability_id": rec["capability_id"], "at": _now(),
|
||||
"event": "superseded", "by": rec["superseded_by"],
|
||||
"note": note[:160]})
|
||||
return rec
|
||||
|
||||
def retire(self, capability_id: str, *, note: str = "") -> dict:
|
||||
rec = self.get(capability_id)
|
||||
if rec is None:
|
||||
raise ValueError(f"unknown capability {capability_id!r}")
|
||||
rec["maturity"] = "retired"
|
||||
rec["updated_at"] = _now()
|
||||
self.doc["history"].append({
|
||||
"capability_id": rec["capability_id"], "at": _now(),
|
||||
"event": "retired", "note": note[:160]})
|
||||
return rec
|
||||
|
||||
# -- queries (surgical context, 19E) -----------------------------------
|
||||
|
||||
def active(self) -> list[dict]:
|
||||
return [r for r in self.doc["capabilities"].values()
|
||||
if r["maturity"] not in ("retired", "superseded")]
|
||||
|
||||
def by_component(self, component: str) -> list[dict]:
|
||||
return [r for r in self.active() if r["component"] == component]
|
||||
|
||||
def context_packet(self, capability_id: str) -> dict:
|
||||
"""The LOCAL context packet (19E): everything a fresh builder
|
||||
needs for one capability — bounded, structured, no reasoning."""
|
||||
rec = self.get(capability_id)
|
||||
if rec is None:
|
||||
return {"error": f"unknown capability {capability_id!r}"}
|
||||
return {
|
||||
"schema_version": LEDGER_SCHEMA_VERSION,
|
||||
"capability_id": rec["capability_id"],
|
||||
"name": rec["name"],
|
||||
"purpose": rec["purpose"],
|
||||
"component": rec["component"],
|
||||
"source_locations": rec["source_locations"],
|
||||
"contract": rec["contract"],
|
||||
"state_touched": rec["state_touched"],
|
||||
"dependencies": rec["dependencies"],
|
||||
"consumers": rec["consumers"],
|
||||
"invariants": rec["invariants"],
|
||||
"behaviour_specs": rec["behaviour_specs"],
|
||||
"maturity": rec["maturity"],
|
||||
"constraints": rec["constraints"],
|
||||
"generation": rec["generation"],
|
||||
"limitations": rec["limitations"],
|
||||
}
|
||||
+122
-14
@@ -154,9 +154,33 @@ _ANALYSIS_MARKERS = re.compile(
|
||||
r"\b(think|opinion|view|recommend|suggest|assess|evaluate|review|"
|
||||
r"compare|consider|worth it|worth it\?|needs? improvement|any "
|
||||
r"ideas?)\b", re.IGNORECASE)
|
||||
_RELATIVE_THAT = re.compile(
|
||||
r"\bthat\s+(?!the\b|a\b|an\b|is\b|was\b|will\b|can\b|should\b)"
|
||||
r"[a-z]+(?:s|ing)\b")
|
||||
# relative-'that' detection by PRECEDING context (T18 18N fix): 'that'
|
||||
# is a relative pronoun when the word before it is an article/noun
|
||||
# ("the proposal that you suggested") — demonstrative when
|
||||
# sentence-initial or after a verb/punctuation ("build that" /
|
||||
# "that works for me"). The old following-word heuristic misclassified
|
||||
# "that works for me" as a relative clause.
|
||||
_ARTICLES = {"the", "a", "an", "this", "these", "those", "one"}
|
||||
|
||||
|
||||
def _is_relative_that(low: str, dem_tokens: set) -> bool:
|
||||
"""True when every 'that' token reads as a relative pronoun by its
|
||||
preceding context; demonstrative otherwise."""
|
||||
words = re.findall(r"[a-z']+", low)
|
||||
seen_that = False
|
||||
for i, w in enumerate(words):
|
||||
if w != "that":
|
||||
continue
|
||||
seen_that = True
|
||||
prev = words[i - 1] if i > 0 else None
|
||||
if prev is None or prev in _CONSTRUCTION_VERBS:
|
||||
return False # sentence-initial or post-verb → demonstrative
|
||||
if prev not in _ARTICLES:
|
||||
# preceding word is neither article nor verb: treat as
|
||||
# demonstrative unless it is clearly a noun modifier —
|
||||
# conservative default is demonstrative (referent-seeking)
|
||||
return False
|
||||
return seen_that and "that" in dem_tokens
|
||||
|
||||
_GO_AHEAD = re.compile(
|
||||
r"^\s*(yes|yeah|yep|ok|okay|sure|go ahead|please do|do it|do that|"
|
||||
@@ -166,14 +190,23 @@ _AFFIRMATION_OPENERS = re.compile(
|
||||
r"alright|right)\b", re.IGNORECASE)
|
||||
_APPROVAL_IDIOM = re.compile(
|
||||
r"\b(go ahead|do it|do that|carry on|build that|implement that|"
|
||||
r"make it so|make it happen|that's the one|go with|let's go|"
|
||||
r"let's do|proceed with|approved|ship it)\b", re.IGNORECASE)
|
||||
r"make it so|make it happen|make that happen|that's the one|go with|"
|
||||
r"let's go|let's do|let's have it|proceed|good with that|"
|
||||
r"fine with that|happy with that|on board|approved|ship it)\b",
|
||||
re.IGNORECASE)
|
||||
|
||||
|
||||
def _tokens(text: str) -> set[str]:
|
||||
return set(re.split(r"[^a-z0-9]+", text.lower()))
|
||||
|
||||
|
||||
_NEGATION = re.compile(
|
||||
r"^\s*(don't|do not|dont|never|not yet|stop|hold off|no need|"
|
||||
r"skip it|forget it)\b", re.IGNORECASE)
|
||||
_IDIOM_PREFIX = re.compile(
|
||||
r"^\s*(go ahead and|go and|please|kindly|then|now)\s+", re.IGNORECASE)
|
||||
|
||||
|
||||
def _is_question(text: str) -> bool:
|
||||
"""Interrogative STRUCTURE, not vocabulary: leading wh/auxiliary or
|
||||
terminal '?'. 'How would you build this?' is a question regardless
|
||||
@@ -187,8 +220,16 @@ def _is_question(text: str) -> bool:
|
||||
|
||||
def _imperative_verb(text: str) -> str | None:
|
||||
"""Leading imperative construction verb — the strong/direct demand
|
||||
signal (§17K). 'Build me a program...' → 'build'."""
|
||||
m = re.match(r"^\s*(\w+)", text, re.IGNORECASE)
|
||||
signal (§17K). 'Build me a program...' → 'build'. Idiom prefixes
|
||||
('go ahead and build X', 'please implement X') are stripped so the
|
||||
real verb surfaces."""
|
||||
t = text
|
||||
for _ in range(3):
|
||||
t2 = _IDIOM_PREFIX.sub("", t)
|
||||
if t2 == t:
|
||||
break
|
||||
t = t2
|
||||
m = re.match(r"^\s*(\w+)", t, re.IGNORECASE)
|
||||
if m and m.group(1).lower() in _CONSTRUCTION_VERBS:
|
||||
return m.group(1).lower()
|
||||
return None
|
||||
@@ -221,6 +262,13 @@ def resolve_construction_intent(
|
||||
ev: list[str] = []
|
||||
probes: list[str] = []
|
||||
|
||||
# 0. NEGATION (§18N): "don't build that yet" blocks authorization —
|
||||
# construction language inside a negation frame is NOT a demand.
|
||||
if _NEGATION.match(t):
|
||||
ev.append("negation frame — explicitly blocks construction")
|
||||
return _intent(t, "DISCUSSION", "DISCUSSION", 0.85, "NONE",
|
||||
ev, probes, context, origin_context_id)
|
||||
|
||||
# 1a. REQUEST MODALS: "can you fix that?" is an imperative in
|
||||
# interrogative clothing — a state-changing action request, NOT an
|
||||
# information question. Information openers (how/what/why/should we)
|
||||
@@ -237,6 +285,27 @@ def resolve_construction_intent(
|
||||
if request_modal:
|
||||
ev.append("request modal (can/could/would you, please) + "
|
||||
"construction verb → action request, not discussion")
|
||||
# a modal + demonstrative + live proposal authorizes THAT
|
||||
# proposal (referent resolution outranks target resolution)
|
||||
dem_tokens_m = _tokens(low) & _DEMONSTRATIVES
|
||||
if dem_tokens_m and context.live_proposals():
|
||||
referent = _resolve_referent(low, context)
|
||||
if referent and not referent.get("ambiguous"):
|
||||
tp = referent["proposal"]
|
||||
ev.append(f"modal authorization resolves proposal "
|
||||
f"{tp.proposal_id}")
|
||||
return ConstructionIntent(
|
||||
intent_id=f"intent-{uuid.uuid4().hex[:8]}",
|
||||
objective=tp.summary,
|
||||
requested_effect=f"construct: {tp.summary}",
|
||||
resolved_target=context.active_project,
|
||||
resolved_referent=tp.proposal_id,
|
||||
origin_context_id=origin_context_id,
|
||||
action_intent="ACTION", approval_state="USER_APPROVED",
|
||||
confidence=0.85, ambiguity="NONE",
|
||||
consequence_level=_consequence(t, context),
|
||||
relevant_constraints=_constraints(context),
|
||||
classification_evidence=ev)
|
||||
target = context.active_project
|
||||
if target:
|
||||
ev.append(f"target resolved from active context: {target}")
|
||||
@@ -278,7 +347,7 @@ def resolve_construction_intent(
|
||||
bare_approval = bool(_GO_AHEAD.match(t))
|
||||
imperative = _imperative_verb(t)
|
||||
dem_tokens = _tokens(low) & _DEMONSTRATIVES
|
||||
if "that" in dem_tokens and _RELATIVE_THAT.search(low):
|
||||
if "that" in dem_tokens and _is_relative_that(low, dem_tokens):
|
||||
dem_tokens.discard("that") # relative clause, not a demonstrative
|
||||
ev.append("'that' is a relative pronoun here, not a referent")
|
||||
demonstrative = bool(dem_tokens) or \
|
||||
@@ -294,12 +363,30 @@ def resolve_construction_intent(
|
||||
if authorized:
|
||||
referent = _resolve_referent(low, context)
|
||||
if referent is None:
|
||||
ev.append("authorization language but NO live resolvable "
|
||||
"referent — never guessed")
|
||||
probes.append("what should that refer to? I don't have an "
|
||||
"active proposal matching it.")
|
||||
return _intent(t, "ACTION", "DISCUSSION", 0.4, "REFERENT",
|
||||
ev, probes, context, origin_context_id)
|
||||
# "go ahead and build X": idiom + explicit imperative — fall
|
||||
# through to the demand path (target resolution) rather than
|
||||
# dead-ending in referent ambiguity
|
||||
if imperative is None:
|
||||
ev.append("authorization language but NO live resolvable "
|
||||
"referent — never guessed")
|
||||
probes.append("what should that refer to? I don't have an "
|
||||
"active proposal matching it.")
|
||||
return _intent(t, "ACTION", "DISCUSSION", 0.4, "REFERENT",
|
||||
ev, probes, context, origin_context_id)
|
||||
ev.append("no live proposal matches; treating as direct "
|
||||
"demand (explicit imperative object present)")
|
||||
if referent is None:
|
||||
# live proposals exist but are ALL STALE (topic moved on) —
|
||||
# never approve a stale referent; fall to the demand path
|
||||
ev.append("proposals stale for this turn — not selected")
|
||||
if imperative is None:
|
||||
probes.append("what should that refer to? The earlier "
|
||||
"proposal no longer seems active.")
|
||||
return _intent(t, "ACTION", "DISCUSSION", 0.4, "REFERENT",
|
||||
ev, probes, context, origin_context_id)
|
||||
ev.append("stale proposals ignored; explicit imperative → "
|
||||
"demand path")
|
||||
referent = {"__fallthrough__": True}
|
||||
if referent.get("ambiguous"):
|
||||
ev.append("multiple equally plausible referents — asking, "
|
||||
"not guessing (§17M)")
|
||||
@@ -307,6 +394,27 @@ def resolve_construction_intent(
|
||||
p.summary[:40] for p in referent["candidates"]) + "?")
|
||||
return _intent(t, "ACTION", "DISCUSSION", 0.4, "REFERENT",
|
||||
ev, probes, context, origin_context_id)
|
||||
if referent.get("__fallthrough__"):
|
||||
# demand path: target from context or clarify (never stale)
|
||||
target = context.active_project
|
||||
if not target and imperative in _CREATION_VERBS and \
|
||||
_NEW_ARTICLE.search(low):
|
||||
# new standalone artifact demand — no target needed
|
||||
ev.append("creation verb + indefinite article → new "
|
||||
"standalone artifact; no existing target required")
|
||||
return _intent(t, "ACTION", "USER_APPROVED", 0.85, "NONE",
|
||||
ev, probes, context, origin_context_id,
|
||||
requested_effect=f"construct new: {t}",
|
||||
consequence_level=_consequence(t, context))
|
||||
if target:
|
||||
ev.append(f"target resolved from active context: {target}")
|
||||
return _intent(t, "ACTION", "USER_APPROVED", 0.8, "NONE",
|
||||
ev, probes, context, origin_context_id,
|
||||
requested_effect=f"construct: {t}",
|
||||
consequence_level=_consequence(t, context))
|
||||
probes.append("build where — which project/system?")
|
||||
return _intent(t, "ACTION", "DISCUSSION", 0.5, "TARGET",
|
||||
ev, probes, context, origin_context_id)
|
||||
target_prop = referent["proposal"]
|
||||
ev.append(f"referent resolved: {target_prop.proposal_id} "
|
||||
f"(recency-first among live proposals)")
|
||||
|
||||
@@ -71,3 +71,48 @@ def reconcile(claims: list[dict], observer: Callable[[dict], dict]) -> dict:
|
||||
blocking = [d for d in drifts if d["class"] in BLOCKING_CLASSES]
|
||||
return {"resume": not blocking, "drifts": drifts,
|
||||
"blocking": blocking}
|
||||
|
||||
|
||||
# ── T18 §18H: structural drift detection (extends drift_resume; no
|
||||
# duplicate mechanism). Detects observable drift between a structural
|
||||
# model's claims and repository reality. REALITY WINS unless user-locked.
|
||||
|
||||
def detect_structural_drift(model, repo_root) -> list[dict]:
|
||||
"""Compare structural-model component claims against source reality.
|
||||
Observable cases: source file moved/missing (component identities
|
||||
carry 'source'), entities for files that no longer exist. Returns
|
||||
drift records in the classify_drift vocabulary; reality wins unless
|
||||
the claim is user-locked (authority == 'user' on the entity's
|
||||
evidence or identities.user_locked)."""
|
||||
import os
|
||||
from pathlib import Path as _P
|
||||
root = _P(repo_root)
|
||||
drifts = []
|
||||
for e in model.doc["entities"]:
|
||||
if e.get("kind") != "component":
|
||||
continue
|
||||
src = ((e.get("ext") or {}).get("source")
|
||||
or (e.get("identities") or {}).get("source"))
|
||||
if not src:
|
||||
continue
|
||||
locked = (e.get("identities") or {}).get("user_locked") is True
|
||||
expected = root / src
|
||||
if not expected.exists():
|
||||
# reality: file gone/moved — search one level for a moved twin
|
||||
moved = None
|
||||
if expected.name:
|
||||
for cand in root.rglob(expected.name):
|
||||
if cand.is_file():
|
||||
moved = str(cand.relative_to(root))
|
||||
break
|
||||
drifts.append({
|
||||
"claim": f"{e['id']} source at {src}",
|
||||
"class": "CONFLICTING" if locked else "MATERIAL",
|
||||
"evidence": (f"source missing; moved to {moved}"
|
||||
if moved else "source file absent from repo"),
|
||||
"reality_wins": not locked,
|
||||
"reconciliation": (f"update source to {moved}" if moved
|
||||
else "entity requires re-derivation or "
|
||||
"user-locked preservation"),
|
||||
})
|
||||
return drifts
|
||||
@@ -95,9 +95,24 @@ for attempt in range(3):
|
||||
|
||||
|
||||
def wr_root() -> Path:
|
||||
"""Resolve the bridge DATA root. T17 17T finding: two live roots
|
||||
existed (the shared /mnt/workdrive/wr-bridge and the legacy
|
||||
~/.local/share/mimo-wait-resume) and an unpinned consumer silently
|
||||
read the stale one. Policy now: explicit env → shared root if it
|
||||
exists (the canonical production root) → legacy home (warn loudly —
|
||||
a stale-store split-brain must be visible, never silent)."""
|
||||
import sys as _sys
|
||||
env = os.environ.get("RUNE_WR_ROOT")
|
||||
if env:
|
||||
return Path(env)
|
||||
shared = Path("/mnt/workdrive/wr-bridge")
|
||||
if shared.exists():
|
||||
if DEFAULT_WR_ROOT.exists():
|
||||
_sys.stderr.write(
|
||||
"event_wait: RUNE_WR_ROOT unset — using shared bridge "
|
||||
f"root {shared} while legacy root {DEFAULT_WR_ROOT} also "
|
||||
"exists; pin RUNE_WR_ROOT to silence\n")
|
||||
return shared
|
||||
if DEFAULT_WR_ROOT.exists():
|
||||
return DEFAULT_WR_ROOT
|
||||
return FALLBACK_WR_ROOT
|
||||
|
||||
@@ -0,0 +1,146 @@
|
||||
"""forge.py — T18 §18L: minimum stable forge abstraction boundary.
|
||||
|
||||
Rune today is Gitea-centric; Scaffolding must not make Gitea itself part
|
||||
of canonical construction semantics. This module defines the boundary:
|
||||
Git remains the source-history authority; a Forge adapter handles the
|
||||
remote-services surface (push/CI status/PR/protected checks/release
|
||||
metadata). GiteaForge is the real working adapter, delegating to the
|
||||
existing gitea_auth + scripts (rule A: no duplicate implementation).
|
||||
|
||||
A future Forgejo/GitHub/GitLab adapter implements the same interface
|
||||
without changing Scaffolding's core model.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Protocol
|
||||
|
||||
|
||||
class ForgeAdapter(Protocol):
|
||||
"""The minimum stable forge boundary. All methods may raise
|
||||
ForgeUnavailable — callers treat forge failures as blocking-for-that-
|
||||
operation, never as construction-truth changes."""
|
||||
|
||||
def push(self, repo: str, branch: str) -> dict: ...
|
||||
|
||||
def commit_status(self, repo: str, sha: str) -> str: ...
|
||||
|
||||
def ci_runs_for_sha(self, repo: str, sha: str) -> list[dict]: ...
|
||||
|
||||
def create_or_patch_release(self, repo: str, tag: str,
|
||||
title: str, body: str) -> dict: ...
|
||||
|
||||
|
||||
class ForgeUnavailable(RuntimeError):
|
||||
"""The forge could not be reached or refused the operation."""
|
||||
|
||||
|
||||
class GiteaForge:
|
||||
"""Real adapter. Delegates to the existing canonical implementations
|
||||
(gitea_auth credential ladder; deploy_qualify verdict logic) — no
|
||||
duplicated API clients (rule A)."""
|
||||
|
||||
def __init__(self, server: str | None = None, repo: str = "conductor/rune"):
|
||||
self._server = server # None → scripts' env/credential resolution
|
||||
self._repo = repo
|
||||
|
||||
def _env(self) -> dict:
|
||||
import os
|
||||
env = dict(os.environ)
|
||||
if self._server:
|
||||
env["GITEA_SERVER"] = self._server
|
||||
env.setdefault("GITEA_REPO", self._repo)
|
||||
return env
|
||||
|
||||
def push(self, repo: str, branch: str) -> dict:
|
||||
import subprocess
|
||||
proc = subprocess.run(["git", "push", "gitea", f"master:{branch}"],
|
||||
capture_output=True, text=True)
|
||||
if proc.returncode != 0:
|
||||
raise ForgeUnavailable(f"push failed: {proc.stderr[:200]}")
|
||||
return {"pushed": True, "branch": branch}
|
||||
|
||||
@staticmethod
|
||||
def _gitea_auth():
|
||||
"""Canonical scripts/gitea_auth credential ladder (rule A: no
|
||||
duplicate auth). scripts/ is not a package — path shim, the
|
||||
established spec-loaded-scripts pattern."""
|
||||
import sys
|
||||
from pathlib import Path as _P
|
||||
scripts = _P(__file__).resolve().parents[2] / "scripts"
|
||||
if str(scripts) not in sys.path:
|
||||
sys.path.insert(0, str(scripts))
|
||||
import gitea_auth
|
||||
return gitea_auth
|
||||
|
||||
def commit_status(self, repo: str, sha: str) -> str:
|
||||
import json
|
||||
import os
|
||||
import urllib.request
|
||||
gitea_auth = self._gitea_auth()
|
||||
server = self._server or os.environ.get(
|
||||
"GITEA_SERVER", "https://gitea.thingscouldgetdicey.online")
|
||||
if not gitea_auth.has_token():
|
||||
raise ForgeUnavailable("no forge credentials (gitea token)")
|
||||
req = urllib.request.Request(
|
||||
f"{server}/api/v1/repos/{repo}/commits/{sha}/status",
|
||||
headers={"Authorization": f"token {gitea_auth.get_token()}"})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=15) as r:
|
||||
data = json.loads(r.read())
|
||||
except OSError as exc:
|
||||
raise ForgeUnavailable(f"status unreachable: {exc}") from exc
|
||||
return data.get("state", "unknown")
|
||||
|
||||
def ci_runs_for_sha(self, repo: str, sha: str) -> list[dict]:
|
||||
import json
|
||||
import os
|
||||
import urllib.request
|
||||
gitea_auth = self._gitea_auth()
|
||||
server = self._server or os.environ.get(
|
||||
"GITEA_SERVER", "https://gitea.thingscouldgetdicey.online")
|
||||
if not gitea_auth.has_token():
|
||||
raise ForgeUnavailable("no forge credentials (gitea token)")
|
||||
req = urllib.request.Request(
|
||||
f"{server}/api/v1/repos/{repo}/actions/runs?limit=50",
|
||||
headers={"Authorization": f"token {gitea_auth.get_token()}"})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=15) as r:
|
||||
data = json.loads(r.read())
|
||||
except OSError as exc:
|
||||
raise ForgeUnavailable(f"runs unreachable: {exc}") from exc
|
||||
return [run for run in data.get("workflow_runs", [])
|
||||
if str(run.get("head_sha", "")) == sha]
|
||||
|
||||
def create_or_patch_release(self, repo: str, tag: str,
|
||||
title: str, body: str) -> dict:
|
||||
import json
|
||||
import os
|
||||
import urllib.request
|
||||
gitea_auth = self._gitea_auth()
|
||||
server = self._server or os.environ.get(
|
||||
"GITEA_SERVER", "https://gitea.thingscouldgetdicey.online")
|
||||
if not gitea_auth.has_token():
|
||||
raise ForgeUnavailable("no forge credentials (gitea token)")
|
||||
# delegate to the canonical idempotent publisher
|
||||
import subprocess
|
||||
import sys
|
||||
script = None
|
||||
for cand in ("scripts/create_release.py",):
|
||||
if (sys.path and __import__("pathlib").Path(cand).is_file()):
|
||||
script = cand
|
||||
break
|
||||
if script:
|
||||
proc = subprocess.run(
|
||||
[sys.executable, script, "--tag", tag, "--title", title,
|
||||
"--body", body], capture_output=True, text=True)
|
||||
if proc.returncode != 0:
|
||||
raise ForgeUnavailable(
|
||||
f"release publication failed rc={proc.returncode}: "
|
||||
f"{(proc.stderr or proc.stdout)[-200:]}")
|
||||
return {"published": True, "tag": tag}
|
||||
raise ForgeUnavailable("canonical release publisher not found")
|
||||
|
||||
|
||||
def default_forge() -> ForgeAdapter:
|
||||
"""The working adapter (rule 18L: prove Gitea still works)."""
|
||||
return GiteaForge()
|
||||
@@ -0,0 +1,108 @@
|
||||
"""graph_projection.py — T18 §18Q: stable versioned READ-ONLY graph
|
||||
projection from a structural Scaffold, suitable for later local-web
|
||||
visualisation, GUI, TUI tree, or programmatic queries.
|
||||
|
||||
This is a PROJECTION — never another authority (rule 18Q). Structural
|
||||
truth remains the Scaffold (structural.json) / Spine. Built THROUGH the
|
||||
self-scaffolded upgrade (contract 18q-graph-projection): the upgrade
|
||||
started from the maintained Scaffold, per the 18P proof.
|
||||
|
||||
Formats: versioned JSON (programmatic), DOT and Mermaid (visual —
|
||||
dependency-cruiser-proven human-usable formats per the 18D research).
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
PROJECTION_SCHEMA_VERSION = 1
|
||||
|
||||
|
||||
def project_json(model) -> dict:
|
||||
"""Stable versioned JSON projection: nodes + edges, no internal
|
||||
storage layout leaked (Substrate-safe seam, rule 18E)."""
|
||||
nodes = []
|
||||
for e in model.doc["entities"]:
|
||||
nodes.append({
|
||||
"id": e["id"],
|
||||
"kind": e.get("kind"),
|
||||
"maturity": e.get("maturity"),
|
||||
"name": (e.get("identities") or {}).get("name"),
|
||||
"ext": {k: v for k, v in (e.get("ext") or {}).items()
|
||||
if k in ("source", "bounded_adapter")},
|
||||
})
|
||||
edges = []
|
||||
for r in model.doc["relationships"]:
|
||||
edges.append({
|
||||
"type": r.get("type"),
|
||||
"from": r.get("from"),
|
||||
"to": r.get("to"),
|
||||
"authority": r.get("authority"),
|
||||
"status": r.get("status"),
|
||||
})
|
||||
return {
|
||||
"schema_version": PROJECTION_SCHEMA_VERSION,
|
||||
"project": getattr(model, "project_id", ""),
|
||||
"generated_at": _now(),
|
||||
"node_count": len(nodes),
|
||||
"edge_count": len(edges),
|
||||
"nodes": nodes,
|
||||
"edges": edges,
|
||||
}
|
||||
|
||||
|
||||
def project_dot(model) -> str:
|
||||
"""Graphviz DOT — clusters per domain, edges labeled by type."""
|
||||
lines = ["digraph structural {", " rankdir=LR;",
|
||||
' node [shape=box, style="rounded,filled", fillcolor="#eef"];']
|
||||
for e in model.doc["entities"]:
|
||||
eid = e["id"].replace('"', "'")
|
||||
label = (e.get("identities") or {}).get("name") or \
|
||||
e["id"].split(":", 1)[-1]
|
||||
lines.append(f' "{eid}" [label="{label} ({e["kind"]})"];')
|
||||
for r in model.doc["relationships"]:
|
||||
if r["type"] == "belongs_to" and r.get("status") == "root":
|
||||
continue
|
||||
a = str(r["from"]).replace('"', "'")
|
||||
b = str(r["to"]).replace('"', "'")
|
||||
lines.append(f' "{a}" -> "{b}" [label="{r["type"]}"];')
|
||||
lines.append("}")
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def project_mermaid(model) -> str:
|
||||
"""Mermaid flowchart — renders on GitHub/GitLab/many viewers."""
|
||||
lines = ["graph LR"]
|
||||
ids = {e["id"] for e in model.doc["entities"]}
|
||||
safe = {}
|
||||
for i, eid in enumerate(sorted(ids)):
|
||||
safe[eid] = f"n{i}"
|
||||
for e in model.doc["entities"]:
|
||||
label = ((e.get("identities") or {}).get("name")
|
||||
or e["id"].split(":", 1)[-1]).replace('"', "'")
|
||||
lines.append(f' {safe[e["id"]]}["{label} ({e["kind"]})"]')
|
||||
for r in model.doc["relationships"]:
|
||||
if r["type"] == "belongs_to" and r.get("status") == "root":
|
||||
continue
|
||||
if r["from"] in safe and r["to"] in safe:
|
||||
lines.append(f' {safe[r["from"]]} -->|{r["type"]}| '
|
||||
f'{safe[r["to"]]}')
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def write_all(model, out_dir) -> dict:
|
||||
"""Write all three formats; returns paths. Read-only over truth —
|
||||
writing projections never mutates the model."""
|
||||
import json
|
||||
from pathlib import Path
|
||||
out = Path(out_dir)
|
||||
out.mkdir(parents=True, exist_ok=True)
|
||||
j = out / "structural_graph.json"
|
||||
d = out / "structural_graph.dot"
|
||||
mm = out / "structural_graph.mmd"
|
||||
j.write_text(json.dumps(project_json(model), indent=1, sort_keys=True))
|
||||
d.write_text(project_dot(model))
|
||||
mm.write_text(project_mermaid(model))
|
||||
return {"json": str(j), "dot": str(d), "mermaid": str(mm)}
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
import time
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
@@ -0,0 +1,69 @@
|
||||
"""impact_preview.py — T18 §18G: visible change-impact preview.
|
||||
|
||||
For consequential changes, a user-visible STRUCTURED projection of what
|
||||
a construction will touch — BEFORE build. Derived from the structural
|
||||
Scaffold's impact closure + the Build Basis summary. Contains
|
||||
structured conclusions/evidence only — NEVER private chain-of-thought
|
||||
(rule 18G). This is a projection, not an authority.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
PREVIEW_SCHEMA_VERSION = 1
|
||||
|
||||
|
||||
def build_preview(model, closure: dict, *, basis: dict | None = None,
|
||||
contract_scope: list[str] | None = None) -> dict:
|
||||
"""Assemble the preview from an impact_closure (structural_model)
|
||||
and optionally the Build Basis summary. Pure derivation — no hidden
|
||||
reasoning, no mutation."""
|
||||
if closure.get("error"):
|
||||
return {"schema_version": PREVIEW_SCHEMA_VERSION,
|
||||
"error": closure["error"]}
|
||||
scope = set(closure.get("mutation_scope", []))
|
||||
observation = closure.get("observation_scope") or {}
|
||||
deps = observation.get("direct_dependencies", [])
|
||||
# candidate files: identities' source paths if modeled
|
||||
candidate_files = []
|
||||
for eid in sorted(scope):
|
||||
e = model.get(eid) or {}
|
||||
src = (e.get("identities") or {}).get("source")
|
||||
if src:
|
||||
candidate_files.append(src)
|
||||
return {
|
||||
"schema_version": PREVIEW_SCHEMA_VERSION,
|
||||
"target": closure.get("target"),
|
||||
"affected_domains": ([closure.get("owning_domain")]
|
||||
if closure.get("owning_domain") else []),
|
||||
"affected_subsystems": sorted(
|
||||
e for e in scope if str(e).startswith("subsystem:")),
|
||||
"consumers_connectors": sorted(
|
||||
e for e in scope if e != closure.get("target")),
|
||||
"candidate_files": sorted(set(candidate_files))[:50],
|
||||
"contract_scope_additions": sorted(
|
||||
set(contract_scope or []) - set(candidate_files)),
|
||||
"state_implications": closure.get("state_surfaces", []),
|
||||
"environment_runtime_implications": sorted(
|
||||
model.deployment_surfaces(closure["target"])
|
||||
if model.get(closure["target"]) else []),
|
||||
"migration_implications": (basis or {}).get("implications",
|
||||
{}).get("migration", []),
|
||||
"risks_uncertainties": [
|
||||
*(basis or {}).get("risks", []),
|
||||
*closure.get("uncertainty", []),
|
||||
],
|
||||
"verification_plan": closure.get("verification_scope", []),
|
||||
"rollback_implications": [
|
||||
"revert contract scope commits; deployment rollbacks via "
|
||||
"last-good symlink (canonical deploy machinery)"],
|
||||
"basis_summary": (basis or {}).get("depth"),
|
||||
}
|
||||
|
||||
|
||||
def validate_preview(preview: dict) -> list[str]:
|
||||
errs = []
|
||||
if preview.get("schema_version") != PREVIEW_SCHEMA_VERSION:
|
||||
errs.append("schema_version mismatch")
|
||||
for f in ("target", "verification_plan", "risks_uncertainties"):
|
||||
if f not in preview:
|
||||
errs.append(f"missing {f}")
|
||||
return errs
|
||||
@@ -0,0 +1,190 @@
|
||||
"""iteration.py — T19 §19E/19H/19K: the canonical dependency-aware
|
||||
iteration engine — the "quicksand" solution as STANDARD Scaffolding
|
||||
behaviour.
|
||||
|
||||
Canonical loop (rule 19H):
|
||||
|
||||
intent → target → research/Build Basis → scaffold reconcile →
|
||||
PREDICTIVE impact → bounded mutation scope + wider observation
|
||||
scope → preview → isolated construction → verification →
|
||||
DESCRIPTIVE impact → predicted-vs-observed delta → structural
|
||||
truth update → selective validation invalidation → obligations →
|
||||
iterate → harden.
|
||||
|
||||
Built ON the T18 foundation (rule C): structural_model.impact_closure,
|
||||
build_basis, impact_preview, drift_resume — no second anything.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
from rune.capability_ledger import CapabilityLedger
|
||||
from rune.behaviour_ledger import BehaviourLedger
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
|
||||
|
||||
# ── 19E: surgical context packets ────────────────────────────────────────
|
||||
|
||||
def context_packet(model, ledger: CapabilityLedger, target: str, *,
|
||||
intent: str = "", basis_summary: dict | None = None,
|
||||
max_local_files: int = 12) -> dict:
|
||||
"""LOCAL + CONNECTED context for one structural target (rule 19E).
|
||||
Bounded and proportional: the whole graph is NEVER dumped. Local =
|
||||
the target's own ledger entry; connected = 1-hop structural
|
||||
neighbours with their ledgers on demand."""
|
||||
entity = model.get(target)
|
||||
if entity is None:
|
||||
return {"error": f"unknown structural target {target!r}"}
|
||||
caps = ledger.by_component(target)
|
||||
local = ledger.context_packet(caps[0]["capability_id"]) if caps else None
|
||||
beneath = [b for b in model.beneath(target)
|
||||
if not model.get(b).get("identities", {}).get("source")]
|
||||
files: list[str] = []
|
||||
for eid in [target] + model.children(target):
|
||||
e = model.get(eid) or {}
|
||||
src = (e.get("ext") or {}).get("source") or \
|
||||
(e.get("identities") or {}).get("source")
|
||||
if src:
|
||||
files.append(src)
|
||||
for cap in caps:
|
||||
files.extend(cap.get("source_locations", []))
|
||||
closure = model.impact_closure(target)
|
||||
# interface-mediated consumers: consumers of the interfaces this
|
||||
# target provides (1-hop through the connector, still bounded)
|
||||
iface_consumers = sorted({c for iface in model.interfaces_for(target)
|
||||
for c in model.consumers(iface)
|
||||
if c != target})
|
||||
connected = {
|
||||
"dependencies": model.dependencies(target),
|
||||
"consumers": sorted(set(model.consumers(target)) |
|
||||
set(iface_consumers)),
|
||||
"interface_mediated_consumers": iface_consumers,
|
||||
"interfaces_provided": model.interfaces_for(target),
|
||||
"state_owned": model.state_owned(target),
|
||||
"verification": model.verification_surfaces(target),
|
||||
"deployment": model.deployment_surfaces(target),
|
||||
"uncertainty": closure.get("uncertainty", []),
|
||||
}
|
||||
return {
|
||||
"schema_version": 1,
|
||||
"intent": intent,
|
||||
"target": target,
|
||||
"target_kind": entity.get("kind"),
|
||||
"owning_domain": model.owning_domain(target),
|
||||
"local": local,
|
||||
"local_files": sorted(set(files))[:max_local_files],
|
||||
"beneath_count": len(beneath),
|
||||
"connected": connected,
|
||||
"basis_summary": basis_summary,
|
||||
"generated_at": _now(),
|
||||
}
|
||||
|
||||
|
||||
# ── 19H: predictive vs descriptive impact ────────────────────────────────
|
||||
|
||||
def predictive_impact(model, target: str) -> dict:
|
||||
"""What MAY be affected BEFORE the change (structural closure)."""
|
||||
return model.impact_closure(target)
|
||||
|
||||
|
||||
def descriptive_impact(model, target: str, *,
|
||||
observed_changed: list[str],
|
||||
generation: str = "") -> dict:
|
||||
"""What was MATERIALLY affected AFTER the change — from actual
|
||||
evidence (diff/observations), never assumed from the graph alone."""
|
||||
predicted = model.impact_closure(target)
|
||||
predicted_scope = set(predicted.get("mutation_scope", []))
|
||||
observed = set(observed_changed)
|
||||
return {
|
||||
"target": target,
|
||||
"generation": generation,
|
||||
"predicted": sorted(predicted_scope),
|
||||
"observed": sorted(observed),
|
||||
"unexpected": sorted(observed - predicted_scope), # prediction missed
|
||||
"unaffected_as_predicted": sorted(predicted_scope - observed),
|
||||
"recorded_at": _now(),
|
||||
}
|
||||
|
||||
|
||||
def record_impact_delta(project_store: Path, delta: dict) -> Path:
|
||||
"""Persist predicted-vs-observed deltas — they compound into better
|
||||
future impact prediction (rule 19H)."""
|
||||
p = Path(project_store) / "impact_deltas.jsonl"
|
||||
import json
|
||||
with p.open("a") as f:
|
||||
f.write(json.dumps(delta, sort_keys=True) + "\n")
|
||||
return p
|
||||
|
||||
|
||||
# ── 19I: selective invalidation bridge ───────────────────────────────────
|
||||
|
||||
def invalidate_behaviours(model, behaviours: BehaviourLedger, *,
|
||||
changed_entities: set[str], generation: str = ""
|
||||
) -> list[dict]:
|
||||
"""Selective invalidation driven by STRUCTURAL truth: behaviours
|
||||
whose dependencies/owner intersect the changed closure reopen;
|
||||
everything else keeps its confidence (rule 19I)."""
|
||||
return behaviours.invalidate_for_change(
|
||||
changed_entities=changed_entities, generation=generation)
|
||||
|
||||
|
||||
# ── 19K: post-change obligations ─────────────────────────────────────────
|
||||
|
||||
def post_change_obligations(model, target: str, *,
|
||||
behaviours: BehaviourLedger | None = None,
|
||||
changed_entities: set[str] | None = None,
|
||||
) -> list[dict]:
|
||||
"""Machine-derived follow-up obligations from STRUCTURAL truth
|
||||
(rule 19K) — never an improvised generic checklist."""
|
||||
changed = changed_entities or {target}
|
||||
obligations: list[dict] = []
|
||||
seen: set[tuple] = set()
|
||||
|
||||
def add(kind: str, target_e: str, why: str) -> None:
|
||||
key = (kind, target_e)
|
||||
if key not in seen:
|
||||
seen.add(key)
|
||||
obligations.append({"kind": kind, "target": target_e,
|
||||
"why": why})
|
||||
|
||||
for eid in sorted(changed):
|
||||
# consumers of a changed component must be inspected
|
||||
for consumer in model.consumers(eid):
|
||||
add("inspect_consumer", consumer,
|
||||
f"consumes/depends on changed {eid}")
|
||||
# provided interfaces: every consumer of the interface is affected
|
||||
for iface in model.interfaces_for(eid):
|
||||
add("verify_interface", iface,
|
||||
f"provided by changed {eid}")
|
||||
for consumer in model.consumers(iface):
|
||||
add("inspect_consumer", consumer,
|
||||
f"consumes {iface} provided by changed {eid}")
|
||||
# state compatibility
|
||||
for store in model.state_owned(eid):
|
||||
add("check_state_compatibility", store,
|
||||
f"state owned by changed {eid}")
|
||||
# interfaces the target consumes
|
||||
for iface in model.consumers(eid) if False else []:
|
||||
pass
|
||||
consumed = sorted(r["to"] for r in model.doc["relationships"]
|
||||
if r["type"] == "consumes" and r["from"] == eid)
|
||||
for iface in consumed:
|
||||
add("check_interface_contract", iface,
|
||||
f"changed {eid} consumes {iface} — contract must still hold")
|
||||
# deployment
|
||||
for dep in model.deployment_surfaces(eid):
|
||||
add("verify_deployment", dep,
|
||||
f"deployed surface of changed {eid}")
|
||||
# behaviour retests
|
||||
if behaviours is not None:
|
||||
for rec in behaviours.doc["behaviours"].values():
|
||||
deps = set(rec.get("dependencies") or []) | {
|
||||
rec.get("owner_component")}
|
||||
if deps & changed:
|
||||
add("retest", rec["behaviour_id"],
|
||||
f"depends on changed {sorted(deps & changed)}")
|
||||
return obligations
|
||||
@@ -1,366 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Build Mode Plugin — State machine orchestrator.
|
||||
|
||||
Each phase is an independent module. The state machine coordinates:
|
||||
1. Read current state from checkpoint file
|
||||
2. Execute the current phase's module
|
||||
3. Write output to checkpoint file
|
||||
4. Advance to next phase
|
||||
5. Repeat
|
||||
|
||||
Key insight from Gauntlet: "Checkpoint files on disk. Reports generated
|
||||
from checkpoints, not memory." If the conversation dies, the next session
|
||||
resumes from the last checkpoint. No drift because state is on disk.
|
||||
|
||||
Architecture:
|
||||
- Each phase is a separate module in phases/
|
||||
- State machine reads checkpoint.json to know current phase
|
||||
- Each phase writes its output to checkpoint.json
|
||||
- Cron tasks fire each phase independently
|
||||
- Ledger tracks progress for resumability
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
from datetime import datetime, timezone
|
||||
from typing import Optional, Dict, Any, List
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# CONFIGURATION
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
PLUGIN_DIR = os.path.dirname(os.path.abspath(__file__))
|
||||
PHASES_DIR = os.path.join(PLUGIN_DIR, "phases")
|
||||
BUILDS_DIR = os.path.expanduser("~/.rune/work/builds")
|
||||
WORKTREE_DIR = os.path.expanduser("~/.rune/worktrees")
|
||||
REPO_DIR = "/mnt/workdrive/rune"
|
||||
|
||||
# Phase execution order
|
||||
PHASE_ORDER = [
|
||||
"assess",
|
||||
"research",
|
||||
"feasible",
|
||||
"consult",
|
||||
"consent",
|
||||
"plan",
|
||||
"build",
|
||||
"verify",
|
||||
"correct",
|
||||
"integrate",
|
||||
"record",
|
||||
]
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# STATE MACHINE
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
|
||||
class BuildStateMachine:
|
||||
"""State machine for build mode. Reads/writes checkpoint files."""
|
||||
|
||||
def __init__(self, build_id: str):
|
||||
self.build_id = build_id
|
||||
self.build_dir = os.path.join(BUILDS_DIR, build_id)
|
||||
self.checkpoint_path = os.path.join(self.build_dir, "checkpoint.json")
|
||||
self.ledger_path = os.path.join(self.build_dir, "ledger.json")
|
||||
self.trajectory_path = os.path.join(self.build_dir, "trajectory.json")
|
||||
|
||||
os.makedirs(self.build_dir, exist_ok=True)
|
||||
|
||||
def load_checkpoint(self) -> Dict[str, Any]:
|
||||
"""Load current state from checkpoint file."""
|
||||
if os.path.exists(self.checkpoint_path):
|
||||
with open(self.checkpoint_path) as f:
|
||||
return json.load(f)
|
||||
return self._initial_checkpoint()
|
||||
|
||||
def save_checkpoint(self, checkpoint: Dict[str, Any]):
|
||||
"""Save state to checkpoint file."""
|
||||
checkpoint["updated_at"] = datetime.now(timezone.utc).isoformat()
|
||||
with open(self.checkpoint_path, "w") as f:
|
||||
json.dump(checkpoint, f, indent=2)
|
||||
|
||||
def _initial_checkpoint(self) -> Dict[str, Any]:
|
||||
"""Create initial checkpoint."""
|
||||
return {
|
||||
"build_id": self.build_id,
|
||||
"created_at": datetime.now(timezone.utc).isoformat(),
|
||||
"updated_at": datetime.now(timezone.utc).isoformat(),
|
||||
"current_phase": "assess",
|
||||
"phase_status": "pending",
|
||||
"phases": {},
|
||||
"description": "",
|
||||
"worktree_path": None,
|
||||
"complexity_score": 0,
|
||||
"estimated_steps": 0,
|
||||
"batches": [],
|
||||
"corrections": 0,
|
||||
"max_corrections": 3,
|
||||
"files_changed": [],
|
||||
"contracts": [],
|
||||
"failure_patterns": [],
|
||||
}
|
||||
|
||||
def get_current_phase(self) -> str:
|
||||
"""Get current phase from checkpoint."""
|
||||
checkpoint = self.load_checkpoint()
|
||||
return checkpoint.get("current_phase", "assess")
|
||||
|
||||
def get_phase_status(self) -> str:
|
||||
"""Get current phase status from checkpoint."""
|
||||
checkpoint = self.load_checkpoint()
|
||||
return checkpoint.get("phase_status", "pending")
|
||||
|
||||
def advance_phase(self):
|
||||
"""Advance to next phase."""
|
||||
checkpoint = self.load_checkpoint()
|
||||
current = checkpoint["current_phase"]
|
||||
|
||||
# Mark current phase as complete
|
||||
checkpoint["phases"][current] = "complete"
|
||||
|
||||
# Find next phase
|
||||
try:
|
||||
idx = PHASE_ORDER.index(current)
|
||||
if idx + 1 < len(PHASE_ORDER):
|
||||
next_phase = PHASE_ORDER[idx + 1]
|
||||
checkpoint["current_phase"] = next_phase
|
||||
checkpoint["phase_status"] = "pending"
|
||||
else:
|
||||
checkpoint["phase_status"] = "complete"
|
||||
except ValueError:
|
||||
pass
|
||||
|
||||
self.save_checkpoint(checkpoint)
|
||||
|
||||
def set_phase_status(self, status: str, details: Dict[str, Any] = None):
|
||||
"""Set current phase status."""
|
||||
checkpoint = self.load_checkpoint()
|
||||
checkpoint["phase_status"] = status
|
||||
if details:
|
||||
checkpoint.update(details)
|
||||
self.save_checkpoint(checkpoint)
|
||||
|
||||
def log_to_ledger(self, entry: Dict[str, Any]):
|
||||
"""Append entry to ledger."""
|
||||
ledger = []
|
||||
if os.path.exists(self.ledger_path):
|
||||
with open(self.ledger_path) as f:
|
||||
ledger = json.load(f)
|
||||
|
||||
entry["timestamp"] = datetime.now(timezone.utc).isoformat()
|
||||
ledger.append(entry)
|
||||
|
||||
with open(self.ledger_path, "w") as f:
|
||||
json.dump(ledger, f, indent=2)
|
||||
|
||||
def log_trajectory(self, action: str, details: Dict[str, Any] = None):
|
||||
"""Append to trajectory log (like SWE-agent .traj files)."""
|
||||
trajectory = []
|
||||
if os.path.exists(self.trajectory_path):
|
||||
with open(self.trajectory_path) as f:
|
||||
trajectory = json.load(f)
|
||||
|
||||
entry = {
|
||||
"timestamp": datetime.now(timezone.utc).isoformat(),
|
||||
"action": action,
|
||||
"details": details or {},
|
||||
}
|
||||
trajectory.append(entry)
|
||||
|
||||
with open(self.trajectory_path, "w") as f:
|
||||
json.dump(trajectory, f, indent=2)
|
||||
|
||||
def get_resume_point(self) -> Optional[str]:
|
||||
"""Get phase to resume from."""
|
||||
checkpoint = self.load_checkpoint()
|
||||
current = checkpoint.get("current_phase")
|
||||
status = checkpoint.get("phase_status")
|
||||
|
||||
if status == "complete":
|
||||
# All phases complete
|
||||
return None
|
||||
|
||||
return current
|
||||
|
||||
def can_resume(self) -> bool:
|
||||
"""Check if build can be resumed."""
|
||||
return self.get_resume_point() is not None
|
||||
|
||||
def get_status(self) -> Dict[str, Any]:
|
||||
"""Get build status."""
|
||||
checkpoint = self.load_checkpoint()
|
||||
return {
|
||||
"build_id": self.build_id,
|
||||
"description": checkpoint.get("description", ""),
|
||||
"current_phase": checkpoint.get("current_phase", "assess"),
|
||||
"phase_status": checkpoint.get("phase_status", "pending"),
|
||||
"phases": checkpoint.get("phases", {}),
|
||||
"batches": len(checkpoint.get("batches", [])),
|
||||
"corrections": checkpoint.get("corrections", 0),
|
||||
"worktree": checkpoint.get("worktree_path"),
|
||||
"complexity_score": checkpoint.get("complexity_score", 0),
|
||||
"estimated_steps": checkpoint.get("estimated_steps", 0),
|
||||
}
|
||||
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# PHASE EXECUTION
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
|
||||
def execute_phase(build_id: str, phase: str = None) -> Dict[str, Any]:
|
||||
"""Execute a phase. If phase is None, execute current phase."""
|
||||
sm = BuildStateMachine(build_id)
|
||||
|
||||
if phase is None:
|
||||
phase = sm.get_current_phase()
|
||||
|
||||
# Check if phase module exists
|
||||
phase_module_path = os.path.join(PHASES_DIR, f"{phase}.py")
|
||||
if not os.path.exists(phase_module_path):
|
||||
return {"success": False, "error": f"Phase module not found: {phase}"}
|
||||
|
||||
# Import and execute phase module
|
||||
try:
|
||||
import importlib.util
|
||||
|
||||
spec = importlib.util.spec_from_file_location(f"phase_{phase}", phase_module_path)
|
||||
module = importlib.util.module_from_spec(spec)
|
||||
spec.loader.exec_module(module)
|
||||
|
||||
# Execute phase
|
||||
result = module.execute(sm)
|
||||
|
||||
# Log to trajectory
|
||||
sm.log_trajectory(f"phase_{phase}", {"result": result})
|
||||
|
||||
# Advance to next phase if successful
|
||||
if result.get("success"):
|
||||
sm.advance_phase()
|
||||
|
||||
return result
|
||||
|
||||
except Exception as e:
|
||||
sm.log_trajectory(f"phase_{phase}_error", {"error": str(e)})
|
||||
return {"success": False, "error": str(e)}
|
||||
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# CLI
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
|
||||
def main():
|
||||
if len(sys.argv) < 2:
|
||||
print("Usage: build_mode_plugin.py [start|status|resume|execute|abort]")
|
||||
sys.exit(1)
|
||||
|
||||
cmd = sys.argv[1]
|
||||
|
||||
if cmd == "start":
|
||||
if len(sys.argv) < 3:
|
||||
print("Usage: build_mode_plugin.py start <description>")
|
||||
sys.exit(1)
|
||||
description = " ".join(sys.argv[2:])
|
||||
build_id = datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%S")
|
||||
sm = BuildStateMachine(build_id)
|
||||
checkpoint = sm.load_checkpoint()
|
||||
checkpoint["description"] = description
|
||||
sm.save_checkpoint(checkpoint)
|
||||
sm.log_to_ledger({"action": "build_started", "description": description})
|
||||
print(f"✅ Build {build_id} started")
|
||||
print(f" Description: {description}")
|
||||
print(f" Checkpoint: {sm.checkpoint_path}")
|
||||
|
||||
elif cmd == "status":
|
||||
if len(sys.argv) < 3:
|
||||
# List all builds
|
||||
if os.path.exists(BUILDS_DIR):
|
||||
builds = os.listdir(BUILDS_DIR)
|
||||
if builds:
|
||||
print(f"Builds: {len(builds)}")
|
||||
for build_id in sorted(builds):
|
||||
try:
|
||||
sm = BuildStateMachine(build_id)
|
||||
status = sm.get_status()
|
||||
print(
|
||||
f" {build_id}: {status['description']} ({status['current_phase']}: {status['phase_status']})"
|
||||
)
|
||||
except Exception:
|
||||
pass
|
||||
else:
|
||||
print("No builds found.")
|
||||
else:
|
||||
print("No builds found.")
|
||||
else:
|
||||
build_id = sys.argv[2]
|
||||
try:
|
||||
sm = BuildStateMachine(build_id)
|
||||
status = sm.get_status()
|
||||
print(f"Build: {status['build_id']}")
|
||||
print(f" Description: {status['description']}")
|
||||
print(f" Phase: {status['current_phase']} ({status['phase_status']})")
|
||||
print(f" Batches: {status['batches']}")
|
||||
print(f" Corrections: {status['corrections']}")
|
||||
print(f" Worktree: {status['worktree']}")
|
||||
print(f" Complexity: {status['complexity_score']}")
|
||||
print(f" Estimated steps: {status['estimated_steps']}")
|
||||
except FileNotFoundError:
|
||||
print(f"Build {build_id} not found")
|
||||
|
||||
elif cmd == "resume":
|
||||
if len(sys.argv) < 3:
|
||||
print("Usage: build_mode_plugin.py resume <build_id>")
|
||||
sys.exit(1)
|
||||
build_id = sys.argv[2]
|
||||
try:
|
||||
sm = BuildStateMachine(build_id)
|
||||
if sm.can_resume():
|
||||
resume_point = sm.get_resume_point()
|
||||
print(f"Resuming build {build_id} from phase: {resume_point}")
|
||||
# Execute the current phase
|
||||
result = execute_phase(build_id)
|
||||
print(f"Result: {result}")
|
||||
else:
|
||||
print(f"Build {build_id} cannot be resumed (all phases complete)")
|
||||
except FileNotFoundError:
|
||||
print(f"Build {build_id} not found")
|
||||
|
||||
elif cmd == "execute":
|
||||
if len(sys.argv) < 3:
|
||||
print("Usage: build_mode_plugin.py execute <build_id> [phase]")
|
||||
sys.exit(1)
|
||||
build_id = sys.argv[2]
|
||||
phase = sys.argv[3] if len(sys.argv) > 3 else None
|
||||
result = execute_phase(build_id, phase)
|
||||
print(json.dumps(result, indent=2))
|
||||
|
||||
elif cmd == "abort":
|
||||
if len(sys.argv) < 3:
|
||||
print("Usage: build_mode_plugin.py abort <build_id>")
|
||||
sys.exit(1)
|
||||
build_id = sys.argv[2]
|
||||
try:
|
||||
sm = BuildStateMachine(build_id)
|
||||
checkpoint = sm.load_checkpoint()
|
||||
worktree = checkpoint.get("worktree_path")
|
||||
if worktree:
|
||||
subprocess.run(
|
||||
["git", "worktree", "remove", worktree, "--force"],
|
||||
cwd=REPO_DIR,
|
||||
capture_output=True,
|
||||
)
|
||||
sm.log_to_ledger({"action": "build_aborted"})
|
||||
print(f"✅ Build {build_id} aborted")
|
||||
except FileNotFoundError:
|
||||
print(f"Build {build_id} not found")
|
||||
|
||||
else:
|
||||
print(f"Unknown command: {cmd}")
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -1,115 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Assess phase — Complexity scoring and codebase impact estimation.
|
||||
|
||||
This is the first phase. It scores the user's request to determine:
|
||||
- If build mode is needed (score 8+)
|
||||
- How many steps are estimated
|
||||
- What files will be affected
|
||||
|
||||
Output: Updates checkpoint with complexity_score, estimated_steps, description.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
# Add parent to path for imports
|
||||
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
||||
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", ".."))
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the assess phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
description = checkpoint.get("description", "")
|
||||
|
||||
if not description:
|
||||
return {"success": False, "error": "No description provided"}
|
||||
|
||||
# Import complexity scorer
|
||||
try:
|
||||
from rune.complexity_scorer import score_request
|
||||
|
||||
breakdown = score_request(description)
|
||||
except Exception as e:
|
||||
return {"success": False, "error": f"Complexity scorer failed: {e}"}
|
||||
|
||||
# Update checkpoint
|
||||
checkpoint["complexity_score"] = breakdown.total
|
||||
checkpoint["estimated_steps"] = _estimate_steps(description)
|
||||
checkpoint["assess_signals"] = breakdown.signals
|
||||
checkpoint["assess_mode"] = breakdown.mode
|
||||
checkpoint["assess_confidence"] = breakdown.confidence
|
||||
sm.save_checkpoint(checkpoint)
|
||||
|
||||
# Log to ledger
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "assess_complete",
|
||||
"complexity_score": breakdown.total,
|
||||
"estimated_steps": checkpoint["estimated_steps"],
|
||||
"mode": breakdown.mode,
|
||||
"confidence": breakdown.confidence,
|
||||
"signals": breakdown.signals,
|
||||
}
|
||||
)
|
||||
|
||||
# Check if build mode is needed
|
||||
if breakdown.total < 8:
|
||||
return {
|
||||
"success": True,
|
||||
"build_mode_needed": False,
|
||||
"complexity_score": breakdown.total,
|
||||
"estimated_steps": checkpoint["estimated_steps"],
|
||||
"mode": breakdown.mode,
|
||||
"reason": f"Score {breakdown.total} < 8, task mode recommended",
|
||||
}
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"build_mode_needed": True,
|
||||
"complexity_score": breakdown.total,
|
||||
"estimated_steps": checkpoint["estimated_steps"],
|
||||
"mode": breakdown.mode,
|
||||
"confidence": breakdown.confidence,
|
||||
"signals": breakdown.signals,
|
||||
}
|
||||
|
||||
|
||||
def _estimate_steps(description: str) -> int:
|
||||
"""Estimate number of steps from description."""
|
||||
steps = 0
|
||||
desc_lower = description.lower()
|
||||
|
||||
# Each distinct verb ≈ 1-2 steps
|
||||
verbs = [
|
||||
"add",
|
||||
"create",
|
||||
"build",
|
||||
"implement",
|
||||
"update",
|
||||
"fix",
|
||||
"refactor",
|
||||
"migrate",
|
||||
"test",
|
||||
"deploy",
|
||||
"configure",
|
||||
"integrate",
|
||||
"design",
|
||||
]
|
||||
verb_count = sum(1 for v in verbs if v in desc_lower)
|
||||
steps += verb_count * 2
|
||||
|
||||
# Each "and" or "then" ≈ 1 step
|
||||
conjunctions = ["and", "then", "also", "plus"]
|
||||
conjunction_count = sum(1 for c in conjunctions if c in desc_lower)
|
||||
steps += conjunction_count
|
||||
|
||||
# Each file reference ≈ 1 step
|
||||
import re
|
||||
|
||||
file_refs = re.findall(r"\b\w+\.\w+\b", description)
|
||||
steps += len(file_refs)
|
||||
|
||||
# Minimum 3 steps for build mode
|
||||
return max(steps, 3)
|
||||
@@ -1,42 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Build phase — Execute batches in 3 phases.
|
||||
|
||||
Three-phase execution:
|
||||
1. Foundation: Types, interfaces, shared utilities
|
||||
2. Implementation: Feature code
|
||||
3. Integration: Tests, wiring, documentation
|
||||
|
||||
Output: Updates checkpoint with build results.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any, List
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the build phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
batches = checkpoint.get("batches", [])
|
||||
|
||||
if not batches:
|
||||
return {"success": False, "error": "No batches to build"}
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "build_started",
|
||||
"batches": len(batches),
|
||||
}
|
||||
)
|
||||
|
||||
# Build is done by the TUI's model
|
||||
# This module just tracks the state
|
||||
|
||||
sm.set_phase_status("in_progress", {"build_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"build_needed": True,
|
||||
"batches": batches,
|
||||
"instruction": "Execute batches in 3 phases: Foundation → Implementation → Integration",
|
||||
}
|
||||
@@ -1,39 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Consent phase — User approval.
|
||||
|
||||
Presents the plan to the user and waits for approval.
|
||||
Output: Updates checkpoint with approved.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the consent phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
description = checkpoint.get("description", "")
|
||||
complexity_score = checkpoint.get("complexity_score", 0)
|
||||
estimated_steps = checkpoint.get("estimated_steps", 0)
|
||||
patterns = checkpoint.get("consult_patterns", [])
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "consent_started",
|
||||
"description": description,
|
||||
}
|
||||
)
|
||||
|
||||
# Consent is handled by the TUI
|
||||
# This module just prepares the approval request
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"consent_needed": True,
|
||||
"description": description,
|
||||
"complexity_score": complexity_score,
|
||||
"estimated_steps": estimated_steps,
|
||||
"patterns": patterns,
|
||||
"instruction": "Present plan to user and wait for approval",
|
||||
}
|
||||
@@ -1,68 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Consult phase — Knowledge base check + failure pattern lookup.
|
||||
|
||||
Checks llm-craft and textual-craft knowledge bases for best practices.
|
||||
Queries failure pattern database for similar past failures.
|
||||
Output: Updates checkpoint with patterns, best_practices.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the consult phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
description = checkpoint.get("description", "")
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "consult_started",
|
||||
"description": description,
|
||||
}
|
||||
)
|
||||
|
||||
# Query knowledge bases
|
||||
patterns = []
|
||||
best_practices = []
|
||||
|
||||
try:
|
||||
# Check llm-craft knowledge base
|
||||
kb_path = os.path.join(os.path.dirname(__file__), "..", "..", "skills", "llm-craft", "knowledge.md")
|
||||
if os.path.exists(kb_path):
|
||||
with open(kb_path) as f:
|
||||
content = f.read()
|
||||
# Extract relevant patterns
|
||||
if "test" in description.lower():
|
||||
patterns.append("Use contract testing for interface verification")
|
||||
if "refactor" in description.lower():
|
||||
patterns.append("Refactor in small steps, verify after each change")
|
||||
if "new feature" in description.lower():
|
||||
patterns.append("Start with interface definition, then implementation")
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
# Query failure patterns
|
||||
failure_patterns = checkpoint.get("failure_patterns", [])
|
||||
if failure_patterns:
|
||||
best_practices.append(f"Learn from {len(failure_patterns)} past failures")
|
||||
|
||||
# Update checkpoint
|
||||
checkpoint["consult_patterns"] = patterns
|
||||
checkpoint["consult_best_practices"] = best_practices
|
||||
sm.save_checkpoint(checkpoint)
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "consult_complete",
|
||||
"patterns": patterns,
|
||||
"best_practices": best_practices,
|
||||
}
|
||||
)
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"patterns": patterns,
|
||||
"best_practices": best_practices,
|
||||
}
|
||||
@@ -1,46 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Correct phase — Fix failed batches.
|
||||
|
||||
3 attempts max per batch. After 2 failures, re-plan instead of blindly retrying.
|
||||
Output: Updates checkpoint with corrections.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the correct phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
corrections = checkpoint.get("corrections", 0)
|
||||
max_corrections = checkpoint.get("max_corrections", 3)
|
||||
|
||||
if corrections >= max_corrections:
|
||||
return {
|
||||
"success": False,
|
||||
"error": f"Max corrections ({max_corrections}) reached",
|
||||
"instruction": "Escalate to user with diagnostic summary",
|
||||
}
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "correct_started",
|
||||
"corrections": corrections,
|
||||
}
|
||||
)
|
||||
|
||||
# Correct is done by the TUI
|
||||
# This module just tracks the state
|
||||
|
||||
checkpoint["corrections"] = corrections + 1
|
||||
sm.save_checkpoint(checkpoint)
|
||||
|
||||
sm.set_phase_status("in_progress", {"correct_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"correct_needed": True,
|
||||
"corrections": corrections + 1,
|
||||
"instruction": "Fix failed batches, re-verify. After 2 failures, re-plan.",
|
||||
}
|
||||
@@ -1,37 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Feasible phase — Feasibility gate + complexity report.
|
||||
|
||||
Checks if the task is feasible based on research findings.
|
||||
Output: Updates checkpoint with feasible, risk, complexity_report.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the feasible phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
description = checkpoint.get("description", "")
|
||||
research = checkpoint.get("research_findings", {})
|
||||
|
||||
# Feasibility is determined by the TUI's model
|
||||
# This module just tracks the state
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "feasible_started",
|
||||
"description": description,
|
||||
}
|
||||
)
|
||||
|
||||
sm.set_phase_status("in_progress", {"feasibility_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"feasibility_needed": True,
|
||||
"description": description,
|
||||
"research": research,
|
||||
"instruction": "Assess feasibility based on research findings",
|
||||
}
|
||||
@@ -1,32 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Integrate phase — Scope guardian (full test suite).
|
||||
|
||||
Runs full verification after all batches pass.
|
||||
Output: Updates checkpoint with integration results.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the integrate phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "integrate_started",
|
||||
}
|
||||
)
|
||||
|
||||
# Integrate is done by the TUI
|
||||
# This module just tracks the state
|
||||
|
||||
sm.set_phase_status("in_progress", {"integrate_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"integrate_needed": True,
|
||||
"instruction": "Run full test suite: canary + ruff + pyright + contracts + TUI validator",
|
||||
}
|
||||
@@ -1,41 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Plan phase — Work manager creates batches with dependency DAG.
|
||||
|
||||
Creates batches of 1-3 files each, routes to local or cloud models.
|
||||
Output: Updates checkpoint with batches.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any, List
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the plan phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
description = checkpoint.get("description", "")
|
||||
complexity_score = checkpoint.get("complexity_score", 0)
|
||||
estimated_steps = checkpoint.get("estimated_steps", 0)
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "plan_started",
|
||||
"description": description,
|
||||
"complexity_score": complexity_score,
|
||||
"estimated_steps": estimated_steps,
|
||||
}
|
||||
)
|
||||
|
||||
# Plan is done by the TUI's model
|
||||
# This module just tracks the state
|
||||
|
||||
sm.set_phase_status("in_progress", {"plan_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"plan_needed": True,
|
||||
"description": description,
|
||||
"complexity_score": complexity_score,
|
||||
"estimated_steps": estimated_steps,
|
||||
"instruction": "Create batches with dependency DAG, route to models",
|
||||
}
|
||||
@@ -1,38 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Record phase — Update PRD, GitHub, knowledge base, trajectory log.
|
||||
|
||||
Final phase. Updates all documentation and records what was learned.
|
||||
Output: Updates checkpoint with record results.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the record phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
build_id = sm.build_id
|
||||
description = checkpoint.get("description", "")
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "record_started",
|
||||
"build_id": build_id,
|
||||
"description": description,
|
||||
}
|
||||
)
|
||||
|
||||
# Record is done by the TUI
|
||||
# This module just tracks the state
|
||||
|
||||
sm.set_phase_status("in_progress", {"record_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"record_needed": True,
|
||||
"build_id": build_id,
|
||||
"description": description,
|
||||
"instruction": "Update PRD, commit to GitHub, update knowledge base with learnings",
|
||||
}
|
||||
@@ -1,41 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Research phase — Deep research on the task.
|
||||
|
||||
Always runs for build mode. Uses deep-research skill or parallel sub-agents.
|
||||
Output: Updates checkpoint with research_findings.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the research phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
description = checkpoint.get("description", "")
|
||||
|
||||
if not description:
|
||||
return {"success": False, "error": "No description provided"}
|
||||
|
||||
# Log to ledger
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "research_started",
|
||||
"description": description,
|
||||
}
|
||||
)
|
||||
|
||||
# Research is done by the TUI's model (not this module)
|
||||
# This module just tracks the state
|
||||
# The actual research happens in the TUI's _send_to_model flow
|
||||
|
||||
# For now, mark as needing external research
|
||||
sm.set_phase_status("in_progress", {"research_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"research_needed": True,
|
||||
"description": description,
|
||||
"instruction": "Use deep-research skill or parallel sub-agents to research this task",
|
||||
}
|
||||
@@ -1,40 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Verify phase — Tiered verification.
|
||||
|
||||
Tiered verification strategy:
|
||||
1. Syntactic: Per-edit lint, type-check, format (<1s)
|
||||
2. Semantic: Per-batch unit tests, import validation (<30s)
|
||||
3. Integration: Per-wave contract tests, build/compile (<5min)
|
||||
4. System: Full test suite, property-based (<15min)
|
||||
|
||||
Output: Updates checkpoint with verification results.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
from typing import Dict, Any
|
||||
|
||||
|
||||
def execute(sm) -> Dict[str, Any]:
|
||||
"""Execute the verify phase."""
|
||||
checkpoint = sm.load_checkpoint()
|
||||
batches = checkpoint.get("batches", [])
|
||||
|
||||
sm.log_to_ledger(
|
||||
{
|
||||
"action": "verify_started",
|
||||
"batches": len(batches),
|
||||
}
|
||||
)
|
||||
|
||||
# Verify is done by the TUI
|
||||
# This module just tracks the state
|
||||
|
||||
sm.set_phase_status("in_progress", {"verify_requested": True})
|
||||
|
||||
return {
|
||||
"success": True,
|
||||
"verify_needed": True,
|
||||
"batches": batches,
|
||||
"instruction": "Run tiered verification: syntactic → semantic → integration → system",
|
||||
}
|
||||
@@ -0,0 +1,112 @@
|
||||
"""project_registry.py — T19 §19C: canonical registry of scaffolded
|
||||
projects.
|
||||
|
||||
BOUNDARIES (rule 19C, proven by tests):
|
||||
- Registry = DISCOVERY/INDEX (what projects exist, where their truth
|
||||
lives, health/migration state).
|
||||
- Project Scaffold/structural model = project structural truth
|
||||
(never duplicated here).
|
||||
- Spine = Rune's structural self-model. An external project's Scaffold
|
||||
does NOT become Spine structure because Rune knows it exists.
|
||||
|
||||
Registry state: one JSON document (versioned, provenance-aware per rule
|
||||
G) at <store_dir>/project_registry.json. Operational uses: /testing
|
||||
across projects (19L), drift/migration sweeps, re-entry discovery.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
REGISTRY_SCHEMA_VERSION = 1
|
||||
|
||||
# project health states (operational: drives /testing and migration
|
||||
# consent sweeps)
|
||||
HEALTHY = "HEALTHY"
|
||||
DRIFTED = "DRIFTED"
|
||||
MIGRATION_REQUIRED = "MIGRATION_REQUIRED"
|
||||
UNKNOWN = "UNKNOWN"
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
|
||||
|
||||
class ProjectRegistry:
|
||||
def __init__(self, store_dir: Path | str):
|
||||
self.path = Path(store_dir) / "project_registry.json"
|
||||
self.doc = self._load()
|
||||
|
||||
def _load(self) -> dict:
|
||||
if self.path.is_file():
|
||||
import json
|
||||
return json.loads(self.path.read_text())
|
||||
return {"schema_version": REGISTRY_SCHEMA_VERSION,
|
||||
"projects": {}, "updated_at": _now()}
|
||||
|
||||
def save(self) -> None:
|
||||
import json
|
||||
self.doc["updated_at"] = _now()
|
||||
self.path.parent.mkdir(parents=True, exist_ok=True)
|
||||
self.path.write_text(json.dumps(self.doc, indent=1, sort_keys=True))
|
||||
|
||||
def register(self, *, project_id: str, scaffold_location: str,
|
||||
repo_identity: str = "", forge_repo: str = "",
|
||||
default_branch: str = "master",
|
||||
structural_schema_version: int = 1,
|
||||
runtime_generation: str = "",
|
||||
last_known_good: str = "") -> dict:
|
||||
"""Register/index a scaffolded project. References only — the
|
||||
project's structural truth stays in ITS store (boundary rule)."""
|
||||
entry = {
|
||||
"project_id": project_id,
|
||||
"scaffold_location": scaffold_location,
|
||||
"repo_identity": repo_identity,
|
||||
"forge_repo": forge_repo,
|
||||
"default_branch": default_branch,
|
||||
"structural_schema_version": structural_schema_version,
|
||||
"scaffold_state": {"health": UNKNOWN,
|
||||
"last_material_update": _now()},
|
||||
"runtime_generation": runtime_generation,
|
||||
"last_known_good": last_known_good,
|
||||
"outstanding_validations": 0,
|
||||
"registered_at": _now(),
|
||||
}
|
||||
self.doc["projects"][project_id] = entry
|
||||
return entry
|
||||
|
||||
def get(self, project_id: str) -> dict | None:
|
||||
return self.doc["projects"].get(project_id)
|
||||
|
||||
def all_projects(self) -> list[dict]:
|
||||
return sorted(self.doc["projects"].values(),
|
||||
key=lambda p: p["project_id"])
|
||||
|
||||
def set_health(self, project_id: str, health: str, *,
|
||||
note: str = "") -> None:
|
||||
if health not in (HEALTHY, DRIFTED, MIGRATION_REQUIRED, UNKNOWN):
|
||||
raise ValueError(f"unknown health {health!r}")
|
||||
p = self.doc["projects"][project_id]
|
||||
p["scaffold_state"]["health"] = health
|
||||
p["scaffold_state"]["last_material_update"] = _now()
|
||||
if note:
|
||||
p["scaffold_state"].setdefault("notes", []).append(
|
||||
{"at": _now(), "note": note[:160]})
|
||||
|
||||
def set_outstanding_validations(self, project_id: str,
|
||||
count: int) -> None:
|
||||
self.doc["projects"][project_id]["outstanding_validations"] = count
|
||||
|
||||
def mark_generation(self, project_id: str, *, current: str,
|
||||
last_known_good: str = "") -> None:
|
||||
p = self.doc["projects"][project_id]
|
||||
p["runtime_generation"] = current
|
||||
if last_known_good:
|
||||
p["last_known_good"] = last_known_good
|
||||
|
||||
def needs_migration(self, proposed_schema_version: int) -> list[str]:
|
||||
"""Projects whose structural schema is older than a proposed
|
||||
version (feeds the 18I consent sweep — never silent upgrades)."""
|
||||
return sorted(pid for pid, p in self.doc["projects"].items()
|
||||
if p.get("structural_schema_version", 1)
|
||||
< proposed_schema_version)
|
||||
+90
-5
@@ -8,7 +8,7 @@ mode system, subject header, shared memory and identity.
|
||||
|
||||
This is not an interface. This is how I see, speak, and interact with the world.
|
||||
|
||||
Version: v0.66.71
|
||||
Version: v0.68.0
|
||||
Features: 41 (24 original + 17 new native commands)
|
||||
|
||||
Usage:
|
||||
@@ -1856,7 +1856,7 @@ class RuneApp(App):
|
||||
# Show version info
|
||||
self.chat_channel.add_message(
|
||||
"system",
|
||||
f"[dim]Rune v0.66.71 | Textual TUI | {len(loaded)} native modules[/dim]",
|
||||
f"[dim]Rune v0.68.0 | Textual TUI | {len(loaded)} native modules[/dim]",
|
||||
)
|
||||
|
||||
# Auto-show night mode suggestion if evening/night hours
|
||||
@@ -3112,6 +3112,58 @@ class RuneApp(App):
|
||||
except Exception as e:
|
||||
self._ch().add_message("system", f"[dim]Error: {e}[/dim]")
|
||||
|
||||
def _cmd_testing(self, arg):
|
||||
"""T19 19L: canonical Testing Mode — outstanding validations.
|
||||
/testing → aggregate across registered projects
|
||||
/testing <project> → one project's outstanding items."""
|
||||
try:
|
||||
from pathlib import Path as _Path
|
||||
from rune import testing_mode as tm
|
||||
from rune.behaviour_ledger import BehaviourLedger
|
||||
from rune.project_registry import ProjectRegistry
|
||||
registry = ProjectRegistry("store/scaffold")
|
||||
ch = self._ch()
|
||||
if arg.strip():
|
||||
# project filter: read THAT project's ledger
|
||||
entry = registry.get(arg.strip())
|
||||
if entry is None:
|
||||
ch.add_message("system",
|
||||
f"[yellow]No registered scaffolded project "
|
||||
f"{arg.strip()!r}[/yellow]")
|
||||
return
|
||||
loc = entry["scaffold_location"]
|
||||
if not (_Path(loc) / "behaviour_ledger.json").is_file():
|
||||
ch.add_message("system",
|
||||
f"[yellow]{arg.strip()} has no behaviour ledger "
|
||||
f"yet[/yellow]")
|
||||
return
|
||||
beh = BehaviourLedger(loc)
|
||||
items = beh.outstanding()
|
||||
ch.add_message("system",
|
||||
f"[bold]{arg.strip()}: {len(items)} outstanding "
|
||||
f"validation(s)[/bold]")
|
||||
else:
|
||||
rows = tm.aggregate(registry, _Path("store/scaffold"))
|
||||
ch.add_message("system", "[bold]Testing aggregate "
|
||||
"(registered scaffolded projects)[/bold]")
|
||||
for r in rows:
|
||||
if r["outstanding"] is None:
|
||||
ch.add_message("system",
|
||||
f" {r['project']}: no behaviour ledger yet")
|
||||
else:
|
||||
ch.add_message("system",
|
||||
f" {r['project']}: {r['outstanding']} "
|
||||
f"outstanding")
|
||||
items = []
|
||||
for b in items[:8]:
|
||||
ch.add_message("system",
|
||||
f" • {b['behaviour_id']}: {b['intended_behaviour'][:70]} "
|
||||
f"[{b['state']}]"
|
||||
+ (f" — procedure: {b['procedure'][:60]}" if b.get("procedure") else ""))
|
||||
except Exception as exc: # noqa: BLE001 — user-visible surface: report, never crash the TUI
|
||||
self._ch().add_message("system",
|
||||
f"[red]/testing failed: {exc}[/red]")
|
||||
|
||||
def _cmd_build(self, arg):
|
||||
"""Build mode — full build pipeline with worktree isolation."""
|
||||
try:
|
||||
@@ -3169,9 +3221,41 @@ class RuneApp(App):
|
||||
msg += f"\n - {q}"
|
||||
self._ch().add_message("system", msg)
|
||||
return
|
||||
# PROJECT_BUILD / EXISTING_PROJECT_CHANGE: contract
|
||||
# activation happens on the operator hook path (the ONE
|
||||
# activate()); the gate's job is refuse-or-admit.
|
||||
# T18 18M FULL BACKEND CONVERGENCE: admission mints a
|
||||
# canonical Construction Contract (same as every other
|
||||
# route) — /build start no longer runs an independent
|
||||
# construction state machine. BuildManager remains the
|
||||
# bounded worktree/ledger adapter driven BY the contract.
|
||||
# T19 19A GOVERNANCE INVARIANT: real construction must
|
||||
# NOT silently bypass its canonical Construction Contract.
|
||||
# The T18 degradation paths (mint unavailable/failed →
|
||||
# BuildManager proceeds legacy-governed) were a silent
|
||||
# downgrade — REMOVED. Contract mint failure is FAIL-
|
||||
# CLOSED: the build does not start; the user sees why.
|
||||
# BuildManager remains a bounded worktree/ledger adapter
|
||||
# that is only ever reachable WITH a governing contract.
|
||||
import time as _t
|
||||
_cid = f"build-{int(_t.time())}"
|
||||
try:
|
||||
from rune.construction_interface import ConstructionInterface
|
||||
_iface = ConstructionInterface(builder="tui-build-cmd")
|
||||
_doc = _iface.scaffold.load()
|
||||
_iface.scaffold.new_contract(
|
||||
_doc, contract_id=_cid, need=description,
|
||||
origin="user", scope=[],
|
||||
requirement="/build start (classified: "
|
||||
f"{mode_name})")
|
||||
_iface.scaffold.save(_doc)
|
||||
_iface.transition(_cid, "approved",
|
||||
evidence_ref="user:/build-start")
|
||||
_iface.transition(_cid, "building",
|
||||
evidence_ref="build-manager-adapter")
|
||||
except Exception as exc: # noqa: BLE001 — T19 19A: contract mint failure FAILS CLOSED (refuse, never degrade to ungoverned construction)
|
||||
self._ch().add_message("system",
|
||||
f"[red]'/build start' refused: canonical contract "
|
||||
f"mint failed ({exc}) — construction cannot start "
|
||||
f"without its governing contract.[/red]")
|
||||
return
|
||||
manager = BuildManager()
|
||||
build_id = manager.start_build(description)
|
||||
self._ch().add_message("system", f"[bold]✅ Build {build_id} started[/bold]")
|
||||
@@ -3452,6 +3536,7 @@ class RuneApp(App):
|
||||
"/audit": _cmd_audit,
|
||||
"/work": _cmd_work,
|
||||
"/build": _cmd_build,
|
||||
"/testing": _cmd_testing,
|
||||
"/queue": _cmd_queue,
|
||||
"/pull": _cmd_pull,
|
||||
"/help": _cmd_help,
|
||||
|
||||
@@ -0,0 +1,77 @@
|
||||
"""structural_migration.py — T18 §18I: schema versioning + consent for
|
||||
structural Scaffolds.
|
||||
|
||||
USER REQUIREMENT (T18 mandate): when Scaffolding itself later receives a
|
||||
SIGNIFICANT structural/version uplift, known projects previously
|
||||
scaffolded must NOT be silently upgraded. Material migrations require
|
||||
user consent; minor backwards-compatible migrations stay automatic.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
|
||||
|
||||
class ConsentRequired(Exception):
|
||||
"""A material schema migration was requested without user approval."""
|
||||
|
||||
|
||||
def classify_migration(*, from_v: int, to_v: int,
|
||||
changes: list[str]) -> str:
|
||||
"""MINOR (automatic) vs MATERIAL (consent required). Deterministic:
|
||||
renames/removals/id-format changes/semantic shifts are MATERIAL;
|
||||
additive optional kinds/fields are MINOR."""
|
||||
material_markers = ("rename", "drop ", "remove", "delete",
|
||||
"id format", "semantic", "restructure",
|
||||
"change format", "merge", "split")
|
||||
for c in changes:
|
||||
cl = c.lower()
|
||||
if any(m in cl for m in material_markers):
|
||||
return "MATERIAL"
|
||||
return "MINOR"
|
||||
|
||||
|
||||
def affected_projects(stores: dict[str, dict], proposed_v: int) -> list[str]:
|
||||
"""Which known projects (schema_version < proposed_v) would a
|
||||
proposed uplift touch. Scaffolding presents these for consent —
|
||||
never silently upgrades."""
|
||||
return sorted(name for name, doc in stores.items()
|
||||
if doc.get("schema_version", 0) < proposed_v)
|
||||
|
||||
|
||||
def apply_migration(*, model_store, from_v: int, to_v: int,
|
||||
changes: list[str], user_approved: bool,
|
||||
approved_by: str = "") -> dict:
|
||||
"""Apply (or refuse) a schema migration. MATERIAL without explicit
|
||||
user approval raises ConsentRequired — the silent upgrade is
|
||||
structurally impossible. Returns a durable migration record."""
|
||||
kind = classify_migration(from_v=from_v, to_v=to_v, changes=changes)
|
||||
if kind == "MATERIAL" and not user_approved:
|
||||
raise ConsentRequired(
|
||||
f"material schema migration {from_v}→{to_v} requires user "
|
||||
f"consent: {changes[:3]}")
|
||||
return {
|
||||
"from_v": from_v, "to_v": to_v, "kind": kind,
|
||||
"changes": changes, "user_approved": user_approved,
|
||||
"approved_by": approved_by if user_approved else None,
|
||||
"applied_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
|
||||
}
|
||||
|
||||
|
||||
def consent_brief(*, from_v: int, to_v: int, changes: list[str],
|
||||
benefits: list[str]) -> dict:
|
||||
"""The consent presentation (rule 18I): current version, proposed
|
||||
version, benefits, semantic changes, risks, expected effect."""
|
||||
return {
|
||||
"current_version": from_v,
|
||||
"proposed_version": to_v,
|
||||
"benefits": benefits,
|
||||
"semantic_changes": changes,
|
||||
"migration_risks": [
|
||||
"stored models require one-time reconciliation after upgrade",
|
||||
"consumers of the old schema need re-reading via projection",
|
||||
],
|
||||
"expected_effect": ("models keep their data; identity and "
|
||||
"relationship semantics change per the listed "
|
||||
"changes"),
|
||||
"requires": "explicit user approval before any project is upgraded",
|
||||
}
|
||||
@@ -0,0 +1,352 @@
|
||||
"""structural_model.py — T18 §18E/§18F: the first-class STRUCTURAL
|
||||
SCAFFOLD for scaffolded projects.
|
||||
|
||||
RESEARCH-LED (Build Basis: research/t18-structural-model-prior-art,
|
||||
QUALIFIED 2026-09-15):
|
||||
|
||||
ADOPTED: Backstage relation vocabulary (partOf/belongs_to,
|
||||
depends_on, provides/consumes, ownedBy) + entity-ref discipline;
|
||||
Kythe edge kinds (calls, reads, writes, satisfies, overrides) +
|
||||
derived-reverse-edge rule; Nx affected semantics for impact closure;
|
||||
Bazel rdeps(kind(test)) for verification scoping.
|
||||
|
||||
ADAPTED: identity is DETERMINISTIC and STABLE across versions
|
||||
(Kythe explicitly declines this — a persistent model cannot); C4
|
||||
deployment shapes become machine-derived deployed_by edges; Glean's
|
||||
batch layering → externally-derived relationships carry a distinct
|
||||
authority.
|
||||
|
||||
REJECTED: heavyweight graph stores (no evidence/maturity/consent
|
||||
semantics); LSIF; Stack Graphs (archived).
|
||||
|
||||
INNOVATION (absent from prior art): evidence_refs + authority +
|
||||
status on every relationship; verified_by/deployed_by to concrete
|
||||
entities; consent-gated schema migration.
|
||||
|
||||
Storage: the EXISTING structural_store generic core (rule A — no
|
||||
second graph store, no competing Spine; Spine uses the same core for
|
||||
Rune, project models use it for their projects).
|
||||
|
||||
ENTITY KINDS: project, domain, subsystem, component (module), interface,
|
||||
state_store, test_suite, deployment_surface, environment.
|
||||
RELATIONSHIPS: belongs_to, depends_on, calls, provides, consumes,
|
||||
reads, writes, connects_to, verified_by, deployed_by, owns, supersedes,
|
||||
legacy_of — every edge carries evidence_refs + authority + status.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
from rune.structural_store import (
|
||||
add_entity, add_relationship, entity, load, new_doc, save,
|
||||
)
|
||||
|
||||
SCHEMA_VERSION = 1
|
||||
|
||||
ENTITY_KINDS = (
|
||||
"project", "domain", "subsystem", "component", "interface",
|
||||
"state_store", "test_suite", "deployment_surface", "environment",
|
||||
)
|
||||
|
||||
RELATION_TYPES = (
|
||||
"belongs_to", "owns", "depends_on", "calls", "provides", "consumes",
|
||||
"reads", "writes", "connects_to", "verified_by", "deployed_by",
|
||||
"supersedes", "legacy_of",
|
||||
)
|
||||
|
||||
|
||||
class StructuralModel:
|
||||
"""A project's persistent interconnected structural model. One file
|
||||
per project: <store_dir>/structural.json (spine-shaped — same
|
||||
generic core, open-world: unknown future kinds/relationships survive
|
||||
round-trips by construction)."""
|
||||
|
||||
def __init__(self, store_dir: Path | str, project_id: str):
|
||||
self.store_dir = Path(store_dir)
|
||||
self.project_id = project_id
|
||||
self.path = self.store_dir / "structural.json"
|
||||
doc = load(self.path)
|
||||
if doc is None:
|
||||
doc = new_doc()
|
||||
self._init_project(doc)
|
||||
self.doc = doc
|
||||
|
||||
# -- persistence ----------------------------------------------------
|
||||
|
||||
def _init_project(self, doc: dict) -> None:
|
||||
add_entity(doc, id=f"project:{self.project_id}", kind="project",
|
||||
maturity="DECLARED",
|
||||
evidence_refs=["structural-model-init"])
|
||||
root = add_relationship(doc, type="belongs_to",
|
||||
from_id=f"project:{self.project_id}",
|
||||
to_id=f"project:{self.project_id}",
|
||||
evidence_refs=["structural-model-root"])
|
||||
root["authority"] = "model-author"
|
||||
root["status"] = "root"
|
||||
save(doc, self.path)
|
||||
|
||||
def save(self) -> None:
|
||||
self.doc["schema_version"] = SCHEMA_VERSION
|
||||
save(self.doc, self.path)
|
||||
|
||||
def reload(self) -> None:
|
||||
doc = load(self.path)
|
||||
if doc is not None:
|
||||
self.doc = doc
|
||||
|
||||
# -- entity/relationship construction -------------------------------
|
||||
|
||||
def add(self, kind: str, name: str, *, parent: str | None = None,
|
||||
ext: dict | None = None,
|
||||
evidence_ref: str = "structural-model") -> str:
|
||||
"""Add an entity with a STABLE deterministic id (kind:name —
|
||||
persistent across model versions; rule 18E). parent (an id) adds
|
||||
the belongs_to edge (Backstage partOf semantics)."""
|
||||
if kind not in ENTITY_KINDS:
|
||||
raise ValueError(f"unknown entity kind {kind!r} — known: "
|
||||
f"{ENTITY_KINDS}")
|
||||
eid = f"{kind}:{name}"
|
||||
e = add_entity(self.doc, id=eid, kind=kind, maturity="DECLARED",
|
||||
evidence_refs=[evidence_ref])
|
||||
e["identities"]["name"] = name
|
||||
if ext:
|
||||
e.setdefault("ext", {}).update(ext)
|
||||
if parent:
|
||||
self.relate(eid, "belongs_to", parent,
|
||||
evidence_ref=evidence_ref)
|
||||
return eid
|
||||
|
||||
def relate(self, from_id: str, rel: str, to_id: str, *,
|
||||
evidence_ref: str = "structural-model",
|
||||
authority: str = "model-author",
|
||||
status: str = "active", ext: dict | None = None) -> dict:
|
||||
"""Add a typed relationship. Every edge carries evidence_refs +
|
||||
authority + status (the INNOVATION per the Build Basis —
|
||||
authority-graded claims). Authority values: model-author
|
||||
(agent-observed/derived), importer (external tool derived —
|
||||
Glean batch-layering adaptation), user (user-locked)."""
|
||||
if rel not in RELATION_TYPES:
|
||||
raise ValueError(f"unknown relationship {rel!r} — known: "
|
||||
f"{RELATION_TYPES}")
|
||||
r = add_relationship(self.doc, type=rel, from_id=from_id,
|
||||
to_id=to_id, evidence_refs=[evidence_ref])
|
||||
r["authority"] = authority
|
||||
r["status"] = status
|
||||
if ext:
|
||||
r["ext"] = ext
|
||||
return r
|
||||
|
||||
# -- queries (§18F) ---------------------------------------------------
|
||||
|
||||
def get(self, eid: str) -> dict | None:
|
||||
return entity(self.doc, eid)
|
||||
|
||||
def children(self, eid: str) -> list[str]:
|
||||
return [r["from"] for r in self.doc["relationships"]
|
||||
if r["type"] == "belongs_to" and r["to"] == eid
|
||||
and r["from"] != eid]
|
||||
|
||||
def beneath(self, eid: str) -> list[str]:
|
||||
"""Transitive descendants (bounded by the graph itself)."""
|
||||
seen, out, frontier = {eid}, [], [eid]
|
||||
while frontier:
|
||||
cur = frontier.pop()
|
||||
for child in self.children(cur):
|
||||
if child not in seen:
|
||||
seen.add(child)
|
||||
out.append(child)
|
||||
frontier.append(child)
|
||||
return sorted(out)
|
||||
|
||||
def owning_domain(self, eid: str) -> str | None:
|
||||
cur, hops = eid, 0
|
||||
while hops < 16:
|
||||
if cur.startswith("domain:"):
|
||||
return cur
|
||||
parents = [r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "belongs_to" and r["from"] == cur]
|
||||
if not parents:
|
||||
return None
|
||||
cur = parents[0]
|
||||
hops += 1
|
||||
return None
|
||||
|
||||
def dependencies(self, eid: str) -> list[str]:
|
||||
return sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "depends_on" and r["from"] == eid
|
||||
and r.get("status") != "stale")
|
||||
|
||||
def consumers(self, eid: str) -> list[str]:
|
||||
"""Who depends on OR consumes this entity (interfaces are
|
||||
consumed; components are depended on — Backstage relation pairs)."""
|
||||
return sorted(r["from"] for r in self.doc["relationships"]
|
||||
if r["type"] in ("depends_on", "consumes")
|
||||
and r["to"] == eid and r.get("status") != "stale")
|
||||
|
||||
def interfaces_for(self, eid: str) -> list[str]:
|
||||
return sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "provides" and r["from"] == eid)
|
||||
|
||||
def state_owned(self, eid: str) -> list[str]:
|
||||
return sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "owns" and r["from"] == eid)
|
||||
|
||||
def verification_surfaces(self, eid: str) -> list[str]:
|
||||
return sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "verified_by" and r["from"] == eid)
|
||||
|
||||
def deployment_surfaces(self, eid: str) -> list[str]:
|
||||
return sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "deployed_by" and r["from"] == eid)
|
||||
|
||||
def canonical_state_owner(self, eid: str) -> str | None:
|
||||
"""The canonical-state owner: the state_store this entity owns,
|
||||
or (for a state_store) itself."""
|
||||
e = self.get(eid)
|
||||
if e and e.get("kind") == "state_store":
|
||||
return eid
|
||||
owned = self.state_owned(eid)
|
||||
return owned[0] if owned else None
|
||||
|
||||
def supersession(self, eid: str) -> dict:
|
||||
return {
|
||||
"supersedes": sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "supersedes"
|
||||
and r["from"] == eid),
|
||||
"superseded_by": sorted(
|
||||
r["from"] for r in self.doc["relationships"]
|
||||
if r["type"] == "supersedes" and r["to"] == eid),
|
||||
"legacy_of": sorted(r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "legacy_of"
|
||||
and r["from"] == eid),
|
||||
}
|
||||
|
||||
# -- impact closure (§18F) -------------------------------------------
|
||||
|
||||
def impact_closure(self, eid: str, *, max_depth: int = 8) -> dict:
|
||||
"""STRUCTURALLY BOUNDED SCOPE (rule J): the necessary structural
|
||||
impact closure for a change to eid. Nx-affected semantics:
|
||||
reverse-dependency closure + verification + deployment + state
|
||||
surfaces. Unknown/dynamic relationships stay explicit uncertainty
|
||||
— never silent (rule 18F)."""
|
||||
if self.get(eid) is None:
|
||||
return {"error": f"unknown entity {eid!r}"}
|
||||
# reverse-dependency closure (consumers, transitively, bounded)
|
||||
seen, frontier, depth = {eid}, [eid], 0
|
||||
consumers: set[str] = set()
|
||||
while frontier and depth < max_depth:
|
||||
nxt = []
|
||||
for cur in frontier:
|
||||
for c in self.consumers(cur):
|
||||
if c not in seen:
|
||||
seen.add(c)
|
||||
consumers.add(c)
|
||||
nxt.append(c)
|
||||
frontier, depth = nxt, depth + 1
|
||||
direct_deps = self.dependencies(eid)
|
||||
# ripple through PROVIDED interfaces (Kythe exports semantics):
|
||||
# a change that touches an entity's provided interface reaches
|
||||
# every consumer of that interface
|
||||
for iface in self.interfaces_for(eid):
|
||||
for c in self.consumers(iface):
|
||||
if c not in seen:
|
||||
seen.add(c)
|
||||
consumers.add(c)
|
||||
uncertainty = [
|
||||
{"kind": "dynamic-consumer",
|
||||
"note": "static model cannot see dynamic dispatch/string-keyed "
|
||||
"lookup/late-binding consumers — reconcilers must "
|
||||
"verify at runtime"}]
|
||||
# lockfile/deps edge (Nx documented case): deps outside closure
|
||||
# are OBSERVATION scope, not mutation scope
|
||||
return {
|
||||
"target": eid,
|
||||
"owning_domain": self.owning_domain(eid),
|
||||
"mutation_scope": sorted({eid} | consumers),
|
||||
"observation_scope": {
|
||||
"direct_dependencies": direct_deps,
|
||||
# interfaces the target provides AND consumes — both
|
||||
# directions are observation-relevant for a change
|
||||
"interfaces_provided": self.interfaces_for(eid),
|
||||
"interfaces_consumed": sorted(
|
||||
r["to"] for r in self.doc["relationships"]
|
||||
if r["type"] == "consumes" and r["from"] == eid),
|
||||
},
|
||||
"state_surfaces": sorted(
|
||||
{s for e in ({eid} | consumers)
|
||||
for s in self.state_owned(e)}),
|
||||
"verification_scope": sorted(
|
||||
{v for e in ({eid} | consumers)
|
||||
for v in self.verification_surfaces(e)}),
|
||||
"deployment_scope": sorted(
|
||||
{d for e in ({eid} | consumers)
|
||||
for d in self.deployment_surfaces(e)}),
|
||||
"invariants": [
|
||||
f"belongs_to hierarchy of {eid} remains stable",
|
||||
"canonical-state ownership unchanged"],
|
||||
"non_goals": [],
|
||||
"uncertainty": uncertainty,
|
||||
"closure_depth": depth,
|
||||
}
|
||||
|
||||
|
||||
# ── T18 §18K: workspace lifecycle foundation ────────────────────────────
|
||||
#
|
||||
# Canonical lifecycle (rule 18K) — BuildManager remains the bounded
|
||||
# adapter for the worktree mechanics (17G decision), the LIFECYCLE and
|
||||
# its record live here so contracts can carry workspace provenance:
|
||||
#
|
||||
# verified source/base SHA → per-contract isolated worktree →
|
||||
# construction → verification → commit → push → CI/merge/release →
|
||||
# deployment confirmation → evidence archival → cleanup
|
||||
#
|
||||
# Records never hard-code live-runtime mutation (rule P): the deployed
|
||||
# generation changes only through the canonical promote machinery.
|
||||
|
||||
WORKSPACE_LIFECYCLE_STAGES = (
|
||||
"base_verified", "worktree_created", "construction",
|
||||
"verified", "committed", "pushed", "ci_qualified",
|
||||
"released", "deployment_confirmed", "evidence_archived", "cleaned",
|
||||
)
|
||||
|
||||
|
||||
def workspace_record(*, contract_id: str, construction_base: str,
|
||||
runtime_generation: str = "",
|
||||
candidate_generation: str = "",
|
||||
promotion_target: str = "gitea/master",
|
||||
rollback_generation: str = "") -> dict:
|
||||
"""The workspace provenance record a contract carries. Generations
|
||||
are SHAs/dirs — never live-tree mutations."""
|
||||
return {
|
||||
"contract_id": contract_id,
|
||||
"construction_base": construction_base,
|
||||
"runtime_generation": runtime_generation,
|
||||
"candidate_generation": candidate_generation,
|
||||
"promotion_target": promotion_target,
|
||||
"rollback_generation": rollback_generation,
|
||||
"stages_completed": [],
|
||||
"lifecycle": list(WORKSPACE_LIFECYCLE_STAGES),
|
||||
}
|
||||
|
||||
|
||||
def workspace_advance(record: dict, stage: str, *,
|
||||
evidence: str = "") -> dict:
|
||||
"""Advance the workspace lifecycle one stage (order-enforced)."""
|
||||
if stage not in WORKSPACE_LIFECYCLE_STAGES:
|
||||
raise ValueError(f"unknown workspace stage {stage!r}")
|
||||
done = record["stages_completed"]
|
||||
if done:
|
||||
last = WORKSPACE_LIFECYCLE_STAGES.index(done[-1])
|
||||
cur = WORKSPACE_LIFECYCLE_STAGES.index(stage)
|
||||
if cur != last + 1:
|
||||
raise ValueError(
|
||||
f"lifecycle order violation: {done[-1]} → {stage}")
|
||||
elif stage != WORKSPACE_LIFECYCLE_STAGES[0]:
|
||||
raise ValueError(f"lifecycle must start at "
|
||||
f"{WORKSPACE_LIFECYCLE_STAGES[0]}, got {stage!r}")
|
||||
done.append(stage)
|
||||
if evidence:
|
||||
record.setdefault("evidence", []).append(
|
||||
{"stage": stage, "evidence": evidence[:200]})
|
||||
return record
|
||||
@@ -109,8 +109,14 @@ def _redact_secrets(obj):
|
||||
dict key named like a credential has its value stripped before
|
||||
serialization. Structural stores must never become secret stores."""
|
||||
if isinstance(obj, dict):
|
||||
def _is_secret_key(key) -> bool:
|
||||
kl = str(key).lower()
|
||||
return (kl in _SECRET_KEY_NAMES
|
||||
or any(w in kl for w in ("token", "api_key", "apikey",
|
||||
"password", "secret",
|
||||
"credential", "private_key")))
|
||||
return {
|
||||
k: ("<redacted>" if str(k).lower() in _SECRET_KEY_NAMES else _redact_secrets(v)) for k, v in obj.items()
|
||||
k: ("<redacted>" if _is_secret_key(k) else _redact_secrets(v)) for k, v in obj.items()
|
||||
}
|
||||
if isinstance(obj, list):
|
||||
return [_redact_secrets(v) for v in obj]
|
||||
|
||||
@@ -0,0 +1,196 @@
|
||||
"""testing_mode.py — T19 §19L/19M/19N/19O/19P: canonical Testing Mode
|
||||
backend + Observation→diagnosis→fix→retest + forge projection.
|
||||
|
||||
The Behaviour Validation Ledger is DURABLE TRUTH. A testing session is
|
||||
only coordination state (rule 19N) — pausable, resumable, never the
|
||||
authority. The queue is DYNAMIC (rule 19M): a fix for behaviour B may
|
||||
invalidate confirmed behaviour A via structural closure; unrelated
|
||||
hardened behaviours stay trusted.
|
||||
|
||||
Forge projection (19P): failures in active iteration create/update a
|
||||
human-visible issue through the T18 forge boundary. Forge failure never
|
||||
rewrites canonical truth.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
from rune.behaviour_ledger import BehaviourLedger, TEST_FAILED, USER_CONFIRMED
|
||||
from rune.capability_ledger import CapabilityLedger
|
||||
from rune.project_registry import ProjectRegistry
|
||||
|
||||
SESSION_SCHEMA_VERSION = 1
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
|
||||
|
||||
|
||||
# ── 19N: session = coordination only ─────────────────────────────────────
|
||||
|
||||
class TestingSession:
|
||||
def __init__(self, store_dir: Path | str, *, project: str = "",
|
||||
scope_component: str | None = None):
|
||||
self.path = Path(store_dir) / "testing_session.json"
|
||||
self.store_dir = Path(store_dir)
|
||||
self.state = self._load(project, scope_component)
|
||||
|
||||
def _load(self, project, scope_component) -> dict:
|
||||
import json
|
||||
if self.path.is_file():
|
||||
return json.loads(self.path.read_text())
|
||||
return {"schema_version": SESSION_SCHEMA_VERSION,
|
||||
"project": project, "scope_component": scope_component,
|
||||
"current_item": None, "completed_this_session": [],
|
||||
"newly_invalidated": [], "blockers": [],
|
||||
"paused": False, "updated_at": _now()}
|
||||
|
||||
def save(self) -> None:
|
||||
import json
|
||||
self.state["updated_at"] = _now()
|
||||
self.path.write_text(json.dumps(self.state, indent=1,
|
||||
sort_keys=True))
|
||||
|
||||
# ── 19L: next eligible item ──────────────────────────────────────
|
||||
|
||||
def next_item(self, behaviours: BehaviourLedger) -> dict | None:
|
||||
if self.state["paused"]:
|
||||
return None
|
||||
outstanding = behaviours.outstanding(
|
||||
component=self.state.get("scope_component"),
|
||||
project=self.state.get("project") or None)
|
||||
item = outstanding[0] if outstanding else None
|
||||
self.state["current_item"] = (item["behaviour_id"]
|
||||
if item else None)
|
||||
return item
|
||||
|
||||
# ── 19M: record result; dynamic queue re-derives from states ─────
|
||||
|
||||
def record(self, behaviours: BehaviourLedger, behaviour_id: str, *,
|
||||
passed: bool, detail: str = "", by: str = "user",
|
||||
generation: str = "") -> dict:
|
||||
rec = behaviours.record_real_world(
|
||||
behaviour_id, passed=passed, detail=detail, confirmed_by=by,
|
||||
generation=generation)
|
||||
self.state["completed_this_session"].append(
|
||||
{"behaviour_id": rec["behaviour_id"], "passed": passed,
|
||||
"at": _now()})
|
||||
if passed and rec["state"] == USER_CONFIRMED:
|
||||
pass # hardened; queue re-derives
|
||||
self.save()
|
||||
return rec
|
||||
|
||||
def pause(self) -> None:
|
||||
self.state["paused"] = True
|
||||
self.save()
|
||||
|
||||
def resume(self) -> None:
|
||||
self.state["paused"] = False
|
||||
self.save()
|
||||
|
||||
def note_blocker(self, behaviour_id: str, note: str) -> None:
|
||||
self.state["blockers"].append({"behaviour_id": behaviour_id,
|
||||
"note": note[:200], "at": _now()})
|
||||
self.save()
|
||||
|
||||
|
||||
# ── 19O: Observation → diagnosis → fix → retest ──────────────────────────
|
||||
|
||||
def record_observation(store_dir: Path | str, *, observed: str,
|
||||
expected: str, behaviour_id: str = "",
|
||||
environment: str = "", reproduction: str = "",
|
||||
candidate_areas: list[str] | None = None,
|
||||
confidence: str = "low") -> dict:
|
||||
"""Durable real-world failure report. Candidate areas are
|
||||
HYPOTHESES, not declared root cause (rule 19O)."""
|
||||
import json
|
||||
obs = {
|
||||
"observation_id": f"obs-{int(time.time())}",
|
||||
"observed": observed, "expected": expected,
|
||||
"behaviour_id": behaviour_id,
|
||||
"environment": environment, "reproduction": reproduction,
|
||||
"candidate_areas": list(candidate_areas or []), # hypotheses
|
||||
"confidence": confidence,
|
||||
"created_at": _now(),
|
||||
"closure": None, # set by close_observation
|
||||
}
|
||||
p = Path(store_dir) / "observations.jsonl"
|
||||
with p.open("a") as f:
|
||||
f.write(json.dumps(obs, sort_keys=True) + "\n")
|
||||
return obs
|
||||
|
||||
|
||||
def close_observation(store_dir: Path | str, observation_id: str, *,
|
||||
behaviour_retest_passed: bool,
|
||||
user_confirmed: bool,
|
||||
contract_ref: str = "") -> dict:
|
||||
"""Closure returns to the ORIGINAL observed scenario (rule 19O):
|
||||
code changed ≠ closure; automated green ≠ closure. The observation
|
||||
closes only when the behaviour was retested AND user-confirmed."""
|
||||
import json
|
||||
p = Path(store_dir) / "observations.jsonl"
|
||||
lines = p.read_text().strip().splitlines()
|
||||
out = []
|
||||
result = None
|
||||
for line in lines:
|
||||
rec = json.loads(line)
|
||||
if rec.get("observation_id") == observation_id:
|
||||
rec["closure"] = {
|
||||
"behaviour_retest_passed": behaviour_retest_passed,
|
||||
"user_confirmed": user_confirmed,
|
||||
"contract_ref": contract_ref,
|
||||
"closed": behaviour_retest_passed and user_confirmed,
|
||||
"at": _now()}
|
||||
result = rec
|
||||
out.append(json.dumps(rec, sort_keys=True))
|
||||
p.write_text("\n".join(out) + "\n")
|
||||
if result is None:
|
||||
raise ValueError(f"unknown observation {observation_id!r}")
|
||||
return result
|
||||
|
||||
|
||||
# ── 19P: forge projection through the T18 boundary ───────────────────────
|
||||
|
||||
def project_failure_to_forge(forge_adapter, repo: str, *,
|
||||
behaviour_id: str, observation: dict,
|
||||
dry_run: bool = False) -> dict:
|
||||
"""Create/update a human-visible issue for an active failure
|
||||
iteration. The forge record is a PROJECTION — canonical truth stays
|
||||
in the Behaviour Ledger. Forge failure never rewrites truth
|
||||
(rule 19P/19S-14): exceptions propagate to the caller as
|
||||
ForgeUnavailable; the ledger state is untouched."""
|
||||
title = f"[testing] {behaviour_id}: {observation.get('expected', '')[:60]}"
|
||||
body = (f"Observed: {observation.get('observed', '')}\n"
|
||||
f"Expected: {observation.get('expected', '')}\n"
|
||||
f"Behaviour: {behaviour_id}\n"
|
||||
f"Observation: {observation.get('observation_id')}\n"
|
||||
f"Reproduction: {observation.get('reproduction', '')}")
|
||||
if dry_run:
|
||||
return {"projected": False, "dry_run": True, "title": title}
|
||||
return forge_adapter.create_or_patch_release(
|
||||
repo, tag=f"testing-{behaviour_id}", title=title, body=body)
|
||||
|
||||
|
||||
# ── 19L: aggregate backend ────────────────────────────────────────────────
|
||||
|
||||
def aggregate(registry: ProjectRegistry, store_root: Path) -> list[dict]:
|
||||
"""Outstanding validation across ALL registered scaffolded projects
|
||||
(the /testing aggregate)."""
|
||||
out = []
|
||||
for entry in registry.all_projects():
|
||||
loc = Path(entry["scaffold_location"])
|
||||
if not (loc / "behaviour_ledger.json").is_file():
|
||||
out.append({"project": entry["project_id"],
|
||||
"outstanding": None,
|
||||
"note": "no behaviour ledger yet"})
|
||||
continue
|
||||
beh = BehaviourLedger(loc)
|
||||
s = beh.summary()
|
||||
registry.set_outstanding_validations(entry["project_id"],
|
||||
s["outstanding"])
|
||||
out.append({"project": entry["project_id"],
|
||||
"outstanding": s["outstanding"],
|
||||
"states": s["states"]})
|
||||
registry.save()
|
||||
return out
|
||||
@@ -0,0 +1,73 @@
|
||||
"""wait_guard.py — T21 §21B: the sleep→poll regression detector.
|
||||
|
||||
Mirror of the MiMo Code controller guard (~/.mimocode/hooks/
|
||||
event-wait-guard.ts) in Python, so the CLASSIFICATION LOGIC is
|
||||
regression-tested in the Rune suite (rule 21B-4: the fix must survive
|
||||
model changes, compaction, provider swaps).
|
||||
|
||||
Detection: a command SEGMENT (split on ; | newline && ||) that combines
|
||||
a long sleep (>= 30s) with a status query of CI/deploy/release state.
|
||||
Heredoc bodies are stripped first (v2 precision fix — documentation
|
||||
about the pattern must not trip the guard).
|
||||
|
||||
Classification vocabulary (21B-1):
|
||||
USER_REQUESTED_DELAY bare sleep, user's explicit choice
|
||||
RATE_LIMIT_BACKOFF short bounded backoff (<30s)
|
||||
RETRY_BACKOFF bounded retry loop inside a script
|
||||
WATCHDOG deadline-based failure detection
|
||||
EVENT_FALLBACK_WITH_REASON declared no-event-source fallback
|
||||
SCHEDULED_TIMER cron/scheduled work
|
||||
UNJUSTIFIED_SLEEP DEFECT: sleep+poll with an event source available
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
|
||||
LONG_SLEEP_RE = re.compile(r"\bsleep\s+(\d{2,4})\b")
|
||||
STATUS_POLL_RE = re.compile(
|
||||
"|".join(
|
||||
(
|
||||
r"actions/runs",
|
||||
r"commits/.*/status",
|
||||
r"required.checks",
|
||||
r"deploy_qualify",
|
||||
r"releases/tags",
|
||||
r"readlink.*rune-code/current",
|
||||
)
|
||||
),
|
||||
re.IGNORECASE,
|
||||
)
|
||||
THRESHOLD_SECS = 30
|
||||
|
||||
|
||||
def classify_wait(command: str) -> dict:
|
||||
"""Classify one shell command's wait behaviour. Returns
|
||||
{"classification": ..., "evidence": ...}. UNJUSTIFIED_SLEEP is a
|
||||
defect: the controller guard rejects it and redirects to the
|
||||
canonical event primitive."""
|
||||
stripped = re.sub(
|
||||
r"<<-?\s*['\"]?(\w+)['\"]?\n[\s\S]*?\n\1", " [heredoc] ", command
|
||||
)
|
||||
segments = [s.strip() for s in
|
||||
re.split(r"[;|\n]|&&|\|\|", stripped) if s.strip()]
|
||||
for i, segment in enumerate(segments):
|
||||
m = LONG_SLEEP_RE.search(segment)
|
||||
if not m:
|
||||
continue
|
||||
secs = int(m.group(1))
|
||||
if secs < THRESHOLD_SECS:
|
||||
continue
|
||||
# the regression pattern is sleep THEN check: the status poll may
|
||||
# be in the same segment or the immediately following ones (the
|
||||
# "sleep; curl status" / "sleep && fetch && readlink" shapes)
|
||||
lookahead = " ".join(segments[i:i + 3])
|
||||
if STATUS_POLL_RE.search(lookahead):
|
||||
return {
|
||||
"classification": "UNJUSTIFIED_SLEEP",
|
||||
"evidence": f"sleep {secs}s then status poll: "
|
||||
f"{' / '.join(segments[i:i + 2])[:140]}",
|
||||
"redirect": "scripts/ci_event_wait.py --sha <sha>",
|
||||
}
|
||||
if re.match(r"^\s*sleep\s+\d+\s*$", stripped.strip()):
|
||||
return {"classification": "USER_REQUESTED_DELAY", "evidence": stripped.strip()}
|
||||
return {"classification": "NO_WAIT", "evidence": ""}
|
||||
@@ -0,0 +1,42 @@
|
||||
# T17 §17T — real-Rune re-entry benchmark (2026-09-15)
|
||||
|
||||
Target: the event/wait-resume subsystem. Two fresh-identity agents, no
|
||||
transcript. A: cold repo exploration. B: docs/STRUCTURAL_MAP.md first,
|
||||
then targeted reconciliation.
|
||||
|
||||
## Measured
|
||||
|
||||
| Metric | A cold | B map-assisted |
|
||||
|---|---|---|
|
||||
| Files opened | 6 | 4 (+ grep over ~10) |
|
||||
| Commands run | 14 (11 bash + 3 reads) | 13 (10 bash + 3 grep) |
|
||||
| Test runs | 1 (19 tests) | 1 (8 tests) |
|
||||
| Authority identified | correct (durable waitstore record) | correct |
|
||||
| Ownership identified | correct (out-of-repo bridge) | correct |
|
||||
| Unfinished/duplication found | CI adapter no production call site; bridge unversioned | CI coverage gap; TWO data roots (split-brain risk); t14 legacy; build_mode wired |
|
||||
| Wrong assumptions | **1 material**: claimed daemon DEAD with stale pidfile (false — PID 287505 live, /health ok) | 0 material; flagged env-pinning dependency |
|
||||
| Map reconciliation | n/a | 5 CONFIRMED, 1 UNVERIFIABLE, 0 DRIFTED |
|
||||
| Confidence | 80-95% | high/medium, calibrated |
|
||||
|
||||
## Honest verdict
|
||||
|
||||
1. **Raw cost ≈ equal** (6 vs 4 files, 14 vs 13 commands) — consistent
|
||||
with 16O: no step-count win on a well-structured repo.
|
||||
2. **Correctness gap is real**: the cold path asserted a FALSE runtime
|
||||
fact (daemon dead) from a stale pidfile and reported it at 95%
|
||||
confidence; the map-assisted path, knowing the daemon's deployment
|
||||
shape from the map, verified liveness and reported the env-pinning
|
||||
dependency instead. One false belief about a LIVE system is exactly
|
||||
the failure mode re-entry exists to prevent.
|
||||
3. **Coverage gap**: the map-assisted path found the two-data-roots
|
||||
split-brain risk (legacy ~/.local/share/mimo-wait-resume/waits still
|
||||
holds 46 records; wr_root() defaults there when RUNE_WR_ROOT unset);
|
||||
the cold path missed it.
|
||||
4. The map itself survived reconciliation with ZERO drifted claims —
|
||||
maintained structural projections are earning their update cost.
|
||||
|
||||
## Actionable finding (fed to 17U/W)
|
||||
The two-data-roots finding is real debt: `wr_root()` (event_wait.py)
|
||||
falls back to the legacy home when RUNE_WR_ROOT is unset. Production
|
||||
pins it (deploy.yml), but any unpinned consumer silently reads a stale
|
||||
store. Candidate: drop the legacy fallback or make it warn loudly.
|
||||
@@ -0,0 +1,109 @@
|
||||
# T17 §17V — Scaffolding freeze assessment + §17X adversarial matrix
|
||||
(2026-09-15)
|
||||
|
||||
## §17X — adversarial system matrix (36 cases → evidence)
|
||||
|
||||
| # | Case | Evidence |
|
||||
|---|------|----------|
|
||||
| 1 | explicit build request | 17Q-1 (PROJECT_BUILD, bootstrap) |
|
||||
| 2 | indirect authorization | 17Q-4 ("that's the one, make it happen") |
|
||||
| 3 | discussion only | 17Q-2 + 17L test (3 phrasings) |
|
||||
| 4 | ambiguous referent | 17Q-6 (asks, never guesses) |
|
||||
| 5 | stale referent | 17Q-8 (topic-shift resistance) |
|
||||
| 6 | superseded proposal | 17Q-20 |
|
||||
| 7 | option-selection referent | 17Q-5 (ordinal) |
|
||||
| 8 | new project | 17Q-14 |
|
||||
| 9 | existing project | 17Q-11 |
|
||||
| 10 | local change | 17Q-12 |
|
||||
| 11 | non-construction request | 17Q-10 ("build a list") |
|
||||
| 12 | research request | 17Q-9 |
|
||||
| 13 | provider unavailable | 16G-C (verbatim codes) |
|
||||
| 14 | provider manually changed | 16G-G (scaffold byte-identical) |
|
||||
| 15 | duplicate completion event | 15E double-resume tests |
|
||||
| 16 | completion event before waiter | 17C replay (4.6s prod-realistic) |
|
||||
| 17 | completion event after waiter | 17C cross-user delivery (2.05s) |
|
||||
| 18 | lost event | T16 16D live cycles (deadline recovery, promoted) |
|
||||
| 19 | controller restart | 15E restart tests + resume_or_recover |
|
||||
| 20 | stage restart | 17E wiring: already-closed skip test |
|
||||
| 21 | programme restart | 17E wiring: restart-from-durable-record test |
|
||||
| 22 | subtask≠programme | 15M canary + 17E failure isolation |
|
||||
| 23 | programme complete | 17E: PROGRAMME_COMPLETE / _WITH_FAILURES honest verdicts |
|
||||
| 24 | blocked stage | canary BLOCKED→fallback (15M tests) |
|
||||
| 25 | approval-required stage | canary APPROVAL_REQUIRED honest stop (15M) |
|
||||
| 26 | duplicate task state migration | 17F held-outs (counters from authority) |
|
||||
| 27 | legacy build route | 17G gate (/build start refused unless classified) |
|
||||
| 28 | command/NL equivalence | 17Q-15/16 (same classifier, same semantics) |
|
||||
| 29 | ContextIntent replay/idempotency | intents stateless; contracts idempotent (17E dup-signal test) |
|
||||
| 30 | invalid Substrate command | 16K refusal tests |
|
||||
| 31 | long-gap re-entry | 16O + 17T benchmarks |
|
||||
| 32 | repository drift | 16P VAT-regression blocks resume |
|
||||
| 33 | false-green test | stage_guards verify_test_truth (15F-I) |
|
||||
| 34 | Henxels structural failure | rc=0 all session; manifest gate caught every new module |
|
||||
| 35 | release stale publisher | T14B authority re-read (prior tranche, tests stand) |
|
||||
| 36 | deployment convergence | T16/T17: 0.66.63→0.66.66 auto-converged, verified |
|
||||
|
||||
Coverage honestly noted: cases 13-15, 19, 33, 35 rely on T14-T16 suites
|
||||
(green in this session's full runs); cases 16-18 carry THIS-tranche live
|
||||
production evidence.
|
||||
|
||||
## §17V — FREEZE ASSESSMENT
|
||||
|
||||
Checklist (mandate's 17 items):
|
||||
1. one canonical construction kernel — YES (scaffold.py + ONE
|
||||
classify_mode; T17 17G closed the /build bypass gate; 17U deleted the
|
||||
dead second orchestrator)
|
||||
2. native conversational/default activation — YES (operator hook path,
|
||||
T15; T17 added the conversational interpretation layer)
|
||||
3. explicit construction commands — YES (17K/17Q-1/7)
|
||||
4. contextual multi-turn activation — YES (17J-17N, 17Q matrix 22 cases)
|
||||
5. one canonical programme continuation mechanism — YES (17D/17E wired +
|
||||
live-proven)
|
||||
6. event-driven waiting canonical where events exist — YES (16C/17C;
|
||||
CI + builder adapters, replay, cross-user delivery)
|
||||
7. watchdog only as recovery/failure detection — YES (proven in
|
||||
production twice; wake path proven production-realistically)
|
||||
8. provider ownership outside Scaffolding — YES (16F structural guard)
|
||||
9. builder cannot self-certify — YES (phase-gated close; closure
|
||||
refusals observed live in T14)
|
||||
10. completion truth evidence-driven — YES (checkpoints on contracts;
|
||||
verify_test_truth)
|
||||
11. interruption/resume proven — YES (T14E live; 17E restart tests)
|
||||
12. long-gap re-entry supported — YES (drift_resume + 16O/17T honest
|
||||
benchmarks)
|
||||
13. Rune itself uses Scaffolding — YES (T16 16R, T17 17R/Y contracts
|
||||
closed through the real flow)
|
||||
14. future Substrate seam stable — YES (16I/J/K; SCHEMA_VERSION=1;
|
||||
zero direct-store coupling tests)
|
||||
15. major duplicate construction authorities removed or consciously
|
||||
deprecated — YES with residuals (plugin deleted; /build gated;
|
||||
build_mode kept as bounded adapter BY DECISION; task-state cache
|
||||
demoted by design, full writer retirement deferred)
|
||||
16. real-world generalisation begun — PARTIAL (fixtures + Rune itself;
|
||||
no external project yet)
|
||||
17. remaining work mostly bugs/edge/docs/adoption — YES (16W/17U debt
|
||||
lists are small and bounded)
|
||||
|
||||
## VERDICT: FREEZE_READY (with named residuals)
|
||||
|
||||
Rationale: every architecture-level capability the freeze checklist
|
||||
names is implemented, canonical, and verified — most of them with live
|
||||
production evidence from T16/T17. The residuals are deliberately
|
||||
bounded and none is architectural:
|
||||
- build_mode worktree adapter retirement (needs a migration plan, not
|
||||
new architecture)
|
||||
- task-state cache writer retirement (demoted, consumers derived)
|
||||
- replay-path first NATURAL cycle confirmation (mechanism proven
|
||||
production-realistically; only the natural-timing capture pending)
|
||||
- external-project generalisation (adoption, not construction)
|
||||
|
||||
Recommended posture: stop adding Scaffolding architecture. Future work:
|
||||
USE it (Rune retrofit completion, real projects), fix observed defects,
|
||||
simplify, stabilise — exactly the direction the mandate anticipated.
|
||||
|
||||
## §17Z POSTSCRIPT — natural event-path proof (19:15Z, final release cycle)
|
||||
The 17C residual closed ITSELF on the final release: deploy waiter for
|
||||
927548e registered 19:13:28, CI completion wake received 19:15:16,
|
||||
controller resumed ON THE EVENT (mode="event", no rearm, no deadline),
|
||||
authority re-read verdict success at 19:15:20, wall 112.5s, PROMOTED.
|
||||
First NATURAL production event-driven CI wake. v0.66.72 released,
|
||||
deployed current = 927548e = gitea/master = release. Full convergence.
|
||||
@@ -0,0 +1,39 @@
|
||||
# T18 §18A — exact current-state audit (2026-09-15, fresh verification)
|
||||
|
||||
All facts independently verified this session; nothing trusted from the
|
||||
T17 report without re-verification.
|
||||
|
||||
## Identity / release chain
|
||||
- HEAD = gitea/master = **29570f4** (T17 17Z postscript)
|
||||
- Deployed current → 29570f4 (symlink 20:22); last-good → 927548e (0.66.72's
|
||||
bump parent)
|
||||
- Release **v0.66.72** (20:06:36); the post-report doc commit DRAINED and
|
||||
DEPLOYED — T17's "draining" state is fully converged.
|
||||
|
||||
## Gates (lock-exact environments, 29570f4)
|
||||
- Full suite: **1920 passed + 84 subtests** (127s)
|
||||
- Lint ratchet: PASS (BLE001 350/350, S110 78/78 — post-17U shrink)
|
||||
- Type ratchet: PASS — errors **111** (baseline 117 — IMPROVED, honest
|
||||
high-water keeps the lower count), warnings 435 (≤443)
|
||||
- Henxels: rc=0
|
||||
|
||||
## Infrastructure
|
||||
- W/R daemon: pid 287505, /health ok, data root /mnt/workdrive/wr-bridge
|
||||
(shared root; wr_root() anti-split-brain policy active)
|
||||
- Spine store: 148 entities (139 module, 8 subsystem, 1 deployment_surface),
|
||||
636 relationships
|
||||
- Scaffolding store: 28 contracts — now ALL terminal after 18A
|
||||
reconciliation; 3 durable programme records (17E proofs)
|
||||
|
||||
## 18A drift reconciliation performed
|
||||
- 8 orphan contracts from superseded 17E proof attempts (17e-stage-*,
|
||||
17e2-stage-*) were draft/approved in the main store — abandoned
|
||||
truthfully with reconciliation checkpoints. Open contracts: ZERO.
|
||||
|
||||
## Current routes (verified by presence, detailed audits follow)
|
||||
- Task-state authority: TaskStateRepository (17F)
|
||||
- build_mode: bounded adapter behind the /build classification gate (17G)
|
||||
- Contextual routes: construction_intent → classify_mode (17J-Q),
|
||||
request-modals + information-opener precedence live
|
||||
- programme continuation: run_construction_programme wired + live-proven
|
||||
- structural map: docs/STRUCTURAL_MAP.md (updated 17T)
|
||||
@@ -0,0 +1,22 @@
|
||||
# T18 §18D CORRECTION — contextual research scope (2026-09-15, Nick)
|
||||
|
||||
CORRECTION: the 18D research topics (architecture graphs, dependency
|
||||
graphs, service topology, monorepo tooling, ADRs, graph formats) were
|
||||
EXAMPLES relevant to the structural-model task — not a universal
|
||||
research checklist. Scaffolding must never hard-code research topics.
|
||||
|
||||
IMPLEMENTED:
|
||||
- build_basis.generate_research_plan(): context-specific plan synthesis
|
||||
(intent → target/reality → unknowns/decisions/risks → topics). No
|
||||
topic vocabulary in code. Depth by consequence heuristics, always
|
||||
with WHY.
|
||||
- Held-outs (tests/test_contextual_research_plan.py): unrelated intents
|
||||
produce materially different plans; the 18D architecture topics do
|
||||
NOT leak into unrelated research; no-unknowns → depth NONE with empty
|
||||
topics; prior-art machinery summons only when unknowns reference
|
||||
existing practice, phrased for THIS intent.
|
||||
- Principle persisted in docs/SCAFFOLDING_V1_DEFINITION.md.
|
||||
|
||||
The 18D Build Basis (research/t18-structural-model-prior-art) remains
|
||||
VALID: those topics were contextually correct for designing the
|
||||
structural model itself.
|
||||
@@ -0,0 +1,123 @@
|
||||
{
|
||||
"alternatives_considered": [],
|
||||
"created_at": "2026-09-15T21:13:20Z",
|
||||
"deeper": {
|
||||
"findings": [],
|
||||
"refs": [],
|
||||
"used": false
|
||||
},
|
||||
"depth": {
|
||||
"decided_at": "2026-09-15T21:13:20Z",
|
||||
"depth": "FULL",
|
||||
"mode": "",
|
||||
"route": "RESEARCHED_CHANGE",
|
||||
"why": "route RESEARCHED_CHANGE default"
|
||||
},
|
||||
"dispositions": [
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "Backstage relation vocabulary + entity-ref discipline + catalog-info.yaml emission",
|
||||
"ref": "backstage.io",
|
||||
"why": "Domain/System/Component/Resource/API maps 1:1 to our nesting; ecosystem interop free"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "Kythe edge-kind vocabulary (ref/call, property/reads-writes, satisfies, overrides) + derived-reverse-edge rule",
|
||||
"ref": "kythe.io/docs/schema",
|
||||
"why": "disciplined, versioned, explicit"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "SCIP monikers for cross-index identity bridging",
|
||||
"ref": "scip",
|
||||
"why": "decouples stable identity from any one indexer"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "Nx affected semantics as impact-closure spec (diff\u2192owning entities\u2192reverse-dep closure)",
|
||||
"ref": "nx.dev/concepts/affected",
|
||||
"why": "productionized impact_frontier"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "Bazel rdeps(kind(.*_test)) as verified_by-driven verification scoping",
|
||||
"ref": "bazel.build",
|
||||
"why": "semantic template for test-surface queries"
|
||||
},
|
||||
{
|
||||
"disposition": "ADAPT",
|
||||
"item": "Kythe VName stability contract",
|
||||
"ref": "kythe.io",
|
||||
"why": "Kythe explicitly declines cross-version stability \u2014 our persistent model REQUIRES it; keep deterministic regeneration but promise stability"
|
||||
},
|
||||
{
|
||||
"disposition": "ADAPT",
|
||||
"item": "C4 deployment shapes (DeploymentNode/ContainerInstance)",
|
||||
"ref": "c4model.com",
|
||||
"why": "become machine-derived deployed_by/connects_to with evidence, not hand-authored"
|
||||
},
|
||||
{
|
||||
"disposition": "ADAPT",
|
||||
"item": "Glean immutable-batch layering",
|
||||
"ref": "glean.software",
|
||||
"why": "our snapshots are philosophically identical; mark externally-derived edges with distinct authority"
|
||||
},
|
||||
{
|
||||
"disposition": "COMBINE",
|
||||
"item": "Backstage org model + Kythe code model + Nx traversal COMBINED on our evidence-gated store",
|
||||
"ref": "combined",
|
||||
"why": "prior art occupies one layer each; the cross-layer join is the actual design"
|
||||
},
|
||||
{
|
||||
"disposition": "REJECT",
|
||||
"item": "Adopting CodeQL/Kythe/Glean as our store core; generic graph DB (Neo4j); LSIF; Stack Graphs (archived 2025-09)",
|
||||
"ref": "various",
|
||||
"why": "none carry evidence_refs/authority/status/maturity as first-class; heavyweight or dead"
|
||||
},
|
||||
{
|
||||
"disposition": "INNOVATE",
|
||||
"item": "Consent-gated schema migration; verified_by edges to verification entities; deployed_by with code linkage; authority-graded evidence on every edge",
|
||||
"ref": "18V assessment",
|
||||
"why": "genuinely absent from all surveyed systems"
|
||||
}
|
||||
],
|
||||
"implications": {
|
||||
"architecture": [],
|
||||
"migration": [],
|
||||
"structural": [],
|
||||
"verification": []
|
||||
},
|
||||
"inward": {
|
||||
"findings": [],
|
||||
"refs": []
|
||||
},
|
||||
"issue_ref": "research/t18-structural-model-prior-art",
|
||||
"kind": "build_basis",
|
||||
"outward": {
|
||||
"findings": [],
|
||||
"prior_art_questions_answered": [
|
||||
"what already exists addressing this intent",
|
||||
"what open-source systems/products/workflows attempt it",
|
||||
"what architectural patterns already work",
|
||||
"what standards/conventions exist",
|
||||
"what can be directly ADOPTED",
|
||||
"what can be ADAPTED",
|
||||
"what can be COMBINED",
|
||||
"what should be REJECTED",
|
||||
"where is genuine INNOVATION required"
|
||||
],
|
||||
"refs": [
|
||||
"https://backstage.io/docs/features/software-catalog/system-model/",
|
||||
"https://kythe.io/docs/schema/",
|
||||
"https://github.com/scip-code/scip",
|
||||
"https://nx.dev/concepts/affected",
|
||||
"https://c4model.com/",
|
||||
"https://bazel.build/query/language",
|
||||
"https://github.com/dependency-cruiser/dependency-cruiser"
|
||||
]
|
||||
},
|
||||
"question": "What existing systems/modeling approaches should Scaffolding's structural Scaffold adopt, adapt, combine, or reject?",
|
||||
"risks": [],
|
||||
"schema_version": 1,
|
||||
"uncertainty": []
|
||||
}
|
||||
@@ -0,0 +1,32 @@
|
||||
{
|
||||
"schema_version": 1,
|
||||
"target": "component:structural_model",
|
||||
"affected_domains": [
|
||||
"domain:structural-awareness"
|
||||
],
|
||||
"affected_subsystems": [],
|
||||
"consumers_connectors": [],
|
||||
"candidate_files": [],
|
||||
"contract_scope_additions": [],
|
||||
"state_implications": [
|
||||
"state_store:structural-store"
|
||||
],
|
||||
"environment_runtime_implications": [],
|
||||
"migration_implications": [],
|
||||
"risks_uncertainties": [
|
||||
{
|
||||
"kind": "dynamic-consumer",
|
||||
"note": "static model cannot see dynamic dispatch/string-keyed lookup/late-binding consumers \u2014 reconcilers must verify at runtime"
|
||||
}
|
||||
],
|
||||
"verification_plan": [
|
||||
"test_suite:scaffolding-tests"
|
||||
],
|
||||
"rollback_implications": [
|
||||
"revert contract scope commits; deployment rollbacks via last-good symlink (canonical deploy machinery)"
|
||||
],
|
||||
"basis_summary": {
|
||||
"depth": "INWARD",
|
||||
"why": "depth supplied by caller (recorded, caller accountable)"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,34 @@
|
||||
{
|
||||
"contract_id": "18q-graph-projection",
|
||||
"construction_base": "b7865a76bbdb",
|
||||
"runtime_generation": "dep-29570f4",
|
||||
"candidate_generation": "",
|
||||
"promotion_target": "gitea/master",
|
||||
"rollback_generation": "",
|
||||
"stages_completed": [
|
||||
"base_verified",
|
||||
"worktree_created",
|
||||
"construction",
|
||||
"verified",
|
||||
"committed"
|
||||
],
|
||||
"lifecycle": [
|
||||
"base_verified",
|
||||
"worktree_created",
|
||||
"construction",
|
||||
"verified",
|
||||
"committed",
|
||||
"pushed",
|
||||
"ci_qualified",
|
||||
"released",
|
||||
"deployment_confirmed",
|
||||
"evidence_archived",
|
||||
"cleaned"
|
||||
],
|
||||
"evidence": [
|
||||
{
|
||||
"stage": "worktree_created",
|
||||
"evidence": "harness worktree (existing dev worktree, rule P)"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
# T18 §18R/§18S — adversarial matrix + V1 gap reassessment (2026-09-15)
|
||||
|
||||
## §18R — 20-case matrix → evidence
|
||||
|
||||
| # | Case | Evidence |
|
||||
|---|------|----------|
|
||||
| 1 | stale Scaffold | test_18r_stale_scaffold_reconciles_via_drift (MATERIAL + reconciliation) |
|
||||
| 2 | changed file location | 18H moved-file detection (src/widgets/widget.py) |
|
||||
| 3 | unknown dynamic consumer | test_18r_dynamic_consumers_stay_uncertain (explicit uncertainty) |
|
||||
| 4 | broken connector | structural_model: consumers/depends_on status field; stale edges excluded from queries |
|
||||
| 5 | research unavailable | build_basis: unqualified basis → is_qualified False; contracts cannot attach qualified=false silently |
|
||||
| 6 | research contradicts architecture assumption | dispositions carry REJECT with why (18D basis: REJECT graph-DB adoption) |
|
||||
| 7 | target expands outside scope | rule J: reconcile/expand explicitly — impact closure marks non_goals + uncertainty; contract scope amendments user-gated (scaffold.py) |
|
||||
| 8 | user rejects material schema upgrade | test_18r_user_rejects_material_upgrade (ConsentRequired) |
|
||||
| 9 | minor compatible migration | classify_migration MINOR = automatic (test_18i) |
|
||||
| 10 | dirty worktree | test_18r_dirty_worktree_is_visible_not_fatal (detect + record, policy per-contract) |
|
||||
| 11 | interrupted construction | T14E SIGKILL live + 17E restart held-outs |
|
||||
| 12 | provider unavailable | 16G-C verbatim status codes; PROVIDER_UNAVAILABLE blocks branch |
|
||||
| 13 | CI failure | T16 16D: deploy refused truthfully on red |
|
||||
| 14 | deployment failure | runs 7953/7958 failed fast+truthful (T16 17C finding) |
|
||||
| 15 | old runtime + candidate schema incompatibility | consent machinery: material migrations gated per project (18I) |
|
||||
| 16 | secret present in env/config | test_18r_secret_in_env_does_not_block_construction (rule O: continues) |
|
||||
| 17 | secret in generated output | test_18r_secret_value_redacted_in_store — **FOUND REAL BUG: *_token keys were not redacted; fixed (substring match now)** |
|
||||
| 18 | forge unavailable | test_18r_forge_unavailable_raises_explicitly (ForgeUnavailable, never truth change) |
|
||||
| 19 | structural graph projection stale | test_18q_projection_is_read_only + projection regenerated on model change (18P step 9) |
|
||||
| 20 | /build route backend bypass | 18M: /build start mints canonical contract (test_native_default + gate) |
|
||||
| 21 | contextual ambiguous authorization | 17Q-6 + 18N multiple-proposal terse selection |
|
||||
|
||||
**Matrix yield: 2 real defects found and fixed** (secret redaction gap;
|
||||
drift source-field mismatch) — the matrix is load-bearing, not decorative.
|
||||
|
||||
## §18S — V1 gap re-score (post-T18)
|
||||
|
||||
| North Star capability | T18-start | T18-end |
|
||||
|---|---|---|
|
||||
| Research-led construction (Build Basis) | ABSENT | **TEST_PROVEN + one QUALIFIED real basis (18D)** |
|
||||
| Contextual research plan (correction) | — | **TEST_PROVEN (disjoint-plan held-outs)** |
|
||||
| OUTWARD precedent-first | PARTIAL | **TEST_PROVEN (contract questions + real run)** |
|
||||
| First-class structural Scaffold | PARTIAL | **TEST_PROVEN + LIVE on Scaffolding itself (18O)** |
|
||||
| Structure→scope→governance | PARTIAL | **TEST_PROVEN (closure→contract 18P)** |
|
||||
| Visible impact preview | ABSENT | **TEST_PROVEN (18G + real 18P preview persisted)** |
|
||||
| Structural drift | PARTIAL | **TEST_PROVEN (18H; 2 bugs found by matrix)** |
|
||||
| Schema versioning + consent | PARTIAL | **TEST_PROVEN (18I; consent structurally enforced)** |
|
||||
| Environment/runtime model | PARTIAL | **TEST_PROVEN (env/deployment entities + distinction)** |
|
||||
| Workspace lifecycle | PARTIAL | **TEST_PROVEN (18K order-enforced; adapter retained)** |
|
||||
| Forge boundary | ABSENT | **TEST_PROVEN (18L; Gitea proven by every push this session)** |
|
||||
| Full route convergence | PARTIAL | **TEST_PROVEN (18M: /build start mints contracts)** |
|
||||
| Contextual generalisation | TEST_PROVEN | **TEST_PROVEN+ (18N: 4 semantic gaps fixed)** |
|
||||
| Self-scaffold | PARTIAL | **LIVE (18O consistency-enforced)** |
|
||||
| Upgrade-via-Scaffold | ABSENT | **LIVE_PROVEN (18P: 11 scaffold-driven steps)** |
|
||||
| Graph projection | ABSENT | **TEST_PROVEN (18Q, 3 formats)** |
|
||||
| Memory/Substrate | ABSENT | ABSENT (BY DESIGN — rule L) |
|
||||
| Kernel behavior changes | — | **ZERO frozen-kernel exceptions (rule B record: none needed)** |
|
||||
|
||||
## VERDICT: RETROFIT_READY (for the Rune-wide retrofit tranche)
|
||||
|
||||
Why: every V1 foundation capability is implemented, test-proven, and —
|
||||
where the tranche could — live-proven on Scaffolding itself (self-
|
||||
scaffold, scaffold-driven upgrade, qualified research basis from real
|
||||
prior-art work). The adversarial matrix made the system better (2 real
|
||||
fixes). What remains is exactly the mandate's next phase: applying this
|
||||
discipline across Rune's remaining subsystems (Spine modernisation,
|
||||
research pipeline modeling, release/deploy structural entities) and
|
||||
real external projects — plus natural-production confirmation of the
|
||||
event-replay path (mechanism proven; natural timing pending, as in T17).
|
||||
Not full V1: generalisation beyond one project is still ahead.
|
||||
@@ -0,0 +1,84 @@
|
||||
digraph structural {
|
||||
rankdir=LR;
|
||||
node [shape=box, style="rounded,filled", fillcolor="#eef"];
|
||||
"component:build_mode_adapter" [label="build_mode_adapter (component)"];
|
||||
"component:build_basis" [label="build_basis (component)"];
|
||||
"component:construction_activation" [label="construction_activation (component)"];
|
||||
"component:construction_decision" [label="construction_decision (component)"];
|
||||
"component:construction_intent" [label="construction_intent (component)"];
|
||||
"component:construction_interface" [label="construction_interface (component)"];
|
||||
"component:construction_mode" [label="construction_mode (component)"];
|
||||
"component:drift_resume" [label="drift_resume (component)"];
|
||||
"component:event_wait" [label="event_wait (component)"];
|
||||
"component:failure_recovery" [label="failure_recovery (component)"];
|
||||
"component:forge" [label="forge (component)"];
|
||||
"component:graph_projection" [label="graph_projection (component)"];
|
||||
"component:impact_preview" [label="impact_preview (component)"];
|
||||
"component:programme_continuation" [label="programme_continuation (component)"];
|
||||
"component:scaffold" [label="scaffold (component)"];
|
||||
"component:stage_guards" [label="stage_guards (component)"];
|
||||
"component:structural_migration" [label="structural_migration (component)"];
|
||||
"component:structural_model" [label="structural_model (component)"];
|
||||
"deployment_surface:rune-code-current" [label="rune-code-current (deployment_surface)"];
|
||||
"domain:construction-governance" [label="construction-governance (domain)"];
|
||||
"domain:execution-integration" [label="execution-integration (domain)"];
|
||||
"domain:structural-awareness" [label="structural-awareness (domain)"];
|
||||
"environment:production" [label="production (environment)"];
|
||||
"interface:builder-boundary" [label="builder-boundary (interface)"];
|
||||
"state_store:scaffold-store" [label="scaffold-store (state_store)"];
|
||||
"state_store:structural-store" [label="structural-store (state_store)"];
|
||||
"subsystem:execution" [label="execution (subsystem)"];
|
||||
"subsystem:interpretation" [label="interpretation (subsystem)"];
|
||||
"subsystem:kernel" [label="kernel (subsystem)"];
|
||||
"subsystem:structural" [label="structural (subsystem)"];
|
||||
"test_suite:scaffolding-tests" [label="scaffolding-tests (test_suite)"];
|
||||
"project:scaffolding" [label="scaffolding (project)"];
|
||||
"component:build_mode_adapter" -> "subsystem:kernel" [label="legacy_of"];
|
||||
"component:build_basis" -> "state_store:structural-store" [label="reads"];
|
||||
"component:build_basis" -> "subsystem:structural" [label="belongs_to"];
|
||||
"component:build_mode_adapter" -> "subsystem:execution" [label="belongs_to"];
|
||||
"component:construction_activation" -> "subsystem:interpretation" [label="belongs_to"];
|
||||
"component:construction_decision" -> "subsystem:kernel" [label="belongs_to"];
|
||||
"component:construction_intent" -> "component:construction_mode" [label="consumes"];
|
||||
"component:construction_intent" -> "subsystem:interpretation" [label="belongs_to"];
|
||||
"component:construction_interface" -> "interface:builder-boundary" [label="provides"];
|
||||
"component:construction_interface" -> "subsystem:execution" [label="belongs_to"];
|
||||
"component:construction_mode" -> "subsystem:kernel" [label="belongs_to"];
|
||||
"component:drift_resume" -> "subsystem:structural" [label="belongs_to"];
|
||||
"component:event_wait" -> "component:programme_continuation" [label="connects_to"];
|
||||
"component:event_wait" -> "subsystem:execution" [label="belongs_to"];
|
||||
"component:failure_recovery" -> "subsystem:kernel" [label="belongs_to"];
|
||||
"component:forge" -> "subsystem:execution" [label="belongs_to"];
|
||||
"component:forge" -> "test_suite:scaffolding-tests" [label="verified_by"];
|
||||
"component:graph_projection" -> "state_store:structural-store" [label="reads"];
|
||||
"component:graph_projection" -> "subsystem:structural" [label="belongs_to"];
|
||||
"component:graph_projection" -> "test_suite:scaffolding-tests" [label="verified_by"];
|
||||
"component:impact_preview" -> "subsystem:structural" [label="belongs_to"];
|
||||
"component:programme_continuation" -> "subsystem:execution" [label="belongs_to"];
|
||||
"component:programme_continuation" -> "test_suite:scaffolding-tests" [label="verified_by"];
|
||||
"component:scaffold" -> "component:construction_mode" [label="depends_on"];
|
||||
"component:scaffold" -> "deployment_surface:rune-code-current" [label="deployed_by"];
|
||||
"component:scaffold" -> "state_store:scaffold-store" [label="owns"];
|
||||
"component:scaffold" -> "state_store:structural-store" [label="reads"];
|
||||
"component:scaffold" -> "subsystem:kernel" [label="belongs_to"];
|
||||
"component:scaffold" -> "test_suite:scaffolding-tests" [label="verified_by"];
|
||||
"component:stage_guards" -> "subsystem:kernel" [label="belongs_to"];
|
||||
"component:structural_migration" -> "subsystem:structural" [label="belongs_to"];
|
||||
"component:structural_model" -> "state_store:structural-store" [label="owns"];
|
||||
"component:structural_model" -> "subsystem:structural" [label="belongs_to"];
|
||||
"component:structural_model" -> "test_suite:scaffolding-tests" [label="verified_by"];
|
||||
"deployment_surface:rune-code-current" -> "environment:production" [label="connects_to"];
|
||||
"deployment_surface:rune-code-current" -> "project:scaffolding" [label="belongs_to"];
|
||||
"domain:construction-governance" -> "project:scaffolding" [label="belongs_to"];
|
||||
"domain:execution-integration" -> "project:scaffolding" [label="belongs_to"];
|
||||
"domain:structural-awareness" -> "project:scaffolding" [label="belongs_to"];
|
||||
"environment:production" -> "project:scaffolding" [label="belongs_to"];
|
||||
"interface:builder-boundary" -> "subsystem:execution" [label="belongs_to"];
|
||||
"state_store:scaffold-store" -> "project:scaffolding" [label="belongs_to"];
|
||||
"state_store:structural-store" -> "project:scaffolding" [label="belongs_to"];
|
||||
"subsystem:execution" -> "domain:execution-integration" [label="belongs_to"];
|
||||
"subsystem:interpretation" -> "domain:construction-governance" [label="belongs_to"];
|
||||
"subsystem:kernel" -> "domain:construction-governance" [label="belongs_to"];
|
||||
"subsystem:structural" -> "domain:structural-awareness" [label="belongs_to"];
|
||||
"test_suite:scaffolding-tests" -> "project:scaffolding" [label="belongs_to"];
|
||||
}
|
||||
@@ -0,0 +1,615 @@
|
||||
{
|
||||
"edge_count": 49,
|
||||
"edges": [
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:build_mode_adapter",
|
||||
"status": "active",
|
||||
"to": "subsystem:kernel",
|
||||
"type": "legacy_of"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:build_basis",
|
||||
"status": "active",
|
||||
"to": "state_store:structural-store",
|
||||
"type": "reads"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:build_basis",
|
||||
"status": "active",
|
||||
"to": "subsystem:structural",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:build_mode_adapter",
|
||||
"status": "active",
|
||||
"to": "subsystem:execution",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_activation",
|
||||
"status": "active",
|
||||
"to": "subsystem:interpretation",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_decision",
|
||||
"status": "active",
|
||||
"to": "subsystem:kernel",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_intent",
|
||||
"status": "active",
|
||||
"to": "component:construction_mode",
|
||||
"type": "consumes"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_intent",
|
||||
"status": "active",
|
||||
"to": "subsystem:interpretation",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_interface",
|
||||
"status": "active",
|
||||
"to": "interface:builder-boundary",
|
||||
"type": "provides"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_interface",
|
||||
"status": "active",
|
||||
"to": "subsystem:execution",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:construction_mode",
|
||||
"status": "active",
|
||||
"to": "subsystem:kernel",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:drift_resume",
|
||||
"status": "active",
|
||||
"to": "subsystem:structural",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:event_wait",
|
||||
"status": "active",
|
||||
"to": "component:programme_continuation",
|
||||
"type": "connects_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:event_wait",
|
||||
"status": "active",
|
||||
"to": "subsystem:execution",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:failure_recovery",
|
||||
"status": "active",
|
||||
"to": "subsystem:kernel",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:forge",
|
||||
"status": "active",
|
||||
"to": "subsystem:execution",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:forge",
|
||||
"status": "active",
|
||||
"to": "test_suite:scaffolding-tests",
|
||||
"type": "verified_by"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:graph_projection",
|
||||
"status": "active",
|
||||
"to": "state_store:structural-store",
|
||||
"type": "reads"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:graph_projection",
|
||||
"status": "active",
|
||||
"to": "subsystem:structural",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:graph_projection",
|
||||
"status": "active",
|
||||
"to": "test_suite:scaffolding-tests",
|
||||
"type": "verified_by"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:impact_preview",
|
||||
"status": "active",
|
||||
"to": "subsystem:structural",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:programme_continuation",
|
||||
"status": "active",
|
||||
"to": "subsystem:execution",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:programme_continuation",
|
||||
"status": "active",
|
||||
"to": "test_suite:scaffolding-tests",
|
||||
"type": "verified_by"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:scaffold",
|
||||
"status": "active",
|
||||
"to": "component:construction_mode",
|
||||
"type": "depends_on"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:scaffold",
|
||||
"status": "active",
|
||||
"to": "deployment_surface:rune-code-current",
|
||||
"type": "deployed_by"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:scaffold",
|
||||
"status": "active",
|
||||
"to": "state_store:scaffold-store",
|
||||
"type": "owns"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:scaffold",
|
||||
"status": "active",
|
||||
"to": "state_store:structural-store",
|
||||
"type": "reads"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:scaffold",
|
||||
"status": "active",
|
||||
"to": "subsystem:kernel",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:scaffold",
|
||||
"status": "active",
|
||||
"to": "test_suite:scaffolding-tests",
|
||||
"type": "verified_by"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:stage_guards",
|
||||
"status": "active",
|
||||
"to": "subsystem:kernel",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:structural_migration",
|
||||
"status": "active",
|
||||
"to": "subsystem:structural",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:structural_model",
|
||||
"status": "active",
|
||||
"to": "state_store:structural-store",
|
||||
"type": "owns"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:structural_model",
|
||||
"status": "active",
|
||||
"to": "subsystem:structural",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "component:structural_model",
|
||||
"status": "active",
|
||||
"to": "test_suite:scaffolding-tests",
|
||||
"type": "verified_by"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "deployment_surface:rune-code-current",
|
||||
"status": "active",
|
||||
"to": "environment:production",
|
||||
"type": "connects_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "deployment_surface:rune-code-current",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "domain:construction-governance",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "domain:execution-integration",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "domain:structural-awareness",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "environment:production",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "interface:builder-boundary",
|
||||
"status": "active",
|
||||
"to": "subsystem:execution",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "state_store:scaffold-store",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "state_store:structural-store",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "subsystem:execution",
|
||||
"status": "active",
|
||||
"to": "domain:execution-integration",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "subsystem:interpretation",
|
||||
"status": "active",
|
||||
"to": "domain:construction-governance",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "subsystem:kernel",
|
||||
"status": "active",
|
||||
"to": "domain:construction-governance",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "subsystem:structural",
|
||||
"status": "active",
|
||||
"to": "domain:structural-awareness",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "test_suite:scaffolding-tests",
|
||||
"status": "active",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
},
|
||||
{
|
||||
"authority": "model-author",
|
||||
"from": "project:scaffolding",
|
||||
"status": "root",
|
||||
"to": "project:scaffolding",
|
||||
"type": "belongs_to"
|
||||
}
|
||||
],
|
||||
"generated_at": "2026-09-15T22:10:51Z",
|
||||
"node_count": 32,
|
||||
"nodes": [
|
||||
{
|
||||
"ext": {
|
||||
"bounded_adapter": true,
|
||||
"source": "src/rune/build_mode.py"
|
||||
},
|
||||
"id": "component:build_mode_adapter",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "build_mode_adapter"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/build_basis.py"
|
||||
},
|
||||
"id": "component:build_basis",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "build_basis"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/construction_activation.py"
|
||||
},
|
||||
"id": "component:construction_activation",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "construction_activation"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/construction_decision.py"
|
||||
},
|
||||
"id": "component:construction_decision",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "construction_decision"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/construction_intent.py"
|
||||
},
|
||||
"id": "component:construction_intent",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "construction_intent"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/construction_interface.py"
|
||||
},
|
||||
"id": "component:construction_interface",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "construction_interface"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/construction_mode.py"
|
||||
},
|
||||
"id": "component:construction_mode",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "construction_mode"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/drift_resume.py"
|
||||
},
|
||||
"id": "component:drift_resume",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "drift_resume"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/event_wait.py"
|
||||
},
|
||||
"id": "component:event_wait",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "event_wait"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/failure_recovery.py"
|
||||
},
|
||||
"id": "component:failure_recovery",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "failure_recovery"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/forge.py"
|
||||
},
|
||||
"id": "component:forge",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "forge"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/graph_projection.py"
|
||||
},
|
||||
"id": "component:graph_projection",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "graph_projection"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/impact_preview.py"
|
||||
},
|
||||
"id": "component:impact_preview",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "impact_preview"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/programme_continuation.py"
|
||||
},
|
||||
"id": "component:programme_continuation",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "programme_continuation"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/scaffold.py"
|
||||
},
|
||||
"id": "component:scaffold",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "scaffold"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/stage_guards.py"
|
||||
},
|
||||
"id": "component:stage_guards",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "stage_guards"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/structural_migration.py"
|
||||
},
|
||||
"id": "component:structural_migration",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "structural_migration"
|
||||
},
|
||||
{
|
||||
"ext": {
|
||||
"source": "src/rune/structural_model.py"
|
||||
},
|
||||
"id": "component:structural_model",
|
||||
"kind": "component",
|
||||
"maturity": "DECLARED",
|
||||
"name": "structural_model"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "deployment_surface:rune-code-current",
|
||||
"kind": "deployment_surface",
|
||||
"maturity": "DECLARED",
|
||||
"name": "rune-code-current"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "domain:construction-governance",
|
||||
"kind": "domain",
|
||||
"maturity": "DECLARED",
|
||||
"name": "construction-governance"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "domain:execution-integration",
|
||||
"kind": "domain",
|
||||
"maturity": "DECLARED",
|
||||
"name": "execution-integration"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "domain:structural-awareness",
|
||||
"kind": "domain",
|
||||
"maturity": "DECLARED",
|
||||
"name": "structural-awareness"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "environment:production",
|
||||
"kind": "environment",
|
||||
"maturity": "DECLARED",
|
||||
"name": "production"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "interface:builder-boundary",
|
||||
"kind": "interface",
|
||||
"maturity": "DECLARED",
|
||||
"name": "builder-boundary"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "state_store:scaffold-store",
|
||||
"kind": "state_store",
|
||||
"maturity": "DECLARED",
|
||||
"name": "scaffold-store"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "state_store:structural-store",
|
||||
"kind": "state_store",
|
||||
"maturity": "DECLARED",
|
||||
"name": "structural-store"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "subsystem:execution",
|
||||
"kind": "subsystem",
|
||||
"maturity": "DECLARED",
|
||||
"name": "execution"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "subsystem:interpretation",
|
||||
"kind": "subsystem",
|
||||
"maturity": "DECLARED",
|
||||
"name": "interpretation"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "subsystem:kernel",
|
||||
"kind": "subsystem",
|
||||
"maturity": "DECLARED",
|
||||
"name": "kernel"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "subsystem:structural",
|
||||
"kind": "subsystem",
|
||||
"maturity": "DECLARED",
|
||||
"name": "structural"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "test_suite:scaffolding-tests",
|
||||
"kind": "test_suite",
|
||||
"maturity": "DECLARED",
|
||||
"name": "scaffolding-tests"
|
||||
},
|
||||
{
|
||||
"ext": {},
|
||||
"id": "project:scaffolding",
|
||||
"kind": "project",
|
||||
"maturity": "DECLARED",
|
||||
"name": null
|
||||
}
|
||||
],
|
||||
"project": "scaffolding",
|
||||
"schema_version": 1
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
graph LR
|
||||
n1["build_mode_adapter (component)"]
|
||||
n0["build_basis (component)"]
|
||||
n2["construction_activation (component)"]
|
||||
n3["construction_decision (component)"]
|
||||
n4["construction_intent (component)"]
|
||||
n5["construction_interface (component)"]
|
||||
n6["construction_mode (component)"]
|
||||
n7["drift_resume (component)"]
|
||||
n8["event_wait (component)"]
|
||||
n9["failure_recovery (component)"]
|
||||
n10["forge (component)"]
|
||||
n11["graph_projection (component)"]
|
||||
n12["impact_preview (component)"]
|
||||
n13["programme_continuation (component)"]
|
||||
n14["scaffold (component)"]
|
||||
n15["stage_guards (component)"]
|
||||
n16["structural_migration (component)"]
|
||||
n17["structural_model (component)"]
|
||||
n18["rune-code-current (deployment_surface)"]
|
||||
n19["construction-governance (domain)"]
|
||||
n20["execution-integration (domain)"]
|
||||
n21["structural-awareness (domain)"]
|
||||
n22["production (environment)"]
|
||||
n23["builder-boundary (interface)"]
|
||||
n25["scaffold-store (state_store)"]
|
||||
n26["structural-store (state_store)"]
|
||||
n27["execution (subsystem)"]
|
||||
n28["interpretation (subsystem)"]
|
||||
n29["kernel (subsystem)"]
|
||||
n30["structural (subsystem)"]
|
||||
n31["scaffolding-tests (test_suite)"]
|
||||
n24["scaffolding (project)"]
|
||||
n1 -->|legacy_of| n29
|
||||
n0 -->|reads| n26
|
||||
n0 -->|belongs_to| n30
|
||||
n1 -->|belongs_to| n27
|
||||
n2 -->|belongs_to| n28
|
||||
n3 -->|belongs_to| n29
|
||||
n4 -->|consumes| n6
|
||||
n4 -->|belongs_to| n28
|
||||
n5 -->|provides| n23
|
||||
n5 -->|belongs_to| n27
|
||||
n6 -->|belongs_to| n29
|
||||
n7 -->|belongs_to| n30
|
||||
n8 -->|connects_to| n13
|
||||
n8 -->|belongs_to| n27
|
||||
n9 -->|belongs_to| n29
|
||||
n10 -->|belongs_to| n27
|
||||
n10 -->|verified_by| n31
|
||||
n11 -->|reads| n26
|
||||
n11 -->|belongs_to| n30
|
||||
n11 -->|verified_by| n31
|
||||
n12 -->|belongs_to| n30
|
||||
n13 -->|belongs_to| n27
|
||||
n13 -->|verified_by| n31
|
||||
n14 -->|depends_on| n6
|
||||
n14 -->|deployed_by| n18
|
||||
n14 -->|owns| n25
|
||||
n14 -->|reads| n26
|
||||
n14 -->|belongs_to| n29
|
||||
n14 -->|verified_by| n31
|
||||
n15 -->|belongs_to| n29
|
||||
n16 -->|belongs_to| n30
|
||||
n17 -->|owns| n26
|
||||
n17 -->|belongs_to| n30
|
||||
n17 -->|verified_by| n31
|
||||
n18 -->|connects_to| n22
|
||||
n18 -->|belongs_to| n24
|
||||
n19 -->|belongs_to| n24
|
||||
n20 -->|belongs_to| n24
|
||||
n21 -->|belongs_to| n24
|
||||
n22 -->|belongs_to| n24
|
||||
n23 -->|belongs_to| n27
|
||||
n25 -->|belongs_to| n24
|
||||
n26 -->|belongs_to| n24
|
||||
n27 -->|belongs_to| n20
|
||||
n28 -->|belongs_to| n19
|
||||
n29 -->|belongs_to| n19
|
||||
n30 -->|belongs_to| n21
|
||||
n31 -->|belongs_to| n24
|
||||
@@ -0,0 +1,98 @@
|
||||
{
|
||||
"alternatives_considered": [],
|
||||
"created_at": "2026-09-15T23:39:58Z",
|
||||
"deeper": {
|
||||
"findings": [],
|
||||
"refs": [],
|
||||
"used": false
|
||||
},
|
||||
"depth": {
|
||||
"decided_at": "2026-09-15T23:39:58Z",
|
||||
"depth": "FULL",
|
||||
"mode": "",
|
||||
"route": "RESEARCHED_CHANGE",
|
||||
"why": "route RESEARCHED_CHANGE default"
|
||||
},
|
||||
"dispositions": [
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "Structural closure (Bazel rdeps/Nx affected) as the SOUND invalidation backbone",
|
||||
"ref": "bazel.build",
|
||||
"why": "static closure over-approximates (20-50% precision) \u2014 drives RETEST MARKING, never verdicts"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "Generation-pinned confirmation state (merge-queue semantics: confirmation belongs to a generation, not forever)",
|
||||
"ref": "github merge-queue",
|
||||
"why": "history append-only, never auto-reverts, always names the verifying generation"
|
||||
},
|
||||
{
|
||||
"disposition": "INNOVATE",
|
||||
"item": "Feedback correction loop: predicted-vs-observed impact persisted per change; misses WIDEN future closures",
|
||||
"ref": "netflix/facebook pattern",
|
||||
"why": "no mainstream tool logs prediction accuracy per edge; substitutes for coverage instrumentation we don't control"
|
||||
},
|
||||
{
|
||||
"disposition": "COMBINE",
|
||||
"item": "Context packets: derived/budgeted code layer + thin curated behaviour-ledger layer; NOT hand-maintained prose (rots), NOT embedding-first (similarity\u2260causality)",
|
||||
"ref": "aider.chat/docs/repomap",
|
||||
"why": "aider repomap proves derived context; behaviour lines add intent/risk repomaps lack"
|
||||
},
|
||||
{
|
||||
"disposition": "ADAPT",
|
||||
"item": "Dynamic /testing queue with reopen semantics; process dependents after providers, topological order",
|
||||
"ref": "gitlab flaky insights",
|
||||
"why": "merge-queue eviction + Nx last-successful-commit anchoring avoid re-chasing fixed sets"
|
||||
},
|
||||
{
|
||||
"disposition": "REJECT",
|
||||
"item": "Mutation testing as continuous gate",
|
||||
"ref": "mutmut",
|
||||
"why": "too expensive per-change; retained as audit-time oracle idea only"
|
||||
},
|
||||
{
|
||||
"disposition": "REJECT",
|
||||
"item": "Embedding indexes as PRIMARY dependency mechanism",
|
||||
"ref": "cursor/cody",
|
||||
"why": "similarity is not causality; keep structural closure primary"
|
||||
}
|
||||
],
|
||||
"implications": {
|
||||
"architecture": [],
|
||||
"migration": [],
|
||||
"structural": [],
|
||||
"verification": []
|
||||
},
|
||||
"inward": {
|
||||
"findings": [],
|
||||
"refs": []
|
||||
},
|
||||
"issue_ref": "research/t19-quicksand",
|
||||
"kind": "build_basis",
|
||||
"outward": {
|
||||
"findings": [],
|
||||
"prior_art_questions_answered": [
|
||||
"what already exists addressing this intent",
|
||||
"what open-source systems/products/workflows attempt it",
|
||||
"what architectural patterns already work",
|
||||
"what standards/conventions exist",
|
||||
"what can be directly ADOPTED",
|
||||
"what can be ADAPTED",
|
||||
"what can be COMBINED",
|
||||
"what should be REJECTED",
|
||||
"where is genuine INNOVATION required"
|
||||
],
|
||||
"refs": [
|
||||
"https://bazel.build/query/language",
|
||||
"https://nx.dev/concepts/affected",
|
||||
"https://netflixtechblog.com/practical-intelligent-test-selection-95423d2516d6",
|
||||
"https://docs.pact.io",
|
||||
"https://aider.chat/docs/repomap.html",
|
||||
"https://docs.github.com/en/pull-requests/merging-a-pull-request-with-a-merge-queue"
|
||||
]
|
||||
},
|
||||
"question": "How should Scaffolding safely iterate a large evolving codebase without quicksand, while minimizing LLM context and rediscovery cost?",
|
||||
"risks": [],
|
||||
"schema_version": 1,
|
||||
"uncertainty": []
|
||||
}
|
||||
@@ -0,0 +1,85 @@
|
||||
{
|
||||
"packet": {
|
||||
"schema_version": 1,
|
||||
"intent": "add /testing command backed by testing_mode.aggregate",
|
||||
"target": "component:rune_tui",
|
||||
"target_kind": "component",
|
||||
"owning_domain": "domain:execution-integration",
|
||||
"local": {
|
||||
"schema_version": 1,
|
||||
"capability_id": "capability:tui-testing-command",
|
||||
"name": "TUI /testing command",
|
||||
"purpose": "aggregate outstanding validations across registered scaffolded projects; minimal command surface",
|
||||
"component": "component:rune_tui",
|
||||
"source_locations": [
|
||||
"src/rune/rune_tui.py"
|
||||
],
|
||||
"contract": "/testing \u2192 aggregate; /testing <project> \u2192 filtered; items show behaviour/procedure/criteria/state",
|
||||
"state_touched": "",
|
||||
"dependencies": [],
|
||||
"consumers": [],
|
||||
"invariants": [
|
||||
"testing_mode backend is authority; TUI renders"
|
||||
],
|
||||
"behaviour_specs": [
|
||||
"behaviour:19l-testing-aggregate"
|
||||
],
|
||||
"maturity": "implemented",
|
||||
"constraints": "",
|
||||
"generation": "",
|
||||
"limitations": []
|
||||
},
|
||||
"local_files": [
|
||||
"src/rune/rune_tui.py"
|
||||
],
|
||||
"beneath_count": 0,
|
||||
"connected": {
|
||||
"dependencies": [],
|
||||
"consumers": [],
|
||||
"interface_mediated_consumers": [],
|
||||
"interfaces_provided": [],
|
||||
"state_owned": [],
|
||||
"verification": [],
|
||||
"deployment": [],
|
||||
"uncertainty": [
|
||||
{
|
||||
"kind": "dynamic-consumer",
|
||||
"note": "static model cannot see dynamic dispatch/string-keyed lookup/late-binding consumers \u2014 reconcilers must verify at runtime"
|
||||
}
|
||||
]
|
||||
},
|
||||
"basis_summary": null,
|
||||
"generated_at": "2026-09-16T00:11:56Z"
|
||||
},
|
||||
"preview": {
|
||||
"schema_version": 1,
|
||||
"target": "component:rune_tui",
|
||||
"affected_domains": [
|
||||
"domain:execution-integration"
|
||||
],
|
||||
"affected_subsystems": [],
|
||||
"consumers_connectors": [],
|
||||
"candidate_files": [],
|
||||
"contract_scope_additions": [],
|
||||
"state_implications": [],
|
||||
"environment_runtime_implications": [],
|
||||
"migration_implications": [],
|
||||
"risks_uncertainties": [
|
||||
{
|
||||
"kind": "dynamic-consumer",
|
||||
"note": "static model cannot see dynamic dispatch/string-keyed lookup/late-binding consumers \u2014 reconcilers must verify at runtime"
|
||||
}
|
||||
],
|
||||
"verification_plan": [],
|
||||
"rollback_implications": [
|
||||
"revert contract scope commits; deployment rollbacks via last-good symlink (canonical deploy machinery)"
|
||||
],
|
||||
"basis_summary": {
|
||||
"depth": "INWARD",
|
||||
"why": "route 'INWARD' unknown \u2014 INWARD floor (never silent NONE)",
|
||||
"route": "INWARD",
|
||||
"mode": "",
|
||||
"decided_at": "2026-09-16T00:11:56Z"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,99 @@
|
||||
{
|
||||
"alternatives_considered": [],
|
||||
"created_at": "2026-09-16T01:24:46Z",
|
||||
"deeper": {
|
||||
"findings": [],
|
||||
"refs": [],
|
||||
"used": false
|
||||
},
|
||||
"depth": {
|
||||
"decided_at": "2026-09-16T01:24:46Z",
|
||||
"depth": "FULL",
|
||||
"mode": "",
|
||||
"route": "RESEARCHED_CHANGE",
|
||||
"why": "route RESEARCHED_CHANGE default"
|
||||
},
|
||||
"dispositions": [
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "kind:name stable IDs with path-as-attribute + alias records on move",
|
||||
"ref": "backstage.io",
|
||||
"why": "Backstage entity-ref discipline; Kythe VName declines cross-version stability (we promise it); uid-style instability rejected"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "dynamic-uncertainty edges (static vs dynamic vs exotic taxonomy)",
|
||||
"ref": "dependency-cruiser",
|
||||
"why": "dependency-cruiser taxonomy validates our explicit dynamic edges; import-linter uncovered=unknown framing"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "strangler-fig: model per subsystem alongside legacy; bounded adapters as transitional architecture",
|
||||
"ref": "martinfowler.com",
|
||||
"why": "incremental retrofit without big-bang"
|
||||
},
|
||||
{
|
||||
"disposition": "ADOPT",
|
||||
"item": "two-tier coverage: manifest coverage vs relationship coverage; fail CI on empty-scope contracts",
|
||||
"ref": "archunit.org",
|
||||
"why": "ArchUnit failOnEmptyShould prevents vacuous passes; file-in-manifest \u2260 ownership-known"
|
||||
},
|
||||
{
|
||||
"disposition": "COMBINE",
|
||||
"item": "LSP call hierarchy for symbol precision where static",
|
||||
"ref": "lsp spec",
|
||||
"why": "with import-graph evidence; dynamic dispatch stays runtime-verified"
|
||||
},
|
||||
{
|
||||
"disposition": "ADAPT",
|
||||
"item": "characterization tests before contract enforcement on legacy adapters",
|
||||
"ref": "feathers",
|
||||
"why": "Feathers legacy pattern; one characterization test per adapter"
|
||||
},
|
||||
{
|
||||
"disposition": "INNOVATE",
|
||||
"item": "per-edge trust weights from predicted-vs-observed history",
|
||||
"ref": "t19 basis",
|
||||
"why": "impact_deltas.jsonl compounds into precision; no mainstream tool logs per-edge prediction accuracy"
|
||||
}
|
||||
],
|
||||
"implications": {
|
||||
"architecture": [],
|
||||
"migration": [],
|
||||
"structural": [],
|
||||
"verification": []
|
||||
},
|
||||
"inward": {
|
||||
"findings": [],
|
||||
"refs": []
|
||||
},
|
||||
"issue_ref": "research/t20-retrofit",
|
||||
"kind": "build_basis",
|
||||
"outward": {
|
||||
"findings": [],
|
||||
"prior_art_questions_answered": [
|
||||
"what already exists addressing this intent",
|
||||
"what open-source systems/products/workflows attempt it",
|
||||
"what architectural patterns already work",
|
||||
"what standards/conventions exist",
|
||||
"what can be directly ADOPTED",
|
||||
"what can be ADAPTED",
|
||||
"what can be COMBINED",
|
||||
"what should be REJECTED",
|
||||
"where is genuine INNOVATION required"
|
||||
],
|
||||
"refs": [
|
||||
"https://kythe.io/docs/schema/",
|
||||
"https://github.com/sourcegraph/scip/blob/main/scip.proto",
|
||||
"https://backstage.io/docs/features/software-catalog/descriptor-format",
|
||||
"https://import-linter.readthedocs.io/en/stable/",
|
||||
"https://github.com/sverweij/dependency-cruiser/blob/main/doc/rules-reference.md",
|
||||
"https://martinfowler.com/bliki/StranglerFigApplication.html",
|
||||
"https://www.archunit.org/userguide/html/000_Index.html"
|
||||
]
|
||||
},
|
||||
"question": "How to retrofit Rune's ~160 modules into a structural model incrementally, without big-bang rewrite or excessive granularity?",
|
||||
"risks": [],
|
||||
"schema_version": 1,
|
||||
"uncertainty": []
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
# 20I — Spine modernization decision (2026-09-16)
|
||||
|
||||
## What Spine stores today
|
||||
- 150 module entities (flat, all with source identities), 8 subsystems,
|
||||
1 deployment_surface. NO domains, NO components-as-structural-units,
|
||||
NO interfaces, NO test_suites, NO state stores, NO environments.
|
||||
- Strengths: module-level structural facts (imports, tests, maturity
|
||||
ladder), umbrella ingest, impact_frontier, byte-deterministic snapshots.
|
||||
|
||||
## Rune model (store/rune_model) today
|
||||
- 55 entities: domains (9), subsystems (11), components (31), 1 interface,
|
||||
2 test_suites. Construction-governance oriented.
|
||||
|
||||
## Authority boundary (rule E — defined, not duplicated)
|
||||
|
||||
| Data | Canonical home | Consumers |
|
||||
|---|---|---|
|
||||
| Module-level facts (imports, maturity, canary wiring) | **Spine** | umbrella gates, Henxels, structural health |
|
||||
| Domain/subsystem/component nesting + purpose | **Rune model** | construction, impact, /testing narrowing |
|
||||
| Capability ledgers | **Rune model** (capability_ledger.json) | surgical packets |
|
||||
| Behaviour specs + validation state | **Rune model** (behaviour_ledger.json) | /testing, invalidation |
|
||||
| Cross-store ID discipline | **shared** (kind:name) | both |
|
||||
|
||||
## Modernization performed (bounded, rule I)
|
||||
1. Spine projectors now READ the Rune model for domain membership
|
||||
(no copy): spine's subsystem entities gain an `ext.rune_domain`
|
||||
pointer where the Rune model nests them — LINKED, not copied.
|
||||
2. Drift rule: if a Spine module's source disappears while the Rune
|
||||
model still claims it (or vice versa), detect_structural_drift flags
|
||||
MATERIAL — neither store silently contradicts the other.
|
||||
|
||||
## What was NOT done
|
||||
- No Spine schema migration (domains not forced into Spine).
|
||||
- No bulk copy of Rune-model entities into Spine.
|
||||
- No graph_projection authority claims (projection stays read-only).
|
||||
@@ -0,0 +1,55 @@
|
||||
[
|
||||
{
|
||||
"candidate": "component:build_mode_adapter",
|
||||
"purpose": "worktree/ledger bounded adapter",
|
||||
"callers": [
|
||||
"rune_tui (gated)",
|
||||
"tests"
|
||||
],
|
||||
"dynamic_risk": "low (no reflection entry)",
|
||||
"replacement": "component:scaffold + workspace lifecycle",
|
||||
"classification": "BOUNDED_ADAPTER"
|
||||
},
|
||||
{
|
||||
"candidate": "component:task_persist",
|
||||
"purpose": "persisted.json export ledger (T17: demoted)",
|
||||
"callers": [
|
||||
"auto_context",
|
||||
"CLI only"
|
||||
],
|
||||
"dynamic_risk": "low",
|
||||
"replacement": "TaskStateRepository (canonical)",
|
||||
"classification": "MIGRATION_CANDIDATE"
|
||||
},
|
||||
{
|
||||
"candidate": "canary_native + canary_full_system",
|
||||
"purpose": "layered overlap, acceptable per 17I",
|
||||
"callers": [
|
||||
"CI",
|
||||
"spine registry"
|
||||
],
|
||||
"dynamic_risk": "none",
|
||||
"replacement": "keep layered",
|
||||
"classification": "KEEP"
|
||||
},
|
||||
{
|
||||
"candidate": "component:complexity_scorer",
|
||||
"purpose": "complexity hint (prints, never gates)",
|
||||
"callers": [
|
||||
"rune_tui:2105"
|
||||
],
|
||||
"dynamic_risk": "none",
|
||||
"replacement": "adaptive_router (authoritative)",
|
||||
"classification": "RETIREMENT_CANDIDATE"
|
||||
},
|
||||
{
|
||||
"candidate": "message_queue.detect_task_addition",
|
||||
"purpose": "chat\u2192task queue with regex confidence",
|
||||
"callers": [
|
||||
"rune_tui:2070"
|
||||
],
|
||||
"dynamic_risk": "none",
|
||||
"replacement": "construction_intent (semantic)",
|
||||
"classification": "MIGRATION_CANDIDATE"
|
||||
}
|
||||
]
|
||||
@@ -0,0 +1,29 @@
|
||||
# 20P — CI/type-check determinism investigation (2026-09-16)
|
||||
|
||||
## Finding
|
||||
With the lock at parity (propcache 0.5.4/yarl 1.25.1 pinned everywhere),
|
||||
runner-user and nick-user pyright on the SAME venv give IDENTICAL
|
||||
results (121 errors, 442 warnings, 211 files). The T14H-class skew is
|
||||
NOT user-environment — it is LOCK-CONTENT skew: when requirements-ci.txt
|
||||
pins drift between local and CI (propcache churned twice mid-T19/T20),
|
||||
the two environments resolve different package versions.
|
||||
|
||||
## Root cause
|
||||
`uv pip compile` regenerates against the live index; any upstream
|
||||
release between a local compile and a CI run shifts resolution.
|
||||
requirements-ci.txt pins the RESULT, but the baseline was being
|
||||
re-baselined against whichever environment ran last.
|
||||
|
||||
## Fix applied
|
||||
- Lock re-pinned to current (0.5.4/1.25.1) — verified parity (0 diff lines
|
||||
between fresh compile and committed lock at python-version 3.11).
|
||||
- Baseline set against CI's fresh-resolution arithmetic (454) — matches
|
||||
the environment the gate actually runs in.
|
||||
- RULE recorded: when the lock changes, re-baseline against a venv built
|
||||
from the NEW lock, never against the old venv.
|
||||
|
||||
## Honest residual
|
||||
Local pre-flight cannot perfectly predict CI when upstream releases land
|
||||
between push and CI run. The structural fix (fully hermetic lockfile
|
||||
with hashes) is a bounded item for the retrofit tranche, recorded as
|
||||
behaviour VAL-RUNE-010.
|
||||
@@ -0,0 +1,63 @@
|
||||
# 20Q — surgical-context benchmarks across Rune domains (2026-09-16)
|
||||
|
||||
## Task 1: provider decision ownership (inference-providers domain)
|
||||
- COLD (fresh explore agent): running in parallel — results appended below.
|
||||
- SCAFFOLD-GUIDED: 1 context_packet call (0 file reads), answered from
|
||||
capability ledger + structural edges: owner=rune_operator,
|
||||
influences=adaptive_router+construction_mode, consumers=rune_tui.
|
||||
Context: ~700-byte ledger entry + structural closure. No repo scan.
|
||||
|
||||
## Task 2: task-state canonical authority (state-resilience domain)
|
||||
- SCAFFOLD-GUIDED: 0 file reads — ledger state_touched field answers
|
||||
directly: "TaskStateRepository (canonical), operator.json (legacy
|
||||
cache)". Invariant recorded: "route decided before execution".
|
||||
|
||||
## Honest assessment
|
||||
The cold agents' parallel results will show whether raw discovery cost
|
||||
differs. What the scaffold demonstrably provides regardless of speed:
|
||||
- authority answers carry the VALIDATION state (VAL-* links),
|
||||
- obligations (what to retest) come free with the answer,
|
||||
- the answer is stable across sessions (no re-derivation each time).
|
||||
|
||||
## Structural facts
|
||||
- Rune model: 107 entities, 94 relationships, 37% file coverage
|
||||
(50/136 — honest: NOT "fully mapped"), 3 state stores, 9 domains.
|
||||
- Capability ledgers: 4 representative (699-866 bytes each — compact).
|
||||
- Behaviour ledger: 10 specs (8 AUTO_VERIFIED, 1 manual pending,
|
||||
1 hardening item), 0 USER_CONFIRMED (none manufactured).
|
||||
|
||||
## Cold results (parallel fresh agents, received)
|
||||
|
||||
### Task 1: provider decision ownership
|
||||
- COLD: **16 tool calls, 10 files opened** — rune_operator.py:1015-1066
|
||||
(tier loop = final decider), model_routing rank() advisory,
|
||||
work_manager route_batch, model_connect, tiered_executor, TUI
|
||||
override, subsystem_health fallback — 9+ influencing modules mapped.
|
||||
- SCAFFOLD-GUIDED: 1 packet call, 0 file reads. Answer: owner +
|
||||
adaptive_router/construction_mode as dependencies, rune_tui consumer.
|
||||
- **Assessment: cold found MORE breadth (9 influencers vs 2 deps) —
|
||||
the model's dependency edges were COARSER than cold analysis.**
|
||||
Honest: for "list every influencer" questions, cold grep+sweep wins.
|
||||
The scaffold's edge set under-models advisory-only influencers
|
||||
(rank() is advisory — not a depends_on edge by our vocabulary).
|
||||
|
||||
### Task 2: task-state canonical authority
|
||||
- COLD: **11 tool calls, 2 files** — found canonical repo + caches +
|
||||
RISK: ~10 non-canonical writers mutate RuneTask.status THEN mirror
|
||||
via transition(); crash between = legacy ahead of truth;
|
||||
_task_counters falls back to cache on empty repo.
|
||||
- SCAFFOLD-GUIDED: 0 file reads — ledger answered canonical-vs-cache
|
||||
directly but did NOT surface the write-ordering crash-window risk.
|
||||
- **Assessment: cold found a REAL defect-shaped risk the ledger
|
||||
lacked.** The ledger's invariants covered ownership, not failure
|
||||
ordering. This is a genuine ledger-content gap, recorded.
|
||||
|
||||
## Verdict (honest, per mandate)
|
||||
- Speed: scaffold-guided is faster on narrow authority questions
|
||||
(1 vs 11-16 calls) but this repo is well-organized; on breadth
|
||||
questions cold sweeps still win.
|
||||
- The scaffold's structural edges are COARSER than code reality —
|
||||
impact closure over-approximates narrowly (misses advisory-only
|
||||
influencers) and ledgers lack failure-ordering detail.
|
||||
- Improvement recorded: capability ledgers should carry a
|
||||
"risk_notes" field for write-ordering/failure-window facts.
|
||||
@@ -0,0 +1,43 @@
|
||||
# 20U — V1 requirement classification after retrofit (2026-09-16)
|
||||
|
||||
| Requirement | Status | Evidence |
|
||||
|---|---|---|
|
||||
| construction kernel | LIVE_PROVEN | T14-T19 production cycles; 19A fail-closed |
|
||||
| contextual intent | TEST_PROVEN + LIVE (17R, 19R) | 22+6 held-outs; two live conversational proofs |
|
||||
| Research Core integration | TEST_PROVEN | build_basis qualified ×2 real bases; depth-from-route |
|
||||
| structural Scaffold | TEST_PROVEN + LIVE (18O, 19R) | self-scaffold consistency-enforced; 107-entity Rune model |
|
||||
| bounded scope/impact | TEST_PROVEN | closures + previews + deltas |
|
||||
| new-build mode | TEST_PROVEN | classify + bootstrap; 17Q-1/14 |
|
||||
| retrofit mode | LIVE_PROVEN | T20: 107 entities via surgical workflow |
|
||||
| future-upgrade mode | LIVE_PROVEN | 18P 11-step scaffold-driven upgrade |
|
||||
| Capability Ledgers | TEST_PROVEN + LIVE | 19R packet bound 1 file; risk_notes added from benchmark |
|
||||
| Project Registry | TEST_PROVEN | boundaries proven |
|
||||
| Behaviour Validation Ledger | TEST_PROVEN | generation history; selective invalidation; no manufactured USER_CONFIRMED |
|
||||
| quicksand protection | TEST_PROVEN + LIVE (20R) | real-entity invalidation + preservation |
|
||||
| /testing | TEST_PROVEN + LIVE (19R) | backend + command; dynamic queue |
|
||||
| Observation→diagnosis | TEST_PROVEN | closure gate (retest AND confirm) |
|
||||
| drift | TEST_PROVEN | 18H entity checks; 2 real fixes by matrix |
|
||||
| schema migration consent | TEST_PROVEN | ConsentRequired structurally enforced |
|
||||
| workspace lifecycle | TEST_PROVEN | order-enforced; generations not mutations |
|
||||
| forge abstraction | TEST_PROVEN | Gitea proven every push; fail-loud fix |
|
||||
| self-update isolation | PARTIAL | worktree-per-contract proven; live-runtime A/B generation swap NOT yet exercised |
|
||||
| Rune-wide retrofit | PARTIAL | 37% file coverage — honest, not complete |
|
||||
| Spine modernization | PARTIAL | boundary defined, 8 subsystems linked; no schema migration |
|
||||
| structural graph | TEST_PROVEN | rune graph 107 nodes/171 edges, read-only |
|
||||
| substantial transformation proof | TEST_PROVEN | 20E retrofit + 19R /testing command |
|
||||
| retirement/deletion proof | PARTIAL | plugin deletion (T17) only; backlog classified, not executed |
|
||||
| external-project adoption | ABSENT | no external project scaffolded yet |
|
||||
| provider-independent operation | TEST_PROVEN | structural guard; ambient context |
|
||||
| operational usefulness | TEST_PROVEN + honest limits | 20Q: faster on narrow questions; breadth still favors cold sweeps; coarse edges recorded |
|
||||
|
||||
## VERDICT: NEAR_V1_ACCEPTANCE_READY
|
||||
|
||||
Missing proof classes (exactly the mandate's predicted list):
|
||||
- substantial legacy transformation (backlog classified, not executed)
|
||||
- governed retirement/deletion beyond one plugin
|
||||
- full self-update/live-runtime proof (A/B generation swap)
|
||||
- external-project adoption
|
||||
|
||||
The retrofit succeeded; the foundation is proven at Rune scale (37%
|
||||
coverage is the honest number). What remains is proof-class breadth,
|
||||
not missing architecture.
|
||||
@@ -0,0 +1,281 @@
|
||||
digraph structural {
|
||||
rankdir=LR;
|
||||
node [shape=box, style="rounded,filled", fillcolor="#eef"];
|
||||
"component:auto_bump_pr" [label="auto_bump_pr (component)"];
|
||||
"component:create_release" [label="create_release (component)"];
|
||||
"component:deploy_promotion" [label="deploy_promotion (component)"];
|
||||
"component:deploy_qualify" [label="deploy_qualify (component)"];
|
||||
"component:deploy_stage" [label="deploy_stage (component)"];
|
||||
"component:gitea_auth" [label="gitea_auth (component)"];
|
||||
"component:semver_bump" [label="semver_bump (component)"];
|
||||
"component:version_convergence" [label="version_convergence (component)"];
|
||||
"component:adaptive_router" [label="adaptive_router (component)"];
|
||||
"component:attention_capsule" [label="attention_capsule (component)"];
|
||||
"component:behaviour_ledger" [label="behaviour_ledger (component)"];
|
||||
"component:build_mode_adapter" [label="build_mode_adapter (component)"];
|
||||
"component:builder_bridge" [label="builder_bridge (component)"];
|
||||
"component:canary_native" [label="canary_native (component)"];
|
||||
"component:capability_ledger" [label="capability_ledger (component)"];
|
||||
"component:claim_audit" [label="claim_audit (component)"];
|
||||
"component:construction_interface" [label="construction_interface (component)"];
|
||||
"component:construction_mode" [label="construction_mode (component)"];
|
||||
"component:context_broker" [label="context_broker (component)"];
|
||||
"component:curator" [label="curator (component)"];
|
||||
"component:drift_ledger" [label="drift_ledger (component)"];
|
||||
"component:drift_observability" [label="drift_observability (component)"];
|
||||
"component:drift_resume" [label="drift_resume (component)"];
|
||||
"component:event_wait" [label="event_wait (component)"];
|
||||
"component:failure_recovery" [label="failure_recovery (component)"];
|
||||
"component:graph_memory" [label="graph_memory (component)"];
|
||||
"component:identity_anchors" [label="identity_anchors (component)"];
|
||||
"component:iteration" [label="iteration (component)"];
|
||||
"component:local_tool_runtime" [label="local_tool_runtime (component)"];
|
||||
"component:memory_env" [label="memory_env (component)"];
|
||||
"component:memory_selector" [label="memory_selector (component)"];
|
||||
"component:memory_store" [label="memory_store (component)"];
|
||||
"component:microkernel" [label="microkernel (component)"];
|
||||
"component:model_connect" [label="model_connect (component)"];
|
||||
"component:model_registry" [label="model_registry (component)"];
|
||||
"component:model_routing" [label="model_routing (component)"];
|
||||
"component:night_mode" [label="night_mode (component)"];
|
||||
"component:openai_compat_transport" [label="openai_compat_transport (component)"];
|
||||
"component:atomic" [label="atomic (component)"];
|
||||
"component:conversation_state" [label="conversation_state (component)"];
|
||||
"component:event_store" [label="event_store (component)"];
|
||||
"component:records" [label="records (component)"];
|
||||
"component:programme_continuation" [label="programme_continuation (component)"];
|
||||
"component:project_registry" [label="project_registry (component)"];
|
||||
"component:provider_registry" [label="provider_registry (component)"];
|
||||
"component:query_memory" [label="query_memory (component)"];
|
||||
"component:recall_router" [label="recall_router (component)"];
|
||||
"component:recall_uplift" [label="recall_uplift (component)"];
|
||||
"component:route_risk_flags" [label="route_risk_flags (component)"];
|
||||
"component:rune_operator" [label="rune_operator (component)"];
|
||||
"component:rune_tui" [label="rune_tui (component)"];
|
||||
"component:scaffold" [label="scaffold (component)"];
|
||||
"component:standardized_providers" [label="standardized_providers (component)"];
|
||||
"component:subconscious_pass" [label="subconscious_pass (component)"];
|
||||
"component:subsystem_health" [label="subsystem_health (component)"];
|
||||
"component:task_gate" [label="task_gate (component)"];
|
||||
"component:task_persist" [label="task_persist (component)"];
|
||||
"component:testing_mode" [label="testing_mode (component)"];
|
||||
"component:tool_executor" [label="tool_executor (component)"];
|
||||
"component:tool_protocol" [label="tool_protocol (component)"];
|
||||
"component:tui_backlog" [label="tui_backlog (component)"];
|
||||
"component:warm_neuron_store" [label="warm_neuron_store (component)"];
|
||||
"component:warm_router" [label="warm_router (component)"];
|
||||
"component:work_manager" [label="work_manager (component)"];
|
||||
"component:conversation_state_probe" [label="conversation_state_probe (component)"];
|
||||
"component:growth_simulator" [label="growth_simulator (component)"];
|
||||
"component:persona" [label="persona (component)"];
|
||||
"component:voice_synthesis" [label="voice_synthesis (component)"];
|
||||
"deployment_surface:rune-code-current" [label="rune-code-current (deployment_surface)"];
|
||||
"domain:client-presentation" [label="client-presentation (domain)"];
|
||||
"domain:construction-governance" [label="construction-governance (domain)"];
|
||||
"domain:execution-runtime" [label="execution-runtime (domain)"];
|
||||
"domain:inference-providers" [label="inference-providers (domain)"];
|
||||
"domain:memory-identity" [label="memory-identity (domain)"];
|
||||
"domain:orchestration-execution" [label="orchestration-execution (domain)"];
|
||||
"domain:perception-context" [label="perception-context (domain)"];
|
||||
"domain:release-delivery" [label="release-delivery (domain)"];
|
||||
"domain:state-resilience" [label="state-resilience (domain)"];
|
||||
"domain:validation" [label="validation (domain)"];
|
||||
"domain:validation-health" [label="validation-health (domain)"];
|
||||
"environment:production" [label="production (environment)"];
|
||||
"interface:operator-api" [label="operator-api (interface)"];
|
||||
"state_store:scaffold-store" [label="scaffold-store (state_store)"];
|
||||
"state_store:spine-store" [label="spine-store (state_store)"];
|
||||
"state_store:wr-bridge" [label="wr-bridge (state_store)"];
|
||||
"subsystem:canaries" [label="canaries (subsystem)"];
|
||||
"subsystem:ci-verification" [label="ci-verification (subsystem)"];
|
||||
"subsystem:context" [label="context (subsystem)"];
|
||||
"subsystem:deploy" [label="deploy (subsystem)"];
|
||||
"subsystem:event-resilience" [label="event-resilience (subsystem)"];
|
||||
"subsystem:growth" [label="growth (subsystem)"];
|
||||
"subsystem:health" [label="health (subsystem)"];
|
||||
"subsystem:identity" [label="identity (subsystem)"];
|
||||
"subsystem:memory" [label="memory (subsystem)"];
|
||||
"subsystem:operator" [label="operator (subsystem)"];
|
||||
"subsystem:orchestration" [label="orchestration (subsystem)"];
|
||||
"subsystem:recall" [label="recall (subsystem)"];
|
||||
"subsystem:registry" [label="registry (subsystem)"];
|
||||
"subsystem:routing" [label="routing (subsystem)"];
|
||||
"subsystem:task-state" [label="task-state (subsystem)"];
|
||||
"subsystem:tool-runtime" [label="tool-runtime (subsystem)"];
|
||||
"subsystem:transports" [label="transports (subsystem)"];
|
||||
"subsystem:tui" [label="tui (subsystem)"];
|
||||
"subsystem:work-dispatch" [label="work-dispatch (subsystem)"];
|
||||
"test_suite:rune-tests" [label="rune-tests (test_suite)"];
|
||||
"test_suite:tui-tests" [label="tui-tests (test_suite)"];
|
||||
"project:rune" [label="rune (project)"];
|
||||
"component:build_mode_adapter" -> "component:scaffold" [label="legacy_of"];
|
||||
"component:event_wait" -> "state_store:wr-bridge" [label="owns"];
|
||||
"component:scaffold" -> "state_store:scaffold-store" [label="owns"];
|
||||
"component:event_wait" -> "component:programme_continuation" [label="connects_to"];
|
||||
"component:rune_tui" -> "interface:builder-boundary" [label="consumes"];
|
||||
"component:rune_tui" -> "test_suite:tui-tests" [label="verified_by"];
|
||||
"component:programme_continuation" -> "component:construction_interface" [label="depends_on"];
|
||||
"component:programme_continuation" -> "component:event_wait" [label="depends_on"];
|
||||
"component:rune_operator" -> "component:adaptive_router" [label="depends_on"];
|
||||
"component:rune_operator" -> "component:construction_mode" [label="depends_on"];
|
||||
"component:scaffold" -> "component:construction_mode" [label="depends_on"];
|
||||
"component:rune_tui" -> "component:rune_operator" [label="depends_on"];
|
||||
"component:adaptive_router" -> "interface:builder-boundary" [label="provides"];
|
||||
"component:adaptive_router" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:atomic" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:attention_capsule" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:auto_bump_pr" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:behaviour_ledger" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:builder_bridge" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:canary_native" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:capability_ledger" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:claim_audit" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:context_broker" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:conversation_state" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:create_release" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:curator" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:deploy_promotion" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:deploy_qualify" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:deploy_stage" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:drift_ledger" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:drift_observability" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:drift_resume" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:event_store" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:failure_recovery" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:gitea_auth" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:graph_memory" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:identity_anchors" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:iteration" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:local_tool_runtime" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:memory_env" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:memory_selector" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:memory_store" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:microkernel" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:model_connect" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:model_registry" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:model_routing" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:night_mode" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:openai_compat_transport" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:project_registry" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:provider_registry" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:query_memory" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:recall_router" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:recall_uplift" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:records" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:route_risk_flags" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:rune_operator" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:semver_bump" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:standardized_providers" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:subconscious_pass" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:subsystem_health" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:task_gate" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:task_persist" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:testing_mode" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:tool_executor" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:tool_protocol" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:version_convergence" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:warm_neuron_store" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:warm_router" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:work_manager" -> "test_suite:rune-tests" [label="verified_by"];
|
||||
"component:adaptive_router" -> "subsystem:routing" [label="belongs_to"];
|
||||
"component:atomic" -> "subsystem:orchestration" [label="belongs_to"];
|
||||
"component:attention_capsule" -> "subsystem:context" [label="belongs_to"];
|
||||
"component:auto_bump_pr" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:behaviour_ledger" -> "subsystem:registry" [label="belongs_to"];
|
||||
"component:builder_bridge" -> "subsystem:work-dispatch" [label="belongs_to"];
|
||||
"component:canary_native" -> "subsystem:canaries" [label="belongs_to"];
|
||||
"component:capability_ledger" -> "subsystem:registry" [label="belongs_to"];
|
||||
"component:claim_audit" -> "subsystem:growth" [label="belongs_to"];
|
||||
"component:context_broker" -> "subsystem:context" [label="belongs_to"];
|
||||
"component:conversation_state" -> "subsystem:orchestration" [label="belongs_to"];
|
||||
"component:conversation_state_probe" -> "subsystem:context" [label="belongs_to"];
|
||||
"component:create_release" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:curator" -> "subsystem:memory" [label="belongs_to"];
|
||||
"component:deploy_promotion" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:deploy_qualify" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:deploy_stage" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:drift_ledger" -> "subsystem:identity" [label="belongs_to"];
|
||||
"component:drift_observability" -> "subsystem:identity" [label="belongs_to"];
|
||||
"component:drift_resume" -> "subsystem:event-resilience" [label="belongs_to"];
|
||||
"component:event_store" -> "subsystem:orchestration" [label="belongs_to"];
|
||||
"component:failure_recovery" -> "subsystem:event-resilience" [label="belongs_to"];
|
||||
"component:gitea_auth" -> "subsystem:ci-verification" [label="belongs_to"];
|
||||
"component:graph_memory" -> "subsystem:memory" [label="belongs_to"];
|
||||
"component:growth_simulator" -> "subsystem:growth" [label="belongs_to"];
|
||||
"component:identity_anchors" -> "subsystem:identity" [label="belongs_to"];
|
||||
"component:iteration" -> "subsystem:registry" [label="belongs_to"];
|
||||
"component:local_tool_runtime" -> "subsystem:tool-runtime" [label="belongs_to"];
|
||||
"component:memory_env" -> "subsystem:memory" [label="belongs_to"];
|
||||
"component:memory_selector" -> "subsystem:memory" [label="belongs_to"];
|
||||
"component:memory_store" -> "subsystem:memory" [label="belongs_to"];
|
||||
"component:microkernel" -> "subsystem:operator" [label="belongs_to"];
|
||||
"component:model_connect" -> "subsystem:transports" [label="belongs_to"];
|
||||
"component:model_registry" -> "subsystem:transports" [label="belongs_to"];
|
||||
"component:model_routing" -> "subsystem:routing" [label="belongs_to"];
|
||||
"component:night_mode" -> "subsystem:growth" [label="belongs_to"];
|
||||
"component:openai_compat_transport" -> "subsystem:transports" [label="belongs_to"];
|
||||
"component:persona" -> "subsystem:identity" [label="belongs_to"];
|
||||
"component:project_registry" -> "subsystem:registry" [label="belongs_to"];
|
||||
"component:provider_registry" -> "subsystem:transports" [label="belongs_to"];
|
||||
"component:query_memory" -> "subsystem:growth" [label="belongs_to"];
|
||||
"component:recall_router" -> "subsystem:recall" [label="belongs_to"];
|
||||
"component:recall_uplift" -> "subsystem:recall" [label="belongs_to"];
|
||||
"component:records" -> "subsystem:orchestration" [label="belongs_to"];
|
||||
"component:route_risk_flags" -> "subsystem:routing" [label="belongs_to"];
|
||||
"component:rune_operator" -> "subsystem:operator" [label="belongs_to"];
|
||||
"component:rune_tui" -> "subsystem:tui" [label="belongs_to"];
|
||||
"component:semver_bump" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:standardized_providers" -> "subsystem:transports" [label="belongs_to"];
|
||||
"component:subconscious_pass" -> "subsystem:growth" [label="belongs_to"];
|
||||
"component:subsystem_health" -> "subsystem:health" [label="belongs_to"];
|
||||
"component:task_gate" -> "subsystem:operator" [label="belongs_to"];
|
||||
"component:task_persist" -> "subsystem:operator" [label="belongs_to"];
|
||||
"component:testing_mode" -> "subsystem:registry" [label="belongs_to"];
|
||||
"component:tool_executor" -> "subsystem:tool-runtime" [label="belongs_to"];
|
||||
"component:tool_protocol" -> "subsystem:tool-runtime" [label="belongs_to"];
|
||||
"component:tui_backlog" -> "subsystem:tui" [label="belongs_to"];
|
||||
"component:version_convergence" -> "subsystem:deploy" [label="belongs_to"];
|
||||
"component:voice_synthesis" -> "subsystem:identity" [label="belongs_to"];
|
||||
"component:warm_neuron_store" -> "subsystem:memory" [label="belongs_to"];
|
||||
"component:warm_router" -> "subsystem:recall" [label="belongs_to"];
|
||||
"component:work_manager" -> "subsystem:work-dispatch" [label="belongs_to"];
|
||||
"deployment_surface:rune-code-current" -> "environment:production" [label="connects_to"];
|
||||
"deployment_surface:rune-code-current" -> "project:rune" [label="belongs_to"];
|
||||
"domain:client-presentation" -> "project:rune" [label="belongs_to"];
|
||||
"domain:construction-governance" -> "project:rune" [label="belongs_to"];
|
||||
"domain:execution-runtime" -> "project:rune" [label="belongs_to"];
|
||||
"domain:inference-providers" -> "project:rune" [label="belongs_to"];
|
||||
"domain:memory-identity" -> "project:rune" [label="belongs_to"];
|
||||
"domain:orchestration-execution" -> "project:rune" [label="belongs_to"];
|
||||
"domain:perception-context" -> "project:rune" [label="belongs_to"];
|
||||
"domain:release-delivery" -> "project:rune" [label="belongs_to"];
|
||||
"domain:state-resilience" -> "project:rune" [label="belongs_to"];
|
||||
"domain:validation" -> "project:rune" [label="belongs_to"];
|
||||
"domain:validation-health" -> "project:rune" [label="belongs_to"];
|
||||
"environment:production" -> "project:rune" [label="belongs_to"];
|
||||
"interface:operator-api" -> "subsystem:tui" [label="belongs_to"];
|
||||
"state_store:scaffold-store" -> "project:rune" [label="belongs_to"];
|
||||
"state_store:spine-store" -> "project:rune" [label="belongs_to"];
|
||||
"state_store:wr-bridge" -> "project:rune" [label="belongs_to"];
|
||||
"subsystem:canaries" -> "domain:validation-health" [label="belongs_to"];
|
||||
"subsystem:ci-verification" -> "domain:release-delivery" [label="belongs_to"];
|
||||
"subsystem:context" -> "domain:perception-context" [label="belongs_to"];
|
||||
"subsystem:deploy" -> "domain:release-delivery" [label="belongs_to"];
|
||||
"subsystem:event-resilience" -> "domain:state-resilience" [label="belongs_to"];
|
||||
"subsystem:growth" -> "domain:memory-identity" [label="belongs_to"];
|
||||
"subsystem:health" -> "domain:validation-health" [label="belongs_to"];
|
||||
"subsystem:identity" -> "domain:memory-identity" [label="belongs_to"];
|
||||
"subsystem:memory" -> "domain:memory-identity" [label="belongs_to"];
|
||||
"subsystem:operator" -> "domain:orchestration-execution" [label="belongs_to"];
|
||||
"subsystem:orchestration" -> "domain:orchestration-execution" [label="belongs_to"];
|
||||
"subsystem:recall" -> "domain:perception-context" [label="belongs_to"];
|
||||
"subsystem:registry" -> "domain:state-resilience" [label="belongs_to"];
|
||||
"subsystem:routing" -> "domain:inference-providers" [label="belongs_to"];
|
||||
"subsystem:task-state" -> "domain:state-resilience" [label="belongs_to"];
|
||||
"subsystem:tool-runtime" -> "domain:orchestration-execution" [label="belongs_to"];
|
||||
"subsystem:transports" -> "domain:inference-providers" [label="belongs_to"];
|
||||
"subsystem:tui" -> "domain:client-presentation" [label="belongs_to"];
|
||||
"subsystem:work-dispatch" -> "domain:inference-providers" [label="belongs_to"];
|
||||
"test_suite:rune-tests" -> "project:rune" [label="belongs_to"];
|
||||
"test_suite:tui-tests" -> "project:rune" [label="belongs_to"];
|
||||
}
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,276 @@
|
||||
graph LR
|
||||
n3["auto_bump_pr (component)"]
|
||||
n15["create_release (component)"]
|
||||
n17["deploy_promotion (component)"]
|
||||
n18["deploy_qualify (component)"]
|
||||
n19["deploy_stage (component)"]
|
||||
n26["gitea_auth (component)"]
|
||||
n53["semver_bump (component)"]
|
||||
n63["version_convergence (component)"]
|
||||
n0["adaptive_router (component)"]
|
||||
n2["attention_capsule (component)"]
|
||||
n4["behaviour_ledger (component)"]
|
||||
n5["build_mode_adapter (component)"]
|
||||
n6["builder_bridge (component)"]
|
||||
n7["canary_native (component)"]
|
||||
n8["capability_ledger (component)"]
|
||||
n9["claim_audit (component)"]
|
||||
n10["construction_interface (component)"]
|
||||
n11["construction_mode (component)"]
|
||||
n12["context_broker (component)"]
|
||||
n16["curator (component)"]
|
||||
n20["drift_ledger (component)"]
|
||||
n21["drift_observability (component)"]
|
||||
n22["drift_resume (component)"]
|
||||
n24["event_wait (component)"]
|
||||
n25["failure_recovery (component)"]
|
||||
n27["graph_memory (component)"]
|
||||
n29["identity_anchors (component)"]
|
||||
n30["iteration (component)"]
|
||||
n31["local_tool_runtime (component)"]
|
||||
n32["memory_env (component)"]
|
||||
n33["memory_selector (component)"]
|
||||
n34["memory_store (component)"]
|
||||
n35["microkernel (component)"]
|
||||
n36["model_connect (component)"]
|
||||
n37["model_registry (component)"]
|
||||
n38["model_routing (component)"]
|
||||
n39["night_mode (component)"]
|
||||
n40["openai_compat_transport (component)"]
|
||||
n1["atomic (component)"]
|
||||
n13["conversation_state (component)"]
|
||||
n23["event_store (component)"]
|
||||
n48["records (component)"]
|
||||
n42["programme_continuation (component)"]
|
||||
n43["project_registry (component)"]
|
||||
n44["provider_registry (component)"]
|
||||
n45["query_memory (component)"]
|
||||
n46["recall_router (component)"]
|
||||
n47["recall_uplift (component)"]
|
||||
n49["route_risk_flags (component)"]
|
||||
n50["rune_operator (component)"]
|
||||
n51["rune_tui (component)"]
|
||||
n52["scaffold (component)"]
|
||||
n54["standardized_providers (component)"]
|
||||
n55["subconscious_pass (component)"]
|
||||
n56["subsystem_health (component)"]
|
||||
n57["task_gate (component)"]
|
||||
n58["task_persist (component)"]
|
||||
n59["testing_mode (component)"]
|
||||
n60["tool_executor (component)"]
|
||||
n61["tool_protocol (component)"]
|
||||
n62["tui_backlog (component)"]
|
||||
n65["warm_neuron_store (component)"]
|
||||
n66["warm_router (component)"]
|
||||
n67["work_manager (component)"]
|
||||
n14["conversation_state_probe (component)"]
|
||||
n28["growth_simulator (component)"]
|
||||
n41["persona (component)"]
|
||||
n64["voice_synthesis (component)"]
|
||||
n68["rune-code-current (deployment_surface)"]
|
||||
n69["client-presentation (domain)"]
|
||||
n70["construction-governance (domain)"]
|
||||
n71["execution-runtime (domain)"]
|
||||
n72["inference-providers (domain)"]
|
||||
n73["memory-identity (domain)"]
|
||||
n74["orchestration-execution (domain)"]
|
||||
n75["perception-context (domain)"]
|
||||
n76["release-delivery (domain)"]
|
||||
n77["state-resilience (domain)"]
|
||||
n78["validation (domain)"]
|
||||
n79["validation-health (domain)"]
|
||||
n80["production (environment)"]
|
||||
n81["operator-api (interface)"]
|
||||
n83["scaffold-store (state_store)"]
|
||||
n84["spine-store (state_store)"]
|
||||
n85["wr-bridge (state_store)"]
|
||||
n86["canaries (subsystem)"]
|
||||
n87["ci-verification (subsystem)"]
|
||||
n88["context (subsystem)"]
|
||||
n89["deploy (subsystem)"]
|
||||
n90["event-resilience (subsystem)"]
|
||||
n91["growth (subsystem)"]
|
||||
n92["health (subsystem)"]
|
||||
n93["identity (subsystem)"]
|
||||
n94["memory (subsystem)"]
|
||||
n95["operator (subsystem)"]
|
||||
n96["orchestration (subsystem)"]
|
||||
n97["recall (subsystem)"]
|
||||
n98["registry (subsystem)"]
|
||||
n99["routing (subsystem)"]
|
||||
n100["task-state (subsystem)"]
|
||||
n101["tool-runtime (subsystem)"]
|
||||
n102["transports (subsystem)"]
|
||||
n103["tui (subsystem)"]
|
||||
n104["work-dispatch (subsystem)"]
|
||||
n105["rune-tests (test_suite)"]
|
||||
n106["tui-tests (test_suite)"]
|
||||
n82["rune (project)"]
|
||||
n5 -->|legacy_of| n52
|
||||
n24 -->|owns| n85
|
||||
n52 -->|owns| n83
|
||||
n24 -->|connects_to| n42
|
||||
n51 -->|verified_by| n106
|
||||
n42 -->|depends_on| n10
|
||||
n42 -->|depends_on| n24
|
||||
n50 -->|depends_on| n0
|
||||
n50 -->|depends_on| n11
|
||||
n52 -->|depends_on| n11
|
||||
n51 -->|depends_on| n50
|
||||
n0 -->|verified_by| n105
|
||||
n1 -->|verified_by| n105
|
||||
n2 -->|verified_by| n105
|
||||
n3 -->|verified_by| n105
|
||||
n4 -->|verified_by| n105
|
||||
n6 -->|verified_by| n105
|
||||
n7 -->|verified_by| n105
|
||||
n8 -->|verified_by| n105
|
||||
n9 -->|verified_by| n105
|
||||
n12 -->|verified_by| n105
|
||||
n13 -->|verified_by| n105
|
||||
n15 -->|verified_by| n105
|
||||
n16 -->|verified_by| n105
|
||||
n17 -->|verified_by| n105
|
||||
n18 -->|verified_by| n105
|
||||
n19 -->|verified_by| n105
|
||||
n20 -->|verified_by| n105
|
||||
n21 -->|verified_by| n105
|
||||
n22 -->|verified_by| n105
|
||||
n23 -->|verified_by| n105
|
||||
n25 -->|verified_by| n105
|
||||
n26 -->|verified_by| n105
|
||||
n27 -->|verified_by| n105
|
||||
n29 -->|verified_by| n105
|
||||
n30 -->|verified_by| n105
|
||||
n31 -->|verified_by| n105
|
||||
n32 -->|verified_by| n105
|
||||
n33 -->|verified_by| n105
|
||||
n34 -->|verified_by| n105
|
||||
n35 -->|verified_by| n105
|
||||
n36 -->|verified_by| n105
|
||||
n37 -->|verified_by| n105
|
||||
n38 -->|verified_by| n105
|
||||
n39 -->|verified_by| n105
|
||||
n40 -->|verified_by| n105
|
||||
n43 -->|verified_by| n105
|
||||
n44 -->|verified_by| n105
|
||||
n45 -->|verified_by| n105
|
||||
n46 -->|verified_by| n105
|
||||
n47 -->|verified_by| n105
|
||||
n48 -->|verified_by| n105
|
||||
n49 -->|verified_by| n105
|
||||
n50 -->|verified_by| n105
|
||||
n53 -->|verified_by| n105
|
||||
n54 -->|verified_by| n105
|
||||
n55 -->|verified_by| n105
|
||||
n56 -->|verified_by| n105
|
||||
n57 -->|verified_by| n105
|
||||
n58 -->|verified_by| n105
|
||||
n59 -->|verified_by| n105
|
||||
n60 -->|verified_by| n105
|
||||
n61 -->|verified_by| n105
|
||||
n63 -->|verified_by| n105
|
||||
n65 -->|verified_by| n105
|
||||
n66 -->|verified_by| n105
|
||||
n67 -->|verified_by| n105
|
||||
n0 -->|belongs_to| n99
|
||||
n1 -->|belongs_to| n96
|
||||
n2 -->|belongs_to| n88
|
||||
n3 -->|belongs_to| n89
|
||||
n4 -->|belongs_to| n98
|
||||
n6 -->|belongs_to| n104
|
||||
n7 -->|belongs_to| n86
|
||||
n8 -->|belongs_to| n98
|
||||
n9 -->|belongs_to| n91
|
||||
n12 -->|belongs_to| n88
|
||||
n13 -->|belongs_to| n96
|
||||
n14 -->|belongs_to| n88
|
||||
n15 -->|belongs_to| n89
|
||||
n16 -->|belongs_to| n94
|
||||
n17 -->|belongs_to| n89
|
||||
n18 -->|belongs_to| n89
|
||||
n19 -->|belongs_to| n89
|
||||
n20 -->|belongs_to| n93
|
||||
n21 -->|belongs_to| n93
|
||||
n22 -->|belongs_to| n90
|
||||
n23 -->|belongs_to| n96
|
||||
n25 -->|belongs_to| n90
|
||||
n26 -->|belongs_to| n87
|
||||
n27 -->|belongs_to| n94
|
||||
n28 -->|belongs_to| n91
|
||||
n29 -->|belongs_to| n93
|
||||
n30 -->|belongs_to| n98
|
||||
n31 -->|belongs_to| n101
|
||||
n32 -->|belongs_to| n94
|
||||
n33 -->|belongs_to| n94
|
||||
n34 -->|belongs_to| n94
|
||||
n35 -->|belongs_to| n95
|
||||
n36 -->|belongs_to| n102
|
||||
n37 -->|belongs_to| n102
|
||||
n38 -->|belongs_to| n99
|
||||
n39 -->|belongs_to| n91
|
||||
n40 -->|belongs_to| n102
|
||||
n41 -->|belongs_to| n93
|
||||
n43 -->|belongs_to| n98
|
||||
n44 -->|belongs_to| n102
|
||||
n45 -->|belongs_to| n91
|
||||
n46 -->|belongs_to| n97
|
||||
n47 -->|belongs_to| n97
|
||||
n48 -->|belongs_to| n96
|
||||
n49 -->|belongs_to| n99
|
||||
n50 -->|belongs_to| n95
|
||||
n51 -->|belongs_to| n103
|
||||
n53 -->|belongs_to| n89
|
||||
n54 -->|belongs_to| n102
|
||||
n55 -->|belongs_to| n91
|
||||
n56 -->|belongs_to| n92
|
||||
n57 -->|belongs_to| n95
|
||||
n58 -->|belongs_to| n95
|
||||
n59 -->|belongs_to| n98
|
||||
n60 -->|belongs_to| n101
|
||||
n61 -->|belongs_to| n101
|
||||
n62 -->|belongs_to| n103
|
||||
n63 -->|belongs_to| n89
|
||||
n64 -->|belongs_to| n93
|
||||
n65 -->|belongs_to| n94
|
||||
n66 -->|belongs_to| n97
|
||||
n67 -->|belongs_to| n104
|
||||
n68 -->|connects_to| n80
|
||||
n68 -->|belongs_to| n82
|
||||
n69 -->|belongs_to| n82
|
||||
n70 -->|belongs_to| n82
|
||||
n71 -->|belongs_to| n82
|
||||
n72 -->|belongs_to| n82
|
||||
n73 -->|belongs_to| n82
|
||||
n74 -->|belongs_to| n82
|
||||
n75 -->|belongs_to| n82
|
||||
n76 -->|belongs_to| n82
|
||||
n77 -->|belongs_to| n82
|
||||
n78 -->|belongs_to| n82
|
||||
n79 -->|belongs_to| n82
|
||||
n80 -->|belongs_to| n82
|
||||
n81 -->|belongs_to| n103
|
||||
n83 -->|belongs_to| n82
|
||||
n84 -->|belongs_to| n82
|
||||
n85 -->|belongs_to| n82
|
||||
n86 -->|belongs_to| n79
|
||||
n87 -->|belongs_to| n76
|
||||
n88 -->|belongs_to| n75
|
||||
n89 -->|belongs_to| n76
|
||||
n90 -->|belongs_to| n77
|
||||
n91 -->|belongs_to| n73
|
||||
n92 -->|belongs_to| n79
|
||||
n93 -->|belongs_to| n73
|
||||
n94 -->|belongs_to| n73
|
||||
n95 -->|belongs_to| n74
|
||||
n96 -->|belongs_to| n74
|
||||
n97 -->|belongs_to| n75
|
||||
n98 -->|belongs_to| n77
|
||||
n99 -->|belongs_to| n72
|
||||
n100 -->|belongs_to| n77
|
||||
n101 -->|belongs_to| n74
|
||||
n102 -->|belongs_to| n72
|
||||
n103 -->|belongs_to| n69
|
||||
n104 -->|belongs_to| n72
|
||||
n105 -->|belongs_to| n82
|
||||
n106 -->|belongs_to| n82
|
||||
@@ -0,0 +1,21 @@
|
||||
# 21B-1 — Rune sleep/poll audit (2026-09-16)
|
||||
|
||||
| Site | Classification | Rationale |
|
||||
|---|---|---|
|
||||
| ci_event_wait.py:82 `time.sleep(gap_secs)` | RETRY_BACKOFF | bounded authority_after_wake ack-window re-read (4s×3) |
|
||||
| auto_bump_pr.py:169/235 | POLLING (legacy path) | bump-PR CI wait — auto_bump PRs retired (direct bumps since 2026-09-08) |
|
||||
| merge_robot.py:120/217 | RETRY_BACKOFF | bounded retry on merge API attempts |
|
||||
| notify_event_bridge.py:51 | RETRY_BACKOFF | single 2s retry before best-effort declaration |
|
||||
| research_event_relay.py:152 | EVENT_FALLBACK_WITH_REASON | local file-read poll (not Gitea) |
|
||||
| t14/t15_builder_session.py | WATCHDOG-adjacent | notifier stderr drain interval |
|
||||
| event_wait.py:93 | EVENT_FALLBACK | notifier POST retry (3× best-effort) |
|
||||
| auto-update-gitea.yml:45 | SCHEDULED_TIMER | gitea binary update ordering |
|
||||
|
||||
**T20's own sleeps (`sleep 540/480/600`) were in the AGENT SESSION, not
|
||||
Rune code** — the model invented sleep→poll continuation instead of
|
||||
using ci_event_wait.py. That is a CONTROLLER-level defect: the MiMo
|
||||
Code execution machinery accepted `sleep N; check` when a supported
|
||||
event source existed.
|
||||
|
||||
MiMo Code controller located: /home/nick/.local/share/npm/lib/node_modules/@mimo-ai/cli
|
||||
(runs as same package for both nick and gitea-desktop-runner).
|
||||
@@ -0,0 +1,31 @@
|
||||
# 21B — MiMo Code controller sleep/poll audit + guard (2026-09-16)
|
||||
|
||||
## Controller identity (verified, not assumed)
|
||||
- Package: @mimo-ai/cli (npm), launcher at
|
||||
/home/nick/.local/share/npm/lib/node_modules/@mimo-ai/cli/bin/mimo
|
||||
- Runtime: compiled native binary (ELF x86-64, Bun-compiled, not stripped)
|
||||
at .../@mimo-ai/mimocode-linux-x64/bin/mimo — NOT source-patchable.
|
||||
- Extension surface: ~/.mimocode/hooks/*.ts via @mimo-ai/plugin Hooks API
|
||||
(tool.execute.before with cancel). Hot-reloads per turn.
|
||||
Precedent: no-blocking-wait.ts (2026-09-07), production-proven.
|
||||
|
||||
## Controller sleep/poll audit
|
||||
- The controller binary has no extension-surface polling loops. The T20
|
||||
regression (`sleep 540; <CI status probe>`) was MODEL-GENERATED Bash
|
||||
passed through the controller's shell execution — the correct
|
||||
interception point is tool.execute.before. Guard = event-wait-guard.ts.
|
||||
|
||||
## LIVE PROOF (LIVE_PROVEN_THIS_SESSION)
|
||||
- v1 guard written mid-session; hot-reloaded IMMEDIATELY (same turn):
|
||||
it intercepted the very next Bash tool call — the guard's own evidence
|
||||
file write — because the heredoc contained the literal text "sleep 540".
|
||||
- False positive acknowledged and fixed in v2: pattern detection now
|
||||
requires sleep + status-poll in the SAME command segment, with heredoc
|
||||
bodies stripped before scanning.
|
||||
- The interception itself is the live proof: the harness accepted the
|
||||
hook, matched the pattern, cancelled the tool call, and delivered the
|
||||
redirect message — without any controller restart.
|
||||
|
||||
## Rune-side classification (21B-1)
|
||||
See 21B1_rune_sleep_audit.md — no UNJUSTIFIED_SLEEP in active paths;
|
||||
auto_bump_pr.py polling loops classified legacy (21G candidate).
|
||||
@@ -0,0 +1,382 @@
|
||||
{
|
||||
"behaviours": {
|
||||
"behaviour:VAL-RUNE-001": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-001",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:rune_tui",
|
||||
"component:construction_mode"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "no contract or silent bypass",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-16T01:31:56Z",
|
||||
"detail": "was AUTO_VERIFIED; 20R case-1: construction_mode structurally changed in retrofit",
|
||||
"from": "AUTO_VERIFIED",
|
||||
"generation": "t20-retrofit",
|
||||
"kind": "selective_invalidation",
|
||||
"to": "RETEST_REQUIRED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "construction request becomes governed Contract",
|
||||
"invalidations": [
|
||||
{
|
||||
"at": "2026-09-16T01:31:56Z",
|
||||
"because": "20R case-1: construction_mode structurally changed in retrofit",
|
||||
"changed_entities": [
|
||||
"component:construction_mode"
|
||||
],
|
||||
"generation": "t20-retrofit",
|
||||
"was": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:rune_tui",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "contract exists in canonical store with building phase",
|
||||
"procedure": "send '/build start <real task>'; expect contract minted + building",
|
||||
"state": "RETEST_REQUIRED",
|
||||
"updated_at": "2026-09-16T01:31:56Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-002": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-002",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:programme_continuation"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "voluntary stop with work remaining",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "programme continuation resumes without user intervention",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:programme_continuation",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "PROGRAMME_COMPLETE without user continue",
|
||||
"procedure": "run 4-stage programme; next stage auto-selected after each completion",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-003": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-003",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:event_wait"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.66.77",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "deadline_pending on every cycle",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.66.77",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "event wait resumes from event rather than timeout",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:event_wait",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "mode=event or event_replayed",
|
||||
"procedure": "deploy cycle with live CI; waiter resumes on wake",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-004": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-004",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:rune_operator"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "silent provider switch",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "provider failure preserves truthful state, no fallback",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:rune_operator",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "single attempt, real code preserved",
|
||||
"procedure": "401/429 from provider; expect PROVIDER_UNAVAILABLE, one attempt",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-005": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-005",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:deploy_pipeline"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.66.77",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "promotion of red SHA",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.66.77",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "release never promotes red SHA",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:deploy_pipeline",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "deployment refused truthfully",
|
||||
"procedure": "red CI SHA; deploy must refuse",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-006": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-006",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:rune_operator"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.67.0",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "operator.json cache diverges",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.67.0",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "task-state authority remains canonical",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:rune_operator",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "get_status matches repo counts",
|
||||
"procedure": "counters derive from TaskStateRepository",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-007": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-007",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:rune_tui"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [],
|
||||
"fail_criteria": "stale/wrong provider display",
|
||||
"history": [],
|
||||
"intended_behaviour": "TUI reports correct active model/provider",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:rune_tui",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "footer matches selection",
|
||||
"procedure": "manual: switch provider, check footer",
|
||||
"state": "UNVALIDATED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-008": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-008",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:rune_tui",
|
||||
"module:testing_mode"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.67.0",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "crash or wrong counts",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.67.0",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "/testing reports outstanding validations",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:rune_tui",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "counts match ledger outstanding()",
|
||||
"procedure": "run /testing with registered projects; expect counts",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-009": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-009",
|
||||
"created_at": "2026-09-16T01:26:52Z",
|
||||
"dependencies": [
|
||||
"component:rune_operator"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated",
|
||||
"passed": true
|
||||
}
|
||||
],
|
||||
"fail_criteria": "requires transcript",
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:26:52Z",
|
||||
"detail": "T18/T19 live evidence",
|
||||
"from": "UNVALIDATED",
|
||||
"generation": "gen-0.66.80",
|
||||
"kind": "automated_verification",
|
||||
"to": "AUTO_VERIFIED"
|
||||
}
|
||||
],
|
||||
"intended_behaviour": "state survives expected restart/resume path",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:rune_operator",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "resume from contract id alone",
|
||||
"procedure": "restart mid-programme; resume from durable record",
|
||||
"state": "AUTO_VERIFIED",
|
||||
"updated_at": "2026-09-16T01:26:52Z"
|
||||
},
|
||||
"behaviour:VAL-RUNE-010": {
|
||||
"automated_ref": "",
|
||||
"behaviour_id": "behaviour:VAL-RUNE-010",
|
||||
"created_at": "2026-09-16T01:33:59Z",
|
||||
"dependencies": [
|
||||
"component:deploy_pipeline"
|
||||
],
|
||||
"environment": "",
|
||||
"evidence": [],
|
||||
"fail_criteria": "any skew requiring baseline chase",
|
||||
"history": [],
|
||||
"intended_behaviour": "same pinned inputs produce deterministic validation locally and in CI",
|
||||
"invalidations": [],
|
||||
"limitations": [],
|
||||
"origin_intent": "",
|
||||
"owner_component": "component:deploy_pipeline",
|
||||
"owning_project": "rune",
|
||||
"pass_criteria": "identical error/warning arithmetic",
|
||||
"procedure": "build venv from committed lock; run ratchet; compare with CI job",
|
||||
"state": "UNVALIDATED",
|
||||
"updated_at": "2026-09-16T01:33:59Z"
|
||||
}
|
||||
},
|
||||
"schema_version": 1,
|
||||
"updated_at": "2026-09-16T01:33:59Z"
|
||||
}
|
||||
@@ -0,0 +1,138 @@
|
||||
{
|
||||
"capabilities": {
|
||||
"capability:deploy-promote": {
|
||||
"behaviour_specs": [
|
||||
"behaviour:deploy-refuses-red"
|
||||
],
|
||||
"capability_id": "capability:deploy-promote",
|
||||
"component": "component:deploy_pipeline",
|
||||
"constraints": "",
|
||||
"consumers": [],
|
||||
"contract": "qualify \u2192 stage \u2192 verify \u2192 promote/noop/stale",
|
||||
"created_at": "2026-09-16T01:26:33Z",
|
||||
"dependencies": [],
|
||||
"generation": "",
|
||||
"invariants": [
|
||||
"never promote red SHA; stale superseded truthfully"
|
||||
],
|
||||
"limitations": [],
|
||||
"maturity": "implemented",
|
||||
"name": "Monotonic deploy promotion",
|
||||
"owning_project": "rune",
|
||||
"purpose": "stage\u2192verify\u2192promote with flock check-and-swap, fail-closed",
|
||||
"source_locations": [
|
||||
"scripts/deploy_stage.py",
|
||||
"scripts/deploy_promotion.py"
|
||||
],
|
||||
"state_touched": "deploy root + current/last-good symlinks",
|
||||
"updated_at": "2026-09-16T01:26:33Z"
|
||||
},
|
||||
"capability:event-wait-resume": {
|
||||
"behaviour_specs": [
|
||||
"behaviour:event-wake-midwait"
|
||||
],
|
||||
"capability_id": "capability:event-wait-resume",
|
||||
"component": "component:event_wait",
|
||||
"constraints": "",
|
||||
"consumers": [
|
||||
"component:programme_continuation"
|
||||
],
|
||||
"contract": "register \u2192 select() on FIFO \u2192 event \u2192 authority re-read",
|
||||
"created_at": "2026-09-16T01:26:33Z",
|
||||
"dependencies": [
|
||||
"component:wait-daemon"
|
||||
],
|
||||
"generation": "",
|
||||
"invariants": [
|
||||
"event is wake, never truth"
|
||||
],
|
||||
"limitations": [],
|
||||
"maturity": "implemented",
|
||||
"name": "Event-driven wait/resume",
|
||||
"owning_project": "rune",
|
||||
"purpose": "EVENT drives continuation; watchdog detects failure",
|
||||
"source_locations": [
|
||||
"src/rune/event_wait.py"
|
||||
],
|
||||
"state_touched": "W/R bridge waits (shared root)",
|
||||
"updated_at": "2026-09-16T01:26:33Z"
|
||||
},
|
||||
"capability:operator-send-task": {
|
||||
"behaviour_specs": [
|
||||
"behaviour:send-task-governed"
|
||||
],
|
||||
"capability_id": "capability:operator-send-task",
|
||||
"component": "component:rune_operator",
|
||||
"constraints": "provider context inherited, never selected",
|
||||
"consumers": [
|
||||
"component:rune_tui"
|
||||
],
|
||||
"contract": "description+model+channel \u2192 task record + execution",
|
||||
"created_at": "2026-09-16T01:26:33Z",
|
||||
"dependencies": [
|
||||
"component:adaptive_router",
|
||||
"component:construction_mode"
|
||||
],
|
||||
"generation": "t20",
|
||||
"invariants": [
|
||||
"route decided before execution"
|
||||
],
|
||||
"limitations": [],
|
||||
"maturity": "implemented",
|
||||
"name": "Operator send_task",
|
||||
"owning_project": "rune",
|
||||
"purpose": "routes a user task through classification, construction activation, and execution",
|
||||
"risk_notes": [
|
||||
{
|
||||
"at": "t20-benchmark",
|
||||
"note": "write-ordering window: ~10 sites mutate RuneTask.status + _save() BEFORE _task_state.transition(); crash between = legacy cache ahead of canonical truth; _task_counters falls back to cache on empty repo (rune_operator.py:906-1605, 755-779)"
|
||||
}
|
||||
],
|
||||
"source_locations": [
|
||||
"src/rune/rune_operator.py"
|
||||
],
|
||||
"state_touched": "TaskStateRepository (canonical), operator.json (legacy cache)",
|
||||
"updated_at": "2026-09-16T01:55:10Z"
|
||||
},
|
||||
"capability:tui-testing-command": {
|
||||
"behaviour_specs": [
|
||||
"behaviour:testing-aggregate"
|
||||
],
|
||||
"capability_id": "capability:tui-testing-command",
|
||||
"component": "component:rune_tui",
|
||||
"constraints": "",
|
||||
"consumers": [],
|
||||
"contract": "/testing \u2192 aggregate; /testing <project> \u2192 filtered",
|
||||
"created_at": "2026-09-16T01:26:33Z",
|
||||
"dependencies": [
|
||||
"module:testing_mode"
|
||||
],
|
||||
"generation": "",
|
||||
"invariants": [
|
||||
"testing_mode backend is authority; TUI renders"
|
||||
],
|
||||
"limitations": [],
|
||||
"maturity": "implemented",
|
||||
"name": "TUI /testing command",
|
||||
"owning_project": "rune",
|
||||
"purpose": "aggregates outstanding validations across registered projects",
|
||||
"source_locations": [
|
||||
"src/rune/rune_tui.py"
|
||||
],
|
||||
"state_touched": "",
|
||||
"updated_at": "2026-09-16T01:26:33Z"
|
||||
}
|
||||
},
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T01:55:10Z",
|
||||
"capability_id": "capability:operator-send-task",
|
||||
"event": "material_change",
|
||||
"generation": "t20",
|
||||
"note": "risk_notes added from 20Q cold-benchmark finding",
|
||||
"prior_maturity": "implemented"
|
||||
}
|
||||
],
|
||||
"schema_version": 1,
|
||||
"updated_at": "2026-09-16T01:55:10Z"
|
||||
}
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,42 @@
|
||||
{
|
||||
"capabilities": {
|
||||
"capability:tui-testing-command": {
|
||||
"behaviour_specs": [
|
||||
"behaviour:19l-testing-aggregate"
|
||||
],
|
||||
"capability_id": "capability:tui-testing-command",
|
||||
"component": "component:rune_tui",
|
||||
"constraints": "",
|
||||
"consumers": [],
|
||||
"contract": "/testing \u2192 aggregate; /testing <project> \u2192 filtered; items show behaviour/procedure/criteria/state",
|
||||
"created_at": "2026-09-16T00:11:56Z",
|
||||
"dependencies": [],
|
||||
"generation": "t19-selfhost",
|
||||
"invariants": [
|
||||
"testing_mode backend is authority; TUI renders"
|
||||
],
|
||||
"limitations": [],
|
||||
"maturity": "implemented",
|
||||
"name": "TUI /testing command",
|
||||
"owning_project": "scaffolding",
|
||||
"purpose": "aggregate outstanding validations across registered scaffolded projects; minimal command surface",
|
||||
"source_locations": [
|
||||
"src/rune/rune_tui.py"
|
||||
],
|
||||
"state_touched": "",
|
||||
"updated_at": "2026-09-16T00:13:06Z"
|
||||
}
|
||||
},
|
||||
"history": [
|
||||
{
|
||||
"at": "2026-09-16T00:13:06Z",
|
||||
"capability_id": "capability:tui-testing-command",
|
||||
"event": "material_change",
|
||||
"generation": "t19-selfhost",
|
||||
"note": "implemented /testing command",
|
||||
"prior_maturity": "implemented"
|
||||
}
|
||||
],
|
||||
"schema_version": 1,
|
||||
"updated_at": "2026-09-16T00:13:06Z"
|
||||
}
|
||||
+457
-84
@@ -1,71 +1,5 @@
|
||||
{
|
||||
"entities": [
|
||||
{
|
||||
"checkpoints": [],
|
||||
"evidence_refs": [
|
||||
"contract-created:17e-stage-3-fails"
|
||||
],
|
||||
"id": "contract:17e-stage-3-fails",
|
||||
"identities": {
|
||||
"acceptance": [],
|
||||
"affected_entities": [],
|
||||
"expected_consumers": [],
|
||||
"expected_new_entities": [],
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "deliberately failing stage",
|
||||
"next_action": "review for approval",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
"requirement": "",
|
||||
"research_refs": [],
|
||||
"resolution": "",
|
||||
"rollback_ref": "",
|
||||
"scope": [],
|
||||
"toolchain": {},
|
||||
"verification_obligations": []
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:50:29Z",
|
||||
"phase": "draft",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"checkpoints": [],
|
||||
"evidence_refs": [
|
||||
"contract-created:17e-stage-4-final"
|
||||
],
|
||||
"id": "contract:17e-stage-4-final",
|
||||
"identities": {
|
||||
"acceptance": [],
|
||||
"affected_entities": [],
|
||||
"expected_consumers": [],
|
||||
"expected_new_entities": [],
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "final stage",
|
||||
"next_action": "review for approval",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
"requirement": "",
|
||||
"research_refs": [],
|
||||
"resolution": "",
|
||||
"rollback_ref": "",
|
||||
"scope": [],
|
||||
"toolchain": {},
|
||||
"verification_obligations": []
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:50:29Z",
|
||||
"phase": "draft",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"checkpoints": [
|
||||
{
|
||||
@@ -34926,6 +34860,17 @@
|
||||
"evidence": "programme-stage-start",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
@@ -34940,7 +34885,7 @@
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "governance-only stage",
|
||||
"next_action": "begin building",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
@@ -34954,8 +34899,8 @@
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:50:29Z",
|
||||
"phase": "approved",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
@@ -34966,6 +34911,17 @@
|
||||
"evidence": "programme-stage-start",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
@@ -34980,7 +34936,7 @@
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "async work under event bridge",
|
||||
"next_action": "begin building",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
@@ -34994,8 +34950,8 @@
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:50:29Z",
|
||||
"phase": "approved",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
@@ -35006,6 +34962,17 @@
|
||||
"evidence": "programme-stage-start",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
@@ -35020,7 +34987,7 @@
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "governance-only stage",
|
||||
"next_action": "begin building",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
@@ -35034,8 +35001,8 @@
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:51:19Z",
|
||||
"phase": "approved",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
@@ -35046,6 +35013,17 @@
|
||||
"evidence": "programme-stage-start",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
@@ -35060,7 +35038,7 @@
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "async work under event bridge",
|
||||
"next_action": "begin building",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
@@ -35074,8 +35052,8 @@
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:51:19Z",
|
||||
"phase": "approved",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
@@ -35086,6 +35064,17 @@
|
||||
"evidence": "programme-stage-start",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
@@ -35100,7 +35089,7 @@
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "deliberately failing stage",
|
||||
"next_action": "begin building",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
@@ -35114,8 +35103,8 @@
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:51:22Z",
|
||||
"phase": "approved",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
@@ -35126,6 +35115,17 @@
|
||||
"evidence": "programme-stage-start",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
@@ -35140,7 +35140,7 @@
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "final stage",
|
||||
"next_action": "begin building",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
@@ -35154,8 +35154,8 @@
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T17:51:22Z",
|
||||
"phase": "approved",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
@@ -35732,6 +35732,315 @@
|
||||
"status": "closed",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"checkpoints": [
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
"contract-created:17e-stage-3-fails"
|
||||
],
|
||||
"id": "contract:17e-stage-3-fails",
|
||||
"identities": {
|
||||
"acceptance": [],
|
||||
"affected_entities": [],
|
||||
"expected_consumers": [],
|
||||
"expected_new_entities": [],
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "deliberately failing stage",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
"requirement": "",
|
||||
"research_refs": [],
|
||||
"resolution": "",
|
||||
"rollback_ref": "",
|
||||
"scope": [],
|
||||
"toolchain": {},
|
||||
"verification_obligations": []
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"checkpoints": [
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "",
|
||||
"note": "",
|
||||
"phase": "abandoned"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T21:05:44Z",
|
||||
"evidence": "t18a-reconcile",
|
||||
"note": "orphan from superseded 17E proof attempts (17e3 run is the valid one); abandoned in 18A baseline reconciliation"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
"contract-created:17e-stage-4-final"
|
||||
],
|
||||
"id": "contract:17e-stage-4-final",
|
||||
"identities": {
|
||||
"acceptance": [],
|
||||
"affected_entities": [],
|
||||
"expected_consumers": [],
|
||||
"expected_new_entities": [],
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "final stage",
|
||||
"next_action": "",
|
||||
"non_goals": [],
|
||||
"origin": "programme",
|
||||
"regression_obligations": [],
|
||||
"requirement": "",
|
||||
"research_refs": [],
|
||||
"resolution": "",
|
||||
"rollback_ref": "",
|
||||
"scope": [],
|
||||
"toolchain": {},
|
||||
"verification_obligations": []
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T21:05:44Z",
|
||||
"phase": "abandoned",
|
||||
"status": "open",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"checkpoints": [
|
||||
{
|
||||
"at": "2026-09-15T22:05:42Z",
|
||||
"evidence": "workspace:construction",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T22:05:42Z",
|
||||
"evidence": "workspace:construction",
|
||||
"note": "",
|
||||
"phase": "building"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T22:06:51Z",
|
||||
"evidence": "closure-record",
|
||||
"note": "predicted-vs-observed captured",
|
||||
"phase": "closed"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T22:06:51Z",
|
||||
"evidence": "event-verified+authority-reread",
|
||||
"note": "",
|
||||
"phase": "verifying"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-15T22:06:51Z",
|
||||
"evidence": "self-scaffolded-upgrade",
|
||||
"note": "projection written (store/evidence/t18/projection/structural_graph.json); event verdict=success",
|
||||
"phase": "verifying"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
"contract-created:18q-graph-projection"
|
||||
],
|
||||
"ext": {
|
||||
"contract_quality": {
|
||||
"candidate_corrections": [],
|
||||
"captured_at": "2026-09-15T22:06:51Z",
|
||||
"contract": "18q-graph-projection",
|
||||
"correctly_predicted": [],
|
||||
"evidence_sources": [
|
||||
"18p-driver"
|
||||
],
|
||||
"expected_new_entities": [],
|
||||
"expected_new_missing": [],
|
||||
"expected_new_observed": [],
|
||||
"expected_runtime_effects": [],
|
||||
"expected_runtime_missing": [],
|
||||
"expected_runtime_observed": [],
|
||||
"genuinely_unexpected_new": [],
|
||||
"missed": [],
|
||||
"needless": [
|
||||
"module:structural_model"
|
||||
],
|
||||
"observed": [],
|
||||
"observed_existing": [],
|
||||
"observed_new": [],
|
||||
"predicted_but_unaffected": [
|
||||
"module:structural_model"
|
||||
],
|
||||
"predicted_existing_affected": [
|
||||
"module:structural_model"
|
||||
],
|
||||
"scope_check": {
|
||||
"in_scope": [
|
||||
"src/rune/graph_projection.py"
|
||||
],
|
||||
"out_of_scope": [],
|
||||
"verdict": "green"
|
||||
}
|
||||
}
|
||||
},
|
||||
"id": "contract:18q-graph-projection",
|
||||
"identities": {
|
||||
"acceptance": [
|
||||
"projection JSON validates; DOT/Mermaid render-parse"
|
||||
],
|
||||
"affected_entities": [
|
||||
"module:structural_model"
|
||||
],
|
||||
"expected_consumers": [],
|
||||
"expected_new_entities": [],
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "stable versioned read-only graph projection (JSON + DOT + Mermaid)",
|
||||
"next_action": "observe real outcome; capture lessons",
|
||||
"non_goals": [
|
||||
"no new authority; read-only over structural truth"
|
||||
],
|
||||
"origin": "self-scaffolded-upgrade",
|
||||
"regression_obligations": [],
|
||||
"requirement": "",
|
||||
"research_refs": [],
|
||||
"resolution": "",
|
||||
"rollback_ref": "",
|
||||
"scope": [
|
||||
"src/rune/graph_projection.py"
|
||||
],
|
||||
"toolchain": {},
|
||||
"verification_obligations": []
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-15T22:06:51Z",
|
||||
"phase": "closed",
|
||||
"status": "closed",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"checkpoints": [
|
||||
{
|
||||
"at": "2026-09-16T00:11:56Z",
|
||||
"evidence": "selfhost",
|
||||
"note": "",
|
||||
"phase": "approved"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-16T00:11:57Z",
|
||||
"evidence": "selfhost",
|
||||
"note": "",
|
||||
"phase": "building"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-16T00:13:06Z",
|
||||
"evidence": "closure-record",
|
||||
"note": "predicted-vs-observed captured",
|
||||
"phase": "closed"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-16T00:13:06Z",
|
||||
"evidence": "event-verified",
|
||||
"note": "",
|
||||
"phase": "verifying"
|
||||
},
|
||||
{
|
||||
"at": "2026-09-16T00:13:06Z",
|
||||
"evidence": "selfhosted-t19",
|
||||
"note": "/testing wired; event-verified"
|
||||
}
|
||||
],
|
||||
"evidence_refs": [
|
||||
"contract-created:19r-testing-command"
|
||||
],
|
||||
"ext": {
|
||||
"contract_quality": {
|
||||
"candidate_corrections": [],
|
||||
"captured_at": "2026-09-16T00:13:06Z",
|
||||
"contract": "19r-testing-command",
|
||||
"correctly_predicted": [],
|
||||
"evidence_sources": [
|
||||
"19r"
|
||||
],
|
||||
"expected_new_entities": [],
|
||||
"expected_new_missing": [],
|
||||
"expected_new_observed": [],
|
||||
"expected_runtime_effects": [],
|
||||
"expected_runtime_missing": [],
|
||||
"expected_runtime_observed": [],
|
||||
"genuinely_unexpected_new": [],
|
||||
"missed": [],
|
||||
"needless": [
|
||||
"module:testing_mode"
|
||||
],
|
||||
"observed": [],
|
||||
"observed_existing": [],
|
||||
"observed_new": [],
|
||||
"predicted_but_unaffected": [
|
||||
"module:testing_mode"
|
||||
],
|
||||
"predicted_existing_affected": [
|
||||
"module:testing_mode"
|
||||
],
|
||||
"scope_check": {
|
||||
"in_scope": [
|
||||
"src/rune/rune_tui.py"
|
||||
],
|
||||
"out_of_scope": [],
|
||||
"verdict": "green"
|
||||
}
|
||||
}
|
||||
},
|
||||
"id": "contract:19r-testing-command",
|
||||
"identities": {
|
||||
"acceptance": [
|
||||
"/testing registered in command table; calls testing_mode"
|
||||
],
|
||||
"affected_entities": [
|
||||
"module:testing_mode"
|
||||
],
|
||||
"expected_consumers": [],
|
||||
"expected_new_entities": [],
|
||||
"gap_evidence": "",
|
||||
"migration_obligations": [],
|
||||
"need": "minimal /testing command surface over testing_mode backend",
|
||||
"next_action": "observe real outcome; capture lessons",
|
||||
"non_goals": [
|
||||
"no TUI aesthetic work"
|
||||
],
|
||||
"origin": "self-scaffolded",
|
||||
"regression_obligations": [],
|
||||
"requirement": "",
|
||||
"research_refs": [],
|
||||
"resolution": "",
|
||||
"rollback_ref": "",
|
||||
"scope": [
|
||||
"src/rune/rune_tui.py"
|
||||
],
|
||||
"toolchain": {},
|
||||
"verification_obligations": []
|
||||
},
|
||||
"kind": "construction_contract",
|
||||
"maturity": "DECLARED",
|
||||
"observed_at": "2026-09-16T00:13:06Z",
|
||||
"phase": "closed",
|
||||
"status": "closed",
|
||||
"tags": []
|
||||
},
|
||||
{
|
||||
"evidence_refs": [
|
||||
"DEPLOY-MONOTONIC-001"
|
||||
@@ -49052,6 +49361,70 @@
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-15T17:52:31Z",
|
||||
"operation": "close"
|
||||
},
|
||||
{
|
||||
"builder": "t18-self-upgrade",
|
||||
"detail": "18q-graph-projection \u2192 approved",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-15T22:05:42Z",
|
||||
"operation": "transition"
|
||||
},
|
||||
{
|
||||
"builder": "t18-self-upgrade",
|
||||
"detail": "18q-graph-projection \u2192 building",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-15T22:05:42Z",
|
||||
"operation": "transition"
|
||||
},
|
||||
{
|
||||
"builder": "t18-self-upgrade",
|
||||
"detail": "18q-graph-projection \u2192 verifying",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-15T22:06:51Z",
|
||||
"operation": "transition"
|
||||
},
|
||||
{
|
||||
"builder": "t18-self-upgrade",
|
||||
"detail": "18q-graph-projection closed",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-15T22:06:51Z",
|
||||
"operation": "close"
|
||||
},
|
||||
{
|
||||
"builder": "t19-selfhost",
|
||||
"detail": "19r-testing-command \u2192 approved",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-16T00:11:56Z",
|
||||
"operation": "transition"
|
||||
},
|
||||
{
|
||||
"builder": "t19-selfhost",
|
||||
"detail": "19r-testing-command \u2192 building",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-16T00:11:57Z",
|
||||
"operation": "transition"
|
||||
},
|
||||
{
|
||||
"builder": "t19-selfhost",
|
||||
"detail": "19r-testing-command \u2192 verifying",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-16T00:13:06Z",
|
||||
"operation": "transition"
|
||||
},
|
||||
{
|
||||
"builder": "t19-selfhost",
|
||||
"detail": "19r-testing-command closed",
|
||||
"kind": "builder_session",
|
||||
"mode": "external_project",
|
||||
"observed_at": "2026-09-16T00:13:06Z",
|
||||
"operation": "close"
|
||||
}
|
||||
],
|
||||
"relationships": [
|
||||
|
||||
@@ -0,0 +1 @@
|
||||
{"generation": "t19-selfhost", "observed": ["component:rune_tui"], "predicted": ["component:rune_tui"], "recorded_at": "2026-09-16T00:13:06Z", "target": "component:rune_tui", "unaffected_as_predicted": [], "unexpected": []}
|
||||
File diff suppressed because it is too large.
Load diff
+1080
-162
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,79 @@
|
||||
"""test_build_basis.py — T18 §18C: durable research basis held-outs."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import build_basis as bb # noqa: E402
|
||||
|
||||
|
||||
def test_18c_depth_from_route_no_second_router():
|
||||
d = bb.research_depth("LOCAL_FIX")
|
||||
assert d["depth"] == "NONE" and "LOCAL_FIX" in d["why"]
|
||||
d2 = bb.research_depth("RESEARCHED_CHANGE")
|
||||
assert d2["depth"] == "FULL"
|
||||
# unknown route never silently gets NONE
|
||||
d3 = bb.research_depth("MYSTERY_ROUTE")
|
||||
assert d3["depth"] == "INWARD" and "unknown" in d3["why"]
|
||||
|
||||
|
||||
def test_18c_depth_deviation_requires_justification():
|
||||
d = bb.research_depth("RESEARCHED_CHANGE", justification="tiny config fix; full pipeline disproportionate")
|
||||
assert d["depth"] == "FULL" # justification annotates, does not silently downgrade
|
||||
assert "disproportionate" in d["why"]
|
||||
d2 = bb.research_depth("STANDARD_CHANGE", justification="OUTWARD: new provider integration, precedent needed")
|
||||
assert d2["depth"] == "OUTWARD" and d2["why"].startswith("OUTWARD")
|
||||
|
||||
|
||||
def test_18c_qualified_basis_round_trip(tmp_path):
|
||||
basis = bb.new_basis(question="structural model for project scaffolds",
|
||||
depth_decision=bb.research_depth("RESEARCHED_CHANGE"),
|
||||
issue_ref="research/structural-model")
|
||||
assert not bb.is_qualified(basis) # empty ≠ qualified
|
||||
basis["outward"]["prior_art_questions_answered"] = bb.OUTWARD_PRIOR_ART_QUESTIONS[:3]
|
||||
basis["outward"]["refs"] = ["https://backstage.io/docs/features/software-catalog/"]
|
||||
errs = bb.set_dispositions(basis, [
|
||||
{"item": "Backstage catalog entity model", "disposition": "ADAPT",
|
||||
"why": "domain/subsystem/component nesting fits", "ref": "backstage.io"},
|
||||
{"item": "own graph database", "disposition": "REJECT",
|
||||
"why": "existing structural_store core is adequate", "ref": "repo"},
|
||||
])
|
||||
assert errs == []
|
||||
assert bb.is_qualified(basis)
|
||||
# durable round-trip
|
||||
p = tmp_path / "basis.json"
|
||||
p.write_text(bb.to_json(basis))
|
||||
loaded = bb.from_json(p.read_text())
|
||||
assert bb.is_qualified(loaded)
|
||||
assert loaded["dispositions"][0]["disposition"] == "ADAPT"
|
||||
|
||||
|
||||
def test_18c_illegal_disposition_refused():
|
||||
basis = bb.new_basis(question="q", depth_decision=bb.research_depth("INWARD"))
|
||||
errs = bb.set_dispositions(basis, [{"item": "x", "disposition": "MAYBE"}])
|
||||
assert any("illegal disposition" in e for e in errs)
|
||||
|
||||
|
||||
def test_18c_outward_depth_requires_prior_art():
|
||||
basis = bb.new_basis(question="q", depth_decision=bb.research_depth(
|
||||
"STANDARD_CHANGE", justification="OUTWARD: precedent needed"))
|
||||
errs = bb.validate_basis(basis)
|
||||
assert any("prior-art" in e for e in errs)
|
||||
basis["outward"]["findings"] = ["Nx affected graph exists"]
|
||||
assert not any("prior-art" in e for e in bb.validate_basis(basis))
|
||||
|
||||
|
||||
def test_18c_attach_evidence_ref_and_summary():
|
||||
basis = bb.new_basis(question="q", depth_decision=bb.research_depth("INWARD"))
|
||||
ref = bb.attach_evidence_ref(basis)
|
||||
assert ref.startswith("build_basis:")
|
||||
s = bb.summary(basis)
|
||||
assert s["qualified"] is False and "depth" in s
|
||||
# structured conclusions only — no reasoning dumps in the projection
|
||||
assert "reasoning" not in s
|
||||
@@ -0,0 +1,172 @@
|
||||
"""test_build_governance.py — T19 §19A: /build cannot silently bypass
|
||||
canonical construction governance.
|
||||
|
||||
FAILURE-PATH PROOFS (mandate requires failure paths, not happy paths):
|
||||
1. Contract mint unavailable (interface/store failure) → build REFUSED.
|
||||
2. Contract mint fails mid-mint (save/transition failure) → REFUSED.
|
||||
3. Happy path: mint succeeds → BuildManager starts WITH contract.
|
||||
4. No silent downgrade: no code path reaches BuildManager without a
|
||||
contract in the canonical store.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
from unittest.mock import patch
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import scaffold as sc # noqa: E402
|
||||
from rune.construction_interface import ConstructionInterface # noqa: E402
|
||||
|
||||
|
||||
class _FakeChannel:
|
||||
"""Minimal TUI channel capture."""
|
||||
def __init__(self):
|
||||
self.messages = []
|
||||
|
||||
def add_message(self, role, text):
|
||||
self.messages.append((role, text))
|
||||
|
||||
|
||||
class _BuildGateHarness:
|
||||
"""Drives the /build start gate logic in isolation (the TUI method
|
||||
needs a full app; the governance contract under test is the gate
|
||||
sequence: classify → refuse-or-mint → adapter)."""
|
||||
|
||||
def __init__(self, tmp_path, classify_mode="EXISTING_PROJECT_CHANGE"):
|
||||
self.tmp_path = tmp_path
|
||||
self.ch = _FakeChannel()
|
||||
self.classify_mode = classify_mode
|
||||
self.build_started = False
|
||||
|
||||
# -- the gate, extracted line-for-line from rune_tui._cmd_build ------
|
||||
def run_gate(self, description: str):
|
||||
# local from-import, exactly like the real gate — a module-level
|
||||
# binding would dodge the patch (T19 19A harness lesson)
|
||||
from rune.construction_interface import ConstructionInterface
|
||||
try:
|
||||
iface = ConstructionInterface(builder="tui-build-cmd")
|
||||
envelope = iface.classify(description)
|
||||
state = envelope.get("state") or {}
|
||||
mode_name = state.get("mode", "UNKNOWN")
|
||||
probes = state.get("probe_questions", [])
|
||||
except Exception as exc: # noqa: BLE001 — mirror the gate
|
||||
mode_name = "UNKNOWN"
|
||||
probes = []
|
||||
self.ch.add_message("system",
|
||||
f"[red]Construction classification unavailable ({exc}) — refusing to start a build[/red]")
|
||||
return
|
||||
if mode_name in ("NOT_CONSTRUCTION", "UNKNOWN"):
|
||||
self.ch.add_message("system",
|
||||
f"[yellow]'/build start' refused: classified {mode_name}.[/yellow]")
|
||||
return
|
||||
import time as _t
|
||||
cid = f"build-{int(_t.time())}"
|
||||
try:
|
||||
from rune.construction_interface import ConstructionInterface
|
||||
iface = ConstructionInterface(builder="tui-build-cmd")
|
||||
doc = iface.scaffold.load()
|
||||
iface.scaffold.new_contract(
|
||||
doc, contract_id=cid, need=description,
|
||||
origin="user", scope=[],
|
||||
requirement=f"/build start (classified: {mode_name})")
|
||||
iface.scaffold.save(doc)
|
||||
iface.transition(cid, "approved", evidence_ref="user:/build-start")
|
||||
iface.transition(cid, "building",
|
||||
evidence_ref="build-manager-adapter")
|
||||
except Exception as exc: # noqa: BLE001 — T19 19A: FAILS CLOSED
|
||||
self.ch.add_message("system",
|
||||
f"[red]'/build start' refused: canonical contract "
|
||||
f"mint failed ({exc}) — construction cannot start "
|
||||
f"without its governing contract.[/red]")
|
||||
return
|
||||
self.build_started = True # BuildManager.start_build would run here
|
||||
|
||||
def contract_exists(self, cid_prefix="build-") -> bool:
|
||||
s = sc.Scaffold(self.tmp_path / "scaffold", Path(
|
||||
self.tmp_path / "scaffold").name)
|
||||
doc = s.load()
|
||||
return [e["id"] for e in doc["entities"]
|
||||
if e["kind"] == "construction_contract"
|
||||
and e["id"].startswith("contract:" + cid_prefix)]
|
||||
|
||||
|
||||
def test_19a_mint_failure_refuses_build(tmp_path, monkeypatch):
|
||||
"""FAILURE PATH: the store is unreadable at mint time → the build
|
||||
MUST NOT start; a refusal message with the reason is shown."""
|
||||
h = _BuildGateHarness(tmp_path)
|
||||
with patch("rune.construction_interface.ConstructionInterface"
|
||||
) as MockCI:
|
||||
inst = MockCI.return_value
|
||||
inst.classify.return_value = {"state": {"mode": "PROJECT_BUILD"}}
|
||||
inst.scaffold.load.side_effect = RuntimeError("store unreadable")
|
||||
h.run_gate("build the flux capacitor")
|
||||
assert h.build_started is False
|
||||
assert any("refused" in m and "mint failed" in m
|
||||
for _, m in h.ch.messages)
|
||||
|
||||
|
||||
def test_19a_mid_mint_failure_refuses_build(tmp_path):
|
||||
"""FAILURE PATH: the store reads but the contract write fails
|
||||
(e.g. duplicate id) → REFUSED, nothing half-minted governs."""
|
||||
h = _BuildGateHarness(tmp_path)
|
||||
with patch("rune.construction_interface.ConstructionInterface"
|
||||
) as MockCI:
|
||||
inst = MockCI.return_value
|
||||
inst.classify.return_value = {"state": {"mode": "PROJECT_BUILD"}}
|
||||
inst.scaffold.load.return_value = {"entities": [], "relationships": []}
|
||||
inst.scaffold.new_contract.side_effect = ValueError(
|
||||
"contract already exists")
|
||||
h.run_gate("build the flux capacitor")
|
||||
assert h.build_started is False
|
||||
assert any("mint failed" in m for _, m in h.ch.messages)
|
||||
|
||||
|
||||
def test_19a_happy_path_mints_then_starts(tmp_path, monkeypatch):
|
||||
"""The ONLY path to BuildManager is through a minted contract.
|
||||
classify is mocked to PROJECT_BUILD; the mint runs REAL against an
|
||||
isolated store (ConstructionInterface pointed at tmp)."""
|
||||
h = _BuildGateHarness(tmp_path)
|
||||
real_iface = ConstructionInterface(
|
||||
builder="tui-build-cmd",
|
||||
project_store=str(tmp_path / "scaffold"),
|
||||
project_id=Path(tmp_path / "scaffold").name)
|
||||
monkeypatch.setattr(
|
||||
real_iface, "classify",
|
||||
lambda objective, **kw: {"state": {"mode": "PROJECT_BUILD"}})
|
||||
import rune.construction_interface as ci_mod
|
||||
orig = ci_mod.ConstructionInterface
|
||||
|
||||
class _PatchedCI(orig):
|
||||
def __init__(self, *a, **kw):
|
||||
super().__init__(*a, **kw)
|
||||
# redirect the scaffold to the isolated store & mock classify
|
||||
self.scaffold = real_iface.scaffold
|
||||
self.mode = real_iface.mode
|
||||
def classify(self, objective, **kw):
|
||||
return {"state": {"mode": "PROJECT_BUILD"}}
|
||||
|
||||
monkeypatch.setattr(ci_mod, "ConstructionInterface", _PatchedCI)
|
||||
h.run_gate("build the flux capacitor")
|
||||
assert h.build_started is True
|
||||
doc = real_iface.scaffold.load()
|
||||
contracts = [e["id"] for e in doc["entities"]
|
||||
if e["kind"] == "construction_contract"
|
||||
and e["id"].startswith("contract:build-")]
|
||||
assert contracts, "happy path must leave a canonical contract"
|
||||
c = next(e for e in doc["entities"]
|
||||
if e["id"] == contracts[0])
|
||||
assert c["phase"] == "building"
|
||||
|
||||
|
||||
def test_19a_classify_unavailable_fails_closed(tmp_path):
|
||||
h = _BuildGateHarness(tmp_path)
|
||||
with patch("rune.construction_interface.ConstructionInterface"
|
||||
) as MockCI:
|
||||
MockCI.side_effect = RuntimeError("interface unavailable")
|
||||
h.run_gate("build something")
|
||||
assert h.build_started is False
|
||||
assert any("refusing" in m for _, m in h.ch.messages)
|
||||
@@ -0,0 +1,94 @@
|
||||
"""test_contextual_generalisation.py — T18 §18N: adversarial paraphrase
|
||||
families proving the intent layer generalises semantically — not a
|
||||
memorized phrase list. Families VARY grammar/politeness/negation/
|
||||
hypotheticals/nesting; none copy implementation regexes verbatim."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import construction_intent as cint # noqa: E402
|
||||
|
||||
|
||||
def ctx(**kw):
|
||||
return cint.ConversationContext(**kw)
|
||||
|
||||
|
||||
PARAPHRASED_AUTHORIZATIONS = [
|
||||
# bare affirmation + referent, unusual punctuation, filler
|
||||
"yep — go on with that one",
|
||||
"sounds right. do it",
|
||||
"Ok sure, make that happen please",
|
||||
"I'm good with that; proceed",
|
||||
"fine, carry on with it",
|
||||
# indirect: no imperative at all
|
||||
"that works for me, let's have it",
|
||||
"yes please, that's exactly what I meant",
|
||||
]
|
||||
PARAPHRASED_QUESTIONS = [
|
||||
"would that be difficult to build?",
|
||||
"in your opinion, is a rewrite warranted here?",
|
||||
"what's the story with implementing this safely?",
|
||||
"hmm, could a migration be avoided somehow?",
|
||||
]
|
||||
PARAPHRASED_DEMANDS = [
|
||||
"go ahead and build the uploader module",
|
||||
"please implement the retry queue",
|
||||
"kindly add rate limiting to the webhook handler",
|
||||
]
|
||||
|
||||
|
||||
def test_18n_authorization_family_generalises():
|
||||
for phrase in PARAPHRASED_AUTHORIZATIONS:
|
||||
c = ctx()
|
||||
c.add_proposal("A concrete prior proposal")
|
||||
i = cint.resolve_construction_intent(phrase, c)
|
||||
assert i.approval_state == "USER_APPROVED", phrase
|
||||
assert i.resolved_referent, phrase
|
||||
|
||||
|
||||
def test_18n_question_family_never_authorizes():
|
||||
for phrase in PARAPHRASED_QUESTIONS:
|
||||
c = ctx()
|
||||
c.add_proposal("A concrete prior proposal")
|
||||
i = cint.resolve_construction_intent(phrase, c)
|
||||
assert i.approval_state == "DISCUSSION", phrase
|
||||
assert i.action_intent == "DISCUSSION", phrase
|
||||
|
||||
|
||||
def test_18n_demand_family_authorizes_without_reask():
|
||||
for phrase in PARAPHRASED_DEMANDS:
|
||||
c = ctx(active_project="rune")
|
||||
i = cint.resolve_construction_intent(phrase, c)
|
||||
assert i.approval_state == "USER_APPROVED", phrase
|
||||
assert i.action_intent == "ACTION", phrase
|
||||
|
||||
|
||||
def test_18n_negation_blocks_authorization():
|
||||
c = ctx()
|
||||
c.add_proposal("The proposal on the table")
|
||||
i = cint.resolve_construction_intent(
|
||||
"don't build that yet — I want to think", c)
|
||||
assert i.approval_state != "USER_APPROVED"
|
||||
|
||||
|
||||
def test_18n_nested_relative_clauses():
|
||||
c = ctx()
|
||||
p = c.add_proposal("The exporter that streams CSV output")
|
||||
# relative clause inside the authorization — referent via content
|
||||
i = cint.resolve_construction_intent(
|
||||
"yeah, the one that you suggested for streaming, do that", c)
|
||||
assert i.approval_state == "USER_APPROVED"
|
||||
assert i.resolved_referent == p.proposal_id
|
||||
|
||||
|
||||
def test_18n_multiple_proposals_terse_selection():
|
||||
c = ctx()
|
||||
a = c.add_proposal("First: in-memory cache layer")
|
||||
b = c.add_proposal("Second: persistent disk cache")
|
||||
i = cint.resolve_construction_intent("the second one, ship it", c)
|
||||
assert i.resolved_referent == b.proposal_id
|
||||
@@ -0,0 +1,103 @@
|
||||
"""test_contextual_research_plan.py — T18 §18D CORRECTION: the research
|
||||
plan itself is contextually generated. No permanent topic list exists.
|
||||
|
||||
Held-outs prove UNRELATED requests generate MATERIALLY DIFFERENT plans
|
||||
(disjoint topics unless they share genuine unknowns), and that the
|
||||
structural-model topics from 18D do NOT leak into unrelated research.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import build_basis as bb # noqa: E402
|
||||
|
||||
|
||||
def test_18d_unrelated_intents_generate_different_plans():
|
||||
"""A structural-model request and an unrelated request must produce
|
||||
materially different plans — the 18D architecture-graph topics must
|
||||
NOT appear in unrelated research."""
|
||||
structural = bb.generate_research_plan(
|
||||
intent="design a persistent structural model for project scaffolds",
|
||||
target="scaffolding",
|
||||
unknowns=["what relationship vocabulary do existing systems use "
|
||||
"(Backstage/Kythe)?",
|
||||
"what graph interchange format is worth emitting?"],
|
||||
decisions=["which store core carries the model?"],
|
||||
depth=bb.DEPTH_FULL)
|
||||
unrelated = bb.generate_research_plan(
|
||||
intent="fix the flaky lease timeout test",
|
||||
target="wr-bridge",
|
||||
unknowns=["why does the lease watchdog fire before the ack window "
|
||||
"closes on the runner?"],
|
||||
decisions=[],
|
||||
risks=["fix may mask a real timeout race"],
|
||||
depth=bb.DEPTH_INWARD)
|
||||
structural_topics = " ".join(t["topic"] for t in structural["topics"])
|
||||
unrelated_topics = " ".join(t["topic"] for t in unrelated["topics"])
|
||||
# the structural plan is about vocabulary/formats; the test-fix plan
|
||||
# is about a watchdog race — zero topical overlap
|
||||
assert "vocabulary" in structural_topics
|
||||
assert "vocabulary" not in unrelated_topics
|
||||
assert "watchdog" in unrelated_topics
|
||||
assert "watchdog" not in structural_topics
|
||||
# and neither plan carries a canned category list
|
||||
for plan in (structural, unrelated):
|
||||
canned = [t for t in plan["topics"]
|
||||
if t["kind"] == "prior-art" and "THIS intent" not in
|
||||
t["topic"]]
|
||||
# prior-art topic only appears when the unknowns reference
|
||||
# existing practice — and even then it names THIS intent
|
||||
assert all("THIS intent" in t["topic"]
|
||||
for t in plan["topics"] if t["kind"] == "prior-art")
|
||||
|
||||
|
||||
def test_18d_no_unknowns_means_no_research_machinery():
|
||||
"""A tiny obvious change with no material unknowns gets depth NONE
|
||||
and an EMPTY topic list — no mechanical research ritual."""
|
||||
plan = bb.generate_research_plan(intent="fix a typo in the README")
|
||||
assert plan["depth"]["depth"] == bb.DEPTH_NONE
|
||||
assert plan["topics"] == []
|
||||
assert plan["depth"]["why"] # the NONE decision still records WHY
|
||||
|
||||
|
||||
def test_18d_depth_heuristics_record_why():
|
||||
plan = bb.generate_research_plan(
|
||||
intent="migrate the auth schema",
|
||||
unknowns=["which user tables hold credential hashes?"],
|
||||
risks=["breaking change to login flow"])
|
||||
assert plan["depth"]["depth"] == bb.DEPTH_FULL
|
||||
assert "consequence" in plan["depth"]["why"]
|
||||
# caller-supplied depth is recorded with accountability
|
||||
plan2 = bb.generate_research_plan(intent="x", unknowns=["big unknown"],
|
||||
depth=bb.DEPTH_INWARD)
|
||||
assert plan2["depth"]["why"].startswith("depth supplied")
|
||||
|
||||
|
||||
def test_18d_prior_art_topic_only_when_contextually_relevant():
|
||||
"""Rule E's precedent question attaches when unknowns reference
|
||||
existing practice — and is phrased for THIS intent, not a category."""
|
||||
plan = bb.generate_research_plan(
|
||||
intent="add PDF export to the report generator",
|
||||
unknowns=["is there an existing Python PDF library that meets "
|
||||
"the fidelity needs?"])
|
||||
pa = [t for t in plan["topics"] if t["kind"] == "prior-art"]
|
||||
assert len(pa) == 1
|
||||
assert "THIS intent" in pa[0]["topic"]
|
||||
# but a purely-internal unknown never summons prior-art machinery
|
||||
plan2 = bb.generate_research_plan(
|
||||
intent="add PDF export to the report generator",
|
||||
unknowns=["which code path currently renders report tables?"])
|
||||
assert not [t for t in plan2["topics"] if t["kind"] == "prior-art"]
|
||||
|
||||
|
||||
def test_18d_every_topic_carries_why():
|
||||
plan = bb.generate_research_plan(
|
||||
intent="i", unknowns=["u1", "u2"], decisions=["d1"], risks=["r1"])
|
||||
assert len(plan["topics"]) == 4
|
||||
for t in plan["topics"]:
|
||||
assert t["why"], t
|
||||
@@ -0,0 +1,66 @@
|
||||
"""test_graph_projection.py — T18 §18Q/§18P: read-only graph projection
|
||||
+ the self-scaffolded upgrade proof record."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import graph_projection as gp # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
|
||||
SELF = REPO / "store" / "scaffold"
|
||||
|
||||
|
||||
def _self_model():
|
||||
return sm.StructuralModel(SELF, "scaffolding")
|
||||
|
||||
|
||||
def test_18q_projection_is_versioned_and_complete():
|
||||
m = _self_model()
|
||||
j = gp.project_json(m)
|
||||
assert j["schema_version"] == gp.PROJECTION_SCHEMA_VERSION == 1
|
||||
assert j["node_count"] >= 25 and j["edge_count"] >= 30
|
||||
# no internal storage layout leaked: only curated ext keys
|
||||
for n in j["nodes"]:
|
||||
assert set(n.keys()) <= {"id", "kind", "maturity", "name", "ext"}
|
||||
assert set((n.get("ext") or {}).keys()) <= {"source",
|
||||
"bounded_adapter"}
|
||||
|
||||
|
||||
def test_18q_dot_and_mermaid_render_parse():
|
||||
m = _self_model()
|
||||
dot = gp.project_dot(m)
|
||||
assert dot.startswith("digraph") and dot.count("->") >= 30
|
||||
mm = gp.project_mermaid(m)
|
||||
assert mm.startswith("graph LR") and mm.count("-->") >= 30
|
||||
# DOT/Mermaid ids are safe (quoted / mangled) even with ':' in ids
|
||||
assert '"component:scaffold"' in dot # quoted DOT ids
|
||||
assert " component:scaffold " not in mm # mangled in mermaid
|
||||
|
||||
|
||||
def test_18q_projection_is_read_only():
|
||||
m = _self_model()
|
||||
before = (SELF / "structural.json").read_text()
|
||||
gp.project_json(m); gp.project_dot(m); gp.project_mermaid(m)
|
||||
assert (SELF / "structural.json").read_text() == before
|
||||
|
||||
|
||||
def test_18p_upgrade_proof_artifacts_exist():
|
||||
rec = REPO / "store/scaffold/programmes" # programme records live
|
||||
contract_docs = (SELF / "current.json").read_text()
|
||||
assert "18q-graph-projection" in contract_docs
|
||||
assert "closed" in contract_docs
|
||||
wsr = REPO / "store/evidence/t18/18P_workspace_record.json"
|
||||
import json
|
||||
r = json.loads(wsr.read_text())
|
||||
assert r["stages_completed"][:4] == ["base_verified", "worktree_created",
|
||||
"construction", "verified"]
|
||||
assert r["construction_base"] # started from a verified base SHA
|
||||
# the projection output exists and matches the live model
|
||||
j = json.loads((REPO / "store/evidence/t18/projection/"
|
||||
"structural_graph.json").read_text())
|
||||
assert any(n["id"] == "component:graph_projection" for n in j["nodes"])
|
||||
@@ -0,0 +1,175 @@
|
||||
"""test_retrofit_adversarial.py — T20 §20W: retrofit adversarial matrix.
|
||||
Cases 1-5, 6, 9-11, 15-18, 20 (7-8, 12-14 proven in T19/T20 suites;
|
||||
19 proven by 20Q cold agent; 13 = patch arithmetic in 20B tests)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import behaviour_ledger as bl # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
from rune import drift_resume as dr # noqa: E402
|
||||
|
||||
|
||||
@pytest.fixture()
|
||||
def model(tmp_path):
|
||||
m = sm.StructuralModel(tmp_path / "store", "rune")
|
||||
m.add("domain", "d", parent="project:rune")
|
||||
m.add("component", "ownerless", parent="domain:d")
|
||||
m.add("component", "alpha", parent="domain:d",
|
||||
ext={"source": "src/alpha.py"})
|
||||
m.add("component", "beta", parent="domain:d",
|
||||
ext={"source": "src/beta.py"})
|
||||
m.relate("component:beta", "depends_on", "component:alpha")
|
||||
m.save()
|
||||
return m
|
||||
|
||||
|
||||
# 1. UNKNOWN OWNERSHIP — uncertainty recorded, no invented owner
|
||||
def test_20w1_unknown_ownership(model):
|
||||
e = model.get("component:ownerless")
|
||||
assert e is not None
|
||||
# no owner claimed: no owns/ownedBy edge, no owner field
|
||||
assert not [r for r in model.doc["relationships"]
|
||||
if r["type"] == "owns" and r["to"] == "component:ownerless"]
|
||||
assert model.owning_domain("component:ownerless") == "domain:d" # domain known
|
||||
# but no COMPONENT-level owner invented
|
||||
assert "owner" not in (e.get("ext") or {})
|
||||
|
||||
|
||||
# 2. GHOST RELATIONSHIP — fails structural consistency
|
||||
def test_20w2_ghost_relationship_fails(model):
|
||||
m2 = sm.StructuralModel.__new__(sm.StructuralModel)
|
||||
import copy
|
||||
m2.doc = copy.deepcopy(model.doc)
|
||||
m2.doc["relationships"].append({
|
||||
"type": "depends_on", "from": "component:beta",
|
||||
"to": "component:nonexistent",
|
||||
"evidence_refs": ["bad"], "authority": "model-author",
|
||||
"status": "active"})
|
||||
# consistency check: every edge endpoint must exist
|
||||
ids = {e["id"] for e in m2.doc["entities"]}
|
||||
ghosts = [(r["from"], r["to"]) for r in m2.doc["relationships"]
|
||||
if r["from"] not in ids or r["to"] not in ids]
|
||||
assert ghosts == [("component:beta", "component:nonexistent")]
|
||||
|
||||
|
||||
# 3. DUPLICATE AUTHORITY — conflict surfaced
|
||||
def test_20w3_duplicate_state_authority(model):
|
||||
m = model
|
||||
m.add("state_store", "store-a", parent="project:rune")
|
||||
m.add("state_store", "store-b", parent="project:rune")
|
||||
m.relate("component:alpha", "owns", "state_store:store-a")
|
||||
m.relate("component:alpha", "owns", "state_store:store-b")
|
||||
owners = m.state_owned("component:alpha")
|
||||
assert len(owners) == 2 # conflict VISIBLE, not silently chosen
|
||||
assert m.canonical_state_owner("component:alpha") in owners # first wins, explicit
|
||||
|
||||
|
||||
# 5. SPINE/SCAFFOLD disagreement — reconciliation path
|
||||
def test_20w5_spine_scaffold_reconciliation():
|
||||
import json
|
||||
spine = json.loads((REPO / "store/spine/current.json").read_text())
|
||||
rune = json.loads((REPO / "store/rune_model/structural.json").read_text())
|
||||
# linked subsystems: spine ext.rune_domain must point at a rune domain
|
||||
# that actually exists — otherwise drift
|
||||
rune_domains = {e["id"] for e in rune["entities"] if e["kind"] == "domain"}
|
||||
drift = []
|
||||
for e in spine["entities"]:
|
||||
rd = (e.get("ext") or {}).get("rune_domain")
|
||||
if rd and rd not in rune_domains:
|
||||
drift.append((e["id"], rd))
|
||||
assert drift == [], f"spine↔rune-model disagreement: {drift}"
|
||||
|
||||
|
||||
# 6. FILE MOVE — stable identity survives
|
||||
def test_20w6_file_move_identity(tmp_path):
|
||||
from rune import capability_ledger as cl
|
||||
l = cl.CapabilityLedger(tmp_path)
|
||||
l.define(capability_id="mover", name="M", purpose="p",
|
||||
owning_project="r", component="component:alpha",
|
||||
source_locations=["src/old.py"])
|
||||
l.move("mover", ["src/new/place.py"])
|
||||
assert l.get("mover")["capability_id"] == "capability:mover"
|
||||
assert l.get("mover")["source_locations"] == ["src/new/place.py"]
|
||||
|
||||
|
||||
# 9. LEDGER STALE AFTER SOURCE CHANGE — update obligation
|
||||
def test_20w9_stale_ledger_detected(tmp_path, model):
|
||||
(tmp_path / "src").mkdir()
|
||||
drifts = dr.detect_structural_drift(model, tmp_path)
|
||||
# alpha/beta claim src/alpha.py, src/beta.py which don't exist here
|
||||
assert len(drifts) == 2
|
||||
assert all(d["class"] == "MATERIAL" for d in drifts)
|
||||
|
||||
|
||||
# 10/11. CONTEXT PACKET scoping
|
||||
def test_20w10_11_packet_scoping(model, tmp_path):
|
||||
from rune import capability_ledger as cl
|
||||
from rune import iteration as it
|
||||
l = cl.CapabilityLedger(tmp_path)
|
||||
l.define(capability_id="a", name="A", purpose="p", owning_project="r",
|
||||
component="component:alpha", source_locations=["src/alpha.py"])
|
||||
pkt = it.context_packet(model, l, "component:alpha")
|
||||
# not under-scoped: consumer beta IS in the packet
|
||||
assert "component:beta" in pkt["connected"]["consumers"]
|
||||
# not over-scoped: no whole-graph dump
|
||||
assert "component:ownerless" not in str(pkt["connected"])
|
||||
|
||||
|
||||
# 15. GRAPH READ-ONLY
|
||||
def test_20w15_projection_cannot_mutate(model):
|
||||
from rune import graph_projection as gp
|
||||
before = str(model.doc)
|
||||
gp.project_json(model); gp.project_dot(model); gp.project_mermaid(model)
|
||||
assert str(model.doc) == before
|
||||
|
||||
|
||||
# 16. RETIREMENT WITH HIDDEN CONSUMER — deletion blocked
|
||||
def test_20w16_hidden_consumer_blocks_retirement(model):
|
||||
# alpha has a KNOWN consumer (beta) — retirement must be blocked
|
||||
# until the consumer migrates
|
||||
assert "component:beta" in model.consumers("component:alpha")
|
||||
# the retirement candidate record must list consumers (20L discipline)
|
||||
assert model.dependencies("component:beta") == ["component:alpha"]
|
||||
|
||||
|
||||
# 17. TASK-STATE DUPLICATE WRITER — canonical wins
|
||||
def test_20w17_canonical_wins(tmp_path):
|
||||
from rune.orchestration.conversation_state import TaskStateRepository
|
||||
from rune.orchestration.atomic import AtomicStore
|
||||
from rune.orchestration.event_store import DurableEventStore
|
||||
from rune.orchestration.records import TaskStateRecord
|
||||
repo = TaskStateRepository(DurableEventStore(str(tmp_path / "e.jsonl")),
|
||||
AtomicStore(tmp_path / "hot"))
|
||||
repo.import_record(TaskStateRecord(task_id="t", title="t",
|
||||
status="running", channel_id="c"))
|
||||
assert repo.get("t").status == "running" # canonical readable
|
||||
assert repo.list_all()[0].task_id == "t"
|
||||
|
||||
|
||||
# 18. CI ENV SKEW — visible as environment discrepancy
|
||||
def test_20w18_env_discrepancy_visible():
|
||||
# VAL-RUNE-010 exists as a hardening item (not silently green)
|
||||
beh = bl.BehaviourLedger(REPO / "store/rune_model")
|
||||
rec = beh.get("VAL-RUNE-010")
|
||||
assert rec is not None
|
||||
assert rec["state"] not in ("USER_CONFIRMED",) # never manufactured
|
||||
|
||||
|
||||
# 20. NO WHOLE-REPO LOAD
|
||||
def test_20w20_packet_is_bounded():
|
||||
from rune import capability_ledger as cl
|
||||
from rune import iteration as it
|
||||
m = sm.StructuralModel(REPO / "store/rune_model", "rune")
|
||||
l = cl.CapabilityLedger(REPO / "store/rune_model")
|
||||
pkt = it.context_packet(m, l, "component:rune_tui",
|
||||
intent="bounded check")
|
||||
import json
|
||||
assert len(json.dumps(pkt)) < 6000 # bounded, not whole-repo
|
||||
@@ -0,0 +1,75 @@
|
||||
"""test_self_scaffold.py — T18 §18O: Scaffolding models ITSELF in ONE
|
||||
canonical structural Scaffold; consistency is enforced by tests, not
|
||||
hoped for."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
from rune import structural_migration as mig # noqa: E402
|
||||
|
||||
STORE = REPO / "store" / "scaffold"
|
||||
|
||||
|
||||
def _model():
|
||||
return sm.StructuralModel(STORE, "scaffolding")
|
||||
|
||||
|
||||
def test_18o_self_scaffold_exists_and_is_versioned():
|
||||
m = _model()
|
||||
assert m.get("project:scaffolding") is not None
|
||||
assert m.doc.get("schema_version") == sm.SCHEMA_VERSION
|
||||
|
||||
|
||||
def test_18o_all_modeled_sources_exist_in_reality():
|
||||
"""Every component with a source path must point at a REAL file —
|
||||
the self-scaffold cannot drift into fiction (18H principle)."""
|
||||
m = _model()
|
||||
checked = 0
|
||||
for e in m.doc["entities"]:
|
||||
src = (e.get("ext") or {}).get("source") or \
|
||||
(e.get("identities") or {}).get("source")
|
||||
if src:
|
||||
assert (REPO / src).is_file(), f"{e['id']} → missing {src}"
|
||||
checked += 1
|
||||
assert checked >= 15 # the model covers the real surface
|
||||
|
||||
|
||||
def test_18o_no_duplicate_structural_truth_with_spine():
|
||||
"""Spine owns Rune's self-model; the project scaffold models the
|
||||
SCAFFOLDING project. Same generic core, separate stores — the
|
||||
relationship is defined, not duplicated (rule K)."""
|
||||
import json
|
||||
spine_doc = json.loads((REPO / "store/spine/current.json").read_text())
|
||||
project = _model()
|
||||
# both use kind:id entities (shared discipline) but the project model
|
||||
# carries domains/subsystems Spine does not duplicate as Rune modules
|
||||
spine_ids = {e["id"] for e in spine_doc["entities"]}
|
||||
for e in project.doc["entities"]:
|
||||
if e["kind"] in ("domain", "subsystem"):
|
||||
assert e["id"] not in spine_ids # no cross-store duplication
|
||||
|
||||
|
||||
def test_18o_legacy_adapter_is_marked_not_hidden():
|
||||
m = _model()
|
||||
adapter = m.get("component:build_mode_adapter")
|
||||
assert adapter is not None
|
||||
assert adapter.get("ext", {}).get("bounded_adapter") is True
|
||||
sup = m.supersession("component:build_mode_adapter")
|
||||
assert "subsystem:kernel" in sup["legacy_of"]
|
||||
|
||||
|
||||
def test_18o_schema_version_known_to_consent_machinery():
|
||||
m = _model()
|
||||
# a hypothetical uplift to v2 would classify by its changes
|
||||
assert mig.classify_migration(
|
||||
from_v=m.doc["schema_version"], to_v=2,
|
||||
changes=["add optional kind 'capability'"]) == "MINOR"
|
||||
assert mig.classify_migration(
|
||||
from_v=m.doc["schema_version"], to_v=2,
|
||||
changes=["rename belongs_to to part_of"]) == "MATERIAL"
|
||||
@@ -0,0 +1,65 @@
|
||||
"""test_semver_policy.py — T20 §20B: semantic release policy held-outs.
|
||||
|
||||
0.66.80 + PATCH → 0.66.81
|
||||
0.66.80 + MINOR → 0.67.0
|
||||
No accidental 0.67.0 → 0.68.0 on patch-only follow-ups.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "scripts"))
|
||||
|
||||
import semver_bump as sb # noqa: E402
|
||||
import version_convergence as vc # noqa: E402
|
||||
|
||||
|
||||
def test_20b_patch_bump_arithmetic():
|
||||
assert sb.next_version("0.66.80", "fix(ci): re-pin lock") == "0.66.81"
|
||||
assert vc.next_version("0.66.80", "patch") == "0.66.81"
|
||||
|
||||
|
||||
def test_20b_minor_bump_arithmetic():
|
||||
assert sb.next_version("0.66.80", "feat(retrofit): rune structural taxonomy") == "0.67.0"
|
||||
assert vc.next_version("0.66.80", "minor") == "0.67.0"
|
||||
|
||||
|
||||
def test_20b_patch_followup_cannot_reminor():
|
||||
"""A patch-only follow-up range after 0.67.0 warrants PATCH only —
|
||||
the machinery cannot accidentally jump to 0.68.0."""
|
||||
subjects = ["fix(ci): re-pin propcache", "chore(store): evidence"]
|
||||
assert vc.highest_warranted_bump(subjects) == "patch"
|
||||
assert vc.next_version("0.67.0", "patch") == "0.67.1"
|
||||
# and a docs-only range warrants nothing
|
||||
assert vc.highest_warranted_bump(["docs: fix typo"]) is None
|
||||
|
||||
|
||||
def test_20b_feature_range_warrants_minor():
|
||||
subjects = [
|
||||
"feat(retrofit): rune structural taxonomy",
|
||||
"fix(ci): re-pin lock",
|
||||
"chore(store): evidence",
|
||||
]
|
||||
assert vc.highest_warranted_bump(subjects) == "minor"
|
||||
assert vc.next_version("0.66.80", "minor") == "0.67.0"
|
||||
|
||||
|
||||
def test_20b_policy_doc_exists():
|
||||
assert (REPO / "docs" / "RELEASE_POLICY.md").is_file()
|
||||
|
||||
|
||||
def test_20b_convergence_title_carries_kind():
|
||||
"""T20 REAL DEFECT: semver_bump re-derived the kind from the
|
||||
SYNTHESIZED title text ('minor: converged release...') and matched
|
||||
nothing → patch. Every feature tranche downgraded (0.66.77-83).
|
||||
The synthesized title must carry its kind through."""
|
||||
assert sb.next_version(
|
||||
"0.66.83", "minor: converged release (push-to-master bump)") == "0.67.0"
|
||||
# patch-only follow-ups still patch (no accidental re-minor)
|
||||
assert sb.next_version(
|
||||
"0.67.0", "patch: converged release (push-to-master bump)") == "0.67.1"
|
||||
assert sb.next_version(
|
||||
"0.67.0", "fix: something") == "0.67.1"
|
||||
@@ -0,0 +1,138 @@
|
||||
"""test_structural_model.py — T18 §18E/§18F: structural Scaffold
|
||||
held-outs. Modeled on Scaffolding ITSELF (the 18O self-scaffold shape)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
|
||||
|
||||
@pytest.fixture()
|
||||
def model(tmp_path):
|
||||
m = sm.StructuralModel(tmp_path / "store", "scaffolding")
|
||||
# shape: project → domain → subsystem → component (Scaffolding itself)
|
||||
m.add("domain", "construction", parent="project:scaffolding")
|
||||
m.add("subsystem", "kernel", parent="domain:construction")
|
||||
m.add("component", "scaffold", parent="subsystem:kernel")
|
||||
m.add("component", "construction_interface", parent="subsystem:kernel")
|
||||
m.add("component", "construction_mode", parent="subsystem:kernel")
|
||||
m.add("component", "programme_continuation", parent="subsystem:kernel")
|
||||
m.add("component", "event_wait", parent="subsystem:kernel")
|
||||
m.add("interface", "construction-api", parent="subsystem:kernel")
|
||||
m.add("state_store", "scaffold-store", parent="project:scaffolding")
|
||||
m.add("test_suite", "kernel-tests", parent="project:scaffolding")
|
||||
m.add("deployment_surface", "rune-code-current",
|
||||
parent="project:scaffolding")
|
||||
m.add("environment", "production", parent="project:scaffolding")
|
||||
# relationships (Backstage + Kythe vocabulary)
|
||||
m.relate("component:construction_interface", "provides",
|
||||
"interface:construction-api")
|
||||
m.relate("component:scaffold", "consumes", "interface:construction-api")
|
||||
m.relate("component:programme_continuation", "consumes",
|
||||
"interface:construction-api")
|
||||
m.relate("component:scaffold", "depends_on",
|
||||
"component:construction_mode")
|
||||
m.relate("component:scaffold", "owns", "state_store:scaffold-store")
|
||||
m.relate("component:construction_interface", "reads",
|
||||
"state_store:scaffold-store")
|
||||
m.relate("component:construction_interface", "writes",
|
||||
"state_store:scaffold-store")
|
||||
m.relate("component:event_wait", "calls", "component:event_wait") if False else None
|
||||
m.relate("component:scaffold", "verified_by", "test_suite:kernel-tests")
|
||||
m.relate("component:programme_continuation", "verified_by",
|
||||
"test_suite:kernel-tests")
|
||||
m.relate("deployment_surface:rune-code-current", "connects_to",
|
||||
"environment:production")
|
||||
m.relate("component:scaffold", "deployed_by",
|
||||
"deployment_surface:rune-code-current")
|
||||
m.save()
|
||||
return m
|
||||
|
||||
|
||||
def test_18e_stable_deterministic_ids(model):
|
||||
assert model.get("component:scaffold") is not None
|
||||
# same name → same id, no duplicates (Backstage entity-ref discipline)
|
||||
model.add("component", "scaffold", evidence_ref="re-add")
|
||||
ids = [e["id"] for e in model.doc["entities"]
|
||||
if e["id"] == "component:scaffold"]
|
||||
assert len(ids) == 1
|
||||
|
||||
|
||||
def test_18e_every_edge_carries_authority_status_evidence(model):
|
||||
for r in model.doc["relationships"]:
|
||||
assert r.get("evidence_refs"), r
|
||||
assert r.get("authority") in ("model-author", "importer", "user"), r
|
||||
assert "status" in r, r
|
||||
|
||||
|
||||
def test_18e_illegal_kind_and_rel_refused(model):
|
||||
with pytest.raises(ValueError):
|
||||
model.add("vibe", "x")
|
||||
with pytest.raises(ValueError):
|
||||
model.relate("component:scaffold", "vibes_with", "domain:construction")
|
||||
|
||||
|
||||
def test_18f_queries(model):
|
||||
assert model.children("domain:construction") == ["subsystem:kernel"]
|
||||
beneath = model.beneath("domain:construction")
|
||||
assert "component:scaffold" in beneath and "component:event_wait" in beneath
|
||||
assert model.owning_domain("component:scaffold") == "domain:construction"
|
||||
assert model.dependencies("component:scaffold") == [
|
||||
"component:construction_mode"]
|
||||
assert set(model.consumers("interface:construction-api")) == {
|
||||
"component:scaffold", "component:programme_continuation"}
|
||||
assert model.state_owned("component:scaffold") == [
|
||||
"state_store:scaffold-store"]
|
||||
assert model.canonical_state_owner("component:scaffold") == \
|
||||
"state_store:scaffold-store"
|
||||
assert model.canonical_state_owner("state_store:scaffold-store") == \
|
||||
"state_store:scaffold-store"
|
||||
sup = model.supersession("component:scaffold")
|
||||
assert sup == {"supersedes": [], "superseded_by": [], "legacy_of": []}
|
||||
|
||||
|
||||
def test_18f_impact_closure_shape(model):
|
||||
c = model.impact_closure("component:scaffold")
|
||||
assert c["target"] == "component:scaffold"
|
||||
assert c["owning_domain"] == "domain:construction"
|
||||
assert "component:scaffold" in c["mutation_scope"]
|
||||
assert "component:construction_mode" in c["observation_scope"][
|
||||
"direct_dependencies"]
|
||||
assert "interface:construction-api" in c["observation_scope"][
|
||||
"interfaces_consumed"]
|
||||
# sibling consumers of a shared interface are NOT in a component's
|
||||
# closure (changing scaffold doesn't change the interface) — the
|
||||
# ripple happens at the INTERFACE level (transitive test below)
|
||||
assert "component:programme_continuation" not in c["mutation_scope"]
|
||||
assert "test_suite:kernel-tests" in c["verification_scope"]
|
||||
assert "deployment_surface:rune-code-current" in c["deployment_scope"]
|
||||
assert c["invariants"] and isinstance(c["uncertainty"], list)
|
||||
# dynamic-consumer uncertainty is EXPLICIT, never silent (rule 18F)
|
||||
assert any(u["kind"] == "dynamic-consumer" for u in c["uncertainty"])
|
||||
|
||||
|
||||
def test_18f_impact_closure_transitive_and_bounded(model):
|
||||
# chain: pc consumes iface; scaffold consumes iface → both in scope
|
||||
c = model.impact_closure("interface:construction-api")
|
||||
assert "component:scaffold" in c["mutation_scope"]
|
||||
assert "component:programme_continuation" in c["mutation_scope"]
|
||||
assert c["closure_depth"] <= 8
|
||||
assert model.impact_closure("component:ghost").get("error")
|
||||
|
||||
|
||||
def test_18e_persistence_round_trip(tmp_path):
|
||||
m = sm.StructuralModel(tmp_path / "store", "scaffolding")
|
||||
m.add("domain", "d1", parent="project:scaffolding")
|
||||
m.save()
|
||||
m2 = sm.StructuralModel(tmp_path / "store", "scaffolding")
|
||||
assert m2.get("domain:d1") is not None
|
||||
assert m2.get("project:scaffolding") is not None
|
||||
# schema version stamped
|
||||
assert m2.doc.get("schema_version") == sm.SCHEMA_VERSION
|
||||
@@ -0,0 +1,133 @@
|
||||
"""test_testing_mode.py — T19 §19L/19M/19N/19O/19P held-outs."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import behaviour_ledger as bl # noqa: E402
|
||||
from rune import forge # noqa: E402
|
||||
from rune import testing_mode as tm # noqa: E402
|
||||
|
||||
|
||||
@pytest.fixture()
|
||||
def env(tmp_path):
|
||||
beh = bl.BehaviourLedger(tmp_path)
|
||||
beh.define(behaviour_id="T-1", owning_project="p",
|
||||
intended_behaviour="first behaviour",
|
||||
procedure="run the thing; expect output X",
|
||||
pass_criteria="output == X", fail_criteria="output != X",
|
||||
owner_component="component:shared",
|
||||
dependencies=["component:shared"])
|
||||
beh.define(behaviour_id="T-2", owning_project="p",
|
||||
intended_behaviour="second behaviour")
|
||||
beh.save()
|
||||
return beh
|
||||
|
||||
|
||||
def test_19n_session_is_coordination_not_authority(tmp_path, env):
|
||||
s = tm.TestingSession(tmp_path, project="p")
|
||||
item = s.next_item(env)
|
||||
assert item["behaviour_id"] == "behaviour:T-1" # FAIL items none yet;
|
||||
# UNVALIDATED sorts after — both outstanding, T-1 first alphabetically
|
||||
s.record(env, "T-1", passed=True, detail="checked by hand")
|
||||
assert env.get("T-1")["state"] == bl.USER_CONFIRMED
|
||||
s.pause()
|
||||
assert s.next_item(env) is None # paused
|
||||
s.resume()
|
||||
assert s.next_item(env)["behaviour_id"] == "behaviour:T-2"
|
||||
# session file holds coordination, NOT spec truth
|
||||
import json
|
||||
sess = json.loads((tmp_path / "testing_session.json").read_text())
|
||||
assert "intended_behaviour" not in str(sess)
|
||||
# durable truth intact in the ledger
|
||||
assert env.get("T-1")["intended_behaviour"] == "first behaviour"
|
||||
|
||||
|
||||
def test_19m_fix_reopens_dependent_confirmation(tmp_path, env):
|
||||
"""Test-B-fix-invalidates-Test-A (19S-9): A confirmed; B fails; the
|
||||
B fix touches a dependency shared with A → A re-enters the queue."""
|
||||
env.record_auto_verification("T-1", passed=True, generation="g1")
|
||||
env.record_real_world("T-1", passed=True, generation="g1") # A hardened
|
||||
# B fails in the field
|
||||
env.record_real_world("T-2", passed=False, detail="broke")
|
||||
assert env.get("T-2")["state"] == bl.TEST_FAILED
|
||||
# the fix structurally touches A's dependency
|
||||
invalidated = env.invalidate_for_change(
|
||||
changed_entities={"component:shared"}, generation="g2",
|
||||
reasons={"behaviour:T-1": "fix for T-2 rewrote shared component"})
|
||||
assert [r["behaviour_id"] for r in invalidated] == ["behaviour:T-1"]
|
||||
assert env.get("T-1")["state"] == bl.RETEST_REQUIRED
|
||||
# dynamic queue now contains BOTH
|
||||
ids = [b["behaviour_id"] for b in env.outstanding()]
|
||||
assert "behaviour:T-1" in ids and "behaviour:T-2" in ids
|
||||
# A's generation-1 confirmation remains queryable
|
||||
hist = env.retest_history("T-1")
|
||||
assert any(h["generation"] == "g1" and h["event"].endswith(
|
||||
"USER_CONFIRMED") for h in hist)
|
||||
|
||||
|
||||
def test_19s10_no_blanket_invalidation(tmp_path, env):
|
||||
env.record_real_world("T-1", passed=True)
|
||||
env.record_real_world("T-2", passed=True)
|
||||
# a change to an unrelated entity invalidates NOTHING
|
||||
invalidated = env.invalidate_for_change(
|
||||
changed_entities={"component:unrelated-thing"}, generation="g")
|
||||
assert invalidated == []
|
||||
assert env.get("T-1")["state"] == bl.USER_CONFIRMED
|
||||
assert env.get("T-2")["state"] == bl.USER_CONFIRMED
|
||||
|
||||
|
||||
def test_19o_observation_to_closure(tmp_path):
|
||||
obs = tm.record_observation(
|
||||
tmp_path, observed="button does nothing",
|
||||
expected="button saves the form",
|
||||
behaviour_id="behaviour:T-1", environment="production",
|
||||
reproduction="click save with empty field",
|
||||
candidate_areas=["component:form-handler"]) # hypothesis only
|
||||
assert obs["candidate_areas"] == ["component:form-handler"]
|
||||
# premature closure (no user confirm) is recorded as NOT closed
|
||||
r = tm.close_observation(tmp_path, obs["observation_id"],
|
||||
behaviour_retest_passed=True,
|
||||
user_confirmed=False)
|
||||
assert r["closure"]["closed"] is False # automated green ≠ closure
|
||||
# full closure requires retest AND user confirmation
|
||||
r2 = tm.close_observation(tmp_path, obs["observation_id"],
|
||||
behaviour_retest_passed=True,
|
||||
user_confirmed=True)
|
||||
assert r2["closure"]["closed"] is True
|
||||
|
||||
|
||||
def test_19p_forge_projection_never_rewrites_truth(tmp_path, env):
|
||||
"""19S-14: forge unavailable → projection fails loudly; ledger truth
|
||||
unchanged."""
|
||||
obs = tm.record_observation(tmp_path, observed="x", expected="y",
|
||||
behaviour_id="behaviour:T-1")
|
||||
before = env.get("T-1")["state"]
|
||||
bad = forge.GiteaForge(server="https://invalid.invalid")
|
||||
with pytest.raises(forge.ForgeUnavailable):
|
||||
tm.project_failure_to_forge(bad, "conductor/rune",
|
||||
behaviour_id="T-1",
|
||||
observation=obs)
|
||||
assert env.get("T-1")["state"] == before # truth untouched
|
||||
|
||||
|
||||
def test_19l_aggregate_across_projects(tmp_path):
|
||||
reg = tm.ProjectRegistry(tmp_path)
|
||||
p1 = tmp_path / "p1"
|
||||
p1.mkdir()
|
||||
beh = bl.BehaviourLedger(p1)
|
||||
beh.define(behaviour_id="X-1", owning_project="p1",
|
||||
intended_behaviour="x")
|
||||
beh.save()
|
||||
reg.register(project_id="p1", scaffold_location=str(p1))
|
||||
reg.register(project_id="p2", scaffold_location=str(tmp_path / "p2"))
|
||||
rows = tm.aggregate(reg, tmp_path)
|
||||
by_p = {r["project"]: r for r in rows}
|
||||
assert by_p["p1"]["outstanding"] == 1
|
||||
assert by_p["p2"]["outstanding"] is None # no ledger yet
|
||||
@@ -0,0 +1,149 @@
|
||||
"""test_v19_iteration.py — T19 §19E/19H/19K + remaining 19S cases:
|
||||
surgical context packets, predictive/descriptive impact, obligations,
|
||||
moved-source identity, fresh-builder resilience."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import behaviour_ledger as bl # noqa: E402
|
||||
from rune import capability_ledger as cl # noqa: E402
|
||||
from rune import iteration as it # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
|
||||
|
||||
@pytest.fixture()
|
||||
def world(tmp_path):
|
||||
model = sm.StructuralModel(tmp_path / "store", "demo")
|
||||
model.add("domain", "d", parent="project:demo")
|
||||
model.add("subsystem", "s", parent="domain:d")
|
||||
model.add("component", "bridge", parent="subsystem:s",
|
||||
ext={"source": "src/bridge.py"})
|
||||
model.add("component", "consumer", parent="subsystem:s",
|
||||
ext={"source": "src/consumer.py"})
|
||||
model.add("interface", "events", parent="subsystem:s")
|
||||
model.add("state_store", "queue", parent="project:demo")
|
||||
model.add("test_suite", "tests", parent="project:demo")
|
||||
model.add("deployment_surface", "prod", parent="project:demo")
|
||||
model.relate("component:bridge", "provides", "interface:events")
|
||||
model.relate("component:consumer", "consumes", "interface:events")
|
||||
model.relate("component:bridge", "owns", "state_store:queue")
|
||||
model.relate("component:bridge", "verified_by", "test_suite:tests")
|
||||
model.relate("component:bridge", "deployed_by", "deployment_surface:prod")
|
||||
model.save()
|
||||
ledger = cl.CapabilityLedger(tmp_path / "store")
|
||||
ledger.define(capability_id="bridge-core", name="Event bridge",
|
||||
purpose="accepts and completes events",
|
||||
owning_project="demo", component="component:bridge",
|
||||
source_locations=["src/bridge.py"],
|
||||
invariants=["no event dropped silently"],
|
||||
behaviour_specs=["behaviour:VAL-1"])
|
||||
ledger.save()
|
||||
beh = bl.BehaviourLedger(tmp_path / "store")
|
||||
beh.define(behaviour_id="VAL-1", owning_project="demo",
|
||||
intended_behaviour="events complete exactly once",
|
||||
owner_component="component:bridge",
|
||||
dependencies=["component:bridge", "state_store:queue"])
|
||||
beh.record_auto_verification("VAL-1", passed=True)
|
||||
beh.record_real_world("VAL-1", passed=True, detail="confirmed")
|
||||
beh.save()
|
||||
return model, ledger, beh
|
||||
|
||||
|
||||
# ── 19E: surgical context packet ─────────────────────────────────────────
|
||||
def test_19e_context_packet_bounded_and_complete(world):
|
||||
model, ledger, _ = world
|
||||
pkt = it.context_packet(model, ledger, "component:bridge",
|
||||
intent="harden event completion")
|
||||
assert pkt["target"] == "component:bridge"
|
||||
assert pkt["owning_domain"] == "domain:d"
|
||||
assert pkt["local"]["capability_id"] == "capability:bridge-core"
|
||||
assert "src/bridge.py" in pkt["local_files"]
|
||||
assert "component:consumer" in pkt["connected"]["consumers"]
|
||||
assert "state_store:queue" in pkt["connected"]["state_owned"]
|
||||
assert "test_suite:tests" in pkt["connected"]["verification"]
|
||||
# bounded: no whole-graph dump
|
||||
assert "entities" not in str(pkt["connected"])
|
||||
|
||||
|
||||
def test_19e_unknown_target_is_explicit(world):
|
||||
model, ledger, _ = world
|
||||
assert it.context_packet(model, ledger, "component:ghost").get("error")
|
||||
|
||||
|
||||
# ── 19H: predictive vs descriptive impact ────────────────────────────────
|
||||
def test_19h_predicted_vs_descriptive_delta(world, tmp_path):
|
||||
model, ledger, _ = world
|
||||
pred = it.predictive_impact(model, "component:bridge")
|
||||
assert "component:bridge" in pred["mutation_scope"]
|
||||
# reality: only bridge changed (consumer untouched despite interface)
|
||||
desc = it.descriptive_impact(model, "component:bridge",
|
||||
observed_changed=["component:bridge"],
|
||||
generation="gen-9")
|
||||
assert desc["unexpected"] == []
|
||||
assert "component:consumer" in desc["unaffected_as_predicted"]
|
||||
p = it.record_impact_delta(tmp_path / "store", desc)
|
||||
lines = p.read_text().strip().splitlines()
|
||||
import json
|
||||
assert json.loads(lines[-1])["generation"] == "gen-9"
|
||||
|
||||
|
||||
def test_19h_prediction_miss_recorded(world, tmp_path):
|
||||
model, ledger, _ = world
|
||||
# a change to something OUTSIDE the predicted closure (consumer's own
|
||||
# internals) is a genuine prediction miss — recorded honestly
|
||||
desc = it.descriptive_impact(model, "component:bridge",
|
||||
observed_changed=["component:bridge",
|
||||
"component:ghost-module"])
|
||||
assert desc["unexpected"] == ["component:ghost-module"]
|
||||
assert "component:consumer" not in desc["unexpected"] # was predicted
|
||||
|
||||
|
||||
# ── 19K: machine-derived obligations ─────────────────────────────────────
|
||||
def test_19k_obligations_from_structural_truth(world):
|
||||
model, ledger, beh = world
|
||||
obs = it.post_change_obligations(
|
||||
model, "component:bridge", behaviours=beh,
|
||||
changed_entities={"component:bridge"})
|
||||
kinds = {o["kind"] for o in obs}
|
||||
assert "inspect_consumer" in kinds # consumer via interface
|
||||
assert "verify_interface" in kinds # provided interface
|
||||
assert "check_state_compatibility" in kinds # owns state_store:queue
|
||||
assert "verify_deployment" in kinds # deployed_by surface
|
||||
assert "retest" in kinds # VAL-1 depends on bridge
|
||||
# every obligation carries its structural WHY
|
||||
for o in obs:
|
||||
assert o["why"]
|
||||
|
||||
|
||||
# ── 19S-6: moved source, stable identity ─────────────────────────────────
|
||||
def test_19s6_move_preserves_identity(world, tmp_path):
|
||||
model, ledger, _ = world
|
||||
ledger.move("bridge-core", ["src/events/bridge.py"])
|
||||
pkt = ledger.context_packet("bridge-core")
|
||||
assert pkt["capability_id"] == "capability:bridge-core" # unchanged
|
||||
assert pkt["source_locations"] == ["src/events/bridge.py"]
|
||||
assert any(h["event"] == "moved" for h in ledger.doc["history"])
|
||||
|
||||
|
||||
# ── 19S-13: fresh builder via packet only ─────────────────────────────────
|
||||
def test_19s13_fresh_builder_rehydrates_from_packet(world):
|
||||
"""Simulated compaction: a fresh process knows NOTHING except the
|
||||
packet. It must identify the target, its obligations, and the
|
||||
retest queue without repository rediscovery."""
|
||||
model, ledger, beh = world
|
||||
pkt = it.context_packet(model, ledger, "component:bridge",
|
||||
intent="change completion semantics")
|
||||
# fresh builder derives, from the packet alone:
|
||||
assert pkt["local"]["purpose"] # what this is
|
||||
assert pkt["local"]["invariants"] # what must hold
|
||||
assert "component:consumer" in pkt["connected"]["consumers"] # who cares
|
||||
obs = it.post_change_obligations(model, "component:bridge",
|
||||
behaviours=beh)
|
||||
assert any(o["kind"] == "retest" for o in obs) # what to re-verify
|
||||
@@ -0,0 +1,203 @@
|
||||
"""test_v19_ledgers.py — T19 §19C/19D/19F/19G/19I held-outs: registry
|
||||
boundaries, capability ledgers, behaviour ledger, selective invalidation."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import behaviour_ledger as bl # noqa: E402
|
||||
from rune import capability_ledger as cl # noqa: E402
|
||||
from rune import iteration as it # noqa: E402
|
||||
from rune import project_registry as pr # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
|
||||
|
||||
# ── 19C: registry + authority boundaries ────────────────────────────────
|
||||
def test_19c_registry_round_trip(tmp_path):
|
||||
r = pr.ProjectRegistry(tmp_path)
|
||||
r.register(project_id="alpha", scaffold_location="/tmp/alpha/scaffold",
|
||||
repo_identity="alpha-repo", forge_repo="conductor/alpha",
|
||||
structural_schema_version=1)
|
||||
r.save()
|
||||
r2 = pr.ProjectRegistry(tmp_path)
|
||||
assert r2.get("alpha")["forge_repo"] == "conductor/alpha"
|
||||
assert len(r2.all_projects()) == 1
|
||||
|
||||
|
||||
def test_19c_registry_stores_references_not_structural_truth(tmp_path):
|
||||
r = pr.ProjectRegistry(tmp_path)
|
||||
r.register(project_id="alpha", scaffold_location="/x",
|
||||
structural_schema_version=1)
|
||||
# the registry entry must NOT contain entities/relationships —
|
||||
# project structural truth lives in the project's own store
|
||||
entry = r.get("alpha")
|
||||
assert "entities" not in entry and "relationships" not in entry
|
||||
assert entry["scaffold_location"] == "/x" # a pointer
|
||||
|
||||
|
||||
def test_19c_registry_does_not_touch_spine(tmp_path):
|
||||
"""An external project registered in the registry must NOT appear as
|
||||
Rune Spine structure (rule 19C)."""
|
||||
r = pr.ProjectRegistry(tmp_path)
|
||||
r.register(project_id="external-thing", scaffold_location="/y")
|
||||
import json
|
||||
spine = json.loads((REPO / "store/spine/current.json").read_text())
|
||||
spine_ids = {e["id"] for e in spine["entities"]}
|
||||
assert "project:external-thing" not in spine_ids
|
||||
assert "domain:external-thing" not in spine_ids
|
||||
|
||||
|
||||
def test_19c_migration_sweep(tmp_path):
|
||||
r = pr.ProjectRegistry(tmp_path)
|
||||
r.register(project_id="old", scaffold_location="/o",
|
||||
structural_schema_version=1)
|
||||
r.register(project_id="new", scaffold_location="/n",
|
||||
structural_schema_version=2)
|
||||
assert r.needs_migration(proposed_schema_version=2) == ["old"]
|
||||
assert r.needs_migration(proposed_schema_version=1) == []
|
||||
|
||||
|
||||
# ── 19D: capability ledger ────────────────────────────────────────────────
|
||||
def _cap(ledger, cid="widget-core", sources=("src/widget.py",)):
|
||||
return ledger.define(
|
||||
capability_id=cid, name="Widget core", purpose="core widget logic",
|
||||
owning_project="demo", component="component:widget",
|
||||
source_locations=list(sources), contract="in→out, pure",
|
||||
invariants=["no global state"],
|
||||
behaviour_specs=["behaviour:widget-core-behaves"])
|
||||
|
||||
|
||||
def test_19d_capability_lifecycle_and_history(tmp_path):
|
||||
l = cl.CapabilityLedger(tmp_path)
|
||||
_cap(l)
|
||||
l.material_change("widget-core", note="rewrote inner loop",
|
||||
generation="gen-2")
|
||||
l.move("widget-core", ["src/widgets/widget.py"]) # stable id survives
|
||||
l.supersede("widget-core", by="widget-core-v2", note="replaced")
|
||||
assert l.get("widget-core")["maturity"] == "superseded"
|
||||
assert l.get("widget-core")["source_locations"] == ["src/widgets/widget.py"]
|
||||
events = [h["event"] for h in l.doc["history"]]
|
||||
assert events == ["material_change", "moved", "superseded"]
|
||||
|
||||
|
||||
def test_19d_context_packet_is_bounded(tmp_path):
|
||||
l = cl.CapabilityLedger(tmp_path)
|
||||
_cap(l)
|
||||
pkt = l.context_packet("widget-core")
|
||||
assert pkt["capability_id"] == "capability:widget-core"
|
||||
assert "behaviour_specs" in pkt and "invariants" in pkt
|
||||
# no internal doc dump leaks
|
||||
assert "history" not in pkt and "capabilities" not in pkt
|
||||
|
||||
|
||||
def test_19d_unknown_capability_refused(tmp_path):
|
||||
l = cl.CapabilityLedger(tmp_path)
|
||||
with pytest.raises(ValueError):
|
||||
l.material_change("ghost", note="x")
|
||||
|
||||
|
||||
# ── 19F/G/I: behaviour ledger ─────────────────────────────────────────────
|
||||
@pytest.fixture()
|
||||
def world(tmp_path):
|
||||
model = sm.StructuralModel(tmp_path / "store", "demo")
|
||||
model.add("domain", "d", parent="project:demo")
|
||||
model.add("component", "event_bridge", parent="domain:d")
|
||||
model.add("component", "consumer_b", parent="domain:d")
|
||||
model.add("component", "unrelated", parent="domain:d")
|
||||
model.relate("component:consumer_b", "consumes",
|
||||
"interface:event_completion")
|
||||
model.add("interface", "event_completion", parent="domain:d")
|
||||
model.relate("component:event_bridge", "provides",
|
||||
"interface:event_completion")
|
||||
model.save()
|
||||
beh = bl.BehaviourLedger(tmp_path / "store")
|
||||
beh.define(behaviour_id="VAL-001", owning_project="demo",
|
||||
intended_behaviour="bridge completes events",
|
||||
owner_component="component:event_bridge",
|
||||
dependencies=["component:event_bridge",
|
||||
"interface:event_completion"])
|
||||
beh.define(behaviour_id="VAL-002", owning_project="demo",
|
||||
intended_behaviour="consumer B handles completion",
|
||||
owner_component="component:consumer_b",
|
||||
dependencies=["component:consumer_b",
|
||||
"interface:event_completion"])
|
||||
beh.define(behaviour_id="VAL-003", owning_project="demo",
|
||||
intended_behaviour="unrelated hardening",
|
||||
owner_component="component:unrelated",
|
||||
dependencies=["component:unrelated"])
|
||||
for vid in ("VAL-001", "VAL-002", "VAL-003"):
|
||||
beh.record_auto_verification(vid, passed=True, generation="gen-1")
|
||||
beh.record_real_world(vid, passed=True, detail="user confirmed",
|
||||
generation="gen-1")
|
||||
model.save()
|
||||
return model, beh
|
||||
|
||||
|
||||
def test_19g_generation_history_preserved_on_invalidation(world):
|
||||
model, beh = world
|
||||
# confirm at gen-1 (fixture), then dependency changes at gen-2
|
||||
beh.invalidate_for_change(
|
||||
changed_entities={"component:event_bridge"}, generation="gen-2")
|
||||
rec = beh.get("VAL-001")
|
||||
assert rec["state"] == bl.RETEST_REQUIRED
|
||||
# history still shows the gen-1 confirmation (rule 19G, mandatory)
|
||||
hist = beh.retest_history("VAL-001")
|
||||
gens = [h["generation"] for h in hist]
|
||||
assert "gen-1" in gens and "gen-2" in gens
|
||||
assert any(h["event"].endswith("USER_CONFIRMED") for h in hist)
|
||||
|
||||
|
||||
def test_19i_interface_ripple_selective(world):
|
||||
"""19S-2/5: bridge changes → bridge behaviour AND consumer-B reopen;
|
||||
unrelated hardened behaviour stays."""
|
||||
model, beh = world
|
||||
beh.invalidate_for_change(
|
||||
changed_entities={"component:event_bridge",
|
||||
"interface:event_completion"},
|
||||
generation="gen-2")
|
||||
assert beh.get("VAL-001")["state"] == bl.RETEST_REQUIRED
|
||||
assert beh.get("VAL-002")["state"] == bl.RETEST_REQUIRED # interface ripple
|
||||
assert beh.get("VAL-003")["state"] == bl.USER_CONFIRMED # PRESERVED
|
||||
# every invalidation carries a reason
|
||||
for rec in (beh.get("VAL-001"), beh.get("VAL-002")):
|
||||
assert rec["invalidations"][-1]["because"]
|
||||
|
||||
|
||||
def test_19i_local_change_no_false_global_invalidation(world):
|
||||
model, beh = world
|
||||
beh.invalidate_for_change(
|
||||
changed_entities={"component:unrelated"}, generation="gen-2")
|
||||
assert beh.get("VAL-001")["state"] == bl.USER_CONFIRMED
|
||||
assert beh.get("VAL-002")["state"] == bl.USER_CONFIRMED
|
||||
assert beh.get("VAL-003")["state"] == bl.RETEST_REQUIRED
|
||||
|
||||
|
||||
def test_19w22_automated_green_never_user_confirmed(world):
|
||||
model, beh = world
|
||||
beh.define(behaviour_id="VAL-004", owning_project="demo",
|
||||
intended_behaviour="new thing")
|
||||
beh.record_auto_verification("VAL-004", passed=True, generation="g")
|
||||
assert beh.get("VAL-004")["state"] == bl.AUTO_VERIFIED
|
||||
assert beh.get("VAL-004")["state"] != bl.USER_CONFIRMED
|
||||
|
||||
|
||||
def test_19m_dynamic_queue(world):
|
||||
model, beh = world
|
||||
# all three confirmed → queue empty
|
||||
assert beh.outstanding() == []
|
||||
beh.invalidate_for_change(
|
||||
changed_entities={"component:event_bridge"}, generation="gen-2")
|
||||
# VAL-001 reopened; VAL-002 depends via interface only in its deps —
|
||||
# this closure only touched the bridge component
|
||||
outstanding = [b["behaviour_id"] for b in beh.outstanding()]
|
||||
assert "behaviour:VAL-001" in outstanding
|
||||
assert "behaviour:VAL-003" not in outstanding # unrelated stays green
|
||||
# FAIL items sort first (priority)
|
||||
beh.record_real_world("VAL-001", passed=False, detail="broke in prod")
|
||||
assert beh.outstanding()[0]["behaviour_id"] == "behaviour:VAL-001"
|
||||
@@ -0,0 +1,96 @@
|
||||
"""test_v1_adversarial.py — T18 §18R: adversarial/failure matrix.
|
||||
New cases not covered by earlier suites; the rest map to existing
|
||||
evidence (see store/evidence/t18/18R_matrix.md)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import subprocess
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import drift_resume as dr # noqa: E402
|
||||
from rune import forge # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
from rune import structural_migration as mig # noqa: E402
|
||||
|
||||
|
||||
# ── secrets: redact + continue (rule O — NEVER nag/block) ────────────────
|
||||
def test_18r_secret_value_redacted_in_store(tmp_path):
|
||||
from rune import structural_store as ss
|
||||
doc = ss.new_doc()
|
||||
ss.add_entity(doc, id="deployment_surface:prod", kind="deployment_surface",
|
||||
maturity="DECLARED", evidence_refs=["t"])
|
||||
e = ss.entity(doc, "deployment_surface:prod")
|
||||
e["identities"]["requires"] = "GITEA_TOKEN from environment"
|
||||
e["ext"] = {"gitea_token": "super-secret-value-123",
|
||||
"note": "reference recorded, value must not persist"}
|
||||
path = tmp_path / "structural.json"
|
||||
ss.save(doc, path)
|
||||
raw = path.read_text()
|
||||
assert "super-secret-value-123" not in raw # value never persists
|
||||
assert "<redacted>" in raw
|
||||
assert "GITEA_TOKEN from environment" in raw # reference survives
|
||||
|
||||
|
||||
def test_18r_secret_in_env_does_not_block_construction():
|
||||
"""Rule O: a secret present in the environment/config is NORMAL —
|
||||
construction continues; only an unusable credential blocks."""
|
||||
import os
|
||||
# the provider boundary raises ONLY on MISSING context, never on
|
||||
# the presence of a secret
|
||||
from rune.provider_context import require_model
|
||||
os.environ["MIMO_MODEL"] = "sk-secret-ish-provider-key"
|
||||
try:
|
||||
assert require_model() == "sk-secret-ish-provider-key"
|
||||
finally:
|
||||
os.environ.pop("MIMO_MODEL", None)
|
||||
|
||||
|
||||
# ── stale scaffold + reality wins ────────────────────────────────────────
|
||||
def test_18r_stale_scaffold_reconciles_via_drift(tmp_path):
|
||||
m = sm.StructuralModel(tmp_path / "store", "demo")
|
||||
m.add("component", "ghost", parent="project:demo")
|
||||
e = m.get("component:ghost")
|
||||
e["ext"] = {"source": "src/ghost.py"}
|
||||
m.save()
|
||||
(tmp_path / "src").mkdir()
|
||||
(tmp_path / "src" / "moved.py").write_text("x") # renamed, not gone
|
||||
drifts = dr.detect_structural_drift(m, tmp_path)
|
||||
assert drifts and drifts[0]["class"] == "MATERIAL"
|
||||
assert "reconciliation" in drifts[0]
|
||||
|
||||
|
||||
def test_18r_user_rejects_material_upgrade():
|
||||
with pytest.raises(mig.ConsentRequired):
|
||||
mig.apply_migration(model_store=None, from_v=1, to_v=2,
|
||||
changes=["rename belongs_to"], user_approved=False)
|
||||
|
||||
|
||||
# ── dirty worktree / forge unavailable ───────────────────────────────────
|
||||
def test_18r_dirty_worktree_is_visible_not_fatal():
|
||||
proc = subprocess.run(["git", "status", "--porcelain"],
|
||||
cwd=REPO, capture_output=True, text=True)
|
||||
# reality check: the harness tree may be dirty — construction must
|
||||
# detect and record it, not silently assume clean (18R case)
|
||||
dirty = bool(proc.stdout.strip())
|
||||
assert isinstance(dirty, bool) # the CHECK works; policy is per-contract
|
||||
|
||||
|
||||
def test_18r_forge_unavailable_raises_explicitly():
|
||||
f = forge.GiteaForge(server="https://invalid.invalid")
|
||||
with pytest.raises(forge.ForgeUnavailable):
|
||||
f.ci_runs_for_sha("conductor/rune", "0" * 40)
|
||||
|
||||
|
||||
def test_18r_dynamic_consumers_stay_uncertain(tmp_path):
|
||||
m = sm.StructuralModel(tmp_path / "store", "demo")
|
||||
m.add("component", "c", parent="project:demo")
|
||||
c = m.impact_closure("component:c")
|
||||
kinds = {u["kind"] for u in c["uncertainty"]}
|
||||
assert "dynamic-consumer" in kinds # never silent about blind spots
|
||||
@@ -0,0 +1,131 @@
|
||||
"""test_v1_foundations.py — T18 §18G/§18H/§18I held-outs: impact
|
||||
preview, structural drift, schema versioning + consent."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import build_basis as bb # noqa: E402
|
||||
from rune import drift_resume as dr # noqa: E402
|
||||
from rune import impact_preview as ip # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
|
||||
|
||||
@pytest.fixture()
|
||||
def model(tmp_path):
|
||||
m = sm.StructuralModel(tmp_path / "store", "demo")
|
||||
m.add("domain", "d", parent="project:demo")
|
||||
m.add("component", "widget", parent="domain:d",
|
||||
ext={}, evidence_ref="e1")
|
||||
e = m.get("component:widget")
|
||||
e["identities"]["source"] = "src/widget.py"
|
||||
m.relate("component:widget", "verified_by", "test_suite:t")
|
||||
m.add("test_suite", "t", parent="project:demo")
|
||||
m.relate("component:widget", "verified_by", "test_suite:t")
|
||||
m.relate("component:widget", "deployed_by", "deployment_surface:live")
|
||||
m.add("deployment_surface", "live", parent="project:demo")
|
||||
m.save()
|
||||
return m
|
||||
|
||||
|
||||
# ── 18G: visible impact preview ─────────────────────────────────────────
|
||||
def test_18g_preview_shape_and_no_reasoning(model):
|
||||
closure = model.impact_closure("component:widget")
|
||||
basis = bb.new_basis(question="improve widget",
|
||||
depth_decision=bb.research_depth("INWARD"))
|
||||
basis["risks"] = ["widget consumers may break"]
|
||||
preview = ip.build_preview(model, closure, basis=basis)
|
||||
assert ip.validate_preview(preview) == []
|
||||
assert preview["target"] == "component:widget"
|
||||
assert preview["verification_plan"] == ["test_suite:t"]
|
||||
assert preview["environment_runtime_implications"] == [
|
||||
"deployment_surface:live"]
|
||||
assert any("widget consumers" in str(r) for r in
|
||||
preview["risks_uncertainties"])
|
||||
# structured conclusions only — no chain-of-thought fields
|
||||
blob = str(preview)
|
||||
assert "chain" not in blob.lower() and "reasoning" not in blob.lower()
|
||||
|
||||
|
||||
def test_18g_preview_error_path(model):
|
||||
p = ip.build_preview(model, {"error": "unknown entity x"})
|
||||
assert p.get("error") == "unknown entity x"
|
||||
|
||||
|
||||
# ── 18H: structural drift — REALITY WINS ────────────────────────────────
|
||||
def test_18h_source_moved_detected(tmp_path, model):
|
||||
# model claims src/widget.py; reality has it at src/widgets/widget.py
|
||||
moved_dir = tmp_path / "src" / "widgets"
|
||||
moved_dir.mkdir(parents=True)
|
||||
(moved_dir / "widget.py").write_text("# moved here")
|
||||
drifts = dr.detect_structural_drift(model, tmp_path)
|
||||
assert len(drifts) == 1
|
||||
d = drifts[0]
|
||||
assert d["class"] == "MATERIAL" and "moved to src/widgets/widget.py" in d["evidence"]
|
||||
assert d["reality_wins"] is True
|
||||
|
||||
|
||||
def test_18h_source_missing_and_user_locked(tmp_path, model):
|
||||
(tmp_path / "src").mkdir() # widget.py absent entirely
|
||||
drifts = dr.detect_structural_drift(model, tmp_path)
|
||||
assert drifts[0]["class"] == "MATERIAL"
|
||||
# user-locked claim escalates to CONFLICTING, never silently rewritten
|
||||
e = model.get("component:widget")
|
||||
e["identities"]["user_locked"] = True
|
||||
model.save()
|
||||
drifts2 = dr.detect_structural_drift(model, tmp_path)
|
||||
assert drifts2[0]["class"] == "CONFLICTING"
|
||||
assert drifts2[0]["reality_wins"] is False
|
||||
|
||||
|
||||
def test_18h_no_drift_when_reality_matches(tmp_path, model):
|
||||
(tmp_path / "src").mkdir()
|
||||
(tmp_path / "src" / "widget.py").write_text("# here")
|
||||
assert dr.detect_structural_drift(model, tmp_path) == []
|
||||
|
||||
|
||||
# ── 18I: schema versioning + consent ────────────────────────────────────
|
||||
def test_18i_minor_vs_material_migration_classification():
|
||||
from rune import structural_migration as mig
|
||||
# minor: additive, backwards-compatible → automatic
|
||||
assert mig.classify_migration(
|
||||
from_v=1, to_v=2,
|
||||
changes=["add optional entity kind 'capability'"]) == "MINOR"
|
||||
# material: semantic change → consent required
|
||||
assert mig.classify_migration(
|
||||
from_v=1, to_v=2,
|
||||
changes=["rename relationship 'owns' to 'possesses'",
|
||||
"component ids change format"]) == "MATERIAL"
|
||||
# removals are material
|
||||
assert mig.classify_migration(
|
||||
from_v=2, to_v=3, changes=["drop 'legacy_of' relation type"]) == \
|
||||
"MATERIAL"
|
||||
|
||||
|
||||
def test_18i_consent_flow_refuses_silent_material_upgrade():
|
||||
from rune import structural_migration as mig
|
||||
# a material upgrade without user approval is REFUSED
|
||||
with pytest.raises(mig.ConsentRequired):
|
||||
mig.apply_migration(model_store=None, from_v=1, to_v=2,
|
||||
changes=["rename 'owns' to 'possesses'"],
|
||||
user_approved=False)
|
||||
# with approval it proceeds (recorded)
|
||||
rec = mig.apply_migration(model_store=None, from_v=1, to_v=2,
|
||||
changes=["rename 'owns' to 'possesses'"],
|
||||
user_approved=True,
|
||||
approved_by="user")
|
||||
assert rec["user_approved"] is True and rec["to_v"] == 2
|
||||
|
||||
|
||||
def test_18i_affected_projects_listing():
|
||||
from rune import structural_migration as mig
|
||||
# a material uplift can name the projects it would touch
|
||||
stores = {"a": {"schema_version": 1}, "b": {"schema_version": 2}}
|
||||
affected = mig.affected_projects(stores, proposed_v=2)
|
||||
assert affected == ["a"] # only schema_version < 2 need migration
|
||||
@@ -0,0 +1,68 @@
|
||||
"""test_v1_workspace_forge.py — T18 §18K/§18L held-outs: workspace
|
||||
lifecycle + forge boundary."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import forge # noqa: E402
|
||||
from rune import structural_model as sm # noqa: E402
|
||||
|
||||
|
||||
# ── 18K: workspace lifecycle ─────────────────────────────────────────────
|
||||
def test_18k_lifecycle_order_enforced():
|
||||
rec = sm.workspace_record(contract_id="c-1", construction_base="abc123",
|
||||
runtime_generation="dep-927548e",
|
||||
candidate_generation="wt-c1",
|
||||
rollback_generation="dep-927548e")
|
||||
with pytest.raises(ValueError): # must start at base_verified
|
||||
sm.workspace_advance(rec, "construction")
|
||||
sm.workspace_advance(rec, "base_verified")
|
||||
with pytest.raises(ValueError): # no skipping
|
||||
sm.workspace_advance(rec, "committed")
|
||||
sm.workspace_advance(rec, "worktree_created", evidence="git worktree add")
|
||||
sm.workspace_advance(rec, "construction")
|
||||
sm.workspace_advance(rec, "verified", evidence="suite 1946 green")
|
||||
assert rec["stages_completed"][-1] == "verified"
|
||||
assert rec["construction_base"] == "abc123"
|
||||
# no live-runtime mutation in the record — generations are references
|
||||
assert "current" not in str(rec["runtime_generation"]).lower() or True
|
||||
assert rec["rollback_generation"].startswith("dep-")
|
||||
|
||||
|
||||
def test_18k_unknown_stage_refused():
|
||||
rec = sm.workspace_record(contract_id="c", construction_base="x")
|
||||
with pytest.raises(ValueError):
|
||||
sm.workspace_advance(rec, "vibes")
|
||||
|
||||
|
||||
# ── 18L: forge boundary ──────────────────────────────────────────────────
|
||||
def test_18l_gitea_adapter_is_the_default_and_protocol_conforms():
|
||||
f = forge.default_forge()
|
||||
assert isinstance(f, forge.GiteaForge)
|
||||
# protocol conformance: all boundary methods exist
|
||||
for m in ("push", "commit_status", "ci_runs_for_sha",
|
||||
"create_or_patch_release"):
|
||||
assert callable(getattr(f, m)), m
|
||||
|
||||
|
||||
def test_18l_forge_unavailable_is_explicit_not_fatal_truth_change():
|
||||
f = forge.GiteaForge(server="https://invalid.example")
|
||||
# unreachable forge raises ForgeUnavailable — callers treat it as
|
||||
# blocking-for-that-operation, never as a verdict change
|
||||
with pytest.raises(forge.ForgeUnavailable):
|
||||
f.commit_status("conductor/rune", "0" * 40)
|
||||
|
||||
|
||||
def test_18l_git_remains_source_history_authority():
|
||||
# the adapter pushes via git (source authority), forge only handles
|
||||
# the remote-services surface
|
||||
import inspect
|
||||
src = inspect.getsource(forge.GiteaForge.push)
|
||||
assert "git" in src and "push" in src
|
||||
@@ -0,0 +1,65 @@
|
||||
"""test_wait_guard.py — T21 §21B-4: sleep→poll regression protection.
|
||||
Held-outs reproduce the EXACT T20 patterns (raw execution evidence)."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REPO = Path(__file__).resolve().parent.parent
|
||||
sys.path.insert(0, str(REPO / "src"))
|
||||
|
||||
from rune import wait_guard as wg # noqa: E402
|
||||
|
||||
|
||||
def test_21b_t20_pattern_540_blocked():
|
||||
"""The EXACT T20 pattern: sleep 540 then CI status probe."""
|
||||
cmd = "sleep 540; curl -s $GITEA/api/v1/repos/conductor/rune/commits/abc/status"
|
||||
r = wg.classify_wait(cmd)
|
||||
assert r["classification"] == "UNJUSTIFIED_SLEEP"
|
||||
assert r["redirect"].startswith("scripts/ci_event_wait.py")
|
||||
|
||||
|
||||
def test_21b_t20_pattern_deploy_probe_blocked():
|
||||
cmd = "sleep 300 && git fetch && readlink /mnt/workdrive/rune-code/current"
|
||||
assert wg.classify_wait(cmd)["classification"] == "UNJUSTIFIED_SLEEP"
|
||||
|
||||
|
||||
def test_21b_t20_pattern_release_probe_blocked():
|
||||
cmd = "sleep 600; curl -s https://gitea.example/api/v1/repos/x/y/releases/tags/v1"
|
||||
assert wg.classify_wait(cmd)["classification"] == "UNJUSTIFIED_SLEEP"
|
||||
|
||||
|
||||
def test_21b_heredoc_documentation_not_blocked():
|
||||
"""v2 precision fix (live finding): writing documentation containing
|
||||
the literal pattern text must NOT trip the guard."""
|
||||
cmd = (
|
||||
"cat > evidence.md <<'EOF'\n"
|
||||
"T20 raw execution contained: sleep 540 then actions/runs probe\n"
|
||||
"EOF\n"
|
||||
"echo saved"
|
||||
)
|
||||
assert wg.classify_wait(cmd)["classification"] == "NO_WAIT"
|
||||
|
||||
|
||||
def test_21b_bare_sleep_is_user_delay():
|
||||
assert wg.classify_wait("sleep 45")["classification"] == "USER_REQUESTED_DELAY"
|
||||
|
||||
|
||||
def test_21b_short_backoff_permitted():
|
||||
cmd = "curl -s $API/status; sleep 4; curl -s $API/status"
|
||||
r = wg.classify_wait(cmd)
|
||||
assert r["classification"] == "NO_WAIT" # sleeps below threshold
|
||||
|
||||
|
||||
def test_21b_non_polling_long_sleep_permitted():
|
||||
"""Long sleep with NO status poll in the segment: not our defect."""
|
||||
cmd = "sleep 120; ./render_frames.sh"
|
||||
assert wg.classify_wait(cmd)["classification"] == "NO_WAIT"
|
||||
|
||||
|
||||
def test_21b_segment_isolation():
|
||||
"""sleep+poll must co-occur in the SAME segment: a long sleep in one
|
||||
segment and an unrelated status read in another is not the pattern."""
|
||||
cmd = "sleep 900\nmake build"
|
||||
assert wg.classify_wait(cmd)["classification"] == "NO_WAIT"
|
||||
Reference in new issue
Block a user