@warpgogol/forge 2.1.0 → 2.2.0

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

@@ -0,0 +1,78 @@
+/*
+<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).
+// RFC-0776: @warpgogol/site-kernel replaced by @warpgogol/werkstatt/kernel.
+// @warpgogol/werkstatt/kernel remains forbidden for src/ portability.
+const FORBIDDEN_IMPORTS = [
+    "@warpgogol/werkstatt/kernel",
+    "@warpgogol/werkstatt-site/ui",
+    "@warpgogol/werkstatt-shared/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":"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"}

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

@@ -0,0 +1,29 @@
+interface Violation {
+    skill: string;
+    rule: string;
+    message: string;
+    pack?: string;
+    file?: string;
+    line?: number;
+    severity?: "error" | "warning";
+    fixHint?: string;
+}
+interface Warning {
+    skill: string;
+    rule: string;
+    message: string;
+    severity: "warning";
+    pack?: string;
+    file?: string;
+    layer?: string;
+    fixHint?: string;
+}
+interface SkillValidateResult {
+    command: string;
+    status: "pass" | "fail";
+    violations: Violation[];
+    warnings: Warning[];
+}
+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":"AAoCA,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAyavF"}