svharness 0.8.0

package/dist/wiki/repowikiCanonicalSections.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultWikiFolderSegment = defaultWikiFolderSegment;
+exports.buildUniqueSectionFolderSegments = buildUniqueSectionFolderSegments;
+exports.sectionFolderSegmentForPage = sectionFolderSegmentForPage;
+exports.formatSectionFolderMapSummary = formatSectionFolderMapSummary;
+const wikiStructureXml_1 = require("./wikiStructureXml");
+/**
+ * When `structure.xml` has no `<sections>`, all pages live under one folder derived from the
+ * wiki outline `<title>`, with a language fallback if the title slug is empty.
+ */
+function defaultWikiFolderSegment(wikiOutlineTitle, langFolder) {
+    const s = (0, wikiStructureXml_1.slugifyWikiTitle)(wikiOutlineTitle);
+    if (s)
+        return s;
+    return langFolder === "zh" ? "文档" : "wiki";
+}
+/**
+ * Map each section id to a unique subdirectory name under the language folder
+ * (slug of `<section>` `<title>`, with numeric suffixes if titles collide).
+ */
+function buildUniqueSectionFolderSegments(groups) {
+    const used = new Set();
+    const idToFolder = new Map();
+    for (const g of groups) {
+        let base = (0, wikiStructureXml_1.slugifyWikiTitle)(g.title) || (0, wikiStructureXml_1.slugifyWikiTitle)(g.id) || "section";
+        let candidate = base;
+        let n = 2;
+        while (used.has(candidate)) {
+            candidate = `${base}-${n}`;
+            n++;
+        }
+        used.add(candidate);
+        idToFolder.set(g.id, candidate);
+    }
+    return idToFolder;
+}
+/**
+ * Resolve the first path segment under `<lang>/…` for a page using `<sections>` when present.
+ */
+function sectionFolderSegmentForPage(page, sectionGroups, outlineFolderSegment, folderBySectionId) {
+    if (sectionGroups.length === 0) {
+        return outlineFolderSegment;
+    }
+    const ps = page.parentSection?.trim();
+    if (ps && folderBySectionId.has(ps)) {
+        return folderBySectionId.get(ps);
+    }
+    const containing = sectionGroups.find((s) => s.pageIds.includes(page.id));
+    if (containing) {
+        return folderBySectionId.get(containing.id) ?? outlineFolderSegment;
+    }
+    return outlineFolderSegment;
+}
+function formatSectionFolderMapSummary(folderByPageId, pageOrder) {
+    const byFolder = new Map();
+    for (const id of pageOrder) {
+        const f = folderByPageId.get(id) ?? "";
+        const arr = byFolder.get(f) ?? [];
+        arr.push(id);
+        byFolder.set(f, arr);
+    }
+    return [...byFolder.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([folder, ids]) => `${folder}: ${ids.join(",")}`)
+        .join(" | ");
+}

package/dist/wiki/repowikiCheckpoint.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPOWIKI_CHECKPOINT_FILENAME = void 0;
+exports.checkpointPath = checkpointPath;
+exports.readRepowikiCheckpoint = readRepowikiCheckpoint;
+exports.checkpointMatchesRun = checkpointMatchesRun;
+exports.writeRepowikiCheckpoint = writeRepowikiCheckpoint;
+exports.clearRepowikiCheckpoint = clearRepowikiCheckpoint;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+exports.REPOWIKI_CHECKPOINT_FILENAME = "checkpoint.json";
+function normFs(p) {
+    return path.normalize(p).replace(/\\/g, "/");
+}
+function checkpointPath(wikiBaseFs) {
+    return path.join(wikiBaseFs, exports.REPOWIKI_CHECKPOINT_FILENAME);
+}
+async function readRepowikiCheckpoint(wikiBaseFs) {
+    try {
+        const raw = await fs.readFile(checkpointPath(wikiBaseFs), "utf8");
+        const j = JSON.parse(raw);
+        if (j.version !== 1 || typeof j.runId !== "string" || typeof j.sourceRootFs !== "string") {
+            return null;
+        }
+        if (typeof j.wikiBaseFs !== "string" || typeof j.targetLang !== "string") {
+            return null;
+        }
+        return {
+            version: 1,
+            runId: j.runId,
+            status: j.status === "done" ? "done" : "running",
+            sourceRootFs: j.sourceRootFs,
+            wikiBaseFs: j.wikiBaseFs,
+            indexedCommit: j.indexedCommit ?? null,
+            targetLang: j.targetLang,
+            languages: Array.isArray(j.languages) ? j.languages : undefined,
+            completed: Array.isArray(j.completed) ? [...j.completed] : [],
+            fileByPageId: j.fileByPageId && typeof j.fileByPageId === "object"
+                ? { ...j.fileByPageId }
+                : {},
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function checkpointMatchesRun(cp, sourceRootFs, wikiBaseFs, targetLangFolder) {
+    return (normFs(cp.sourceRootFs) === normFs(sourceRootFs) &&
+        normFs(cp.wikiBaseFs) === normFs(wikiBaseFs) &&
+        cp.targetLang === targetLangFolder &&
+        cp.status !== "done");
+}
+/** Atomic replace via temp + rename. */
+async function writeRepowikiCheckpoint(wikiBaseFs, data) {
+    await fs.mkdir(wikiBaseFs, { recursive: true });
+    const finalPath = checkpointPath(wikiBaseFs);
+    const tmp = path.join(wikiBaseFs, `.checkpoint-${data.runId}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}.tmp.json`);
+    const payload = {
+        ...data,
+        wikiBaseFs: normFs(data.wikiBaseFs),
+        sourceRootFs: normFs(data.sourceRootFs),
+    };
+    await fs.writeFile(tmp, JSON.stringify(payload, null, 2), "utf8");
+    await fs.rename(tmp, finalPath);
+}
+async function clearRepowikiCheckpoint(wikiBaseFs) {
+    try {
+        await fs.unlink(checkpointPath(wikiBaseFs));
+    }
+    catch {
+        /* missing is fine */
+    }
+}

package/dist/wiki/repowikiConfig.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRepowikiMetadata = void 0;
+/**
+ * Compatibility shim — keeps the original filename used by ported modules
+ * (e.g. `repowikiStructureNav.ts`) so we avoid churning their imports.
+ */
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadRepowikiMetadata", { enumerable: true, get: function () { return config_1.loadRepowikiMetadata; } });

package/dist/wiki/repowikiGit.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitHeadAt = gitHeadAt;
+exports.basenameSafe = basenameSafe;
+exports.gitChangedPathCountSince = gitChangedPathCountSince;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+async function gitHeadAt(cwdFs) {
+    return new Promise((resolve) => {
+        const gitBin = process.platform === "win32" ? "git.exe" : "git";
+        (0, child_process_1.execFile)(gitBin, ["-C", cwdFs, "rev-parse", "HEAD"], { timeout: 8000 }, (err, stdout) => {
+            if (err) {
+                resolve(undefined);
+                return;
+            }
+            const h = stdout.trim();
+            resolve(h.length > 7 ? h : undefined);
+        });
+    });
+}
+function basenameSafe(p) {
+    return path.basename(p.replace(/[/\\]+$/, "")) || "workspace";
+}
+/** Count paths changed between `fromRef` and current `HEAD` (merge-base range). Undefined if git fails. */
+async function gitChangedPathCountSince(cwdFs, fromCommit) {
+    const from = fromCommit.trim();
+    if (from.length < 7)
+        return undefined;
+    return new Promise((resolve) => {
+        const gitBin = process.platform === "win32" ? "git.exe" : "git";
+        (0, child_process_1.execFile)(gitBin, ["-C", cwdFs, "diff", "--name-only", `${from}...HEAD`], { timeout: 12_000, maxBuffer: 4 * 1024 * 1024 }, (err, stdout) => {
+            if (err) {
+                resolve(undefined);
+                return;
+            }
+            const n = stdout.split(/\r?\n/).filter((l) => l.length > 0).length;
+            resolve(n);
+        });
+    });
+}