@git.zone/tsdisk 1.1.0

package/ts/tsdisk.plugins.ts

@@ -0,0 +1,15 @@
+// node native
+import { spawn } from 'node:child_process';
+import { createReadStream, type ReadStream } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+
+export {
+  createInterface,
+  createReadStream,
+  fs,
+  path,
+  spawn,
+  type ReadStream,
+};

package/ts/tsdisk.toolcaches.ts

@@ -0,0 +1,143 @@
+import * as path from 'node:path';
+
+export const toolCacheMarkerFile = '.gitzone-tool-cache.json';
+
+export type TToolCacheRisk = 'safe-marked' | 'safe-heuristic' | 'review' | 'report-only';
+
+export interface IToolCacheMarker {
+  owner: string;
+  kind: string;
+  safeToPrune: boolean;
+  createdAt: string;
+  schemaVersion: 1;
+}
+
+export interface IToolCacheClassification {
+  ownerGuess: string;
+  kind: string;
+  risk: TToolCacheRisk;
+  suggestedCleanupCommand: string;
+  marker?: IToolCacheMarker;
+}
+
+export interface IToolCacheFinding extends IToolCacheClassification {
+  path: string;
+  bytes?: number;
+}
+
+export function parseToolCacheMarker(rawArg: string): IToolCacheMarker | undefined {
+  try {
+    const marker = JSON.parse(rawArg) as Partial<IToolCacheMarker>;
+    if (
+      typeof marker.owner === 'string' &&
+      typeof marker.kind === 'string' &&
+      marker.safeToPrune === true &&
+      typeof marker.createdAt === 'string' &&
+      marker.schemaVersion === 1
+    ) {
+      return marker as IToolCacheMarker;
+    }
+  } catch {
+    return undefined;
+  }
+
+  return undefined;
+}
+
+function quotePath(pathArg: string): string {
+  return `"${pathArg.replace(/(["\\$`])/g, '\\$1')}"`;
+}
+
+function normalizedPath(pathArg: string): string {
+  return path.resolve(pathArg).replace(/\\/g, '/');
+}
+
+function workspaceRootFor(pathArg: string): string {
+  const normalized = normalizedPath(pathArg);
+  const nogitIndex = normalized.indexOf('/.nogit/');
+  if (nogitIndex > 0) {
+    return normalized.slice(0, nogitIndex);
+  }
+  const rustTargetIndex = normalized.indexOf('/rust/target');
+  if (rustTargetIndex > 0) {
+    return normalized.slice(0, rustTargetIndex);
+  }
+  const tsRustTargetIndex = normalized.indexOf('/ts_rust/target');
+  if (tsRustTargetIndex > 0) {
+    return normalized.slice(0, tsRustTargetIndex);
+  }
+  const distIndex = normalized.indexOf('/dist/binaries/');
+  if (distIndex > 0) {
+    return normalized.slice(0, distIndex);
+  }
+  return path.dirname(pathArg);
+}
+
+export function classifyToolCachePath(pathArg: string, markerArg?: IToolCacheMarker): IToolCacheClassification | undefined {
+  const normalized = normalizedPath(pathArg);
+  if (markerArg) {
+    return {
+      ownerGuess: markerArg.owner,
+      kind: markerArg.kind,
+      risk: markerArg.safeToPrune ? 'safe-marked' : 'review',
+      suggestedCleanupCommand: `rm -rf ${quotePath(pathArg)}`,
+      marker: markerArg,
+    };
+  }
+
+  if (/\/dist\/binaries\/\.[^/]+\/[^/]+\/\.deno_compile_node_modules$/.test(normalized)) {
+    return {
+      ownerGuess: '@git.zone/tsdeno',
+      kind: 'deno-self-extracting-staging',
+      risk: 'report-only',
+      suggestedCleanupCommand: `report-only: verify ownership before removing ${quotePath(path.dirname(pathArg))}`,
+    };
+  }
+
+  if (/\/\.nogit\/release-binaries\/\.[^/]+\/[^/]+\/\.deno_compile_node_modules$/.test(normalized)) {
+    return {
+      ownerGuess: '@git.zone/tsdeno',
+      kind: 'deno-self-extracting-release-staging',
+      risk: 'report-only',
+      suggestedCleanupCommand: `report-only: verify ownership before removing ${quotePath(path.dirname(pathArg))}`,
+    };
+  }
+
+  if (normalized.endsWith('/.nogit/tsbundle-temp')) {
+    return {
+      ownerGuess: '@git.zone/tsbundle',
+      kind: 'bundle-temp-workspace',
+      risk: 'report-only',
+      suggestedCleanupCommand: `report-only: verify ownership before removing ${quotePath(pathArg)}`,
+    };
+  }
+
+  if (normalized.endsWith('/.nogit/docker-registry') || normalized.includes('/.nogit/docker-registry/')) {
+    return {
+      ownerGuess: '@git.zone/tsdocker',
+      kind: 'docker-registry-cache',
+      risk: 'report-only',
+      suggestedCleanupCommand: `report-only: run tsdocker prune dry-run from ${quotePath(workspaceRootFor(pathArg))} and verify markers before removal`,
+    };
+  }
+
+  if (normalized.endsWith('/rust/target') || normalized.endsWith('/ts_rust/target')) {
+    return {
+      ownerGuess: '@git.zone/tsrust/cargo',
+      kind: 'rust-target-cache',
+      risk: 'report-only',
+      suggestedCleanupCommand: `report-only: run tsrust prune dry-run from ${quotePath(workspaceRootFor(pathArg))} and verify managed markers before removal`,
+    };
+  }
+
+  if (normalized.endsWith('/.nogit/tsrust-target')) {
+    return {
+      ownerGuess: '@git.zone/tsrust',
+      kind: 'rust-target-cache',
+      risk: 'report-only',
+      suggestedCleanupCommand: `report-only: run tsrust prune dry-run from ${quotePath(workspaceRootFor(pathArg))} and verify managed markers before removal`,
+    };
+  }
+
+  return undefined;
+}