@t3lnet/sceneforge 1.0.14 → 1.0.15

package/context/context-builder.ts

@@ -107,6 +107,42 @@ async function mergeWithExisting(
   }
 }
 
+async function writeSplitPointer(
+  tool: TargetTool,
+  stageNames: Stage[],
+  outputDir: string
+): Promise<{ filePath: string; merged: boolean }> {
+  const config = getToolConfig(tool);
+  const stageLines = stageNames.map((stage) => {
+    const friendly = formatStageName(stage);
+    const stageFile = `${config.splitFilePrefix}${getStageFileName(stage)}${config.fileExtension}`;
+    const relativePath = path.posix.join(config.splitDir, stageFile);
+    return `- ${friendly}: ${relativePath}`;
+  });
+
+  const pointerBody = [
+    "SceneForge context for this tool is split across the following stage files:",
+    "",
+    ...stageLines,
+    "",
+    `Open the stage file that matches the work you're doing, or run "npx sceneforge context preview --target ${tool} --stage <stage>" to inspect a specific stage.`,
+  ].join("\n");
+
+  const formattedPointer = formatForTool(tool, pointerBody, {
+    includeToolHeader: true,
+  });
+
+  const combinedPath = path.join(outputDir, config.combinedFile);
+  await fs.mkdir(path.dirname(combinedPath), { recursive: true });
+  const { content: finalContent, merged } = await mergeWithExisting(
+    combinedPath,
+    formattedPointer
+  );
+  await fs.writeFile(combinedPath, finalContent, "utf-8");
+
+  return { filePath: combinedPath, merged };
+}
+
 /**
  * Build context content for a specific tool and stage.
  */
@@ -210,6 +246,7 @@ export async function deployContext(
       }
     } else {
       // Generate split files for each stage
+      const deployedStages: Stage[] = [];
       for (const stg of stages) {
         try {
           const content = await buildContext(tool, stg, variables);
@@ -240,6 +277,7 @@ export async function deployContext(
           if (merged) {
             console.log(`  [merged] ${path.relative(outputDir, absolutePath)}`);
           }
+          deployedStages.push(stg);
         } catch (error) {
           results.push({
             tool,
@@ -250,6 +288,24 @@ export async function deployContext(
           });
         }
       }
+      if (deployedStages.length > 0) {
+        const pointerResult = await writeSplitPointer(
+          tool,
+          deployedStages,
+          outputDir
+        );
+        results.push({
+          tool,
+          filePath: pointerResult.filePath,
+          created: true,
+          skipped: false,
+        });
+        if (pointerResult.merged) {
+          console.log(
+            `  [merged] ${path.relative(outputDir, pointerResult.filePath)}`
+          );
+        }
+      }
     }
   }
 

package/context/tests/context-builder.test.ts

@@ -118,7 +118,7 @@ describe("context-builder", () => {
         outputDir: tempDir,
       });
 
-      expect(results.length).toBe(1);
+      expect(results.length).toBe(2);
       expect(results[0].created).toBe(true);
 
       const splitDir = path.join(tempDir, ".claude/rules");
@@ -134,9 +134,22 @@ describe("context-builder", () => {
         outputDir: tempDir,
       });
 
-      expect(results.length).toBe(4);
+      expect(results.length).toBe(5);
       expect(results.every((r) => r.created)).toBe(true);
     });
+
+    it("updates combined file when split files are deployed", async () => {
+      await deployContext({
+        target: "claude",
+        stage: "actions",
+        format: "split",
+        outputDir: tempDir,
+      });
+
+      const claudeFile = await fs.readFile(path.join(tempDir, "CLAUDE.md"), "utf-8");
+      expect(claudeFile).toContain("split across the following stage files");
+      expect(claudeFile).toContain(".claude/rules/stage1-actions.md");
+    });
   });
 
   describe("listDeployedContext", () => {

package/dist/index.cjs

@@ -2723,6 +2723,33 @@ async function mergeWithExisting(filePath, newContent) {
     throw error;
   }
 }
+async function writeSplitPointer(tool, stageNames, outputDir) {
+  const config = getToolConfig(tool);
+  const stageLines = stageNames.map((stage) => {
+    const friendly = formatStageName(stage);
+    const stageFile = `${config.splitFilePrefix}${getStageFileName(stage)}${config.fileExtension}`;
+    const relativePath = path6.posix.join(config.splitDir, stageFile);
+    return `- ${friendly}: ${relativePath}`;
+  });
+  const pointerBody = [
+    "SceneForge context for this tool is split across the following stage files:",
+    "",
+    ...stageLines,
+    "",
+    `Open the stage file that matches the work you're doing, or run "npx sceneforge context preview --target ${tool} --stage <stage>" to inspect a specific stage.`
+  ].join("\n");
+  const formattedPointer = formatForTool(tool, pointerBody, {
+    includeToolHeader: true
+  });
+  const combinedPath = path6.join(outputDir, config.combinedFile);
+  await fs6.mkdir(path6.dirname(combinedPath), { recursive: true });
+  const { content: finalContent, merged } = await mergeWithExisting(
+    combinedPath,
+    formattedPointer
+  );
+  await fs6.writeFile(combinedPath, finalContent, "utf-8");
+  return { filePath: combinedPath, merged };
+}
 async function buildContext(tool, stage, variables) {
   const templates = [];
   const baseTemplates = await loadTemplatesByCategory("base");
@@ -2783,6 +2810,7 @@ async function deployContext(options) {
         });
       }
     } else {
+      const deployedStages = [];
       for (const stg of stages) {
         try {
           const content = await buildContext(tool, stg, variables);
@@ -2805,6 +2833,7 @@ async function deployContext(options) {
           if (merged) {
             console.log(`  [merged] ${path6.relative(outputDir, absolutePath)}`);
           }
+          deployedStages.push(stg);
         } catch (error) {
           results.push({
             tool,
@@ -2815,6 +2844,24 @@ async function deployContext(options) {
           });
         }
       }
+      if (deployedStages.length > 0) {
+        const pointerResult = await writeSplitPointer(
+          tool,
+          deployedStages,
+          outputDir
+        );
+        results.push({
+          tool,
+          filePath: pointerResult.filePath,
+          created: true,
+          skipped: false
+        });
+        if (pointerResult.merged) {
+          console.log(
+            `  [merged] ${path6.relative(outputDir, pointerResult.filePath)}`
+          );
+        }
+      }
     }
   }
   return results;