@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/overlay/data/tutorials/projects/managing-projects.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Managing Projects Tutorial
+ *
+ * How to switch between projects, use /projects and /workflow,
+ * and archive/delete projects.
+ */
+import type { TutorialBuilder } from '../../tutorial-types.js';
+export declare const managingProjectsTutorial: TutorialBuilder;

package/dist/ui/overlay/data/tutorials/projects/managing-projects.js

@@ -0,0 +1,212 @@
+/**
+ * Managing Projects Tutorial
+ *
+ * How to switch between projects, use /projects and /workflow,
+ * and archive/delete projects.
+ */
+export const managingProjectsTutorial = (s) => ({
+    id: 'managing-projects',
+    title: 'Managing Projects',
+    description: 'Switch, organize, and archive projects',
+    pages: [
+        // Page 1: Introduction
+        {
+            title: 'Managing Projects',
+            lines: [
+                '',
+                `  This tutorial covers:`,
+                '',
+                `    ${s.primary('/projects')}   View and switch between projects`,
+                `    ${s.primary('/workflow')}   Project status and actions`,
+                `    ${s.muted('Archiving')}    Hide projects from active list`,
+                `    ${s.muted('Sessions')}     What happens when you switch`,
+                '',
+                `  ${s.warning('TIP:')} You can also access ${s.primary('/projects')} from the Dashboard`,
+                `  by pressing ${s.primary('[p]')}.`,
+                '',
+            ],
+        },
+        // Page 2: /projects overlay
+        {
+            title: 'The /projects Overlay',
+            lines: [
+                '',
+                `  Run ${s.primary('/projects')} to see all your projects:`,
+                '',
+                `    ${s.muted('─'.repeat(60))}`,
+                `    ${s.primaryBold('Projects')} ${s.muted('[2/2]')}`,
+                '',
+                `     ${s.muted('All')}  ${s.muted('Active')}  ${s.muted('Paused')}  ${s.muted('Complete')}  ${s.muted('Archived')}`,
+                '',
+                `    ${s.primary('❯')} Note Taking App         general   ${s.success('● Active')}`,
+                `      My First Project        general   ${s.success('● Active')}`,
+                '',
+                `    ${s.muted('─'.repeat(60))}`,
+                `    ${s.muted('Last Activity:')} Jan 25, 2026, 09:47 AM`,
+                `    ${s.muted('Work Items:')} None`,
+                `    ${s.muted('─'.repeat(60))}`,
+                '',
+            ],
+        },
+        // Page 3: Filtering by status
+        {
+            title: 'Filtering Projects',
+            lines: [
+                '',
+                `  Use the tabs to filter projects by status:`,
+                '',
+                `     ${s.primary('All')}  ${s.muted('Active')}  ${s.muted('Paused')}  ${s.muted('Complete')}  ${s.muted('Archived')}`,
+                '',
+                `    ${s.primary('Tab')} or ${s.primary('←/→')}    Switch between tabs`,
+                `    ${s.primary('1-5')}             Jump directly to tab`,
+                '',
+                `  ${s.secondary('Status meanings:')}`,
+                '',
+                `    ${s.success('● Active')}     Currently being worked on`,
+                `    ${s.warning('● Paused')}     Temporarily on hold`,
+                `    ${s.primary('● Complete')}   Finished projects`,
+                `    ${s.muted('● Archived')}   Hidden from main view`,
+                '',
+            ],
+        },
+        // Page 4: Project actions
+        {
+            title: 'Project Actions',
+            lines: [
+                '',
+                `  From the ${s.primary('/projects')} list:`,
+                '',
+                `    ${s.primary('Enter')}    Open project in /workflow`,
+                `    ${s.primary('e')}        Edit project name/description`,
+                `    ${s.primary('x')}        Archive project`,
+                `    ${s.primary('d')}        Delete project ${s.muted('(must archive first)')}`,
+                `    ${s.primary('/')}        Search projects by name`,
+                '',
+                `  ${s.secondary('Navigation:')}`,
+                '',
+                `    ${s.primary('↑/↓')} or ${s.primary('j/k')}    Move between projects`,
+                `    ${s.primary('q')} or ${s.primary('Esc')}      Close overlay`,
+                '',
+            ],
+        },
+        // Page 5: /workflow overlay - Actions tab
+        {
+            title: 'The /workflow Overlay',
+            lines: [
+                '',
+                `  Press ${s.primary('Enter')} on a project to open ${s.primary('/workflow')}:`,
+                '',
+                `    ${s.muted('─'.repeat(60))}`,
+                `    ${s.primaryBold('Workflow')}  Note Taking App`,
+                '',
+                `    ${s.primary('[Actions]')} ${s.muted('[Details]')} ${s.muted('[Dashboard]')} ${s.muted('[Manage]')}`,
+                '',
+                `    Status: ${s.success('active')}  Mode: ${s.primary('flexible')}  ${s.warning('★ Current')}`,
+                `    Progress: 0/0 ${s.muted('[░░░░░░░░░░░░░░░░░░░░]')} 0%`,
+                '',
+                `    ${s.success('✓')} Initialize  ${s.primary('►')} Design  ${s.muted('○')} Backlog  ${s.muted('○')} Scaffold  ${s.muted('○')} Build`,
+                `    ${s.muted('─'.repeat(60))}`,
+                `    ${s.secondary('Quick Actions:')}`,
+                '',
+                `    ${s.primary('❯')} Design Project        ${s.muted('Create PRD and requirements')}`,
+                `      Quick Sketch          ${s.muted('Lightweight project outline')}`,
+                `      View Documents        ${s.muted('Browse project documents')}`,
+                `      View Anchors          ${s.muted('Manage persistent context')}`,
+                '',
+            ],
+        },
+        // Page 6: /workflow - Details tab
+        {
+            title: 'Project Details',
+            lines: [
+                '',
+                `  The ${s.primary('Details')} tab shows project information:`,
+                '',
+                `    ${s.muted('[Actions]')} ${s.primary('[Details]')} ${s.muted('[Dashboard]')} ${s.muted('[Manage]')}`,
+                '',
+                `    ${s.muted('─'.repeat(50))}`,
+                `    ${s.secondary('Project Details:')}`,
+                '',
+                `    Name            ${s.primary('note-taking-app')}`,
+                `    Display Name    ${s.primary('Note Taking App')}`,
+                `    Type            ${s.muted('general')}`,
+                `    Path            ${s.muted('/workspace/projects/note-taking-app')}`,
+                `    Created         ${s.muted('1/25/2026')}`,
+                `    Last Activity   ${s.muted('3m ago')}`,
+                `    Lifecycle       ${s.muted('setup')}`,
+                '',
+                `    ${s.secondary('Description:')}`,
+                `      ${s.muted('An app to take and organise notes')}`,
+                '',
+            ],
+        },
+        // Page 7: /workflow - Manage tab
+        {
+            title: 'Managing a Project',
+            lines: [
+                '',
+                `  The ${s.primary('Manage')} tab lets you change project settings:`,
+                '',
+                `    ${s.muted('[Actions]')} ${s.muted('[Details]')} ${s.muted('[Dashboard]')} ${s.primary('[Manage]')}`,
+                '',
+                `    ${s.muted('─'.repeat(50))}`,
+                `    ${s.secondary('Management Actions:')}`,
+                '',
+                `    ${s.primary('❯')} Edit Project          ${s.muted('Change name, description')}`,
+                `      Set as Current        ${s.muted('Switch to this project')}`,
+                `      Archive Project       ${s.muted('Hide from active list')}`,
+                `      Delete Project        ${s.muted('Permanently remove')}`,
+                '',
+                `  ${s.warning('TIP:')} Use ${s.primary('Set as Current')} to switch to a different project.`,
+                `  The ${s.warning('★ Current')} indicator shows which project is active.`,
+                '',
+            ],
+        },
+        // Page 8: Archiving a project
+        {
+            title: 'Archiving Projects',
+            lines: [
+                '',
+                `  Press ${s.primary('x')} in /projects or select ${s.primary('Archive Project')} in /workflow:`,
+                '',
+                `    ${s.muted('─'.repeat(50))}`,
+                `    ${s.primaryBold('ARCHIVE PROJECT')}`,
+                '',
+                `    Archive this project?`,
+                '',
+                `    Project: ${s.primary('Note Taking App')}`,
+                '',
+                `    ${s.muted('The project will be hidden from the active view.')}`,
+                `    ${s.muted('You can restore it later from the Archived tab.')}`,
+                '',
+                `    ${s.muted('─'.repeat(50))}`,
+                `    ${s.muted('Enter Confirm · Esc Cancel')}`,
+                '',
+                `  ${s.warning('NOTE:')} A project must be archived before it can be deleted.`,
+                '',
+            ],
+        },
+        // Page 9: Session behavior
+        {
+            title: 'Session Behavior',
+            lines: [
+                '',
+                `  When you switch projects, your session is saved automatically.`,
+                '',
+                `  ${s.secondary('Configure in /config:')}`,
+                '',
+                `    ${s.primary('Session restore mode')}`,
+                `      ${s.muted('Auto')}  - Automatically restore previous session`,
+                `      ${s.muted('Ask')}   - Prompt to restore or start fresh`,
+                `      ${s.muted('Fresh')} - Always start with clean session`,
+                '',
+                `    ${s.primary('Auto-open project')}`,
+                `      ${s.muted('Last opened')} - Opens your last project on startup`,
+                `      ${s.muted('Off')}         - Start fresh, choose manually`,
+                '',
+                `  ${s.warning('TIP:')} Use ${s.primary('/resume')} to manually restore a previous session.`,
+                '',
+            ],
+        },
+    ],
+});

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

@@ -0,0 +1,7 @@
+/**
+ * Creating a New Project Tutorial
+ *
+ * Detailed walkthrough of the /new wizard.
+ */
+import type { TutorialBuilder } from '../../tutorial-types.js';
+export declare const newProjectTutorial: TutorialBuilder;

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

@@ -0,0 +1,251 @@
+/**
+ * Creating a New Project Tutorial
+ *
+ * Detailed walkthrough of the /new wizard.
+ */
+export const newProjectTutorial = (s) => ({
+    id: 'new-project',
+    title: 'Creating a New Project',
+    description: 'Step-by-step /new walkthrough',
+    pages: [
+        // Page 1: Two Ways to Start
+        {
+            title: 'Two Ways to Start',
+            lines: [
+                '',
+                `  You can create a new project in two ways:`,
+                '',
+                `  ${s.secondary('From the Dashboard:')}`,
+                '',
+                `    Press ${s.primary('[n]')} or select ${s.primary('/new Project')} and press Enter.`,
+                '',
+                `  ${s.secondary('From the REPL:')}`,
+                '',
+                `    ${s.primary('compilr>')} /new`,
+                '',
+                `  Both methods open the same ${s.primaryBold('Initialize New Project')} wizard.`,
+                '',
+            ],
+        },
+        // Page 2: Starting the Wizard [0/8]
+        {
+            title: 'Starting the Wizard',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[0/8]')}`,
+                '',
+                `     ${s.primary('What would you like to do?')}`,
+                '',
+                `     ${s.primary('>')} 1. Start a new project`,
+                `       2. Add workflow to existing project`,
+                '',
+                `     ${s.muted('Start fresh with a structured project layout')}`,
+                `     ${s.muted('optimized for AI-assisted development.')}`,
+                '',
+                `     ${s.muted('Up/Down Navigate | Enter Select | q/Esc Cancel')}`,
+                '',
+                `  Select "Start a new project" and press Enter.`,
+                '',
+            ],
+        },
+        // Page 3: Project Name [1/8]
+        {
+            title: 'Project Name',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[1/8]')}`,
+                '',
+                `     ${s.primary('Project name')}`,
+                '',
+                `     ${s.primary('>')} my-first-project${s.muted('|')}`,
+                '',
+                `     ${s.muted('Use lowercase letters, numbers, hyphens (e.g., my-saas-app)')}`,
+                `     ${s.muted('2-50 characters, must start with a letter')}`,
+                '',
+                `     ${s.muted('Enter Confirm | Esc Back')}`,
+                '',
+                `  ${s.warning('TIP:')} Choose a descriptive name - it becomes your folder name.`,
+                '',
+            ],
+        },
+        // Page 4: Description [2/8]
+        {
+            title: 'Description',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[2/8]')}`,
+                '',
+                `     ${s.primary('What are you building?')}`,
+                '',
+                `     ${s.primary('>')} A note-taking app with markdown support${s.muted('|')}`,
+                '',
+                `     ${s.muted('Brief description (1-2 sentences)')}`,
+                `     ${s.muted('Example: "A task management SaaS for small teams"')}`,
+                '',
+                `     ${s.muted('Enter Confirm | Esc Back')}`,
+                '',
+                `  ${s.warning('TIP:')} Be specific! The AI uses this to understand your project.`,
+                '',
+            ],
+        },
+        // Page 5: Documentation Structure [3/8]
+        {
+            title: 'Documentation Structure',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[3/8]')}`,
+                '',
+                `     ${s.primary('Documentation structure')}`,
+                '',
+                `     ${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.muted('Up/Down Navigate | Enter Select | Esc Back')}`,
+                '',
+                `  ${s.warning('TIP:')} Single repo is simpler for most projects.`,
+                '',
+            ],
+        },
+        // Page 6: Tech Stack [4/8]
+        {
+            title: 'Tech Stack',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[4/8]')}`,
+                '',
+                `     ${s.primary('Tech stack')}`,
+                '',
+                `     ${s.primary('>')} 1. React + Node.js + PostgreSQL`,
+                `       2. React + Python + PostgreSQL`,
+                `       3. Vue + Node.js + PostgreSQL`,
+                `       4. Custom (configure later)`,
+                '',
+                `     ${s.muted('Choose a preset or configure later')}`,
+                '',
+                `     ${s.muted('Up/Down Navigate | Enter Select | Esc Back')}`,
+                '',
+                `  ${s.warning('TIP:')} You can change this later in your COMPILR.md file.`,
+                '',
+            ],
+        },
+        // Page 7: Coding Standards [5/8]
+        {
+            title: 'Coding Standards',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[5/8]')}`,
+                '',
+                `     ${s.primary('Coding standards preset')}`,
+                '',
+                `     ${s.primary('>')} 1. TypeScript Strict (recommended)`,
+                `       2. TypeScript Relaxed`,
+                `       3. Custom (configure later)`,
+                '',
+                `     ${s.muted('Strict: Full TypeScript with strict mode + ESLint')}`,
+                `     ${s.muted('Relaxed: TypeScript with basic strict mode')}`,
+                `     ${s.muted('Custom: Configure your own standards later')}`,
+                '',
+                `     ${s.muted('Up/Down Navigate | Enter Select | Esc Back')}`,
+                '',
+            ],
+        },
+        // Page 8: Git Repository [6/8]
+        {
+            title: 'Git Repository',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[6/8]')}`,
+                '',
+                `     ${s.primary('Initialize git repository?')}`,
+                '',
+                `     ${s.primary('>')} Yes`,
+                `       No`,
+                '',
+                `     ${s.muted('Creates git repo with initial commit')}`,
+                '',
+                `     ${s.muted('Up/Down Navigate | Enter Select | Esc Back')}`,
+                '',
+                `  If you select Yes, you can optionally add a remote URL:`,
+                '',
+                `     ${s.primary('Git remote URL (optional)')}`,
+                '',
+                `     ${s.primary('>')} https://github.com/user/my-first-project${s.muted('|')}`,
+                '',
+                `     ${s.muted('Enter Continue · Esc Skip')}`,
+                '',
+            ],
+        },
+        // Page 9: Workflow Mode [7/8]
+        {
+            title: 'Workflow Mode',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[7/8]')}`,
+                '',
+                `     ${s.primary('Workflow mode')}`,
+                '',
+                `     ${s.primary('>')} 1. Flexible (user-driven, exploratory) ${s.muted('(recommended)')}`,
+                `       2. Guided (structured step-by-step workflow)`,
+                '',
+                `     ${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('Up/Down Navigate | Enter Select | Esc Back')}`,
+                '',
+                `  ${s.warning('TIP:')} Start with Flexible. Switch to Guided anytime via ${s.primary('/workflow')}.`,
+                '',
+            ],
+        },
+        // Page 10: Confirmation [8/8]
+        {
+            title: 'Confirmation',
+            lines: [
+                '',
+                `     ${s.primaryBold('Initialize New Project')} ${s.muted('[8/8]')}`,
+                '',
+                `     ${s.primary('Ready to create project?')}`,
+                '',
+                `     Project:     ${s.primary('my-first-project')}`,
+                `     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)')}`,
+                '',
+                `     ${s.primary('>')} Create`,
+                `       Cancel`,
+                '',
+                `     ${s.muted('Up/Down Navigate | Enter Confirm | Esc Back')}`,
+                '',
+            ],
+        },
+        // Page 11: What Gets Created
+        {
+            title: 'What Gets Created',
+            lines: [
+                '',
+                `  ${s.secondary('After pressing Create, you get:')}`,
+                '',
+                `    ${s.success('✓')} ${s.primary('Project folder')} with initial structure`,
+                `       ${s.muted('./my-first-project/')}`,
+                '',
+                `    ${s.success('✓')} ${s.primary('COMPILR.md')} - Context file for the AI`,
+                `       ${s.muted('The AI reads this automatically')}`,
+                '',
+                `    ${s.success('✓')} ${s.primary('.compilr/')} folder with project config`,
+                `       ${s.muted('Requirements, roadmap, architecture docs')}`,
+                '',
+                `    ${s.success('✓')} ${s.primary('Git repository')} with initial commit`,
+                `       ${s.muted('Remote configured if you provided a URL')}`,
+                '',
+                `  You'll return to the Dashboard with your new project selected.`,
+                '',
+            ],
+        },
+    ],
+});

package/dist/ui/overlay/data/tutorials/projects/session-management.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Session Management Tutorial
+ *
+ * How to resume previous sessions and understand what's saved.
+ */
+import type { TutorialBuilder } from '../../tutorial-types.js';
+export declare const sessionManagementTutorial: TutorialBuilder;

package/dist/ui/overlay/data/tutorials/projects/session-management.js

@@ -0,0 +1,169 @@
+/**
+ * Session Management Tutorial
+ *
+ * How to resume previous sessions and understand what's saved.
+ */
+export const sessionManagementTutorial = (s) => ({
+    id: 'session-management',
+    title: 'Session Management',
+    description: 'Resume previous work sessions',
+    pages: [
+        // Page 1: Introduction
+        {
+            title: 'Session Management',
+            lines: [
+                '',
+                `  Sessions are ${s.primary('automatically saved')} after each AI response.`,
+                '',
+                `  This tutorial covers:`,
+                '',
+                `    ${s.primary('/resume')}      Restore a previous session`,
+                `    ${s.muted('What\'s saved')}   Conversation, todos, workflow state`,
+                `    ${s.muted('Cross-project')}  Resuming from other projects`,
+                '',
+                `  ${s.warning('TIP:')} You don't need to manually save. Sessions are saved`,
+                `  automatically as you work.`,
+                '',
+            ],
+        },
+        // Page 2: /resume overlay
+        {
+            title: 'The /resume Overlay',
+            lines: [
+                '',
+                `  Run ${s.primary('/resume')} to see your saved sessions:`,
+                '',
+                `    ${s.muted('─'.repeat(60))}`,
+                `    ${s.primaryBold('Resume Session')} ${s.muted('[5/7]')}`,
+                '',
+                `     ${s.primary('Recent')}  ${s.muted('All')}   ${s.muted('(Tab Switch · 1-2 Jump)')}`,
+                '',
+                `    ${s.primary('❯')} [Project 15]   24 minutes ago    11 msgs ${s.muted('what issue did you have?')}`,
+                `      [My First P..] 1 hour ago         4 msgs ${s.muted('how do I create a project?')}`,
+                `      [My First P..] 1 hour ago         0 msgs ${s.muted('No preview available')}`,
+                `      [My First P..] 1 hour ago        16 msgs ${s.muted('try again')}`,
+                `      [Project 14]   2 hours ago        4 msgs ${s.muted('which tools do you have?')}`,
+                '',
+                `    ${s.muted('─'.repeat(60))}`,
+                '',
+            ],
+        },
+        // Page 3: Session list tabs
+        {
+            title: 'Filtering Sessions',
+            lines: [
+                '',
+                `  Use the tabs to filter sessions:`,
+                '',
+                `     ${s.primary('Recent')}  ${s.muted('All')}`,
+                '',
+                `    ${s.primary('Recent')}   Sessions from the current project only`,
+                `    ${s.primary('All')}      Sessions from all projects`,
+                '',
+                `  ${s.secondary('Navigation:')}`,
+                '',
+                `    ${s.primary('j/k')} or ${s.primary('↑/↓')}    Move between sessions`,
+                `    ${s.primary('Tab')}             Switch tabs`,
+                `    ${s.primary('/')}               Search sessions`,
+                `    ${s.primary('Enter')}           Resume selected session`,
+                `    ${s.primary('d')}               Delete session`,
+                `    ${s.primary('q')} or ${s.primary('Esc')}       Close`,
+                '',
+            ],
+        },
+        // Page 4: Cross-project warning
+        {
+            title: 'Cross-Project Sessions',
+            lines: [
+                '',
+                `  When you select a session from a ${s.warning('different project')}:`,
+                '',
+                `    ${s.muted('─'.repeat(50))}`,
+                `    ${s.primaryBold('Session Details')}`,
+                '',
+                `    ${s.warning('⚠ From different project: My First Project')}`,
+                '',
+                `    Updated:    ${s.muted('1 hour ago')}`,
+                `    Created:    ${s.muted('1/25/2026, 9:11:01 AM')}`,
+                `    Messages:   ${s.muted('4')}`,
+                `    Session ID: ${s.muted('session_toolu_mktzwc05_uccch1s')}`,
+                '',
+                `    ${s.secondary('Last message:')}`,
+                `      ${s.muted('how do I create a project?')}`,
+                '',
+                `    ${s.muted('─'.repeat(50))}`,
+                `    ${s.muted('Enter Resume · d Delete · q/Esc Back')}`,
+                '',
+            ],
+        },
+        // Page 5: What's saved
+        {
+            title: 'What\'s Saved in a Session',
+            lines: [
+                '',
+                `  Each session saves:`,
+                '',
+                `    ${s.success('✓')} ${s.primary('Conversation history')}`,
+                `      All messages between you and the AI`,
+                '',
+                `    ${s.success('✓')} ${s.primary('Todo list')}`,
+                `      Your current task tracking items`,
+                '',
+                `    ${s.success('✓')} ${s.primary('Workflow state')}`,
+                `      Mode (flexible/guided), current work item`,
+                '',
+                `    ${s.success('✓')} ${s.primary('Token usage')}`,
+                `      How much context has been used`,
+                '',
+            ],
+        },
+        // Page 6: What's NOT saved in session
+        {
+            title: 'What\'s NOT in Sessions',
+            lines: [
+                '',
+                `  These are saved ${s.primary('per-project')}, not per-session:`,
+                '',
+                `    ${s.primary('Anchors')}`,
+                `      Persistent notes stay with the project`,
+                `      Available across all sessions`,
+                '',
+                `    ${s.primary('Team agents')}`,
+                `      Agent configurations are project-level`,
+                `      Shared context persists separately`,
+                '',
+                `    ${s.primary('Documents')}`,
+                `      PRD, architecture docs, backlog items`,
+                `      Stored in .compilr/ folder`,
+                '',
+                `  ${s.warning('TIP:')} Use ${s.primary('/anchors')} for information you want to`,
+                `  persist across all sessions.`,
+                '',
+            ],
+        },
+        // Page 7: Session restore config
+        {
+            title: 'Auto-Restore Settings',
+            lines: [
+                '',
+                `  Configure session restore behavior in ${s.primary('/config')}:`,
+                '',
+                `  ${s.secondary('Session restore mode:')}`,
+                '',
+                `    ${s.primary('Auto')}    Automatically restore last session`,
+                `    ${s.primary('Ask')}     Prompt to restore or start fresh`,
+                `    ${s.primary('Fresh')}   Always start with clean session`,
+                '',
+                `  ${s.secondary('When you switch projects:')}`,
+                '',
+                `    ${s.muted('•')} Current session is saved automatically`,
+                `    ${s.muted('•')} New project session restored based on setting`,
+                `    ${s.muted('•')} Project context (COMPILR.md, anchors) is loaded`,
+                '',
+                `  ${s.warning('TIP:')} Use ${s.primary('/resume')} to manually restore any session,`,
+                `  regardless of your auto-restore setting.`,
+                '',
+            ],
+        },
+    ],
+});

package/dist/ui/overlay/data/tutorials/teams/background-execution.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Background Execution Tutorial
+ *
+ * Covers running agents in background, /bg, /fg, /kill, /pending, /filter.
+ */
+import type { TutorialBuilder } from '../../tutorial-types.js';
+export declare const backgroundExecutionTutorial: TutorialBuilder;