Skip to content

Latest commit

 

History

History
177 lines (126 loc) · 4.49 KB

clean.md

File metadata and controls

177 lines (126 loc) · 4.49 KB

stamp context clean Command

Remove all generated context artifacts from your project. Use this to reset your context files and start fresh.

stamp context clean [path] [options]
  • [path] (optional) – Directory to clean. Defaults to the current working directory. Paths can be relative (./src) or absolute.

Behavior

Default (dry run): Shows what would be removed without actually deleting anything. Safe way to preview the cleanup.

With --all --yes: Deletes all context artifacts. Both flags are required to prevent accidental deletions.

Options

Option Description
--all Include all context files in the deletion operation
--yes Confirm deletion (required with --all)
--quiet -q
--help, -h Show help message

Files Removed

Removes:

  • context_main.json – Main index file with folder metadata
  • **/context.json – All folder context files (recursively, JSON format only)
  • .logicstamp/ – Cache directory (if present, automatically included)

Note: This command only removes JSON format files (context.json). TOON format files (context.toon) are not cleaned by this command. See toon.md for details on TOON format support.

Automatically detects and includes the .logicstamp/ directory if it exists. No separate flag needed.

Examples

Preview what would be removed (dry run)

# Show what would be removed without deleting
stamp context clean

Output:

🧹 This will remove:
  - context_main.json
  - src/components/context.json
  - src/hooks/context.json
  - src/ui/context.json
  - .logicstamp/

💡 Run with --all --yes to confirm and delete these files.

Actually delete all context artifacts

# Delete all context files
stamp context clean --all --yes

Output:

🧹 This will remove:
  - context_main.json
  - src/components/context.json
  - src/hooks/context.json
  - src/ui/context.json
  - .logicstamp/

🗑️  Removing files...

   ✓ Removed context_main.json
   ✓ Removed src/components/context.json
   ✓ Removed src/hooks/context.json
   ✓ Removed src/ui/context.json
   ✓ Removed .logicstamp/

✅ Cleaned 4 file(s) and 1 directory

Clean specific directory

# Clean context files in a specific directory
stamp context clean ./src --all --yes

# Suppress verbose output (quiet mode)
stamp context clean --all --yes --quiet

Clean when no files exist

# When no context artifacts are found
stamp context clean

Output:

✅ No context artifacts found to clean

Safety Features

  • Dry run by default – Shows what would be removed without deleting anything unless both --all and --yes flags are provided
  • Requires both flags – Both --all and --yes must be specified to delete files, preventing accidental deletions
  • Ignores build directories – Automatically ignores node_modules/, dist/, build/, and .next/ when searching for context files

Use Cases

Reset and regenerate

# Clean all context files
stamp context clean --all --yes

# Generate fresh context
stamp context

Clean before switching branches

# Remove context files that might conflict
stamp context clean --all --yes

# Switch branch and regenerate
git checkout feature-branch
stamp context

Clean specific output directory

# Generate context to custom output directory
stamp context --out ./output

# Later, clean that directory
stamp context clean ./output --all --yes

Integration with Other Commands

The clean command works well with other LogicStamp commands:

# Clean → Generate → Validate workflow
stamp context clean --all --yes
stamp context
stamp context validate
# Clean → Generate → Compare workflow
stamp context clean --all --yes
stamp context
stamp context compare

Notes

  • Safe by default – Requires explicit confirmation (--all --yes) to delete files
  • Files are searched recursively but build directories (node_modules, dist, build, .next) are automatically ignored
  • The .logicstamp/ directory is automatically included if it exists (no separate flag needed)
  • Exit code is 0 on success (whether files were found or not)

Related Commands