@auraindustry/aurajs 0.1.3 → 0.1.5

package/src/scaffold/project-docs.mjs

@@ -1,3 +1,5 @@
+import { describeProjectAiGuidance } from '../ai-guidance.mjs';
+
 export function renderProjectReadme({ name, projectTitle, template, templateMetadata }) {
   if (templateMetadata?.runtimeFamily === 'retro') {
     return renderRetroProjectReadme({ name, projectTitle, template, templateMetadata });
@@ -7,6 +9,7 @@ export function renderProjectReadme({ name, projectTitle, template, templateMeta
   const workflowSection = renderTemplateWorkflowSection(templateMetadata);
   const projectMap = renderProjectMapSection(template);
   const generateFilesSection = renderGenerateFilesSection(template);
+  const aiWorkflowSection = renderAiWorkflowSection(template);
   const stateOwnershipSection = renderStateOwnershipSection();
   const continuityOwnershipSection = renderContinuityOwnershipSection();
   const largeAssetSection = renderLargeAssetSection();
@@ -46,6 +49,7 @@ before the first \`auramaxx publish\`.
 
 ${largeAssetSection}
 ${workflowSection}
+${aiWorkflowSection}
 ${generateFilesSection}
 ${stateOwnershipSection}
 ${continuityOwnershipSection}
@@ -77,6 +81,7 @@ export function renderProjectRunbook({ projectTitle, template, templateMetadata
   const workflowSection = renderTemplateWorkflowSection(templateMetadata);
   const firstThirtyMinutes = renderFirstThirtyMinutesSteps(template);
   const generateFilesSection = renderGenerateFilesSection(template);
+  const aiWorkflowSection = renderAiWorkflowSection(template);
   const stateOwnershipSection = renderStateOwnershipSection();
   const continuityOwnershipSection = renderContinuityOwnershipSection();
   const largeAssetSection = renderLargeAssetSection();
@@ -93,6 +98,7 @@ ${stateOwnershipSection}
 ${continuityOwnershipSection}
 
 ${workflowSection}
+${aiWorkflowSection}
 ${generateFilesSection}
 
 ## First-Hour Implementation Pass
@@ -131,6 +137,36 @@ ${steps.map((line) => `1. ${line}`).join('\n')}
 `;
 }
 
+function renderAiWorkflowSection(template) {
+  const aiGuidance = describeProjectAiGuidance({
+    template,
+    starterUtils: template === 'blank'
+      ? null
+      : {
+        available: true,
+        recommendedImportPath: './src/starter-utils/index.js',
+      },
+  });
+
+  const importHint = aiGuidance.recommendedImportPath || aiGuidance.preferredPackageSpecifier || '(none)';
+  const modules = Array.isArray(aiGuidance.recommendedModules) && aiGuidance.recommendedModules.length > 0
+    ? aiGuidance.recommendedModules.map((entry) => `- \`${entry.id}\` via \`${importHint}\``).join('\n')
+    : '- no starter helper lane is preselected; build outward from `src/runtime/`, `scenes/`, and `content/`';
+
+  return `## AI Workflow
+
+- run \`auramaxx explain --json\` before moving files so the current source boundary, starter helper lane, and paved-road guidance stay explicit
+- run \`auramaxx check --json\` after edits when you want machine-readable import and registry validation
+- keep authored gameplay code inside \`src/\`, \`scenes/\`, \`ui/\`, \`prefabs/\`, \`config/\`, and \`content/\`
+- preferred helper import: \`${importHint}\`
+- AI paved road lane: \`${aiGuidance.laneId}\`
+
+Recommended starter modules:
+
+${modules}
+`;
+}
+
 function renderRetroProjectReadme({ name, projectTitle, template, templateMetadata }) {
   const controls = templateMetadata.controls.map((line) => `- ${line}`).join('\n');
   const firstEdits = templateMetadata.firstEdits.map((line) => `1. ${line}`).join('\n');
@@ -352,7 +388,13 @@ export function renderProjectMapSection(template) {
 - \`config/\` - editable defaults and tuning payloads.
 - \`content/\` - authored definitions, levels, registries, and progression content.
 - \`content/registries/\` - starter-owned registry files for cards, enemies, relics, and encounters.
-- \`src/starter-utils/\` - reusable helpers copied for non-blank templates.
+- \`src/starter-utils/\` - local copies of reusable authored helper modules
+  shipped with AuraJS for non-blank templates. Keep imports local here for
+  starter-facing gameplay code; use the published
+  \`@auraindustry/aurajs/helpers\` lane only when you want the shared
+  package-backed helper surface directly. Run \`auramaxx vendor helpers\` when
+  you want to seed or resync the local helper lane in a project that does not
+  already have it.
 - \`assets/starter/\` - starter asset pack and editable design payloads.
 - \`aura.config.json\` - identity/window/build/modules.
 - \`aura.capabilities.json\` - canonical runtime API declaration for this scaffold.

package/src/scaffold.mjs

@@ -7,6 +7,7 @@ import {
   CREATE_TEMPLATE_DIRS,
   GITIGNORE_TEMPLATE,
   LEGACY_STARTER_TEMPLATE_DIR,
+  PACKAGED_STARTER_UTILS_DIR,
   PLAY_BIN_TEMPLATE,
   applyTemplateConfigOverrides,
   buildCapabilitiesDeclaration,
@@ -106,6 +107,9 @@ export function scaffoldGame(options) {
   copyTree(templateDir, dest, replacements);
   if (shouldCopyCreateSharedTemplate(normalizedTemplate, templateMetadata) && existsSync(CREATE_SHARED_TEMPLATE_DIR)) {
     copyTree(CREATE_SHARED_TEMPLATE_DIR, dest, replacements);
+    if (existsSync(PACKAGED_STARTER_UTILS_DIR)) {
+      copyTree(PACKAGED_STARTER_UTILS_DIR, join(dest, 'src', 'starter-utils'), replacements);
+    }
   }
 
   mkdirSync(join(dest, 'assets'), { recursive: true });

package/src/session-runtime.mjs

@@ -74,8 +74,10 @@ export async function bootSessionRuntime(options = {}) {
   });
 
   const testState = createSessionTestState();
-  const aura = createHeadlessAura({ width, height, testState });
-  const context = vm.createContext(createRuntimeContext(aura, testState));
+  const aura = createHeadlessAura({ width, height, testState, projectRoot });
+  const context = vm.createContext(createRuntimeContext(aura, testState, {
+    math: options.math,
+  }));
 
   const source = readFileSync(bundle.outFile, 'utf8');
   const script = new vm.Script(source, {
@@ -318,4 +320,3 @@ export async function exportSessionInspect(runtime, options = {}) {
     };
   }
 }
-

package/src/web-conformance.mjs

@@ -16,15 +16,6 @@ export const DEFAULT_WEB_SMOKE_CASES = Object.freeze([
     testName: 'web loader installs browser-backed aura surface for 2d examples',
     examples: [],
   }),
-  Object.freeze({
-    id: 'web-supported-render-2d-proof-example',
-    bucket: 'supported',
-    expectation: 'supported',
-    title: 'web-render-2d-proof runs on the committed advanced draw2d browser floor',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: web-render-2d-proof runs on the committed advanced draw2d browser floor',
-    examples: ['examples/web-render-2d-proof'],
-  }),
   Object.freeze({
     id: 'web-partial-auramon-example',
     bucket: 'partial',
@@ -34,33 +25,6 @@ export const DEFAULT_WEB_SMOKE_CASES = Object.freeze([
     testName: 'web loader browser smoke: auramon runs on the supported 2d subset with input and resize evidence',
     examples: ['examples/auramon'],
   }),
-  Object.freeze({
-    id: 'web-supported-starter-3d-example',
-    bucket: 'supported',
-    expectation: 'supported',
-    title: 'starter-3d runs on the committed browser 3d floor',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: starter-3d runs on the committed browser 3d floor',
-    examples: ['examples/starter-3d'],
-  }),
-  Object.freeze({
-    id: 'web-unsupported-multiplayer-examples',
-    bucket: 'unsupported',
-    expectation: 'unsupported',
-    title: 'multiplayer examples fail before setup with stable capability diagnostics',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: multiplayer examples fail before setup with stable capability diagnostics',
-    examples: ['examples/multiplayer-room-client', 'examples/multiplayer-room-host'],
-  }),
-  Object.freeze({
-    id: 'web-unsupported-advanced-3d-example',
-    bucket: 'unsupported',
-    expectation: 'unsupported',
-    title: 'advanced 3d examples outside the committed browser floor fail before setup with stable capability diagnostics',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: advanced 3d examples still fail before setup with stable capability diagnostics',
-    examples: ['examples/custom-shader-material-proof'],
-  }),
 ]);
 
 export class WebConformanceSuiteError extends Error {

package/templates/create/2d-adventure/config/gameplay/adventure.config.js

@@ -1,14 +1,17 @@
 export const ADVENTURE_CONFIG = {
   playerSize: 28,
-  playerSpeed: 232,
-  relicRadius: 20,
-  beaconRadius: 42,
-  exitPadding: 18,
+  playerSpeed: 216,
+  pickupSize: 28,
+  checkpointSize: 48,
+  gateGlowSize: 96,
 };
 
 export const ADVENTURE_TEXT = {
   started: '{{PROJECT_TITLE}} started (2D adventure template)',
-  controls: 'Move: Arrows/WASD  Interact: E or Enter  Hint: H',
-  clearedTitle: 'RUINS SURVEY COMPLETE',
+  controls: 'Move: Arrows/WASD  Interact: E or Enter  Inventory: I or Tab  Journal: J  Hint: H',
+  inventoryControls: 'Inventory: A/D or Left/Right tabs  W/S or Up/Down items  I or Tab closes',
+  journalControls: 'Journal: A/D or Left/Right sections  W/S or Up/Down entries  J closes',
+  dialogueControls: 'Dialogue: W/S or Up/Down choices  E, Enter, or Space confirms',
+  clearedTitle: 'ARCHIVE ROUTE SECURED',
   clearedPrompt: 'Press Enter to restart the route',
 };

package/templates/create/2d-adventure/content/gameplay/dialogue.js

@@ -0,0 +1,85 @@
+export const ARCHIVE_CONSOLE_DIALOGUE_ID = 'archive-console-link';
+
+export const JOURNAL_ENTRY_IDS = Object.freeze({
+  routeBrief: 'route-brief',
+  consoleLog: 'archive-console-log',
+  moonGate: 'moon-gate-route',
+});
+
+export const JOURNAL_CATEGORIES = [
+  { id: 'route', label: 'Route' },
+  { id: 'intel', label: 'Archive Intel' },
+];
+
+export const STARTING_JOURNAL_ENTRIES = [
+  {
+    id: JOURNAL_ENTRY_IDS.routeBrief,
+    label: 'Route Brief',
+    categoryId: 'route',
+    categoryLabel: 'Route',
+    description: 'Sweep the Moon Archive, recover the route note, then reopen the Moon Gate.',
+    detail: 'The archive console should reveal the final route once the relic anchors are back online.',
+    status: 'active',
+    badge: 'Active',
+    updatedAt: 'Initial route objective',
+  },
+];
+
+export const ADVENTURE_DIALOGUES = [
+  {
+    id: ARCHIVE_CONSOLE_DIALOGUE_ID,
+    title: 'Archive Console Link',
+    speaker: 'Archivist Sol',
+    startNodeId: 'handshake',
+    nodes: [
+      {
+        id: 'handshake',
+        lines: [
+          'Moon Archive relay restored. I can mark the exit route once you choose what to review.',
+        ],
+        nextNodeId: 'prompt',
+      },
+      {
+        id: 'prompt',
+        lines: [
+          'Ask for the route or confirm what still blocks the gate.',
+        ],
+        choices: [
+          {
+            id: 'ask-route',
+            label: 'Ask for the route',
+            detail: 'Request the marked path through the lower gallery.',
+            nextNodeId: 'route',
+          },
+          {
+            id: 'ask-key',
+            label: 'Ask about the Dawn Key',
+            detail: 'Confirm what the Moon Gate still needs.',
+            nextNodeId: 'key',
+          },
+        ],
+      },
+      {
+        id: 'route',
+        lines: [
+          'The final route runs south, then doubles back to the Moon Gate once the key is recovered.',
+        ],
+        nextNodeId: 'briefing',
+      },
+      {
+        id: 'key',
+        lines: [
+          'The Moon Gate still listens for the Dawn Key. Recover it from the south gallery and the route will hold.',
+        ],
+        nextNodeId: 'briefing',
+      },
+      {
+        id: 'briefing',
+        lines: [
+          'Route note transmitted. Check your journal and carry the Dawn Key back to the gate.',
+        ],
+        outcomeId: 'route-briefed',
+      },
+    ],
+  },
+];

package/templates/create/2d-adventure/content/gameplay/world.js

@@ -1,46 +1,42 @@
-export const WORLD_BOUNDS = { x: 72, y: 72, width: 1136, height: 576 };
+import WORLD_TILEMAP_SOURCE from './world.tilemap.json' with { type: 'json' };
 
-export const PLAYER_SPAWN = { x: 156, y: 584 };
+export const WORLD_ORIGIN = { x: 128, y: 72 };
 
-export const WORLD_OBSTACLES = [
-  { id: 'fallen-arch', x: 312, y: 236, w: 220, h: 40 },
-  { id: 'mirror-pool', x: 694, y: 172, w: 164, h: 104 },
-  { id: 'collapsed-hall', x: 530, y: 422, w: 268, h: 42 },
-];
+export const WORLD_TILEMAP = WORLD_TILEMAP_SOURCE;
+
+export const WORLD_OBJECT_LAYERS = Object.freeze({
+  markers: 'markers',
+  pickups: 'pickups',
+  checkpoints: 'checkpoints',
+  props: 'props',
+  locks: 'locks',
+  scenery: 'scenery',
+});
 
-export const RELIC_SPAWNS = [
-  { id: 'survey-lens', label: 'Survey Lens', x: 214, y: 190, radius: 20 },
-  { id: 'signal-reel', label: 'Signal Reel', x: 546, y: 152, radius: 20 },
-  { id: 'chorus-map', label: 'Chorus Map', x: 930, y: 352, radius: 20 },
-  { id: 'dawn-key', label: 'Dawn Key', x: 792, y: 548, radius: 20 },
+export const INVENTORY_CATEGORIES = [
+  { id: 'relics', label: 'Relics' },
+  { id: 'keys', label: 'Access Keys' },
+  { id: 'field', label: 'Field Notes' },
 ];
 
-export const BEACON_SITES = [
-  {
-    id: 'north-brazier',
-    label: 'North Brazier',
-    x: 246,
-    y: 150,
-    size: 34,
-    radius: 42,
-    requiredRelics: 1,
-  },
+export const STARTING_INVENTORY_ITEMS = [
   {
-    id: 'east-brazier',
-    label: 'East Brazier',
-    x: 1034,
-    y: 276,
-    size: 34,
-    radius: 42,
-    requiredRelics: 3,
+    id: 'route-brief',
+    label: 'Route Brief',
+    categoryId: 'field',
+    categoryLabel: 'Field Notes',
+    quantity: 1,
+    badge: 'BRIEF',
+    description: 'Survey the Moon Archive and restore the exit route.',
+    detail: 'Recover three relics, inspect the archive console, then use the Dawn Key on the Moon Gate.',
   },
 ];
 
-export const EXIT_GATE = {
-  id: 'moon-gate',
-  label: 'Moon Gate',
-  x: 1028,
-  y: 526,
-  w: 118,
-  h: 88,
+export const WORLD_TEXT = {
+  zoneLabel: 'Moon Archive',
+  objective: 'Recover the relics, inspect the archive console, and leave through the Moon Gate.',
+  inventoryHint: 'Inventory stays on the HUD while the journal and dialogue proof move through the overlay screen lane.',
+  journalHint: 'Journal tracks route progress and archive intel through one shared starter-owned log surface.',
+  consoleNoteTitle: 'Archive Console Log',
+  consoleNoteDetail: 'The route seal listens for the Dawn Key. The relic anchors simply restore power to the archive floor.',
 };

package/templates/create/2d-adventure/content/gameplay/world.tilemap.json

@@ -0,0 +1,273 @@
+{
+  "width": 16,
+  "height": 9,
+  "tilewidth": 64,
+  "tileheight": 64,
+  "solidLayerNames": [
+    "collision"
+  ],
+  "layers": [
+    {
+      "name": "ground",
+      "type": "tilelayer",
+      "width": 16,
+      "height": 9,
+      "data": [
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+      ]
+    },
+    {
+      "name": "collision",
+      "type": "tilelayer",
+      "width": 16,
+      "height": 9,
+      "data": [
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1,
+        1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1,
+        1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0, 1, 0, 1,
+        1, 0, 1, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 1,
+        1, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 1, 0, 1,
+        1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 1,
+        1, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+      ]
+    },
+    {
+      "name": "markers",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 1,
+          "name": "player-start",
+          "type": "spawn",
+          "x": 128,
+          "y": 128,
+          "point": true
+        },
+        {
+          "id": 2,
+          "name": "camp-west",
+          "type": "spawn",
+          "x": 320,
+          "y": 448,
+          "point": true
+        }
+      ]
+    },
+    {
+      "name": "pickups",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 101,
+          "name": "Survey Lens",
+          "type": "pickup",
+          "x": 168,
+          "y": 168,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to secure the Survey Lens",
+            "grantItemId": "survey-lens",
+            "grantCategoryId": "relics",
+            "grantCategoryLabel": "Relics",
+            "grantDescription": "Calibrates the archive's survey route.",
+            "grantDetail": "The brass housing still hums with lunar static.",
+            "grantBadge": "RELIC"
+          }
+        },
+        {
+          "id": 102,
+          "name": "Signal Reel",
+          "type": "pickup",
+          "x": 456,
+          "y": 152,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to pocket the Signal Reel",
+            "grantItemId": "signal-reel",
+            "grantCategoryId": "relics",
+            "grantCategoryLabel": "Relics",
+            "grantDescription": "Restores the relay sequence for the east hall.",
+            "grantDetail": "Stamped with route marks from the first survey team.",
+            "grantBadge": "RELIC"
+          }
+        },
+        {
+          "id": 103,
+          "name": "Chorus Map",
+          "type": "pickup",
+          "x": 760,
+          "y": 344,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to collect the Chorus Map",
+            "grantItemId": "chorus-map",
+            "grantCategoryId": "relics",
+            "grantCategoryLabel": "Relics",
+            "grantDescription": "Pins the resonant floor and old service ducts.",
+            "grantDetail": "Enough of it survived to restore the final route.",
+            "grantBadge": "RELIC"
+          }
+        },
+        {
+          "id": 104,
+          "name": "Dawn Key",
+          "type": "pickup",
+          "x": 888,
+          "y": 456,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to recover the Dawn Key",
+            "grantItemId": "dawn-key",
+            "grantCategoryId": "keys",
+            "grantCategoryLabel": "Access Keys",
+            "grantDescription": "Still accepted by the Moon Gate lock.",
+            "grantDetail": "The key teeth match the seal at the archive exit.",
+            "grantBadge": "KEY"
+          }
+        }
+      ]
+    },
+    {
+      "name": "checkpoints",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 201,
+          "name": "Camp Lantern",
+          "type": "checkpoint",
+          "x": 288,
+          "y": 416,
+          "width": 48,
+          "height": 48,
+          "properties": {
+            "promptText": "Press E to mark the west camp checkpoint",
+            "checkpointId": "camp-west"
+          }
+        }
+      ]
+    },
+    {
+      "name": "props",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 301,
+          "name": "Archive Console",
+          "type": "prop",
+          "x": 616,
+          "y": 192,
+          "width": 56,
+          "height": 40,
+          "properties": {
+            "promptText": "Press E to inspect the archive console"
+          }
+        }
+      ]
+    },
+    {
+      "name": "locks",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 401,
+          "name": "Moon Gate",
+          "type": "lock",
+          "x": 896,
+          "y": 448,
+          "width": 96,
+          "height": 88,
+          "properties": {
+            "promptText": "Press E to unlock the Moon Gate",
+            "lockedPromptText": "Recover the Dawn Key before opening the Moon Gate",
+            "openedPromptText": "The Moon Gate is online",
+            "requiredItemId": "dawn-key",
+            "requiredQuantity": 1,
+            "consumeRequiredItem": false
+          }
+        }
+      ]
+    },
+    {
+      "name": "scenery",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 501,
+          "name": "Central Court",
+          "type": "plaza",
+          "x": 64,
+          "y": 64,
+          "width": 896,
+          "height": 448,
+          "properties": {
+            "fill": "#14211b",
+            "border": "#294436"
+          }
+        },
+        {
+          "id": 502,
+          "name": "Mirror Pool",
+          "type": "pool",
+          "x": 704,
+          "y": 128,
+          "width": 160,
+          "height": 96,
+          "properties": {
+            "fill": "#173949",
+            "border": "#3a728c"
+          }
+        },
+        {
+          "id": 503,
+          "name": "Collapsed Hall",
+          "type": "ruin",
+          "x": 256,
+          "y": 224,
+          "width": 192,
+          "height": 48,
+          "properties": {
+            "fill": "#28302d",
+            "border": "#4c5b57"
+          }
+        },
+        {
+          "id": 504,
+          "name": "South Gallery",
+          "type": "ruin",
+          "x": 512,
+          "y": 384,
+          "width": 224,
+          "height": 48,
+          "properties": {
+            "fill": "#242a29",
+            "border": "#48504c"
+          }
+        }
+      ]
+    }
+  ],
+  "tilesets": [
+    {
+      "firstgid": 1,
+      "image": "ruins-placeholder.png",
+      "tilewidth": 64,
+      "tileheight": 64,
+      "tilecount": 1,
+      "columns": 1
+    }
+  ]
+}

package/templates/create/2d-adventure/docs/design/loop.md

@@ -1,5 +1,6 @@
 # 2D Adventure Loop
 
-1. Sweep the ruin, collect four relics, and light the route beacons.
-1. Keep tuning knobs in `config/gameplay/adventure.config.js` and authored room nouns in `content/gameplay/world.js`.
-1. Extend the loop by adding more relic families, gate rules, or room variants before introducing heavier systems.
+1. Sweep the Moon Archive, recover the route relics, inspect the archive console, and leave through the Moon Gate.
+1. Keep authored room nouns in `content/gameplay/world.js`, `content/gameplay/world.tilemap.json`, and `content/gameplay/dialogue.js`, then keep starter-specific render/collision wrappers in `prefabs/world.prefab.js`.
+1. Use the archive console beat to prove the shared dialogue helper lane plus the shared journal/log owner before widening into heavier narrative or quest systems.
+1. Extend the loop by adding more object layers, item categories, checkpoints, or lock rules once the dialogue and journal proof still fits in one readable starter scene.