@try-works/dsh-recursive-mode 0.1.3 → 0.1.5

package/references/scripts/recursive-subagent-action.ps1

@@ -0,0 +1,98 @@
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)][string]$RunId,
+    [Parameter(Mandatory = $true)][string]$SubagentId,
+    [Parameter(Mandatory = $true)][string]$Phase,
+    [Parameter(Mandatory = $true)][string]$Purpose,
+    [Parameter(Mandatory = $true)][string]$ExecutionMode,
+    [string]$ArtifactPath = "",
+    [string]$RepoRoot = (Get-Location).Path,
+    [string[]]$UpstreamArtifact = @(),
+    [string[]]$Addendum = @(),
+    [string]$ReviewBundle = "",
+    [string]$DiffBasis = "",
+    [string[]]$CodeRef = @(),
+    [string[]]$MemoryRef = @(),
+    [string[]]$AuditQuestion = @(),
+    [string[]]$ActionTaken = @(),
+    [string[]]$CreatedFile = @(),
+    [string[]]$ModifiedFile = @(),
+    [string[]]$ReviewedFile = @(),
+    [string[]]$UntouchedFile = @(),
+    [string[]]$ArtifactRead = @(),
+    [string[]]$ArtifactUpdated = @(),
+    [string[]]$EvidenceUsed = @(),
+    [string[]]$Finding = @(),
+    [string[]]$VerificationPath = @(),
+    [string[]]$VerificationItem = @(),
+    [string]$RouterUsed = "",
+    [string]$RoutedRole = "",
+    [string]$RoutedCli = "",
+    [string]$RoutedModel = "",
+    [string]$RoutingConfigPath = "",
+    [string]$RoutingDiscoveryPath = "",
+    [string]$RoutingResolutionBasis = "",
+    [string]$RoutingFallbackReason = "",
+    [string]$CliProbeSummary = "",
+    [string]$PromptBundlePath = "",
+    [string]$InvocationExitCode = "",
+    [string[]]$OutputCapturePath = @(),
+    [string]$OutputName = ""
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$python = if ($env:PYTHON) { $env:PYTHON } elseif (Get-Command python -ErrorAction SilentlyContinue) { "python" } else { $null }
+if (-not $python) {
+    Write-Host "[FAIL] Python executable not found in PATH."
+    exit 1
+}
+
+$scriptPath = Join-Path $PSScriptRoot "recursive-subagent-action.py"
+$argsList = @(
+    $scriptPath,
+    "--repo-root", $RepoRoot,
+    "--run-id", $RunId,
+    "--subagent-id", $SubagentId,
+    "--phase", $Phase,
+    "--purpose", $Purpose,
+    "--execution-mode", $ExecutionMode
+)
+
+if ($ArtifactPath) { $argsList += @("--artifact-path", $ArtifactPath) }
+if ($ReviewBundle) { $argsList += @("--review-bundle", $ReviewBundle) }
+if ($DiffBasis) { $argsList += @("--diff-basis", $DiffBasis) }
+if ($OutputName) { $argsList += @("--output-name", $OutputName) }
+if ($RouterUsed) { $argsList += @("--router-used", $RouterUsed) }
+if ($RoutedRole) { $argsList += @("--routed-role", $RoutedRole) }
+if ($RoutedCli) { $argsList += @("--routed-cli", $RoutedCli) }
+if ($RoutedModel) { $argsList += @("--routed-model", $RoutedModel) }
+if ($RoutingConfigPath) { $argsList += @("--routing-config-path", $RoutingConfigPath) }
+if ($RoutingDiscoveryPath) { $argsList += @("--routing-discovery-path", $RoutingDiscoveryPath) }
+if ($RoutingResolutionBasis) { $argsList += @("--routing-resolution-basis", $RoutingResolutionBasis) }
+if ($RoutingFallbackReason) { $argsList += @("--routing-fallback-reason", $RoutingFallbackReason) }
+if ($CliProbeSummary) { $argsList += @("--cli-probe-summary", $CliProbeSummary) }
+if ($PromptBundlePath) { $argsList += @("--prompt-bundle-path", $PromptBundlePath) }
+if ($InvocationExitCode) { $argsList += @("--invocation-exit-code", $InvocationExitCode) }
+
+foreach ($value in @($UpstreamArtifact)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--upstream-artifact", $piece.Trim()) } } }
+foreach ($value in @($Addendum)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--addendum", $piece.Trim()) } } }
+foreach ($value in @($CodeRef)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--code-ref", $piece.Trim()) } } }
+foreach ($value in @($MemoryRef)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--memory-ref", $piece.Trim()) } } }
+foreach ($value in @($AuditQuestion)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--audit-question", $piece.Trim()) } } }
+foreach ($value in @($ActionTaken)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--action-taken", $piece.Trim()) } } }
+foreach ($value in @($CreatedFile)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--created-file", $piece.Trim()) } } }
+foreach ($value in @($ModifiedFile)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--modified-file", $piece.Trim()) } } }
+foreach ($value in @($ReviewedFile)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--reviewed-file", $piece.Trim()) } } }
+foreach ($value in @($UntouchedFile)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--untouched-file", $piece.Trim()) } } }
+foreach ($value in @($ArtifactRead)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--artifact-read", $piece.Trim()) } } }
+foreach ($value in @($ArtifactUpdated)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--artifact-updated", $piece.Trim()) } } }
+foreach ($value in @($EvidenceUsed)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--evidence-used", $piece.Trim()) } } }
+foreach ($value in @($Finding)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--finding", $piece.Trim()) } } }
+foreach ($value in @($VerificationPath)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--verification-path", $piece.Trim()) } } }
+foreach ($value in @($VerificationItem)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--verification-item", $piece.Trim()) } } }
+foreach ($value in @($OutputCapturePath)) { foreach ($piece in ($value -split ",")) { if ($piece.Trim()) { $argsList += @("--output-capture-path", $piece.Trim()) } } }
+
+& $python @argsList
+exit $LASTEXITCODE

package/references/scripts/recursive-subagent-action.py

@@ -0,0 +1,197 @@
+#!/usr/bin/env python3
+"""
+Generate a recursive-mode subagent action record scaffold.
+"""
+
+from __future__ import annotations
+
+import argparse
+import hashlib
+import re
+from datetime import datetime, timezone
+from pathlib import Path
+
+
+def normalize_repo_path(raw_path: str) -> str:
+    return raw_path.replace("\\", "/").strip().lstrip("/")
+
+
+def slugify(value: str) -> str:
+    lowered = value.strip().lower()
+    slug = re.sub(r"[^a-z0-9]+", "-", lowered).strip("-")
+    return slug or "action"
+
+
+def render_path_list(title: str, values: list[str]) -> list[str]:
+    lines = [title]
+    if not values:
+        lines.append("- none")
+        return lines
+    lines.extend(f"- `{value}`" for value in values)
+    return lines
+
+
+def render_text_list(title: str, values: list[str]) -> list[str]:
+    lines = [title]
+    if not values:
+        lines.append("- none")
+        return lines
+    lines.extend(f"- {value}" for value in values)
+    return lines
+
+
+def content_sha256(content: str) -> str:
+    normalized = content.replace("\r\n", "\n").replace("\r", "\n")
+    return hashlib.sha256(normalized.encode("utf-8")).hexdigest()
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Generate a recursive-mode subagent action record scaffold.")
+    parser.add_argument("--repo-root", default=".", help="Repository root path.")
+    parser.add_argument("--run-id", required=True, help="Run ID under .recursive/run/.")
+    parser.add_argument("--subagent-id", required=True, help="Subagent identifier.")
+    parser.add_argument("--phase", required=True, help="Phase name for the action record.")
+    parser.add_argument("--purpose", required=True, help="Invocation purpose.")
+    parser.add_argument("--execution-mode", required=True, help="Execution mode, e.g. review, audit, implementer.")
+    parser.add_argument("--artifact-path", default="", help="Repo-relative current artifact path.")
+    parser.add_argument("--upstream-artifact", action="append", default=[], help="Repo-relative upstream artifact path.")
+    parser.add_argument("--addendum", action="append", default=[], help="Repo-relative addendum path.")
+    parser.add_argument("--review-bundle", default="", help="Repo-relative review bundle path if used.")
+    parser.add_argument("--diff-basis", default="", help="Explicit diff basis summary if not inferred.")
+    parser.add_argument("--code-ref", action="append", default=[], help="Repo-relative code reference path.")
+    parser.add_argument("--memory-ref", action="append", default=[], help="Repo-relative memory doc path.")
+    parser.add_argument("--audit-question", action="append", default=[], help="Audit/task question passed to the subagent.")
+    parser.add_argument("--action-taken", action="append", default=[], help="Concrete delegated action taken by the subagent.")
+    parser.add_argument("--created-file", action="append", default=[], help="Repo-relative created file path.")
+    parser.add_argument("--modified-file", action="append", default=[], help="Repo-relative modified file path.")
+    parser.add_argument("--reviewed-file", action="append", default=[], help="Repo-relative reviewed file path.")
+    parser.add_argument("--untouched-file", action="append", default=[], help="Repo-relative relevant but untouched file path.")
+    parser.add_argument("--artifact-read", action="append", default=[], help="Repo-relative recursive artifact read by the subagent.")
+    parser.add_argument("--artifact-updated", action="append", default=[], help="Repo-relative recursive artifact updated by the subagent.")
+    parser.add_argument("--evidence-used", action="append", default=[], help="Repo-relative evidence path used by the subagent.")
+    parser.add_argument("--finding", action="append", default=[], help="Claimed finding or unresolved point.")
+    parser.add_argument("--verification-path", action="append", default=[], help="Repo-relative file or artifact path the controller should inspect first.")
+    parser.add_argument("--verification-item", action="append", default=[], help="Main-agent verification handoff item.")
+    parser.add_argument("--router-used", default="", help="Router identifier used for delegated dispatch, e.g. recursive-router.")
+    parser.add_argument("--routed-role", default="", help="Canonical routed role resolved for this action.")
+    parser.add_argument("--routed-cli", default="", help="Resolved external CLI id if any.")
+    parser.add_argument("--routed-model", default="", help="Resolved model id if any.")
+    parser.add_argument("--routing-config-path", default="", help="Repo-relative routing policy path.")
+    parser.add_argument("--routing-discovery-path", default="", help="Repo-relative routing discovery path.")
+    parser.add_argument("--routing-resolution-basis", default="", help="Short explanation of how the route was resolved.")
+    parser.add_argument("--routing-fallback-reason", default="", help="Why execution fell back from routed delegation, if applicable.")
+    parser.add_argument("--cli-probe-summary", default="", help="Compact CLI probe summary for the action record.")
+    parser.add_argument("--prompt-bundle-path", default="", help="Repo-relative routed prompt bundle path if used.")
+    parser.add_argument("--invocation-exit-code", default="", help="External CLI invocation exit code if applicable.")
+    parser.add_argument("--output-capture-path", action="append", default=[], help="Repo-relative captured output path from the routed CLI.")
+    parser.add_argument("--output-name", default="", help="Optional action record filename under subagents/.")
+    args = parser.parse_args()
+
+    repo_root = Path(args.repo_root).resolve()
+    run_dir = repo_root / ".recursive" / "run" / args.run_id.strip()
+    if not run_dir.exists():
+        print(f"[FAIL] Run directory not found: {run_dir}")
+        return 1
+
+    subagents_dir = run_dir / "subagents"
+    subagents_dir.mkdir(parents=True, exist_ok=True)
+
+    bundle_path = normalize_repo_path(args.review_bundle) if args.review_bundle.strip() else ""
+    artifact_path = normalize_repo_path(args.artifact_path) if args.artifact_path.strip() else ""
+    artifact_hash = ""
+    if artifact_path and (repo_root / artifact_path).exists():
+        artifact_hash = content_sha256((repo_root / artifact_path).read_text(encoding="utf-8"))
+
+    diff_basis = args.diff_basis.strip() or "See /.recursive/run/<run-id>/00-worktree.md for the normalized diff basis used."
+    timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    output_name = args.output_name.strip()
+    if not output_name:
+        output_name = f"{timestamp.replace(':', '').replace('-', '')}-{slugify(args.subagent_id)}-action.md"
+    if not output_name.lower().endswith(".md"):
+        output_name = f"{output_name}.md"
+    output_path = subagents_dir / output_name
+    output_rel = normalize_repo_path(str(output_path.relative_to(repo_root)))
+
+    upstream_artifacts = sorted(set(normalize_repo_path(value) for value in args.upstream_artifact if value.strip()))
+    addenda = sorted(set(normalize_repo_path(value) for value in args.addendum if value.strip()))
+    code_refs = sorted(set(normalize_repo_path(value) for value in args.code_ref if value.strip()))
+    memory_refs = sorted(set(normalize_repo_path(value) for value in args.memory_ref if value.strip()))
+    created_files = sorted(set(normalize_repo_path(value) for value in args.created_file if value.strip()))
+    modified_files = sorted(set(normalize_repo_path(value) for value in args.modified_file if value.strip()))
+    reviewed_files = sorted(set(normalize_repo_path(value) for value in args.reviewed_file if value.strip()))
+    untouched_files = sorted(set(normalize_repo_path(value) for value in args.untouched_file if value.strip()))
+    artifacts_read = sorted(set(normalize_repo_path(value) for value in args.artifact_read if value.strip()))
+    artifacts_updated = sorted(set(normalize_repo_path(value) for value in args.artifact_updated if value.strip()))
+    evidence_used = sorted(set(normalize_repo_path(value) for value in args.evidence_used if value.strip()))
+    actions_taken = [value.strip() for value in args.action_taken if value.strip()]
+    verification_paths = sorted(set(normalize_repo_path(value) for value in args.verification_path if value.strip()))
+    output_capture_paths = sorted(set(normalize_repo_path(value) for value in args.output_capture_path if value.strip()))
+    routing_config_path = normalize_repo_path(args.routing_config_path) if args.routing_config_path.strip() else ""
+    routing_discovery_path = normalize_repo_path(args.routing_discovery_path) if args.routing_discovery_path.strip() else ""
+    prompt_bundle_path = normalize_repo_path(args.prompt_bundle_path) if args.prompt_bundle_path.strip() else ""
+
+    lines: list[str] = [
+        "# Subagent Action Record",
+        "",
+        "## Metadata",
+        f"- Subagent ID: `{args.subagent_id.strip()}`",
+        f"- Run ID: `{args.run_id.strip()}`",
+        f"- Phase: `{args.phase.strip()}`",
+        f"- Purpose: `{args.purpose.strip()}`",
+        f"- Execution Mode: `{args.execution_mode.strip()}`",
+        f"- Timestamp: `{timestamp}`",
+        f"- Action Record Path: `/{output_rel}`",
+        "",
+        "## Inputs Provided",
+        f"- Current Artifact: `{('/' + artifact_path) if artifact_path else 'none'}`",
+        f"- Artifact Content Hash: `{artifact_hash or 'UNKNOWN'}`",
+    ]
+    lines.extend(render_path_list("- Upstream Artifacts:", [f"/{value}" for value in upstream_artifacts]))
+    lines.extend(render_path_list("- Addenda:", [f"/{value}" for value in addenda]))
+    lines.append(f"- Review Bundle: `{('/' + bundle_path) if bundle_path else 'none'}`")
+    lines.append(f"- Diff Basis: `{diff_basis}`")
+    lines.extend(render_path_list("- Code Refs:", [f"/{value}" for value in code_refs]))
+    lines.extend(render_path_list("- Memory Refs:", [f"/{value}" for value in memory_refs]))
+    lines.extend(render_text_list("- Audit / Task Questions:", args.audit_question))
+    lines.append("")
+    lines.append("## Routing")
+    lines.append(f"- Router Used: `{args.router_used.strip() or 'none'}`")
+    lines.append(f"- Routed Role: `{args.routed_role.strip() or 'none'}`")
+    lines.append(f"- Routed CLI: `{args.routed_cli.strip() or 'none'}`")
+    lines.append(f"- Routed Model: `{args.routed_model.strip() or 'none'}`")
+    lines.append(f"- Routing Config Path: `{('/' + routing_config_path) if routing_config_path else 'none'}`")
+    lines.append(f"- Routing Discovery Path: `{('/' + routing_discovery_path) if routing_discovery_path else 'none'}`")
+    lines.append(f"- Routing Resolution Basis: `{args.routing_resolution_basis.strip() or 'none'}`")
+    lines.append(f"- Routing Fallback Reason: `{args.routing_fallback_reason.strip() or 'none'}`")
+    lines.append(f"- CLI Probe Summary: `{args.cli_probe_summary.strip() or 'none'}`")
+    lines.append(f"- Prompt Bundle Path: `{('/' + prompt_bundle_path) if prompt_bundle_path else 'none'}`")
+    lines.append(f"- Invocation Exit Code: `{args.invocation_exit_code.strip() or 'none'}`")
+    lines.extend(render_path_list("- Output Capture Paths:", [f"/{value}" for value in output_capture_paths]))
+    lines.append("")
+    lines.extend(render_text_list("## Claimed Actions Taken", actions_taken))
+    lines.append("")
+    lines.append("## Claimed File Impact")
+    lines.extend(render_path_list("### Created", [f"/{value}" for value in created_files]))
+    lines.extend(render_path_list("### Modified", [f"/{value}" for value in modified_files]))
+    lines.extend(render_path_list("### Reviewed", [f"/{value}" for value in reviewed_files]))
+    lines.extend(render_path_list("### Relevant but Untouched", [f"/{value}" for value in untouched_files]))
+    lines.append("")
+    lines.append("## Claimed Artifact Impact")
+    lines.extend(render_path_list("### Read", [f"/{value}" for value in artifacts_read]))
+    lines.extend(render_path_list("### Updated", [f"/{value}" for value in artifacts_updated]))
+    lines.extend(render_path_list("### Evidence Used", [f"/{value}" for value in evidence_used]))
+    lines.append("")
+    lines.extend(render_text_list("## Claimed Findings", args.finding))
+    lines.append("")
+    lines.append("## Verification Handoff")
+    lines.extend(render_path_list("- Inspect first:", [f"/{value}" if value.startswith(".recursive/") else value for value in verification_paths]))
+    lines.extend(render_text_list("- Notes:", args.verification_item))
+    lines.append("")
+
+    output_path.write_text("\n".join(lines), encoding="utf-8", newline="\n")
+    print(f"[OK] Wrote subagent action record: /{output_rel}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/references/scripts/recursive-training-extract.ps1

@@ -0,0 +1,23 @@
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)][string]$RepoRoot,
+    [Parameter(Mandatory = $true)][string]$PromptFile,
+    [Parameter()][string]$ResponseFile = ""
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$python = if ($env:PYTHON) { $env:PYTHON } elseif (Get-Command python -ErrorAction SilentlyContinue) { "python" } else { $null }
+if (-not $python) {
+    Write-Host "[FAIL] Python executable not found in PATH."
+    exit 1
+}
+
+$scriptPath = Join-Path $PSScriptRoot "recursive-training-extract.py"
+$argsList = @("--repo-root", $RepoRoot, "--prompt-file", $PromptFile)
+if ($ResponseFile) {
+    $argsList += @("--response-file", $ResponseFile)
+}
+& $python $scriptPath @argsList
+exit $LASTEXITCODE

package/references/scripts/recursive-training-extract.py

@@ -0,0 +1,99 @@
+#!/usr/bin/env python3
+"""
+Companion extractor for recursive-training prompt evaluation.
+
+The training scripts build extraction prompts and hand them to this script.
+Supported evaluation modes (first match wins):
+
+1. --response-file PATH — print the file contents (agent/offline JSON)
+2. Sibling <prompt-file>.response.json — same as response-file when present
+3. RECURSIVE_TRAINING_EXTRACTOR_CMD — shell command; `{prompt_file}` and
+   `{repo_root}` are substituted; stdout is the extraction result
+4. Otherwise exit 2 (unavailable)
+
+Exit codes:
+  0: extraction text printed to stdout
+  1: invalid arguments / missing prompt
+  2: no extractor wired
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import shlex
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _run_external_command(command: str, repo_root: Path, prompt_path: Path) -> int:
+    rendered = command.format(prompt_file=str(prompt_path), repo_root=str(repo_root))
+    # Windows-friendly: run via shell when the command is a single string template
+    result = subprocess.run(
+        rendered if os.name == "nt" else shlex.split(rendered),
+        check=False,
+        capture_output=True,
+        text=True,
+        shell=(os.name == "nt"),
+    )
+    if result.returncode != 0:
+        err = (result.stderr or result.stdout or "extractor command failed").strip()
+        print(err, file=sys.stderr)
+        return result.returncode if result.returncode != 2 else 1
+    sys.stdout.write(result.stdout)
+    if result.stdout and not result.stdout.endswith("\n"):
+        sys.stdout.write("\n")
+    return 0
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Companion extractor for recursive-training")
+    parser.add_argument("--repo-root", required=True, help="Repository root path")
+    parser.add_argument("--prompt-file", required=True, help="Path to the prompt file to evaluate")
+    parser.add_argument(
+        "--response-file",
+        default="",
+        help="Optional precomputed JSON/text response to emit instead of calling a model",
+    )
+    args = parser.parse_args()
+
+    repo_root = Path(args.repo_root).resolve()
+    prompt_path = Path(args.prompt_file).resolve()
+    if not prompt_path.exists():
+        print("ERROR: Prompt file not found for recursive-training extraction.", file=sys.stderr)
+        return 1
+
+    response_path = Path(args.response_file).resolve() if args.response_file.strip() else None
+    if response_path is None:
+        sibling = prompt_path.with_suffix(prompt_path.suffix + ".response.json")
+        if not sibling.exists():
+            sibling = Path(str(prompt_path) + ".response.json")
+        if sibling.exists():
+            response_path = sibling
+
+    if response_path is not None:
+        if not response_path.exists():
+            print(f"ERROR: Response file not found: {response_path}", file=sys.stderr)
+            return 1
+        payload = response_path.read_text(encoding="utf-8")
+        sys.stdout.write(payload)
+        if payload and not payload.endswith("\n"):
+            sys.stdout.write("\n")
+        return 0
+
+    extractor_cmd = os.environ.get("RECURSIVE_TRAINING_EXTRACTOR_CMD", "").strip()
+    if extractor_cmd:
+        return _run_external_command(extractor_cmd, repo_root, prompt_path)
+
+    print(
+        "Training extractor is not available for recursive-training in this environment.\n"
+        "Wire one of: --response-file, <prompt>.response.json, or "
+        "RECURSIVE_TRAINING_EXTRACTOR_CMD.",
+        file=sys.stderr,
+    )
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/references/scripts/recursive-training-grpo.ps1

@@ -0,0 +1,52 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Repository-local Training-Free GRPO for recursive-mode runs (PowerShell wrapper).
+
+.DESCRIPTION
+    Thin wrapper that calls recursive-training-grpo.py with the same arguments.
+    Extraction is delegated to recursive-training-extract.py (response-file or
+    RECURSIVE_TRAINING_EXTRACTOR_CMD). This wrapper does not select an LLM provider.
+#>
+
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$RepoRoot,
+
+    [Parameter()]
+    [switch]$Incremental,
+
+    [Parameter()]
+    [string]$RunId,
+
+    [Parameter()]
+    [int]$WinnerOnlyThreshold = 0
+)
+
+$python = Get-Command python -ErrorAction SilentlyContinue
+if (-not $python) {
+    $python = Get-Command python3 -ErrorAction SilentlyContinue
+}
+
+if (-not $python) {
+    Write-Error "Python is required but not found. Please install Python 3.10+."
+    exit 1
+}
+
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$pyScript = Join-Path $scriptDir "recursive-training-grpo.py"
+
+$argsList = @("--repo-root", $RepoRoot)
+if ($Incremental) {
+    $argsList += "--incremental"
+}
+if ($RunId) {
+    $argsList += @("--run-id", $RunId)
+}
+if ($WinnerOnlyThreshold -gt 0) {
+    $argsList += @("--winner-only-threshold", "$WinnerOnlyThreshold")
+}
+
+& $python.Source $pyScript @argsList
+exit $LASTEXITCODE