@loicngr/kobo 1.7.7 → 1.7.9

package/dist/server/services/settings-service.js

@@ -1,11 +1,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { WORKTREES_PATH } from '../../shared/consts.js';
+import { isValidProjectColor } from '../../shared/project-colors.js';
+import { isValidSkillSuite } from '../../shared/skill-suite-prompts.js';
 import { listClaudeMcpEntries } from '../utils/mcp-client.js';
 import { getSettingsPath } from '../utils/paths.js';
 import { InvalidWorktreesPathError, resolveGlobalWorktreesRoot, sanitizeWorktreesPath, validateWorktreesPath, } from '../utils/worktree-paths.js';
 import { DEFAULT_NOTION_INITIAL_PROMPT, DEFAULT_SENTRY_INITIAL_PROMPT } from './initial-prompt-template-service.js';
 import { DEFAULT_REVIEW_PROMPT_TEMPLATE } from './review-template-service.js';
+import { AGNOSTIC_PROMPTS } from './skill-suite-prompts.js';
 export const DEFAULT_GIT_CONVENTIONS = `# Git conventions
 
 ## Commits
@@ -299,6 +302,101 @@ const settingsMigrations = [
                 global.voiceSuppressNonSpeechTokens = true;
         },
     },
+    {
+        version: 19,
+        name: 'split-default-model-by-engine',
+        // Codex was added alongside Claude Code; the single `defaultModel` is now
+        // ambiguous (different engines have different model catalogues). Split it
+        // into a per-engine map. Preserve the legacy value as the claude-code
+        // default for back-compat, and seed codex with `'auto'`.
+        migrate({ global }) {
+            const existing = global.defaultModelByEngine;
+            if (typeof existing !== 'object' || existing === null || Array.isArray(existing)) {
+                const legacyModel = typeof global.defaultModel === 'string' && global.defaultModel.length > 0
+                    ? global.defaultModel
+                    : 'auto';
+                global.defaultModelByEngine = {
+                    'claude-code': legacyModel,
+                    codex: 'auto',
+                };
+            }
+            else {
+                // Backfill any missing engine entries idempotently.
+                const map = existing;
+                if (typeof map['claude-code'] !== 'string')
+                    map['claude-code'] = 'auto';
+                if (typeof map.codex !== 'string')
+                    map.codex = 'auto';
+            }
+            // Drop the legacy field once migrated.
+            delete global.defaultModel;
+        },
+    },
+    {
+        version: 20,
+        name: 'split-default-permission-mode-by-engine',
+        // Mirrors v19 for permission modes. Both engines accept the full mode set.
+        migrate({ global }) {
+            const existing = global.defaultPermissionModeByEngine;
+            const legacyMode = typeof global.defaultPermissionMode === 'string' && global.defaultPermissionMode.length > 0
+                ? global.defaultPermissionMode
+                : 'plan';
+            if (typeof existing !== 'object' || existing === null || Array.isArray(existing)) {
+                global.defaultPermissionModeByEngine = {
+                    'claude-code': legacyMode,
+                    codex: legacyMode,
+                };
+            }
+            else {
+                const map = existing;
+                if (typeof map['claude-code'] !== 'string')
+                    map['claude-code'] = legacyMode;
+                if (typeof map.codex !== 'string')
+                    map.codex = legacyMode;
+            }
+            delete global.defaultPermissionMode;
+        },
+    },
+    {
+        version: 21,
+        name: 'add-project-color-and-flatten',
+        migrate: ({ global, projects }) => {
+            if (typeof global.flattenWorkspaceList !== 'boolean') {
+                global.flattenWorkspaceList = false;
+            }
+            for (const p of projects) {
+                if (!('color' in p) || (p.color !== null && !isValidProjectColor(p.color))) {
+                    ;
+                    p.color = null;
+                }
+            }
+        },
+    },
+    {
+        version: 22,
+        name: 'add-skill-suite-selector',
+        // Auto-migrate every existing user to `superpowers` (the closest match to
+        // today's behaviour). New installs get the same default via
+        // `defaultSettings()`. The 4 `custom*` fields seed with the agnostic
+        // baseline so users switching to `custom` mode have a sane editable start.
+        migrate: ({ global }) => {
+            if (!isValidSkillSuite(global.skillSuite)) {
+                global.skillSuite = 'superpowers';
+            }
+            if (typeof global.customReviewTemplate !== 'string') {
+                global.customReviewTemplate = AGNOSTIC_PROMPTS.reviewTemplate;
+            }
+            if (typeof global.customAutoLoopReviewGate !== 'string') {
+                global.customAutoLoopReviewGate = AGNOSTIC_PROMPTS.autoLoopReviewGate;
+            }
+            if (typeof global.customAutoLoopGroomingIntro !== 'string') {
+                global.customAutoLoopGroomingIntro = AGNOSTIC_PROMPTS.autoLoopGroomingIntro;
+            }
+            if (typeof global.customQaPromptTemplate !== 'string') {
+                global.customQaPromptTemplate = AGNOSTIC_PROMPTS.qaPromptTemplate;
+            }
+        },
+    },
 ];
 /** Current settings schema version — always equals the highest migration version. */
 export const SETTINGS_SCHEMA_VERSION = settingsMigrations.length > 0 ? settingsMigrations[settingsMigrations.length - 1].version : 0;
@@ -326,7 +424,7 @@ function defaultSettings() {
     return {
         schemaVersion: SETTINGS_SCHEMA_VERSION,
         global: {
-            defaultModel: 'claude-opus-4-7',
+            defaultModelByEngine: { 'claude-code': 'auto', codex: 'auto' },
             dangerouslySkipPermissions: true,
             prPromptTemplate: DEFAULT_PR_PROMPT_TEMPLATE,
             reviewPromptTemplate: DEFAULT_REVIEW_PROMPT_TEMPLATE,
@@ -340,7 +438,7 @@ function defaultSettings() {
             audioNotificationVolume: 1,
             notionStatusProperty: '',
             notionInProgressStatus: '',
-            defaultPermissionMode: 'plan',
+            defaultPermissionModeByEngine: { 'claude-code': 'plan', codex: 'plan' },
             notionMcpKey: '',
             sentryMcpKey: '',
             tags: [...DEFAULT_WORKSPACE_TAGS],
@@ -356,6 +454,12 @@ function defaultSettings() {
             voicePrompt: '',
             voiceTranslateToEnglish: false,
             voiceSuppressNonSpeechTokens: true,
+            flattenWorkspaceList: false,
+            skillSuite: 'superpowers',
+            customReviewTemplate: AGNOSTIC_PROMPTS.reviewTemplate,
+            customAutoLoopReviewGate: AGNOSTIC_PROMPTS.autoLoopReviewGate,
+            customAutoLoopGroomingIntro: AGNOSTIC_PROMPTS.autoLoopGroomingIntro,
+            customQaPromptTemplate: AGNOSTIC_PROMPTS.qaPromptTemplate,
         },
         projects: [],
     };
@@ -385,6 +489,7 @@ function defaultProjectSettings(projectPath) {
         finalization: {
             prompt: DEFAULT_FINALIZATION_PROMPT,
         },
+        color: null,
     };
 }
 function pickKnownKeys(data, allowedKeys) {
@@ -540,8 +645,9 @@ export function getEffectiveSettings(projectPath) {
     const settings = readSettings();
     const project = settings.projects.find((p) => p.path === projectPath) ?? null;
     if (!project) {
+        const claudeCodeDefault = settings.global.defaultModelByEngine?.['claude-code'] ?? 'auto';
         return {
-            model: settings.global.defaultModel,
+            model: claudeCodeDefault,
             dangerouslySkipPermissions: settings.global.dangerouslySkipPermissions,
             prPromptTemplate: settings.global.prPromptTemplate,
             reviewPromptTemplate: settings.global.reviewPromptTemplate,
@@ -555,8 +661,14 @@ export function getEffectiveSettings(projectPath) {
             notionInProgressStatus: settings.global.notionInProgressStatus,
         };
     }
+    // `model` here is the legacy single-string field exposed via EffectiveSettings
+    // for back-compat with existing callers. The engine-aware default lives in
+    // `global.defaultModelByEngine[engineId]` and is read directly by the create
+    // flow / settings UI. Fall back through claude-code's entry (the historical
+    // semantics) so this field never goes empty.
+    const claudeCodeDefault = settings.global.defaultModelByEngine?.['claude-code'] ?? 'auto';
     return {
-        model: project.defaultModel || settings.global.defaultModel,
+        model: project.defaultModel || claudeCodeDefault,
         dangerouslySkipPermissions: project.dangerouslySkipPermissions ?? settings.global.dangerouslySkipPermissions,
         prPromptTemplate: project.prPromptTemplate || settings.global.prPromptTemplate,
         reviewPromptTemplate: project.reviewPromptTemplate || settings.global.reviewPromptTemplate,
@@ -573,8 +685,16 @@ export function getEffectiveSettings(projectPath) {
 /** Merge partial updates into global settings and persist. */
 export function updateGlobalSettings(data) {
     const settings = readSettings();
+    // Validate skillSuite before merging: drop invalid values so the previous
+    // value is preserved (same pattern as `upsertProject`'s color validation).
+    if ('skillSuite' in data) {
+        if (!isValidSkillSuite(data.skillSuite)) {
+            console.warn(`[settings] Invalid skillSuite value rejected: ${data.skillSuite}`);
+            delete data.skillSuite;
+        }
+    }
     const allowedGlobalKeys = [
-        'defaultModel',
+        'defaultModelByEngine',
         'dangerouslySkipPermissions',
         'prPromptTemplate',
         'reviewPromptTemplate',
@@ -588,7 +708,7 @@ export function updateGlobalSettings(data) {
         'audioNotificationVolume',
         'notionStatusProperty',
         'notionInProgressStatus',
-        'defaultPermissionMode',
+        'defaultPermissionModeByEngine',
         'notionMcpKey',
         'sentryMcpKey',
         'tags',
@@ -604,6 +724,12 @@ export function updateGlobalSettings(data) {
         'voicePrompt',
         'voiceTranslateToEnglish',
         'voiceSuppressNonSpeechTokens',
+        'flattenWorkspaceList',
+        'skillSuite',
+        'customReviewTemplate',
+        'customAutoLoopReviewGate',
+        'customAutoLoopGroomingIntro',
+        'customQaPromptTemplate',
     ];
     const filtered = pickKnownKeys(data, allowedGlobalKeys);
     if (filtered.tags !== undefined) {
@@ -647,6 +773,13 @@ function isNonNativeWindowsPath(value) {
 }
 /** Create or update project-specific settings. Merges devServer, e2e, and finalization fields on update. */
 export function upsertProject(projectPath, data) {
+    // Validate color: accept null or a valid palette entry; drop anything else.
+    if ('color' in data) {
+        if (data.color !== null && !isValidProjectColor(data.color)) {
+            console.warn(`[settings] Invalid color value rejected for project '${projectPath}': ${data.color}`);
+            delete data.color;
+        }
+    }
     const allowedProjectKeys = [
         'displayName',
         'defaultSourceBranch',
@@ -661,6 +794,7 @@ export function upsertProject(projectPath, data) {
         'devServer',
         'e2e',
         'finalization',
+        'color',
     ];
     const allowedDevServerKeys = ['startCommand', 'stopCommand'];
     const allowedE2eKeys = ['framework', 'skill', 'prompt'];

package/dist/server/services/skill-suite-prompts.js

@@ -0,0 +1,80 @@
+import { AGNOSTIC_AUTO_LOOP_GROOMING_INTRO, AGNOSTIC_AUTO_LOOP_REVIEW_GATE, AGNOSTIC_QA_PROMPT_TEMPLATE, AGNOSTIC_REVIEW_TEMPLATE, GROOMING_INTRO_GSTACK, GROOMING_INTRO_SUPERPOWERS, } from '../../shared/skill-suite-prompts.js';
+// Headers and body shared with the agnostic baseline. We reconstruct them
+// locally here so the suite-specific text can sit between header and body
+// in the same shape across all 3 suites.
+const REVIEW_HEADER = `You are reviewing code changes on workspace "{{workspace_name}}" in project {{project_name}}.
+
+Branch: {{branch_name}}  (base: {{source_branch}})
+Base commit: {{base_commit}}
+
+`;
+const REVIEW_BODY = `## Scope
+
+Review ALL changes — both committed and uncommitted in the working tree:
+- \`git diff {{base_commit}}..HEAD\` — committed changes on this branch
+- \`git status\` and \`git diff\` — uncommitted changes (staged + unstaged)
+
+## Diff summary
+{{diff_stats}}
+
+## Commits
+{{commits}}
+
+## Additional instructions
+{{additional_instructions}}
+
+## Output
+
+If no review skill is available, structure your reply as:
+1. Summary — what changed and why
+2. Issues — bugs, regressions, security or perf concerns (with file:line)
+3. Suggestions — refactor / improvement opportunities
+4. Tests — coverage gaps
+5. Verdict — ship / fix-then-ship / blocked
+`;
+export const SUPERPOWERS_PROMPTS = {
+    reviewTemplate: REVIEW_HEADER +
+        'If a code-review skill is available (e.g. superpowers:requesting-code-review), invoke it to drive this review. Otherwise follow the steps below directly.\n\n' +
+        REVIEW_BODY,
+    autoLoopReviewGate: 'Code review gate — BEFORE marking the task done, dispatch an independent code-reviewer subagent via the Task tool with `subagent_type: "code-reviewer"` (or `"superpowers:code-reviewer"` / `"pr-review-toolkit:code-reviewer"` — use whichever exists in this environment; fall back to `superpowers:requesting-code-review` skill if none is available). Brief the reviewer with: what you just implemented, the task title, and the commit SHA (via `git rev-parse HEAD`). Ask specifically whether the change matches the task scope, whether edge cases are handled, and whether the commit is clean.',
+    autoLoopGroomingIntro: GROOMING_INTRO_SUPERPOWERS,
+    qaPromptTemplate: 'QA pass for workspace "{{workspace_name}}" in project {{project_name}}.\n\nBranch: {{branch_name}}\nStaging URL: {{staging_url}}\n\nIf a QA-style skill that drives a real browser is available in this environment (e.g. via the superpowers-chrome browsing skill), use it to navigate the staging URL and exercise the changes. Otherwise, fall back to manually scripting the smoke checks and recording your findings as a bug report.',
+};
+export const GSTACK_PROMPTS = {
+    reviewTemplate: REVIEW_HEADER +
+        'Run /review to drive this audit (the gstack Staff Engineer skill — finds bugs that pass CI but blow up in production, auto-fixes the obvious ones, flags completeness gaps). If /review is unavailable in this environment, fall back to the manual checklist below.\n\n' +
+        REVIEW_BODY,
+    autoLoopReviewGate: 'Code review gate — BEFORE marking the task done, run /review (the gstack Staff Engineer skill). Brief it with: what you just implemented, the task title, and the commit SHA (via `git rev-parse HEAD`). Ask specifically whether the change matches the task scope, whether edge cases are handled, and whether the commit is clean. If /review auto-fixes minor issues, accept the fixes via an amend or fix-up commit, then re-run step 3 checks.',
+    autoLoopGroomingIntro: GROOMING_INTRO_GSTACK,
+    qaPromptTemplate: 'QA pass for workspace "{{workspace_name}}" in project {{project_name}}.\n\nBranch: {{branch_name}}\nStaging URL: {{staging_url}}\n\nRun /qa {{staging_url}} (gstack QA Lead skill — opens a real browser, clicks through flows, finds bugs, fixes them with atomic commits, generates regression tests). If you only want a bug report without code changes, use /qa-only {{staging_url}} instead.',
+};
+export const AGNOSTIC_PROMPTS = {
+    reviewTemplate: AGNOSTIC_REVIEW_TEMPLATE,
+    autoLoopReviewGate: AGNOSTIC_AUTO_LOOP_REVIEW_GATE,
+    autoLoopGroomingIntro: AGNOSTIC_AUTO_LOOP_GROOMING_INTRO,
+    qaPromptTemplate: AGNOSTIC_QA_PROMPT_TEMPLATE,
+};
+/**
+ * Resolve the suite prompts to use right now, given the global `skillSuite`
+ * and the four user-editable `custom*` fields (only consulted in `custom` mode).
+ * Empty-string or whitespace-only overrides fall back to AGNOSTIC defaults.
+ */
+export function getSuitePrompts(suite, overrides) {
+    if (suite === 'superpowers')
+        return SUPERPOWERS_PROMPTS;
+    if (suite === 'gstack')
+        return GSTACK_PROMPTS;
+    // custom mode: per-field fallback to AGNOSTIC when the override is missing/blank
+    const pick = (k) => {
+        const value = overrides[k];
+        if (typeof value !== 'string')
+            return AGNOSTIC_PROMPTS[k];
+        return value.trim() ? value : AGNOSTIC_PROMPTS[k];
+    };
+    return {
+        reviewTemplate: pick('reviewTemplate'),
+        autoLoopReviewGate: pick('autoLoopReviewGate'),
+        autoLoopGroomingIntro: pick('autoLoopGroomingIntro'),
+        qaPromptTemplate: pick('qaPromptTemplate'),
+    };
+}

package/dist/server/utils/git-ops.js

@@ -409,21 +409,80 @@ export function getPrUrl(repoPath, branchName) {
         return null;
     }
 }
-/** Get the state and URL of the PR for a branch. Returns null if no PR exists. */
+const GH_PR_FIELDS = [
+    'number',
+    'title',
+    'url',
+    'state',
+    'baseRefName',
+    'reviewDecision',
+    'author',
+    'assignees',
+    'labels',
+    'latestReviews',
+    'reviewRequests',
+    'reviewThreads',
+    'statusCheckRollup',
+    'updatedAt',
+].join(',');
+function mapGhPrToSnapshot(raw) {
+    const reviewers = [];
+    const seen = new Set();
+    for (const r of raw.latestReviews ?? []) {
+        const login = r.author?.login;
+        if (!login || seen.has(login))
+            continue;
+        seen.add(login);
+        reviewers.push({ login, state: r.state ?? 'COMMENTED' });
+    }
+    for (const r of raw.reviewRequests ?? []) {
+        if (!r.login || seen.has(r.login))
+            continue;
+        seen.add(r.login);
+        reviewers.push({ login: r.login, state: 'PENDING' });
+    }
+    const checks = (raw.statusCheckRollup ?? []).map((c) => ({
+        name: c.name,
+        conclusion: c.conclusion ?? null,
+        status: c.status,
+        detailsUrl: c.detailsUrl ?? null,
+    }));
+    let rollup = null;
+    if (checks.length > 0) {
+        if (checks.some((c) => c.conclusion === 'FAILURE'))
+            rollup = 'FAILURE';
+        else if (checks.some((c) => c.status !== 'COMPLETED'))
+            rollup = 'PENDING';
+        else
+            rollup = 'SUCCESS';
+    }
+    const unresolvedReviewThreadsCount = (raw.reviewThreads ?? []).reduce((acc, t) => acc + (t.isResolved ? 0 : 1), 0);
+    return {
+        number: raw.number,
+        title: raw.title,
+        url: raw.url,
+        state: raw.state,
+        base: raw.baseRefName ?? '',
+        reviewDecision: raw.reviewDecision ?? null,
+        author: { login: raw.author?.login ?? '' },
+        assignees: (raw.assignees ?? []).map((a) => ({ login: a.login })),
+        reviewers,
+        labels: (raw.labels ?? []).map((l) => ({ name: l.name, color: l.color })),
+        ci: { rollup, checks },
+        updatedAt: raw.updatedAt ?? '',
+        unresolvedReviewThreadsCount,
+    };
+}
+/** Get a rich snapshot of the PR for a branch. Returns null if no PR exists. */
 export function getPrStatus(repoPath, branchName) {
     try {
-        const raw = execFileSync('gh', ['pr', 'view', branchName, '--json', 'state,url,baseRefName'], {
+        const raw = execFileSync('gh', ['pr', 'view', branchName, '--json', GH_PR_FIELDS], {
             cwd: repoPath,
             encoding: 'utf-8',
         }).trim();
         if (!raw)
             return null;
-        const parsed = JSON.parse(raw);
-        return {
-            state: parsed.state,
-            url: parsed.url,
-            base: parsed.baseRefName || undefined,
-        };
+        return mapGhPrToSnapshot(JSON.parse(raw));
     }
     catch {
         return null;
@@ -766,19 +825,14 @@ export async function getPrUrlAsync(repoPath, branchName) {
 /** Async version of getPrStatus. Returns null if no PR exists. */
 export async function getPrStatusAsync(repoPath, branchName) {
     try {
-        const { stdout } = await execFileAsync('gh', ['pr', 'view', branchName, '--json', 'state,url,baseRefName'], {
+        const { stdout } = await execFileAsync('gh', ['pr', 'view', branchName, '--json', GH_PR_FIELDS], {
             cwd: repoPath,
             encoding: 'utf-8',
         });
         const raw = stdout.trim();
         if (!raw)
             return null;
-        const parsed = JSON.parse(raw);
-        return {
-            state: parsed.state,
-            url: parsed.url,
-            base: parsed.baseRefName || undefined,
-        };
+        return mapGhPrToSnapshot(JSON.parse(raw));
     }
     catch {
         return null;

package/dist/server/utils/paths.js

@@ -100,8 +100,15 @@ export function getTemplatesPath() {
  * Absolute path to the compiled MCP server entry (shipped in the published
  * package as dist/mcp-server/kobo-tasks-server.js). Returns null if not
  * present — callers (orchestrator) then fall back to the TS source for dev.
+ *
+ * `KOBO_ENFORCE_LOCAL_HOME=1` (set by `npm run dev`) forces the source path
+ * even if a stale `dist/mcp-server/` from a prior `npm run build` is hanging
+ * around. Without this guard, edits to `kobo-tasks-server.ts` are silently
+ * ignored during dev (the orchestrator spawns the months-old compiled binary).
  */
 export function getCompiledMcpServerPath() {
+    if (process.env.KOBO_ENFORCE_LOCAL_HOME === '1')
+        return null;
     const compiled = getPackageAssetPath('dist', 'mcp-server', 'kobo-tasks-server.js');
     return fs.existsSync(compiled) ? compiled : null;
 }

package/dist/shared/auto-loop-prompts.js

@@ -16,7 +16,24 @@
  *
  * `AUTO_LOOP_HARD_RULES` is the trailing hard-rules block, same for both.
  */
-export const PREP_AUTOLOOP_INTRO = `You are preparing this workspace for Kōbō auto-loop mode. This is a GROOMING session only — DO NOT implement anything, DO NOT write or edit code, DO NOT run tests or builds, DO NOT invoke \`superpowers:executing-plans\` or any implementation skill. Your ONLY job is to curate the Kōbō task list via MCP tools.`;
+import { getGroomingIntro } from './skill-suite-prompts.js';
+/**
+ * Build the grooming intro for the chosen skill suite. In `custom` mode the
+ * user's `customAutoLoopGroomingIntro` overrides the agnostic default (when
+ * non-empty). This is the runtime-correct way to obtain the intro — every
+ * new consumer should call this rather than reading the legacy
+ * `PREP_AUTOLOOP_INTRO` constant below.
+ */
+export function buildGroomingIntro(suite, customOverride) {
+    return getGroomingIntro(suite, customOverride);
+}
+/**
+ * Back-compat alias resolving to the `superpowers` variant (the historical
+ * inlined text). Kept so any existing import still works without a
+ * behaviour change. New code should call `buildGroomingIntro(suite, override)`
+ * with live settings so the user's `skillSuite` choice is honoured.
+ */
+export const PREP_AUTOLOOP_INTRO = getGroomingIntro('superpowers');
 export function buildAutoLoopGroomingSteps(e2e, finalization) {
     const steps = [
         `1. Call \`kobo__list_tasks\` FIRST to inspect any pre-existing tasks (they may have been seeded from Notion, a template, or the CreatePage form).`,

package/dist/shared/codex-models.js

@@ -0,0 +1,43 @@
+/**
+ * Codex model catalogue — kept in sync with the official roster published at
+ * developers.openai.com/codex/models. The Codex CLI accepts arbitrary strings
+ * in `--model`, so power users can still pin a model not listed here by
+ * editing the workspace `model` field directly. This list reflects the
+ * recommended set surfaced in the create-workspace selector.
+ *
+ * Auth caveat: `gpt-5.5` is currently only reachable when authenticated via
+ * ChatGPT (Plus/Pro/Team/Enterprise). API-key auth is limited to `gpt-5.4`
+ * and below.
+ */
+export const CODEX_MODELS = [
+    {
+        id: 'auto',
+        label: 'Auto',
+        i18nLabelKey: 'model.auto',
+        i18nDescriptionKey: 'model.autoDescription',
+    },
+    {
+        id: 'gpt-5.5',
+        label: 'GPT-5.5',
+        i18nLabelKey: 'model.gpt55',
+        i18nDescriptionKey: 'model.gpt55Description',
+    },
+    {
+        id: 'gpt-5.4',
+        label: 'GPT-5.4',
+        i18nLabelKey: 'model.gpt54',
+        i18nDescriptionKey: 'model.gpt54Description',
+    },
+    {
+        id: 'gpt-5.4-mini',
+        label: 'GPT-5.4 mini',
+        i18nLabelKey: 'model.gpt54mini',
+        i18nDescriptionKey: 'model.gpt54miniDescription',
+    },
+    {
+        id: 'gpt-5.3-codex',
+        label: 'GPT-5.3 Codex',
+        i18nLabelKey: 'model.gpt53codex',
+        i18nDescriptionKey: 'model.gpt53codexDescription',
+    },
+];

package/dist/shared/project-colors.js

@@ -0,0 +1,23 @@
+/**
+ * Curated palette for per-project colours. Quasar colour keys at the `-5`
+ * intensity — picked to read well against Kōbō's dark theme. Append-only —
+ * existing values must never move or be removed (settings.json may reference
+ * them). New colours can be added at the end.
+ */
+export const PROJECT_COLOR_PALETTE = [
+    'red-5',
+    'pink-5',
+    'purple-5',
+    'deep-purple-5',
+    'indigo-5',
+    'blue-5',
+    'cyan-5',
+    'teal-5',
+    'green-5',
+    'amber-5',
+    'orange-5',
+    'brown-5',
+];
+export function isValidProjectColor(value) {
+    return typeof value === 'string' && PROJECT_COLOR_PALETTE.includes(value);
+}

package/dist/shared/skill-suite-prompts.js

@@ -0,0 +1,66 @@
+// src/shared/skill-suite-prompts.ts
+export function isValidSkillSuite(value) {
+    return value === 'superpowers' || value === 'gstack' || value === 'custom';
+}
+// ── Agnostic prompt strings ───────────────────────────────────────────────────
+// These are the neutral, suite-free versions used both:
+//   1. As the seed for `custom` mode (so the user has a sane base to edit).
+//   2. As building blocks for the backend full prompt sets in
+//      `src/server/services/skill-suite-prompts.ts`.
+//
+// They MUST NOT mention any specific skill suite by name.
+const REVIEW_HEADER = `You are reviewing code changes on workspace "{{workspace_name}}" in project {{project_name}}.
+
+Branch: {{branch_name}}  (base: {{source_branch}})
+Base commit: {{base_commit}}
+
+`;
+const REVIEW_BODY = `## Scope
+
+Review ALL changes — both committed and uncommitted in the working tree:
+- \`git diff {{base_commit}}..HEAD\` — committed changes on this branch
+- \`git status\` and \`git diff\` — uncommitted changes (staged + unstaged)
+
+## Diff summary
+{{diff_stats}}
+
+## Commits
+{{commits}}
+
+## Additional instructions
+{{additional_instructions}}
+
+## Output
+
+If no review skill is available, structure your reply as:
+1. Summary — what changed and why
+2. Issues — bugs, regressions, security or perf concerns (with file:line)
+3. Suggestions — refactor / improvement opportunities
+4. Tests — coverage gaps
+5. Verdict — ship / fix-then-ship / blocked
+`;
+export const AGNOSTIC_REVIEW_TEMPLATE = REVIEW_HEADER +
+    'If a code-review skill is available in this environment, invoke it to drive this audit. Otherwise follow the manual checklist below.\n\n' +
+    REVIEW_BODY;
+export const AGNOSTIC_AUTO_LOOP_REVIEW_GATE = 'Code review gate — BEFORE marking the task done, run whichever code-review skill is configured in this environment. Brief it with: what you just implemented, the task title, and the commit SHA (via `git rev-parse HEAD`). Ask specifically whether the change matches the task scope, whether edge cases are handled, and whether the commit is clean. If no review skill is available, do a manual self-review against the same criteria.';
+export const AGNOSTIC_AUTO_LOOP_GROOMING_INTRO = 'You are preparing this workspace for Kōbō auto-loop mode. This is a GROOMING session only — DO NOT implement anything, DO NOT write or edit code, DO NOT run tests or builds, DO NOT invoke any implementation, planning, or release skill (your environment may have several). Your ONLY job is to curate the Kōbō task list via MCP tools.';
+export const AGNOSTIC_QA_PROMPT_TEMPLATE = 'QA pass for workspace "{{workspace_name}}" in project {{project_name}}.\n\nBranch: {{branch_name}}\nStaging URL: {{staging_url}}\n\nIf a QA skill is configured in this environment, invoke it on {{staging_url}}. Otherwise, manually exercise the staging URL against the workspace\'s acceptance criteria and report findings.';
+// ── Grooming intro: superpowers + gstack variants ────────────────────────────
+// Only the grooming intro is needed shared (both backend auto-loop-prompts and
+// frontend kobo-commands use it). The review/review-gate/QA variants are
+// backend-only — they live in src/server/services/skill-suite-prompts.ts.
+export const GROOMING_INTRO_SUPERPOWERS = 'You are preparing this workspace for Kōbō auto-loop mode. This is a GROOMING session only — DO NOT implement anything, DO NOT write or edit code, DO NOT run tests or builds, DO NOT invoke `superpowers:executing-plans` or any implementation skill. Your ONLY job is to curate the Kōbō task list via MCP tools.';
+export const GROOMING_INTRO_GSTACK = 'You are preparing this workspace for Kōbō auto-loop mode. This is a GROOMING session only — DO NOT implement anything, DO NOT write or edit code, DO NOT run tests or builds, DO NOT invoke `/ship`, `/autoplan`, `/land-and-deploy`, or any implementation skill. Your ONLY job is to curate the Kōbō task list via MCP tools.';
+/**
+ * Resolve the grooming intro for the given suite. In `custom` mode, the
+ * user-provided override is used (or AGNOSTIC if the override is empty/blank).
+ */
+export function getGroomingIntro(suite, customOverride) {
+    if (suite === 'custom') {
+        const trimmed = (customOverride ?? '').trim();
+        return trimmed || AGNOSTIC_AUTO_LOOP_GROOMING_INTRO;
+    }
+    if (suite === 'gstack')
+        return GROOMING_INTRO_GSTACK;
+    return GROOMING_INTRO_SUPERPOWERS;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loicngr/kobo",
-  "version": "1.7.7",
+  "version": "1.7.9",
   "description": "Kōbō — multi-workspace agent manager for Claude Code. Orchestrates isolated git worktrees with dev servers, Notion integration, and MCP tools.",
   "type": "module",
   "license": "GPL-3.0-or-later",
@@ -71,6 +71,7 @@
     "@emnapi/runtime": "^1.10.0",
     "@hono/node-server": "^2.0.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@openai/codex": "^0.130.0",
     "better-sqlite3": "^12.9.0",
     "cron-parser": "^5.5.0",
     "hono": "^4.12.18",