@aperant/framework 0.10.0 → 0.12.0

package/dist/cli/git/default-branch.mjs

@@ -0,0 +1,234 @@
+/**
+ * git/default-branch.mjs — local default-branch resolution + merged-PR parsing
+ * for the Team-Change Digest (LD-03/04/05).
+ *
+ * Pure git helpers (no .aperant IO). Every git call uses the no-throw
+ * execFileSync pattern from git/remote.mjs (stdio ['ignore','pipe','ignore'])
+ * so a non-git dir / unresolvable ref returns null instead of throwing.
+ *
+ * The resolver reads the LOCAL default-branch ref only — it NEVER calls
+ * `git fetch`. The digest surfaces work the user has actually pulled, not
+ * unfetched server state (ADR Consequences ¶1).
+ *
+ * @internal
+ */
+import { execFileSync } from 'node:child_process';
+/**
+ * Run a git command, returning trimmed stdout or null on any error.
+ * @param {string} targetDir
+ * @param {string[]} args
+ * @returns {string|null}
+ */
+function git(targetDir, args) {
+    try {
+        return execFileSync('git', args, {
+            cwd: targetDir,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the local default-branch ref, with its current sha. Resolution order:
+ *   1. `git symbolic-ref refs/remotes/origin/HEAD` (strip the
+ *      'refs/remotes/origin/' prefix);
+ *   2. `git config init.defaultBranch`;
+ *   3. existence check of `main` then `master` via `git rev-parse --verify`.
+ *
+ * NEVER fetches. Returns null outside a git repo or when nothing resolves.
+ *
+ * @param {string} targetDir
+ * @returns {{ branch: string, sha: string }|null}
+ */
+export function resolveLocalDefaultBranch(targetDir) {
+    // Fast bail when not a git repo.
+    if (git(targetDir, ['rev-parse', '--git-dir']) === null)
+        return null;
+    let branch = null;
+    // (1) origin/HEAD symbolic-ref — the authoritative "what main points at".
+    const originHead = git(targetDir, ['symbolic-ref', 'refs/remotes/origin/HEAD']);
+    if (originHead?.startsWith('refs/remotes/origin/')) {
+        branch = originHead.slice('refs/remotes/origin/'.length);
+    }
+    // (2) init.defaultBranch config.
+    if (!branch) {
+        const configured = git(targetDir, ['config', 'init.defaultBranch']);
+        if (configured)
+            branch = configured;
+    }
+    // (3) existence check main → master.
+    if (!branch) {
+        for (const candidate of ['main', 'master']) {
+            if (git(targetDir, ['rev-parse', '--verify', '--quiet', candidate]) !== null) {
+                branch = candidate;
+                break;
+            }
+        }
+    }
+    if (!branch)
+        return null;
+    const sha = git(targetDir, ['rev-parse', branch]);
+    if (!sha)
+        return null;
+    return { branch, sha };
+}
+/**
+ * Parse a PR number + title from a merge-commit subject/body.
+ *
+ * GitHub merge-commit format:
+ *   subject: "Merge pull request #N from owner/branch"
+ *   body:    "<PR title>"  (first non-empty body line)
+ * Squash-merge format:
+ *   subject: "<PR title> (#N)"
+ *
+ * @param {string} subject
+ * @param {string} body
+ * @returns {{ number: number, title: string }|null}
+ */
+function parsePullRequest(subject, body) {
+    const mergeMatch = subject.match(/^Merge pull request #(\d+) from /);
+    if (mergeMatch) {
+        const number = Number(mergeMatch[1]);
+        const firstBodyLine = (body || '')
+            .split('\n')
+            .map((l) => l.trim())
+            .find((l) => l.length > 0);
+        return { number, title: firstBodyLine || subject };
+    }
+    // GitHub squash-merge convention: greedy `(.*)` captures the longest prefix
+    // so titles with parentheses (e.g. "feat(core): ...") are handled correctly.
+    const squashMatch = subject.match(/^(.*)\s\(#(\d+)\)\s*$/);
+    if (squashMatch) {
+        return { number: Number(squashMatch[2]), title: squashMatch[1].trim() };
+    }
+    return null;
+}
+/**
+ * Resolve both the introduced-commit author emails (LD-05) and a display name
+ * from a single `git log` call per merge. Replaces the former separate
+ * `introducedAuthorEmails` + `pickAuthorName` pair (PRF-002).
+ *
+ * @param {string} targetDir
+ * @param {string[]} parents          parent shas of the merge commit
+ * @param {string} authorEmail        the merge commit's own author email
+ * @param {string} currentUserEmail   the user's git email (for name picking)
+ * @param {string} fallbackName       merge/commit author name when no better pick
+ * @returns {{ emails: string[], authorName: string }}
+ */
+function resolveIntroducedAuthors(targetDir, parents, authorEmail, currentUserEmail, fallbackName) {
+    if (parents.length >= 2) {
+        const raw = git(targetDir, ['log', `${parents[0]}..${parents[1]}`, '--format=%ae%x1f%an']);
+        if (raw) {
+            const emails = new Set();
+            let pickedName = null;
+            for (const line of raw.split('\n')) {
+                const [email, name] = line.split('\x1f');
+                if (!email)
+                    continue;
+                const normEmail = email.trim().toLowerCase();
+                if (normEmail.length > 0)
+                    emails.add(normEmail);
+                if (!pickedName && normEmail !== currentUserEmail) {
+                    pickedName = (name || fallbackName).trim();
+                }
+            }
+            if (emails.size > 0) {
+                return { emails: [...emails], authorName: pickedName || fallbackName.trim() };
+            }
+        }
+    }
+    const own = authorEmail.trim().toLowerCase();
+    return {
+        emails: own.length > 0 ? [own] : [],
+        authorName: fallbackName.trim(),
+    };
+}
+/**
+ * List merged PRs on the local default branch since `sinceSha`, attributed to
+ * whoever actually wrote the work (LD-04/05).
+ *
+ * Walks `git log --first-parent <sinceSha>..<defaultBranch>`. Each commit that
+ * parses as a PR (merge-commit or squash form) becomes one entry, attributed
+ * via its introduced-commit author emails. An entry is excluded only when ALL
+ * its introduced emails equal `currentUserEmail` (the user's own work) — so a
+ * PR the user merged but a teammate authored still appears.
+ *
+ * The scan is bounded (R3): at most `maxEntries * SCAN_MULTIPLIER` commits are
+ * inspected, so a stale marker can't enumerate an unbounded history.
+ *
+ * @param {string} targetDir
+ * @param {object} opts
+ * @param {string} opts.sinceSha            baseline sha (exclusive lower bound)
+ * @param {string} [opts.defaultBranch]     branch to walk to (default: resolved)
+ * @param {string} opts.currentUserEmail    the user's git email (own-work filter)
+ * @param {number} [opts.maxEntries=7]      cap on returned entries
+ * @returns {{ entries: Array<{ number: number, title: string, author: string }>, more_count: number }}
+ */
+export function listMergedPullRequests(targetDir, opts = {}) {
+    const empty = { entries: [], more_count: 0, more_capped: false };
+    const sinceSha = opts.sinceSha;
+    const maxEntries = Number.isInteger(opts.maxEntries) && opts.maxEntries > 0 ? opts.maxEntries : 7;
+    const currentUserEmail = (opts.currentUserEmail || '').trim().toLowerCase();
+    let defaultBranch = opts.defaultBranch;
+    if (!defaultBranch) {
+        const resolved = resolveLocalDefaultBranch(targetDir);
+        if (!resolved)
+            return empty;
+        defaultBranch = resolved.branch;
+    }
+    if (!sinceSha)
+        return empty;
+    if (!/^[0-9a-f]{7,40}$/i.test(sinceSha))
+        return empty;
+    const SCAN_MULTIPLIER = 4;
+    const scanCap = maxEntries * SCAN_MULTIPLIER;
+    // One commit per record, fields separated by \x1f, records by \x1e.
+    // %H sha · %P parents · %an author name · %ae author email · %s subject · %b body
+    const FIELD = '\x1f';
+    const RECORD = '\x1e';
+    const format = `%H${FIELD}%P${FIELD}%an${FIELD}%ae${FIELD}%s${FIELD}%b${RECORD}`;
+    const raw = git(targetDir, [
+        'log',
+        '--first-parent',
+        `--max-count=${scanCap}`,
+        `--format=${format}`,
+        `${sinceSha}..${defaultBranch}`,
+    ]);
+    if (!raw)
+        return empty;
+    const records = raw
+        .split(RECORD)
+        .map((r) => r.replace(/^\n+/, ''))
+        .filter((r) => r.trim().length > 0);
+    const matched = [];
+    for (const rec of records) {
+        const [sha, parentsRaw, authorName, authorEmail, subject, body] = rec.split(FIELD);
+        if (!sha)
+            continue;
+        const pr = parsePullRequest(subject || '', body || '');
+        if (!pr)
+            continue;
+        const parents = (parentsRaw || '').trim().split(/\s+/).filter(Boolean);
+        const { emails, authorName: resolvedAuthor } = resolveIntroducedAuthors(targetDir, parents, authorEmail || '', currentUserEmail, authorName || 'unknown');
+        // Exclude only when EVERY introduced commit is the current user's own.
+        const allOwn = currentUserEmail.length > 0 &&
+            emails.length > 0 &&
+            emails.every((e) => e === currentUserEmail);
+        if (allOwn)
+            continue;
+        matched.push({ number: pr.number, title: pr.title, author: resolvedAuthor });
+    }
+    const more_capped = records.length >= scanCap;
+    if (matched.length <= maxEntries) {
+        return { entries: matched, more_count: 0, more_capped };
+    }
+    return {
+        entries: matched.slice(0, maxEntries),
+        more_count: matched.length - maxEntries,
+        more_capped,
+    };
+}
+//# sourceMappingURL=default-branch.mjs.map

package/dist/cli/git/default-branch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-branch.mjs","sourceRoot":"","sources":["../../../src/cli/git/default-branch.mjs"],"names":[],"mappings":"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"}

package/dist/cli/git/identity.d.mts

@@ -1,17 +1,15 @@
 /**
  * Auto-detect the current user's git identity. Returns null if git config is unset.
+ * Memoized per targetDir for the process lifetime (git identity is stable within a CLI invocation).
  */
-export function getGitIdentity(targetDir: any): {
-    name: string;
-    email: string;
-} | null;
+export function getGitIdentity(targetDir: any): any;
 /**
  * Default owner string for roadmap phases when `--owner` is not passed.
  * Uses the current user's git identity name so solo developers are attributed
  * automatically. Team-mode skills can override by passing `--owner` explicitly
  * (typically after prompting against team.json members).
  */
-export function getDefaultOwner(targetDir: any): string;
+export function getDefaultOwner(targetDir: any): any;
 /**
  * Auto-detect the current git branch. Returns null if not in a git repo or detached HEAD.
  */

package/dist/cli/git/identity.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.mts","sourceRoot":"","sources":["../../../src/cli/git/identity.mjs"],"names":[],"mappings":"AAMA;;GAEG;AACH;;;SAeC;AAED;;;;;GAKG;AACH,wDAGC;AAED;;GAEG;AACH,gEAWC"}
+{"version":3,"file":"identity.d.mts","sourceRoot":"","sources":["../../../src/cli/git/identity.mjs"],"names":[],"mappings":"AAQA;;;GAGG;AACH,oDAkBC;AAED;;;;;GAKG;AACH,qDAGC;AAED;;GAEG;AACH,gEAWC"}

package/dist/cli/git/identity.mjs

@@ -2,10 +2,15 @@
  * identity.mjs — git user/branch auto-detection helpers (C29).
  */
 import { execSync } from 'node:child_process';
+const _identityCache = new Map();
 /**
  * Auto-detect the current user's git identity. Returns null if git config is unset.
+ * Memoized per targetDir for the process lifetime (git identity is stable within a CLI invocation).
  */
 export function getGitIdentity(targetDir) {
+    if (_identityCache.has(targetDir))
+        return _identityCache.get(targetDir);
+    let result = null;
     try {
         const name = execSync('git config user.name 2>/dev/null', {
             cwd: targetDir,
@@ -15,13 +20,14 @@ export function getGitIdentity(targetDir) {
             cwd: targetDir,
             encoding: 'utf-8',
         }).trim();
-        if (!name || !email)
-            return null;
-        return { name, email };
+        if (name && email)
+            result = { name, email };
     }
     catch {
-        return null;
+        /* no git config — result stays null */
     }
+    _identityCache.set(targetDir, result);
+    return result;
 }
 /**
  * Default owner string for roadmap phases when `--owner` is not passed.

package/dist/cli/git/identity.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"identity.mjs","sourceRoot":"","sources":["../../../src/cli/git/identity.mjs"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAS;IACvC,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,QAAQ,CAAC,kCAAkC,EAAE;YACzD,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SACjB,CAAC,CAAC,IAAI,EAAE,CAAA;QACT,MAAM,KAAK,GAAG,QAAQ,CAAC,mCAAmC,EAAE;YAC3D,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SACjB,CAAC,CAAC,IAAI,EAAE,CAAA;QACT,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QAChC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAS;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IAC1C,OAAO,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAS;IACzC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,QAAQ,CAAC,6CAA6C,EAAE;YACtE,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SACjB,CAAC,CAAC,IAAI,EAAE,CAAA;QACT,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,CAAA;QAC7C,OAAO,MAAM,CAAA;IACd,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC"}
+{"version":3,"file":"identity.mjs","sourceRoot":"","sources":["../../../src/cli/git/identity.mjs"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAE,CAAA;AAEhC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAS;IACvC,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACvE,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,QAAQ,CAAC,kCAAkC,EAAE;YACzD,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SACjB,CAAC,CAAC,IAAI,EAAE,CAAA;QACT,MAAM,KAAK,GAAG,QAAQ,CAAC,mCAAmC,EAAE;YAC3D,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SACjB,CAAC,CAAC,IAAI,EAAE,CAAA;QACT,IAAI,IAAI,IAAI,KAAK;YAAE,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACR,uCAAuC;IACxC,CAAC;IACD,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACrC,OAAO,MAAM,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAS;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IAC1C,OAAO,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAA;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAS;IACzC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,QAAQ,CAAC,6CAA6C,EAAE;YACtE,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,OAAO;SACjB,CAAC,CAAC,IAAI,EAAE,CAAA;QACT,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,CAAA;QAC7C,OAAO,MAAM,CAAA;IACd,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC"}

package/dist/cli/install/legacy-paths.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-paths.d.mts","sourceRoot":"","sources":["../../../src/cli/install/legacy-paths.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;GAMG;AAEH,gDAAgD;AAChD,mCADW,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CA+I1C;;kBArJY,MAAM;kBACN,MAAM;;;;;qBAEN,aAAa,CAAC,MAAM,CAAC"}
+{"version":3,"file":"legacy-paths.d.mts","sourceRoot":"","sources":["../../../src/cli/install/legacy-paths.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;GAMG;AAEH,gDAAgD;AAChD,mCADW,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAiJ1C;;kBAvJY,MAAM;kBACN,MAAM;;;;;qBAEN,aAAa,CAAC,MAAM,CAAC"}

package/dist/cli/install/legacy-paths.mjs

@@ -86,6 +86,7 @@ export const LEGACY_INSTALL_PATHS = Object.freeze({
             'agents/apt.md',
             'agents/apt-author-skill.md',
             'agents/apt-bootstrap.md',
+            'agents/apt-catch-up.md',
             'agents/apt-caveman.md',
             'agents/apt-classify.md',
             'agents/apt-close-task.md',
@@ -129,6 +130,7 @@ export const LEGACY_INSTALL_PATHS = Object.freeze({
             'commands/apt.md',
             'commands/apt-author-skill.md',
             'commands/apt-bootstrap.md',
+            'commands/apt-catch-up.md',
             'commands/apt-caveman.md',
             'commands/apt-classify.md',
             'commands/apt-close-task.md',

package/dist/cli/install/legacy-paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-paths.mjs","sourceRoot":"","sources":["../../../src/cli/install/legacy-paths.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"legacy-paths.mjs","sourceRoot":"","sources":["../../../src/cli/install/legacy-paths.mjs"],"names":[],"mappings":"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"}

package/dist/cli/install/mcp-server-specs.d.mts

@@ -3,17 +3,18 @@
  * triggers. A multi-surface monorepo (e.g. electron + nextjs) returns
  * multiple ids.
  *
- *   is_electron                          → ['electron']
- *   is_tauri                             → ['tauri']
- *   is_web_frontend|is_nextjs|is_nuxt    → ['agent-browser']
+ *   is_electron                                       → ['electron']
+ *   is_tauri                                          → ['tauri']
+ *   is_web_frontend|is_nextjs|is_nuxt                 → ['agent-browser']
+ *   is_ios_native|is_android_native|is_expo|is_react_native → ['mobile-mcp']
  *
  * Accepts a partial capability record — only the flags it reads need be
  * present (the rest default to absent/false).
  *
- * @param {Partial<import('../util/runtime-capabilities.mjs').RuntimeCapabilities>} runtimeCaps
+ * @param {Partial<import('../util/runtime-capabilities.mjs').RuntimeCapabilities> | null | undefined} runtimeCaps
  * @returns {string[]}
  */
-export function capabilityToProvisionIds(runtimeCaps: Partial<import("../util/runtime-capabilities.mjs").RuntimeCapabilities>): string[];
+export function capabilityToProvisionIds(runtimeCaps: Partial<import("../util/runtime-capabilities.mjs").RuntimeCapabilities> | null | undefined): string[];
 /**
  * install/mcp-server-specs.mjs — single-sourced install-time provision specs.
  *

package/dist/cli/install/mcp-server-specs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server-specs.d.mts","sourceRoot":"","sources":["../../../src/cli/install/mcp-server-specs.mjs"],"names":[],"mappings":"AA4EA;;;;;;;;;;;;;;GAcG;AACH,sDAHW,OAAO,CAAC,OAAO,kCAAkC,EAAE,mBAAmB,CAAC,GACrE,MAAM,EAAE,CAWpB;AApGD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;GAQG;AACH,8BAFU,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CA+BtC;;UApDa,YAAY;aACZ,MAAM;UACN,MAAM,EAAE;;;;;;;;UAKR,OAAO;aACP,MAAM;;;;0BACN,MAAM;;4BAEP,aAAa,GAAG,SAAS"}
+{"version":3,"file":"mcp-server-specs.d.mts","sourceRoot":"","sources":["../../../src/cli/install/mcp-server-specs.mjs"],"names":[],"mappings":"AAuFA;;;;;;;;;;;;;;;GAeG;AACH,sDAHW,OAAO,CAAC,OAAO,kCAAkC,EAAE,mBAAmB,CAAC,GAAG,IAAI,GAAG,SAAS,GACxF,MAAM,EAAE,CAmBpB;AAxHD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;GAQG;AACH,8BAFU,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CA0CtC;;UA/Da,YAAY;aACZ,MAAM;UACN,MAAM,EAAE;;;;;;;;UAKR,OAAO;aACP,MAAM;;;;0BACN,MAAM;;4BAEP,aAAa,GAAG,SAAS"}

package/dist/cli/install/mcp-server-specs.mjs

@@ -59,6 +59,17 @@ export const PROVISION_SPECS = {
         args: ['./scripts/tauri-mcp.sh'],
         requiresLauncherScript: true,
     },
+    'mobile-mcp': {
+        kind: 'mcp-server',
+        // Unified iOS + Android UI-driving server (Apache-2.0). Pure npm —
+        // the iOS/Android SYSTEM prereqs (idb-companion / adb / Xcode /
+        // Android SDK) are validated by the mobile driver's preflight, NOT
+        // installed here (decision D-09). Matches the driver manifest's
+        // transport.mcp_server_id = "mobile-mcp".
+        command: 'npx',
+        args: ['-y', '@mobilenext/mobile-mcp@latest'],
+        env: {},
+    },
     // kind 'skill'
     'agent-browser': {
         kind: 'skill',
@@ -76,14 +87,15 @@ export const PROVISION_SPECS = {
  * triggers. A multi-surface monorepo (e.g. electron + nextjs) returns
  * multiple ids.
  *
- *   is_electron                          → ['electron']
- *   is_tauri                             → ['tauri']
- *   is_web_frontend|is_nextjs|is_nuxt    → ['agent-browser']
+ *   is_electron                                       → ['electron']
+ *   is_tauri                                          → ['tauri']
+ *   is_web_frontend|is_nextjs|is_nuxt                 → ['agent-browser']
+ *   is_ios_native|is_android_native|is_expo|is_react_native → ['mobile-mcp']
  *
  * Accepts a partial capability record — only the flags it reads need be
  * present (the rest default to absent/false).
  *
- * @param {Partial<import('../util/runtime-capabilities.mjs').RuntimeCapabilities>} runtimeCaps
+ * @param {Partial<import('../util/runtime-capabilities.mjs').RuntimeCapabilities> | null | undefined} runtimeCaps
  * @returns {string[]}
  */
 export function capabilityToProvisionIds(runtimeCaps) {
@@ -97,6 +109,12 @@ export function capabilityToProvisionIds(runtimeCaps) {
     if (runtimeCaps.is_web_frontend || runtimeCaps.is_nextjs || runtimeCaps.is_nuxt) {
         ids.push('agent-browser');
     }
+    if (runtimeCaps.is_ios_native ||
+        runtimeCaps.is_android_native ||
+        runtimeCaps.is_expo ||
+        runtimeCaps.is_react_native) {
+        ids.push('mobile-mcp');
+    }
     return ids;
 }
 //# sourceMappingURL=mcp-server-specs.mjs.map

package/dist/cli/install/mcp-server-specs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server-specs.mjs","sourceRoot":"","sources":["../../../src/cli/install/mcp-server-specs.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,oBAAoB;IACpB,QAAQ,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACnC,qEAAqE;QACrE,GAAG,EAAE,EAAE;KACP;IACD,KAAK,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,qEAAqE;QACrE,mEAAmE;QACnE,6DAA6D;QAC7D,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,wBAAwB,CAAC;QAChC,sBAAsB,EAAE,IAAI;KAC5B;IACD,eAAe;IACf,eAAe,EAAE;QAChB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,eAAe;QACxB,uEAAuE;QACvE,qEAAqE;QACrE,4DAA4D;QAC5D,wEAAwE;QACxE,mEAAmE;QACnE,oBAAoB,EAAE,8CAA8C;KACpE;CACD,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAW;IACnD,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAC/D,IAAI,WAAW,CAAC,WAAW;QAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACjD,IAAI,WAAW,CAAC,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,WAAW,CAAC,eAAe,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACjF,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}
+{"version":3,"file":"mcp-server-specs.mjs","sourceRoot":"","sources":["../../../src/cli/install/mcp-server-specs.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,oBAAoB;IACpB,QAAQ,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACnC,qEAAqE;QACrE,GAAG,EAAE,EAAE;KACP;IACD,KAAK,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,qEAAqE;QACrE,mEAAmE;QACnE,6DAA6D;QAC7D,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,wBAAwB,CAAC;QAChC,sBAAsB,EAAE,IAAI;KAC5B;IACD,YAAY,EAAE;QACb,IAAI,EAAE,YAAY;QAClB,mEAAmE;QACnE,gEAAgE;QAChE,mEAAmE;QACnE,gEAAgE;QAChE,0CAA0C;QAC1C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,+BAA+B,CAAC;QAC7C,GAAG,EAAE,EAAE;KACP;IACD,eAAe;IACf,eAAe,EAAE;QAChB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,eAAe;QACxB,uEAAuE;QACvE,qEAAqE;QACrE,4DAA4D;QAC5D,wEAAwE;QACxE,mEAAmE;QACnE,oBAAoB,EAAE,8CAA8C;KACpE;CACD,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAW;IACnD,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAC/D,IAAI,WAAW,CAAC,WAAW;QAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACjD,IAAI,WAAW,CAAC,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,WAAW,CAAC,eAAe,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACjF,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC1B,CAAC;IACD,IACC,WAAW,CAAC,aAAa;QACzB,WAAW,CAAC,iBAAiB;QAC7B,WAAW,CAAC,OAAO;QACnB,WAAW,CAAC,eAAe,EAC1B,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}

package/dist/cli/roadmap/backend-adapter.d.mts

@@ -0,0 +1,43 @@
+/**
+ * Dispatch a roadmap write subcommand through the configured backend.
+ *
+ * Return shapes:
+ *   - markdown (default) → `{ backend: 'markdown', delegated: false }`
+ *     The caller proceeds with the existing markdown file-write path.
+ *   - cloud-mcp success  → `{ backend: 'cloud-mcp', delegated: true,
+ *                             result: <MCP response JSON> }`
+ *   - cloud-mcp error    → `{ backend: 'cloud-mcp', delegated: true,
+ *                             error: '<msg>', code?: <http>, status: 'error' }`
+ *
+ * The `error` branch is still `delegated: true` because the caller MUST
+ * NOT silently fall through to the markdown path when the user has
+ * opted into cloud-mcp — that would lose writes the user expected to
+ * land in Convex.
+ *
+ * @param {string} projectDir
+ * @param {string} subcommand
+ * @param {Record<string, unknown>} args
+ * @param {{ fetchImpl?: typeof fetch }} [opts]
+ * @returns {Promise<
+ *   | { backend: 'markdown', delegated: false }
+ *   | { backend: 'cloud-mcp', delegated: true, result: unknown }
+ *   | { backend: 'cloud-mcp', delegated: true, status: 'error', error: string, code?: number }
+ * >}
+ */
+export function dispatchRoadmapWrite(projectDir: string, subcommand: string, args: Record<string, unknown>, opts?: {
+    fetchImpl?: typeof fetch;
+}): Promise<{
+    backend: "markdown";
+    delegated: false;
+} | {
+    backend: "cloud-mcp";
+    delegated: true;
+    result: unknown;
+} | {
+    backend: "cloud-mcp";
+    delegated: true;
+    status: "error";
+    error: string;
+    code?: number;
+}>;
+//# sourceMappingURL=backend-adapter.d.mts.map

package/dist/cli/roadmap/backend-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-adapter.d.mts","sourceRoot":"","sources":["../../../src/cli/roadmap/backend-adapter.mjs"],"names":[],"mappings":"AA8FA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iDAVW,MAAM,cACN,MAAM,QACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SACvB;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAC1B,OAAO,CACb;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,KAAK,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAC3F,CAgHH"}