jumbo-cli 2.1.0 → 2.3.1

package/dist/presentation/cli/commands/sessions/start/SessionContextOutputBuilder.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionContextOutputBuilder = void 0;
+const TerminalOutputBuilder_js_1 = require("../../../output/TerminalOutputBuilder.js");
+const YamlFormatter_js_1 = require("../../../formatting/YamlFormatter.js");
+/**
+ * SessionContextOutputBuilder - Builds output for session context orientation.
+ *
+ * Renders project context (name, purpose, audiences, pains) and session summary
+ * (focus, status, paused goals, recent decisions, deactivated relations).
+ * Includes brownfield onboarding and paused goals resume @LLM prompts.
+ */
+class SessionContextOutputBuilder {
+    constructor() {
+        this.builder = new TerminalOutputBuilder_js_1.TerminalOutputBuilder();
+        this.yamlFormatter = new YamlFormatter_js_1.YamlFormatter();
+    }
+    /**
+     * Build human-readable session context output.
+     * Returns project context block (if available) and session summary block.
+     */
+    buildSessionContext(context) {
+        this.builder.reset();
+        const projectContextYaml = this.renderProjectContext(context.context.projectContext);
+        if (projectContextYaml) {
+            this.builder.addPrompt(projectContextYaml);
+        }
+        this.builder.addPrompt(this.renderSessionSummary(context));
+        return this.builder.build();
+    }
+    /**
+     * Build structured session context data for JSON output.
+     */
+    buildStructuredSessionContext(context) {
+        const sessionContextResult = this.buildSessionContextData(context);
+        return {
+            projectContext: this.buildProjectContextData(context.context.projectContext),
+            sessionContext: sessionContextResult.data.sessionContext,
+            llmSessionContextInstruction: sessionContextResult.llmInstruction ?? null,
+        };
+    }
+    renderProjectContext(projectContext) {
+        const contextData = this.buildProjectContextData(projectContext);
+        if (!contextData) {
+            return "";
+        }
+        return this.yamlFormatter.toYaml({ projectContext: contextData });
+    }
+    renderSessionSummary(context) {
+        const sessionContextResult = this.buildSessionContextData(context);
+        let output = this.yamlFormatter.toYaml(sessionContextResult.data);
+        if (sessionContextResult.llmInstruction) {
+            output += sessionContextResult.llmInstruction;
+        }
+        return output;
+    }
+    buildProjectContextData(projectContext) {
+        if (!projectContext) {
+            return null;
+        }
+        const contextData = {
+            name: projectContext.project.name,
+            purpose: projectContext.project.purpose || "Not defined",
+        };
+        if (projectContext.audiences.length > 0) {
+            contextData.audiences = projectContext.audiences.map((a) => ({
+                name: a.name,
+                description: a.description,
+                priority: a.priority,
+            }));
+        }
+        if (projectContext.audiencePains.length > 0) {
+            contextData.audiencePains = projectContext.audiencePains.map((p) => ({
+                title: p.title,
+                description: p.description,
+            }));
+        }
+        return contextData;
+    }
+    buildSessionContextData(context) {
+        if (context.instructions.includes("brownfield-onboarding")) {
+            return {
+                data: {
+                    sessionContext: {
+                        message: "No previous session context available. This appears to be your first session with Jumbo on this project.",
+                    },
+                },
+                llmInstruction: this.buildBrownfieldInstruction(),
+            };
+        }
+        if (!context.session) {
+            return {
+                data: {
+                    sessionContext: {
+                        message: "No previous session context available.",
+                    },
+                },
+            };
+        }
+        const contextData = {
+            sessionContext: {
+                focus: context.session.focus ?? "Not yet defined",
+                status: context.session.status,
+            },
+        };
+        const sessionCtx = contextData.sessionContext;
+        if (context.context.pausedGoals.length > 0) {
+            sessionCtx.pausedGoals = context.context.pausedGoals.map((g) => {
+                const pausedGoal = {
+                    goalId: g.goalId,
+                    objective: g.objective,
+                    pausedAt: g.updatedAt,
+                };
+                if (g.note) {
+                    pausedGoal.note = g.note;
+                }
+                return pausedGoal;
+            });
+        }
+        if (context.context.recentDecisions.length > 0) {
+            sessionCtx.recentDecisions = context.context.recentDecisions.map((d) => ({
+                decisionId: d.decisionId,
+                title: d.title,
+                rationale: d.rationale,
+            }));
+        }
+        if (context.context.deactivatedRelations.count > 0) {
+            sessionCtx.deactivatedRelations = {
+                count: context.context.deactivatedRelations.count,
+                summary: context.context.deactivatedRelations.summary,
+            };
+            sessionCtx.warning =
+                "Deactivated relations detected. Review them before relying on architecture links.";
+        }
+        const llmInstruction = context.context.pausedGoals.length > 0
+            ? "\n\n@LLM: Goals were paused. To resume a paused goal, run:\n  jumbo goal resume --id <goal-id>"
+            : undefined;
+        return { data: contextData, llmInstruction };
+    }
+    buildBrownfieldInstruction() {
+        return [
+            "",
+            "@LLM: This is a BROWNFIELD PROJECT with no Jumbo context yet.",
+            "",
+            "REQUIRED ACTION: Proactively engage the user with the following approach:",
+            "",
+            "1. GREET and ACKNOWLEDGE: \"Hi! I can see that you've added Jumbo to this project. ",
+            "   This looks like an existing codebase with valuable context to preserve.\"",
+            "",
+            "2. OFFER HELP: \"Would you like me to help transfer your existing project knowledge into Jumbo? ",
+            "   I can scan your documentation, code structure, and patterns to capture:\"",
+            "   - Project purpose and target audience (from README, docs)",
+            "   - Architectural components and dependencies (from code structure)",
+            "   - Development guidelines and coding standards (from patterns)",
+            "   - Architectural decisions (from docs, comments, ADRs)",
+            "",
+            "3. GET PERMISSION: \"I'll ask for your confirmation before adding anything to Jumbo. ",
+            "   Should we start by scanning your project documentation?\"",
+            "",
+            "IMPORTANT:",
+            "- Take initiative: Don't wait passively. Actively offer to help.",
+            "- Be conversational: Use natural language, not robotic instructions.",
+            "- Human-in-the-loop: Always get user confirmation before running jumbo commands.",
+            "- Start with docs: README.md, package.json, or docs/ are good starting points.",
+            "",
+            "AVAILABLE COMMANDS (use after getting user permission):",
+            "- jumbo architecture define --help",
+            "- jumbo component add --name 'ComponentName' --description 'What it does'",
+            "- jumbo decision add --title 'Decision' --rationale 'Why' --context 'Background'",
+            "- jumbo guideline add --category 'testing' --description 'Guideline text'",
+            "- jumbo invariant add --category 'architecture' --description 'Non-negotiable rule'",
+            "",
+            "Run 'jumbo --help' to see all available commands.",
+        ].join("\n");
+    }
+}
+exports.SessionContextOutputBuilder = SessionContextOutputBuilder;
+//# sourceMappingURL=SessionContextOutputBuilder.js.map

package/dist/presentation/cli/commands/sessions/start/SessionContextOutputBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContextOutputBuilder.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionContextOutputBuilder.ts"],"names":[],"mappings":"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"}

package/dist/presentation/cli/commands/sessions/start/SessionGoalsOutputBuilder.d.ts

@@ -0,0 +1,41 @@
+import { TerminalOutput } from "../../../output/TerminalOutput.js";
+import { GoalView } from "../../../../../application/context/goals/GoalView.js";
+interface GoalGroupEntry {
+    goalId: string;
+    objective: string;
+    createdAt: string;
+}
+interface GoalGroup {
+    hint: string;
+    count: number;
+    goals: GoalGroupEntry[];
+}
+export type GroupedGoals = Record<string, GoalGroup>;
+/**
+ * SessionGoalsOutputBuilder - Builds output for session start goal sections.
+ *
+ * Groups all goals by status with per-state next-step hints.
+ * Includes the @LLM goal start instruction prompt.
+ */
+export declare class SessionGoalsOutputBuilder {
+    private readonly builder;
+    private readonly yamlFormatter;
+    constructor();
+    /**
+     * Build human-readable goals output for session start.
+     * Groups goals by status with hints, ordered by STATUS_ORDER.
+     * Empty groups are omitted.
+     */
+    buildGoalsOutput(allGoals: GoalView[]): TerminalOutput;
+    /**
+     * Build structured goals data for JSON output.
+     */
+    buildStructuredGoals(allGoals: GoalView[]): {
+        goals: GroupedGoals;
+        llmGoalStartInstruction: string;
+    };
+    renderGoalStartInstruction(): string;
+    private buildGroupedGoals;
+}
+export {};
+//# sourceMappingURL=SessionGoalsOutputBuilder.d.ts.map

package/dist/presentation/cli/commands/sessions/start/SessionGoalsOutputBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionGoalsOutputBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionGoalsOutputBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,sDAAsD,CAAC;AAyChF,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;;IAO9C;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc;IAWtD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG;QAC1C,KAAK,EAAE,YAAY,CAAC;QACpB,uBAAuB,EAAE,MAAM,CAAC;KACjC;IAOD,0BAA0B,IAAI,MAAM;IAapC,OAAO,CAAC,iBAAiB;CA4B1B"}

package/dist/presentation/cli/commands/sessions/start/SessionGoalsOutputBuilder.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionGoalsOutputBuilder = void 0;
+const TerminalOutputBuilder_js_1 = require("../../../output/TerminalOutputBuilder.js");
+const YamlFormatter_js_1 = require("../../../formatting/YamlFormatter.js");
+/**
+ * Status ordering for session start goal display.
+ * Ordered reverse of the goal workflow: most progressed statuses appear first.
+ * Matches GoalListOutputBuilder's STATUS_ORDER.
+ */
+const STATUS_ORDER = {
+    "approved": 0,
+    "in-review": 1,
+    "submitted": 2,
+    "paused": 3,
+    "doing": 4,
+    "blocked": 5,
+    "unblocked": 6,
+    "rejected": 7,
+    "in-refinement": 8,
+    "codifying": 9,
+    "refined": 10,
+    "defined": 11,
+};
+/**
+ * Next-step hints per goal status.
+ */
+const STATUS_HINTS = {
+    "defined": "jumbo goal refine --id <id>",
+    "refined": "jumbo goal start --id <id>",
+    "doing": "jumbo goal submit --id <id>",
+    "paused": "jumbo goal resume --id <id>",
+    "blocked": "jumbo goal unblock --id <id>",
+    "unblocked": "jumbo goal start --id <id>",
+    "in-review": "Awaiting QA review",
+    "approved": "jumbo goal codify --id <id>",
+    "rejected": "jumbo goal start --id <id>",
+    "submitted": "jumbo goal review --id <id>",
+    "in-refinement": "Awaiting refinement completion",
+    "codifying": "Awaiting codification completion",
+};
+/**
+ * SessionGoalsOutputBuilder - Builds output for session start goal sections.
+ *
+ * Groups all goals by status with per-state next-step hints.
+ * Includes the @LLM goal start instruction prompt.
+ */
+class SessionGoalsOutputBuilder {
+    constructor() {
+        this.builder = new TerminalOutputBuilder_js_1.TerminalOutputBuilder();
+        this.yamlFormatter = new YamlFormatter_js_1.YamlFormatter();
+    }
+    /**
+     * Build human-readable goals output for session start.
+     * Groups goals by status with hints, ordered by STATUS_ORDER.
+     * Empty groups are omitted.
+     */
+    buildGoalsOutput(allGoals) {
+        this.builder.reset();
+        const grouped = this.buildGroupedGoals(allGoals);
+        this.builder.addPrompt(this.yamlFormatter.toYaml({ goals: grouped }));
+        this.builder.addPrompt("---\n");
+        this.builder.addPrompt(this.renderGoalStartInstruction());
+        return this.builder.build();
+    }
+    /**
+     * Build structured goals data for JSON output.
+     */
+    buildStructuredGoals(allGoals) {
+        return {
+            goals: this.buildGroupedGoals(allGoals),
+            llmGoalStartInstruction: this.renderGoalStartInstruction(),
+        };
+    }
+    renderGoalStartInstruction() {
+        const llmInstruction = [
+            "@LLM: Prompt the user for input about what goal to work on. ",
+            "For example, \"I can see we've recently worked on X, Y, Z. ",
+            "Everything was completed without blockers. Goals A, B, and N ",
+            "are available. Do you want to start with A, or something else?\"",
+            "Each goal group includes a hint with the suggested next-step command.",
+            "IMPORTANT: Run the suggested command for the chosen goal before doing any work!",
+        ];
+        return llmInstruction.join("\n");
+    }
+    buildGroupedGoals(allGoals) {
+        const groupMap = new Map();
+        for (const goal of allGoals) {
+            const group = groupMap.get(goal.status) ?? [];
+            group.push(goal);
+            groupMap.set(goal.status, group);
+        }
+        const orderedStatuses = [...groupMap.keys()].sort((a, b) => (STATUS_ORDER[a] ?? 99) - (STATUS_ORDER[b] ?? 99));
+        const grouped = {};
+        for (const status of orderedStatuses) {
+            const goals = groupMap.get(status);
+            grouped[status] = {
+                hint: STATUS_HINTS[status] ?? "No action available",
+                count: goals.length,
+                goals: goals.map((g) => ({
+                    goalId: g.goalId,
+                    objective: g.objective,
+                    createdAt: g.createdAt,
+                })),
+            };
+        }
+        return grouped;
+    }
+}
+exports.SessionGoalsOutputBuilder = SessionGoalsOutputBuilder;
+//# sourceMappingURL=SessionGoalsOutputBuilder.js.map

package/dist/presentation/cli/commands/sessions/start/SessionGoalsOutputBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionGoalsOutputBuilder.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionGoalsOutputBuilder.ts"],"names":[],"mappings":"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"}

package/dist/presentation/cli/commands/sessions/start/SessionStartOutputBuilder.d.ts

@@ -0,0 +1,26 @@
+import { TerminalOutput } from "../../../output/TerminalOutput.js";
+import { EnrichedSessionContext } from "../../../../../application/context/sessions/get/EnrichedSessionContext.js";
+/**
+ * SessionStartOutputBuilder - Top-level output builder for session start command.
+ *
+ * Composes SessionContextOutputBuilder and SessionGoalsOutputBuilder to produce
+ * the complete session start output. Supports both human-readable and structured modes.
+ *
+ * Pattern: Follows OutputBuilder composition pattern per decision dec_34f667f7.
+ */
+export declare class SessionStartOutputBuilder {
+    private readonly builder;
+    private readonly sessionContextOutputBuilder;
+    private readonly sessionGoalsOutputBuilder;
+    constructor();
+    /**
+     * Build complete human-readable session start output.
+     * Composes project context, session summary, goals, and LLM instructions.
+     */
+    buildSessionStartOutput(context: EnrichedSessionContext): TerminalOutput;
+    /**
+     * Build structured JSON output for session start command.
+     */
+    buildStructuredOutput(context: EnrichedSessionContext, sessionId: string): Record<string, unknown>;
+}
+//# sourceMappingURL=SessionStartOutputBuilder.d.ts.map

package/dist/presentation/cli/commands/sessions/start/SessionStartOutputBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStartOutputBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionStartOutputBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2EAA2E,CAAC;AAGnH;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA8B;IAC1E,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4B;;IAQtE;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc;IAyBxE;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAuBnG"}

package/dist/presentation/cli/commands/sessions/start/SessionStartOutputBuilder.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStartOutputBuilder = void 0;
+const TerminalOutputBuilder_js_1 = require("../../../output/TerminalOutputBuilder.js");
+const SessionContextOutputBuilder_js_1 = require("./SessionContextOutputBuilder.js");
+const SessionGoalsOutputBuilder_js_1 = require("./SessionGoalsOutputBuilder.js");
+/**
+ * SessionStartOutputBuilder - Top-level output builder for session start command.
+ *
+ * Composes SessionContextOutputBuilder and SessionGoalsOutputBuilder to produce
+ * the complete session start output. Supports both human-readable and structured modes.
+ *
+ * Pattern: Follows OutputBuilder composition pattern per decision dec_34f667f7.
+ */
+class SessionStartOutputBuilder {
+    constructor() {
+        this.builder = new TerminalOutputBuilder_js_1.TerminalOutputBuilder();
+        this.sessionContextOutputBuilder = new SessionContextOutputBuilder_js_1.SessionContextOutputBuilder();
+        this.sessionGoalsOutputBuilder = new SessionGoalsOutputBuilder_js_1.SessionGoalsOutputBuilder();
+    }
+    /**
+     * Build complete human-readable session start output.
+     * Composes project context, session summary, goals, and LLM instructions.
+     */
+    buildSessionStartOutput(context) {
+        this.builder.reset();
+        const contextOutput = this.sessionContextOutputBuilder.buildSessionContext(context);
+        for (const section of contextOutput.getSections()) {
+            if (section.type === "prompt" && section.content) {
+                this.builder.addPrompt(section.content);
+            }
+        }
+        const allGoals = [
+            ...context.context.activeGoals,
+            ...context.context.pausedGoals,
+            ...context.context.plannedGoals,
+        ];
+        const goalsOutput = this.sessionGoalsOutputBuilder.buildGoalsOutput(allGoals);
+        for (const section of goalsOutput.getSections()) {
+            if (section.type === "prompt" && section.content) {
+                this.builder.addPrompt(section.content);
+            }
+        }
+        return this.builder.build();
+    }
+    /**
+     * Build structured JSON output for session start command.
+     */
+    buildStructuredOutput(context, sessionId) {
+        const allGoals = [
+            ...context.context.activeGoals,
+            ...context.context.pausedGoals,
+            ...context.context.plannedGoals,
+        ];
+        const contextData = this.sessionContextOutputBuilder.buildStructuredSessionContext(context);
+        const goalsData = this.sessionGoalsOutputBuilder.buildStructuredGoals(allGoals);
+        return {
+            projectContext: contextData.projectContext,
+            sessionContext: contextData.sessionContext,
+            goals: goalsData.goals,
+            llmInstructions: {
+                sessionContext: contextData.llmSessionContextInstruction,
+                goalStart: goalsData.llmGoalStartInstruction,
+            },
+            sessionStart: {
+                sessionId,
+            },
+        };
+    }
+}
+exports.SessionStartOutputBuilder = SessionStartOutputBuilder;
+//# sourceMappingURL=SessionStartOutputBuilder.js.map

package/dist/presentation/cli/commands/sessions/start/SessionStartOutputBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStartOutputBuilder.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionStartOutputBuilder.ts"],"names":[],"mappings":";;;AAAA,uFAAiF;AAGjF,qFAA+E;AAC/E,iFAA2E;AAC3E;;;;;;;GAOG;AACH,MAAa,yBAAyB;IAKpC;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,gDAAqB,EAAE,CAAC;QAC3C,IAAI,CAAC,2BAA2B,GAAG,IAAI,4DAA2B,EAAE,CAAC;QACrE,IAAI,CAAC,yBAAyB,GAAG,IAAI,wDAAyB,EAAE,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,uBAAuB,CAAC,OAA+B;QACrD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAErB,MAAM,aAAa,GAAG,IAAI,CAAC,2BAA2B,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACpF,KAAK,MAAM,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YAClD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAiB,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG;YACf,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW;YAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW;YAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY;SAChC,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9E,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YAChD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAiB,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,OAA+B,EAAE,SAAiB;QACtE,MAAM,QAAQ,GAAG;YACf,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW;YAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW;YAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY;SAChC,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,CAAC,2BAA2B,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;QAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAEhF,OAAO;YACL,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,eAAe,EAAE;gBACf,cAAc,EAAE,WAAW,CAAC,4BAA4B;gBACxD,SAAS,EAAE,SAAS,CAAC,uBAAuB;aAC7C;YACD,YAAY,EAAE;gBACZ,SAAS;aACV;SACF,CAAC;IACJ,CAAC;CACF;AAlED,8DAkEC"}

package/dist/presentation/cli/commands/sessions/start/SessionStartTextRenderer.d.ts

@@ -6,46 +6,24 @@ export interface SessionStartTextRenderResult {
 export interface SessionStartStructuredContext {
     readonly projectContext: Record<string, unknown> | null;
     readonly sessionContext: Record<string, unknown>;
-    readonly inProgressGoals: Record<string, unknown>;
-    readonly plannedGoals: Record<string, unknown>;
+    readonly goals: Record<string, unknown>;
     readonly llmInstructions: {
         readonly sessionContext: string | null;
         readonly goalStart: string;
     };
 }
 /**
- * SessionStartTextRenderer - Formats session start context for LLM orientation
+ * SessionStartTextRenderer - Formats session start context for LLM orientation.
  *
- * Renders the session start context:
- * - Project name and purpose
- * - Target audiences
- * - Active audience pains
- * - Session context (focus, status, paused goals, recent decisions)
- * - In-progress goals
- * - Planned goals
- *
- * Output Format: YAML (more LLM-friendly than JSON)
+ * Delegates to SessionStartOutputBuilder for composition.
+ * Retained for backward compatibility with existing callers and tests.
  */
 export declare class SessionStartTextRenderer {
-    private readonly yamlFormatter;
+    private readonly sessionStartOutputBuilder;
+    private readonly sessionContextOutputBuilder;
     constructor();
     render(context: EnrichedSessionContext): SessionStartTextRenderResult;
     buildStructuredContext(context: EnrichedSessionContext): SessionStartStructuredContext;
     renderSessionSummary(context: EnrichedSessionContext): string;
-    private renderProjectContext;
-    private renderInProgressGoals;
-    private renderPlannedGoals;
-    private renderGoalStartInstruction;
-    /**
-     * Format message when no session summary exists (first-ever session on brownfield project)
-     *
-     * Outputs direct LLM instructions that cause the agent to proactively offer
-     * to help transfer existing project context into Jumbo.
-     */
-    private buildProjectContextData;
-    private buildInProgressGoalsData;
-    private buildPlannedGoalsData;
-    private buildSessionContextData;
-    private buildBrownfieldInstruction;
 }
 //# sourceMappingURL=SessionStartTextRenderer.d.ts.map

package/dist/presentation/cli/commands/sessions/start/SessionStartTextRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionStartTextRenderer.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionStartTextRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2EAA2E,CAAC;AAInH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE;QACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;;IAM9C,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,4BAA4B;IAqBrE,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,6BAA6B;IAetF,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAY7D,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,0BAA0B;IAYlC;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,uBAAuB;IAyE/B,OAAO,CAAC,0BAA0B;CAoCnC"}
+{"version":3,"file":"SessionStartTextRenderer.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/sessions/start/SessionStartTextRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2EAA2E,CAAC;AAInH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE;QACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4B;IACtE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA8B;;IAO1E,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,4BAA4B;IAqBrE,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,6BAA6B;IAatF,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;CAG9D"}