htmlgraph 0.24.2__py3-none-any.whl → 0.25.0__py3-none-any.whl

{htmlgraph-0.24.2.dist-info → htmlgraph-0.25.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgraph
-Version: 0.24.2
+Version: 0.25.0
 Summary: HTML is All You Need - Graph database on web standards
 Project-URL: Homepage, https://github.com/Shakes-tzd/htmlgraph
 Project-URL: Documentation, https://github.com/Shakes-tzd/htmlgraph#readme
@@ -19,11 +19,14 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Database
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: fastapi>=0.104.0
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: justhtml>=0.6.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typing-extensions>=4.0.0; python_version < '3.11'
+Requires-Dist: uvicorn>=0.24.0
 Requires-Dist: watchdog>=3.0.0
 Provides-Extra: deploy
 Requires-Dist: invoke>=2.2.0; extra == 'deploy'
@@ -35,7 +38,9 @@ Requires-Dist: pdoc>=14.0.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'dev'
 Provides-Extra: sqlite
 Requires-Dist: aiosqlite>=0.19.0; extra == 'sqlite'
 Description-Content-Type: text/markdown
@@ -81,71 +86,47 @@ This bootstraps:
 - `.htmlgraph/index.sqlite` analytics cache (rebuildable; gitignored via `.gitignore`)
 - versioned hook scripts under `.htmlgraph/hooks/` (installed into `.git/hooks/` with `--install-hooks`)
 
-### Python
+### Python (SDK - Recommended)
 
 ```python
-from htmlgraph import HtmlGraph, Node, Edge, Step
-
-# Initialize graph from directory
-graph = HtmlGraph("features/")
-
-# Create a node
-node = Node(
-    id="feature-001",
-    title="User Authentication",
-    type="feature",
-    status="in-progress",
-    priority="high",
-    steps=[
-        Step(description="Create auth routes"),
-        Step(description="Add middleware"),
-        Step(description="Implement OAuth"),
-    ],
-    edges={
-        "blocked_by": [Edge(target_id="feature-002", title="Database Schema")]
-    }
-)
-
-# Add to graph (creates HTML file)
-graph.add(node)
-
-# Query with CSS selectors
-blocked = graph.query("[data-status='blocked']")
-high_priority = graph.query("[data-priority='high']")
-
-# Graph traversal
-path = graph.shortest_path("feature-001", "feature-010")
-deps = graph.transitive_deps("feature-001")
-bottlenecks = graph.find_bottlenecks()
-
-# Get lightweight context for AI agents (~50 tokens)
-print(node.to_context())
-# Output:
-# # feature-001: User Authentication
-# Status: in-progress | Priority: high
-# Progress: 0/3 steps (0%)
-# ⚠️  Blocked by: Database Schema
-# Next: Create auth routes
-```
-
-### Agent Interface
-
-```python
-from htmlgraph.agents import AgentInterface
-
-agent = AgentInterface("features/", agent_id="claude")
-
-# Get next available task
-task = agent.get_next_task(priority="high")
-
-# Get lightweight context
-context = agent.get_context(task.id)
-
-# Update progress
-agent.complete_step(task.id, step_index=0)
-
-# Complete task
-agent.complete_task(task.id)
+from htmlgraph import SDK
+
+# Initialize (auto-discovers .htmlgraph directory)
+sdk = SDK(agent="claude")
+
+# Create and configure a feature with fluent API
+feature = sdk.features.create("User Authentication") \
+    .set_priority("high") \
+    .set_description("Implement OAuth 2.0 login") \
+    .add_steps([
+        "Create login endpoint",
+        "Add JWT middleware",
+        "Write integration tests"
+    ]) \
+    .save()
+
+print(f"Created: {feature.id}")
+
+# Work on features
+with sdk.features.edit(feature.id) as f:
+    f.status = "in-progress"
+    f.agent_assigned = "claude"
+    f.steps[0].completed = True
+
+# Query features
+high_priority_todos = sdk.features.where(status="todo", priority="high")
+for feat in high_priority_todos:
+    print(f"- {feat.id}: {feat.title}")
+
+# Create and configure a track with TrackBuilder
+track = sdk.tracks.builder() \
+    .title("Q1 Security Initiative") \
+    .priority("high") \
+    .add_feature("feature-001") \
+    .add_feature("feature-002") \
+    .create()
+
+print(f"Created track: {track.id}")
 ```
 
 ### HTML File Format
@@ -203,6 +184,43 @@ HtmlGraph nodes are standard HTML files:
 - **Deployment Automation** - One-command releases with version management
 - **Unified Backend** - Operations layer shared by CLI and SDK for consistency
 
+## Orchestrator Architecture: Flexible Multi-Agent Coordination
+
+HtmlGraph implements an orchestrator pattern that coordinates multiple AI agents in parallel, preserving context efficiency while maintaining complete flexibility in model selection. Instead of rigid rules, the pattern uses **capability-first thinking** to choose the right tool (and model) for each task.
+
+**Key Principles:**
+- ✅ **Flexible model selection** - Any model can do any work; choose based on task fit and cost
+- ✅ **Dynamic spawner composition** - Mix and match spawner types (Gemini, Copilot, Codex, Claude) within the same workflow
+- ✅ **Cost optimization** - Use cheaper models for exploratory work, expensive models only for reasoning
+- ✅ **Parallel execution** - Independent tasks run simultaneously, reducing total time
+
+**Example: Parallel Exploration with Multiple Spawners**
+
+```python
+# All run in parallel - each uses the best tool for the job
+Task(subagent_type="gemini-spawner",    # FREE exploration
+     prompt="Find all authentication patterns in src/auth/")
+
+Task(subagent_type="copilot-spawner",   # GitHub integration
+     prompt="Check GitHub issues related to auth",
+     allow_tools=["github(*)"])
+
+Task(subagent_type="claude-spawner",    # Deep reasoning
+     prompt="Analyze auth patterns for security issues")
+
+# Orchestrator coordinates, subagents work in parallel
+# Total time = slowest task (not sum of all)
+# Cost = optimized (cheap exploration + expensive reasoning only)
+```
+
+**Spawner Types:**
+- **Gemini Spawner** - FREE exploratory research, batch analysis (2M tokens/min)
+- **Copilot Spawner** - GitHub-integrated workflows, git operations
+- **Codex Spawner** - Code generation, coding completions
+- **Claude Spawner** - Deep reasoning, analysis, strategic planning (any Claude model)
+
+→ [Complete Orchestrator Architecture Guide](docs/orchestrator-architecture.md) - Detailed patterns, cost optimization, decision framework, and advanced examples
+
 ## Comparison
 
 | Feature | Neo4j | JSON | HtmlGraph |
@@ -257,6 +275,15 @@ uv run python
 
 MIT
 
+## System Prompt & Delegation Documentation
+
+For Claude Code users and teams using HtmlGraph for AI agent coordination:
+
+- **[System Prompt Quick Start](docs/SYSTEM_PROMPT_QUICK_START.md)** - Setup your system prompt in 5 minutes (start here!)
+- **[System Prompt Architecture](docs/SYSTEM_PROMPT_ARCHITECTURE.md)** - Technical deep dive + troubleshooting
+- **[Delegation Enforcement Admin Guide](docs/DELEGATION_ENFORCEMENT_ADMIN_GUIDE.md)** - Setup cost-optimal delegation for your team
+- **[System Prompt Developer Guide](docs/SYSTEM_PROMPT_DEVELOPER_GUIDE.md)** - Extend with custom layers, hooks, and skills
+
 ## Links
 
 - [GitHub](https://github.com/Shakes-tzd/htmlgraph)

{htmlgraph-0.24.2.dist-info → htmlgraph-0.25.0.dist-info}/RECORD

@@ -1,18 +1,26 @@
-htmlgraph/__init__.py,sha256=yO5hS-1KuZzmWAcp_aHlokwwNAv2iNQSju-B7r7DWHc,5185
-htmlgraph/agent_detection.py,sha256=PAYo7rU3N_y1cGRd7Dwjh5Wgu-QZ7ENblX_yOzU-gJ0,2749
+htmlgraph/__init__.py,sha256=dFd3HYe-7Vne9VAaoztjV_j3I3gP5Anj041awVdIh9s,5717
+htmlgraph/agent_detection.py,sha256=wEmrDv4hssPX2OkEnJZBHPbalxcaloiJF_hOOow_5WE,3511
 htmlgraph/agent_registry.py,sha256=Usa_35by7p5gtpvHO7K3AcGimnorw-FzgPVa3cWTQ58,9448
 htmlgraph/agents.py,sha256=Yvu6x1nOfrW2WhRTAHiCuSpvqoVJXx1Mkzd59kwEczw,33466
-htmlgraph/analytics_index.py,sha256=ba6Y4H_NNOCxI_Z4U7wSgBFFairf4IJT74WcM1PoZuI,30594
+htmlgraph/analytics_index.py,sha256=6jMIHFslnXdzMuq2V2Z0GeBSesyJX7WTjZ3jTAt_3ns,32792
+htmlgraph/atomic_ops.py,sha256=f0ULZoJThfC-A8xORvRv5OuFuhEnnH7uJrZslnZwmuw,18781
 htmlgraph/attribute_index.py,sha256=cBZUV4YfGnhh6lF59aYPCdNrRr1hK__BzSKCueSDUhQ,6593
-htmlgraph/cli.py,sha256=-v3VBsf0IZwNQ-7ASkp_1jJHDrsFQKIkHzbtU-K66Ts,216118
+htmlgraph/cli.py,sha256=lNRgPgS1KR45Sz-VoDuNUYQ5Ko2Gc-9cR7u0FrqKBic,252393
+htmlgraph/cli_framework.py,sha256=YfAjTGIECmv_uNpkenYyc9_iKd3jXIG5OstEKpIGWJM,3551
+htmlgraph/config.py,sha256=Pv-ska7GqmFxCTyR--3jBGcFU89-i_EshHVZnFjTkHo,3640
 htmlgraph/context_analytics.py,sha256=CaLu0o2uSr6rlBM5YeaFZe7grgsy7_Hx10qdXuNcdao,11344
-htmlgraph/converter.py,sha256=fhJF2h4YbrmL1wIa1jk7kGkT_CYGHeWp_5UzXitQ6HE,22747
-htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
+htmlgraph/converter.py,sha256=8dSp5XKrU-5_gk5AZE2PTmeNAoqSN_RoMptkReTg-cs,24297
+htmlgraph/dashboard.html,sha256=jzXrhore6RQ_u94FEhvze_2QpMhn8PkLWLSeGYf4Z0M,287408
+htmlgraph/dashboard.html.backup,sha256=MUT6SaYnazoyDcvHz5hN1omYswyIoUfeoZLf2M_iblo,251268
+htmlgraph/dashboard.html.bak,sha256=cDDMzwxkoDFFOd8V0VDCa_yigDYTvpPrP7RMoiCJ5Zo,276374
+htmlgraph/dashboard.html.bak2,sha256=Gm-4u_HV9WTQubgdFX5S5itW0u2f94N0F1R44UVjBRw,279532
+htmlgraph/dashboard.html.bak3,sha256=eJppW200aMT3qP4if8RuInVDBkx3dLP0kHiZtnsJOaI,279573
 htmlgraph/dependency_models.py,sha256=eKpBz9y_pTE5E8baESqHyGUDj5-uXokVd2Bx3ZogAyM,4313
-htmlgraph/deploy.py,sha256=kM_IMa3PmKpQf4YVH57aL9uV5IfpVJgaj-IFsgAKIbY,17771
+htmlgraph/deploy.py,sha256=cci_8_J7zhAk102q5gfwjbNHN0-v7ePwGmqBKfziRWc,17859
 htmlgraph/deployment_models.py,sha256=8pjvfe0YmExuYg65D4jO4kET52HaG8WhcArWXOJpfCQ,16064
 htmlgraph/edge_index.py,sha256=epeUiTj1Hm-NQj8WCWjSUypG1e8Z2hJulNT9drHstcM,14937
-htmlgraph/event_log.py,sha256=zJUefAaz97LvoVA-pi8uVMcCqA_pyS_saVczbioQf-Q,9372
+htmlgraph/error_handler.py,sha256=DgGZd2hee3zkZl9_JVa0ocnhrDPeeTCDji5EJmDWFDc,16760
+htmlgraph/event_log.py,sha256=d1xAfe8SfVG4GdjnEAvFr-hb1MjtRbOHX7eXaFAhJQk,9517
 htmlgraph/event_migration.py,sha256=7vocfwy-E6_D8_Aeql630FrlBXppIYp1iLmZ_cw_ras,2512
 htmlgraph/exceptions.py,sha256=o_BPNQXtv9zaejbiItDVBK7kcGvYbh4Icj5NXmDSLeU,1592
 htmlgraph/file_watcher.py,sha256=qwwmDkWnKLPp8a_48VrtJZo6HcoYPRz1KMAD39yCV7U,6296
@@ -23,7 +31,7 @@ htmlgraph/ids.py,sha256=ibEC8xW1ZHbAW6ImOKP2wLARgW7nzkxu8voce_hkljk,8389
 htmlgraph/index.d.ts,sha256=7dvExfA16g1z5Kut8xyHnSUfZ6wiUUwWNy6R7WKiwas,6922
 htmlgraph/learning.py,sha256=6SsRdz-xJGFPjp7YagpUDTZqqjNKp2wWihcnhwkHys0,28566
 htmlgraph/mcp_server.py,sha256=AeJeGJEtX5Dqu5rfhKfT5kwF2Oe8V8xCaP8BgMEh86s,24033
-htmlgraph/models.py,sha256=Zs4aXDv9TRNqkFxib_TKgMpiygHak1mV1TAM0doZJqI,83045
+htmlgraph/models.py,sha256=dJz_y6GdTiT-W7FMGbRX5CrKWX9RAkDxScnbnFnlMYc,86662
 htmlgraph/orchestrator-system-prompt-optimized.txt,sha256=O9GwHwitLyYMAbNuNsPVVG4UtHGC7uPnmIhUTfFj-PY,9671
 htmlgraph/orchestrator.py,sha256=6mj70vroWjmNmdvQ7jqqRSA9O1rFUNMUYDWPzqkizLk,19697
 htmlgraph/orchestrator_mode.py,sha256=F6LNZARqieQXUri3CRSq_lsqFbnVeGXJQPno1ZP47O4,9187
@@ -31,47 +39,74 @@ htmlgraph/orchestrator_validator.py,sha256=gd_KbHsRsNEIF7EElwcxbMYqOMlyeuYIZwClA
 htmlgraph/parallel.py,sha256=BsyqGKWY_DkSRElBdvvAkWlL6stC9BPkyxjdPdggx_w,22418
 htmlgraph/parser.py,sha256=mPcQ3WQdDCpflhjk8397TPbHnQcU3SzefNk-JE406UA,16570
 htmlgraph/planning.py,sha256=iqPF9mCVQwOfJ4vuqcF2Y3-yhx9koJZw0cID7CknIug,35903
+htmlgraph/pydantic_models.py,sha256=4vGAp2n59Hf8v5mZG-Tx2vOSm3lcE_PypBprcejJUXE,15832
+htmlgraph/quality_gates.py,sha256=ovPrjGgAwK5MjMzEIda4a6M5_S-yGiRJYy8KhzdyTZ0,11686
 htmlgraph/query_builder.py,sha256=aNtJ05GpGl9yUSSrX0D6pX_AgqlrrH-CulI_oP11PUk,18092
 htmlgraph/reflection.py,sha256=j5oclTrmRGEFgGCPHh93QSasEG2IMAFdFXRj7tP-S2c,15662
+htmlgraph/repo_hash.py,sha256=rmRgfPs8Xl9FuiP3PERAz5l6qm5Goy_Q0O6RT-V5jVM,14887
 htmlgraph/routing.py,sha256=QYDY6bzYPmv6kocAXCqguB1cazN0i_xTo9EVCO3fO2Y,8803
-htmlgraph/sdk.py,sha256=GgQOXDiqpNtO0PTf88_taxLhJK4dLOjeGR5ExZw_F-4,101109
-htmlgraph/server.py,sha256=F94rNpGSlgCg3Ax6kvzi7WjWFeHr7QerLxgmVknP4gA,52479
-htmlgraph/session_manager.py,sha256=8_H29kN6Btii1RfzNpifjjUVTMU0cEeTElFsDC6icLM,89430
+htmlgraph/sdk.py,sha256=l1jQFi1ox9pcJ6mrOU9qyBXGhq0lSVs86sBmJHnNnww,113660
+htmlgraph/server.py,sha256=J77UKjGcY0aMTfjZdc0QV3N8S0x8qIJq0gPoLwnjrQk,59986
+htmlgraph/session_hooks.py,sha256=AOjpPMZo2s_d_KXuPiWDo8TIOdkXsEU0CoOHd4G5A10,9195
+htmlgraph/session_manager.py,sha256=bwo_SWYHQw9JFOtz6D6cTX7XUwY0WFMcMUbZy8eqEFc,93515
+htmlgraph/session_registry.py,sha256=xF6VaFp3tE9LA8PXXnaIs2PKZxMOktxRUJJ7vCs0Mcs,18725
+htmlgraph/session_state.py,sha256=2UcgQNzwBjHkVuGxrAGfHkODopqDexU4wjy9qXKcQIk,15245
 htmlgraph/session_warning.py,sha256=leAYNp8pOkPFosIvNkY4Y3vjs1j76F3pGktUqQX9tI0,7877
 htmlgraph/setup.py,sha256=LpA6R7gAsevFhXh5AGGBmHyhb2ijIAjxTsm0VuzvH2Y,10866
 htmlgraph/spike_index.py,sha256=-qsJc92MtxJN1whHqV1SGU6HjXkKeG2Vsg7l3q2ReRg,4264
 htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
 htmlgraph/sync_docs.py,sha256=CH1xB3OeOFG6Wmo_D_r1aiGWS1P1gE7hfjJySCEz7bc,9114
-htmlgraph/track_builder.py,sha256=3Ldtv6OsBfrCqpXiUB13TOjuchJdgo4IuOYnFCaxc1k,6009
+htmlgraph/system_prompts.py,sha256=iV8Q5cHUedQ0yh99HDDEssP9ozjapw21ZeqDaq5ToUE,14164
+htmlgraph/track_builder.py,sha256=c3YpR3KsmJj51ZVuUcxLJPKhrXeZPcaOdW1gn6S4iwI,6492
 htmlgraph/track_manager.py,sha256=HhCg0nFOy_dx2R0_Bb2IOx9dA2lPfg7dM-_O3vBmlRU,22445
 htmlgraph/transcript.py,sha256=uk_I9tirypUdMRfKxJmoHuaySxlu1OWt7xy774KYZNw,31808
 htmlgraph/transcript_analytics.py,sha256=O-T7SfM3gJIbGFNPlF3gmKjcy--NzPiJt03lvTC209w,24922
 htmlgraph/types.py,sha256=EBxCbke3PhORsmIhHrD-f1XG6YPRX-1D5R1OXCp6xt8,8945
+htmlgraph/validation.py,sha256=I-ELEAWXESk9iv291zNBaJ78b-ikUOR5CCbPSRxekHU,3248
 htmlgraph/watch.py,sha256=xsiZwDVaXZ6vXI_oOZMqMF78aeAgxuhKpxiz98Hryqg,3791
 htmlgraph/work_type_utils.py,sha256=exA3FnuSmVMMMSBhPYDW-Bq5jGaTDjX7jkckCvnVZ_s,3408
 htmlgraph/analytics/__init__.py,sha256=G_DvCaiAeYVfMWFri1GOfLNF7PtAhitKa2V9TXHtsds,409
 htmlgraph/analytics/cli.py,sha256=aSnxkvNdrdukytqSirpFtcuiNRbg3Dt-hSpUsDPF9jo,14771
-htmlgraph/analytics/cross_session.py,sha256=KjDohOPigkHrwI_bnDr3v5MIIgx_bSEIIxXK3UcQoaM,20472
+htmlgraph/analytics/cross_session.py,sha256=BmTNqyt1qYjKbq5sXDYGxp85G2XB2aHkIvdqRgSIQBw,20494
 htmlgraph/analytics/dependency.py,sha256=7Qc5xe0b1QE_P6-l4Z0WtstEmEXc4ZGNbyIEBMoABys,25757
-htmlgraph/analytics/work_type.py,sha256=nMuUmC0rV4gvu2eovCBuR-JEnsCzk6nWnB4_zIfbJ9s,17594
+htmlgraph/analytics/work_type.py,sha256=SrZvY_RVq70uvzl3Ky7I3LHgOMduW_0vdSsk5yUZRG4,19293
+htmlgraph/api/__init__.py,sha256=PPFJ5QSv-Zei8U0yGOSs8dJKtUQMeloEqsxVBfzNbbA,105
+htmlgraph/api/main.py,sha256=6CEQMoVXjsWfitPkrVsoBql888ivMnCngt7nxYYLygA,79759
+htmlgraph/api/static/htmx.min.js,sha256=0VEHzH8ECp6DsbZhdv2SetQLXgJVgToD-Mz-7UbuQrA,48036
+htmlgraph/api/static/style-redesign.css,sha256=zp0ggDJHz81FN5SW5tRcWXPK_jVNCAJyqKhwlZkBfnQ,26759
+htmlgraph/api/static/style.css,sha256=6nUzPvf3Xri0vxbEIunrbJkujP6k3HrM3KC5nrkOjyw,20022
+htmlgraph/api/templates/dashboard-redesign.html,sha256=Y0w6qoXEPVmWETxi-_GwBNiWlCMP1Ur0OD5EL5uH7P4,30027
+htmlgraph/api/templates/dashboard.html,sha256=Bz8wcApv_QibrH-f3OBqWS1jT6uNRXdgFpqpG5T2b6Y,30748
+htmlgraph/api/templates/partials/activity-feed-hierarchical.html,sha256=28N1IeL84Fh4uYv6DxwivnzCm08LoXf6OWR2GDVvAnY,14175
+htmlgraph/api/templates/partials/activity-feed.html,sha256=6eMICdaj7cYvLFMJMuvGWE4_Ps_Fn0wO8NysVCWc93c,17346
+htmlgraph/api/templates/partials/agents-redesign.html,sha256=32sZ596ShucaLW7kUh95mB_znJeK7p8eyJ5F-wxkXzw,10266
+htmlgraph/api/templates/partials/agents.html,sha256=32sZ596ShucaLW7kUh95mB_znJeK7p8eyJ5F-wxkXzw,10266
+htmlgraph/api/templates/partials/event-traces.html,sha256=asZ_TjZT_xqbAqN2NU3hbdxExsQFL7t9LLaXw5NrOfU,10417
+htmlgraph/api/templates/partials/features-kanban-redesign.html,sha256=36lEnE-zZK0s2YZrOHCzroorEvGnCzzoem39Z5Q0SgI,18949
+htmlgraph/api/templates/partials/features.html,sha256=36lEnE-zZK0s2YZrOHCzroorEvGnCzzoem39Z5Q0SgI,18949
+htmlgraph/api/templates/partials/metrics-redesign.html,sha256=9LtXP5dzNhHsi2LiSmYTU3kWnka7x629Bkpnln7_MSE,14740
+htmlgraph/api/templates/partials/metrics.html,sha256=9LtXP5dzNhHsi2LiSmYTU3kWnka7x629Bkpnln7_MSE,14740
+htmlgraph/api/templates/partials/orchestration-redesign.html,sha256=gL3Qpo-toVlZRW86alKqGy6zu9A1btjXJEF90XSsy0w,17567
+htmlgraph/api/templates/partials/orchestration.html,sha256=nuiGQFmvbPSab57nY7q3_zBogcdsZYpfBDh-c0Q0Q50,7901
+htmlgraph/api/templates/partials/spawners.html,sha256=9sI7K49hrvm7pVwxM0pzdHivr1uyW9QcPDmOHHQbTnQ,9338
 htmlgraph/archive/__init__.py,sha256=F5VpZNiKar5J1e6caWhB7P7QQ4xvsyhDHtH65Q3224c,661
 htmlgraph/archive/bloom.py,sha256=8OL-apF3BGW1V1P9vgi6vk_IHlJe3JOxigMRyuLMjys,7058
 htmlgraph/archive/fts.py,sha256=HZSNb0GYwfm_KA6BlR72LcaAfXWsUPAi0f4BC7IJcRo,9193
 htmlgraph/archive/manager.py,sha256=FPYVvgi5xbFIJtveV25KxHmczozfKDZiq0D76k_wHjo,18256
 htmlgraph/archive/search.py,sha256=stfT296q0fqHUtW9pFQ8yJ034jq3dobEt1_qZQ21A4U,7183
 htmlgraph/builders/__init__.py,sha256=a65xHw2ARqK8oMVS1YNsIS4FAO17nBe2TFcceUqhyc0,949
-htmlgraph/builders/base.py,sha256=iLAE7oTySX8psnFbX1dauDyhrCNTCXa-D_bpM7Ymh_8,7255
-htmlgraph/builders/bug.py,sha256=RzLkMPoRvZQkBK3odZ2MYXdUHc-HgTLE4v0lOn6vyJU,3380
-htmlgraph/builders/chore.py,sha256=UY2QCRVghMCtNgYt3MThlSWlxxaIJ4dwUv9ZZhr27LU,2662
-htmlgraph/builders/epic.py,sha256=uoWlDOYE94cZDYq7gdI86AfX7bO0db8E74_PBAlGBlc,3459
-htmlgraph/builders/feature.py,sha256=xmwoobPXO5bhk5xFGAgAPmKBUwFQwtwqiElKeRTP4I0,2668
+htmlgraph/builders/base.py,sha256=UBEZdWhZWSElWMJGL7jEokNxCnXigVDYpJ6E_WuIzsw,9665
+htmlgraph/builders/bug.py,sha256=vrB_4Nz4blvwCL8WTxjW4RJ77xmiiVC2mAQQzfkQGhg,4064
+htmlgraph/builders/chore.py,sha256=Ux5eUqjl9brWbb8-B49D92IKa4iF-lJOaI0QIjdEXdc,3350
+htmlgraph/builders/epic.py,sha256=t3NwtKuTsc1zXyxDsJ9ZjD_gVyVOr31DFjED0eryNck,4145
+htmlgraph/builders/feature.py,sha256=b6mJjzWRHhKnaWX6kX3_teA7N4dghsfczzA7_sxOMdI,3706
 htmlgraph/builders/insight.py,sha256=NcS8nkiRNHlMz6wmjvzIqEr6AsUgM3RxvQAVM_VJoys,5979
 htmlgraph/builders/metric.py,sha256=G5wviNbC5zg4GotbUind4yVjO-aqUDxWvacWvK5N4Ic,6538
 htmlgraph/builders/pattern.py,sha256=QIKHJ3raOjwAWj1KipWA5o9wxbFCZLPsnoF1CkuFbnE,5726
-htmlgraph/builders/phase.py,sha256=pvdG_ZiswzdRCBM1pz7hOoCS9MD-lwaOgPqVcuLXucs,3611
-htmlgraph/builders/spike.py,sha256=_LXMDEJCdCjJPbNB8CA0FDlFDN-pZbdzvQDFXdrldo0,4327
-htmlgraph/builders/track.py,sha256=tdolGgYQl3PvoX6jHNCq3Vh6USrb7uN3NX555SoRHGs,23097
-htmlgraph/cigs/__init__.py,sha256=FQa1Tx0fnp7U0RgM-4A_WuZvuFjLC_qCgRt9KdFG3nU,1935
+htmlgraph/builders/phase.py,sha256=o7Wxmtki5pczI764eL21WyN89BE4RRPxMDgqREWIxxs,4299
+htmlgraph/builders/spike.py,sha256=qsOsUMLnFnq4Nnk6ptbIjNcD19xa6HV4MqSC4kF4nyc,5460
+htmlgraph/builders/track.py,sha256=iIoYm4GRKraOj8CNcEtyLTwSrtR7hRzEYFRQesDug04,23422
+htmlgraph/cigs/__init__.py,sha256=3-g20ISHNVO-1lOik1LaQ7e8xgvlkd_4EbHTHijSkmY,2070
 htmlgraph/cigs/autonomy.py,sha256=kq35CbzI9UV9h0Bzy8t9YIJwmHHM9KD381RUocQIlNs,14075
 htmlgraph/cigs/cost.py,sha256=DcXsIoJt_IlGVSD0Unk8f9lJUwoEXiBZATFHOM2SdjY,17502
 htmlgraph/cigs/messages_basic.py,sha256=QWaOmV6BLLkutrQGfX7B-RIEEy0dwGlUj1BuCKz2Shg,16422
@@ -80,9 +115,12 @@ htmlgraph/cigs/models.py,sha256=QoCpaRsw8DzNzA9oPBcqr76ZMghxKtCJCVtL1zB5U6E,2764
 htmlgraph/cigs/pattern_storage.py,sha256=7ZjLc62xEk5TwLUkd88MW02d_iLNkDffX3CFudR95mg,14201
 htmlgraph/cigs/patterns.py,sha256=qshVy2jey3_MJaizYIagi_qWbSnShyLyHdB100vzjn8,18456
 htmlgraph/cigs/posttool_analyzer.py,sha256=hVUXXVuvFhq-smc2JAst-gMlQWI7gXCXH9f91kBcSRs,8134
+htmlgraph/cigs/reporter.py,sha256=DgfHjD_ufP6a9Fmfm_-Ro50bDCQrNC6BZYl3dYNl86o,24307
 htmlgraph/cigs/tracker.py,sha256=OcyXY7tGxbRCtlLX8Pg2bVtCtzPJtvh1VOtt4jbL9SI,10502
-htmlgraph/collections/__init__.py,sha256=qHT1UvHD-jCmNI4t1fWprWLw-5jE7NabN6kngboVRFY,1056
-htmlgraph/collections/base.py,sha256=yK-1Kdh1wq3Ng7PkEzKX2UXlbqQl8257-9WIOfVGSmI,24721
+htmlgraph/cli_commands/__init__.py,sha256=GYdoNv80KS2p7bCThuoRbhiLmIZW6ddPqPEFEx567nQ,35
+htmlgraph/cli_commands/feature.py,sha256=KqC0daKE1aMb9-FBHlEEUZbLFvZdjlW5CxqSeO1HVVU,6689
+htmlgraph/collections/__init__.py,sha256=bDUTK5grqWKCR5sawI8fa-XoL09p5-heReGdkdSXArY,1163
+htmlgraph/collections/base.py,sha256=QAqWSz8fK5lLLU4-ba55EMUjyhkXlTANf8tKFCZig0I,25579
 htmlgraph/collections/bug.py,sha256=bDbZy_sdiIn7AK0b8CXs88mUEr1ZkOGVezG0aKwh0pw,1331
 htmlgraph/collections/chore.py,sha256=PgKPjd1WkHHmZD4p4nRr8rUhC1JxfYfNWOfANxNbXqs,1352
 htmlgraph/collections/epic.py,sha256=1qJPzEHqwlfRk-4VVyKNvlZPRuGlXq68saH3tv0fZqY,1350
@@ -91,14 +129,27 @@ htmlgraph/collections/insight.py,sha256=Ifl3W_aVTFCD39-dIyo7YoEr4rbyQLaJycc9lhhR
 htmlgraph/collections/metric.py,sha256=zlHZaZSfiF6dHQ-C8bK0tIbMcXXs8_csAUQn_jfIvxQ,2620
 htmlgraph/collections/pattern.py,sha256=FkEqF0eoMoluJxvpiZZ3OZnZNxMc24kzTL0ZmvyiPog,2560
 htmlgraph/collections/phase.py,sha256=2GcgD-P-j61jgG4c0VhUmsOp1qjtrJLtRDNumHHDNZA,1359
-htmlgraph/collections/spike.py,sha256=Omazli2JM9RoYgseSAxKYeK4KC8mAwMCfUAF1XFml54,2963
+htmlgraph/collections/session.py,sha256=xIEY8ANLwjrc7ia9I9KV5BumzCIY91q1fjHGLG_27vg,6437
+htmlgraph/collections/spike.py,sha256=BSFUOIecX41i3unePSa-RlX0raDifcyJ3S3tG12GgmA,3198
+htmlgraph/collections/task_delegation.py,sha256=NMrVLKoI6ektuS8RoTeh_4exG4a1sNLx2u78091v5b0,7944
 htmlgraph/collections/todo.py,sha256=SWOkolqCIvf7PCxCLuqPuNCpdDSTOc9KsuaXanWSEFY,15548
+htmlgraph/collections/traces.py,sha256=DVl4gSBxiLb3SVZhAHQeCtM0HdzJPrPR9ZEPnoFYB2U,16236
+htmlgraph/cost_analysis/__init__.py,sha256=kuAA4Fd0gUplOWOiqs3CF4eO1wwekGs_3DaiFVqGNjg,148
+htmlgraph/cost_analysis/analyzer.py,sha256=TDKgRXeOQ-td5LZhkFob4ajEf-JssSCGKlMS3GysYJU,15040
+htmlgraph/db/__init__.py,sha256=1yWTyWrN2kcmW6mVKCUf4POSUXTOSaAljwEyyC0Xs1w,1033
+htmlgraph/db/queries.py,sha256=FtqOIBJC0EociEYNJr6gTVROqd9m5yZdVGYLxXNVSdk,22608
+htmlgraph/db/schema.py,sha256=22P_29cTDN49NE0KrDofy5-FOExse2VVhYU3f0wNSQc,51240
+htmlgraph/docs/API_REFERENCE.md,sha256=LYsYeHinF6GEsjMvrgdQSbgmMPsOh4ZQ1WK11niqNvo,17862
+htmlgraph/docs/HTTP_API.md,sha256=IrX-wZckFn-K3ztCVcT-zyGqJL2TtY1qYV7dUuC7kzc,13344
+htmlgraph/docs/INTEGRATION_GUIDE.md,sha256=uNNM0ipY0bFAkZaL1CkvnA_Wt2MVPGRBdA4927cZaHo,16910
+htmlgraph/docs/ORCHESTRATION_PATTERNS.md,sha256=F1aLdEZ_SIT7qEI2ha-PD5IZmexbx635ST-YLxphvY8,16193
+htmlgraph/docs/README.md,sha256=eFIv9U-1LhyO7uQOBzKd_tgawgeE8ZDGOtEWopxLv3E,12861
 htmlgraph/docs/__init__.py,sha256=WlDS4y_DgpkoXQbJMucUjkCwyQs60t_QySI9m1CaMKU,2106
 htmlgraph/docs/docs_version.py,sha256=4rXIhuhKv7VDGRlNtvWyB4zPboNGtcGfJjbf0yf1sI0,1475
 htmlgraph/docs/metadata.py,sha256=sUlbIEqysXRma99a2KLSfJ-NqPYfz5p2pSj-s8wPblQ,2708
 htmlgraph/docs/migrations.py,sha256=-kCWXOmilJKXCxe1LKob8sfVCQhcWambEa9asTCobKg,7248
 htmlgraph/docs/template_engine.py,sha256=aRr7hUcCoXOPzZlxifmxNr3nImOvla-X3qYYWKfXDMw,4825
-htmlgraph/docs/version_check.py,sha256=4zhplgv42k8REik4fU9Q2LANZoSRv7uSzGQGdVKj5VI,4892
+htmlgraph/docs/version_check.py,sha256=QNBt0yKjBplWkz081xZfaNKJ2GiWEm0RCvxthVBOfFg,4956
 htmlgraph/docs/templates/base_agents.md.j2,sha256=s3qyWyx4XWkeeqmWGtnsK0AsDOhBA108Cc2lbA08VfE,1713
 htmlgraph/docs/templates/example_user_override.md.j2,sha256=BYm_p9qP21hjAF7zwGfx1NU8PTlQ00yphk-leHsMHDY,1361
 htmlgraph/docs/templates/_sections/cli_reference.md.j2,sha256=TItgng09Qxre2EdqXdq-R2RhS9IW5W7mis-vjpWGKA4,806
@@ -111,9 +162,12 @@ htmlgraph/extensions/gemini/hooks/hooks.json,sha256=BHLoneQ61_8WixYGKbZVziRgv0sA
 htmlgraph/extensions/gemini/hooks/scripts/post-tool.sh,sha256=z8lUt5qoyLylwCVqNTVvhJdfRSM1gEhXwU0JYNmehYQ,871
 htmlgraph/extensions/gemini/hooks/scripts/session-end.sh,sha256=yQzSKfxBzuMS-U_xcS_sbISrjQwnyM-E-KMu1LeRYAI,1095
 htmlgraph/extensions/gemini/hooks/scripts/session-start.sh,sha256=thpCbfE8WD8huFU7mUMas-gWAk6BsHtYLaKlIHusNRg,2670
-htmlgraph/hooks/__init__.py,sha256=jL2HyCoFWQQ8l-4-EAlypDxPalNE3JBfDyELYWAg-g0,865
+htmlgraph/hooks/__init__.py,sha256=FxVdnSYMNTjaKyOJ-euvyq9qYy5LZvGH5eIRqw0SpyQ,1071
+htmlgraph/hooks/bootstrap.py,sha256=IiahOTOZolhIHF-yDfolmfT2kR5_EH_E9A7BBFKy2lI,5194
 htmlgraph/hooks/cigs_pretool_enforcer.py,sha256=q0v8KwRI0oLdfUZup95LSXJO-olokNwSY1qqTu4vWnM,12702
-htmlgraph/hooks/event_tracker.py,sha256=KQcIWbhNJser6Tip87oUAPQJgUAAKESKE5ARQasLtCM,23301
+htmlgraph/hooks/context.py,sha256=yyJLbGQtmLtuVG4nhSIAeXlJef1FSdzrUGWqD_MYNuc,9121
+htmlgraph/hooks/drift_handler.py,sha256=e0rqVlD6tVd5fnk9h7Kd5OwXCSFTqEqwzL0YxXoMFVA,17544
+htmlgraph/hooks/event_tracker.py,sha256=QVl-X0QSmWbG1cfcC68Qegw5a_GQnOdxnNBLNPaYofc,38112
 htmlgraph/hooks/hooks-config.example.json,sha256=tXpk-U-FZzGOoNJK2uiDMbIHCYEHA794J-El0fBwkqg,197
 htmlgraph/hooks/installer.py,sha256=nOctCFDEV7BEh7ZzxNY-apu1KZG0SHPMq74UPIOChqY,11756
 htmlgraph/hooks/orchestrator.py,sha256=rKRx5EYED-BFQrnAJ_roIjpP8GOs3RKDpulDouA29K0,19781
@@ -122,21 +176,27 @@ htmlgraph/hooks/post-checkout.sh,sha256=Hsr5hqD54jisGbtqf7-Z-G_b6XNGcee_CZRYaKYz
 htmlgraph/hooks/post-commit.sh,sha256=if65jNGZnEWsZPq_iYDNYunrZ1cmjPUEUbh6_4vfpOE,511
 htmlgraph/hooks/post-merge.sh,sha256=gq-EeFLhDUVp-J2jyWMBVFcB0pdmH54Wu1SW_Gn-s2I,541
 htmlgraph/hooks/post_tool_use_failure.py,sha256=DHkJtuAOg5KSLfFZ1O-kePwaqmtNkbGQSEn4NplzvD8,8381
+htmlgraph/hooks/post_tool_use_handler.py,sha256=e0L8X4sU2H167HH96CgV6iYojd02AI9uyF8m4A1a-kU,8345
 htmlgraph/hooks/posttooluse.py,sha256=3usICpqlIdLKsijYY61BP2QezsB45MZ6evwFSobC9Yo,12822
 htmlgraph/hooks/pre-commit.sh,sha256=gTpbnHIBFxpAl7-REhXoS0NI4Pmlqo9pQEMEngTAU_A,3865
 htmlgraph/hooks/pre-push.sh,sha256=rNnkG8YmDtyk7OuJHOcbOYQR3MYFneaG6_w2X-Hl8Hs,660
-htmlgraph/hooks/pretooluse.py,sha256=Q6wtU_IBIjCd22j7MvZrdd959TdAHx8OovIOnqkwCm0,9606
-htmlgraph/hooks/task_enforcer.py,sha256=NFyU1TiUoVZBl91AWiZwZc3JzugWxcfGbaFw2nuGHnA,6587
+htmlgraph/hooks/pretooluse.py,sha256=SVHwj7joOG0ifDGmUYvOEai9U1g2P_sf2-AACPNNCUk,25002
+htmlgraph/hooks/prompt_analyzer.py,sha256=vVTzvJF_JjD7Wt8XY6RTro4iQwoLek0_kxgvSYqVI8Y,23269
+htmlgraph/hooks/session_handler.py,sha256=aB-gNn29LE-9pP8M2LmXLNSlfGlkrWVAa2idY4N279Q,18578
+htmlgraph/hooks/state_manager.py,sha256=S5gWSwyjuuVIXH9NWD5xRW6TYwHnH-48GWQmYph_ZE0,17568
+htmlgraph/hooks/subagent_stop.py,sha256=V08sL3T_q1EJLrZWRtsB_Du1LOLIPvDlStUDB4R0xJs,9078
+htmlgraph/hooks/task_enforcer.py,sha256=eXaQaNibUu1ty78t9M46h0Hhw2M1Fi1lnqCpUdsBZ9Y,7927
 htmlgraph/hooks/task_validator.py,sha256=GwEoqL2lptPWQqckkfl0N-Auc7TtHiyRlOf6p7HcoIo,5438
 htmlgraph/hooks/validator.py,sha256=cwul8fIGS-_hFKskrYC6Hjh0F9yP4_3ErAsyp_SL43c,17417
 htmlgraph/operations/README.md,sha256=5h0P-aZ3po3h_7mUpuh7jJwOL-NEvtlBlPCbqzvLrIE,1730
 htmlgraph/operations/__init__.py,sha256=uiUUmWG3BAtRlSr-WMS4STB76JKJYs0QPQKR7mRh3Co,1237
 htmlgraph/operations/analytics.py,sha256=XDbGEG5ydrjqM5sXa01wsruT0u9DtOb24VJEPzQS8BM,11583
 htmlgraph/operations/events.py,sha256=vSuLj8IWtdfPMvoK6yDmDM3kh_SDOWU8Ofu5u4DF_Tw,6842
+htmlgraph/operations/fastapi_server.py,sha256=OdcUqPHMCO102y9STEtwwfvSOmrPw9IOEFu_4Oxt8DY,5801
 htmlgraph/operations/hooks.py,sha256=_jRHbjrWNM1fjukEr0TBu6wn90PVfpXtJjicSITqP0A,10037
 htmlgraph/operations/server.py,sha256=cxdSYZU10pNgiNfYk2T84D_40CAFjA9wSVsRfk9Ipm8,8746
 htmlgraph/orchestration/__init__.py,sha256=a9NWy-zWG9T7f7V37ibahniF_enn-31gM4veEJkM8cw,844
-htmlgraph/orchestration/headless_spawner.py,sha256=8B_y6NojAVwwaav25izAiKGApel61gAeVzDEcm_xP9k,40244
+htmlgraph/orchestration/headless_spawner.py,sha256=SWvNLTHsQEo1ZbuhaHa4eC6FT3UixnjpSjeGJx-PVqA,40269
 htmlgraph/orchestration/model_selection.py,sha256=2IArHkde5rKD56aj5Jw9I9Z5iLV0yOgw3QCmNF996DE,11311
 htmlgraph/orchestration/task_coordination.py,sha256=7_oQ4AlHOv14hs6RvLsatJzF-F5gkIbv1EOrmeGPhiw,9699
 htmlgraph/scripts/__init__.py,sha256=a_ef7jnypTH3fzjutKYtUquJospdbA6IOR4o9dgv8Gk,48
@@ -146,12 +206,13 @@ htmlgraph/services/claiming.py,sha256=HcrltEJKN72mxuD7fGuXWeh1U0vwhjMvhZcFc02Eiy
 htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
 htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
 htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
-htmlgraph-0.24.2.data/data/htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
-htmlgraph-0.24.2.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
-htmlgraph-0.24.2.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
-htmlgraph-0.24.2.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
-htmlgraph-0.24.2.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
-htmlgraph-0.24.2.dist-info/METADATA,sha256=4dJhWJBwkmM3_NerNUIpL9IdY6yt0UPDKLLFKYSXe_4,7881
-htmlgraph-0.24.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-htmlgraph-0.24.2.dist-info/entry_points.txt,sha256=EaUbjA_bbDwEO_XDLEGMeK8aQP-ZnHiUTkLshyKDyB8,98
-htmlgraph-0.24.2.dist-info/RECORD,,
+htmlgraph/templates/orchestration-view.html,sha256=DlS7LlcjH0oO_KYILjuF1X42t8QhKLH4F85rkO54alY,10472
+htmlgraph-0.25.0.data/data/htmlgraph/dashboard.html,sha256=jzXrhore6RQ_u94FEhvze_2QpMhn8PkLWLSeGYf4Z0M,287408
+htmlgraph-0.25.0.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
+htmlgraph-0.25.0.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
+htmlgraph-0.25.0.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
+htmlgraph-0.25.0.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
+htmlgraph-0.25.0.dist-info/METADATA,sha256=_e-eOgin2tm5rIdKmsRHNpDGIvxo8LXH26tLDdfnxXk,10236
+htmlgraph-0.25.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+htmlgraph-0.25.0.dist-info/entry_points.txt,sha256=EaUbjA_bbDwEO_XDLEGMeK8aQP-ZnHiUTkLshyKDyB8,98
+htmlgraph-0.25.0.dist-info/RECORD,,