From ccc10f341739aed008c9a4c2a2bc88faa80e3e02 Mon Sep 17 00:00:00 2001 From: daymade Date: Sun, 5 Apr 2026 13:47:47 +0800 Subject: [PATCH] docs: update docs for directory structure preservation (v1.0.2) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update SKILL.md and workflow_examples.md to reflect the new behavior of recover_content.py which now preserves original directory structure: - SKILL.md: Add 'preserving the original directory structure' note - SKILL.md: Update verification examples to use find command and show subdirectory paths (e.g., ./recovered_content/src/components/) - workflow_examples.md: Update diff example to account for nested paths Version bump: 1.0.1 → 1.0.2 Co-Authored-By: Claude Sonnet 4.6 --- .claude-plugin/marketplace.json | 2 +- claude-code-history-files-finder/SKILL.md | 12 ++++++------ .../references/workflow_examples.md | 5 +++-- 3 files changed, 10 insertions(+), 9 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index d842301..9bd582c 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -378,7 +378,7 @@ "description": "Find and recover content from Claude Code session history files. Use when searching for deleted files, tracking changes across sessions, analyzing conversation history, or recovering code/documents from previous Claude interactions. Triggers include mentions of session history, recover deleted, find in history, previous conversation, or .claude/projects", "source": "./", "strict": false, - "version": "1.0.1", + "version": "1.0.2", "category": "developer-tools", "keywords": [ "session-history", diff --git a/claude-code-history-files-finder/SKILL.md b/claude-code-history-files-finder/SKILL.md index be6faa5..dade1de 100644 --- a/claude-code-history-files-finder/SKILL.md +++ b/claude-code-history-files-finder/SKILL.md @@ -58,7 +58,7 @@ Extract files from session history: python3 scripts/recover_content.py /path/to/session.jsonl ``` -Extracts all Write tool calls and saves files to `./recovered_content/`. +Extracts all Write tool calls and saves files to `./recovered_content/`, preserving the original directory structure. **Filtering by keywords**: @@ -125,14 +125,14 @@ python3 scripts/recover_content.py session.jsonl -o ./feature_xy_history/ After recovery, always verify content: ```bash -# Check file list -ls -lh ./recovered_content/ +# Check directory structure (files preserved in subdirectories) +find ./recovered_content/ -type f -# Read recovery report +# Read recovery report (shows full output paths) cat ./recovered_content/recovery_report.txt -# Spot-check content -head -20 ./recovered_content/ImportantFile.jsx +# Spot-check content (use actual path from report) +head -20 ./recovered_content/src/components/ImportantFile.jsx ``` ## Limitations diff --git a/claude-code-history-files-finder/references/workflow_examples.md b/claude-code-history-files-finder/references/workflow_examples.md index 62c7ab5..20bb0be 100644 --- a/claude-code-history-files-finder/references/workflow_examples.md +++ b/claude-code-history-files-finder/references/workflow_examples.md @@ -40,8 +40,9 @@ python3 scripts/recover_content.py session1.jsonl -k componentName -o ./v1/ python3 scripts/recover_content.py session2.jsonl -k componentName -o ./v2/ python3 scripts/recover_content.py session3.jsonl -k componentName -o ./v3/ -# 4. Compare versions -diff ./v1/componentName.jsx ./v2/componentName.jsx +# 4. Compare versions (files retain original directory structure) +# Use find to locate the file in subdirectories, or reference the recovery_report.txt +find ./v1/ -name "componentName.jsx" -exec diff {} ./v2/{} \; ``` ## Find Session with Specific Implementation