packwright 0.1.0rc1__tar.gz

packwright-0.1.0rc1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,31 @@
+name: Bug report
+description: Report a reproducible Packwright defect using synthetic data.
+title: "[bug] "
+body:
+  - type: input
+    id: version
+    attributes:
+      label: Packwright version
+      placeholder: Output of packwright --version
+    validations:
+      required: true
+  - type: dropdown
+    id: adapter
+    attributes:
+      label: Adapter
+      options: [codex, claude-code, cursor, not adapter-specific]
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Include commands and sanitized output. Never attach real memory or credentials.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true

packwright-0.1.0rc1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,17 @@
+name: Feature request
+description: Propose a focused improvement to the public v0.1 workflow.
+title: "[feature] "
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What user problem should Packwright solve?
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired outcome
+    validations:
+      required: true

packwright-0.1.0rc1/.github/pull_request_template.md

@@ -0,0 +1,10 @@
+## Summary
+
+Describe the user-visible change and its v0.1 scope.
+
+## Verification
+
+- [ ] `scripts/release-gate.sh --quick`
+- [ ] Tests cover the changed behavior
+- [ ] No real memory, credentials, private paths, or build artifacts are included
+- [ ] Migration changes preserve dry-run, confirmation, and receipt semantics

packwright-0.1.0rc1/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install -e '.[test]'
+      - run: scripts/release-gate.sh --quick
+
+  package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+      - run: python -m pip install -e '.[test]'
+      - run: scripts/release-gate.sh --output-dir "$RUNNER_TEMP/packwright-dist"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: packwright-0.1.0rc1
+          path: |
+            ${{ runner.temp }}/packwright-dist/*.whl
+            ${{ runner.temp }}/packwright-dist/*.tar.gz
+            ${{ runner.temp }}/packwright-dist/release-artifacts.json

packwright-0.1.0rc1/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and verify distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+      - name: Verify release tag matches package version
+        run: |
+          PACKAGE_VERSION="$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')"
+          test "$GITHUB_REF_NAME" = "v$PACKAGE_VERSION"
+      - run: python -m pip install -e '.[test]'
+      - run: scripts/release-gate.sh --output-dir "$RUNNER_TEMP/packwright-dist"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: |
+            ${{ runner.temp }}/packwright-dist/*.whl
+            ${{ runner.temp }}/packwright-dist/*.tar.gz
+          if-no-files-found: error
+
+  publish:
+    name: Publish distributions to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/packwright
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

packwright-0.1.0rc1/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes are documented here. Packwright follows Semantic Versioning.
+
+## [0.1.0rc1] - 2026-07-11
+
+### Added
+
+- Six-command public CLI: `init`, `build`, `install`, `migrate`, `doctor`, and `score`.
+- Native projections for Codex, Claude Code, and Cursor.
+- Read-only migration plans with path-level generated, carried, rewritten, and excluded receipts.
+- Self-contained installed-target metadata and pre/post-install scoring.
+- Static zero-network audit, local release gate, packaging checks, and CI.
+
+[0.1.0rc1]: https://github.com/pioneerjeff-labs/packwright/releases/tag/v0.1.0rc1

packwright-0.1.0rc1/CONTRIBUTING.md

@@ -0,0 +1,11 @@
+# Contributing
+
+Packwright accepts focused bug fixes, tests, documentation corrections, and adapter improvements.
+
+1. Create a branch from `main`.
+2. Install development tools with `python -m pip install -e '.[dev]'`.
+3. Run `scripts/release-gate.sh --quick` while iterating.
+4. Run `scripts/release-gate.sh` before opening a pull request.
+5. Explain user-visible behavior and add or update tests.
+
+Do not include real agent memory, credentials, private paths, or generated build artifacts. Migration changes must preserve the dry-run-before-write contract and report every generated, carried, rewritten, and excluded path.

packwright-0.1.0rc1/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.0rc1/MANIFEST.in

@@ -0,0 +1,17 @@
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include README.md
+include README.zh-CN.md
+include SECURITY.md
+recursive-include docs *.md
+recursive-include examples *.yaml *.md
+recursive-include assets *.css *.svg
+recursive-include site *.html *.css *.svg
+recursive-include templates *
+recursive-include specs *.yaml
+recursive-include tests *.py
+recursive-include scripts *.py *.sh
+recursive-include .github *.yml *.yaml *.md
+global-exclude *.py[cod]
+global-exclude .DS_Store

packwright-0.1.0rc1/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: packwright
+Version: 0.1.0rc1
+Summary: Agent pack compiler for Codex, Claude Code, and Cursor.
+Author: pioneerjeff-labs
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pioneerjeff-labs/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
+
+# Packwright
+
+Packwright migrates a working coding-agent setup between Codex, Claude Code, and Cursor, showing exactly what will be generated, carried, rewritten, and excluded before it writes.
+
+The output is plain files you can read.
+
+> Packwright itself makes no network requests and sends no telemetry. Your files stay under your control; your coding runtime's own data policy still applies.
+
+## Quickstart
+
+Install the current release candidate:
+
+```bash
+python -m pip install packwright==0.1.0rc1
+```
+
+Create an editable source and build it for one of the three adapters:
+
+```bash
+packwright init --template creator -o work/mira
+packwright build work/mira --adapter codex -o pack/mira-codex
+packwright install pack/mira-codex --target project/mira-codex
+```
+
+Supported adapters are `codex`, `claude-code`, and `cursor`. Codex emits `AGENTS.md` and `.agents/skills/`; Claude Code emits `CLAUDE.md` and `.claude/skills/`; Cursor emits `.cursor/rules/*.mdc`.
+
+Preview a migration without creating its destination:
+
+```bash
+packwright migrate project/mira-codex \
+  --to cursor \
+  --target project/mira-cursor \
+  --dry-run
+```
+
+Review the generated, carried, rewritten, and excluded paths. Then apply that plan explicitly:
+
+```bash
+packwright migrate project/mira-codex \
+  --to cursor \
+  --target project/mira-cursor \
+  --yes
+packwright doctor project/mira-cursor
+packwright score project/mira-cursor
+```
+
+For machine-readable migration receipts, add `--json` to both the dry run and the confirmed run. Existing targets are not overwritten unless you separately opt into `--force`.
+
+## What the score means
+
+Packwright validates the pack structure and its public artifact contract. A score of 100.0 means those rules pass; it does not claim that a coding runtime will behave perfectly. Runtime compatibility is verified separately.
+
+Installed targets include self-contained `.packwright/` metadata, so `migrate`, `doctor`, and `score` do not depend on the original source or build directory. Migration receipts identify the small set of adapter-routing lines that Packwright may rewrite; carried files are hash-verified.
+
+## Use it through a coding agent
+
+[Use Packwright with your coding agent](docs/USE_WITH_YOUR_AGENT.md) provides a paste-ready operating prompt. It requires a dry run, user confirmation, and a final receipt.
+
+## Documentation
+
+- [CLI contract](docs/CLI.md)
+- [Character drafting](docs/CHARACTER_DRAFTING.md)
+- [Agent archetypes](docs/AGENT_ARCHETYPES.md)
+- [Chinese README](README.zh-CN.md)
+- [0.1.0rc1 release notes](docs/releases/0.1.0rc1.md)
+- [Contributing](CONTRIBUTING.md)
+- [Security](SECURITY.md)
+
+Packwright is licensed under the [MIT License](LICENSE).

packwright-0.1.0rc1/README.md

@@ -0,0 +1,69 @@
+# Packwright
+
+Packwright migrates a working coding-agent setup between Codex, Claude Code, and Cursor, showing exactly what will be generated, carried, rewritten, and excluded before it writes.
+
+The output is plain files you can read.
+
+> Packwright itself makes no network requests and sends no telemetry. Your files stay under your control; your coding runtime's own data policy still applies.
+
+## Quickstart
+
+Install the current release candidate:
+
+```bash
+python -m pip install packwright==0.1.0rc1
+```
+
+Create an editable source and build it for one of the three adapters:
+
+```bash
+packwright init --template creator -o work/mira
+packwright build work/mira --adapter codex -o pack/mira-codex
+packwright install pack/mira-codex --target project/mira-codex
+```
+
+Supported adapters are `codex`, `claude-code`, and `cursor`. Codex emits `AGENTS.md` and `.agents/skills/`; Claude Code emits `CLAUDE.md` and `.claude/skills/`; Cursor emits `.cursor/rules/*.mdc`.
+
+Preview a migration without creating its destination:
+
+```bash
+packwright migrate project/mira-codex \
+  --to cursor \
+  --target project/mira-cursor \
+  --dry-run
+```
+
+Review the generated, carried, rewritten, and excluded paths. Then apply that plan explicitly:
+
+```bash
+packwright migrate project/mira-codex \
+  --to cursor \
+  --target project/mira-cursor \
+  --yes
+packwright doctor project/mira-cursor
+packwright score project/mira-cursor
+```
+
+For machine-readable migration receipts, add `--json` to both the dry run and the confirmed run. Existing targets are not overwritten unless you separately opt into `--force`.
+
+## What the score means
+
+Packwright validates the pack structure and its public artifact contract. A score of 100.0 means those rules pass; it does not claim that a coding runtime will behave perfectly. Runtime compatibility is verified separately.
+
+Installed targets include self-contained `.packwright/` metadata, so `migrate`, `doctor`, and `score` do not depend on the original source or build directory. Migration receipts identify the small set of adapter-routing lines that Packwright may rewrite; carried files are hash-verified.
+
+## Use it through a coding agent
+
+[Use Packwright with your coding agent](docs/USE_WITH_YOUR_AGENT.md) provides a paste-ready operating prompt. It requires a dry run, user confirmation, and a final receipt.
+
+## Documentation
+
+- [CLI contract](docs/CLI.md)
+- [Character drafting](docs/CHARACTER_DRAFTING.md)
+- [Agent archetypes](docs/AGENT_ARCHETYPES.md)
+- [Chinese README](README.zh-CN.md)
+- [0.1.0rc1 release notes](docs/releases/0.1.0rc1.md)
+- [Contributing](CONTRIBUTING.md)
+- [Security](SECURITY.md)
+
+Packwright is licensed under the [MIT License](LICENSE).

packwright-0.1.0rc1/README.zh-CN.md

@@ -0,0 +1,53 @@
+# Packwright
+
+Packwright 可在 Codex、Claude Code 与 Cursor 之间迁移已经在工作的 coding agent 配置，并在写入之前准确展示将生成、原样携带、改写和排除的内容。
+
+输出是你可以直接阅读的普通文件。
+
+> Packwright 自身不会发起任何网络请求，也不会发送遥测数据。你的文件始终由你控制；你所使用的 coding runtime 自身的数据政策仍然适用。
+
+## 快速开始
+
+安装当前候选版本：
+
+```bash
+python -m pip install packwright==0.1.0rc1
+```
+
+创建可编辑的源文件、构建并安装：
+
+```bash
+packwright init --template creator -o work/mira
+packwright build work/mira --adapter codex -o pack/mira-codex
+packwright install pack/mira-codex --target project/mira-codex
+```
+
+支持的 adapter 为 `codex`、`claude-code` 与 `cursor`。所有输出均为普通文件。
+
+先预览迁移，不创建目标目录：
+
+```bash
+packwright migrate project/mira-codex \
+  --to cursor \
+  --target project/mira-cursor \
+  --dry-run
+```
+
+检查生成、原样携带、改写与排除清单后，再明确确认写入：
+
+```bash
+packwright migrate project/mira-codex \
+  --to cursor \
+  --target project/mira-cursor \
+  --yes
+packwright doctor project/mira-cursor
+packwright score project/mira-cursor
+```
+
+如需机器可读的迁移收据，请在预览与确认命令中都加入 `--json`。除非另行使用 `--force`，Packwright 不会覆盖已有目标。
+
+## 分数边界
+
+100.0 分表示 pack 通过 Packwright 的公开结构规则，不代表 coding runtime 的实际行为获得 100% 保证。三种 runtime 的真实交互兼容性需要独立验证。
+
+更多内容请参阅 [CLI 契约](docs/CLI.md)、[coding agent 使用提示词](docs/USE_WITH_YOUR_AGENT.md)与 [0.1.0rc1 发布说明](docs/releases/0.1.0rc1.md)。

packwright-0.1.0rc1/SECURITY.md

@@ -0,0 +1,11 @@
+# Security Policy
+
+## Supported versions
+
+Security fixes are provided for the latest published Packwright release.
+
+## Reporting a vulnerability
+
+Please use GitHub private vulnerability reporting for `pioneerjeff-labs/packwright`. Do not open a public issue with exploit details or private agent files. Include the affected version, reproduction steps using synthetic data, and expected impact.
+
+Packwright itself makes no network requests and sends no telemetry. Your files stay under your control; your coding runtime's own data policy still applies.

packwright-0.1.0rc1/assets/mark-dark.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Packwright"><path fill="#EFE8DB" d="M8 8 H50 V40 L76 30 V70 L50 60 V92 H8 Z"/><path fill="#B87333" d="M92 8 H50 V40 L76 30 V70 L50 60 V92 H92 Z"/></svg>

packwright-0.1.0rc1/assets/mark-light.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Packwright"><path fill="#221C15" d="M8 8 H50 V40 L76 30 V70 L50 60 V92 H8 Z"/><path fill="#B87333" d="M92 8 H50 V40 L76 30 V70 L50 60 V92 H92 Z"/></svg>

packwright-0.1.0rc1/assets/tokens.css

@@ -0,0 +1,2 @@
+:root{--pw-bg:#F8F4EC;--pw-bg-raised:#FFFDF8;--pw-text:#221C15;--pw-text-muted:#5C5245;--pw-border:#DFD5C2;--pw-accent:#9C4F16;--pw-link:#2E5F86;--pw-copper-mid:#B87333}
+@media(prefers-color-scheme:dark){:root{--pw-bg:#221C15;--pw-bg-raised:#2C251C;--pw-text:#EFE8DB;--pw-text-muted:#B3A78F;--pw-border:#453C2F;--pw-accent:#D9935A;--pw-link:#8AB6D9}}

packwright-0.1.0rc1/docs/AGENT_ARCHETYPES.md

@@ -0,0 +1,113 @@
+# Agent Archetypes And Memory Contract
+
+Packwright treats a character as an agent instance generated from an archetype. The archetype sets the default memory shape and promotion rules; the instance supplies the name, role, voice, work focus, and local state.
+
+```text
+archetype
+  -> character instance
+    -> platform entry file
+    -> memory contract
+    -> workspace contract
+    -> optional runtime state
+```
+
+## Core Layers
+
+- `AGENTS.md` or `CLAUDE.md`: stable identity, voice, and default behavior.
+- `memory/index.md`: default router and owner map.
+- `memory/profile.md`: explicit stable profile facts that may matter across workstreams.
+- `memory/workstreams.md`: router for long-running domains.
+- `memory/workstreams/<slug>.md`: optional detailed domain file for mature workstreams.
+- `memory/projects/<slug>.md`: project state, decisions, and open loops.
+- `memory/source-map.md`: source, account, file, and artifact lookup pointers.
+- `memory/todos.md`: action queue and commitments.
+- `memory/collaboration.md`: collaboration calibration and repair notes.
+- `workspace/`: domain-first generated drafts, durable artifacts, and archives.
+- `.emotion-engine/codex-state.json`: optional dynamic emotion state, separate from durable memory.
+
+## Archetypes
+
+### Productivity
+
+For task execution, project work, planning, and operational follow-through.
+
+Default bias:
+
+- profile stores stable user, team, or operating preferences.
+- workstreams represent durable areas of responsibility.
+- projects own concrete deliverables and current state.
+
+### Learning Coach
+
+For teaching, coaching, deliberate practice, and feedback loops.
+
+Default bias:
+
+- profile stores learner level, goals, constraints, preferences, and recurring errors.
+- workstreams represent curriculum, practice, feedback, assessment, and habit tracks.
+- projects represent courses, exams, training blocks, or learning deliverables.
+
+### Companion
+
+For companion-style continuity where relationship tone matters.
+
+Default bias:
+
+- profile stores only user-approved stable facts and preferences.
+- transient emotion, inferred psychology, and relationship dynamics do not belong in profile.
+- dynamic state belongs in the Emotion Engine sidecar when enabled.
+- workstreams represent shared routines, creative threads, or boundary-safe support contexts.
+
+### Creator
+
+For media, writing, publishing, editorial systems, and audience development.
+
+Default bias:
+
+- profile stores creator identity, public positioning, style preferences, and platform constraints.
+- workstreams represent content pillars, publishing operations, asset pipelines, and campaign tracks.
+- workspace stores drafts, scripts, title sets, thumbnail briefs, and final publishing artifacts under the creator domain.
+
+### Operations
+
+For recurring maintenance, monitoring, community, and administrative workflows.
+
+Default bias:
+
+- profile stores stakeholders, constraints, service expectations, and escalation preferences.
+- workstreams represent recurring operational domains with checklists and cadence.
+- source-map indexes dashboards, accounts, documents, and monitoring sources.
+
+## Workstream Promotion
+
+A workstream should stay inside the parent agent while it only needs domain routing and compact state. Promote it to an independent agent when one or more of these become stable:
+
+- different default personality or voice
+- distinct toolchain or source map
+- independent cadence, checks, or maintenance
+- multiple projects with a stable domain router
+- enough context that loading it would pollute unrelated work
+- separate acceptance criteria or ownership boundary
+
+Promotion path:
+
+```text
+memory/workstreams.md entry
+  -> memory/workstreams/<slug>.md detail file
+  -> generated independent agent
+  -> parent agent keeps routing and acceptance unless ownership moves
+```
+
+## Workspace Rules
+
+Memory files are not a content warehouse. Workspace layout is domain-first and lifecycle-second so workstream artifacts are easy to migrate with the domain later.
+
+- Use `workspace/<domain>/drafts/` for temporary drafts and explorations.
+- Use `workspace/<domain>/artifacts/` for final or reusable deliverables.
+- Use `workspace/<domain>/archive/` for old outputs kept for reference.
+- Use `workspace/shared/` only for cross-domain outputs.
+- Use `workspace/shared/artifacts/handoffs/` for real cross-agent or cross-runtime handoffs.
+- Use `workspace/shared/artifacts/session-briefs/` for same-agent next-session preparation files.
+- Use `workspace/_template/` as the skeleton for a new workstream workspace.
+- Index important outputs in `memory/source-map.md`.
+- Move durable project state into `memory/projects/<slug>.md`, not workspace files.