feat: add export engine and command aliases

- Add tree_printer module for directory tree export functionality
- Add --export mode with filtering options (--exclude-dirs, --exclude-files, --only-type, etc.)
- Add treenav and tn aliases via justfile install-tn target
- Add STATE.scm for project state tracking
- Add SPDX-License-Identifier headers to all Ada source files
- Enhanced main.adb with comprehensive CLI argument parsing

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Jonathan D.A. Jewell

STATE.scm

@@ -0,0 +1,101 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; STATE.scm - Tree Navigator project state
+;; Updated: 2025-12-31
+
+(define state
+  `((metadata
+     (version . "2.1.0")
+     (schema-version . "1.0")
+     (created . "2024-11-06")
+     (updated . "2025-12-31")
+     (project . "tree-navigator")
+     (repo . "https://github.com/hyperpolymath/tree-navigator"))
+
+    (project-context
+     (name . "Tree Navigator")
+     (tagline . "Directory tree visualization and export tool")
+     (tech-stack . (ada-2022 gnat gprbuild)))
+
+    (current-position
+     (phase . "mvp-completion")
+     (overall-completion . 75)
+     (components
+      ((interactive-mode
+        (status . complete)
+        (completion . 100))
+       (export-mode
+        (status . just-implemented)
+        (completion . 90))
+       (filtering
+        (status . implemented)
+        (completion . 85))
+       (tui-interface
+        (status . planned)
+        (completion . 0))
+       (printer-support
+        (status . planned)
+        (completion . 0))))
+     (working-features
+      interactive-navigation
+      bookmarks
+      file-type-detection
+      directory-exclusion
+      file-exclusion
+      tree-export
+      statistics))
+
+    (route-to-mvp
+     ((milestone . "v2.1.0-export")
+      (status . in-progress)
+      (items
+       ((item . "Create tree_printer module")
+        (status . done))
+       ((item . "Add --export flag to main.adb")
+        (status . done))
+       ((item . "Add treenav alias")
+        (status . done))
+       ((item . "Test build and export")
+        (status . pending))
+       ((item . "Update CHANGELOG")
+        (status . pending))))
+     ((milestone . "v2.2.0-tui")
+      (status . planned)
+      (items
+       ((item . "Ada/SPARK TUI framework")
+        (status . planned))
+       ((item . "ncurses or custom terminal UI")
+        (status . planned))
+       ((item . "Real-time tree navigation display")
+        (status . planned)))))
+
+    (blockers-and-issues
+     (critical . ())
+     (high
+      ((issue . "Build not yet tested with new tree_printer module")
+       (impact . "Cannot verify export functionality works")))
+     (medium
+      ((issue . "README documents features not yet implemented")
+       (impact . "User expectations mismatch")))
+     (low . ()))
+
+    (critical-next-actions
+     (immediate
+      ("Test gprbuild with new tree_printer module"
+       "Verify export functionality works"
+       "Update version to 2.1.0"))
+     (this-week
+      ("Add SPDX headers to all Ada source files"
+       "Update CHANGELOG.md for v2.1.0"
+       "Create v2.1.0 release"))
+     (this-month
+      ("Research Ada/SPARK TUI options"
+       "Plan printer integration"
+       "Consider winget submission like bunsenite")))
+
+    (session-history
+     ((date . "2025-12-31")
+      (accomplishments
+       "Created tree_printer.ads/adb export engine"
+       "Updated main.adb with --export flag handling"
+       "Added treenav alias to justfile"
+       "Created STATE.scm")))))

justfile

@@ -426,28 +426,35 @@ ci-deploy-stage:
     @echo "🚀 CI Deploy stage"
     @echo "Not implemented yet"
 
-# Install with short alias 'tn'
+# Install with short aliases 'tn' and 'treenav'
 install-tn: release
-    @echo "📦 Installing Tree Navigator with 'tn' alias..."
+    @echo "📦 Installing Tree Navigator with aliases..."
     sudo install -m 755 bin/main /usr/local/bin/tn
+    sudo ln -sf /usr/local/bin/tn /usr/local/bin/treenav
     sudo ln -sf /usr/local/bin/tn /usr/local/bin/tree-navigator
     sudo mkdir -p /usr/local/share/man/man1
     sudo cp man/tree-navigator.1 /usr/local/share/man/man1/
+    sudo ln -sf tree-navigator.1.gz /usr/local/share/man/man1/tn.1.gz 2>/dev/null || true
+    sudo ln -sf tree-navigator.1.gz /usr/local/share/man/man1/treenav.1.gz 2>/dev/null || true
     sudo gzip -f /usr/local/share/man/man1/tree-navigator.1
     sudo mandb 2>/dev/null || true
     @echo "✅ Installed!"
     @echo ""
-    @echo "Use: tn --help"
-    @echo "Or:  tree-navigator --help"
+    @echo "Commands available:"
+    @echo "  tn             # shortest"
+    @echo "  treenav        # medium"
+    @echo "  tree-navigator # full name"
     @echo ""
-    @echo "Add shell alias:"
-    @echo "  echo \"alias tn='tree-navigator'\" >> ~/.bashrc"
+    @echo "Try: tn --help"
 
-# Uninstall tn
+# Uninstall tn, treenav, and tree-navigator
 uninstall-tn:
     @echo "🗑️  Uninstalling Tree Navigator..."
     sudo rm -f /usr/local/bin/tn
+    sudo rm -f /usr/local/bin/treenav
     sudo rm -f /usr/local/bin/tree-navigator
     sudo rm -f /usr/local/share/man/man1/tree-navigator.1.gz
+    sudo rm -f /usr/local/share/man/man1/tn.1.gz
+    sudo rm -f /usr/local/share/man/man1/treenav.1.gz
     sudo mandb 2>/dev/null || true
     @echo "✅ Uninstalled"

src/bookmarks.adb

@@ -1,3 +1,5 @@
+-- SPDX-License-Identifier: AGPL-3.0-or-later
+-- Bookmark management implementation
 pragma Ada_2022;
 with Ada.Text_IO; use Ada.Text_IO;
 with Ada.Directories;

src/bookmarks.ads

@@ -1,3 +1,4 @@
+-- SPDX-License-Identifier: AGPL-3.0-or-later
 -- Bookmark management with persistence
 pragma Ada_2022;
 with Ada.Calendar;

src/config.adb

@@ -1,3 +1,5 @@
+-- SPDX-License-Identifier: AGPL-3.0-or-later
+-- Configuration management implementation
 pragma Ada_2022;
 
 package body Config is

src/config.ads

@@ -1,3 +1,4 @@
+-- SPDX-License-Identifier: AGPL-3.0-or-later
 -- Configuration management with strong typing
 pragma Ada_2022;
 

src/file_types.adb

@@ -1,3 +1,5 @@
+-- SPDX-License-Identifier: AGPL-3.0-or-later
+-- File type detection implementation
 pragma Ada_2022;
 with Ada.Strings.Fixed;
 

src/file_types.ads

@@ -1,3 +1,4 @@
+-- SPDX-License-Identifier: AGPL-3.0-or-later
 -- File type detection and classification
 pragma Ada_2022;
 with Ada.Directories;