@topce/pizx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Slobodan Filipovic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# pizx
+
+**zx fork with native Pi AI integration** — 15 template tags for shell scripting, AI text generation, coding agents, agentic patterns, communication, and orchestration topologies.
+
+```js
+#!/usr/bin/env pizx
+const files = (await $`ls src/`).stdout.trim()
+const summary = await π`summarize these files: ${files}`
+await Π`fix TypeScript errors flagged in: ${summary}`
+await Ρ`iteratively improve error handling across src/`
+const plan = await Ω`design a comprehensive testing strategy for this project`
+```
+
+## Tags Reference
+
+Each tag has its own detailed documentation in [`docs/`](docs/):
+
+### Core
+
+| Tag | Name | Description | Docs |
+|---|---|---|---|
+| `$` | Shell | Shell commands (unchanged from zx) | — |
+| `π` | Pi | AI text generation via pi-ai | [docs/pi.md](docs/pi.md) |
+| `Π` | Capital Pi | Pi coding agent with tools (read, bash, edit, write) | [docs/capital-pi.md](docs/capital-pi.md) |
+
+### Agent Patterns (Ρ Φ Σ Δ Λ Ψ Ω Ν)
+
+| Tag | Name | Flow | Docs |
+|---|---|---|---|
+| `Ρ` | Ralph Loop | analyze → plan → execute → review ↺ | [docs/ralph.md](docs/ralph.md) |
+| `Φ` | Fleet | A, B, C in parallel → aggregate | [docs/fleet.md](docs/fleet.md) |
+| `Σ` | Subagents | decompose → sub-agents → synthesize | [docs/subagent.md](docs/subagent.md) |
+| `Δ` | Debate | perspectives → converge | [docs/debate.md](docs/debate.md) |
+| `Λ` | Pipeline | stage₁ → stage₂ → stage₃ | [docs/pipeline.md](docs/pipeline.md) |
+| `Ψ` | Critique | generate → critique → improve | [docs/critique.md](docs/critique.md) |
+| `Ω` | Orchestrator | plan → dispatch → synthesize | [docs/orchestrator.md](docs/orchestrator.md) |
+| `Ν` | Nu | analyze → negotiate roles → execute → synthesize | [docs/nu.md](docs/nu.md) |
+
+### Communication Patterns (Θ Μ Β)
+
+| Tag | Name | Pattern | Docs |
+|---|---|---|---|
+| `Θ` | Thread | Multi-agent conversation | [docs/thread.md](docs/thread.md) |
+| `Μ` | Memory | Shared blackboard | [docs/memory.md](docs/memory.md) |
+| `Β` | Broadcast | One-to-many messaging | [docs/broadcast.md](docs/broadcast.md) |
+
+### Orchestration Topologies (Α Γ Χ Τ)
+
+| Tag | Name | Pattern | Docs |
+|---|---|---|---|
+| `Α` | Adaptive | Self-adjusting workflow | [docs/adaptive.md](docs/adaptive.md) |
+| `Γ` | Graph | DAG-based execution | [docs/graph.md](docs/graph.md) |
+| `Χ` | Chi | Analyze traces → extract patterns | [docs/chi.md](docs/chi.md) |
+| `Τ` | Tau | Define schema → write → refine → consolidate | [docs/tau.md](docs/tau.md) |
+
+## Per-Phase Model Selection
+
+All patterns support `plannerModel` and `workerModel` for routing high-level reasoning vs execution to different models:
+
+```js
+await Ω({
+  plannerModel: 'deepseek/deepseek-v4-pro',  // planning + synthesis
+  workerModel: 'deepseek/deepseek-v4-flash',  // worker execution
+})`design a notification system`
+```
+
+Without per-phase models, patterns fall back to `model` → Pi default.
+
+## Option Chaining
+
+All patterns support option chaining and `.quiet` mode:
+
+```js
+await Φ({ concurrency: 5 })`review all .ts files`
+await Σ.quiet`analyze security across the codebase`
+await Θ({ agents: 4, turns: 3 })`debate the architecture`
+await Γ({ graph: { nodes: [...], edges: [...] } })`execute workflow`
+```
+
+## Install
+
+```bash
+npm install @topce/pizx
+```
+
+Requires Pi AI configured: `pi auth login`
+
+## CLI
+
+```bash
+pizx script.mjs          # Run a pizx script
+pizx -p "prompt"         # Quick pi-ai query
+pizx --version           # Print version
+```
+
+## Commands
+
+```bash
+npm run build            # Build (JS + DTS)
+npm test                 # 95 unit tests
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * pizx CLI — a zx-compatible script runner with π (pi-ai) and Π (pi-coding-agent)
+ * template tags available globally.
+ *
+ * Usage:
+ *   pizx script.mjs       # Run a pizx script
+ *   pizx -p "prompt"      # Quick pi-ai query (print mode)
+ *   pizx --version        # Print version
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}