@winspan/claude-forge 8.39.0 → 8.50.6

package/dist/agents/methodologies/user-config-loader.js

@@ -1,159 +0,0 @@
-/**
- * User-defined methodology preset loader.
- *
- * Reads `~/.claude-forge/methodologies.yaml` and converts user-authored
- * compositions into `MethodologyAgentPreset` instances. Validation is
- * tolerant: invalid entries are skipped with warnings, valid ones still
- * load. The final array is consumed by AgentRegistry, which expands each
- * preset into an AgentDefinition via `buildMethodologyAgent()`.
- *
- * Path resolution is lazy (per call) so tests can redirect `process.env.HOME`
- * after module load — the same pattern used by `web/routes/experiments.ts`.
- *
- * YAML is parsed with `CORE_SCHEMA` to disallow `!!js/function` and other
- * unsafe js-yaml tags, matching the convention in `experiment-router.ts`.
- */
-import fs from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import yaml from 'js-yaml';
-import { logger } from '../../core/utils/logger.js';
-import { getPhase } from './agent-builder.js';
-const STANDARD_TOOLS = ['Read', 'Write', 'Edit', 'Grep', 'Glob', 'Bash'];
-/**
- * Default file path: `~/.claude-forge/methodologies.yaml`.
- *
- * NOTE: cannot use `FORGE_PATHS.home()` because it captures `homedir()` at
- * module load time, which makes tests that mutate `process.env.HOME` fail.
- * We re-evaluate per-call here.
- */
-function defaultConfigPath() {
-    return join(homedir(), '.claude-forge', 'methodologies.yaml');
-}
-/**
- * Load `~/.claude-forge/methodologies.yaml` and return validated presets.
- *
- * Behaviour:
- * - File missing → `{ presets: [], warnings: [] }`
- * - Parse error → `{ presets: [], warnings: [<error>] }`, logged at warn level
- * - Per-entry validation failure → entry skipped, warning recorded, others continue
- */
-export function loadUserMethodologyPresets(configPath) {
-    const path = configPath ?? defaultConfigPath();
-    const warnings = [];
-    if (!fs.existsSync(path)) {
-        return { presets: [], warnings: [] };
-    }
-    let parsed;
-    try {
-        const raw = fs.readFileSync(path, 'utf-8');
-        const data = yaml.load(raw, { schema: yaml.CORE_SCHEMA });
-        if (data === null || data === undefined) {
-            return { presets: [], warnings: [] };
-        }
-        if (typeof data !== 'object' || Array.isArray(data)) {
-            const msg = 'methodologies.yaml: root must be a mapping';
-            logger.warn(`[Methodologies] ${msg}`);
-            return { presets: [], warnings: [msg] };
-        }
-        parsed = data;
-    }
-    catch (err) {
-        const msg = `methodologies.yaml parse error: ${err instanceof Error ? err.message : String(err)}`;
-        logger.warn(`[Methodologies] ${msg}`);
-        return { presets: [], warnings: [msg] };
-    }
-    const rawAgents = parsed.agents;
-    if (rawAgents === undefined) {
-        return { presets: [], warnings: [] };
-    }
-    if (!Array.isArray(rawAgents)) {
-        const msg = 'methodologies.yaml: `agents` must be an array';
-        warnings.push(msg);
-        return { presets: [], warnings };
-    }
-    const presets = [];
-    const seenIds = new Set();
-    for (const item of rawAgents) {
-        if (item === null || typeof item !== 'object' || Array.isArray(item)) {
-            warnings.push('Skipped agent: entry must be a mapping');
-            continue;
-        }
-        const preset = validateAndBuildPreset(item, warnings);
-        if (!preset)
-            continue;
-        if (seenIds.has(preset.id)) {
-            warnings.push(`Skipped agent ${preset.id}: duplicate id within methodologies.yaml`);
-            continue;
-        }
-        seenIds.add(preset.id);
-        presets.push(preset);
-    }
-    return { presets, warnings };
-}
-/**
- * Validate one raw entry and convert it into a `MethodologyAgentPreset`.
- * Returns `null` (and pushes a warning) when validation fails.
- */
-function validateAndBuildPreset(item, warnings) {
-    // id (required, kebab-case)
-    if (typeof item.id !== 'string' || item.id.length === 0) {
-        warnings.push('Skipped agent: missing or non-string `id`');
-        return null;
-    }
-    const id = item.id;
-    if (!/^[a-z][a-z0-9-]*$/.test(id)) {
-        warnings.push(`Skipped agent ${id}: invalid id format (must be kebab-case, e.g. my-feature-flow)`);
-        return null;
-    }
-    // phases (required, non-empty array, every entry resolvable)
-    if (!Array.isArray(item.phases) || item.phases.length === 0) {
-        warnings.push(`Skipped agent ${id}: \`phases\` must be a non-empty array`);
-        return null;
-    }
-    const phases = [];
-    for (const phaseId of item.phases) {
-        if (typeof phaseId !== 'string') {
-            warnings.push(`Skipped agent ${id}: every phase entry must be a string (got ${typeof phaseId})`);
-            return null;
-        }
-        if (!getPhase(phaseId)) {
-            warnings.push(`Skipped agent ${id}: phase "${phaseId}" not found (valid format: bmad/<phase> or harness/<phase>)`);
-            return null;
-        }
-        phases.push(phaseId);
-    }
-    // optional string fields
-    const name = typeof item.name === 'string' && item.name.length > 0 ? item.name : id;
-    const description = typeof item.description === 'string' && item.description.length > 0
-        ? item.description
-        : `User-defined methodology agent: ${id}`;
-    const scenario = typeof item.scenario === 'string' && item.scenario.length > 0
-        ? item.scenario
-        : '用户自定义场景';
-    const version = typeof item.version === 'string' && item.version.length > 0 ? item.version : '1.0.0';
-    // tools (default to STANDARD_TOOLS if absent or empty)
-    let tools = STANDARD_TOOLS;
-    if (Array.isArray(item.tools)) {
-        const filtered = item.tools.filter((t) => typeof t === 'string' && t.length > 0);
-        if (filtered.length > 0)
-            tools = filtered;
-    }
-    // tags (optional)
-    let tags;
-    if (Array.isArray(item.tags)) {
-        const filtered = item.tags.filter((t) => typeof t === 'string' && t.length > 0);
-        tags = filtered.length > 0 ? filtered : undefined;
-    }
-    return {
-        id,
-        name,
-        description,
-        scenario,
-        version,
-        phases,
-        tools,
-        tags,
-    };
-}
-//# sourceMappingURL=user-config-loader.js.map

package/dist/agents/methodologies/user-config-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"user-config-loader.js","sourceRoot":"","sources":["../../../src/agents/methodologies/user-config-loader.ts"],"names":[],"mappings":"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"}

package/dist/agents/official-agents.d.ts

@@ -1,4 +0,0 @@
-import type { AgentDefinition } from './definition.js';
-export declare const OFFICIAL_AGENTS: AgentDefinition[];
-export declare function findOfficialAgent(name: string): AgentDefinition | undefined;
-//# sourceMappingURL=official-agents.d.ts.map

package/dist/agents/official-agents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"official-agents.d.ts","sourceRoot":"","sources":["../../src/agents/official-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA4cvD,eAAO,MAAM,eAAe,EAAE,eAAe,EA6G5C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE3E"}