jumbo-cli 2.1.0 → 2.3.1

package/dist/domain/project/AgentsMdContent.d.ts

@@ -1,7 +1,8 @@
 /**
  * Domain Value Object: AGENTS.md Content
  *
- * Codifies the Jumbo instructions section for AGENTS.md files.
+ * Codifies the thin reference content for AGENTS.md files that
+ * points agents to JUMBO.md as the single source of truth.
  * Handles content generation, section marker management, and
  * section replacement for both current and legacy markers.
  *
@@ -10,7 +11,7 @@
  */
 export declare class AgentsMdContent {
     /**
-     * Generate the Jumbo instructions section for AGENTS.md
+     * Generate the Jumbo reference section for AGENTS.md
      */
     static getJumboSection(): string;
     /**
@@ -28,7 +29,7 @@ export declare class AgentsMdContent {
      */
     static getLegacyJumboSectionMarkers(): string[];
     /**
-     * Replace the Jumbo section in AGENTS.md with the current version.
+     * Replace the Jumbo section in AGENTS.md with the current thin reference version.
      * Checks the current marker and all legacy markers to find the section,
      * then replaces everything from the matched marker to the next "## " heading
      * (or EOF) with current getJumboSection().

package/dist/domain/project/AgentsMdContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentsMdContent.d.ts","sourceRoot":"","sources":["../../../src/domain/project/AgentsMdContent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IA4EhC;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAM/B;;OAEG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM;IAI7C;;;;OAIG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM,EAAE;IAM/C;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CA6BnE"}
+{"version":3,"file":"AgentsMdContent.d.ts","sourceRoot":"","sources":["../../../src/domain/project/AgentsMdContent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IAOhC;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAM/B;;OAEG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM;IAI7C;;;;OAIG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM,EAAE;IAM/C;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CA6BnE"}

package/dist/domain/project/AgentsMdContent.js

@@ -2,7 +2,8 @@
 /**
  * Domain Value Object: AGENTS.md Content
  *
- * Codifies the Jumbo instructions section for AGENTS.md files.
+ * Codifies the thin reference content for AGENTS.md files that
+ * points agents to JUMBO.md as the single source of truth.
  * Handles content generation, section marker management, and
  * section replacement for both current and legacy markers.
  *
@@ -13,88 +14,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentsMdContent = void 0;
 class AgentsMdContent {
     /**
-     * Generate the Jumbo instructions section for AGENTS.md
+     * Generate the Jumbo reference section for AGENTS.md
      */
     static getJumboSection() {
         return `## Instructions for Agents on how to collaborate with Jumbo
 
-Dear Agent,
-
-This project uses Jumbo CLI for agent orchestration and context management. Follow all prompts received from running \`jumbo\` commands, and take full advantage of \`jumbo\` commands to ensure optimal collaboration and maximal efficiency in executing goals.
-
-Sincerely,
-Project Administrator
-
-### When you start a new Session Start
-Run \`jumbo session start\`
-
-This orients you with the current state of the project: high-level project, recent events and a goal backlog to select work from.
-
-### Pre Compaction/Compression
-If a goal is actively being implemented.
-
-Run \`jumbo work pause\`
-
-### After Compaction/Compression
-Run \`jumbo work resume\`
-
-This will automatically serve context of a goal that you were progressing on prior to compaction.
-
-### Before Finishing a Session
-Run \`jumbo session end --focus {focus-description}\` --summary {summary-of-what-transpired}
-
-### Before Starting Work on a Goal
-Run \`jumbo goal start --id <id>\`
-
-### Be Proactive - Use Jumbo to the Fullest Extent
-Jumbo supercharges your abilities and consistency by supplying you with durable memory. Use is unsparingly. Be vigilant in identifying user decisions that change the existing standards for the project. Document when new patterns are introduced or removed. Capture corrections made by the user in the form of invariants or guidelines. If a new pattern is introduced, capture it. If a new component is introduced capture it. If new relations are relevant, register them. Use the full jumbo command catalog to quickly gain project insights. The rate of successful collaborations and ability to deliver on the developers wishes without error will highly increase the more you leverage Jumbo.
-
-### Available Commands
-\`jumbo --help \`
-\`jumbo goal add --help \`
-\`jumbo goal block --help \`
-\`jumbo goal complete --help \`
-\`jumbo goal remove --help \`
-\`jumbo goal reset --help \`
-\`jumbo goal resume --help \`
-\`jumbo goal show --help \`
-\`jumbo goal start --help \`
-\`jumbo goal unblock --help \`
-\`jumbo goal update --help \`
-\`jumbo goals list --help \`
-\`jumbo session end --help \`
-\`jumbo session pause --help \`
-\`jumbo session resume --help \`
-\`jumbo session start --help \`
-\`jumbo architecture define --help \`
-\`jumbo architecture update --help \`
-\`jumbo component add --help \`
-\`jumbo component deprecate --help \`
-\`jumbo component remove --help \`
-\`jumbo component update --help \`
-\`jumbo decision add --help \`
-\`jumbo decision reverse --help \`
-\`jumbo decision supersede --help \`
-\`jumbo decision update --help \`
-\`jumbo dependency add --help \`
-\`jumbo dependency remove --help \`
-\`jumbo dependency update --help \`
-\`jumbo guideline add --help \`
-\`jumbo guideline remove --help \`
-\`jumbo guideline update --help \`
-\`jumbo invariant add --help \`
-\`jumbo invariant remove --help \`
-\`jumbo invariant update --help \`
-
-### Next step:
-Run \`jumbo session start\` to retrieve project orientation.
+See JUMBO.md and follow all instructions. If the file does not exist, then ignore this instruction.
 `;
     }
     /**
      * Generate complete AGENTS.md file content
      */
     static getFullContent() {
-        return `# Agents.md
+        return `# AGENTS.md
 
 ${this.getJumboSection()}`;
     }
@@ -115,7 +47,7 @@ ${this.getJumboSection()}`;
         ];
     }
     /**
-     * Replace the Jumbo section in AGENTS.md with the current version.
+     * Replace the Jumbo section in AGENTS.md with the current thin reference version.
      * Checks the current marker and all legacy markers to find the section,
      * then replaces everything from the matched marker to the next "## " heading
      * (or EOF) with current getJumboSection().

package/dist/domain/project/AgentsMdContent.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentsMdContent.js","sourceRoot":"","sources":["../../../src/domain/project/AgentsMdContent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,MAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEV,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO;;EAET,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,4BAA4B;QACjC,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,4BAA4B;QACjC,OAAO;YACL,2BAA2B;SAC5B,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAuB;QAChD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC,CAAC;QAEjG,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;QAErB,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,aAAa,GAAG,MAAM,CAAC;gBACvB,WAAW,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,aAAa,KAAK,IAAI,IAAI,WAAW,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE9D,qDAAqD;QACrD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,gBAAgB;YAC/B,CAAC,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,GAAG,gBAAgB,CAAC,KAAM;YAC9D,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QAE3B,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC;IACjD,CAAC;CACF;AAhJD,0CAgJC"}
+{"version":3,"file":"AgentsMdContent.js","sourceRoot":"","sources":["../../../src/domain/project/AgentsMdContent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,MAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO;;;CAGV,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO;;EAET,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,4BAA4B;QACjC,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,4BAA4B;QACjC,OAAO;YACL,2BAA2B;SAC5B,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAuB;QAChD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC,CAAC;QAEjG,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;QAErB,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,aAAa,GAAG,MAAM,CAAC;gBACvB,WAAW,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,aAAa,KAAK,IAAI,IAAI,WAAW,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE9D,qDAAqD;QACrD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,gBAAgB;YAC/B,CAAC,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,GAAG,gBAAgB,CAAC,KAAM;YAC9D,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QAE3B,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC;IACjD,CAAC;CACF;AA3ED,0CA2EC"}

package/dist/domain/project/CopilotInstructionsContent.d.ts

@@ -1,7 +1,8 @@
 /**
  * Domain Value Object: Copilot Instructions Content
  *
- * Codifies the GitHub Copilot instructions for copilot-instructions.md.
+ * Codifies the thin reference content for copilot-instructions.md
+ * that directs agents to read JUMBO.md on startup.
  * Handles content generation, section marker detection, and section replacement.
  *
  * Rationale: Codified in domain rather than template file to support
@@ -9,7 +10,7 @@
  */
 export declare class CopilotInstructionsContent {
     /**
-     * Generate GitHub Copilot instructions for copilot-instructions.md
+     * Generate thin reference content for copilot-instructions.md
      */
     static getCopilotInstructions(): string;
     /**
@@ -17,11 +18,15 @@ export declare class CopilotInstructionsContent {
      */
     static getCopilotSectionMarker(): string;
     /**
-     * Replace the Copilot section in copilot-instructions.md with the current version.
-     * Finds "## Jumbo Context Management" heading and replaces everything from there
-     * to the next "## " heading (or EOF) with current getCopilotInstructions().
+     * Legacy marker from the previous verbose Copilot instructions.
+     */
+    private static getLegacyCopilotSectionMarker;
+    /**
+     * Replace the Copilot section in copilot-instructions.md with the current thin reference.
+     * Finds current or legacy section marker and replaces everything from there
+     * to the next "## " heading (or EOF) with current thin reference section.
      *
-     * @returns Updated content, or null if marker not found
+     * @returns Updated content, or null if no marker found
      */
     static replaceCopilotSection(existingContent: string): string | null;
 }

package/dist/domain/project/CopilotInstructionsContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotInstructionsContent.d.ts","sourceRoot":"","sources":["../../../src/domain/project/CopilotInstructionsContent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qBAAa,0BAA0B;IACrC;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,MAAM;IA0CvC;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM;IAIxC;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAiBrE"}
+{"version":3,"file":"CopilotInstructionsContent.d.ts","sourceRoot":"","sources":["../../../src/domain/project/CopilotInstructionsContent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,0BAA0B;IACrC;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,MAAM;IASvC;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM;IAIxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAI5C;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAkCrE"}

package/dist/domain/project/CopilotInstructionsContent.js

@@ -2,7 +2,8 @@
 /**
  * Domain Value Object: Copilot Instructions Content
  *
- * Codifies the GitHub Copilot instructions for copilot-instructions.md.
+ * Codifies the thin reference content for copilot-instructions.md
+ * that directs agents to read JUMBO.md on startup.
  * Handles content generation, section marker detection, and section replacement.
  *
  * Rationale: Codified in domain rather than template file to support
@@ -12,76 +13,62 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CopilotInstructionsContent = void 0;
 class CopilotInstructionsContent {
     /**
-     * Generate GitHub Copilot instructions for copilot-instructions.md
+     * Generate thin reference content for copilot-instructions.md
      */
     static getCopilotInstructions() {
-        return `## Jumbo Context Management
+        return `# copilot-instructions.md
 
-**IMPORTANT: This project uses Jumbo for AI memory and context management.**
+## Instructions for Agents on how to collaborate with Jumbo
 
-GitHub Copilot does not support automatic SessionStart hooks, so you must manually
-run Jumbo commands to load project context.
-
-### MANDATORY FIRST ACTION
-
-**Run \`jumbo session start\` at the beginning of each session.**
-
-This loads orientation context including:
-- Recent completed work and session state
-- Planned goals and their success criteria
-- Active architectural decisions
-- System invariants and guidelines
-- Project context and domain knowledge
-
-### Working with Jumbo
-
-1. **Start each session**: Run \`jumbo session start\` to load orientation context
-2. **Start a goal**: Before working on a task, run \`jumbo goal start --id <id>\` to load goal-specific context
-3. **Capture memories**: As you work, run jumbo commands to capture project knowledge:
-   - \`jumbo component add\` - Track architectural components
-   - \`jumbo decision add\` - Record architectural decisions (ADRs)
-   - \`jumbo guideline add\` - Capture coding standards and preferences
-   - \`jumbo invariant add\` - Document non-negotiable constraints
-   - \`jumbo relation add\` - Link related entities
-
-### Available Commands
-
-Run \`jumbo --help\` to see all available commands.
-
-### Learn More
-
-See AGENTS.md for complete instructions on using Jumbo.
-
-Run \`jumbo capabilities\` to learn about Jumbo's workflow and philosophy.
+See ../JUMBO.md and follow all instructions. If the file does not exist, then ignore this instruction.
 `;
     }
     /**
      * Marker used to detect if Jumbo section already exists in copilot-instructions.md
      */
     static getCopilotSectionMarker() {
+        return "## Instructions for Agents on how to collaborate with Jumbo";
+    }
+    /**
+     * Legacy marker from the previous verbose Copilot instructions.
+     */
+    static getLegacyCopilotSectionMarker() {
         return "## Jumbo Context Management";
     }
     /**
-     * Replace the Copilot section in copilot-instructions.md with the current version.
-     * Finds "## Jumbo Context Management" heading and replaces everything from there
-     * to the next "## " heading (or EOF) with current getCopilotInstructions().
+     * Replace the Copilot section in copilot-instructions.md with the current thin reference.
+     * Finds current or legacy section marker and replaces everything from there
+     * to the next "## " heading (or EOF) with current thin reference section.
      *
-     * @returns Updated content, or null if marker not found
+     * @returns Updated content, or null if no marker found
      */
     static replaceCopilotSection(existingContent) {
-        const marker = this.getCopilotSectionMarker();
-        const markerIndex = existingContent.indexOf(marker);
-        if (markerIndex === -1)
+        const allMarkers = [this.getCopilotSectionMarker(), this.getLegacyCopilotSectionMarker()];
+        let matchedMarker = null;
+        let markerIndex = -1;
+        for (const marker of allMarkers) {
+            const index = existingContent.indexOf(marker);
+            if (index !== -1) {
+                matchedMarker = marker;
+                markerIndex = index;
+                break;
+            }
+        }
+        if (matchedMarker === null || markerIndex === -1)
             return null;
         // Find the next ## heading after the marker (or EOF)
-        const afterMarker = existingContent.substring(markerIndex + marker.length);
+        const afterMarker = existingContent.substring(markerIndex + matchedMarker.length);
         const nextHeadingMatch = afterMarker.match(/\n## /);
         const endIndex = nextHeadingMatch
-            ? markerIndex + marker.length + nextHeadingMatch.index
+            ? markerIndex + matchedMarker.length + nextHeadingMatch.index
             : existingContent.length;
         const before = existingContent.substring(0, markerIndex);
         const after = existingContent.substring(endIndex);
-        return before + this.getCopilotInstructions() + after;
+        const sectionContent = `## Instructions for Agents on how to collaborate with Jumbo
+
+See ../JUMBO.md and follow all instructions. If the file does not exist, then ignore this instruction.
+`;
+        return before + sectionContent + after;
     }
 }
 exports.CopilotInstructionsContent = CopilotInstructionsContent;

package/dist/domain/project/CopilotInstructionsContent.js.map

@@ -1 +1 @@
-{"version":3,"file":"CopilotInstructionsContent.js","sourceRoot":"","sources":["../../../src/domain/project/CopilotInstructionsContent.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,MAAa,0BAA0B;IACrC;;OAEG;IACH,MAAM,CAAC,sBAAsB;QAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCV,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB;QAC5B,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,eAAuB;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,WAAW,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,qDAAqD;QACrD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,gBAAgB;YAC/B,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,gBAAgB,CAAC,KAAM;YACvD,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QAE3B,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO,MAAM,GAAG,IAAI,CAAC,sBAAsB,EAAE,GAAG,KAAK,CAAC;IACxD,CAAC;CACF;AA7ED,gEA6EC"}
+{"version":3,"file":"CopilotInstructionsContent.js","sourceRoot":"","sources":["../../../src/domain/project/CopilotInstructionsContent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,MAAa,0BAA0B;IACrC;;OAEG;IACH,MAAM,CAAC,sBAAsB;QAC3B,OAAO;;;;;CAKV,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB;QAC5B,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,6BAA6B;QAC1C,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,eAAuB;QAClD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,CAAC,6BAA6B,EAAE,CAAC,CAAC;QAE1F,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;QAErB,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,aAAa,GAAG,MAAM,CAAC;gBACvB,WAAW,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,aAAa,KAAK,IAAI,IAAI,WAAW,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE9D,qDAAqD;QACrD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,gBAAgB;YAC/B,CAAC,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,GAAG,gBAAgB,CAAC,KAAM;YAC9D,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QAE3B,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElD,MAAM,cAAc,GAAG;;;CAG1B,CAAC;QAEE,OAAO,MAAM,GAAG,cAAc,GAAG,KAAK,CAAC;IACzC,CAAC;CACF;AApED,gEAoEC"}

package/dist/domain/project/JumboMdContent.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Domain Value Object: JUMBO.md Content
+ *
+ * Codifies the centralized Jumbo instructions for JUMBO.md, which
+ * serves as the single source of truth for agent onboarding.
+ * All other agent files (AGENTS.md, CLAUDE.md, GEMINI.md,
+ * copilot-instructions.md) are thin references pointing here.
+ *
+ * Handles content generation, section marker management, and
+ * section replacement for both current and legacy markers.
+ *
+ * Rationale: Codified in domain rather than template file to support
+ * npm distribution (no file copying during build).
+ */
+export declare class JumboMdContent {
+    /**
+     * Generate the Jumbo instructions section for JUMBO.md
+     */
+    static getJumboSection(): string;
+    /**
+     * Generate complete JUMBO.md file content
+     */
+    static getFullContent(): string;
+    /**
+     * The current section heading extracted from getJumboSection().
+     */
+    static getCurrentSectionMarker(): string;
+    /**
+     * All historically used section headings for the Jumbo section.
+     * Carried over from AgentsMdContent legacy markers.
+     * When the current heading changes, add the previous heading here
+     * so that repair/init can find and replace old installations.
+     */
+    static getLegacySectionMarkers(): string[];
+    /**
+     * Replace the Jumbo section in JUMBO.md with the current version.
+     * Checks the current marker and all legacy markers to find the section,
+     * then replaces everything from the matched marker to the next "## " heading
+     * (or EOF) with current getJumboSection().
+     *
+     * @returns Updated content, or null if no marker found
+     */
+    static replaceJumboSection(existingContent: string): string | null;
+}
+//# sourceMappingURL=JumboMdContent.d.ts.map

package/dist/domain/project/JumboMdContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JumboMdContent.d.ts","sourceRoot":"","sources":["../../../src/domain/project/JumboMdContent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IA6EhC;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAM/B;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM;IAIxC;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAM1C;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CA6BnE"}

package/dist/domain/project/JumboMdContent.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Domain Value Object: JUMBO.md Content
+ *
+ * Codifies the centralized Jumbo instructions for JUMBO.md, which
+ * serves as the single source of truth for agent onboarding.
+ * All other agent files (AGENTS.md, CLAUDE.md, GEMINI.md,
+ * copilot-instructions.md) are thin references pointing here.
+ *
+ * Handles content generation, section marker management, and
+ * section replacement for both current and legacy markers.
+ *
+ * Rationale: Codified in domain rather than template file to support
+ * npm distribution (no file copying during build).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JumboMdContent = void 0;
+class JumboMdContent {
+    /**
+     * Generate the Jumbo instructions section for JUMBO.md
+     */
+    static getJumboSection() {
+        return `## Instructions for Agents on how to collaborate with Jumbo
+
+Dear Agent,
+
+This project uses Jumbo CLI for agent orchestration and context management. Jumbo is a proxy for me. You must follow all prompts received from running \`jumbo\` commands, and take full advantage of \`jumbo\` commands to ensure optimal collaboration and maximal efficiency in executing goals.
+
+Sincerely,
+Project Administrator
+
+### When you start a new Session Start
+Run \`jumbo session start\`
+
+This orients you with the current state of the project: high-level project, recent events and a goal backlog to select work from.
+
+### Pre Compaction/Compression
+If a goal is actively being implemented.
+
+Run \`jumbo work pause\`
+
+### After Compaction/Compression
+Run \`jumbo work resume\`
+
+This will automatically serve context of a goal that you were progressing on prior to compaction.
+
+### Before Finishing a Session
+Run \`jumbo session end --focus {focus-description}\` --summary {summary-of-what-transpired}
+
+### Before Starting Work on a Goal
+Run \`jumbo goal start --id <id>\`
+
+### Be Proactive - Use Jumbo to the Fullest Extent
+Jumbo supercharges your abilities and consistency by supplying you with durable memory. Use is unsparingly. Be vigilant in identifying user decisions that change the existing standards for the project. Document when new patterns are introduced or removed. Capture corrections made by the user in the form of invariants or guidelines. If a new pattern is introduced, capture it. If a new component is introduced capture it. If new relations are relevant, register them. Use the full jumbo command catalog to quickly gain project insights. The rate of successful collaborations and ability to deliver on the developers wishes without error will highly increase the more you leverage Jumbo.
+
+### Available Commands
+\`jumbo --help \`
+\`jumbo goal add --help \`
+\`jumbo goal refine --help \`
+\`jumbo goal block --help \`
+\`jumbo goal complete --help \`
+\`jumbo goal remove --help \`
+\`jumbo goal reset --help \`
+\`jumbo goal resume --help \`
+\`jumbo goal show --help \`
+\`jumbo goal start --help \`
+\`jumbo goal unblock --help \`
+\`jumbo goal update --help \`
+\`jumbo goals list --help \`
+\`jumbo session end --help \`
+\`jumbo session pause --help \`
+\`jumbo session resume --help \`
+\`jumbo session start --help \`
+\`jumbo architecture define --help \`
+\`jumbo architecture update --help \`
+\`jumbo component add --help \`
+\`jumbo component deprecate --help \`
+\`jumbo component remove --help \`
+\`jumbo component update --help \`
+\`jumbo decision add --help \`
+\`jumbo decision reverse --help \`
+\`jumbo decision supersede --help \`
+\`jumbo decision update --help \`
+\`jumbo dependency add --help \`
+\`jumbo dependency remove --help \`
+\`jumbo dependency update --help \`
+\`jumbo guideline add --help \`
+\`jumbo guideline remove --help \`
+\`jumbo guideline update --help \`
+\`jumbo invariant add --help \`
+\`jumbo invariant remove --help \`
+\`jumbo invariant update --help \`
+
+### Next step:
+Run \`jumbo session start\` to retrieve project orientation.
+`;
+    }
+    /**
+     * Generate complete JUMBO.md file content
+     */
+    static getFullContent() {
+        return `# JUMBO.md
+
+${this.getJumboSection()}`;
+    }
+    /**
+     * The current section heading extracted from getJumboSection().
+     */
+    static getCurrentSectionMarker() {
+        return "## Instructions for Agents on how to collaborate with Jumbo";
+    }
+    /**
+     * All historically used section headings for the Jumbo section.
+     * Carried over from AgentsMdContent legacy markers.
+     * When the current heading changes, add the previous heading here
+     * so that repair/init can find and replace old installations.
+     */
+    static getLegacySectionMarkers() {
+        return [
+            "## Instructions for Jumbo",
+        ];
+    }
+    /**
+     * Replace the Jumbo section in JUMBO.md with the current version.
+     * Checks the current marker and all legacy markers to find the section,
+     * then replaces everything from the matched marker to the next "## " heading
+     * (or EOF) with current getJumboSection().
+     *
+     * @returns Updated content, or null if no marker found
+     */
+    static replaceJumboSection(existingContent) {
+        const allMarkers = [this.getCurrentSectionMarker(), ...this.getLegacySectionMarkers()];
+        let matchedMarker = null;
+        let markerIndex = -1;
+        for (const marker of allMarkers) {
+            const index = existingContent.indexOf(marker);
+            if (index !== -1) {
+                matchedMarker = marker;
+                markerIndex = index;
+                break;
+            }
+        }
+        if (matchedMarker === null || markerIndex === -1)
+            return null;
+        // Find the next ## heading after the marker (or EOF)
+        const afterMarker = existingContent.substring(markerIndex + matchedMarker.length);
+        const nextHeadingMatch = afterMarker.match(/\n## /);
+        const endIndex = nextHeadingMatch
+            ? markerIndex + matchedMarker.length + nextHeadingMatch.index
+            : existingContent.length;
+        const before = existingContent.substring(0, markerIndex);
+        const after = existingContent.substring(endIndex);
+        return before + this.getJumboSection() + after;
+    }
+}
+exports.JumboMdContent = JumboMdContent;
+//# sourceMappingURL=JumboMdContent.js.map

package/dist/domain/project/JumboMdContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JumboMdContent.js","sourceRoot":"","sources":["../../../src/domain/project/JumboMdContent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,MAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEV,CAAC;IACA,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO;;EAET,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB;QAC5B,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB;QAC5B,OAAO;YACL,2BAA2B;SAC5B,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAuB;QAChD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;QAEvF,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;QAErB,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,aAAa,GAAG,MAAM,CAAC;gBACvB,WAAW,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,aAAa,KAAK,IAAI,IAAI,WAAW,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE9D,qDAAqD;QACrD,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClF,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,gBAAgB;YAC/B,CAAC,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,GAAG,gBAAgB,CAAC,KAAM;YAC9D,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QAE3B,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElD,OAAO,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC;IACjD,CAAC;CACF;AAlJD,wCAkJC"}

package/dist/infrastructure/context/project/init/AgentFileProtocol.d.ts

@@ -19,7 +19,11 @@ export declare class AgentFileProtocol implements IAgentFileProtocol {
     private readonly configurers;
     constructor(templateSkillsRoot?: string);
     /**
-     * Ensure AGENTS.md exists with Jumbo instructions
+     * Ensure JUMBO.md exists with full Jumbo instructions
+     */
+    ensureJumboMd(projectRoot: string): Promise<void>;
+    /**
+     * Ensure AGENTS.md exists with thin reference to JUMBO.md
      */
     ensureAgentsMd(projectRoot: string): Promise<void>;
     /**
@@ -27,7 +31,11 @@ export declare class AgentFileProtocol implements IAgentFileProtocol {
      */
     ensureAgentConfigurations(projectRoot: string): Promise<void>;
     /**
-     * Repair AGENTS.md by replacing the Jumbo section with the current version
+     * Repair JUMBO.md by replacing the Jumbo section with the current version
+     */
+    repairJumboMd(projectRoot: string): Promise<void>;
+    /**
+     * Repair AGENTS.md by replacing the Jumbo section with the current thin reference
      */
     repairAgentsMd(projectRoot: string): Promise<void>;
     /**

package/dist/infrastructure/context/project/init/AgentFileProtocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentFileProtocol.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/context/project/init/AgentFileProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mEAAmE,CAAC;AA+BtG,qBAAa,iBAAkB,YAAW,kBAAkB;IAQ9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAP/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAK1B;gBAE2B,kBAAkB,GAAE,MAAqC;IAEtF;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxD;;OAEG;IACG,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxD;;OAEG;IACG,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAuBhE,0BAA0B;YAiC1B,yBAAyB;YAkCzB,0BAA0B;YA6B1B,qBAAqB;CAYpC"}
+{"version":3,"file":"AgentFileProtocol.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/context/project/init/AgentFileProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mEAAmE,CAAC;AAgCtG,qBAAa,iBAAkB,YAAW,kBAAkB;IAQ9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAP/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAK1B;gBAE2B,kBAAkB,GAAE,MAAqC;IAEtF;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvD;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxD;;OAEG;IACG,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvD;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxD;;OAEG;IACG,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YA+BhE,0BAA0B;YAiC1B,yBAAyB;YAkCzB,0BAA0B;YA6B1B,qBAAqB;CAYpC"}