@warpgogol/forge 0.3.1

package/dist/src/utils/fs.js

@@ -0,0 +1,60 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Trivial filesystem utilities — inlined from @warpgogol/share to avoid dependency.</purpose>
+<non-goals>
+  <item>Do not add non-filesystem utilities here — use dedicated utility modules.</item>
+  <item>Do not introduce @warpgogol/* imports — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial inline of collectFiles, fileExists from @warpgogol/share/fs.</item>
+</CHANGE_SUMMARY>
+*/
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+function defaultIgnore(name) {
+    return name.startsWith("-") || name.startsWith("old-");
+}
+export async function collectFiles(root, options = {}) {
+    const { extensions, ignore = defaultIgnore, withDirs = false } = options;
+    const results = [];
+    // fs.walk.lint: allow — this is the canonical collectFiles implementation,
+    // inlined from @warpgogol/share/fs to keep @warpgogol/forge dependency-free (RFC-0303).
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (ignore(entry.name))
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (withDirs)
+                    results.push(full);
+                await walk(full);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (extensions && !extensions.some((ext) => entry.name.endsWith(ext)))
+                continue;
+            results.push(full);
+        }
+    }
+    await walk(root);
+    return results;
+}
+export async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,UAA+B,EAAE;IAEjC,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACzE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,wFAAwF;IACxF,KAAK,UAAU,IAAI,CAAC,GAAW;QAC7B,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,QAAQ;oBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS;YAE9B,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAAE,SAAS;YAEhF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/utils/generated-marker.d.ts

@@ -0,0 +1,21 @@
+export declare const GENERATED_MARKER = "GENERATED. Do not change this line unless the file contains project specific changes.";
+export declare function hasGeneratedMarker(content: string): boolean;
+export interface StripGeneratedMarkerResult {
+    changed: boolean;
+    content: string;
+}
+export declare function stripGeneratedMarker(content: string): StripGeneratedMarkerResult;
+export interface GeneratedHeaderInput {
+    filePath: string;
+    ownerCommand: string;
+    templatePath?: string;
+    site?: string;
+    /**
+     * Command prefix for the regenerate hint. Defaults to "forge" (autonomous mode).
+     * Site-kernel callers pass "pnpm exec site-kernel run" for Warpgogol context.
+     */
+    commandPrefix?: string;
+}
+export declare function buildGeneratedHeader(input: GeneratedHeaderInput): string;
+export declare function isGeneratedMarkerTextCandidate(filePath: string): boolean;
+//# sourceMappingURL=generated-marker.d.ts.map

package/dist/src/utils/generated-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-marker.d.ts","sourceRoot":"","sources":["../../../src/utils/generated-marker.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,gBAAgB,0FAC4D,CAAC;AAE1F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,CAmDhF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAsBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA4BxE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiBxE"}

package/dist/src/utils/generated-marker.js

@@ -0,0 +1,128 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Canonical GENERATED_MARKER constant and advisory header builder for
+generated-file governance. Moved from @warpgogol/site-kernel to forge as canonical
+source (dependency inversion).</purpose>
+<non-goals>
+  <item>Do not perform file I/O — operates on in-memory content strings only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Moved from @warpgogol/site-kernel/generated-marker to forge as canonical source.</item>
+  <item>Added optional commandPrefix to GeneratedHeaderInput — defaults to "forge" for autonomous mode; site-kernel passes "pnpm exec site-kernel run".</item>
+</CHANGE_SUMMARY>
+*/
+export const GENERATED_MARKER = "GENERATED. Do not change this line unless the file contains project specific changes.";
+export function hasGeneratedMarker(content) {
+    return content.includes(GENERATED_MARKER);
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+const DO_NOT_EDIT_LINE = "DO NOT EDIT THIS FILE. Changes are overwritten on the next build.";
+export function stripGeneratedMarker(content) {
+    const raw = GENERATED_MARKER;
+    let result = content;
+    let changed = false;
+    const applyAll = (patterns) => {
+        for (const pattern of patterns) {
+            const next = result.replace(pattern, "");
+            if (next !== result) {
+                changed = true;
+                result = next;
+            }
+        }
+    };
+    applyAll([
+        new RegExp(`<!--[ \\t]*\\n[\\s\\S]*?${escapeRegex(raw)}[\\s\\S]*?-->\\n?`, "g"),
+        new RegExp(`/\\*[ \\t]*\\n[\\s\\S]*?${escapeRegex(raw)}[\\s\\S]*?\\*/\\n?`, "g"),
+    ]);
+    for (const token of ["//", "#"]) {
+        const t = escapeRegex(token);
+        const advisoryLine = (suffix) => `(?:[ \\t]*${t}[ \\t]*${suffix}\\n)?`;
+        const pattern = new RegExp(`^[ \\t]*${t}[ \\t]*${escapeRegex(raw)}\\n` +
+            advisoryLine(escapeRegex(DO_NOT_EDIT_LINE)) +
+            advisoryLine("Owner command:.*") +
+            advisoryLine("Edit instead:.*") +
+            advisoryLine("Regenerate:.*"), "gm");
+        applyAll([pattern]);
+    }
+    applyAll([
+        new RegExp(`^\\s*<!--\\s*${escapeRegex(raw)}\\s*-->\\n?`, "gm"),
+        new RegExp(`^\\s*//\\s*${escapeRegex(raw)}\\n?`, "gm"),
+        new RegExp(`^\\s*/\\*\\s*${escapeRegex(raw)}\\s*\\*/\\n?`, "gm"),
+        new RegExp(`^\\s*#\\s*${escapeRegex(raw)}\\n?`, "gm"),
+        new RegExp(`^\\s*${escapeRegex(raw)}\\n?`, "gm"),
+    ]);
+    if (result.includes(raw)) {
+        const next = result.split(raw).join("");
+        if (next !== result) {
+            changed = true;
+            result = next;
+        }
+    }
+    return { changed, content: result };
+}
+function commentStyleForPath(filePath) {
+    const lower = filePath.toLowerCase().replace(/\\/g, "/");
+    const base = lower.slice(lower.lastIndexOf("/") + 1);
+    if (base === ".gitattributes" ||
+        base === "_headers" ||
+        base === "_redirects" ||
+        base.endsWith(".txt") ||
+        base.endsWith(".yml") ||
+        base.endsWith(".yaml")) {
+        return "line-hash";
+    }
+    if (base.endsWith(".md"))
+        return "block-html";
+    if (base.endsWith(".css"))
+        return "block-css";
+    return "line-slash";
+}
+export function buildGeneratedHeader(input) {
+    const style = commentStyleForPath(input.filePath);
+    const prefix = input.commandPrefix ?? "forge";
+    const regenerateCommand = input.site
+        ? `${prefix} ${input.ownerCommand} --site ${input.site}`
+        : `${prefix} ${input.ownerCommand}`;
+    const editInstead = input.templatePath
+        ? `Edit instead: ${input.templatePath}`
+        : `Edit instead: the ${input.ownerCommand} generator source (not this file).`;
+    const lines = [
+        GENERATED_MARKER,
+        DO_NOT_EDIT_LINE,
+        `Owner command: ${input.ownerCommand}`,
+        editInstead,
+        `Regenerate:   ${regenerateCommand}`,
+    ];
+    switch (style) {
+        case "line-slash":
+            return `${lines.map((line) => `// ${line}`).join("\n")}\n`;
+        case "line-hash":
+            return `${lines.map((line) => `# ${line}`).join("\n")}\n`;
+        case "block-css":
+            return `/*\n${lines.map((line) => `  ${line}`).join("\n")}\n*/\n`;
+        case "block-html":
+            return `<!--\n${lines.map((line) => `  ${line}`).join("\n")}\n-->\n`;
+    }
+}
+export function isGeneratedMarkerTextCandidate(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf(".")).toLowerCase();
+    const TEXT_EXTS = new Set([
+        ".txt",
+        ".xml",
+        ".md",
+        ".yml",
+        ".yaml",
+        ".css",
+        ".js",
+        ".mjs",
+        ".ts",
+        ".json",
+        ".html",
+        ".astro",
+    ]);
+    return TEXT_EXTS.has(ext);
+}
+//# sourceMappingURL=generated-marker.js.map

package/dist/src/utils/generated-marker.js.map

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

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

@@ -0,0 +1,2 @@
+export declare function byteHash(bytes: Uint8Array | string): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAeA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAG3D"}

package/dist/src/utils/hash.js

@@ -0,0 +1,18 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Trivial hash utility — inlined from @warpgogol/fingerprint to avoid dependency.</purpose>
+<non-goals>
+  <item>Do not add non-hash utilities here — use dedicated utility modules.</item>
+  <item>Do not introduce @warpgogol/* imports — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial inline of byteHash from @warpgogol/fingerprint/primitives.</item>
+</CHANGE_SUMMARY>
+*/
+import { createHash } from "node:crypto";
+export function byteHash(bytes) {
+    const input = typeof bytes === "string" ? Buffer.from(bytes, "utf8") : bytes;
+    return `sha256:${createHash("sha256").update(input).digest("hex")}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/src/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,KAA0B;IACjD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7E,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC"}

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

@@ -0,0 +1,7 @@
+export { writeFileAtomic, type WriteFileAtomicOptions } from "./fs-atomic.ts";
+export { writeFileIfChanged } from "./fs-idempotent.ts";
+export { GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, type GeneratedHeaderInput, type StripGeneratedMarkerResult, } from "./generated-marker.ts";
+export { toKebabCase } from "./string-utils.ts";
+export { collectFiles, fileExists, type CollectFilesOptions } from "./fs.ts";
+export { byteHash } from "./hash.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for forge utilities — canonical, autonomous, no @warpgogol/* dependencies.</purpose>
+<non-goals>
+  <item>Do not add non-utility exports here — use the appropriate forge module.</item>
+  <item>Do not re-export from @warpgogol/* packages — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial utility barrel: fs-atomic, generated-marker, string-utils, fs, hash.</item>
+</CHANGE_SUMMARY>
+*/
+export { writeFileAtomic } from "./fs-atomic.js";
+export { writeFileIfChanged } from "./fs-idempotent.js";
+export { GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, } from "./generated-marker.js";
+export { toKebabCase } from "./string-utils.js";
+export { collectFiles, fileExists } from "./fs.js";
+export { byteHash } from "./hash.js";
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/src/utils/string-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function toKebabCase(value: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/src/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/string-utils.ts"],"names":[],"mappings":"AAaA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/src/utils/string-utils.js

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Trivial string utilities — inlined from @warpgogol/share to avoid dependency.</purpose>
+<non-goals>
+  <item>Do not add non-string utilities here — use dedicated utility modules.</item>
+  <item>Do not introduce @warpgogol/* imports — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial inline of toKebabCase from @warpgogol/share/string-utils.</item>
+</CHANGE_SUMMARY>
+*/
+export function toKebabCase(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/src/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/src/validators/port-validate.d.ts

@@ -0,0 +1,12 @@
+interface PortValidateResult {
+    command: string;
+    status: "pass" | "fail";
+    violations: string[];
+}
+export declare function runPortValidate(input: {
+    flags: {
+        name?: string;
+    };
+}, context: unknown): PortValidateResult;
+export {};
+//# sourceMappingURL=port-validate.d.ts.map

package/dist/src/validators/port-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-validate.d.ts","sourceRoot":"","sources":["../../../src/validators/port-validate.ts"],"names":[],"mappings":"AAgBA,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAOD,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACnC,OAAO,EAAE,OAAO,GACf,kBAAkB,CA0CpB"}

package/dist/src/validators/port-validate.js

@@ -0,0 +1,73 @@
+/*
+<MODULE_CONTRACT>
+<purpose>forge.port.validate — validates that a ported skill or command complies with forge contracts (frontmatter, registry, no project-specific dependencies).</purpose>
+<non-goals>
+  <item>Do not validate all skills — only the named skill or command.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial forge.port.validate handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { FORGE_SKILLS } from "../registry.js";
+// RFC-0556: removed @warpgogol/site-kernel-checks and @warpgogol/site-kernel-handoff
+// from this list — os/compass and os/werkstatt no longer import them (handlers inlined).
+// @warpgogol/site-kernel remains forbidden for src/ portability.
+const FORBIDDEN_IMPORTS = ["@warpgogol/site-kernel", "@warpgogol/ui", "@warpgogol/share/page"];
+export function runPortValidate(input, context) {
+    const ctx = context;
+    const workspaceRoot = ctx?.workspaceRoot ?? process.cwd();
+    const forgeRoot = path.join(workspaceRoot, "packages", "forge");
+    const name = input.flags?.name;
+    if (!name) {
+        return {
+            command: "forge.port.validate",
+            status: "fail",
+            violations: ["--name flag is required"],
+        };
+    }
+    const violations = [];
+    // Check if skill exists in registry
+    const skillEntry = FORGE_SKILLS.find((s) => s.name === name);
+    if (!skillEntry) {
+        violations.push(`Skill "${name}" not found in forge registry`);
+    }
+    // Check for forbidden imports in TypeScript files under the skill/command directory
+    const skillDir = path.join(forgeRoot, "skills");
+    const searchDirs = [
+        path.join(skillDir, "fo", name),
+        path.join(skillDir, "shared", name),
+        path.join(skillDir, "meta", name),
+        path.join(forgeRoot, "os"),
+    ];
+    for (const dir of searchDirs) {
+        if (fs.existsSync(dir)) {
+            scanForForbiddenImports(dir, FORBIDDEN_IMPORTS, violations);
+        }
+    }
+    return {
+        command: "forge.port.validate",
+        status: violations.length === 0 ? "pass" : "fail",
+        violations,
+    };
+}
+function scanForForbiddenImports(dir, forbidden, violations) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            scanForForbiddenImports(fullPath, forbidden, violations);
+        }
+        else if (entry.name.endsWith(".ts") || entry.name.endsWith(".mjs")) {
+            const content = fs.readFileSync(fullPath, "utf8");
+            for (const imp of forbidden) {
+                if (content.includes(imp)) {
+                    violations.push(`Forbidden import "${imp}" found in ${path.relative(process.cwd(), fullPath)}`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=port-validate.js.map

package/dist/src/validators/port-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-validate.js","sourceRoot":"","sources":["../../../src/validators/port-validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,qFAAqF;AACrF,yFAAyF;AACzF,iEAAiE;AACjE,MAAM,iBAAiB,GAAG,CAAC,wBAAwB,EAAE,eAAe,EAAE,uBAAuB,CAAC,CAAC;AAE/F,MAAM,UAAU,eAAe,CAC7B,KAAmC,EACnC,OAAgB;IAEhB,MAAM,GAAG,GAAG,OAAqC,CAAC;IAClD,MAAM,aAAa,GAAG,GAAG,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,qBAAqB;YAC9B,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,CAAC,yBAAyB,CAAC;SACxC,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,oCAAoC;IACpC,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACjE,CAAC;IAED,oFAAoF;IACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;KAC3B,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,qBAAqB;QAC9B,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACjD,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAW,EAAE,SAAmB,EAAE,UAAoB;IACrF,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACrE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1B,UAAU,CAAC,IAAI,CACb,qBAAqB,GAAG,cAAc,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,CAC/E,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/validators/skill-validate.d.ts

@@ -0,0 +1,14 @@
+interface Violation {
+    skill: string;
+    rule: string;
+    message: string;
+    pack?: string;
+}
+interface SkillValidateResult {
+    command: string;
+    status: "pass" | "fail";
+    violations: Violation[];
+}
+export declare function runSkillValidate(_input: unknown, context: unknown): SkillValidateResult;
+export {};
+//# sourceMappingURL=skill-validate.d.ts.map

package/dist/src/validators/skill-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-validate.d.ts","sourceRoot":"","sources":["../../../src/validators/skill-validate.ts"],"names":[],"mappings":"AAyBA,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,mBAAmB,CA4XvF"}