feat: Strategic pivot to CLI implementation with comprehensive foundation

Major gap analysis reveals critical missing CLI interface despite solid library foundation.
This commit implements core components and strategic roadmap pivot.

Key Changes:
- NEXT.md: Complete strategic roadmap pivot to CLI-first implementation
- FEATURES.md: Comprehensive USP and architecture documentation
- markitect/ast_cache.py: High-performance AST caching system
- markitect/document_manager.py: Parse-once architecture implementation
- docs/markitect.1: CLI interface manpage documentation

Foundation Status:
- All 45 tests passing (solid library base)
- AST caching with <50% parse time performance goal
- Database integration ready for CLI integration
- TDD8 methodology fully operational

Strategic Pivot:
- Previous: Continue with Issues #2-4 (database expansion)
- New Priority: Issue #5 - CLI Entry Point implementation
- Goal: Transform library capabilities into user-accessible tools

Next Session: Implement CLI interface using Click/Typer framework
to deliver documented vision and core USPs.

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

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

.ast_cache/integration_test.md.ast.json

@@ -0,0 +1,231 @@
+[
+  {
+    "type": "hr",
+    "tag": "hr",
+    "attrs": {},
+    "map": [
+      0,
+      1
+    ],
+    "nesting": 0,
+    "level": 0,
+    "content": "",
+    "markup": "----",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "heading_open",
+    "tag": "h2",
+    "attrs": {},
+    "map": [
+      1,
+      4
+    ],
+    "nesting": 1,
+    "level": 0,
+    "content": "",
+    "markup": "-",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "inline",
+    "tag": "",
+    "attrs": {},
+    "map": [
+      1,
+      3
+    ],
+    "nesting": 0,
+    "level": 1,
+    "children": [
+      {
+        "type": "text",
+        "tag": "",
+        "attrs": {},
+        "nesting": 0,
+        "level": 0,
+        "content": "title: Integration Test",
+        "markup": "",
+        "info": "",
+        "meta": {},
+        "block": false,
+        "hidden": false
+      },
+      {
+        "type": "softbreak",
+        "tag": "br",
+        "attrs": {},
+        "nesting": 0,
+        "level": 0,
+        "content": "",
+        "markup": "",
+        "info": "",
+        "meta": {},
+        "block": false,
+        "hidden": false
+      },
+      {
+        "type": "text",
+        "tag": "",
+        "attrs": {},
+        "nesting": 0,
+        "level": 0,
+        "content": "category: testing",
+        "markup": "",
+        "info": "",
+        "meta": {},
+        "block": false,
+        "hidden": false
+      }
+    ],
+    "content": "title: Integration Test\ncategory: testing",
+    "markup": "",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "heading_close",
+    "tag": "h2",
+    "attrs": {},
+    "nesting": -1,
+    "level": 0,
+    "content": "",
+    "markup": "-",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "heading_open",
+    "tag": "h1",
+    "attrs": {},
+    "map": [
+      5,
+      6
+    ],
+    "nesting": 1,
+    "level": 0,
+    "content": "",
+    "markup": "#",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "inline",
+    "tag": "",
+    "attrs": {},
+    "map": [
+      5,
+      6
+    ],
+    "nesting": 0,
+    "level": 1,
+    "children": [
+      {
+        "type": "text",
+        "tag": "",
+        "attrs": {},
+        "nesting": 0,
+        "level": 0,
+        "content": "Integration Test",
+        "markup": "",
+        "info": "",
+        "meta": {},
+        "block": false,
+        "hidden": false
+      }
+    ],
+    "content": "Integration Test",
+    "markup": "",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "heading_close",
+    "tag": "h1",
+    "attrs": {},
+    "nesting": -1,
+    "level": 0,
+    "content": "",
+    "markup": "#",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "paragraph_open",
+    "tag": "p",
+    "attrs": {},
+    "map": [
+      7,
+      8
+    ],
+    "nesting": 1,
+    "level": 0,
+    "content": "",
+    "markup": "",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "inline",
+    "tag": "",
+    "attrs": {},
+    "map": [
+      7,
+      8
+    ],
+    "nesting": 0,
+    "level": 1,
+    "children": [
+      {
+        "type": "text",
+        "tag": "",
+        "attrs": {},
+        "nesting": 0,
+        "level": 0,
+        "content": "Testing database integration.",
+        "markup": "",
+        "info": "",
+        "meta": {},
+        "block": false,
+        "hidden": false
+      }
+    ],
+    "content": "Testing database integration.",
+    "markup": "",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  },
+  {
+    "type": "paragraph_close",
+    "tag": "p",
+    "attrs": {},
+    "nesting": -1,
+    "level": 0,
+    "content": "",
+    "markup": "",
+    "info": "",
+    "meta": {},
+    "block": true,
+    "hidden": false
+  }
+]