PR_26171_011 Game Journey recommended targets

Author: ToolboxAid

src/dev-runtime/persistence/tool-repositories/game-journey-mock-repository.js

@@ -243,6 +243,33 @@ export const GAME_JOURNEY_TOOL_OWNERSHIP_AREAS = Object.freeze([
   }),
 ]);
 
+export const GAME_JOURNEY_RECOMMENDED_TARGETS = Object.freeze([
+  Object.freeze({
+    key: "heroes",
+    label: "Heroes",
+    sectionName: "Objects",
+    suggestedCount: 1,
+  }),
+  Object.freeze({
+    key: "enemies",
+    label: "Enemies",
+    sectionName: "Objects",
+    suggestedCount: 3,
+  }),
+  Object.freeze({
+    key: "levels",
+    label: "Levels",
+    sectionName: "Worlds",
+    suggestedCount: 5,
+  }),
+  Object.freeze({
+    key: "audio",
+    label: "Audio",
+    sectionName: "Audio",
+    suggestedCount: 6,
+  }),
+]);
+
 function clone(value) {
   return JSON.parse(JSON.stringify(value));
 }

src/dev-runtime/server/local-api-router.mjs

@@ -68,6 +68,7 @@ import {
   GAME_JOURNEY_KEYS,
   GAME_JOURNEY_STATUS_BY_ID,
   GAME_JOURNEY_STATUSES,
+  GAME_JOURNEY_RECOMMENDED_TARGETS,
   GAME_JOURNEY_SUGGESTED_TOOLS,
   GAME_JOURNEY_TOOL_OWNERSHIP_AREAS,
   createGameJourneyMockRepository,
@@ -5115,6 +5116,7 @@ LIMIT 1;
         GAME_JOURNEY_KEYS,
         GAME_JOURNEY_STATUS_BY_ID,
         GAME_JOURNEY_STATUSES,
+        GAME_JOURNEY_RECOMMENDED_TARGETS,
         GAME_JOURNEY_SUGGESTED_TOOLS,
         GAME_JOURNEY_TOOL_OWNERSHIP_AREAS,
       };

tests/playwright/tools/GameJourneyTool.spec.mjs

@@ -7,6 +7,7 @@ import { clearPlaywrightStorage, installPlaywrightStorageIsolation } from "../..
 import { workspaceV2CoverageReporter } from "../../helpers/workspaceV2CoverageReporter.mjs";
 import {
   GAME_JOURNEY_KEYS,
+  GAME_JOURNEY_RECOMMENDED_TARGETS,
   GAME_JOURNEY_STATUS_BY_ID,
   GAME_JOURNEY_STATUSES,
   GAME_JOURNEY_TOOL_OWNERSHIP_AREAS,
@@ -195,11 +196,23 @@ async function expectFilteredSummaryRows(page, statusId, expectedRows) {
 
 test("Game Journey exposes static tool ownership areas without automatic counts", async () => {
   expectStaticToolOwnershipAreas(GAME_JOURNEY_TOOL_OWNERSHIP_AREAS);
+  expect(GAME_JOURNEY_RECOMMENDED_TARGETS.map((target) => target.label)).toEqual([
+    "Heroes",
+    "Enemies",
+    "Levels",
+    "Audio",
+  ]);
 
   const server = await startRepoServer();
   try {
     const constants = await fetchApiData(server, "/api/toolbox/game-journey/constants");
     expectStaticToolOwnershipAreas(constants.GAME_JOURNEY_TOOL_OWNERSHIP_AREAS);
+    expect(constants.GAME_JOURNEY_RECOMMENDED_TARGETS.map((target) => target.label)).toEqual([
+      "Heroes",
+      "Enemies",
+      "Levels",
+      "Audio",
+    ]);
   } finally {
     await server.close();
   }
@@ -269,6 +282,13 @@ test("Game Journey progress dashboard summarizes completion metrics", async ({ p
     await expect(page.locator("[data-journey-most-complete-areas] li").first()).toHaveText("Idea: 0% complete (0 of 4)");
     await expect(page.locator("[data-journey-least-complete-areas] li")).toHaveCount(3);
     await expect(page.locator("[data-journey-least-complete-areas] li").first()).toHaveText("Idea: 0% complete (0 of 4)");
+    await expect(page.locator("[data-journey-recommended-target]")).toHaveCount(4);
+    await expect(page.locator("[data-journey-recommended-target='heroes'] td").nth(0)).toHaveText("Heroes");
+    await expect(page.locator("[data-journey-recommended-target='heroes'] td").nth(1)).toHaveText("Objects");
+    await expect(page.locator("[data-journey-target-input='heroes']")).toHaveValue("1");
+    await page.locator("[data-journey-target-input='heroes']").fill("2");
+    await expect(page.locator("[data-journey-target-status]")).toHaveText("Heroes suggested target set to 2.");
+    await expect(page.locator("[data-journey-target-input='heroes']")).toHaveValue("2");
     await expect(page.locator("style, [style], script:not([src])")).toHaveCount(0);
 
     expect(failedRequests).toEqual([]);

toolbox/game-journey/game-journey-api-client.js

@@ -15,6 +15,7 @@ export const GAME_JOURNEY_STATUS_BY_ID = Object.freeze(requireServerConstant(con
 export const GAME_JOURNEY_STATUSES = Object.freeze(requireServerConstant(constants, "GAME_JOURNEY_STATUSES", "game-journey"));
 export const GAME_JOURNEY_SUGGESTED_TOOLS = Object.freeze(requireServerConstant(constants, "GAME_JOURNEY_SUGGESTED_TOOLS", "game-journey"));
 export const GAME_JOURNEY_TOOL_OWNERSHIP_AREAS = Object.freeze(requireServerConstant(constants, "GAME_JOURNEY_TOOL_OWNERSHIP_AREAS", "game-journey"));
+export const GAME_JOURNEY_RECOMMENDED_TARGETS = Object.freeze(requireServerConstant(constants, "GAME_JOURNEY_RECOMMENDED_TARGETS", "game-journey"));
 
 export function createGameJourneyApiRepository(options = {}) {
   return createServerRepositoryClient("game-journey", options);

toolbox/game-journey/game-journey.js

@@ -1,5 +1,6 @@
 import {
   GAME_JOURNEY_KEYS,
+  GAME_JOURNEY_RECOMMENDED_TARGETS,
   GAME_JOURNEY_STATUS_BY_ID,
   GAME_JOURNEY_STATUSES,
   GAME_JOURNEY_SUGGESTED_TOOLS,
@@ -51,6 +52,8 @@ const diagnostics = document.querySelector("[data-journey-diagnostics]");
 const searchInput = document.querySelector("[data-journey-search-input]");
 const searchStatus = document.querySelector("[data-journey-search-status]");
 const completionMetrics = document.querySelector("[data-journey-completion-metrics]");
+const recommendedTargets = document.querySelector("[data-journey-recommended-targets]");
+const recommendedTargetStatus = document.querySelector("[data-journey-target-status]");
 
 const statTargets = {
   open: document.querySelector("[data-journey-stat-open]"),
@@ -78,6 +81,9 @@ let summarySort = {
 };
 let completionMetricsSnapshot = null;
 let completionMetricsDiagnostic = "";
+const recommendedTargetValues = new Map(
+  GAME_JOURNEY_RECOMMENDED_TARGETS.map((target) => [target.key, target.suggestedCount]),
+);
 
 function refreshCompletionMetricsSnapshot() {
   try {
@@ -819,6 +825,58 @@ function renderCompletionMetrics() {
   completionMetrics.append(dashboard);
 }
 
+function normalizeTargetCount(value) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    return 0;
+  }
+  return Math.max(0, Math.trunc(parsed));
+}
+
+function renderRecommendedTargets() {
+  if (!recommendedTargets) {
+    return;
+  }
+  recommendedTargets.innerHTML = "";
+  if (!GAME_JOURNEY_RECOMMENDED_TARGETS.length) {
+    recommendedTargets.append(createElement("p", { text: "No recommended planning targets are available." }));
+    return;
+  }
+
+  const wrapper = createElement("div", { className: "table-wrapper" });
+  const table = createElement("table", { className: "data-table data-table--fixed" });
+  table.setAttribute("aria-label", "Game Journey recommended planning targets");
+  const head = createElement("thead");
+  const headRow = createElement("tr");
+  ["Target", "Section", "Suggested"].forEach((heading) => {
+    const cell = createElement("th", { text: heading });
+    cell.scope = "col";
+    headRow.append(cell);
+  });
+  head.append(headRow);
+  const body = createElement("tbody");
+  GAME_JOURNEY_RECOMMENDED_TARGETS.forEach((target) => {
+    const row = createElement("tr");
+    row.dataset.journeyRecommendedTarget = target.key;
+    const labelCell = createElement("td", { text: target.label });
+    const sectionCell = createElement("td", { text: target.sectionName });
+    const input = document.createElement("input");
+    input.type = "number";
+    input.min = "0";
+    input.step = "1";
+    input.value = String(recommendedTargetValues.get(target.key) ?? target.suggestedCount);
+    input.setAttribute("aria-label", `${target.label} suggested target`);
+    input.dataset.journeyTargetInput = target.key;
+    const inputCell = createElement("td");
+    inputCell.append(input);
+    row.append(labelCell, sectionCell, inputCell);
+    body.append(row);
+  });
+  table.append(head, body);
+  wrapper.append(table);
+  recommendedTargets.append(wrapper);
+}
+
 function renderSearchStatus(query, notes) {
   if (!searchStatus) {
     return;
@@ -1089,6 +1147,7 @@ function render() {
   renderStatScope(selectedStatsNote, notes);
   renderStats(statCounts);
   renderCompletionMetrics();
+  renderRecommendedTargets();
   renderSuggestedTools(displayNote);
   renderRecentActivity();
   renderDiagnostics(activeGame, displayNote, notes);
@@ -1256,6 +1315,23 @@ searchInput?.addEventListener("input", () => {
   render();
 });
 
+recommendedTargets?.addEventListener("input", (event) => {
+  const input = event.target.closest("[data-journey-target-input]");
+  if (!input) {
+    return;
+  }
+  const target = GAME_JOURNEY_RECOMMENDED_TARGETS.find((item) => item.key === input.dataset.journeyTargetInput);
+  if (!target) {
+    return;
+  }
+  const value = normalizeTargetCount(input.value);
+  recommendedTargetValues.set(target.key, value);
+  input.value = String(value);
+  if (recommendedTargetStatus) {
+    recommendedTargetStatus.textContent = `${target.label} suggested target set to ${value}.`;
+  }
+});
+
 addNoteButton.addEventListener("click", () => {
   if (redirectGuestWriteAction(noteStatus)) {
     return;

toolbox/game-journey/index.html

@@ -180,6 +180,13 @@ <h2>Journey Inspector</h2>
                                     <div class="content-stack content-stack--compact" data-journey-suggested-tools></div>
                                 </div>
                             </details>
+                            <details class="vertical-accordion" open>
+                                <summary>Recommended Targets</summary>
+                                <div class="accordion-body content-stack">
+                                    <div class="content-stack content-stack--compact" data-journey-recommended-targets></div>
+                                    <div class="status" role="status" data-journey-target-status>Suggested planning targets are ready to edit.</div>
+                                </div>
+                            </details>
                             <details class="vertical-accordion" open>
                                 <summary>Recent Activity</summary>
                                 <div class="accordion-body">