forgeo-cli 0.3.0__py3-none-any.whl

forgeo/runs.py

@@ -0,0 +1,73 @@
+"""Durable run history: one JSON line per finished cycle in ``runs.jsonl``.
+
+The file lives next to the backlog (``runs.jsonl`` beside ``backlog.json``)
+so Forgeo, the CLI, and the web API all read the same records. Reading
+tolerates a missing file and skips corrupt lines with a warning, so a broken
+``runs.jsonl`` never breaks a cycle or the API.
+"""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from pydantic import ValidationError
+
+from forgeo.models import RunRecord
+
+logger = logging.getLogger(__name__)
+
+
+def runs_path_for(backlog_path: str | Path) -> Path:
+    """The ``runs.jsonl`` path that sits next to the backlog file."""
+    return Path(backlog_path).with_name("runs.jsonl")
+
+
+class RunRecorder:
+    """Appends :class:`RunRecord` rows to a JSON-lines file and reads them back."""
+
+    def __init__(self, path: str | Path) -> None:
+        self.path = Path(path)
+
+    def append(self, record: RunRecord) -> None:
+        """Append ``record`` as one JSON line.
+
+        A write failure is logged and never raised, so recording can never
+        break a Forgeo cycle.
+        """
+        try:
+            self.path.parent.mkdir(parents=True, exist_ok=True)
+            with self.path.open("a", encoding="utf-8") as handle:
+                handle.write(record.model_dump_json() + "\n")
+        except OSError as exc:
+            logger.error("Could not write run record to %s: %s", self.path, exc)
+
+    def read(self, limit: int | None = None) -> list[RunRecord]:
+        """Return the newest ``limit`` records, newest first.
+
+        A missing file yields an empty list; corrupt lines are skipped with a
+        warning. ``limit=None`` returns every readable record.
+        """
+        try:
+            text = self.path.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            return []
+        records: list[RunRecord] = []
+        for line_no, line in enumerate(text.splitlines(), start=1):
+            if not line.strip():
+                continue
+            try:
+                records.append(RunRecord.model_validate_json(line))
+            except ValidationError:
+                logger.warning(
+                    "Skipping corrupt run record in %s on line %s", self.path, line_no
+                )
+        records.sort(key=lambda record: record.finished_at, reverse=True)
+        if limit is None:
+            return records
+        return records[: max(0, limit)]
+
+    def read_last(self) -> RunRecord | None:
+        """Return the most recent record, or ``None`` when none exists."""
+        records = self.read(limit=1)
+        return records[0] if records else None

forgeo/setup.py

@@ -0,0 +1,185 @@
+"""Guided first-time setup: ``forgeo init``.
+
+Walks the user through the three decisions Forgeo needs before it can
+work on a repository:
+
+1. Forgeo folder — where the backlog, ``BLOCKER.md`` and the log live
+   (inside the project, gitignored by default);
+2. the coding agent command — any shell command that reads ``$FORGEO_TASK``
+   and works in the repository (e.g. ``claude -p "$FORGEO_TASK"``);
+3. the refactoring prompt — the default is offered; a custom one can be
+   pasted instead.
+
+The result is written as ``forgeo.yaml`` next to the project.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from pathlib import Path
+
+import yaml
+from rich.console import Console
+from rich.markup import escape
+from rich.panel import Panel
+from rich.prompt import Confirm, Prompt
+
+from forgeo.models import DEFAULT_REFACTOR_PROMPT
+
+DEFAULT_FORGEO_DIR = ".forgeo"
+DEFAULT_AGENT_COMMAND = 'aider --message "$FORGEO_TASK"'
+
+SetupInput = Callable[[str], str]
+
+
+def _ask_text(input_fn: SetupInput | None, prompt: str, default: str | None = None) -> str:
+    """Free-text question; ``input_fn`` replaces the terminal in tests."""
+    if input_fn is not None:
+        return input_fn(prompt)
+    if default is None:
+        return Prompt.ask(prompt)
+    return Prompt.ask(prompt, default=default)
+
+
+def _ask_yes_no(input_fn: SetupInput | None, prompt: str, default: bool = True) -> bool:
+    """Yes/no question; ``input_fn`` replaces the terminal in tests."""
+    if input_fn is not None:
+        return input_fn(prompt).strip().lower() in ("y", "yes")
+    return Confirm.ask(prompt, default=default)
+
+
+def _ask_multiline(input_fn: SetupInput | None, prompt: str, console: Console) -> str:
+    """Multi-line answer; an empty line finishes it."""
+    if input_fn is None:
+        console.print(prompt)
+        prompt = "[dim](paste a line; an empty line finishes)[/dim]"
+    lines = []
+    while True:
+        line = input_fn(prompt) if input_fn is not None else Prompt.ask(prompt)
+        if not line.strip():
+            break
+        lines.append(line.strip())
+    return "\n".join(lines)
+
+
+def add_gitignore(project_root: Path, line: str) -> bool:
+    """Append ``line`` to ``<project_root>/.gitignore`` when absent."""
+    path = project_root / ".gitignore"
+    if path.exists():
+        content = path.read_text(encoding="utf-8")
+        if line in content.splitlines():
+            return False
+        content = content.rstrip("\n") + "\n" + line + "\n"
+    else:
+        content = line + "\n"
+    path.write_text(content, encoding="utf-8")
+    return True
+
+
+def run_setup(
+    base_dir: Path,
+    config_path: Path,
+    *,
+    console: Console | None = None,
+    input_fn: SetupInput | None = None,
+) -> dict[str, object] | None:
+    """Interactively collect the configuration and write it to ``config_path``.
+
+    Args:
+        base_dir: Directory the config lives in (the project root); all
+            generated paths are relative to it.
+        config_path: Where to write the YAML config.
+        console: Rich console for output (a new one when omitted).
+        input_fn: Replacement for the terminal prompts (tests).
+
+    Returns the written YAML payload, or ``None`` when the setup was aborted.
+    """
+    out = console or Console()
+    root = base_dir.resolve()
+    if not (root / ".git").exists():
+        out.print(
+            "[yellow]Warning: no .git directory here — Forgeo works on a git "
+            "repository.[/yellow]"
+        )
+
+    forgeo_dir = _ask_text(
+        input_fn,
+        f"[bold]Forgeo folder[/bold] for backlog, BLOCKER.md and logs "
+        f"[default {DEFAULT_FORGEO_DIR}]",
+        default=DEFAULT_FORGEO_DIR,
+    ).strip()
+    forgeo_dir = forgeo_dir.removeprefix("./").rstrip("/") or DEFAULT_FORGEO_DIR
+    if Path(forgeo_dir).is_absolute():
+        out.print("[red]Forgeo folder must live inside the project. Aborting.[/red]")
+        return None
+    if ".." in Path(forgeo_dir).parts:
+        out.print(
+            "[yellow]Note: Forgeo folder escapes the project root — the "
+            "gitignore rule will not protect it.[/yellow]"
+        )
+
+    command = _ask_text(
+        input_fn,
+        f"[bold]Coding agent command[/bold] [default {DEFAULT_AGENT_COMMAND}]",
+        default=DEFAULT_AGENT_COMMAND,
+    ).strip() or DEFAULT_AGENT_COMMAND
+    if "$FORGEO_TASK" not in command:
+        out.print(
+            "[yellow]Note: the command never references $FORGEO_TASK, so the "
+            "agent will not receive the task text.[/yellow]"
+        )
+
+    if _ask_yes_no(input_fn, "[bold]Use the default refactor prompt?[/bold]", default=True):
+        refactor_prompt = DEFAULT_REFACTOR_PROMPT
+    else:
+        out.print("[bold]Your refactor prompt[/bold] (used when the backlog is empty):")
+        refactor_prompt = (
+            _ask_multiline(input_fn, "[dim](paste a line; empty line finishes)[/dim]", out)
+            or DEFAULT_REFACTOR_PROMPT
+        )
+
+    if _ask_yes_no(
+        input_fn,
+        f"[bold]Add '{escape(forgeo_dir)}/' to .gitignore?[/bold]",
+        default=True,
+    ):
+        if add_gitignore(root, forgeo_dir + "/"):
+            out.print(f"[green]Added {forgeo_dir}/ to .gitignore.[/green]")
+        else:
+            out.print(f"[dim]{forgeo_dir}/ already in .gitignore.[/dim]")
+
+    payload = {
+        "name": root.name or "my-forgeo",
+        "repo": ".",
+        "interval_minutes": 60,
+        "branch": "main",
+        "backlog": f"{forgeo_dir}/backlog.json",
+        "blocker_file": f"{forgeo_dir}/BLOCKER.md",
+        "agent_command": command,
+        "refactor_prompt": refactor_prompt,
+        "log_file": f"{forgeo_dir}/forgeo.log",
+    }
+
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    body = yaml.safe_dump(payload, sort_keys=False, allow_unicode=True)
+    config_path.write_text(
+        "# Forgeo configuration — generated by `forgeo init`.\n"
+        "# Relative paths resolve against this file's directory.\n"
+        "# Re-run `forgeo init --force` to regenerate. See README.md for all keys.\n\n"
+        + body,
+        encoding="utf-8",
+    )
+    (root / forgeo_dir).mkdir(parents=True, exist_ok=True)
+
+    out.print(
+        Panel.fit(
+            f"[bold]Forgeo configured[/bold] in {config_path}\n"
+            f"[bold]Repo:[/bold] {root}\n"
+            f"[bold]Backlog:[/bold] {(root / forgeo_dir) / 'backlog.json'}\n"
+            f"[bold]Agent:[/bold] {escape(command)}\n"
+            f"[bold]Next:[/bold] forgeo start --config {config_path.name}",
+            title="Forgeo",
+            border_style="green",
+        )
+    )
+    return payload

forgeo/web/central/central.css

@@ -0,0 +1,380 @@
+/* Extra component styles for the central dashboard (home + instance pages).
+   The dark theme, board, status columns and task cards come from style.css. */
+
+/* ---------- Instance list (home) ---------- */
+
+.instance-list {
+  flex: 1;
+  padding: 32px 0 40px;
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+.instance-card {
+  display: block;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 16px 18px;
+  color: var(--text);
+  text-decoration: none;
+  transition: transform 0.15s ease, border-color 0.18s ease, background 0.18s ease;
+}
+
+.instance-card:hover {
+  transform: translateY(-1px);
+  background: var(--surface-hover);
+  border-color: var(--border-strong);
+}
+
+.instance-card__head {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 10px;
+  margin-bottom: 12px;
+}
+
+.instance-card__name {
+  font-size: 16px;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+}
+
+.instance-card__grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 14px;
+}
+
+.instance-card__info {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-width: 0;
+}
+
+.instance-card__label {
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.09em;
+  color: var(--text-faint);
+}
+
+.instance-card__value {
+  font-size: 13px;
+  color: var(--text-muted);
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.instance-card__counts {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.count-chip {
+  font-size: 11px;
+  font-weight: 600;
+  letter-spacing: 0.06em;
+  padding: 3px 9px;
+  border-radius: 999px;
+  border: 1px solid var(--border);
+  color: var(--text-muted);
+  font-variant-numeric: tabular-nums;
+}
+
+.count-chip--OPEN {
+  color: var(--open);
+  background: rgba(143, 183, 255, 0.1);
+  border-color: transparent;
+}
+.count-chip--BLOCKED {
+  color: var(--blocked);
+  background: rgba(240, 168, 77, 0.16);
+  border-color: transparent;
+}
+.count-chip--COMPLETED {
+  color: var(--completed);
+  background: rgba(111, 206, 147, 0.1);
+  border-color: transparent;
+}
+.count-chip--FAILED {
+  color: var(--failed);
+  background: rgba(224, 108, 117, 0.1);
+  border-color: transparent;
+}
+
+/* ---------- Daemon badge (instance page header) ---------- */
+
+.daemon-badge {
+  font-size: 11px;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  padding: 3px 9px;
+  border-radius: 999px;
+  white-space: nowrap;
+  color: var(--text-muted);
+  border: 1px solid var(--border);
+}
+
+.daemon-badge--running {
+  color: var(--completed);
+  background: rgba(111, 206, 147, 0.1);
+  border-color: rgba(111, 206, 147, 0.35);
+}
+
+.daemon-badge--stopped {
+  color: var(--failed);
+  background: rgba(224, 108, 117, 0.1);
+  border-color: rgba(224, 108, 117, 0.35);
+}
+
+/* ---------- Tabs ---------- */
+
+.tabs {
+  display: flex;
+  gap: 6px;
+  padding: 14px 0 0;
+  border-bottom: 1px solid var(--border);
+  overflow-x: auto;
+}
+
+.tab {
+  appearance: none;
+  background: none;
+  border: none;
+  border-bottom: 2px solid transparent;
+  color: var(--text-muted);
+  font: inherit;
+  font-size: 13px;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  padding: 10px 14px 12px;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: color 0.15s ease, border-color 0.15s ease;
+}
+
+.tab:hover {
+  color: var(--text);
+}
+
+.tab.is-active {
+  color: var(--text);
+  border-bottom-color: var(--accent);
+}
+
+.tab-panel {
+  flex: 1;
+  padding: 20px 0 40px;
+}
+
+.tab-panel[hidden] {
+  display: none;
+}
+
+/* ---------- Code panels (logs / blocker / config) ---------- */
+
+.code-panel {
+  margin: 0;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 16px 18px;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 12.5px;
+  line-height: 1.6;
+  color: var(--text-muted);
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 70vh;
+  overflow: auto;
+}
+
+/* ---------- Run table ---------- */
+
+.table-wrap {
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow: auto;
+}
+
+.run-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 13px;
+}
+
+.run-table th,
+.run-table td {
+  text-align: left;
+  padding: 10px 14px;
+  border-bottom: 1px solid var(--border);
+  white-space: nowrap;
+  font-variant-numeric: tabular-nums;
+}
+
+.run-table th {
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.09em;
+  color: var(--text-faint);
+}
+
+.run-table tbody tr:last-child td {
+  border-bottom: none;
+}
+
+.run-table tbody tr:hover {
+  background: var(--surface-hover);
+}
+
+.run-table .mono {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 12px;
+}
+
+/* ---------- Footer ---------- */
+
+.footer-link {
+  color: var(--accent);
+  font-weight: 600;
+  text-decoration: none;
+}
+
+.footer-link:hover {
+  text-decoration: underline;
+}
+
+/* ---------- Task detail modal: edit mode ---------- */
+
+#task-modal-view {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+#task-modal-view[hidden] {
+  display: none;
+}
+
+.modal__head-actions {
+  flex: none;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.modal__btn {
+  appearance: none;
+  background: var(--surface-hover);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text-muted);
+  font: inherit;
+  font-size: 13px;
+  font-weight: 600;
+  padding: 6px 14px;
+  cursor: pointer;
+  transition: color 0.15s ease, border-color 0.15s ease, background 0.15s ease;
+}
+
+.modal__btn:hover {
+  color: var(--text);
+  border-color: var(--border-strong);
+  background: var(--border);
+}
+
+.modal__btn--primary {
+  background: var(--accent-dim);
+  border-color: rgba(124, 140, 255, 0.45);
+  color: var(--accent);
+}
+
+.modal__btn--primary:hover {
+  background: rgba(124, 140, 255, 0.24);
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.modal__edit {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+
+.modal__edit[hidden] {
+  display: none;
+}
+
+.modal__edit-field {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+}
+
+.modal__edit-field label {
+  font-size: 11px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.09em;
+  color: var(--text-faint);
+}
+
+.modal__edit-field input,
+.modal__edit-field textarea {
+  width: 100%;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  color: var(--text);
+  font: inherit;
+  font-size: 14px;
+  padding: 8px 10px;
+  outline: none;
+  resize: vertical;
+  transition: border-color 0.18s ease, background 0.18s ease;
+}
+
+.modal__edit-field input:focus,
+.modal__edit-field textarea:focus {
+  border-color: var(--accent);
+  background: var(--surface-hover);
+}
+
+.modal__edit-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+}
+
+.modal__error {
+  margin: 0;
+  font-size: 13px;
+  color: var(--failed);
+}
+
+.modal__error[hidden] {
+  display: none;
+}
+
+/* ---------- Responsive ---------- */
+
+@media (max-width: 860px) {
+  .instance-card__grid {
+    grid-template-columns: 1fr 1fr;
+  }
+}
+
+@media (max-width: 560px) {
+  .instance-card__grid {
+    grid-template-columns: 1fr;
+  }
+}