Skip to content

dse120071750/m8m-harness-builder / skills/m8m/m8m-harness-builder

m8m-harness-builder

Flagged

Build and edit M8M harnesses that coordinate existing tools and FlowSteps, validate milestone outputs, and track progress and resume. Reuse working implementations in place. Compile workflow changes without runtime packaging; build portable packages when requested and deliver server installations through the dedicated M8M server installer.

FileKindSize
.gitattributesother112 B
.gitignoreother208 B
LICENSEother673 B
README.mdmarkdown29.8 KB
SKILL.mdskill md1.3 KB
agents/audit_complete.yamlconfig1.6 KB
agents/flow_generated.yamlconfig2.2 KB
agents/harness_validated.yamlconfig2.3 KB
agents/openai.yamlconfig4.6 KB
agents/skill_shipped.yamlconfig2.1 KB
agents/toolbox_ready.yamlconfig1.6 KB
conftest.pyscript275 B
contracts/conformance/expectation_first_runtime/candidate-cases.jsonconfig4.1 KB
contracts/conformance/expectation_first_runtime/common-linear.jsonconfig2.7 KB
contracts/conformance/expectation_first_runtime/schemas/judge-decision.schema.jsonconfig373 B
contracts/conformance/expectation_first_runtime/schemas/result.output.schema.jsonconfig589 B
contracts/conformance/expectation_first_runtime/schemas/source.output.schema.jsonconfig500 B
contracts/conformance/flowstep_flow_v4/invalid/judge-loop-unbound.jsonconfig483 B
contracts/conformance/flowstep_flow_v4/invalid/malformed-execution.jsonconfig571 B
contracts/conformance/flowstep_flow_v4/invalid/no-required-output.jsonconfig455 B
contracts/conformance/flowstep_flow_v4/invalid/nonjudge-bound.jsonconfig763 B
contracts/conformance/flowstep_flow_v4/invalid/unknown-field.jsonconfig469 B
contracts/conformance/flowstep_flow_v4/valid/authoring-union.jsonconfig4.3 KB
contracts/conformance/flowstep_flow_v4/valid/platform-dag.jsonconfig1.9 KB
contracts/file_ref_v2.schema.jsonconfig484 B
contracts/flow_sequence_action_v2.schema.jsonconfig1.5 KB
contracts/flowstep_flow_v4.schema.jsonconfig13.6 KB
contracts/flowstep_output_v2.schema.jsonconfig2.8 KB
contracts/flowstep_output_v3.schema.jsonconfig3.0 KB
contracts/flowstep_skill_audit_v1.schema.jsonconfig5.1 KB
contracts/m8m_builder_configuration_v1.schema.jsonconfig252 B
contracts/m8m_builder_input_v1.schema.jsonconfig183 B
contracts/m8m_builder_installation_receipt_v2.schema.jsonconfig2.9 KB
contracts/m8m_builder_output_v1.schema.jsonconfig453 B
contracts/m8m_builder_request_v3.schema.jsonconfig707 B
contracts/m8m_builder_result_v3.schema.jsonconfig422 B
contracts/m8m_builder_source_audit_v2.schema.jsonconfig6.1 KB
contracts/m8m_builder_source_bundle_v2.schema.jsonconfig8.6 KB
contracts/m8m_builder_toolbox_manifest_v2.schema.jsonconfig2.6 KB
contracts/m8m_builder_validation_report_v2.schema.jsonconfig3.4 KB
contracts/m8m_cache_receipt_v1.schema.jsonconfig1.2 KB
contracts/m8m_candidate_cache_entry_v1.schema.jsonconfig2.8 KB
contracts/m8m_chosen_output_v1.schema.jsonconfig2.3 KB
contracts/m8m_context_capsule_v1.schema.jsonconfig1.9 KB
contracts/m8m_contract_bundle_lock_v1.schema.jsonconfig648 B
contracts/m8m_goal_ledger_v1.schema.jsonconfig1.8 KB
contracts/m8m_milestone_agent_v1.schema.jsonconfig13.8 KB
contracts/m8m_milestone_expectation_v1.schema.jsonconfig1.9 KB
contracts/m8m_milestone_judge_receipt_v1.schema.jsonconfig1.7 KB
contracts/m8m_milestone_judge_request_v1.schema.jsonconfig3.0 KB
contracts/m8m_run_context_v1.schema.jsonconfig994 B
contracts/m8m_run_context_v2.schema.jsonconfig1.2 KB
contracts/m8m_run_storage_contract_v1.schema.jsonconfig894 B
contracts/m8m_runtime_lock_v1.schema.jsonconfig1.7 KB
contracts/m8m_runtime_release_v1.schema.jsonconfig2.2 KB
contracts/m8m_skill_canvas_v1.schema.jsonconfig4.0 KB
contracts/m8m_source_asset_manifest_v1.schema.jsonconfig1.2 KB
contracts/m8m_workflow_package_archive_v1.schema.jsonconfig1.1 KB
contracts/m8m_workflow_source_bundle_proof_v1.schema.jsonconfig1.6 KB
contracts/m8m_workflow_source_bundle_v1.schema.jsonconfig19.5 KB
contracts/tool_vs_intelligence_table_v1.schema.jsonconfig1.3 KB
docs/m8m-chart.jpgbinary172.2 KB
docs/m8m-task-builder-design.zh-HK.mdmarkdown66.9 KB
examples/article_infographic/README.mdmarkdown598 B
examples/article_infographic/planning/m8m-flowchart.jpgbinary186.0 KB
examples/article_infographic/planning/m8m-flowchart.mdmarkdown4.2 KB
flows/m8m_build_v2.yamlconfig9.9 KB
flowsteps/tools/audit_complete_judge/input.schema.jsonconfig190 B
flowsteps/tools/audit_complete_judge/output.schema.jsonconfig477 B
flowsteps/tools/audit_complete_judge/tests/test_tool.pyscript1.1 KB
flowsteps/tools/audit_complete_judge/tool.pyscript1.2 KB
flowsteps/tools/audit_skill/input.schema.jsonconfig250 B
flowsteps/tools/audit_skill/output.schema.jsonconfig136 B
flowsteps/tools/audit_skill/tests/test_tool.pyscript1.9 KB
flowsteps/tools/audit_skill/tool.pyscript2.9 KB
flowsteps/tools/flow_generated_judge/input.schema.jsonconfig190 B
flowsteps/tools/flow_generated_judge/output.schema.jsonconfig475 B
flowsteps/tools/flow_generated_judge/tests/test_tool.pyscript1.1 KB
flowsteps/tools/flow_generated_judge/tool.pyscript1.5 KB
flowsteps/tools/generate_from_audit/input.schema.jsonconfig562 B
flowsteps/tools/generate_from_audit/output.schema.jsonconfig137 B
flowsteps/tools/generate_from_audit/tests/test_tool.pyscript2.2 KB
flowsteps/tools/generate_from_audit/tool.pyscript3.0 KB
flowsteps/tools/harness_validated_judge/input.schema.jsonconfig193 B
flowsteps/tools/harness_validated_judge/output.schema.jsonconfig488 B
flowsteps/tools/harness_validated_judge/tests/test_tool.pyscript1.1 KB
flowsteps/tools/harness_validated_judge/tool.pyscript1.3 KB
flowsteps/tools/install_local_skill/input.schema.jsonconfig733 B
flowsteps/tools/install_local_skill/output.schema.jsonconfig144 B
flowsteps/tools/install_local_skill/tests/test_tool.pyscript2.1 KB
flowsteps/tools/install_local_skill/tool.pyscript3.0 KB
flowsteps/tools/install_toolbox/input.schema.jsonconfig400 B
flowsteps/tools/install_toolbox/output.schema.jsonconfig140 B
flowsteps/tools/install_toolbox/tests/test_tool.pyscript1.9 KB
flowsteps/tools/install_toolbox/tool.pyscript3.0 KB
flowsteps/tools/skill_shipped_judge/input.schema.jsonconfig189 B
flowsteps/tools/skill_shipped_judge/output.schema.jsonconfig484 B
flowsteps/tools/skill_shipped_judge/tests/test_tool.pyscript1.1 KB
flowsteps/tools/skill_shipped_judge/tool.pyscript1.3 KB
flowsteps/tools/toolbox_ready_judge/input.schema.jsonconfig189 B
flowsteps/tools/toolbox_ready_judge/output.schema.jsonconfig490 B
flowsteps/tools/toolbox_ready_judge/tests/test_tool.pyscript1.3 KB
flowsteps/tools/toolbox_ready_judge/tool.pyscript1.6 KB
flowsteps/tools/validate_harness/input.schema.jsonconfig563 B
flowsteps/tools/validate_harness/output.schema.jsonconfig141 B
flowsteps/tools/validate_harness/tests/test_tool.pyscript2.1 KB
flowsteps/tools/validate_harness/tool.pyscript3.0 KB
planning/upgrade.mdmarkdown16.2 KB
references/architecture.mdmarkdown28.1 KB
references/audit_complete.mdmarkdown739 B
references/builder-authoring.mdmarkdown9.8 KB
references/flow_generated.mdmarkdown1.2 KB
references/flowstep-development.mdmarkdown4.3 KB
references/harness-invocation.mdmarkdown2.9 KB
references/harness_validated.mdmarkdown786 B
references/master-prompts.mdmarkdown14.0 KB
references/milestone.mdmarkdown11.4 KB
references/output-lineage.mdmarkdown4.4 KB
references/runtime-packaging.mdmarkdown35.2 KB
references/server-delivery.mdmarkdown6.8 KB
references/skill_shipped.mdmarkdown798 B
references/tool-vs-intelligence.mdmarkdown10.0 KB
references/toolbox_ready.mdmarkdown612 B
requirements.txtmanifest150 B
scripts/audit_harness.pyscript80.7 KB
scripts/candidate_cache.pyscript27.6 KB
scripts/coordinate_workflow.pyscript4.3 KB
scripts/execution_identity.pyscript1.0 KB
scripts/flowchart_jpg.pyscript16.1 KB
scripts/flowstep_instruction.pyscript14.1 KB
scripts/flowstep_runtime.pyscript108.6 KB
scripts/flowstep_tools.pyscript5.7 KB
scripts/gem_text.pyscript5.7 KB
scripts/generate_harness.pyscript61.4 KB
scripts/humanize_chart.pyscript5.6 KB
scripts/humanize_chart_zh.pyscript5.2 KB
scripts/import_flow_v4.pyscript62.3 KB
scripts/m8m_build_steps.pyscript143.2 KB
scripts/m8m_cache.pyscript1.7 KB
scripts/m8m_delivery_common.pyscript3.8 KB
scripts/m8m_deploy.pyscript5.6 KB
scripts/m8m_factory.pyscript10.1 KB
scripts/m8m_flowchart.pyscript16.6 KB
scripts/m8m_local_bundle.pyscript4.5 KB
scripts/migrate_skill_source.pyscript34.2 KB
scripts/milestone_expectation.pyscript3.3 KB
scripts/milestone_pair.pyscript3.1 KB
scripts/package_archive.pyscript7.1 KB
scripts/project_imports.pyscript10.8 KB
scripts/run_flow.pyscript153.8 KB
scripts/run_goal.pyscript14.1 KB
scripts/run_m8m.pyscript3.8 KB
scripts/runtime_release.pyscript45.0 KB
scripts/schema_gate.pyscript5.6 KB
scripts/session_layout.pyscript74.4 KB
scripts/skill_source.pyscript65.3 KB
scripts/source_bundle.pyscript87.7 KB
scripts/teaching_contracts.pyscript8.9 KB
scripts/tool_vs_intelligence.pyscript9.3 KB
scripts/toolbox_plan.pyscript6.1 KB
scripts/validate_harness.pyscript24.1 KB
scripts/verify_platform_contract_parity.pyscript2.9 KB
seeds/branch_receipt/input.schema.jsonconfig1.0 KB
seeds/branch_receipt/output.schema.jsonconfig359 B
seeds/branch_receipt/tests/test_tool.pyscript2.0 KB
seeds/branch_receipt/tool.pyscript3.7 KB
seeds/cycle_receipt/input.schema.jsonconfig1.0 KB
seeds/cycle_receipt/output.schema.jsonconfig319 B
seeds/cycle_receipt/tests/test_tool.pyscript1.5 KB
seeds/cycle_receipt/tool.pyscript2.0 KB
seeds/hash_bind/input.schema.jsonconfig213 B
seeds/hash_bind/output.schema.jsonconfig288 B
seeds/hash_bind/tests/test_tool.pyscript814 B
seeds/hash_bind/tool.pyscript527 B
seeds/ledger_receipt/input.schema.jsonconfig278 B
seeds/ledger_receipt/output.schema.jsonconfig355 B
seeds/ledger_receipt/tests/test_tool.pyscript842 B
seeds/ledger_receipt/tool.pyscript747 B
seeds/ok_receipt/input.schema.jsonconfig280 B
seeds/ok_receipt/output.schema.jsonconfig280 B
seeds/ok_receipt/tests/test_tool.pyscript667 B
seeds/ok_receipt/tool.pyscript682 B
seeds/schema_validate/input.schema.jsonconfig265 B
seeds/schema_validate/output.schema.jsonconfig196 B
seeds/schema_validate/tests/test_tool.pyscript1.0 KB
seeds/schema_validate/tool.pyscript844 B
seeds/slot_write/input.schema.jsonconfig558 B
seeds/slot_write/output.schema.jsonconfig346 B
seeds/slot_write/tests/test_tool.pyscript1.2 KB
seeds/slot_write/tool.pyscript1015 B
tests/__init__.pyscript0 B
tests/support.pyscript668 B
tests/test_audit_harness.pyscript23.5 KB
tests/test_branch.pyscript14.4 KB
tests/test_builder3_templates.pyscript2.4 KB
tests/test_builder_install_integrity.pyscript30.6 KB
tests/test_builder_native_snapshot.pyscript5.0 KB
tests/test_builder_requirements.pyscript26.8 KB
tests/test_builder_self_dogfood.pyscript7.0 KB
tests/test_builder_self_source.pyscript10.3 KB

tests/test_branch.py

View on GitHub
from __future__ import annotations

import json
import tempfile
import unittest
from pathlib import Path
from unittest.mock import patch

import support  # noqa: F401
import run_flow

from generate_harness import generate_tool, generate_v3_flow
from m8m_flowchart import render_flowchart
from run_flow import advance
from flowstep_runtime import read_json


def _write(path: Path, text: str) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(text, encoding="utf-8", newline="\n")


def _ok_test(path: Path) -> None:
    _write(path, "def test_ok():\n    assert True\n")


def _passthrough(path: Path, extra: str = "") -> None:
    _write(
        path,
        "def run(input_data, draft=None, **_):\n"
        "    payload = dict(input_data)\n"
        "    if len(payload) == 1:\n"
        "        only = next(iter(payload.values()))\n"
        "        if isinstance(only, dict):\n"
        "            payload = dict(only)\n"
        "    if isinstance(draft, dict):\n"
        "        payload.update(draft)\n"
        + extra
        + "    return {'outputs': {'result': payload}}\n",
    )


def _intake_assemble(path: Path) -> None:
    _passthrough(
        path,
        extra=(
            "    from pathlib import Path\n"
            "    marker = Path(__file__).with_name('_handler_calls.txt')\n"
            "    calls = int(marker.read_text()) + 1 if marker.is_file() else 1\n"
            "    marker.write_text(str(calls))\n"
            "    req = payload.get('request') if isinstance(payload.get('request'), dict) else payload\n"
            "    case_type = payload.get('case_type') or req.get('case_type') or 'restyle'\n"
            "    return {'outputs': {'result': {'case_type': case_type}}}\n"
        ),
    )


BRANCH_SPEC = [
    {
        "id": "intake_ready",
        "asset": {"kind": "json"},
        "intelligence": "completion",
        "tools": ["branch_receipt"],
        "branch": {
            "worker": "branch_receipt",
            "default": "direct",
            "join": "restyle_ready",
            "paths": [
                {"id": "direct", "then": "restyle_direct"},
                {"id": "floorplan_source_case", "then": "floorplan_source_ready"},
            ],
        },
        "output_schema_object": {
            "type": "object",
            "additionalProperties": False,
            "required": ["case_type"],
            "properties": {
                "case_type": {"type": "string"},
                "recommended_branch": {"type": "string"},
            },
        },
    },
    {
        "id": "restyle_direct",
        "on_path": "direct",
        "asset": {"kind": "json"},
        "tools": ["hash_bind"],
        "output_schema_object": {
            "type": "object",
            "additionalProperties": False,
            "required": ["label"],
            "properties": {"label": {"type": "string"}},
        },
    },
    {
        "id": "floorplan_source_ready",
        "on_path": "floorplan_source_case",
        "asset": {"kind": "json"},
        "tools": ["hash_bind"],
        "output_schema_object": {
            "type": "object",
            "additionalProperties": False,
            "required": ["source_title"],
            "properties": {"source_title": {"type": "string"}},
        },
    },
    {
        "id": "source_title_frozen",
        "on_path": "floorplan_source_case",
        "asset": {"kind": "json"},
        "tools": ["hash_bind"],
        "output_schema_object": {
            "type": "object",
            "additionalProperties": False,
            "required": ["source_title"],
            "properties": {"source_title": {"type": "string"}},
        },
    },
    {
        "id": "restyle_ready",
        "asset": {"kind": "json"},
        "tools": ["hash_bind"],
        "inputs": {
            "request": "user.request",
            "direct": "restyle_direct.restyle_direct_v1",
            "source": "source_title_frozen.source_title_frozen_v1",
        },
        "output_schema_object": {
            "type": "object",
            "additionalProperties": False,
            "required": ["ready"],
            "properties": {"ready": {"type": "boolean"}},
        },
    },
]


def _scaffold(temp: str) -> tuple[Path, Path]:
    codebase = Path(temp) / "repo"
    generate_tool(codebase, "hash_bind")
    generate_tool(codebase, "branch_receipt")
    explicit_specs: list[dict] = []
    for source in BRANCH_SPEC:
        milestone_id = str(source["id"])
        spec = dict(source)
        spec.update(
            {
                "success": f"{milestone_id} produces its declared branch-safe result.",
                "output_contract": f"{milestone_id}_v1",
                "outputs": [
                    {
                        "id": "result",
                        "name": f"{milestone_id} result",
                        "kind": "json",
                        "cardinality": "one",
                        "required": True,
                    }
                ],
                "intelligence": "none",
                "flowsteps": [
                    {"id": tool, "tool": f"{tool}@1.0.0"}
                    for tool in source.get("tools", [])
                ],
                "execution": {
                    "candidate_executor": {
                        "ref": f"handler.restyle_v1.{milestone_id}@3.1.0"
                    },
                    "tool_bindings": [
                        {"tool": tool, "ref": f"{tool}@1.0.0"}
                        for tool in source.get("tools", [])
                    ],
                },
            }
        )
        explicit_specs.append(spec)
    generate_v3_flow(
        codebase,
        "restyle_v1",
        [item["id"] for item in BRANCH_SPEC],
        tools=["hash_bind", "branch_receipt"],
        milestone_specs=explicit_specs,
    )
    harness = codebase / "flowsteps" / "flows" / "restyle_v1"
    _intake_assemble(harness / "milestones" / "intake_ready" / "assemble.py")
    _passthrough(
        harness / "milestones" / "restyle_direct" / "assemble.py",
        extra="    payload = {'label': 'direct'}\n",
    )
    _passthrough(
        harness / "milestones" / "floorplan_source_ready" / "assemble.py",
        extra="    payload = {'source_title': payload.get('source_title') or 'Villa'}\n",
    )
    _passthrough(
        harness / "milestones" / "source_title_frozen" / "assemble.py",
        extra="    payload = {'source_title': payload.get('source_title') or 'Villa'}\n",
    )
    _passthrough(
        harness / "milestones" / "restyle_ready" / "assemble.py",
        extra="    payload = {'ready': True}\n",
    )
    for mid in [item["id"] for item in BRANCH_SPEC]:
        _ok_test(harness / "milestones" / mid / "tests" / "test_assemble.py")
    # open input schemas so request/previous passthrough works
    for mid in [item["id"] for item in BRANCH_SPEC]:
        _write(
            harness / "milestones" / mid / "input.schema.json",
            json.dumps({"type": "object", "additionalProperties": True}),
        )
    _write(
        harness / "milestones" / "intake_ready" / "draft.schema.json",
        json.dumps({"type": "object", "additionalProperties": True}),
    )
    return codebase, harness


class BranchChartTests(unittest.TestCase):
    def test_chart_lists_both_paths(self) -> None:
        text = render_flowchart(BRANCH_SPEC, title="restyle", flow_id="restyle_v1")
        self.assertIn("## Branch (after the milestone)", text)
        self.assertIn("`direct`", text)
        self.assertIn("`floorplan_source_case`", text)
        self.assertIn("branch_receipt", text)


class BranchRunTests(unittest.TestCase):
    def test_branch_commit_resume_reconciles_normalized_control_receipt(self) -> None:
        with tempfile.TemporaryDirectory() as temp:
            codebase, harness = _scaffold(temp)
            run_dir = codebase / "runs" / "branch-crash"
            real_store = run_flow._store_active_branch
            interrupted = False

            def interrupt_once(*args, **kwargs):
                nonlocal interrupted
                if not interrupted:
                    interrupted = True
                    raise KeyboardInterrupt("simulated crash after branch chosen commit")
                return real_store(*args, **kwargs)

            with patch.object(run_flow, "_store_active_branch", side_effect=interrupt_once):
                with self.assertRaisesRegex(KeyboardInterrupt, "simulated crash"):
                    advance(
                        harness,
                        run_dir,
                        request_path=_write_request(run_dir, {"case_type": "restyle"}),
                    )

            committed = read_json(
                run_dir / "milestones" / "intake_ready" / "out" / "judge-receipt.json"
            )
            self.assertEqual(committed["schema"], "m8m.milestone_judge_receipt.v1")
            self.assertIs(committed["details"]["worker_receipt"]["ok"], True)
            self.assertEqual(
                committed["details"]["worker_receipt"]["branch"],
                "direct",
            )
            self.assertFalse(read_json(run_dir / "flow-execution-record.json").get("active_branch"))

            result = advance(harness, run_dir)

            self.assertEqual(result["state"], "COMPLETE", result)
            record = read_json(run_dir / "flow-execution-record.json")
            self.assertEqual(record.get("active_branch"), "direct")
            self.assertEqual(record.get("branch_from"), "intake_ready")
            self.assertEqual(
                (harness / "milestones" / "intake_ready" / "_handler_calls.txt").read_text(),
                "1",
            )

    def test_direct_default_skips_floorplan_path(self) -> None:
        with tempfile.TemporaryDirectory() as temp:
            codebase, harness = _scaffold(temp)
            run_dir = codebase / "runs" / "direct"
            result = advance(
                harness,
                run_dir,
                request_path=_write_request(run_dir, {"case_type": "restyle"}),
            )
            self.assertEqual(result["state"], "COMPLETE", result)
            record = read_json(run_dir / "flow-execution-record.json")
            self.assertEqual(record.get("active_branch"), "direct")
            skipped = {item["step_id"] for item in record.get("skipped") or []}
            self.assertIn("floorplan_source_ready", skipped)
            self.assertIn("source_title_frozen", skipped)
            self.assertNotIn("restyle_direct", skipped)
            self.assertTrue((run_dir / "milestones" / "floorplan_source_ready" / "skipped.json").is_file())
            self.assertTrue((run_dir / "artifacts" / "restyle_direct.restyle_direct_v1.json").is_file() or True)
            done = {item["step_id"] for item in record["steps"]}
            self.assertIn("restyle_direct", done)
            self.assertIn("restyle_ready", done)
            self.assertNotIn("floorplan_source_ready", done)

    def test_source_case_path_skips_direct(self) -> None:
        with tempfile.TemporaryDirectory() as temp:
            codebase, harness = _scaffold(temp)
            run_dir = codebase / "runs" / "source"
            result = advance(
                harness,
                run_dir,
                request_path=_write_request(run_dir, {"case_type": "source_case"}),
            )
            self.assertEqual(result["state"], "COMPLETE", result)
            record = read_json(run_dir / "flow-execution-record.json")
            self.assertEqual(record.get("active_branch"), "floorplan_source_case")
            skipped = {item["step_id"] for item in record.get("skipped") or []}
            self.assertIn("restyle_direct", skipped)
            done = {item["step_id"] for item in record["steps"]}
            self.assertIn("floorplan_source_ready", done)
            self.assertIn("source_title_frozen", done)
            self.assertIn("restyle_ready", done)
            self.assertNotIn("restyle_direct", done)

    def test_replace_downstream_preserves_active_branch(self) -> None:
        with tempfile.TemporaryDirectory() as temp:
            codebase, harness = _scaffold(temp)
            run_dir = codebase / "runs" / "replace-direct"
            first = advance(
                harness,
                run_dir,
                request_path=_write_request(
                    run_dir, {"case_type": "restyle"}
                ),
            )
            self.assertEqual(first["state"], "COMPLETE", first)
            repeated = advance(
                harness,
                run_dir,
                replace_milestone="restyle_direct",
            )
            self.assertEqual(repeated["state"], "COMPLETE", repeated)
            record = read_json(run_dir / "flow-execution-record.json")
            self.assertEqual(record.get("active_branch"), "direct")
            done = {item["step_id"] for item in record["steps"]}
            self.assertIn("restyle_direct", done)
            self.assertNotIn("floorplan_source_ready", done)
            self.assertNotIn("source_title_frozen", done)

    def test_unknown_branch_blocks(self) -> None:
        with tempfile.TemporaryDirectory() as temp:
            codebase, harness = _scaffold(temp)
            _passthrough(
                harness / "milestones" / "intake_ready" / "assemble.py",
                extra="    return {'outputs': {'result': {'case_type': 'x', 'recommended_branch': 'other'}}}\n",
            )
            run_dir = codebase / "runs" / "bad2"
            action = advance(harness, run_dir, request_path=_write_request(run_dir, {"case_type": "x"}))
            self.assertEqual(action.get("state") or action.get("status"), "BLOCKED")

    def test_candidate_provided_control_receipt_blocks_before_worker(self) -> None:
        with tempfile.TemporaryDirectory() as temp:
            codebase, harness = _scaffold(temp)
            _passthrough(
                harness / "milestones" / "intake_ready" / "assemble.py",
                extra=(
                    "    return {'outputs': {'result': {'case_type': 'restyle'}}, "
                    "'receipt': {'ok': True, 'branch': 'direct'}}\n"
                ),
            )
            run_dir = codebase / "runs" / "noreceipt"
            action = advance(harness, run_dir, request_path=_write_request(run_dir, {"case_type": "restyle"}))
            self.assertEqual(action.get("state") or action.get("status"), "BLOCKED")


def _write_request(run_dir: Path, payload: dict) -> Path:
    path = run_dir / "request.json"
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(json.dumps(payload), encoding="utf-8")
    return path
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall