easy-coding-harness 0.1.4

package/templates/shared-hooks/easy_coding_status.py

@@ -0,0 +1,73 @@
+import json
+from pathlib import Path
+
+
+READY_LINE = (
+    "> **Easy Coding** · Ready · Use `ec-analysis` to start requirement analysis, "
+    "`ec-brainstorming` to brainstorm, or `ec-task-management` to view tasks"
+)
+WAITING_INIT_LINE = "> **Easy Coding** · Waiting init · Use `ec-init` to initialize"
+
+
+def load_json(path: Path) -> dict | None:
+    if not path.exists():
+        return None
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return None
+
+
+def load_task(root: Path, task_id: str | None) -> dict | None:
+    if not task_id:
+        return None
+    return load_json(root / ".easy-coding" / "tasks" / task_id / "task.json")
+
+
+def is_project_init_required(root: Path) -> bool:
+    project_init = load_json(root / ".easy-coding" / "tasks" / "project-init" / "task.json")
+    return bool(project_init and project_init.get("status") != "COMPLETE")
+
+
+def resolve_task_status(root: Path, state: dict, task_id: str | None) -> str:
+    task = load_task(root, task_id)
+    if task and task.get("status"):
+        return str(task["status"])
+    return str(state.get("current_stage") or "idle")
+
+
+def build_status_line(root: Path, state: dict, agent: str | None = None) -> str:
+    task_id = state.get("current_task")
+    if task_id:
+        status = resolve_task_status(root, state, str(task_id))
+        line = f"> **Easy Coding** · `{task_id}` · `{status}`"
+        last_agent = state.get("last_agent")
+        if agent and last_agent and last_agent != agent:
+            line += f" · Handoff -> `{last_agent}`"
+        return line
+
+    if is_project_init_required(root):
+        return WAITING_INIT_LINE
+
+    return READY_LINE
+
+
+def build_machine_breadcrumbs(root: Path, state: dict, agent: str | None = None) -> list[str]:
+    stage = state.get("current_stage") or "idle"
+    task_id = state.get("current_task")
+    lines = [f"[workflow-state:{stage}]"]
+
+    if task_id:
+        lines.append(f"[current-task:{task_id}]")
+        last_agent = state.get("last_agent")
+        if agent and last_agent and last_agent != agent:
+            lines.append(f"[easy-coding:handoff-from:{last_agent}]")
+
+    if is_project_init_required(root):
+        lines.append("[easy-coding:init-required]")
+
+    return lines
+
+
+def build_status_context(root: Path, state: dict, agent: str | None = None) -> str:
+    return "\n".join([build_status_line(root, state, agent), *build_machine_breadcrumbs(root, state, agent)])

package/templates/shared-hooks/inject-subagent-context.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+import json
+import os
+from pathlib import Path
+import sys
+
+
+def configure_stdio() -> None:
+    for stream in (sys.stdin, sys.stdout, sys.stderr):
+        if hasattr(stream, "reconfigure"):
+            stream.reconfigure(encoding="utf-8")
+
+
+def read_payload() -> dict:
+    try:
+        return json.loads(sys.stdin.read() or "{}")
+    except (json.JSONDecodeError, ValueError):
+        return {}
+
+
+def find_ec_root(start: Path) -> Path | None:
+    current = start.resolve()
+    while True:
+        if (current / ".easy-coding").is_dir():
+            return current
+        if current == current.parent:
+            return None
+        current = current.parent
+
+
+def load_json(path: Path) -> dict | None:
+    if not path.exists():
+        return None
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return None
+
+
+def emit(event_name: str, context: str) -> None:
+    print(
+        json.dumps(
+            {
+                "hookSpecificOutput": {
+                    "hookEventName": event_name,
+                    "additionalContext": context,
+                }
+            },
+            ensure_ascii=False,
+        )
+    )
+
+
+def main() -> int:
+    configure_stdio()
+    if os.environ.get("EC_HOOKS") == "0":
+        return 0
+
+    payload = read_payload()
+    root = find_ec_root(Path(payload.get("cwd") or os.getcwd()))
+    if root is None:
+        return 0
+
+    state = load_json(root / ".easy-coding" / "state.json") or {}
+    task_id = state.get("current_task")
+    context = [
+        "[easy-coding:subagent-guard]",
+        "Sub-agents must follow the task card, stay within the allowed file scope, and return structured results.",
+        "They must not claim completion or verification without fresh evidence.",
+    ]
+    if task_id:
+        context.append(f"Active Easy Coding task: {task_id}")
+
+    event_name = payload.get("hook_event_name") or payload.get("hookEventName") or "PreToolUse"
+    emit(event_name, "\n".join(context))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/templates/shared-hooks/inject-workflow-state.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+import json
+import os
+from pathlib import Path
+import sys
+
+from easy_coding_status import build_status_context
+
+
+def configure_stdio() -> None:
+    for stream in (sys.stdin, sys.stdout, sys.stderr):
+        if hasattr(stream, "reconfigure"):
+            stream.reconfigure(encoding="utf-8")
+
+
+def read_payload() -> dict:
+    try:
+        return json.loads(sys.stdin.read() or "{}")
+    except (json.JSONDecodeError, ValueError):
+        return {}
+
+
+def find_ec_root(start: Path) -> Path | None:
+    current = start.resolve()
+    while True:
+        if (current / ".easy-coding").is_dir():
+            return current
+        if current == current.parent:
+            return None
+        current = current.parent
+
+
+def load_state(root: Path) -> dict | None:
+    state_path = root / ".easy-coding" / "state.json"
+    if not state_path.exists():
+        return {"current_stage": "idle", "current_task": None}
+    try:
+        return json.loads(state_path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return None
+
+
+def detect_agent() -> str:
+    if os.environ.get("CLAUDE_PROJECT_DIR"):
+        return "claude-code"
+    if os.environ.get("QODER_PROJECT_DIR"):
+        return "qoder"
+    hook_path = Path(sys.argv[0]).as_posix()
+    if ".claude/" in hook_path:
+        return "claude-code"
+    if ".codex/" in hook_path:
+        return "codex"
+    if ".qoder/" in hook_path or ".qodercn/" in hook_path:
+        return "qoder"
+    return "unknown"
+
+
+def emit(event_name: str, context: str) -> None:
+    print(
+        json.dumps(
+            {
+                "hookSpecificOutput": {
+                    "hookEventName": event_name,
+                    "additionalContext": context,
+                }
+            },
+            ensure_ascii=False,
+        )
+    )
+
+
+def main() -> int:
+    configure_stdio()
+    if os.environ.get("EC_HOOKS") == "0":
+        return 0
+
+    payload = read_payload()
+    root = find_ec_root(Path(payload.get("cwd") or os.getcwd()))
+    if root is None:
+        return 0
+
+    state = load_state(root)
+    if state is None:
+        return 0
+
+    event_name = payload.get("hook_event_name") or payload.get("hookEventName") or "UserPromptSubmit"
+    emit(event_name, build_status_context(root, state, detect_agent()))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/templates/shared-hooks/session-start.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+import json
+import os
+from pathlib import Path
+import sys
+
+from easy_coding_status import build_status_context
+
+
+def configure_stdio() -> None:
+    for stream in (sys.stdin, sys.stdout, sys.stderr):
+        if hasattr(stream, "reconfigure"):
+            stream.reconfigure(encoding="utf-8")
+
+
+def read_payload() -> dict:
+    try:
+        return json.loads(sys.stdin.read() or "{}")
+    except (json.JSONDecodeError, ValueError):
+        return {}
+
+
+def find_ec_root(start: Path) -> Path | None:
+    current = start.resolve()
+    while True:
+        if (current / ".easy-coding").is_dir():
+            return current
+        if current == current.parent:
+            return None
+        current = current.parent
+
+
+def load_json(path: Path) -> dict | None:
+    if not path.exists():
+        return None
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return None
+
+
+def write_json(path: Path, data: dict) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+
+
+def detect_agent() -> str:
+    if os.environ.get("CLAUDE_PROJECT_DIR"):
+        return "claude-code"
+    if os.environ.get("QODER_PROJECT_DIR"):
+        return "qoder"
+    hook_path = Path(sys.argv[0]).as_posix()
+    if ".claude/" in hook_path:
+        return "claude-code"
+    if ".codex/" in hook_path:
+        return "codex"
+    if ".qoder/" in hook_path or ".qodercn/" in hook_path:
+        return "qoder"
+    return "unknown"
+
+
+def default_state(agent: str) -> dict:
+    return {
+        "current_stage": "idle",
+        "current_task": None,
+        "last_agent": agent,
+        "stage_history": [],
+        "confirmed_by_user": False,
+        "test_strategy_confirmed": False,
+        "repo_paths": {},
+    }
+
+
+def emit(event_name: str, context: str) -> None:
+    print(
+        json.dumps(
+            {
+                "hookSpecificOutput": {
+                    "hookEventName": event_name,
+                    "additionalContext": context,
+                }
+            },
+            ensure_ascii=False,
+        )
+    )
+
+
+def main() -> int:
+    configure_stdio()
+    if os.environ.get("EC_HOOKS") == "0":
+        return 0
+
+    payload = read_payload()
+    root = find_ec_root(Path(payload.get("cwd") or os.getcwd()))
+    if root is None:
+        return 0
+
+    agent = detect_agent()
+    event_name = payload.get("hook_event_name") or payload.get("hookEventName") or "SessionStart"
+    state_path = root / ".easy-coding" / "state.json"
+    state = load_json(state_path)
+    if state is None:
+        state = default_state(agent)
+        write_json(state_path, state)
+
+    emit(event_name, build_status_context(root, state, agent))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())