@warpgogol/forge 0.3.1

package/dist/src/registry.d.ts

@@ -0,0 +1,38 @@
+import type { ForgeConfig } from "./config/forge-config.ts";
+/**
+ * Every entry MUST be portable — it runs in any forge-bootstrapped project
+ * using only forge commands, forge bindings, and standard project files.
+ * Ecosystem-bound skills belong in project skill packs (RFC-0539), not here.
+ */
+export interface ForgeSkillEntry {
+    name: string;
+    category: "fo" | "shared" | "meta";
+    invocation: "user" | "model";
+    concerns: "read-only" | "document-only" | "content-mutation" | "code-mutation";
+    dependsOn: string[];
+    path: string;
+    knowledge?: string[];
+    triggers?: string[];
+}
+/**
+ * A skill discovered in a project-declared skill pack (RFC-0539).
+ * Unlike ForgeSkillEntry, pack skills are discovered at runtime by scanning
+ * the pack directory rather than being statically registered.
+ */
+export interface PackSkillEntry {
+    name: string;
+    pack: string;
+    dir: string;
+    path: string;
+    knowledge?: string[];
+}
+/**
+ * Discover skills in project-declared skill packs by scanning each pack's
+ * directory for `<prefix>-<name>/SKILL.md` entries (RFC-0539).
+ *
+ * This is the single source of truth for pack skill discovery — used by
+ * forge.create, forge.skill.validate, forge.doctor, and forge.skill.list.
+ */
+export declare function discoverPackSkills(workspaceRoot: string, config: ForgeConfig): PackSkillEntry[];
+export declare const FORGE_SKILLS: ForgeSkillEntry[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,EAAE,WAAW,GAAG,eAAe,GAAG,kBAAkB,GAAG,eAAe,CAAC;IAC/E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,EAAE,CA6C/F;AAkED,eAAO,MAAM,YAAY,EAAE,eAAe,EAAqC,CAAC"}

package/dist/src/registry.js

@@ -0,0 +1,135 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Skill registry — machine-readable array of all forge skills, used by forge.skill.validate and forge.create. Also provides discoverPackSkills helper for project-declared skill packs (RFC-0539).</purpose>
+<non-goals>
+  <item>Do not include third-party skills — only forge-managed skills belong here.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial ForgeSkillEntry interface and FORGE_SKILLS registry (17 migrated + 3 meta = 20).</item>
+  <item>Added fo-add-tests skill (11th fo skill) — absorbs tdd + PBT conventions from RFC-0347.</item>
+  <item>Skill consolidation: added fo-architecture, fo-handoff, fo-triage, fo-qa (15 fo skills). Removed handoff, improve-codebase-architecture, to-spec from shared (absorbed into fo-). Shared skills reduced to 4 (grilling, my-preferences, windows-ai-tooling, writing-great-skills).</item>
+  <item>Renamed skill prefix wg- → fo- across all skills, paths, and categories. Added fo-idea-status, fo-idea-i-just-want-to-see-the-plan, fo-idea-i-just-want-to-see-the-result (18 fo skills total).</item>
+  <item>Added fo-doc-audit skill (19th fo skill) — centralized documentation audit replacing inline AGENTS/README update steps in fo-fix and fo-idea-implement.</item>
+  <item>RFC-0395: added fo-spec-ingest skill (20th fo skill) — spec package ingest/authoring with validation, grilling, and acceptance gate.</item>
+  <item>Added fo-session-retro skill (21st fo skill) — session-end insight triage, categorizes discoveries and routes to AGENTS.md / ADR / DNA / forge / memory.</item>
+  <item>RFC-0523: expanded concerns enum from binary (document-only | implementation) to four-level taxonomy (read-only | document-only | content-mutation | code-mutation). All 30 skills reclassified.</item>
+  <item>RFC-0524: added optional knowledge?: string[] field for cumulative knowledge system. Added knowledge arrays to fo-site-scan and grilling.</item>
+  <item>RFC-0538: added fo-compass-annotate skill (22nd fo skill) — full-lifecycle Compass header management replacing removed compass.annotate, compass.clear, compass.markup.migrate, compass.invariant.add kernel commands.</item>
+  <item>RFC-0539: added discoverPackSkills helper and PackSkillEntry interface for project-declared skill packs. Removed mission-complete and fo-site-scan entries (relocated to warpgogol-skills as wg- pack skills).</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Discover skills in project-declared skill packs by scanning each pack's
+ * directory for `<prefix>-<name>/SKILL.md` entries (RFC-0539).
+ *
+ * This is the single source of truth for pack skill discovery — used by
+ * forge.create, forge.skill.validate, forge.doctor, and forge.skill.list.
+ */
+export function discoverPackSkills(workspaceRoot, config) {
+    const result = [];
+    if (!config.skillPacks)
+        return result;
+    for (const pack of config.skillPacks) {
+        const packDir = path.resolve(workspaceRoot, pack.dir);
+        if (!fs.existsSync(packDir))
+            continue;
+        const entries = fs.readdirSync(packDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (!entry.name.startsWith(`${pack.prefix}-`))
+                continue;
+            const skillMdPath = path.join(packDir, entry.name, "SKILL.md");
+            if (!fs.existsSync(skillMdPath))
+                continue;
+            const relPath = path.relative(packDir, skillMdPath).replace(/\\/g, "/");
+            const skillEntry = {
+                name: entry.name,
+                pack: pack.prefix,
+                dir: pack.dir,
+                path: relPath,
+            };
+            // Extract knowledge files from frontmatter if present
+            const content = fs.readFileSync(skillMdPath, "utf8");
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (fmMatch) {
+                try {
+                    const fm = parseYaml(fmMatch[1]);
+                    if (Array.isArray(fm["knowledge"])) {
+                        skillEntry.knowledge = fm["knowledge"].filter((v) => typeof v === "string");
+                    }
+                }
+                catch {
+                    // Frontmatter parse error — SKILL-01 will catch this in validation
+                }
+            }
+            result.push(skillEntry);
+        }
+    }
+    return result;
+}
+/**
+ * Auto-discover forge skills by scanning the skills/ directory for SKILL.md
+ * files and parsing their frontmatter. This replaces the hand-maintained
+ * FORGE_SKILLS array — the frontmatter is the single source of truth.
+ *
+ * Skills are organized as skills/{category}/{name}/SKILL.md.
+ */
+function discoverForgeSkills(skillsRoot) {
+    const result = [];
+    if (!fs.existsSync(skillsRoot))
+        return result;
+    for (const categoryDir of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
+        if (!categoryDir.isDirectory())
+            continue;
+        const category = categoryDir.name;
+        const catDirPath = path.join(skillsRoot, category);
+        for (const skillDir of fs.readdirSync(catDirPath, { withFileTypes: true })) {
+            if (!skillDir.isDirectory())
+                continue;
+            const skillMdPath = path.join(catDirPath, skillDir.name, "SKILL.md");
+            if (!fs.existsSync(skillMdPath))
+                continue;
+            const content = fs.readFileSync(skillMdPath, "utf8");
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (!fmMatch)
+                continue;
+            let fm;
+            try {
+                fm = parseYaml(fmMatch[1]);
+            }
+            catch {
+                continue;
+            }
+            const relPath = path.relative(skillsRoot, skillMdPath).replace(/\\/g, "/");
+            result.push({
+                name: fm["name"],
+                category: fm["category"],
+                invocation: fm["invocation"],
+                concerns: fm["concerns"],
+                dependsOn: Array.isArray(fm["dependsOn"])
+                    ? fm["dependsOn"].filter((v) => typeof v === "string")
+                    : [],
+                path: `skills/${relPath}`,
+                ...(Array.isArray(fm["knowledge"])
+                    ? {
+                        knowledge: fm["knowledge"].filter((v) => typeof v === "string"),
+                    }
+                    : {}),
+                ...(Array.isArray(fm["triggers"])
+                    ? {
+                        triggers: fm["triggers"].filter((v) => typeof v === "string"),
+                    }
+                    : {}),
+            });
+        }
+    }
+    return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+const SKILLS_ROOT = path.resolve(import.meta.dirname, "..", "skills");
+export const FORGE_SKILLS = discoverForgeSkills(SKILLS_ROOT);
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

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

package/dist/src/skill-schema.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const skillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    invocation: z.ZodEnum<{
+        user: "user";
+        model: "model";
+    }>;
+    category: z.ZodEnum<{
+        fo: "fo";
+        shared: "shared";
+        meta: "meta";
+    }>;
+    concerns: z.ZodEnum<{
+        "read-only": "read-only";
+        "document-only": "document-only";
+        "content-mutation": "content-mutation";
+        "code-mutation": "code-mutation";
+    }>;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    languagePolicy: z.ZodLiteral<"ref(PREFERENCES.md)">;
+    bindings: z.ZodOptional<z.ZodObject<{
+        requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        optional: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    knowledge: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type SkillFrontmatter = z.infer<typeof skillFrontmatterSchema>;
+//# sourceMappingURL=skill-schema.d.ts.map

package/dist/src/skill-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-schema.d.ts","sourceRoot":"","sources":["../../src/skill-schema.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/src/skill-schema.js

@@ -0,0 +1,34 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Define the Zod frontmatter schema used by forge skill validation commands.</purpose>
+<non-goals>
+  <item>Do not validate SKILL.md body content — that is handled by pattern matching in the validator.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial skillFrontmatterSchema with name, description, invocation, category, concerns, dependsOn, languagePolicy.</item>
+  <item>RFC-0393: added optional bindings field (requires/optional arrays of binding keys).</item>
+  <item>RFC-0523: expanded concerns enum from binary to four-level taxonomy (read-only | document-only | content-mutation | code-mutation).</item>
+  <item>RFC-0524: added optional knowledge field (array of file names relative to SKILL.md directory).</item>
+  <item>RFC-0548: added optional triggers field (array of natural-language trigger phrases, max 5 entries, each 5-100 chars) for intent-to-skill routing.</item>
+</CHANGE_SUMMARY>
+*/
+import { z } from "zod";
+export const skillFrontmatterSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().min(1).max(200),
+    invocation: z.enum(["user", "model"]),
+    category: z.enum(["fo", "shared", "meta"]),
+    concerns: z.enum(["read-only", "document-only", "content-mutation", "code-mutation"]),
+    dependsOn: z.array(z.string()).default([]),
+    languagePolicy: z.literal("ref(PREFERENCES.md)"),
+    bindings: z
+        .object({
+        requires: z.array(z.string()).default([]),
+        optional: z.array(z.string()).default([]),
+    })
+        .optional(),
+    knowledge: z.array(z.string()).optional(),
+    triggers: z.array(z.string().min(5).max(100)).max(5).optional(),
+});
+//# sourceMappingURL=skill-schema.js.map

package/dist/src/skill-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-schema.js","sourceRoot":"","sources":["../../src/skill-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;IACrF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAChD,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC1C,CAAC;SACD,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,153 @@
+export type ForgeFlagValue = boolean | string | string[];
+export interface ForgeCommandInput {
+    argv: string[];
+    args: string[];
+    flags: Record<string, ForgeFlagValue>;
+}
+export interface ForgeCommandTiming {
+    durationMs?: number;
+    startedAt?: string;
+    endedAt?: string;
+}
+export interface ForgeNextStep {
+    action: string;
+    kind: "required" | "optional";
+}
+export interface ForgeCommandResult<TData = unknown> {
+    data?: TData;
+    nextSteps?: ForgeNextStep[];
+    exitCode?: number;
+    summary?: string;
+    timing?: ForgeCommandTiming;
+}
+export interface ForgeFlagSpec {
+    kind: "boolean" | "string" | "string[]";
+    required?: boolean;
+    default?: ForgeFlagValue;
+    description: string;
+}
+export type ForgeCommandScope = "app" | "workspace";
+export interface ForgeCommandMetadata {
+    description: string;
+    scope: ForgeCommandScope;
+    mutatesState?: boolean;
+    requiresNetwork?: boolean;
+    supportsAllSites?: boolean;
+    timeoutMs?: number;
+    expectedDurationMs?: number;
+    longRunning?: boolean;
+    cacheable?: boolean;
+    /**
+     * RFC-0518: declarative gate metadata. Optional. Structurally compatible
+     * with GateMetadata from @warpgogol/site-kernel. Does NOT affect execution.
+     */
+    gate?: GateMetadata;
+}
+export type GateSeverity = "error" | "warning" | "mixed";
+export type GatePhase = "author" | "postbuild" | "workspace" | "mission" | "release";
+export interface GateConditional {
+    kind: "entitlement" | "flag" | "config";
+    ref: string;
+    description: string;
+}
+export interface GateMetadata {
+    severity: GateSeverity;
+    phase: GatePhase;
+    conditional?: GateConditional;
+    surfaces?: string[];
+    rules?: string[];
+    blocks?: string[];
+}
+export interface ForgeRegisteredCommandInfo extends ForgeCommandMetadata {
+    name: string;
+    provider: "workspace" | "site";
+    siteName?: string;
+    module?: string;
+    flags?: Record<string, ForgeFlagSpec>;
+    reads?: string[];
+    writes?: string[];
+}
+export interface ForgeCommandDefinition<TData = unknown> extends ForgeCommandMetadata {
+    name: string;
+    flags?: Record<string, ForgeFlagSpec>;
+    reads?: string[];
+    writes?: string[];
+    execute(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<void | ForgeCommandResult<TData>> | void | ForgeCommandResult<TData>;
+}
+export type DiagnosticSeverity = "error" | "warning" | "info";
+export interface DiagnosticEvidence {
+    kind: "rule" | "rendered" | "source" | "config" | "cache" | "runtime";
+    ruleFile?: string;
+    ruleId?: string;
+    file?: string;
+    url?: string;
+    snippet?: string;
+}
+export interface Diagnostic {
+    ruleId: string;
+    severity: DiagnosticSeverity;
+    message: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    fixHint?: string;
+    evidence?: DiagnosticEvidence[];
+    data?: Record<string, unknown>;
+    id?: string;
+    blockId?: string;
+    suggestion?: string;
+}
+export interface CheckResult {
+    command: string;
+    status: "pass" | "warn" | "fail";
+    diagnostics: Diagnostic[];
+    summary: {
+        error: number;
+        warning: number;
+        info: number;
+    };
+}
+export interface ForgeLogger {
+    section(message: string, details?: unknown): void;
+    info(message: string, details?: unknown): void;
+    warn(message: string, details?: unknown): void;
+    error(message: string, details?: unknown): void;
+    success(message: string, details?: unknown): void;
+}
+export interface CommandRegistry {
+    listCommandNames(): string[];
+    listCommands(): ForgeRegisteredCommandInfo[];
+    getCommand(name: string): ForgeCommandDefinition | undefined;
+}
+export type ForgeOutputFormat = "pretty" | "json";
+export interface ForgeSiteContext {
+    name: string;
+    directory: string;
+    toolsDirectory: string;
+    configPath?: string;
+    packageName?: string;
+}
+export interface ForgeRuntimeContext {
+    workspaceRoot: string;
+    logger: ForgeLogger;
+    dryRun: boolean;
+    outputFormat: ForgeOutputFormat;
+    /**
+     * Optional command registry — provided by the runner (forge CLI or site-kernel).
+     * Forge commands that need to discover other commands (e.g. rfc lifecycle validation)
+     * access this through the context instead of importing a kernel-specific function.
+     */
+    commandRegistry?: CommandRegistry;
+    /** Optional target site/app context — provided when running in app-scoped mode. */
+    site?: ForgeSiteContext;
+    /** True only when --site <name> was passed explicitly by the caller. */
+    siteExplicit?: boolean;
+    /**
+     * Optional forge root override — provided when a command is called from
+     * another command (e.g. forge.create delegates to forge.init and forge.scaffold
+     * in a new directory where resolveForgeRoot would fail). When set, handlers
+     * use this instead of calling resolveForgeRoot(workspaceRoot).
+     */
+    forgeRoot?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,17 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Canonical forge runtime types — autonomous, no @warpgogol/* dependencies.
+Structurally compatible with @warpgogol/site-kernel types so that forge modules
+can be registered in a Warpgogol kernel without direct dependency.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/site-kernel or any @warpgogol/* package.</item>
+  <item>Do not add Warpgogol-specific fields to ForgeRuntimeContext — keep it minimal and portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial canonical forge types: ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext, ForgeFlagSpec, Diagnostic, CommandRegistry, ForgeLogger.</item>
+  <item>RFC-0518: add GateMetadata, GateSeverity, GatePhase, GateConditional types and optional gate field to ForgeCommandMetadata (structurally compatible with @warpgogol/site-kernel).</item>
+</CHANGE_SUMMARY>
+*/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/dist/src/utils/fs-atomic.d.ts

@@ -0,0 +1,7 @@
+import { rename as fsRename } from "node:fs/promises";
+export interface WriteFileAtomicOptions {
+    retries?: number;
+}
+export declare function __setRenameImplForTests(impl: typeof fsRename | undefined): void;
+export declare function writeFileAtomic(filePath: string, content: string | Uint8Array, options?: WriteFileAtomicOptions): Promise<void>;
+//# sourceMappingURL=fs-atomic.d.ts.map

package/dist/src/utils/fs-atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.d.ts","sourceRoot":"","sources":["../../../src/utils/fs-atomic.ts"],"names":[],"mappings":"AAcA,OAAO,EAAa,MAAM,IAAI,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AAKzE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,QAAQ,GAAG,SAAS,GAAG,IAAI,CAE/E;AAuBD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/src/utils/fs-atomic.js

@@ -0,0 +1,81 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Atomic file-write primitive — canonical forge utility. Writes to a temp
+file then renames, with bounded retry for Windows EPERM/EBUSY.</purpose>
+<non-goals>
+  <item>Do not provide cross-process locks — convergent atomic writes are sufficient.</item>
+  <item>Do not fall back to non-atomic writes — fail loudly.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Moved from @warpgogol/site-kernel/fs-atomic to forge as canonical source (dependency inversion).</item>
+</CHANGE_SUMMARY>
+*/
+import { writeFile, rename as fsRename, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join, basename } from "node:path";
+import { randomBytes } from "node:crypto";
+let renameImpl = fsRename;
+export function __setRenameImplForTests(impl) {
+    renameImpl = impl ?? fsRename;
+}
+const DEFAULT_RETRIES = 10;
+const RETRY_BACKOFF_MS = 50;
+const RETRYABLE_CODES = new Set(["EPERM", "EBUSY"]);
+function isRetryableError(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    const code = error.code;
+    return typeof code === "string" && RETRYABLE_CODES.has(code);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function makeTempPath(filePath) {
+    const dir = dirname(filePath);
+    const name = basename(filePath);
+    const random = randomBytes(6).toString("hex");
+    return join(dir, `${name}.${random}.tmp`);
+}
+export async function writeFileAtomic(filePath, content, options) {
+    const retries = options?.retries ?? DEFAULT_RETRIES;
+    const tempPath = makeTempPath(filePath);
+    let tempWritten = false;
+    try {
+        await writeFile(tempPath, content);
+        tempWritten = true;
+        let attempt = 0;
+        for (;;) {
+            try {
+                await renameImpl(tempPath, filePath);
+                return;
+            }
+            catch (error) {
+                if (attempt >= retries || !isRetryableError(error)) {
+                    throw error;
+                }
+                attempt += 1;
+                if (existsSync(filePath)) {
+                    try {
+                        await unlink(filePath);
+                    }
+                    catch {
+                        // If unlink also fails, the retry loop will try again.
+                    }
+                }
+                await sleep(RETRY_BACKOFF_MS * attempt);
+            }
+        }
+    }
+    finally {
+        if (tempWritten) {
+            try {
+                await unlink(tempPath);
+            }
+            catch {
+                // Expected in the success path (temp file already renamed away).
+            }
+        }
+    }
+}
+//# sourceMappingURL=fs-atomic.js.map

package/dist/src/utils/fs-atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-atomic.js","sourceRoot":"","sources":["../../../src/utils/fs-atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAEF,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM1C,IAAI,UAAU,GAAoB,QAAQ,CAAC;AAE3C,MAAM,UAAU,uBAAuB,CAAC,IAAiC;IACvE,UAAU,GAAG,IAAI,IAAI,QAAQ,CAAC;AAChC,CAAC;AAED,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpD,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,MAAM,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAA4B,EAC5B,OAAgC;IAEhC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,eAAe,CAAC;IACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnC,WAAW,GAAG,IAAI,CAAC;QAEnB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,SAAS,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO,IAAI,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnD,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,OAAO,IAAI,CAAC,CAAC;gBACb,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACzB,CAAC;oBAAC,MAAM,CAAC;wBACP,uDAAuD;oBACzD,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,CAAC,gBAAgB,GAAG,OAAO,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/utils/fs-idempotent.d.ts

@@ -0,0 +1,2 @@
+export declare function writeFileIfChanged(filePath: string, content: string): Promise<"written" | "unchanged">;
+//# sourceMappingURL=fs-idempotent.d.ts.map

package/dist/src/utils/fs-idempotent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-idempotent.d.ts","sourceRoot":"","sources":["../../../src/utils/fs-idempotent.ts"],"names":[],"mappings":"AAkBA,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,CAWlC"}

package/dist/src/utils/fs-idempotent.js

@@ -0,0 +1,30 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Idempotent file-write primitive — canonical forge utility. Writes only
+when file content differs, delegating to writeFileAtomic for the actual write.
+Reduces unnecessary disk writes and git churn in Compass and Werkstatt commands.</purpose>
+<non-goals>
+  <item>Do not provide cross-process locks — convergent atomic writes are sufficient.</item>
+  <item>Do not fall back to non-atomic writes — fail loudly.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0556: moved from @warpgogol/site-kernel/fs-idempotent to forge as canonical source (dependency inversion).</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import { writeFileAtomic } from "./fs-atomic.js";
+export async function writeFileIfChanged(filePath, content) {
+    try {
+        const existing = await readFile(filePath, "utf8");
+        if (existing === content) {
+            return "unchanged";
+        }
+    }
+    catch {
+        // File does not exist — proceed to write.
+    }
+    await writeFileAtomic(filePath, content);
+    return "written";
+}
+//# sourceMappingURL=fs-idempotent.js.map

package/dist/src/utils/fs-idempotent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-idempotent.js","sourceRoot":"","sources":["../../../src/utils/fs-idempotent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/utils/fs.d.ts

@@ -0,0 +1,8 @@
+export interface CollectFilesOptions {
+    extensions?: string[];
+    ignore?: (name: string) => boolean;
+    withDirs?: boolean;
+}
+export declare function collectFiles(root: string, options?: CollectFilesOptions): Promise<string[]>;
+export declare function fileExists(path: string): Promise<boolean>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/src/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/utils/fs.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CAmCnB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D"}