@warpgogol/forge 2.9.11 → 2.9.13

package/dist/os/core/handlers/package-health.d.ts

@@ -1,17 +0,0 @@
-import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
-export interface PackageHealthViolation {
-    ruleId: string;
-    packageName: string;
-    severity: "error" | "warning";
-    message: string;
-    file?: string;
-    fixHint?: string;
-}
-export interface PackageHealthResult {
-    command: "forge.package.health";
-    packagesChecked: number;
-    violations: PackageHealthViolation[];
-    passed: boolean;
-}
-export declare function runPackageHealth(_input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<PackageHealthResult>>;
-//# sourceMappingURL=package-health.d.ts.map

package/dist/os/core/handlers/package-health.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-health.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/package-health.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,sBAAsB,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;CACjB;AAiCD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAmKlD"}

package/dist/os/core/handlers/package-health.js

@@ -1,196 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>forge.package.health — validate all published packages (private: false) for standalone extraction readiness. Checks engines.node, embedded CI workflow, extract.config.yaml, and devDependencies completeness (no hoisted tool deps).</purpose>
-<non-goals>
-  <item>Do not import from @warpgogol/* — this module is portable.</item>
-  <item>Do not modify files — read-only validation.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Initial: forge.package.health validator — engines, CI workflow, extract config, devDeps completeness.</item>
-</CHANGE_SUMMARY>
-*/
-import fs from "node:fs";
-import path from "node:path";
-const KNOWN_SCRIPT_TOOLS = {
-    eslint: "eslint",
-    prettier: "prettier",
-    vitest: "vitest",
-    tsc: "typescript",
-    tsx: "tsx",
-    turbo: "turbo",
-    biome: "@biomejs/biome",
-};
-function extractToolNames(scripts) {
-    const tools = new Set();
-    for (const scriptValue of Object.values(scripts)) {
-        for (const [toolName, depName] of Object.entries(KNOWN_SCRIPT_TOOLS)) {
-            if (scriptValue.includes(toolName) || scriptValue.includes(`pnpm exec ${toolName}`)) {
-                tools.add(depName);
-            }
-        }
-    }
-    return tools;
-}
-function readJsonFile(filePath) {
-    try {
-        const raw = fs.readFileSync(filePath, "utf8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-export async function runPackageHealth(_input, context) {
-    const { workspaceRoot, logger } = context;
-    const packagesDir = path.join(workspaceRoot, "packages");
-    if (!fs.existsSync(packagesDir)) {
-        return {
-            data: {
-                command: "forge.package.health",
-                packagesChecked: 0,
-                violations: [],
-                passed: true,
-            },
-            exitCode: 0,
-            summary: "No packages/ directory found — nothing to check.",
-        };
-    }
-    const rootPkg = readJsonFile(path.join(workspaceRoot, "package.json"));
-    const rootEngines = rootPkg?.["engines"];
-    const rootNodeRange = rootEngines?.["node"];
-    const violations = [];
-    let packagesChecked = 0;
-    const entries = fs.readdirSync(packagesDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        if (entry.name.startsWith("."))
-            continue;
-        const pkgDir = path.join(packagesDir, entry.name);
-        const pkgJsonPath = path.join(pkgDir, "package.json");
-        const pkg = readJsonFile(pkgJsonPath);
-        if (!pkg)
-            continue;
-        const isPrivate = pkg["private"] === true;
-        if (isPrivate)
-            continue;
-        packagesChecked++;
-        const packageName = String(pkg["name"] ?? entry.name);
-        // CHECK 1: engines.node exists and matches root
-        const pkgEngines = pkg["engines"];
-        const pkgNodeRange = pkgEngines?.["node"];
-        if (!pkgNodeRange) {
-            violations.push({
-                ruleId: "PKG-HEALTH-01",
-                packageName,
-                severity: "error",
-                message: `Missing engines.node in package.json. Root requires "${rootNodeRange ?? ">=24 <25"}".`,
-                file: pkgJsonPath,
-                fixHint: `Add "engines": { "node": "${rootNodeRange ?? ">=24 <25"}" } to package.json.`,
-            });
-        }
-        else if (rootNodeRange && pkgNodeRange !== rootNodeRange) {
-            violations.push({
-                ruleId: "PKG-HEALTH-01",
-                packageName,
-                severity: "warning",
-                message: `engines.node is "${pkgNodeRange}" but root is "${rootNodeRange}".`,
-                file: pkgJsonPath,
-                fixHint: `Align engines.node with root: "${rootNodeRange}".`,
-            });
-        }
-        // CHECK 2: .github/workflows/ci.yml exists inside package
-        const ciWorkflowPath = path.join(pkgDir, ".github", "workflows", "ci.yml");
-        if (!fs.existsSync(ciWorkflowPath)) {
-            violations.push({
-                ruleId: "PKG-HEALTH-02",
-                packageName,
-                severity: "error",
-                message: "Missing .github/workflows/ci.yml — standalone extraction repo will have no CI.",
-                file: pkgDir,
-                fixHint: "Create .github/workflows/ci.yml inside the package directory with Node 24 setup.",
-            });
-        }
-        // CHECK 3: extract.config.yaml exists
-        const extractConfigPath = path.join(pkgDir, "extract.config.yaml");
-        if (!fs.existsSync(extractConfigPath)) {
-            violations.push({
-                ruleId: "PKG-HEALTH-03",
-                packageName,
-                severity: "warning",
-                message: "Missing extract.config.yaml — package cannot be extracted via repo-extract.",
-                file: pkgDir,
-                fixHint: "Create extract.config.yaml with git remote and extraction settings.",
-            });
-        }
-        // CHECK 4: devDependencies completeness — tools used in scripts must be declared
-        const scripts = (pkg["scripts"] ?? {});
-        const devDeps = (pkg["devDependencies"] ?? {});
-        const deps = (pkg["dependencies"] ?? {});
-        const allDeclared = { ...devDeps, ...deps };
-        const usedTools = extractToolNames(scripts);
-        for (const toolDep of usedTools) {
-            if (!(toolDep in allDeclared)) {
-                violations.push({
-                    ruleId: "PKG-HEALTH-04",
-                    packageName,
-                    severity: "error",
-                    message: `Script uses "${toolDep}" but it is not in devDependencies or dependencies. It relies on monorepo hoisting and will fail standalone.`,
-                    file: pkgJsonPath,
-                    fixHint: `Add "${toolDep}" to devDependencies in package.json.`,
-                });
-            }
-        }
-    }
-    const errors = violations.filter((v) => v.severity === "error");
-    const warnings = violations.filter((v) => v.severity === "warning");
-    const passed = errors.length === 0;
-    if (context.outputFormat === "pretty") {
-        if (packagesChecked === 0) {
-            logger.info("forge.package.health: no published packages found.");
-        }
-        else {
-            for (const v of violations) {
-                if (v.severity === "error") {
-                    logger.error(`  [${v.ruleId}] ${v.packageName}: ${v.message}`);
-                }
-                else {
-                    logger.warn(`  [${v.ruleId}] ${v.packageName}: ${v.message}`);
-                }
-            }
-            if (passed && warnings.length === 0) {
-                logger.success(`forge.package.health: all ${packagesChecked} published package(s) healthy.`);
-            }
-            else if (passed) {
-                logger.warn(`forge.package.health: ${packagesChecked} package(s) checked, ${warnings.length} warning${warnings.length === 1 ? "" : "s"}.`);
-            }
-            else {
-                const parts = [];
-                parts.push(`${errors.length} error${errors.length === 1 ? "" : "s"}`);
-                if (warnings.length > 0)
-                    parts.push(`${warnings.length} warning${warnings.length === 1 ? "" : "s"}`);
-                logger.error(`forge.package.health: ${parts.join(", ")} across ${packagesChecked} package(s).`);
-            }
-        }
-    }
-    return {
-        data: {
-            command: "forge.package.health",
-            packagesChecked,
-            violations,
-            passed,
-        },
-        exitCode: passed ? 0 : 1,
-        summary: passed
-            ? warnings.length > 0
-                ? `All ${packagesChecked} package(s) passed with ${warnings.length} warning${warnings.length === 1 ? "" : "s"}.`
-                : `All ${packagesChecked} package(s) healthy.`
-            : `${errors.length} error${errors.length === 1 ? "" : "s"} found across ${packagesChecked} package(s).`,
-        nextSteps: errors.map((e) => ({
-            action: e.fixHint ?? e.message,
-            kind: "required",
-        })),
-    };
-}
-//# sourceMappingURL=package-health.js.map

package/dist/os/core/handlers/package-health.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-health.js","sourceRoot":"","sources":["../../../../os/core/handlers/package-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAuB7B,MAAM,kBAAkB,GAA2B;IACjD,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF,SAAS,gBAAgB,CAAC,OAA+B;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrE,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,aAAa,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACpF,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAyB,EACzB,OAA4B;IAE5B,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,sBAAsB;gBAC/B,eAAe,EAAE,CAAC;gBAClB,UAAU,EAAE,EAAE;gBACd,MAAM,EAAE,IAAI;aACb;YACD,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,kDAAkD;SAC5D,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC,SAAS,CAAuC,CAAC;IAC/E,MAAM,aAAa,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,UAAU,GAA6B,EAAE,CAAC;IAChD,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAEzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;QAC1C,IAAI,SAAS;YAAE,SAAS;QAExB,eAAe,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QAEtD,gDAAgD;QAChD,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,CAAuC,CAAC;QACxE,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,eAAe;gBACvB,WAAW;gBACX,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,wDAAwD,aAAa,IAAI,UAAU,IAAI;gBAChG,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,6BAA6B,aAAa,IAAI,UAAU,sBAAsB;aACxF,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,aAAa,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;YAC3D,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,eAAe;gBACvB,WAAW;gBACX,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,oBAAoB,YAAY,kBAAkB,aAAa,IAAI;gBAC5E,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,kCAAkC,aAAa,IAAI;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,0DAA0D;QAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,eAAe;gBACvB,WAAW;gBACX,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,gFAAgF;gBACzF,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,kFAAkF;aAC5F,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtC,UAAU,CAAC,IAAI,CAAC;gBACd,MAAM,EAAE,eAAe;gBACvB,WAAW;gBACX,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,6EAA6E;gBACtF,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,qEAAqE;aAC/E,CAAC,CAAC;QACL,CAAC;QAED,iFAAiF;QACjF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAA2B,CAAC;QACjE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAA2B,CAAC;QACzE,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAA2B,CAAC;QACnE,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;QAE5C,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC;gBAC9B,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,eAAe;oBACvB,WAAW;oBACX,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,gBAAgB,OAAO,8GAA8G;oBAC9I,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,QAAQ,OAAO,uCAAuC;iBAChE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAEnC,IAAI,OAAO,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;oBAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YACD,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,OAAO,CACZ,6BAA6B,eAAe,gCAAgC,CAC7E,CAAC;YACJ,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CACT,yBAAyB,eAAe,wBAAwB,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAC9H,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBACtE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBACrB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC9E,MAAM,CAAC,KAAK,CACV,yBAAyB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,eAAe,cAAc,CAClF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,sBAAsB;YAC/B,eAAe;YACf,UAAU;YACV,MAAM;SACP;QACD,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE,MAAM;YACb,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACnB,CAAC,CAAC,OAAO,eAAe,2BAA2B,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;gBAChH,CAAC,CAAC,OAAO,eAAe,sBAAsB;YAChD,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,iBAAiB,eAAe,cAAc;QACzG,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO;YAC9B,IAAI,EAAE,UAAmB;SAC1B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/os/core/handlers/pinned-check.d.ts

@@ -1,49 +0,0 @@
-import type { PinnedEntry, PinnedManifest, PinnedViolation } from "./pinned-types.ts";
-/**
- * Path to the pinned manifest relative to the repository root.
- */
-export declare const PINNED_MANIFEST_PATH: string;
-/**
- * Error thrown when the manifest exists but is malformed (invalid YAML or missing required fields).
- */
-export declare class PinnedManifestMalformedError extends Error {
-    constructor(message: string);
-}
-/**
- * Load and parse the pinned manifest from .forge/pinned.yaml.
- * Returns null if the file does not exist (protection is opt-in).
- * Throws PinnedManifestMalformedError if the file exists but is not valid YAML
- * or does not contain a `pinned` array.
- */
-export declare function loadPinnedManifest(repoRoot: string): Promise<PinnedManifest | null>;
-/**
- * Check if a relative file path matches a pinned entry.
- *
- * Path matching rules:
- * - Exact match: if the entry path equals the file path, it matches.
- * - Directory match: if the entry path ends with `/`, it matches any file
- *   that starts with the directory prefix (recursive).
- *
- * Returns the matching PinnedEntry or null if no match.
- */
-export declare function isPinned(manifest: PinnedManifest, relPath: string): PinnedEntry | null;
-/**
- * Check if a move from sourceRel to destRel stays within the same pinned directory.
- * This exempts intra-directory moves (e.g. rfc.archive moves
- * docs/rfcs/rfc-0076.md → docs/rfcs/archive/implemented/rfc-0076.md)
- * from the pinned pre-check, since the file hasn't left the protected directory.
- *
- * Only applies to directory-pinned entries (path ends with `/`).
- * Returns true if the same pinned directory entry matches both source and dest.
- */
-export declare function isIntraDirMove(manifest: PinnedManifest, sourceRel: string, destRel: string): boolean;
-/**
- * Batch-check multiple file paths against the manifest.
- * Returns violations for files that match a pinned entry.
- * The operation type is determined by the caller (delete, move, or modify).
- */
-export declare function checkFilesForPinned(manifest: PinnedManifest, files: Array<{
-    relPath: string;
-    operation: PinnedViolation["operation"];
-}>): PinnedViolation[];
-//# sourceMappingURL=pinned-check.d.ts.map

package/dist/os/core/handlers/pinned-check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pinned-check.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/pinned-check.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAc,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKlG;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAqC,CAAC;AAEvE;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkEzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgBtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAiBT;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC,GACzE,eAAe,EAAE,CAgBnB"}

package/dist/os/core/handlers/pinned-check.js

@@ -1,159 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Shared pre-check utility for the forge pinned-files protection system (RFC-0733).
-Loads the pinned manifest from .forge/pinned.yaml and provides an isPinned lookup
-that all archive handlers call before moving files. Manifest loading is cached
-per invocation — loadPinnedManifest is called once and the result is reused.</purpose>
-<non-goals>
-  <item>Does not implement validation logic (git diff parsing, violation detection) — use pinned-validate.ts.</item>
-  <item>Does not implement manifest creation — use pinned-init.ts.</item>
-  <item>Does not enforce overrides or audit logging — that is pinned-validate.ts responsibility.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0733: initial pinned-check utility — loadPinnedManifest, isPinned, checkFilesForPinned.</item>
-  <item>Gap fix: add isIntraDirMove to exempt moves within the same pinned directory (e.g. rfc.archive moves docs/rfcs/x.md → docs/rfcs/archive/implemented/x.md).</item>
-</CHANGE_SUMMARY>
-*/
-import fs from "node:fs/promises";
-import path from "node:path";
-import { parse as parseYaml } from "yaml";
-const PINNED_DIR = ".forge";
-const PINNED_FILE = "pinned.yaml";
-/**
- * Path to the pinned manifest relative to the repository root.
- */
-export const PINNED_MANIFEST_PATH = path.join(PINNED_DIR, PINNED_FILE);
-/**
- * Error thrown when the manifest exists but is malformed (invalid YAML or missing required fields).
- */
-export class PinnedManifestMalformedError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "PinnedManifestMalformedError";
-    }
-}
-/**
- * Load and parse the pinned manifest from .forge/pinned.yaml.
- * Returns null if the file does not exist (protection is opt-in).
- * Throws PinnedManifestMalformedError if the file exists but is not valid YAML
- * or does not contain a `pinned` array.
- */
-export async function loadPinnedManifest(repoRoot) {
-    const manifestPath = path.join(repoRoot, PINNED_MANIFEST_PATH);
-    let content;
-    try {
-        content = await fs.readFile(manifestPath, "utf8");
-    }
-    catch {
-        return null;
-    }
-    let parsed;
-    try {
-        parsed = parseYaml(content);
-    }
-    catch (err) {
-        throw new PinnedManifestMalformedError(`pinned.yaml is not valid YAML: ${String(err.message)}`);
-    }
-    if (!parsed || typeof parsed !== "object") {
-        throw new PinnedManifestMalformedError("pinned.yaml must contain a top-level object with a `pinned` array");
-    }
-    const obj = parsed;
-    if (!Array.isArray(obj["pinned"])) {
-        throw new PinnedManifestMalformedError("pinned.yaml is missing required `pinned` array field");
-    }
-    const entries = [];
-    for (const raw of obj["pinned"]) {
-        if (!raw || typeof raw !== "object") {
-            throw new PinnedManifestMalformedError("pinned.yaml: each entry must be an object with path, mode, and reason");
-        }
-        const entry = raw;
-        const entryPath = entry["path"];
-        const entryMode = entry["mode"];
-        const entryReason = entry["reason"];
-        if (typeof entryPath !== "string" || !entryPath) {
-            throw new PinnedManifestMalformedError("pinned.yaml: each entry must have a non-empty `path` string");
-        }
-        if (entryMode !== "protect" && entryMode !== "freeze") {
-            throw new PinnedManifestMalformedError(`pinned.yaml: entry "${entryPath}" has invalid mode "${String(entryMode)}" — must be "protect" or "freeze"`);
-        }
-        if (typeof entryReason !== "string" || !entryReason) {
-            throw new PinnedManifestMalformedError(`pinned.yaml: entry "${entryPath}" must have a non-empty reason string`);
-        }
-        entries.push({
-            path: entryPath,
-            mode: entryMode,
-            reason: entryReason,
-        });
-    }
-    return { pinned: entries };
-}
-/**
- * Check if a relative file path matches a pinned entry.
- *
- * Path matching rules:
- * - Exact match: if the entry path equals the file path, it matches.
- * - Directory match: if the entry path ends with `/`, it matches any file
- *   that starts with the directory prefix (recursive).
- *
- * Returns the matching PinnedEntry or null if no match.
- */
-export function isPinned(manifest, relPath) {
-    const normalizedRelPath = relPath.replace(/\\/g, "/");
-    for (const entry of manifest.pinned) {
-        const normalizedEntryPath = entry.path.replace(/\\/g, "/");
-        if (normalizedEntryPath.endsWith("/")) {
-            if (normalizedRelPath.startsWith(normalizedEntryPath)) {
-                return entry;
-            }
-        }
-        else if (normalizedRelPath === normalizedEntryPath) {
-            return entry;
-        }
-    }
-    return null;
-}
-/**
- * Check if a move from sourceRel to destRel stays within the same pinned directory.
- * This exempts intra-directory moves (e.g. rfc.archive moves
- * docs/rfcs/rfc-0076.md → docs/rfcs/archive/implemented/rfc-0076.md)
- * from the pinned pre-check, since the file hasn't left the protected directory.
- *
- * Only applies to directory-pinned entries (path ends with `/`).
- * Returns true if the same pinned directory entry matches both source and dest.
- */
-export function isIntraDirMove(manifest, sourceRel, destRel) {
-    const normalizedSource = sourceRel.replace(/\\/g, "/");
-    const normalizedDest = destRel.replace(/\\/g, "/");
-    for (const entry of manifest.pinned) {
-        const normalizedEntryPath = entry.path.replace(/\\/g, "/");
-        if (normalizedEntryPath.endsWith("/")) {
-            if (normalizedSource.startsWith(normalizedEntryPath) &&
-                normalizedDest.startsWith(normalizedEntryPath)) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
-/**
- * Batch-check multiple file paths against the manifest.
- * Returns violations for files that match a pinned entry.
- * The operation type is determined by the caller (delete, move, or modify).
- */
-export function checkFilesForPinned(manifest, files) {
-    const violations = [];
-    for (const { relPath, operation } of files) {
-        const entry = isPinned(manifest, relPath);
-        if (entry) {
-            violations.push({
-                path: relPath,
-                mode: entry.mode,
-                operation,
-                reason: entry.reason,
-            });
-        }
-    }
-    return violations;
-}
-//# sourceMappingURL=pinned-check.js.map

package/dist/os/core/handlers/pinned-check.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pinned-check.js","sourceRoot":"","sources":["../../../../os/core/handlers/pinned-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;EAgBE;AAEF,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAE/D,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,4BAA4B,CACpC,kCAAkC,MAAM,CAAE,GAAa,CAAC,OAAO,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,4BAA4B,CACpC,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,4BAA4B,CAAC,sDAAsD,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,4BAA4B,CACpC,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,GAA8B,CAAC;QAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEpC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,4BAA4B,CACpC,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,4BAA4B,CACpC,uBAAuB,SAAS,uBAAuB,MAAM,CAAC,SAAS,CAAC,mCAAmC,CAC5G,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD,MAAM,IAAI,4BAA4B,CACpC,uBAAuB,SAAS,uCAAuC,CACxE,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAuB;YAC7B,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAwB,EAAE,OAAe;IAChE,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE3D,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,IAAI,iBAAiB,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACtD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;aAAM,IAAI,iBAAiB,KAAK,mBAAmB,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAwB,EACxB,SAAiB,EACjB,OAAe;IAEf,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEnD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3D,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,IACE,gBAAgB,CAAC,UAAU,CAAC,mBAAmB,CAAC;gBAChD,cAAc,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAC9C,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB,EACxB,KAA0E;IAE1E,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,KAAK,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,KAAK,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,SAAS;gBACT,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/os/core/handlers/pinned-init.d.ts

@@ -1,19 +0,0 @@
-import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
-import type { PinnedEntry } from "./pinned-types.ts";
-/**
- * Default pinned entries for a forge-consuming repository.
- * These are re-added by pinned.init if missing from an existing manifest.
- */
-export declare const DEFAULT_PINNED_ENTRIES: PinnedEntry[];
-export interface PinnedInitResult {
-    command: "pinned.init";
-    status: "ok";
-    manifestPath: string;
-    manifestAction: "created" | "merged" | "unchanged";
-    entriesCount: number;
-    hookAction: "created" | "updated" | "unchanged";
-    gitignoreAction: "created" | "updated" | "unchanged";
-    ciWorkflowAction: "created" | "unchanged" | "skipped";
-}
-export declare function runPinnedInit(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<PinnedInitResult>>;
-//# sourceMappingURL=pinned-init.d.ts.map

package/dist/os/core/handlers/pinned-init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pinned-init.d.ts","sourceRoot":"","sources":["../../../../os/core/handlers/pinned-init.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAKrE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,EAgG/C,CAAC;AAmHF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAChD,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IACrD,gBAAgB,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;CACvD;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAyE/C"}