@triflux/remote 10.43.0 → 10.45.0

package/scripts/lib/agent-route-policy.mjs

@@ -0,0 +1,367 @@
+// Canonical Codex role policy. Concrete model IDs stay in profile config files.
+
+import {
+  normalizeCodexProfileName,
+  resolveCodexProfileConfigValues,
+} from "./codex-profile-config.mjs";
+
+const policy = {
+  executor: {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1080,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  codex: {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1080,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  "build-fixer": {
+    profile: "gpt56_luna_low",
+    timeoutSec: 540,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  cleanup: {
+    profile: "gpt56_terra_med",
+    timeoutSec: 540,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  deslop: {
+    profile: "gpt56_terra_med",
+    timeoutSec: 540,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  debugger: {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  "deep-executor": {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  architect: {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  critic: {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  planner: {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 3600,
+    runMode: "fg",
+    opusOversight: true,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  analyst: {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 3600,
+    runMode: "fg",
+    opusOversight: true,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  "code-reviewer": {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1800,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  "quality-reviewer": {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1800,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  "security-reviewer": {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 1800,
+    runMode: "bg",
+    opusOversight: true,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  scientist: {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1440,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  "document-specialist": {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1440,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  "scientist-deep": {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 3600,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "analyze",
+    subcommand: "exec",
+  },
+  verifier: {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1200,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  "test-engineer": {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1200,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  "qa-tester": {
+    profile: "gpt56_terra_high",
+    timeoutSec: 1200,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "review",
+    subcommand: "review",
+  },
+  spark: {
+    profile: "gpt56_luna_low",
+    timeoutSec: 180,
+    runMode: "fg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  // These entries are only for explicit direct-Codex overrides. agent-map.json
+  // remains the provider-selection authority for their normal execution.
+  designer: {
+    profile: "gpt6_astra_xhigh",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+  writer: {
+    profile: "gpt56_luna_low",
+    timeoutSec: 900,
+    runMode: "bg",
+    opusOversight: false,
+    mcpHint: "implement",
+    subcommand: "exec",
+  },
+};
+
+function freezePolicy(entry) {
+  return Object.freeze({ ...entry });
+}
+
+export const CODEX_AGENT_POLICY = Object.freeze(
+  Object.fromEntries(
+    Object.entries(policy).map(([agent, entry]) => [
+      agent,
+      freezePolicy(entry),
+    ]),
+  ),
+);
+export const DEFAULT_CODEX_AGENT = "executor";
+
+export const CANONICAL_CODEX_PROFILE_OVERRIDES = Object.freeze(
+  new Set([
+    "gpt56_luna_low",
+    "gpt56_terra_med",
+    "gpt56_terra_high",
+    "gpt6_astra_xhigh",
+    "gpt6_astra_max",
+    "gpt6_astra_ultra",
+  ]),
+);
+export const ULTRA_ELIGIBLE_CODEX_AGENTS = Object.freeze(
+  new Set(["deep-executor", "scientist-deep"]),
+);
+
+const NESTED_GLOBAL_PROFILE_OVERRIDES = new Set([
+  "max",
+  "ultra",
+  "gpt6_astra_max",
+  "gpt6_astra_ultra",
+]);
+
+export function resolveCodexAgentPolicy(agent) {
+  return freezePolicy(
+    CODEX_AGENT_POLICY[agent] ?? CODEX_AGENT_POLICY[DEFAULT_CODEX_AGENT],
+  );
+}
+
+/**
+ * Resolves a requested Codex profile against the canonical role policy.
+ *
+ * `retryProfile` intentionally wins over `profileOverride`: retry snapshots
+ * represent an already-selected escalation step and must not be replaced by a
+ * later process-level `TFX_CODEX_PROFILE`. Ultra is reserved for an eligible
+ * top-level role; every nested/sandboxed or ineligible request is max.
+ */
+export function resolveCodexAgentProfile(
+  agent,
+  {
+    profileOverride = "auto",
+    retryProfile = null,
+    nested = false,
+    allowCustom = false,
+  } = {},
+) {
+  const defaultProfile = resolveCodexAgentPolicy(agent).profile;
+  const retryRequested = String(retryProfile ?? "").trim();
+  const requested = normalizeCodexProfileName(
+    retryRequested || String(profileOverride || "auto").trim(),
+  );
+  if (!requested || requested === "auto") return defaultProfile;
+
+  const canonical =
+    requested === "max"
+      ? "gpt6_astra_max"
+      : requested === "ultra"
+        ? "gpt6_astra_ultra"
+        : requested;
+  if (!CANONICAL_CODEX_PROFILE_OVERRIDES.has(canonical)) {
+    if (allowCustom) return requested;
+    throw new Error(
+      `[agent-route-policy] unsupported profile override: ${requested}`,
+    );
+  }
+  if (canonical !== "gpt6_astra_ultra") return canonical;
+  return nested || !ULTRA_ELIGIBLE_CODEX_AGENTS.has(agent)
+    ? "gpt6_astra_max"
+    : canonical;
+}
+
+/**
+ * Nested headless, team, worker, and delegator launches always select an
+ * explicit role profile rather than inheriting the global Codex config. A
+ * custom profile that resolves to ultra is also downgraded to max.
+ */
+export function resolveNestedCodexAgentProfile(
+  agent,
+  {
+    profileOverride = "auto",
+    globalProfile = "auto",
+    retryProfile = null,
+    codexHome,
+  } = {},
+) {
+  const explicitProfile = String(profileOverride || "auto").trim();
+  const globalOverride = normalizeCodexProfileName(
+    String(globalProfile || "auto").trim(),
+  );
+  // Headless lanes must select their role policy explicitly. Only the max and
+  // ultra exception lanes may cross the process environment boundary.
+  const effectiveOverride =
+    explicitProfile !== "auto"
+      ? explicitProfile
+      : NESTED_GLOBAL_PROFILE_OVERRIDES.has(globalOverride)
+        ? globalOverride
+        : "auto";
+  const fallback = resolveCodexAgentProfile(agent);
+  const candidate = resolveCodexAgentProfile(agent, {
+    profileOverride: effectiveOverride,
+    retryProfile,
+    nested: true,
+    allowCustom: true,
+  });
+  const { effort } = resolveCodexProfileConfigValues(candidate, { codexHome });
+  if (!effort) return fallback;
+  return effort.toLowerCase() === "ultra" ? "gpt6_astra_max" : candidate;
+}
+
+export function describeCodexAgentPolicy() {
+  return {
+    defaultAgent: DEFAULT_CODEX_AGENT,
+    agents: Object.keys(CODEX_AGENT_POLICY),
+  };
+}
+
+function parseCliArgs(argv) {
+  const args = [...argv];
+  let format = "json";
+  let agent = DEFAULT_CODEX_AGENT;
+  while (args.length > 0) {
+    const flag = args.shift();
+    if (flag === "--format") format = args.shift() || "";
+    else if (flag === "--agent") agent = args.shift() || "";
+    else throw new Error(`unknown argument: ${flag}`);
+  }
+  if (!new Set(["json", "tsv"]).has(format)) {
+    throw new Error(`unsupported format: ${format}`);
+  }
+  return { format, agent };
+}
+
+function runCli() {
+  const { format, agent } = parseCliArgs(process.argv.slice(2));
+  const resolved = resolveCodexAgentPolicy(agent);
+  if (format === "tsv") {
+    process.stdout.write(
+      [
+        resolved.profile,
+        resolved.timeoutSec,
+        resolved.runMode,
+        resolved.opusOversight,
+        resolved.mcpHint,
+        resolved.subcommand,
+      ].join("\t"),
+    );
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(resolved)}\n`);
+}
+
+if (import.meta.url === new URL(process.argv[1], "file:").href) {
+  try {
+    runCli();
+  } catch (error) {
+    process.stderr.write(`[agent-route-policy] ${error.message}\n`);
+    process.exitCode = 1;
+  }
+}

package/scripts/lib/cli-agy.mjs

@@ -1,12 +1,18 @@
 // cli-agy.mjs — Antigravity (agy) CLI adapter (Phase 0 PoC).
 //
-// 책임: agy --print 는 stdin-only 이므로 plan() 에서 stdinMode="pipe" 시그널을 반환한다.
-// positional prompt 패턴은 환영 메시지 폴백을 유발하므로 사용 금지.
+// 책임: agy 1.1.27 부터 --print 는 값(프롬프트)이 필수이고 stdin 프롬프트는 거부되므로
+// plan() 은 프롬프트를 args 의 --print 값으로 넣고 stdinMode="argv" 를 돌려준다.
+// --print 뒤에 다른 플래그가 오면 그 플래그를 프롬프트로 삼키므로 항상 마지막에 둔다.
 //
 // 출처: scripts/tfx-route.sh route_agent() L1052-L1059, run_codex_exec() L2036-L2046.
 //        .claude/rules/tfx-update-logic.md Antigravity CLI 1.0.0 정밀 sanity matrix.
 // timeoutSec은 lane 예상 소요 시간(advisory)이다. hard ceiling 집행은 Bash route가 소유한다.
 
+import {
+  resolveGeminiModel,
+  resolveGeminiProfileForPurpose,
+} from "./gemini-profiles.mjs";
+
 export const id = "agy";
 export const cliType = "antigravity";
 export const command = "agy";
@@ -38,6 +44,7 @@ export function plan({
   mcpProfile = "auto",
   timeoutSec,
   contextFile,
+  geminiProfilesPath,
 } = {}) {
   if (!agent) {
     throw new Error("[cli-agy] agent required");
@@ -49,8 +56,21 @@ export function plan({
     command,
     profile: cfg.profile,
     effort: cfg.profile,
-    args: ["--print", "--dangerously-skip-permissions"],
-    stdinMode: "pipe",
+    // effort 는 역할별 SSOT(gemini-profiles.mjs): designer → High, writer → Medium ...
+    geminiProfile: resolveGeminiProfileForPurpose(agent),
+    model: resolveGeminiModel(resolveGeminiProfileForPurpose(agent), {
+      profilesPath: geminiProfilesPath,
+    }),
+    args: [
+      "--dangerously-skip-permissions",
+      "--model",
+      resolveGeminiModel(resolveGeminiProfileForPurpose(agent), {
+        profilesPath: geminiProfilesPath,
+      }),
+      "--print",
+      prompt,
+    ],
+    stdinMode: "argv",
     timeoutMs: effectiveTimeoutSec * 1000,
     runMode: cfg.runMode,
     opusOversight: cfg.opusOversight,

package/scripts/lib/cli-codex.mjs

@@ -4,169 +4,23 @@
 // 산출한다. 실제 spawn 은 Phase 1 에서 이관된다 (현재는 tfx-route.sh 가 수행).
 //
 // 진입점: tfx-route.mjs → selectAdapter("codex") → plan({...}).
-// 출처: scripts/tfx-route.sh route_agent() L1001-L1079 case 문 미러.
+// 출처: agent-route-policy.mjs 의 canonical Codex role policy.
 // timeoutSec은 lane 예상 소요 시간(advisory)이다. hard ceiling 집행은 Bash route가 소유한다.
 
 export const id = "codex";
 export const cliType = "codex";
 export const command = "codex";
 
-const AGENT_PROFILES = {
-  executor: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1080,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  codex: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1080,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  "build-fixer": {
-    profile: "gpt56_luna_low",
-    timeoutSec: 540,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  cleanup: {
-    profile: "gpt56_terra_med",
-    timeoutSec: 540,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  deslop: {
-    profile: "gpt56_terra_med",
-    timeoutSec: 540,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  debugger: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 900,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  "deep-executor": {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "implement",
-  },
-  architect: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  critic: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  planner: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "fg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  analyst: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "fg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  "code-reviewer": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1800,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  "quality-reviewer": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1800,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  "security-reviewer": {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 1800,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  scientist: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1440,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "analyze",
-  },
-  "document-specialist": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1440,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "analyze",
-  },
-  "scientist-deep": {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "analyze",
-  },
-  verifier: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1200,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  "test-engineer": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1200,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  "qa-tester": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1200,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  spark: {
-    profile: "gpt56_luna_low",
-    timeoutSec: 180,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-};
+import {
+  CODEX_AGENT_POLICY,
+  resolveCodexAgentPolicy,
+  resolveCodexAgentProfile,
+  resolveNestedCodexAgentProfile,
+} from "./agent-route-policy.mjs";
 
-const DEFAULT_PROFILE = AGENT_PROFILES.executor;
+// Compatibility re-exports for launchers which historically imported these
+// helpers from this adapter. The policy module owns the semantics.
+export { resolveCodexAgentProfile, resolveNestedCodexAgentProfile };
 
 export function plan({
   agent,
@@ -174,18 +28,26 @@ export function plan({
   mcpProfile = "auto",
   timeoutSec,
   contextFile,
+  profileOverride = "auto",
+  retryProfile = null,
+  nested = false,
 } = {}) {
   if (!agent) {
     throw new Error("[cli-codex] agent required");
   }
-  const cfg = AGENT_PROFILES[agent] ?? DEFAULT_PROFILE;
+  const cfg = resolveCodexAgentPolicy(agent);
+  const profile = resolveCodexAgentProfile(agent, {
+    profileOverride,
+    retryProfile,
+    nested,
+  });
   const effectiveTimeoutSec =
     Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : cfg.timeoutSec;
   return {
     command,
     subcommand: cfg.subcommand ?? "exec",
-    profile: cfg.profile,
-    effort: cfg.profile,
+    profile,
+    effort: profile,
     timeoutMs: effectiveTimeoutSec * 1000,
     runMode: cfg.runMode,
     opusOversight: cfg.opusOversight,
@@ -196,5 +58,5 @@ export function plan({
 }
 
 export function describe() {
-  return { id, cliType, command, agents: Object.keys(AGENT_PROFILES) };
+  return { id, cliType, command, agents: Object.keys(CODEX_AGENT_POLICY) };
 }