@entelligentsia/forgecli 1.0.14 → 1.0.21

package/dist/extensions/forgecli/config/config-layer.d.ts

@@ -0,0 +1,53 @@
+export interface PersonaModel {
+    provider: string;
+    model: string;
+    description?: string;
+}
+export type PersonaModelsMap = Record<string, PersonaModel>;
+export interface PhaseConfig {
+    "model-override"?: string | PersonaModel;
+}
+export interface PipelineConfig {
+    "persona-models"?: PersonaModelsMap;
+    /** Phase overrides keyed by role string. */
+    phases?: Record<string, PhaseConfig>;
+}
+export interface SkillCurationConfig {
+    /**
+     * FORGE-S24 SKILL-CURATION pipeline rollout flag. Default false.
+     * When false, the four T08–T11 modules (skill-retriever, skill-usage-tracker,
+     * skill-curator-subagent, friction-emit) no-op at entry. Wired into the
+     * orchestrator handlers (run-task / fix-bug) so a flag-off run is
+     * byte-identical to pre-FORGE-S24 behaviour.
+     */
+    enabled?: boolean;
+}
+export interface ForgeCliFeatureFlags {
+    skillCuration?: SkillCurationConfig;
+}
+export interface GlobalConfig {
+    "persona-models"?: PersonaModelsMap;
+    forgeCli?: ForgeCliFeatureFlags;
+}
+export interface ProjectConfig {
+    "persona-models"?: PersonaModelsMap;
+    forgeCli?: ForgeCliFeatureFlags;
+    pipelines?: Record<string, PipelineConfig>;
+}
+export interface MergedConfig {
+    /** Shallow-merged persona-models (project wins on key collision). */
+    "persona-models"?: PersonaModelsMap;
+    /** Project-only pipelines (L3/L4 config lives here). */
+    pipelines?: Record<string, PipelineConfig>;
+    /** The raw global config for L1 lookups — null if absent or invalid. */
+    _global: GlobalConfig | null;
+    /** The raw project config for L2 lookups — null if absent or invalid. */
+    _project: ProjectConfig | null;
+}
+export interface LayeredConfig {
+    global: GlobalConfig | null;
+    project: ProjectConfig | null;
+    merged: MergedConfig;
+    errors: string[];
+}
+export declare function loadLayeredConfig(cwd: string): LayeredConfig;

package/dist/extensions/forgecli/config/config-layer.js

@@ -0,0 +1,72 @@
+import * as fs from "node:fs";
+import AjvModule from "ajv";
+import schema from "../forge-cli-schema.json" with { type: "json" };
+import { getGlobalConfigPath, getProjectConfigPath } from "../paths/paths.js";
+// Ajv v8 ESM interop: default export is a namespace holder;
+// the actual constructor lives at .Ajv or .default.Ajv.
+const Ajv = AjvModule.default?.Ajv ?? AjvModule.Ajv ?? AjvModule;
+const ajv = new Ajv({ allErrors: true });
+const validate = ajv.compile(schema);
+function validateConfig(raw, label) {
+    const ok = validate(raw);
+    if (!ok) {
+        const messages = validate.errors
+            ?.map((e) => `${e.instancePath || "/"} ${e.message}`)
+            .join("; ") ?? "unknown";
+        return { valid: false, error: `forge-cli ${label} config schema error: ${messages}` };
+    }
+    return { valid: true, data: raw };
+}
+function readJsonFile(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch (_err) {
+        return null;
+    }
+}
+export function loadLayeredConfig(cwd) {
+    const errors = [];
+    const globalPath = getGlobalConfigPath();
+    const projectPath = getProjectConfigPath(cwd);
+    let globalConfig = null;
+    let projectConfig = null;
+    const rawGlobal = readJsonFile(globalPath);
+    if (rawGlobal !== null) {
+        const result = validateConfig(rawGlobal, "global");
+        if (result.valid) {
+            globalConfig = result.data;
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    const rawProject = readJsonFile(projectPath);
+    if (rawProject !== null) {
+        const result = validateConfig(rawProject, "project");
+        if (result.valid) {
+            projectConfig = result.data;
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    // Shallow-merge persona-models: global first, project overwrites per key
+    const mergedPersonaModels = {
+        ...(globalConfig?.["persona-models"] ?? {}),
+        ...(projectConfig?.["persona-models"] ?? {}),
+    };
+    const merged = {
+        _global: globalConfig,
+        _project: projectConfig,
+    };
+    if (Object.keys(mergedPersonaModels).length > 0) {
+        merged["persona-models"] = mergedPersonaModels;
+    }
+    // Pipelines are project-only (global config is project-agnostic)
+    if (projectConfig?.pipelines) {
+        merged.pipelines = projectConfig.pipelines;
+    }
+    return { global: globalConfig, project: projectConfig, merged, errors };
+}
+//# sourceMappingURL=config-layer.js.map

package/dist/extensions/forgecli/config/config-layer.js.map

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

package/dist/extensions/forgecli/config/config-writer.d.ts

@@ -0,0 +1,16 @@
+import type { PersonaModelsMap, PipelineConfig } from "./config-layer.js";
+export type ConfigLayer = "global" | "project";
+export interface RoutingConfigBuffer {
+    "persona-models"?: PersonaModelsMap;
+    pipelines?: Record<string, PipelineConfig>;
+}
+export interface WriteOptions {
+    layer: ConfigLayer;
+    cwd: string;
+    buffer: RoutingConfigBuffer;
+}
+export declare function resolveTargetPath(opts: {
+    layer: ConfigLayer;
+    cwd: string;
+}): string;
+export declare function writeRoutingConfig(opts: WriteOptions): string;

package/dist/extensions/forgecli/config/config-writer.js

@@ -0,0 +1,69 @@
+// Atomic, schema-validated writer for forge-cli routing config files.
+//
+// Plan 16, Slice 4a. Writes ONLY to (paths resolved via paths/paths.ts):
+//   - global layer (L1) → getGlobalConfigPath() → ~/.pi/forge-cli/config.json
+//   - project layer (L2/L3/L4) → getProjectConfigPath(cwd) →
+//     <cwd>/.pi/forge-cli/config.json
+//
+// Never writes to .forge/config.json — that's the plugin's pipeline catalogue,
+// read-only from this TUI.
+//
+// Write protocol:
+//   1. Validate buffer against forge-cli-schema.json. Throw on fail.
+//   2. If buffer is empty ({}) and target file exists → unlink. Return target.
+//   3. Otherwise: write to <target>.tmp, fsync, rename atomically to <target>.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import AjvModule from "ajv";
+import schema from "../forge-cli-schema.json" with { type: "json" };
+import { getGlobalConfigPath, getProjectConfigPath } from "../paths/paths.js";
+// Ajv v8 ESM interop: default export is a namespace holder;
+// the actual constructor lives at .Ajv or .default.Ajv.
+const Ajv = AjvModule.default?.Ajv ?? AjvModule.Ajv ?? AjvModule;
+const ajv = new Ajv({ allErrors: true });
+const validate = ajv.compile(schema);
+export function resolveTargetPath(opts) {
+    if (opts.layer === "global") {
+        return getGlobalConfigPath();
+    }
+    return getProjectConfigPath(opts.cwd);
+}
+function isEmpty(buffer) {
+    const personaCount = Object.keys(buffer["persona-models"] ?? {}).length;
+    const pipelineCount = Object.keys(buffer.pipelines ?? {}).length;
+    return personaCount === 0 && pipelineCount === 0;
+}
+export function writeRoutingConfig(opts) {
+    const target = resolveTargetPath(opts);
+    // Empty buffer → delete file if present.
+    if (isEmpty(opts.buffer)) {
+        if (fs.existsSync(target)) {
+            fs.unlinkSync(target);
+        }
+        return target;
+    }
+    // Validate FIRST. Any failure short-circuits before touching the filesystem.
+    const ok = validate(opts.buffer);
+    if (!ok) {
+        const messages = validate.errors
+            ?.map((e) => `${e.instancePath || "/"} ${e.message}`)
+            .join("; ") ?? "unknown";
+        throw new Error(`forge-cli config schema error: ${messages}`);
+    }
+    // Ensure parent dir exists.
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    // Atomic write: temp file + rename. Pretty-print for human-readable diffs.
+    const tmpPath = `${target}.tmp`;
+    const serialized = `${JSON.stringify(opts.buffer, null, 2)}\n`;
+    const fd = fs.openSync(tmpPath, "w");
+    try {
+        fs.writeSync(fd, serialized);
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    fs.renameSync(tmpPath, target);
+    return target;
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/extensions/forgecli/config/config-writer.js.map

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

package/dist/extensions/forgecli/config/model-registry.d.ts

@@ -0,0 +1,61 @@
+import { type Static, Type } from "typebox";
+declare const ProviderSchema: Type.TObject<{
+    id: Type.TString;
+    label: Type.TString;
+    enabled: Type.TBoolean;
+    deferredTo: Type.TOptional<Type.TString>;
+    modelGlobs: Type.TArray<Type.TString>;
+    credentialEnvAny: Type.TArray<Type.TString>;
+}>;
+declare const RegistrySchema: Type.TObject<{
+    version: Type.TLiteral<1>;
+    providers: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        label: Type.TString;
+        enabled: Type.TBoolean;
+        deferredTo: Type.TOptional<Type.TString>;
+        modelGlobs: Type.TArray<Type.TString>;
+        credentialEnvAny: Type.TArray<Type.TString>;
+    }>>;
+}>;
+export type CuratedRegistry = Static<typeof RegistrySchema>;
+export type CuratedProvider = Static<typeof ProviderSchema>;
+export interface LoadOptions {
+    registryPath?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface SeedOutcome {
+    seeded: boolean;
+    path: string;
+}
+export interface SeedOptions {
+    projectRoot: string;
+    registry: CuratedRegistry;
+    now?: () => number;
+}
+declare function resolveRegistryPath(opts: LoadOptions): string;
+export declare function loadRegistry(opts?: LoadOptions): CuratedRegistry;
+declare function seededModelGlobs(registry: CuratedRegistry): string[];
+declare function defaultGlob(registry: CuratedRegistry): string;
+declare function seedFilePath(projectRoot: string): string;
+export declare function seedEnabledModels(opts: SeedOptions): Promise<SeedOutcome>;
+export declare function detectMissingCredentials(registry: CuratedRegistry, env?: NodeJS.ProcessEnv): string | null;
+export declare const __test__: {
+    BUNDLED_PATH: string;
+    resolveRegistryPath: typeof resolveRegistryPath;
+    seedFilePath: typeof seedFilePath;
+    seededModelGlobs: typeof seededModelGlobs;
+    defaultGlob: typeof defaultGlob;
+    RegistrySchema: Type.TObject<{
+        version: Type.TLiteral<1>;
+        providers: Type.TArray<Type.TObject<{
+            id: Type.TString;
+            label: Type.TString;
+            enabled: Type.TBoolean;
+            deferredTo: Type.TOptional<Type.TString>;
+            modelGlobs: Type.TArray<Type.TString>;
+            credentialEnvAny: Type.TArray<Type.TString>;
+        }>>;
+    }>;
+};
+export {};

package/dist/extensions/forgecli/config/model-registry.js

@@ -0,0 +1,127 @@
+// Curated provider/model registry — FORGE-S16-T16 (issue #17).
+//
+// Loads forgecli's bundled registry/models.json (or a `FORGE_MODEL_REGISTRY`
+// override), seeds project-scope `enabledModels` exactly once into
+// `<projectRoot>/.forge/pi-settings.json`, and emits a missing-credentials
+// banner naming the env vars the user can set. Global pi settings
+// (`~/.pi/agent/settings.json`) are never read or written.
+import { promises as fs, readFileSync } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+const ProviderSchema = Type.Object({
+    id: Type.String({ minLength: 1 }),
+    label: Type.String({ minLength: 1 }),
+    enabled: Type.Boolean(),
+    deferredTo: Type.Optional(Type.String()),
+    modelGlobs: Type.Array(Type.String()),
+    credentialEnvAny: Type.Array(Type.String()),
+});
+const RegistrySchema = Type.Object({
+    version: Type.Literal(1),
+    providers: Type.Array(ProviderSchema, { minItems: 1 }),
+});
+const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "..");
+const BUNDLED_PATH = path.join(PKG_ROOT, "registry", "models.json");
+function resolveRegistryPath(opts) {
+    const env = opts.env ?? process.env;
+    if (opts.registryPath && opts.registryPath.length > 0)
+        return opts.registryPath;
+    const envOverride = env.FORGE_MODEL_REGISTRY;
+    if (typeof envOverride === "string" && envOverride.length > 0)
+        return envOverride;
+    return BUNDLED_PATH;
+}
+export function loadRegistry(opts = {}) {
+    const target = resolveRegistryPath(opts);
+    const raw = readFileSync(target, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!Value.Check(RegistrySchema, parsed)) {
+        const errors = [...Value.Errors(RegistrySchema, parsed)]
+            .slice(0, 3)
+            .map((e) => e.message)
+            .join("; ");
+        throw new Error(`Invalid model registry at ${target}: ${errors || "schema check failed"}`);
+    }
+    return parsed;
+}
+function seededModelGlobs(registry) {
+    const out = [];
+    for (const p of registry.providers) {
+        if (!p.enabled)
+            continue;
+        for (const g of p.modelGlobs) {
+            if (!out.includes(g))
+                out.push(g);
+        }
+    }
+    return out;
+}
+function defaultGlob(registry) {
+    for (const p of registry.providers) {
+        if (p.enabled && p.modelGlobs.length > 0)
+            return p.modelGlobs[0];
+    }
+    return "claude-*";
+}
+function seedFilePath(projectRoot) {
+    return path.join(projectRoot, ".forge", "pi-settings.json");
+}
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function seedEnabledModels(opts) {
+    const target = seedFilePath(opts.projectRoot);
+    if (await pathExists(target)) {
+        return { seeded: false, path: target };
+    }
+    const now = opts.now ?? (() => Date.now());
+    const payload = {
+        schemaVersion: 1,
+        seededAt: now(),
+        seedSource: "@entelligentsia/forgecli registry v1",
+        enabledModels: seededModelGlobs(opts.registry),
+        defaultModelGlob: defaultGlob(opts.registry),
+    };
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    const tmp = `${target}.${process.pid}.${Date.now()}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(payload, null, 2), "utf8");
+    await fs.rename(tmp, target);
+    return { seeded: true, path: target };
+}
+const PRIMARY_ENV_KEYS = ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GEMINI_API_KEY", "OPENROUTER_API_KEY"];
+export function detectMissingCredentials(registry, env = process.env) {
+    const requiring = registry.providers.filter((p) => p.enabled && p.credentialEnvAny.length > 0);
+    if (requiring.length === 0)
+        return null;
+    for (const p of requiring) {
+        for (const key of p.credentialEnvAny) {
+            const v = env[key];
+            if (typeof v === "string" && v.length > 0) {
+                return null;
+            }
+        }
+    }
+    const lines = [
+        "forge — no provider credentials configured. Set one of:",
+        `  ${PRIMARY_ENV_KEYS.join(", ")}`,
+        "(or run pi /login for OAuth providers).",
+    ];
+    return lines.join("\n");
+}
+export const __test__ = {
+    BUNDLED_PATH,
+    resolveRegistryPath,
+    seedFilePath,
+    seededModelGlobs,
+    defaultGlob,
+    RegistrySchema,
+};
+//# sourceMappingURL=model-registry.js.map

package/dist/extensions/forgecli/config/model-registry.js.map

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

package/dist/extensions/forgecli/config/model-resolver.d.ts

@@ -0,0 +1,32 @@
+import type { MergedConfig } from "./config-layer.js";
+export type { MergedConfig } from "./config-layer.js";
+export type ResolveSource = "L4-inline" | "L4-name" | "L3" | "L2" | "L1" | "default" | "inherit";
+export type LookupSource = "L3" | "L2" | "L1" | "default" | "missing";
+export interface ResolveResult {
+    model: {
+        provider: string;
+        model: string;
+    } | undefined;
+    source: ResolveSource;
+}
+export interface LookupResult {
+    model: {
+        provider: string;
+        model: string;
+    } | undefined;
+    source: LookupSource;
+}
+/**
+ * Look up a persona-model name through L3 → L2 → L1 → default → missing.
+ * Used by resolveModelForPhase for L4-name resolution and direct persona lookups.
+ */
+export declare function lookupPersonaModel(personaName: string, pipelineName: string, merged: MergedConfig): LookupResult;
+/**
+ * Resolve the {provider, model} pair for a specific phase invocation.
+ *
+ * Cascade order:
+ *   L4-inline → L4-name → L3 → L2 → L1 → default persona-model → inherit
+ *
+ * When source is "inherit", model is undefined — caller must skip setModel.
+ */
+export declare function resolveModelForPhase(pipelineName: string, phaseRole: string, personaNoun: string, merged: MergedConfig): ResolveResult;

package/dist/extensions/forgecli/config/model-resolver.js

@@ -0,0 +1,65 @@
+function toModel(pm) {
+    return { provider: pm.provider, model: pm.model };
+}
+/**
+ * Look up a persona-model name through L3 → L2 → L1 → default → missing.
+ * Used by resolveModelForPhase for L4-name resolution and direct persona lookups.
+ */
+export function lookupPersonaModel(personaName, pipelineName, merged) {
+    // L3 — pipeline-level persona-models
+    const l3 = merged.pipelines?.[pipelineName]?.["persona-models"]?.[personaName];
+    if (l3)
+        return { model: toModel(l3), source: "L3" };
+    // L2 — project persona-models
+    const l2 = merged._project?.["persona-models"]?.[personaName];
+    if (l2)
+        return { model: toModel(l2), source: "L2" };
+    // L1 — global persona-models
+    const l1 = merged._global?.["persona-models"]?.[personaName];
+    if (l1)
+        return { model: toModel(l1), source: "L1" };
+    // default persona-model (same L3→L2→L1 walk with key="default")
+    if (personaName !== "default") {
+        const defL3 = merged.pipelines?.[pipelineName]?.["persona-models"]?.["default"];
+        if (defL3)
+            return { model: toModel(defL3), source: "default" };
+        const defL2 = merged._project?.["persona-models"]?.["default"];
+        if (defL2)
+            return { model: toModel(defL2), source: "default" };
+        const defL1 = merged._global?.["persona-models"]?.["default"];
+        if (defL1)
+            return { model: toModel(defL1), source: "default" };
+    }
+    return { model: undefined, source: "missing" };
+}
+/**
+ * Resolve the {provider, model} pair for a specific phase invocation.
+ *
+ * Cascade order:
+ *   L4-inline → L4-name → L3 → L2 → L1 → default persona-model → inherit
+ *
+ * When source is "inherit", model is undefined — caller must skip setModel.
+ */
+export function resolveModelForPhase(pipelineName, phaseRole, personaNoun, merged) {
+    const phase = merged.pipelines?.[pipelineName]?.phases?.[phaseRole];
+    const override = phase?.["model-override"];
+    if (override !== undefined) {
+        // L4-inline: override is an inline {provider, model} object
+        if (typeof override === "object") {
+            return { model: toModel(override), source: "L4-inline" };
+        }
+        // L4-name: override is a persona-model key string
+        const named = lookupPersonaModel(override, pipelineName, merged);
+        if (named.source !== "missing") {
+            return { model: named.model, source: "L4-name" };
+        }
+        // L4-name miss: fall through with original personaNoun
+    }
+    // L3 → L2 → L1 → default → missing
+    const lookup = lookupPersonaModel(personaNoun, pipelineName, merged);
+    if (lookup.source === "missing") {
+        return { model: undefined, source: "inherit" };
+    }
+    return { model: lookup.model, source: lookup.source };
+}
+//# sourceMappingURL=model-resolver.js.map

package/dist/extensions/forgecli/config/model-resolver.js.map

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

package/dist/extensions/forgecli/config/model-validator.d.ts

@@ -0,0 +1,29 @@
+import type { MergedConfig } from "./config-layer.js";
+export type ValidationCode = "UNKNOWN_PERSONA" | "MODEL_UNAVAILABLE" | "UNKNOWN_PIPELINE" | "UNRESOLVABLE_OVERRIDE";
+export interface ValidationIssue {
+    code: ValidationCode;
+    message: string;
+    /** JSON-pointer-style path to the offending config value */
+    path?: string;
+}
+export interface ValidationReport {
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+type AvailableModel = {
+    provider: string;
+    id: string;
+};
+/**
+ * Validate the merged forge-cli model config against runtime catalogues.
+ *
+ * - strict=false: unavailability and unknown persona names are warnings.
+ * - strict=true: those warnings become errors.
+ * - Unknown pipeline names are always errors when pipelineCatalogue is non-null;
+ *   warnings when pipelineCatalogue is null (no .forge/config.json found).
+ * - Unresolvable model-override strings are always errors.
+ *
+ * The function is pure — no I/O. Callers pass in the pre-built catalogues.
+ */
+export declare function validateModelConfig(personaCatalogue: string[], pipelineCatalogue: string[] | null, merged: MergedConfig, availableModels: AvailableModel[], strict: boolean): ValidationReport;
+export {};