ai-forge-cli 2.1.0__tar.gz → 2.1.3__tar.gz

ai_forge_cli-2.1.3/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: ai-forge-cli
+Version: 2.1.3
+Summary: Forge V3 context CLI
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: mypy>=1.15; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
+
+# Forge
+
+Forge is a Python CLI and framework for vertical-first system design and
+delivery. It helps you define a system clearly, split it into buildable
+verticals, and then deepen and implement one slice at a time with the minimum
+context needed for the task at hand.
+
+Forge is **skills-first**. The skills drive the work. The CLI exists to provide
+scoped context, validation, and audit artifacts to the active skill.
+
+## What This Repository Contains
+
+- `src/cli`: the Forge CLI implementation
+- `skills/`: the Forge skill source used by initialized repositories
+- `FRAMEWORK_V3.md`: the framework process and recommended authoring order used to seed `forge/FRAMEWORK_V3.md`
+- `SCHEMA_REFERENCE_V3.md`: the schema contract and field rules used to seed `forge/SCHEMA_REFERENCE_V3.md`
+- `examples/`: example Forge repositories and audit artifacts
+
+## CLI Commands
+
+- `forge init`: scaffold a new Forge workspace and explain how to use it
+- `forge context`: render scoped context for a system, vertical, flow,
+  container, or component
+- `forge audit`: generate a self-contained architecture audit dashboard
+
+## What Forge Is
+
+- a framework for capturing architectural truth before implementation detail
+- a skills-first workflow for moving from broad system design to one thin
+  vertical at a time
+- a scoped context generator for build, review, and security tasks
+- an audit artifact generator for human review
+
+## What Forge Is Not
+
+- a generic project scaffolder for arbitrary app stacks
+- a replacement for implementation skills such as build, review, and security
+- a reason to model every payload, component, or environment detail up front
+- an excuse to widen a vertical beyond what can be built and validated cleanly
+
+## Recommended Workflow
+
+1. Run `forge init` in an empty repository.
+2. Read:
+   - `forge/USING_FORGE.md`
+   - `forge/FRAMEWORK_V3.md`
+   - `forge/SCHEMA_REFERENCE_V3.md`
+3. Use `forge-schema` to define:
+   - `forge/system.yaml`
+   - `forge/high_level_flows/`
+   - `forge/early_state.yaml`
+   - `forge/runtime.yaml`
+4. Derive `forge/verticals/` once the runtime picture is clear.
+5. Pick one vertical and deepen it through:
+   - `forge/runtime_flows/`
+   - `forge/data_shapes/`
+   - `forge/persistent_shapes/`
+   - `forge/containers/`
+   - `forge/deployment.yaml`
+6. Use `forge-review` to check the slice for drift, bloat, and broken references before build starts.
+7. Use `forge-security` to make the slice security posture explicit before build starts.
+8. Use `forge-build` to plan or implement that approved vertical.
+
+The intended operating mode is:
+
+1. choose the active skill first
+2. ask that skill what scope it needs
+3. use `forge context` only for that narrow scope
+4. use `forge audit` when you need a whole-system review artifact
+
+An initialized repository keeps the Forge-owned schema workspace under `./forge/`. The repo root stays available for product code, app docs, and non-Forge tooling.
+
+## Golden Path Examples
+
+- `examples/forge_v2_ordering_example`: the compact canonical example for docs,
+  smoke tests, and first-time users
+- `examples/forge_v2_fulfillment_control_example`: the richer example used to
+  pressure-test flows, data, deployment, and audit rendering
+
+## Local Development
+
+Use the project virtual environment:
+
+```bash
+.venv/bin/python -m pip install -e .[dev]
+```
+
+## Validation Commands
+
+```bash
+make lint
+make typecheck
+make test
+make compile
+make build
+make verify-package
+make smoke-init
+make check
+```
+
+`make verify-package` builds the wheel, installs it into a fresh Python 3.11+
+virtual environment, and confirms that the installed `forge` entrypoint works.
+
+## Packaging
+
+Build artifacts are generated with:
+
+```bash
+.venv/bin/python -m build
+```
+
+This produces:
+
+- `dist/*.tar.gz`
+- `dist/*.whl`
+
+Validate package metadata before release with:
+
+```bash
+make check-dist
+```
+
+## Local Testing
+
+Run the full local verification path:
+
+```bash
+make check
+```
+
+That covers linting, type checking, tests, compile validation, build output,
+distribution metadata checks, clean wheel install, and `forge init` smoke
+validation.
+
+If you want to test the richer example schema directly:
+
+```bash
+EXAMPLE="examples/forge_v2_fulfillment_control_example"
+.venv/bin/forge audit --project-dir "$EXAMPLE" --output /tmp/forge-audit-example.html
+```
+
+That generates the audit artifact and opens it unless `--no-open` is supplied.
+
+## Framework Notes
+
+- Forge is vertical-first: model broadly, then deepen one thin slice.
+- The framework should reduce context, not increase it.
+- Components and exact schemas should only appear when runtime boundaries and
+  vertical intent are already clear.
+- Important decisions should be captured in `decision_notes.md`.
+
+## Maintainer Notes
+
+- Release instructions live in [docs/RELEASING.md](/Users/willdefina/Documents/2026%20-%20Business/dev-tools/forge/docs/RELEASING.md).
+
+## Repository Notes
+
+Previous iteration artifacts have been retained in `old-forge-v2/`.

ai_forge_cli-2.1.3/README.md

@@ -0,0 +1,158 @@
+# Forge
+
+Forge is a Python CLI and framework for vertical-first system design and
+delivery. It helps you define a system clearly, split it into buildable
+verticals, and then deepen and implement one slice at a time with the minimum
+context needed for the task at hand.
+
+Forge is **skills-first**. The skills drive the work. The CLI exists to provide
+scoped context, validation, and audit artifacts to the active skill.
+
+## What This Repository Contains
+
+- `src/cli`: the Forge CLI implementation
+- `skills/`: the Forge skill source used by initialized repositories
+- `FRAMEWORK_V3.md`: the framework process and recommended authoring order used to seed `forge/FRAMEWORK_V3.md`
+- `SCHEMA_REFERENCE_V3.md`: the schema contract and field rules used to seed `forge/SCHEMA_REFERENCE_V3.md`
+- `examples/`: example Forge repositories and audit artifacts
+
+## CLI Commands
+
+- `forge init`: scaffold a new Forge workspace and explain how to use it
+- `forge context`: render scoped context for a system, vertical, flow,
+  container, or component
+- `forge audit`: generate a self-contained architecture audit dashboard
+
+## What Forge Is
+
+- a framework for capturing architectural truth before implementation detail
+- a skills-first workflow for moving from broad system design to one thin
+  vertical at a time
+- a scoped context generator for build, review, and security tasks
+- an audit artifact generator for human review
+
+## What Forge Is Not
+
+- a generic project scaffolder for arbitrary app stacks
+- a replacement for implementation skills such as build, review, and security
+- a reason to model every payload, component, or environment detail up front
+- an excuse to widen a vertical beyond what can be built and validated cleanly
+
+## Recommended Workflow
+
+1. Run `forge init` in an empty repository.
+2. Read:
+   - `forge/USING_FORGE.md`
+   - `forge/FRAMEWORK_V3.md`
+   - `forge/SCHEMA_REFERENCE_V3.md`
+3. Use `forge-schema` to define:
+   - `forge/system.yaml`
+   - `forge/high_level_flows/`
+   - `forge/early_state.yaml`
+   - `forge/runtime.yaml`
+4. Derive `forge/verticals/` once the runtime picture is clear.
+5. Pick one vertical and deepen it through:
+   - `forge/runtime_flows/`
+   - `forge/data_shapes/`
+   - `forge/persistent_shapes/`
+   - `forge/containers/`
+   - `forge/deployment.yaml`
+6. Use `forge-review` to check the slice for drift, bloat, and broken references before build starts.
+7. Use `forge-security` to make the slice security posture explicit before build starts.
+8. Use `forge-build` to plan or implement that approved vertical.
+
+The intended operating mode is:
+
+1. choose the active skill first
+2. ask that skill what scope it needs
+3. use `forge context` only for that narrow scope
+4. use `forge audit` when you need a whole-system review artifact
+
+An initialized repository keeps the Forge-owned schema workspace under `./forge/`. The repo root stays available for product code, app docs, and non-Forge tooling.
+
+## Golden Path Examples
+
+- `examples/forge_v2_ordering_example`: the compact canonical example for docs,
+  smoke tests, and first-time users
+- `examples/forge_v2_fulfillment_control_example`: the richer example used to
+  pressure-test flows, data, deployment, and audit rendering
+
+## Local Development
+
+Use the project virtual environment:
+
+```bash
+.venv/bin/python -m pip install -e .[dev]
+```
+
+## Validation Commands
+
+```bash
+make lint
+make typecheck
+make test
+make compile
+make build
+make verify-package
+make smoke-init
+make check
+```
+
+`make verify-package` builds the wheel, installs it into a fresh Python 3.11+
+virtual environment, and confirms that the installed `forge` entrypoint works.
+
+## Packaging
+
+Build artifacts are generated with:
+
+```bash
+.venv/bin/python -m build
+```
+
+This produces:
+
+- `dist/*.tar.gz`
+- `dist/*.whl`
+
+Validate package metadata before release with:
+
+```bash
+make check-dist
+```
+
+## Local Testing
+
+Run the full local verification path:
+
+```bash
+make check
+```
+
+That covers linting, type checking, tests, compile validation, build output,
+distribution metadata checks, clean wheel install, and `forge init` smoke
+validation.
+
+If you want to test the richer example schema directly:
+
+```bash
+EXAMPLE="examples/forge_v2_fulfillment_control_example"
+.venv/bin/forge audit --project-dir "$EXAMPLE" --output /tmp/forge-audit-example.html
+```
+
+That generates the audit artifact and opens it unless `--no-open` is supplied.
+
+## Framework Notes
+
+- Forge is vertical-first: model broadly, then deepen one thin slice.
+- The framework should reduce context, not increase it.
+- Components and exact schemas should only appear when runtime boundaries and
+  vertical intent are already clear.
+- Important decisions should be captured in `decision_notes.md`.
+
+## Maintainer Notes
+
+- Release instructions live in [docs/RELEASING.md](/Users/willdefina/Documents/2026%20-%20Business/dev-tools/forge/docs/RELEASING.md).
+
+## Repository Notes
+
+Previous iteration artifacts have been retained in `old-forge-v2/`.

ai_forge_cli-2.1.3/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ai-forge-cli"
+version = "2.1.3"
+description = "Forge V3 context CLI"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = ["pyyaml>=6.0"]
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.2",
+    "mypy>=1.15",
+    "pytest>=8",
+    "ruff>=0.11",
+    "twine>=5.1",
+    "types-PyYAML>=6.0.12",
+]
+
+[project.scripts]
+forge = "cli.forge:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["cli*"]
+
+[tool.setuptools.package-data]
+cli = ["assets/*.svg", "assets/*.html", "resources/*.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 160
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.mypy]
+python_version = "3.11"
+files = ["src/cli"]
+mypy_path = ["src"]
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+strict_equality = true
+check_untyped_defs = true
+disallow_any_generics = true
+no_implicit_optional = true
+explicit_package_bases = true
+
+[[tool.mypy.overrides]]
+module = [
+    "cli.commands.audit",
+    "cli.commands.context",
+    "cli.schema",
+]
+ignore_errors = true

ai_forge_cli-2.1.3/src/ai_forge_cli.egg-info/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.4
+Name: ai-forge-cli
+Version: 2.1.3
+Summary: Forge V3 context CLI
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: mypy>=1.15; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
+
+# Forge
+
+Forge is a Python CLI and framework for vertical-first system design and
+delivery. It helps you define a system clearly, split it into buildable
+verticals, and then deepen and implement one slice at a time with the minimum
+context needed for the task at hand.
+
+Forge is **skills-first**. The skills drive the work. The CLI exists to provide
+scoped context, validation, and audit artifacts to the active skill.
+
+## What This Repository Contains
+
+- `src/cli`: the Forge CLI implementation
+- `skills/`: the Forge skill source used by initialized repositories
+- `FRAMEWORK_V3.md`: the framework process and recommended authoring order used to seed `forge/FRAMEWORK_V3.md`
+- `SCHEMA_REFERENCE_V3.md`: the schema contract and field rules used to seed `forge/SCHEMA_REFERENCE_V3.md`
+- `examples/`: example Forge repositories and audit artifacts
+
+## CLI Commands
+
+- `forge init`: scaffold a new Forge workspace and explain how to use it
+- `forge context`: render scoped context for a system, vertical, flow,
+  container, or component
+- `forge audit`: generate a self-contained architecture audit dashboard
+
+## What Forge Is
+
+- a framework for capturing architectural truth before implementation detail
+- a skills-first workflow for moving from broad system design to one thin
+  vertical at a time
+- a scoped context generator for build, review, and security tasks
+- an audit artifact generator for human review
+
+## What Forge Is Not
+
+- a generic project scaffolder for arbitrary app stacks
+- a replacement for implementation skills such as build, review, and security
+- a reason to model every payload, component, or environment detail up front
+- an excuse to widen a vertical beyond what can be built and validated cleanly
+
+## Recommended Workflow
+
+1. Run `forge init` in an empty repository.
+2. Read:
+   - `forge/USING_FORGE.md`
+   - `forge/FRAMEWORK_V3.md`
+   - `forge/SCHEMA_REFERENCE_V3.md`
+3. Use `forge-schema` to define:
+   - `forge/system.yaml`
+   - `forge/high_level_flows/`
+   - `forge/early_state.yaml`
+   - `forge/runtime.yaml`
+4. Derive `forge/verticals/` once the runtime picture is clear.
+5. Pick one vertical and deepen it through:
+   - `forge/runtime_flows/`
+   - `forge/data_shapes/`
+   - `forge/persistent_shapes/`
+   - `forge/containers/`
+   - `forge/deployment.yaml`
+6. Use `forge-review` to check the slice for drift, bloat, and broken references before build starts.
+7. Use `forge-security` to make the slice security posture explicit before build starts.
+8. Use `forge-build` to plan or implement that approved vertical.
+
+The intended operating mode is:
+
+1. choose the active skill first
+2. ask that skill what scope it needs
+3. use `forge context` only for that narrow scope
+4. use `forge audit` when you need a whole-system review artifact
+
+An initialized repository keeps the Forge-owned schema workspace under `./forge/`. The repo root stays available for product code, app docs, and non-Forge tooling.
+
+## Golden Path Examples
+
+- `examples/forge_v2_ordering_example`: the compact canonical example for docs,
+  smoke tests, and first-time users
+- `examples/forge_v2_fulfillment_control_example`: the richer example used to
+  pressure-test flows, data, deployment, and audit rendering
+
+## Local Development
+
+Use the project virtual environment:
+
+```bash
+.venv/bin/python -m pip install -e .[dev]
+```
+
+## Validation Commands
+
+```bash
+make lint
+make typecheck
+make test
+make compile
+make build
+make verify-package
+make smoke-init
+make check
+```
+
+`make verify-package` builds the wheel, installs it into a fresh Python 3.11+
+virtual environment, and confirms that the installed `forge` entrypoint works.
+
+## Packaging
+
+Build artifacts are generated with:
+
+```bash
+.venv/bin/python -m build
+```
+
+This produces:
+
+- `dist/*.tar.gz`
+- `dist/*.whl`
+
+Validate package metadata before release with:
+
+```bash
+make check-dist
+```
+
+## Local Testing
+
+Run the full local verification path:
+
+```bash
+make check
+```
+
+That covers linting, type checking, tests, compile validation, build output,
+distribution metadata checks, clean wheel install, and `forge init` smoke
+validation.
+
+If you want to test the richer example schema directly:
+
+```bash
+EXAMPLE="examples/forge_v2_fulfillment_control_example"
+.venv/bin/forge audit --project-dir "$EXAMPLE" --output /tmp/forge-audit-example.html
+```
+
+That generates the audit artifact and opens it unless `--no-open` is supplied.
+
+## Framework Notes
+
+- Forge is vertical-first: model broadly, then deepen one thin slice.
+- The framework should reduce context, not increase it.
+- Components and exact schemas should only appear when runtime boundaries and
+  vertical intent are already clear.
+- Important decisions should be captured in `decision_notes.md`.
+
+## Maintainer Notes
+
+- Release instructions live in [docs/RELEASING.md](/Users/willdefina/Documents/2026%20-%20Business/dev-tools/forge/docs/RELEASING.md).
+
+## Repository Notes
+
+Previous iteration artifacts have been retained in `old-forge-v2/`.

ai_forge_cli-2.1.3/src/ai_forge_cli.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+README.md
+pyproject.toml
+src/ai_forge_cli.egg-info/PKG-INFO
+src/ai_forge_cli.egg-info/SOURCES.txt
+src/ai_forge_cli.egg-info/dependency_links.txt
+src/ai_forge_cli.egg-info/entry_points.txt
+src/ai_forge_cli.egg-info/requires.txt
+src/ai_forge_cli.egg-info/top_level.txt
+src/cli/__init__.py
+src/cli/__main__.py
+src/cli/common.py
+src/cli/forge.py
+src/cli/schema.py
+src/cli/assets/audit_template.html
+src/cli/assets/forge_full_logo.drawio.svg
+src/cli/assets/forge_white_small.drawio.svg
+src/cli/commands/__init__.py
+src/cli/commands/audit.py
+src/cli/commands/base.py
+src/cli/commands/context.py
+src/cli/commands/init.py
+src/cli/resources/FRAMEWORK_V3.md
+src/cli/resources/SCHEMA_REFERENCE_V3.md
+tests/test_context.py

ai_forge_cli-2.1.3/src/ai_forge_cli.egg-info/requires.txt

@@ -0,0 +1,9 @@
+pyyaml>=6.0
+
+[dev]
+build>=1.2
+mypy>=1.15
+pytest>=8
+ruff>=0.11
+twine>=5.1
+types-PyYAML>=6.0.12

{ai_forge_cli-2.1.0 → ai_forge_cli-2.1.3}/src/cli/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "2.1.0"
+__version__ = "2.1.3"

{ai_forge_cli-2.1.0 → ai_forge_cli-2.1.3}/src/cli/__main__.py

@@ -1,5 +1,4 @@
 from cli.forge import main
 
-
 if __name__ == "__main__":
     raise SystemExit(main())