@warpgogol/forge 4.1.6 → 4.2.1

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

@@ -0,0 +1,363 @@
+/*
+<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

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,29 @@
+import type { ForgeCommandDefinition } from "./types.ts";
+export interface ForgePipelineStep {
+    command: string;
+    args?: string[];
+}
+export interface ForgePipelineDeclaration {
+    name: string;
+    steps: ForgePipelineStep[];
+}
+/**
+ * RFC-1038: ForgeModuleRegistry is kept for the CLI's standalone registry
+ * implementation. The kernel no longer uses it — modules export commands/
+ * pipelines arrays directly. The CLI uses it to collect commands from
+ * ForgeModule.commands[] into its own registry.
+ */
+export interface ForgeModuleRegistry {
+    registerCommand(command: ForgeCommandDefinition): void;
+    registerPipeline(name: string, steps: ForgePipelineStep[]): void;
+}
+export interface ForgeModule {
+    name: string;
+    version: string;
+    runtime: "autonomous" | "werkstatt-adapter";
+    declarations: never[];
+    commands: ForgeCommandDefinition[];
+    pipelines: ForgePipelineDeclaration[];
+}
+export type { ForgeCommandDefinition, ForgeCommandResult, ForgeFlagSpec } from "./types.ts";
+//# 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":"AAeA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAQzD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,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,OAAO,EAAE,YAAY,GAAG,mBAAmB,CAAC;IAC5C,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAGD,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/forge-module.js

@@ -0,0 +1,16 @@
+/*
+<MODULE_CONTRACT>
+<purpose>ForgeModule interfaces — structurally compatible with KernelModule from @warpgogol/site-kernel. Forge does NOT import from site-kernel. The optional runtime field (RFC-0940) declares whether a module is autonomous or a werkstatt adapter.</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>
+  <item>RFC-0940: add optional runtime field to ForgeModule for autonomy declaration.</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;;;;;;;;;;;;;EAaE"}

package/dist/src/index.d.ts

@@ -0,0 +1,39 @@
+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, EDITABLE_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, resolveTerminology, 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 { stackProfileDomainFieldsSchema, profileArtifactSchema, profileWorkspaceTypeSchema, profileInvariantSchema, UNIVERSAL_TERMINOLOGY_KEYS, TERMINOLOGY_DEFAULTS, type StackProfileDomainFields, type ProfileArtifact, type ProfileWorkspaceType, type ProfileInvariant, } from "./profiles/profile-schema.ts";
+export { parseKnowledgeFile, serializeKnowledgeFile, knowledgeEntryMetaSchema, type KnowledgeLayer, type KnowledgeEntryStatus, type KnowledgeEntryMeta, type KnowledgeEntry, type LegacySection, type ParseIssue, type ParsedKnowledgeFile, } from "./knowledge/index.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 { scaffoldMemoryLayer, type MemoryScaffoldResult } from "./onboarding/memory-scaffold.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 { forgePluginManifestSchema, type ForgePluginManifest, } from "./plugin/forge-plugin-manifest.ts";
+export type { CompassContractBlockSpec, CompassContractRequiredTag, CompassContractExtensionPoint, CompassContractRegistry, CompassContractRegistryEntry, CompassContractValidationDiagnostic, } from "./compass/types.ts";
+export { createForgeCoreModule } from "../os/core/core.module.ts";
+export { createForgeRfcModule } from "../os/rfc/rfc.module.ts";
+export { createForgeWorkflowModule } from "../os/workflow/workflow.module.ts";
+export { createForgeNamingModule } from "../os/naming/naming.module.ts";
+export { forgeCompassModule } from "../os/compass/compass.module.ts";
+export { forgeWerkstattModule } from "../os/werkstatt/werkstatt.module.ts";
+export { createForgeSpecModule } from "../os/spec/spec.module.ts";
+export { createForgeAdrModule } from "../os/adr/adr.module.ts";
+export { createForgePlanModule } from "../os/plan/plan.module.ts";
+export { createForgeAuditModule } from "../os/audit/audit.module.ts";
+export { createForgeMissionModule } from "../os/mission/mission.module.ts";
+export { createForgeExplorationModule } from "../os/exploration/exploration.module.ts";
+export { createForgeNotesModule } from "../os/notes/notes.module.ts";
+export { createForgeProgramModule } from "../os/program/program.module.ts";
+export { forgePluginModule } from "../os/plugin/plugin.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,59 @@
+/*
+<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, EDITABLE_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, resolveTerminology, FORGE_CLI_BINDING_DEFAULTS, PM_RUNNER_MAP, resolvePmRunner, applyCliBindingDefaults, resolvePackageManager, } from "./config/forge-config.js";
+// Stack profiles (RFC-0392, RFC-0638)
+export { stackProfileSchema, loadStackProfile, listStackProfiles, detectStack, } from "./profiles/stack-profile.js";
+// Profile domain fields (RFC-0638)
+export { stackProfileDomainFieldsSchema, profileArtifactSchema, profileWorkspaceTypeSchema, profileInvariantSchema, UNIVERSAL_TERMINOLOGY_KEYS, TERMINOLOGY_DEFAULTS, } from "./profiles/profile-schema.js";
+// Knowledge module (RFC-0660)
+export { parseKnowledgeFile, serializeKnowledgeFile, knowledgeEntryMetaSchema, } from "./knowledge/index.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 { scaffoldMemoryLayer } from "./onboarding/memory-scaffold.js";
+export { FORGE_PROTECTED_PATHS, DEFAULT_EXCLUDE_PATTERNS } from "./migration-adapters/types.js";
+export { nodeTypescriptPnpmAdapter, phaserPnpmAdapter, getAdapters, detectAdapter, detectAdapters, } from "./migration-adapters/index.js";
+// Plugin manifest (RFC-0941, RFC-0943)
+export { forgePluginManifestSchema, } from "./plugin/forge-plugin-manifest.js";
+// OS modules
+export { createForgeCoreModule } from "../os/core/core.module.js";
+export { createForgeRfcModule } from "../os/rfc/rfc.module.js";
+export { createForgeWorkflowModule } from "../os/workflow/workflow.module.js";
+export { createForgeNamingModule } from "../os/naming/naming.module.js";
+export { forgeCompassModule } from "../os/compass/compass.module.js";
+export { forgeWerkstattModule } from "../os/werkstatt/werkstatt.module.js";
+export { createForgeSpecModule } from "../os/spec/spec.module.js";
+export { createForgeAdrModule } from "../os/adr/adr.module.js";
+export { createForgePlanModule } from "../os/plan/plan.module.js";
+export { createForgeAuditModule } from "../os/audit/audit.module.js";
+export { createForgeMissionModule } from "../os/mission/mission.module.js";
+export { createForgeExplorationModule } from "../os/exploration/exploration.module.js";
+export { createForgeNotesModule } from "../os/notes/notes.module.js";
+export { createForgeProgramModule } from "../os/program/program.module.js";
+export { forgePluginModule } from "../os/plugin/plugin.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":"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"}

package/dist/src/knowledge/budgets.d.ts

@@ -0,0 +1,38 @@
+import type { ParsedKnowledgeFile, KnowledgeLayer } from "./schema.ts";
+export interface KnowledgeBudgets {
+    hot: number;
+    warm: number;
+}
+export interface LayerBudgetReport {
+    skill: string;
+    file: string;
+    layer: KnowledgeLayer;
+    activeChars: number;
+    budget: number;
+    exceededBy: number;
+    pack?: string;
+}
+export declare const DEFAULT_KNOWLEDGE_BUDGETS: KnowledgeBudgets;
+/**
+ * Compute per-file budget reports for parsed knowledge files.
+ *
+ * - Counts only `status: active` entries (heading + metadata block + body).
+ * - Uses `ParsedKnowledgeFile.layer` to determine which budget applies.
+ * - Skips files with undeterminable layer (null) or L0 (cold, no budget).
+ * - Skips files with parse issues (schema errors are already reported by SKILL-19).
+ *
+ * Pure: no filesystem side effects.
+ */
+export declare function computeLayerBudgets(files: ParsedKnowledgeFile[], budgets: KnowledgeBudgets, skillNames: Map<string, string>): LayerBudgetReport[];
+/**
+ * Read effective knowledge budgets from forge.yaml bindings.
+ *
+ * Falls back to defaults (hot: 4096, warm: 8192) when:
+ * - forge.yaml is not found
+ * - bindings.knowledge.budgets is absent
+ * - override values are invalid (non-positive, non-integer)
+ *
+ * Does NOT validate the override shape — forge.doctor handles that separately.
+ */
+export declare function resolveKnowledgeBudgets(workspaceRoot: string): KnowledgeBudgets;
+//# sourceMappingURL=budgets.d.ts.map

package/dist/src/knowledge/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../../src/knowledge/budgets.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMvE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,yBAAyB,EAAE,gBAGvC,CAAC;AAMF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,iBAAiB,EAAE,CA0DrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CA0B/E"}