@aperant/framework 0.16.0 → 0.19.0

package/src/cli/commands/spar-resolve-partner.mjs

@@ -0,0 +1,85 @@
+/**
+ * commands/spar-resolve-partner.mjs — live partner-model resolver for `apt:spar`.
+ *
+ * Layer 1 cmd (returns { envelope, exitCode } via ok()/err() — never calls
+ * process.exit / output() / fail() directly; the Layer 2 wrapper in dispatch.mjs
+ * writes stdout and exits).
+ *
+ * `apt-tools spar-resolve-partner --partner <codex|claude|gemini>` returns the
+ * model the codex MCP rung must pass, read LIVE from `~/.codex/config.toml` with
+ * no baked default (Decision B + C). For claude / gemini the MCP rung needs no
+ * model arg, so the command returns `reason: 'self_resolving'` + `model: null`.
+ *
+ * Each envelope carries an EXPLICIT transport preference (plan-gate spar
+ * refinement #2): codex returns `prefer_self_resolving: true` +
+ * `recommended_walk: ['plugin','cli','mcp']` so the SKILL agent walks the
+ * self-resolving rungs first and only tries the model-naming MCP rung last. The
+ * `detect.mjs` `partner_transports` array stays MCP-first (ID-02); the agent
+ * follows THIS returned preference rather than inferring rung order from prose.
+ */
+
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { resolveCodexSparModel } from '../host/codex-config.mjs'
+import { err, ok } from '../util/result.mjs'
+
+/**
+ * Parse `--partner <id>` from the positional args. Defaults to `codex`
+ * (the only partner whose MCP rung requires a model arg).
+ *
+ * @param {string[]} args
+ * @returns {string}
+ */
+function parsePartner(args) {
+	if (!Array.isArray(args)) return 'codex'
+	const idx = args.indexOf('--partner')
+	if (idx === -1 || idx === args.length - 1) return 'codex'
+	return String(args[idx + 1]).toLowerCase()
+}
+
+/**
+ * @param {string[]} [args]
+ * @returns {{ envelope: object, exitCode: number }}
+ */
+export function cmdSparResolvePartner(args = []) {
+	const partner = parsePartner(args)
+
+	if (partner === 'codex') {
+		const { available, model, source, reason } = resolveCodexSparModel({
+			home: homedir(),
+			existsSync,
+			readFileSync,
+		})
+		return ok({
+			status: 'ok',
+			command: 'spar-resolve-partner',
+			partner: 'codex',
+			available,
+			model,
+			source,
+			reason,
+			// Refinement #2 — explicit transport preference the SKILL FOLLOWS.
+			prefer_self_resolving: true,
+			recommended_walk: ['plugin', 'cli', 'mcp'],
+		})
+	}
+
+	if (partner === 'claude' || partner === 'gemini') {
+		return ok({
+			status: 'ok',
+			command: 'spar-resolve-partner',
+			partner,
+			available: true,
+			model: null,
+			source: null,
+			reason: 'self_resolving',
+			prefer_self_resolving: false,
+			recommended_walk: ['mcp', 'plugin', 'cli'],
+		})
+	}
+
+	return err(`Unknown partner: ${partner}. Expected codex, claude, or gemini.`, 1, {
+		command: 'spar-resolve-partner',
+		partner,
+	})
+}