Skip to content

plan.md

Latest commit

 

History

History
76 lines (60 loc) · 3.21 KB

plan.md

File metadata and controls

76 lines (60 loc) · 3.21 KB

Project Roadmap & Evolution

This document tracks the phased evolution of Skelecode from inception to the stable v1.0 release.

Completed Phases

✅ Phase 1: Core Foundation

  • Defined Unified IR (Intermediate Representation).
  • Implemented basic Rust parser with Tree-sitter.
  • Created Machine Context renderer for AI-ready output.

✅ Phase 2: CLI & TUI

  • Robust CLI with Clap.
  • Interactive TUI using Ratatui.
  • Support for language filtering and exclusions.

✅ Phase 3: Java Support

  • Full Java parser (class, interface, enum, record).
  • Integration with Unified IR.

✅ Phase 4: Kotlin Support

  • Kotlin parser (data classes, objects, properties).
  • Support for Kotlin-specific constructs.

✅ Phase 5: JavaScript & TypeScript Support

  • Parsers for .js, .ts, .jsx, .tsx.
  • Support for functional and class-based patterns.
  • Module-as-file mapping for JS ecosystem.

✅ Phase 6: Obsidian Vault Migration

  • Removed legacy Mermaid.js renderer due to scalability limits.
  • Implemented Obsidian Vault Renderer generating interlinked Markdown files.
  • Added Visual Topology via native Obsidian Canvas generation.

✅ Phase 7: Call Resolution (Level 1)

  • Resolve this/self calls to current type.
  • Resolve calls on fields with explicit types.
  • Resolve calls on method/function parameters.
  • base_type() strips &mut, Box<>, Arc<>, Option<>, ? decorators.

✅ Phase 8: Call Resolution (Level 2)

  • Parse import/use statements for all languages.
  • Map type aliases to fully qualified paths.
  • Cross-module call graph edges in Obsidian Graph View.
  • Auto-exclude build output directories (target/, bin/, build/, etc.).

✅ Phase 9: UI Polish & Export Enhancements

  • Richer Dataview/Juggl metadata in Obsidian vault (YAML frontmatter, inline fields, edge labels).
  • Fields rendered as Markdown tables; relations with edge-label:: hints.
  • TUI "Obsidian Preview" tab shows per-type/method/function Obsidian markdown.
  • Copy to Clipboard (y) for current detail panel content.
  • Back navigation (Esc/b) from main view to welcome screen.
  • Structure panel scrolling with ListState.
  • Detail panel scrolling with u/d.

Future Roadmap

✅ Phase 10: Reverse Call Graph

  • Added CallerRef to IR; callers: Vec<CallerRef> on Method and Function.
  • resolve_reverse_calls() post-processes forward call graph to populate reverse edges.
  • Machine Context emits @callers[...] alongside @calls[...].
  • Obsidian vault emits called-by:: inline fields with Juggl-compatible links.
  • TUI Detail panel shows "Called by" section for method and function nodes.

✅ Phase 11: Python Support

  • Parser for Python (classes, functions, imports, decorators).
  • typed_parameter extraction, __init__ field inference, self.* call tracking.
  • Map to Unified IR; integrated into TUI, CLI, and Obsidian/Machine renderers.

✅ Phase 12: Symbol Search

  • Press / to enter search mode; type to filter the structure tree in real-time.
  • Matched text highlighted (yellow background) in tree; parent module shown as context.
  • Enter commits filter (stays active for navigation); Esc clears filter.
  • Match count shown in tree title bottom; search bar replaces help bar while active.