@mriekki/lean 0.1.0 → 0.2.0

package/README.md

@@ -1,67 +1,71 @@
-# Lean Platform
-
-`@mriekki/lean` is the public consumer-facing distribution for Lean engineering assets.
-
-Canonical engineering remains in the private platform repositories. Before publication, a deterministic assembly step verifies exact pinned source commits and distribution descriptors, then copies only those approved consumer mappings into the npm payload. Each published npm release is therefore self-contained; consumers do not need access to the canonical repositories to install or update Lean assets.
-
-## V0.1 profile
-
-The initial `greenfield-poc` profile bundles:
-
-- Lean Agentic Core `1.10.0` from commit `e2d64b10f1a30507471755339c20e8b58e62be16`, distribution `greenfield-workspace`;
-- Lean POC Deployment Kit commit `4c23140576b39608a3ef285cad4abe53dccb9c47`, distribution `greenfield-poc`.
-
-## Developer experience
-
-Preview/install:
-
-```powershell
-npx @mriekki/lean install
-```
-
-When run interactively, the command previews all managed changes and asks once before applying a safe plan. Automation can use `--apply` after reviewing the preview contract.
-
-Update using the newest published package:
-
-```powershell
-npx @mriekki/lean@latest update
-```
-
-Inspect or verify:
-
-```powershell
-npx @mriekki/lean@latest status
-npx @mriekki/lean@latest check
-```
-
-The umbrella package writes `LEAN_BASELINE.json` while preserving component-native `CORE_BASELINE.json` and `DEPLOYMENT_BASELINE.json` ledgers. Updates refuse managed drift/conflicts before modifying any component. Core retired paths require explicit ownership transfer with `--accept-retired core:<path>`; unchanged Deployment Kit retirements may be removed under its existing ownership contract.
-
-## Safety and ownership
-
-- npm is the distribution transport, not the canonical source of reusable behavior.
-- package releases pin exact accepted source commits.
-- install/update never require private GitHub access.
-- no install/update lifecycle hook mutates a consumer repository; changes occur only when the user invokes the Lean CLI.
-- one preflight plan covers all selected components; an unsafe component blocks the entire apply.
-- package publication is separate from merging this repository and requires an explicit release action.
-
-## Current scope
-
-V0.1 intentionally starts with the greenfield POC consumer profile. Existing-repository Adoption Kit packaging can be added as another profile without changing the one-package developer experience.
-
-## Package assembly and release
-
-The public source repository intentionally does not commit generated private-source snapshots. Prepare an auditable release candidate from clean exact canonical checkouts:
-
-```powershell
-Set-Location D:\Projects\lean-platform
-node .\scripts\prepare-release.mjs `
-  --core-root D:\Projects\lean-agentic-core `
-  --deployment-root D:\Projects\lean-poc-deployment-kit
-```
-
-Release preparation verifies exact `origin/main`, runs the complete test suite, refuses dirty canonical source checkouts, assembles and verifies the pinned assets, compares two independent `npm pack` SHA-256 values, and smoke-tests the packed CLI from a clean temporary install. The resulting tarball and `RELEASE_MANIFEST.json` are written under `dist/release/`.
-
-The first npm version is staged manually and requires explicit 2FA approval before it becomes public. After the bootstrap version exists, `.github/workflows/npm-stage.yml` can use npm Trusted Publishing (OIDC) to stage future versions without a long-lived npm publish token; human 2FA approval remains the final publication gate.
-
-See `docs/RELEASE_PROCESS.md` for the full release contract.
+# Lean Platform
+
+`@mriekki/lean` is the public consumer-facing distribution for Lean engineering assets.
+
+Canonical engineering remains in the private platform repositories. Before publication, a deterministic assembly step verifies exact pinned source commits and distribution descriptors, then copies only those approved consumer mappings into the npm payload. Each published npm release is therefore self-contained; consumers do not need access to the canonical repositories to install or update Lean assets.
+
+## Current `greenfield-poc` profile
+
+The current profile bundles:
+
+- Lean Agentic Core `1.11.0` from commit `5b2f13bb188f74fa0d7b6b8d7985fe3abfc543f9`, distribution `greenfield-workspace`;
+- Lean POC Deployment Kit commit `4c23140576b39608a3ef285cad4abe53dccb9c47`, distribution `greenfield-poc`.
+
+Core `1.11.0` adds the package-aware `/lean-update` workflow for `LEAN_BASELINE.json` consumers, keeps `/core-sync` as a compatibility/router path for component-only Core consumers, and aligns `/upstream-fix` and `/deploy` with the package and generated Deployment Kit boundaries.
+
+## Developer experience
+
+Preview/install:
+
+```powershell
+npx @mriekki/lean install
+```
+
+When run interactively, the command previews all managed changes and asks once before applying a safe plan. Automation can use `--apply` after reviewing the preview contract.
+
+Update using the newest published package:
+
+```powershell
+npx @mriekki/lean@latest update
+```
+
+For reviewed maintenance operations, prefer resolving and using one exact package version for preview, apply, and final check rather than allowing a moving `@latest` reference to change between those steps.
+
+Inspect or verify:
+
+```powershell
+npx @mriekki/lean@latest status
+npx @mriekki/lean@latest check
+```
+
+The umbrella package writes `LEAN_BASELINE.json` while preserving component-native `CORE_BASELINE.json` and `DEPLOYMENT_BASELINE.json` ledgers. Updates refuse managed drift/conflicts before modifying any component. Core retired paths require explicit ownership transfer with `--accept-retired core:<path>`; unchanged Deployment Kit retirements may be removed under its existing ownership contract.
+
+## Safety and ownership
+
+- npm is the distribution transport, not the canonical source of reusable behavior.
+- package releases pin exact accepted source commits.
+- install/update never require private GitHub access.
+- no install/update lifecycle hook mutates a consumer repository; changes occur only when the user invokes the Lean CLI.
+- one preflight plan covers all selected components; an unsafe component blocks the entire apply.
+- package publication is separate from merging this repository and requires an explicit release action.
+
+## Current scope
+
+The package currently starts with the `greenfield-poc` consumer profile. Existing-repository Adoption Kit packaging can be added as another profile without changing the one-package developer experience.
+
+## Package assembly and release
+
+The public source repository intentionally does not commit generated private-source snapshots. Prepare an auditable release candidate from clean exact canonical checkouts:
+
+```powershell
+Set-Location D:\Projects\lean-platform
+node .\scripts\prepare-release.mjs `
+  --core-root D:\Projects\lean-agentic-core `
+  --deployment-root D:\Projects\lean-poc-deployment-kit
+```
+
+Release preparation verifies exact `origin/main`, runs the complete test suite, refuses dirty canonical source checkouts, assembles and verifies the pinned assets, compares two independent `npm pack` SHA-256 values, and smoke-tests the packed CLI from a clean temporary install. The resulting tarball and `RELEASE_MANIFEST.json` are written under `dist/release/`.
+
+The first npm version was staged manually and required explicit 2FA approval before becoming public. Current releases use `.github/workflows/npm-stage.yml` with npm Trusted Publishing (OIDC) to stage future versions without a long-lived npm publish token; human 2FA approval remains the final publication gate.
+
+See `docs/RELEASE_PROCESS.md` for the full release contract.

package/assets/components.json

@@ -1,33 +1,33 @@
-{
-  "schemaVersion": 1,
-  "package": "@mriekki/lean",
-  "version": "0.1.0",
-  "defaultProfile": "greenfield-poc",
-  "profiles": {
-    "greenfield-poc": {
-      "components": [
-        "core",
-        "deployment"
-      ]
-    }
-  },
-  "components": {
-    "core": {
-      "repository": "mriekki/lean-agentic-core",
-      "commit": "e2d64b10f1a30507471755339c20e8b58e62be16",
-      "version": "1.10.0",
-      "distribution": "greenfield-workspace",
-      "descriptor": "assets/core/distribution.json",
-      "sourceRoot": "assets/generated/core",
-      "canonicalDescriptor": "distributions/greenfield-workspace.json"
-    },
-    "deployment": {
-      "repository": "mriekki/lean-poc-deployment-kit",
-      "commit": "4c23140576b39608a3ef285cad4abe53dccb9c47",
-      "distribution": "greenfield-poc",
-      "descriptor": "assets/deployment/distribution.json",
-      "sourceRoot": "assets/generated/deployment",
-      "canonicalDescriptor": "distributions/greenfield-poc.json"
-    }
-  }
-}
+{
+  "schemaVersion": 1,
+  "package": "@mriekki/lean",
+  "version": "0.2.0",
+  "defaultProfile": "greenfield-poc",
+  "profiles": {
+    "greenfield-poc": {
+      "components": [
+        "core",
+        "deployment"
+      ]
+    }
+  },
+  "components": {
+    "core": {
+      "repository": "mriekki/lean-agentic-core",
+      "commit": "5b2f13bb188f74fa0d7b6b8d7985fe3abfc543f9",
+      "version": "1.11.0",
+      "distribution": "greenfield-workspace",
+      "descriptor": "assets/core/distribution.json",
+      "sourceRoot": "assets/generated/core",
+      "canonicalDescriptor": "distributions/greenfield-workspace.json"
+    },
+    "deployment": {
+      "repository": "mriekki/lean-poc-deployment-kit",
+      "commit": "4c23140576b39608a3ef285cad4abe53dccb9c47",
+      "distribution": "greenfield-poc",
+      "descriptor": "assets/deployment/distribution.json",
+      "sourceRoot": "assets/generated/deployment",
+      "canonicalDescriptor": "distributions/greenfield-poc.json"
+    }
+  }
+}

package/assets/core/distribution.json

@@ -1,51 +1,52 @@
-{
-  "name": "greenfield-workspace",
-  "profileSource": "profiles/greenfield/lean-workspace.json",
-  "profileDestination": ".github/lean-workspace.json",
-  "mappings": [
-    {"source":"core/agents/reviewer.agent.md","destination":".github/agents/reviewer.agent.md"},
-    {"source":"core/agents/coach.agent.md","destination":".github/agents/coach.agent.md"},
-    {"source":"core/instructions/lean-workflow.instructions.md","destination":".github/instructions/lean-workflow.instructions.md"},
-    {"source":"core/instructions/lean-docs.instructions.md","destination":".github/instructions/lean-docs.instructions.md"},
-    {"source":"core/skills/define-feature/SKILL.md","destination":".github/skills/define-feature/SKILL.md"},
-    {"source":"core/skills/grill-me/SKILL.md","destination":".github/skills/grill-me/SKILL.md"},
-    {"source":"core/skills/grill-with-docs/SKILL.md","destination":".github/skills/grill-with-docs/SKILL.md"},
-    {"source":"core/skills/refine-requirements/SKILL.md","destination":".github/skills/refine-requirements/SKILL.md"},
-    {"source":"core/skills/start-work/SKILL.md","destination":".github/skills/start-work/SKILL.md"},
-    {"source":"core/skills/next-step/SKILL.md","destination":".github/skills/next-step/SKILL.md"},
-    {"source":"core/skills/deliver/SKILL.md","destination":".github/skills/deliver/SKILL.md"},
-    {"source":"core/skills/cleanup-branches/SKILL.md","destination":".github/skills/cleanup-branches/SKILL.md"},
-    {"source":"core/skills/pull-latest/SKILL.md","destination":".github/skills/pull-latest/SKILL.md"},
-    {"source":"core/skills/core-sync/SKILL.md","destination":".github/skills/core-sync/SKILL.md"},
-    {"source":"core/skills/upstream-fix/SKILL.md","destination":".github/skills/upstream-fix/SKILL.md"},
-    {"source":"core/skills/wait-what/SKILL.md","destination":".github/skills/wait-what/SKILL.md"},
-    {"source":"core/skills/production-readiness/SKILL.md","destination":".github/skills/production-readiness/SKILL.md"},
-    {"source":"core/skills/deploy/SKILL.md","destination":".github/skills/deploy/SKILL.md"},
-    {"source":"core/skills/tear-down/SKILL.md","destination":".github/skills/tear-down/SKILL.md"},
-    {"source":"core/skills/coach/SKILL.md","destination":".github/skills/coach/SKILL.md"},
-    {"source":"core/skills/code-walkthrough/SKILL.md","destination":".github/skills/code-walkthrough/SKILL.md"},
-    {"source":"core/skills/learning-review/SKILL.md","destination":".github/skills/learning-review/SKILL.md"},
-    {"source":"core/process/WORK_ITEM_MODEL.md","destination":"docs/process/WORK_ITEM_MODEL.md"},
-    {"source":"core/process/PR_WORKFLOW.md","destination":"docs/process/PR_WORKFLOW.md"},
-    {"source":"core/process/PRODUCTION_ENABLEMENT.md","destination":"docs/process/PRODUCTION_ENABLEMENT.md"},
-    {"source":"core/process/HUMAN_GATES.md","destination":"docs/process/HUMAN_IN_LOOP_GATES.md"},
-    {"source":"core/process/GUIDED_NEXT_STEPS.md","destination":"docs/process/GUIDED_NEXT_STEPS.md"},
-    {"source":"core/process/INTERACTIVE_SESSION_GUIDE.md","destination":"docs/process/INTERACTIVE_SESSION_GUIDE.md"},
-    {"source":"core/process/COACHING_GUIDE.md","destination":"docs/process/COACHING_GUIDE.md"},
-    {"source":"core/process/SETUP_ACCEPTANCE_CHECKLIST.md","destination":"docs/process/SETUP_ACCEPTANCE_CHECKLIST.md"},
-    {"source":"core/templates/PULL_REQUEST_TEMPLATE.md","destination":".github/PULL_REQUEST_TEMPLATE.md"},
-    {"source":"core/templates/PRODUCT_BRIEF_TEMPLATE.md","destination":"docs/templates/PRODUCT_BRIEF_TEMPLATE.md"},
-    {"source":"core/templates/FEATURE_BRIEF_TEMPLATE.md","destination":"docs/templates/FEATURE_BRIEF_TEMPLATE.md"},
-    {"source":"core/templates/REQUIREMENTS_TEMPLATE.md","destination":"docs/templates/REQUIREMENTS_TEMPLATE.md"},
-    {"source":"core/learning/ENGINEERING_LEARNING_WORKBOOK.md","destination":"learning/ENGINEERING_LEARNING_WORKBOOK.md"},
-    {"source":"core/learning/LEARNING_MAP.md","destination":"learning/LEARNING_MAP.md"},
-    {"source":"core/learning/LEARNING_PROGRESS.md","destination":"learning/LEARNING_PROGRESS.md"},
-    {"source":"core/learning/CODING_DRILLS.md","destination":"learning/CODING_DRILLS.md"},
-    {"source":"core/learning/SQL_DRILLS.md","destination":"learning/SQL_DRILLS.md"},
-    {"source":"core/learning/SYSTEM_DESIGN_DRILLS.md","destination":"learning/SYSTEM_DESIGN_DRILLS.md"},
-    {"source":"core/learning/DIAGRAM_GUIDE.md","destination":"learning/DIAGRAM_GUIDE.md"},
-    {"source":"core/learning/RESOURCE_CATALOG.md","destination":"learning/RESOURCE_CATALOG.md"},
-    {"source":"tools/package/check_baseline.py","destination":"tools/lean-core/check-core-baseline.py"},
-    {"source":"tools/package/check_upstream.py","destination":"tools/lean-core/check-core-upstream.py"}
-  ]
-}
+{
+  "name": "greenfield-workspace",
+  "profileSource": "profiles/greenfield/lean-workspace.json",
+  "profileDestination": ".github/lean-workspace.json",
+  "mappings": [
+    {"source":"core/agents/reviewer.agent.md","destination":".github/agents/reviewer.agent.md"},
+    {"source":"core/agents/coach.agent.md","destination":".github/agents/coach.agent.md"},
+    {"source":"core/instructions/lean-workflow.instructions.md","destination":".github/instructions/lean-workflow.instructions.md"},
+    {"source":"core/instructions/lean-docs.instructions.md","destination":".github/instructions/lean-docs.instructions.md"},
+    {"source":"core/skills/define-feature/SKILL.md","destination":".github/skills/define-feature/SKILL.md"},
+    {"source":"core/skills/grill-me/SKILL.md","destination":".github/skills/grill-me/SKILL.md"},
+    {"source":"core/skills/grill-with-docs/SKILL.md","destination":".github/skills/grill-with-docs/SKILL.md"},
+    {"source":"core/skills/refine-requirements/SKILL.md","destination":".github/skills/refine-requirements/SKILL.md"},
+    {"source":"core/skills/start-work/SKILL.md","destination":".github/skills/start-work/SKILL.md"},
+    {"source":"core/skills/next-step/SKILL.md","destination":".github/skills/next-step/SKILL.md"},
+    {"source":"core/skills/deliver/SKILL.md","destination":".github/skills/deliver/SKILL.md"},
+    {"source":"core/skills/cleanup-branches/SKILL.md","destination":".github/skills/cleanup-branches/SKILL.md"},
+    {"source":"core/skills/pull-latest/SKILL.md","destination":".github/skills/pull-latest/SKILL.md"},
+    {"source":"core/skills/lean-update/SKILL.md","destination":".github/skills/lean-update/SKILL.md"},
+    {"source":"core/skills/core-sync/SKILL.md","destination":".github/skills/core-sync/SKILL.md"},
+    {"source":"core/skills/upstream-fix/SKILL.md","destination":".github/skills/upstream-fix/SKILL.md"},
+    {"source":"core/skills/wait-what/SKILL.md","destination":".github/skills/wait-what/SKILL.md"},
+    {"source":"core/skills/production-readiness/SKILL.md","destination":".github/skills/production-readiness/SKILL.md"},
+    {"source":"core/skills/deploy/SKILL.md","destination":".github/skills/deploy/SKILL.md"},
+    {"source":"core/skills/tear-down/SKILL.md","destination":".github/skills/tear-down/SKILL.md"},
+    {"source":"core/skills/coach/SKILL.md","destination":".github/skills/coach/SKILL.md"},
+    {"source":"core/skills/code-walkthrough/SKILL.md","destination":".github/skills/code-walkthrough/SKILL.md"},
+    {"source":"core/skills/learning-review/SKILL.md","destination":".github/skills/learning-review/SKILL.md"},
+    {"source":"core/process/WORK_ITEM_MODEL.md","destination":"docs/process/WORK_ITEM_MODEL.md"},
+    {"source":"core/process/PR_WORKFLOW.md","destination":"docs/process/PR_WORKFLOW.md"},
+    {"source":"core/process/PRODUCTION_ENABLEMENT.md","destination":"docs/process/PRODUCTION_ENABLEMENT.md"},
+    {"source":"core/process/HUMAN_GATES.md","destination":"docs/process/HUMAN_IN_LOOP_GATES.md"},
+    {"source":"core/process/GUIDED_NEXT_STEPS.md","destination":"docs/process/GUIDED_NEXT_STEPS.md"},
+    {"source":"core/process/INTERACTIVE_SESSION_GUIDE.md","destination":"docs/process/INTERACTIVE_SESSION_GUIDE.md"},
+    {"source":"core/process/COACHING_GUIDE.md","destination":"docs/process/COACHING_GUIDE.md"},
+    {"source":"core/process/SETUP_ACCEPTANCE_CHECKLIST.md","destination":"docs/process/SETUP_ACCEPTANCE_CHECKLIST.md"},
+    {"source":"core/templates/PULL_REQUEST_TEMPLATE.md","destination":".github/PULL_REQUEST_TEMPLATE.md"},
+    {"source":"core/templates/PRODUCT_BRIEF_TEMPLATE.md","destination":"docs/templates/PRODUCT_BRIEF_TEMPLATE.md"},
+    {"source":"core/templates/FEATURE_BRIEF_TEMPLATE.md","destination":"docs/templates/FEATURE_BRIEF_TEMPLATE.md"},
+    {"source":"core/templates/REQUIREMENTS_TEMPLATE.md","destination":"docs/templates/REQUIREMENTS_TEMPLATE.md"},
+    {"source":"core/learning/ENGINEERING_LEARNING_WORKBOOK.md","destination":"learning/ENGINEERING_LEARNING_WORKBOOK.md"},
+    {"source":"core/learning/LEARNING_MAP.md","destination":"learning/LEARNING_MAP.md"},
+    {"source":"core/learning/LEARNING_PROGRESS.md","destination":"learning/LEARNING_PROGRESS.md"},
+    {"source":"core/learning/CODING_DRILLS.md","destination":"learning/CODING_DRILLS.md"},
+    {"source":"core/learning/SQL_DRILLS.md","destination":"learning/SQL_DRILLS.md"},
+    {"source":"core/learning/SYSTEM_DESIGN_DRILLS.md","destination":"learning/SYSTEM_DESIGN_DRILLS.md"},
+    {"source":"core/learning/DIAGRAM_GUIDE.md","destination":"learning/DIAGRAM_GUIDE.md"},
+    {"source":"core/learning/RESOURCE_CATALOG.md","destination":"learning/RESOURCE_CATALOG.md"},
+    {"source":"tools/package/check_baseline.py","destination":"tools/lean-core/check-core-baseline.py"},
+    {"source":"tools/package/check_upstream.py","destination":"tools/lean-core/check-core-upstream.py"}
+  ]
+}

package/assets/deployment/distribution.json

@@ -1,34 +1,34 @@
-{
-  "name": "greenfield-poc",
-  "schemaVersion": 1,
-  "description": "Reusable deployment tooling for generated disposable Lean POCs.",
-  "mappings": [
-    {"source": "distribution/lean-poc-deploy.py", "destination": "tools/lean-deployment/lean-poc-deploy.py"},
-    {"source": "src/lean_poc_deployment/__init__.py", "destination": "tools/lean-deployment/lean_poc_deployment/__init__.py"},
-    {"source": "src/lean_poc_deployment/__main__.py", "destination": "tools/lean-deployment/lean_poc_deployment/__main__.py"},
-    {"source": "src/lean_poc_deployment/app_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_cli.py"},
-    {"source": "src/lean_poc_deployment/app_runtime.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime.py"},
-    {"source": "src/lean_poc_deployment/app_runtime_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime_remote.py"},
-    {"source": "src/lean_poc_deployment/box_platform.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform.py"},
-    {"source": "src/lean_poc_deployment/box_platform_assets.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_assets.py"},
-    {"source": "src/lean_poc_deployment/box_platform_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_remote.py"},
-    {"source": "src/lean_poc_deployment/cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/cli.py"},
-    {"source": "src/lean_poc_deployment/doctor.py", "destination": "tools/lean-deployment/lean_poc_deployment/doctor.py"},
-    {"source": "src/lean_poc_deployment/entrypoint.py", "destination": "tools/lean-deployment/lean_poc_deployment/entrypoint.py"},
-    {"source": "src/lean_poc_deployment/errors.py", "destination": "tools/lean-deployment/lean_poc_deployment/errors.py"},
-    {"source": "src/lean_poc_deployment/keys.py", "destination": "tools/lean-deployment/lean_poc_deployment/keys.py"},
-    {"source": "src/lean_poc_deployment/profiles.py", "destination": "tools/lean-deployment/lean_poc_deployment/profiles.py"},
-    {"source": "src/lean_poc_deployment/teardown.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown.py"},
-    {"source": "src/lean_poc_deployment/teardown_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown_cli.py"},
-    {"source": "src/lean_poc_deployment/teardown_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown_remote.py"},
-    {"source": "src/lean_poc_deployment/route_registry.py", "destination": "tools/lean-deployment/lean_poc_deployment/route_registry.py"},
-    {"source": "src/lean_poc_deployment/route_registry_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/route_registry_remote.py"},
-    {"source": "src/lean_poc_deployment/security.py", "destination": "tools/lean-deployment/lean_poc_deployment/security.py"},
-    {"source": "src/lean_poc_deployment/sqlite_adapter.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter.py"},
-    {"source": "src/lean_poc_deployment/sqlite_adapter_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter_remote.py"},
-    {"source": "src/lean_poc_deployment/sqlite_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_cli.py"},
-    {"source": "src/lean_poc_deployment/sqlite_import_recovery.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_import_recovery.py"},
-    {"source": "src/lean_poc_deployment/ssh.py", "destination": "tools/lean-deployment/lean_poc_deployment/ssh.py"},
-    {"source": "src/lean_poc_deployment/trust.py", "destination": "tools/lean-deployment/lean_poc_deployment/trust.py"}
-  ]
-}
+{
+  "name": "greenfield-poc",
+  "schemaVersion": 1,
+  "description": "Reusable deployment tooling for generated disposable Lean POCs.",
+  "mappings": [
+    {"source": "distribution/lean-poc-deploy.py", "destination": "tools/lean-deployment/lean-poc-deploy.py"},
+    {"source": "src/lean_poc_deployment/__init__.py", "destination": "tools/lean-deployment/lean_poc_deployment/__init__.py"},
+    {"source": "src/lean_poc_deployment/__main__.py", "destination": "tools/lean-deployment/lean_poc_deployment/__main__.py"},
+    {"source": "src/lean_poc_deployment/app_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_cli.py"},
+    {"source": "src/lean_poc_deployment/app_runtime.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime.py"},
+    {"source": "src/lean_poc_deployment/app_runtime_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/app_runtime_remote.py"},
+    {"source": "src/lean_poc_deployment/box_platform.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform.py"},
+    {"source": "src/lean_poc_deployment/box_platform_assets.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_assets.py"},
+    {"source": "src/lean_poc_deployment/box_platform_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/box_platform_remote.py"},
+    {"source": "src/lean_poc_deployment/cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/cli.py"},
+    {"source": "src/lean_poc_deployment/doctor.py", "destination": "tools/lean-deployment/lean_poc_deployment/doctor.py"},
+    {"source": "src/lean_poc_deployment/entrypoint.py", "destination": "tools/lean-deployment/lean_poc_deployment/entrypoint.py"},
+    {"source": "src/lean_poc_deployment/errors.py", "destination": "tools/lean-deployment/lean_poc_deployment/errors.py"},
+    {"source": "src/lean_poc_deployment/keys.py", "destination": "tools/lean-deployment/lean_poc_deployment/keys.py"},
+    {"source": "src/lean_poc_deployment/profiles.py", "destination": "tools/lean-deployment/lean_poc_deployment/profiles.py"},
+    {"source": "src/lean_poc_deployment/teardown.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown.py"},
+    {"source": "src/lean_poc_deployment/teardown_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown_cli.py"},
+    {"source": "src/lean_poc_deployment/teardown_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/teardown_remote.py"},
+    {"source": "src/lean_poc_deployment/route_registry.py", "destination": "tools/lean-deployment/lean_poc_deployment/route_registry.py"},
+    {"source": "src/lean_poc_deployment/route_registry_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/route_registry_remote.py"},
+    {"source": "src/lean_poc_deployment/security.py", "destination": "tools/lean-deployment/lean_poc_deployment/security.py"},
+    {"source": "src/lean_poc_deployment/sqlite_adapter.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter.py"},
+    {"source": "src/lean_poc_deployment/sqlite_adapter_remote.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_adapter_remote.py"},
+    {"source": "src/lean_poc_deployment/sqlite_cli.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_cli.py"},
+    {"source": "src/lean_poc_deployment/sqlite_import_recovery.py", "destination": "tools/lean-deployment/lean_poc_deployment/sqlite_import_recovery.py"},
+    {"source": "src/lean_poc_deployment/ssh.py", "destination": "tools/lean-deployment/lean_poc_deployment/ssh.py"},
+    {"source": "src/lean_poc_deployment/trust.py", "destination": "tools/lean-deployment/lean_poc_deployment/trust.py"}
+  ]
+}