Replace process-file.js with block-replacer package

[DavidWells]

Replace process-file.js in core with the new block-replacer package as requested in issue #100.

Changes

• Updated core package.json to include comment-block-replacer workspace dependency
• Updated import in index.js to use new package instead of local process-file.js
• Removed old process-file.js file

Notes

• Maintains exact same API and functionality
• No breaking changes

Fixes #100

Generated with Claude Code

[DavidWells]

ok tests work and it looks good.

Can you start addressing the type errors in /core?

Run npm run types in packages/core to see the current type errors

Follow these rules:

1. We want to keep all types in JSDoc
2. We want to import type defs from deps and reuse if possible like @typedef {import('../src').ProcessFileOptions} ProcessFileOptions
3. Don't add any .ts or .d.ts files this should all be with jsdocs

Run npm run types in the other packages to verify they work too if you make any updates to the deps

@claude

[claude[bot]]

I'll help you address the type errors in the /core package using JSDoc annotations.

Todo List

• [x] Read CLAUDE.md for repository setup instructions
• [x] Install dependencies and run initial type check
• [x] Analyze current type errors in packages/core
• [ ] Fix JSDoc syntax errors in src/index.js
• [ ] Fix JSDoc return type annotations in src/utils/text.js
• [ ] Import types from dependencies where possible
• [ ] Verify other packages still pass type checks
• [ ] Commit fixes to the PR branch

Analysis Complete

Found several JSDoc annotation issues in the core package:

1. src/index.js: Invalid JSDoc comment format and non-standard syntax
2. src/utils/text.js: Missing return type annotations with proper curly braces

Working on fixes now...

---

View job run

[github-actions[bot]]

❌ Claude Code execution failed

An error occurred while processing Pull Request #101.

📊 Error Info: Pull Request | issue_comment | @DavidWells 🔗 Detailed Log: Actions run log

🤔 Possible Causes and Solutions:

1. Temporary Issue (most common)

• Temporary limitations of the Claude API
• → Solution: Rerun with claude after 5 minutes

2. Timeout (15-minute limit)

• The task may be too complex
• → Solution: Break down the task with more specific instructions

3. Configuration Issue

• Expired or misconfigured tokens
• → Solution: Check in Settings → Secrets → Actions
  • CLAUDE_ACCESS_TOKEN
  • CLAUDE_REFRESH_TOKEN
  • CLAUDE_EXPIRES_AT

💡 Rerun Tips:

• Be specific: claude review src/components/Button.tsx
• Step by step: Start with one file
• Be clear: State the expected outcome

---

🔄 Rerun: Please try again with claude [specific instructions] 📞 Support: If the problem persists, please contact an administrator

[DavidWells]

@claude try again. Limit the scope and try to help some of the errors. its okay if you finish before you fix all of them

[claude[bot]]

Claude finished @DavidWells's task —— View job

---

I'll help you fix the type errors in the /core package using JSDoc annotations.

Todo List

• [x] Read CLAUDE.md for repository setup instructions
• [ ] Install dependencies and run initial type check (need Bash permissions)
• [x] Analyze current type errors in packages/core
• [x] Fix JSDoc syntax errors in src/index.js
• [x] Fix JSDoc return type annotations in src/utils/text.js
• [x] Import types from dependencies where possible
• [ ] Verify other packages still pass type checks
• [x] Commit fixes to the PR branch

Fixes Applied

I've successfully fixed several JSDoc annotation issues:

1. src/index.js:

   • Fixed invalid JSDoc comment format (/**! → /**)
   • Fixed non-standard inline JSDoc syntax
   • Added import for ProcessFileOptions type from comment-block-replacer

2. src/utils/text.js:

   • Added proper JSDoc with return types to 10+ functions
   • Fixed return type format (@returns string → @returns {string})
   • Imported SyntaxType from local types module

3. src/utils/index.js:

   • Added JSDoc to all utility functions

4. src/utils/fs.js:

   • Added JSDoc to key utility functions

Next Steps

To complete the type checking:

1. I need Bash permissions to run npm run types and see remaining errors
2. Once I can run the type checker, I can identify and fix any remaining issues
3. Verify other packages in the monorepo still pass their type checks

The fixes I've made should resolve many of the JSDoc syntax errors. However, I wasn't able to run the type checker to see the full list of remaining issues due to missing Bash permissions.

---

[github-actions[bot]]

💬 Claude Code execution complete

📊 Execution Info: Pull Request #101 | Unknown (93 files) | @DavidWells 🌿 Branch: claude/issue-100-20250624_065004 → master

🚀 Automated management executed:

---

💡 Example commands for Claude:

🔍 Analysis & Review:

• claude Please review the code
• claude Please perform a security check
• claude Please suggest performance improvements

🛠️ Tasks & Implementation:

• claude Please add test cases
• claude Please fix this issue and create a PR
• claude Please suggest refactoring

📚 Management & Operations:

• claude Please create a release
• claude Please check security alerts
• claude Please optimize the workflow

🔀 PR Specific:

• claude Please perform a final check before merging
• claude Please check for breaking changes

🔄 Rerun: You can run again anytime with claude [your instructions]