@outcomeeng/spx 0.1.0 → 0.1.4

package/README.md

@@ -1,8 +1,6 @@
-# spx
+# @outcomeeng/spx
 
-Fast, deterministic CLI tool for spec workflow management.
-
-> **Note**: This tool will be published to a registry when it reaches a more mature state. For now, install directly from GitHub.
+Developer CLI for code validation and session management.
 
 ## What is spx?
 
@@ -14,24 +12,21 @@ Fast, deterministic CLI tool for spec workflow management.
 - **Session management**: Queue, claim, and hand off work between agents
 - **Multiple formats**: Text, JSON output for CI and automation
 
-## Installation
+All commands are domain-scoped (e.g., `spx validation`, `spx session`) and support `--quiet` and `--json` flags for CI and automation.
 
-### From GitHub (Latest)
+## Installation
 
 ```bash
-# Clone and install
-git clone https://github.com/simonheimlicher/spx-cli.git
-cd spx-cli
-pnpm install
-pnpm run build
-pnpm link --global  # Makes 'spx' available globally
+pnpm add -g @outcomeeng/spx
 ```
 
-### From Registry (Coming Soon)
+### From Source
 
 ```bash
-# Will be available when published
-pnpm add -g spx
+git clone https://github.com/outcomeeng/spx.git
+cd spx
+pnpm install && pnpm run build
+pnpm link --global
 ```
 
 ## Usage
@@ -53,7 +48,7 @@ spx validation knip           # Unused code detection
 spx validation all --scope production
 ```
 
-All commands support `--quiet` for CI and `--json` for machine-readable output.
+All validation commands support `--quiet` for CI and `--json` for machine-readable output.
 
 ### Session Management
 
@@ -98,23 +93,41 @@ See [Session Recipes](docs/how-to/session/common-tasks.md) for detailed usage pa
 
 ## Development
 
+### Setup
+
 ```bash
-# Install dependencies
+git clone https://github.com/outcomeeng/spx.git
+cd spx
 pnpm install
+pnpm run build
+pnpm link --global  # Optional: makes 'spx' available in your shell
+```
 
-# Run tests
-pnpm test
+### Build and Test
 
-# Run validation (required before commits)
-pnpm run validate   # or: spx validation all
+```bash
+pnpm run build          # Build with tsup
+pnpm run dev            # Build in watch mode
+pnpm test               # Run all tests
+pnpm run test:watch     # Run tests in watch mode
+pnpm run test:unit      # Unit tests only
+pnpm run test:e2e       # End-to-end tests only
+pnpm run test:coverage  # Tests with coverage
+```
 
-# Build
-pnpm run build
+### Validation (Required Before Commits)
 
-# Run locally
-node bin/spx.js --help
+```bash
+pnpm run validate       # Full pipeline: circular deps → ESLint → TypeScript
+pnpm run lint           # ESLint only
+pnpm run lint:fix       # ESLint with auto-fix
+pnpm run typecheck      # TypeScript only
+pnpm run circular       # Circular dependency detection
+pnpm run knip           # Unused code detection
 ```
 
+The `pnpm run` scripts use `node bin/spx.js` internally, so they work without a global link. Once linked, you can also use `spx validation all` etc. directly.
+
 ## Technical Stack
 
 - **TypeScript** - Type-safe implementation

package/dist/cli.js

@@ -5,6 +5,7 @@ import {
 
 // src/cli.ts
 import { Command } from "commander";
+import { createRequire as createRequire2 } from "module";
 
 // src/commands/claude/init.ts
 import { execa } from "execa";
@@ -4013,8 +4014,10 @@ var validationDomain = {
 };
 
 // src/cli.ts
+var require3 = createRequire2(import.meta.url);
+var { version } = require3("../package.json");
 var program = new Command();
-program.name("spx").description("Fast, deterministic CLI tool for spec workflow management").version("0.2.0");
+program.name("spx").description("Fast, deterministic CLI tool for spec workflow management").version(version);
 claudeDomain.register(program);
 sessionDomain.register(program);
 specDomain.register(program);