infynon 0.2.0 → 0.2.2

package/README.md

@@ -1,5 +1,164 @@
 # infynon
 
-This package installs the matching INFYNON CLI binary for the current platform.
+INFYNON is a security-first CLI for package intelligence, API flow testing, repository memory, and bounded AI task execution.
 
-The Rust source code is not bundled in this package.
+This npm package is the official installer wrapper for the INFYNON native binary. It does not contain the Rust source code. During installation, it downloads the matching prebuilt binary from the official GitHub Releases page.
+
+## Why Install INFYNON
+
+INFYNON is built for teams that need one terminal tool for four connected workflows:
+
+| Workflow | Command Area | Purpose |
+|---|---|---|
+| Package intelligence | `infynon pkg` | Scan dependencies, inspect risk, audit package changes, and support safer install workflows. |
+| API flow testing | `infynon weave` | Run multi-step API flows with context passed between requests. |
+| Repository memory | `infynon trace` | Preserve structured handoff notes, branch context, package ownership, and repo memory. |
+| Agent task contracts | `infynon task` | Turn vague AI work requests into GCCD task briefs with a goal, context, constraints, and completion criteria. |
+
+## Install
+
+```bash
+npm install -g infynon
+```
+
+The installer downloads the binary for the current platform and makes `infynon` available through npm's global binary directory.
+
+## Supported Platforms
+
+- Windows x64
+- Linux x64
+- Linux arm64
+- macOS x64
+- macOS arm64
+
+Unsupported platforms can still install the npm wrapper, but the wrapper will not be able to download a native binary until a matching release asset exists.
+
+## Quick Start
+
+```bash
+infynon --help
+infynon pkg scan
+infynon pkg audit
+infynon weave flow run checkout
+infynon trace tui
+infynon task create task_001 --mutate --workspace . --prompt "Ship the settings API patch"
+```
+
+## Package Intelligence
+
+Use `infynon pkg` to inspect dependency risk and package state.
+
+```bash
+infynon pkg scan
+infynon pkg audit
+infynon pkg explain serde_json
+```
+
+Good fit:
+
+- reviewing dependency changes
+- scanning a project before merging
+- understanding why a package exists
+- adding package security checks to local workflows
+
+## API Flow Testing
+
+Use `infynon weave` when API behavior depends on multiple connected requests.
+
+```bash
+infynon weave env set BASE_URL http://localhost:8001
+infynon weave flow run checkout
+```
+
+Good fit:
+
+- login-then-action API workflows
+- stateful API validation
+- terminal-first flow execution
+- CI-friendly API checks
+
+## Repository Memory
+
+Use `infynon trace` to preserve context that usually disappears into chat, PR comments, or local notes.
+
+```bash
+infynon trace init
+infynon trace note add repo-handoff --title "Auth changed" --body "Refresh moved into middleware"
+infynon trace tui
+```
+
+Good fit:
+
+- branch handoffs
+- package ownership context
+- team notes
+- AI-assisted coding sessions that need durable memory
+
+## Agent Task Contracts
+
+Use `infynon task` when AI work needs a contract instead of a loose prompt. INFYNON uses GCCD:
+
+- Goal: the outcome the task must produce
+- Context: the project, files, APIs, or decisions the agent needs to know
+- Constraints: boundaries the agent must respect
+- Done When: the checks that prove the task is complete
+
+```bash
+infynon task create task_001 \
+  --mutate \
+  --workspace ./apps/web \
+  --agent codex \
+  --prompt "Build the settings page using existing UI components. Do not modify auth logic. Typecheck must pass."
+```
+
+Good fit:
+
+- parent and child agent work
+- scoped implementation tasks
+- reviewable handoffs
+- retries where completion criteria must stay intact
+
+## Alternative Install Methods
+
+GitHub Releases:
+
+```text
+https://github.com/d4rkNinja/infynon-cli/releases
+```
+
+macOS and Linux:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/d4rkNinja/infynon-cli/main/install.sh | bash
+```
+
+Windows:
+
+```powershell
+iwr https://raw.githubusercontent.com/d4rkNinja/infynon-cli/main/install.ps1 -useb | iex
+```
+
+Go wrapper:
+
+```bash
+go install github.com/d4rkNinja/infynon-cli/go/cmd/infynon@latest
+```
+
+## Verification
+
+GitHub Releases include `checksums.txt` for SHA-256 verification.
+
+```text
+https://github.com/d4rkNinja/infynon-cli/releases
+```
+
+## Documentation
+
+- Public docs: https://github.com/d4rkNinja/infynon-cli/tree/main/docs
+- GCCD task contracts: https://github.com/d4rkNinja/infynon-cli/blob/main/docs/gccd.md
+- Releases: https://github.com/d4rkNinja/infynon-cli/releases
+- Issues: https://github.com/d4rkNinja/infynon-cli/issues
+
+## Source Availability
+
+This npm package distributes the INFYNON binary and installer wrapper only. The Rust source code is proprietary and is not bundled in this package.

package/package.json

@@ -1,36 +1,35 @@
 {
-  "name": "infynon",
-  "version": "0.2.0",
-  "description": "Thin npm installer for the proprietary INFYNON CLI binary releases.",
-  "bin": {
-    "infynon": "run.js",
-    "infynon-pkg": "run.js"
-  },
-  "scripts": {
-    "postinstall": "node postinstall.js",
-    "preuninstall": "node preuninstall.js"
-  },
-  "files": [
-    "LICENSE",
-    "run.js",
-    "postinstall.js",
-    "preuninstall.js"
-  ],
-  "engines": {
-    "node": ">=14.14"
-  },
-  "author": "d4rkNinja",
-  "license": "SEE LICENSE IN LICENSE",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/d4rkNinja/infynon-cli.git"
-  },
-  "bugs": {
-    "url": "https://github.com/d4rkNinja/infynon-cli/issues"
-  },
-  "homepage": "https://github.com/d4rkNinja/infynon-cli#readme",
-  "publishConfig": {
-    "access": "public"
-  }
+    "name":  "infynon",
+    "version":  "0.2.2",
+    "description":  "Thin npm installer for the proprietary INFYNON CLI binary releases.",
+    "bin":  {
+                "infynon":  "run.js",
+                "infynon-pkg":  "run.js"
+            },
+    "scripts":  {
+                    "postinstall":  "node postinstall.js",
+                    "preuninstall":  "node preuninstall.js"
+                },
+    "files":  [
+                  "LICENSE",
+                  "run.js",
+                  "postinstall.js",
+                  "preuninstall.js"
+              ],
+    "engines":  {
+                    "node":  "\u003e=14.14"
+                },
+    "author":  "d4rkNinja",
+    "license":  "SEE LICENSE IN LICENSE",
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/d4rkNinja/infynon-cli.git"
+                   },
+    "bugs":  {
+                 "url":  "https://github.com/d4rkNinja/infynon-cli/issues"
+             },
+    "homepage":  "https://github.com/d4rkNinja/infynon-cli#readme",
+    "publishConfig":  {
+                          "access":  "public"
+                      }
 }
-