fraim-framework 2.0.124 → 2.0.127

package/dist/src/cli/mcp/ide-formats.js

@@ -2,7 +2,7 @@
 // IDE Format Adapters - transform logical server structure to IDE-specific formats
 // Uses the centralized registry to determine server types
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IDE_FORMATS = exports.CodexFormat = exports.WindsurfFormat = exports.ClaudeCodeFormat = exports.ClaudeFormat = exports.VSCodeFormat = exports.KiroFormat = exports.StandardFormat = void 0;
+exports.IDE_FORMATS = exports.CodexFormat = exports.WindsurfFormat = exports.ClaudeCodeFormat = exports.ClaudeFormat = exports.GeminiCliFormat = exports.VSCodeFormat = exports.KiroFormat = exports.StandardFormat = void 0;
 exports.getIDEFormat = getIDEFormat;
 const mcp_server_registry_1 = require("./mcp-server-registry");
 const provider_registry_1 = require("../providers/provider-registry");
@@ -93,6 +93,33 @@ class VSCodeFormat {
     }
 }
 exports.VSCodeFormat = VSCodeFormat;
+class GeminiCliFormat {
+    constructor() {
+        this.name = 'gemini-cli';
+    }
+    transform(servers) {
+        const mcpServers = {};
+        for (const [key, server] of servers) {
+            if (server.url) {
+                mcpServers[key] = {
+                    ...(server.type === 'sse'
+                        ? { url: server.url }
+                        : { httpUrl: server.httpUrl || server.url }),
+                    ...(server.headers && { headers: server.headers })
+                };
+            }
+            else {
+                mcpServers[key] = {
+                    command: server.command,
+                    ...(server.args && { args: server.args }),
+                    ...(server.env && { env: server.env })
+                };
+            }
+        }
+        return { mcpServers };
+    }
+}
+exports.GeminiCliFormat = GeminiCliFormat;
 // Claude Desktop format (excludes provider servers - Issue #132)
 class ClaudeFormat {
     constructor() {
@@ -230,6 +257,7 @@ exports.IDE_FORMATS = {
     standard: new StandardFormat(),
     kiro: new KiroFormat(),
     vscode: new VSCodeFormat(),
+    'gemini-cli': new GeminiCliFormat(),
     claude: new ClaudeFormat(),
     'claude-code': new ClaudeCodeFormat(),
     windsurf: new WindsurfFormat(),

package/dist/src/cli/mcp/mcp-server-registry.js

@@ -85,6 +85,7 @@ function buildHTTPServer(mcpConfig, token) {
     }
     const authHeader = mcpConfig.authHeaderTemplate?.replace('{token}', token) || `Bearer ${token}`;
     return {
+        type: 'http',
         url: mcpConfig.url,
         headers: {
             Authorization: authHeader

package/dist/src/cli/setup/auto-mcp-setup.js

@@ -252,9 +252,9 @@ const configureIDEMCP = async (ide, fraimKey, tokenInput, providerConfigs) => {
 const autoConfigureMCP = async (fraimKey, tokenInput, selectedIDEs, providerConfigs) => {
     const tokens = normalizePlatformTokens(tokenInput);
     const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
-    if (detectedIDEs.length === 0) {
+    if (detectedIDEs.length === 0 && (!selectedIDEs || selectedIDEs.length === 0)) {
         console.log(chalk_1.default.yellow('⚠️ No supported IDEs detected.'));
-        console.log(chalk_1.default.gray('Supported IDEs: Claude, Antigravity, Kiro, Cursor, VSCode, Codex, Windsurf'));
+        console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Windsurf'));
         console.log(chalk_1.default.blue('\n💡 You can install an IDE and run setup again later.'));
         console.log(chalk_1.default.gray('   Or continue with manual MCP configuration.'));
         if (process.env.FRAIM_NON_INTERACTIVE) {
@@ -275,13 +275,19 @@ const autoConfigureMCP = async (fraimKey, tokenInput, selectedIDEs, providerConf
     }
     let idesToConfigure;
     if (selectedIDEs && selectedIDEs.length > 0) {
-        // Use command line specified IDEs
-        idesToConfigure = detectedIDEs.filter(ide => selectedIDEs.some(selected => ide.name.toLowerCase().includes(selected.toLowerCase())));
+        idesToConfigure = detectedIDEs.filter((ide) => selectedIDEs.some((selected) => ide.name.toLowerCase().includes(selected.toLowerCase())));
         if (idesToConfigure.length === 0) {
-            console.log(chalk_1.default.yellow(`⚠️ No IDEs found matching: ${selectedIDEs.join(', ')}`));
-            console.log(chalk_1.default.gray('Available IDEs:'));
-            detectedIDEs.forEach(ide => console.log(chalk_1.default.gray(`   • ${ide.name}`)));
-            return;
+            idesToConfigure = (0, ide_detector_1.getAllSupportedIDEs)().filter((ide) => selectedIDEs.some((selected) => {
+                const normalized = selected.toLowerCase();
+                return ide.name.toLowerCase().includes(normalized)
+                    || ide.aliases?.some((alias) => alias.includes(normalized));
+            }));
+            if (idesToConfigure.length === 0) {
+                console.log(chalk_1.default.yellow(`⚠️ No IDEs found matching: ${selectedIDEs.join(', ')}`));
+                console.log(chalk_1.default.gray('Available IDEs:'));
+                detectedIDEs.forEach((ide) => console.log(chalk_1.default.gray(`   • ${ide.name}`)));
+                return;
+            }
         }
     }
     else {

package/dist/src/cli/setup/ide-detector.js

@@ -7,6 +7,7 @@ exports.expandPath = exports.findIDEByName = exports.getAllSupportedIDEs = expor
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
 const expandPath = (filePath) => {
     if (filePath.startsWith('~/')) {
         return path_1.default.join(os_1.default.homedir(), filePath.slice(2));
@@ -17,6 +18,12 @@ exports.expandPath = expandPath;
 const checkMultiplePaths = (paths) => {
     return paths.some(p => fs_1.default.existsSync(expandPath(p)));
 };
+const availableByVersionProbe = (command) => {
+    const result = process.platform === 'win32'
+        ? (0, child_process_1.spawnSync)('cmd.exe', ['/d', '/s', '/c', `${command} --version`], { encoding: 'utf8', timeout: 1500 })
+        : (0, child_process_1.spawnSync)(command, ['--version'], { encoding: 'utf8', timeout: 1500 });
+    return result.status === 0;
+};
 const detectClaude = () => {
     const paths = [
         '~/.claude.json',
@@ -54,6 +61,15 @@ const detectWindsurf = () => {
     ];
     return checkMultiplePaths(paths);
 };
+const detectGeminiCli = () => {
+    const paths = [
+        '~/.gemini/settings.json',
+        '~/.gemini',
+        '~/AppData/Roaming/gemini/settings.json',
+        '~/.config/gemini/settings.json'
+    ];
+    return checkMultiplePaths(paths) || availableByVersionProbe('gemini');
+};
 exports.IDE_CONFIGS = [
     {
         name: 'Claude Code',
@@ -90,6 +106,21 @@ exports.IDE_CONFIGS = [
         detectMethod: () => fs_1.default.existsSync(expandPath('~/.gemini/antigravity')),
         description: 'Google Gemini Antigravity IDE'
     },
+    {
+        name: 'Gemini CLI',
+        configPath: '~/.gemini/settings.json',
+        configFormat: 'json',
+        configType: 'gemini-cli',
+        invocationProfile: 'gemini-command',
+        detectMethod: detectGeminiCli,
+        supportsConfigBootstrap: true,
+        aliases: ['gemini', 'gemini-cli', 'gemini cli'],
+        alternativePaths: [
+            '~/AppData/Roaming/gemini/settings.json',
+            '~/.config/gemini/settings.json'
+        ],
+        description: 'Google Gemini CLI local settings'
+    },
     {
         name: 'Kiro',
         configPath: '~/.kiro/settings/mcp.json',
@@ -186,6 +217,6 @@ const findIDEByName = (name) => {
     const normalized = name.toLowerCase();
     return exports.IDE_CONFIGS.find(ide => ide.name.toLowerCase().includes(normalized) ||
         normalized.includes(ide.name.toLowerCase()) ||
-        ide.aliases?.some(alias => alias.includes(normalized) || normalized.includes(alias)));
+        ide.aliases?.some(alias => alias.toLowerCase().includes(normalized) || normalized.includes(alias.toLowerCase())));
 };
 exports.findIDEByName = findIDEByName;

package/dist/src/cli/setup/ide-global-integration.js

@@ -36,7 +36,7 @@ async function installSlashCommands(homeDir) {
 }
 /**
  * Install FRAIM invocation artifacts for non-Claude IDEs.
- * Supports: Cursor, Codex, Windsurf, Kiro
+ * Supports: Cursor, Codex, Gemini CLI, Windsurf, Kiro
  * Does not overwrite existing files.
  */
 async function installGlobalRules(homeDir) {
@@ -49,6 +49,10 @@ async function installGlobalRules(homeDir) {
     if (fs_1.default.existsSync(codexDir)) {
         installFileIfMissing(path_1.default.join(codexDir, 'skills', 'fraim', 'SKILL.md'), (0, ide_invocation_surfaces_1.buildCodexSkillContent)(), 'Codex FRAIM skill (~/.codex/skills/fraim/SKILL.md)');
     }
+    const geminiDir = path_1.default.join(home, '.gemini');
+    if (fs_1.default.existsSync(geminiDir)) {
+        installFileIfMissing(path_1.default.join(geminiDir, 'commands', 'fraim.toml'), (0, ide_invocation_surfaces_1.buildGeminiCommandContent)(), 'Gemini CLI FRAIM command (~/.gemini/commands/fraim.toml)');
+    }
     const windsurfDir = path_1.default.join(home, '.codeium', 'windsurf');
     if (fs_1.default.existsSync(windsurfDir)) {
         installFileIfMissing(path_1.default.join(windsurfDir, 'commands', 'fraim.md'), (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)(), 'Windsurf FRAIM command (~/.codeium/windsurf/commands/fraim.md)');

package/dist/src/cli/setup/ide-invocation-surfaces.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FRAIM_INVOCATION_BODY = exports.CURSOR_MDC_FRONTMATTER = exports.FRAIM_LAUNCH_PHRASE = void 0;
+exports.FRAIM_INVOCATION_BODY = exports.FRAIM_DEFERRED_TOOL_PRELOAD = exports.CURSOR_MDC_FRONTMATTER = exports.FRAIM_LAUNCH_PHRASE = void 0;
+exports.buildFraimInvocationBody = buildFraimInvocationBody;
 exports.buildClaudeSkillContent = buildClaudeSkillContent;
 exports.buildClaudeCommandShimContent = buildClaudeCommandShimContent;
 exports.buildClaudeSlashCommandContent = buildClaudeSlashCommandContent;
@@ -8,15 +9,52 @@ exports.buildCursorMentionRuleContent = buildCursorMentionRuleContent;
 exports.buildCodexSkillContent = buildCodexSkillContent;
 exports.buildWindsurfCommandContent = buildWindsurfCommandContent;
 exports.buildKiroCommandContent = buildKiroCommandContent;
+exports.buildGeminiCommandContent = buildGeminiCommandContent;
 exports.describeInvocationSurface = describeInvocationSurface;
 exports.FRAIM_LAUNCH_PHRASE = 'Use FRAIM for <job or task>';
 exports.CURSOR_MDC_FRONTMATTER = `---
 description: FRAIM discovery and execution contract
 alwaysApply: true
 ---`;
-exports.FRAIM_INVOCATION_BODY = `Follow this process:
+exports.FRAIM_DEFERRED_TOOL_PRELOAD = [
+    'fraim_connect',
+    'list_fraim_jobs',
+    'get_fraim_job',
+    'get_fraim_file',
+    'seekMentoring'
+];
+function buildDeferredToolBootstrapSection(profile) {
+    if (profile === 'none') {
+        return '';
+    }
+    const preloadList = exports.FRAIM_DEFERRED_TOOL_PRELOAD.map((toolName) => `\`${toolName}\``).join(', ');
+    switch (profile) {
+        case 'claude-toolsearch':
+            return `0. **Preload deferred FRAIM tools when needed**:
+   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, call \`ToolSearch\` once to load ${preloadList}.
+   - Do the preload as one batched discovery step, not one search per tool.
+
+`;
+        case 'codex-tool-search':
+            return `0. **Preload deferred FRAIM tools when needed**:
+   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, call \`tool_search\` once to load ${preloadList}.
+   - Do the preload as one batched discovery step, not one search per tool.
+
+`;
+        case 'generic-tool-discovery':
+            return `0. **Preload deferred FRAIM tools when needed**:
+   - If FRAIM MCP tools are unavailable because this host lazily loads deferred tool schemas, use the host's tool discovery surface once to load ${preloadList}.
+   - Do the preload as one batched discovery step, not one search per tool.
+
+`;
+        default:
+            return '';
+    }
+}
+function buildFraimInvocationBody(profile = 'none') {
+    return `Follow this process:
 
-1. **If the user did not specify a FRAIM job or topic**:
+${buildDeferredToolBootstrapSection(profile)}1. **If the user did not specify a FRAIM job or topic**:
    Call \`list_fraim_jobs()\` to discover available jobs. Present the results grouped by the categories returned by the server. For each group, list 3-5 of the most relevant jobs with a one-line description.
 
 2. **Find the match**:
@@ -27,20 +65,22 @@ exports.FRAIM_INVOCATION_BODY = `Follow this process:
    - For skills, use the content returned by \`get_fraim_file(...)\`.
 
 4. **Execute**:
-   - For jobs, follow the phased instructions and use \`seekMentoring\` when the job requires phase transitions.
-   - For skills, apply the skill steps directly to the user's current context.
+   - For jobs, follow the phased instructions and use \`seekMentoring\` when the job requires phase transitions.
+   - For skills, apply the skill steps directly to the user's current context.
 `;
+}
+exports.FRAIM_INVOCATION_BODY = buildFraimInvocationBody();
 function buildClaudeSkillContent() {
-    return `# FRAIM
-
-${exports.FRAIM_INVOCATION_BODY}`;
+    return `# FRAIM
+
+${buildFraimInvocationBody('claude-toolsearch')}`;
 }
 function buildClaudeCommandShimContent() {
-    return `# FRAIM Compatibility Command
-
-Use the FRAIM skill when Claude exposes skills directly. This compatibility command keeps \`/fraim\` working on surfaces that still discover legacy command files.
-
-${exports.FRAIM_INVOCATION_BODY}`;
+    return `# FRAIM Compatibility Command
+
+Use the FRAIM skill when Claude exposes skills directly. This compatibility command keeps \`/fraim\` working on surfaces that still discover legacy command files.
+
+${buildFraimInvocationBody('claude-toolsearch')}`;
 }
 function buildClaudeSlashCommandContent() {
     return buildClaudeCommandShimContent();
@@ -50,23 +90,34 @@ function buildCursorMentionRuleContent() {
 
 # FRAIM
 
-${exports.FRAIM_INVOCATION_BODY}
+${buildFraimInvocationBody('generic-tool-discovery')}
 `;
 }
 function buildCodexSkillContent() {
     return `# FRAIM
 
-${exports.FRAIM_INVOCATION_BODY}`;
+${buildFraimInvocationBody('codex-tool-search')}`;
 }
 function buildWindsurfCommandContent() {
     return `# FRAIM
 
-${exports.FRAIM_INVOCATION_BODY}`;
+${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildKiroCommandContent() {
     return `# FRAIM
 
-${exports.FRAIM_INVOCATION_BODY}`;
+${buildFraimInvocationBody('generic-tool-discovery')}`;
+}
+function escapeTomlMultiline(value) {
+    return value.replace(/"""/g, '\\"""');
+}
+function buildGeminiCommandContent() {
+    return `description = "Discover and execute FRAIM jobs and skills"
+prompt = """
+# FRAIM
+
+${escapeTomlMultiline(buildFraimInvocationBody('generic-tool-discovery'))}
+"""`;
 }
 function describeInvocationSurface(ideName, invocationProfile) {
     switch (invocationProfile) {
@@ -86,6 +137,8 @@ function describeInvocationSurface(ideName, invocationProfile) {
             return `${ideName}: /fraim`;
         case 'kiro-hashtag':
             return `${ideName}: #fraim`;
+        case 'gemini-command':
+            return `${ideName}: /fraim`;
         case 'instructions-only':
         default:
             return `${ideName}: natural language`;

package/dist/src/cli/setup/mcp-config-generator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMCPConfig = exports.generateWindsurfMCPServers = exports.generateVSCodeMCPServers = exports.generateCodexMCPServers = exports.generateKiroMCPServers = exports.generateClaudeCodeMCPServers = exports.generateClaudeMCPServers = exports.generateStandardMCPServers = exports.mergeTomlMCPServers = exports.extractTomlMcpServerBlock = void 0;
+exports.generateMCPConfig = exports.generateWindsurfMCPServers = exports.generateGeminiCliMCPServers = exports.generateVSCodeMCPServers = exports.generateCodexMCPServers = exports.generateKiroMCPServers = exports.generateClaudeCodeMCPServers = exports.generateClaudeMCPServers = exports.generateStandardMCPServers = exports.mergeTomlMCPServers = exports.extractTomlMcpServerBlock = void 0;
 const mcp_server_builder_1 = require("../mcp/mcp-server-builder");
 const ide_formats_1 = require("../mcp/ide-formats");
 const normalizeTokens = (tokenInput) => {
@@ -160,6 +160,15 @@ const generateVSCodeMCPServers = async (fraimKey, tokenInput, providerConfigs) =
     return format.transform(builder.getServers());
 };
 exports.generateVSCodeMCPServers = generateVSCodeMCPServers;
+const generateGeminiCliMCPServers = async (fraimKey, tokenInput, providerConfigs) => {
+    const tokens = normalizeTokens(tokenInput);
+    const builder = new mcp_server_builder_1.MCPServerBuilder();
+    builder.addBaseServers(fraimKey);
+    await addProviderServers(builder, tokens, providerConfigs);
+    const format = (0, ide_formats_1.getIDEFormat)('gemini-cli');
+    return format.transform(builder.getServers());
+};
+exports.generateGeminiCliMCPServers = generateGeminiCliMCPServers;
 const generateWindsurfMCPServers = async (fraimKey, tokenInput, providerConfigs) => {
     const tokens = normalizeTokens(tokenInput);
     const builder = new mcp_server_builder_1.MCPServerBuilder();
@@ -181,6 +190,8 @@ const generateMCPConfig = async (configType, fraimKey, tokenInput, providerConfi
             return await (0, exports.generateKiroMCPServers)(fraimKey, tokenInput, providerConfigs);
         case 'vscode':
             return await (0, exports.generateVSCodeMCPServers)(fraimKey, tokenInput, providerConfigs);
+        case 'gemini-cli':
+            return await (0, exports.generateGeminiCliMCPServers)(fraimKey, tokenInput, providerConfigs);
         case 'codex':
             return await (0, exports.generateCodexMCPServers)(fraimKey, tokenInput, providerConfigs);
         case 'windsurf':

package/dist/src/cli/utils/agent-adapters.js

@@ -15,6 +15,8 @@ const CLAUDE_FRAIM_COMMAND_PATH = path_1.default.join('.claude', 'commands', 'fr
 const CLAUDE_FRAIM_SKILL_PATH = path_1.default.join('.claude', 'skills', 'fraim', 'SKILL.md');
 const VSCODE_FRAIM_PROMPT_PATH = path_1.default.join('.github', 'prompts', 'fraim.prompt.md');
 const CODEX_FRAIM_SKILL_PATH = path_1.default.join('.codex', 'skills', 'fraim', 'SKILL.md');
+const GEMINI_FRAIM_COMMAND_PATH = path_1.default.join('.gemini', 'commands', 'fraim.toml');
+const GEMINI_PROJECT_INSTRUCTIONS_PATH = path_1.default.join('.gemini', 'GEMINI.md');
 const WINDSURF_FRAIM_COMMAND_PATH = path_1.default.join('.windsurf', 'commands', 'fraim.md');
 const KIRO_FRAIM_COMMAND_PATH = path_1.default.join('.kiro', 'commands', 'fraim.md');
 function buildManagedSection(body) {
@@ -74,7 +76,7 @@ This repository uses FRAIM.
     const cursorManagedBody = buildManagedSection(`
 # FRAIM
 
-${ide_invocation_surfaces_1.FRAIM_INVOCATION_BODY}
+${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discovery')}
 `);
     const copilotBody = buildManagedSection(`
 ## FRAIM
@@ -101,7 +103,11 @@ Use the stubs here to discover which FRAIM job, skill, or rule is relevant, then
 `;
     const vscodePrompt = `# FRAIM
 
-${ide_invocation_surfaces_1.FRAIM_INVOCATION_BODY}`;
+${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discovery')}`;
+    const geminiProjectInstructions = `# Gemini Project Instructions
+
+@../AGENTS.md
+`;
     return [
         { path: 'AGENTS.md', content: markdownBody },
         { path: 'CLAUDE.md', content: markdownBody },
@@ -112,6 +118,8 @@ ${ide_invocation_surfaces_1.FRAIM_INVOCATION_BODY}`;
         { path: CLAUDE_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSkillContent)() },
         { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)() },
         { path: CODEX_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildCodexSkillContent)() },
+        { path: GEMINI_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildGeminiCommandContent)() },
+        { path: GEMINI_PROJECT_INSTRUCTIONS_PATH, content: geminiProjectInstructions },
         { path: WINDSURF_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)() },
         { path: KIRO_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildKiroCommandContent)() }
     ];
@@ -132,6 +140,8 @@ function ensureAgentAdapterFiles(projectRoot) {
                 || file.path === CLAUDE_FRAIM_SKILL_PATH
                 || file.path === CLAUDE_FRAIM_COMMAND_PATH
                 || file.path === CODEX_FRAIM_SKILL_PATH
+                || file.path === GEMINI_FRAIM_COMMAND_PATH
+                || file.path === GEMINI_PROJECT_INSTRUCTIONS_PATH
                 || file.path === WINDSURF_FRAIM_COMMAND_PATH
                 || file.path === KIRO_FRAIM_COMMAND_PATH
                 ? file.content

package/dist/src/cli/utils/project-bootstrap.js

@@ -8,6 +8,7 @@ exports.recordPathStatus = recordPathStatus;
 exports.buildInitProjectSummary = buildInitProjectSummary;
 exports.printInitProjectSummary = printInitProjectSummary;
 const chalk_1 = __importDefault(require("chalk"));
+const ONBOARDING_VIDEO_PLAYLIST_URL = 'https://fraimworks.ai/resources.html#videos';
 function formatModeLabel(mode) {
     switch (mode) {
         case 'conversational':
@@ -21,11 +22,11 @@ function formatModeLabel(mode) {
 function getModeSpecificNextStep(mode) {
     switch (mode) {
         case 'conversational':
-            return 'The agent will focus on project context, validation commands, and durable repo rules.';
+            return `The agent will focus on project context, validation commands, and durable repo rules. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
         case 'split':
-            return 'The agent will confirm the code-host and issue-tracker split, then ask only for the missing project details.';
+            return `The agent will confirm the code-host and issue-tracker split, then ask only for the missing project details. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
         default:
-            return 'The agent will review the detected repo setup, then ask only for the highest-value missing project details.';
+            return `The agent will review the detected repo setup, then ask only for the highest-value missing project details. For a walkthrough, watch the onboarding videos at ${ONBOARDING_VIDEO_PLAYLIST_URL}.`;
     }
 }
 function createInitProjectResult(projectName, mode) {

package/dist/src/core/quality-evidence.js

@@ -26,7 +26,11 @@ exports.validateQualityEvidence = validateQualityEvidence;
 exports.buildQualityRejectionMessage = buildQualityRejectionMessage;
 exports.QUALITY_REGISTRY = {
     // Customer Development
-    'process-interview-notes': { stage: 'customer-development', enforced: true, telemetryKind: 'score' },
+    // review-customer-development is the sole quality emitter for this stage.
+    // process-interview-notes is retained here for stage mapping only; it does
+    // not emit (enforced: false).
+    'process-interview-notes': { stage: 'customer-development', enforced: false },
+    'review-customer-development': { stage: 'customer-development', enforced: true, telemetryKind: 'score' },
     'triage-customer-needs': { stage: 'customer-development', enforced: true, telemetryKind: 'gate' },
     'interview-preparation': { stage: 'customer-discovery', enforced: false },
     // Business Strategy
@@ -39,6 +43,7 @@ exports.QUALITY_REGISTRY = {
     'test-quality-assessment': { stage: 'test-quality', enforced: true, telemetryKind: 'score' },
     // Security
     'security-review': { stage: 'security', enforced: true, telemetryKind: 'score' },
+    'production-readiness-review': { stage: 'production-readiness', enforced: true, telemetryKind: 'score' },
     // Fundraising
     'investor-pitch-preparation': { stage: 'fundraising', enforced: false },
     // Go-to-Market
@@ -73,6 +78,7 @@ exports.STAGE_DISPLAY_NAMES = {
     'product-quality': 'Product Quality',
     'test-quality': 'Test Quality',
     'security': 'Security',
+    'production-readiness': 'Production Readiness',
     'fundraising': 'Fundraising',
     'go-to-market': 'Go-to-Market',
 };
@@ -86,6 +92,7 @@ exports.ALL_STAGE_CATEGORIES = [
     'product-quality',
     'test-quality',
     'security',
+    'production-readiness',
     'fundraising',
     'go-to-market',
 ];
@@ -114,20 +121,85 @@ const GATE_REQUIRED_FIELDS = [
 const UNIVERSAL_REQUIRED_FIELDS = [
     { path: 'composite', type: 'number' },
 ];
+const SCORE_DIMENSION_REQUIRED_FIELDS = [
+    { suffix: 'score', type: 'number' },
+    { suffix: 'rationale', type: 'string' }
+];
+const QUALITY_SCORE_DIMENSIONS = {
+    'review-customer-development': [
+        'icpCoherence',
+        'interviewCoverage',
+        'evidenceQuality',
+        'patternSaturation',
+        'signalToProduct'
+    ],
+    'review-business-strategy': [
+        'marketEvidence',
+        'competitiveRigor',
+        'unitEconomics',
+        'strategicCoherence'
+    ],
+    'branding-quality-audit': [
+        'clarity',
+        'differentiation',
+        'coherence',
+        'proof',
+        'identityExpressiveness',
+        'governanceReadiness'
+    ],
+    'code-quality-assessment': [
+        'typeSafety',
+        'errorHandling',
+        'architecture',
+        'maintainability'
+    ],
+    'test-quality-assessment': [
+        'coverage',
+        'testIntegrity',
+        'testDesign',
+        'reliability'
+    ],
+    'security-review': [
+        'findingSeverity',
+        'remediationReadiness',
+        'coverageCompleteness'
+    ],
+    'production-readiness-review': [
+        'securityPosture',
+        'availabilityResilience',
+        'backupRestore',
+        'observabilityOps',
+        'releaseSafety',
+        'governanceRunbooks'
+    ]
+};
+function requiredDimensionFields(jobName) {
+    const dimensions = QUALITY_SCORE_DIMENSIONS[jobName] ?? [];
+    return dimensions.flatMap((dimension) => SCORE_DIMENSION_REQUIRED_FIELDS.map(({ suffix, type }) => ({
+        path: `${dimension}.${suffix}`,
+        type
+    })));
+}
 /**
  * Returns the required quality fields for a given job.
- * Customer-development jobs retain the strict V1 schema.
- * All other jobs require only a composite score (principle-based, not prescriptive).
+ * Gate-only jobs use the gate schema. The strict V1 interview schema is
+ * pinned to process-interview-notes for defense-in-depth on the
+ * /api/analytics/quality-score endpoint. Scored quality review jobs require
+ * their stage-specific rubric dimensions as direct `{ score, rationale }`
+ * properties so the Quality view can render those dimensions dynamically.
  */
 function getRequiredFieldsForJob(jobName) {
     const entry = exports.QUALITY_REGISTRY[jobName];
     if (entry?.telemetryKind === 'gate') {
         return GATE_REQUIRED_FIELDS;
     }
-    if (entry?.stage === 'customer-development') {
+    if (jobName === 'process-interview-notes') {
         return CUSTOMER_DEV_REQUIRED_FIELDS;
     }
-    return UNIVERSAL_REQUIRED_FIELDS;
+    return [
+        ...UNIVERSAL_REQUIRED_FIELDS,
+        ...requiredDimensionFields(jobName)
+    ];
 }
 /**
  * @deprecated Use getRequiredFieldsForJob() for stage-aware validation.
@@ -188,6 +260,9 @@ function buildQualityRejectionMessage(jobName, currentPhase, errors) {
     const entry = exports.QUALITY_REGISTRY[jobName];
     const isGateOnly = entry?.telemetryKind === 'gate';
     const isCustomerDev = entry?.stage === 'customer-development';
+    const dimensionExamples = (QUALITY_SCORE_DIMENSIONS[jobName] ?? ['marketEvidence', 'unitEconomics'])
+        .map((dimension) => `    ${dimension}: { score: <number>, rationale: "<string>" },`)
+        .join('\n');
     const schemaExample = isGateOnly
         ? [
             '```javascript',
@@ -226,9 +301,7 @@ function buildQualityRejectionMessage(jobName, currentPhase, errors) {
                 '  quality: {',
                 '    composite: <number 0-10>,',
                 '    coaching: "<actionable recommendation>",',
-                '    marketEvidence: { score: <number>, rationale: "<string>" }, // flat, NO "dimensions" wrapper',
-                '    unitEconomics: { score: <number>, rationale: "<string>" },',
-                '    // add other sub-scores as direct properties',
+                dimensionExamples,
                 '  }',
                 '}',
                 '```'

package/dist/src/core/utils/git-utils.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExplicitLocalRepoPath = isExplicitLocalRepoPath;
 exports.getPort = getPort;
 exports.determineDatabaseName = determineDatabaseName;
 exports.getCurrentGitBranch = getCurrentGitBranch;
@@ -7,6 +8,30 @@ exports.determineSchema = determineSchema;
 exports.getDefaultBranch = getDefaultBranch;
 exports.sanitizeRepoIdentifier = sanitizeRepoIdentifier;
 const child_process_1 = require("child_process");
+function extractLocalFolderLabel(rawPath) {
+    const normalized = rawPath
+        .trim()
+        .replace(/^file:\/\//i, '')
+        .replace(/\\/g, '/')
+        .replace(/\/+$/, '');
+    if (!normalized)
+        return undefined;
+    const parts = normalized.split('/').filter(Boolean);
+    const candidate = parts[parts.length - 1];
+    return candidate || undefined;
+}
+function isExplicitLocalRepoPath(repoUrl) {
+    if (!repoUrl || typeof repoUrl !== 'string') {
+        return false;
+    }
+    const trimmed = repoUrl.trim();
+    return (trimmed.startsWith('/') ||
+        trimmed.startsWith('\\') ||
+        /^[a-zA-Z]:[\\/]/.test(trimmed) ||
+        trimmed.startsWith('./') ||
+        trimmed.startsWith('../') ||
+        trimmed.startsWith('file://'));
+}
 /**
  * Gets a unique port based on the current git branch name (if it's an issue branch)
  * Default to 15302 if not on an issue branch
@@ -106,13 +131,9 @@ function sanitizeRepoIdentifier(repoUrl) {
         return undefined;
     }
     const trimmed = repoUrl.trim();
-    // Reject local paths (Windows and POSIX)
-    if (trimmed.startsWith('/') ||
-        trimmed.startsWith('\\') ||
-        /^[a-zA-Z]:\\/.test(trimmed) ||
-        trimmed.startsWith('./') ||
-        trimmed.startsWith('../')) {
-        return undefined;
+    // Convert local paths to just the folder name for privacy-safe workspace labeling.
+    if (isExplicitLocalRepoPath(trimmed)) {
+        return extractLocalFolderLabel(trimmed);
     }
     // Normalize GitHub/GitLab SSH and HTTPS URLs
     // Patterns:
@@ -144,5 +165,9 @@ function sanitizeRepoIdentifier(repoUrl) {
     catch (e) {
         // Not a valid URL
     }
+    // Preserve plain folder labels that are already privacy-safe and not path-like.
+    if (!trimmed.includes('/') && !trimmed.includes('\\') && !trimmed.includes('://')) {
+        return trimmed;
+    }
     return undefined;
 }