common.json

{
  "schemaVersion": 1,
  "pack": "common",
  "updated": "2026-10-20",
  "rules": [
    {
      "id": "regen-node-modules",
      "kind": "project-directory",
      "title": "node_modules",
      "description": "JavaScript dependencies — restore any time",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "npm",
      "names": [
        "node_modules"
      ],
      "ownerManifest": [
        "package.json"
      ],
      "evidence": [
        ".package-lock.json",
        ".bin",
        ".modules.yaml",
        ".yarn-integrity",
        ".pnpm"
      ],
      "restoreCommand": "npm install"
    },
    {
      "id": "regen-python-venv",
      "kind": "project-directory",
      "title": "Python virtualenv",
      "description": "Virtual environment — Python can make it again, but the packages in it must be reinstalled",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "python",
      "names": [
        ".venv",
        "venv",
        "env"
      ],
      "requiresSibling": [
        "requirements.txt",
        "pyproject.toml",
        "Pipfile",
        "setup.py",
        "setup.cfg",
        ".python-version"
      ],
      "requiresChild": [
        "pyvenv.cfg"
      ],
      "evidence": [
        "pyvenv.cfg"
      ],
      "restoreCommand": "python3 -m venv <folder>, then reinstall the packages it held"
    },
    {
      "id": "regen-pycache",
      "kind": "project-directory",
      "title": "Python bytecode cache",
      "description": "__pycache__ — Python regenerates it automatically",
      "category": "regenerable",
      "confidence": "high",
      "names": [
        "__pycache__"
      ],
      "restoreCommand": "automatic on next run"
    },
    {
      "id": "regen-rust-target",
      "kind": "project-directory",
      "title": "Rust build target",
      "description": "Cargo build output and fetched crates",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "cargo",
      "names": [
        "target"
      ],
      "requiresSibling": [
        "Cargo.toml"
      ],
      "evidence": [
        "cachedir.tag",
        ".rustc_info.json",
        ".rustdoc_fingerprint.json"
      ],
      "restoreCommand": "cargo build"
    },
    {
      "id": "regen-maven-target",
      "kind": "project-directory",
      "title": "Maven build target",
      "description": "Maven build output",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "maven",
      "names": [
        "target"
      ],
      "requiresSibling": [
        "pom.xml"
      ],
      "evidence": [
        "maven-status",
        "maven-archiver",
        "surefire-reports"
      ],
      "restoreCommand": "mvn package"
    },
    {
      "id": "regen-gradle-build",
      "kind": "project-directory",
      "title": "Gradle build output",
      "description": "Compiled output — rebuilt by the next Gradle build",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "gradle",
      "names": [
        "build"
      ],
      "requiresSibling": [
        "build.gradle",
        "build.gradle.kts",
        "settings.gradle",
        "settings.gradle.kts"
      ],
      "evidence": [
        "tmp",
        "libs",
        "intermediates",
        "classes"
      ],
      "restoreCommand": "gradle build"
    },
    {
      "id": "regen-cocoapods",
      "kind": "project-directory",
      "title": "CocoaPods",
      "description": "Installed pods — restore with pod install",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "cocoapods",
      "names": [
        "Pods"
      ],
      "requiresSibling": [
        "Podfile"
      ],
      "evidence": [
        "manifest.lock",
        "pods.xcodeproj",
        "target support files"
      ],
      "restoreCommand": "pod install"
    },
    {
      "id": "regen-web-build",
      "kind": "project-directory",
      "title": "Web framework build",
      "description": "Framework build output — rebuilt by the next build",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "npm",
      "names": [
        ".next",
        ".nuxt",
        ".svelte-kit",
        ".angular"
      ],
      "ownerManifest": [
        "package.json"
      ],
      "evidence": [
        "static",
        "server",
        "cache",
        "build-manifest.json",
        "prerender-manifest.json"
      ],
      "restoreCommand": "npm run build"
    },
    {
      "id": "regen-web-build",
      "kind": "project-directory",
      "title": "Web framework build",
      "description": "Framework build output — rebuilt by the next build",
      "category": "regenerable",
      "confidence": "high",
      "ecosystem": "npm",
      "names": [
        "dist",
        ".output"
      ],
      "requiresSibling": [
        "package.json",
        "next.config.*",
        "nuxt.config.*",
        "vite.config.*",
        "svelte.config.*",
        "angular.json"
      ],
      "ownerManifest": [
        "package.json"
      ],
      "evidence": [
        "static",
        "server",
        "cache",
        "build-manifest.json",
        "prerender-manifest.json"
      ],
      "restoreCommand": "npm run build"
    },
    {
      "id": "test-coverage",
      "kind": "project-directory",
      "title": "Test coverage reports",
      "description": "Where JavaScript, Ruby and Flutter test tools write coverage reports — the next test run with coverage writes them again",
      "category": "regenerable",
      "confidence": "high",
      "names": [
        "coverage"
      ],
      "requiresSibling": [
        "package.json",
        "Gemfile",
        "pubspec.yaml"
      ],
      "requiresChild": [
        "lcov.info",
        "coverage-final.json",
        "coverage-summary.json",
        "clover.xml",
        "cobertura-coverage.xml",
        "prettify.js",
        ".resultset.json"
      ],
      "restoreCommand": "the next test run with coverage writes it again"
    },
    {
      "id": "gradle-project-cache",
      "kind": "project-directory",
      "title": "Gradle project cache",
      "description": "Gradle's own records for this project — the next Gradle build writes them again",
      "category": "regenerable",
      "confidence": "high",
      "names": [
        ".gradle"
      ],
      "requiresSibling": [
        "build.gradle",
        "build.gradle.kts",
        "settings.gradle",
        "settings.gradle.kts"
      ],
      "requiresChild": [
        "buildOutputCleanup",
        "file-system.probe",
        "vcs-1"
      ],
      "forbidsChild": [
        "gradle.properties",
        "init.d",
        "init.gradle",
        "init.gradle.kts",
        "caches",
        "wrapper",
        "daemon"
      ],
      "restoreCommand": "gradle build"
    },
    {
      "id": "build-output",
      "kind": "directory",
      "title": "Build output",
      "description": "Compiled output folders — regenerated by the next build",
      "category": "regenerable",
      "confidence": "medium",
      "names": [
        "dist",
        "target",
        "build"
      ]
    },
    {
      "id": "tool-caches",
      "kind": "directory",
      "title": "Tool caches",
      "description": "Caches left by dev tools — rebuilt automatically when needed",
      "category": "cache",
      "confidence": "high",
      "names": [
        ".pytest_cache",
        ".mypy_cache",
        ".ruff_cache",
        ".turbo",
        ".parcel-cache",
        ".eslintcache",
        ".tox"
      ]
    },
    {
      "id": "os-junk",
      "kind": "file",
      "title": "OS junk files",
      "description": "Hidden metadata files the OS recreates on demand",
      "category": "junk",
      "confidence": "high",
      "names": [
        ".DS_Store",
        "Thumbs.db",
        "desktop.ini"
      ]
    },
    {
      "id": "old-downloads",
      "kind": "stale-files",
      "title": "Old downloads",
      "description": "Files in Downloads not changed in 90+ days",
      "category": "junk",
      "confidence": "medium",
      "withinPath": "{home}/Downloads",
      "olderThanDays": 90,
      "minSizeBytes": 1000000
    },
    {
      "id": "media-lightroom-previews",
      "kind": "directory",
      "title": "Lightroom previews",
      "description": "Rendered previews beside a Lightroom Classic catalog — never your photos, which live outside the catalog. Lightroom re-renders previews as you browse; the first scroll through each folder is slower. Only the default catalog names are matched here — renamed catalogs are found by the media-library scan. Not offered for deletion from here: the Media libraries card in the Libraries view makes the gated offer after checking the owning app is not holding the library.",
      "category": "regenerable",
      "confidence": "high",
      "action": "advice",
      "adviceCommand": "Lightroom Classic ▸ Edit ▸ Catalog Settings ▸ File Handling ▸ Automatically Discard 1:1 Previews",
      "os": [
        "darwin",
        "win32"
      ],
      "names": [
        "Lightroom Catalog Previews.lrdata",
        "Lightroom Catalog-v10 Previews.lrdata",
        "Lightroom Catalog-v11 Previews.lrdata",
        "Lightroom Catalog-v12 Previews.lrdata",
        "Lightroom Catalog-v13 Previews.lrdata",
        "Lightroom Catalog-v14 Previews.lrdata"
      ]
    },
    {
      "id": "media-lightroom-smart-previews",
      "kind": "directory",
      "title": "Lightroom smart previews",
      "description": "Compressed stand-ins that let Lightroom Classic edit with the originals offline. Rebuilt on demand, but until then offline editing is unavailable — never your photos, which live outside the catalog. Not offered for deletion from here: the Media libraries card in the Libraries view makes the gated offer after checking the owning app is not holding the library.",
      "category": "regenerable",
      "confidence": "high",
      "action": "advice",
      "adviceCommand": "Lightroom Classic ▸ Library ▸ Previews ▸ Build Smart Previews",
      "os": [
        "darwin",
        "win32"
      ],
      "names": [
        "Lightroom Catalog Smart Previews.lrdata",
        "Lightroom Catalog-v10 Smart Previews.lrdata",
        "Lightroom Catalog-v11 Smart Previews.lrdata",
        "Lightroom Catalog-v12 Smart Previews.lrdata",
        "Lightroom Catalog-v13 Smart Previews.lrdata",
        "Lightroom Catalog-v14 Smart Previews.lrdata"
      ]
    },
    {
      "id": "media-captureone-cache",
      "kind": "location",
      "title": "Capture One catalog cache",
      "description": "Thumbnails and proxies inside the default Capture One catalog. Re-created as images are browsed — the first pass through each folder is slower. Originals and the catalog database are never touched. Not offered for deletion from here: the Media libraries card in the Libraries view makes the gated offer after checking the owning app is not holding the library.",
      "category": "regenerable",
      "confidence": "high",
      "action": "advice",
      "adviceCommand": "Capture One ▸ Image ▸ Regenerate Previews",
      "os": [
        "darwin",
        "win32"
      ],
      "paths": [
        "{home}/Pictures/Capture One Catalog.cocatalog/Cache"
      ]
    }
  ]
}