agentic-dev 0.2.11 → 0.2.13

package/sdd/99_toolchain/01_automation/agentic-dev/init_repo_contract.sh

@@ -1,51 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  cat <<'EOF'
-Usage: init_repo_contract.sh [repo_root]
-
-Create the canonical toolchain contract if it does not exist.
-Also create runtime-friendly aliases:
-  - .codex/agentic-dev.json
-  - .claude/agentic-dev.json
-Print the resulting canonical contract path.
-EOF
-}
-
-if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
-  usage
-  exit 0
-fi
-
-repo_root="$(cd "${1:-$(pwd)}" && pwd)"
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-template_path="${script_dir}/assets/repo-contract.template.json"
-contract_path="${repo_root}/sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json"
-codex_dir="${repo_root}/.codex"
-claude_dir="${repo_root}/.claude"
-codex_alias_path="${codex_dir}/agentic-dev.json"
-claude_alias_path="${claude_dir}/agentic-dev.json"
-
-if [[ ! -f "${template_path}" ]]; then
-  echo "Template not found: ${template_path}" >&2
-  exit 1
-fi
-
-mkdir -p "$(dirname "${contract_path}")" "${codex_dir}" "${claude_dir}"
-if [[ ! -f "${contract_path}" ]]; then
-  cp "${template_path}" "${contract_path}"
-fi
-
-python3 - "${codex_alias_path}" "${claude_alias_path}" <<'PY'
-import json
-import sys
-from pathlib import Path
-
-payload = {"contract_path": "../sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json"}
-for raw_path in sys.argv[1:]:
-    path = Path(raw_path)
-    path.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
-PY
-
-printf '%s\n' "${contract_path}"

package/sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json

@@ -1,76 +0,0 @@
-{
-  "schema_version": 1,
-  "name": "templates-frontends",
-  "spec": {
-    "planning_paths": [
-      "sdd/01_planning",
-      "sdd/02_plan"
-    ],
-    "canonical_targets_dir": "sdd/02_plan"
-  },
-  "frontend": {
-    "default_target": "web",
-    "targets": {
-      "web": {
-        "dir": "client/web",
-        "adapter_path": "client/web/scripts/ui-parity-web-adapter.mjs",
-        "screens_path": "client/web/src/lib/specScreens.json",
-        "routes_path": "client/web/src/lib/specRouteCatalog.json",
-        "preview_url": "http://127.0.0.1:4301",
-        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_web_contract.yaml",
-        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json",
-        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.md",
-        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json"
-      },
-      "mobile": {
-        "dir": "client/mobile",
-        "adapter_path": "client/mobile/scripts/ui-parity-mobile-adapter.mjs",
-        "screens_path": "client/mobile/src/lib/specScreens.json",
-        "routes_path": "client/mobile/src/lib/specRouteCatalog.json",
-        "preview_url": "http://127.0.0.1:4302",
-        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_mobile_contract.yaml",
-        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_mobile_route_gap_report.json",
-        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_mobile_route_gap_report.md",
-        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_mobile_agentic_dev_latest.json"
-      },
-      "admin": {
-        "dir": "client/admin",
-        "adapter_path": "client/admin/scripts/ui-parity-admin-adapter.mjs",
-        "screens_path": "client/admin/src/lib/specScreens.json",
-        "routes_path": "client/admin/src/lib/specRouteCatalog.json",
-        "preview_url": "http://127.0.0.1:4400",
-        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_admin_contract.yaml",
-        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_admin_route_gap_report.json",
-        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_admin_route_gap_report.md",
-        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_admin_agentic_dev_latest.json"
-      },
-      "landing": {
-        "dir": "client/landing",
-        "adapter_path": "client/landing/scripts/ui-parity-landing-adapter.mjs",
-        "screens_path": "client/landing/src/lib/specScreens.json",
-        "routes_path": "client/landing/src/lib/specRouteCatalog.json",
-        "preview_url": "http://127.0.0.1:4300",
-        "parity_contract_path": "sdd/02_plan/10_test/templates/ui_parity_landing_contract.yaml",
-        "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_landing_route_gap_report.json",
-        "route_gap_markdown_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_landing_route_gap_report.md",
-        "proof_output": "sdd/03_verify/10_test/ui_parity/templates_landing_agentic_dev_latest.json"
-      }
-    }
-  },
-  "commands": {
-    "plan_audit": "bash sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh route_gap .",
-    "build": "bash sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh build .",
-    "proof": "bash sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh proof .",
-    "deploy_dev": "echo 'configure deploy_dev command in sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json for the cloned service' >&2",
-    "verify_dev": "test -f \"$PWD/sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json\" && echo verify-dev-placeholder-ok"
-  },
-  "artifacts": {
-    "route_gap_output": "sdd/02_plan/99_generated/from_planning/ui_parity/ui_parity_web_route_gap_report.json",
-    "proof_output": "sdd/03_verify/10_test/ui_parity/templates_web_agentic_dev_latest.json"
-  },
-  "notes": [
-    "This template contract is intentionally self-contained and points at repo-local 99_toolchain automation.",
-    "Replace deploy_dev and verify_dev with service-specific DEV commands after cloning the template.",
-    "plan_audit is expected to generate and gate a route-gap report before proof."
-  ]
-}

package/sdd/99_toolchain/01_automation/agentic-dev/resolve_frontend_target.py

@@ -1,52 +0,0 @@
-#!/usr/bin/env python3
-import json
-import sys
-from pathlib import Path
-
-from resolve_repo_contract import resolve_repo_contract_path
-
-
-def main() -> int:
-    if len(sys.argv) < 2:
-        print("Usage: resolve_frontend_target.py <repo_root> [target]", file=sys.stderr)
-        return 1
-
-    repo_root = Path(sys.argv[1]).resolve()
-    target_name = sys.argv[2].strip() if len(sys.argv) > 2 and sys.argv[2].strip() else None
-    contract_path = resolve_repo_contract_path(repo_root)
-    if contract_path is None:
-        print("Frontend contract not found via .codex/.claude/toolchain contract search order.", file=sys.stderr)
-        return 1
-
-    contract = json.loads(contract_path.read_text(encoding="utf-8"))
-    frontend = contract.get("frontend")
-    if not isinstance(frontend, dict):
-        print(f"Missing frontend block in {contract_path}", file=sys.stderr)
-        return 1
-
-    default_target = frontend.get("default_target")
-    targets = frontend.get("targets")
-    if not isinstance(default_target, str) or not default_target.strip():
-        print(f"Missing frontend.default_target in {contract_path}", file=sys.stderr)
-        return 1
-    if not isinstance(targets, dict):
-        print(f"Missing frontend.targets in {contract_path}", file=sys.stderr)
-        return 1
-
-    selected = target_name or default_target
-    target = targets.get(selected)
-    if not isinstance(target, dict):
-        print(f"Unknown frontend target: {selected}", file=sys.stderr)
-        return 1
-
-    payload = {
-        "name": selected,
-        "default_target": default_target,
-        "target": target,
-    }
-    print(json.dumps(payload, ensure_ascii=False))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/sdd/99_toolchain/01_automation/agentic-dev/resolve_repo_contract.py

@@ -1,56 +0,0 @@
-#!/usr/bin/env python3
-import json
-import sys
-from pathlib import Path
-
-
-SEARCH_ORDER = (
-    ".codex/agentic-dev.json",
-    ".claude/agentic-dev.json",
-    "sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json",
-)
-
-
-def candidate_paths(start: Path):
-    current = start.resolve()
-    if current.is_file():
-        current = current.parent
-    for base in (current, *current.parents):
-        for rel in SEARCH_ORDER:
-            yield base / rel
-
-
-def resolve_pointer(path: Path) -> Path:
-    data = json.loads(path.read_text(encoding="utf-8"))
-    target = data.get("contract_path")
-    if isinstance(target, str) and target.strip():
-        resolved = (path.parent / target).resolve()
-        if not resolved.is_file():
-            raise FileNotFoundError(f"contract_path target not found: {resolved}")
-        return resolved
-    return path.resolve()
-
-
-def resolve_repo_contract_path(start: Path) -> Path | None:
-    for path in candidate_paths(start):
-        if path.is_file():
-            return resolve_pointer(path)
-    return None
-
-
-def main() -> int:
-    start = Path(sys.argv[1]) if len(sys.argv) > 1 else Path.cwd()
-    resolved = resolve_repo_contract_path(start)
-    if resolved is not None:
-        print(resolved)
-        return 0
-    print(
-        "No repo contract found. Checked .codex/agentic-dev.json, "
-        ".claude/agentic-dev.json, sdd/99_toolchain/01_automation/agentic-dev/repo-contract.json in current and parent directories.",
-        file=sys.stderr,
-    )
-    return 1
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/sdd/99_toolchain/01_automation/agentic-dev/run_frontend_target.sh

@@ -1,100 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  cat <<'EOF'
-Usage: run_frontend_target.sh <action> [repo_root] [target]
-
-Actions:
-  build
-  preview
-  scaffold
-  route_gap
-  materialize_references
-  proof
-EOF
-}
-
-if [[ $# -lt 1 ]]; then
-  usage >&2
-  exit 1
-fi
-
-action="$1"
-repo_root="$(cd "${2:-$(pwd)}" && pwd)"
-target_name="${3:-${FRONTEND_TARGET:-}}"
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-resolver_path="${script_dir}/resolve_frontend_target.py"
-payload="$(python3 "${resolver_path}" "${repo_root}" "${target_name}")"
-
-read_target_value() {
-  local key="$1"
-  python3 - "${payload}" "${key}" <<'PY'
-import json
-import sys
-
-payload = json.loads(sys.argv[1])
-key = sys.argv[2]
-value = payload
-for part in key.split("."):
-    if not isinstance(value, dict):
-        raise SystemExit(1)
-    value = value.get(part)
-if isinstance(value, (dict, list)):
-    print(json.dumps(value, ensure_ascii=False))
-elif value is None:
-    raise SystemExit(1)
-else:
-    print(str(value))
-PY
-}
-
-target_id="$(read_target_value "name")"
-target_dir="$(read_target_value "target.dir")"
-adapter_path="$(read_target_value "target.adapter_path")"
-screens_path="$(read_target_value "target.screens_path")"
-routes_path="$(read_target_value "target.routes_path")"
-parity_contract_path="$(read_target_value "target.parity_contract_path")"
-route_gap_output="$(read_target_value "target.route_gap_output")"
-route_gap_markdown_output="$(read_target_value "target.route_gap_markdown_output")"
-proof_output="$(read_target_value "target.proof_output")"
-
-cd "${repo_root}"
-
-case "${action}" in
-  build)
-    npm --prefix "${target_dir}" run build
-    ;;
-  preview)
-    npm --prefix "${target_dir}" run preview
-    ;;
-  scaffold)
-    node sdd/99_toolchain/01_automation/ui-parity/cli/scaffold-contract.mjs \
-      --adapter "${adapter_path}" \
-      --out "${parity_contract_path}"
-    ;;
-  route_gap)
-    node sdd/99_toolchain/01_automation/ui-parity/cli/route-gap-report.mjs \
-      --service "${target_id}" \
-      --screens "${screens_path}" \
-      --routes "${routes_path}" \
-      --out "${route_gap_output}" \
-      --markdown-out "${route_gap_markdown_output}"
-    ;;
-  materialize_references)
-    node sdd/99_toolchain/01_automation/ui-parity/cli/materialize-reference-assets.mjs \
-      --adapter "${adapter_path}" \
-      --contract "${parity_contract_path}"
-    ;;
-  proof)
-    node sdd/99_toolchain/01_automation/ui-parity/cli/run-proof.mjs \
-      --adapter "${adapter_path}" \
-      --contract "${parity_contract_path}" \
-      --out "${proof_output}"
-    ;;
-  *)
-    echo "Unsupported frontend action: ${action}" >&2
-    usage >&2
-    exit 1
-    ;;
-esac

package/sdd/99_toolchain/01_automation/agentic-dev/run_repo_phase.sh

@@ -1,140 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  cat <<'EOF'
-Usage: run_repo_phase.sh <phase> [repo_root] [target]
-
-Run a repo-local command from the nearest repo contract.
-
-Supported phases:
-  plan_audit
-  build
-  proof
-  deploy_dev
-  verify_dev
-  full_dev
-EOF
-}
-
-if [[ $# -lt 1 ]]; then
-  usage >&2
-  exit 1
-fi
-
-phase="$1"
-repo_root="${2:-$(pwd)}"
-frontend_target="${3:-}"
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-resolver_path="${script_dir}/resolve_repo_contract.py"
-frontend_resolver_path="${script_dir}/resolve_frontend_target.py"
-proof_schema_path="${script_dir}/../ui-parity/contracts/proof-result.schema.json"
-route_gap_schema_path="${script_dir}/../ui-parity/contracts/route-gap-report.schema.json"
-schema_validator_path="${script_dir}/validate_json_schema.py"
-repo_root="$(cd "${repo_root}" && pwd)"
-
-resolve_contract() {
-  "${resolver_path}" "${repo_root}"
-}
-
-load_contract_value() {
-  local contract_path="$1"
-  local key="$2"
-  python3 - "${contract_path}" "${key}" <<'PY'
-import json
-import sys
-
-contract_path, key = sys.argv[1], sys.argv[2]
-with open(contract_path, "r", encoding="utf-8") as handle:
-    data = json.load(handle)
-
-keys = key.split(".")
-value = data
-for part in keys:
-    if not isinstance(value, dict):
-        raise SystemExit(1)
-    value = value.get(part)
-
-if not isinstance(value, str) or not value.strip():
-    raise SystemExit(1)
-
-print(value.strip())
-PY
-}
-
-run_single_phase() {
-  local contract_path="$1"
-  local repo_root_path="$2"
-  local single_phase="$3"
-  local command
-  command="$(load_contract_value "${contract_path}" "commands.${single_phase}")" || {
-    echo "Phase command not found in ${contract_path}: ${single_phase}" >&2
-    exit 1
-  }
-
-  printf 'Running phase `%s` from %s\n' "${single_phase}" "${contract_path}"
-  (
-    cd "${repo_root_path}"
-    if [[ -n "${frontend_target}" ]]; then
-      export FRONTEND_TARGET="${frontend_target}"
-    fi
-    eval "${command}"
-  )
-
-  if [[ "${single_phase}" == "plan_audit" ]]; then
-    local route_gap_output
-    route_gap_output="$(python3 "${frontend_resolver_path}" "${repo_root_path}" "${frontend_target}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["target"]["route_gap_output"])')" || \
-    route_gap_output="$(load_contract_value "${contract_path}" "artifacts.route_gap_output")" || {
-      echo "Route gap artifact path not found in ${contract_path}" >&2
-      exit 1
-    }
-    if [[ ! -f "${repo_root_path}/${route_gap_output}" ]]; then
-      echo "Expected route gap artifact missing: ${repo_root_path}/${route_gap_output}" >&2
-      exit 1
-    fi
-    python3 "${schema_validator_path}" "${route_gap_schema_path}" "${repo_root_path}/${route_gap_output}"
-    python3 "${script_dir}/analyze_route_gap.py" --gate "${repo_root_path}/${route_gap_output}"
-  fi
-
-  if [[ "${single_phase}" == "proof" || "${single_phase}" == "verify_dev" ]]; then
-    local proof_output
-    proof_output="$(python3 "${frontend_resolver_path}" "${repo_root_path}" "${frontend_target}" | python3 -c 'import json,sys; print(json.load(sys.stdin)["target"]["proof_output"])')" || \
-    proof_output="$(load_contract_value "${contract_path}" "artifacts.proof_output")" || {
-      echo "Proof artifact path not found in ${contract_path}" >&2
-      exit 1
-    }
-    if [[ ! -f "${repo_root_path}/${proof_output}" ]]; then
-      echo "Expected proof artifact missing: ${repo_root_path}/${proof_output}" >&2
-      exit 1
-    fi
-    python3 "${schema_validator_path}" "${proof_schema_path}" "${repo_root_path}/${proof_output}"
-    if [[ "${single_phase}" == "proof" ]]; then
-      python3 "${script_dir}/analyze_proof_results.py" --gate "${repo_root_path}/${proof_output}"
-    fi
-  fi
-}
-
-if [[ ! -f "${resolver_path}" ]]; then
-  echo "Missing contract resolver: ${resolver_path}" >&2
-  exit 1
-fi
-
-contract_path="$(resolve_contract)" || exit 1
-
-case "${phase}" in
-  plan_audit|build|proof|deploy_dev|verify_dev)
-    run_single_phase "${contract_path}" "${repo_root}" "${phase}"
-    ;;
-  full_dev)
-    run_single_phase "${contract_path}" "${repo_root}" plan_audit
-    run_single_phase "${contract_path}" "${repo_root}" build
-    run_single_phase "${contract_path}" "${repo_root}" proof
-    run_single_phase "${contract_path}" "${repo_root}" deploy_dev
-    run_single_phase "${contract_path}" "${repo_root}" verify_dev
-    ;;
-  *)
-    echo "Unsupported phase: ${phase}" >&2
-    usage >&2
-    exit 1
-    ;;
-esac

package/sdd/99_toolchain/01_automation/agentic-dev/validate_json_schema.py

@@ -1,39 +0,0 @@
-#!/usr/bin/env python3
-import json
-import sys
-from pathlib import Path
-
-from jsonschema import Draft202012Validator
-
-
-def main() -> int:
-    if len(sys.argv) != 3:
-        print("Usage: validate_json_schema.py <schema-json> <instance-json>", file=sys.stderr)
-        return 1
-
-    schema_path = Path(sys.argv[1])
-    instance_path = Path(sys.argv[2])
-    if not schema_path.is_file():
-        print(f"Schema not found: {schema_path}", file=sys.stderr)
-        return 1
-    if not instance_path.is_file():
-        print(f"Instance not found: {instance_path}", file=sys.stderr)
-        return 1
-
-    schema = json.loads(schema_path.read_text(encoding="utf-8"))
-    instance = json.loads(instance_path.read_text(encoding="utf-8"))
-    validator = Draft202012Validator(schema)
-    errors = sorted(validator.iter_errors(instance), key=lambda error: list(error.absolute_path))
-    if errors:
-      print("schema_validation=fail")
-      for error in errors[:20]:
-          path_label = ".".join(str(part) for part in error.absolute_path) or "<root>"
-          print(f"- {path_label}: {error.message}")
-      return 2
-
-    print("schema_validation=pass")
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())