invar-tools 1.14.0__py3-none-any.whl → 1.15.1__py3-none-any.whl

invar/templates/skills/invar-reflect/CONFIG.md

@@ -16,6 +16,46 @@ The `/invar-reflect` skill can be triggered:
 
 ## Proposed Hook Schema
 
+
+### Message Count Trigger (Implemented - DX-79)
+
+**Status**: ✅ Implemented in v1.15.0
+
+Both Claude Code and Pi now support automatic feedback triggering via **message count threshold**.
+
+**Configuration in `.claude/settings.local.json`**:
+
+```json
+{
+  "feedback": {
+    "enabled": true,
+    "min_messages": 30
+  }
+}
+```
+
+**Hook Parameters**:
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `enabled` | boolean | true | Enable feedback collection |
+| `min_messages` | number | 30 | Minimum messages before trigger |
+
+**How it works**:
+
+1. **Message counting**: Both hooks track message count per session
+2. **Threshold trigger**: At `min_messages`, hook displays reminder
+3. **User action**: Agent sees reminder and can run `/invar-reflect`
+
+**Cross-platform implementation**:
+
+| Platform | Hook File | Mechanism |
+|----------|-----------|-----------|
+| **Claude Code** | `.claude/hooks/invar.UserPromptSubmit.sh` | Bash script with jq config parsing |
+| **Pi** | `.pi/hooks/invar.ts` | TypeScript with fs config reading |
+
+Both read the same `.claude/settings.local.json` configuration file.
+
 ### PostTaskCompletion Hook (Waiting for Claude Code Support)
 
 **Proposed configuration in `.claude/settings.json`**:
@@ -69,24 +109,46 @@ The `/invar-reflect` skill can be triggered:
 
 ## Triggering Conditions
 
-The hook triggers when **ALL** conditions are met:
 
-1. ✅ **Task completed** - User finished major work (natural stopping point)
-2. ✅ **Message count >= 30** - Sufficient context for meaningful feedback
-3. ✅ **Duration >= 2 hours** - Non-trivial session (avoids quick fixes)
+The hook triggers when the message count reaches the configured threshold (default: 30).
 
-**No hard frequency cap**: Same-day sessions merge into single file (see SKILL.md for merge logic).
+**Conditions**:
 
----
+1. ✅ **Message count >= min_messages** (default: 30)
+2. ✅ **Feedback enabled** (`feedback.enabled = true`)
+
+**No hard frequency cap**: Users can run `/invar-reflect` manually at any time.
+
+**Customizing threshold**:
+
+```json
+{
+  "feedback": {
+    "enabled": true,
+    "min_messages": 50  // Trigger at 50 messages instead of 30
+  }
+}
+```
 
 ## Silent Mode
 
-When `mode: "silent"`:
-- Feedback generation runs in background
-- No interruption to current conversation
-- User sees notification only: `✓ Feedback saved to .invar/feedback/feedback-{date}.md`
 
----
+The hook displays a **reminder** when the threshold is reached:
+
+```
+<system-reminder>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Invar: Auto-triggering usage feedback (30 messages)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Session has reached 30 messages. Consider running /invar-reflect
+to generate usage feedback.
+
+To disable: Set feedback.enabled=false in .claude/settings.local.json
+</system-reminder>
+```
+
+**Note**: The agent sees this reminder and can choose to invoke `/invar-reflect` or continue working.
 
 ## User Control
 
@@ -144,7 +206,68 @@ rm .invar/feedback/feedback-2026-01-03.md
 
 ## Workaround: Using Stop Hook (Until PostTaskCompletion is Available)
 
-Since Claude Code doesn't yet support `PostTaskCompletion` hook, you can use the `Stop` hook as a temporary workaround.
+
+### Implementation Details
+
+**Claude Code Hook** (`.claude/hooks/invar.UserPromptSubmit.sh`):
+
+```bash
+# DX-79: Feedback trigger at threshold
+FEEDBACK_ENABLED=true
+MIN_MESSAGES=30
+
+if [[ -f ".claude/settings.local.json" ]]; then
+  if command -v jq &> /dev/null; then
+    FEEDBACK_ENABLED=$(jq -r '.feedback.enabled // true' .claude/settings.local.json)
+    MIN_MESSAGES=$(jq -r '.feedback.min_messages // 30' .claude/settings.local.json)
+  fi
+fi
+
+if [[ "$FEEDBACK_ENABLED" == "true" && $COUNT -eq $MIN_MESSAGES ]]; then
+  echo "<system-reminder>"
+  echo "📊 Invar: Auto-triggering usage feedback ($COUNT messages)"
+  echo "Consider running /invar-reflect to generate usage feedback."
+  echo "</system-reminder>"
+fi
+```
+
+**Pi Hook** (`.pi/hooks/invar.ts`):
+
+```typescript
+// DX-79: Helper to read feedback configuration
+function readFeedbackConfig() {
+  try {
+    const fs = require("fs");
+    const settingsPath = ".claude/settings.local.json";
+    if (fs.existsSync(settingsPath)) {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+      return {
+        enabled: settings.feedback?.enabled ?? true,
+        min_messages: settings.feedback?.min_messages ?? 30,
+      };
+    }
+  } catch {
+    // Ignore errors, use defaults
+  }
+  return { enabled: true, min_messages: 30 };
+}
+
+pi.on("agent_start", async () => {
+  msgCount++;
+  
+  // ... protocol refresh logic ...
+  
+  const feedbackConfig = readFeedbackConfig();
+  if (msgCount === feedbackConfig.min_messages && feedbackConfig.enabled) {
+    pi.send(`<system-reminder>
+📊 Invar: Auto-triggering usage feedback (${msgCount} messages)
+Consider running /invar-reflect to generate usage feedback.
+</system-reminder>`);
+  }
+});
+```
+
+**Installation**: Hooks are automatically installed via `invar init --claude` or `invar init --pi`.
 
 ### Stop Hook Implementation
 
@@ -332,24 +455,26 @@ Enable automatic feedback collection? [Y/n]:
 
 ## Phase B Status
 
-**Completed**:
-- ✅ Hook schema designed
-- ✅ Configuration structure defined
-- ✅ User control mechanism specified
-- ✅ Stop hook workaround documented
 
-**Waiting for Claude Code Support**:
-- ⏸️ PostTaskCompletion hook type
-- ⏸️ Skill invocation from hooks
-- ⏸️ Session state tracking (message count, duration)
+**Completed** (v1.15.0):
+- ✅ Message Count trigger strategy designed
+- ✅ Cross-platform implementation (Claude Code + Pi)
+- ✅ Shared configuration structure
+- ✅ Hook templates updated
+- ✅ Installation via `invar init`
 
-**Next Steps**:
-- Implement Phase C: Init Integration (can be done independently)
-- Submit feature request to Claude Code for PostTaskCompletion hook
-- Test manual `/invar-reflect` invocation thoroughly
+**Replaced PostTaskCompletion with Message Count** because:
+- PostTaskCompletion hook not supported by Claude Code or Pi
+- Message count is universally implementable
+- Simpler, more predictable trigger mechanism
+- User has full control via config
 
----
+**Testing**:
+- Manual `/invar-reflect` invocation: Works
+- Hook trigger at threshold: Implemented
+- Config disable: Honored by both hooks
+- Multi-agent setup: Both hooks installed
 
-**Version**: 1.0 (Phase B - Proposed)
-**Updated**: 2026-01-03
-**Related**: DX-79 Invar Usage Feedback Collection
+**Next Steps**:
+- Monitor user feedback on threshold defaults
+- Consider adding reminder messages at other checkpoints (e.g., 60, 90 messages)

{invar_tools-1.14.0.dist-info → invar_tools-1.15.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: invar-tools
-Version: 1.14.0
+Version: 1.15.1
 Summary: AI-native software engineering tools with design-by-contract verification
 Project-URL: Homepage, https://github.com/tefx/invar
 Project-URL: Documentation, https://github.com/tefx/invar#readme
@@ -190,8 +190,9 @@ cd your-project
 uvx invar-tools init
 
 # Or quick setup (skip prompts)
-uvx invar-tools init --claude    # Claude Code
-uvx invar-tools init --pi        # Pi Coding Agent
+uvx invar-tools init --claude    # Claude Code only
+uvx invar-tools init --pi        # Pi only
+uvx invar-tools init --claude --pi  # Both agents (DX-81)
 uvx invar-tools init --mcp-only  # MCP tools only (legacy projects)
 
 # Add runtime contracts to your project
@@ -492,6 +493,7 @@ AlphaCodium · Parsel · Reflexion · Clover
 |-------|--------|-------|
 | **Claude Code** | ✅ Full | `invar init --claude` |
 | **[Pi](https://shittycodingagent.ai/)** | ✅ Full | `invar init --pi` |
+| **Multi-Agent** | ✅ Full | `invar init --claude --pi` (DX-81) |
 | **Cursor** | ✅ MCP | `invar init` → select Other, add MCP config |
 | **Other** | 📝 Manual | `invar init` → select Other, include `AGENT.md` in prompt |
 
@@ -821,6 +823,7 @@ rules = ["missing_contract", "shell_result"]
 | `invar init` | Initialize or update project (interactive) |
 | `invar init --claude` | Quick setup for Claude Code |
 | `invar init --pi` | Quick setup for Pi agent |
+| `invar init --claude --pi` | Setup for both agents (DX-81) |
 | `invar init --mcp-only` | MCP tools only (no framework files) |
 | `invar uninstall` | Remove Invar from project (preserves user content) |
 | `invar sig <file>` | Show signatures and contracts |

{invar_tools-1.14.0.dist-info → invar_tools-1.15.1.dist-info}/RECORD

@@ -72,6 +72,7 @@ invar/shell/mcp_config.py,sha256=-hC7Y5BGuVs285b6gBARk7ZyzVxHwPgXSyt_GoN0jfs,458
 invar/shell/mutation.py,sha256=Lfyk2b8j8-hxAq-iwAgQeOhr7Ci6c5tRF1TXe3CxQCs,8914
 invar/shell/pattern_integration.py,sha256=pRcjfq3NvMW_tvQCnaXZnD1k5AVEWK8CYOE2jN6VTro,7842
 invar/shell/pi_hooks.py,sha256=ulZc1sP8mTRJTBsjwFHQzUgg-h8ajRIMp7iF1Y4UUtw,6885
+invar/shell/pi_tools.py,sha256=a3ACDDXykFV8fUB5UpBmgMvppwkmLvT1k_BWm0IY47k,4068
 invar/shell/property_tests.py,sha256=N9JreyH5PqR89oF5yLcX7ZAV-Koyg5BKo-J05-GUPsA,9109
 invar/shell/py_refs.py,sha256=Vjz50lmt9prDBcBv4nkkODdiJ7_DKu5zO4UPZBjAfmM,4638
 invar/shell/skill_manager.py,sha256=Mr7Mh9rxPSKSAOTJCAM5ZHiG5nfUf6KQVCuD4LBNHSI,12440
@@ -85,7 +86,7 @@ invar/shell/commands/doc.py,sha256=SOLDoCXXGxx_JU0PKXlAIGEF36PzconHmmAtL-rM6D4,1
 invar/shell/commands/feedback.py,sha256=lLxEeWW_71US_vlmorFrGXS8IARB9nbV6D0zruLs660,7640
 invar/shell/commands/guard.py,sha256=xTQ8cPp-x1xMCtufKxmMNUSpIpH31uUjziAB8ifCnC0,24837
 invar/shell/commands/hooks.py,sha256=W-SOnT4VQyUvXwipozkJwgEYfiOJGz7wksrbcdWegUg,2356
-invar/shell/commands/init.py,sha256=bYrQWkDXGKEqncLgCFicSRt6LAmA34XyBFJ31kip-1Q,22564
+invar/shell/commands/init.py,sha256=vaPo0p7xBm3Nfgu9ytcvAjgk4dQBKvyEhrz_Cg1URMQ,23557
 invar/shell/commands/merge.py,sha256=nuvKo8m32-OL-SCQlS4SLKmOZxQ3qj-1nGCx1Pgzifw,8183
 invar/shell/commands/mutate.py,sha256=GwemiO6LlbGCBEQsBFnzZuKhF-wIMEl79GAMnKUWc8U,5765
 invar/shell/commands/perception.py,sha256=HewSv6Kv8Gw2UQqkGY2rP5YKlnwyC3LBrQ2hFVXXw30,19304
@@ -135,13 +136,14 @@ invar/templates/examples/typescript/workflow.md,sha256=5byADjA3WgOgiDbkEtVRKKGvl
 invar/templates/hooks/PostToolUse.sh.jinja,sha256=JHJGMdF3xp2qEqkPC9GaLp0NCa5gdRzqAmgRy4IldBg,3428
 invar/templates/hooks/PreToolUse.sh.jinja,sha256=tZb-FGFxOBtTprUfeChau7rZOMPII69_5HSF-i_WD4Q,3558
 invar/templates/hooks/Stop.sh.jinja,sha256=SD0PhBPeun7DTvn8Erbz11PBGAwGby4tMTd97yOJuTQ,981
-invar/templates/hooks/UserPromptSubmit.sh.jinja,sha256=sUsqBiXzIEM3C8NdN4s4C7KqPlamyVhk5_-3zd5TC9Y,2621
+invar/templates/hooks/UserPromptSubmit.sh.jinja,sha256=5xs-ASw8s_tHLvtA30nm5J7PhbpIML-8Hhv-QTTuhKY,3981
 invar/templates/hooks/__init__.py,sha256=RnnMoQA-8eqbr8Y_1Vu9B8h5vAz4C-vmo8wgdcGYrz0,43
-invar/templates/hooks/pi/invar.ts.jinja,sha256=0V7kBxPfXx18wGbZRT4F1CcuaK09oHh2IJll62N4XVM,2620
+invar/templates/hooks/pi/invar.ts.jinja,sha256=WLEYwO8tvdu9RakxFtcVRuBmaE3HgRAUFf9T5OmgP0s,4027
 invar/templates/onboard/assessment.md.jinja,sha256=EzqF0VUcxJZG2bVJLxTOyQlAERRbh9v9hXKVt6vcbxY,5850
 invar/templates/onboard/roadmap.md.jinja,sha256=gmvZk4Hdwe0l3qSFV15QGcsr-OPMhsc6-1K9F2SFSIQ,3939
 invar/templates/onboard/patterns/python.md,sha256=3wwucAcQz0DlggtpqYo-ZCnmrXgBQ0aBgUHN_EZ1VW0,8681
 invar/templates/onboard/patterns/typescript.md,sha256=yOVfHtdAdjKkWNh66_dR7z2xEA4sggbIcCKthW-fqac,11983
+invar/templates/pi-tools/invar/index.ts,sha256=G3ST0Bd8RWl7LnUGAMJmhIeTvq6L7C18ruVU4bs_S4s,19810
 invar/templates/protocol/INVAR.md.jinja,sha256=t2ZIQZJvzDTJMrRw_ijUo6ScZmeNK0-nV-H7ztTIyQQ,1464
 invar/templates/protocol/python/architecture-examples.md,sha256=O96LH9WFpk7G9MrhSbifLS5pyibTIDG-_EGFF7g3V4M,1175
 invar/templates/protocol/python/contracts-syntax.md,sha256=Q6supTQ3tChVrlN7xhcdb3Q8VGIESxQLA-mQvrNIZmo,1162
@@ -173,16 +175,16 @@ invar/templates/skills/extensions/security/SKILL.md,sha256=5mLwf4JP82Wq1vKkDIJwi
 invar/templates/skills/extensions/security/patterns/_common.yaml,sha256=75BvSABWUtO1VXFvdsMgqi86J1759T4ROhYYcizSygQ,3680
 invar/templates/skills/extensions/security/patterns/python.yaml,sha256=osyR8mWiyjW6tWjZA7QZfBIiim7XqgBYnrE45ktDx50,4658
 invar/templates/skills/extensions/security/patterns/typescript.yaml,sha256=qDEg-sxSE63Bis2IZG1y4L8m8g2ZYkC29o6t-J_LmUo,5508
-invar/templates/skills/invar-reflect/CONFIG.md,sha256=xBiKEy0TnoXNxqn55_GpkNGgmXoUg65RXwb_RdF-eGk,9291
+invar/templates/skills/invar-reflect/CONFIG.md,sha256=G8KVNROQIm7CvjrB7cwzOANQOfJg3-1_0zRVZR1sX44,12852
 invar/templates/skills/invar-reflect/SKILL.md,sha256=z0Nyh9JasZr70XhE9Es7IslxL3C8wH2lf8RewQi4Lbs,11285
 invar/templates/skills/invar-reflect/template.md,sha256=Rr5hvbllvmd8jSLf_0ZjyKt6KOod0RlNdCtZJ3lYjiM,10470
 invar/templates/skills/investigate/SKILL.md.jinja,sha256=cp6TBEixBYh1rLeeHOR1yqEnFqv1NZYePORMnavLkQI,3231
 invar/templates/skills/propose/SKILL.md.jinja,sha256=6BuKiCqO1AEu3VtzMHy1QWGqr_xqG9eJlhbsKT4jev4,3463
 invar/templates/skills/review/SKILL.md.jinja,sha256=ET5mbdSe_eKgJbi2LbgFC-z1aviKcHOBw7J5Q28fr4U,14105
-invar_tools-1.14.0.dist-info/METADATA,sha256=1cKRlX8XrRzgAVc_9EJeCzXWrDBAUFooA8tSIktfclk,28409
-invar_tools-1.14.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-invar_tools-1.14.0.dist-info/entry_points.txt,sha256=RwH_EhqgtFPsnO6RcrwrAb70Zyfb8Mh6uUtztWnUxGk,102
-invar_tools-1.14.0.dist-info/licenses/LICENSE,sha256=qeFksp4H4kfTgQxPCIu3OdagXyiZcgBlVfsQ6M5oFyk,10767
-invar_tools-1.14.0.dist-info/licenses/LICENSE-GPL,sha256=IvZfC6ZbP7CLjytoHVzvpDZpD-Z3R_qa1GdMdWlWQ6Q,35157
-invar_tools-1.14.0.dist-info/licenses/NOTICE,sha256=joEyMyFhFY8Vd8tTJ-a3SirI0m2Sd0WjzqYt3sdcglc,2561
-invar_tools-1.14.0.dist-info/RECORD,,
+invar_tools-1.15.1.dist-info/METADATA,sha256=2Pgh_tDChmFZRZpdBlLTf4JrjsX4bFFKq8XznWFTuH4,28595
+invar_tools-1.15.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+invar_tools-1.15.1.dist-info/entry_points.txt,sha256=RwH_EhqgtFPsnO6RcrwrAb70Zyfb8Mh6uUtztWnUxGk,102
+invar_tools-1.15.1.dist-info/licenses/LICENSE,sha256=qeFksp4H4kfTgQxPCIu3OdagXyiZcgBlVfsQ6M5oFyk,10767
+invar_tools-1.15.1.dist-info/licenses/LICENSE-GPL,sha256=IvZfC6ZbP7CLjytoHVzvpDZpD-Z3R_qa1GdMdWlWQ6Q,35157
+invar_tools-1.15.1.dist-info/licenses/NOTICE,sha256=joEyMyFhFY8Vd8tTJ-a3SirI0m2Sd0WjzqYt3sdcglc,2561
+invar_tools-1.15.1.dist-info/RECORD,,