overseer.env_map
Map and track environment variables across project phases to identify required versus optional variables for structured deployment.
Instructions
Maps and tracks environment variables across phases, identifying required vs. optional variables.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repo_name | Yes | Name of the repository | |
| phase_name | No | Optional: filter to specific phase |
Implementation Reference
- src/tools/env-map.ts:25-53 (handler)The handleEnvMap function that executes the tool's core logic, currently a placeholder for future environment variable mapping across phases.export async function handleEnvMap( args: { repo_name: string; phase_name?: string; }, phaseManager: PhaseManager ): Promise<{ success: boolean; env_map: Record< string, { variable: string; required_for_phases: string[]; description?: string; default_value?: string; } >; message?: string; }> { // Note: env_map is a planned feature for v1.1+ // This tool will scan project files for environment variable usage // and map them to phases where they are required return { success: true, env_map: {}, message: 'Environment mapping is planned for v1.1.0. This tool will analyze project files to identify environment variables and their phase dependencies.', }; }
- src/tools/env-map.ts:4-23 (schema)The createEnvMapTool function defines the tool's metadata, including name, description, and input schema for validation.export function createEnvMapTool(phaseManager: PhaseManager): Tool { return { name: 'overseer.env_map', description: 'Maps and tracks environment variables across phases, identifying required vs. optional variables.', inputSchema: { type: 'object', required: ['repo_name'], properties: { repo_name: { type: 'string', description: 'Name of the repository', }, phase_name: { type: 'string', description: 'Optional: filter to specific phase', }, }, }, }; }
- src/tools/index.ts:71-72 (registration)Registration of the handler in the main tool dispatcher switch statement.case 'overseer.env_map': return await handleEnvMap(args, context.phaseManager);
- src/tools/index.ts:37-37 (registration)The tool is added to the list of available tools in createTools.createEnvMapTool(context.phaseManager),