@stage5/lumine 0.3.74 → 0.3.75

package/lib/workspace.js

@@ -8,9 +8,11 @@ import {
   EXCLUDED_UPLOAD_FILES,
   LUMINE_AGENT_INSTRUCTIONS,
   LUMINE_AGENT_INSTRUCTIONS_MARKER,
+  LUMINE_MAIN_CHECKOUT_INSTRUCTIONS_MARKER,
   LUMINE_REFERENCE_INSTRUCTIONS,
   LUMINE_REFERENCE_INSTRUCTIONS_MARKER,
   LUMINE_SDK_REFERENCE_MARKER,
+  LUMINE_VERSION_CHECKOUT_INSTRUCTIONS_MARKER,
   PROJECT_EFFECTIVE_LINE_MAX_COLUMNS,
   PROJECT_MAX_EFFECTIVE_FILE_LINES,
   PROJECT_MAX_FILES,
@@ -39,14 +41,23 @@ export async function writeReferenceInstructions({ dir }) {
   });
 }
 
-// Write AGENTS.md/CLAUDE.md, but never clobber a file the user customized:
-// only (re)write when the file is absent or still carries our marker.
+// All checkout modes generate these same two files. A previous mode's header
+// still identifies a CLI-managed guide and must change with the checkout.
+// Custom guides omit the generated header; quoting a marker later is not ownership.
 export async function writeInstructionFiles({ dir, marker, content }) {
+  const managedHeaders = new Set([
+    marker,
+    LUMINE_AGENT_INSTRUCTIONS_MARKER,
+    LUMINE_REFERENCE_INSTRUCTIONS_MARKER,
+    LUMINE_MAIN_CHECKOUT_INSTRUCTIONS_MARKER,
+    LUMINE_VERSION_CHECKOUT_INSTRUCTIONS_MARKER,
+  ]);
   for (const fileName of AGENT_INSTRUCTION_FILES) {
     const filePath = path.join(dir, fileName);
     try {
       const existing = await fs.readFile(filePath, "utf8");
-      if (!existing.includes(marker)) {
+      const header = existing.replace(/^\uFEFF/, "").split(/\r?\n/, 1)[0];
+      if (!managedHeaders.has(header)) {
         continue;
       }
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage5/lumine",
-  "version": "0.3.74",
+  "version": "0.3.75",
   "description": "Command line tools for launching Lumine builds on Twinkle.",
   "type": "module",
   "bin": {