hoatv2211/GameStudio-CodexKIT / skills/studio-goal-progress
studio-goal-progress
VerifiedUse when a KIT-managed Codex or Hermes Goal needs evidence-backed percentage, ETA range, live read-only progress views, or portable append-only progress recovery.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.3 KB |
| agents/openai.yaml | config | 313 B |
| assets/app.js | script | 13.4 KB |
| assets/index.html | other | 6.4 KB |
| assets/styles.css | other | 9.0 KB |
| references/commands.md | markdown | 5.5 KB |
| schemas/studio-goal-event.schema.json | config | 25.5 KB |
| schemas/studio-goal-manifest.schema.json | config | 5.2 KB |
| schemas/studio-goal-state.schema.json | config | 13.2 KB |
| scripts/goal_progress.py | script | 22.1 KB |
| scripts/goal_progress_app_server.py | script | 5.6 KB |
| scripts/goal_progress_core.py | script | 52.0 KB |
| scripts/goal_progress_server.py | script | 110.9 KB |
| scripts/goal_progress_store.py | script | 26.1 KB |
scripts/goal_progress_app_server.py
View on GitHub# Generated by scripts/sync_skill_resources.py. Do not edit manually.
from __future__ import annotations
import json
from collections.abc import Iterable, Mapping
SUPPORTED_METHODS = frozenset(
{
"thread/started",
"thread/status/changed",
"turn/started",
"turn/completed",
"turn/plan/updated",
"item/started",
"item/completed",
"thread/tokenUsage/updated",
"warning",
"configWarning",
}
)
_METHOD_REQUIRED_FIELDS = {
"thread/started": frozenset({"thread"}),
"thread/status/changed": frozenset({"threadId", "status"}),
"turn/started": frozenset({"threadId", "turn"}),
"turn/completed": frozenset({"threadId", "turn"}),
"turn/plan/updated": frozenset({"threadId", "turnId", "plan"}),
"item/started": frozenset({"threadId", "turnId", "startedAtMs", "item"}),
"item/completed": frozenset({"threadId", "turnId", "completedAtMs", "item"}),
"thread/tokenUsage/updated": frozenset({"threadId", "turnId", "tokenUsage"}),
"warning": frozenset({"message"}),
"configWarning": frozenset({"summary"}),
}
_METHOD_OPTIONAL_FIELDS = {
"turn/plan/updated": frozenset({"explanation"}),
"warning": frozenset({"threadId"}),
"configWarning": frozenset({"details", "path", "range"}),
}
_TRANSPORT_FIELDS = frozenset({"kind", "id", "initialized"})
_TRANSPORT_KIND = "codex_app_server"
def build_initialize_request(request_id: int, client_version: str) -> dict[str, object]:
return {
"jsonrpc": "2.0",
"id": request_id,
"method": "initialize",
"params": {
"clientInfo": {
"name": "gamestudio_codexkit",
"title": "GameStudio-CodexKIT Goal Progress",
"version": client_version,
},
"capabilities": {},
},
}
def build_initialized_notification() -> dict[str, object]:
return {"jsonrpc": "2.0", "method": "initialized", "params": {}}
def normalize_notification(
message: Mapping[str, object], binding: Mapping[str, object]
) -> list[dict[str, object]]:
"""Return sanitized observations; App Server events never change workflow state."""
if not _has_initialized_transport(binding) or _message_problem(message) is not None:
return []
method = str(message["method"])
return [
{
"source": "codex_app_server",
"informational": True,
"authority": None,
"event_type": "runtime.heartbeat",
"summary": f"Codex App Server observed {method}.",
"payload": {"method": method, "informational": True},
}
]
def consume_notifications(
lines: Iterable[str], binding: Mapping[str, object], *, runtime_version: str
) -> tuple[list[dict[str, object]], dict[str, object]]:
if not _has_initialized_transport(binding):
return [], {
"status": "BLOCKED",
"reason": "desktop_transport_unavailable",
"portable_progress_available": True,
}
candidates: list[dict[str, object]] = []
recognized_methods: list[str] = []
for line in lines:
try:
message = json.loads(line)
except (TypeError, json.JSONDecodeError):
return candidates, _blocked_status(
"invalid_app_server_message", runtime_version, recognized_methods
)
if not isinstance(message, dict):
return candidates, _blocked_status(
"invalid_app_server_message", runtime_version, recognized_methods
)
problem = _message_problem(message)
if problem is not None:
return candidates, _blocked_status(problem, runtime_version, recognized_methods)
method = str(message["method"])
recognized_methods.append(method)
candidates.extend(normalize_notification(message, binding))
return candidates, {
"status": "READY",
"runtime_version": runtime_version,
"recognized_methods": recognized_methods,
"portable_progress_available": True,
}
def _has_initialized_transport(binding: Mapping[str, object]) -> bool:
"""Accept only {kind: codex_app_server, id: nonblank, initialized: true}."""
transport = binding.get("transport")
if not isinstance(transport, Mapping) or frozenset(transport) != _TRANSPORT_FIELDS:
return False
transport_id = transport.get("id")
return (
transport.get("kind") == _TRANSPORT_KIND
and isinstance(transport_id, str)
and bool(transport_id.strip())
and transport.get("initialized") is True
)
def _message_problem(message: Mapping[str, object]) -> str | None:
if message.get("jsonrpc") != "2.0" or "id" in message:
return "invalid_app_server_message"
method = message.get("method")
if not isinstance(method, str) or method not in SUPPORTED_METHODS:
return "unsupported_app_server_message"
params = message.get("params")
if not isinstance(params, dict):
return "unsupported_app_server_message"
required = _METHOD_REQUIRED_FIELDS[method]
allowed = required | _METHOD_OPTIONAL_FIELDS.get(method, frozenset())
if not required.issubset(params) or not frozenset(params).issubset(allowed):
return "unsupported_app_server_message"
return None
def _blocked_status(
reason: str, runtime_version: str, recognized_methods: list[str]
) -> dict[str, object]:
return {
"status": "BLOCKED",
"reason": reason,
"runtime_version": runtime_version,
"recognized_methods": recognized_methods,
"portable_progress_available": True,
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |