Skip to content

Conversation

@athola
Copy link
Owner

@athola athola commented Jan 3, 2026

Add JSON Resume importer module for converting JSON Resume format to simple-resume YAML. Includes comprehensive field mapping for work experience, education, skills, projects, and contact information.

New features:

  • JSON Resume importer at core/importers/json_resume.py
  • JSON Schema for resume validation (shell/assets/static/schema.json)
  • Extended file_operations to support JSON Resume detection

Documentation:

  • API Reference with complete module documentation
  • API Stability Policy defining versioning guarantees
  • Shell Layer APIs guide for io_utils and runtime modules
  • Updated Getting Started and Usage Guide

Includes comprehensive test coverage for JSON Resume import scenarios.

🤖 Generated with Claude Code

Add JSON Resume importer module for converting JSON Resume format to
simple-resume YAML. Includes comprehensive field mapping for work
experience, education, skills, projects, and contact information.

New features:
- JSON Resume importer at core/importers/json_resume.py
- JSON Schema for resume validation (shell/assets/static/schema.json)
- Extended file_operations to support JSON Resume detection

Documentation:
- API Reference with complete module documentation
- API Stability Policy defining versioning guarantees
- Shell Layer APIs guide for io_utils and runtime modules
- Updated Getting Started and Usage Guide

Includes comprehensive test coverage for JSON Resume import scenarios.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Convert the Shell Layer APIs architecture diagram from ASCII box-drawing
to GitHub-compatible Mermaid flowchart format for better rendering.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@athola
Copy link
Owner Author

athola commented Jan 3, 2026

PR Review Feedback Addressed

All issues from the code review have been fixed in commit 4c9f48f.

In-Scope Issues (1) [FIXED]

ID Issue Resolution
S1 Convert ASCII architecture diagram to GitHub Mermaid Converted to ```mermaid flowchart with subgraphs, proper styling, and labeled connections

Test Results

  • Tests: 1264 passed
  • Coverage: 91.91% (exceeds 85% requirement)
  • Pre-commit hooks: All passed

Issues Closed

Issue Title Status
#13 Support JSON Resume format Closed - JSON Resume importer added
#17 Add schema.json for autocomplete Closed - JSON Schema added

Backlog Issues Created

None - All review items were in-scope.


Ready for re-review. All pre-commit hooks pass.

Update all documentation files to use declarative mood in lead
sentences, replacing imperative constructions with direct
statements. This change improves readability by making
descriptions more natural and less instructional.

Key changes:
- Convert checkmark symbols (✓/✗) to "Yes"/"No" text in tables
- Replace imperative verbs with declarative statements
- Remove redundant legends and explanatory notes
- Tighten language throughout for conciseness

Affected files:
- README.md, PACKAGING.md (main documentation)
- wiki/*.md (all wiki pages)
- src/simple_resume/core/resume.py (docstrings)
- themes/README.md (theme documentation)

This aligns with standard technical writing practices where
descriptions state what something is rather than instructing
what the reader should understand.
Remove excessive <br/> tags from Mermaid diagram node labels that
were causing text overlap with data objects in GitHub's renderer.
Simplified labels for cleaner rendering.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@athola
Copy link
Owner Author

athola commented Jan 4, 2026

PR Review Feedback Addressed

The final issue from the code review has been fixed in commit 4bbd7fd.

In-Scope Issues (1) [FIXED]

ID Issue Resolution
S1 Mermaid diagram breakline overlap Removed excessive <br/> tags from node labels that were causing text overlap in GitHub's Mermaid renderer. Simplified labels for cleaner rendering.

Test Results

  • Tests: 1264 passed
  • Coverage: 91.91% (exceeds 85% requirement)
  • Pre-commit hooks: All passed

Issues Closed

Issue Title Status
#13 Support JSON Resume format Closed - JSON Resume importer added
#17 Add schema.json for autocomplete Closed - JSON Schema added

Issue Linkage Summary

Analyzed 4 open issues - none related to this PR's changes (all are about LLM integration features).

Backlog Issues Created

None - All review items were in-scope.


Ready for re-review. All pre-commit hooks pass.

athola added 3 commits January 3, 2026 23:51
Remove nested ROW1/ROW2 subgraphs from the Shell layer to simplify the
Mermaid flowchart layout. Replace the generic PUBLIC→SHELL re-export edge
with explicit EXPORTS→module edges for generate/, session/, and render/.

This makes the architecture diagram easier to read and better represents
the individual re-export relationships from the PUBLIC layer to each
Shell module.
Add <br/> HTML tag to the SHELL subgraph label in the Mermaid architecture
diagram. This splits the label into two lines ("Shell Layer" and the module
path) and prevents it from overlapping with the nodes inside the subgraph.

Also adds <b> tags to emphasize the layer name for better visual hierarchy.
Remove the module path "(simple_resume.shell.*)" from the SHELL subgraph
label, leaving only "Shell Layer". The shorter label eliminates the
overlap issue with child nodes in the rendered Mermaid diagram.

The module path is already documented in the page title and section
context, so this improves clarity without losing information.
@athola athola merged commit 8b41646 into main Jan 4, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants