@warpgogol/forge 0.3.1

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

@@ -0,0 +1,170 @@
+import { z } from "zod";
+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>>;
+    }, 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.ZodOptional<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>>;
+}, 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;
+    };
+    paths: {
+        invariantsFile: string | null;
+        compassDocs: string[];
+        reviewsDir: string | null;
+        handoffsDir: string | null;
+        sessionsDir: string | null;
+    };
+    terminology?: Record<string, string>;
+    compass?: {
+        fileExtensions?: string[];
+        testPatterns?: string[];
+    };
+}
+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";
+        }>>;
+    }, 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>>;
+        }, 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.ZodOptional<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>>;
+    }, 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>>;
+}, z.core.$strip>;
+export interface ForgeConfig {
+    schema: "forge/config@1";
+    project: {
+        name: string;
+        stack: string[];
+        packageManager: "pnpm" | "npm" | "yarn" | "bun" | "none";
+    };
+    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;
+    };
+}
+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 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;
+//# 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,259 @@
+/*
+<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>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { parse as parseYaml } from "yaml";
+// ---------------------------------------------------------------------------
+// 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),
+    }),
+    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()).optional(),
+    compass: z
+        .object({
+        fileExtensions: z.array(z.string()).optional(),
+        testPatterns: z.array(z.string()).optional(),
+    })
+        .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"),
+    }),
+    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(),
+});
+export const FORGE_CLI_BINDING_DEFAULTS = [
+    { key: "commands.validateRfc", template: "forge rfc.validate {id} --json" },
+    { key: "commands.validateAdr", template: "forge adr.validate {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" },
+];
+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 function applyCliBindingDefaults(pm) {
+    const runner = resolvePmRunner(pm);
+    const commands = {
+        validateRfc: null,
+        validateAdr: null,
+        implementStamp: null,
+        typecheck: null,
+        test: null,
+        scopedBuild: null,
+        specValidate: 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.`);
+    }
+    return result.data;
+}
+// ---------------------------------------------------------------------------
+// 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;
+}
+//# 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"forge-module.js","sourceRoot":"","sources":["../../src/forge-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE"}

package/dist/src/index.d.ts

@@ -0,0 +1,30 @@
+export type { ForgeCommandInput, ForgeCommandResult, ForgeCommandTiming, ForgeNextStep, ForgeFlagValue, ForgeFlagSpec, ForgeCommandMetadata, ForgeRegisteredCommandInfo, ForgeCommandDefinition, ForgeCommandScope, Diagnostic, DiagnosticSeverity, DiagnosticEvidence, CheckResult, ForgeLogger, CommandRegistry, ForgeRuntimeContext, ForgeSiteContext, ForgeOutputFormat, GateMetadata, GateSeverity, GatePhase, GateConditional, } from "./types.ts";
+export { writeFileAtomic, type WriteFileAtomicOptions, GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, type GeneratedHeaderInput, type StripGeneratedMarkerResult, toKebabCase, collectFiles, fileExists, type CollectFilesOptions, byteHash, } from "./utils/index.ts";
+export type { ForgeModule, ForgeModuleRegistry, ForgePipelineStep } from "./forge-module.ts";
+export { skillFrontmatterSchema, type SkillFrontmatter } from "./skill-schema.ts";
+export { FORGE_SKILLS, type ForgeSkillEntry } from "./registry.ts";
+export { forgeConfigSchema, forgeBindingsSchema, defaultForgeConfig, loadForgeConfig, resolveForgeRoot, resolveBinding, FORGE_CLI_BINDING_DEFAULTS, PM_RUNNER_MAP, resolvePmRunner, applyCliBindingDefaults, resolvePackageManager, type ForgeConfig, type ForgeBindings, type ForgeCliBindingDefault, type ForgePackageManager, type ForgeMigrationAdapter, } from "./config/forge-config.ts";
+export { stackProfileSchema, loadStackProfile, listStackProfiles, detectStack, type StackProfile, type ProfileFile, } from "./profiles/stack-profile.ts";
+export { runSkillValidate } from "./validators/skill-validate.ts";
+export { runPortValidate } from "./validators/port-validate.ts";
+export { renderNextSteps, renderIdeRecommendation, generateHelp } from "./cli-output.ts";
+export { runInit } from "./onboarding/init.ts";
+export { runScaffold } from "./onboarding/scaffold.ts";
+export { runDoctor } from "./onboarding/doctor.ts";
+export { runAgentsGenerate } from "./onboarding/agents-generate.ts";
+export { runScaffoldProject } from "./onboarding/scaffold-project.ts";
+export type { MigrationAdapter, AdapterAnalysis, MigrationResult, Conflict, } from "./migration-adapters/types.ts";
+export { FORGE_PROTECTED_PATHS, DEFAULT_EXCLUDE_PATTERNS } from "./migration-adapters/types.ts";
+export { nodeTypescriptPnpmAdapter, phaserPnpmAdapter, getAdapters, detectAdapter, detectAdapters, } from "./migration-adapters/index.ts";
+export { forgeCoreModule } from "../os/core/core.module.ts";
+export { forgeRfcModule } from "../os/rfc/rfc.module.ts";
+export { forgeWorkflowModule } from "../os/workflow/workflow.module.ts";
+export { forgeNamingModule } from "../os/naming/naming.module.ts";
+export { forgeCompassModule } from "../os/compass/compass.module.ts";
+export { forgeWerkstattModule } from "../os/werkstatt/werkstatt.module.ts";
+export { forgeSpecModule } from "../os/spec/spec.module.ts";
+export { forgeAdrModule } from "../os/adr/adr.module.ts";
+export { forgePlanModule } from "../os/plan/plan.module.ts";
+export { forgeAuditModule } from "../os/audit/audit.module.ts";
+export { forgeMissionModule } from "../os/mission/mission.module.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -0,0 +1,48 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Public entrypoint for @warpgogol/forge — exports ForgeModule types, canonical types, utilities, skill schema, registry, validators, onboarding, and OS modules.</purpose>
+<non-goals>
+  <item>Do not export internal implementation details — only public API.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial public exports for forge package.</item>
+  <item>Forge autonomy refactor: add canonical types and utils exports.</item>
+</CHANGE_SUMMARY>
+*/
+// Canonical utilities
+export { writeFileAtomic, GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, toKebabCase, collectFiles, fileExists, byteHash, } from "./utils/index.js";
+// Skill schema
+export { skillFrontmatterSchema } from "./skill-schema.js";
+// Skill registry
+export { FORGE_SKILLS } from "./registry.js";
+// Forge config (RFC-0391)
+export { forgeConfigSchema, forgeBindingsSchema, defaultForgeConfig, loadForgeConfig, resolveForgeRoot, resolveBinding, FORGE_CLI_BINDING_DEFAULTS, PM_RUNNER_MAP, resolvePmRunner, applyCliBindingDefaults, resolvePackageManager, } from "./config/forge-config.js";
+// Stack profiles (RFC-0392)
+export { stackProfileSchema, loadStackProfile, listStackProfiles, detectStack, } from "./profiles/stack-profile.js";
+// Validators
+export { runSkillValidate } from "./validators/skill-validate.js";
+export { runPortValidate } from "./validators/port-validate.js";
+// CLI output rendering (RFC-0542)
+export { renderNextSteps, renderIdeRecommendation, generateHelp } from "./cli-output.js";
+// Onboarding
+export { runInit } from "./onboarding/init.js";
+export { runScaffold } from "./onboarding/scaffold.js";
+export { runDoctor } from "./onboarding/doctor.js";
+export { runAgentsGenerate } from "./onboarding/agents-generate.js";
+export { runScaffoldProject } from "./onboarding/scaffold-project.js";
+export { FORGE_PROTECTED_PATHS, DEFAULT_EXCLUDE_PATTERNS } from "./migration-adapters/types.js";
+export { nodeTypescriptPnpmAdapter, phaserPnpmAdapter, getAdapters, detectAdapter, detectAdapters, } from "./migration-adapters/index.js";
+// OS modules
+export { forgeCoreModule } from "../os/core/core.module.js";
+export { forgeRfcModule } from "../os/rfc/rfc.module.js";
+export { forgeWorkflowModule } from "../os/workflow/workflow.module.js";
+export { forgeNamingModule } from "../os/naming/naming.module.js";
+export { forgeCompassModule } from "../os/compass/compass.module.js";
+export { forgeWerkstattModule } from "../os/werkstatt/werkstatt.module.js";
+export { forgeSpecModule } from "../os/spec/spec.module.js";
+export { forgeAdrModule } from "../os/adr/adr.module.js";
+export { forgePlanModule } from "../os/plan/plan.module.js";
+export { forgeAuditModule } from "../os/audit/audit.module.js";
+export { forgeMissionModule } from "../os/mission/mission.module.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AA6BF,sBAAsB;AACtB,OAAO,EACL,eAAe,EAEf,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAG9B,WAAW,EACX,YAAY,EACZ,UAAU,EAEV,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAK1B,eAAe;AACf,OAAO,EAAE,sBAAsB,EAAyB,MAAM,mBAAmB,CAAC;AAElF,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAwB,MAAM,eAAe,CAAC;AAEnE,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GAMtB,MAAM,0BAA0B,CAAC;AAElC,4BAA4B;AAC5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GAGZ,MAAM,6BAA6B,CAAC;AAErC,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzF,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAStE,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/src/migration-adapters/git-utils.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterAnalysis } from "./types.ts";
+export declare function runPostSetup(sourceDir: string, targetDir: string, analysis: AdapterAnalysis): void;
+//# sourceMappingURL=git-utils.d.ts.map

package/dist/src/migration-adapters/git-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../../src/migration-adapters/git-utils.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CA4BlG"}

package/dist/src/migration-adapters/git-utils.js

@@ -0,0 +1,46 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Shared git utilities for migration adapters — git init and git history transfer via format-patch + git am (RFC-0547).</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not implement adapter-specific logic — only shared git operations.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0547: extract shared postSetup git logic from duplicated adapter implementations.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+export function runPostSetup(sourceDir, targetDir, analysis) {
+    const gitDir = path.join(targetDir, ".git");
+    if (analysis.gitHistory) {
+        try {
+            const patchDir = path.join(targetDir, ".forge-migration-patches");
+            fs.mkdirSync(patchDir, { recursive: true });
+            execFileSync("git", ["-C", sourceDir, "format-patch", "--all", "-o", patchDir], { stdio: "pipe" });
+            execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
+            const patches = fs.readdirSync(patchDir).filter((f) => f.endsWith(".patch")).sort();
+            if (patches.length > 0) {
+                for (const patch of patches) {
+                    execFileSync("git", ["am", path.join(patchDir, patch)], { cwd: targetDir, stdio: "pipe" });
+                }
+            }
+            fs.rmSync(patchDir, { recursive: true, force: true });
+            return;
+        }
+        catch (err) {
+            console.warn(`forge: git history transfer failed, falling back to clean git init: ${err instanceof Error ? err.message : String(err)}`);
+            if (!fs.existsSync(gitDir)) {
+                execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
+            }
+        }
+    }
+    else {
+        if (!fs.existsSync(gitDir)) {
+            execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
+        }
+    }
+}
+//# sourceMappingURL=git-utils.js.map