invar-tools 1.12.0__py3-none-any.whl → 1.15.0__py3-none-any.whl

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

@@ -0,0 +1,343 @@
+# Invar Usage Feedback - 2026-01-03
+
+**Sessions**: 3 sessions today
+**Total Duration**: 7.5 hours
+**Total Messages**: 107
+
+---
+
+## Session Timeline
+
+### Session 1: 08:30-11:30 (Implement Authentication)
+**Messages**: 40 | **Duration**: 3h
+
+Implemented JWT authentication for API endpoints. Main challenge was understanding Core/Shell separation for token validation logic.
+
+### Session 2: 13:00-15:30 (Add Tests)
+**Messages**: 35 | **Duration**: 2.5h
+
+Added comprehensive test suite with doctests and property tests. Guard verification took longer than expected due to CrossHair timeout issues.
+
+### Session 3: 16:00-18:00 (Fix Bugs)
+**Messages**: 32 | **Duration**: 2h
+
+Fixed edge cases found in code review. Learning curve improved - fewer contract syntax errors.
+
+---
+
+## 📊 Tool Usage Statistics
+
+| Tool | Calls | Success | Failure | Success Rate |
+|------|-------|---------|---------|--------------|
+| invar_guard | 12 | 10 | 2 | 83.3% |
+| invar_sig | 18 | 18 | 0 | 100% |
+| invar_map | 5 | 5 | 0 | 100% |
+| invar_refs | 3 | 2 | 1 | 66.7% |
+
+**Total**: 38 tool calls, 35 successful (92.1% success rate)
+
+---
+
+## 😫 Aggregated Pain Points
+
+### P1: [Critical] Guard Performance Issues
+
+**First seen**: Session 1 (08:30)
+**Last seen**: Session 3 (16:45)
+**Total occurrences**: 12 times across 3 sessions
+
+**Session breakdown**:
+- Session 1: 4 times → "Takes 5 minutes to run"
+- Session 2: 5 times → "Timeout on CrossHair verification"
+- Session 3: 3 times → "Still slow even with --changed"
+
+**Context**:
+Project has 500+ Python files. Guard takes 3-5 minutes even with `--changed` flag. CrossHair verification frequently times out on complex contract conditions.
+
+**Evolution**:
+> Session 1: "5 minutes breaks my flow, totally blocking"
+> Session 3: "Found workaround but still annoying"
+
+**Current status**: Unresolved, workaround reduces impact
+
+**Workaround**:
+```bash
+invar guard --changed --skip-crosshair  # First pass
+invar guard src/core/critical.py        # Manual targeted check
+```
+
+**Suggested Improvement**:
+- Add incremental verification mode (only changed functions + callers)
+- Show progress bar with ETA during long runs
+- Allow cancellation with partial results
+- Consider caching CrossHair results for unchanged functions
+
+---
+
+### P2: [High] Contract Syntax Confusion
+
+**First seen**: Session 1 (08:45)
+**Last seen**: Session 2 (14:20)
+**Total occurrences**: 7 times across 2 sessions
+
+**Session breakdown**:
+- Session 1: 5 errors → Learning phase
+- Session 2: 2 errors → Improving
+- Session 3: 0 errors → Learned! ✓
+
+**Context**:
+Confusion about lambda parameter requirements in `@pre`/`@post` decorators. Error messages didn't clearly explain that lambda must include ALL parameters including defaults.
+
+**What I tried** (wrong):
+```python
+@pre(lambda x: x >= 0)  # Missing y parameter!
+def calc(x: int, y: int = 0):
+    ...
+```
+
+**What worked**:
+```python
+@pre(lambda x, y=0: x >= 0)  # Include defaults
+def calc(x: int, y: int = 0):
+    ...
+```
+
+**Evolution**: **RESOLVED** through practice and better error messages in latest Guard version
+
+**Suggested Improvement**:
+- Show example in error message: "Did you forget parameters? Try: @pre(lambda x, y=0: ...)"
+- Add to INVAR.md Critical Rules with prominent placement
+
+---
+
+### P3: [Medium] Core/Shell Decision Unclear
+
+**First seen**: Session 1 (09:15)
+**Last seen**: Session 3 (17:00)
+**Total occurrences**: 5 times across 3 sessions
+
+**Session breakdown**:
+- Session 1: 3 decisions, ~15 min each → Re-read docs multiple times
+- Session 2: 1 decision, ~5 min → Pattern becoming clearer
+- Session 3: 1 decision, ~2 min → Faster decisions
+
+**Context**:
+Edge cases not covered in documentation:
+- Function accepting `Path` parameter but not reading it
+- Functions using `datetime.now()` or `random`
+- Logging/stderr output
+
+**Decision Pattern**:
+| Function | My Guess | Actual | Time Spent |
+|----------|----------|--------|------------|
+| validate_path(p: Path) | Core? | Core ✓ | 5 min |
+| read_config(p: Path) | Shell | Shell ✓ | 2 min |
+| log_error(msg: str) | ??? | Shell | 15 min (re-read docs) |
+| format_timestamp(dt) | Core? | Core ✓ | 3 min |
+
+**Current status**: Ongoing learning, improving with experience
+
+**Suggested Improvement**:
+- Decision flowchart in INVAR.md
+- More edge case examples in `.invar/examples/core_shell.py`
+- Guard could hint: "This looks like Shell (uses logging)"
+
+---
+
+## ✅ What Worked Well
+
+### 1. `invar_sig` for quick contract lookup
+
+**Usage**: 18 times (most used tool)
+**Success**: 100%
+
+**Why it worked**:
+- Instant feedback - no need to read full file
+- Clear output format - contracts highlighted
+- Fast - <1s response time
+
+**Typical workflow**:
+```bash
+invar sig src/core/parser.py  # See all contracts
+# Spot the function I need
+# Copy contract pattern
+```
+
+**User experience**:
+> "This is my go-to tool. Saves tons of time vs opening files. I now check contracts before writing any Core function."
+
+---
+
+### 2. Guard auto-fix suggestions
+
+**Fixed automatically**: 5 issues
+- 3x `missing_contract` → Guard suggested contracts based on type signatures
+- 2x `redundant_type_contract` → Guard explained semantic constraint needed
+
+**User experience**:
+> "When Guard suggests fixes, I learn the pattern. By the 3rd similar error, I stopped making that mistake. The suggestions are educational, not just fixes."
+
+---
+
+### 3. Contract-first workflow (USBV)
+
+**Followed**: Understand → Specify → Build → Validate
+**Result**: 0 contract violations caught by CrossHair in Session 3
+
+**User experience**:
+> "Writing contracts before code felt slow at first (Session 1), but by Session 3, Guard caught zero violations. Saved debugging time. The upfront investment paid off."
+
+---
+
+## 🤔 Confusion Points
+
+### 1. @post cannot access parameters
+
+**What I tried** (wrong):
+```python
+@pre(lambda x: x > 0)
+@post(lambda result: result > x)  # ERROR: 'x' not available!
+def double(x: int) -> int:
+    return x * 2
+```
+
+**Error**:
+```
+NameError: name 'x' is not defined
+```
+
+**What worked**:
+```python
+@pre(lambda x: x > 0)
+@post(lambda result: result >= 0)  # Only access 'result'
+def double(x: int) -> int:
+    return x * 2
+```
+
+**Gap**: CLAUDE.md "Contract Rules" section mentions this, but I skimmed it and missed the detail. Could be more prominent.
+
+---
+
+### 2. Deal vs invar_runtime contracts
+
+**Confusion**: When to use `from deal import pre` vs `from invar_runtime import pre`?
+
+**What I learned** (after trial and error):
+- `deal.pre` → Lambda-based contracts: `@pre(lambda x: x > 0)`
+- `invar_runtime.pre` → Pre-built contract objects: `@pre(NonEmpty())`
+
+**Gap**: This distinction not explained in INVAR.md "Critical Rules" section. Found it in examples after searching.
+
+---
+
+## 🔄 Workarounds Used
+
+| Issue | Workaround | Frequency |
+|-------|------------|-----------|
+| Guard timeout | `--changed` + manual spot checks | 12 times |
+| Core/Shell confusion | Copy from examples instead of thinking | 5 times |
+| Contract syntax | Copy-paste from `.invar/examples/` | 7 times (Sessions 1-2) |
+
+---
+
+## 💡 Improvement Suggestions
+
+### High Priority
+
+1. **Incremental Guard mode**
+   - Problem: Full project scan too slow (3-5 minutes)
+   - Solution: Only verify changed functions + their callers
+   - Benefit: 10x speedup for iterative development
+
+2. **Contextual error messages**
+   - Problem: Errors say WHAT but not HOW
+   - Solution: Include example link + fix hint in error
+   - Benefit: Reduce "search for examples" friction
+
+3. **Core/Shell decision tree**
+   - Problem: Edge cases unclear
+   - Solution: Flowchart in INVAR.md + more examples
+   - Benefit: Faster decisions, less re-reading
+
+### Medium Priority
+
+4. **Interactive tutorial for first-time users**
+   - Problem: Learning curve steep (Session 1 had 5 contract errors)
+   - Solution: `invar tutorial` command with guided examples
+   - Benefit: Faster onboarding
+
+5. **Guard progress indicator**
+   - Problem: No feedback during long runs (anxiety-inducing)
+   - Solution: Show "Checking file 45/120..." with ETA
+   - Benefit: Less anxiety, can estimate wait time
+
+6. **Contract snippet library**
+   - Problem: Repetitive contract patterns (e.g., "non-empty string")
+   - Solution: `invar snippet list` with common patterns
+   - Benefit: Copy-paste correct patterns quickly
+
+### Low Priority
+
+7. **Guard performance dashboard**
+   - Problem: Can't see what's slow
+   - Solution: `--profile` flag showing time per rule/file
+   - Benefit: Optimize workflow, identify bottlenecks
+
+---
+
+## 📈 Daily Summary
+
+### High-Frequency Issues (Top 3)
+1. **Guard performance** - 12 occurrences, still blocking
+2. **Contract syntax** - 7 occurrences, now resolved ✓
+3. **Core/Shell decision** - 5 occurrences, ongoing learning
+
+### Learning Progress
+| Issue | Session 1 | Session 2 | Session 3 | Trend |
+|-------|-----------|-----------|-----------|-------|
+| Contract syntax | 5 errors | 2 errors | 0 errors | ✅ Learned |
+| Core/Shell | Confused (15 min) | Still unsure (5 min) | Clearer (2 min) | 📈 Improving |
+| Guard usage | Blocked | Found workaround | Using workaround | ⚠️ Not fixed |
+
+### Sentiment Evolution
+- **Morning (Session 1)**: Frustrated (Guard blocks progress, contract errors)
+- **Afternoon (Session 2)**: Adapting (workarounds found, fewer errors)
+- **Evening (Session 3)**: Productive (main friction remains but manageable)
+
+---
+
+## 🎯 Session Success Metrics
+
+| Metric | Value | Assessment |
+|--------|-------|------------|
+| Task completed | ✅ Yes | Success |
+| Guard final pass | ✅ 0 errors | Success |
+| Time to first Guard pass | 2.5 hours | Could be faster |
+| Stuck on Invar issues | ~45 min total | Acceptable |
+| Would recommend Invar | ✅ Yes | Positive overall |
+
+---
+
+## 📝 Additional Notes
+
+- First time using `invar refs` - worked great for finding TypeScript symbol usage
+- Didn't use `invar map` much this session - not sure when it's better than `invar sig`
+- Skill system (`/develop`, `/review`) works smoothly - no issues
+- USBV workflow feels natural by Session 3 - initial friction worth it
+
+---
+
+## 🔒 Privacy Notice
+
+This feedback document is stored locally in `.invar/feedback/`.
+You control what (if anything) to share with Invar maintainers.
+
+**To share feedback**:
+1. Review this document
+2. Remove any sensitive project details
+3. Submit via GitHub issue or email to invar-maintainers@example.com
+
+---
+
+*Generated by `/invar-reflect` v1.0*
+*Last updated: 2026-01-03 18:15*

{invar_tools-1.12.0.dist-info → invar_tools-1.15.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: invar-tools
-Version: 1.12.0
+Version: 1.15.0
 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.12.0.dist-info → invar_tools-1.15.0.dist-info}/RECORD

@@ -6,6 +6,7 @@ invar/core/doc_edit.py,sha256=kLBkSQMFiXKdZMlQYAy-pzld1f1p2UFKGpKVVJo8Nes,6690
 invar/core/doc_parser.py,sha256=yzZKzgr9myUiiRGtRidT2tubrs4-omtGlTwbUkSKhoM,18197
 invar/core/entry_points.py,sha256=1p6GRGTp9kA9spNkGKidFLlzLPheh6JO2XFb68Cr0sE,12209
 invar/core/extraction.py,sha256=mScqEMEEQdsd-Z0jx9g3scK6Z1vI9l-ESjggXPIWHZ4,6112
+invar/core/feedback.py,sha256=JhQf32y_Qutza8D2b5qX2U4fM--vtR3sBdV22KrVNY0,3246
 invar/core/format_specs.py,sha256=P299aRHFMXyow8STwsvaT6Bg2ALPs2wSy7SByiRZZ-A,5610
 invar/core/format_strategies.py,sha256=LifL97JbsF8WEkVNmQpq2htyFUC3pW21myAjtRGpSxU,5774
 invar/core/formatter.py,sha256=rCGZhMpl4dPLrztgKDkNtAvnv2vKfomyIHl_6fThuno,11293
@@ -58,7 +59,7 @@ invar/node_tools/fc-runner/cli.js,sha256=72_gIhvnx2peKITdzdnFWI5fzGaNTS3BcEqyS62
 invar/node_tools/quick-check/cli.js,sha256=dwV3hdJleFQga2cKUn3PPfQDvvujhzKdjQcIvWsKgM0,66196
 invar/node_tools/ts-analyzer/cli.js,sha256=SvZ6HyjmobpP8NAZqXFiy8BwH_t5Hb17Ytar_18udaQ,4092887
 invar/shell/__init__.py,sha256=FFw1mNbh_97PeKPcHIqQpQ7mw-JoIvyLM1yOdxLw5uk,204
-invar/shell/claude_hooks.py,sha256=I_2VEepwS0kW55lW7U--FPwpuJq5hAXECcyYCd9D-jM,17360
+invar/shell/claude_hooks.py,sha256=hV4DfG3cVng32f0Rxoo070tliVlYFC5v9slIWEbAD7E,18899
 invar/shell/config.py,sha256=6-kbo6--SxfROXoyU-v7InSLR8f_U1Mar_xEOdCXFkY,17633
 invar/shell/contract_coverage.py,sha256=81OQkQqUVYUKytG5aiJyRK62gwh9UzbSG926vkvFTc8,12088
 invar/shell/coverage.py,sha256=m01o898IFIdBztEBQLwwL1Vt5PWrpUntO4lv4nWEkls,11344
@@ -71,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=_xTxE3zeEWSUm3IuuMziglkB_nL8NIco7kQ2nZkCMLU,3668
 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
@@ -81,9 +83,10 @@ invar/shell/testing.py,sha256=rTNBH0Okh2qtG9ohSXOz487baQ2gXrWT3s_WECW3HJs,11143
 invar/shell/ts_compiler.py,sha256=nA8brnOhThj9J_J3vAEGjDsM4NjbWQ_eX8Yf4pHPOgk,6672
 invar/shell/commands/__init__.py,sha256=MEkKwVyjI9DmkvBpJcuumXo2Pg_FFkfEr-Rr3nrAt7A,284
 invar/shell/commands/doc.py,sha256=SOLDoCXXGxx_JU0PKXlAIGEF36PzconHmmAtL-rM6D4,13819
-invar/shell/commands/guard.py,sha256=p0kI63RUzC1OTh_YviviY6dz2bq_SoBksGOp2NyocQM,24512
+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=-FZTYTwJr_NRoluAM4YwcseNju56GSxtnKVkqsXREPg,20461
+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
@@ -102,7 +105,7 @@ invar/shell/prove/hypothesis.py,sha256=QUclOOUg_VB6wbmHw8O2EPiL5qBOeBRqQeM04AVuL
 invar/templates/CLAUDE.md.template,sha256=eaGU3SyRO_NEifw5b26k3srgQH4jyeujjCJ-HbM36_w,4913
 invar/templates/__init__.py,sha256=cb3ht8KPK5oBn5oG6HsTznujmo9WriJ_P--fVxJwycc,45
 invar/templates/context.md.template,sha256=FKyI1ghpqcf4wftyv9-auIFHor8Nm8lETN45Ja-L8Og,2386
-invar/templates/manifest.toml,sha256=UzLXcLPrRq9-99wdEMEGAHo_YWMordyDLjLhgkJPeZE,4500
+invar/templates/manifest.toml,sha256=2S_pmyH4bcsJEeSbrIJVfkso4mPu5wHDHgy48uTzyK0,4981
 invar/templates/proposal.md.template,sha256=UP7SpQ7gk8jVlHGLQCSQ5c-kCj1DBQEz8M-vEStK77I,1573
 invar/templates/claude-md/python/critical-rules.md,sha256=Pkw6ZXFtAN2WGOeTD0CwkB_T73fd66NGzdOFM0wn-80,895
 invar/templates/claude-md/python/quick-reference.md,sha256=ttd0TwgyIY0qt6qbeaCn4GO0e2OKedFLQE3yG32SlrA,672
@@ -110,11 +113,12 @@ invar/templates/claude-md/typescript/critical-rules.md,sha256=wC8EsPMR6R5sEAi6a3
 invar/templates/claude-md/typescript/quick-reference.md,sha256=JtuUOrExY3TURZwc8vZA0t83etYL6ci1d7AqjUkUM3U,695
 invar/templates/claude-md/universal/check-in.md,sha256=EUlpig5Cp0MRctlx7U49Ia7lEHkZriFXWj4-qHkDmTU,616
 invar/templates/claude-md/universal/skills.md,sha256=O0JgCQNzUTEGAsGYTZg0HoBTffn-pRxQV6iso4MTUuc,2584
+invar/templates/claude-md/universal/tool-selection.md,sha256=QJcxDmXE6atiRU3d-Autm3q5gOedBumG_foikcIiG8o,3707
 invar/templates/claude-md/universal/workflow.md,sha256=MatlbihubRg9zAjjuR331PSJ9xwMCusUVfbc86YEVoE,1966
 invar/templates/commands/audit.md.jinja,sha256=Gwh3LNNcNWHzsOC7chYYg5ym8BxWTjySain3qPOs8pM,4817
 invar/templates/commands/guard.md,sha256=N_C_AXd9kI85W1B0aTEycjiDp_jdaP8eeq8O0FQ_WQ8,1227
 invar/templates/config/AGENT.md.jinja,sha256=tBIK5kZ7hjWgABU96Yq5_w3gNw_F31gQ19h4u1MLY4o,7037
-invar/templates/config/CLAUDE.md.jinja,sha256=-cnl2yU3n4xP3nACEvmk2DK7ptniymQrS3eBUnGAj34,1737
+invar/templates/config/CLAUDE.md.jinja,sha256=Mr3Q6B5ojczLlHmxLO8xnoHNDS2oqWoswdMi69X_oHc,1792
 invar/templates/config/context.md.jinja,sha256=BZnqBg_CXz3QFiCc8rfG8Kav_BGaGmSqxATKMliMA7k,3911
 invar/templates/config/pre-commit.yaml.jinja,sha256=nUPxLxkTHAgZwhFAuOMDbZ8v0NQV9FlQPbr2MDEOsoA,1778
 invar/templates/examples/python/README.md,sha256=mBsWKgQOF_PMQ_rf91TTjAEHpwfnb8Bb3x80D82bNZE,703
@@ -132,23 +136,24 @@ 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=fhE3aGKk5VYcUdbeVMv-x3tqWHA0eVU641pytY06Bvg,6694
 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
 invar/templates/protocol/python/markers.md,sha256=fzltCKbdPVz_vCuJFiQ9pbRPztvpMJpSf_4aFHcXFLM,1223
-invar/templates/protocol/python/tools.md,sha256=LBFh-6vW-MMbyxU3qYr9m7edqKELUKsfPcICZ5S76yU,896
+invar/templates/protocol/python/tools.md,sha256=RULbZhisRxNI1oTxYzhWI3NTVyKNukrkQbwR5XWQt2Y,1043
 invar/templates/protocol/python/troubleshooting.md,sha256=-JHLUOxvfQeSrLpqKrxUXQ5UrkW44AHFr3LGHwxnw7w,1081
 invar/templates/protocol/typescript/architecture-examples.md,sha256=Dej-DI6OqRVsbzjukjOqdO8WEz0aT-1iwYqrah2B_xk,1454
 invar/templates/protocol/typescript/contracts-syntax.md,sha256=yKyM6WhyF5p-bt-RqD5SI4ZZudE7bLLFTAMzVSa74QE,1610
 invar/templates/protocol/typescript/markers.md,sha256=8mHzYfBlQ2baeQSV2e7uY2p6_EW1rwKVjToTLiQwUrQ,1536
-invar/templates/protocol/typescript/tools.md,sha256=S_LG-o2X8fAudAcWYV41doIMYoFXUKyFvcff0keF_CI,1537
+invar/templates/protocol/typescript/tools.md,sha256=c0xu0n15iFcNAET8wOqKdcgG2n_OC0hP4xE7rZaFDI0,1691
 invar/templates/protocol/typescript/troubleshooting.md,sha256=kHx4Ykfgv6S1OXMmLZ3jMft6aqy60c9ODEhfs5kcybo,2588
 invar/templates/protocol/universal/architecture.md,sha256=WT6wL0VDPD4n8yXBQEOXXnzh2IkK18oOt76lZelN3As,1379
 invar/templates/protocol/universal/completion.md,sha256=bFo8-Npa7vb1efQLgOdGDSWnho45f0BBxvaD8awFLus,425
@@ -170,13 +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=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.12.0.dist-info/METADATA,sha256=jpbC0FFokpDTexuAf5nodUMsRM46nU5-ZC0SmVVN5cQ,28409
-invar_tools-1.12.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-invar_tools-1.12.0.dist-info/entry_points.txt,sha256=RwH_EhqgtFPsnO6RcrwrAb70Zyfb8Mh6uUtztWnUxGk,102
-invar_tools-1.12.0.dist-info/licenses/LICENSE,sha256=qeFksp4H4kfTgQxPCIu3OdagXyiZcgBlVfsQ6M5oFyk,10767
-invar_tools-1.12.0.dist-info/licenses/LICENSE-GPL,sha256=IvZfC6ZbP7CLjytoHVzvpDZpD-Z3R_qa1GdMdWlWQ6Q,35157
-invar_tools-1.12.0.dist-info/licenses/NOTICE,sha256=joEyMyFhFY8Vd8tTJ-a3SirI0m2Sd0WjzqYt3sdcglc,2561
-invar_tools-1.12.0.dist-info/RECORD,,
+invar_tools-1.15.0.dist-info/METADATA,sha256=Xm0Suh3a3jfCfDBqzsuYpuVRwT4dWxRF5-PnZDMgYas,28595
+invar_tools-1.15.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+invar_tools-1.15.0.dist-info/entry_points.txt,sha256=RwH_EhqgtFPsnO6RcrwrAb70Zyfb8Mh6uUtztWnUxGk,102
+invar_tools-1.15.0.dist-info/licenses/LICENSE,sha256=qeFksp4H4kfTgQxPCIu3OdagXyiZcgBlVfsQ6M5oFyk,10767
+invar_tools-1.15.0.dist-info/licenses/LICENSE-GPL,sha256=IvZfC6ZbP7CLjytoHVzvpDZpD-Z3R_qa1GdMdWlWQ6Q,35157
+invar_tools-1.15.0.dist-info/licenses/NOTICE,sha256=joEyMyFhFY8Vd8tTJ-a3SirI0m2Sd0WjzqYt3sdcglc,2561
+invar_tools-1.15.0.dist-info/RECORD,,