Commit Graph

185 Commits

Author SHA1 Message Date
nvaldez e9542ccf88 update fiona skill 2026-10-06 11:27:26 +02:00
nvaldez 09362f3951 librarian move specifications 2026-10-02 12:24:54 +02:00
nvaldez 8a00ce97f5 sanity fix 2026-10-02 11:50:26 +02:00
nvaldez 348579a085 license 2026-10-02 11:35:46 +02:00
nvaldez 48b94a5781 graph optimization 2026-10-02 11:33:55 +02:00
nvaldez 44029aee90 wiki update fix, themes versioning, readme refactor, graph ignore 2026-10-01 16:58:19 +02:00
nvaldez c45d4f1d2a Version 1.…11 llm tagging for auto mode 2026-10-01 13:53:04 +02:00
nvaldez 9e98390f2b Version 1.…1.0 SPEC subsection improvement, and wiki update refinement 2026-10-01 11:36:20 +02:00
nvaldez 482b2cb2e0 ingest implemented 2026-10-01 07:04:55 +02:00
nvaldez 2d08b71b55 new custom pylint to enforce no late declaration 2026-09-30 23:37:59 +02:00
nvaldez a1fccbe641 housekeeping and fiona skill overhaul 2026-09-30 21:24:29 +02:00
nvaldez da01b3fe4a housekeeping and fiona skill overhaul 2026-09-30 21:19:47 +02:00
nvaldez 94d3554d77 update themes 2026-09-30 17:10:12 +02:00
nvaldez b93a5a0c02 bump version and update themes 2026-09-30 13:37:01 +02:00
nvaldez 0907252d4c fiona skill improvement, and local non edit bootstrap install 2026-09-30 11:06:02 +02:00
nvaldez 3471ff9fe6 themes revisit 2026-09-30 08:53:47 +02:00
nvaldez 32920d1736 Major graph refactor, better physics, themes, etc 2026-09-30 08:34:27 +02:00
nvaldez fd58ad549a refactor fiona src to have single module 2026-09-29 16:01:16 +02:00
nvaldez 6e334cc34d major refactor of spec 2026-09-29 14:35:51 +02:00
nvaldez e6920aa691 windows bootstrap implemented 2026-09-29 10:04:57 +02:00
nvaldez 9b54aebe14 test: add comprehensive tests for jsonlint to achieve 96% coverage
- 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>
2026-09-29 08:42:05 +02:00
nvaldez 4365f291ae test: add comprehensive tests for wiki/graph_generator.py to achieve 100% coverage
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>
2026-09-28 21:32:46 +02:00
nvaldez f0dccf726c refactor: fix JSON linter imports and violations for project standards
- 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>
2026-09-28 21:08:13 +02:00
nvaldez 814bad2866 feat: add JSON linter (jsonlint) to customlinter package
- 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>
2026-09-28 20:55:07 +02:00
nvaldez 90e7055dbd feat: add JSON linter (json-lint) module with full integration
- Implement src/json_lint/json_lint.py with JSON syntax and style validation
- Support JSON syntax validation using standard json module
- Add style rules: indentation (space/tab), trailing commas, duplicate keys, key ordering, line length
- Add CLI integration: fiona-assistant json-lint chklint [directory]
- Support --fix flag for auto-fixing certain violations
- Add settings support via fiona-settings.json (json section)
- Integrate into run_sanity.py sanity checker
- Integrate into wiki/sanity_manager.py wiki sanity checker
- Add comprehensive TDD tests (25 tests)
- Update pyproject.toml with json-lint entry point

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 20:45:30 +02:00
nvaldez f1a12ae1f6 feat: add configurable hover settings for wiki graph
- 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>
2026-09-28 20:32:59 +02:00
nvaldez 7639abeaa6 feat: generalize linter violation format (SPEC 4.3.1, 4.9.3)
- 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>
2026-09-28 20:00:25 +02:00
nvaldez 1f70f184af fix: resolve sanity check failures
- 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>
2026-09-28 19:42:21 +02:00
nvaldez 22835f9efc feat: implement git version control for llm-wiki (SPEC 3.2)
- 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>
2026-09-28 17:50:29 +02:00
nvaldez fa1842cd63 fix: frontmatter card only appears on click and stays with highlight
- 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>
2026-09-28 16:50:59 +02:00
nvaldez 5ea410b80c fix: make blue highlight persistent on click and show frontmatter card on hover
- 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>
2026-09-28 16:47:16 +02:00
nvaldez a43f7f044e feat: add node click to highlight with frontmatter card display
- 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>
2026-09-28 16:43:12 +02:00
nvaldez aa85703d69 fix: change highlight color to light blue and add node hover effects
- 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>
2026-09-28 16:36:56 +02:00
nvaldez 202c2dd63c fix: simplify graph controls and improve search highlighting
- Make matching nodes 1.5x bigger in search results
- All neighbor nodes shown in gray (any degree)
- Removed layout dropdown (not functional)
- Removed reanimate button (not working)
- Updated SPEC.md to reflect current features

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 16:30:19 +02:00
nvaldez 781ac7ca8f fix: update search to highlight matching nodes in yellow and neighbors in gray
- 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>
2026-09-28 16:26:54 +02:00
nvaldez 6dcae18033 feat: improve wiki graph controls and search functionality
- 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>
2026-09-28 16:22:56 +02:00
nvaldez d91b2a6144 fix: update edge highlight to only use opacity (no stroke width change)
- 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>
2026-09-28 16:12:33 +02:00
nvaldez 2772886de3 feat: add edge highlighting on node hover for wiki graph
- 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>
2026-09-28 16:02:56 +02:00
nvaldez 93ddf5b5cc fix: make children follow parent when dragged with proper 360deg layout
- 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>
2026-09-28 15:48:02 +02:00
nvaldez 1dd9befa40 fix: make circular force very strong for continuous 360deg division with close children
- 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>
2026-09-28 15:44:01 +02:00
nvaldez 07a3ec9ebc fix: use BFS tree hierarchy for circular layout instead of adjacency
- 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>
2026-09-28 15:41:05 +02:00
nvaldez 24b510310f fix: make circular force dominant for perfect 360deg node positioning
- 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>
2026-09-28 15:33:12 +02:00
nvaldez 62d8b88210 fix: balance physics parameters for fluid animation and stable 360deg separation
- 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>
2026-09-28 15:30:50 +02:00
nvaldez 9f3a1de6f2 feat: adjust physics parameters for tight clusters and 360deg separation
- 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>
2026-09-28 15:29:24 +02:00
nvaldez d8f109f150 feat: significantly strengthen 360 degree circular edge separation
- 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>
2026-09-28 15:26:59 +02:00
nvaldez 2b65128004 fix: graph template physics and code quality
- Adjusted graph physics parameters for better edge separation
  - Increased CHARGE_STRENGTH to -40 for stronger node repulsion
  - Increased BASE_LINK_DISTANCE to 50 and LINK_STRENGTH to 0.1
  - Increased collision radii (BASE_COLLIDE_RADIUS=12, EDGE_PADDING_MULTIPLIER=2.5)
- Removed expensive custom forces (node-edge repulsion, edge-edge collision)
  that were causing browser performance issues
- Fixed SPEC.md line length violation (MD013)
- Fixed inline import in graph_generator.py (PYC001)
- Edge stroke width reduced from 2 to 1

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 14:30:30 +02:00
nvaldez f427dc5819 refactor: wiki graph - extract all physics parameters to editable constants
Added configuration section at top of JavaScript with:

PHYSICS PARAMETERS:
- LINK_STRENGTH: 0.2 (connection pull strength)
- BASE_LINK_DISTANCE: 25 (base spacing)
- LINK_DISTANCE_PER_DEGREE: 1 (extra spacing per degree)
- CHARGE_STRENGTH: -30 (repulsion)
- CHARGE_DISTANCE_MIN/MAX: 15/150 (repulsion range)
- CENTER_STRENGTH: 0.15 (center pull - increase for tighter center)
- COLLIDE_STRENGTH: 0.5 (bounciness)
- BASE_COLLIDE_RADIUS: 8 (base node size)
- COLLIDE_PER_DEGREE: 2 (extra size per degree)
- EDGE_PADDING_MULTIPLIER: 1.5 (simulates edge repulsion)

TIMING PARAMETERS:
- ALPHA_DECAY: 0 (never settles)
- ALPHA_MIN: 0.5 (safety)
- VELOCITY_DECAY: 0.6 (fluidity)

User can now easily adjust CENTER_STRENGTH for stronger central pull.

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 13:31:53 +02:00
nvaldez 0ba3cd6561 fix: wiki graph - never-stopping animation with alphaDecay=0
- alphaDecay: 0 (NEVER decays) - simulation stays at alpha=1.0 forever
- alphaMin: 0.5 (safety net)
- Forces remain at full strength indefinitely
- velocityDecay: 0.6 (fluid motion)
- Result: nodes never stop moving, continuously rearrange like Obsidian

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 13:27:35 +02:00
nvaldez f6806769a1 fix: wiki graph - faster initial animation + never-ending continuous motion
- alphaDecay: 0.05 (faster initial convergence)
- alphaMin: 0.2 (never settles, always moving)
- velocityDecay: 0.6 (more fluid motion)
- Result: animation reaches good separation quickly, then keeps moving fluidly

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 13:24:12 +02:00
nvaldez 34e9b8cbf8 fix: wiki graph - continuous motion + stronger center gravity for tighter clusters
- Link distance: 25 + (sourceDegree + targetDegree) (tighter)
- Charge: -30 (weaker repulsion)
- Center: 0.15 (stronger pull)
- Collide edgePadding: (in_degree + out_degree) * 1.5
- alphaMin: 0.1 (high - keeps continuous motion like picture 2)
- alphaDecay: 0.01 (slow decay)
- velocityDecay: 0.7
- Result: nodes continuously move and form tight hub-and-spoke clusters

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-09-28 13:17:11 +02:00