- Added tests for all public methods in JsonLinter class
- Added tests for internal helper methods (_check_trailing_commas, _check_indentation,
_check_duplicate_keys, _check_line_length, _check_key_order)
- Added tests for error handling in lint_file and fix_file
- Added tests for settings loading and default settings
- Added tests for violation formatting and compression
- Added direct calls to main() function to cover CLI code paths
- Fixed inline imports by moving StringIO to top-level imports
- Fixed except (SystemExit, Exception): pass to use specific exception types
This improves overall test coverage from 94% to 96%, meeting the project requirement.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Added tests for all uncovered code paths in graph_generator.py:
- TestLoadGraphSettings: tests for loading settings from fiona-settings.json
- MarkdownLinkParser: tests for fragment handling, wikilinks, external URLs,
file parsing error handling, and link validation
- WikiGraphMain: tests for directory validation, settings override, output
directory creation, file writability checks, max_files limit, overwrite
behavior, and exception handling
This increases coverage from 85% to 100% for wiki/graph_generator.py (315/315 statements).
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Move JsonLinter to customlinter package (src/customlinter/jsonlint.py)
- Use JSN001-JSN006 violation codes matching other linters
- Fix circular import by not importing JsonLinter in customlinter/__init__.py
- Fix import sorting to pass ruff checks
- Update all imports to use correct paths
- Fix test to expect LinterError instead of ValueError/OSError
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Move JSON linter from src/json_lint/json_lint.py to src/customlinter/jsonlint.py
- Use JSN prefix for violation codes (JSN001-JSN006) matching other linters
- Rename class from JSONLinter to JsonLinter for consistency
- Update all imports across codebase
- Fix inline import violations for pycustomlint
- Integrate into both sanity checkers (run_sanity.py and wiki/sanity_manager.py)
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Fix hover exit behavior to restore original node size (not minimum)
- Add configurable hover settings in fiona-settings.json:
- hover.color: node highlight color (default: #add8e6)
- hover.edge_color: edge highlight color (default: #0000ff)
- hover.size_multiplier: hover size multiplier (default: 1.3)
- Cap hover size at max_radius to prevent nodes from growing too large
- Update SPEC.md with new configuration options and acceptance criteria
- Update llm-wiki fiona-settings.json with hover configuration
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Migrate PythonCustomLinter to use compressed violation format
- Update SPEC 4.1 and 4.5 to document shared linter format
- Update tests for new format
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Fix markdownlint violations in SPEC.md (MD031, MD040)
- Fix Ruff RUF012 violations in mdoctor.py and python_ruff.py with ClassVar annotations
- Update BaseLinter to handle None target in compress_violations
- Update python_ruff tests to match new BaseLinter format
- Add lint_file test to improve python_ruff coverage to 89%
- Overall coverage improved from 95% to 96%
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Add GitPython dependency to pyproject.toml
- Create gittool/ module with GitTool wrapper class
- Implement all git operations: save, snapshot, restore, clean, undo, status
- Integrate git commands into fiona-assistant CLI as 'fiona-assistant git <command>'
- Auto-initialize git repo on wiki init with .gitignore excluding personal/
- snapshot creates tag with timestamp prefix (yyyy-mm-dd_HH-MM-SS_<tag_name>)
- restore creates new commit (does not modify history)
- Update SPEC.md to reflect implementation
- Add comprehensive tests for gittool module
- All sanity checks pass
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Frontmatter card now appears ONLY on click (not on hover)
- Frontmatter card stays visible together with the blue highlight
- Kept node-info tooltip on hover (follows mouse)
- Only one frontmatter card in upper left of SVG
- Clicking another node switches both highlight and card
- Clicking empty space removes both
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Blue highlight now stays when clicking a node (doesn't disappear on mouseout)
- Frontmatter card appears on hover in upper left of SVG (not on click)
- Frontmatter card hides on mouseout
- Click highlight is independent from hover highlight
- Persistent highlight remains until another node is clicked or empty space is clicked
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Single click on node: highlights node in light blue with 1.3x size, shows frontmatter card in upper left
- Clicking another node switches the highlight
- Clicking on empty space removes highlight
- Double click on node opens file in default editor using file:// URL
- Added frontmatter-card CSS styling
- Added SPEC items 3.1.4.3.8-3.1.4.3.11 for new click behavior
- Fixed SPEC numbering for subsequent items
Note: wiki_graph.html has duplicate nodes from scanning both src/llm-wiki and build/lib/llm-wiki
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Changed search highlight color from yellow to light blue (#add8e6)
- On node hover: node becomes light blue with 1.3x larger size
- On node hover: connected edges change to blue (if they were gray)
- Restores original colors/sizes when mouse leaves or search is cleared
- Updated SPEC.md to document the light blue color
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Search now highlights matching nodes in yellow (#ffff00)
- All neighbor nodes (any degree) are shown in gray (#808080)
- Fixed reanimate button to use correct node object references
- Restores original colors when search is cleared
- All reachable nodes from search remain at full opacity
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Implemented search/filter with degree-based visibility:
- Matching nodes and direct neighbors at full opacity (1.0)
- 2nd degree neighbors at 50% opacity (0.5)
- 3rd degree neighbors at 30% opacity (0.3)
- Other nodes hidden
- Changed orphan nodes from checkbox to toggle button
- Added reanimate button to restart graph animation
- Added layout selector (force-directed, hierarchical)
- Removed export as PNG button
- Updated SPEC.md with new features
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Modified edge highlighting to only decrease visibility of other edges
- Removed stroke-width changes, keeping only opacity modification
- Updated test to check for dimmed opacity (0.2) instead of stroke width
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Added SPEC 3.1.4.3.7: On node hover, highlight all edges connected to that node
- Implemented edge highlighting in graph_template.html with thicker stroke and full opacity
- Added test for edge highlight on hover feature
- Renumbered subsequent SPEC items to maintain consistency
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Increase LINK_STRENGTH from 0.001 to 0.2 (children now follow parent)
- Reduce NEIGHBOR_REPEL_STRENGTH from 1.0 to 0.2 (works with link force)
- Reduce CIRCULAR_FORCE_MULTIPLIER from 1.0 to 0.5
- Increase CHARGE_STRENGTH from -5 to -20 (prevents overlap)
- Decrease CHARGE_DISTANCE_MIN from 150 to 80
- Decrease CHARGE_DISTANCE_MAX from 400 to 200
- Increase ALPHA_DECAY from 0.01 to 0.02 (faster response)
- Decrease ALPHA_MIN from 0.001 to 0.0005 (continuous correction)
- Decrease VELOCITY_DECAY from 0.6 to 0.4 (responsive motion)
How it works: Link force (0.2) pulls children toward parent at 60px.
Circular force (0.2 * 0.5 = 0.1) positions children at correct angles.
Together they maintain: distance = 60px, angle = 360/N.
When parent moves, link force pulls children along.
Grandchildren follow through their link to their parent.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Reduce LINK_STRENGTH from 0.01 to 0.001 (circular force dominates completely)
- Reduce BASE_LINK_DISTANCE from 100 to 60 (children very close to parent)
- Reduce CHARGE_STRENGTH from -10 to -5 (minimal repulsion, only prevents overlap)
- Increase NEIGHBOR_REPEL_STRENGTH from 0.5 to 1.0 (very strong continuous 360deg enforcement)
- Increase CHARGE_DISTANCE_MIN from 100 to 150
- Increase CHARGE_DISTANCE_MAX from 300 to 400
- Rename CIRCULAR EDGE SEPARATION to CIRCULAR LAYOUT FORCE in comments
Key fix: Circular force now runs every tick with very high strength,
continuously correcting any deviation to maintain perfect 360deg division.
Children are rendered very close to their parent (60px vs 100px).
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Rename forceCircularEdgeSeparation to forceCircularLayout
- Use childrenMap from BFS tree instead of adjacency list
- Position children in perfect circles around their parent only
- Reduce VELOCITY_DECAY from 0.9 to 0.6 for fluid motion
- Reduce ALPHA_DECAY from 0.02 to 0.01 for smoother settling
- Increase ALPHA_MIN from 0.0001 to 0.001
Key fix: Circular force now only applies to parent-child relationships
from the BFS tree, ensuring children are positioned in perfect 360deg
circles around their parent, not all neighbors.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Reduce LINK_STRENGTH from 0.15 to 0.01 (circular force now handles positioning)
- Increase BASE_LINK_DISTANCE from 50 to 100 (fixed distance for all links)
- Set LINK_DISTANCE_PER_DEGREE to 0 (no degree-based scaling)
- Reduce CHARGE_STRENGTH from -30 to -10 (very weak, just prevents overlap)
- Increase CHARGE_DISTANCE_MIN from 50 to 100
- Reduce CENTER_STRENGTH from 0.02 to 0.001 (minimal center pull)
- Reduce COLLIDE_STRENGTH from 0.9 to 0.5
- Reduce BASE_COLLIDE_RADIUS from 20 to 15
- Increase VELOCITY_DECAY from 0.7 to 0.9 (immediate stabilization)
- Increase ALPHA_DECAY from 0.01 to 0.02
- Increase NEIGHBOR_REPEL_STRENGTH from 0.1 to 0.5 (STRONG for perfect circles)
- Change targetRadius to use BASE_LINK_DISTANCE directly (fixed radius)
Key insight: Circular force is now the PRIMARY positioning force, while link force
just maintains connections without affecting positions. This ensures nodes
arrange in perfect 360deg circles around their parent like the left cluster.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Reduce LINK_STRENGTH from 0.2 to 0.15 for balanced pull
- Increase BASE_LINK_DISTANCE from 40 to 50 for better spacing
- Reduce CHARGE_STRENGTH from -60 to -30 to prevent over-repulsion
- Increase CENTER_STRENGTH from 0.01 to 0.02 for gentle centering
- Reduce VELOCITY_DECAY from 0.4 to 0.7 for smoother, more damped motion
- Increase ALPHA_DECAY from 0.008 to 0.01 for faster settling
- Reduce CIRCULAR_FORCE_MULTIPLIER from 2.5 to 0.5 for stable circular force
- Fix circular force comment to clarify it's a spring-like force
These changes ensure:
- Fluid, stable animation without jitter
- Proper 360 degree edge separation
- Tight parent-child clusters
- Stray nodes pushed away from clusters
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Increase LINK_STRENGTH from 0.05 to 0.2 for tighter parent-child clusters
- Decrease BASE_LINK_DISTANCE from 80 to 40 for closer connected nodes
- Decrease CHARGE_STRENGTH from -40 to -60 for stronger stray node repulsion
- Decrease CENTER_STRENGTH from 0.05 to 0.01 for minimal center pull
- Increase CIRCULAR_FORCE_MULTIPLIER from 2.0 to 2.5 for stronger 360deg division
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Increased NEIGHBOR_REPEL_STRENGTH from 0.03 to 0.08
- Increased CIRCULAR_LAYOUT_STRENGTH from 0.1 to 0.5
- Increased CIRCULAR_RADIUS_MULTIPLIER from 2.5 to 3.0
- Added CIRCULAR_FORCE_MULTIPLIER = 2.0 to amplify force
- Removed distance damping (* 0.1) in circular force calculation
- Force now: NEIGHBOR_REPEL_STRENGTH * alpha * distance * CIRCULAR_FORCE_MULTIPLIER
- This ensures nodes always divide evenly in 360 degree circles
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Link distance now dynamic: 30 + (sourceDegree + targetDegree)
- Collision radius now includes edge padding: nodeRadius + (in_degree + out_degree) * 2
- This simulates edges repelling other nodes by making high-degree nodes have larger
effective collision radius
- Charge: -40 (moderate repulsion)
- Center: 0.08
- Collide strength: 0.6, iterations: 2
- Result: edges effectively repel other nodes and each other via proxy
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Removed .numIterations(300) which is not a valid method in D3 v7
- D3 v7 uses .iterations() on individual forces instead
- Already have iterations(2) on link and collide forces
- Updated test to not require numIterations
- All tests pass (793/793)
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Fixed: numIterations() is a method on d3.forceSimulation, not on forces
- Moved .numIterations(300) to simulation creation chain (first method)
- Added test_generate_html_has_valid_javascript to catch JS syntax errors
- Test verifies valid D3 force simulation method chains in generated HTML
- Prevents errors like 'is not a function' from incorrect method chaining
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Link distance now based on node degree: 60 + (sourceDegree + targetDegree) * 2
- This spreads out hub nodes (high degree) to reduce edge crossings
- Increased link strength from 0.1 to 0.3 for better untangling
- Added link.iterations(2) for faster convergence
- Added theta(0.8) to forceManyBody for performance
- Increased numIterations from default to 300 for better convergence
- Collision radius increased to max(12, in_degree * 3 + 5)
- Result: fewer edge crossings, better spacing between hub nodes
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Use standard D3 forceLink with distance=80, strength=0.1
- Use forceManyBody with strength=-150 for repulsion
- Added distanceMin=60 and distanceMax=300 for repulsion range
- Added forceCollide with radius based on node size for hard overlap prevention
- Very gentle center force (0.05) to keep graph centered
- High velocityDecay (0.8) for stable layout
- Removed custom gravity/repulsion forces, using D3 built-ins
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- Changed repulsion to constant strength: forceManyBody().strength(-3)
- All nodes repel equally regardless of mass
- Heavier nodes resist being pushed via stronger central gravity (0.02 * mass)
- Result: when dragging big node, others don't fly away
- When dragging small node, it moves easily, big nodes stay put via gravity
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>