package.json

{
  "name": "ralphdex",
  "displayName": "Ralphdex",
  "description": "VS Code extension for file-backed Ralphdex prompts, IDE handoff, and CLI exec loops.",
  "version": "1.3.1",
  "publisher": "s0l0m0n8und9",
  "icon": "media/ralph-icon.png",
  "homepage": "https://github.com/S0l0m0n8und9/RalphDex#readme",
  "bugs": {
    "url": "https://github.com/S0l0m0n8und9/RalphDex/issues"
  },
  "markdown": "github",
  "galleryBanner": {
    "color": "#111827",
    "theme": "dark"
  },
  "keywords": [
    "ai",
    "agent",
    "ralphdex",
    "automation",
    "codex",
    "vscode",
    "prompts",
    "provenance",
    "claude",
    "task-runner",
    "agentic"
  ],
  "repository": {
    "type": "git",
    "url": "https://github.com/S0l0m0n8und9/RalphDex.git"
  },
  "license": "MIT",
  "engines": {
    "vscode": "^1.95.0",
    "node": ">=22"
  },
  "categories": [
    "AI",
    "Other"
  ],
  "capabilities": {
    "untrustedWorkspaces": {
      "supported": "limited",
      "description": "Ralphdex supports status inspection in untrusted workspaces. Prompt generation, runtime state reset, IDE handoff, and CLI execution require workspace trust.",
      "restrictedConfigurations": [
        "ralphCodex.codexCommandPath",
        "ralphCodex.claudeCommandPath",
        "ralphCodex.copilotCommandPath",
        "ralphCodex.geminiCommandPath",
        "ralphCodex.copilotFoundry",
        "ralphCodex.azureFoundry",
        "ralphCodex.preferredHandoffMode",
        "ralphCodex.agentId",
        "ralphCodex.agentRole",
        "ralphCodex.inspectionRootOverride",
        "ralphCodex.ralphIterationCap",
        "ralphCodex.verifierModes",
        "ralphCodex.noProgressThreshold",
        "ralphCodex.repeatedFailureThreshold",
        "ralphCodex.artifactRetentionPath",
        "ralphCodex.generatedArtifactRetentionCount",
        "ralphCodex.provenanceBundleRetentionCount",
        "ralphCodex.gitCheckpointMode",
        "ralphCodex.scmStrategy",
        "ralphCodex.scmPrOnParentDone",
        "ralphCodex.watchdogStaleTtlMs",
        "ralphCodex.validationCommandOverride",
        "ralphCodex.stopOnHumanReviewNeeded",
        "ralphCodex.autonomyMode",
        "ralphCodex.autoReplenishBacklog",
        "ralphCodex.autoApplyRemediation",
        "ralphCodex.ralphTaskFilePath",
        "ralphCodex.prdPath",
        "ralphCodex.progressPath",
        "ralphCodex.structureDefinitionPath",
        "ralphCodex.promptTemplateDirectory",
        "ralphCodex.promptIncludeVerifierFeedback",
        "ralphCodex.promptPriorContextBudget",
        "ralphCodex.promptBudgetProfile",
        "ralphCodex.customPromptBudget",
        "ralphCodex.clipboardAutoCopy",
        "ralphCodex.model",
        "ralphCodex.reasoningEffort",
        "ralphCodex.approvalMode",
        "ralphCodex.sandboxMode",
        "ralphCodex.claudePermissionMode",
        "ralphCodex.copilotApprovalMode",
        "ralphCodex.openSidebarCommandId",
        "ralphCodex.newChatCommandId",
        "ralphCodex.agentCount",
        "ralphCodex.promptCaching",
        "ralphCodex.memoryStrategy",
        "ralphCodex.memoryWindowSize",
        "ralphCodex.memorySummaryThreshold",
        "ralphCodex.prdGenerationTemplate"
      ]
    },
    "virtualWorkspaces": {
      "supported": false,
      "description": "Ralphdex requires a real local workspace because it reads and writes Ralph files and can run CLI backends."
    }
  },
  "activationEvents": [
    "onCommand:ralphCodex.addTask",
    "onCommand:ralphCodex.seedTasksFromFeatureRequest",
    "onCommand:ralphCodex.generatePrompt",
    "onCommand:ralphCodex.openCodexAndCopyPrompt",
    "onCommand:ralphCodex.runRalphIteration",
    "onCommand:ralphCodex.runReviewAgent",
    "onCommand:ralphCodex.runWatchdogAgent",
    "onCommand:ralphCodex.runScmAgent",
    "onCommand:ralphCodex.runRalphLoop",
    "onCommand:ralphCodex.stopLoop",
    "onCommand:ralphCodex.runMultiAgentLoop",
    "onCommand:ralphCodex.showRalphStatus",
    "onCommand:ralphCodex.openFailureDiagnosis",
    "onCommand:ralphCodex.autoRecoverTask",
    "onCommand:ralphCodex.skipTask",
    "onCommand:ralphCodex.openLatestRalphSummary",
    "onCommand:ralphCodex.openLatestProvenanceBundle",
    "onCommand:ralphCodex.openLatestPromptEvidence",
    "onCommand:ralphCodex.openLatestCliTranscript",
    "onCommand:ralphCodex.applyLatestTaskDecompositionProposal",
    "onCommand:ralphCodex.resolveStaleTaskClaim",
    "onCommand:ralphCodex.revealLatestProvenanceBundleDirectory",
    "onCommand:ralphCodex.cleanupRalphRuntimeArtifacts",
    "onCommand:ralphCodex.resetRalphWorkspaceState",
    "onCommand:ralphCodex.runPipeline",
    "onCommand:ralphCodex.openLatestPipelineRun",
    "onCommand:ralphCodex.openLatestDoctrineProposal",
    "onCommand:ralphCodex.applyLatestDoctrineProposal",
    "onCommand:ralphCodex.rejectLatestDoctrineProposal",
    "onCommand:ralphCodex.initializeDoctrinePack",
    "onCommand:ralphCodex.openDoctrineAgents",
    "onCommand:ralphCodex.openDoctrineBoundaries",
    "onCommand:ralphCodex.openDoctrineInvariants",
    "onCommand:ralphCodex.openDoctrineFolder",
    "onCommand:ralphCodex.openPrdWizard",
    "onCommand:ralphCodex.regeneratePrd",
    "onCommand:ralphCodex.requeueDeadLetterTask",
    "onView:ralphCodex.dashboard",
    "onCommand:ralphCodex.setProviderSecret",
    "onCommand:ralphCodex.clearProviderSecret",
    "onCommand:ralphCodex.openSettings",
    "onCommand:ralphCodex.showSidebar",
    "onCommand:ralphCodex.showTasks",
    "onCommand:ralphCodex.showDashboard",
    "onCommand:ralphCodex.openDashboard"
  ],
  "main": "./out/extension.js",
  "contributes": {
    "commands": [
      {
        "command": "ralphCodex.addTask",
        "title": "Ralphdex: Add Task"
      },
      {
        "command": "ralphCodex.seedTasksFromFeatureRequest",
        "title": "Ralphdex: Seed Tasks from Feature Request"
      },
      {
        "command": "ralphCodex.generatePrompt",
        "title": "Ralphdex: Prepare IDE Prompt"
      },
      {
        "command": "ralphCodex.initializeDoctrinePack",
        "title": "Ralphdex: Initialize Doctrine Pack"
      },
      {
        "command": "ralphCodex.openDoctrineFolder",
        "title": "Ralphdex: Open Doctrine Folder"
      },
      {
        "command": "ralphCodex.openDoctrineInvariants",
        "title": "Ralphdex: Open Doctrine Invariants"
      },
      {
        "command": "ralphCodex.openDoctrineBoundaries",
        "title": "Ralphdex: Open Doctrine Boundaries"
      },
      {
        "command": "ralphCodex.openDoctrineAgents",
        "title": "Ralphdex: Open Doctrine Agents"
      },
      {
        "command": "ralphCodex.openCodexAndCopyPrompt",
        "title": "Ralphdex: Open Codex IDE"
      },
      {
        "command": "ralphCodex.runRalphIteration",
        "title": "Ralphdex: Run Single Iteration"
      },
      {
        "command": "ralphCodex.runReviewAgent",
        "title": "Ralphdex: Run Review Agent"
      },
      {
        "command": "ralphCodex.runWatchdogAgent",
        "title": "Ralphdex: Run Watchdog Agent"
      },
      {
        "command": "ralphCodex.runScmAgent",
        "title": "Ralphdex: Run SCM Agent"
      },
      {
        "command": "ralphCodex.runRalphLoop",
        "title": "Ralphdex: Run Loop"
      },
      {
        "command": "ralphCodex.stopLoop",
        "title": "Ralphdex: Stop Loop"
      },
      {
        "command": "ralphCodex.runMultiAgentLoop",
        "title": "Ralphdex: Run Multi-Agent Loop"
      },
      {
        "command": "ralphCodex.showRalphStatus",
        "title": "Ralphdex: Show Status"
      },
      {
        "command": "ralphCodex.openFailureDiagnosis",
        "title": "Ralphdex: Open Failure Diagnosis"
      },
      {
        "command": "ralphCodex.autoRecoverTask",
        "title": "Ralphdex: Auto-Recover Task"
      },
      {
        "command": "ralphCodex.skipTask",
        "title": "Ralphdex: Skip Task"
      },
      {
        "command": "ralphCodex.openLatestRalphSummary",
        "title": "Ralphdex: Open Latest Ralph Summary"
      },
      {
        "command": "ralphCodex.openLatestProvenanceBundle",
        "title": "Ralphdex: Open Latest Provenance Bundle"
      },
      {
        "command": "ralphCodex.openLatestPromptEvidence",
        "title": "Ralphdex: Open Latest Prompt Evidence"
      },
      {
        "command": "ralphCodex.openLatestCliTranscript",
        "title": "Ralphdex: Open Latest CLI Transcript"
      },
      {
        "command": "ralphCodex.applyLatestTaskDecompositionProposal",
        "title": "Ralphdex: Apply Latest Task Decomposition Proposal"
      },
      {
        "command": "ralphCodex.resolveStaleTaskClaim",
        "title": "Ralphdex: Resolve Stale Task Claim"
      },
      {
        "command": "ralphCodex.revealLatestProvenanceBundleDirectory",
        "title": "Ralphdex: Reveal Latest Provenance Bundle Directory"
      },
      {
        "command": "ralphCodex.cleanupRalphRuntimeArtifacts",
        "title": "Ralphdex: Clean Up Old Run Artifacts"
      },
      {
        "command": "ralphCodex.resetRalphWorkspaceState",
        "title": "Ralphdex: Reset Runtime State"
      },
      {
        "command": "ralphCodex.showDashboard",
        "title": "Ralphdex: Focus Dashboard"
      },
      {
        "command": "ralphCodex.openDashboard",
        "title": "Ralphdex: Open Dashboard"
      },
      {
        "command": "ralphCodex.runPipeline",
        "title": "Ralphdex: Run Full Workflow"
      },
      {
        "command": "ralphCodex.openLatestPipelineRun",
        "title": "Ralphdex: Open Latest Run Report"
      },
      {
        "command": "ralphCodex.openLatestDoctrineProposal",
        "title": "Ralphdex: Open Latest Doctrine Proposal"
      },
      {
        "command": "ralphCodex.applyLatestDoctrineProposal",
        "title": "Ralphdex: Apply Latest Doctrine Proposal"
      },
      {
        "command": "ralphCodex.rejectLatestDoctrineProposal",
        "title": "Ralphdex: Reject Latest Doctrine Proposal"
      },
      {
        "command": "ralphCodex.openPrdWizard",
        "title": "Ralphdex: Open PRD Wizard"
      },
      {
        "command": "ralphCodex.regeneratePrd",
        "title": "Ralphdex: Regenerate PRD"
      },
      {
        "command": "ralphCodex.requeueDeadLetterTask",
        "title": "Ralphdex: Requeue Recovery Task"
      },
      {
        "command": "ralphCodex.showSidebar",
        "title": "Ralphdex: Show Sidebar"
      },
      {
        "command": "ralphCodex.setProviderSecret",
        "title": "Ralphdex: Set Provider Secret"
      },
      {
        "command": "ralphCodex.clearProviderSecret",
        "title": "Ralphdex: Clear Provider Secret"
      },
      {
        "command": "ralphCodex.showTasks",
        "title": "Ralphdex: Show Tasks"
      },
      {
        "command": "ralphCodex.openSettings",
        "title": "Ralphdex: Open RalphDex Settings"
      }
    ],
    "viewsContainers": {
      "activitybar": [
        {
          "id": "ralphCodex",
          "title": "Ralphdex",
          "icon": "media/ralph-icon.svg"
        }
      ]
    },
    "views": {
      "ralphCodex": [
        {
          "type": "webview",
          "id": "ralphCodex.dashboard",
          "name": "Dashboard"
        }
      ]
    },
    "walkthroughs": [
      {
        "id": "ralphdexGettingStarted",
        "title": "Get started with Ralphdex",
        "description": "Set up a durable, file-backed agentic coding loop in four steps.",
        "steps": [
          {
            "id": "ralphdex.createPrd",
            "title": "Create your PRD and task backlog",
            "description": "Scaffold `.ralph/` with a product brief and a starter task backlog.\n[Open PRD Wizard](command:ralphCodex.openPrdWizard)",
            "media": {
              "markdown": "media/walkthrough/01-prd.md"
            },
            "completionEvents": [
              "onCommand:ralphCodex.openPrdWizard"
            ]
          },
          {
            "id": "ralphdex.checkProvider",
            "title": "Confirm your AI provider",
            "description": "Ralphdex runs iterations through a provider CLI or Azure endpoint. Confirm yours is ready in the First-Run Readiness card.\n[Show Status](command:ralphCodex.showRalphStatus)",
            "media": {
              "markdown": "media/walkthrough/02-provider.md"
            },
            "completionEvents": [
              "onCommand:ralphCodex.showRalphStatus"
            ]
          },
          {
            "id": "ralphdex.runIteration",
            "title": "Run your first iteration",
            "description": "Execute one deterministic Ralph cycle and inspect its stop reason.\n[Run Single Iteration](command:ralphCodex.runRalphIteration)",
            "media": {
              "markdown": "media/walkthrough/03-iterate.md"
            },
            "completionEvents": [
              "onCommand:ralphCodex.runRalphIteration"
            ]
          },
          {
            "id": "ralphdex.readDashboard",
            "title": "Read the dashboard",
            "description": "See what happened and why, with plain-language stop reasons and artifact links.\n[Show Status](command:ralphCodex.showRalphStatus)",
            "media": {
              "markdown": "media/walkthrough/04-dashboard.md"
            }
          }
        ]
      }
    ],
    "menus": {
      "commandPalette": [
        {
          "command": "ralphCodex.openLatestRalphSummary",
          "when": "false"
        },
        {
          "command": "ralphCodex.openLatestProvenanceBundle",
          "when": "false"
        },
        {
          "command": "ralphCodex.openLatestPromptEvidence",
          "when": "false"
        },
        {
          "command": "ralphCodex.openLatestCliTranscript",
          "when": "false"
        },
        {
          "command": "ralphCodex.openLatestPipelineRun",
          "when": "false"
        },
        {
          "command": "ralphCodex.revealLatestProvenanceBundleDirectory",
          "when": "false"
        },
        {
          "command": "ralphCodex.openDoctrineFolder",
          "when": "false"
        },
        {
          "command": "ralphCodex.openDoctrineInvariants",
          "when": "false"
        },
        {
          "command": "ralphCodex.openDoctrineBoundaries",
          "when": "false"
        },
        {
          "command": "ralphCodex.openDoctrineAgents",
          "when": "false"
        },
        {
          "command": "ralphCodex.openLatestDoctrineProposal",
          "when": "false"
        },
        {
          "command": "ralphCodex.applyLatestDoctrineProposal",
          "when": "false"
        },
        {
          "command": "ralphCodex.rejectLatestDoctrineProposal",
          "when": "false"
        },
        {
          "command": "ralphCodex.applyLatestTaskDecompositionProposal",
          "when": "false"
        },
        {
          "command": "ralphCodex.showDashboard",
          "when": "false"
        },
        {
          "command": "ralphCodex.openDashboard",
          "when": "false"
        }
      ]
    },
    "configuration": {
      "title": "Ralphdex",
      "properties": {
        "ralphCodex.cliProvider": {
          "type": "string",
          "enum": [
            "codex",
            "claude",
            "copilot",
            "copilot-byok",
            "copilot-foundry",
            "azure-foundry",
            "gemini"
          ],
          "default": "claude",
          "description": "Which CLI backend to use for scripted iterations. 'codex' uses the OpenAI Codex CLI, 'claude' uses the Anthropic Claude CLI, 'copilot' uses the GitHub Copilot CLI, 'copilot-byok' uses the Copilot CLI with an external BYOK provider, 'copilot-foundry' is a preset alias for copilot-byok with providerType azure, 'azure-foundry' uses Azure AI Foundry directly, and 'gemini' uses the Google Gemini CLI."
        },
        "ralphCodex.codexCommandPath": {
          "type": "string",
          "default": "codex",
          "description": "Path or command name for the Codex CLI executable."
        },
        "ralphCodex.claudeCommandPath": {
          "type": "string",
          "default": "claude",
          "description": "Path or command name for the Claude CLI executable."
        },
        "ralphCodex.copilotCommandPath": {
          "type": "string",
          "default": "copilot",
          "description": "Path or command name for the GitHub Copilot CLI executable."
        },
        "ralphCodex.geminiCommandPath": {
          "type": "string",
          "default": "gemini",
          "description": "Path or command name for the Google Gemini CLI executable. Requires GEMINI_API_KEY to be set in the environment."
        },
        "ralphCodex.copilotFoundry": {
          "type": "object",
          "default": {
            "commandPath": "copilot",
            "providerType": "azure",
            "baseUrlOverride": "",
            "model": "",
            "azure": {
              "resourceName": "",
              "deployment": ""
            },
            "offline": false,
            "requiredApiKeyEnvVar": "COPILOT_PROVIDER_API_KEY",
            "approvalMode": "allow-tools-only",
            "maxAutopilotContinues": 200
          },
          "description": "Copilot CLI + BYOK provider settings (used by both copilot-byok and copilot-foundry). Auth credentials are inherited from the operator process environment — RalphDex never reads or stores API key values.",
          "properties": {
            "commandPath": {
              "type": "string",
              "default": "copilot",
              "description": "Path or command name for the Copilot CLI executable."
            },
            "providerType": {
              "type": "string",
              "enum": [
                "azure",
                "openai",
                "anthropic"
              ],
              "default": "azure",
              "description": "Target LLM provider type for BYOK routing. For copilot-foundry alias, this is always 'azure'."
            },
            "baseUrlOverride": {
              "type": "string",
              "default": "",
              "description": "Full base URL override. Required for non-azure provider types. For azure, derived from azure.resourceName and azure.deployment if not set."
            },
            "model": {
              "type": "string",
              "default": "",
              "description": "Model name passed as COPILOT_MODEL to the child process environment."
            },
            "azure": {
              "type": "object",
              "default": {
                "resourceName": "",
                "deployment": ""
              },
              "description": "Azure OpenAI resource and deployment settings. Used to derive the base URL when providerType is azure.",
              "properties": {
                "resourceName": {
                  "type": "string",
                  "default": "",
                  "description": "Azure OpenAI resource name. Derived base URL: https://<resourceName>.openai.azure.com/openai/deployments/<deployment>."
                },
                "deployment": {
                  "type": "string",
                  "default": "",
                  "description": "Azure deployment name, appended to the base URL path and used for COPILOT_MODEL if model is not set."
                }
              }
            },
            "offline": {
              "type": "boolean",
              "default": false,
              "description": "When true, sets COPILOT_OFFLINE=true in the child process environment."
            },
            "requiredApiKeyEnvVar": {
              "type": "string",
              "default": "COPILOT_PROVIDER_API_KEY",
              "description": "Name of the environment variable that must be set by the operator before launch. Used for preflight readiness checks only; secret values are never stored or logged by RalphDex."
            },
            "approvalMode": {
              "type": "string",
              "enum": [
                "allow-all",
                "allow-tools-only",
                "interactive"
              ],
              "default": "allow-tools-only",
              "description": "Approval posture used by the Copilot CLI harness."
            },
            "maxAutopilotContinues": {
              "type": "number",
              "default": 200,
              "minimum": 1,
              "maximum": 500,
              "description": "Maximum number of autopilot continuation turns per Copilot CLI invocation."
            }
          }
        },
        "ralphCodex.azureFoundry": {
          "type": "object",
          "default": {
            "commandPath": "azure-foundry",
            "endpointUrl": "",
            "modelDeployment": "",
            "apiVersion": "2024-12-01-preview",
            "auth": {
              "mode": "az-bearer",
              "tenantId": "",
              "subscriptionId": "",
              "apiKeyEnvVar": "",
              "secretStorageKey": ""
            }
          },
          "description": "Grouped Azure AI Foundry direct-provider settings. Secrets are resolved externally and are not stored in settings.",
          "properties": {
            "commandPath": {
              "type": "string",
              "default": "azure-foundry",
              "description": "Path or command name for the Azure AI Foundry CLI executable."
            },
            "endpointUrl": {
              "type": "string",
              "default": "",
              "description": "Azure AI Foundry endpoint URL (e.g. https://<resource>.openai.azure.com/)."
            },
            "modelDeployment": {
              "type": "string",
              "default": "",
              "description": "Azure AI Foundry model deployment name (e.g. gpt-4o)."
            },
            "apiVersion": {
              "type": "string",
              "default": "2024-12-01-preview",
              "description": "Azure OpenAI API version to use with Azure AI Foundry."
            },
            "auth": {
              "type": "object",
              "default": {
                "mode": "az-bearer",
                "tenantId": "",
                "subscriptionId": "",
                "apiKeyEnvVar": "",
                "secretStorageKey": ""
              },
              "description": "Azure auth source metadata. Secrets are resolved externally, not stored in settings.",
              "properties": {
                "mode": {
                  "type": "string",
                  "enum": [
                    "az-bearer",
                    "env-api-key",
                    "vscode-secret"
                  ],
                  "default": "az-bearer",
                  "description": "How the provider resolves Azure credentials."
                },
                "tenantId": {
                  "type": "string",
                  "default": "",
                  "description": "Azure tenant identifier used for bearer-token auth."
                },
                "subscriptionId": {
                  "type": "string",
                  "default": "",
                  "description": "Azure subscription identifier used for readiness diagnostics."
                },
                "apiKeyEnvVar": {
                  "type": "string",
                  "default": "",
                  "description": "Environment variable name used when the API key is sourced externally."
                },
                "secretStorageKey": {
                  "type": "string",
                  "default": "",
                  "description": "SecretStorage key used when the API key is sourced from VS Code secrets."
                }
              }
            }
          }
        },
        "ralphCodex.claudeMaxTurns": {
          "type": "number",
          "default": 125,
          "minimum": 1,
          "maximum": 500,
          "description": "Maximum number of agentic turns per Claude CLI invocation."
        },
        "ralphCodex.copilotMaxAutopilotContinues": {
          "type": "number",
          "default": 200,
          "minimum": 1,
          "maximum": 500,
          "description": "Maximum number of autopilot continuation turns per Copilot CLI invocation. Maps to --max-autopilot-continues."
        },
        "ralphCodex.claudePermissionMode": {
          "type": "string",
          "enum": [
            "dangerously-skip-permissions",
            "default"
          ],
          "default": "default",
          "description": "Permission mode for Claude CLI runs. 'default' keeps Claude's standard permission checks. 'dangerously-skip-permissions' is a permissive override and should be enabled explicitly by the operator."
        },
        "ralphCodex.copilotApprovalMode": {
          "type": "string",
          "enum": [
            "allow-all",
            "allow-tools-only",
            "interactive"
          ],
          "default": "allow-tools-only",
          "description": "Approval posture for GitHub Copilot CLI runs. 'allow-tools-only' is the safer default. 'interactive' is stricter, and 'allow-all' is permissive and should be selected explicitly by the operator."
        },
        "ralphCodex.agentId": {
          "type": "string",
          "default": "default",
          "description": "Identity Ralph writes into claims and iteration artifacts. Set a unique value per concurrent loop instance so multiple agents do not share the same durable identity."
        },
        "ralphCodex.agentRole": {
          "type": "string",
          "enum": [
            "implementer",
            "planner",
            "reviewer",
            "build",
            "review",
            "watchdog",
            "scm"
          ],
          "enumDescriptions": [
            "Performs implementation work on assigned tasks (default crew role).",
            "Decomposes requirements into subtasks and sequences the crew's work plan.",
            "Validates completed work against acceptance criteria and flags gaps.",
            "Performs implementation work (legacy alias for implementer).",
            "Performs review-only validation and gap analysis (internal system role).",
            "Performs bounded claim/task recovery when agents stall (internal system role).",
            "Performs source-control follow-through for branch-per-task flows (internal system role)."
          ],
          "default": "implementer",
          "description": "Role contract for the active Ralph agent. User-facing crew roles: 'implementer', 'planner', 'reviewer'. Internal system roles assigned automatically: 'build', 'review', 'watchdog', 'scm'."
        },
        "ralphCodex.preferredHandoffMode": {
          "type": "string",
          "enum": [
            "ideCommand",
            "clipboard",
            "cliExec"
          ],
          "default": "clipboard",
          "description": "Preferred way to hand a generated prompt to Codex. IDE command mode uses documented VS Code commands plus clipboard, clipboard mode only copies the prompt, and cliExec is reserved for command-driven runs."
        },
        "ralphCodex.inspectionRootOverride": {
          "type": "string",
          "default": "",
          "description": "Optional workspace-relative or absolute directory inside the workspace to inspect, execute, and verify from instead of using Ralph's shallow root-selection heuristics."
        },
        "ralphCodex.ralphIterationCap": {
          "type": "number",
          "default": 20,
          "minimum": 1,
          "maximum": 100,
          "description": "Maximum number of CLI iterations to run for the Ralphdex loop command."
        },
        "ralphCodex.verifierModes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "validationCommand",
              "gitDiff",
              "taskState"
            ]
          },
          "default": [
            "validationCommand",
            "gitDiff",
            "taskState"
          ],
          "description": "Verifier layers to run after each CLI iteration. validationCommand runs the selected validation command, gitDiff checks for relevant file changes, and taskState compares durable Ralph task/progress state."
        },
        "ralphCodex.noProgressThreshold": {
          "type": "number",
          "default": 2,
          "minimum": 1,
          "maximum": 20,
          "description": "Number of consecutive no-progress Ralph iterations that stop the loop."
        },
        "ralphCodex.repeatedFailureThreshold": {
          "type": "number",
          "default": 2,
          "minimum": 1,
          "maximum": 20,
          "description": "Number of consecutive identical blocked/failed/human-review classifications that stop the loop."
        },
        "ralphCodex.artifactRetentionPath": {
          "type": "string",
          "default": ".ralph/artifacts",
          "description": "Workspace-relative or absolute directory used for per-iteration Ralph artifacts."
        },
        "ralphCodex.generatedArtifactRetentionCount": {
          "type": "number",
          "default": 25,
          "minimum": 0,
          "maximum": 500,
          "description": "How many of the newest generated prompt files, transcript or last-message pairs, and iteration artifact directories to keep before adding any older state-linked or latest-pointer-protected references. Cleanup runs after Ralph persists prompt or iteration provenance, protection never evicts the newest retained entries, and 0 disables automatic cleanup."
        },
        "ralphCodex.provenanceBundleRetentionCount": {
          "type": "number",
          "default": 25,
          "minimum": 0,
          "maximum": 500,
          "description": "How many of the newest provenance bundle directories to keep under .ralph/artifacts/runs/ before adding any older latest-pointer-protected bundles. Cleanup runs after bundle writes, protection never evicts the newest retained entries, and 0 disables automatic cleanup."
        },
        "ralphCodex.gitCheckpointMode": {
          "type": "string",
          "enum": [
            "off",
            "snapshot",
            "snapshotAndDiff"
          ],
          "default": "snapshotAndDiff",
          "description": "Controls optional Git safety artifacts. snapshot records pre/post status when Git is available. snapshotAndDiff also records a working-tree diff summary."
        },
        "ralphCodex.scmStrategy": {
          "type": "string",
          "enum": [
            "none",
            "commit-on-done",
            "branch-per-task"
          ],
          "default": "none",
          "description": "Controls optional SCM automation after Ralph reconciles task results. none disables SCM actions, commit-on-done creates a commit after a task is reconciled done, and branch-per-task commits task branches and merges completed child slices through the recorded integration branch flow."
        },
        "ralphCodex.scmPrOnParentDone": {
          "type": "boolean",
          "default": false,
          "description": "When enabled with scmStrategy = branch-per-task, Ralph pushes ralph/integration/<parentId> and opens a GitHub pull request through gh when the final child completion auto-completes a parent task. Push or PR failures are reported as iteration warnings without rolling back completion."
        },
        "ralphCodex.watchdogStaleTtlMs": {
          "type": "number",
          "default": 86400000,
          "minimum": 0,
          "description": "Time-to-live in milliseconds for active claims before the watchdog considers them stale. Defaults to 86400000 (24 hours). Set to 0 to treat every active claim as immediately stale for testing purposes."
        },
        "ralphCodex.validationCommandOverride": {
          "type": "string",
          "default": "",
          "description": "Optional shell command to use as the primary post-iteration validator instead of task hints or inferred workspace commands."
        },
        "ralphCodex.stopOnHumanReviewNeeded": {
          "type": "boolean",
          "default": true,
          "description": "Stop the Ralph loop immediately when the task-state verifier classifies an iteration as needs_human_review."
        },
        "ralphCodex.autonomyMode": {
          "type": "string",
          "enum": [
            "supervised",
            "autonomous"
          ],
          "default": "autonomous",
          "description": "Shorthand for Ralph loop autonomy. 'supervised' leaves the individual autonomy settings untouched; 'autonomous' forces autoApplyRemediation to both decompose_task and mark_blocked, and autoReplenishBacklog on, while preserving hard stops such as blocked preflight, request_human_review, and manual PRD authorship."
        },
        "ralphCodex.autoReplenishBacklog": {
          "type": "boolean",
          "default": true,
          "description": "Continue the Ralph loop into backlog replenishment when no actionable task remains and preflight found no ledger-drift safety errors."
        },
        "ralphCodex.autoApplyRemediation": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "decompose_task",
              "mark_blocked"
            ]
          },
          "default": [
            "decompose_task",
            "mark_blocked"
          ],
          "description": "Opt-in remediation actions Ralph may auto-apply after repeated-stop evidence. Leave this empty to preserve review-only behavior; set one or both of decompose_task and mark_blocked to allow only those actions."
        },
        "ralphCodex.ralphTaskFilePath": {
          "type": "string",
          "default": ".ralph/tasks.json",
          "description": "Workspace-relative path to the durable Ralph task file."
        },
        "ralphCodex.prdPath": {
          "type": "string",
          "default": ".ralph/prd.md",
          "description": "Workspace-relative path to the durable Ralph PRD or objective file."
        },
        "ralphCodex.progressPath": {
          "type": "string",
          "default": ".ralph/progress.md",
          "description": "Workspace-relative path to the durable Ralph progress log."
        },
        "ralphCodex.structureDefinitionPath": {
          "type": "string",
          "default": ".ralph/structure.json",
          "description": "Workspace-relative path to the repo structure definition file (structure.d). Describes directory roles, placement rules, naming conventions, and forbidden paths so Ralph respects the repo's existing layout."
        },
        "ralphCodex.promptTemplateDirectory": {
          "type": "string",
          "default": "",
          "description": "Optional workspace-relative or absolute directory containing Ralph prompt templates. Leave empty to use the bundled templates."
        },
        "ralphCodex.promptIncludeVerifierFeedback": {
          "type": "boolean",
          "default": true,
          "description": "Include compact prior iteration and verifier feedback when shaping the next prompt."
        },
        "ralphCodex.promptPriorContextBudget": {
          "type": "number",
          "default": 8,
          "minimum": 1,
          "maximum": 40,
          "description": "Maximum number of concise prior-iteration bullet lines to carry into the next prompt."
        },
        "ralphCodex.promptBudgetProfile": {
          "type": "string",
          "enum": [
            "codex",
            "claude",
            "custom"
          ],
          "default": "codex",
          "description": "Prompt-budget policy profile for Ralph prompt shaping. 'codex' uses the calibrated default matrix, 'claude' uses a higher-context deterministic matrix that must be calibrated before production use, and 'custom' reads per-policy targetTokens overrides from ralphCodex.customPromptBudget."
        },
        "ralphCodex.customPromptBudget": {
          "type": "object",
          "default": {},
          "additionalProperties": {
            "type": "number",
            "minimum": 1
          },
          "description": "Optional targetTokens overrides used only when ralphCodex.promptBudgetProfile is 'custom'. Keys must match promptKind:promptTarget entries such as iteration:cliExec."
        },
        "ralphCodex.clipboardAutoCopy": {
          "type": "boolean",
          "default": true,
          "description": "Automatically copy generated prompts to the clipboard when using Prepare IDE Prompt."
        },
        "ralphCodex.model": {
          "type": "string",
          "default": "claude-sonnet-4-6",
          "description": "Default model for CLI runs. The configured provider decides which model IDs are valid."
        },
        "ralphCodex.reasoningEffort": {
          "type": "string",
          "enum": [
            "",
            "medium",
            "high"
          ],
          "default": "medium",
          "description": "Reasoning effort to pass to Codex/Copilot scripted runs. Set to an empty string to omit explicit reasoning-effort flags (useful for non-reasoning models such as gpt-4.1)."
        },
        "ralphCodex.approvalMode": {
          "type": "string",
          "enum": [
            "never",
            "on-request",
            "untrusted"
          ],
          "default": "never",
          "description": "Approval mode to pass to Codex CLI scripted runs. This setting is Codex-specific."
        },
        "ralphCodex.sandboxMode": {
          "type": "string",
          "enum": [
            "read-only",
            "workspace-write",
            "danger-full-access"
          ],
          "default": "workspace-write",
          "description": "Sandbox mode to pass to Codex CLI scripted runs. This setting is Codex-specific."
        },
        "ralphCodex.openSidebarCommandId": {
          "type": "string",
          "default": "claude.openSidebar",
          "description": "VS Code command id to use when attempting to reveal the active AI chat surface (e.g. chatgpt.openSidebar, claude.openSidebar, or none)."
        },
        "ralphCodex.newChatCommandId": {
          "type": "string",
          "default": "claude.newChat",
          "description": "VS Code command id to use when attempting to start a new AI chat or agent session (e.g. chatgpt.newChat, claude.newChat, github.copilot.cli.newSession)."
        },
        "ralphCodex.claimTtlHours": {
          "type": "number",
          "default": 24,
          "minimum": 1,
          "description": "Hours before a task claim expires. Increase for long-running agents on slow machines."
        },
        "ralphCodex.staleLockThresholdMinutes": {
          "type": "number",
          "default": 5,
          "minimum": 1,
          "description": "Minutes before an orphaned lock file is treated as stale and automatically removed."
        },
        "ralphCodex.agentCount": {
          "type": "number",
          "default": 2,
          "minimum": 1,
          "maximum": 20,
          "description": "Number of concurrent Ralph agent instances configured for this workspace. Surfaced in preflight and Show Status so operators can verify the intended parallelism before starting a loop."
        },
        "ralphCodex.hooks": {
          "type": "object",
          "default": {},
          "properties": {
            "beforeIteration": {
              "type": "string",
              "default": "",
              "description": "Optional shell command hook that runs before each CLI iteration starts."
            },
            "afterIteration": {
              "type": "string",
              "default": "",
              "description": "Optional shell command hook that runs after each CLI iteration completes."
            },
            "onTaskComplete": {
              "type": "string",
              "default": "",
              "description": "Optional shell command hook that runs when a task is reconciled to done."
            },
            "onStop": {
              "type": "string",
              "default": "",
              "description": "Optional shell command hook that runs when a loop run stops for any reason."
            },
            "onFailure": {
              "type": "string",
              "default": "",
              "description": "Optional shell command hook that runs when an iteration reports executionStatus=failed."
            }
          },
          "additionalProperties": false,
          "description": "Optional lifecycle hook commands. Each configured value is a shell command string executed at the named lifecycle point; hook failures are logged but do not stop the loop."
        },
        "ralphCodex.autoWatchdogOnStall": {
          "type": "boolean",
          "default": true,
          "description": "Automatically run the watchdog agent after a loop stop caused by repeated no-progress or repeated identical failure classification."
        },
        "ralphCodex.autoReviewOnParentDone": {
          "type": "boolean",
          "default": false,
          "description": "Automatically run the review agent after a parent task is completed."
        },
        "ralphCodex.autoReviewOnLoopComplete": {
          "type": "boolean",
          "default": true,
          "description": "Automatically run the review agent when a loop command completes with at least one iteration result."
        },
        "ralphCodex.autoScmOnConflict": {
          "type": "boolean",
          "default": true,
          "description": "When true, branch-per-task conflict handling can auto-invoke the SCM conflict path and retry up to scmConflictRetryLimit."
        },
        "ralphCodex.scmConflictRetryLimit": {
          "type": "number",
          "default": 1,
          "minimum": 1,
          "maximum": 20,
          "description": "Maximum number of automatic SCM conflict retries attempted when autoScmOnConflict is enabled."
        },
        "ralphCodex.cliExecutionTimeoutMs": {
          "type": "number",
          "default": 0,
          "minimum": 0,
          "description": "Maximum time in milliseconds to wait for a CLI iteration (codex, claude, or copilot) to complete before killing the process with a timeout error. Set to 0 (default) to disable the timeout and wait indefinitely."
        },
        "ralphCodex.promptCaching": {
          "type": "string",
          "enum": [
            "auto",
            "force",
            "off"
          ],
          "default": "auto",
          "description": "Controls prompt caching behaviour for providers that support it (currently Azure AI Foundry direct-HTTPS). auto (default): caching is applied when the provider supports it and is silent for CLI-based providers. force: caching is applied when supported; a warning is emitted when the active provider does not support explicit cache_control markers (e.g. codex, claude, copilot CLI). off: the cache_control marker is omitted from all requests, disabling prompt caching on direct-API providers. See docs/prompt-calibration.md for cost implications."
        },
        "ralphCodex.memoryStrategy": {
          "type": "string",
          "enum": [
            "verbatim",
            "sliding-window",
            "summary"
          ],
          "default": "sliding-window",
          "description": "Controls how Ralph manages agent memory across iterations. verbatim: the full last-iteration context is included verbatim in every prompt. sliding-window (default): only the last memoryWindowSize iterations are included; older entries are dropped to keep prompts compact. summary: when iteration count exceeds memorySummaryThreshold, Ralph invokes the configured CLI provider to produce a condensed memory-summary.md that replaces verbatim history in subsequent prompts."
        },
        "ralphCodex.memoryWindowSize": {
          "type": "number",
          "default": 10,
          "minimum": 1,
          "maximum": 100,
          "description": "Number of recent iterations to include in the prior-iteration context section when memoryStrategy is sliding-window. Ignored for other memory strategies."
        },
        "ralphCodex.memorySummaryThreshold": {
          "type": "number",
          "default": 20,
          "minimum": 1,
          "maximum": 500,
          "description": "Minimum iteration count before automatic summarisation is triggered when memoryStrategy is summary. Below this threshold the summary strategy behaves like verbatim."
        },
        "ralphCodex.enableModelTiering": {
          "type": "boolean",
          "default": true,
          "description": "Enable complexity-based model tier selection. When true, Ralph scores each task using structural signals (validation field, child count, blocker note, trailing failures) and routes it to the simple, medium, or complex tier model. Thresholds default to simpleThreshold=3, complexThreshold=6 and can be overridden via ralphCodex.modelTiering. See docs/model-tiering.md for signal definitions and expected cost savings."
        },
        "ralphCodex.modelTiering": {
          "type": "object",
          "default": {
            "enabled": true,
            "simple": {
              "provider": "claude",
              "model": "claude-haiku-4-5"
            },
            "medium": {
              "provider": "claude",
              "model": "claude-sonnet-4-6"
            },
            "complex": {
              "provider": "claude",
              "model": "claude-opus-4-6"
            },
            "simpleThreshold": 3,
            "complexThreshold": 6
          },
          "properties": {
            "enabled": {
              "type": "boolean",
              "default": true,
              "description": "Enable complexity-based model tiering."
            },
            "simple": {
              "oneOf": [
                {
                  "type": "string"
                },
                {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "type": "string",
                      "enum": [
                        "codex",
                        "claude",
                        "copilot",
                        "copilot-byok",
                        "copilot-foundry",
                        "azure-foundry",
                        "gemini"
                      ],
                      "description": "Optional CLI provider override for the simple tier."
                    },
                    "model": {
                      "type": "string",
                      "description": "Model identifier for the simple tier."
                    },
                    "reasoningEffort": {
                      "type": "string",
                      "enum": [
                        "",
                        "medium",
                        "high"
                      ],
                      "description": "Optional reasoning effort override for the simple tier."
                    }
                  }
                }
              ]
            },
            "medium": {
              "oneOf": [
                {
                  "type": "string"
                },
                {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "type": "string",
                      "enum": [
                        "codex",
                        "claude",
                        "copilot",
                        "copilot-byok",
                        "copilot-foundry",
                        "azure-foundry",
                        "gemini"
                      ],
                      "description": "Optional CLI provider override for the medium tier."
                    },
                    "model": {
                      "type": "string",
                      "description": "Model identifier for the medium tier."
                    },
                    "reasoningEffort": {
                      "type": "string",
                      "enum": [
                        "",
                        "medium",
                        "high"
                      ],
                      "description": "Optional reasoning effort override for the medium tier."
                    }
                  }
                }
              ]
            },
            "complex": {
              "oneOf": [
                {
                  "type": "string"
                },
                {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "type": "string",
                      "enum": [
                        "codex",
                        "claude",
                        "copilot",
                        "copilot-byok",
                        "copilot-foundry",
                        "azure-foundry",
                        "gemini"
                      ],
                      "description": "Optional CLI provider override for the complex tier."
                    },
                    "model": {
                      "type": "string",
                      "description": "Model identifier for the complex tier."
                    },
                    "reasoningEffort": {
                      "type": "string",
                      "enum": [
                        "",
                        "medium",
                        "high"
                      ],
                      "description": "Optional reasoning effort override for the complex tier."
                    }
                  }
                }
              ]
            },
            "simpleThreshold": {
              "type": "number",
              "default": 3,
              "description": "Complexity score below which Ralph selects the simple tier."
            },
            "complexThreshold": {
              "type": "number",
              "default": 6,
              "description": "Complexity score at or above which Ralph selects the complex tier."
            }
          },
          "description": "Full model tiering configuration. Fields: enabled (bool), simple/medium/complex (legacy model string or object with model string, optional provider, and optional reasoningEffort), simpleThreshold (int, default 3), complexThreshold (int, default 6). When a tier omits reasoningEffort, Ralph falls back to global ralphCodex.reasoningEffort. ralphCodex.enableModelTiering is a convenience toggle for the enabled field."
        },
        "ralphCodex.prdGenerationTemplate": {
          "type": "string",
          "default": "",
          "description": "Optional custom system prompt for PRD and task generation. When set, replaces the built-in generation prompt. Use {OBJECTIVE} as a placeholder for the user-supplied project objective. Leave empty to use the built-in prompt."
        },
        "ralphCodex.planningPass": {
          "type": "object",
          "default": {
            "enabled": true,
            "mode": "inline"
          },
          "description": "Pre-execution planning pass configuration. enabled (bool, default true): when true, a planning turn runs before the main implementer iteration to produce a task-plan.json artifact. mode: 'inline' (implementer runs its own planning prompt turn before execution) or 'dedicated' (a separate planner agent writes task-plan.json; implementer waits for it). In dedicated mode, set agentRole=planner on planning agents and agentRole=implementer on executing agents."
        },
        "ralphCodex.taskReadinessGate": {
          "type": "string",
          "enum": [
            "off",
            "warn",
            "auto",
            "strict"
          ],
          "default": "auto",
          "description": "Controls whether planning-pass readiness can gate execution. off: never gate. warn: record readiness warnings and continue. auto: stop before provider execution when planner reports blocked/needs_human_review, and auto-apply valid suggestedChildTasks for needs_decomposition. strict: require an executable task shape (bounded scope, validation, acceptance) and stop/decompose before execution when missing."
        },
        "ralphCodex.failureDiagnostics": {
          "type": "string",
          "enum": [
            "auto",
            "off"
          ],
          "default": "auto",
          "description": "Controls whether Ralph runs a diagnostic pass when a task is blocked or the verifier fails. 'auto': run a diagnostic CLI invocation to classify the failure root cause and write a failure-analysis.json artifact. 'off': suppress all diagnostic invocations."
        },
        "ralphCodex.maxRecoveryAttempts": {
          "type": "number",
          "default": 3,
          "minimum": 1,
          "description": "Maximum number of recovery attempts Ralph will make after a classified failure before giving up and marking the task blocked."
        },
        "ralphCodex.maxReplansPerParent": {
          "type": "number",
          "default": 2,
          "minimum": 1,
          "description": "Maximum number of adaptive re-plan attempts per parent task before the replan node fails with replan_cap_exhausted and escalates to human review."
        },
        "ralphCodex.maxGeneratedChildren": {
          "type": "number",
          "default": 8,
          "minimum": 1,
          "description": "Maximum number of child tasks a single re-plan pass may generate. Waves exceeding this limit are truncated."
        }
      }
    }
  },
  "scripts": {
    "build:webview": "esbuild src/webview-ui/main.tsx --bundle --platform=browser --format=iife --target=es2022 --jsx=automatic --outfile=out/webview-ui/main.js --sourcemap --minify",
    "typecheck:webview": "tsc -p ./tsconfig.webview-ui.json",
    "compile": "npm run build:webview && tsc -p ./",
    "compile:tests": "tsc -p ./tsconfig.test.json",
    "watch:ts": "tsc -watch -p ./",
    "watch:webview": "npm run build:webview -- --watch=forever",
    "watch": "node ./scripts/watch-extension-dev.js",
    "lint": "tsc --noEmit -p ./ && tsc --noEmit -p ./tsconfig.test.json && npm run typecheck:webview",
    "check:docs": "node ./scripts/check-docs.js",
    "check:ledger": "node ./scripts/check-ledger.js",
    "prompt:calibrate": "node ./scripts/calibrate-prompt-budget.js",
    "check:prompt-budget": "node ./scripts/validate-prompt-budget.js",
    "test": "npm run compile:tests && node --require ./test/register-vscode-stub.cjs --test ./out-test/test/*.js ./out-test/test/webview/*.js && node --require ./test/register-vscode-stub.cjs --require ./test/register-dom.cjs --test ./out-test/test/ui/*.js",
    "test:activation": "npm run compile && npm run compile:tests && node ./out-test/test/vscode/runActivationSmoke.js",
    "test:e2e-pipeline": "node ./scripts/run-e2e-pipeline-smoke.js",
    "test:e2e-orchestration": "node ./scripts/run-e2e-orchestration-smoke.js",
    "test:real-cli-smoke": "node ./scripts/run-real-cli-smoke.js",
    "test:offline-evals": "node ./scripts/run-offline-evals.js",
    "test:evals": "npm run test:offline-evals",
    "test:ui-harness": "npm run compile:tests && node --require ./test/register-vscode-stub.cjs --test ./out-test/test/ui/uiFixtureHarness.test.js ./out-test/test/ui/panelHtml.test.js ./out-test/test/ui/sidebarHtml.test.js ./out-test/test/webview/sharedStyles.test.js",
    "evidence:ui-fixtures": "npm run compile && npm run compile:tests && node ./scripts/export-ui-fixture-catalog.js",
    "dogfood": "node ./scripts/run-dogfood.js",
    "validate": "npm run compile && npm run check:docs && npm run check:ledger && npm run check:prompt-budget && npm run lint && npm run test",
    "check:runtime": "node ./scripts/ensure-node-version.js",
    "vscode:prepublish": "npm run compile",
    "package": "npm run check:runtime && vsce package --allow-unused-files-pattern",
    "publish:dry-run": "npm run package"
  },
  "devDependencies": {
    "@testing-library/dom": "^10.4.1",
    "@testing-library/react": "^16.3.2",
    "@testing-library/user-event": "^14.6.1",
    "@types/node": "^22.19.15",
    "@types/react": "^19.2.14",
    "@types/react-dom": "^19.2.3",
    "@types/vscode": "^1.95.0",
    "@vscode/test-electron": "^2.5.2",
    "@vscode/vsce": "^3.7.1",
    "esbuild": "^0.28.0",
    "jsdom": "^29.1.1",
    "react": "^19.2.6",
    "react-dom": "^19.2.6",
    "typescript": "^5.8.2"
  },
  "dependencies": {
    "@azure/identity": "^4.13.1"
  }
}