@compilr-dev/cli 0.7.3 → 0.7.5

package/dist/ui/overlay/data/tutorials/projects/new-project.js

@@ -88,24 +88,30 @@ export const newProjectTutorial = (s) => ({
                 '',
             ],
         },
-        // Page 5: Documentation Structure [3/8]
+        // Page 5: Project Type [3/8]
         {
-            title: 'Documentation Structure',
+            title: 'Project Type',
             lines: [
                 '',
                 `     ${s.primaryBold('Initialize New Project')} ${s.muted('[3/8]')}`,
                 '',
-                `     ${s.primary('Documentation structure')}`,
+                `     ${s.primary('What kind of project are you starting?')}`,
                 '',
-                `     ${s.primary('>')} 1. Single repo (.compilr/ folder + COMPILR.md in project root)`,
-                `       2. Two repos (project/ + project-docs/ separate repositories)`,
-                '',
-                `     ${s.muted('Single repo: All files in one repository')}`,
-                `     ${s.muted('Two repos: Code and docs in separate repositories')}`,
+                `     ${s.primary('>')} Software Development     ${s.muted('Web apps, APIs, CLIs, libraries')}`,
+                `       General Purpose          ${s.muted('Blank workspace — define your own')}`,
+                `       Research Paper           ${s.muted('Academic / analytical document')}`,
+                `       Content & Marketing      ${s.muted('Blog posts, social copy, content')}`,
+                `       Technical Documentation  ${s.muted('API docs, user guides, tutorials')}`,
+                `       Book                     ${s.muted('Long-form writing, fiction / nonfic')}`,
+                `       Business Plan            ${s.muted('Vision, market, financials, pitch')}`,
+                `       Course                   ${s.muted('Curriculum, modules, lessons')}`,
                 '',
                 `     ${s.muted('Up/Down Navigate | Enter Select | Esc Back')}`,
                 '',
-                `  ${s.warning('TIP:')} Single repo is simpler for most projects.`,
+                `  ${s.warning('TIP:')} Picking a type tailors the wizard. Software types ask about`,
+                `       tech stack + coding standards; non-software types skip those`,
+                `       steps. The type also drives the team-roster suggestion two`,
+                `       steps from now.`,
                 '',
             ],
         },
@@ -178,24 +184,50 @@ export const newProjectTutorial = (s) => ({
                 '',
             ],
         },
-        // Page 9: Workflow Mode [7/8]
+        // Page 9: Team Roster [7/8]
         {
-            title: 'Workflow Mode',
+            title: 'Team Roster',
             lines: [
                 '',
                 `     ${s.primaryBold('Initialize New Project')} ${s.muted('[7/8]')}`,
                 '',
-                `     ${s.primary('Workflow mode')}`,
+                `     ${s.primary('Team roster')}`,
                 '',
-                `     ${s.primary('>')} 1. Flexible (user-driven, exploratory) ${s.muted('(recommended)')}`,
-                `       2. Guided (structured step-by-step workflow)`,
+                `     ${s.muted('Software Development suggests these specialists:')}`,
                 '',
-                `     ${s.muted('Flexible: Work at your own pace, agent responds to requests')}`,
-                `     ${s.muted('Guided: Agent suggests next steps, tracks work item progress')}`,
+                `       ${s.muted('[▲_▲] Developer    Writes and debugs code')}`,
+                `       ${s.muted('[◈_◈] Architect    System design')}`,
+                `       ${s.muted('[◉_◉] QA           Testing and quality')}`,
+                `       ${s.muted('[▣_▣] PM           Project planning')}`,
                 '',
-                `     ${s.muted('Up/Down Navigate | Enter Select | Esc Back')}`,
+                `     ${s.primary('How should we set up the team?')}`,
+                '',
+                `     ${s.primary('>')} Add all suggested (4) ${s.muted('← recommended')}`,
+                `       Customize selection`,
+                `       Skip — start with just $default`,
+                '',
+                `     ${s.muted('Up/Down Navigate | Enter Confirm | Esc Back')}`,
+                '',
+                `  ${s.secondary('Three options:')}`,
                 '',
-                `  ${s.warning('TIP:')} Start with Flexible. Switch to Guided anytime via ${s.primary('/workflow')}.`,
+                `  ${s.primary('1.')} ${s.primaryBold('Add all suggested')} (default)`,
+                `     Specialists are spawned automatically when the project is created.`,
+                `     A chat with each agent is ready as soon as you finish.`,
+                '',
+                `  ${s.primary('2.')} ${s.primaryBold('Customize selection')}`,
+                `     Opens a checklist of the suggested agents. Use ${s.primary('Space')} to`,
+                `     toggle each one on/off. ${s.primary('Enter')} when done. You can still`,
+                `     run ${s.primary('/team add <role>')} later for roles outside the suggestion.`,
+                '',
+                `  ${s.primary('3.')} ${s.primaryBold('Skip')}`,
+                `     The project starts with only ${s.primary('$default')}. Useful for very`,
+                `     small projects or when you prefer to add agents one at a time.`,
+                '',
+                `  For project types with no default team (like General Purpose), this`,
+                `  step is skipped automatically.`,
+                '',
+                `  ${s.warning('TIP:')} If you accidentally skip and want the team back, run`,
+                `       ${s.primary('/team add')} for each role you want.`,
                 '',
             ],
         },
@@ -209,13 +241,13 @@ export const newProjectTutorial = (s) => ({
                 `     ${s.primary('Ready to create project?')}`,
                 '',
                 `     Project:     ${s.primary('my-first-project')}`,
+                `     Type:        ${s.primary('Software Development')}`,
                 `     Location:    ${s.primary('./my-first-project/')}`,
-                `     Structure:   ${s.primary('Single repo')}`,
                 `     Tech:        ${s.primary('React + Node.js + PostgreSQL')}`,
                 `     Standards:   ${s.primary('TypeScript Strict (recommended)')}`,
                 `     Git:         ${s.primary('Yes')}`,
                 `     Remote:      ${s.primary('https://github.com/user/my-first-project')}`,
-                `     Workflow:    ${s.primary('Flexible (user-driven, exploratory)')}`,
+                `     Team:        ${s.primary('4 specialists')} ${s.muted('($dev, $arch, $qa, $pm)')}`,
                 '',
                 `     ${s.primary('>')} Create`,
                 `       Cancel`,
@@ -243,6 +275,10 @@ export const newProjectTutorial = (s) => ({
                 `    ${s.success('✓')} ${s.primary('Git repository')} with initial commit`,
                 `       ${s.muted('Remote configured if you provided a URL')}`,
                 '',
+                `    ${s.success('✓')} ${s.primary('Team specialists')} added to the project's team`,
+                `       ${s.muted('Based on the type you picked + roster option chosen')}`,
+                `       ${s.muted('Run /team to see them')}`,
+                '',
                 `  You'll return to the Dashboard with your new project selected.`,
                 '',
             ],

package/dist/ui/overlay/impl/interactive-flow-overlay-v2.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Interactive Flow Overlay V2
+ *
+ * Multi-screen wizard for the `build_interactive_flow` DSL. Walks the
+ * user through a tree of nodes (question / info / branch / summary)
+ * defined by the agent. Branches are pure routing — never rendered.
+ *
+ * The state-machine logic (next-resolution, branch evaluation,
+ * backtrack) lives in `@compilr-dev/sdk/flow-runner` as pure helpers
+ * shared with Desktop. This overlay only handles per-node rendering +
+ * keyboard input + the renderer-specific transient state (cursor
+ * position, multi-selections, text buffer).
+ *
+ * Renderer collapses: the SDK has many `render` variants (tile-row,
+ * card-grid, segmented, …) that target GUIs. The terminal collapses
+ * them all to one rendering per input mode — `render` is ignored, as
+ * are `tone`, `density`, `icon`.
+ *
+ * Phase coverage (per spec):
+ *   - Phase A: single + text(single-line) + info + summary + branch ✓
+ *   - Phase B: multi + text(multiline) ✓
+ *   - Phase C: proposal mode — rendered inline as a numbered list with
+ *     pros + cons under each option. Same selection UX as 'single' mode
+ *     (arrows / 1-9 / Enter). Result is the chosen Proposal's id, which
+ *     `lookupLabel` resolves to the option's label for the summary table.
+ *
+ * Spec: project-docs/00-requirements/compilr-dev-cli/interactive-flow-cli-spec.md
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+import type { Flow, AnswerValue, InteractiveFlowResult, NodeId } from '../../../shared-handlers.js';
+interface FlowState {
+    /** Stack of every node visited, in order. Last element is current. */
+    path: NodeId[];
+    /** Final answers per question node */
+    answers: Record<NodeId, AnswerValue>;
+    /** Human-readable labels for the answers */
+    answerLabels: Record<NodeId, AnswerValue>;
+    /** Wall-clock start for durationMs */
+    startedAt: number;
+    /** Cursor index for single/multi questions */
+    selectedIndex: number;
+    /** Selections for multi mode (zero-based choice indices) */
+    multiSelections: Set<number>;
+    /** Text buffer for text-input questions */
+    inputBuffer: string;
+    /** Last warning message (e.g. multi-select min/max not met) */
+    warning: string;
+}
+export interface InteractiveFlowOptionsV2 {
+    flow: Flow;
+}
+export type InteractiveFlowResultV2 = InteractiveFlowResult;
+export declare class InteractiveFlowOverlayV2 extends BaseOverlayV2<FlowState, InteractiveFlowResultV2> {
+    readonly type: "inline";
+    readonly id = "interactive-flow-overlay-v2";
+    private readonly flow;
+    constructor(options: InteractiveFlowOptionsV2);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(key: KeyEvent): OverlayAction<InteractiveFlowResultV2>;
+    getCloseSummary(result: InteractiveFlowResultV2): string | null;
+    private currentNodeId;
+    private currentNode;
+    private renderQuestion;
+    private handleQuestionKey;
+    private renderInfo;
+    private handleInfoKey;
+    private renderSummary;
+    private handleSummaryKey;
+    private advance;
+    private advanceInfo;
+    private handleBackOrCancel;
+    private resetTransientState;
+    private makeCompleted;
+    private makeAborted;
+    private footerHints;
+    private tinted;
+}
+export {};