packwright 0.1.0__py3-none-any.whl

packwright/core/workspace_contract.py

@@ -0,0 +1,102 @@
+WORKSPACE_ROOT = "workspace"
+WORKSPACE_LAYOUT = "domain_first_lifecycle_second"
+WORKSPACE_DOMAIN_TEMPLATE_DIR = "workspace/_template"
+WORKSPACE_SHARED_DIR = "workspace/shared"
+WORKSPACE_INDEX_OWNER = "memory/source-map.md"
+WORKSPACE_LIFECYCLE_DIRS = ("drafts", "artifacts", "archive")
+WORKSPACE_SHARED_ARTIFACT_DIRS = (
+    "workspace/shared/artifacts/handoffs",
+    "workspace/shared/artifacts/session-briefs",
+)
+
+
+def workspace_skeleton_paths():
+    return tuple(
+        f"{WORKSPACE_DOMAIN_TEMPLATE_DIR}/{name}/.gitkeep"
+        for name in WORKSPACE_LIFECYCLE_DIRS
+    ) + (f"{WORKSPACE_SHARED_DIR}/.gitkeep",) + tuple(
+        f"{path}/.gitkeep" for path in WORKSPACE_SHARED_ARTIFACT_DIRS
+    )
+
+
+def workspace_required_dirs():
+    return (
+        WORKSPACE_ROOT,
+        WORKSPACE_DOMAIN_TEMPLATE_DIR,
+        *(f"{WORKSPACE_DOMAIN_TEMPLATE_DIR}/{name}" for name in WORKSPACE_LIFECYCLE_DIRS),
+        WORKSPACE_SHARED_DIR,
+        "workspace/shared/artifacts",
+        *WORKSPACE_SHARED_ARTIFACT_DIRS,
+    )
+
+
+def workspace_artifacts():
+    return ("workspace/README.md", *workspace_skeleton_paths())
+
+
+def workspace_files(readme):
+    files = {"workspace/README.md": readme}
+    files.update({path: "" for path in workspace_skeleton_paths()})
+    return files
+
+
+def workspace_readme():
+    return (
+        "# Workspace\n\n"
+        "Use this directory for generated work products, not durable memory.\n\n"
+        "## Directories\n\n"
+        "- `workspace/<domain>/drafts/`: temporary drafts, explorations, and working versions.\n"
+        "- `workspace/<domain>/artifacts/`: final or reusable deliverables.\n"
+        "- `workspace/<domain>/archive/`: old outputs kept for reference.\n"
+        "- `workspace/shared/`: cross-domain outputs only.\n"
+        "- `workspace/shared/artifacts/handoffs/`: real cross-agent or cross-runtime handoff files.\n"
+        "- `workspace/shared/artifacts/session-briefs/`: same-agent next-session preparation files.\n"
+        "- `workspace/_template/`: copy when a new workstream needs workspace storage.\n\n"
+        "## Rules\n\n"
+        "- Keep memory files focused on state, decisions, and pointers.\n"
+        "- Index important workspace outputs in `memory/source-map.md`.\n"
+        "- Move durable project state into `memory/projects/<slug>.md`, not workspace files.\n"
+    )
+
+
+def workspace_feature():
+    return {
+        "root": WORKSPACE_ROOT,
+        "layout": WORKSPACE_LAYOUT,
+        "domain_template": WORKSPACE_DOMAIN_TEMPLATE_DIR,
+        "shared": WORKSPACE_SHARED_DIR,
+        "shared_artifact_dirs": list(WORKSPACE_SHARED_ARTIFACT_DIRS),
+        "lifecycle_dirs": list(WORKSPACE_LIFECYCLE_DIRS),
+        "index_owner": WORKSPACE_INDEX_OWNER,
+    }
+
+
+def workspace_spec():
+    return {
+        "root": WORKSPACE_ROOT,
+        "layout": WORKSPACE_LAYOUT,
+        "domain_template_dir": WORKSPACE_DOMAIN_TEMPLATE_DIR,
+        "shared_dir": WORKSPACE_SHARED_DIR,
+        "lifecycle_dirs": list(WORKSPACE_LIFECYCLE_DIRS),
+        "index_owner": WORKSPACE_INDEX_OWNER,
+        "rules": [
+            "Use workspace/<domain>/drafts for temporary generated work.",
+            "Use workspace/<domain>/artifacts for durable deliverables the user may reuse.",
+            "Use workspace/<domain>/archive for old deliverables kept for reference.",
+            "Use workspace/shared only for cross-domain outputs.",
+            "Use workspace/shared/artifacts/handoffs for real cross-agent or cross-runtime handoff files.",
+            "Use workspace/shared/artifacts/session-briefs for same-agent next-session preparation files.",
+            "Index important workspace outputs in memory/source-map.md instead of copying content into memory files.",
+        ],
+    }
+
+
+def workspace_readme_required_markers():
+    return (
+        WORKSPACE_INDEX_OWNER,
+        "workspace/<domain>/drafts/",
+        "workspace/<domain>/artifacts/",
+        "workspace/shared/",
+        "workspace/shared/artifacts/handoffs/",
+        "workspace/shared/artifacts/session-briefs/",
+    )

packwright-0.1.0.dist-info/METADATA

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: packwright
+Version: 0.1.0
+Summary: Build, install, and migrate portable agent packs across Codex, Claude Code, and Cursor.
+Author: pioneerjeff-labs
+License-Expression: MIT
+Project-URL: Homepage, https://pioneerjeff-labs.github.io/packwright/
+Project-URL: Documentation, https://github.com/pioneerjeff-labs/packwright#readme
+Project-URL: Issues, https://github.com/pioneerjeff-labs/packwright/issues
+Project-URL: Changelog, https://github.com/pioneerjeff-labs/packwright/blob/main/CHANGELOG.md
+Keywords: agents,codex,claude-code,cursor,migration
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: test
+Requires-Dist: build>=1.2; extra == "test"
+Requires-Dist: twine>=5.1; extra == "test"
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/mark-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="assets/mark-light.svg">
+    <img alt="Packwright dovetail mark" src="assets/mark-light.svg" width="88" height="88">
+  </picture>
+</p>
+
+<h1 align="center">Packwright</h1>
+
+<p align="center"><strong>Build your agent once. Carry it everywhere.</strong></p>
+
+<p align="center">
+  Compile one agent definition—rules, memory, skills, and workspace—into native packs<br>
+  for Codex, Claude Code, and Cursor. Build, install, migrate, and verify with plain files.
+</p>
+
+<p align="center">
+  <strong><a href="https://pioneerjeff-labs.github.io/packwright/">Explore the live product website →</a></strong><br>
+  Watch the animated CLI, follow a Claude Code → Codex migration, and switch the Quickstart between Claude Code, Codex, and Cursor.<br>
+  <a href="https://pioneerjeff-labs.github.io/packwright/">English</a> · <a href="https://pioneerjeff-labs.github.io/packwright/zh-CN.html">简体中文</a>
+</p>
+
+<p align="center">
+  <a href="https://pioneerjeff-labs.github.io/packwright/">
+    <img alt="Open the Packwright live product website" src="assets/social-preview.png" width="800">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://pioneerjeff-labs.github.io/packwright/"><img alt="Packwright website" src="https://img.shields.io/badge/website-live-9C4F16?style=flat-square"></a>
+  <a href="https://github.com/pioneerjeff-labs/packwright/actions/workflows/ci.yml"><img alt="CI status" src="https://github.com/pioneerjeff-labs/packwright/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-5C5245?style=flat-square"></a>
+  <a href="README.zh-CN.md"><img alt="中文 README" src="https://img.shields.io/badge/README-中文-B87333?style=flat-square"></a>
+</p>
+
+<p align="center"><strong>Native packs. Portable state. Preview every migration before any files are written.</strong></p>
+
+> [!NOTE]
+> Packwright itself makes no network requests and sends no telemetry. Your coding runtime may still send files it reads to its own model provider; its data policy continues to apply.
+
+## Start with your coding agent
+
+The shortest interface is a conversation. Install Packwright, then paste the operating prompt into Codex, Claude Code, or Cursor:
+
+```bash
+python -m pip install packwright==0.1.0
+```
+
+**[Open the paste-ready agent prompt →](docs/USE_WITH_YOUR_AGENT.md)**
+
+For a new agent, describe what it should do and choose its name. The prompt makes your coding agent draft a canonical intake, confirm it with you, build the pack, and verify the installed target. For migration, it previews the receipt and waits for approval before writing.
+
+## Create your own
+
+Generate Packwright's interviewer contract, then let your coding agent turn the conversation into a confirmed `character_intake.yaml`:
+
+```bash
+packwright draft-character \
+  --user-name Morgan \
+  --prompt-out work/character-interviewer.md
+```
+
+After the agent saves the confirmed intake, create editable source and build it:
+
+```bash
+packwright init work/nova-intake.yaml -o work/nova
+packwright build work/nova --adapter claude-code -o pack/nova-claude
+packwright install pack/nova-claude --adapter claude-code --target project/nova-claude
+```
+
+Already have an agent or workspace? Inventory it before importing anything:
+
+```bash
+packwright adopt --from existing-agent --dry-run
+```
+
+## Or use a nameless starter
+
+Three presets cover common starting points. Customize responsibilities, capabilities, voice, boundaries, and emotional feedback; the preset shapes how the agent works, while you always choose its name.
+
+| Preset | Starting role |
+|---|---|
+| `code` | Expert engineer — builds, reviews, debugs, tests, and ships technical work |
+| `work` | Versatile assistant — plans projects, drafts deliverables, clarifies decisions, and keeps execution moving |
+| `companion` | Personal secretary — supports daily routines, life decisions, travel planning, and emotional support |
+
+Choose a preset, answer a few simple questions, and supply the character name yourself.
+
+```bash
+packwright init --template code --name Nova --user-name Morgan -o work/nova
+packwright build work/nova --adapter claude-code -o pack/nova-claude
+packwright install pack/nova-claude --adapter claude-code --target project/nova-claude
+```
+
+`Nova` is only an example of a user-chosen name. Edit the generated name, relationship, voice, and boundaries whenever you need.
+
+Preview a move from Claude Code to Codex. The destination is not created during this step:
+
+```bash
+packwright migrate project/nova-claude \
+  --to codex \
+  --target project/nova-codex --dry-run
+```
+
+The plan names four kinds of paths:
+
+| Receipt section | Meaning |
+|---|---|
+| `generated` | Files compiled for the destination runtime |
+| `carried` | Portable user files copied and SHA-256 verified |
+| `rewritten` | Packwright-managed routing lines changed for the destination |
+| `excluded` | Runtime-specific files deliberately left behind |
+
+After reviewing the receipt, apply that exact move and verify the result:
+
+```bash
+packwright migrate project/nova-claude \
+  --to codex \
+  --target project/nova-codex --yes
+packwright doctor project/nova-codex
+packwright score project/nova-codex
+```
+
+Add `--json` to the dry run and confirmed run for a machine-readable `packwright-migration/v1` receipt. Packwright refuses to overwrite an existing target unless you separately opt into `--force`.
+
+## Why not just prompts?
+
+A working coding agent is more than its top-level instructions, and each runtime expects a different native layout:
+
+| Runtime | Native entry | Reusable procedures |
+|---|---|---|
+| Codex | `AGENTS.md` | `.agents/skills/<name>/SKILL.md` |
+| Claude Code | `CLAUDE.md` | `.claude/skills/<name>/SKILL.md` |
+| Cursor | `.cursor/rules/<name>.mdc` | `.cursor/rules/<name>-save-context.mdc` |
+
+Packwright treats those files as compiled projections. Your editable source owns the behavior; adapters own the runtime layout; migration carries portable state and reports the seams instead of hiding them.
+
+## Build once, carry everywhere
+
+```text
+editable source
+  identity · memory contract · skills · workspace rules
+         │
+         ├── packwright build --adapter codex       → AGENTS.md + .agents/skills/
+         ├── packwright build --adapter claude-code → CLAUDE.md + .claude/skills/
+         └── packwright build --adapter cursor      → .cursor/rules/*.mdc
+```
+
+Every pack and installed target includes self-contained `.packwright/` metadata: the canonical source snapshot, artifact lock, and checker receipt. You can relocate a target and still run `migrate`, `doctor`, and `score` without its original build directory.
+
+## Move a working agent
+
+`migrate` recompiles runtime-native files and carries portable state into the destination. It reports what cannot carry before it writes, then waits for an explicit `--yes`. The receipt is the proof behind “carry it everywhere,” not a promise that unlike runtimes have no seams.
+
+## What the checks prove
+
+- `score` evaluates the public pack structure and artifact contract. `100.0` is a structural pass, not a promise that a runtime will behave perfectly.
+- `doctor` verifies Packwright-managed projection hashes and can repair reproducible drift without treating portable user state as generated output.
+- Migration verifies carried and rewritten files by hash and records planned and installed scores.
+- Packwright ships six directed migration paths across the three current adapters. New adapters land when they pass the checker.
+
+## Current release boundary
+
+`0.1.0` is Packwright's first stable release. The supported destination adapters are Codex, Claude Code, and Cursor. Packwright is local tooling, not cloud sync, and its plain-file structure score is separate from real runtime compatibility.
+
+## Documentation
+
+- [Live product website](https://pioneerjeff-labs.github.io/packwright/) · [简体中文](https://pioneerjeff-labs.github.io/packwright/zh-CN.html)
+- [CLI contract](docs/CLI.md)
+- [Use Packwright with your coding agent](docs/USE_WITH_YOUR_AGENT.md)
+- [Character drafting](docs/CHARACTER_DRAFTING.md)
+- [Agent archetypes](docs/AGENT_ARCHETYPES.md)
+- [Optional Emotion Engine sidecar](docs/EMOTION_ENGINE.md)
+- [0.1.0 release notes](docs/releases/0.1.0.md)
+- [Contributing](CONTRIBUTING.md)
+- [Security](SECURITY.md)
+
+Packwright is open source under the [MIT License](LICENSE).

packwright-0.1.0.dist-info/RECORD

@@ -0,0 +1,33 @@
+packwright/__init__.py,sha256=sQUsvrd5EshcTEs5nYJ5zz4FZN6FIsV-1G7CEjvYfV4,61
+packwright/__main__.py,sha256=PSQ4rpL0dG6f-qH4N7H-gD9igQkdHzH4yVZDcW8lfZo,80
+packwright/cli.py,sha256=l8R-xlPvCvTi3IZU-2WiaDvX4gmm1CukSeWu8P2deW8,36962
+packwright/adapters/__init__.py,sha256=n5-TZrT3iDcljNUPtpd2lc_1Y_g27P9992ip83uAeck,300
+packwright/adapters/claude_code.py,sha256=8J7b-t9vZCtYxG-EabXp2O0ckTI--i-cqCc1sWmPw1s,16822
+packwright/adapters/codex.py,sha256=mQ-o5IYRiiU9nc8kcYg_zw5LV9-_E-2R7c54HApdNRk,15318
+packwright/adapters/cursor.py,sha256=fswpYPSIUcOKKPhK6Dsai3ZWp1FgDPHHXt8WCAYX-Ko,18790
+packwright/checker/__init__.py,sha256=bjczkvMuzmHuG2Ig_vWLQgGY0QJ4cRfNPLQfXeDOtuU,68
+packwright/checker/scoring.py,sha256=I0vQb63Dm3FlBN-BTZRSB5FJ9S8n2WrULFjj0_-k-E8,34803
+packwright/core/__init__.py,sha256=U2-Vp6xOG4QdjKdu0lAWgX8IGEwGRR39j0KZ6nIVy-0,1662
+packwright/core/adapter_layout.py,sha256=azR1b-IazUR6Ruu-iMdtKbc83zLRGTIg0AK11nHKQSA,921
+packwright/core/adopt.py,sha256=TFDYFCguR8jwm7GU6ZD_pT7609KJRMfd9sKKHKoKYOI,6925
+packwright/core/character_intake.py,sha256=POfFMutsgRiR_zm8O1cOLRv0KpBV-0wI_il6nxLyJB0,74597
+packwright/core/emotion_engine_contract.py,sha256=qrX2GHPSixvg8E3zgO1iWGRkSbq6Yq8NPGh007qSwxc,6527
+packwright/core/errors.py,sha256=H4tPDEUD8e5kkOIixh1ILw9Bzlere6tz0VJ3TfX0Fxs,464
+packwright/core/handoff.py,sha256=T1JrEamEDDonFxvu5d9oNRy7qVUhk7VcRbxb2wqkCVo,18707
+packwright/core/install.py,sha256=XLSSw0k24PYj8UwKsSSmm52zCgMJqdKLkLGZb6jQSjg,85394
+packwright/core/intake_contract.py,sha256=MV5rkZN6042daN4TLYdvgpJF41bVAZNQ10PJ9IRqo7Y,5294
+packwright/core/knowledge_contract.py,sha256=V6m_oUpCNuRhvcR5md2jOLjnURHP41w8P7QMFiyKyYs,8020
+packwright/core/loader.py,sha256=vr7VrXjiGWRkvHjztXwRDOyEOcM0zjOqH0w49omX-EU,1045
+packwright/core/memory_projection.py,sha256=pzNUaXGKBl53mv1CD-_rLdRCngMS5lD7L8Ukz9VbabQ,4868
+packwright/core/naming.py,sha256=Lq0cH2RB65KR-pJnFD5VPt0qApxX0y0kFP4jg56-t78,3232
+packwright/core/pack_metadata.py,sha256=zCBD8PkusaB2yuoamINHC3RWRMKkBjxAcdAr9-HYzb4,3780
+packwright/core/path_safety.py,sha256=QtSnSaxAmgxyaaNDE59hW0nbf-dpaThiBZtVMqM2G3k,3170
+packwright/core/resolver.py,sha256=-_BsW_gM3LfvI-_Vil57GZmqYYyttlNMJ3H2AGIZVNg,2149
+packwright/core/validation.py,sha256=RK9SP7kjo3MOuonKHwmuCPl_zL1jd2KvD_evGFE-Ma0,26336
+packwright/core/workspace_contract.py,sha256=GrZDcqTiu9Qvz4h5HwFuPJWAQxIyYJBPtzHwvWs0cWk,4031
+packwright-0.1.0.dist-info/licenses/LICENSE,sha256=hN8ArnqkeuXOndFwP5yGel9pVtPtDQrMvyqSd48oNEQ,1073
+packwright-0.1.0.dist-info/METADATA,sha256=16iEN3hIs3H2VOLnJEnJmHqRBb-9oQqqNlWBTlghg6A,10032
+packwright-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+packwright-0.1.0.dist-info/entry_points.txt,sha256=fMWtmYWrnxVCxNKAfvl6QEIHGyhiPrMHZLj15e2SPz0,51
+packwright-0.1.0.dist-info/top_level.txt,sha256=97Gr-aAWj6Yw7XFcrECPSv0WoaQVPrhXqM0blNZhD9Y,11
+packwright-0.1.0.dist-info/RECORD,,

packwright-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

packwright-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+packwright = packwright.cli:main

packwright-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pioneerjeff-labs
+
+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.

packwright-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+packwright