@t3lnet/sceneforge 1.0.13 → 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/template-loader.ts

@@ -3,6 +3,7 @@
  * Loads markdown templates and supports variable interpolation.
  */
 
+import { existsSync } from "fs";
 import * as fs from "fs/promises";
 import * as path from "path";
 import { fileURLToPath } from "url";
@@ -24,7 +25,22 @@ export interface LoadedTemplate {
  * Get the templates directory path.
  */
 function getTemplatesDir(): string {
-  return path.join(__dirname, "templates");
+  const candidates = [
+    // Standard dist layout: dist/templates/{base,stages,skills}
+    path.join(__dirname, "templates"),
+    // Nested layout if templates were copied into an existing dist/templates
+    path.join(__dirname, "templates", "templates"),
+    // Source layout when templates are shipped under context/templates
+    path.join(__dirname, "..", "context", "templates"),
+  ];
+
+  for (const candidate of candidates) {
+    if (existsSync(path.join(candidate, "base"))) {
+      return candidate;
+    }
+  }
+
+  return candidates[0];
 }
 
 /**
@@ -68,7 +84,9 @@ export async function loadTemplatesByCategory(
 
     return templates;
   } catch (error) {
-    throw new Error(`Failed to load templates from ${category}: ${error}`);
+    throw new Error(
+      `Failed to load templates from ${category} in ${templatesDir}: ${error}`
+    );
   }
 }
 

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

@@ -2483,6 +2483,7 @@ async function discoverDemos(demoDir) {
 }
 
 // context/template-loader.ts
+var import_fs = require("fs");
 var fs5 = __toESM(require("fs/promises"), 1);
 var path5 = __toESM(require("path"), 1);
 var import_url = require("url");
@@ -2490,7 +2491,20 @@ var import_meta = {};
 var __filename = (0, import_url.fileURLToPath)(import_meta.url);
 var __dirname = path5.dirname(__filename);
 function getTemplatesDir() {
-  return path5.join(__dirname, "templates");
+  const candidates = [
+    // Standard dist layout: dist/templates/{base,stages,skills}
+    path5.join(__dirname, "templates"),
+    // Nested layout if templates were copied into an existing dist/templates
+    path5.join(__dirname, "templates", "templates"),
+    // Source layout when templates are shipped under context/templates
+    path5.join(__dirname, "..", "context", "templates")
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_fs.existsSync)(path5.join(candidate, "base"))) {
+      return candidate;
+    }
+  }
+  return candidates[0];
 }
 async function loadTemplate(category, name) {
   const templatesDir = getTemplatesDir();
@@ -2517,7 +2531,9 @@ async function loadTemplatesByCategory(category) {
     }
     return templates;
   } catch (error) {
-    throw new Error(`Failed to load templates from ${category}: ${error}`);
+    throw new Error(
+      `Failed to load templates from ${category} in ${templatesDir}: ${error}`
+    );
   }
 }
 function interpolateVariables(content, variables) {
@@ -2707,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");
@@ -2767,6 +2810,7 @@ async function deployContext(options) {
         });
       }
     } else {
+      const deployedStages = [];
       for (const stg of stages) {
         try {
           const content = await buildContext(tool, stg, variables);
@@ -2789,6 +2833,7 @@ async function deployContext(options) {
           if (merged) {
             console.log(`  [merged] ${path6.relative(outputDir, absolutePath)}`);
           }
+          deployedStages.push(stg);
         } catch (error) {
           results.push({
             tool,
@@ -2799,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;