@aloth/olcli 0.7.0 → 0.9.0

package/dist/rename-plan.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pure planning logic for bulk project renames.
+ *
+ * Lives apart from the CLI so the MCP surface can compute and inspect the same
+ * plan without going through argument parsing. Two copies of these rules would
+ * drift, and the collision check is exactly the part that must not.
+ */
+export interface RenameCandidate {
+    id: string;
+    name: string;
+}
+export interface PlannedRename {
+    id: string;
+    from: string;
+    to: string;
+}
+export interface SkippedRename {
+    name: string;
+    reason: string;
+}
+export interface RenamePlanOptions {
+    /** Only consider projects whose name matches this regex source. */
+    match?: string;
+    /** Literal substring to replace. Takes precedence over regex replacement. */
+    search?: string;
+    /** Replacement text. Supports $1/$2 backrefs when used with `match`. */
+    replace?: string;
+    prefix?: string;
+    suffix?: string;
+}
+export interface RenamePlan {
+    planned: PlannedRename[];
+    skipped: SkippedRename[];
+    /** Human-readable collision descriptions. Non-empty means: do not apply. */
+    collisions: string[];
+}
+export declare class RenamePlanError extends Error {
+}
+/**
+ * Build the rename plan. Never performs I/O and never mutates its input.
+ *
+ * Throws RenamePlanError for operator mistakes (no transform, bad regex) so the
+ * caller can surface them before anything touches the network.
+ */
+export declare function planProjectRenames(projects: RenameCandidate[], options: RenamePlanOptions): RenamePlan;
+//# sourceMappingURL=rename-plan.d.ts.map

package/dist/rename-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-plan.d.ts","sourceRoot":"","sources":["../src/rename-plan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,EAAE,iBAAiB,GACzB,UAAU,CAqEZ"}

package/dist/rename-plan.js

@@ -0,0 +1,81 @@
+/**
+ * Pure planning logic for bulk project renames.
+ *
+ * Lives apart from the CLI so the MCP surface can compute and inspect the same
+ * plan without going through argument parsing. Two copies of these rules would
+ * drift, and the collision check is exactly the part that must not.
+ */
+export class RenamePlanError extends Error {
+}
+/**
+ * Build the rename plan. Never performs I/O and never mutates its input.
+ *
+ * Throws RenamePlanError for operator mistakes (no transform, bad regex) so the
+ * caller can surface them before anything touches the network.
+ */
+export function planProjectRenames(projects, options) {
+    const hasTransform = options.replace !== undefined || Boolean(options.prefix) || Boolean(options.suffix);
+    if (!hasTransform) {
+        throw new RenamePlanError('Nothing to do: pass replace, prefix or suffix.');
+    }
+    if (options.replace !== undefined && !options.search && !options.match) {
+        throw new RenamePlanError('replace needs either search (literal) or match (regex).');
+    }
+    let matcher;
+    if (options.match) {
+        try {
+            matcher = new RegExp(options.match);
+        }
+        catch (err) {
+            throw new RenamePlanError(`Invalid match regex: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const planned = [];
+    const skipped = [];
+    for (const p of projects) {
+        if (matcher && !matcher.test(p.name))
+            continue;
+        let next = p.name;
+        if (options.replace !== undefined) {
+            if (options.search) {
+                // split/join rather than replaceAll so the needle is always literal:
+                // project names routinely contain regex metacharacters like . ( ) [ ]
+                next = next.split(options.search).join(options.replace);
+            }
+            else if (matcher) {
+                next = next.replace(matcher, options.replace);
+            }
+        }
+        if (options.prefix)
+            next = `${options.prefix}${next}`;
+        if (options.suffix)
+            next = `${next}${options.suffix}`;
+        next = next.trim();
+        if (!next) {
+            skipped.push({ name: p.name, reason: 'result would be empty' });
+            continue;
+        }
+        if (next === p.name)
+            continue;
+        planned.push({ id: p.id, from: p.name, to: next });
+    }
+    // Overleaf tolerates duplicate project names, which makes a collision worse
+    // rather than harmless: nothing fails, and afterwards two projects are
+    // indistinguishable in every listing and in `olcli list`.
+    const targetCounts = new Map();
+    for (const p of planned)
+        targetCounts.set(p.to, (targetCounts.get(p.to) ?? 0) + 1);
+    const existing = new Set(projects.map((p) => p.name));
+    const renamedAway = new Set(planned.map((p) => p.from));
+    const collisions = [];
+    for (const [name, count] of targetCounts) {
+        if (count > 1) {
+            collisions.push(`${name} (${count} projects map to it)`);
+        }
+        else if (existing.has(name) && !renamedAway.has(name)) {
+            collisions.push(`${name} (an untouched project already has this name)`);
+        }
+    }
+    return { planned, skipped, collisions };
+}
+//# sourceMappingURL=rename-plan.js.map

package/dist/rename-plan.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aloth/olcli",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Command-line interface for Overleaf — Sync, manage, and compile LaTeX projects from your terminal",
   "type": "module",
   "main": "dist/index.js",