Skip to content

flurdy/agent-skills / skills/next

Rank ready beads across validated workspace stores or one local store. List read-only, or claim one selected bead, show its details, and continue into its work.

tests/workspace_fixture.py

View on GitHub
from __future__ import annotations

import json
import os
import subprocess
import tempfile
import unittest
from pathlib import Path
from typing import Any

SKILL_DIR = Path(__file__).parents[1]

FAKE_BD = """#!/usr/bin/env python3
import json
import os
import sys
import time
from pathlib import Path

arguments = sys.argv[1:]
directory = Path.cwd()
while arguments and arguments[0] == '-C':
    directory = Path(arguments[1])
    arguments = arguments[2:]

log = os.environ.get('BD_CALL_LOG')
if log:
    with open(log, 'a', encoding='utf-8') as handle:
        handle.write(json.dumps({
            'directory': str(directory.resolve()),
            'arguments': arguments,
        }) + '\\n')

payload = json.loads((directory / '.beads' / 'fixture.json').read_text())
command = arguments[0]

if command == 'show':
    key = 'show'
elif command == 'update':
    key = 'update'
elif command == 'comments':
    key = 'comments-add' if arguments[1] == 'add' else 'comments'
elif command == 'blocked':
    key = 'blocked'
elif command == 'dep':
    key = 'dep'
elif '--id' in arguments:
    key = 'probe'
elif '--ready' in arguments:
    if any(argument.startswith('--priority') for argument in arguments):
        print('Error: validation failed: --ready cannot filter on priority', file=sys.stderr)
        raise SystemExit(1)
    key = 'ready'
elif '--status=in_progress' in arguments:
    key = 'in_progress'
elif '--status=deferred' in arguments:
    key = 'deferred'
else:
    raise SystemExit(2)

fault = payload.get('faults', {}).get(key)
if fault == 'error':
    print(f'simulated {key} failure', file=sys.stderr)
    raise SystemExit(9)
if fault == 'dolt-down':
    print('Error: failed to open database: Dolt server unreachable at 127.0.0.1:1: connect: connection refused  '
          'The Dolt server may not be running. Try:   bd dolt start', file=sys.stderr)
    raise SystemExit(1)
if fault == 'invalid-json':
    print('{')
    raise SystemExit(0)
delay = payload.get('delays', {}).get(key)
if delay:
    time.sleep(delay)

issues = [i for k in ('ready', 'blocked', 'in_progress', 'deferred', 'other') for i in payload.get(k, [])]
statuses = {'in_progress': 'in_progress', 'deferred': 'deferred', 'other': 'closed'}
by_id = {issue['id']: {'status': statuses.get(bucket, 'open'), **issue}
         for bucket in ('ready', 'blocked', 'in_progress', 'deferred', 'other')
         for issue in payload.get(bucket, [])}
if key == 'show':
    matches = []
    for argument in arguments[1:]:
        if argument.startswith('--id='):
            if argument[5:] not in by_id:
                print(f"issue not found: {argument[5:]}", file=sys.stderr)
                raise SystemExit(1)
            matches.append(by_id[argument[5:]])
        elif not argument.startswith('--'):
            found = [issue for issue in issues
                     if issue['id'] == argument or issue['id'].endswith('-' + argument)]
            if not found:
                print(f"issue not found: {argument}", file=sys.stderr)
                raise SystemExit(1)
            matches.append(found[0])
    print(json.dumps(matches))
    raise SystemExit(0)
if key == 'update':
    issue_id = arguments[1]
    for bucket in ('ready', 'blocked', 'other'):
        retained = []
        for issue in payload.get(bucket, []):
            if issue['id'] == issue_id:
                payload.setdefault('in_progress', []).append(issue)
            else:
                retained.append(issue)
        payload[bucket] = retained
    (directory / '.beads' / 'fixture.json').write_text(json.dumps(payload))
    raise SystemExit(0)
if key == 'comments':
    print(json.dumps([comment for comment in payload.get('comments', [])
                      if comment.get('issue_id', arguments[1]) == arguments[1]]))
    raise SystemExit(0)
if key == 'dep':
    issue_id = arguments[2]
    options = dict(argument[2:].split('=', 1) for argument in arguments if argument.startswith('--') and '=' in argument)
    if issue_id not in by_id:
        print(json.dumps({'error': f'no issue found matching {issue_id}'}))
        raise SystemExit(1)
    rows = []
    for edge in payload.get('deps', []):
        if options.get('type', edge['type']) != edge['type']:
            continue
        near, far = ('to', 'from') if options.get('direction') == 'up' else ('from', 'to')
        if edge[near] == issue_id and edge[far] in by_id:
            row = {k: v for k, v in by_id[edge[far]].items() if k not in ('parent', 'defer_until')}
            rows.append({**row, 'dependency_type': edge['type']})
    print(json.dumps(rows))
    raise SystemExit(0)
if key == 'comments-add':
    payload.setdefault('comments', []).append({
        'issue_id': arguments[2],
        'text': arguments[3],
    })
    (directory / '.beads' / 'fixture.json').write_text(json.dumps(payload))
    if fault == 'after-write-error':
        print('simulated comments-add ambiguous failure', file=sys.stderr)
        raise SystemExit(9)
    raise SystemExit(0)
if key == 'probe':
    issue_id = arguments[arguments.index('--id') + 1]
    print(json.dumps([issue for issue in issues if issue['id'] == issue_id]))
    raise SystemExit(0)
rows = payload[key]
if command == 'list' and '--limit=0' not in arguments:
    rows = rows[:50]
print(json.dumps(rows))
"""


def issue(
    issue_id: str,
    priority: int,
    issue_type: str,
    created_at: str,
    *,
    labels: list[str] | None = None,
) -> dict[str, Any]:
    return {
        "id": issue_id,
        "title": f"Title for {issue_id}",
        "priority": priority,
        "issue_type": issue_type,
        "labels": labels or [],
        "created_at": created_at,
    }


class WorkspaceFixture(unittest.TestCase):
    def setUp(self) -> None:
        self.temporary = tempfile.TemporaryDirectory()
        self.base = Path(self.temporary.name)
        self.call_log = self.base / "bd-calls.jsonl"

        fake_bin = self.base / "bin"
        fake_bin.mkdir()
        fake_bd = fake_bin / "bd"
        fake_bd.write_text(FAKE_BD, encoding="utf-8")
        fake_bd.chmod(0o755)

        self.environment = os.environ.copy()
        self.environment["PATH"] = f"{fake_bin}:{self.environment['PATH']}"
        self.environment["BD_CALL_LOG"] = str(self.call_log)
        self.home = self.base / "home"
        self.home.mkdir()
        self.environment["HOME"] = str(self.home)

    def tearDown(self) -> None:
        self.temporary.cleanup()

    def recorded_calls(self) -> list[dict[str, Any]]:
        if not self.call_log.exists():
            return []
        return [
            json.loads(line)
            for line in self.call_log.read_text(encoding="utf-8").splitlines()
            if line
        ]

    def create_store(
        self,
        directory: Path,
        *,
        ready: list[dict[str, Any]] | None = None,
        blocked: list[dict[str, Any]] | None = None,
        in_progress: list[dict[str, Any]] | None = None,
        deferred: list[dict[str, Any]] | None = None,
        other: list[dict[str, Any]] | None = None,
        comments: list[dict[str, Any]] | None = None,
        deps: list[dict[str, str]] | None = None,
        faults: dict[str, str] | None = None,
        delays: dict[str, float] | None = None,
    ) -> None:
        directory.mkdir(parents=True)
        subprocess.run(
            ["git", "init", "-q", "--initial-branch=main"],
            cwd=directory,
            check=True,
        )
        beads = directory / ".beads"
        beads.mkdir()
        (beads / "fixture.json").write_text(
            json.dumps(
                {
                    "ready": ready or [],
                    "blocked": blocked or [],
                    "in_progress": in_progress or [],
                    "deferred": deferred or [],
                    "other": other or [],
                    "comments": comments or [],
                    "deps": deps or [],
                    "faults": faults or {},
                    "delays": delays or {},
                }
            ),
            encoding="utf-8",
        )

    def create_workspace(
        self,
        *,
        root_data: dict[str, Any] | None = None,
        repositories: dict[str, dict[str, Any]] | None = None,
    ) -> Path:
        root = self.base / "workspace"
        self.create_store(root, **(root_data or {}))
        (root / "repos").mkdir()
        (root / "infrastructure").mkdir()
        for relative_path in (
            "docs/prds",
            "docs/adrs",
            "docs/architecture",
            "docs/runbooks",
        ):
            (root / relative_path).mkdir(parents=True)
        (root / "AGENTS.md").write_text("# Fixture agents\n", encoding="utf-8")
        (root / "Makefile").write_text("all:\n\t@true\n", encoding="utf-8")

        entries = []
        for index, (name, data) in enumerate((repositories or {}).items()):
            target = self.base / "sources" / name
            self.create_store(target, **data)
            link = root / "repos" / name
            link.symlink_to(os.path.relpath(target, link.parent), target_is_directory=True)
            entries.append(
                {
                    "name": name,
                    "path": f"repos/{name}",
                    "role": "primary" if index == 0 else "service",
                }
            )

        manifest = {
            "version": 1,
            "name": "Fixture Workspace",
            "repositories": entries,
            "infrastructure": [],
        }
        (root / "workspace.json").write_text(json.dumps(manifest), encoding="utf-8")
        repository_lines = "\n".join(
            f"- `{entry['name']}` — [`{entry['path']}`]({entry['path']}) ({entry['role']})"
            for entry in entries
        ) or "_No repositories are registered yet._"
        (root / "README.md").write_text(
            "# Fixture Workspace\n\n"
            "<!-- project-workspace:repositories:start -->\n"
            f"{repository_lines}\n"
            "<!-- project-workspace:repositories:end -->\n\n"
            "<!-- project-workspace:infrastructure:start -->\n"
            "_No infrastructure references are registered yet._\n"
            "<!-- project-workspace:infrastructure:end -->\n",
            encoding="utf-8",
        )
        return root

    def declare_tracking(self, workspace: Path, **owners: Any) -> None:
        path = workspace / "workspace.json"
        manifest = json.loads(path.read_text(encoding="utf-8"))
        for entry in manifest["repositories"]:
            if entry["name"] in owners:
                entry["beadsStore"] = owners[entry["name"]]
        path.write_text(json.dumps(manifest), encoding="utf-8")

    def run_script(
        self, script: Path, directory: Path, *arguments: str, check: bool = True
    ) -> subprocess.CompletedProcess[str]:
        return subprocess.run(
            [str(script), *arguments],
            cwd=directory,
            env=self.environment,
            capture_output=True,
            check=check,
            text=True,
        )
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall