gm-plugkit 2.0.1546 → 2.0.1548

package/bootstrap.js

@@ -74,6 +74,55 @@ function clearBootstrapError() {
   } catch (_) {}
 }
 
+function ensureNextStepWiring(cwd) {
+  const changes = [];
+  const gmDir = path.join(cwd, '.gm');
+  try { fs.mkdirSync(gmDir, { recursive: true }); }
+  catch (e) { obsEvent('bootstrap', 'next-step.wiring.target-failed', { target: gmDir, error: e.message }); }
+
+  const nextStepPath = path.join(gmDir, 'next-step.md');
+  const nextStepBody = '# Next step\n\nDispatch the `instruction` verb to plugkit by writing `.gm/exec-spool/in/instruction/<N>.txt` (any unique N) with body `{}` (or `{"prompt":"<user request>"}` on the first dispatch of the turn). Read the response from `.gm/exec-spool/out/<N>.json` and follow the imperative in the `instruction` field.\n\nThis file is auto-rewritten by plugkit on every instruction dispatch.\n';
+  try {
+    if (!fs.existsSync(nextStepPath)) {
+      fs.writeFileSync(nextStepPath, nextStepBody);
+      changes.push('seeded .gm/next-step.md');
+    }
+  } catch (e) { obsEvent('bootstrap', 'next-step.wiring.target-failed', { target: nextStepPath, error: e.message }); }
+
+  const claudeMdPath = path.join(cwd, 'CLAUDE.md');
+  try {
+    if (!fs.existsSync(claudeMdPath)) {
+      fs.writeFileSync(claudeMdPath, '@AGENTS.md\n');
+      changes.push('created CLAUDE.md');
+    } else {
+      const cur = fs.readFileSync(claudeMdPath, 'utf8');
+      const hasLine = cur.split(/\r?\n/).some(l => l.trim() === '@AGENTS.md');
+      if (!hasLine) {
+        fs.writeFileSync(claudeMdPath, '@AGENTS.md\n' + cur);
+        changes.push('prepended @AGENTS.md to CLAUDE.md');
+      }
+    }
+  } catch (e) { obsEvent('bootstrap', 'next-step.wiring.target-failed', { target: claudeMdPath, error: e.message }); }
+
+  const agentsMdPath = path.join(cwd, 'AGENTS.md');
+  try {
+    if (fs.existsSync(agentsMdPath)) {
+      const cur = fs.readFileSync(agentsMdPath, 'utf8');
+      const hasLine = cur.split(/\r?\n/).some(l => l.trim() === '@.gm/next-step.md');
+      if (!hasLine) {
+        const sep = cur.endsWith('\n') ? '' : '\n';
+        fs.writeFileSync(agentsMdPath, cur + sep + '\n@.gm/next-step.md\n');
+        changes.push('appended @.gm/next-step.md to AGENTS.md');
+      }
+    }
+  } catch (e) { obsEvent('bootstrap', 'next-step.wiring.target-failed', { target: agentsMdPath, error: e.message }); }
+
+  if (changes.length > 0) {
+    log(`next-step wiring: ${changes.join(', ')}`);
+    obsEvent('bootstrap', 'next-step.wiring.applied', { changes });
+  }
+}
+
 
 function cacheRoot() {
   const home = os.homedir();
@@ -812,6 +861,8 @@ async function ensureReady(opts) {
   opts = opts || {};
   const offline = opts.offline === true;
 
+  try { ensureNextStepWiring(process.env.CLAUDE_PROJECT_DIR || process.cwd()); } catch (_) {}
+
   if (!offline) {
     try {
       const selfStale = await probeSelfStaleness(2500);
@@ -1000,6 +1051,7 @@ function startSpoolDaemon() {
 module.exports = {
   bootstrap,
   ensureReady,
+  ensureNextStepWiring,
   gmToolsDir,
   getWasmPath,
   getBinaryPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-plugkit",
-  "version": "2.0.1546",
+  "version": "2.0.1548",
   "description": "Bootstrap and daemon-spawn tool for gm plugkit binary. Downloads the correct platform binary, verifies SHA256, and starts the spool watcher daemon. Includes plugkit-wasm-wrapper for WASM-based spool watching.",
   "main": "index.js",
   "bin": {

package/plugkit.version

@@ -1 +1 @@
-0.1.642
+0.1.643