@warpgogol/forge 2.1.0 → 2.2.0

package/dist/src/profiles/stack-profile.d.ts

@@ -0,0 +1,168 @@
+import { z } from "zod";
+import { type StackProfileDomainFields } from "./profile-schema.ts";
+export declare const stackProfileSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"forge/stack-profile@1">;
+    id: z.ZodString;
+    displayName: z.ZodString;
+    detect: z.ZodObject<{
+        anyOf: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    workspace: z.ZodObject<{
+        dirs: z.ZodArray<z.ZodString>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    install: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    firstWorkspace: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>;
+        install: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    domain: z.ZodOptional<z.ZodString>;
+    terminology: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        extensions: z.ZodArray<z.ZodString>;
+        produce: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        validate: z.ZodOptional<z.ZodObject<{
+            command: z.ZodString;
+            outputFormat: z.ZodOptional<z.ZodEnum<{
+                json: "json";
+                plain: "plain";
+            }>>;
+            violationPattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        determinism: z.ZodOptional<z.ZodObject<{
+            hashable: z.ZodBoolean;
+            inputs: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    workspaceTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        detect: z.ZodObject<{
+            glob: z.ZodOptional<z.ZodString>;
+            contains: z.ZodOptional<z.ZodString>;
+            packageJsonDep: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        agentsMdTemplate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    invariants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rule: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        check: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                "filename-pattern": "filename-pattern";
+                "file-contains": "file-contains";
+                "file-not-contains": "file-not-contains";
+                "attribute-pattern": "attribute-pattern";
+                "link-resolution": "link-resolution";
+                "frontmatter-required": "frontmatter-required";
+                "path-exclusion": "path-exclusion";
+                "gitignore-entry": "gitignore-entry";
+                "secret-scan": "secret-scan";
+            }>;
+            glob: z.ZodOptional<z.ZodString>;
+            pattern: z.ZodOptional<z.ZodString>;
+            negatedPattern: z.ZodOptional<z.ZodString>;
+            elements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            attribute: z.ZodOptional<z.ZodString>;
+            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    register: z.ZodOptional<z.ZodEnum<{
+        business: "business";
+        creative: "creative";
+    }>>;
+    devServer: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        port: z.ZodOptional<z.ZodNumber>;
+        readinessTimeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    assets: z.ZodOptional<z.ZodObject<{
+        dir: z.ZodString;
+        types: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            extensions: z.ZodArray<z.ZodString>;
+            referencePattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    release: z.ZodOptional<z.ZodObject<{
+        target: z.ZodEnum<{
+            local: "local";
+            r2: "r2";
+            s3: "s3";
+        }>;
+        outputDir: z.ZodString;
+        manifestName: z.ZodDefault<z.ZodString>;
+        includeArtifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        r2: z.ZodOptional<z.ZodObject<{
+            bucket: z.ZodString;
+            accountId: z.ZodString;
+            prefix: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    prerequisites: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        check: z.ZodString;
+        installHint: z.ZodOptional<z.ZodString>;
+        severity: z.ZodDefault<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>>;
+    }, z.core.$strip>>>;
+    templates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        default: z.ZodOptional<z.ZodBoolean>;
+        firstWorkspace: z.ZodObject<{
+            path: z.ZodString;
+            files: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                content: z.ZodString;
+            }, z.core.$strip>>;
+            install: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    scriptDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface ProfileFile {
+    path: string;
+    content: string;
+}
+export interface StackProfile extends StackProfileDomainFields {
+    schema: "forge/stack-profile@1";
+    id: string;
+    displayName: string;
+    detect: {
+        anyOf: string[];
+    };
+    workspace: {
+        dirs: string[];
+        files: ProfileFile[];
+    };
+    install: string[];
+    firstWorkspace?: {
+        path: string;
+        files: ProfileFile[];
+        install: string[];
+    };
+    prerequisites?: import("./profile-schema.ts").ProfilePrerequisite[];
+    templates?: import("./profile-schema.ts").ProfileTemplate[];
+}
+export declare function loadStackProfile(profilePath: string): StackProfile;
+export declare function listStackProfiles(forgeRoot: string): StackProfile[];
+export declare function detectStack(projectRoot: string, profiles: StackProfile[]): StackProfile | null;
+//# sourceMappingURL=stack-profile.d.ts.map

package/dist/src/profiles/stack-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-profile.d.ts","sourceRoot":"","sources":["../../../src/profiles/stack-profile.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAkC,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAMpG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgD7B,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,wBAAwB;IAC5D,MAAM,EAAE,uBAAuB,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5B,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,EAAE,WAAW,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,mBAAmB,EAAE,CAAC;IACpE,SAAS,CAAC,EAAE,OAAO,qBAAqB,EAAE,eAAe,EAAE,CAAC;CAC7D;AAMD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAkBlE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAiBnE;AAMD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,GAAG,IAAI,CAO9F"}

package/dist/src/profiles/stack-profile.js

@@ -0,0 +1,144 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Stack profile schema, loader, and detector. Defines what a supported stack looks like and how to detect it in an existing project.</purpose>
+<non-goals>
+  <item>Do not scaffold projects — that is scaffold-project.ts.</item>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0392: initial stack profile module with zod schema, listStackProfiles, detectStack.</item>
+  <item>RFC-0638: extended stackProfileSchema with optional domain-neutral fields (domain, terminology, artifacts, workspaceTypes, invariants, register).</item>
+  <item>RFC-0674: add devServer field to stackProfileSchema for lifecycle commands.</item>
+  <item>RFC-0679: add assets field to stackProfileSchema for asset management commands.</item>
+  <item>RFC-0680: add release field to stackProfileSchema for release lifecycle commands.</item>
+  <item>ADR-0043: add scriptDir field for agent-generated script directory convention.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { parse as parseYaml } from "yaml";
+import { stackProfileDomainFieldsSchema } from "./profile-schema.js";
+// ---------------------------------------------------------------------------
+// Schema (forge/stack-profile@1)
+// ---------------------------------------------------------------------------
+export const stackProfileSchema = z.object({
+    schema: z.literal("forge/stack-profile@1"),
+    id: z.string().min(1),
+    displayName: z.string().min(1),
+    detect: z.object({
+        anyOf: z.array(z.string()).min(1),
+    }),
+    workspace: z.object({
+        dirs: z.array(z.string()).min(1),
+        files: z.array(z.object({
+            path: z.string().min(1),
+            content: z.string(),
+        })),
+    }),
+    install: z.array(z.string()).default([]),
+    firstWorkspace: z
+        .object({
+        path: z.string().min(1),
+        files: z.array(z.object({
+            path: z.string().min(1),
+            content: z.string(),
+        })),
+        install: z.array(z.string()).default([]),
+    })
+        .optional(),
+    // RFC-0638: Domain-neutral optional fields
+    domain: stackProfileDomainFieldsSchema.shape.domain,
+    terminology: stackProfileDomainFieldsSchema.shape.terminology,
+    artifacts: stackProfileDomainFieldsSchema.shape.artifacts,
+    workspaceTypes: stackProfileDomainFieldsSchema.shape.workspaceTypes,
+    invariants: stackProfileDomainFieldsSchema.shape.invariants,
+    register: stackProfileDomainFieldsSchema.shape.register,
+    // RFC-0674: Dev server declaration for lifecycle commands
+    devServer: stackProfileDomainFieldsSchema.shape.devServer,
+    // RFC-0679: Asset management declaration
+    assets: stackProfileDomainFieldsSchema.shape.assets,
+    // RFC-0680: Release lifecycle declaration
+    release: stackProfileDomainFieldsSchema.shape.release,
+    // Prerequisites: system-level dependency checks (e.g. FFmpeg)
+    prerequisites: stackProfileDomainFieldsSchema.shape.prerequisites,
+    // Templates: multi-template profiles (e.g. React + HTML)
+    templates: stackProfileDomainFieldsSchema.shape.templates,
+    // ADR-0043: Agent-generated script directory override
+    scriptDir: stackProfileDomainFieldsSchema.shape.scriptDir,
+});
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+export function loadStackProfile(profilePath) {
+    const raw = fs.readFileSync(profilePath, "utf8");
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`Stack profile at ${profilePath} is not valid YAML: ${err.message}`);
+    }
+    const result = stackProfileSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Stack profile at ${profilePath} failed schema validation:\n${issues}`);
+    }
+    return result.data;
+}
+export function listStackProfiles(forgeRoot) {
+    const profilesDir = path.join(forgeRoot, "profiles");
+    if (!fs.existsSync(profilesDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(profilesDir);
+    const profiles = [];
+    for (const entry of entries) {
+        if (entry.endsWith(".yaml") && !entry.startsWith(".")) {
+            const profilePath = path.join(profilesDir, entry);
+            profiles.push(loadStackProfile(profilePath));
+        }
+    }
+    return profiles;
+}
+// ---------------------------------------------------------------------------
+// Detector
+// ---------------------------------------------------------------------------
+export function detectStack(projectRoot, profiles) {
+    for (const profile of profiles) {
+        if (matchesAnyOf(projectRoot, profile.detect.anyOf)) {
+            return profile;
+        }
+    }
+    return null;
+}
+function matchesAnyOf(projectRoot, patterns) {
+    for (const pattern of patterns) {
+        if (globExists(projectRoot, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+function globExists(dir, pattern) {
+    // Simple glob: support * and *.ext patterns at the root level
+    if (!pattern.includes("*")) {
+        return fs.existsSync(path.join(dir, pattern));
+    }
+    try {
+        const entries = fs.readdirSync(dir);
+        const regex = globToRegex(pattern);
+        return entries.some((e) => regex.test(e));
+    }
+    catch {
+        return false;
+    }
+}
+function globToRegex(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    return new RegExp(`^${escaped}$`);
+}
+//# sourceMappingURL=stack-profile.js.map

package/dist/src/profiles/stack-profile.js.map

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

package/dist/src/profiles/terminology-utils.d.ts

@@ -0,0 +1,8 @@
+import { type ForgeConfig } from "../config/forge-config.ts";
+import type { StackProfile } from "./stack-profile.ts";
+/**
+ * Resolve all terminology keys (universal + profile-specific) from config and profile.
+ * Used by both root AGENTS.md generation and nested AGENTS.md generation.
+ */
+export declare function resolveAllTerminology(config: ForgeConfig, profile: StackProfile | undefined): Record<string, string>;
+//# sourceMappingURL=terminology-utils.d.ts.map

package/dist/src/profiles/terminology-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminology-utils.d.ts","sourceRoot":"","sources":["../../../src/profiles/terminology-utils.ts"],"names":[],"mappings":"AAcA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GAAG,SAAS,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB"}

package/dist/src/profiles/terminology-utils.js

@@ -0,0 +1,31 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Shared terminology resolution utility (RFC-0643). Resolves all terminology keys
+from config + profile, used by both root and nested AGENTS.md generation.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0643: extracted resolveAllTerminology from agents-generate.ts and nested-agents-generate.ts to eliminate duplication.</item>
+</CHANGE_SUMMARY>
+*/
+import { UNIVERSAL_TERMINOLOGY_KEYS } from "./profile-schema.js";
+import { resolveTerminology } from "../config/forge-config.js";
+/**
+ * Resolve all terminology keys (universal + profile-specific) from config and profile.
+ * Used by both root AGENTS.md generation and nested AGENTS.md generation.
+ */
+export function resolveAllTerminology(config, profile) {
+    const terminology = {};
+    for (const key of UNIVERSAL_TERMINOLOGY_KEYS) {
+        terminology[key] = resolveTerminology(config, profile?.terminology, key);
+    }
+    if (profile?.terminology) {
+        for (const key of Object.keys(profile.terminology)) {
+            terminology[key] = resolveTerminology(config, profile.terminology, key);
+        }
+    }
+    return terminology;
+}
+//# sourceMappingURL=terminology-utils.js.map

package/dist/src/profiles/terminology-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminology-utils.js","sourceRoot":"","sources":["../../../src/profiles/terminology-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,2BAA2B,CAAC;AAGjF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmB,EACnB,OAAiC;IAEjC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAC7C,WAAW,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,WAAW,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

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"}