{
  "scenario": "research-investigation",
  "locale": "en-US",
  "version": "1.0.0",
  "syntax": "handlebars",
  "syntaxVersion": "1.0",
  "author": "PCode Team",
  "description": "Investigate a selected CodeRef vault, optionally clone or update Git repositories under repos/, analyze the codebase, and write deliverables under docs/.",
  "image": {
    "stageStyleKey": "custom-executor-research-investigation",
    "artStyle": "Repository field-research operations card",
    "displayMode": "story-card",
    "aspectRatio": "4:3",
    "alt": "Investigate a selected CodeRef vault, optionally clone or update Git repositories under repos/, analyze the codebase, and write deliverables under docs/.",
    "stageStyleLabel": "Research investigation card",
    "promptDirection": "coderef research, repository intake, documentation synthesis"
  },
  "lastModified": "2026-04-14",
  "tags": [
    "research",
    "coderef",
    "CustomExecutor"
  ],
  "parameters": [
    {
      "name": "projectPath",
      "type": "string",
      "required": true,
      "description": "Absolute working directory for the selected CodeRef vault root."
    },
    {
      "name": "repositoryPath",
      "type": "string",
      "required": false,
      "description": "Resolved repository identity hint. For vault-targeted runs this usually matches the resolved vault path."
    },
    {
      "name": "targetType",
      "type": "string",
      "required": false,
      "description": "Execution target kind. Research requests are expected to use vault."
    },
    {
      "name": "vaultId",
      "type": "string",
      "required": false,
      "description": "Legacy output vault identifier alias kept for compatibility during rollout."
    },
    {
      "name": "vaultName",
      "type": "string",
      "required": false,
      "description": "Legacy output vault display name alias kept for compatibility during rollout."
    },
    {
      "name": "vaultType",
      "type": "string",
      "required": false,
      "description": "Legacy output vault type alias kept for compatibility during rollout."
    },
    {
      "name": "outputVaultId",
      "type": "string",
      "required": false,
      "description": "Explicit output CodeRef vault identifier for the research run."
    },
    {
      "name": "outputVaultName",
      "type": "string",
      "required": false,
      "description": "Display name of the output CodeRef vault."
    },
    {
      "name": "outputVaultType",
      "type": "string",
      "required": false,
      "description": "Runtime output vault type metadata. Expected value: coderef."
    },
    {
      "name": "researchDirection",
      "type": "string",
      "required": true,
      "description": "Concrete investigation goal that defines what the executor must analyze."
    },
    {
      "name": "repositoryUrls",
      "type": "array",
      "required": false,
      "description": "Ordered Git repository URLs that should be cloned or updated under repos/ before analysis."
    },
    {
      "name": "referenceVaults",
      "type": "array",
      "required": false,
      "description": "Read-only reference vault summaries with id, name, type, and physicalPath for auxiliary evidence."
    },
    {
      "name": "targetProjects",
      "type": "array",
      "required": false,
      "description": "Supplemental read-only project references with projectId, name, physicalPath, and accessType. Research project references are reference-only scope."
    },
    {
      "name": "reposDirectory",
      "type": "string",
      "required": false,
      "description": "Absolute path to the CodeRef repos/ workspace."
    },
    {
      "name": "docsDirectory",
      "type": "string",
      "required": false,
      "description": "Absolute path to the CodeRef docs/ output area."
    }
  ],
  "dungeon": {
    "enabled": true,
    "scriptKey": "autotask.research-investigation",
    "groupKey": "autotask",
    "sortOrder": 230,
    "displayNameKey": "hero.dungeon.catalog.autotask.researchInvestigation.name",
    "descriptionKey": "hero.dungeon.catalog.autotask.researchInvestigation.description",
    "displayName": "Research Investigation",
    "description": "Runtime member routing for CodeRef research investigation tasks."
  }
}
