Compare commits

..
2 Commits
Author SHA1 Message Date
conductor 1326713234 chore(release): auto-bump version to 0.74.0 — earned by # (minor: converged release (push-to-master bump))
Promotion record: (unknown)
2026-09-16 16:26:42 +01:00
Nick 867321ed05 feat(t21.1): 21.1E governed retirement — complexity_scorer deleted (602 lines)
Full lifecycle: DISCOVER (T20L candidate) → consumers mapped (1: the
TUI hint printer) → dynamic risk checked (clean) → canonical replacement
(classify_mode — the ONE classifier, same route as /build and
conversational) → caller migrated → supersession recorded (construction_mode
supersedes complexity_scorer) → stabilization run green → DELETE → spine
reconciled → full regression green (2061) → lint baseline shrunk
(BLE001 350→347, S110 78→75 — earned by the deletion).

Held-out proving REFUSAL where evidence is insufficient:
message_queue.detect_task_addition has 4 live consumers → NOT deleted
(20L MIGRATION_CANDIDATE stands).
2026-09-16 16:26:14 +01:00
10 changed files with 245 additions and 823 deletions

No files matched your search

+1 -1
View File
@@ -1,6 +1,6 @@
# Rune
**Current release: v0.73.0**
**Current release: v0.74.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.**
+1 -2
View File
@@ -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-16T03:45:21Z",
"generated_at": "2026-09-16T15:14:52Z",
"umbrellas": {
"capability": {
"description": "Tool selection and execution authority",
@@ -222,7 +222,6 @@
"capability_fit",
"capability_ledger",
"cognitive_budgeter",
"complexity_scorer",
"construction_activation",
"construction_commands",
"construction_decision",
+2 -2
View File
@@ -1,4 +1,4 @@
{
"BLE001": 350,
"S110": 78
"BLE001": 347,
"S110": 75
}
+1 -1
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "rune"
version = "0.73.0"
version = "0.74.0"
description = "Rune — a stateful coding assistant with persistent memory, orchestration, and TUI"
requires-python = ">=3.10"
+1 -1
View File
@@ -6,7 +6,7 @@ This is the main entry point for the Rune program.
import json
from pathlib import Path
__version__ = "0.73.0"
__version__ = "0.74.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
+1 -1
View File
@@ -231,7 +231,7 @@ def main() -> int:
)
check(
"Rune minor version advertises provisioning and restore verification",
'__version__ = "0.73.0"' in rune_version,
'__version__ = "0.74.0"' in rune_version,
failures,
)
# #169 policy update: auto-bump on merge is sanctioned (Nick directive:
-602
View File
@@ -1,602 +0,0 @@
#!/usr/bin/env python3
"""complexity_scorer.py — Auto-detection of task complexity for build mode.
Scores user requests to determine if they need:
- Task mode (0-3): direct execution
- Task mode with planning (4-7): add planning step
- Build mode (8+): full pipeline
Research basis:
- No existing tool does auto-detection (SWE-agent, Aider, Devin, Cursor, OpenCode)
- Simple keyword scoring: zero cost for 90% of requests, LLM fallback for 10%
- Agent reliability degrades 96% → 34% from 8K to 128K tokens (LOCA-bench, ICML 2026)
- Single-file changes: ~80% success vs <50% for 4-6 files (SWE-bench)
Usage:
complexity_scorer.py score "add user auth with JWT, update API routes, add tests"
complexity_scorer.py mode "fix the typo in README"
"""
import json
import os
import re
import sys
from dataclasses import dataclass, field, asdict
from typing import List, Dict, Any, Optional
# ═══════════════════════════════════════════════════════════════════════════════
# SIGNAL DEFINITIONS
# ═══════════════════════════════════════════════════════════════════════════════
# Request analysis signals (regex, zero cost)
CONJUNCTIONS = ["and", "then", "also", "additionally", "after that", "plus", "as well as"]
CROSS_SYSTEM_REFS = [
"api",
"frontend",
"backend",
"database",
"tests",
"config",
"ci",
"deploy",
"ui",
"cli",
"server",
"client",
"model",
"view",
]
ARCH_KEYWORDS = [
"refactor",
"migrate",
"redesign",
"pipeline",
"system",
"architecture",
"overhaul",
"restructure",
"reorganize",
"consolidate",
]
NEW_ABSTRACTION_KEYWORDS = [
"create a new",
"build a new",
"implement a new",
"add a new",
"new module",
"new system",
"new feature",
"new component",
"new service",
"new layer",
]
SCOPE_MODIFIERS = ["entire", "all", "every", "throughout", "comprehensive", "complete", "full", "whole", "across"]
EXT_DEPENDENCY_KEYWORDS = [
"integrate",
"third-party",
"library",
"package",
"sdk",
"api",
"service",
"webhook",
"external",
]
COMPLEXITY_MARKERS = [
"complex",
"big change",
"major",
"significant",
"extensive",
"substantial",
"non-trivial",
"involved",
]
SIMPLE_FIX_INDICATORS = [
"fix typo",
"rename",
"update comment",
"change color",
"add import",
"remove import",
"fix whitespace",
"format",
"lint",
"bump version",
"update readme",
"fix comment",
]
# Build mode trigger keywords (high confidence)
BUILD_TRIGGERS = [
"implement",
"build",
"create feature",
"refactor",
"migrate",
"across multiple files",
"new system",
"new module",
"overhaul",
"redesign",
"restructure",
"full pipeline",
"end-to-end",
]
# Task mode trigger keywords
TASK_TRIGGERS = [
"fix",
"change",
"update",
"rename",
"bug",
"typo",
"error",
"crash",
"broken",
"not working",
"issue",
"patch",
"hotfix",
]
# Research mode trigger keywords
RESEARCH_TRIGGERS = [
"how does",
"what is",
"explain",
"investigate",
"explore",
"research",
"understand",
"analyze",
"study",
"review",
]
# Plan mode trigger keywords
PLAN_TRIGGERS = [
"plan",
"design",
"architecture",
"before we start",
"approach",
"strategy",
"roadmap",
"blueprint",
"spec",
]
# ═══════════════════════════════════════════════════════════════════════════════
# SCORING FUNCTIONS
# ═══════════════════════════════════════════════════════════════════════════════
@dataclass
class ScoreBreakdown:
"""Detailed breakdown of complexity score."""
request_analysis: int = 0
codebase_impact: int = 0
historical_patterns: int = 0
risk_assessment: int = 0
total: int = 0
signals: List[str] = field(default_factory=list)
mode: str = "task"
confidence: str = "high" # high, medium, low
def analyze_request_text(request: str) -> tuple[int, List[str]]:
"""Analyze request text for complexity signals. Zero cost, <1ms."""
score = 0
signals = []
request_lower = request.lower()
# Multiple verbs/conjunctions
conjunction_matches = [c for c in CONJUNCTIONS if c in request_lower]
if len(conjunction_matches) >= 2:
score += 2
signals.append(f"Multiple conjunctions: {', '.join(conjunction_matches)}")
elif len(conjunction_matches) == 1:
score += 1
signals.append(f"Conjunction: {conjunction_matches[0]}")
# Cross-system references
system_matches = [s for s in CROSS_SYSTEM_REFS if s in request_lower]
if len(system_matches) >= 2:
score += 3
signals.append(f"Cross-system: {', '.join(system_matches)}")
elif len(system_matches) == 1:
score += 1
signals.append(f"System ref: {system_matches[0]}")
# Architecture keywords
arch_matches = [k for k in ARCH_KEYWORDS if k in request_lower]
if arch_matches:
score += 2
signals.append(f"Architecture: {', '.join(arch_matches)}")
# New abstraction keywords
new_matches = [k for k in NEW_ABSTRACTION_KEYWORDS if k in request_lower]
if new_matches:
score += 2
signals.append(f"New abstraction: {', '.join(new_matches)}")
# Scope modifiers
scope_matches = [s for s in SCOPE_MODIFIERS if s in request_lower]
if scope_matches:
score += 1
signals.append(f"Scope: {', '.join(scope_matches)}")
# External dependency mentions
ext_matches = [k for k in EXT_DEPENDENCY_KEYWORDS if k in request_lower]
if ext_matches:
score += 1
signals.append(f"External dep: {', '.join(ext_matches)}")
# Explicit complexity markers
complex_matches = [k for k in COMPLEXITY_MARKERS if k in request_lower]
if complex_matches:
score += 3
signals.append(f"Complexity marker: {', '.join(complex_matches)}")
# Simple fix indicators (negative score)
simple_matches = [k for k in SIMPLE_FIX_INDICATORS if k in request_lower]
if simple_matches:
score -= 3
signals.append(f"Simple fix: {', '.join(simple_matches)}")
return score, signals
def estimate_codebase_impact(request: str, repo_path: str = "/mnt/workdrive/rune") -> tuple[int, List[str]]:
"""Estimate codebase impact using grep/glob. ~100ms."""
score = 0
signals = []
# Extract potential module/function names from request
words = re.findall(r"\b[a-zA-Z_][a-zA-Z0-9_]*\b", request)
# Filter out common words
stop_words = {
"the",
"a",
"an",
"and",
"or",
"but",
"in",
"on",
"at",
"to",
"for",
"of",
"with",
"by",
"from",
"is",
"are",
"was",
"were",
"be",
"been",
"being",
"have",
"has",
"had",
"do",
"does",
"did",
"will",
"would",
"could",
"should",
"may",
"might",
"can",
"shall",
"that",
"which",
"who",
"whom",
"this",
"these",
"those",
"it",
"its",
"my",
"your",
"his",
"her",
"our",
"their",
"me",
"you",
"him",
"us",
"them",
"i",
"we",
"he",
"she",
"they",
"what",
"where",
"when",
"how",
"why",
"if",
"then",
"else",
"so",
"just",
"also",
"very",
"too",
"much",
"many",
"some",
"any",
"all",
"each",
"every",
"both",
"few",
"more",
"most",
"other",
"another",
"such",
"no",
"not",
"only",
"own",
"same",
"than",
"too",
"now",
"here",
"there",
"about",
"up",
"out",
"off",
"over",
"under",
"again",
"further",
"then",
"once",
"new",
"add",
"update",
"fix",
"change",
"make",
"create",
"build",
"implement",
}
potential_modules = [w for w in words if w.lower() not in stop_words and len(w) > 3]
# Check if any potential modules exist in codebase
if potential_modules:
try:
import subprocess
# Quick grep for potential module names
grep_pattern = "|".join(potential_modules[:5]) # Limit to 5 to avoid slow grep
result = subprocess.run(
["grep", "-r", "-l", "-E", grep_pattern, os.path.join(repo_path, "src")],
capture_output=True,
text=True,
timeout=5,
)
if result.returncode == 0:
files = [f for f in result.stdout.strip().split("\n") if f]
if len(files) > 5:
score += 3
signals.append(f"Files likely affected: {len(files)}")
elif len(files) > 2:
score += 1
signals.append(f"Files possibly affected: {len(files)}")
except Exception:
pass
# Check for cross-module dependencies
if "src/rune" in repo_path:
try:
import subprocess
result = subprocess.run(
["grep", "-r", "-c", "import", os.path.join(repo_path, "src/rune")],
capture_output=True,
text=True,
timeout=5,
)
if result.returncode == 0:
import_count = sum(
int(line.split(":")[-1])
for line in result.stdout.strip().split("\n")
if ":" in line and line.split(":")[-1].strip().isdigit()
)
if import_count > 50:
score += 2
signals.append(f"High import density: {import_count} imports")
except Exception:
pass
return score, signals
def check_historical_patterns(request: str) -> tuple[int, List[str]]:
"""Check memory for similar past tasks. Returns score and signals."""
score = 0
signals = []
# Check if similar tasks needed build mode
try:
import sys
sys.path.insert(0, os.path.expanduser("~/.config/opencode/scripts"))
import memory_store
db = memory_store.connect()
try:
results = memory_store.cached_recall(db, f"build mode {request}", budget=3)
if results:
for r in results:
text = r.get("text", "").lower()
if "build mode" in text or "multi-step" in text or "complex" in text:
score += 2
signals.append("Similar past task needed build mode")
break
finally:
db.close()
except Exception:
pass
return score, signals
def assess_risk(request: str, repo_path: str = "/mnt/workdrive/rune") -> tuple[int, List[str]]:
"""Assess risk based on file paths and content."""
score = 0
signals = []
request_lower = request.lower()
# Auth/security code
auth_keywords = ["auth", "security", "token", "credential", "password", "login", "session"]
if any(k in request_lower for k in auth_keywords):
score += 2
signals.append("Touches auth/security code")
# Data layer
data_keywords = ["database", "migration", "schema", "sql", "sqlite", "model", "orm"]
if any(k in request_lower for k in data_keywords):
score += 1
signals.append("Touches data layer")
# Public API
api_keywords = ["api", "endpoint", "route", "export", "interface", "sdk", "public"]
if any(k in request_lower for k in api_keywords):
score += 2
signals.append("Touches public API")
# Reversibility concern
destructive_keywords = ["delete", "remove", "drop", "destroy", "clear", "reset", "wipe"]
if any(k in request_lower for k in destructive_keywords):
score += 1
signals.append("Reversibility concern")
return score, signals
# ═══════════════════════════════════════════════════════════════════════════════
# MAIN SCORING
# ═══════════════════════════════════════════════════════════════════════════════
def score_request(request: str, repo_path: str = "/mnt/workdrive/rune") -> ScoreBreakdown:
"""Score a request for complexity. Returns ScoreBreakdown with total and mode."""
breakdown = ScoreBreakdown()
# Signal Category 1: Request Analysis (zero cost, <1ms)
req_score, req_signals = analyze_request_text(request)
breakdown.request_analysis = req_score
breakdown.signals.extend(req_signals)
# Signal Category 2: Codebase Impact (~100ms)
impact_score, impact_signals = estimate_codebase_impact(request, repo_path)
breakdown.codebase_impact = impact_score
breakdown.signals.extend(impact_signals)
# Signal Category 3: Historical Patterns
hist_score, hist_signals = check_historical_patterns(request)
breakdown.historical_patterns = hist_score
breakdown.signals.extend(hist_signals)
# Signal Category 4: Risk Assessment
risk_score, risk_signals = assess_risk(request, repo_path)
breakdown.risk_assessment = risk_score
breakdown.signals.extend(risk_signals)
# Calculate total
breakdown.total = (
breakdown.request_analysis
+ breakdown.codebase_impact
+ breakdown.historical_patterns
+ breakdown.risk_assessment
)
# Determine mode
if breakdown.total >= 8:
breakdown.mode = "build"
breakdown.confidence = "high"
elif breakdown.total >= 4:
breakdown.mode = "task_with_planning"
breakdown.confidence = "medium"
else:
breakdown.mode = "task"
breakdown.confidence = "high"
# Check for explicit mode triggers
request_lower = request.lower()
if any(t in request_lower for t in BUILD_TRIGGERS):
if breakdown.mode != "build":
breakdown.mode = "build"
breakdown.confidence = "high"
breakdown.signals.append("Explicit build trigger detected")
elif any(t in request_lower for t in RESEARCH_TRIGGERS):
breakdown.mode = "research"
breakdown.confidence = "high"
breakdown.signals.append("Research trigger detected")
elif any(t in request_lower for t in PLAN_TRIGGERS):
breakdown.mode = "plan"
breakdown.confidence = "high"
breakdown.signals.append("Plan trigger detected")
return breakdown
def get_mode(request: str, repo_path: str = "/mnt/workdrive/rune") -> str:
"""Get the recommended mode for a request. Returns mode string."""
breakdown = score_request(request, repo_path)
return breakdown.mode
def get_score(request: str, repo_path: str = "/mnt/workdrive/rune") -> Dict[str, Any]:
"""Get detailed score breakdown. Returns dict."""
breakdown = score_request(request, repo_path)
return asdict(breakdown)
# ═══════════════════════════════════════════════════════════════════════════════
# CLI
# ═══════════════════════════════════════════════════════════════════════════════
def main():
if len(sys.argv) < 3:
print("Usage: complexity_scorer.py [score|mode] <request>")
sys.exit(1)
cmd = sys.argv[1]
request = " ".join(sys.argv[2:])
if cmd == "score":
result = get_score(request)
print(json.dumps(result, indent=2))
elif cmd == "mode":
mode = get_mode(request)
print(mode)
else:
print(f"Unknown command: {cmd}")
sys.exit(1)
if __name__ == "__main__":
main()
+12 -11
View File
@@ -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.73.0
Version: v0.74.0
Features: 41 (24 original + 17 new native commands)
Usage:
@@ -1885,7 +1885,7 @@ class RuneApp(App):
# Show version info
self.chat_channel.add_message(
"system",
f"[dim]Rune v0.73.0 | Textual TUI | {len(loaded)} native modules[/dim]",
f"[dim]Rune v0.74.0 | Textual TUI | {len(loaded)} native modules[/dim]",
)
# Auto-show night mode suggestion if evening/night hours
@@ -2128,20 +2128,21 @@ class RuneApp(App):
except Exception:
pass
# Task mode: auto-detect if build mode is needed
# Task mode: auto-detect if build mode is needed (T21.1 21.1E:
# complexity_scorer RETIRED — the canonical classify_mode owns
# construction-mode recommendation now (same classifier as every
# other route; the scorer's keyword heuristic was superseded).
# Kept proportional: a one-line hint, no separate 602-line module.
if channel == "task":
try:
from rune.complexity_scorer import score_request
from rune.construction_mode import classify_mode
breakdown = score_request(text)
if breakdown.total >= 8 and breakdown.mode == "build":
_mode = classify_mode(text)
if _mode.mode in ("PROJECT_BUILD", "EXISTING_PROJECT_CHANGE"):
ch.add_message(
"system",
f"[yellow]🔨 Build mode recommended (score: {breakdown.total})[/yellow]",
)
ch.add_message(
"system",
f"[yellow] Signals: {', '.join(breakdown.signals[:3])}[/yellow]",
f"[yellow]🔨 Build mode recommended "
f"(classified: {_mode.mode})[/yellow]",
)
ch.add_message(
"system",
+38
View File
@@ -256,6 +256,22 @@
"observed_at": "2026-09-16T01:31:05Z",
"tags": []
},
{
"evidence_refs": [
"structural-model"
],
"ext": {
"source": "src/rune/complexity_scorer.py"
},
"id": "component:complexity_scorer",
"identities": {
"name": "complexity_scorer"
},
"kind": "component",
"maturity": "DECLARED",
"observed_at": "2026-09-16T15:10:35Z",
"tags": []
},
{
"evidence_refs": [
"structural-model"
@@ -1670,6 +1686,17 @@
"to": "state_store:scaffold-store",
"type": "owns"
},
{
"authority": "model-author",
"evidence_refs": [
"21.1E-retirement"
],
"from": "component:construction_mode",
"observed_at": "2026-09-16T15:10:35Z",
"status": "active",
"to": "component:complexity_scorer",
"type": "supersedes"
},
{
"authority": "model-author",
"evidence_refs": [
@@ -2495,6 +2522,17 @@
"to": "subsystem:growth",
"type": "belongs_to"
},
{
"authority": "model-author",
"evidence_refs": [
"structural-model"
],
"from": "component:complexity_scorer",
"observed_at": "2026-09-16T15:10:35Z",
"status": "active",
"to": "project:rune",
"type": "belongs_to"
},
{
"authority": "model-author",
"evidence_refs": [
+188 -202
View File
File diff suppressed because it is too large. Load diff