@warpgogol/forge 2.9.11 → 2.9.13

package/dist/src/cli-output.js

@@ -1,53 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>CLI output rendering helpers (RFC-0542) — renderNextSteps,
-renderIdeRecommendation, generateHelp. Pure functions, no I/O, no process.exit.
-Importable by bin/cli.ts and unit tests.</purpose>
-<non-goals>
-  <item>Do not call console.log or process.exit — callers handle output.</item>
-  <item>Do not import from bin/ — this is the portable layer.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0542: initial CLI output rendering helpers — renderNextSteps, renderIdeRecommendation, generateHelp.</item>
-</CHANGE_SUMMARY>
-*/
-export function renderNextSteps(steps) {
-    if (!steps || steps.length === 0)
-        return "";
-    const lines = ["\nNext steps:"];
-    for (const step of steps) {
-        const label = step.kind === "required" ? "[must do]" : "[can do]";
-        lines.push(`  • ${step.action}        ${label}`);
-    }
-    return lines.join("\n");
-}
-export function renderIdeRecommendation() {
-    return "\nRecommended IDE: Windsurf (tested with forge). Other IDEs (VS Code, Cursor)\nwork but are not tested.";
-}
-export function generateHelp(registry) {
-    const commands = registry.listCommands().filter((cmd) => !cmd.hidden);
-    const header = `forge — autonomous project tooling
-
-Usage:
-  forge <command> [args...] [--flags...]
-  forge --help <command>    Show per-command flags and description
-
-Flags:
-  --json              Output results as JSON
-  --dry-run           Show what would happen without making changes
-  --site <name>       Target a specific site/app
-  --version           Show forge version
-  --help              Show this help (or per-command help with --help <command>)
-
-Registered commands (${commands.length}):`;
-    const commandLines = commands
-        .map((cmd) => {
-        const desc = cmd.description.length > 80 ? cmd.description.slice(0, 77) + "..." : cmd.description;
-        const displayName = cmd.name.replace(/^forge\./, "");
-        return `  ${displayName.padEnd(40)} ${desc}`;
-    })
-        .join("\n");
-    return `${header}\n${commandLines}\n`;
-}
-//# sourceMappingURL=cli-output.js.map

package/dist/src/cli-output.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-output.js","sourceRoot":"","sources":["../../src/cli-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAIF,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,WAAW,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,yGAAyG,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG;;;;;;;;;;;;;uBAaM,QAAQ,CAAC,MAAM,IAAI,CAAC;IAEzC,MAAM,YAAY,GAAG,QAAQ;SAC1B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,IAAI,GACR,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;QACvF,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,KAAK,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,GAAG,MAAM,KAAK,YAAY,IAAI,CAAC;AACxC,CAAC"}

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

@@ -1,242 +0,0 @@
-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, forgeRootOverride?: 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

@@ -1 +0,0 @@
-{"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

@@ -1,363 +0,0 @@
-/*
-<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, forgeRootOverride) {
-    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 = forgeRootOverride ?? 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;
-    }
-    if (fs.existsSync(path.join(workspaceRoot, "profiles")) &&
-        fs.existsSync(path.join(workspaceRoot, "package.json"))) {
-        return workspaceRoot;
-    }
-    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