@tailor-platform/sdk-codemod 0.2.7 → 0.3.0-next.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @tailor-platform/sdk-codemod
 
+## 0.3.0-next.1
+### Patch Changes
+
+
+
+- [#1460](https://github.com/tailor-platform/sdk/pull/1460) [`f49c6d1`](https://github.com/tailor-platform/sdk/commit/f49c6d1b5a856969cb4e04ae7d3a87ed34aa020f) Thanks [@dqn](https://github.com/dqn)! - Remove the v1 runtime globals compatibility layer. Importing from `@tailor-platform/sdk` no longer activates the ambient `tailor.*` / `tailordb.*` declarations; opt into globals with `@tailor-platform/sdk/runtime/globals` or use the typed wrappers from `@tailor-platform/sdk/runtime`.
+  
+  The capital-cased `Tailordb.*` namespace is removed. If your project still references `Tailordb.QueryResult`, `Tailordb.CommandType`, `Tailordb.Client`, or `typeof Tailordb.Client`, migrate before upgrading: run `pnpm dlx @tailor-platform/sdk-codemod v2/tailordb-namespace` to rewrite them to lowercase `tailordb.*`, then add `import "@tailor-platform/sdk/runtime/globals"` so the rewritten references resolve.
+
+
+- [#1457](https://github.com/tailor-platform/sdk/pull/1457) [`84325f8`](https://github.com/tailor-platform/sdk/commit/84325f8602a5631b7c323c997b1425235509920e) Thanks [@dqn](https://github.com/dqn)! - Remove deprecated CLI aliases for the v2 command surface. Use `tailor-sdk deploy` instead of `tailor-sdk apply`, `tailor-sdk crashreport` instead of `tailor-sdk crash-report`, and the hyphenated `--machine-user` option instead of the hidden `--machineuser` alias.
+  
+  Fix the v2 CLI rename codemod to migrate the hidden `--machineuser` option to `--machine-user`.
+
+## 0.3.0-next.0
+### Minor Changes
+
+
+
+- [#1435](https://github.com/tailor-platform/sdk/pull/1435) [`49c0cc9`](https://github.com/tailor-platform/sdk/commit/49c0cc99171d7e317a50a18804a21067d89f9493) Thanks [@dqn](https://github.com/dqn)! - Add the `v2/plugin-cli-import` codemod so `tailor-sdk upgrade` rewrites deprecated plugin imports from `@tailor-platform/sdk/cli` (`kyselyTypePlugin`, `enumConstantsPlugin`, `fileUtilsPlugin`, `seedPlugin`) to their dedicated `@tailor-platform/sdk/plugin/*` subpaths, splitting any non-plugin specifiers onto a separate import.
+
+## 0.3.0
+### Minor Changes
+
+
+
+- [#1435](https://github.com/tailor-platform/sdk/pull/1435) [`49c0cc9`](https://github.com/tailor-platform/sdk/commit/49c0cc99171d7e317a50a18804a21067d89f9493) Thanks [@dqn](https://github.com/dqn)! - Add the `v2/plugin-cli-import` codemod so `tailor-sdk upgrade` rewrites deprecated plugin imports from `@tailor-platform/sdk/cli` (`kyselyTypePlugin`, `enumConstantsPlugin`, `fileUtilsPlugin`, `seedPlugin`) to their dedicated `@tailor-platform/sdk/plugin/*` subpaths, splitting any non-plugin specifiers onto a separate import.
+
 ## 0.2.7
 
 ### Patch Changes

package/dist/codemods/v2/apply-to-deploy/scripts/transform.js

@@ -1,8 +1,10 @@
 import * as path from "pathe";
 //#region codemods/v2/apply-to-deploy/scripts/transform.ts
-const APPLY_PATTERN = /\btailor-sdk(@[^\s'"`]+)?(\s+)apply(?![-\w])/g;
+const ARG_VALUE = `(?:[^\\s'"\`;&|]+|'[^']*'|"(?:(?:\\\\.)|[^"\\\\])*")`;
+const GLOBAL_ARG_PATTERN = `(?:(?:\\s+(?:--verbose|--json|-j))|(?:\\s+(?:--env-file|--env-file-if-exists|-e)(?:=${ARG_VALUE}|\\s+${ARG_VALUE})))*`;
+const APPLY_PATTERN = new RegExp(`(?<![\\w-])tailor-sdk(?:@[^\\s'"\`]+)?(?![\\w-])(${GLOBAL_ARG_PATTERN}\\s+)apply(?![-\\w])`, "g");
 function replaceApply(value) {
-	return value.replace(APPLY_PATTERN, (_match, ver, sep) => `tailor-sdk${ver ?? ""}${sep}deploy`);
+	return value.replace(APPLY_PATTERN, (match) => `${match.slice(0, -5)}deploy`);
 }
 function transformText(source) {
 	if (!APPLY_PATTERN.test(source)) return null;
@@ -35,7 +37,7 @@ function transformPackageJson(source) {
 /**
 * Replace `tailor-sdk apply` invocations with `tailor-sdk deploy`.
 *
-* `deploy` is a v1 alias of `apply` and the recommended name going forward.
+* `deploy` is the canonical v2 command name.
 * @param source - File contents
 * @param filePath - Absolute path to the file (used to dispatch package.json vs text)
 * @returns Transformed source or null when nothing matched.

package/dist/codemods/v2/cli-rename/scripts/transform.js

@@ -1,15 +1,377 @@
 import * as path from "pathe";
 //#region codemods/v2/cli-rename/scripts/transform.ts
 const COMMAND_RENAMES = [["crash-report", "crashreport"]];
-const COMMAND_PATTERN = new RegExp(`\\btailor-sdk(@[^\\s'"\`]+)?(\\s+)(${COMMAND_RENAMES.map(([from]) => from).join("|")})\\b`, "g");
+const OPTION_RENAMES = [["--machineuser", "--machine-user"]];
+const ARG_VALUE = `(?:[^\\s'"\`;&|]+|'[^']*'|"(?:(?:\\\\.)|[^"\\\\])*")`;
+const GLOBAL_ARG_PATTERN = `(?:(?:\\s+(?:--verbose|--json|-j))|(?:\\s+(?:--env-file|--env-file-if-exists|-e)(?:=${ARG_VALUE}|\\s+${ARG_VALUE})))*`;
+const TAILOR_BINARY = `(?<![\\w-])tailor-sdk(?:@[^\\s'"\`]+)?(?![\\w-])`;
+const COMMAND_PATTERN = new RegExp(`${TAILOR_BINARY}(${GLOBAL_ARG_PATTERN}\\s+)(${COMMAND_RENAMES.map(([from]) => from).join("|")})\\b`, "g");
+const TAILOR_BINARY_PATTERN = new RegExp(TAILOR_BINARY, "g");
 const COMMAND_MAP = new Map(COMMAND_RENAMES);
-function replaceAll(value) {
-	return value.replace(COMMAND_PATTERN, (_match, ver, sep, cmd) => `tailor-sdk${ver ?? ""}${sep}${COMMAND_MAP.get(cmd) ?? cmd}`);
+function isOptionBoundaryChar(value) {
+	return value === void 0 || !/[\w-]/.test(value);
 }
-function transformText(source) {
-	if (!COMMAND_PATTERN.test(source)) return null;
-	COMMAND_PATTERN.lastIndex = 0;
-	const updated = replaceAll(source);
+function findInlineCodeSpanEnd(source, start) {
+	const lineStart = source.lastIndexOf("\n", start - 1) + 1;
+	if ([...source.slice(lineStart, start).matchAll(/`/g)].length % 2 === 0) return void 0;
+	const codeSpanEnd = source.indexOf("`", start);
+	return codeSpanEnd === -1 ? void 0 : codeSpanEnd;
+}
+function findEnclosingLineQuoteEnd(source, start) {
+	const lineStart = source.lastIndexOf("\n", start - 1) + 1;
+	const lineEnd = source.indexOf("\n", start);
+	const limit = lineEnd === -1 ? source.length : lineEnd;
+	let quote = null;
+	for (let index = lineStart; index < start; index += 1) {
+		const ch = source[index];
+		if (quote !== null) {
+			if (ch === "\\" && quote === "\"" && index + 1 < start) {
+				index += 1;
+				continue;
+			}
+			if (ch === quote) quote = null;
+			continue;
+		}
+		if (ch === "'" || ch === "\"") quote = ch;
+	}
+	if (quote === null) return void 0;
+	for (let index = start; index < limit; index += 1) {
+		const ch = source[index];
+		if (ch === "\\" && quote === "\"" && index + 1 < limit) {
+			index += 1;
+			continue;
+		}
+		if (ch === quote) return index;
+	}
+}
+function lineIndent(line) {
+	return line.match(/^ */)?.[0].length ?? 0;
+}
+function isFoldedScalarHeader(line) {
+	return /^\s*(?:-\s*)?[^#\n]*:\s*>[+-]?(?:\s*(?:#.*)?)?$/.test(line);
+}
+function findFoldedYamlRanges(source) {
+	const ranges = [];
+	const lines = source.match(/^.*(?:\n|$)/gm) ?? [];
+	let offset = 0;
+	for (let index = 0; index < lines.length; index += 1) {
+		const line = lines[index];
+		const body = line.replace(/\r?\n$/, "");
+		offset += line.length;
+		if (!isFoldedScalarHeader(body)) continue;
+		const baseIndent = lineIndent(body);
+		let rangeStart;
+		let rangeEnd;
+		let cursor = offset;
+		for (let nextIndex = index + 1; nextIndex < lines.length; nextIndex += 1) {
+			const nextLine = lines[nextIndex];
+			const nextBody = nextLine.replace(/\r?\n$/, "");
+			const trimmed = nextBody.trim();
+			const indent = lineIndent(nextBody);
+			if (trimmed !== "" && indent <= baseIndent) break;
+			if (trimmed === "") {
+				if (rangeStart !== void 0 && rangeEnd !== void 0) {
+					ranges.push({
+						start: rangeStart,
+						end: rangeEnd
+					});
+					rangeStart = void 0;
+					rangeEnd = void 0;
+				}
+			} else {
+				rangeStart ??= cursor;
+				rangeEnd = cursor + nextLine.length;
+			}
+			cursor += nextLine.length;
+		}
+		if (rangeStart !== void 0 && rangeEnd !== void 0) ranges.push({
+			start: rangeStart,
+			end: rangeEnd
+		});
+	}
+	return ranges;
+}
+function findMarkdownFencedCodeRanges(source) {
+	const ranges = [];
+	const lines = source.match(/^.*(?:\n|$)/gm) ?? [];
+	let offset = 0;
+	let open;
+	for (const line of lines) {
+		const body = line.replace(/\r?\n$/, "");
+		if (open) {
+			const marker = body.match(/^ {0,3}(`{3,}|~{3,})\s*$/)?.[1];
+			if (marker && marker[0] === open.char && marker.length >= open.length) {
+				ranges.push({
+					start: open.start,
+					end: offset
+				});
+				open = void 0;
+			}
+		} else {
+			const marker = body.match(/^ {0,3}(`{3,}|~{3,}).*$/)?.[1];
+			if (marker) open = {
+				char: marker[0],
+				length: marker.length,
+				start: offset + line.length
+			};
+		}
+		offset += line.length;
+	}
+	if (open) ranges.push({
+		start: open.start,
+		end: source.length
+	});
+	return ranges;
+}
+function isCommandSeparator(source, index) {
+	const ch = source[index];
+	const prev = source[index - 1];
+	if (prev === "\\") return false;
+	if (ch === "&") {
+		const next = source[index + 1];
+		if (prev === ">" || prev === "<" || next === ">") return false;
+	}
+	return ch === ";" || ch === "&" || ch === "|";
+}
+function startsCommandSubstitution(source, index) {
+	return source[index] === "$" && source[index + 1] === "(" && source[index - 1] !== "\\";
+}
+function findCommandSubstitutionEnd(source, start) {
+	let depth = 1;
+	let index = start + 2;
+	let quote = null;
+	while (index < source.length) {
+		const ch = source[index];
+		if (quote !== null) {
+			if (quote.escaped) {
+				if (ch === "\\" && source[index + 1] === quote.char) {
+					quote = null;
+					index += 2;
+					continue;
+				}
+				index += 1;
+				continue;
+			}
+			if (quote.char === "\"" && startsCommandSubstitution(source, index)) {
+				depth += 1;
+				index += 2;
+				continue;
+			}
+			if (ch === "\\" && quote.char === "\"" && index + 1 < source.length) {
+				index += 2;
+				continue;
+			}
+			if (ch === quote.char) quote = null;
+			index += 1;
+			continue;
+		}
+		if (ch === "\\" && source[index + 1] === "\"") {
+			quote = {
+				char: "\"",
+				escaped: true
+			};
+			index += 2;
+			continue;
+		}
+		if (ch === "'" || ch === "\"") {
+			quote = {
+				char: ch,
+				escaped: false
+			};
+			index += 1;
+			continue;
+		}
+		if (startsCommandSubstitution(source, index)) {
+			depth += 1;
+			index += 2;
+			continue;
+		}
+		if (ch === ")") {
+			depth -= 1;
+			if (depth === 0) return index;
+		}
+		index += 1;
+	}
+}
+function findContainingRange(ranges, index) {
+	return ranges?.find((range) => range.start <= index && index < range.end);
+}
+function findTailorCommandEnd(source, start, foldedYamlRanges, markdownFencedCodeRanges) {
+	const inlineCodeSpanEnd = findInlineCodeSpanEnd(source, start);
+	const enclosingLineQuoteEnd = findEnclosingLineQuoteEnd(source, start);
+	const limit = Math.min(inlineCodeSpanEnd ?? source.length, enclosingLineQuoteEnd ?? source.length);
+	const foldedYamlRange = findContainingRange(foldedYamlRanges, start);
+	const markdownFencedCodeRange = findContainingRange(markdownFencedCodeRanges, start);
+	const delimitedRange = foldedYamlRange ?? markdownFencedCodeRange;
+	const commandLimit = delimitedRange ? Math.min(limit, delimitedRange.end) : limit;
+	let quote = null;
+	let end = start;
+	while (end < commandLimit) {
+		const ch = source[end];
+		if (quote !== null) {
+			if (quote.escaped) {
+				if (ch === "\\" && source[end + 1] === quote.char) {
+					quote = null;
+					end += 2;
+					continue;
+				}
+				end += 1;
+				continue;
+			}
+			if (quote.char === "\"" && startsCommandSubstitution(source, end)) {
+				const substitutionEnd = findCommandSubstitutionEnd(source, end);
+				if (substitutionEnd !== void 0) {
+					end = substitutionEnd + 1;
+					continue;
+				}
+			}
+			if (ch === "\\" && quote.char === "\"" && end + 1 < commandLimit) {
+				end += 2;
+				continue;
+			}
+			if (ch === quote.char) quote = null;
+			end += 1;
+			continue;
+		}
+		if (ch === "\\" && source[end + 1] === "\"") {
+			quote = {
+				char: "\"",
+				escaped: true
+			};
+			end += 2;
+			continue;
+		}
+		if (ch === "'" || ch === "\"") {
+			quote = {
+				char: ch,
+				escaped: false
+			};
+			end += 1;
+			continue;
+		}
+		if (startsCommandSubstitution(source, end)) {
+			const substitutionEnd = findCommandSubstitutionEnd(source, end);
+			if (substitutionEnd !== void 0) {
+				end = substitutionEnd + 1;
+				continue;
+			}
+		}
+		const prev = source[end - 1];
+		if (ch === ")") break;
+		if (isCommandSeparator(source, end)) break;
+		if (ch === "\n" && prev !== "\\" && !foldedYamlRange) break;
+		end += 1;
+	}
+	return end;
+}
+function isDelimitedCommandContext(source, start, foldedYamlRanges, markdownFencedCodeRanges) {
+	return findInlineCodeSpanEnd(source, start) !== void 0 || findEnclosingLineQuoteEnd(source, start) !== void 0 || findContainingRange(foldedYamlRanges, start) !== void 0 || findContainingRange(markdownFencedCodeRanges, start) !== void 0;
+}
+function findOptionRename(command, index) {
+	return OPTION_RENAMES.find(([from]) => command.startsWith(from, index) && isOptionBoundaryChar(command[index - 1]) && isOptionBoundaryChar(command[index + from.length]));
+}
+function replaceOptionsInCommand(command) {
+	let updated = "";
+	let index = 0;
+	let quote = null;
+	while (index < command.length) {
+		const ch = command[index];
+		if (quote !== null) {
+			if (quote.char === "\"" && startsCommandSubstitution(command, index)) {
+				const substitutionEnd = findCommandSubstitutionEnd(command, index);
+				if (substitutionEnd !== void 0) {
+					updated += "$(";
+					updated += replaceAll(command.slice(index + 2, substitutionEnd));
+					updated += ")";
+					index = substitutionEnd + 1;
+					continue;
+				}
+			}
+			updated += ch;
+			if (quote.escaped) {
+				if (ch === "\\" && command[index + 1] === quote.char) {
+					index += 1;
+					updated += command[index];
+					quote = null;
+				}
+			} else if (ch === "\\" && quote.char === "\"" && index + 1 < command.length) {
+				index += 1;
+				updated += command[index];
+			} else if (ch === quote.char) quote = null;
+			index += 1;
+			continue;
+		}
+		if (ch === "\\" && command[index + 1] === "\"") {
+			quote = {
+				char: "\"",
+				escaped: true
+			};
+			updated += ch;
+			index += 1;
+			updated += command[index];
+			index += 1;
+			continue;
+		}
+		if (ch === "'" || ch === "\"") {
+			quote = {
+				char: ch,
+				escaped: false
+			};
+			updated += ch;
+			index += 1;
+			continue;
+		}
+		if (startsCommandSubstitution(command, index)) {
+			const substitutionEnd = findCommandSubstitutionEnd(command, index);
+			if (substitutionEnd !== void 0) {
+				updated += "$(";
+				updated += replaceAll(command.slice(index + 2, substitutionEnd));
+				updated += ")";
+				index = substitutionEnd + 1;
+				continue;
+			}
+		}
+		const rename = findOptionRename(command, index);
+		if (rename) {
+			updated += rename[1];
+			index += rename[0].length;
+			continue;
+		}
+		updated += ch;
+		index += 1;
+	}
+	return updated;
+}
+function replaceOptionsInTailorCommands(source, foldedYamlRanges, requireDelimitedContext = false, markdownFencedCodeRanges) {
+	let updated = "";
+	let cursor = 0;
+	TAILOR_BINARY_PATTERN.lastIndex = 0;
+	for (;;) {
+		const match = TAILOR_BINARY_PATTERN.exec(source);
+		if (!match) break;
+		const start = match.index;
+		if (start < cursor) continue;
+		if (requireDelimitedContext && !isDelimitedCommandContext(source, start, foldedYamlRanges, markdownFencedCodeRanges)) {
+			TAILOR_BINARY_PATTERN.lastIndex = start + match[0].length;
+			continue;
+		}
+		const end = findTailorCommandEnd(source, start, foldedYamlRanges, markdownFencedCodeRanges);
+		updated += source.slice(cursor, start);
+		updated += replaceOptionsInCommand(source.slice(start, end));
+		cursor = end;
+		TAILOR_BINARY_PATTERN.lastIndex = end;
+	}
+	return updated + source.slice(cursor);
+}
+function replaceAll(value, parseFoldedYaml = false, requireDelimitedContext = false, parseMarkdownFencedCode = false) {
+	const updated = value.replace(COMMAND_PATTERN, (match, _prefix, cmd) => `${match.slice(0, -cmd.length)}${COMMAND_MAP.get(cmd) ?? cmd}`);
+	return replaceOptionsInTailorCommands(updated, parseFoldedYaml ? findFoldedYamlRanges(updated) : void 0, requireDelimitedContext, parseMarkdownFencedCode ? findMarkdownFencedCodeRanges(updated) : void 0);
+}
+function transformText(source, filePath) {
+	const ext = path.extname(filePath).toLowerCase();
+	const isYaml = ext === ".yml" || ext === ".yaml";
+	const isMarkdown = ext === ".md";
+	const updated = replaceAll(source, isYaml, isMarkdown, isMarkdown);
 	return updated === source ? null : updated;
 }
 function transformPackageJson(source) {
@@ -35,20 +397,17 @@ function transformPackageJson(source) {
 }
 /**
 * Apply v2 CLI naming conventions: multi-word commands collapse into a single
-* word (`crash-report` → `crashreport`). Optional `@version` pins on the binary
-* (`tailor-sdk@latest`) are preserved.
+* word (`crash-report` → `crashreport`), and legacy option spellings are
+* rewritten to kebab-case (`--machineuser` → `--machine-user`). Optional
+* `@version` pins on the binary (`tailor-sdk@latest`) are preserved.
 *
-* Long options (`--executionId`, `--executorName`, `--jobId`) and the
-* positional argument keys with the same names are intentionally not rewritten:
-* those tokens are positional in the SDK CLI and never appear as long flags in
-* user scripts, so a transform here would have no real-world target.
 * @param source - File contents
 * @param filePath - Absolute path to the file (used to dispatch package.json vs text)
 * @returns Transformed source or null when nothing matched.
 */
 function transform(source, filePath) {
 	if (path.extname(filePath).toLowerCase() === ".json") return transformPackageJson(source);
-	return transformText(source);
+	return transformText(source, filePath);
 }
 //#endregion
 export { transform as default };

package/dist/codemods/v2/plugin-cli-import/scripts/transform.js

@@ -0,0 +1,70 @@
+import { Lang, parse } from "@ast-grep/napi";
+//#region codemods/v2/plugin-cli-import/scripts/transform.ts
+const CLI_MODULE = "@tailor-platform/sdk/cli";
+/** Deprecated plugin re-exports from `@tailor-platform/sdk/cli` and their dedicated subpaths. */
+const PLUGIN_SUBPATHS = {
+	kyselyTypePlugin: "@tailor-platform/sdk/plugin/kysely-type",
+	enumConstantsPlugin: "@tailor-platform/sdk/plugin/enum-constants",
+	fileUtilsPlugin: "@tailor-platform/sdk/plugin/file-utils",
+	seedPlugin: "@tailor-platform/sdk/plugin/seed"
+};
+function* iterateImportSpecs(importStmt) {
+	const specs = importStmt.findAll({ rule: { kind: "import_specifier" } });
+	for (const spec of specs) {
+		const idents = spec.children().filter((c) => c.kind() === "identifier");
+		if (idents.length === 0) continue;
+		yield {
+			importedName: idents[0].text(),
+			text: spec.text()
+		};
+	}
+}
+/** True for `import type { ... }` (statement-level `type`), not inline `{ type x }`. */
+function isTypeOnlyImport(importStmt) {
+	return importStmt.children().some((c) => c.kind() === "type");
+}
+/** True when the import has a default binding or a `* as x` namespace binding. */
+function hasNonNamedBinding(importStmt) {
+	const clause = importStmt.children().find((c) => c.kind() === "import_clause");
+	if (!clause) return false;
+	return clause.children().some((c) => c.kind() === "identifier" || c.kind() === "namespace_import");
+}
+/**
+* Rewrite deprecated plugin re-export imports from `@tailor-platform/sdk/cli`
+* to their dedicated plugin subpaths.
+*
+* Plugin specifiers are split into one `import { plugin } from "<subpath>"`
+* statement each; any non-plugin specifiers stay on the original `/cli`
+* import. A statement-level `import type` is carried over to every generated
+* line. `/cli` imports without plugin specifiers are left untouched.
+* @param source - File contents
+* @param filePath - Absolute path to the file (kept for the runner signature)
+* @returns Transformed source or null when nothing matched.
+*/
+function transform(source, _filePath) {
+	if (!source.includes(CLI_MODULE)) return null;
+	const root = parse(source.includes("</") || source.includes("/>") ? Lang.Tsx : Lang.TypeScript, source).root();
+	const edits = [];
+	const importStmts = root.findAll({ rule: {
+		kind: "import_statement",
+		has: {
+			kind: "string",
+			regex: `^["']${CLI_MODULE}["']$`
+		}
+	} });
+	for (const importStmt of importStmts) {
+		if (hasNonNamedBinding(importStmt)) continue;
+		const keyword = isTypeOnlyImport(importStmt) ? "import type" : "import";
+		const pluginSpecs = [];
+		const otherSpecs = [];
+		for (const spec of iterateImportSpecs(importStmt)) (Object.hasOwn(PLUGIN_SUBPATHS, spec.importedName) ? pluginSpecs : otherSpecs).push(spec);
+		if (pluginSpecs.length === 0) continue;
+		const lines = pluginSpecs.map((s) => `${keyword} { ${s.text} } from "${PLUGIN_SUBPATHS[s.importedName]}";`).toSorted();
+		if (otherSpecs.length > 0) lines.unshift(`${keyword} { ${otherSpecs.map((s) => s.text).join(", ")} } from "${CLI_MODULE}";`);
+		edits.push(importStmt.replace(lines.join("\n")));
+	}
+	if (edits.length === 0) return null;
+	return root.commitEdits(edits);
+}
+//#endregion
+export { transform as default };

package/dist/codemods/v2/tailordb-namespace/scripts/transform.js

@@ -6,10 +6,11 @@ const MEMBER_GROUP = [
 ].join("|");
 const PATTERN = new RegExp(String.raw`\bTailordb\.(${MEMBER_GROUP})\b`, "g");
 /**
-* Rewrite references to the deprecated capital-cased `Tailordb` ambient
-* namespace to the new lowercase `tailordb` namespace. The capital-cased
-* namespace was inherited from `@tailor-platform/function-types`; the SDK
-* keeps it as a `@deprecated` alias in v1 and removes it in v2.
+* Rewrite references to the capital-cased `Tailordb` ambient namespace to the
+* lowercase `tailordb` namespace. The capital-cased namespace was inherited
+* from `@tailor-platform/function-types`; the SDK kept it as a `@deprecated`
+* alias in v1 and removed it in v2, leaving only the lowercase `tailordb.*`
+* namespace exposed by `@tailor-platform/sdk/runtime/globals`.
 *
 * Only the known type-only members (`QueryResult`, `CommandType`, `Client`)
 * are rewritten so that unrelated user-defined symbols sharing the

package/dist/index.js

@@ -7,7 +7,6 @@ import { arg, defineCommand, runMain } from "politty";
 import { z } from "zod";
 import { gte, lt, valid } from "semver";
 import * as fs from "node:fs";
-import { glob } from "node:fs/promises";
 import chalk from "chalk";
 import { structuredPatch } from "diff";
 import picomatch from "picomatch";
@@ -23,6 +22,14 @@ const allCodemods = [
 		scriptPath: "v2/define-generators-to-plugins/scripts/transform.js",
 		legacyPatterns: ["defineGenerators"]
 	},
+	{
+		id: "v2/plugin-cli-import",
+		name: "@tailor-platform/sdk/cli plugin imports → dedicated subpaths",
+		description: "Rewrite deprecated plugin re-export imports (kyselyTypePlugin, enumConstantsPlugin, fileUtilsPlugin, seedPlugin) from `@tailor-platform/sdk/cli` to their dedicated plugin subpaths",
+		since: "1.0.0",
+		until: "2.0.0",
+		scriptPath: "v2/plugin-cli-import/scripts/transform.js"
+	},
 	{
 		id: "v2/test-run-arg-input",
 		name: "function test-run --arg input unwrap",
@@ -67,7 +74,7 @@ const allCodemods = [
 	{
 		id: "v2/apply-to-deploy",
 		name: "tailor-sdk apply → tailor-sdk deploy",
-		description: "Rewrite `tailor-sdk apply` invocations in package.json scripts, shell scripts, CI configs, and docs to the v2-recommended `tailor-sdk deploy` alias",
+		description: "Rewrite `tailor-sdk apply` invocations in package.json scripts, shell scripts, CI configs, and docs to the canonical v2 `tailor-sdk deploy` command",
 		since: "1.0.0",
 		until: "2.0.0",
 		scriptPath: "v2/apply-to-deploy/scripts/transform.js",
@@ -79,8 +86,8 @@ const allCodemods = [
 	},
 	{
 		id: "v2/cli-rename",
-		name: "v2 CLI rename (single-word commands)",
-		description: "Rewrite `tailor-sdk crash-report` invocations to the v2 single-word `tailor-sdk crashreport` form across package.json scripts, shell scripts, CI configs, and docs",
+		name: "v2 CLI rename",
+		description: "Rewrite `tailor-sdk crash-report` to `tailor-sdk crashreport` and `--machineuser` to `--machine-user` across package.json scripts, shell scripts, CI configs, and docs",
 		since: "1.0.0",
 		until: "2.0.0",
 		scriptPath: "v2/cli-rename/scripts/transform.js",
@@ -88,7 +95,8 @@ const allCodemods = [
 			"**/package.json",
 			"**/*.{sh,bash,zsh,yml,yaml}",
 			"**/*.md"
-		]
+		],
+		legacyPatterns: ["tailor-sdk crash-report", "--machineuser"]
 	},
 	{
 		id: "v2/auth-invoker-unwrap",
@@ -102,7 +110,7 @@ const allCodemods = [
 	{
 		id: "v2/tailordb-namespace",
 		name: "Tailordb → tailordb (lowercase ambient namespace)",
-		description: "Rewrite references to the deprecated capital-cased `Tailordb` ambient namespace (`Tailordb.QueryResult`, `Tailordb.CommandType`, `Tailordb.Client`, `typeof Tailordb.Client`) to the new lowercase `tailordb.*` namespace re-published by the SDK in place of `@tailor-platform/function-types`.",
+		description: "Rewrite references to the removed capital-cased `Tailordb` ambient namespace (`Tailordb.QueryResult`, `Tailordb.CommandType`, `Tailordb.Client`, `typeof Tailordb.Client`) to the lowercase `tailordb.*` namespace exposed by `@tailor-platform/sdk/runtime/globals`.",
 		since: "1.0.0",
 		until: "2.0.0",
 		scriptPath: "v2/tailordb-namespace/scripts/transform.js",
@@ -139,6 +147,28 @@ const EXCLUDE_DIRS = new Set([
 	"dist",
 	".git"
 ]);
+const ALLOWED_DOT_DIRS = new Set([".github", ".circleci"]);
+function shouldSkipDirectory(name) {
+	return EXCLUDE_DIRS.has(name) || name.startsWith(".") && !ALLOWED_DOT_DIRS.has(name);
+}
+async function* walkFiles(root, relativeDir = "") {
+	const absoluteDir = path.join(root, relativeDir);
+	let entries;
+	try {
+		entries = await fs.promises.readdir(absoluteDir, { withFileTypes: true });
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		const relative = relativeDir ? path.join(relativeDir, entry.name) : entry.name;
+		if (entry.isDirectory()) {
+			if (shouldSkipDirectory(entry.name)) continue;
+			yield* walkFiles(root, relative);
+			continue;
+		}
+		if (entry.isFile()) yield relative;
+	}
+}
 /**
 * Print a colorized unified diff for a single file to stderr.
 * @param filePath - Absolute path to the file
@@ -168,6 +198,13 @@ async function loadTransform(scriptPath) {
 	if (typeof mod.default !== "function") throw new Error(`Transform at ${scriptPath} does not have a default export function`);
 	return mod.default;
 }
+function legacyPatternWarnings(relative, content, transforms) {
+	return transforms.flatMap((lt) => {
+		const found = lt.legacyPatterns.filter((p) => content.includes(p));
+		if (found.length === 0) return [];
+		return [`${relative}: contains ${found.join(", ")} but was not migrated automatically (rule: ${lt.id}). Manual migration may be needed.`];
+	});
+}
 /**
 * Run multiple codemods on a project directory using in-memory chaining.
 * Each file is processed through all transforms whose filePatterns match it.
@@ -186,23 +223,20 @@ async function runCodemods(codemods, targetPath, dryRun) {
 		loaded.push({
 			id: codemod.id,
 			transform: await loadTransform(scriptPath),
-			matches: picomatch(patterns),
+			matches: picomatch(patterns, { dot: true }),
 			legacyPatterns: codemod.legacyPatterns ?? []
 		});
 	}
-	const allPatterns = /* @__PURE__ */ new Set();
-	for (const { codemod } of codemods) for (const p of codemod.filePatterns ?? DEFAULT_FILE_PATTERNS) allPatterns.add(p);
 	const filesModified = [];
 	const warnings = [];
 	const appliedCodemodIds = /* @__PURE__ */ new Set();
 	const seen = /* @__PURE__ */ new Set();
-	for (const pattern of allPatterns) for await (const relative of glob(pattern, {
-		cwd: targetPath,
-		exclude: (name) => EXCLUDE_DIRS.has(name)
-	})) {
+	for await (const relative of walkFiles(targetPath)) {
 		const absolute = path.resolve(targetPath, relative);
 		if (seen.has(absolute)) continue;
 		seen.add(absolute);
+		const matchedTransforms = loaded.filter((lt) => lt.matches(relative));
+		if (matchedTransforms.length === 0) continue;
 		let original;
 		try {
 			original = await fs.promises.readFile(absolute, "utf-8");
@@ -210,10 +244,7 @@ async function runCodemods(codemods, targetPath, dryRun) {
 			continue;
 		}
 		let current = original;
-		const matchedTransforms = [];
-		for (const lt of loaded) {
-			if (!lt.matches(relative)) continue;
-			matchedTransforms.push(lt);
+		for (const lt of matchedTransforms) {
 			const result = await lt.transform(current, absolute);
 			if (result != null) {
 				current = result;
@@ -224,10 +255,8 @@ async function runCodemods(codemods, targetPath, dryRun) {
 			filesModified.push(absolute);
 			if (dryRun) printDiff(absolute, original, current);
 			else await fs.promises.writeFile(absolute, current, "utf-8");
-		} else for (const lt of matchedTransforms) {
-			const found = lt.legacyPatterns.filter((p) => original.includes(p));
-			if (found.length > 0) warnings.push(`${relative}: contains ${found.join(", ")} but was not migrated automatically (rule: ${lt.id}). Manual migration may be needed.`);
 		}
+		warnings.push(...legacyPatternWarnings(relative, current, matchedTransforms));
 	}
 	return {
 		changed: filesModified.length > 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk-codemod",
-  "version": "0.2.7",
+  "version": "0.3.0-next.1",
   "description": "Codemod runner for Tailor Platform SDK upgrades",
   "license": "MIT",
   "repository": {
@@ -22,15 +22,15 @@
     "pathe": "2.0.3",
     "picomatch": "4.0.4",
     "pkg-types": "2.3.1",
-    "politty": "0.5.1",
-    "semver": "7.8.3",
+    "politty": "0.6.0",
+    "semver": "7.8.4",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@types/node": "24.13.1",
+    "@types/node": "24.13.2",
     "@types/picomatch": "4.0.3",
     "@types/semver": "7.7.1",
-    "oxlint": "1.68.0",
+    "oxlint": "1.69.0",
     "tsdown": "0.22.2",
     "typescript": "5.9.3",
     "vitest": "4.1.8"