expflow-hooks 1.0.0__py3-none-any.whl

expflow_hooks/__init__.py

@@ -0,0 +1,8 @@
+"""
+Expflow Python hook package - v1 scaffold.
+
+This package contains no product runtime implementation.
+No hook registration, dispatch, or execution exists in core.
+"""
+
+__version__ = "1.0.0"

expflow_hooks/discovery.py

@@ -0,0 +1,54 @@
+"""Read-only discovery of architecture schema-source directory.
+
+Phase 1 scaffold only. No product runtime behavior exists.
+
+Architecture sources are repository-contract inputs and are not packaged into
+the Python wheel. Installed wheels can import the package and report the
+contract version, while architecture discovery is explicitly available only
+from an editable repository checkout.
+"""
+
+from pathlib import Path
+
+_REPO_ROOT = Path(__file__).resolve().parent.parent.parent
+ARCHITECTURE_DIR = _REPO_ROOT / "docs" / "architecture"
+SCHEMAS_DIR = ARCHITECTURE_DIR / "schemas"
+SOURCE_MANIFEST_PATH = ARCHITECTURE_DIR / "SOURCE_MANIFEST.json"
+ARCHITECTURE_DISCOVERY_MODE = "editable-repository"
+
+
+def architecture_sources_available() -> bool:
+    """Return whether repository architecture sources are available."""
+    return (
+        ARCHITECTURE_DIR.is_dir()
+        and SCHEMAS_DIR.is_dir()
+        and SOURCE_MANIFEST_PATH.is_file()
+    )
+
+
+def require_repository_architecture() -> None:
+    """Require architecture sources from an editable repository checkout."""
+    if architecture_sources_available():
+        return
+
+    missing = [
+        path
+        for path in (ARCHITECTURE_DIR, SCHEMAS_DIR, SOURCE_MANIFEST_PATH)
+        if not path.exists()
+    ]
+    missing_text = ", ".join(str(path) for path in missing)
+    raise FileNotFoundError(
+        "Expflow Phase 1 Python architecture discovery is available only from "
+        "an editable repository checkout; installed wheels do not package "
+        f"docs/architecture. Missing: {missing_text}"
+    )
+
+
+__all__ = [
+    "ARCHITECTURE_DIR",
+    "ARCHITECTURE_DISCOVERY_MODE",
+    "SCHEMAS_DIR",
+    "SOURCE_MANIFEST_PATH",
+    "architecture_sources_available",
+    "require_repository_architecture",
+]

expflow_hooks-1.0.0.dist-info/METADATA

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: expflow-hooks
+Version: 1.0.0
+Summary: Expflow Python hook scaffold and read-only architecture schema discovery
+Author-email: Paragon AI <work.jlines@gmail.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/paragon-ux/Expflow
+Project-URL: Issues, https://github.com/paragon-ux/Expflow/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: jsonschema>=4.23.0; extra == "dev"
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: build>=1.2.0; extra == "dev"
+Requires-Dist: twine>=6.1.0; extra == "dev"
+Dynamic: license-file
+
+[![CI](https://github.com/paragon-ux/Expflow/actions/workflows/phase-1-contract.yml/badge.svg)](https://github.com/paragon-ux/Expflow/actions/workflows/phase-1-contract.yml)
+
+# Expflow
+
+Expflow is a schema-governed, local-first workflow ownership and observability platform for projects where people, agents, and tools produce changing artifact trees.
+
+Expflow records what changed, which evidence was trusted, which decisions remain durable, and which outputs can be inspected, regenerated, restored, or reused.
+
+Current release: [`v1.0.0`](docs/release_notes/GITHUB_RELEASE_NOTE_V1_0_0.md).
+
+## What Expflow Tracks
+
+Expflow separates five concerns that are often blurred in automated work:
+
+- material files before and after workflow activity;
+- accepted authority sources for the work;
+- attributed claims, decisions, conflicts, and review requests;
+- workflow inputs, outputs, projections, regeneration attempts, equivalence evaluations, and reuse evidence;
+- local security, migration, package, and proof evidence.
+
+Material output does not imply semantic acceptance, workflow completion, or reuse permission. Expflow keeps those records separate.
+
+## Release Scope
+
+Expflow v1.0.0 covers the local core surfaces implemented in this repository:
+
+- four ordinary commands: `expflow init`, `expflow sync`, `expflow status`, and `expflow restore`;
+- local `.expflow/` material storage with immutable object, node-revision, tree-revision, receipt, validation, change, and material-head records;
+- complete-tree sync, drift status, tree/node restore, scoped path selection, explicit identity directives, and digest-similarity proposals without silent identity preservation;
+- project locks, operation-scoped staging, recoverable init/restore intents, stale-lock classification, causal tree/receipt head repair, restore recovery, and restored-tree digest verification;
+- library runtimes for authority sources, semantic decisions, workflow boundaries, projections, regeneration/equivalence, structural reuse, security controls, migration evidence, and the native extension host;
+- repository-contract checks for immutable architecture sources, schemas, examples, fixtures, registries, package boundaries, and end-to-end proof.
+
+## Quickstart
+
+With the npm package available from the public registry:
+
+```bash
+npm install -g expflow
+expflow init
+expflow status
+```
+
+The npm package exposes the `expflow` CLI and TypeScript library exports. The Python package is a separate hook scaffold with read-only repository architecture discovery; it does not dispatch or execute hooks.
+
+## Installation
+
+After verified registry publication, install the primary Expflow CLI and TypeScript package with:
+
+```bash
+npm install -g expflow
+```
+
+Install the Python hook scaffold separately with:
+
+```bash
+pip install expflow-hooks
+```
+
+`expflow-hooks` is not the primary Expflow CLI implementation. It exposes the limited Python hook/scaffold package and `expflow_hooks` import surface.
+
+## Workflow
+
+1. Run `expflow init` to create local Expflow state.
+2. Change files in the project tree.
+3. Run `expflow sync` to record a complete material tree revision.
+4. Run `expflow status` to inspect drift and recorded state.
+5. Run `expflow restore` when a recorded tree or node revision should be restored.
+
+Gate C ownership/reproduction behavior and Gate D security/migration behavior are available through library runtimes rather than additional ordinary commands.
+
+## Commands
+
+| Command           | Purpose                                                             |
+| ----------------- | ------------------------------------------------------------------- |
+| `expflow init`    | Initialize local Expflow project state.                             |
+| `expflow sync`    | Scan the working tree and commit a complete material tree revision. |
+| `expflow status`  | Report local drift and material project state.                      |
+| `expflow restore` | Restore a recorded material tree or node revision.                  |
+
+## What Expflow Delegates
+
+Expflow core intentionally does not implement every surrounding integration surface.
+
+- **Adapter inspection and reconciliation:** belongs in separately versioned adapter packages.
+- **External revision cursors and idempotency:** outside the core repository.
+- **Guerilla hook dispatch:** compatibility reference only, not an Expflow core runtime.
+- **Network services, databases, and brokers:** absent from the local core.
+- **Archive extraction and generated-code execution:** blocked by the Gate D security posture.
+- **Pilots and empirical evaluation:** future work outside the v1.0.0 core release.
+
+## Repository Map
+
+- `docs/architecture/` contains immutable architecture sources.
+- `docs/` contains mutable implementation evidence, completion reports, release notes, review summaries, and orientation.
+- `schemas/` and `examples/` mirror the architecture schemas and examples for tooling.
+- `src/` contains the TypeScript package, CLI, material runtime, Gate C library runtimes, Gate D security/migration runtimes, and contract tooling.
+- `python/expflow_hooks/` contains the Python hook-package scaffold and repository-only schema discovery.
+- `tests/` contains repository-contract, material-runtime, authority, Gate C ownership/reproduction, Gate D security/migration, package, and end-to-end proof tests.
+
+For implementation status, see [docs/CURRENT_STATUS_MATRIX.md](docs/CURRENT_STATUS_MATRIX.md). For contributor setup and validation commands, see [README_DEV.md](README_DEV.md).
+
+## Validation
+
+```bash
+npm ci
+npm run validate
+python -m pip install -e ".[dev]"
+python -m pytest
+python -m build --wheel
+python tests/contracts/verify_python_wheel.py
+```
+
+## Documentation
+
+- [v1.0.0 GitHub release note](docs/release_notes/GITHUB_RELEASE_NOTE_V1_0_0.md)
+- [v1 compatibility promise](docs/V1_COMPATIBILITY.md)
+- [Release publishing checklist](docs/RELEASE_PUBLISHING.md)
+- [Current status matrix](docs/CURRENT_STATUS_MATRIX.md)
+- [Developer guide](README_DEV.md)
+- [Repository directory structure](docs/REPOSITORY_DIRECTORY_STRUCTURE.md)
+- [Security policy](SECURITY.md)
+
+## License
+
+Expflow is released under the [MIT License](LICENSE).

expflow_hooks-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+expflow_hooks/__init__.py,sha256=rSnkOuecre9JQj3yU31ZUyOD4IQK_BOuc503Ea-kZs8,193
+expflow_hooks/discovery.py,sha256=D-U_Q29CmKij6xpXc1ix9-kB9ckxmp07STSSezSQd50,1770
+expflow_hooks-1.0.0.dist-info/licenses/LICENSE,sha256=FbRh9aMtpHeyBN1BQ5yAEJH4RgUu2WcWWwKqx68KvVw,1067
+expflow_hooks-1.0.0.dist-info/METADATA,sha256=DLsVuPEeqQoZ3p4yOptcI-rCyrjDrmLTjMkcEa6eCqE,6979
+expflow_hooks-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+expflow_hooks-1.0.0.dist-info/top_level.txt,sha256=eWAX0zDJn8_fVCzecNJkDRZk3N_WCGWOqL1z__gwR6Y,14
+expflow_hooks-1.0.0.dist-info/RECORD,,

expflow_hooks-1.0.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
+

expflow_hooks-1.0.0.dist-info/licenses/LICENSE

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

expflow_hooks-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+expflow_hooks