@trebired/code-discipline 0.1.0 → 1.0.0

package/CHANGELOG.md

@@ -2,19 +2,23 @@
 
 All notable changes to `@trebired/code-discipline` will be documented here.
 
-This project follows semantic versioning once published.
+## 1.0.0
 
-## Unreleased
-
-- established `@trebired/code-discipline` as the package identity
-- added `checkCodeDiscipline()` with `maxFileLines` and `folderizeCompoundFiles` rules
-- added the `code-discipline check` and `code-discipline sync` CLI commands
-- kept `syncImports()` as the package's mutating import-sync feature
-- changed the project license to `AGPL-3.0-only`
-- reorganized the source and test layout into smaller responsibility-focused modules
+- introduced the breaking `enabled` / `stop` / `fix` rule model across the package
+- removed `severity` from discipline and sync-import config
+- removed suffix-based folderization and replaced it with structural folder grouping
+- removed `suffixes` from `folderizeCompoundFiles`
+- removed nested `syncImports.imports`
+- removed `rewrite` as a sync config option in favor of `syncImports.fix`
+- replaced `keepRelative` with `allowRelative`
+- made `check` fully read-only
+- made `sync` mutate imports and `tsconfig.json` only when `syncImports.fix` is `true`
+- added explicit `fix` support for folderization moves and affected import rewrites
+- added `fixCodeDiscipline()` as the structural mutation API
+- added blocking-or-warning behavior through `stop` instead of severity levels
+- bumped the package to `1.0.0` for the config and API cleanup
 
 ## 0.1.0
 
 - initial public release
 - added source scanning, alias generation, tsconfig path syncing, and in-place import rewriting
-- added configurable alias strategies, keep-relative policies, and restrained logging adapters

package/README.md

@@ -1,10 +1,8 @@
 # @trebired/code-discipline
 
-Configurable codebase discipline checks and import syncing for Bun and Node.js projects.
+Configurable repository discipline checks, structural fixes, and import syncing for Bun and Node.js projects.
 
-`@trebired/code-discipline` scans a configured source tree, runs project-level discipline rules, and can also keep TypeScript path aliases plus source imports aligned in one package.
-
-The package is intentionally focused. It helps with repository structure rules, file-shape rules, and import hygiene. It does not try to be a full linter, formatter, or build system.
+`@trebired/code-discipline` is intentionally focused. It helps you keep a source tree disciplined without turning into a full linter, formatter, or build system.
 
 ## Install
 
@@ -14,59 +12,105 @@ Runtime support: Bun 1+ and Node.js 18+.
 npm install @trebired/code-discipline
 ```
 
-## Quick Start
-
-```ts
-import { checkCodeDiscipline } from "@trebired/code-discipline";
-
-const result = await checkCodeDiscipline({
-  projectRoot: "/repo",
-  sourceRoot: "src",
-  rules: {
-    maxFileLines: {
-      enabled: true,
-      max: 500,
-    },
-    folderizeCompoundFiles: {
-      enabled: true,
-      suffixes: ["start", "service"],
-      separators: ["_", "-"],
-    },
-  },
-});
+## Why This Package
 
-if (!result.ok) {
-  console.error(result.violations);
-  process.exit(1);
-}
-```
+Some repository rules are not really single-file lint rules. They are about the shape of the tree:
 
-The first public slice is intentionally small:
+- files growing too large
+- compound filenames that want to become folders
+- alias drift between `tsconfig.json` and source imports
+- blocking or warning on repository policy in CI or startup flows
 
-- `checkCodeDiscipline()`
-- `syncImports()`
-- `defineCodeDisciplineConfig()`
-- `loadCodeDisciplineConfig()`
+That is the lane of this package.
 
-If you want repo-driven usage instead of embedding the API directly, use the CLI with a top-level config file:
+## Commands
 
 ```sh
 code-discipline check
 code-discipline sync
+code-discipline fix
+```
+
+Command responsibilities stay clean:
+
+- `check`: read-only validation and logging
+- `sync`: import and `tsconfig.json` synchronization only
+- `fix`: explicit folderization moves only
+
+Both `sync` and `fix` are gated by rule config. They do not mutate anything unless their rule has `fix: true`.
+
+## Config
+
+Every rule uses the same control model:
+
+```txt
+enabled
+= whether the rule runs
+
+stop
+= whether violations fail the result / exit non-zero
+
+fix
+= whether explicit mutation commands may change files
 ```
 
-## What This Package Checks
+Example `code-discipline.config.json`:
 
-The first discipline layer is intentionally narrow:
+```json
+{
+  "sourceRoot": "src",
+  "sourceExtensions": [
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx"
+  ],
+  "excludeDirs": [
+    "node_modules",
+    "dist",
+    ".vite"
+  ],
+  "rules": {
+    "maxFileLines": {
+      "enabled": true,
+      "stop": true,
+      "max": 500
+    },
+    "folderizeCompoundFiles": {
+      "enabled": true,
+      "stop": true,
+      "fix": false,
+      "separators": [
+        "_",
+        "-"
+      ]
+    },
+    "syncImports": {
+      "enabled": true,
+      "stop": true,
+      "fix": true,
+      "alias": {
+        "strategy": "relative-path-slug"
+      },
+      "allowRelative": [
+        "./"
+      ]
+    }
+  }
+}
+```
 
-- `maxFileLines`
-- `folderizeCompoundFiles`
+Breaking cleanup in `1.0.0`:
 
-`maxFileLines` reports files whose physical line count exceeds a configured threshold.
+- `severity` was removed
+- `suffixes` was removed
+- `keepRelative` was replaced by `allowRelative`
+- nested `syncImports.imports` was removed
+- `rewrite` was removed as a config flag because `fix` controls mutation
 
-`folderizeCompoundFiles` reports names such as `user_start.ts` or `user-start.ts` that could be grouped into a more structured path such as `user/start.ts`.
+## Checks
 
-Example:
+`checkCodeDiscipline()` is read-only. It never moves files, rewrites imports, or updates `tsconfig.json`.
 
 ```ts
 import { checkCodeDiscipline } from "@trebired/code-discipline";
@@ -76,29 +120,38 @@ const result = await checkCodeDiscipline({
   rules: {
     maxFileLines: {
       enabled: true,
+      stop: true,
       max: 500,
-      severity: "error",
     },
     folderizeCompoundFiles: {
       enabled: true,
-      suffixes: ["start"],
+      stop: false,
       separators: ["_", "-"],
-      severity: "warn",
+    },
+    syncImports: {
+      enabled: true,
+      stop: true,
+      fix: false,
+      alias: {
+        strategy: "relative-path-slug",
+      },
+      allowRelative: ["./"],
     },
   },
 });
 ```
 
-The result shape stays simple:
+Result shape:
 
 ```ts
 {
   ok: boolean;
   warnings: number;
-  errors: number;
+  failures: number;
   violations: Array<{
-    rule: "max-file-lines" | "folderize-compound-files";
-    severity: "warn" | "error";
+    rule: "max-file-lines" | "folderize-compound-files" | "sync-imports";
+    stop: boolean;
+    fix: boolean;
     filePath: string;
     message: string;
     details: Record<string, unknown>;
@@ -107,135 +160,76 @@ The result shape stays simple:
 }
 ```
 
-Checks are read-only. They report problems and let the caller decide whether to fail startup, fail CI, or only warn.
+## Folderization
 
-## CLI And Config
+`folderizeCompoundFiles` is structural. It no longer depends on configured suffix lists.
 
-The CLI is meant for repository-owned discipline rules:
+Same-directory groups:
 
-```sh
-code-discipline check
-code-discipline sync
+```txt
+src/api/user_route.ts
+src/api/user_schema.ts
+src/api/user_controller.ts
 ```
 
-Both commands accept `--config <path>`. When that flag is omitted, the CLI looks for `code-discipline.config.json` in the current working directory.
+suggest:
 
-Example config:
+```txt
+src/api/user/route.ts
+src/api/user/schema.ts
+src/api/user/controller.ts
+```
 
-```json
-{
-  "sourceRoot": "src",
-  "rules": {
-    "maxFileLines": {
-      "enabled": true,
-      "max": 500
-    },
-    "folderizeCompoundFiles": {
-      "enabled": true,
-      "suffixes": ["start", "service"],
-      "separators": ["_", "-"]
-    },
-    "syncImports": {
-      "alias": {
-        "strategy": "relative-path-slug"
-      }
-    }
-  }
-}
+Repeated folder-prefix files are also detected:
+
+```txt
+src/api/user/user_route.ts
 ```
 
-`check` is read-only. It reports violations and exits non-zero when any error-severity rule fails.
+suggests:
 
-`sync` is the mutating import-alignment command. It updates `compilerOptions.paths` and rewrites eligible source imports.
+```txt
+src/api/user/route.ts
+```
 
-In practice:
+`check` only reports these candidates.
 
-- use JSON config plus the CLI when the rules belong to the repo
-- use the API when another tool wants to control configuration or reporting dynamically
+`fix` may apply them only when `folderizeCompoundFiles.fix` is `true`, and it rewrites affected relative imports after the move.
 
 ## Import Sync
 
-`syncImports()` remains a first-class part of the package. It scans source files, generates aliases, preserves still-valid alias ids, writes stable `compilerOptions.paths` output, and rewrites eligible relative imports to those aliases.
+`syncImports()` and `code-discipline sync` use one flat `syncImports` config.
 
 ```ts
 import { syncImports } from "@trebired/code-discipline";
 
 const result = await syncImports({
   projectRoot: "/repo",
-  sourceRoot: "src",
-  tsconfigPath: "/repo/tsconfig.json",
-});
-```
-
-Default behavior:
-
-- `sourceRoot: "src"`
-- `tsconfigPath: "<projectRoot>/tsconfig.json"`
-- `sourceExtensions: [".ts", ".tsx", ".js", ".jsx"]`
-- `excludeDirs: ["node_modules", "dist", ".vite"]`
-- `imports.rewrite: true`
-- `imports.keepRelative: ["./"]`
-- `alias.prefix: "#"`
-- `alias.strategy: "random"`
-- `alias.randomLength: 12`
-
-By default, same-directory imports such as `./local` stay relative. Imports that walk upward, such as `../shared/util`, are eligible for rewrite when they resolve to a file under the configured source root.
-
-Alias strategies:
-
-- `"random"`
-- `"relative-path-slug"`
-- `"relative-path-hash"`
-- custom function
-
-Example custom strategy:
-
-```ts
-await syncImports({
-  projectRoot: "/repo",
+  fix: true,
   alias: {
-    strategy(input) {
-      return `@${input.relativeFromSourceRoot.replace(/\//g, "__")}`;
-    },
+    strategy: "relative-path-slug",
   },
+  allowRelative: ["./"],
 });
 ```
 
-If a custom strategy returns an invalid id or a duplicate id, the package fails clearly instead of guessing a fallback.
+Behavior:
 
-## Why This Package
-
-Many repository rules are awkward in a single-file linter pass because they are really about the shape of a source tree, not only one file at a time.
-
-This package is a better fit when you want checks such as:
+- `check` reports import-policy drift in read-only mode
+- `sync` rewrites imports and updates `tsconfig.json` only when `syncImports.fix` is `true`
+- `allowRelative: ["./"]` keeps same-folder relative imports
+- upward relative imports can be reported or rewritten through the configured alias policy
 
-- file-size limits across a configured source root
-- filename patterns that imply a cleaner folder layout
-- path alias synchronization across many files
-- startup, CI, or pre-build gates based on repository conventions
+## Logging
 
-It is intentionally repo-oriented. The package does one lane of work: codebase discipline plus import alignment.
+When you provide a logger, discipline results are emitted through it. Trebired-style loggers are supported directly, and the package falls back safely when no logger is provided.
 
-## Current API
+## Public API
 
 - `checkCodeDiscipline()`
+- `fixCodeDiscipline()`
+- `syncImports()`
 - `defineCodeDisciplineConfig()`
 - `loadCodeDisciplineConfig()`
-- `syncImports()`
-- `scanSourceFiles()`
-- `syncTsconfigAliases()`
-- `rewriteSourceImports()`
-- `resolveRelativeImport()`
-- `createRandomAlias()`
-- `createRelativePathHashAlias()`
-- `createRelativePathSlugAlias()`
-
-The package also exports the public TypeScript types for options, results, violations, alias strategies, keep-relative callbacks, log events, and source scan rows.
-
-## What This Package Does Not Do
-
-- it does not build or compile TypeScript
-- it does not move files automatically for folderization violations
-- it does not rewrite emitted build output
-- it does not depend on ESLint
-- it does not assume a framework-specific runtime layout
+
+The package also exports the public TypeScript types for rule config, results, violations, alias strategies, logging adapters, and source scan rows.

package/dist/checks/fix-folderization.d.ts

@@ -0,0 +1,17 @@
+import type { CodeDisciplineViolation, FixCodeDisciplineResult, NormalizedCheckCodeDisciplineOptions } from "./types.js";
+import type { ScannedSourceFile } from "../imports/types.js";
+import type { NormalizedSyncImportsLogger } from "../shared/logging-types.js";
+type PlannedMove = {
+    fromAbsolutePath: string;
+    fromRelativePath: string;
+    toAbsolutePath: string;
+    toRelativePath: string;
+};
+declare function createFolderizationViolation(filePath: string, suggestedPath: string, options: NormalizedCheckCodeDisciplineOptions, details: Record<string, unknown>): CodeDisciplineViolation;
+declare function buildMovePlan(sourceFiles: ScannedSourceFile[], options: NormalizedCheckCodeDisciplineOptions): {
+    moves: PlannedMove[];
+    violations: CodeDisciplineViolation[];
+};
+declare function fixFolderization(sourceFiles: ScannedSourceFile[], options: NormalizedCheckCodeDisciplineOptions, logger: NormalizedSyncImportsLogger): Promise<FixCodeDisciplineResult>;
+export { buildMovePlan, createFolderizationViolation, fixFolderization };
+//# sourceMappingURL=fix-folderization.d.ts.map

package/dist/checks/fix-folderization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-folderization.d.ts","sourceRoot":"","sources":["../../src/checks/fix-folderization.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACrC,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAO9E,KAAK,WAAW,GAAG;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,iBAAS,4BAA4B,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,oCAAoC,EAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,uBAAuB,CAUzB;AAED,iBAAS,aAAa,CACpB,WAAW,EAAE,iBAAiB,EAAE,EAChC,OAAO,EAAE,oCAAoC,GAC5C;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,UAAU,EAAE,uBAAuB,EAAE,CAAA;CAAE,CAqBjE;AAsKD,iBAAe,gBAAgB,CAC7B,WAAW,EAAE,iBAAiB,EAAE,EAChC,OAAO,EAAE,oCAAoC,EAC7C,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAyElC;AAED,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/checks/fix-folderization.js

@@ -0,0 +1,223 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { applyTextReplacements, collectModuleSpecifiers } from "../imports/module-specifiers.js";
+import { isRelativeImportSpecifier } from "../imports/resolve.js";
+import { FileConflictError, FixFailureError, RewriteFailureError } from "../shared/errors.js";
+import { ensureDotExtension, pathExists, stripKnownExtension, toPosixPath } from "../shared/utils.js";
+import { planFolderizeCompoundFiles } from "./rules/folderize-plan.js";
+function createFolderizationViolation(filePath, suggestedPath, options, details) {
+    return {
+        rule: "folderize-compound-files",
+        stop: options.rules.folderizeCompoundFiles.stop,
+        fix: options.rules.folderizeCompoundFiles.fix,
+        filePath,
+        message: `file can be grouped under ${suggestedPath}`,
+        suggestedPath,
+        details,
+    };
+}
+function buildMovePlan(sourceFiles, options) {
+    const candidates = planFolderizeCompoundFiles(sourceFiles, options);
+    const moves = candidates.map((candidate) => ({
+        fromAbsolutePath: candidate.absolutePath,
+        fromRelativePath: candidate.relativeFromProjectRoot,
+        toAbsolutePath: candidate.suggestedAbsolutePath,
+        toRelativePath: candidate.suggestedPath,
+    }));
+    const violations = candidates.map((candidate) => createFolderizationViolation(candidate.relativeFromProjectRoot, candidate.suggestedPath, options, {
+        mode: candidate.mode,
+        prefix: candidate.prefix,
+        remainder: candidate.remainder,
+        separator: candidate.separator,
+    }));
+    return { moves, violations };
+}
+function resolveRelativeFromInventory(specifier, sourceFilePath, sourceExtensions, knownFiles) {
+    if (!isRelativeImportSpecifier(specifier))
+        return null;
+    const basePath = path.resolve(path.dirname(sourceFilePath), specifier);
+    const exactCandidates = [basePath];
+    const fileCandidates = sourceExtensions.map((extension) => `${basePath}${ensureDotExtension(extension)}`);
+    const indexCandidates = sourceExtensions.map((extension) => path.join(basePath, `index${ensureDotExtension(extension)}`));
+    for (const candidate of [...exactCandidates, ...fileCandidates, ...indexCandidates]) {
+        if (knownFiles.has(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function formatRelativeSpecifier(originalSpecifier, fromAbsolutePath, toAbsolutePath, sourceExtensions) {
+    const hadExplicitExtension = sourceExtensions.some((extension) => originalSpecifier.toLowerCase().endsWith(extension.toLowerCase()));
+    let relativePath = toPosixPath(path.relative(path.dirname(fromAbsolutePath), toAbsolutePath));
+    if (!relativePath.startsWith("."))
+        relativePath = `./${relativePath}`;
+    if (hadExplicitExtension) {
+        return relativePath;
+    }
+    const withoutExtension = stripKnownExtension(relativePath, sourceExtensions);
+    const targetBasename = path.basename(toAbsolutePath);
+    const originalWithoutExtension = stripKnownExtension(originalSpecifier, sourceExtensions);
+    const originalUsesIndex = /(^|\/)index$/.test(originalWithoutExtension);
+    if (targetBasename.startsWith("index.") && !originalUsesIndex) {
+        return withoutExtension.replace(/\/index$/, "") || ".";
+    }
+    return withoutExtension;
+}
+async function planImportRewritesForFolderizationMoves(sourceFiles, moves, options) {
+    if (moves.length === 0) {
+        return {
+            rewrittenByPath: new Map(),
+            rewrittenFiles: 0,
+            rewrittenImports: 0,
+        };
+    }
+    const movedPaths = new Map(moves.map((move) => [move.fromAbsolutePath, move.toAbsolutePath]));
+    const knownFiles = new Set(sourceFiles.map((file) => file.absolutePath));
+    const rewrittenByPath = new Map();
+    let rewrittenFiles = 0;
+    let rewrittenImports = 0;
+    for (const file of sourceFiles) {
+        const originalText = await fs.readFile(file.absolutePath, "utf8");
+        const futureFilePath = movedPaths.get(file.absolutePath) ?? file.absolutePath;
+        const replacements = [];
+        try {
+            for (const occurrence of collectModuleSpecifiers(originalText, file.absolutePath)) {
+                if (!isRelativeImportSpecifier(occurrence.specifier))
+                    continue;
+                const resolvedTarget = resolveRelativeFromInventory(occurrence.specifier, file.absolutePath, options.sourceExtensions, knownFiles);
+                if (!resolvedTarget)
+                    continue;
+                const futureTargetPath = movedPaths.get(resolvedTarget) ?? resolvedTarget;
+                const sourceMoved = futureFilePath !== file.absolutePath;
+                const targetMoved = futureTargetPath !== resolvedTarget;
+                if (!sourceMoved && !targetMoved)
+                    continue;
+                replacements.push({
+                    start: occurrence.start,
+                    end: occurrence.end,
+                    value: formatRelativeSpecifier(occurrence.specifier, futureFilePath, futureTargetPath, options.sourceExtensions),
+                });
+            }
+        }
+        catch (error) {
+            throw new RewriteFailureError(file.relativeFromProjectRoot, error);
+        }
+        const next = applyTextReplacements(originalText, replacements);
+        if (next.count === 0)
+            continue;
+        rewrittenByPath.set(futureFilePath, next);
+        rewrittenFiles += 1;
+        rewrittenImports += next.count;
+    }
+    return { rewrittenByPath, rewrittenFiles, rewrittenImports };
+}
+async function validateMovePlan(moves) {
+    const seenTargets = new Set();
+    const movingFrom = new Set(moves.map((move) => move.fromAbsolutePath));
+    for (const move of moves) {
+        if (move.fromAbsolutePath === move.toAbsolutePath)
+            continue;
+        if (seenTargets.has(move.toAbsolutePath)) {
+            throw new FileConflictError(move.toRelativePath, {
+                reason: "duplicate-target",
+            });
+        }
+        seenTargets.add(move.toAbsolutePath);
+        if (movingFrom.has(move.toAbsolutePath))
+            continue;
+        if (await pathExists(move.toAbsolutePath)) {
+            throw new FileConflictError(move.toRelativePath, {
+                reason: "existing-target",
+            });
+        }
+    }
+}
+async function moveFiles(moves) {
+    let movedFiles = 0;
+    for (const move of moves) {
+        if (move.fromAbsolutePath === move.toAbsolutePath)
+            continue;
+        await fs.mkdir(path.dirname(move.toAbsolutePath), { recursive: true });
+        await fs.rename(move.fromAbsolutePath, move.toAbsolutePath);
+        movedFiles += 1;
+    }
+    return movedFiles;
+}
+async function removeEmptyDirectories(directories) {
+    const sorted = [...new Set(directories)].sort((left, right) => right.length - left.length);
+    for (const directoryPath of sorted) {
+        try {
+            await fs.rmdir(directoryPath);
+        }
+        catch {
+            // The directory still contains files, which is expected in many cases.
+        }
+    }
+}
+async function fixFolderization(sourceFiles, options, logger) {
+    const { moves, violations } = buildMovePlan(sourceFiles, options);
+    const warnings = violations.filter((violation) => !violation.stop).length;
+    const failures = violations.length - warnings;
+    if (!options.rules.folderizeCompoundFiles.enabled || moves.length === 0) {
+        logger.info("fix-folderization-unchanged", "no folderization moves required", {
+            moves: 0,
+        });
+        return {
+            ok: true,
+            moved_files: 0,
+            rewritten_files: 0,
+            rewritten_imports: 0,
+            warnings,
+            failures,
+            violations,
+        };
+    }
+    if (!options.rules.folderizeCompoundFiles.fix) {
+        logger.warn("fix-folderization-disabled", "folderization fix is disabled", {
+            candidates: moves.length,
+        });
+        return {
+            ok: failures === 0,
+            moved_files: 0,
+            rewritten_files: 0,
+            rewritten_imports: 0,
+            warnings,
+            failures,
+            violations,
+        };
+    }
+    await validateMovePlan(moves);
+    const sourceDirectories = moves.map((move) => path.dirname(move.fromAbsolutePath));
+    try {
+        const rewriteState = await planImportRewritesForFolderizationMoves(sourceFiles, moves, options);
+        const movedFiles = await moveFiles(moves);
+        for (const [filePath, next] of rewriteState.rewrittenByPath) {
+            await fs.writeFile(filePath, next.text);
+        }
+        await removeEmptyDirectories(sourceDirectories);
+        logger.success("fix-folderization-finished", `folderized files=${movedFiles} rewrittenImports=${rewriteState.rewrittenImports}`, {
+            movedFiles,
+            rewrittenFiles: rewriteState.rewrittenFiles,
+            rewrittenImports: rewriteState.rewrittenImports,
+        });
+        return {
+            ok: true,
+            moved_files: movedFiles,
+            rewritten_files: rewriteState.rewrittenFiles,
+            rewritten_imports: rewriteState.rewrittenImports,
+            warnings,
+            failures: 0,
+            violations,
+        };
+    }
+    catch (error) {
+        if (error instanceof FileConflictError || error instanceof RewriteFailureError) {
+            throw error;
+        }
+        throw new FixFailureError("Folderization fix failed", {
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+export { buildMovePlan, createFolderizationViolation, fixFolderization };
+//# sourceMappingURL=fix-folderization.js.map

package/dist/checks/fix-folderization.js.map

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