@mriekki/project-forge 4.11.1 → 4.11.2

package/assets/components.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "package": "@mriekki/project-forge",
-  "version": "4.11.1",
+  "version": "4.11.2",
   "defaultProfile": "greenfield-project",
   "profiles": {
     "greenfield-project": {
@@ -13,7 +13,7 @@
   },
   "components": {
     "core": {
-      "revision": "7a0c5a3ef42c0d6f38203007c957c3e59cbf4f8b",
+      "revision": "78a3fbe722ea277eaad4d2082d239cd7afd3d064",
       "version": "4.0.0",
       "distribution": "greenfield-workspace",
       "descriptor": "assets/core/distribution.json",

package/assets/generated/ASSEMBLY.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": 2,
   "package": "@mriekki/project-forge",
-  "version": "4.11.1",
+  "version": "4.11.2",
   "components": {
     "core": {
-      "revision": "7a0c5a3ef42c0d6f38203007c957c3e59cbf4f8b",
+      "revision": "78a3fbe722ea277eaad4d2082d239cd7afd3d064",
       "version": "4.0.0",
       "distribution": "greenfield-workspace",
       "files": [
@@ -51,7 +51,7 @@
         {
           "source": "core/skills/setup/SKILL.md",
           "destination": ".github/skills/setup/SKILL.md",
-          "sha256": "9b3dee1d965f1999490d0e3c58925c341ac5f3f5b228ccfe6a0ac53d64b19a64"
+          "sha256": "d1c6e7a0a04a1fb358b136ed8f83495c27bf8959ebd8941a3d42397fa4dcbaf1"
         },
         {
           "source": "core/skills/build/SKILL.md",
@@ -91,7 +91,7 @@
         {
           "source": "core/skills/work-item-status/SKILL.md",
           "destination": ".github/skills/work-item-status/SKILL.md",
-          "sha256": "7235ceebebc61519f2aa6c903ab8e814ba33cb029db4b7e5626852f935038c3c"
+          "sha256": "ca79843e59e5f50785c3621b6bf8ecb7413307aefce05fec737321589792c3a9"
         },
         {
           "source": "core/skills/cleanup-branches/SKILL.md",
@@ -221,7 +221,7 @@
         {
           "source": "core/process/SETUP_ACCEPTANCE_CHECKLIST.md",
           "destination": "docs/process/SETUP_ACCEPTANCE_CHECKLIST.md",
-          "sha256": "b5f8b39de15b464a1c80b26a6c150c6d2a363751abc05d33df4cebcad6b49d9b"
+          "sha256": "92174c10920f536c9912719a630e07e11c525fa2a7913d239bd097fb67f193a0"
         },
         {
           "source": "core/process/OPERATION_JOURNAL.md",

package/assets/generated/core/core/process/SETUP_ACCEPTANCE_CHECKLIST.md

@@ -31,10 +31,13 @@ After opening/reloading the intended editor workspace:
 - [ ] `Reviewer` is discoverable.
 - [ ] `Coach` is discoverable when the workspace includes coaching.
 - [ ] expected Project Forge skills are discoverable, including `/start-work`, `/deliver`, and `/wait-what` when included by the distribution/capability set.
+- [ ] when local `docs/work-items` folders exist, the Project Forge Work Item Status extension is installed/updated by setup and its Explorer decoration is available after any requested one-time VS Code reload; otherwise this check is not applicable.
 - [ ] path-specific instructions are present when the workspace declares them.
 - [ ] path-specific instructions are recognized/applied for matching files when the host supports them.
 - [ ] the human controls the routine model/tier; the workspace does not silently pin or upgrade it.
 
+The work-item Explorer decoration is an evidence-derived editor view, not a workflow authority. Its installation/readiness is reported separately from application runtime/build readiness.
+
 ## Copilot CLI + VS Code discovery
 
 When GitHub Copilot CLI is an intended execution surface:

package/assets/generated/core/core/skills/setup/SKILL.md

@@ -47,6 +47,7 @@ From the repository root inspect only what is needed:
 - `SCAFFOLD_PLAN.json` when present;
 - `.github/project-forge-workspace.json` and Project Forge/component baselines when present;
 - `scripts/setup.ps1` on Windows or `scripts/setup.sh` on macOS;
+- `tools/project-forge-vscode/work-item-status/install.py` and `docs/work-items` when present;
 - current Git branch/status/upstream evidence so setup does not overwrite unrelated work;
 - workstation-local setup/readiness evidence when present;
 - actual workstation OS/platform and machine-local identity needed to describe this workspace instance.
@@ -84,12 +85,13 @@ Prefer a compact result such as:
 ```text
 SETUP STATUS
 
-Workspace ......... READY / NOT CONFIGURED / BLOCKED
-Local runtime ..... READY / STALE / NOT APPLICABLE
-Build/tests ....... READY / STALE / BLOCKED
-Local data ........ READY / NOT APPLICABLE / BLOCKED
-Personal profile .. READY / DEFERRED / BLOCKED
-Remote capability . READY / PARTIAL / NOT CONFIGURED
+Workspace ........... READY / NOT CONFIGURED / BLOCKED
+Local runtime ....... READY / STALE / NOT APPLICABLE
+Build/tests ......... READY / STALE / BLOCKED
+Local data .......... READY / NOT APPLICABLE / BLOCKED
+Personal profile .... READY / DEFERRED / BLOCKED
+Work-item Explorer .. READY / NOT INSTALLED / NOT APPLICABLE / ERROR
+Remote capability ... READY / PARTIAL / NOT CONFIGURED
 
 NEXT
 /setup local | /setup remote | /setup <environment> | /next-step
@@ -126,6 +128,38 @@ A temporary process `PATH` adjustment may prove a diagnosis but does not by itse
 
 Stop before destructive replacement, unrelated machine mutation, secret disclosure, or repair outside the declared setup contract.
 
+### Work-item Explorer decoration
+
+When `tools/project-forge-vscode/work-item-status/install.py` exists, treat the Project Forge-owned VS Code work-item status extension as routine workstation setup when local `docs/work-items` folders are present.
+
+For `/setup status`, remain read-only. If `docs/work-items` exists, run:
+
+```text
+python tools/project-forge-vscode/work-item-status/install.py status --json
+```
+
+Report the returned state as the `Work-item Explorer` setup dimension. If `docs/work-items` does not exist, report `NOT APPLICABLE` and do not create a local work-item hierarchy merely to enable badges.
+
+For normal `/setup` and `/setup local`, when `docs/work-items` exists, run the bounded Project Forge installer:
+
+```text
+python tools/project-forge-vscode/work-item-status/install.py install --json
+```
+
+This installation is already authorized by `/setup` as routine workstation preparation; do not require a second `/work-item-status enable` confirmation. The installer may replace older versions of this same Project Forge extension only and must not install unrelated extensions, alter Project files, or change Git/GitHub state.
+
+If the result has `reloadRequired: true`, tell the developer to reload VS Code once after setup. Do not repeatedly reinstall an already-ready version merely because the editor has not yet been reloaded.
+
+If a Project has local `docs/work-items` but the package-managed installer is absent, report:
+
+```text
+PROJECT FORGE UPDATE NEEDED
+```
+
+Route to `/project-forge-update`; do not clone private Project Forge source repositories or download loose extension files as a workaround.
+
+A decorator installation error does not erase otherwise valid runtime/build readiness. Report the `Work-item Explorer` dimension as `ACTION NEEDED` or `ERROR`, preserve the other independent setup dimensions, and give the smallest repair/update action.
+
 ## 4. `/setup local` converges verified local development readiness
 
 The first success target is:
@@ -485,6 +519,7 @@ SETUP RESULT
 Local tools/runtime ......... VERIFIED / BLOCKED / NOT APPLICABLE
 Fresh-shell discovery ....... VERIFIED / CAVEAT / BLOCKED
 Build/tests ................. VERIFIED / BLOCKED / NOT RUN
+Work-item Explorer .......... READY / ACTION NEEDED / NOT APPLICABLE
 Remote target access ........ VERIFIED / BLOCKED / NOT CONFIGURED
 Host platform ............... READY / BLOCKED / NOT APPLICABLE
 Deployment path ............. PROVEN / NOT PROVEN / BLOCKED

package/assets/generated/core/core/skills/work-item-status/SKILL.md

@@ -10,6 +10,8 @@ disable-model-invocation: true
 
 Purpose: make local `docs/work-items/<ID>-...` folders easier to scan in VS Code without changing work-item paths, ticket content, or Project Forge workflow authority.
 
+Normal `/setup` owns automatic installation/update of this Project Forge extension when local `docs/work-items` folders are present. This command remains the focused read-only inspection and manual enable/disable surface.
+
 Normal use is read-only:
 
 ```text
@@ -72,6 +74,8 @@ python tools/project-forge-vscode/work-item-status/install.py status --json
 
 Also check whether `docs/work-items` exists. If the Project uses an external-only work-item source with no local work-item folders, report the Explorer decoration as not applicable rather than creating a competing local hierarchy.
 
+If local work-item folders are present but the package-managed installer is absent, route to `/project-forge-update`; do not clone Project Forge source repositories or download loose extension files as a workaround.
+
 A useful result is:
 
 ```text
@@ -84,7 +88,7 @@ Project workflow authority . UNCHANGED
 
 ## 4. Enable
 
-`/work-item-status enable` is explicit authorization for one bounded local editor change: install/update the Project Forge-owned extension in this developer's VS Code extensions directory.
+Outside `/setup`, `/work-item-status enable` is explicit authorization for one bounded local editor change: install/update the Project Forge-owned extension in this developer's VS Code extensions directory. Normal `/setup` and `/setup local` already authorize the same bounded install when local `docs/work-items` folders are present, so do not ask for a second confirmation in that flow.
 
 Run:
 
@@ -102,7 +106,7 @@ Project Forge: Refresh Work Item Status
 
 through the VS Code Command Palette.
 
-Failure to install this optional decoration does **not** make Project setup, implementation, review, delivery, or deployment unready.
+Failure to install this editor decoration does **not** make Project setup, implementation, review, delivery, or deployment unready. `/setup` reports the editor dimension separately as action-needed/error and gives the smallest repair/update action without erasing otherwise-valid application/runtime readiness.
 
 ## 5. Disable
 
@@ -124,4 +128,4 @@ Return:
 - a reminder that badges are evidence-derived and non-authoritative;
 - the smallest relevant next action.
 
-Do not turn this optional convenience into a required Project Forge gate.
+Do not turn this editor convenience into a source of Project workflow authority.

package/package.json

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