@warpgogol/forge 1.2.2 → 2.1.0

package/dist/os/plan/handlers/archive.js

@@ -1,206 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-Plan archive handler — moves plan files whose parent RFC has terminal status
-into status-specific subdirectories under docs/plans/archive/ and moves
-non-terminal files found in subdirectories back to the root.
-</purpose>
-<non-goals>
-  <item>Does not validate plan content.</item>
-  <item>Does not change plan frontmatter — only moves files on disk.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0521: implement plan.archive command.</item>
-  <item>RFC-0733: add pinned-files pre-check — skip pinned files with warning instead of moving them.</item>
-</CHANGE_SUMMARY>
-*/
-import fs from "node:fs/promises";
-import path from "node:path";
-import { listPlanFiles, extractRfcIdFromPlanFile } from "../frontmatter-io.js";
-import { loadRfcStatusMap } from "../../rfc/frontmatter-io.js";
-import { PLAN_DIR } from "../types.js";
-import { loadPinnedManifest, isPinned, isIntraDirMove } from "../../core/handlers/pinned-check.js";
-const TERMINAL_STATUSES = ["implemented", "rejected", "superseded"];
-export async function runPlanArchive(input, context) {
-    const { workspaceRoot, logger, outputFormat } = context;
-    const planDirPath = path.join(workspaceRoot, PLAN_DIR);
-    const rfcDirPath = path.join(workspaceRoot, "docs", "rfcs");
-    const dryRun = context.dryRun || input.flags["dry-run"] === true;
-    const statusFilter = input.flags["status"];
-    if (statusFilter && !TERMINAL_STATUSES.includes(statusFilter)) {
-        throw new Error(`Invalid --status "${statusFilter}". Must be one of: ${TERMINAL_STATUSES.join(", ")}`);
-    }
-    const files = await listPlanFiles(planDirPath);
-    const rfcStatusMap = await loadRfcStatusMap(rfcDirPath);
-    const moved = [];
-    const skipped = [];
-    // RFC-0733: Load pinned manifest once per invocation
-    let pinnedManifest = null;
-    try {
-        pinnedManifest = await loadPinnedManifest(workspaceRoot);
-    }
-    catch {
-        // Malformed manifest — skip pre-check
-    }
-    for (const fileName of files) {
-        const rfcId = extractRfcIdFromPlanFile(fileName);
-        const relFile = path.join(PLAN_DIR, fileName);
-        const basename = path.basename(fileName);
-        if (!rfcId) {
-            skipped.push({ id: "UNKNOWN", file: relFile, reason: "no RFC id in filename" });
-            continue;
-        }
-        const rfcStatus = rfcStatusMap.get(rfcId);
-        if (!rfcStatus) {
-            skipped.push({ id: rfcId, file: relFile, reason: "parent RFC not found" });
-            continue;
-        }
-        const isTerminal = rfcStatus === "implemented" || rfcStatus === "rejected" || rfcStatus === "superseded";
-        const isInArchive = fileName.includes("/");
-        if (statusFilter && rfcStatus !== statusFilter) {
-            skipped.push({
-                id: rfcId,
-                file: relFile,
-                reason: `parent RFC status ${rfcStatus} does not match --status ${statusFilter}`,
-            });
-            continue;
-        }
-        if (isTerminal && !isInArchive) {
-            const targetDir = path.join(planDirPath, "archive", rfcStatus);
-            const targetPath = path.join(targetDir, basename);
-            const targetRel = path.join(PLAN_DIR, "archive", rfcStatus, basename);
-            // RFC-0733: Check if file is pinned before moving
-            // Gap fix: exempt intra-directory moves (file stays within the same pinned dir)
-            if (pinnedManifest &&
-                isPinned(pinnedManifest, relFile) &&
-                !isIntraDirMove(pinnedManifest, relFile, targetRel)) {
-                skipped.push({
-                    id: rfcId,
-                    file: relFile,
-                    reason: "pinned (protected by .forge/pinned.yaml)",
-                });
-                if (outputFormat === "pretty") {
-                    logger.warn(`  pinned: skipping ${relFile} (protected)`);
-                }
-                continue;
-            }
-            try {
-                await fs.access(targetPath);
-                skipped.push({ id: rfcId, file: relFile, reason: "destination exists" });
-                continue;
-            }
-            catch {
-                // destination doesn't exist — proceed
-            }
-            if (!dryRun) {
-                await fs.mkdir(targetDir, { recursive: true });
-                try {
-                    await fs.rename(path.join(planDirPath, fileName), targetPath);
-                }
-                catch (err) {
-                    if (err.code === "ENOENT") {
-                        skipped.push({ id: rfcId, file: relFile, reason: "already moved by another process" });
-                        continue;
-                    }
-                    throw err;
-                }
-            }
-            moved.push({
-                id: rfcId,
-                file: targetRel,
-                status: rfcStatus,
-                from: relFile,
-                to: targetRel,
-                direction: "into-archive",
-            });
-        }
-        else if (!isTerminal && isInArchive) {
-            const targetPath = path.join(planDirPath, basename);
-            const targetRel = path.join(PLAN_DIR, basename);
-            // RFC-0733: Check if file is pinned before moving
-            // Gap fix: exempt intra-directory moves (file stays within the same pinned dir)
-            if (pinnedManifest &&
-                isPinned(pinnedManifest, relFile) &&
-                !isIntraDirMove(pinnedManifest, relFile, targetRel)) {
-                skipped.push({
-                    id: rfcId,
-                    file: relFile,
-                    reason: "pinned (protected by .forge/pinned.yaml)",
-                });
-                if (outputFormat === "pretty") {
-                    logger.warn(`  pinned: skipping ${relFile} (protected)`);
-                }
-                continue;
-            }
-            try {
-                await fs.access(targetPath);
-                skipped.push({ id: rfcId, file: relFile, reason: "destination exists" });
-                continue;
-            }
-            catch {
-                // destination doesn't exist — proceed
-            }
-            if (!dryRun) {
-                try {
-                    await fs.rename(path.join(planDirPath, fileName), targetPath);
-                }
-                catch (err) {
-                    if (err.code === "ENOENT") {
-                        skipped.push({ id: rfcId, file: relFile, reason: "already moved by another process" });
-                        continue;
-                    }
-                    throw err;
-                }
-            }
-            moved.push({
-                id: rfcId,
-                file: targetRel,
-                status: rfcStatus,
-                from: relFile,
-                to: targetRel,
-                direction: "out-of-archive",
-            });
-        }
-        else if (isTerminal && isInArchive) {
-            skipped.push({ id: rfcId, file: relFile, reason: `already archived (${rfcStatus})` });
-        }
-        else {
-            skipped.push({
-                id: rfcId,
-                file: relFile,
-                reason: `parent RFC status ${rfcStatus} is non-terminal`,
-            });
-        }
-    }
-    if (outputFormat === "pretty") {
-        if (dryRun) {
-            logger.info(`[dry-run] plan.archive: would move ${moved.length} file(s), skip ${skipped.length}`);
-        }
-        else {
-            logger.success(`plan.archive: moved ${moved.length} file(s), skipped ${skipped.length}`);
-        }
-        for (const m of moved) {
-            logger.info(`  ${m.direction}: ${m.id} (${m.status}) ${m.from} → ${m.to}`);
-        }
-    }
-    return {
-        data: {
-            command: "plan.archive",
-            status: "ok",
-            moved,
-            skipped,
-            dryRun,
-        },
-        summary: dryRun
-            ? `[dry-run] Would move ${moved.length} file(s), skip ${skipped.length}`
-            : `Moved ${moved.length} file(s), skipped ${skipped.length}`,
-        nextSteps: [
-            {
-                action: "Run: pnpm exec werkstatt run plan.list --json to verify archive status",
-                kind: "optional",
-            },
-        ],
-    };
-}
-//# sourceMappingURL=archive.js.map

package/dist/os/plan/handlers/archive.js.map

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

package/dist/os/plan/index.d.ts

@@ -1,6 +0,0 @@
-export { forgePlanModule } from "./plan.module.ts";
-export { runPlanArchive } from "./handlers/archive.ts";
-export { listPlanFiles, parsePlanFile, readAndParsePlan, extractRfcIdFromPlanFile, type ParsedPlan, } from "./frontmatter-io.ts";
-export type { PlanArchiveResult, PlanArchiveMove, PlanArchiveSkip } from "./types.ts";
-export { PLAN_DIR, PLAN_FILE_PATTERN } from "./types.ts";
-//# sourceMappingURL=index.d.ts.map

package/dist/os/plan/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/plan/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/plan/index.js

@@ -1,16 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Barrel export for the plan domain — types, module, and handlers.</purpose>
-<non-goals>
-  <item>Do not implement plan logic here; delegate to handlers/ and plan.module.ts.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0521: initial plan module barrel.</item>
-</CHANGE_SUMMARY>
-*/
-export { forgePlanModule } from "./plan.module.js";
-export { runPlanArchive } from "./handlers/archive.js";
-export { listPlanFiles, parsePlanFile, readAndParsePlan, extractRfcIdFromPlanFile, } from "./frontmatter-io.js";
-export { PLAN_DIR, PLAN_FILE_PATTERN } from "./types.js";
-//# sourceMappingURL=index.js.map

package/dist/os/plan/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/plan/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,wBAAwB,GAEzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/plan/plan.module.d.ts

@@ -1,3 +0,0 @@
-import type { ForgeModule } from "../../src/forge-module.ts";
-export declare const forgePlanModule: ForgeModule;
-//# sourceMappingURL=plan.module.d.ts.map

package/dist/os/plan/plan.module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan.module.d.ts","sourceRoot":"","sources":["../../../os/plan/plan.module.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,eAAe,EAAE,WAiC7B,CAAC"}

package/dist/os/plan/plan.module.js

@@ -1,44 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Register the plan archive command with the forge kernel registry.</purpose>
-<non-goals>
-  <item>Do not implement handler logic here — delegate to handlers/archive.ts.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0521: initial forgePlanModule registering plan.archive command.</item>
-</CHANGE_SUMMARY>
-*/
-export const forgePlanModule = {
-    name: "forge-plan",
-    version: "0.1.0",
-    async register(registry) {
-        const { runPlanArchive } = await import("./handlers/archive.js");
-        registry.registerCommand({
-            name: "plan.archive",
-            description: "Move plan files whose parent RFC has terminal status " +
-                "(implemented, rejected, superseded) into docs/plans/archive/<status>/ " +
-                "subdirectories. Bidirectional: moves non-terminal files found in " +
-                "subdirectories back to root. Use --dry-run to preview. " +
-                "Use --status to filter to a single terminal status. " +
-                "Prefer the docs.archive umbrella command unless you need to archive only plans.",
-            scope: "workspace",
-            mutatesState: true,
-            writes: ["docs/plans/*.md", "docs/plans/archive/**"],
-            reads: ["docs/plans/**/*.md", "docs/rfcs/**/*.md"],
-            cacheable: false,
-            flags: {
-                "dry-run": {
-                    kind: "boolean",
-                    description: "Preview what would be moved without touching the filesystem.",
-                },
-                status: {
-                    kind: "string",
-                    description: "Filter to a single terminal status (implemented, rejected, superseded).",
-                },
-            },
-            execute: runPlanArchive,
-        });
-    },
-};
-//# sourceMappingURL=plan.module.js.map

package/dist/os/plan/plan.module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan.module.js","sourceRoot":"","sources":["../../../os/plan/plan.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAIF,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;IAChB,KAAK,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAEjE,QAAQ,CAAC,eAAe,CAAC;YACvB,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,uDAAuD;gBACvD,wEAAwE;gBACxE,mEAAmE;gBACnE,yDAAyD;gBACzD,sDAAsD;gBACtD,iFAAiF;YACnF,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;YACpD,KAAK,EAAE,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;YAClD,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE;gBACL,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yEAAyE;iBACvF;aACF;YACD,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/os/plan/types.d.ts

@@ -1,12 +0,0 @@
-import type { ArchiveMove, ArchiveSkip } from "../rfc/handlers/archive.ts";
-export declare const PLAN_DIR = "docs/plans";
-export declare const PLAN_FILE_PATTERN: RegExp;
-export interface PlanArchiveResult {
-    command: "plan.archive";
-    status: "ok";
-    moved: ArchiveMove[];
-    skipped: ArchiveSkip[];
-    dryRun: boolean;
-}
-export type { ArchiveMove as PlanArchiveMove, ArchiveSkip as PlanArchiveSkip };
-//# sourceMappingURL=types.d.ts.map

package/dist/os/plan/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../os/plan/types.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3E,eAAO,MAAM,QAAQ,eAAe,CAAC;AACrC,eAAO,MAAM,iBAAiB,QAAqB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,YAAY,EAAE,WAAW,IAAI,eAAe,EAAE,WAAW,IAAI,eAAe,EAAE,CAAC"}

package/dist/os/plan/types.js

@@ -1,17 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-Type definitions for the plan archive domain — plan file discovery, parsing,
-and archive result shapes.
-</purpose>
-<non-goals>
-  <item>Do not define archive handler logic here — that lives in handlers/archive.ts.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0521: initial plan archive types.</item>
-</CHANGE_SUMMARY>
-*/
-export const PLAN_DIR = "docs/plans";
-export const PLAN_FILE_PATTERN = /^plan-rfc-\d{4}-/;
-//# sourceMappingURL=types.js.map

package/dist/os/plan/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/plan/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAIF,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC"}

package/dist/os/program/discovery.d.ts

@@ -1,61 +0,0 @@
-import { type ProgramManifest, type ProgramPacket, type ProgramPacketIndexEntry } from "./schemas.ts";
-export interface ProgramLocation {
-    programDir: string;
-    manifestPath: string;
-    manifest: ProgramManifest;
-}
-/**
- * Discover a program by RFC id. Scans docs/plans/ for a program.yaml whose
- * `program` field matches the given RFC id.
- */
-export declare function discoverProgram(workspaceRoot: string, programRfc: string): ProgramLocation | null;
-/**
- * Parse a packet .md file: extract YAML frontmatter and validate against
- * the forge/program-packet@1 schema.
- */
-export declare function parsePacketFile(packetPath: string): ProgramPacket;
-/**
- * Find a packet by packetId within a program.
- */
-export declare function findPacketEntry(manifest: ProgramManifest, packetId: string): ProgramPacketIndexEntry | null;
-/**
- * Resolve the full path to a packet file.
- */
-export declare function resolvePacketPath(programDir: string, entry: ProgramPacketIndexEntry): string;
-/**
- * Compute SHA-256 hex digest of a file's bytes.
- */
-export declare function fileSha256(filePath: string): string;
-/**
- * Verify normative source hashes for a packet. Returns violations.
- */
-export declare function verifyNormativeSources(workspaceRoot: string, packet: ProgramPacket): Array<{
-    path: string;
-    expected: string;
-    actual: string;
-}>;
-export declare function gitHead(workspaceRoot: string): string;
-export declare function gitBranch(workspaceRoot: string): string;
-export declare function gitIsClean(workspaceRoot: string): boolean;
-export declare function gitAncestorOf(workspaceRoot: string, ancestor: string, descendant: string): boolean;
-export declare function gitChangedFilesBetween(workspaceRoot: string, base: string, head: string): string[];
-/**
- * Normalize a path to forward slashes for cross-platform comparison.
- */
-export declare function normalizePath(p: string): string;
-/**
- * Check if a path matches a glob pattern. Supports:
- * - `**` for recursive directory matching
- * - `*` for single-level wildcard
- * - exact prefix matching with trailing `/**`
- */
-export declare function pathMatchesGlob(filePath: string, pattern: string): boolean;
-/**
- * Check if a file path is within the allowed files list.
- */
-export declare function isPathAllowed(filePath: string, allowedFiles: string[]): boolean;
-/**
- * Check if a file path matches any forbidden pattern.
- */
-export declare function isPathForbidden(filePath: string, forbiddenFiles: string[]): boolean;
-//# sourceMappingURL=discovery.d.ts.map

package/dist/os/program/discovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../os/program/discovery.ts"],"names":[],"mappings":"AAoBA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAMtB,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA4BjG;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAgBjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,uBAAuB,GAAG,IAAI,CAEhC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAE5F;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,aAAa,GACpB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB3D;AAMD,wBAAgB,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAWT;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAWV;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAqB1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAG/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAGnF"}

package/dist/os/program/discovery.js

@@ -1,236 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Discovery and parsing for program manifests and packet files.
-Reads YAML frontmatter from program.yaml and packet .md files, validates
-against schemas, and computes normative source hashes.</purpose>
-<non-goals>
-  <item>Do not import from @warpgogol/* — forge must remain dependency-free.</item>
-  <item>Do not mutate files — discovery is read-only.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0856: initial program/packet discovery and parsing.</item>
-</CHANGE_SUMMARY>
-*/
-import fs from "node:fs";
-import path from "node:path";
-import { createHash } from "node:crypto";
-import { execSync } from "node:child_process";
-import { parse as parseYaml } from "yaml";
-import { programManifestSchema, programPacketSchema, } from "./schemas.js";
-/**
- * Discover a program by RFC id. Scans docs/plans/ for a program.yaml whose
- * `program` field matches the given RFC id.
- */
-export function discoverProgram(workspaceRoot, programRfc) {
-    const plansDir = path.join(workspaceRoot, "docs", "plans");
-    if (!fs.existsSync(plansDir))
-        return null;
-    for (const entry of fs.readdirSync(plansDir, { withFileTypes: true })) {
-        if (!entry.isDirectory())
-            continue;
-        const manifestPath = path.join(plansDir, entry.name, "program.yaml");
-        if (!fs.existsSync(manifestPath))
-            continue;
-        const raw = fs.readFileSync(manifestPath, "utf8");
-        const parsed = parseYaml(raw);
-        if (parsed.program !== programRfc)
-            continue;
-        const result = programManifestSchema.safeParse(parsed);
-        if (!result.success) {
-            throw new Error(`PROGRAM-PACKET-01: malformed program manifest at ${manifestPath}: ${result.error.message}`);
-        }
-        return {
-            programDir: path.join(plansDir, entry.name),
-            manifestPath,
-            manifest: result.data,
-        };
-    }
-    return null;
-}
-// ---------------------------------------------------------------------------
-// Packet parsing
-// ---------------------------------------------------------------------------
-/**
- * Parse a packet .md file: extract YAML frontmatter and validate against
- * the forge/program-packet@1 schema.
- */
-export function parsePacketFile(packetPath) {
-    const raw = fs.readFileSync(packetPath, "utf8");
-    const match = raw.match(/^---\n([\s\S]*?)\n---/);
-    if (!match) {
-        throw new Error(`PROGRAM-PACKET-01: missing frontmatter in ${packetPath}`);
-    }
-    const fm = parseYaml(match[1]);
-    const result = programPacketSchema.safeParse(fm);
-    if (!result.success) {
-        throw new Error(`PROGRAM-PACKET-01: malformed packet at ${packetPath}: ${result.error.message}`);
-    }
-    return result.data;
-}
-/**
- * Find a packet by packetId within a program.
- */
-export function findPacketEntry(manifest, packetId) {
-    return manifest.packets.find((p) => p.packetId === packetId) ?? null;
-}
-/**
- * Resolve the full path to a packet file.
- */
-export function resolvePacketPath(programDir, entry) {
-    return path.join(programDir, entry.file);
-}
-// ---------------------------------------------------------------------------
-// Normative source hashing
-// ---------------------------------------------------------------------------
-/**
- * Compute SHA-256 hex digest of a file's bytes.
- */
-export function fileSha256(filePath) {
-    const bytes = fs.readFileSync(filePath);
-    return createHash("sha256").update(bytes).digest("hex");
-}
-/**
- * Verify normative source hashes for a packet. Returns violations.
- */
-export function verifyNormativeSources(workspaceRoot, packet) {
-    const violations = [];
-    for (const source of packet.normativeSources) {
-        const fullPath = path.join(workspaceRoot, source.path);
-        if (!fs.existsSync(fullPath)) {
-            violations.push({
-                path: source.path,
-                expected: source.sha256,
-                actual: "<missing>",
-            });
-            continue;
-        }
-        const actual = fileSha256(fullPath);
-        if (actual !== source.sha256) {
-            violations.push({
-                path: source.path,
-                expected: source.sha256,
-                actual,
-            });
-        }
-    }
-    return violations;
-}
-// ---------------------------------------------------------------------------
-// Git helpers (read-only)
-// ---------------------------------------------------------------------------
-export function gitHead(workspaceRoot) {
-    return execSync("git rev-parse HEAD", {
-        cwd: workspaceRoot,
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "pipe"],
-    }).trim();
-}
-export function gitBranch(workspaceRoot) {
-    return execSync("git branch --show-current", {
-        cwd: workspaceRoot,
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "pipe"],
-    }).trim();
-}
-export function gitIsClean(workspaceRoot) {
-    const status = execSync("git status --porcelain", {
-        cwd: workspaceRoot,
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "pipe"],
-    }).trim();
-    return status.length === 0;
-}
-export function gitAncestorOf(workspaceRoot, ancestor, descendant) {
-    try {
-        const result = execSync(`git merge-base --is-ancestor ${ancestor} ${descendant}`, {
-            cwd: workspaceRoot,
-            encoding: "utf8",
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export function gitChangedFilesBetween(workspaceRoot, base, head) {
-    try {
-        const output = execSync(`git diff --name-only ${base}..${head}`, {
-            cwd: workspaceRoot,
-            encoding: "utf8",
-            stdio: ["pipe", "pipe", "pipe"],
-        }).trim();
-        return output.length === 0 ? [] : output.split("\n");
-    }
-    catch {
-        return [];
-    }
-}
-// ---------------------------------------------------------------------------
-// Path matching (cross-platform)
-// ---------------------------------------------------------------------------
-/**
- * Normalize a path to forward slashes for cross-platform comparison.
- */
-export function normalizePath(p) {
-    return p.replace(/\\/g, "/");
-}
-/**
- * Resolve ".." and "." segments in a path without touching the filesystem.
- * Returns the lexical normalization (e.g. "a/b/../c" → "a/c").
- */
-function resolveLexical(p) {
-    const segments = p.split("/");
-    const result = [];
-    for (const seg of segments) {
-        if (seg === "..") {
-            result.pop();
-        }
-        else if (seg !== "." && seg !== "") {
-            result.push(seg);
-        }
-    }
-    return result.join("/");
-}
-/**
- * Check if a path matches a glob pattern. Supports:
- * - `**` for recursive directory matching
- * - `*` for single-level wildcard
- * - exact prefix matching with trailing `/**`
- */
-export function pathMatchesGlob(filePath, pattern) {
-    const normalized = resolveLexical(normalizePath(filePath));
-    const glob = resolveLexical(normalizePath(pattern));
-    // Exact match
-    if (normalized === glob)
-        return true;
-    // /** suffix — prefix match
-    if (glob.endsWith("/**")) {
-        const prefix = glob.slice(0, -3);
-        return normalized === prefix || normalized.startsWith(prefix + "/");
-    }
-    // * wildcard matching (simplified)
-    const regexStr = glob
-        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
-        .replace(/\*\*/g, "<<<GLOBSTAR>>>")
-        .replace(/\*/g, "[^/]*")
-        .replace(/<<<GLOBSTAR>>>/g, ".*");
-    const regex = new RegExp(`^${regexStr}$`);
-    return regex.test(normalized);
-}
-/**
- * Check if a file path is within the allowed files list.
- */
-export function isPathAllowed(filePath, allowedFiles) {
-    const normalized = resolveLexical(normalizePath(filePath));
-    return allowedFiles.some((pattern) => pathMatchesGlob(normalized, pattern));
-}
-/**
- * Check if a file path matches any forbidden pattern.
- */
-export function isPathForbidden(filePath, forbiddenFiles) {
-    const normalized = resolveLexical(normalizePath(filePath));
-    return forbiddenFiles.some((pattern) => pathMatchesGlob(normalized, pattern));
-}
-//# sourceMappingURL=discovery.js.map