flurdy/agent-skills / skills/next
next
VerifiedRank 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 50.1 KB |
| pi/index.ts | script | 2.5 KB |
| pi/lease-selection.ts | script | 16.9 KB |
| references/dolt-recovery.md | markdown | 7.7 KB |
| references/source-scope.md | markdown | 12.5 KB |
| scripts/bd-showexecutable | script | 1.1 KB |
| scripts/collect.pyexecutable | script | 25.5 KB |
| scripts/next-bdexecutable | script | 16.5 KB |
| scripts/next-selectexecutable | script | 21.3 KB |
| tests/lease-extension.test.mjs | script | 7.4 KB |
| tests/lease-kernel.test.mjs | script | 3.7 KB |
| tests/lease-selection.test.mjs | script | 20.1 KB |
| tests/test_defer_dates.py | script | 6.8 KB |
| tests/test_dolt_recovery_contract.py | script | 3.3 KB |
| tests/test_machine_routing.py | script | 10.1 KB |
| tests/test_next_bd.py | script | 43.8 KB |
| tests/test_next_select.py | script | 36.2 KB |
| tests/test_ownership_contract.py | script | 2.8 KB |
| tests/test_read_deadlines.py | script | 8.2 KB |
| tests/test_related.py | script | 11.4 KB |
| tests/test_source_scope.py | script | 10.1 KB |
| tests/workspace_fixture.py | script | 10.8 KB |
tests/test_source_scope.py
View on GitHubfrom __future__ import annotations
import json
import shutil
import subprocess
import unittest
from workspace_fixture import SKILL_DIR, WorkspaceFixture, issue
class SourceScopeTest(WorkspaceFixture):
def test_skill_requires_verbatim_report_and_preserves_recheck_gate(self) -> None:
skill = (SKILL_DIR / "SKILL.md").read_text()
self.assertIn("Reproduce the successful list", skill)
self.assertIn("returned Markdown verbatim", skill)
self.assertIn("recompute", skill)
self.assertIn("do not claim via a fallback", skill)
self.assertIn("Numbers identify rows for review only", skill)
def test_safe_packet_keeps_undeclared_and_label_conflicts(self) -> None:
free = issue("free", 2, "task", "2026-01-01")
free["metadata"] = {"source_scope": {"version": 1, "complete": True, "roots": ["repos/api"]}}
busy = issue("busy", 2, "task", "2026-01-02", labels=["claimed"])
workspace = self.create_workspace(
root_data={"ready": [free, busy], "in_progress": [issue("active", 2, "task", "2026-01-01", labels=["claimed"])]},
repositories={"api": {}},
)
result = self.run_script(SKILL_DIR / "scripts/next-bd", workspace, "--safe-json")
packet = json.loads(result.stdout)
self.assertEqual(packet["version"], 1)
rows = packet["candidates"]
self.assertEqual([row["id"] for row in rows], ["free", "busy"])
self.assertEqual(rows[0]["source_scope"]["state"], "declared")
self.assertEqual(rows[0]["source_scope"]["roots"], [str((workspace / "repos/api").resolve())])
self.assertEqual(rows[1]["source_scope"]["state"], "unknown")
self.assertEqual(packet["in_progress"][0]["id"], "active")
self.assertEqual(rows[1]["services"], [])
self.assertTrue(all("--readonly" in row["arguments"] for row in self.recorded_calls()))
def test_safe_display_holds_back_only_shared_services(self) -> None:
root = self.base / "safe-display"
self.create_store(root, ready=[
issue("review", 2, "task", "2026-01-01", labels=["marketing"]),
issue("clash", 2, "task", "2026-01-02", labels=["hosted", "seo"]),
], in_progress=[issue("active", 2, "task", "2026-01-01", labels=["marketing", "hosted"])])
(root / "hosted").mkdir()
(root / ".hidden").mkdir()
packet = json.loads(self.run_script(SKILL_DIR / "scripts/next-bd", root, "--safe-json").stdout)
self.assertEqual([row["services"] for row in packet["candidates"]], [[], ["hosted"]])
self.assertEqual(packet["in_progress"][0]["services"], ["hosted"])
self.assertEqual([row["service_roots"] for row in packet["candidates"]], [[], [str((root / "hosted").resolve())]])
output = self.run_script(SKILL_DIR / "scripts/next-bd", root, "--safe").stdout
self.assertIn("## Ready to review (1 beads)", output)
self.assertIn("| 1 | review |", output)
main, held = output.split("## Held back — same service as in-progress work (1 beads)")
self.assertNotIn("| clash |", main)
self.assertIn("## Claimed — in progress (1 beads; not selectable)", main)
self.assertIn("Tracker claims; session activity unverified.", main)
self.assertIn("labels only, not lease evidence", held)
self.assertIn("| Shared service |", held)
self.assertIn("| hosted (active) |", held)
self.assertIn("## Ready to review (1 beads)", held)
self.assertNotIn("| clash |", held.split("## Ready to review", 1)[1])
self.assertNotIn("Tracker label overlap", output)
def test_workspace_root_services_include_registered_repositories(self) -> None:
workspace = self.create_workspace(root_data={
"ready": [issue("root", 2, "task", "2026-01-01", labels=["api", "docs", "topic"])],
}, repositories={"api": {"ready": [issue("member", 2, "task", "2026-01-01", labels=["api"])]}})
packet = json.loads(self.run_script(SKILL_DIR / "scripts/next-bd", workspace, "--safe-json").stdout)
services = {row["id"]: row["services"] for row in packet["candidates"]}
self.assertEqual(services, {"root": ["api", "docs"], "member": []})
roots = next(row["service_roots"] for row in packet["candidates"] if row["id"] == "root")
self.assertEqual(roots, [str((workspace / "repos/api").resolve()), str((workspace / "docs").resolve())])
def test_workspace_owned_scope_is_explicit_and_redirected_bases_are_unknown(self) -> None:
declared = issue("declared", 2, "task", "2026-01-01")
declared["metadata"] = {"source_scope": {"version": 1, "complete": True, "roots": ["repos/api"]}}
undeclared = issue("undeclared", 2, "task", "2026-01-02")
workspace = self.create_workspace(root_data={"ready": [declared, undeclared]}, repositories={"api": {}})
manifest_path = workspace / "workspace.json"
manifest = json.loads(manifest_path.read_text())
manifest["repositories"][0]["beadsStore"] = "workspace"
manifest_path.write_text(json.dumps(manifest))
shutil.rmtree(workspace / "repos/api/.beads")
packet = json.loads(self.run_script(SKILL_DIR / "scripts/next-bd", workspace, "--safe-json").stdout)
self.assertEqual(packet["candidates"][0]["source_scope"]["roots"], [str((workspace / "repos/api").resolve())])
self.assertEqual(packet["candidates"][1]["source_scope"]["roots"], [])
(workspace / ".beads/redirect").write_text("elsewhere")
packet = json.loads(self.run_script(SKILL_DIR / "scripts/next-bd", workspace, "--safe-json").stdout)
self.assertEqual(packet["candidates"][0]["source_scope"]["state"], "unavailable")
@unittest.skipUnless(shutil.which("node") and shutil.which("lslocks"), "optional Node/Linux observer adapter")
def test_native_adapter_reloads_declarations_and_never_claims(self) -> None:
row = issue("a", 2, "task", "2026-01-01")
row["metadata"] = {"source_scope": {"version": 1, "complete": True, "roots": ["."]}}
root = self.base / "native"
self.create_store(root, ready=[row])
module = (SKILL_DIR / "pi/lease-selection.ts").as_uri()
code = f"""
import assert from 'node:assert/strict';
import {{readFile,writeFile}} from 'node:fs/promises';
import {{inspectCandidates,collectCandidates}} from {json.dumps(module)};
const cwd = {json.dumps(str(root))};
const loadObserver = async () => async roots => roots.map(root => ({{kind:'free',root}}));
assert.equal((await inspectCandidates(cwd, {{loadObserver}})).eligible.length, 1);
const unavailable = await inspectCandidates(cwd);
assert.equal(unavailable.eligible.length, 0);
assert.equal(unavailable.unavailable.length, 1);
const fixturePath = cwd + '/.beads/fixture.json';
const fixture = JSON.parse(await readFile(fixturePath,'utf8'));
fixture.ready[0].metadata.source_scope.complete = false;
await writeFile(fixturePath,JSON.stringify(fixture));
const checked = await inspectCandidates(cwd, {{selector:'local:a',loadObserver}});
assert.equal(checked.eligible.length, 0);
assert.equal(checked.unknown.length, 1);
await assert.rejects(inspectCandidates(cwd, {{selector:'local:missing',loadObserver}}));
const controller = new AbortController(); controller.abort();
await assert.rejects(collectCandidates(cwd, controller.signal), /aborted/);
await assert.rejects(collectCandidates(cwd, undefined, 1), /timed out/);
"""
result = subprocess.run(["node", "--input-type=module", "-e", code], env=self.environment, capture_output=True, text=True, timeout=15)
self.assertEqual(result.returncode, 0, result.stderr)
self.assertTrue(all("--readonly" in call["arguments"] for call in self.recorded_calls()))
def test_scope_validation_and_portable_degradation(self) -> None:
declarations = [
None,
{"version": 1, "complete": False, "roots": ["."]},
{"version": 1, "complete": True, "roots": [".", "alias"]},
{"version": 1, "complete": True, "roots": ["/tmp"]},
{"version": 1, "complete": True, "roots": ["missing"]},
{"version": 2, "complete": True, "roots": ["."]},
]
rows = []
for index, declaration in enumerate(declarations):
row = issue(f"case-{index}", 2, "task", f"2026-01-0{index + 1}")
if declaration is not None:
row["metadata"] = {"source_scope": declaration}
rows.append(row)
root = self.base / "local"
self.create_store(root, ready=rows)
(root / "alias").symlink_to(root, target_is_directory=True)
packet = json.loads(self.run_script(SKILL_DIR / "scripts/next-bd", root, "--safe-json").stdout)
scopes = [row["source_scope"] for row in packet["candidates"]]
self.assertEqual([s["state"] for s in scopes], ["unknown", "partial", "declared", "invalid", "unavailable", "invalid"])
self.assertEqual(scopes[2]["roots"], [str(root)])
self.assertEqual(packet["candidates"][2]["selector"], "local:case-2")
fallback = self.run_script(SKILL_DIR / "scripts/next-bd", root, "--safe")
self.assertIn("no in-process Pi observer", fallback.stdout)
self.assertIn("case-2", fallback.stdout)
self.assertIn("## Ready to review (6 beads)", fallback.stdout)
self.assertIn("| # | ID | Pri | Type | Labels | Title | Parent | Lease check |", fallback.stdout)
self.assertIn("| unknown |", fallback.stdout)
self.assertIn("| n/a |", fallback.stdout)
self.assertIn("n/a = observer unavailable", fallback.stdout)
self.assertNotIn("## Occupancy unavailable", fallback.stdout)
self.assertNotIn("## Unknown", fallback.stdout)
self.assertNotIn("_None._", fallback.stdout)
self.assertIn("Numbers are for review", fallback.stdout)
self.assertIn("picking a not-checked row starts ordinary, not lease-checked, work", fallback.stdout)
ordinary = json.loads(self.run_script(SKILL_DIR / "scripts/next-bd", root, "--json").stdout)
self.assertTrue(all("source_scope" not in row for row in ordinary))
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |