project_memory.json

{
  "project": "FluidGateway",
  "stark_pipeline": "STARK-PRODUCTIONS",
  "current_slice": "v0.61-presentmon-operational-ledger",
  "key_decisions": [
    {
      "decision": "Build a runtime daemon dry-run loop over adapter event streams.",
      "rationale": "The project needs a persistent advisory loop before any native scheduler, game adapter, or process manager can safely exist."
    },
    {
      "decision": "Carry only RuntimeStateAccumulator across daemon cycles.",
      "rationale": "Each adapter replay should remain isolated while the accumulated runtime state becomes the durable memory between cycles."
    },
    {
      "decision": "Keep v0.46 advisory and deterministic.",
      "rationale": "FluidGateway still must not modify CPU scheduling, GPU queues, RAM, VRAM, drivers, games, or OS state."
    },
    {
      "decision": "Normalize --state paths before load and write.",
      "rationale": "Extensionless state paths must load the same JSON file they write, and invalid normalized state must fail before report/state writes."
    },
    {
      "decision": "Attach host capability evidence to daemon dry-run reports.",
      "rationale": "CPU thread count, RAM pressure, GPU presence, and reported VRAM are required context for any future manager that tries to reduce friction across CPU/GPU/RAM/VRAM."
    },
    {
      "decision": "Build daemon_decision_plan from host evidence and supervisor execution.",
      "rationale": "This creates the first host-aware manager intent layer while preserving the advisory-only boundary."
    },
    {
      "decision": "Build daemon_action_queue from daemon_decision_plan.",
      "rationale": "Backend-shaped queued actions make the future native boundary explicit: read-only telemetry can proceed, while scheduler, GPU, RAM, or VRAM mutation remains blocked until a native backend and safety review exist."
    },
    {
      "decision": "Build daemon_action_execution from daemon_action_queue.",
      "rationale": "The daemon now has a dry-run execution contract: read-only and advisory actions can be evaluated, while native or privileged CPU/GPU/RAM/VRAM actions are blocked before system mutation."
    },
    {
      "decision": "Build native_backend_preflight from daemon_action_queue and daemon_action_execution.",
      "rationale": "The future native manager needs explicit capability, privilege, and safety-review requirements before any CPU/GPU/RAM/VRAM control backend can be considered."
    },
    {
      "decision": "Build daemon_arbitration_plan from final runtime state, action execution, and native backend preflight.",
      "rationale": "The manager needs pressure-aware lane ordering across telemetry, memory, GPU, scheduler, and safety before a native backend can safely act."
    },
    {
      "decision": "Build daemon_control_plan from daemon_arbitration_plan and native_backend_preflight.",
      "rationale": "The gateway needs explicit control intents per telemetry, scheduler, safety, GPU, RAM, and VRAM surface before any native backend is allowed to mutate the host."
    },
    {
      "decision": "Build daemon_control_execution from daemon_control_plan.",
      "rationale": "The gateway needs dry-run execution outcomes per control surface so read-only/advisory control can proceed while native CPU/GPU/RAM/VRAM mutation remains blocked."
    },
    {
      "decision": "Build native_backend_manifest from daemon_control_execution.",
      "rationale": "The gateway needs an explicit backend load/hold manifest so future native CPU/GPU/RAM/VRAM work can be added behind a tested safety boundary instead of implied by control output."
    },
    {
      "decision": "Build native_backend_probe from native_backend_manifest.",
      "rationale": "The gateway needs a read-only evidence binding step before native backend work can safely claim CPU/RAM/GPU/VRAM observability or control readiness."
    },
    {
      "decision": "Build native_backend_readiness from native_backend_probe.",
      "rationale": "The gateway needs a conservative readiness and risk policy before any future native backend can claim it has enough CPU/GPU/RAM/VRAM evidence to progress."
    },
    {
      "decision": "Build native_backend_gate from native_backend_readiness.",
      "rationale": "The gateway needs an explicit promotion gate that advances safe read-only/advisory paths while blocking native CPU/GPU/RAM/VRAM control until a real backend and safety review exist."
    },
    {
      "decision": "Build presentmon_runtime ingest from advisory management actions.",
      "rationale": "The gateway needs real PresentMon diagnostics to feed the runtime adapter and daemon loop, otherwise the manager remains disconnected from measured frame-path waste."
    },
    {
      "decision": "Build presentmon_daemon runner from PresentMon ingest and runtime daemon.",
      "rationale": "The gateway needs a one-command measured-trace path into persistent manager decisions while preserving the generated adapter stream as replayable evidence."
    },
    {
      "decision": "Build presentmon operational ledger from daemon runner output.",
      "rationale": "The gateway needs a compact operational memory of each measured run: pressure, safe progress, native blockers, and next manager step."
    },
    {
      "decision": "Extract runtime client and adapter summaries from fluidgateway/cli.py.",
      "rationale": "The CLI should coordinate commands while presentation-only output belongs to a dedicated runtime summary module."
    }
  ],
  "handoffs": [
    {
      "from": "RESEARCHER",
      "to": "PLANNER",
      "summary": "Confirmed replay_adapter_event_stream plus RuntimeStateAccumulator is the smallest safe daemon loop integration."
    },
    {
      "from": "PLANNER",
      "to": "CODER",
      "summary": "Specified run-daemon CLI, required state path, path conflict rejection, event stream ordering, repeat semantics, and edge-case tests."
    },
    {
      "from": "CODER",
      "to": "REVIEWER",
      "summary": "Implemented daemon report dataclasses, CLI integration, docs, version bump, and daemon tests."
    },
    {
      "from": "REVIEWER",
      "to": "CODER",
      "summary": "Requested changes for extensionless --state load/write mismatch; CODER normalized state path and added regression tests."
    },
    {
      "from": "REVIEWER",
      "to": "META-ORCHESTRATOR",
      "summary": "Approved v0.46 after the normalization fix, daemon regression tests, full unittest, diff check, version check, and CLI smokes."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.47 host capability snapshot, integrated it into run-daemon reports, added host and daemon tests, and verified with unittest plus CLI smoke."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.48 daemon decision plan, integrated it into daemon reports and CLI output, added direct decision tests, and verified with unittest plus CLI smoke."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.49 daemon action queue, integrated it into daemon reports and CLI output, added action queue tests, and verified with unittest plus CLI smoke."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.50 daemon action execution dry-run, integrated it into daemon reports and CLI output, added action execution tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.51 native backend preflight, integrated it into daemon reports and CLI output, added backend preflight tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.52 daemon arbitration plan, integrated it into daemon reports and CLI output, added arbitration tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.53 daemon control plan, integrated it into daemon reports and CLI output, added control plan tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.54 daemon control execution dry-run, integrated it into daemon reports and CLI output, added control execution tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.55 native backend manifest, integrated it into daemon reports and CLI output, added manifest tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.56 native backend probe, integrated it into daemon reports and CLI output, added probe tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.57 native backend readiness, integrated it into daemon reports and CLI output, added readiness tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.58 native backend gate, integrated it into daemon reports and CLI output, added gate tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.59 PresentMon runtime ingest, added CLI bridge from CSV diagnostics to adapter JSONL, added daemon-consumption tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.60 PresentMon daemon runner, added direct CSV-to-daemon CLI flow, preserved generated events, added tests, and prepared verification gates."
    },
    {
      "from": "CODER",
      "to": "LOCAL VERIFICATION",
      "summary": "Implemented v0.61 PresentMon operational ledger, added ledger output to run-presentmon-daemon, added tests, and prepared verification gates."
    },
    {
      "from": "REVIEWER",
      "to": "CODER",
      "summary": "Reviewed the runtime CLI hotspot and extracted client/adapter terminal summaries without changing public commands or JSON contracts."
    }
  ],
  "open_issues": [
    "Native execution requires a future safety review before any process, driver, game, RAM, or VRAM mutation.",
    "A concrete native/control backend is still missing; v0.61 can summarize measured daemon runs into an operational ledger, but native/control backend promotion remains blocked."
  ],
  "resolved_issues": [
    "Added runtime daemon dry-run report with per-cycle transition and supervisor execution evidence.",
    "Added required --state path and rejected state/report path collisions.",
    "Fixed extensionless --state paths so load/write use the same normalized JSON file.",
    "Added daemon tests for chaining, iterations, CLI output/state, required state, path conflict, normalized state loading, and invalid normalized state failure.",
    "Added host capability snapshot with CPU, RAM, GPU, reported VRAM, host profile, telemetry confidence, and manager hint.",
    "Added daemon decision plan with telemetry, memory, GPU, scheduler, and safety advisory actions.",
    "Added daemon action queue with backend, dry-run status, native backend requirement, privilege requirement, expected signal, and safety boundary per queued action.",
    "Added daemon action execution with read-only/advisory dry-run results and native/privileged action blocking.",
    "Added native backend preflight with explicit backend capability requirements, privilege blockers, safety-review blockers, and native promotion held false.",
    "Added daemon arbitration plan with pressure-aware lane ranking across telemetry, memory, GPU, scheduler, and safety.",
    "Added daemon control plan with advisory control intents for telemetry, scheduler, safety, GPU, RAM, and VRAM surfaces.",
    "Added daemon control execution with read-only/advisory simulated outcomes and native control-surface blocking.",
    "Added native backend manifest with read-only/advisory ready entries and native RAM/VRAM backend load blockers.",
    "Added native backend probe with host snapshot signal binding and native RAM/VRAM probe blockers.",
    "Added native backend readiness with evidence scoring, risk classification, and native promotion held false.",
    "Added native backend gate with safe read-only/advisory advancement and native CPU/GPU/RAM/VRAM promotion blocked.",
    "Added PresentMon runtime ingest so diagnostic management actions can become daemon-consumable adapter JSONL events.",
    "Added PresentMon daemon runner so a measured CSV can generate replayable events, daemon report, and persisted state in one flow.",
    "Added PresentMon operational ledger with pressure score, safe progress, native blockers, and next-step recommendation.",
    "Reduced fluidgateway/cli.py from more than 1100 lines to about 640 by extracting runtime client and adapter terminal summaries."
  ],
  "constraints": [
    "Standard library only for runtime prototype code.",
    "Do not claim real performance gains without native integration and measurement.",
    "Keep JSON contracts explicit and test-covered.",
    "Preserve dry_run=true, would_modify_system=false, and execution_guard=advisory-only until a separate native safety boundary exists."
  ]
}