@mcptoolshop/pathway 0.2.0 → 0.2.2

package/README.md

@@ -1,35 +1,50 @@
-# @mikeyfrilot/pathway
-
-npm wrapper for [pathway](https://pypi.org/project/pathway/) - Workflow automation tool.
-
-## Installation
-
-```bash
-npm install -g @mikeyfrilot/pathway
-# or
-npx @mikeyfrilot/pathway --help
-```
-
-## Prerequisites
-
-Requires the Python `pathway` package:
-
-```bash
-pip install pathway
-```
-
-## Usage
-
-```bash
-pathway --help
-pathway run workflow.yml
-```
-
-## Links
-
-- **PyPI**: https://pypi.org/project/pathway/
-- **GitHub**: https://github.com/mcp-tool-shop/pathway
-
-## License
-
-MIT
+# @mcptoolshop/pathway
+
+[![npm](https://img.shields.io/npm/v/@mcptoolshop/pathway)](https://www.npmjs.com/package/@mcptoolshop/pathway)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/mcp-tool-shop-org/pathway/blob/main/LICENSE)
+
+**npm wrapper for [Pathway Core](https://github.com/mcp-tool-shop-org/pathway) — an append-only journey engine where undo never erases learning.**
+
+## Install
+
+```bash
+npm install @mcptoolshop/pathway
+```
+
+This package provides a CLI wrapper that installs and delegates to the Python `pathway-core` package.
+
+## Usage
+
+```bash
+npx @mcptoolshop/pathway init
+npx @mcptoolshop/pathway import sample_session.jsonl
+npx @mcptoolshop/pathway state sess_001
+npx @mcptoolshop/pathway serve
+```
+
+## What is Pathway?
+
+Traditional undo rewrites history. Pathway doesn't.
+
+When you backtrack in Pathway, you create a new event pointing backward — the original path remains. When you learn something on a failed path, that knowledge persists. Your mistakes teach you; they don't disappear.
+
+### Features
+
+- **Append-only event log**: Events are never edited or deleted
+- **Undo = pointer move**: Backtracking creates a new event and moves head
+- **Learning persists**: Knowledge survives across backtracking and branches
+- **Branching is first-class**: Git-like implicit divergence on new work after backtrack
+
+## Requirements
+
+- Node.js >= 18
+- Python 3.10+ (installed automatically via postinstall if needed)
+
+## Links
+
+- [GitHub Repository](https://github.com/mcp-tool-shop-org/pathway)
+- [PyPI Package](https://pypi.org/project/pathway-core/)
+
+## License
+
+MIT

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "@mcptoolshop/pathway",
-  "version": "0.2.0",
-  "description": "npm wrapper for pathway - Workflow automation tool",
-  "bin": {
-    "pathway": "./bin/pathway.js"
-  },
-  "scripts": {
-    "postinstall": "node postinstall.js"
-  },
-  "keywords": [
-    "workflow",
-    "automation",
-    "cli",
-    "python",
-    "wrapper"
-  ],
-  "author": "mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mcp-tool-shop/pathway.git",
-    "directory": "npm"
-  },
-  "homepage": "https://github.com/mcp-tool-shop/pathway#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
-  }
-}
+{
+  "name": "@mcptoolshop/pathway",
+  "version": "0.2.2",
+  "description": "npm wrapper for pathway - Workflow automation tool",
+  "bin": {
+    "pathway": "./bin/pathway.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "keywords": [
+    "workflow",
+    "automation",
+    "cli",
+    "python",
+    "wrapper"
+  ],
+  "author": "mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcp-tool-shop-org/pathway.git",
+    "directory": "npm"
+  },
+  "homepage": "https://github.com/mcp-tool-shop-org/pathway#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/bin/pathway.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-const { spawn } = require('child_process');
-
-async function main() {
-  const args = process.argv.slice(2);
-  const pathway = spawn('pathway', args, {
-    stdio: 'inherit',
-    shell: true
-  });
-
-  pathway.on('close', (code) => {
-    process.exit(code || 0);
-  });
-
-  pathway.on('error', (err) => {
-    console.error('❌ pathway is not installed.');
-    console.error('');
-    console.error('Please install pathway using pip:');
-    console.error('  pip install pathway');
-    console.error('');
-    console.error('PyPI: https://pypi.org/project/pathway/');
-    process.exit(1);
-  });
-}
-
-main();

package/postinstall.js

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-console.log('');
-console.log('📦 @mikeyfrilot/pathway installed!');
-console.log('');
-console.log('⚠️  This is an npm wrapper for the Python package "pathway".');
-console.log('');
-console.log('To use pathway, install the Python package:');
-console.log('  pip install pathway');
-console.log('');
-console.log('PyPI: https://pypi.org/project/pathway/');
-console.log('');