@warpgogol/forge 2.1.0 → 2.3.0

package/dist/src/knowledge/promote.js

@@ -0,0 +1,120 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Cross-skill duplicate detection and promotion planning for shared knowledge layer (RFC-0663).</purpose>
+<non-goals>
+  <item>Do not read or write files — that is handled by parse.ts/serialize.ts and the distill skill.</item>
+  <item>Do not execute promotions — that is the operator's decision inside fo-knowledge-distill.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0663: initial cross-skill duplicate detection and promotion planning.</item>
+</CHANGE_SUMMARY>
+*/
+const STOP_WORDS = new Set(["the", "a", "an"]);
+const MIN_CONTAINMENT_LENGTH = 20;
+const MIN_CONTAINMENT_RATIO = 0.6;
+export function normalizeTitle(title) {
+    let result = title.toLowerCase();
+    result = result.replace(/[^\p{L}\p{N}\s]/gu, " ");
+    result = result.replace(/\s+/g, " ").trim();
+    const words = result.split(" ").filter((w) => w.length > 0 && !STOP_WORDS.has(w));
+    return words.join(" ");
+}
+function isExcludedEntry(meta) {
+    if (meta.status === "stale" || meta.status === "archived")
+        return true;
+    if (meta.promotedTo !== undefined && meta.promotedTo !== null)
+        return true;
+    return false;
+}
+function isLinkedPair(metaA, metaB) {
+    if (metaA.supersedes && metaB.id && metaA.supersedes.includes(metaB.id))
+        return true;
+    if (metaB.supersedes && metaA.id && metaB.supersedes.includes(metaA.id))
+        return true;
+    if (metaA.promotedTo && metaB.id && metaA.promotedTo === `shared/${metaB.id}`)
+        return true;
+    if (metaB.promotedTo && metaA.id && metaB.promotedTo === `shared/${metaA.id}`)
+        return true;
+    return false;
+}
+function collectActiveEntries(files) {
+    const active = [];
+    for (const file of files) {
+        if (file.parsed.isKnowledgeAdjacent)
+            continue;
+        if (file.parsed.parseIssues.length > 0)
+            continue;
+        for (const entry of file.parsed.entries) {
+            if (isExcludedEntry(entry.meta))
+                continue;
+            const normalized = normalizeTitle(entry.title);
+            if (normalized.length === 0)
+                continue;
+            active.push({ skill: file.skill, entry, normalizedTitle: normalized });
+        }
+    }
+    return active;
+}
+export function detectDuplicatePrinciples(files) {
+    const active = collectActiveEntries(files);
+    const pairs = [];
+    for (let i = 0; i < active.length; i++) {
+        for (let j = i + 1; j < active.length; j++) {
+            const a = active[i];
+            const b = active[j];
+            if (isLinkedPair(a.entry.meta, b.entry.meta))
+                continue;
+            if (a.normalizedTitle === b.normalizedTitle) {
+                pairs.push({
+                    a: { skill: a.skill, entryId: a.entry.meta.id, title: a.entry.title },
+                    b: { skill: b.skill, entryId: b.entry.meta.id, title: b.entry.title },
+                    normalizedTitle: a.normalizedTitle,
+                    kind: "exact",
+                });
+                continue;
+            }
+            const shorter = a.normalizedTitle.length <= b.normalizedTitle.length ? a : b;
+            const longer = a.normalizedTitle.length <= b.normalizedTitle.length ? b : a;
+            if (shorter.normalizedTitle.length < MIN_CONTAINMENT_LENGTH)
+                continue;
+            if (shorter.normalizedTitle.length < longer.normalizedTitle.length * MIN_CONTAINMENT_RATIO)
+                continue;
+            if (longer.normalizedTitle.includes(shorter.normalizedTitle)) {
+                pairs.push({
+                    a: { skill: a.skill, entryId: a.entry.meta.id, title: a.entry.title },
+                    b: { skill: b.skill, entryId: b.entry.meta.id, title: b.entry.title },
+                    normalizedTitle: shorter.normalizedTitle,
+                    kind: "containment",
+                });
+            }
+        }
+    }
+    return pairs;
+}
+export function planPromotion(sources, merged, nextSharedId, today) {
+    const totalConfirmations = sources.reduce((sum, s) => sum + (s.entry.meta.confirmations ?? 0), 0);
+    const promotedFrom = sources.map((s) => `${s.skill}/${s.entry.meta.id}`);
+    const sharedMeta = {
+        id: nextSharedId,
+        layer: "L2",
+        created: today,
+        lastConfirmedAt: today,
+        confirmations: totalConfirmations,
+        status: "active",
+        promotedFrom,
+    };
+    const sharedEntry = {
+        meta: sharedMeta,
+        title: merged.title,
+        body: merged.body,
+        lineStart: 0,
+    };
+    const localPointers = sources.map((s) => ({
+        skill: s.skill,
+        file: s.file,
+        entryId: s.entry.meta.id,
+    }));
+    return { sharedEntry, localPointers };
+}
+//# sourceMappingURL=promote.js.map

package/dist/src/knowledge/promote.js.map

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

package/dist/src/knowledge/schema.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export type KnowledgeLayer = "L0" | "L1" | "L2";
+export type KnowledgeEntryStatus = "active" | "stale" | "superseded" | "archived";
+export declare const knowledgeEntryMetaSchema: z.ZodObject<{
+    id: z.ZodString;
+    layer: z.ZodEnum<{
+        L0: "L0";
+        L1: "L1";
+        L2: "L2";
+    }>;
+    created: z.ZodString;
+    lastConfirmedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    confirmations: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    supersedes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    promotedTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
+    promotedFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodEnum<{
+        active: "active";
+        stale: "stale";
+        superseded: "superseded";
+        archived: "archived";
+    }>;
+}, z.core.$strip>;
+export interface KnowledgeEntryMeta {
+    id: string;
+    layer: KnowledgeLayer;
+    created: string;
+    lastConfirmedAt?: string | null;
+    confirmations?: number;
+    expiresAt?: string | null;
+    supersedes?: string[];
+    promotedTo?: string | null;
+    promotedFrom?: string[];
+    status: KnowledgeEntryStatus;
+}
+export interface KnowledgeEntry {
+    meta: KnowledgeEntryMeta;
+    title: string;
+    body: string;
+    lineStart: number;
+}
+export interface LegacySection {
+    text: string;
+    lineStart: number;
+}
+export interface ParseIssue {
+    line: number;
+    message: string;
+    entryId?: string;
+}
+export interface ParsedKnowledgeFile {
+    path: string;
+    layer: KnowledgeLayer | null;
+    preamble: string;
+    entries: KnowledgeEntry[];
+    legacySections: LegacySection[];
+    parseIssues: ParseIssue[];
+    isKnowledgeAdjacent: boolean;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/knowledge/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/knowledge/schema.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAmBlF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAkCnC,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;CAC9B"}

package/dist/src/knowledge/schema.js

@@ -0,0 +1,64 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Define the Zod metadata schema for knowledge entries with layer-specific refinements (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not parse markdown — that is handled by parse.ts.</item>
+  <item>Do not serialize — that is handled by serialize.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial knowledge entry metadata schema with L0/L1/L2 layer-specific refinements.</item>
+  <item>RFC-0663: added promotedFrom field for shared-layer provenance tracking.</item>
+</CHANGE_SUMMARY>
+*/
+import { z } from "zod";
+const ENTRY_ID_PATTERN = /^K-\d{4}$/;
+const PROMOTED_TO_PATTERN = /^shared\/K-\d{4}$/;
+const PROMOTED_FROM_PATTERN = /^[a-z0-9-]+\/K-\d{4}$/;
+const baseMetaSchema = z.object({
+    id: z.string().regex(ENTRY_ID_PATTERN, "id must match ^K-\\d{4}$"),
+    layer: z.enum(["L0", "L1", "L2"]),
+    created: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "created must be YYYY-MM-DD"),
+    lastConfirmedAt: z.union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.null()]).optional(),
+    confirmations: z.number().int().min(0).optional(),
+    expiresAt: z.union([z.string().regex(/^\d{4}-\d{2}-\d{2}$/), z.null()]).optional(),
+    supersedes: z.array(z.string().regex(ENTRY_ID_PATTERN)).optional(),
+    promotedTo: z.union([z.string().regex(PROMOTED_TO_PATTERN), z.null()]).optional(),
+    promotedFrom: z.array(z.string().regex(PROMOTED_FROM_PATTERN)).optional(),
+    status: z.enum(["active", "stale", "superseded", "archived"]),
+});
+export const knowledgeEntryMetaSchema = baseMetaSchema.superRefine((data, ctx) => {
+    if (data.layer === "L0" || data.layer === "L1") {
+        if (data.confirmations !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `confirmations is forbidden on ${data.layer} entries`,
+                path: ["confirmations"],
+            });
+        }
+        if (data.lastConfirmedAt !== undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `lastConfirmedAt is forbidden on ${data.layer} entries`,
+                path: ["lastConfirmedAt"],
+            });
+        }
+    }
+    if (data.layer === "L2") {
+        if (data.confirmations === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "confirmations is required on L2 entries",
+                path: ["confirmations"],
+            });
+        }
+        if (data.lastConfirmedAt === undefined) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "lastConfirmedAt is required on L2 entries",
+                path: ["lastConfirmedAt"],
+            });
+        }
+    }
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/knowledge/schema.js.map

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

package/dist/src/knowledge/serialize.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedKnowledgeFile } from "./schema.ts";
+export declare function serializeKnowledgeFile(parsed: ParsedKnowledgeFile): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/src/knowledge/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/knowledge/serialize.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAoC3E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAsB1E"}

package/dist/src/knowledge/serialize.js

@@ -0,0 +1,67 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Round-trip serializer for knowledge files — reconstructs markdown from ParsedKnowledgeFile (RFC-0660).</purpose>
+<non-goals>
+  <item>Do not parse — that is handled by parse.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0660: initial round-trip serializer for structured knowledge entries.</item>
+  <item>RFC-0663: added promotedFrom to FIELD_ORDER for shared-layer provenance.</item>
+</CHANGE_SUMMARY>
+*/
+const FIELD_ORDER = [
+    "id",
+    "layer",
+    "created",
+    "lastConfirmedAt",
+    "confirmations",
+    "expiresAt",
+    "supersedes",
+    "promotedTo",
+    "promotedFrom",
+    "status",
+];
+function formatYamlValue(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        return `[${value.join(", ")}]`;
+    }
+    if (typeof value === "string")
+        return value;
+    return String(value);
+}
+function serializeMeta(meta) {
+    const lines = ["```knowledge-entry"];
+    for (const field of FIELD_ORDER) {
+        const value = meta[field];
+        if (value === undefined)
+            continue;
+        lines.push(`${field}: ${formatYamlValue(value)}`);
+    }
+    lines.push("```");
+    return lines.join("\n");
+}
+export function serializeKnowledgeFile(parsed) {
+    const parts = [];
+    if (parsed.preamble) {
+        parts.push(parsed.preamble);
+    }
+    for (const entry of parsed.entries) {
+        parts.push(`### ${entry.meta.id}: ${entry.title}`);
+        parts.push("");
+        parts.push(serializeMeta(entry.meta));
+        if (entry.body) {
+            parts.push("");
+            parts.push(entry.body);
+        }
+    }
+    for (const legacy of parsed.legacySections) {
+        parts.push(legacy.text);
+    }
+    return parts.join("\n").replace(/\n{3,}/g, "\n\n") + "\n";
+}
+//# sourceMappingURL=serialize.js.map

package/dist/src/knowledge/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/knowledge/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,WAAW,GAAiC;IAChD,IAAI;IACJ,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,QAAQ;CACT,CAAC;AAEF,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB;IAC7C,MAAM,KAAK,GAAa,CAAC,oBAAoB,CAAC,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA2B;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;AAC5D,CAAC"}

package/dist/src/migration-adapters/git-utils.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterAnalysis } from "./types.ts";
+export declare function runPostSetup(sourceDir: string, targetDir: string, analysis: AdapterAnalysis): void;
+//# sourceMappingURL=git-utils.d.ts.map

package/dist/src/migration-adapters/git-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../../src/migration-adapters/git-utils.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAsCN"}

package/dist/src/migration-adapters/git-utils.js

@@ -0,0 +1,56 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Shared git utilities for migration adapters — git init and git history transfer via format-patch + git am (RFC-0547).</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not implement adapter-specific logic — only shared git operations.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0547: extract shared postSetup git logic from duplicated adapter implementations.</item>
+  <item>Replace fs.rmSync with trashSync for patch directory cleanup (trash bin for LLM-initiated deletions).</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { trashSync } from "../utils/fs-trash-sync.js";
+export function runPostSetup(sourceDir, targetDir, analysis) {
+    const gitDir = path.join(targetDir, ".git");
+    if (analysis.gitHistory) {
+        try {
+            const patchDir = path.join(targetDir, ".forge-migration-patches");
+            fs.mkdirSync(patchDir, { recursive: true });
+            execFileSync("git", ["-C", sourceDir, "format-patch", "--all", "-o", patchDir], {
+                stdio: "pipe",
+            });
+            execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
+            const patches = fs
+                .readdirSync(patchDir)
+                .filter((f) => f.endsWith(".patch"))
+                .sort();
+            if (patches.length > 0) {
+                for (const patch of patches) {
+                    execFileSync("git", ["am", path.join(patchDir, patch)], {
+                        cwd: targetDir,
+                        stdio: "pipe",
+                    });
+                }
+            }
+            trashSync(patchDir);
+            return;
+        }
+        catch (err) {
+            console.warn(`forge: git history transfer failed, falling back to clean git init: ${err instanceof Error ? err.message : String(err)}`);
+            if (!fs.existsSync(gitDir)) {
+                execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
+            }
+        }
+    }
+    else {
+        if (!fs.existsSync(gitDir)) {
+            execFileSync("git", ["init"], { cwd: targetDir, stdio: "pipe" });
+        }
+    }
+}
+//# sourceMappingURL=git-utils.js.map

package/dist/src/migration-adapters/git-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../../src/migration-adapters/git-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,SAAiB,EACjB,QAAyB;IAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE5C,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;YAClE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE;gBAC9E,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,EAAE;iBACf,WAAW,CAAC,QAAQ,CAAC;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;iBACnC,IAAI,EAAE,CAAC;YACV,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE;wBACtD,GAAG,EAAE,SAAS;wBACd,KAAK,EAAE,MAAM;qBACd,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,SAAS,CAAC,QAAQ,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,uEAAuE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC1H,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/migration-adapters/ignored-files.d.ts

@@ -0,0 +1,12 @@
+export type IgnoredFileCategoryId = "config" | "data" | "runtime-state" | "cache" | "other";
+export interface IgnoredFileCategory {
+    id: IgnoredFileCategoryId;
+    label: string;
+    description: string;
+    paths: string[];
+    totalSizeBytes: number;
+    fileCount: number;
+}
+export declare function discoverIgnoredFiles(sourceDir: string): IgnoredFileCategory[];
+export declare function formatSize(bytes: number): string;
+//# sourceMappingURL=ignored-files.d.ts.map

package/dist/src/migration-adapters/ignored-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored-files.d.ts","sourceRoot":"","sources":["../../../src/migration-adapters/ignored-files.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,MAAM,GAAG,eAAe,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5F,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,qBAAqB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAsID,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAqD7E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/src/migration-adapters/ignored-files.js

@@ -0,0 +1,190 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Discover and categorize git-ignored/untracked files in a source project for interactive transfer selection during onboarding.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not copy files — discovery and categorization only.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial: discoverIgnoredFiles function that scans source for git-ignored files, categorizes them by type (config, data, runtime-state, cache, other), and returns sized categories for operator selection.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+const CONFIG_MATCHERS = [
+    (p) => p === ".env" || p.startsWith(".env."),
+    (p) => p.endsWith(".key") || p.endsWith(".pem") || p.endsWith(".crt"),
+    (p) => p === ".secret" || p.startsWith("secret"),
+    (p) => p.startsWith("secrets/"),
+    (p) => p.includes("/.env") || p.includes("/.env."),
+    (p) => p === ".envrc" || p.startsWith(".envrc."),
+];
+const DATA_MATCHERS = [
+    (p) => p.startsWith(".input/") || p.includes("/.input/"),
+    (p) => p.startsWith("input/") || p.includes("/input/"),
+    (p) => p.startsWith("inputs/") || p.includes("/inputs/"),
+    (p) => p.startsWith("data/") || p.includes("/data/"),
+    (p) => p.startsWith("assets/") || p.includes("/assets/"),
+    (p) => p.startsWith("batches/") || p.includes("/batches/"),
+    (p) => p.endsWith(".db") || p.endsWith(".sqlite") || p.endsWith(".sqlite3"),
+    (p) => p.endsWith(".ndjson") && !p.startsWith("bordbuch/"),
+];
+const RUNTIME_STATE_MATCHERS = [
+    (p) => p.startsWith("storage/") || p.includes("/storage/"),
+    (p) => p.startsWith(".state/") || p.includes("/.state/"),
+    (p) => p.startsWith("state/") || p.includes("/state/"),
+    (p) => p.endsWith(".log"),
+];
+const CACHE_MATCHERS = [
+    (p) => p.startsWith(".cache/") || p.includes("/.cache/"),
+    (p) => p.startsWith("cache/") || p.includes("/cache/"),
+    (p) => p.includes(".playwright") || p.includes("browser-profile"),
+    (p) => p.endsWith(".tmp") || p.startsWith(".tmp"),
+];
+const CATEGORY_DEFS = [
+    {
+        id: "config",
+        label: "Configuration & secrets",
+        description: "Environment files, API keys, certificates, and local configuration needed for the project to run.",
+        matchers: CONFIG_MATCHERS,
+    },
+    {
+        id: "data",
+        label: "Data & inputs",
+        description: "Input data, datasets, databases, and batch files used by the project.",
+        matchers: DATA_MATCHERS,
+    },
+    {
+        id: "runtime-state",
+        label: "Runtime state",
+        description: "Crawlee state, logs, and other runtime artifacts from previous executions.",
+        matchers: RUNTIME_STATE_MATCHERS,
+    },
+    {
+        id: "cache",
+        label: "Caches",
+        description: "Browser profiles, temporary files, and build caches that can be regenerated.",
+        matchers: CACHE_MATCHERS,
+    },
+    {
+        id: "other",
+        label: "Other ignored files",
+        description: "Files matched by .gitignore that don't fit into any standard category.",
+        matchers: [],
+    },
+];
+const CATEGORY_PRIORITY = {
+    config: 0,
+    data: 1,
+    "runtime-state": 2,
+    cache: 3,
+    other: 4,
+};
+function categorizePath(relPath) {
+    const normalized = relPath.replace(/\\/g, "/");
+    for (const def of CATEGORY_DEFS) {
+        if (def.matchers.some((m) => m(normalized))) {
+            return def;
+        }
+    }
+    return CATEGORY_DEFS[CATEGORY_DEFS.length - 1];
+}
+function getDirStats(dirPath) {
+    let size = 0;
+    let count = 0;
+    try {
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                const sub = getDirStats(fullPath);
+                size += sub.size;
+                count += sub.count;
+            }
+            else if (entry.isFile()) {
+                try {
+                    size += fs.statSync(fullPath).size;
+                    count++;
+                }
+                catch {
+                    // File may have been removed
+                }
+            }
+        }
+    }
+    catch {
+        // Directory may have been removed
+    }
+    return { size, count };
+}
+function getPathSize(fullPath) {
+    try {
+        const stat = fs.statSync(fullPath);
+        if (stat.isDirectory()) {
+            const { size, count } = getDirStats(fullPath);
+            return { sizeBytes: size, fileCount: count };
+        }
+        return { sizeBytes: stat.size, fileCount: 1 };
+    }
+    catch {
+        return { sizeBytes: 0, fileCount: 0 };
+    }
+}
+export function discoverIgnoredFiles(sourceDir) {
+    const hasGit = fs.existsSync(path.join(sourceDir, ".git"));
+    let ignoredPaths = [];
+    if (hasGit) {
+        try {
+            const output = execFileSync("git", ["-C", sourceDir, "status", "--ignored", "--porcelain"], {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+                timeout: 30_000,
+            });
+            ignoredPaths = output
+                .split("\n")
+                .filter((l) => l.startsWith("!! "))
+                .map((l) => l.slice(3).trim())
+                .filter((p) => p.length > 0);
+        }
+        catch {
+            // git command failed — return empty
+            return [];
+        }
+    }
+    if (ignoredPaths.length === 0) {
+        return [];
+    }
+    const categoryMap = new Map();
+    for (const relPath of ignoredPaths) {
+        const fullPath = path.join(sourceDir, relPath);
+        const def = categorizePath(relPath);
+        const { sizeBytes, fileCount } = getPathSize(fullPath);
+        if (!categoryMap.has(def.id)) {
+            categoryMap.set(def.id, {
+                id: def.id,
+                label: def.label,
+                description: def.description,
+                paths: [],
+                totalSizeBytes: 0,
+                fileCount: 0,
+            });
+        }
+        const cat = categoryMap.get(def.id);
+        cat.paths.push(relPath);
+        cat.totalSizeBytes += sizeBytes;
+        cat.fileCount += fileCount;
+    }
+    return Array.from(categoryMap.values()).sort((a, b) => CATEGORY_PRIORITY[a.id] - CATEGORY_PRIORITY[b.id]);
+}
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+//# sourceMappingURL=ignored-files.js.map

package/dist/src/migration-adapters/ignored-files.js.map

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

package/dist/src/migration-adapters/index.d.ts

@@ -0,0 +1,8 @@
+export type { MigrationAdapter, AdapterAnalysis, MigrationResult, Conflict } from "./types.ts";
+export { FORGE_PROTECTED_PATHS, DEFAULT_EXCLUDE_PATTERNS } from "./types.ts";
+export { nodeTypescriptPnpmAdapter } from "./node-typescript-pnpm/index.ts";
+export { phaserPnpmAdapter } from "./phaser-pnpm/index.ts";
+export { getAdapters, detectAdapter, detectAdapters } from "./registry.ts";
+export { discoverIgnoredFiles, formatSize } from "./ignored-files.ts";
+export type { IgnoredFileCategory, IgnoredFileCategoryId } from "./ignored-files.ts";
+//# sourceMappingURL=index.d.ts.map