@mriekki/project-forge 2.1.0 → 3.0.0

package/assets/generated/core/core/skills/start-work/SKILL.md

@@ -111,16 +111,16 @@ Explain why the level was chosen.
 
 ## 4. Optional learning checkpoint
 
-For STANDARD/ELEVATED work, once requirements are ready, coaching may be offered but is never required:
+For STANDARD/ELEVATED work, once requirements are ready, coaching may be offered but is never required. When the human needs to choose, render a **single-select structured choice** through the host UI when available; in VS Code use the native question surface such as `vscode_askQuestions`.
 
-```text
-1. Continue without coaching — recommended default
-2. /coach for a short pre-build concept review
-3. /grill-me for challenge rather than teaching
-4. Stop
-```
+Relevant choices are:
 
-For LIGHT work, do not interrupt with coaching unless requested.
+- `Continue without coaching` — `RECOMMENDED` default
+- `/coach` for a short pre-build concept review
+- `/grill-me` for challenge rather than teaching
+- `Stop`
+
+Use a numbered text list only when structured choice UI is unavailable. For LIGHT work, do not interrupt with coaching unless requested.
 
 ## 5. Planning rules
 
@@ -185,6 +185,8 @@ Return:
 - requirement readiness,
 - branch state / expected short-lived branch when implementation is about to begin,
 - RECOMMENDED NEXT STEP,
-- a small numbered OPTIONS menu with action labels.
+- a small set of relevant action choices.
+
+Render mutually exclusive next actions through the host's **single-select structured choice UI** when available, following `INTERACTIVE_SESSION_GUIDE.md`. In VS Code, use the native question surface such as `vscode_askQuestions`. Make the recommended action visible when evidence supports one, include `Other / specify` or free-text only when the action set may be incomplete, and use a numbered text menu only as the no-structured-UI fallback.
 
 Do not skip an unresolved requirement/plan gate merely because implementation is technically possible. Once implementation is selected/approved, do not insert a separate ceremonial branch-creation gate when the branch setup is safe and deterministic.

package/assets/generated/core/core/skills/tear-down/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tear-down
-description: "Guided destructive cleanup for local state, one exact repository-defined named environment, or all explicitly configured POC environments. Preserves ownership boundaries and resolved Production-data authorization."
+description: "Guided destructive cleanup for local state, one exact repository-defined named environment, or all explicitly configured Project environments. Preserves ownership boundaries and resolved Production-data authorization."
 argument-hint: "[local|<environment>|all]"
 user-invocable: true
 disable-model-invocation: true
@@ -8,7 +8,7 @@ disable-model-invocation: true
 
 # Tear Down
 
-`/tear-down` is the human-facing destructive cleanup workflow for repository-owned POC state.
+`/tear-down` is the human-facing destructive cleanup workflow for repository-owned Project state.
 
 Logical environment names are data-driven and are not limited to Staging/Production:
 
@@ -47,7 +47,7 @@ all
 
 If no scope is named, present only scopes the repository actually supports; never silently default to a Production environment or `all`.
 
-`all` means only all explicitly configured scopes for this POC; it never means machine-wide cleanup.
+`all` means only all explicitly configured scopes for this Project; it never means machine-wide cleanup.
 
 Selecting scope does not authorize deletion. Physical colocation never merges ownership: deleting `demo` must not remove `staging` or `prod-east` merely because they share hardware.
 
@@ -99,7 +99,7 @@ Do not promise deletion of named/shared Docker volumes unless the installed dete
 Every modifying tear-down requires the installed normal authorization, conceptually:
 
 ```text
-[POC TEAR DOWN]
+[PROJECT TEAR DOWN]
 ```
 
 whenever **any selected environment is Production-class**, require the stronger Production-data deletion authorization, conceptually:

package/assets/generated/deployment/docs/DEVELOPER_ENVIRONMENTS.md

@@ -13,7 +13,7 @@ The happy path intentionally hides Bootstrap/package/control-plane plumbing. Dev
 The normal progression is:
 
 ```text
-generated POC repository
+generated Project repository
 → clone/open workspace
 → /setup
 → LOCAL READY
@@ -42,7 +42,7 @@ The normal conversational entry point is:
 
 `/setup` explains the current state/options and invokes the correct repository-local setup launcher. Direct script invocation remains the non-AI/automation fallback.
 
-The first local success target is `LOCAL WORKSPACE READY`. Remote access must not block it unless the POC explicitly requires a remote dependency for local development.
+The first local success target is `LOCAL WORKSPACE READY`. Remote access must not block it unless the Project explicitly requires a remote dependency for local development.
 
 ## Progress and next action
 
@@ -156,11 +156,11 @@ A changed previously pinned host key remains a blocker and requires explicit tru
 
 ## Docker and host preparation
 
-Docker is a workstation/target capability, not something every POC should reinstall.
+Docker is a workstation/target capability, not something every Project should reinstall.
 
 ### Developer workstation
 
-The first POC on a computer may install/verify required local tools and Docker through the generated setup contract. Later POCs reuse the ready workstation.
+The first Project on a computer may install/verify required local tools and Docker through the generated setup contract. Later Projects reuse the ready workstation.
 
 ### Remote Ubuntu target
 
@@ -209,17 +209,17 @@ A credential needed to acquire a private image is entered only through the local
 
 If the exact immutable image is already cached locally, registry authentication is not required merely to transfer it to the remote target.
 
-## POC environment model
+## Project environment model
 
-![POC environment model](images/poc-environment-model.svg)
+![Project environment model](images/project-environment-model.svg)
 
-The POC owns project-specific facts such as environment identities/roles, placement, target binding, application image, runtime/health contract, persistence, routes/exposure, and Production classification/authorization.
+The Project owns project-specific facts such as environment identities/roles, placement, target binding, application image, runtime/health contract, persistence, routes/exposure, and Production classification/authorization.
 
-The reusable workstation/target layer owns machine mechanics. A POC references targets; it does not own or duplicate a developer's private credentials.
+The reusable workstation/target layer owns machine mechanics. A Project references targets; it does not own or duplicate a developer's private credentials.
 
 ## New workstation
 
-A developer normally starts from any generated POC:
+A developer normally starts from any generated Project:
 
 ```text
 clone repository
@@ -233,7 +233,7 @@ When GitHub is reachable, personal profile sync supplies portable target definit
 
 ## New remote box
 
-Adding a new remote target is a workstation-driven onboarding operation, not a POC implementation step:
+Adding a new remote target is a workstation-driven onboarding operation, not a Project implementation step:
 
 ```text
 add/import portable target definition
@@ -243,7 +243,7 @@ add/import portable target definition
 → TARGET READY
 ```
 
-Once ready, multiple POCs can bind logical environments to that target without repeating host bootstrap.
+Once ready, multiple Projects can bind logical environments to that target without repeating host bootstrap.
 
 ## Portable export/import fallback
 

package/assets/generated/deployment/docs/ENVIRONMENT_PROOF.md

@@ -1,6 +1,6 @@
 # Environment Proof Deployment
 
-A Project Forge environment proof verifies that one developer workstation can exercise the real remote deployment path for one exact named logical environment before the POC application exists or before its first real deployment.
+A Project Forge environment proof verifies that one developer workstation can exercise the real remote deployment path for one exact named logical environment before the Project application exists or before its first real deployment.
 
 It is intentionally **not** the project application.
 
@@ -84,7 +84,7 @@ The proof attempts cleanup even when deployment raises after mutation begins.
 
 Successful completion requires terminal cleanup evidence (`removed` or already `absent`) for the reserved probe runtime. If deployment succeeds but cleanup cannot be verified, the command fails rather than reporting a clean proof.
 
-The probe must not delete another POC, another application, another logical environment, or shared host platform state.
+The probe must not delete another Project, another application, another logical environment, or shared host platform state.
 
 ## Relationship to `/setup` and `/deploy`
 

package/assets/generated/deployment/docs/WORKSPACE_INSTANCES.md

@@ -63,7 +63,7 @@ Local mutable application data is not synchronized between workstations by Proje
 
 ## Setup on another workstation
 
-The normal flow for an existing generated POC is:
+The normal flow for an existing generated Project is:
 
 ```text
 clone repository

package/assets/generated/deployment/docs/images/developer-environment-journey.svg

@@ -1,6 +1,6 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="520" viewBox="0 0 1200 520" role="img" aria-labelledby="title desc">
   <title id="title">Project Forge developer environment journey</title>
-  <desc id="desc">Generated POC repository progresses through clone and setup to local ready, then optionally to staging ready and production ready.</desc>
+  <desc id="desc">Generated Project repository progresses through clone and setup to local ready, then optionally to staging ready and production ready.</desc>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
       <stop offset="0" stop-color="#0b1220"/>
@@ -20,7 +20,7 @@
   <g filter="url(#shadow)" font-family="Inter,Segoe UI,Arial,sans-serif">
     <rect x="70" y="180" width="205" height="128" rx="18" fill="#1e2a40" stroke="#405274" stroke-width="2"/>
     <text x="172" y="222" text-anchor="middle" font-size="15" font-weight="700" fill="#91a4c4">PROJECT</text>
-    <text x="172" y="254" text-anchor="middle" font-size="22" font-weight="700" fill="#ffffff">Generated POC</text>
+    <text x="172" y="254" text-anchor="middle" font-size="22" font-weight="700" fill="#ffffff">Generated Project</text>
     <text x="172" y="282" text-anchor="middle" font-size="15" fill="#b8c5d8">clone + open workspace</text>
 
     <rect x="360" y="180" width="205" height="128" rx="18" fill="#1f3440" stroke="#3b7584" stroke-width="2"/>

package/assets/generated/deployment/docs/images/{poc-environment-model.svg → project-environment-model.svg}

@@ -1,6 +1,6 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1200" height="720" viewBox="0 0 1200 720" role="img" aria-labelledby="title desc">
   <title id="title">Project Forge environment model</title>
-  <desc id="desc">A POC uses local workstation runtime and optional remote logical staging and production environments bound to reusable remote targets and shared host platform infrastructure.</desc>
+  <desc id="desc">A Project uses local workstation runtime and optional remote logical staging and production environments bound to reusable remote targets and shared host platform infrastructure.</desc>
   <defs>
     <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
       <stop offset="0" stop-color="#0b1220"/>
@@ -14,12 +14,12 @@
     </marker>
   </defs>
   <rect width="1200" height="720" rx="24" fill="url(#bg)"/>
-  <text x="70" y="70" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="30" font-weight="700" fill="#f7f9fc">POC Environment Model</text>
-  <text x="70" y="102" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="17" fill="#aebbd0">The POC owns application/environment facts; reusable workstation and target layers own machine mechanics.</text>
+  <text x="70" y="70" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="30" font-weight="700" fill="#f7f9fc">Project Environment Model</text>
+  <text x="70" y="102" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="17" fill="#aebbd0">The Project owns application/environment facts; reusable workstation and target layers own machine mechanics.</text>
 
   <g filter="url(#shadow)" font-family="Inter,Segoe UI,Arial,sans-serif">
     <rect x="390" y="135" width="420" height="106" rx="20" fill="#25294a" stroke="#7277c9" stroke-width="2"/>
-    <text x="600" y="176" text-anchor="middle" font-size="15" font-weight="700" fill="#aaaef1">GENERATED POC</text>
+    <text x="600" y="176" text-anchor="middle" font-size="15" font-weight="700" fill="#aaaef1">GENERATED Project</text>
     <text x="600" y="209" text-anchor="middle" font-size="21" font-weight="700" fill="#ffffff">Environment bindings + app runtime facts</text>
 
     <rect x="95" y="330" width="300" height="190" rx="20" fill="#173c35" stroke="#3a9d82" stroke-width="2"/>

package/assets/generated/deployment/src/project_forge_deployment/cli.py

@@ -283,7 +283,7 @@ def build_parser() -> argparse.ArgumentParser:
     route_inventory_parser.add_argument("--json", action="store_true")
 
     route_register = route_sub.add_parser(
-        "register", help="Create or update one POC/environment-owned Caddy + mDNS route"
+        "register", help="Create or update one Project/environment-owned Caddy + mDNS route"
     )
     route_register.add_argument("name")
     route_register.add_argument("--owner-repo", required=True)

package/assets/generated/deployment/src/project_forge_deployment/entrypoint.py

@@ -33,5 +33,5 @@ def main(argv: list[str] | None = None) -> int:
         print("Command group: local  Loopback-only workstation application runtime")
         print("Command group: registry  Read-only exact-image registry access verification")
         print("Command group: sqlite  SQLite persistence import/backup/migration/rollback checks")
-        print("Command group: tear-down  Scoped destructive POC environment/local cleanup")
+        print("Command group: tear-down  Scoped destructive Project environment/local cleanup")
     return core_main(args)

package/assets/generated/deployment/src/project_forge_deployment/environment_probe.py

@@ -14,7 +14,7 @@ from .app_runtime_workstation import apply_app_deploy_from_workstation
 from .box_platform import platform_status
 from .errors import DeploymentKitError
 from .registry_access import normalize_registry_image
-from .teardown import tear_down_poc
+from .teardown import tear_down_project
 
 ENVIRONMENT_PROOF_WRITE_PHRASE = "[ENVIRONMENT PROOF WRITE]"
 PRODUCTION_ENVIRONMENT_PROOF_WRITE_PHRASE = "[PRODUCTION ENVIRONMENT PROOF]"
@@ -171,7 +171,7 @@ def run_environment_proof(plan: dict[str, Any]) -> dict[str, Any]:
         deploy_error = error
     finally:
         try:
-            cleanup = tear_down_poc(
+            cleanup = tear_down_project(
                 {
                     "ownerRepo": plan["ownerRepo"],
                     "appSlug": plan["probeAppSlug"],

package/assets/generated/deployment/src/project_forge_deployment/route_registry.py

@@ -270,7 +270,7 @@ def plan_route_registration(
         owner_fields = ("ownerRepo", "environment", "appSlug")
         if any(existing[field] != spec[field] for field in owner_fields):
             raise DeploymentKitError(
-                f"Route ID {spec['routeId']} is already owned by another POC/environment; refusing takeover."
+                f"Route ID {spec['routeId']} is already owned by another Project/environment; refusing takeover."
             )
     requested = set(spec["hostnames"])
     for route in inventory["managedRoutes"]:
@@ -312,7 +312,7 @@ def plan_route_removal(
     if existing is None:
         raise DeploymentKitError(f"Managed route does not exist: {route_id}")
     if existing["ownerRepo"] != owner_repo or existing["environment"] != environment or existing["appSlug"] != app_slug:
-        raise DeploymentKitError("Route removal ownership does not match the registered POC/environment.")
+        raise DeploymentKitError("Route removal ownership does not match the registered Project/environment.")
     return {
         "targetName": name,
         "action": "remove",

package/assets/generated/deployment/src/project_forge_deployment/teardown.py

@@ -15,7 +15,7 @@ from .route_registry import apply_route_change, plan_route_removal, route_invent
 from .ssh import ssh_args, verify_access
 from .teardown_remote import REMOTE_SCRIPT
 
-TEAR_DOWN_WRITE_PHRASE = "[POC TEAR DOWN]"
+TEAR_DOWN_WRITE_PHRASE = "[PROJECT TEAR DOWN]"
 PRODUCTION_DATA_DELETE_PHRASE = "[PRODUCTION DATA DELETE]"
 RESERVED_SCOPES = ("local", "all")
 
@@ -167,13 +167,13 @@ def _tear_down_remote_environment(
     stderr = completed.stderr.decode("utf-8", errors="replace").strip()
     if completed.returncode != 0:
         raise DeploymentKitError(
-            "Remote POC tear-down failed: " + (stderr or stdout or f"exit {completed.returncode}")
+            "Remote Project tear-down failed: " + (stderr or stdout or f"exit {completed.returncode}")
         )
     parts = stdout.split("\t")
     if len(parts) not in {4, 5} or parts[0] != "TEAR_DOWN" or parts[1] not in {"absent", "removed"}:
-        raise DeploymentKitError("Remote POC tear-down returned malformed evidence.")
+        raise DeploymentKitError("Remote Project tear-down returned malformed evidence.")
     if parts[2] != app_slug or parts[3] != environment:
-        raise DeploymentKitError("Remote POC tear-down returned mismatched app/environment evidence.")
+        raise DeploymentKitError("Remote Project tear-down returned mismatched app/environment evidence.")
     result: dict[str, Any] = {"state": parts[1], "mutated": parts[1] == "removed"}
     if len(parts) == 5:
         result["containerName"] = parts[4]
@@ -219,7 +219,7 @@ def tear_down_workstation_package(package: str) -> dict[str, Any]:
         removed = _run_local([docker, "rm", "-f", "-v", *containers])
         if removed.returncode != 0:
             raise DeploymentKitError(
-                "Local POC container removal failed: " + (removed.stderr or removed.stdout).strip()
+                "Local Project container removal failed: " + (removed.stderr or removed.stdout).strip()
             )
 
     images_result = _run_local([docker, "images", "--format", "{{.Repository}}:{{.Tag}}"])
@@ -238,7 +238,7 @@ def tear_down_workstation_package(package: str) -> dict[str, Any]:
         removed = _run_local([docker, "image", "rm", "-f", *image_refs])
         if removed.returncode != 0:
             raise DeploymentKitError(
-                "Local POC image removal failed: " + (removed.stderr or removed.stdout).strip()
+                "Local Project image removal failed: " + (removed.stderr or removed.stdout).strip()
             )
     return {
         "state": "removed" if containers or image_refs else "absent",
@@ -248,7 +248,7 @@ def tear_down_workstation_package(package: str) -> dict[str, Any]:
     }
 
 
-def tear_down_poc(spec: dict[str, Any]) -> dict[str, Any]:
+def tear_down_project(spec: dict[str, Any]) -> dict[str, Any]:
     normalized = normalize_teardown_spec(
         owner_repo=spec.get("ownerRepo"),
         app_slug=spec.get("appSlug"),

package/assets/generated/deployment/src/project_forge_deployment/teardown_cli.py

@@ -1,4 +1,4 @@
-"""CLI for scoped destructive POC tear-down."""
+"""CLI for scoped destructive Project tear-down."""
 
 from __future__ import annotations
 
@@ -12,7 +12,7 @@ from .teardown import (
     normalize_teardown_spec,
     parse_environment_targets,
     render_teardown_summary,
-    tear_down_poc,
+    tear_down_project,
 )
 
 
@@ -83,7 +83,7 @@ def _preview(spec: dict[str, object]) -> dict[str, object]:
         "deletesPersistentData": bool(spec["environmentTargets"]),
         "deletesProductionData": production,
         "preservesSharedPlatform": True,
-        "preservesUnrelatedPocs": True,
+        "preservesUnrelatedProjects": True,
         "deletesGhcrPackage": False,
         "requiredAuthorization": TEAR_DOWN_WRITE_PHRASE,
         "requiredProductionDataAuthorization": PRODUCTION_DATA_DELETE_PHRASE if production else None,
@@ -111,7 +111,7 @@ def main(argv: list[str] | None = None) -> int:
             and args.production_data_authorization != PRODUCTION_DATA_DELETE_PHRASE
         )
         if missing_general or missing_production:
-            print("POC TEAR-DOWN PREVIEW")
+            print("PROJECT TEAR-DOWN PREVIEW")
             print(render_teardown_summary(preview))
             if missing_general:
                 print(
@@ -126,8 +126,8 @@ def main(argv: list[str] | None = None) -> int:
                 )
             return 2
 
-        result = tear_down_poc(spec)
-        print("POC TEAR-DOWN COMPLETE")
+        result = tear_down_project(spec)
+        print("PROJECT TEAR-DOWN COMPLETE")
         print(render_teardown_summary(result))
         return 0
     except DeploymentKitError as exc:

package/assets/generated/deployment/src/project_forge_deployment/teardown_remote.py

@@ -1,4 +1,4 @@
-"""Remote destructive tear-down for one Kit-managed POC environment."""
+"""Remote destructive tear-down for one Kit-managed Project environment."""
 
 REMOTE_SCRIPT = r'''#!/usr/bin/env bash
 set -Eeuo pipefail
@@ -37,7 +37,7 @@ if [[ ! -e "$ROOT" ]]; then
 fi
 
 [[ -d "$ROOT" && ! -L "$ROOT" ]] || {
-    echo "POC environment root is not a safe managed directory: $ROOT" >&2
+    echo "Project environment root is not a safe managed directory: $ROOT" >&2
     exit 21
 }
 
@@ -46,16 +46,16 @@ HAS_PERSISTENCE=false
 [[ -f "$STATE" && ! -L "$STATE" ]] && HAS_STATE=true
 [[ -f "$PERSISTENCE" && ! -L "$PERSISTENCE" ]] && HAS_PERSISTENCE=true
 [[ "$HAS_STATE" == true || "$HAS_PERSISTENCE" == true ]] || {
-    echo "POC environment root has no managed ownership marker: $ROOT" >&2
+    echo "Project environment root has no managed ownership marker: $ROOT" >&2
     exit 21
 }
 
 if [[ "$HAS_STATE" == true ]] && ! assert_owned_marker "$STATE"; then
-    echo "POC deployment ownership mismatch for $ROOT" >&2
+    echo "Project deployment ownership mismatch for $ROOT" >&2
     exit 22
 fi
 if [[ "$HAS_PERSISTENCE" == true ]] && ! assert_owned_marker "$PERSISTENCE"; then
-    echo "POC persistence ownership mismatch for $ROOT" >&2
+    echo "Project persistence ownership mismatch for $ROOT" >&2
     exit 22
 fi
 
@@ -87,7 +87,7 @@ if [[ "$HAS_STATE" == true ]]; then
     fi
 fi
 
-# The verified environment root is owned by this POC/environment. Tear-down
+# The verified environment root is owned by this Project/environment. Tear-down
 # removes releases, evidence, persistent data, and backups together.
 rm -rf --one-file-system -- "$ROOT"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mriekki/project-forge",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Public consumer distribution and updater for Project Forge engineering assets.",
   "type": "module",
   "bin": {