@git.zone/tsdisk 1.1.0 → 1.3.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@git.zone/tsdisk',
-    version: '1.1.0',
+    version: '1.3.0',
     description: 'A disk usage diagnostic CLI for finding large files, caches, logs, and Docker storage.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHdGQUF3RjtDQUN0RyxDQUFBIn0=

package/dist_ts/index.d.ts

@@ -1,3 +1,9 @@
 export { commitinfo } from './00_commitinfo_data.js';
-export { formatBytes, main, parseDuOutput, runCli, } from './tsdisk.cli.js';
+export { formatBytes, collectDiskReport, collectProjectToolCacheReport, diagnosticCommandComplete, main, parseDuOutput, runCli, } from './tsdisk.cli.js';
 export * from './tsdisk.toolcaches.js';
+export * from './tsdisk.scan.js';
+export * from './tsdisk.cleanup.js';
+export * from './tsdisk.usage.js';
+export { DiskProgressReporter, estimateReclaimableSpace } from './tsdisk.progress.js';
+export type { IDiskProgress, IReclaimEstimate } from './tsdisk.progress.js';
+export type { IRuntimeContext, IDiagnosticSection } from './tsdisk.cli.js';

package/dist_ts/index.js

@@ -1,4 +1,8 @@
 export { commitinfo } from './00_commitinfo_data.js';
-export { formatBytes, main, parseDuOutput, runCli, } from './tsdisk.cli.js';
+export { formatBytes, collectDiskReport, collectProjectToolCacheReport, diagnosticCommandComplete, main, parseDuOutput, runCli, } from './tsdisk.cli.js';
 export * from './tsdisk.toolcaches.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDckQsT0FBTyxFQUNMLFdBQVcsRUFDWCxJQUFJLEVBQ0osYUFBYSxFQUNiLE1BQU0sR0FDUCxNQUFNLGlCQUFpQixDQUFDO0FBQ3pCLGNBQWMsd0JBQXdCLENBQUMifQ==
+export * from './tsdisk.scan.js';
+export * from './tsdisk.cleanup.js';
+export * from './tsdisk.usage.js';
+export { DiskProgressReporter, estimateReclaimableSpace } from './tsdisk.progress.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDckQsT0FBTyxFQUNMLFdBQVcsRUFDWCxpQkFBaUIsRUFDakIsNkJBQTZCLEVBQzdCLHlCQUF5QixFQUN6QixJQUFJLEVBQ0osYUFBYSxFQUNiLE1BQU0sR0FDUCxNQUFNLGlCQUFpQixDQUFDO0FBQ3pCLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsT0FBTyxFQUFFLG9CQUFvQixFQUFFLHdCQUF3QixFQUFFLE1BQU0sc0JBQXNCLENBQUMifQ==

package/dist_ts/tsdisk.cleanup.d.ts

@@ -0,0 +1,26 @@
+export type TCleanupCategory = 'rust' | 'docker' | 'pnpm';
+export interface ICleanupAction {
+    category: TCleanupCategory;
+    cwd: string;
+    command: string;
+    previewArgs?: string[];
+    applyArgs: string[];
+    scope: string;
+    blocked?: string;
+}
+export interface ICleanupPlan {
+    dryRun: boolean;
+    actions: ICleanupAction[];
+}
+export interface ICliOptions {
+    command: 'diagnose' | 'scan' | 'cleanup' | 'help' | 'version';
+    roots: string[];
+    categories: TCleanupCategory[];
+    json: boolean;
+    apply: boolean;
+    yes: boolean;
+    days: number;
+}
+export declare function parseCliOptions(args: string[]): ICliOptions;
+/** Build project-scoped owner commands. No discovered marker authorizes deletion. */
+export declare function createCleanupPlan(options: ICliOptions): Promise<ICleanupPlan>;

package/dist_ts/tsdisk.cleanup.js

@@ -0,0 +1,128 @@
+import * as plugins from './tsdisk.plugins.js';
+export function parseCliOptions(args) {
+    const options = { command: 'diagnose', roots: [], categories: ['rust', 'docker'], json: false, apply: false, yes: false, days: 14 };
+    let commandSeen = false;
+    let dryRun = false;
+    let cleanupOption = false;
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (arg === '--help' || arg === '-h') {
+            options.command = 'help';
+            return options;
+        }
+        if (arg === '--version' || arg === '-v') {
+            options.command = 'version';
+            return options;
+        }
+        if (arg === 'scan' || arg === 'cleanup') {
+            if (commandSeen)
+                throw new Error('Specify one command: scan or cleanup.');
+            options.command = arg;
+            commandSeen = true;
+        }
+        else if (arg === '--json')
+            options.json = true;
+        else if (arg === '--apply') {
+            options.apply = true;
+            cleanupOption = true;
+        }
+        else if (arg === '--yes' || arg === '-y') {
+            options.yes = true;
+            cleanupOption = true;
+        }
+        else if (arg === '--dry-run' || arg === '-n') {
+            dryRun = true;
+            cleanupOption = true;
+        }
+        else if (['--root', '--only', '--days'].some((flag) => arg === flag || arg.startsWith(`${flag}=`))) {
+            const separator = arg.indexOf('=');
+            const name = separator < 0 ? arg : arg.slice(0, separator);
+            const value = separator < 0 ? args[++index] : arg.slice(separator + 1);
+            if (!value || value.startsWith('--'))
+                throw new Error(`Missing value for ${name}.`);
+            if (name === '--root')
+                options.roots.push(plugins.path.resolve(value));
+            else if (name === '--only') {
+                cleanupOption = true;
+                const values = value.split(',');
+                if (values.some((category) => !['rust', 'docker', 'pnpm'].includes(category)))
+                    throw new Error('Cleanup categories: rust,docker,pnpm.');
+                options.categories = [...new Set(values)];
+            }
+            else {
+                cleanupOption = true;
+                options.days = Number(value);
+                if (!Number.isSafeInteger(options.days) || options.days < 1)
+                    throw new Error('--days must be a positive integer.');
+            }
+        }
+        else
+            throw new Error(`Unknown argument: ${arg}`);
+    }
+    if (cleanupOption && options.command !== 'cleanup')
+        throw new Error('Cleanup options require the cleanup command.');
+    if (dryRun && options.apply)
+        throw new Error('--dry-run and --apply cannot be combined.');
+    if (options.yes && !options.apply)
+        throw new Error('--yes requires --apply.');
+    if (options.command === 'diagnose' && (options.roots.length || options.json))
+        options.command = 'scan';
+    options.roots = [...new Set(options.roots)];
+    return options;
+}
+/** Build project-scoped owner commands. No discovered marker authorizes deletion. */
+export async function createCleanupPlan(options) {
+    if (options.command !== 'cleanup')
+        throw new Error('Cleanup command required.');
+    if (!Number.isSafeInteger(options.days) || options.days < 1)
+        throw new Error('Invalid retention period.');
+    if (!options.categories.length || options.categories.some((category) => !['rust', 'docker', 'pnpm'].includes(category)))
+        throw new Error('Invalid cleanup category.');
+    const plan = { dryRun: !options.apply, actions: [] };
+    for (const root of new Set(options.roots.length ? options.roots : [process.cwd()])) {
+        const cwd = plugins.path.resolve(root);
+        const stat = await plugins.fs.lstat(cwd);
+        if (!stat.isDirectory() || stat.isSymbolicLink() || await plugins.fs.realpath(cwd) !== cwd || cwd === plugins.path.parse(cwd).root) {
+            throw new Error(`Cleanup requires a real project directory: ${cwd}`);
+        }
+        // Running project-installed tools as root would grant project code host-wide authority.
+        if (process.getuid?.() === 0)
+            throw new Error('Run cleanup as the project owner, without sudo.');
+        if (process.getuid && stat.uid !== process.getuid())
+            throw new Error(`Cleanup root is not owned by the current user: ${cwd}`);
+        for (const category of new Set(options.categories)) {
+            if (category === 'pnpm') {
+                plan.actions.push({ category, cwd, command: 'pnpm', applyArgs: ['store', 'prune'], scope: 'Prune unreferenced packages from the pnpm store configured for this project. The store may be shared. pnpm provides no prune dry-run.' });
+                continue;
+            }
+            const binary = category === 'rust' ? 'tsrust' : 'tsdocker';
+            const command = plugins.path.join(cwd, 'node_modules', '.bin', binary);
+            const args = category === 'rust' ? ['prune', '--days', String(options.days)] : ['prune'];
+            const action = {
+                category, cwd, command, previewArgs: args, applyArgs: [...args, '--apply'],
+                scope: category === 'rust'
+                    ? `Project's marked managed Rust targets; newest-file retention ${options.days} days, revalidated by tsrust.`
+                    : 'Project registry caches and tsdocker-owned abandoned containers in the current Docker context; container scope may include other projects. tsdocker revalidates owner identity and active mounts.',
+            };
+            try {
+                await plugins.fs.access(command, plugins.constants.X_OK);
+                const packagePath = plugins.path.join(cwd, 'node_modules', '@git.zone', binary, 'package.json');
+                const manifest = JSON.parse(await plugins.fs.readFile(packagePath, 'utf8'));
+                if (manifest.name !== `@git.zone/${binary}`)
+                    throw new Error('Unexpected owning package.');
+                const version = /^(\d+)\.(\d+)\.(\d+)$/.exec(manifest.version ?? '')?.slice(1).map(Number);
+                const minimum = category === 'docker' ? [3, 6, 0] : [1, 13, 2];
+                const different = version?.findIndex((part, index) => part !== minimum[index]);
+                if (!version || (different !== undefined && different !== -1 && version[different] < minimum[different])) {
+                    action.blocked = `@git.zone/${binary} ${minimum.join('.')} or later is required for the documented prune contract.`;
+                }
+            }
+            catch {
+                action.blocked = `Install a current @git.zone/${binary} in this project before cleanup. No tool is downloaded automatically.`;
+            }
+            plan.actions.push(action);
+        }
+    }
+    return plan;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHNkaXNrLmNsZWFudXAuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy90c2Rpc2suY2xlYW51cC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHFCQUFxQixDQUFDO0FBNkIvQyxNQUFNLFVBQVUsZUFBZSxDQUFDLElBQWM7SUFDNUMsTUFBTSxPQUFPLEdBQWdCLEVBQUUsT0FBTyxFQUFFLFVBQVUsRUFBRSxLQUFLLEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsR0FBRyxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsRUFBRSxFQUFFLENBQUM7SUFDakosSUFBSSxXQUFXLEdBQUcsS0FBSyxDQUFDO0lBQ3hCLElBQUksTUFBTSxHQUFHLEtBQUssQ0FBQztJQUNuQixJQUFJLGFBQWEsR0FBRyxLQUFLLENBQUM7SUFDMUIsS0FBSyxJQUFJLEtBQUssR0FBRyxDQUFDLEVBQUUsS0FBSyxHQUFHLElBQUksQ0FBQyxNQUFNLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FBQztRQUNqRCxNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDeEIsSUFBSSxHQUFHLEtBQUssUUFBUSxJQUFJLEdBQUcsS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUFDLE9BQU8sQ0FBQyxPQUFPLEdBQUcsTUFBTSxDQUFDO1lBQUMsT0FBTyxPQUFPLENBQUM7UUFBQyxDQUFDO1FBQ25GLElBQUksR0FBRyxLQUFLLFdBQVcsSUFBSSxHQUFHLEtBQUssSUFBSSxFQUFFLENBQUM7WUFBQyxPQUFPLENBQUMsT0FBTyxHQUFHLFNBQVMsQ0FBQztZQUFDLE9BQU8sT0FBTyxDQUFDO1FBQUMsQ0FBQztRQUN6RixJQUFJLEdBQUcsS0FBSyxNQUFNLElBQUksR0FBRyxLQUFLLFNBQVMsRUFBRSxDQUFD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

package/dist_ts/tsdisk.cli.d.ts

@@ -1,5 +1,17 @@
+import { type IWorkspaceScanOptions, type IScanIssue } from './tsdisk.scan.js';
+import { type IUsageReport } from './tsdisk.usage.js';
+import { type IDiskProgress } from './tsdisk.progress.js';
+export { formatBytes } from './tsdisk.progress.js';
+export type { IWorkspaceScanOptions } from './tsdisk.scan.js';
 import { type IToolCacheFinding } from './tsdisk.toolcaches.js';
+interface ICommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+    truncated?: boolean;
+}
 export interface IRuntimeContext {
+    onProgress?: (progress: Partial<IDiskProgress>) => void;
     runningAsRoot: boolean;
     sudoAvailable: boolean;
     sudoChecked: boolean;
@@ -15,15 +27,39 @@ interface IDuEntry {
     bytes: number;
     path: string;
 }
-export interface IWorkspaceScanOptions {
-    maxDepth: number;
-    timeoutMs: number;
-    maxEntries: number;
-}
-export declare function formatBytes(bytes: number): string;
 export declare function parseDuOutput(output: string): IDuEntry[];
-export declare function collectToolCachePathsFromRoot(rootArg: string, optionsArg: IWorkspaceScanOptions): Promise<IToolCacheFinding[]>;
+export declare function collectToolCachePathsFromRoot(root: string, options: IWorkspaceScanOptions): Promise<IToolCacheFinding[]>;
+export declare function collectProjectToolCacheReport(ctx: IRuntimeContext, roots?: string[]): Promise<{
+    roots: string[];
+    toolCaches: IToolCacheFinding[];
+    usagePriorityPaths: string[];
+    issues: IScanIssue[];
+    issueCounts: Partial<Record<"timeout" | "read-error" | "invalid-marker" | "depth-limit" | "entry-limit" | "mount-boundary" | "symlink" | "size-unavailable", number>>;
+    complete: boolean;
+}>;
 export declare function collectProjectToolCacheDiagnostics(ctx: IRuntimeContext): Promise<IToolCacheFinding[]>;
 export declare function main(): Promise<void>;
+export interface IDiagnosticSection {
+    name: string;
+    kind?: 'command' | 'derived';
+    derivedFrom?: 'usage.entries';
+    command: string;
+    args: string[];
+    result: ICommandResult;
+    complete: boolean;
+}
+export declare function diagnosticCommandComplete(command: string, result: ICommandResult): boolean;
+export declare function collectDiskReport(ctx: IRuntimeContext, roots?: string[]): Promise<{
+    usage: IUsageReport;
+    reclaim: import("./tsdisk.progress.js").IReclaimEstimate;
+    sections: IDiagnosticSection[];
+    complete: boolean;
+    roots: string[];
+    toolCaches: IToolCacheFinding[];
+    usagePriorityPaths: string[];
+    issues: IScanIssue[];
+    issueCounts: Partial<Record<"timeout" | "read-error" | "invalid-marker" | "depth-limit" | "entry-limit" | "mount-boundary" | "symlink" | "size-unavailable", number>>;
+    schemaVersion: number;
+    generatedAt: string;
+}>;
 export declare function runCli(args?: string[]): Promise<void>;
-export {};