Files
CASAN/packages/casan-harness/scripts/bash/dashboard-server.py
T
thanhnvandClaude Opus 4.8 36a4812ef3 refactor(structure): promote app to repo root + remove redundant workspace cruft
Standard production layout: the OKR app (was nested under AINative_OKR_CASAN5/) is now
the repository root. No more wrapper directory.

- Promote AINative_OKR_CASAN5/* -> repo root (backend/ frontend/ packages/ apps/
  .specify/ docs/ infra/ nginx/ scripts/ + configs). Merge tool dirs: .gitea (kept the
  active deploy ci.yml, added harness-ci.yml + runbooks), .claude (agents/commands +
  launch.json), .github moved up.
- Remove redundant: 00_SUBMISSION_PACKAGE, scattered root notes (FPT_CASAN_Full.md,
  tu-tuong-casan.md, casan-tu-sinh..., casan_harness_assessment.md, source-review...,
  README_CASAN5_REFINED.md), casan-next-plans/ and optimize-docs/ (competition/planning
  artifacts — roadmap + design history preserved in git log / commit messages).
- Update all references to the old layout:
  - .gitea/workflows/{ci,harness-ci}.yml, .github/workflows/{ci,deploy}.yml:
    working-directory .; drop AINative_OKR_CASAN5/ prefix; .specify/{tests,scripts}
    -> packages/casan-harness/... (.specify/logs state kept)
  - .claude/launch.json, .gitea/*-runbook.md: path prefixes
  - CLAUDE.md, README.md: docs/input -> apps/okr/domain/input
  - policy-bundle.yaml: 8 policy paths -> packages/casan-harness/...; manifest re-signed
- secrets-scan.sh: fixture excludes -> new package/domain paths.

Full gate from the new root: PASS=64 FAIL=0 SKIP=3.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-08 13:26:36 +09:00

98 lines
3.8 KiB
Python

#!/usr/bin/env python3
"""CASAN H6 — hosted AgentOps dashboard server (D3).
Serves the generated dashboard over HTTP with a stale-aware /healthz probe so
an external monitor (uptime check / load-balancer) can page when telemetry
stops flowing — not just when the process dies.
Routes:
GET / -> dashboard HTML (also /dashboard)
GET /healthz -> 200 {"status":"ok",...} while metrics are fresh,
503 {"status":"stale",...} when metrics are older than
CASAN_DASHBOARD_STALE_S (default 3600s) or missing.
Usage: dashboard-server.py <port>
"""
import json
import os
import pathlib
import sys
import time
from http.server import BaseHTTPRequestHandler, HTTPServer
def _app_root(start):
# Plan-01: `.resolve()` follows the compat symlink into packages/casan-harness;
# dashboards + runtime logs live at the app's `.specify`, so walk UP for it.
d = pathlib.Path(start).resolve()
for p in (d, *d.parents):
if (p / ".specify").is_dir():
return p
return d.parents[3]
ROOT = _app_root(__file__)
PORT = int(sys.argv[1]) if len(sys.argv) > 1 else 8787
DASH = pathlib.Path(os.environ.get(
"CASAN_DASHBOARD_HTML", ROOT / "docs" / "output" / "casan" / "central-agentops-dashboard.html"))
METRICS = pathlib.Path(os.environ.get(
"CASAN_DASHBOARD_METRICS", ROOT / ".specify" / "logs" / "cost" / "metrics.jsonl"))
ALERTS = pathlib.Path(os.environ.get(
"CASAN_DASHBOARD_ALERTS", ROOT / ".specify" / "agentops" / "alerts.log"))
STALE_S = int(os.environ.get("CASAN_DASHBOARD_STALE_S", "3600"))
def count_lines(path: pathlib.Path) -> int:
if not path.exists():
return 0
return sum(1 for line in path.read_text(encoding="utf-8").splitlines() if line.strip())
class Handler(BaseHTTPRequestHandler):
def _send(self, code: int, ctype: str, body: str) -> None:
data = body.encode("utf-8")
self.send_response(code)
self.send_header("Content-Type", ctype)
self.send_header("Content-Length", str(len(data)))
self.end_headers()
self.wfile.write(data)
def do_GET(self): # noqa: N802 (http.server API)
if self.path == "/healthz":
if METRICS.exists():
age = int(time.time() - METRICS.stat().st_mtime)
stale = age > STALE_S
else:
age = -1
stale = True
body = json.dumps({
"status": "stale" if stale else "ok",
"metrics_age_s": age,
"stale_after_s": STALE_S,
"runs": count_lines(METRICS),
"alerts": count_lines(ALERTS),
})
self._send(503 if stale else 200, "application/json", body)
elif self.path in ("/", "/dashboard"):
if DASH.exists():
self._send(200, "text/html; charset=utf-8", DASH.read_text(encoding="utf-8"))
else:
self._send(404, "text/plain", "dashboard not generated")
else:
self._send(404, "text/plain", "not found")
def log_message(self, *args): # silence per-request stderr noise
pass
BIND = os.environ.get("CASAN_DASHBOARD_BIND", "127.0.0.1")
if __name__ == "__main__":
# SEC-13 (M-09): the dashboard has no auth, so binding to all interfaces exposes
# it to the network. In enforced mode refuse a non-loopback bind (fail-closed);
# a real deployment must front it with TLS + auth (Plan-07 TIER 2), not 0.0.0.0.
_enforced = os.environ.get("CASAN_PROFILE") == "prod" or os.environ.get("CASAN_DASHBOARD_STRICT") == "1"
if _enforced and BIND not in ("127.0.0.1", "::1", "localhost"):
sys.stderr.write(f"DASHBOARD_BIND_REFUSED bind={BIND} (loopback only in enforced mode)\n")
raise SystemExit(1)
HTTPServer((BIND, PORT), Handler).serve_forever()