173 lines
6.9 KiB
Python
173 lines
6.9 KiB
Python
"""Install the quality investigation context into the existing local nao runtime.
|
|
|
|
Uses upstream nao extension points: project rules, system prompt, model settings,
|
|
and a stdio MCP. The packaged engine, source workbooks and business DB stay intact.
|
|
"""
|
|
import argparse
|
|
import ast
|
|
import hashlib
|
|
import json
|
|
import os
|
|
import signal
|
|
import shutil
|
|
import socket
|
|
import subprocess
|
|
import sys
|
|
import time
|
|
from datetime import datetime
|
|
from pathlib import Path
|
|
from urllib.request import urlopen
|
|
|
|
import nao_trial
|
|
|
|
ROOT = Path(__file__).resolve().parents[1]
|
|
TEMPLATES = ROOT / "ai/nao-quality"
|
|
ACTIVE = nao_trial.PROJECT
|
|
STATE = nao_trial.TRIAL / "quality-context.json"
|
|
OUT = ROOT / "output/nao-quality"
|
|
|
|
|
|
def _digest(path):
|
|
return hashlib.sha256(path.read_bytes()).hexdigest()
|
|
|
|
|
|
def configure():
|
|
for name in ("nao_quality_tools.py", "nao_quality_mcp.py"):
|
|
path = ROOT / "scripts" / name
|
|
ast.parse(path.read_text())
|
|
_, _, model = nao_trial.model_settings()
|
|
stamp = datetime.now().astimezone().strftime("%Y%m%d-%H%M%S-%f")
|
|
backup = nao_trial.TRIAL / "context-backups" / stamp
|
|
backup.mkdir(parents=True, mode=0o700)
|
|
ACTIVE.mkdir(parents=True, exist_ok=True)
|
|
files = ["RULES.md", "nao_config.yaml", "agent/prompts/system.md", "agent/mcps/mcp.json"]
|
|
for relative in files:
|
|
old = ACTIVE / relative
|
|
if old.exists():
|
|
target = backup / relative
|
|
target.parent.mkdir(parents=True, exist_ok=True)
|
|
shutil.copy2(old, target)
|
|
# Old baseline warehouse context is preserved outside the active project.
|
|
# Deep investigation uses the live, version-bound quality API MCP instead.
|
|
old_databases = ACTIVE / "databases"
|
|
if old_databases.exists():
|
|
shutil.move(str(old_databases), str(backup / "databases"))
|
|
# Upstream deliberately reuses discovered specs across restarts. Move only
|
|
# our generated server directory aside so startup discovers the live schema.
|
|
old_quality_specs = ACTIVE / "agent/mcps/quality"
|
|
if old_quality_specs.exists():
|
|
target = backup / "agent/mcps/quality"
|
|
target.parent.mkdir(parents=True, exist_ok=True)
|
|
shutil.move(str(old_quality_specs), str(target))
|
|
for relative in ("RULES.md", "agent/prompts/system.md"):
|
|
target = ACTIVE / relative
|
|
target.parent.mkdir(parents=True, exist_ok=True)
|
|
shutil.copy2(TEMPLATES / relative, target)
|
|
(ACTIVE / "nao_config.yaml").write_text(
|
|
"project_name: quality-investigation\n"
|
|
"databases: []\n"
|
|
"llm:\n"
|
|
f" annotation_model: openaiCompatible:{model}\n"
|
|
" providers:\n"
|
|
" - provider: openaiCompatible\n"
|
|
" api_key: \"{{ env('NAO_MODEL_KEY') }}\"\n"
|
|
" base_url: \"{{ env('NAO_MODEL_BASE') }}\"\n"
|
|
" models:\n"
|
|
f" - id: {json.dumps(model)}\n"
|
|
" default: true\n"
|
|
" settings:\n"
|
|
" maxOutputTokens: 8192\n"
|
|
" temperature: 0.2\n"
|
|
" reasoningEffort: low\n"
|
|
)
|
|
old_mcp = backup / "agent/mcps/mcp.json"
|
|
mcps = json.loads(old_mcp.read_text()) if old_mcp.exists() else {"mcpServers": {}}
|
|
mcps.setdefault("mcpServers", {})["quality"] = {
|
|
"transport": "stdio",
|
|
"command": sys.executable,
|
|
"args": [str(ROOT / "scripts/nao_quality_mcp.py")],
|
|
}
|
|
mcp_path = ACTIVE / "agent/mcps/mcp.json"
|
|
mcp_path.parent.mkdir(parents=True, exist_ok=True)
|
|
mcp_path.write_text(json.dumps(mcps, ensure_ascii=False, indent=2))
|
|
mcp_path.chmod(0o600)
|
|
state = {
|
|
"mode": "QUALITY_API_MCP",
|
|
"model": model,
|
|
"backup": str(backup),
|
|
"configuredAt": datetime.now().astimezone().isoformat(),
|
|
"sourceHashes": {relative: _digest(TEMPLATES / relative)
|
|
for relative in ("RULES.md", "agent/prompts/system.md")},
|
|
"upstreamCoreModified": False,
|
|
"qualityApi": "http://127.0.0.1:5281",
|
|
"naoUi": "http://127.0.0.1:5674",
|
|
"accessBoundary": "Local maintenance-account project only, not a shared multi-user integration",
|
|
}
|
|
STATE.write_text(json.dumps(state, ensure_ascii=False, indent=2))
|
|
STATE.chmod(0o600)
|
|
OUT.mkdir(parents=True, exist_ok=True)
|
|
(OUT / "environment.json").write_text(json.dumps(state, ensure_ascii=False, indent=2))
|
|
print("Quality investigation context installed; prior context backed up")
|
|
|
|
|
|
def stop():
|
|
state_path = nao_trial.TRIAL / "pids.json"
|
|
previous = json.loads(state_path.read_text()) if state_path.exists() else {}
|
|
nao_trial.stop()
|
|
deadline = time.monotonic() + 8
|
|
while time.monotonic() < deadline:
|
|
alive = []
|
|
for pid in previous.values():
|
|
result = subprocess.run(["ps", "-p", str(pid), "-o", "stat="], capture_output=True, text=True)
|
|
if result.returncode == 0 and not result.stdout.strip().startswith("Z"):
|
|
alive.append(pid)
|
|
if not alive:
|
|
return
|
|
time.sleep(0.1)
|
|
for pid in alive:
|
|
result = subprocess.run(["ps", "-p", str(pid), "-o", "args="], capture_output=True, text=True)
|
|
if result.returncode:
|
|
continue
|
|
if str(nao_trial.TRIAL) not in result.stdout or os.getpgid(pid) != pid:
|
|
raise RuntimeError("Local nao process identity changed; force stop refused")
|
|
os.killpg(pid, signal.SIGKILL)
|
|
print("Stopped verified local nao process groups after graceful shutdown timeout")
|
|
|
|
|
|
def activate():
|
|
# Validate first so a missing adapter never takes the working trial offline.
|
|
for name in ("nao_quality_tools.py", "nao_quality_mcp.py"):
|
|
ast.parse((ROOT / "scripts" / name).read_text())
|
|
stop()
|
|
deadline = time.monotonic() + 15
|
|
for port in (5674, 5675):
|
|
while True:
|
|
with socket.socket() as connection:
|
|
connection.settimeout(0.3)
|
|
occupied = connection.connect_ex(("127.0.0.1", port)) == 0
|
|
if not occupied:
|
|
break
|
|
if time.monotonic() > deadline:
|
|
raise RuntimeError(f"Prior local nao port {port} is still occupied; restart was not attempted")
|
|
time.sleep(0.15)
|
|
configure()
|
|
nao_trial.start()
|
|
deadline = time.monotonic() + 30
|
|
while time.monotonic() < deadline:
|
|
try:
|
|
with urlopen("http://127.0.0.1:5674", timeout=2) as response:
|
|
if response.status == 200:
|
|
print("Quality investigation ready at http://127.0.0.1:5674")
|
|
return
|
|
except OSError:
|
|
time.sleep(0.3)
|
|
raise RuntimeError("nao did not become ready; preserved backup is recorded in quality-context.json")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
parser = argparse.ArgumentParser()
|
|
parser.add_argument("action", choices=("configure", "activate", "start", "stop"))
|
|
args = parser.parse_args()
|
|
{"configure": configure, "activate": activate, "start": nao_trial.start,
|
|
"stop": stop}[args.action]()
|