miaoda-game-devkit 0.7.2 → 0.7.3

package/mechanics/pnpmfile.cjs

@@ -23,13 +23,14 @@ const packageGuidance =
   'Do not reimplement equivalent physics rules, AI, pathfinding, simulation, or algorithms in application code.\n' +
   'Keep local code focused on game-specific composition, presentation, and thin integration.';
 const contextReminder =
-  'Read miaoda-game-context.json before implementing gameplay. Use the installed packages and respect their owns and doesNotOwn boundaries.';
+  'Read miaoda-game-context.json before implementing gameplay. Use the installed packages and respect their owns and doesNotOwn boundaries.\n' +
+  'Refer to installed package READMEs and public types when using their APIs.';
 const automaticContextInstructions = [
   'Read this file before implementing or changing gameplay mechanics.',
   'Prefer a directly installed Miaoda package when its owns field matches the required mechanic.',
   'Do not reimplement responsibilities listed in a package owns field.',
   'Respect doesNotOwn and keep those responsibilities outside that package.',
-  'Read the installed package README and public types before using its API.',
+  'Refer to installed package READMEs and public types when using their APIs.',
 ];
 
 function readJson(path) {
@@ -103,7 +104,12 @@ function validateProjectConfig(capabilityDocument, projectManifest) {
   return problems;
 }
 
-function createGuard(capabilityDocument, projectManifest, observedPackages = new Map()) {
+function createGuard(
+  capabilityDocument,
+  projectManifest,
+  observedPackages = new Map(),
+  logState = { guidanceLogged: false },
+) {
   const capabilities = capabilityDocument?.packages || {};
   const config = projectConfig(projectManifest);
   const problems = validateProjectConfig(capabilityDocument, projectManifest);
@@ -112,7 +118,6 @@ function createGuard(capabilityDocument, projectManifest, observedPackages = new
   }
 
   const blockedPackages = new Set(config?.blockedPackages || []);
-  let guidanceLogged = false;
   const loggedPackages = new Set();
 
   return function readPackage(pkg, context) {
@@ -126,9 +131,9 @@ function createGuard(capabilityDocument, projectManifest, observedPackages = new
       throw new Error(`Restricted by package.json miaodaGame.blockedPackages: ${pkg.name}`);
     }
 
-    if (!guidanceLogged) {
+    if (!logState.guidanceLogged) {
       context.log(packageGuidance);
-      guidanceLogged = true;
+      logState.guidanceLogged = true;
     }
 
     const capability = capabilities[pkg.name];
@@ -389,7 +394,13 @@ if (!existsSync(packageJsonPath)) {
 const capabilityDocument = readJson(capabilityPath);
 const projectManifest = readJson(packageJsonPath);
 const observedPackages = new Map();
-const guardReadPackage = createGuard(capabilityDocument, projectManifest, observedPackages);
+const logState = { guidanceLogged: false };
+const guardReadPackage = createGuard(
+  capabilityDocument,
+  projectManifest,
+  observedPackages,
+  logState,
+);
 const localPnpmfile = existsSync(localPnpmfilePath) ? require(localPnpmfilePath) : {};
 let contextReminderLogged = false;
 
@@ -397,6 +408,8 @@ if (process.env.MIAODA_GAME_CONTEXT_DISABLED !== '1') {
   refreshInstalledContext(capabilityDocument, projectManifest, contextPath);
   const installedLockfile = rootImporterLockfile(join(projectRoot, 'pnpm-lock.yaml'));
   if (existsSync(contextPath) && directDependencies(installedLockfile, projectManifest).size > 0) {
+    console.log(packageGuidance);
+    logState.guidanceLogged = true;
     console.log(contextReminder);
     contextReminderLogged = true;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-game-devkit",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Shared React and Phaser game lint plus deterministic testing tools for Miaoda games",
   "license": "MIT",
   "main": "./dist/index.js",