sheldonify 0.1.0

package/dist/config.js

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const CustomRuleSchema = z.object({
+    name: z.string(),
+    match: z.object({
+        extensions: z.array(z.string()).optional(),
+        patterns: z.array(z.string()).optional(),
+        regex: z.string().optional(),
+    }),
+    priority: z.number().optional(),
+});
+const ConfigFileSchema = z.object({
+    strategy: z.enum(['type', 'context', 'date', 'custom']).optional(),
+    depth: z.number().int().min(1).optional(),
+    protected: z.object({
+        useDefaults: z.boolean().optional(),
+        include: z.array(z.string()).optional(),
+        exclude: z.array(z.string()).optional(),
+    }).optional(),
+    typeStrategy: z.object({
+        extraMappings: z.record(z.string()).optional(),
+        categoryRenames: z.record(z.string()).optional(),
+    }).optional(),
+    contextStrategy: z.object({
+        extraKeywords: z.record(z.array(z.string())).optional(),
+    }).optional(),
+    dateStrategy: z.object({
+        dateSource: z.enum(['modified', 'created']).optional(),
+    }).optional(),
+    customRules: z.array(CustomRuleSchema).optional(),
+});
+const DEFAULTS = {
+    strategy: 'type',
+    depth: 1,
+    dryRun: false,
+    verbose: false,
+    jsonOutput: false,
+    targetDir: '.',
+    protected: {
+        useDefaults: true,
+        include: [],
+        exclude: [],
+    },
+    typeStrategy: {
+        extraMappings: {},
+        categoryRenames: {},
+    },
+    contextStrategy: {
+        extraKeywords: {},
+    },
+    dateStrategy: {
+        dateSource: 'modified',
+    },
+    customRules: [],
+};
+export async function loadConfig(targetDir, cliOptions) {
+    const configFile = await findAndParseConfig(targetDir, cliOptions.config);
+    const config = {
+        ...DEFAULTS,
+        targetDir: path.resolve(targetDir),
+        strategy: (cliOptions.strategy ?? configFile?.strategy ?? DEFAULTS.strategy),
+        depth: cliOptions.depth ? parseInt(cliOptions.depth, 10) : (configFile?.depth ?? DEFAULTS.depth),
+        dryRun: cliOptions.dryRun ?? DEFAULTS.dryRun,
+        verbose: cliOptions.verbose ?? DEFAULTS.verbose,
+        jsonOutput: cliOptions.json ?? DEFAULTS.jsonOutput,
+        protected: {
+            useDefaults: configFile?.protected?.useDefaults ?? DEFAULTS.protected.useDefaults,
+            include: configFile?.protected?.include ?? DEFAULTS.protected.include,
+            exclude: configFile?.protected?.exclude ?? DEFAULTS.protected.exclude,
+        },
+        typeStrategy: {
+            extraMappings: configFile?.typeStrategy?.extraMappings ?? DEFAULTS.typeStrategy.extraMappings,
+            categoryRenames: configFile?.typeStrategy?.categoryRenames ?? DEFAULTS.typeStrategy.categoryRenames,
+        },
+        contextStrategy: {
+            extraKeywords: configFile?.contextStrategy?.extraKeywords ?? DEFAULTS.contextStrategy.extraKeywords,
+        },
+        dateStrategy: {
+            dateSource: configFile?.dateStrategy?.dateSource ?? DEFAULTS.dateStrategy.dateSource,
+        },
+        customRules: configFile?.customRules ?? DEFAULTS.customRules,
+    };
+    return config;
+}
+async function findAndParseConfig(targetDir, explicitPath) {
+    const candidates = explicitPath
+        ? [path.resolve(explicitPath)]
+        : [
+            path.join(path.resolve(targetDir), 'sheldonify.config.json'),
+            path.join(homedir(), 'sheldonify.config.json'),
+        ];
+    for (const candidate of candidates) {
+        try {
+            const raw = await fs.readFile(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const validated = ConfigFileSchema.parse(parsed);
+            return validated;
+        }
+        catch (err) {
+            if (err instanceof z.ZodError) {
+                const issues = err.issues.map(i => `  ${i.path.join('.')}: ${i.message}`).join('\n');
+                throw new Error(`Invalid config file ${candidate}:\n${issues}`);
+            }
+            if (isNodeError(err) && err.code === 'ENOENT') {
+                continue;
+            }
+            if (explicitPath) {
+                throw new Error(`Failed to read config file ${candidate}: ${err}`);
+            }
+        }
+    }
+    return null;
+}
+function homedir() {
+    return process.env.HOME ?? process.env.USERPROFILE ?? '';
+}
+function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/duplicates.d.ts

@@ -0,0 +1,3 @@
+import { FileEntry, DuplicateGroup } from './types.js';
+export declare function findDuplicates(files: FileEntry[]): Promise<DuplicateGroup[]>;
+//# sourceMappingURL=duplicates.d.ts.map

package/dist/duplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.d.ts","sourceRoot":"","sources":["../src/duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAsB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAyDlF"}

package/dist/duplicates.js

@@ -0,0 +1,59 @@
+import { hashFile } from './utils/hash.js';
+export async function findDuplicates(files) {
+    // Phase 1: group by size — unique sizes can't be duplicates
+    const sizeGroups = new Map();
+    for (const file of files) {
+        if (file.isDirectory)
+            continue;
+        const group = sizeGroups.get(file.size);
+        if (group) {
+            group.push(file);
+        }
+        else {
+            sizeGroups.set(file.size, [file]);
+        }
+    }
+    const duplicateGroups = [];
+    // Phase 2: hash files that share a size
+    for (const group of sizeGroups.values()) {
+        if (group.length < 2)
+            continue;
+        const hashGroups = new Map();
+        for (const file of group) {
+            try {
+                const hash = await hashFile(file.absolutePath);
+                file.hash = hash;
+                const hg = hashGroups.get(hash);
+                if (hg) {
+                    hg.push(file);
+                }
+                else {
+                    hashGroups.set(hash, [file]);
+                }
+            }
+            catch {
+                // skip files we can't hash
+            }
+        }
+        for (const [hash, hashGroup] of hashGroups) {
+            if (hashGroup.length < 2)
+                continue;
+            // Keep the file with the shortest path; ties broken by earliest modification
+            const sorted = [...hashGroup].sort((a, b) => {
+                const pathDiff = a.relativePath.length - b.relativePath.length;
+                if (pathDiff !== 0)
+                    return pathDiff;
+                return a.modifiedAt.getTime() - b.modifiedAt.getTime();
+            });
+            const kept = sorted[0];
+            const dupes = sorted.slice(1);
+            duplicateGroups.push({
+                hash,
+                kept: kept.absolutePath,
+                duplicates: dupes.map(d => d.absolutePath),
+            });
+        }
+    }
+    return duplicateGroups;
+}
+//# sourceMappingURL=duplicates.js.map

package/dist/duplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.js","sourceRoot":"","sources":["../src/duplicates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAkB;IACrD,4DAA4D;IAC5D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW;YAAE,SAAS;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAqB,EAAE,CAAC;IAE7C,wCAAwC;IACxC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChC,IAAI,EAAE,EAAE,CAAC;oBACP,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAEnC,6EAA6E;YAC7E,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC1C,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;gBAC/D,IAAI,QAAQ,KAAK,CAAC;oBAAE,OAAO,QAAQ,CAAC;gBACpC,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACzD,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAE9B,eAAe,CAAC,IAAI,CAAC;gBACnB,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,YAAY;gBACvB,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/executor.d.ts

@@ -0,0 +1,3 @@
+import { MovePlan, SheldonifyConfig, ExecutionResult } from './types.js';
+export declare function executePlan(plan: MovePlan, config: SheldonifyConfig): Promise<ExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAiB,gBAAgB,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AAKxG,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,eAAe,CAAC,CAmF1B"}

package/dist/executor.js

@@ -0,0 +1,99 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { safeMove, ensureDir } from './utils/fs-helpers.js';
+import { generateUndoSh, generateUndoPs1 } from './undo-generator.js';
+import { generateIndex } from './index-generator.js';
+export async function executePlan(plan, config) {
+    const errors = [];
+    let operationsExecuted = 0;
+    let aborted = false;
+    const completedOps = [];
+    const onAbort = () => { aborted = true; };
+    process.on('SIGINT', onAbort);
+    process.on('SIGTERM', onAbort);
+    try {
+        // Create all target directories
+        const dirs = new Set();
+        for (const op of plan.operations) {
+            dirs.add(path.dirname(op.destination));
+        }
+        for (const dir of dirs) {
+            await ensureDir(dir);
+        }
+        // Execute moves with progress
+        const total = plan.operations.length;
+        for (const op of plan.operations) {
+            if (aborted) {
+                errors.push('Aborted by user (SIGINT). Partial undo script generated.');
+                break;
+            }
+            try {
+                await safeMove(op.source, op.destination);
+                completedOps.push(op);
+                operationsExecuted++;
+                if (!config.jsonOutput && total > 10 && operationsExecuted % 50 === 0) {
+                    process.stderr.write(`  Moving files... ${operationsExecuted}/${total}\r`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                errors.push(`Failed to move ${op.source} → ${op.destination}: ${msg}`);
+            }
+        }
+        if (!config.jsonOutput && total > 10) {
+            process.stderr.write('\n');
+        }
+        // Write duplicate metadata sidecars
+        if (!aborted) {
+            for (const group of plan.duplicateGroups) {
+                await writeDuplicateMetadata(group, config);
+            }
+        }
+        // Generate undo scripts (always — even on abort, for completed operations)
+        const opsForUndo = aborted ? completedOps : plan.operations;
+        const undoSh = generateUndoSh(opsForUndo, config.targetDir);
+        const undoPs1 = generateUndoPs1(opsForUndo, config.targetDir);
+        const undoShPath = path.join(config.targetDir, '_sheldonify-undo.sh');
+        const undoPs1Path = path.join(config.targetDir, '_sheldonify-undo.ps1');
+        await fs.writeFile(undoShPath, undoSh, 'utf-8');
+        await fs.writeFile(undoPs1Path, undoPs1, 'utf-8');
+        // Generate index
+        const partialPlan = aborted
+            ? { ...plan, operations: completedOps }
+            : plan;
+        const index = generateIndex(partialPlan, config);
+        const indexPath = path.join(config.targetDir, '_sheldonify-index.json');
+        await fs.writeFile(indexPath, JSON.stringify(index, null, 2), 'utf-8');
+        return {
+            success: errors.length === 0,
+            operationsExecuted,
+            errors,
+            indexPath,
+            undoShPath,
+            undoPs1Path,
+        };
+    }
+    finally {
+        process.removeListener('SIGINT', onAbort);
+        process.removeListener('SIGTERM', onAbort);
+    }
+}
+async function writeDuplicateMetadata(group, config) {
+    for (const dupPath of group.duplicates) {
+        const dupRelPath = path.relative(config.targetDir, dupPath);
+        const movedTo = path.join(config.targetDir, '_duplicates', dupRelPath);
+        const metaPath = movedTo + '.sheldonify-meta.json';
+        try {
+            await ensureDir(path.dirname(metaPath));
+            await fs.writeFile(metaPath, JSON.stringify({
+                originalPath: dupRelPath,
+                hash: group.hash,
+                keptCopy: path.relative(config.targetDir, group.kept),
+            }, null, 2), 'utf-8');
+        }
+        catch {
+            // non-critical
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index-generator.d.ts

@@ -0,0 +1,3 @@
+import { MovePlan, SheldonifyConfig, SheldonifyIndex, UncertainResolution } from './types.js';
+export declare function generateIndex(plan: MovePlan, config: SheldonifyConfig, uncertainResolutions?: UncertainResolution[]): SheldonifyIndex;
+//# sourceMappingURL=index-generator.d.ts.map

package/dist/index-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-generator.d.ts","sourceRoot":"","sources":["../src/index-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE9F,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,EACxB,oBAAoB,GAAE,mBAAmB,EAAO,GAC/C,eAAe,CAmBjB"}

package/dist/index-generator.js

@@ -0,0 +1,22 @@
+import path from 'node:path';
+export function generateIndex(plan, config, uncertainResolutions = []) {
+    return {
+        version: 1,
+        timestamp: new Date().toISOString(),
+        strategy: config.strategy,
+        targetDir: config.targetDir,
+        stats: plan.stats,
+        operations: plan.operations.map(op => ({
+            source: path.relative(config.targetDir, op.source),
+            destination: path.relative(config.targetDir, op.destination),
+            reason: op.reason,
+            type: op.type,
+        })),
+        undo: plan.operations.map(op => ({
+            from: path.relative(config.targetDir, op.destination),
+            to: path.relative(config.targetDir, op.source),
+        })),
+        uncertainResolutions,
+    };
+}
+//# sourceMappingURL=index-generator.js.map

package/dist/index-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-generator.js","sourceRoot":"","sources":["../src/index-generator.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,UAAU,aAAa,CAC3B,IAAc,EACd,MAAwB,EACxB,uBAA8C,EAAE;IAEhD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC;YAClD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC;YAC5D,MAAM,EAAE,EAAE,CAAC,MAAM;YACjB,IAAI,EAAE,EAAE,CAAC,IAAI;SACd,CAAC,CAAC;QACH,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC;YACrD,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC;SAC/C,CAAC,CAAC;QACH,oBAAoB;KACrB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { loadConfig } from './config.js';
+export { scanDirectory, getScanWarnings } from './scanner.js';
+export { createProtectedChecker, hasProjectMarker } from './protected.js';
+export { getStrategy } from './strategies/index.js';
+export { classify } from './classifier.js';
+export { findDuplicates } from './duplicates.js';
+export { buildMovePlan } from './planner.js';
+export { executePlan } from './executor.js';
+export { generateIndex } from './index-generator.js';
+export { generateUndoSh, generateUndoPs1 } from './undo-generator.js';
+export type { SheldonifyConfig, StrategyName, FileEntry, Classification, MoveOperation, MovePlan, DuplicateGroup, ExecutionResult, SheldonifyIndex, SortStrategy, CustomRule, UncertainFile, UncertainResolution, PlanStats, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { loadConfig } from './config.js';
+export { scanDirectory, getScanWarnings } from './scanner.js';
+export { createProtectedChecker, hasProjectMarker } from './protected.js';
+export { getStrategy } from './strategies/index.js';
+export { classify } from './classifier.js';
+export { findDuplicates } from './duplicates.js';
+export { buildMovePlan } from './planner.js';
+export { executePlan } from './executor.js';
+export { generateIndex } from './index-generator.js';
+export { generateUndoSh, generateUndoPs1 } from './undo-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,7 @@
+import { MovePlan, ExecutionResult, SheldonifyConfig } from './types.js';
+export declare function printDryRun(plan: MovePlan, config: SheldonifyConfig): void;
+export declare function printResult(result: ExecutionResult, config: SheldonifyConfig): void;
+export declare function printUncertainFiles(plan: MovePlan, config: SheldonifyConfig): void;
+export declare function printError(message: string, jsonOutput: boolean): void;
+export declare function printVerbose(message: string, config: SheldonifyConfig): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAqC1E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAyBnF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAwBlF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAMrE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAI5E"}

package/dist/output.js

@@ -0,0 +1,129 @@
+import chalk from 'chalk';
+import path from 'node:path';
+export function printDryRun(plan, config) {
+    if (config.jsonOutput) {
+        printJson({ status: 'dry-run', plan: sanitizePlan(plan, config) });
+        return;
+    }
+    const header = chalk.bold(`sheldonify — preview for ${chalk.cyan(config.targetDir)} using "${config.strategy}" strategy`);
+    stderr(header);
+    stderr('');
+    if (plan.operations.length === 0) {
+        stderr(chalk.yellow('  Nothing to do — directory is already organized.'));
+        return;
+    }
+    const grouped = groupByDestFolder(plan.operations, config.targetDir);
+    for (const [folder, ops] of Object.entries(grouped)) {
+        stderr(chalk.green(`  📁 ${folder}/`));
+        for (const op of ops) {
+            const from = path.relative(config.targetDir, op.source);
+            const to = path.relative(config.targetDir, op.destination);
+            const icon = op.type === 'duplicate' ? chalk.yellow('⚠') : ' ';
+            stderr(`  ${icon}  ${chalk.dim(from)} → ${chalk.white(to)}`);
+        }
+    }
+    stderr('');
+    stderr(chalk.bold('  Stats:'));
+    stderr(`    Files to move:     ${plan.stats.filesToMove}`);
+    stderr(`    Duplicates:        ${plan.stats.duplicatesFound}`);
+    stderr(`    Folders to create: ${plan.stats.foldersToCreate}`);
+    stderr(`    Protected skipped: ${plan.stats.protectedSkipped}`);
+    if (plan.stats.uncertainCount > 0) {
+        stderr(`    Uncertain:        ${chalk.yellow(plan.stats.uncertainCount.toString())}`);
+    }
+    stderr('');
+    stderr(chalk.dim('  Run without --dry-run to apply.'));
+}
+export function printResult(result, config) {
+    if (config.jsonOutput) {
+        printJson({
+            status: result.success ? 'completed' : 'partial',
+            operationsExecuted: result.operationsExecuted,
+            errors: result.errors,
+            indexPath: result.indexPath,
+            undoShPath: result.undoShPath,
+            undoPs1Path: result.undoPs1Path,
+        });
+        return;
+    }
+    if (result.success) {
+        stderr(chalk.green.bold(`\n  ✓ Organized ${result.operationsExecuted} files successfully.`));
+    }
+    else {
+        stderr(chalk.red.bold(`\n  ✗ Completed with ${result.errors.length} error(s).`));
+        for (const err of result.errors) {
+            stderr(chalk.red(`    • ${err}`));
+        }
+    }
+    stderr(chalk.dim(`\n  Index: ${result.indexPath}`));
+    stderr(chalk.dim(`  Undo:  ${result.undoShPath} (bash) / ${result.undoPs1Path} (powershell)`));
+    stderr('');
+}
+export function printUncertainFiles(plan, config) {
+    if (config.jsonOutput) {
+        printJson({
+            status: 'needs-review',
+            uncertainFiles: plan.uncertainFiles.map(u => ({
+                file: u.file.relativePath,
+                candidates: u.candidates.map(c => ({
+                    category: c.category,
+                    confidence: c.confidence,
+                    reason: c.reason,
+                })),
+            })),
+        });
+        return;
+    }
+    stderr(chalk.yellow.bold('\n  ⚠ The following files need your input:\n'));
+    for (const uncertain of plan.uncertainFiles) {
+        stderr(`  ${chalk.white(uncertain.file.relativePath)}`);
+        for (const candidate of uncertain.candidates) {
+            stderr(`    → ${chalk.cyan(candidate.category)} (${(candidate.confidence * 100).toFixed(0)}%: ${candidate.reason})`);
+        }
+        stderr('');
+    }
+}
+export function printError(message, jsonOutput) {
+    if (jsonOutput) {
+        printJson({ status: 'error', error: message });
+    }
+    else {
+        stderr(chalk.red.bold(`\n  Error: ${message}\n`));
+    }
+}
+export function printVerbose(message, config) {
+    if (config.verbose && !config.jsonOutput) {
+        stderr(chalk.dim(`  [verbose] ${message}`));
+    }
+}
+function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+function stderr(message) {
+    process.stderr.write(message + '\n');
+}
+function groupByDestFolder(operations, targetDir) {
+    const groups = {};
+    for (const op of operations) {
+        const rel = path.relative(targetDir, op.destination);
+        const folder = rel.split(path.sep)[0] ?? 'root';
+        if (!groups[folder])
+            groups[folder] = [];
+        groups[folder].push(op);
+    }
+    return groups;
+}
+function sanitizePlan(plan, config) {
+    return {
+        stats: plan.stats,
+        operations: plan.operations.map(op => ({
+            from: path.relative(config.targetDir, op.source),
+            to: path.relative(config.targetDir, op.destination),
+            reason: op.reason,
+            type: op.type,
+        })),
+        skippedPaths: plan.skippedPaths,
+        warnings: plan.warnings,
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/planner.d.ts

@@ -0,0 +1,3 @@
+import { FileEntry, Classification, DuplicateGroup, UncertainFile, MovePlan, SheldonifyConfig } from './types.js';
+export declare function buildMovePlan(files: FileEntry[], classifications: Map<string, Classification>, duplicateGroups: DuplicateGroup[], uncertainFiles: UncertainFile[], config: SheldonifyConfig): MovePlan;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAiB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGjI,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAAE,EAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5C,eAAe,EAAE,cAAc,EAAE,EACjC,cAAc,EAAE,aAAa,EAAE,EAC/B,MAAM,EAAE,gBAAgB,GACvB,QAAQ,CAsFV"}

package/dist/planner.js

@@ -0,0 +1,83 @@
+import path from 'node:path';
+import { resolveConflict } from './utils/fs-helpers.js';
+export function buildMovePlan(files, classifications, duplicateGroups, uncertainFiles, config) {
+    const operations = [];
+    const usedDests = new Set();
+    const duplicateSet = new Set();
+    const warnings = [];
+    // Collect all duplicate file paths
+    for (const group of duplicateGroups) {
+        for (const dup of group.duplicates) {
+            duplicateSet.add(dup);
+        }
+    }
+    // Build organize operations from classifications
+    for (const file of files) {
+        if (duplicateSet.has(file.absolutePath))
+            continue;
+        const classification = classifications.get(file.absolutePath);
+        if (!classification)
+            continue;
+        const destDir = path.join(config.targetDir, classification.category);
+        let destPath = path.join(destDir, file.name);
+        // Skip if file is already in the right place (case-insensitive on Windows)
+        if (path.dirname(file.absolutePath).toLowerCase() === destDir.toLowerCase())
+            continue;
+        destPath = resolveConflict(destPath, usedDests);
+        if (destPath.toLowerCase() === file.absolutePath.toLowerCase())
+            continue;
+        usedDests.add(destPath);
+        operations.push({
+            source: file.absolutePath,
+            destination: destPath,
+            reason: classification.reason,
+            type: 'organize',
+        });
+    }
+    // Build duplicate move operations
+    for (const group of duplicateGroups) {
+        for (const dup of group.duplicates) {
+            const dupFile = files.find(f => f.absolutePath === dup);
+            if (!dupFile)
+                continue;
+            const dupRelPath = path.relative(config.targetDir, dup);
+            if (dupRelPath.startsWith('_duplicates')) {
+                warnings.push(`Skipping duplicate already in _duplicates: ${dupRelPath}`);
+                continue;
+            }
+            let destPath = path.join(config.targetDir, '_duplicates', dupRelPath);
+            destPath = resolveConflict(destPath, usedDests);
+            usedDests.add(destPath);
+            operations.push({
+                source: dup,
+                destination: destPath,
+                reason: `duplicate of ${path.relative(config.targetDir, group.kept)}`,
+                type: 'duplicate',
+            });
+        }
+    }
+    // Calculate folders to create
+    const foldersToCreate = new Set();
+    for (const op of operations) {
+        const dir = path.dirname(op.destination);
+        if (dir !== config.targetDir) {
+            foldersToCreate.add(dir);
+        }
+    }
+    return {
+        operations,
+        duplicateGroups,
+        skippedPaths: [],
+        uncertainFiles,
+        warnings,
+        stats: {
+            totalFiles: files.length,
+            filesToMove: operations.filter(o => o.type === 'organize').length,
+            duplicatesFound: duplicateGroups.reduce((sum, g) => sum + g.duplicates.length, 0),
+            foldersToCreate: foldersToCreate.size,
+            protectedSkipped: 0,
+            uncertainCount: uncertainFiles.length,
+        },
+    };
+}
+//# sourceMappingURL=planner.js.map