ptywright 0.1.1 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ptywright",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Terminal/TUI automation driver over PTY + xterm, exposed as MCP tools",
   "keywords": [
     "agent",
@@ -22,52 +22,59 @@
     "type": "git",
     "url": "git+https://github.com/kingsword09/ptywright.git"
   },
-  "main": "src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./mcp": "./src/mcp/server.ts",
-    "./session": "./src/session/terminal_session.ts",
-    "./script": "./src/script/runner.ts"
-  },
   "bin": {
-    "ptywright": "bin/ptywright"
+    "ptywright": "dist/bin/ptywright.mjs"
   },
   "files": [
-    "bin",
-    "src",
+    "dist",
     "schemas",
     "skills",
     "README.md",
     "LICENSE"
   ],
   "type": "module",
+  "main": "./dist/cli.mjs",
+  "exports": {
+    ".": "./dist/cli.mjs",
+    "./agent": "./dist/agent.mjs",
+    "./mcp": "./dist/mcp.mjs",
+    "./pty-cassette": "./dist/pty-cassette.mjs",
+    "./session": "./dist/session.mjs",
+    "./script": "./dist/script.mjs"
+  },
   "scripts": {
-    "dev": "bun run src/index.ts",
-    "test": "bun test",
+    "build": "vp pack",
+    "dev": "vp dev",
+    "mcp": "bun run src/index.ts",
+    "agent": "bun run src/cli.ts agent",
+    "agent:check": "bun run src/cli.ts agent check",
+    "check": "vp check && bun run build && bun run test && bun run agent:check",
+    "test": "bun run scripts/test_all.ts",
     "test:mcp-all-tools": "bun test tests/mcp_all_tools_smoke.test.ts",
-    "lint": "oxlint --type-aware --type-check .",
-    "format": "oxfmt src tests '!tests/fixtures/**'",
-    "format:check": "oxfmt --check src tests '!tests/fixtures/**'",
+    "lint": "vp lint",
+    "format": "vp fmt",
+    "format:check": "vp fmt --check",
     "trace:report": "bun run src/trace/report.ts",
     "trace:cast-to-txt": "bun run src/trace/cast_to_txt.ts",
     "script:run": "bun run src/script/run.ts",
     "script:run-all": "bun run src/script/run_all.ts",
     "script:m5-mask-demo": "bun run src/script/run.ts scripts/m5_mask_demo.json",
-    "prepublishOnly": "bun run format:check && bun run lint && bun test"
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@xterm/headless": "^6.0.0",
     "asciinema-player": "3.9.0",
     "bun-pty": "^0.4.7",
+    "playwright": "^1.60.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "bun-types": "^1.3.6",
-    "oxfmt": "^0.24.0",
-    "oxlint": "^1.39.0",
-    "oxlint-tsgolint": "^0.11.1",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "vite": "^8.0.14",
+    "vite-plus": "^0.1.22",
+    "vitest": "^4.1.7"
   },
   "engines": {
     "bun": ">=1.3.6"

package/schemas/ptywright-agent-cassette.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ptywright.local/schemas/ptywright-agent-cassette.schema.json",
+  "title": "ptywright agent cassette",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "name", "createdAt", "spec", "frames"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "const": 1 },
+    "name": { "type": "string", "minLength": 1 },
+    "createdAt": { "type": "string", "minLength": 1 },
+    "spec": { "$ref": "./ptywright-agent.schema.json" },
+    "frames": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "viewport",
+          "phase",
+          "stepIndex",
+          "stepType",
+          "terminalText",
+          "terminalHash",
+          "dom",
+          "domHash",
+          "capturedAt"
+        ],
+        "properties": {
+          "viewport": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "width", "height"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "width": { "type": "integer", "minimum": 1 },
+              "height": { "type": "integer", "minimum": 1 },
+              "deviceScaleFactor": { "type": "number", "exclusiveMinimum": 0 },
+              "isMobile": { "type": "boolean" },
+              "hasTouch": { "type": "boolean" }
+            }
+          },
+          "phase": { "type": "integer", "minimum": 0 },
+          "stepIndex": { "type": ["integer", "null"], "minimum": 0 },
+          "stepType": { "type": "string", "minLength": 1 },
+          "terminalText": { "type": "string" },
+          "terminalHash": { "type": "string", "minLength": 1 },
+          "dom": { "type": "string" },
+          "domHash": { "type": "string", "minLength": 1 },
+          "capturedAt": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/ptywright-agent-check.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ptywright.local/schemas/ptywright-agent-check.schema.json",
+  "title": "ptywright agent check summary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "ok",
+    "cassetteDir",
+    "artifactsRoot",
+    "summaryPath",
+    "commands",
+    "inputs",
+    "replay",
+    "outputs",
+    "failures"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "const": 1 },
+    "ok": { "type": "boolean" },
+    "cassetteDir": { "type": "string", "minLength": 1 },
+    "artifactsRoot": { "type": "string", "minLength": 1 },
+    "summaryPath": { "type": "string", "minLength": 1 },
+    "commands": { "$ref": "#/$defs/commands" },
+    "inputs": { "$ref": "#/$defs/counts" },
+    "replay": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "totalCount", "failureCount", "reportPath", "summaryPath"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "totalCount": { "type": "integer", "minimum": 0 },
+        "failureCount": { "type": "integer", "minimum": 0 },
+        "reportPath": { "type": "string" },
+        "summaryPath": { "type": "string" }
+      }
+    },
+    "outputs": { "$ref": "#/$defs/counts" },
+    "failures": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/failure" }
+    }
+  },
+  "$defs": {
+    "checkCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/checkArgv" }
+      }
+    },
+    "checkUpdateCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": {
+          "allOf": [
+            { "$ref": "#/$defs/checkArgv" },
+            { "contains": { "const": "--update-snapshots" } }
+          ]
+        }
+      }
+    },
+    "rerunCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/rerunArgv" }
+      }
+    },
+    "checkArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "check" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "rerunArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "rerun" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["check", "updateSnapshots", "rerun"],
+      "properties": {
+        "check": { "$ref": "#/$defs/checkCommand" },
+        "updateSnapshots": { "$ref": "#/$defs/checkUpdateCommand" },
+        "rerun": { "$ref": "#/$defs/rerunCommand" }
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["totalCount", "failureCount"],
+      "properties": {
+        "totalCount": { "type": "integer", "minimum": 0 },
+        "failureCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "filePath", "errors"],
+      "properties": {
+        "stage": { "type": "string", "enum": ["input", "replay", "output"] },
+        "filePath": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string" },
+        "errors": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/ptywright-agent-manifest.schema.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ptywright.local/schemas/ptywright-agent-manifest.schema.json",
+  "title": "ptywright agent artifact manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "kind",
+    "ok",
+    "generatedAt",
+    "rootDir",
+    "primaryPath",
+    "commands",
+    "files"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "const": 1 },
+    "kind": { "type": "string", "enum": ["run", "replay-suite", "check", "promote"] },
+    "ok": { "type": "boolean" },
+    "generatedAt": { "type": "string", "minLength": 1 },
+    "rootDir": { "type": "string", "minLength": 1 },
+    "primaryPath": { "type": "string", "minLength": 1 },
+    "commands": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/command" },
+      "minProperties": 1
+    },
+    "validation": { "$ref": "#/$defs/validation" },
+    "files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/file" }
+    }
+  },
+  "$defs": {
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/agentArgv" }
+      }
+    },
+    "agentArgv": {
+      "type": "array",
+      "minItems": 3,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "validation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "stages"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "stages": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/validationStage" }
+        }
+      }
+    },
+    "validationStage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "ok", "totalCount", "failureCount"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "ok": { "type": "boolean" },
+        "totalCount": { "type": "integer", "minimum": 0 },
+        "failureCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "kind", "bytes", "sha256"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Path to the artifact file, relative to the manifest directory when the file is inside the artifact root."
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "flow",
+            "cassette",
+            "run-record",
+            "replay-summary",
+            "check-summary",
+            "promote-summary",
+            "report",
+            "terminal",
+            "dom",
+            "screenshot",
+            "diff"
+          ]
+        },
+        "role": { "type": "string", "minLength": 1 },
+        "ok": { "type": "boolean" },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    }
+  }
+}

package/schemas/ptywright-agent-promote.schema.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ptywright.local/schemas/ptywright-agent-promote.schema.json",
+  "title": "ptywright agent promote summary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "ok",
+    "sourcePath",
+    "cassetteDir",
+    "targetDir",
+    "targetCassettePath",
+    "snapshotDir",
+    "artifactsRoot",
+    "summaryPath",
+    "updateSnapshots",
+    "commands",
+    "validation",
+    "replay",
+    "failures"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "const": 1 },
+    "ok": { "type": "boolean" },
+    "sourcePath": { "type": "string", "minLength": 1 },
+    "cassetteDir": { "type": "string", "minLength": 1 },
+    "targetDir": { "type": "string", "minLength": 1 },
+    "targetCassettePath": { "type": "string", "minLength": 1 },
+    "snapshotDir": { "type": "string", "minLength": 1 },
+    "artifactsRoot": { "type": "string", "minLength": 1 },
+    "summaryPath": { "type": "string", "minLength": 1 },
+    "updateSnapshots": { "type": "boolean" },
+    "commands": { "$ref": "#/$defs/commands" },
+    "validation": { "$ref": "#/$defs/countsWithOk" },
+    "replay": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "totalCount", "failureCount", "reportPath", "summaryPath"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "totalCount": { "type": "integer", "minimum": 0 },
+        "failureCount": { "type": "integer", "minimum": 0 },
+        "reportPath": { "type": "string" },
+        "summaryPath": { "type": "string" }
+      }
+    },
+    "failures": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/failure" }
+    }
+  },
+  "$defs": {
+    "promoteCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/promoteArgv" }
+      }
+    },
+    "checkCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/checkArgv" }
+      }
+    },
+    "checkUpdateCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": {
+          "allOf": [
+            { "$ref": "#/$defs/checkArgv" },
+            { "contains": { "const": "--update-snapshots" } }
+          ]
+        }
+      }
+    },
+    "rerunCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/rerunArgv" }
+      }
+    },
+    "promoteArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "promote" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "checkArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "check" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "rerunArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "rerun" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["promote", "check", "updateSnapshots", "rerun"],
+      "properties": {
+        "promote": { "$ref": "#/$defs/promoteCommand" },
+        "check": { "$ref": "#/$defs/checkCommand" },
+        "updateSnapshots": { "$ref": "#/$defs/checkUpdateCommand" },
+        "rerun": { "$ref": "#/$defs/rerunCommand" }
+      }
+    },
+    "countsWithOk": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "totalCount", "failureCount"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "totalCount": { "type": "integer", "minimum": 0 },
+        "failureCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "filePath", "errors"],
+      "properties": {
+        "stage": { "type": "string", "enum": ["validation", "replay"] },
+        "filePath": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string" },
+        "errors": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/ptywright-agent-replay-summary.schema.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ptywright.local/schemas/ptywright-agent-replay-summary.schema.json",
+  "title": "ptywright agent replay summary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "ok",
+    "dir",
+    "suiteDir",
+    "durationMs",
+    "reportPath",
+    "summaryPath",
+    "commands",
+    "updateSnapshots",
+    "totalCount",
+    "failureCount",
+    "entries"
+  ],
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "const": 1 },
+    "ok": { "type": "boolean" },
+    "dir": { "type": "string", "minLength": 1 },
+    "suiteDir": { "type": "string", "minLength": 1 },
+    "durationMs": { "type": "integer", "minimum": 0 },
+    "reportPath": { "type": "string", "minLength": 1 },
+    "summaryPath": { "type": "string", "minLength": 1 },
+    "commands": { "$ref": "#/$defs/commands" },
+    "updateSnapshots": { "type": "boolean" },
+    "totalCount": { "type": "integer", "minimum": 0 },
+    "failureCount": { "type": "integer", "minimum": 0 },
+    "entries": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/entry" }
+    }
+  },
+  "$defs": {
+    "replayAllCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/replayAllArgv" }
+      }
+    },
+    "replayAllUpdateCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": {
+          "allOf": [
+            { "$ref": "#/$defs/replayAllArgv" },
+            { "contains": { "const": "--update-snapshots" } }
+          ]
+        }
+      }
+    },
+    "rerunCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["argv"],
+      "properties": {
+        "argv": { "$ref": "#/$defs/rerunArgv" }
+      }
+    },
+    "replayAllArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "replay-all" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "rerunArgv": {
+      "type": "array",
+      "minItems": 4,
+      "prefixItems": [{ "const": "ptywright" }, { "const": "agent" }, { "const": "rerun" }],
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["replayAll", "updateSnapshots", "rerun"],
+      "properties": {
+        "replayAll": { "$ref": "#/$defs/replayAllCommand" },
+        "updateSnapshots": { "$ref": "#/$defs/replayAllUpdateCommand" },
+        "rerun": { "$ref": "#/$defs/rerunCommand" }
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "filePath",
+        "durationMs",
+        "ok",
+        "mode",
+        "frames",
+        "reportPath",
+        "recordPath",
+        "cassettePath",
+        "failedArtifacts",
+        "errors"
+      ],
+      "properties": {
+        "filePath": { "type": "string", "minLength": 1 },
+        "durationMs": { "type": "integer", "minimum": 0 },
+        "ok": { "type": "boolean" },
+        "mode": { "type": "string", "enum": ["live", "replay"] },
+        "frames": { "type": "integer", "minimum": 0 },
+        "reportPath": { "type": "string", "minLength": 1 },
+        "recordPath": { "type": "string", "minLength": 1 },
+        "cassettePath": { "type": "string", "minLength": 1 },
+        "failedArtifacts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/failedArtifact" }
+        },
+        "errors": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "failedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "viewport", "kind", "path"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "viewport": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string", "enum": ["terminal", "dom", "screenshot"] },
+        "path": { "type": "string", "minLength": 1 },
+        "baselinePath": { "type": "string", "minLength": 1 },
+        "diffPath": { "type": "string", "minLength": 1 },
+        "error": { "type": "string" }
+      }
+    }
+  }
+}