Skip to content

Commit 73556c3

Browse files
committed
chore: Prepare v1.0.0 for PyPI release
- Update all GitHub links to intersystems-community org - Bump version to 1.0.0 in __init__.py and module.xml - Convert all relative links to absolute for PyPI rendering - Update docs/ to use community repo URLs - Build and validate PyPI package
1 parent b40cd07 commit 73556c3

File tree

8 files changed

+286
-37
lines changed

8 files changed

+286
-37
lines changed

.mcp.json

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"mcpServers": {
3+
"qwen-impl": {
4+
"type": "stdio",
5+
"command": "/Users/tdyar/ws/productivity-framework/tools/qwen-mcp/venv/bin/python",
6+
"args": ["/Users/tdyar/ws/productivity-framework/tools/qwen-mcp/qwen_mcp_server.py"],
7+
"env": {
8+
"QWEN_BASE_URL": "${QWEN_BASE_URL}",
9+
"QWEN_MODEL": "${QWEN_MODEL}",
10+
"GEMINI_API_KEY": "${GEMINI_API_KEY}",
11+
"GEMINI_MODEL": "${GEMINI_MODEL}"
12+
}
13+
},
14+
"gemini-impl": {
15+
"type": "stdio",
16+
"command": "/Users/tdyar/ws/productivity-framework/tools/gemini-mcp/venv/bin/python",
17+
"args": ["/Users/tdyar/ws/productivity-framework/tools/gemini-mcp/gemini_mcp_server.py"],
18+
"env": {
19+
"GEMINI_API_KEY": "${GEMINI_API_KEY}"
20+
}
21+
}
22+
}
23+
}

.specify/model-routing.yaml

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# Model Routing Configuration for SpecKit
2+
# Defines which models/tools to use for each workflow phase
3+
4+
phases:
5+
# Clarification phase - quick, cheap interactions
6+
clarify:
7+
orchestrator_model_alias: haiku
8+
description: "Use Haiku for clarifying specs, asking questions, small edits"
9+
10+
# Task breakdown phase - structured analysis
11+
tasks:
12+
orchestrator_model_alias: haiku
13+
description: "Use Haiku for breaking down work into tasks"
14+
15+
# Planning phase - deeper reasoning required
16+
plan:
17+
orchestrator_model_alias: opusplan
18+
description: "Use Opus Plan Mode for architecture and planning (executes on Sonnet)"
19+
20+
# Implementation phase - high token volume, use Qwen (free on VPN) with Gemini fallback
21+
implement:
22+
tool: qwen_implement
23+
orchestrator_model_alias: sonnet
24+
description: "Use Qwen (free on VPN) or Gemini fallback for code implementation, Sonnet for orchestration"
25+
26+
# Review phase - validation and checking
27+
review:
28+
orchestrator_model_alias: sonnet
29+
description: "Use Sonnet for code review and validation"
30+
31+
# Complex architecture - only when truly needed
32+
architect:
33+
orchestrator_model_alias: opus
34+
description: "Reserve Opus for cross-service architecture decisions"
35+
36+
# Model tier descriptions for agent context
37+
model_tiers:
38+
haiku:
39+
use_for:
40+
- "Clarifying specs and requirements"
41+
- "Small edits and summaries"
42+
- "Task breakdown and checklists"
43+
- "Quick questions and answers"
44+
cost: "lowest"
45+
46+
sonnet:
47+
use_for:
48+
- "Planning within a single service"
49+
- "Validating plans and checklists"
50+
- "Coordinating implementation"
51+
- "Code review"
52+
cost: "moderate"
53+
54+
qwen:
55+
use_for:
56+
- "Code implementation (when on VPN)"
57+
- "Large refactors and multi-file edits"
58+
- "Generating patches and diffs"
59+
- "High-volume code generation"
60+
cost: "free (VPN only, falls back to Gemini)"
61+
tool: "qwen_implement"
62+
63+
gemini_flash:
64+
use_for:
65+
- "Code implementation (fallback when off VPN)"
66+
- "Same as Qwen but always available"
67+
cost: "low (via MCP tool)"
68+
tool: "gemini_implement"
69+
70+
opus:
71+
use_for:
72+
- "Cross-service architecture decisions"
73+
- "Extremely complex reasoning"
74+
- "Novel problem solving"
75+
cost: "highest - use sparingly"
76+
77+
# Default model when not in a specific phase
78+
default_model: sonnet

README.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Connect **any PostgreSQL-compatible tool** to InterSystems IRIS without custom d
3030
### Docker (Fastest - 60 seconds)
3131

3232
```bash
33-
git clone https://github.com/isc-tdyar/iris-pgwire.git
33+
git clone https://github.com/intersystems-community/iris-pgwire.git
3434
cd iris-pgwire
3535
docker-compose up -d
3636

@@ -274,7 +274,7 @@ conn = psycopg.connect("host=localhost port=5432 user=_SYSTEM password=SYS dbnam
274274
**IRIS Wallet**: Encrypted credential storage with audit trail (zero plain-text passwords in code)
275275
**SCRAM-SHA-256**: Industry best practice for password authentication (replaces deprecated MD5)
276276

277-
See [Authentication Guide](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/DEPLOYMENT.md#authentication) for detailed configuration
277+
See [Authentication Guide](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/DEPLOYMENT.md#authentication) for detailed configuration
278278

279279
---
280280

@@ -304,7 +304,7 @@ docker-compose --profile bi-tools up superset
304304
# Access: http://localhost:8088 (admin / admin)
305305
```
306306

307-
**Try the Healthcare Demo**: Complete working example with 250 patient records and 400 lab results - see [Superset Healthcare Example](https://github.com/isc-tdyar/iris-pgwire/blob/main/examples/superset-iris-healthcare/README.md) for <10 minute setup.
307+
**Try the Healthcare Demo**: Complete working example with 250 patient records and 400 lab results - see [Superset Healthcare Example](https://github.com/intersystems-community/iris-pgwire/blob/main/examples/superset-iris-healthcare/README.md) for <10 minute setup.
308308

309309
#### Metabase
310310
User-friendly business intelligence tool with visual query builder.
@@ -354,7 +354,7 @@ LIMIT 10
354354
- ✅ Binary parameter encoding (40% more compact than text)
355355
- ✅ 100% success rate across all dimensions and execution paths
356356

357-
**Detailed Benchmarks**: See [benchmarks/README_4WAY.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/benchmarks/README_4WAY.md) and [Vector Parameter Binding](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/VECTOR_PARAMETER_BINDING.md)
357+
**Detailed Benchmarks**: See [benchmarks/README_4WAY.md](https://github.com/intersystems-community/iris-pgwire/blob/main/benchmarks/README_4WAY.md) and [Vector Parameter Binding](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/VECTOR_PARAMETER_BINDING.md)
358358

359359
---
360360

@@ -400,7 +400,7 @@ LIMIT 10
400400
- **Query Translation**: SQL rewriting, pgvector → IRIS vector functions
401401
- **Connection Pooling**: Async pool with configurable limits (DBAPI backend)
402402

403-
**Detailed Architecture**: See [Dual-Path Architecture](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/DUAL_PATH_ARCHITECTURE.md)
403+
**Detailed Architecture**: See [Dual-Path Architecture](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/DUAL_PATH_ARCHITECTURE.md)
404404

405405
---
406406

@@ -417,7 +417,7 @@ LIMIT 10
417417

418418
```bash
419419
# Clone repository
420-
git clone https://github.com/isc-tdyar/iris-pgwire.git
420+
git clone https://github.com/intersystems-community/iris-pgwire.git
421421
cd iris-pgwire
422422

423423
# Start services
@@ -475,19 +475,19 @@ irispython -m iris_pgwire.server
475475
## 📚 Documentation
476476

477477
### Getting Started
478-
- **[Installation Guide](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/DEPLOYMENT.md)** - Detailed deployment instructions
479-
- **[BI Tools Setup](https://github.com/isc-tdyar/iris-pgwire/blob/main/examples/BI_TOOLS_SETUP.md)** - Superset, Metabase, Grafana integration
480-
- **[Developer Guide](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/developer_guide.md)** - Development setup and contribution
478+
- **[Installation Guide](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/DEPLOYMENT.md)** - Detailed deployment instructions
479+
- **[BI Tools Setup](https://github.com/intersystems-community/iris-pgwire/blob/main/examples/BI_TOOLS_SETUP.md)** - Superset, Metabase, Grafana integration
480+
- **[Developer Guide](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/developer_guide.md)** - Development setup and contribution
481481

482482
### Core Features
483-
- **[Vector Parameter Binding](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/VECTOR_PARAMETER_BINDING.md)** - High-dimensional vector support
484-
- **[DBAPI Backend Guide](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/DBAPI_BACKEND.md)** - Connection pooling configuration
485-
- **[Testing Guide](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/testing.md)** - Test framework and validation
483+
- **[Vector Parameter Binding](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/VECTOR_PARAMETER_BINDING.md)** - High-dimensional vector support
484+
- **[DBAPI Backend Guide](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/DBAPI_BACKEND.md)** - Connection pooling configuration
485+
- **[Testing Guide](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/testing.md)** - Test framework and validation
486486

487487
### Architecture
488-
- **[Dual-Path Architecture](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/DUAL_PATH_ARCHITECTURE.md)** - DBAPI vs Embedded execution
489-
- **[Embedded Python Servers](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/EMBEDDED_PYTHON_SERVERS_HOWTO.md)** - Running inside IRIS
490-
- **[Client Compatibility](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/CLIENT_RECOMMENDATIONS.md)** - PostgreSQL client matrix
488+
- **[Dual-Path Architecture](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/DUAL_PATH_ARCHITECTURE.md)** - DBAPI vs Embedded execution
489+
- **[Embedded Python Servers](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/EMBEDDED_PYTHON_SERVERS_HOWTO.md)** - Running inside IRIS
490+
- **[Client Compatibility](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/CLIENT_RECOMMENDATIONS.md)** - PostgreSQL client matrix
491491

492492
---
493493

@@ -508,7 +508,7 @@ irispython -m iris_pgwire.server
508508
**SSL/TLS**: Delegated to reverse proxy (nginx/HAProxy) - industry-standard pattern matching QuestDB, Tailscale pgproxy
509509
**Kerberos**: Not implemented - matches PgBouncer, YugabyteDB, PGAdapter (use OAuth 2.0 instead)
510510

511-
See [KNOWN_LIMITATIONS.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/KNOWN_LIMITATIONS.md) for detailed deployment guidance and industry comparison
511+
See [KNOWN_LIMITATIONS.md](https://github.com/intersystems-community/iris-pgwire/blob/main/KNOWN_LIMITATIONS.md) for detailed deployment guidance and industry comparison
512512

513513
---
514514

@@ -543,7 +543,7 @@ Connection path latency comparison (50 iterations, 128-dimensional vectors):
543543
- PGWire adds ~4ms protocol translation overhead for PostgreSQL client compatibility
544544
- For maximum performance, use IRIS DBAPI driver directly when PostgreSQL compatibility isn't required
545545

546-
*Benchmarks from 2025-10-05. See [benchmarks/README_4WAY.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/benchmarks/README_4WAY.md) for methodology.*
546+
*Benchmarks from 2025-10-05. See [benchmarks/README_4WAY.md](https://github.com/intersystems-community/iris-pgwire/blob/main/benchmarks/README_4WAY.md) for methodology.*
547547

548548
**Run Your Own Benchmarks**:
549549
```bash
@@ -563,7 +563,7 @@ python3 benchmarks/4way_comparison.py \
563563

564564
```bash
565565
# Clone repository
566-
git clone https://github.com/isc-tdyar/iris-pgwire.git
566+
git clone https://github.com/intersystems-community/iris-pgwire.git
567567
cd iris-pgwire
568568

569569
# Install development dependencies
@@ -582,7 +582,7 @@ pytest -v
582582

583583
## 🔗 Links
584584

585-
- **Repository**: https://github.com/isc-tdyar/iris-pgwire
585+
- **Repository**: https://github.com/intersystems-community/iris-pgwire
586586
- **IRIS Documentation**: https://docs.intersystems.com/iris/
587587
- **PostgreSQL Protocol**: https://www.postgresql.org/docs/current/protocol.html
588588
- **pgvector**: https://github.com/pgvector/pgvector
@@ -591,7 +591,7 @@ pytest -v
591591

592592
## 📄 License
593593

594-
MIT License - See [LICENSE](https://github.com/isc-tdyar/iris-pgwire/blob/main/LICENSE) for details
594+
MIT License - See [LICENSE](https://github.com/intersystems-community/iris-pgwire/blob/main/LICENSE) for details
595595

596596
---
597597

@@ -672,4 +672,4 @@ with psycopg.connect("host=localhost port=5432 dbname=USER") as conn:
672672

673673
---
674674

675-
**Questions?** File an issue on [GitHub](https://github.com/isc-tdyar/iris-pgwire/issues)
675+
**Questions?** File an issue on [GitHub](https://github.com/intersystems-community/iris-pgwire/issues)

docs/DUAL_PATH_ARCHITECTURE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -320,9 +320,9 @@ class TestDualPathComparison:
320320

321321
## References
322322

323-
- HNSW Investigation: [docs/HNSW_INVESTIGATION.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/docs/HNSW_INVESTIGATION.md)
324-
- Constitutional Governance: [src/iris_pgwire/constitutional.py](https://github.com/isc-tdyar/iris-pgwire/blob/main/src/iris_pgwire/constitutional.py)
325-
- CLAUDE.md: [CLAUDE.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/CLAUDE.md)
323+
- HNSW Investigation: [docs/HNSW_INVESTIGATION.md](https://github.com/intersystems-community/iris-pgwire/blob/main/docs/HNSW_INVESTIGATION.md)
324+
- Constitutional Governance: [src/iris_pgwire/constitutional.py](https://github.com/intersystems-community/iris-pgwire/blob/main/src/iris_pgwire/constitutional.py)
325+
- CLAUDE.md: [CLAUDE.md](https://github.com/intersystems-community/iris-pgwire/blob/main/CLAUDE.md)
326326
- User Requirement: "we need to put this in the specs and constitution!!!!!!!"
327327

328328
## Constitutional Status

docs/articles/developer-community-article.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ IRIS PGWire is my Christmas gift to the InterSystems developer community. It's a
9595

9696
```bash
9797
# Quick Start
98-
git clone https://github.com/isc-tdyar/iris-pgwire.git
98+
git clone https://github.com/intersystems-community/iris-pgwire.git
9999
cd iris-pgwire
100100
docker-compose up -d
101101

@@ -218,7 +218,7 @@ Every user story in the spec maps to acceptance criteria. Every acceptance crite
218218
## Try It Yourself
219219

220220
### IRIS PGWire
221-
- **GitHub**: https://github.com/isc-tdyar/iris-pgwire
221+
- **GitHub**: https://github.com/intersystems-community/iris-pgwire
222222
- **Open Exchange**: Coming soon!
223223
- **Quick Start**: 60 seconds with Docker
224224

@@ -247,7 +247,7 @@ Happy Holidays from InterSystems. May your prompts be clear and your tests be gr
247247

248248
## Resources
249249

250-
- [IRIS PGWire GitHub Repository](https://github.com/isc-tdyar/iris-pgwire) - The "after" (27 specs, 171 tests)
250+
- [IRIS PGWire GitHub Repository](https://github.com/intersystems-community/iris-pgwire) - The "after" (27 specs, 171 tests)
251251
- [Internal project started a few months ago](https://github.com/isc-tdyar/iris-vector-rag) - The "before" (no specs, AI slop)
252252
- [specify-kit Claude Code Workflow](https://github.com/ProfSynapse/specify-kit)
253253
- [Kiro - AWS Spec-Driven Development](https://kiro.dev)

docs/presentations/speckit-internal-talk.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -170,7 +170,7 @@ Creates a feature branch and spec from natural language.
170170
- Success Criteria (measurable outcomes)
171171
- Key Entities
172172

173-
[View Example: specs/028-readme-performance/spec.md](https://github.com/isc-tdyar/iris-pgwire/blob/028-readme-performance/specs/028-readme-performance/spec.md)
173+
[View Example: specs/028-readme-performance/spec.md](https://github.com/intersystems-community/iris-pgwire/blob/028-readme-performance/specs/028-readme-performance/spec.md)
174174

175175
---
176176

@@ -198,7 +198,7 @@ Scans spec for ambiguities and asks targeted questions (max 5).
198198
→ A: Smoke test - Copy-paste and run each example manually
199199
```
200200

201-
[View Example: specs/026-doc-review/spec.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/specs/026-doc-review/spec.md)
201+
[View Example: specs/026-doc-review/spec.md](https://github.com/intersystems-community/iris-pgwire/blob/main/specs/026-doc-review/spec.md)
202202

203203
---
204204

@@ -220,7 +220,7 @@ specs/026-doc-review/
220220
- Constitution check (principles verification)
221221
- Phase-by-phase implementation approach
222222

223-
[View Example: specs/026-doc-review/plan.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/specs/026-doc-review/plan.md)
223+
[View Example: specs/026-doc-review/plan.md](https://github.com/intersystems-community/iris-pgwire/blob/main/specs/026-doc-review/plan.md)
224224

225225
---
226226

@@ -252,7 +252,7 @@ Breaks plan into ordered, executable tasks:
252252
- Phase 3 (Accuracy): Can run parallel with Phase 2
253253
```
254254

255-
[View Example: specs/026-doc-review/tasks.md](https://github.com/isc-tdyar/iris-pgwire/blob/main/specs/026-doc-review/tasks.md)
255+
[View Example: specs/026-doc-review/tasks.md](https://github.com/intersystems-community/iris-pgwire/blob/main/specs/026-doc-review/tasks.md)
256256

257257
---
258258

@@ -429,11 +429,11 @@ Every `/plan` checks against constitution. Violations flagged.
429429

430430
## Resources
431431

432-
- **This Project**: [github.com/isc-tdyar/iris-pgwire](https://github.com/isc-tdyar/iris-pgwire)
433-
- **Example Spec (026)**: [specs/026-doc-review/](https://github.com/isc-tdyar/iris-pgwire/tree/main/specs/026-doc-review)
434-
- **Example Spec (028)**: [specs/028-readme-performance/](https://github.com/isc-tdyar/iris-pgwire/tree/028-readme-performance/specs/028-readme-performance)
435-
- **SpecKit Commands**: [.claude/commands/](https://github.com/isc-tdyar/iris-pgwire/tree/main/.claude/commands)
436-
- **Templates**: [.specify/templates/](https://github.com/isc-tdyar/iris-pgwire/tree/main/.specify/templates)
432+
- **This Project**: [github.com/intersystems-community/iris-pgwire](https://github.com/intersystems-community/iris-pgwire)
433+
- **Example Spec (026)**: [specs/026-doc-review/](https://github.com/intersystems-community/iris-pgwire/tree/main/specs/026-doc-review)
434+
- **Example Spec (028)**: [specs/028-readme-performance/](https://github.com/intersystems-community/iris-pgwire/tree/028-readme-performance/specs/028-readme-performance)
435+
- **SpecKit Commands**: [.claude/commands/](https://github.com/intersystems-community/iris-pgwire/tree/main/.claude/commands)
436+
- **Templates**: [.specify/templates/](https://github.com/intersystems-community/iris-pgwire/tree/main/.specify/templates)
437437

438438
---
439439

src/iris_pgwire/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
caretdev/sqlalchemy-iris.
77
"""
88

9-
__version__ = "0.1.0"
9+
__version__ = "1.0.0"
1010
__author__ = "IRIS PGWire Team"
1111

1212
# Don't import server/protocol in __init__ to avoid sys.modules conflicts

0 commit comments

Comments
 (0)