htmlgraph 0.27.4__py3-none-any.whl → 0.27.6__py3-none-any.whl

htmlgraph/__init__.py

@@ -118,7 +118,7 @@ from htmlgraph.types import (
 )
 from htmlgraph.work_type_utils import infer_work_type, infer_work_type_from_id
 
-__version__ = "0.27.4"
+__version__ = "0.27.6"
 __all__ = [
     # Exceptions
     "HtmlGraphError",

htmlgraph/orchestrator-system-prompt-optimized.txt

@@ -6,7 +6,7 @@
 
 **DO NOT execute operations directly. Your job is to ROUTE WORK to specialized agents.**
 
-Think of yourself as a **strategic coordinator**, not a tactical executor. You make decisions about WHAT to do and WHO should do it, but you DO NOT do the work yourself.
+Act as a **strategic coordinator**, not a tactical executor. Make decisions about WHAT to do and WHO should do it. DO NOT do the work yourself.
 
 ---
 
@@ -45,12 +45,12 @@ Think of yourself as a **strategic coordinator**, not a tactical executor. You m
 
 **If you catch yourself using tools like Read, Edit, Grep, Glob - STOP. You should have delegated.**
 
-**Bash tool is allowed ONLY for:**
+**Use Bash tool ONLY for:**
 - Simple, direct operations (ls, pwd, echo, cat)
 - When Skill/Task delegation would be overkill
 - Quick checks or validations
 
-**For complex operations, use Skill() or Task() delegation.**
+**For complex operations, MUST use Skill() or Task() delegation.**
 
 ---
 
@@ -99,7 +99,7 @@ Think of yourself as a **strategic coordinator**, not a tactical executor. You m
 
 ### What Are Spawners?
 
-**Spawners** are HtmlGraph-integrated ways to invoke external CLIs (Copilot, Gemini, Codex) with **full parent event context and subprocess tracking**.
+**Use Spawners** as HtmlGraph-integrated ways to invoke external CLIs (Copilot, Gemini, Codex) with **full parent event context and subprocess tracking**.
 
 **CRITICAL: Spawners are invoked DIRECTLY via Python SDK, NOT wrapped in Task(). Task() is ONLY for Claude subagents (Haiku, Sonnet, Opus).**
 
@@ -367,7 +367,7 @@ Task(
 )
 ```
 
-**Use Haiku when:**
+**Use Haiku for:**
 - Single file, clear instructions
 - Typo fixes, config updates
 - Rename/move operations
@@ -396,7 +396,7 @@ Task(
 )
 ```
 
-**Use Sonnet when:**
+**Use Sonnet for:**
 - Multi-file feature implementation
 - Module-level refactors
 - Component integration
@@ -426,7 +426,7 @@ Task(
 )
 ```
 
-**Use Opus when:**
+**Use Opus for:**
 - System architecture design
 - Large-scale refactors (10+ files)
 - Performance optimization with profiling
@@ -458,15 +458,15 @@ Task(model="haiku", prompt="Design microservices architecture")
 
 ### When in Doubt
 
-**Default to Sonnet** - Best balance of capability and cost.
+**ALWAYS default to Sonnet** - Best balance of capability and cost.
 
-If Sonnet struggles or produces inadequate results, escalate to Opus for the retry.
+Escalate to Opus for the retry if Sonnet struggles or produces inadequate results.
 
 ---
 
 ## Configurable Thresholds
 
-Delegation enforcement uses configurable thresholds instead of hardcoded values:
+Use configurable thresholds instead of hardcoded values for delegation enforcement:
 
 **Default Thresholds:**
 - `exploration_calls: 5` - Consecutive Grep/Read/Glob before warning
@@ -487,10 +487,10 @@ uv run htmlgraph orchestrator config-reset
 ```
 
 **Time-Based Decay:** Violations automatically expire after 2 minutes (configurable).
-This prevents long-running sessions from accumulating stale violations.
+Prevent long-running sessions from accumulating stale violations.
 
 **Rapid Sequence Collapsing:** Multiple violations within 10 seconds count as one.
-This prevents "violation spam" when you make quick exploratory mistakes.
+Prevent "violation spam" when making quick exploratory mistakes.
 
 ---
 
@@ -553,7 +553,7 @@ When you call `Skill(skill=".claude-plugin:copilot")`, here's what happens:
 3. **Embedded coordination** - Python code may check for external CLIs
 4. **Guide execution** - Shows HOW to use Bash or Task() for actual work
 
-**Skills are teaching tools, not execution tools.**
+**Use Skills as teaching tools, NOT execution tools.**
 
 ### The Execution Model
 
@@ -637,13 +637,13 @@ Task(
 
 ### When to Use Skills
 
-**Use Skills for:**
+**Use Skills ONLY for:**
 - ✅ Learning CLI syntax and options
 - ✅ Understanding available commands
 - ✅ Seeing example workflows
 - ✅ Reference documentation
 
-**Don't use Skills for:**
+**NEVER use Skills for:**
 - ❌ Actual execution (use Bash or Task instead)
 - ❌ Creating PRs, issues, or repos (use Bash with gh commands)
 - ❌ Code generation (use Task delegation)
@@ -755,7 +755,7 @@ This section is pre-computed from session history and contains max 5 actionable
 - **Related Spikes** (🔍) - Relevant investigations. Check findings.
 - **Recommendations** (💡) - Strategic next actions.
 
-**Use reflections to inform delegation prompts:**
+**ALWAYS use reflections to inform delegation prompts:**
 ```python
 # Include relevant context in Task prompts
 Task(
@@ -770,7 +770,7 @@ Task(
 
 ## What is HtmlGraph?
 
-Lightweight graph database for AI coordination and human observability. HTML files = nodes, hyperlinks = edges, CSS selectors = queries. Zero dependencies, offline-first. Use SDK for ALL operations tracking.
+Use HtmlGraph as a lightweight graph database for AI coordination and human observability. HTML files = nodes, hyperlinks = edges, CSS selectors = queries. Zero dependencies, offline-first. MUST use SDK for ALL operations tracking.
 
 ## Operation Backbone: HtmlGraph + Git
 
@@ -831,9 +831,9 @@ When you call `Task()`, the system automatically:
 
 ## Speed & Testing
 
-- Use WebSearch for up-to-date information
-- Test incrementally, not at the end
-- Quality gates: ruff, mypy, pytest (delegate via Task or Bash)
+- ALWAYS use WebSearch for up-to-date information
+- MUST test incrementally, not at the end
+- MUST run quality gates: ruff, mypy, pytest (delegate via Task or Bash)
 
 ---
 

htmlgraph/sdk/operations/mixin.py

@@ -425,3 +425,63 @@ class OperationsMixin:
         from htmlgraph.operations import analytics
 
         return analytics.get_recommendations(graph_dir=self._directory)
+
+    def init_project(self, directory: Path | None = None) -> dict[str, Any]:
+        """
+        Initialize HtmlGraph directory structure.
+
+        Creates .htmlgraph/ with subdirectories:
+        - features/, sessions/, tracks/, spikes/
+        - bugs/, patterns/, insights/, metrics/
+        - todos/, task-delegations/
+
+        Args:
+            directory: Base directory (defaults to current working directory)
+
+        Returns:
+            Dict with status ("created" or "already_exists") and directories list
+
+        Example:
+            >>> sdk = SDK(agent="claude")
+            >>> result = sdk.init_project()
+            >>> print(result['status'])  # "created"
+            >>> print(result['directories'])  # ['features', 'sessions', ...]
+        """
+        from pathlib import Path
+
+        base_dir = directory or Path.cwd() / ".htmlgraph"
+
+        # Check if already initialized
+        if base_dir.exists():
+            existing_dirs = [d.name for d in base_dir.iterdir() if d.is_dir()]
+            return {
+                "status": "already_exists",
+                "directories": existing_dirs,
+                "path": str(base_dir),
+            }
+
+        # Create directory structure
+        dirs = [
+            "features",
+            "sessions",
+            "tracks",
+            "spikes",
+            "bugs",
+            "patterns",
+            "insights",
+            "metrics",
+            "todos",
+            "task-delegations",
+        ]
+
+        created = []
+        for dirname in dirs:
+            dir_path = base_dir / dirname
+            dir_path.mkdir(parents=True, exist_ok=True)
+            created.append(dirname)
+
+        return {
+            "status": "created",
+            "directories": created,
+            "path": str(base_dir),
+        }

{htmlgraph-0.27.4.dist-info → htmlgraph-0.27.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgraph
-Version: 0.27.4
+Version: 0.27.6
 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

{htmlgraph-0.27.4.dist-info → htmlgraph-0.27.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-htmlgraph/__init__.py,sha256=7_6mNCvGfhGT-edtfQ2j5_VDZDrjSyTppTRIkaOiLnU,6407
+htmlgraph/__init__.py,sha256=uOeA6rclaPyDSJry64EF_-hlCIcl0vNxeEXKD9juFKs,6407
 htmlgraph/__init__.pyi,sha256=8JuFVuDll9jMx9s8ZQHt2tXic-geOJHiXUMB2YjmHhU,6683
 htmlgraph/agent_detection.py,sha256=wEmrDv4hssPX2OkEnJZBHPbalxcaloiJF_hOOow_5WE,3511
 htmlgraph/agent_registry.py,sha256=80TPYr4P0YMizPUbTH4N5wH6D84IKs-HPBLHGeeP6bY,9449
@@ -35,7 +35,7 @@ htmlgraph/learning.py,sha256=A3LU7VeK129sy5C0xjgVtZNI3dS6xEh9ow3GBnoq2JQ,28567
 htmlgraph/mcp_server.py,sha256=Isha3F2Jk_YLsbchtr2wusmEy6LDrMH-3zF0jzvJmFk,24034
 htmlgraph/models.py,sha256=rE1Arbb4CoC5HHKx_JXxtKfneH3rQVjOUVGrz-s1iMU,87352
 htmlgraph/orchestration.md,sha256=7oCum1RtlkGfHjh9YQ1h24flPbHrEIKiSNjnt61CuG4,17874
-htmlgraph/orchestrator-system-prompt-optimized.txt,sha256=Lzu-WE3vEZ6aBvBzk_SECVaHB0xO3TeGMQLAfeShVGY,31164
+htmlgraph/orchestrator-system-prompt-optimized.txt,sha256=8ekZ19YWJE9npaAaAGTkTMfseOlA2rliGYc_ad2HaRc,31191
 htmlgraph/orchestrator.py,sha256=vF7ovxsb2rIkQs_ifX-lKp7UJO9CCUq4ZQNOdNhdwJM,19698
 htmlgraph/orchestrator_config.py,sha256=5EBnT81OAkJBsp6jNDNgBnhJmD8A4zV2REaop9qb8gc,10886
 htmlgraph/orchestrator_mode.py,sha256=DXkG89uHe2VPz8wSx44JENn70lQiI5BLihKGpcPnNx8,10538
@@ -300,7 +300,7 @@ htmlgraph/sdk/mixins/__init__.py,sha256=IziHuV8N1sz65xYTO12JvdkGgP-5yDx8hjMTN6MY
 htmlgraph/sdk/mixins/attribution.py,sha256=SA1k8ccF2ZIKcTPyzaeB3h4OKE0YGQJq9BvnsgsC0z8,4048
 htmlgraph/sdk/mixins/mixin.py,sha256=sOSjY7tNkYQOIKkpmu1tDDy74Ci-_8OJsvt-QJQW6O4,13472
 htmlgraph/sdk/operations/__init__.py,sha256=HxULDCxJz9jFFyzEfavgrMuwDZqEVMOFIzYzWDPfo8E,235
-htmlgraph/sdk/operations/mixin.py,sha256=65w5ftLxdbn4U3i2hZhrsOosB4I5lcx-9Ts3LTMAYYQ,14338
+htmlgraph/sdk/operations/mixin.py,sha256=0f2uySxZB-V9sjBOabrShL04zWBn-Std7IEmJfy3uWs,16124
 htmlgraph/sdk/orchestration/__init__.py,sha256=cSYuiXEs1gedLgLTqPM5IkmGxQchReukjazklxpCi1A,442
 htmlgraph/sdk/orchestration/coordinator.py,sha256=LcsCsraLkzV0uedCkCvCC2vJDDM9v9N9_tYfVH548uA,6771
 htmlgraph/sdk/orchestration/spawner.py,sha256=Ei9-4qv7iSdoiJfRrkqHesSGmf6hVt9FYIGHKAI-YCg,7783
@@ -326,12 +326,12 @@ htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4be
 htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
 htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
 htmlgraph/templates/orchestration-view.html,sha256=DlS7LlcjH0oO_KYILjuF1X42t8QhKLH4F85rkO54alY,10472
-htmlgraph-0.27.4.data/data/htmlgraph/dashboard.html,sha256=MUT6SaYnazoyDcvHz5hN1omYswyIoUfeoZLf2M_iblo,251268
-htmlgraph-0.27.4.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
-htmlgraph-0.27.4.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
-htmlgraph-0.27.4.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
-htmlgraph-0.27.4.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
-htmlgraph-0.27.4.dist-info/METADATA,sha256=yPqPZlougY7y9u4JA2V96KFRw3mlAeFgWrtvogoL1qI,10220
-htmlgraph-0.27.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-htmlgraph-0.27.4.dist-info/entry_points.txt,sha256=Wmdo5cx8pt6NoMsssVE2mZH1CZLSUsrg_3iSWatiyn0,103
-htmlgraph-0.27.4.dist-info/RECORD,,
+htmlgraph-0.27.6.data/data/htmlgraph/dashboard.html,sha256=MUT6SaYnazoyDcvHz5hN1omYswyIoUfeoZLf2M_iblo,251268
+htmlgraph-0.27.6.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
+htmlgraph-0.27.6.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
+htmlgraph-0.27.6.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
+htmlgraph-0.27.6.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
+htmlgraph-0.27.6.dist-info/METADATA,sha256=tU22e3oeC3VapYYv-SmSDYIhkUCpUHOwwNHYhMPHmrI,10220
+htmlgraph-0.27.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+htmlgraph-0.27.6.dist-info/entry_points.txt,sha256=Wmdo5cx8pt6NoMsssVE2mZH1CZLSUsrg_3iSWatiyn0,103
+htmlgraph-0.27.6.dist-info/RECORD,,