@warpgogol/forge 2.1.0 → 2.3.0

package/dist/src/config/forge-config.d.ts

@@ -0,0 +1,242 @@
+import { z } from "zod";
+import { type StackProfile } from "../profiles/stack-profile.ts";
+export declare const forgeBindingsSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/bindings@1">;
+    commands: z.ZodObject<{
+        validateRfc: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        validateAdr: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        implementStamp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        typecheck: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        test: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        scopedBuild: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        specValidate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sessionSave: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        validate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        produce: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        verify: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        preview: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        lint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    paths: z.ZodObject<{
+        invariantsFile: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        compassDocs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        reviewsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        handoffsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        sessionsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    terminology: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    compass: z.ZodOptional<z.ZodObject<{
+        fileExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        testPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    knowledge: z.ZodOptional<z.ZodObject<{
+        budgets: z.ZodOptional<z.ZodObject<{
+            hot: z.ZodNumber;
+            warm: z.ZodNumber;
+        }, z.core.$strip>>;
+        retentionDays: z.ZodOptional<z.ZodNumber>;
+        staleDays: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    memory: z.ZodOptional<z.ZodObject<{
+        budget: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export interface ForgeBindings {
+    schema: "forge/bindings@1";
+    commands: {
+        validateRfc: string | null;
+        validateAdr: string | null;
+        implementStamp: string | null;
+        typecheck: string | null;
+        test: string | null;
+        scopedBuild: string | null;
+        specValidate: string | null;
+        sessionSave: string | null;
+        validate: string | null;
+        produce: string | null;
+        verify: string | null;
+        preview: string | null;
+        lint: string | null;
+    };
+    paths: {
+        invariantsFile: string | null;
+        compassDocs: string[];
+        reviewsDir: string | null;
+        handoffsDir: string | null;
+        sessionsDir: string | null;
+    };
+    terminology: Record<string, string>;
+    compass?: {
+        fileExtensions?: string[];
+        testPatterns?: string[];
+    };
+    knowledge?: {
+        budgets?: {
+            hot: number;
+            warm: number;
+        };
+        retentionDays?: number;
+        staleDays?: number;
+    };
+    memory?: {
+        budget: number;
+    };
+}
+export declare const forgeSkillPackSchema: z.ZodObject<{
+    prefix: z.ZodString;
+    dir: z.ZodString;
+}, z.core.$strip>;
+export interface ForgeSkillPack {
+    prefix: string;
+    dir: string;
+}
+export declare const forgeMigrationAdapterSchema: z.ZodObject<{
+    id: z.ZodString;
+    module: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface ForgeMigrationAdapter {
+    id: string;
+    module?: string;
+}
+export declare const forgeConfigSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/config@1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        stack: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        packageManager: z.ZodDefault<z.ZodEnum<{
+            pnpm: "pnpm";
+            npm: "npm";
+            yarn: "yarn";
+            bun: "bun";
+            none: "none";
+        }>>;
+        domain: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    paths: z.ZodObject<{
+        rfcsDir: z.ZodDefault<z.ZodString>;
+        adrsDir: z.ZodDefault<z.ZodString>;
+        plansDir: z.ZodDefault<z.ZodString>;
+        auditsDir: z.ZodDefault<z.ZodString>;
+        specsDir: z.ZodDefault<z.ZodString>;
+        skillsDir: z.ZodDefault<z.ZodString>;
+        sessionsDir: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    bindings: z.ZodOptional<z.ZodObject<{
+        schema: z.ZodLiteral<"forge/bindings@1">;
+        commands: z.ZodObject<{
+            validateRfc: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            validateAdr: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            implementStamp: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            typecheck: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            test: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            scopedBuild: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            specValidate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            sessionSave: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            validate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            produce: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            verify: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            preview: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            lint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        paths: z.ZodObject<{
+            invariantsFile: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            compassDocs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            reviewsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            handoffsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            sessionsDir: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        terminology: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        compass: z.ZodOptional<z.ZodObject<{
+            fileExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            testPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        knowledge: z.ZodOptional<z.ZodObject<{
+            budgets: z.ZodOptional<z.ZodObject<{
+                hot: z.ZodNumber;
+                warm: z.ZodNumber;
+            }, z.core.$strip>>;
+            retentionDays: z.ZodOptional<z.ZodNumber>;
+            staleDays: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        memory: z.ZodOptional<z.ZodObject<{
+            budget: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    skillPacks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prefix: z.ZodString;
+        dir: z.ZodString;
+    }, z.core.$strip>>>;
+    migrationAdapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        module: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    forge: z.ZodOptional<z.ZodObject<{
+        syncedVersion: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    profile: z.ZodOptional<z.ZodString>;
+    independentVersionPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export interface ForgeConfig {
+    schema: "forge/config@1";
+    project: {
+        name: string;
+        stack: string[];
+        packageManager: "pnpm" | "npm" | "yarn" | "bun" | "none";
+        /** RFC-0640: optional domain field — absent means software-domain fallback */
+        domain?: string;
+    };
+    paths: {
+        rfcsDir: string;
+        adrsDir: string;
+        plansDir: string;
+        auditsDir: string;
+        specsDir: string;
+        skillsDir: string;
+        sessionsDir: string;
+    };
+    /** Bindings contract (RFC-0393). Optional — absent means no bindings. */
+    bindings?: ForgeBindings;
+    /** Skill packs (RFC-0539). Optional — absent means no project-local packs. */
+    skillPacks?: ForgeSkillPack[];
+    /** Migration adapters (RFC-0546). Optional — absent means built-in adapters only. */
+    migrationAdapters?: ForgeMigrationAdapter[];
+    /** Forge sync metadata (RFC-0543). Optional — absent means never synced. */
+    forge?: {
+        syncedVersion: string | null;
+    };
+    /** RFC-0643: loaded stack profile — present when forge.yaml has a `profile` field */
+    profile?: StackProfile;
+    /** RFC-0704: packages with autonomous npm versions — ecosystem.commit skips platform bump when all staged files belong to these packages */
+    independentVersionPackages?: string[];
+}
+export interface ForgeCliBindingDefault {
+    key: string;
+    template: string;
+}
+export declare const FORGE_CLI_BINDING_DEFAULTS: ForgeCliBindingDefault[];
+export declare const PM_RUNNER_MAP: Record<string, string>;
+export declare function resolvePmRunner(pm: string): string;
+export declare const PM_INSTALL_MAP: Record<string, string>;
+export declare function resolvePmInstall(pm: string): string;
+export declare function applyCliBindingDefaults(pm: string): ForgeBindings["commands"];
+export type ForgePackageManager = ForgeConfig["project"]["packageManager"];
+export declare function resolvePackageManager(pm: string): ForgePackageManager;
+export declare function defaultForgeConfig(projectName: string, packageManager?: string): ForgeConfig;
+export declare function loadForgeConfig(workspaceRoot: string): ForgeConfig;
+export declare function resolveForgeRoot(workspaceRoot: string): string;
+/**
+ * Resolve a binding key (e.g. "commands.validateRfc") from the config.
+ * Returns the resolved string/array, or null if the binding is absent or explicitly null.
+ * Supports placeholder substitution: {id}, {workspace}, {file}.
+ */
+export declare function resolveBinding(config: ForgeConfig, key: string, placeholders?: Record<string, string>): string | string[] | null;
+/**
+ * Resolve a terminology key using a three-tier chain:
+ * 1. Per-project override in bindings.terminology
+ * 2. Caller-provided terminology map (typically from profile.terminology, RFC-0638)
+ * 3. Universal default from TERMINOLOGY_DEFAULTS (RFC-0638)
+ *
+ * If the key is not found in any tier, the key itself is returned.
+ */
+export declare function resolveTerminology(config: ForgeConfig, terminology: Record<string, string> | undefined, key: string): string;
+//# sourceMappingURL=forge-config.d.ts.map

package/dist/src/config/forge-config.d.ts.map

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

package/dist/src/config/forge-config.js

@@ -0,0 +1,359 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Forge project configuration — forge.yaml schema, loader, forge root resolver, and bindings contract. Single source of truth for how forge is deployed in a project.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0391: initial forge-config module with zod schema, loadForgeConfig, resolveForgeRoot.</item>
+  <item>RFC-0393: added ForgeBindings schema, resolveBinding with placeholder substitution.</item>
+  <item>RFC-0538: added optional compass binding section (fileExtensions, testPatterns).</item>
+  <item>RFC-0537: added sessionsDir to paths and bindings.paths schemas.</item>
+  <item>RFC-0539: added ForgeSkillPack schema and skillPacks to forge config for project-declared skill packs.</item>
+  <item>RFC-0540: added implementStamp to bindings schema, FORGE_CLI_BINDING_DEFAULTS, PM_RUNNER_MAP, resolvePmRunner, applyCliBindingDefaults.</item>
+  <item>RFC-0540 fix: eliminated type casts — applyCliBindingDefaults returns ForgeBindings["commands"] directly, resolvePackageManager validates pm against enum.</item>
+  <item>RFC-0543: added optional forge.syncedVersion field to forgeConfigSchema and defaultForgeConfig for consumer upgrade tracking.</item>
+  <item>RFC-0546: added optional migrationAdapters field to forgeConfigSchema for migration-adapter registry discovery.</item>
+  <item>RFC-0639: added 5 semantic command keys (validate, produce, verify, preview, lint), terminology promoted from .optional() to .default({}), resolveTerminology function.</item>
+  <item>RFC-0640: added optional domain field to project section for domain-aware bootstrapping and health checks.</item>
+  <item>RFC-0643: added optional profile field to forgeConfigSchema and ForgeConfig; loadForgeConfig loads profiles/<id>.yaml when present.</item>
+  <item>RFC-0661: added optional knowledge.budgets binding for hot/warm layer character budget overrides.</item>
+  <item>RFC-0662: added optional knowledge.retentionDays and knowledge.staleDays bindings for compaction overrides.</item>
+  <item>RFC-0704: added optional independentVersionPackages field to forgeConfigSchema for packages with autonomous npm versions.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { parse as parseYaml } from "yaml";
+import { TERMINOLOGY_DEFAULTS } from "../profiles/profile-schema.js";
+import { listStackProfiles } from "../profiles/stack-profile.js";
+// ---------------------------------------------------------------------------
+// Bindings schema (forge/bindings@1) — RFC-0393
+// ---------------------------------------------------------------------------
+export const forgeBindingsSchema = z.object({
+    schema: z.literal("forge/bindings@1"),
+    commands: z.object({
+        validateRfc: z.string().nullable().default(null),
+        validateAdr: z.string().nullable().default(null),
+        implementStamp: z.string().nullable().default(null),
+        typecheck: z.string().nullable().default(null),
+        test: z.string().nullable().default(null),
+        scopedBuild: z.string().nullable().default(null),
+        specValidate: z.string().nullable().default(null),
+        sessionSave: z.string().nullable().default(null),
+        // Semantic keys (RFC-0639) — domain-neutral, optional
+        validate: z.string().nullable().default(null),
+        produce: z.string().nullable().default(null),
+        verify: z.string().nullable().default(null),
+        preview: z.string().nullable().default(null),
+        lint: z.string().nullable().default(null),
+    }),
+    paths: z.object({
+        invariantsFile: z.string().nullable().default(null),
+        compassDocs: z.array(z.string()).default([]),
+        reviewsDir: z.string().nullable().default(null),
+        handoffsDir: z.string().nullable().default(null),
+        sessionsDir: z.string().nullable().default(null),
+    }),
+    terminology: z.record(z.string(), z.string()).default({}),
+    compass: z
+        .object({
+        fileExtensions: z.array(z.string()).optional(),
+        testPatterns: z.array(z.string()).optional(),
+    })
+        .optional(),
+    // RFC-0661: optional knowledge layer character budget overrides
+    // RFC-0662: optional retention/stale day overrides
+    knowledge: z
+        .object({
+        budgets: z
+            .object({
+            hot: z.number().positive(),
+            warm: z.number().positive(),
+        })
+            .optional(),
+        retentionDays: z.number().positive().optional(),
+        staleDays: z.number().positive().optional(),
+    })
+        .optional(),
+    // RFC-0664: optional memory layer budget override (MEMORY.md hot store)
+    memory: z
+        .object({
+        budget: z.number().int().positive().default(4096),
+    })
+        .optional(),
+});
+// ---------------------------------------------------------------------------
+// Skill packs schema (RFC-0539)
+// ---------------------------------------------------------------------------
+export const forgeSkillPackSchema = z.object({
+    prefix: z
+        .string()
+        .regex(/^[a-z][a-z0-9]{1,7}$/, "prefix must be 2-8 chars: lowercase letter followed by lowercase alphanumeric")
+        .refine((v) => v !== "fo", "fo prefix is reserved for forge"),
+    dir: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// Migration adapters schema (RFC-0546)
+// ---------------------------------------------------------------------------
+export const forgeMigrationAdapterSchema = z.object({
+    id: z.string().min(1),
+    module: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Schema (forge/config@1)
+// ---------------------------------------------------------------------------
+export const forgeConfigSchema = z.object({
+    schema: z.literal("forge/config@1"),
+    project: z.object({
+        name: z.string().min(1),
+        stack: z.array(z.string()).default([]),
+        packageManager: z.enum(["pnpm", "npm", "yarn", "bun", "none"]).default("pnpm"),
+        // RFC-0640: optional domain field — absent means software-domain fallback
+        domain: z.string().optional(),
+    }),
+    paths: z.object({
+        rfcsDir: z.string().default("docs/rfcs"),
+        adrsDir: z.string().default("docs/adrs"),
+        plansDir: z.string().default("docs/plans"),
+        auditsDir: z.string().default("docs/audits"),
+        specsDir: z.string().default("docs/specs"),
+        skillsDir: z.string().default(".agents/skills"),
+        sessionsDir: z.string().default("docs/sessions"),
+    }),
+    /** Bindings contract (RFC-0393). Optional — absent means no bindings. */
+    bindings: forgeBindingsSchema.optional(),
+    /** Skill packs (RFC-0539). Optional — absent means no project-local packs. */
+    skillPacks: z.array(forgeSkillPackSchema).optional(),
+    /** Migration adapters (RFC-0546). Optional — absent means built-in adapters only. */
+    migrationAdapters: z.array(forgeMigrationAdapterSchema).optional(),
+    /** Forge sync metadata (RFC-0543). Optional — absent means never synced. */
+    forge: z
+        .object({
+        syncedVersion: z.string().nullable().default(null),
+    })
+        .optional(),
+    /** RFC-0643: profile id — when present, loadForgeConfig loads the corresponding profiles/<id>.yaml */
+    profile: z.string().optional(),
+    /** RFC-0704: packages with autonomous npm versions — ecosystem.commit skips platform bump when all staged files belong to these packages */
+    independentVersionPackages: z.array(z.string()).optional(),
+});
+export const FORGE_CLI_BINDING_DEFAULTS = [
+    { key: "commands.validateRfc", template: "forge rfc.validate --id {id} --json" },
+    { key: "commands.validateAdr", template: "forge adr.validate --id {id} --json" },
+    {
+        key: "commands.implementStamp",
+        template: "forge rfc.implement.stamp --id {id} --implementation-commit {commit}",
+    },
+    { key: "commands.specValidate", template: "forge spec.validate --spec={id} --json" },
+    { key: "commands.sessionSave", template: "forge session.save --json" },
+];
+export const PM_RUNNER_MAP = {
+    pnpm: "pnpm exec",
+    npm: "npx",
+    yarn: "yarn exec",
+    bun: "bunx",
+    none: "npx",
+};
+export function resolvePmRunner(pm) {
+    return PM_RUNNER_MAP[pm] ?? "npx";
+}
+export const PM_INSTALL_MAP = {
+    pnpm: "pnpm add",
+    npm: "npm install",
+    yarn: "yarn add",
+    bun: "bun add",
+    none: "npm install",
+};
+export function resolvePmInstall(pm) {
+    return PM_INSTALL_MAP[pm] ?? "npm install";
+}
+export function applyCliBindingDefaults(pm) {
+    const runner = resolvePmRunner(pm);
+    const commands = {
+        validateRfc: null,
+        validateAdr: null,
+        implementStamp: null,
+        typecheck: null,
+        test: null,
+        scopedBuild: null,
+        specValidate: null,
+        sessionSave: null,
+        // Semantic keys (RFC-0639) — stack-dependent, not CLI-backed
+        validate: null,
+        produce: null,
+        verify: null,
+        preview: null,
+        lint: null,
+    };
+    for (const entry of FORGE_CLI_BINDING_DEFAULTS) {
+        const bareKey = entry.key.replace("commands.", "");
+        commands[bareKey] = `${runner} ${entry.template}`;
+    }
+    return commands;
+}
+const VALID_PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "bun", "none"];
+export function resolvePackageManager(pm) {
+    return VALID_PACKAGE_MANAGERS.includes(pm) ? pm : "pnpm";
+}
+export function defaultForgeConfig(projectName, packageManager) {
+    const pm = resolvePackageManager(packageManager ?? "pnpm");
+    return {
+        schema: "forge/config@1",
+        project: {
+            name: projectName,
+            stack: [],
+            packageManager: pm,
+        },
+        paths: {
+            rfcsDir: "docs/rfcs",
+            adrsDir: "docs/adrs",
+            plansDir: "docs/plans",
+            auditsDir: "docs/audits",
+            specsDir: "docs/specs",
+            skillsDir: ".agents/skills",
+            sessionsDir: "docs/sessions",
+        },
+        bindings: {
+            schema: "forge/bindings@1",
+            commands: applyCliBindingDefaults(pm),
+            paths: {
+                invariantsFile: null,
+                compassDocs: [],
+                reviewsDir: "docs/reviews",
+                handoffsDir: "docs/handoffs",
+                sessionsDir: "docs/sessions",
+            },
+            terminology: {},
+            compass: {},
+        },
+        forge: { syncedVersion: null },
+    };
+}
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+export function loadForgeConfig(workspaceRoot) {
+    const configPath = path.join(workspaceRoot, "forge.yaml");
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`forge.yaml not found at ${configPath}. Run 'forge create' to create project configuration.`);
+    }
+    const raw = fs.readFileSync(configPath, "utf8");
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`forge.yaml at ${configPath} is not valid YAML: ${err.message}`);
+    }
+    const result = forgeConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`forge.yaml at ${configPath} failed schema validation:\n${issues}\nFix the listed fields or run 'forge create' to regenerate defaults.`);
+    }
+    const rawData = result.data;
+    const profileId = rawData["profile"];
+    // RFC-0643: load stack profile when `profile` field is present in forge.yaml
+    let loadedProfile;
+    if (profileId) {
+        try {
+            const forgeRoot = resolveForgeRoot(workspaceRoot);
+            const profiles = listStackProfiles(forgeRoot);
+            loadedProfile = profiles.find((p) => p.id === profileId);
+        }
+        catch {
+            // forge root not resolvable — profile not loaded
+        }
+    }
+    const config = { ...rawData };
+    if (loadedProfile) {
+        config.profile = loadedProfile;
+    }
+    else {
+        delete config.profile;
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// Forge root resolver — the single place that decides monorepo vs npm-installed
+// ---------------------------------------------------------------------------
+export function resolveForgeRoot(workspaceRoot) {
+    const monorepoPath = path.join(workspaceRoot, "packages", "forge");
+    if (fs.existsSync(path.join(monorepoPath, "package.json"))) {
+        return monorepoPath;
+    }
+    const npmPath = path.join(workspaceRoot, "node_modules", "@warpgogol", "forge");
+    if (fs.existsSync(path.join(npmPath, "package.json"))) {
+        return npmPath;
+    }
+    throw new Error(`Could not resolve forge root. Checked:\n  ${monorepoPath}\n  ${npmPath}\nEnsure @warpgogol/forge is installed or packages/forge exists.`);
+}
+// ---------------------------------------------------------------------------
+// Binding resolver — RFC-0393
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a binding key (e.g. "commands.validateRfc") from the config.
+ * Returns the resolved string/array, or null if the binding is absent or explicitly null.
+ * Supports placeholder substitution: {id}, {workspace}, {file}.
+ */
+export function resolveBinding(config, key, placeholders) {
+    if (!config.bindings) {
+        return null;
+    }
+    const parts = key.split(".");
+    let current = config.bindings;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return null;
+        }
+        if (typeof current !== "object" || !(part in current)) {
+            return null;
+        }
+        current = current[part];
+    }
+    if (current === null || current === undefined) {
+        return null;
+    }
+    if (Array.isArray(current)) {
+        return current;
+    }
+    if (typeof current === "string") {
+        if (placeholders) {
+            return substitutePlaceholders(current, placeholders);
+        }
+        return current;
+    }
+    return null;
+}
+function substitutePlaceholders(template, placeholders) {
+    let result = template;
+    for (const [key, value] of Object.entries(placeholders)) {
+        result = result.replaceAll(`{${key}}`, value);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Terminology resolver — RFC-0639
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a terminology key using a three-tier chain:
+ * 1. Per-project override in bindings.terminology
+ * 2. Caller-provided terminology map (typically from profile.terminology, RFC-0638)
+ * 3. Universal default from TERMINOLOGY_DEFAULTS (RFC-0638)
+ *
+ * If the key is not found in any tier, the key itself is returned.
+ */
+export function resolveTerminology(config, terminology, key) {
+    if (config.bindings?.terminology?.[key]) {
+        return config.bindings.terminology[key];
+    }
+    if (terminology?.[key]) {
+        return terminology[key];
+    }
+    return TERMINOLOGY_DEFAULTS[key] ?? key;
+}
+//# sourceMappingURL=forge-config.js.map

package/dist/src/config/forge-config.js.map

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

package/dist/src/forge-module.d.ts

@@ -0,0 +1,16 @@
+import type { ForgeCommandDefinition } from "./types.ts";
+export interface ForgeModuleRegistry {
+    registerCommand(command: ForgeCommandDefinition): void;
+    registerPipeline(name: string, steps: ForgePipelineStep[]): void;
+}
+export interface ForgeModule {
+    name: string;
+    version: string;
+    register(registry: ForgeModuleRegistry): void | Promise<void>;
+}
+export type { ForgeCommandDefinition, ForgeCommandResult, ForgeFlagSpec } from "./types.ts";
+export interface ForgePipelineStep {
+    command: string;
+    args?: string[];
+}
+//# sourceMappingURL=forge-module.d.ts.map

package/dist/src/forge-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-module.d.ts","sourceRoot":"","sources":["../../src/forge-module.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOzD,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACvD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAGD,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/src/forge-module.js

@@ -0,0 +1,15 @@
+/*
+<MODULE_CONTRACT>
+<purpose>ForgeModule interfaces — structurally compatible with KernelModule from @warpgogol/site-kernel. Forge does NOT import from site-kernel.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/site-kernel — forge must be installable without it.</item>
+  <item>Do not add project-specific fields to ForgeModule — keep it minimal and portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial ForgeModule, ForgeModuleRegistry, ForgeCommandDefinition, ForgePipelineStep interfaces.</item>
+  <item>Forge autonomy refactor: ForgeCommandDefinition and ForgeCommandResult now reference canonical types from types.ts.</item>
+</CHANGE_SUMMARY>
+*/
+export {};
+//# sourceMappingURL=forge-module.js.map