@event4u/agent-config 6.1.0 → 7.0.0

package/dist/agent-src/templates/scripts/work_engine/state_io.py

@@ -1,202 +0,0 @@
-"""State-file I/O helpers for the CLI entry point.
-
-Extracted from ``cli.py`` in P2.3 of
-``road-to-post-pr29-optimize.md``. Holds the format-preserving
-load/save pair, the v0 legacy serialiser, the JSON reader, the
-``DeliveryState`` projection helpers, and the legacy-file migration
-hint. Behaviour is byte-identical to the pre-split version — Goldens
-stay green.
-"""
-from __future__ import annotations
-
-import json
-from pathlib import Path
-from typing import Any
-
-from . import state as _state_module
-from .cli_args import DEFAULT_STATE_FILE, LEGACY_STATE_FILE, _FMT_V0, _FMT_V1
-from .delivery_state import DeliveryState
-from .errors import _CLIError
-from .migration.v0_to_v1 import migrate_payload
-from .state import SchemaError, WorkState
-
-
-def _maybe_raise_legacy_hint(state_file: Path) -> None:
-    """Surface a migration hint when only the pre-1.15.0 file is present.
-
-    The dispatcher renamed the default state file from
-    ``.implement-ticket-state.json`` to ``.work-state.json`` in 1.15.0
-    (alongside the ``implement_ticket → work_engine`` package move).
-    Existing checkouts that still carry the legacy file would otherwise
-    fail with a generic "no state file" message. This helper detects
-    the legacy file in the same directory and points the user at the
-    one-shot migration command instead.
-
-    Only fires when ``state_file`` has the canonical default name and
-    sits next to a legacy file — explicit ``--state-file`` overrides
-    bypass the hint so power users can carry their own naming scheme.
-    """
-    if state_file.name != DEFAULT_STATE_FILE.name:
-        return
-    legacy_candidate = state_file.with_name(LEGACY_STATE_FILE.name)
-    if not legacy_candidate.is_file():
-        return
-    raise _CLIError(
-        f"Found legacy state file {legacy_candidate} but no "
-        f"{state_file}. The default state file was renamed in 1.15.0. "
-        f"Run `python3 -m work_engine.migration.v0_to_v1 "
-        f"{legacy_candidate}` to migrate, or pass `--state-file "
-        f"{legacy_candidate}` to keep using the old name. See "
-        "docs/MIGRATION.md.",
-    )
-
-
-def _load(state_file: Path) -> tuple[WorkState, str]:
-    """Load ``state_file`` and tag it with the wire format detected."""
-    data = _read_json(state_file)
-    if not isinstance(data, dict):
-        raise _CLIError(
-            f"State file {state_file} must carry a JSON object; "
-            f"got {type(data).__name__}.",
-        )
-
-    # v1 declares ``version``; v0 has none. Anything else is invalid.
-    if data.get("version") == _state_module.SCHEMA_VERSION:
-        try:
-            return _state_module.from_dict(data), _FMT_V1
-        except SchemaError as exc:
-            raise _CLIError(f"State file shape is invalid: {exc}") from exc
-    if "version" in data:
-        raise _CLIError(
-            f"State file shape is invalid: unsupported version "
-            f"{data.get('version')!r}; expected {_state_module.SCHEMA_VERSION}",
-        )
-    if "ticket" not in data:
-        raise _CLIError(
-            "State file shape is invalid: missing 'ticket' (v0) or "
-            "'version' (v1) — file is neither shape.",
-        )
-    try:
-        migrated = migrate_payload(data)
-        return _state_module.from_dict(migrated), _FMT_V0
-    except SchemaError as exc:
-        raise _CLIError(f"State file shape is invalid: {exc}") from exc
-
-
-def _to_delivery(work: WorkState) -> DeliveryState:
-    """Project ``work`` into a ``DeliveryState`` for handler dispatch.
-
-    R1 P4 S1 (Option A2): handlers continue to consume ``DeliveryState``
-    with ``state.ticket``; the ``WorkState`` wrapper exists at the CLI
-    boundary so the dispatcher's directive-set selection has a v1
-    state object to read ``directive_set`` from. Mutable containers
-    (``memory``, ``changes``, ``outcomes``, ``questions``) are passed
-    by reference — in-place mutations land on both objects without an
-    explicit sync. Reassignments (``state.plan = …``, ``state.report
-    = …``) are mirrored back by :func:`_sync_back`.
-    """
-    return DeliveryState(
-        ticket=work.input.data,
-        persona=work.persona,
-        memory=work.memory,
-        plan=work.plan,
-        changes=work.changes,
-        tests=work.tests,
-        verify=work.verify,
-        outcomes=work.outcomes,
-        questions=work.questions,
-        report=work.report,
-        ui_audit=work.ui_audit,
-        ui_design=work.ui_design,
-        ui_review=work.ui_review,
-        ui_polish=work.ui_polish,
-        contract=work.contract,
-        stitch=work.stitch,
-        stack=work.stack,
-    )
-
-
-def _sync_back(work: WorkState, delivery: DeliveryState) -> None:
-    """Mirror handler mutations from ``delivery`` back into ``work``.
-
-    Container fields are shared by reference (see :func:`_to_delivery`)
-    so the assignment is a no-op for those — we still mirror them
-    defensively to cover the case where a handler reassigned the
-    attribute (``state.memory = [new_list]``) instead of mutating in
-    place.
-    """
-    work.input.data = delivery.ticket
-    work.persona = delivery.persona
-    work.memory = delivery.memory
-    work.plan = delivery.plan
-    work.changes = delivery.changes
-    work.tests = delivery.tests
-    work.verify = delivery.verify
-    work.outcomes = delivery.outcomes
-    work.questions = delivery.questions
-    work.report = delivery.report
-    work.ui_audit = delivery.ui_audit
-    work.ui_design = delivery.ui_design
-    work.ui_review = delivery.ui_review
-    work.ui_polish = delivery.ui_polish
-    work.contract = delivery.contract
-    work.stitch = delivery.stitch
-    work.stack = delivery.stack
-
-
-def _save(state_file: Path, work: WorkState, fmt: str) -> None:
-    """Persist ``work`` in the wire format it was loaded with.
-
-    v1 emits the canonical envelope via :func:`work_engine.state.to_dict`;
-    v0 emits the legacy flat shape that ``DeliveryState.asdict`` used
-    to produce, byte-identical to the pre-Phase-4 output so the
-    Golden Transcript replay stays green.
-    """
-    state_file.parent.mkdir(parents=True, exist_ok=True)
-    payload = _state_module.to_dict(work) if fmt == _FMT_V1 else _to_v0_dict(work)
-    state_file.write_text(
-        json.dumps(payload, indent=2, ensure_ascii=False) + "\n",
-        encoding="utf-8",
-    )
-
-
-def _to_v0_dict(work: WorkState) -> dict[str, Any]:
-    """Serialise ``work`` in the legacy v0 wire format.
-
-    Field order matches ``DeliveryState`` declaration order so
-    pre-Phase-4 state files round-trip byte-equal.
-    """
-    return {
-        "ticket": work.input.data,
-        "persona": work.persona,
-        "memory": work.memory,
-        "plan": work.plan,
-        "changes": work.changes,
-        "tests": work.tests,
-        "verify": work.verify,
-        "outcomes": work.outcomes,
-        "questions": work.questions,
-        "report": work.report,
-    }
-
-
-def _read_json(path: Path):
-    try:
-        raw = path.read_text(encoding="utf-8")
-    except OSError as exc:
-        raise _CLIError(f"Cannot read {path}: {exc}") from exc
-    try:
-        return json.loads(raw)
-    except json.JSONDecodeError as exc:
-        raise _CLIError(f"Invalid JSON in {path}: {exc}") from exc
-
-
-__all__ = [
-    "_load",
-    "_maybe_raise_legacy_hint",
-    "_read_json",
-    "_save",
-    "_sync_back",
-    "_to_delivery",
-    "_to_v0_dict",
-]

package/dist/cli/python/resolvePython.js

@@ -1,38 +0,0 @@
-/**
- * Python interpreter resolution.
- *
- * The Bash dispatcher's `require_python3` only checks PATH for
- * `python3`. We keep the same contract here: the first executable on
- * PATH named `python3` (or `python` on Windows) wins. No version
- * coercion, no venv hijacking — the engine's own scripts handle that.
- *
- * Exposed as a function so tests can stub it via dependency injection.
- */
-import { execaSync } from 'execa';
-export class PythonNotFoundError extends Error {
-    constructor() {
-        super('agent-config: python3 not found on PATH. Install Python 3.11+ and retry.');
-        this.name = 'PythonNotFoundError';
-    }
-}
-export function resolvePython() {
-    const candidates = process.platform === 'win32'
-        ? ['python3', 'python']
-        : ['python3'];
-    for (const bin of candidates) {
-        try {
-            const { stdout } = execaSync(bin, ['--version'], {
-                reject: false,
-                timeout: 5000,
-            });
-            const match = /Python\s+(\d+\.\d+\.\d+)/.exec(stdout);
-            if (match?.[1])
-                return { bin, version: match[1] };
-        }
-        catch {
-            // try next candidate
-        }
-    }
-    throw new PythonNotFoundError();
-}
-//# sourceMappingURL=resolvePython.js.map

package/dist/cli/python/resolvePython.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolvePython.js","sourceRoot":"","sources":["../../../src/cli/python/resolvePython.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASlC,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC1C;QACI,KAAK,CACD,0EAA0E,CAC7E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,UAAU,aAAa;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC3C,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC;QACvB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE;gBAC7C,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IACD,MAAM,IAAI,mBAAmB,EAAE,CAAC;AACpC,CAAC"}

package/src/scripts/_archive/_backfill_skill_domains.py

@@ -1,140 +0,0 @@
-#!/usr/bin/env python3
-"""One-shot back-fill: inject `domain:` frontmatter into every SKILL.md.
-
-Removed after B3 lands. Source-of-truth = SKILL_DOMAIN_MAP below.
-Fails loudly if the map and on-disk skill set diverge.
-"""
-from __future__ import annotations
-import re
-import sys
-from pathlib import Path
-
-SKILL_DOMAIN_MAP: dict[str, str] = {
-    "adr-create": "process", "adversarial-review": "quality",
-    "agent-docs-writing": "process", "agents-md-thin-root": "process",
-    "ai-council": "process", "analysis-autonomous-mode": "discovery",
-    "analysis-skill-router": "discovery", "api-design": "engineering",
-    "api-endpoint": "engineering", "api-testing": "quality",
-    "artisan-commands": "engineering", "async-python-patterns": "engineering",
-    "authz-review": "quality", "aws-infrastructure": "devops",
-    "blade-ui": "engineering", "blast-radius-analyzer": "discovery",
-    "bug-analyzer": "discovery", "check-refs": "process",
-    "code-refactoring": "engineering", "code-review": "quality",
-    "command-routing": "process", "command-writing": "process",
-    "composer-packages": "engineering", "context-authoring": "process",
-    "context-document": "process", "conventional-commits-writing": "process",
-    "copilot-agents-optimization": "process", "copilot-config": "process",
-    "dashboard-design": "devops", "data-flow-mapper": "discovery",
-    "database": "engineering", "dcf-modeling": "product",
-    "deep-reading-analyst": "discovery", "defense-in-depth": "quality",
-    "dependency-upgrade": "engineering", "description-assist": "process",
-    "design-review": "quality", "devcontainer": "devops",
-    "developer-like-execution": "process", "docker": "devops",
-    "dto-creator": "engineering", "eloquent": "engineering",
-    "error-handling-patterns": "engineering", "estimate-ticket": "product",
-    "existing-ui-audit": "discovery", "fe-design": "engineering",
-    "feature-planning": "product", "file-editor": "process",
-    "finishing-a-development-branch": "process", "flux": "engineering",
-    "funnel-analysis": "product", "git-workflow": "process",
-    "github-ci": "devops", "grafana": "devops",
-    "guideline-writing": "process", "jira-integration": "process",
-    "jobs-events": "engineering", "judge-bug-hunter": "quality",
-    "judge-code-quality": "quality", "judge-security-auditor": "quality",
-    "judge-test-coverage": "quality", "laravel": "engineering",
-    "laravel-horizon": "engineering", "laravel-mail": "engineering",
-    "laravel-middleware": "engineering", "laravel-notifications": "engineering",
-    "laravel-pennant": "engineering", "laravel-pulse": "engineering",
-    "laravel-reverb": "engineering", "laravel-scheduling": "engineering",
-    "laravel-validation": "engineering", "learning-to-rule-or-skill": "process",
-    "lint-skills": "process", "livewire": "engineering",
-    "logging-monitoring": "devops", "markitdown": "process",
-    "mcp": "process", "mcp-builder": "process",
-    "md-language-check": "process", "merge-conflicts": "process",
-    "migration-creator": "engineering", "mobile-e2e-strategy": "quality",
-    "module-management": "process", "multi-tenancy": "engineering",
-    "okr-tree-modeling": "product", "openapi": "engineering",
-    "override-management": "process", "performance": "engineering",
-    "performance-analysis": "discovery", "persona-writing": "process",
-    "pest-testing": "quality", "php-coder": "engineering",
-    "php-debugging": "engineering", "php-service": "engineering",
-    "playwright-testing": "quality", "project-analysis-core": "discovery",
-    "project-analysis-hypothesis-driven": "discovery",
-    "project-analysis-laravel": "discovery", "project-analysis-nextjs": "discovery",
-    "project-analysis-node-express": "discovery",
-    "project-analysis-react": "discovery", "project-analysis-symfony": "discovery",
-    "project-analysis-zend-laminas": "discovery", "project-analyzer": "discovery",
-    "project-docs": "process", "prompt-engineering-patterns": "product",
-    "prompt-optimizer": "product", "quality-tools": "quality",
-    "react-native-setup": "devops", "react-shadcn-ui": "engineering",
-    "readme-reviewer": "quality", "readme-writing": "process",
-    "readme-writing-package": "process", "receiving-code-review": "process",
-    "refine-prompt": "product", "refine-ticket": "product",
-    "repomix-packer": "process", "requesting-code-review": "process",
-    "review-routing": "quality", "rice-prioritization": "product",
-    "roadmap-management": "process", "roadmap-writing": "process",
-    "rtk-output-filtering": "process", "rule-writing": "process",
-    "script-writing": "process", "secrets-management": "devops",
-    "security": "quality", "security-audit": "quality",
-    "sentry-integration": "devops", "sequential-thinking": "process",
-    "skill-improvement-pipeline": "process", "skill-management": "process",
-    "skill-reviewer": "quality", "skill-writing": "process",
-    "sql-writing": "engineering", "subagent-orchestration": "process",
-    "systematic-debugging": "discovery", "technical-specification": "product",
-    "terraform": "devops", "terragrunt": "devops",
-    "test-driven-development": "quality", "test-performance": "quality",
-    "testing-anti-patterns": "quality", "threat-modeling": "quality",
-    "token-optimizer": "process", "traefik": "devops",
-    "unit-economics-modeling": "product", "universal-project-analysis": "discovery",
-    "upstream-contribute": "process", "using-git-worktrees": "process",
-    "validate-feature-fit": "quality", "verify-completion-evidence": "quality",
-    "websocket": "engineering",
-}
-VALID_DOMAINS = {"engineering", "product", "quality", "devops", "process", "discovery"}
-
-
-def main() -> int:
-    # Default: source-of-truth tree. Pass --target=condensed to mirror into .agent-src/.
-    target = ".agent-src.uncondensed/skills"
-    for arg in sys.argv[1:]:
-        if arg == "--target=condensed":
-            target = ".agent-src/skills"
-    skills_root = Path(target)
-    on_disk = sorted(p.name for p in skills_root.iterdir() if p.is_dir())
-    in_map = sorted(SKILL_DOMAIN_MAP.keys())
-    missing = set(on_disk) - set(in_map)
-    extra = set(in_map) - set(on_disk)
-    if missing or extra:
-        print(f"DRIFT: missing={sorted(missing)} extra={sorted(extra)}", file=sys.stderr)
-        return 2
-    bad = {k: v for k, v in SKILL_DOMAIN_MAP.items() if v not in VALID_DOMAINS}
-    if bad:
-        print(f"INVALID DOMAIN VALUES: {bad}", file=sys.stderr)
-        return 2
-
-    fm_pat = re.compile(r"^(---\n)(.*?)(\n---\n)", re.DOTALL)
-    domain_line_pat = re.compile(r"^domain:[ \t]*[A-Za-z]+[ \t]*$", re.MULTILINE)
-    source_line_pat = re.compile(r"^(source:[ \t]*\S+)$", re.MULTILINE)
-    edited = 0
-    for slug, domain in SKILL_DOMAIN_MAP.items():
-        skill_md = skills_root / slug / "SKILL.md"
-        text = skill_md.read_text()
-        m = fm_pat.match(text)
-        if not m:
-            print(f"NO FRONTMATTER: {skill_md}", file=sys.stderr)
-            return 2
-        fm_body = m.group(2)
-        if domain_line_pat.search(fm_body):
-            new_fm = domain_line_pat.sub(f"domain: {domain}", fm_body)
-        elif source_line_pat.search(fm_body):
-            new_fm = source_line_pat.sub(rf"\1\ndomain: {domain}", fm_body)
-        else:
-            new_fm = fm_body.rstrip("\n") + f"\ndomain: {domain}"
-        if new_fm != fm_body:
-            skill_md.write_text(m.group(1) + new_fm + m.group(3) + text[m.end():])
-            edited += 1
-    print(f"Back-filled {edited}/{len(SKILL_DOMAIN_MAP)} skills")
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/src/scripts/_archive/_bootstrap_tier_frontmatter.py

@@ -1,151 +0,0 @@
-#!/usr/bin/env python3
-"""One-shot bootstrap — inject `tier: N` frontmatter into every slash command.
-
-Per Phase 4 Step 3 of `agents/roadmaps/road-to-distribution-maturity.md`.
-
-Walks `.agent-src.uncondensed/commands/**.md`. For each file:
-
-- Tier-0 promotions match TIER_0 below — typed by hand.
-- Tier-1 promotions match TIER_1 below — typed by hand.
-- Everything else defaults to **Tier-2** (per the contract).
-
-Idempotent — re-running is a no-op once tiers are tagged. The lint
-script `scripts/lint_command_tiers.py` enforces drift from here on.
-
-Run from repo root: `python3 scripts/_bootstrap_tier_frontmatter.py`.
-"""
-from __future__ import annotations
-
-import re
-from pathlib import Path
-
-REPO_ROOT = Path(__file__).resolve().parent.parent.parent
-COMMANDS_DIRS = (
-    REPO_ROOT / ".agent-src.uncondensed" / "commands",
-    REPO_ROOT / ".agent-src" / "commands",
-)
-
-# Tier-0 — daily-driver slash commands (per docs/contracts/command-surface-tiers.md).
-# Paths are relative to COMMANDS_DIR.
-TIER_0 = {
-    "onboard.md",
-    "commit.md",
-    "work.md",
-    "implement-ticket.md",
-    "agent-status.md",
-    "agent-handoff.md",
-}
-
-# Tier-1 — power-user / maintainer / orchestrator slash commands.
-TIER_1 = {
-    "create-pr.md",
-    "review-changes.md",
-    "optimize.md",
-    "roadmap.md",
-    "feature.md",
-    "fix.md",
-    "judge.md",
-    "memory.md",
-    "council.md",
-    "agents.md",
-    "commit/in-chunks.md",
-    "create-pr/description-only.md",
-    "quality-fix.md",
-    "prepare-for-review.md",
-    "estimate-ticket.md",
-    "refine-ticket.md",
-    "bug-fix.md",
-    "bug-investigate.md",
-    "jira-ticket.md",
-    "condense.md",
-    "mode.md",
-    "project-analyze.md",
-    "project-health.md",
-    "rule-compliance-audit.md",
-    "threat-model.md",
-    "set-cost-profile.md",
-    "sync-agent-settings.md",
-    "sync-gitignore.md",
-    "upstream-contribute.md",
-}
-
-FRONTMATTER_RE = re.compile(r"^---\n(.*?)\n---\n", re.DOTALL)
-
-
-def classify(rel_path: str) -> int:
-    if rel_path in TIER_0:
-        return 0
-    if rel_path in TIER_1:
-        return 1
-    return 2
-
-
-def inject_tier(text: str, tier: int) -> tuple[str, bool]:
-    """Inject `tier: N` into the frontmatter block. Returns (new_text, changed).
-
-    If frontmatter already contains `tier:`, the existing value wins
-    (idempotent — bootstrap never overrides a manual tag).
-    """
-    m = FRONTMATTER_RE.match(text)
-    if not m:
-        return text, False
-    block = m.group(1)
-    if re.search(r"^tier:\s*[012]\s*$", block, re.MULTILINE):
-        return text, False
-    # Insert `tier: N` right after the `name:` line if present, else at
-    # the top of the block.
-    name_match = re.search(r"^(name:\s*\S+)$", block, re.MULTILINE)
-    if name_match:
-        new_block = (
-            block[: name_match.end()]
-            + f"\ntier: {tier}"
-            + block[name_match.end() :]
-        )
-    else:
-        new_block = f"tier: {tier}\n{block}"
-    new_fm = f"---\n{new_block}\n---\n"
-    return new_fm + text[m.end() :], True
-
-
-def main() -> int:
-    overall_tagged = 0
-    overall_skipped = 0
-    for commands_dir in COMMANDS_DIRS:
-        if not commands_dir.is_dir():
-            print(f"[bootstrap-tier] no commands dir: {commands_dir}")
-            continue
-        files = sorted(commands_dir.rglob("*.md"))
-        tagged = 0
-        skipped = 0
-        by_tier = {0: 0, 1: 0, 2: 0}
-        for path in files:
-            rel = path.relative_to(commands_dir).as_posix()
-            # Sub-AGENTS.md files are not slash commands.
-            if rel.endswith("AGENTS.md"):
-                continue
-            tier = classify(rel)
-            by_tier[tier] += 1
-            text = path.read_text(encoding="utf-8")
-            new_text, changed = inject_tier(text, tier)
-            if changed:
-                path.write_text(new_text, encoding="utf-8")
-                tagged += 1
-            else:
-                skipped += 1
-        overall_tagged += tagged
-        overall_skipped += skipped
-        rel_label = commands_dir.relative_to(REPO_ROOT)
-        print(
-            f"[bootstrap-tier] dir={rel_label} tagged={tagged} "
-            f"skipped={skipped} tier-0={by_tier[0]} "
-            f"tier-1={by_tier[1]} tier-2={by_tier[2]}"
-        )
-    print(
-        f"[bootstrap-tier] total: tagged={overall_tagged} "
-        f"skipped={overall_skipped}"
-    )
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())