elanous 0.2.34 → 0.2.35

package/src/task-agent/task-hand.ts

@@ -17,6 +17,7 @@ import { validateUnitCalls } from '../graph-runner/runner.js';
 import { parseGraphTemplateYaml } from '../self-implement/graph-yaml.js';
 import { resolveDaemonHarnessTarget } from '../intake-plane/harness-target.js';
 import { HARNESS_RUN_ID_ENV, mintRunId, normalizeRunId } from '../harness/harness-space.js';
+import { newLaunchUtteranceId, recordLaunchUtterance } from '../harness/launch-utterance-ledger.js';
 import { debug } from '../debug/log.js';
 import { effectiveInstanceRoot } from '../instance/resolve.js';
 import { withFileLockSync } from '../storage/file-lock.js';
@@ -51,38 +52,35 @@ function missingOrReadFailure(error: unknown): '없다' | '읽기 실패' {
   return code === 'ENOENT' || code === 'ENOTDIR' ? '없다' : '읽기 실패';
 }
 
-/**
- * TA-WORK-ORDER — `.work-order.json` 골 파일의 내용을 지시서로 검증한다.
- * 통과하면 골 문면으로 펼쳐 `work-order` 로, 깨진 JSON·칸 id 없음은 `rejected`(사유) 로 돌린다.
- * 관측: `debug.log('task-agent.work-order', 'parsed' | 'rejected', { cellId, unknownFields })`.
- */
-function resolveWorkOrderFile(content: string, path: string): ResolvedHandText {
-  const parsed = parseWorkOrder(content);
-  if (!parsed.ok) {
-    try { debug.log('task-agent.work-order', 'rejected', { cellId: null, unknownFields: [] }); } catch { /* fail-soft */ }
-    return { kind: 'rejected', path, reason: parsed.reason };
-  }
-  try { debug.log('task-agent.work-order', 'parsed', { cellId: parsed.order.cellId, unknownFields: parsed.order.unknownFields }); } catch { /* fail-soft */ }
-  return { kind: 'work-order', text: renderWorkOrderGoal(parsed.order), path, order: parsed.order };
-}
-
-/** 파일 판정만 한다. 관측과 카드 작성은 호출자가 결과에 따라 수행한다. */
+/** 파일 판정만 한다. 카드 작성은 호출자가 결과에 따라 수행한다. */
 export function resolveHandText(text: string, deps: ResolveHandTextDeps = { cwd: process.cwd(), stat: statSync, readFile: readFileSync }): ResolvedHandText {
-  if (!text || /\s/.test(text)) return { kind: 'unchanged', text };
+  const workOrder = WORK_ORDER_FILE_PATTERN.test(text);
+  if (!text || (/\s/.test(text) && !workOrder)) return { kind: 'unchanged', text };
   const path = resolve(deps.cwd, text);
   const extension = /\.(?:md|markdown|txt)$/i.test(text);
+  const reject = (reason: string): ResolvedHandText => {
+    if (workOrder) {
+      try { debug.log('task-agent.work-order', 'rejected', { cellId: null, unknownFields: [] }); } catch { /* fail-soft */ }
+    }
+    return { kind: 'rejected', path, reason };
+  };
   let file: Pick<Stats, 'isFile' | 'isDirectory'>;
   try { file = deps.stat(path); } catch (error) {
-    if (!extension) return { kind: 'unchanged', text };
-    return { kind: 'rejected', path, reason: missingOrReadFailure(error) };
+    if (!extension && !workOrder) return { kind: 'unchanged', text };
+    return reject(missingOrReadFailure(error));
   }
-  if (!file.isFile() && !extension && !file.isDirectory()) return { kind: 'unchanged', text };
-  if (!file.isFile()) return { kind: 'rejected', path, reason: file.isDirectory() ? '디렉터리' : '읽기 실패' };
+  if (!file.isFile() && !extension && !workOrder && !file.isDirectory()) return { kind: 'unchanged', text };
+  if (!file.isFile()) return reject(file.isDirectory() ? '디렉터리' : '읽기 실패');
   let content: string;
   // stat 과 read 사이에 지워지거나 경로가 바뀌어도 사유는 같은 규칙(없다/읽기 실패)으로 가른다.
-  try { content = deps.readFile(path, 'utf8'); } catch (error) { return { kind: 'rejected', path, reason: missingOrReadFailure(error) }; }
+  try { content = deps.readFile(path, 'utf8'); } catch (error) { return reject(missingOrReadFailure(error)); }
   // TA-WORK-ORDER — 지시서 골 파일은 인라인하지 않고 지시서로 검증해 골 문면으로 펼친다.
-  if (WORK_ORDER_FILE_PATTERN.test(text)) return resolveWorkOrderFile(content, path);
+  if (workOrder) {
+    const parsed = parseWorkOrder(content);
+    if (!parsed.ok) return reject(parsed.reason);
+    try { debug.log('task-agent.work-order', 'parsed', { cellId: parsed.order.cellId, unknownFields: parsed.order.unknownFields }); } catch { /* fail-soft */ }
+    return { kind: 'work-order', text: renderWorkOrderGoal(parsed.order), path, order: parsed.order };
+  }
   const carried = content.trim();
   if (!carried) return { kind: 'rejected', path, reason: '비었다' };
   return { kind: 'inlined', text: content, path, chars: carried.length, sha256: createHash('sha256').update(carried).digest('hex') };
@@ -305,6 +303,11 @@ export interface TaskCard {
   childLlm?: TaskChildLlm;
   /** Dispatch difficulty, fixed at handoff so repair uses the same judgement. */
   tier?: '하' | '중' | '상' | '특';
+  /**
+   * TIER-SPLIT-BEFORE-LAUNCH — 상·특 hand 를 분해해 나온 조각 카드(`tier-split.ts`). group = 같은 hand 에서 나온 조각들의 묶음 id
+   * (칸 연결은 `checklistId` 가 그대로 잇는다) · fromTier = 원래 난이도 · unavoidable = 상으로 남은 조각의 불가피 이유.
+   */
+  tierSplit?: { group: string; fromTier: '상' | '특'; index: number; total: number; unavoidable?: string };
   /** RUN-IDENTITY-TAGS — 출생 신분 묶음(`run-identity.js` 정본): 칸 우선순위·대표 표시에서 태어나고 `--tag k=v` 가 덮는다. 카드 상태 파일이 원장 정본이다. */
   identity?: RunIdentity;
   /** Same-PR repair launches; exact source head and worker result are retained for CAS and retry limits. */
@@ -577,7 +580,7 @@ export function shellQuote(arg: string): string {
 }
 
 /** 발사기에 넘기는 연결 — env(`ELANOUS_RUN_ID`)를 자식 환경에 얹으면 하니스 런이 `runId` 로 돈다(`resolveRunIdentity` 상속). launchId 는 카드에만 남는 발사 토큰이다. */
-export interface TaskLaunchContext { runId: string; launchId: string; env: Record<string, string>; cardLabelContext?: TaskCardLabelContext; substrate?: 'pod'; podGoal?: string; effectiveChildProvider?: string }
+export interface TaskLaunchContext { runId: string; launchId: string; env: Record<string, string>; /** exact untrimmed hand text (launch-utterance ledger pair) */ launchUtterance?: string; cardLabelContext?: TaskCardLabelContext; substrate?: 'pod'; podGoal?: string; effectiveChildProvider?: string }
 /** 발사기가 «이 런 id 로 띄웠다»고 돌려주는 영수증 — 없으면 카드에 런 id 를 적지 않는다(추측하지 않는다). */
 export interface TaskLaunchReceipt {
   runId?: string;
@@ -597,12 +600,18 @@ export interface HandTaskOptions {
   goal?: string;
   milestone?: string;
   live?: boolean;
+  /** Production `tasks hand --live` guard; test launchers opt in explicitly. */
+  preflightGoalDoneBoundary?: boolean;
   /** TA-LIVE-LAND-2 — `--ta-land`: card field `taLand` ⊕ launch env `ELANOUS_TA_LAND=1`. */
   taLand?: boolean;
   /** TASKS-HAND-CHILD-LLM — `<provider>/<model>`(`parseChildLlm`) ⊕ 선택 추론 노력. effort 만 주면 거부. */
   childLlm?: string;
   childLlmEffort?: string;
   tier?: TaskCard['tier'];
+  /** TIER-SPLIT-BEFORE-LAUNCH — 조각 카드에 싣는 분해 연결(`tier-split.ts` 만 준다). */
+  tierSplit?: TaskCard['tierSplit'];
+  /** TIER-SPLIT-BEFORE-LAUNCH — 분해 실패 사유. 주면 카드를 발사 없이 failed(history `tier-split-failed`)로 남기고 launched:false 로 돌아온다. */
+  tierSplitBlocked?: string;
   /** RUN-IDENTITY-TAGS — `tasks hand --tag k=v`(반복): 출생 신분을 덮는다. 목록 밖 값은 거부한다(`run-identity.js`). */
   tags?: string[];
   /** RUN-IDENTITY-TAGS — 칸 읽기 seam(우선순위·대표 표시). 주면 그 답이 최종이다(«칸 없음» 포함). */
@@ -682,6 +691,7 @@ export function dispatchDeliverableCompletion(id: string, input: { ref: string;
 export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
   const text = opts.text.trim();
   if (!text) throw new Error('과제 한 줄이 비어 있다');
+  const path = opts.statePath ?? taskAgentStatePath();
   const targetPathHints = parseAskTargetPathHintsResult(text);
   const targetPaths = canonicalTargetPaths(targetPathHints.paths);
   if (opts.seat !== undefined && !TASK_SEATS.includes(opts.seat)) throw new Error(`자리는 ${TASK_SEATS.join('|')} 중 하나다: ${opts.seat}`);
@@ -691,6 +701,7 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
   }
   if (opts.childLlmEffort !== undefined && opts.childLlm === undefined) throw new Error('--child-llm-effort 는 --child-llm <provider>/<model> 과 함께 준다');
   if (opts.tier !== undefined && !['하', '중', '상', '특'].includes(opts.tier)) throw new Error(`--tier 는 하|중|상|특 중 하나다: ${opts.tier}`);
+  const tierSplitBlocked = opts.tierSplitBlocked;
   // RUN-IDENTITY-TAGS — 출생 신분: 칸 우선순위(P0 = critical·special·protect · P1 = normal · 그 외 normal)·대표 표시에서 단다.
   // `--tag k=v`(반복) 이 덮는다 — 칸·태그 없는 손은 오늘 모양 그대로다(신분 없음). 목록 밖 값은 카드를 적기 전에 거부한다(`run-identity.js` 정본).
   const birthCell = opts.checklistId === undefined ? undefined
@@ -732,7 +743,6 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
   const now = (opts.now ?? (() => new Date()))();
   const id = opts.id ?? `${TASK_CARD_PREFIX}${now.toISOString().slice(0, 10).replaceAll('-', '')}-${randomBytes(3).toString('hex')}`;
   const mode = opts.live ? 'live' : 'shadow';
-  const path = opts.statePath ?? taskAgentStatePath();
   const card: TaskCard = {
     id, text,
     ...(!targetPathHints.labelMissing ? { targetPaths } : {}),
@@ -749,18 +759,21 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
     ...(opts.taLand === true ? { taLand: true as const } : {}),
     ...(childLlm ? { childLlm } : {}),
     ...(opts.tier ? { tier: opts.tier } : {}),
+    ...(opts.tierSplit ? { tierSplit: opts.tierSplit } : {}),
     ...(identity ? { identity } : {}),
     createdAt: now.toISOString(),
-    status: selectionFailure ? 'failed' : 'handed',
+    status: selectionFailure || tierSplitBlocked !== undefined ? 'failed' : 'handed',
     history: selectionFailure ? [{ at: now.toISOString(), event: !selected.composition ? 'composition-missing'
-      : selected.error ? 'composition-invalid' : 'composition-launcher-unavailable', detail: selectionFailure }] : [],
+      : selected.error ? 'composition-invalid' : 'composition-launcher-unavailable', detail: selectionFailure }]
+      : tierSplitBlocked !== undefined ? [{ at: now.toISOString(), event: 'tier-split-failed', detail: `tier-split-failed: ${tierSplitBlocked}` }] : [],
     ...(opts.mission ? { mission: opts.mission, after: [...(opts.after ?? [])] } : {}),
     ...(opts.cardFields?.pr !== undefined ? { pr: opts.cardFields.pr } : {}),
     ...(opts.cardFields?.goalId !== undefined ? { goalId: opts.cardFields.goalId } : {}),
     ...(opts.cardFields?.handed !== undefined ? { handed: opts.cardFields.handed } : {}),
   };
   const move = selectionFailure ? undefined : nextMoveFor(card, opts.landed);
-  if (move && move.kind !== 'launch') throw new Error(`발사할 수 없는 과제다 — ${move.reason}`);
+  // 분해 실패로 막은 카드는 wait(failed 사유)가 정답이다 — 던지지 않고 카드를 적은 뒤 발사 0 으로 돌아간다.
+  if (move && move.kind !== 'launch' && tierSplitBlocked === undefined) throw new Error(`발사할 수 없는 과제다 — ${move.reason}`);
   const guard = opts.writeGuard;
   const writeCard = (target: string, next: TaskCard): void => {
     if (!guard) { writeTaskCards(target, [next]); return; }
@@ -775,6 +788,15 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
     });
     if (!owned.ok) throw new TaskCardSupersededError(next.id);
   };
+  // Production Pod launches use the remote-parent lint's shared boundary judge.
+  // Injected launchers are test seams and opt in explicitly at the contract test.
+  if (opts.live && opts.preflightGoalDoneBoundary && !selectionFailure && move?.kind === 'launch') {
+    readTaskAgentState(path);
+    const { missing } = inspectGoalDoneBoundary(text);
+    if (missing.length > 0) {
+      throw new Error(`goal-revision-required: 완료 경계 누락 ${missing.join(' · ')} — 골 문면에 완료 경계 코드·완료 경계 실물·완료 경계 증거 명령을 적은 뒤 다시 넘기세요`);
+    }
+  }
   writeCard(path, card);
   try { debug.log('task-agent.hand', 'target-paths', { card: id, count: targetPaths.length, labelMissing: targetPathHints.labelMissing }); } catch { /* fail-soft */ }
   try { debug.log('task-agent.graph-select', !selected.composition ? 'composition-missing' : selected.error ? 'composition-invalid' : 'composition-selected', {
@@ -783,6 +805,7 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
     ...(selected.error ? { error: selected.error } : {}),
   }); } catch { /* fail-soft */ }
   if (selectionFailure) throw new Error(`${selectionFailure} (카드 ${id})`);
+  if (tierSplitBlocked !== undefined && move) return { card, move, mode, launched: false, ...(project ? { cwd: project.target } : {}) };
   if (!move || move.kind !== 'launch') throw new Error('조합 선택 뒤 발사 수가 없다');
   try { debug.log('task-agent', 'handed', { taskId: id, seat: card.seat ?? null, checklistId: card.checklistId ?? null, mode, projectId: project?.id ?? null, targetIsGit, taLand: card.taLand === true, runPriority: card.identity ? runPriorityClass(card.identity) : null }); } catch { /* fail-soft */ }
   if (childLlm) {
@@ -790,17 +813,6 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
   }
   if (mode === 'shadow') return { card, move, mode, launched: false, ...(project ? { cwd: project.target } : {}) };
   if (!opts.launcher) throw new Error('--live 인데 launcher 가 없다');
-  if (completion === 'code-pr' && card.checklistId) {
-    const { missing } = inspectGoalDoneBoundary(text);
-    if (missing.length > 0) {
-      const reason = `goal-revision-required: 완료 경계 누락 ${missing.join(' · ')} — 골 문면을 고친 뒤 다시 넘기세요`;
-      const failed: TaskCard = { ...card, status: 'failed', history: [...card.history,
-        { at: (opts.now ?? (() => new Date()))().toISOString(), event: 'goal-revision-required', detail: reason }] };
-      writeCard(path, failed);
-      try { debug.log('task-agent.hand', 'done-boundary-missing', { taskId: id, checklistId: card.checklistId ?? null, missing, reason }); } catch { /* fail-soft */ }
-      throw new Error(`${reason} (카드 ${id})`);
-    }
-  }
   let prelaunch: AlreadyDoneDecision;
   try { prelaunch = completion === 'code-pr'
     ? (opts.prelaunchInspector ?? ((input, target) => inspectPrelaunchAlreadyDone(input, target,
@@ -817,8 +829,9 @@ export async function handTask(opts: HandTaskOptions): Promise<HandTaskResult> {
     return { card: candidate, move: nextMoveFor(candidate), mode, launched: false, ...(project ? { cwd: project.target } : {}) };
   }
   const runId = mintRunId();
-  const launchId = `tl-${randomBytes(6).toString('hex')}`;
-  const context: TaskLaunchContext = { runId, launchId, env: { [HARNESS_RUN_ID_ENV]: runId, ELANOUS_TASK_CARD_ID: card.id,
+  const launchId = newLaunchUtteranceId();
+  recordLaunchUtterance({ source: 'hand', utterance: opts.text, launchId });
+  const context: TaskLaunchContext = { runId, launchId, launchUtterance: opts.text, env: { [HARNESS_RUN_ID_ENV]: runId, ELANOUS_TASK_CARD_ID: card.id,
     ...(cardPrNumber(card) ? { ELANOUS_TASK_BOUND_PR: String(cardPrNumber(card)) } : {}),
     ...(card.checklistId ? { ELANOUS_POD_SLOT_ID: card.checklistId } : {}),
     ...(card.seat ? { ELANOUS_POD_OWNER_KIND: 'seat', ELANOUS_POD_OWNER_ID: card.seat } : {}),

package/src/task-agent/tier-split.ts

@@ -0,0 +1,127 @@
+/**
+ * TIER-SPLIT-BEFORE-LAUNCH (0.2.35 P0) — `tasks hand --tier 상|특 --live` 를 한 덩어리로 쏘지 않고, 저작 분해
+ * (TC TIER-SIZED-DECOMPOSE `decomposeToTierSizedSlices`)가 만든 «중 이하 조각»으로 나눠 조각마다 hand 발사한다.
+ * 대표: «최우선으로 중·하 난이도로 쪼개기를 정착 · 구독 sol 은 웬만해선 소진 안 함».
+ *
+ * - 분해 규칙은 TC 몫 — 여기는 그 함수를 «주입 seam» 으로 받는다. 기본 seam 은 이 파일 한 곳(`DEFAULT_TIER_SIZED_DECOMPOSE`)에서만 정한다.
+ * - 분해기 «미배선»(seam 에 undefined 명시) = `decomposer-unavailable` → 종전처럼 한 덩어리 발사 ⊕ 기록. 기본 seam 은 TC 함수다.
+ * - 분해 «실패»(ok:false · throw · 불가피 이유 없는 상 조각 · 빈/잘못된 조각) → 발사 0 · 카드 failed(history `tier-split-failed`).
+ * - 관측: `debug.log('task-agent.hand', 'tier-split', {cid, fromTier, outcome, reason?, slices, unavoidable})`.
+ */
+import { randomBytes } from 'node:crypto';
+import { debug } from '../debug/log.js';
+import { handTask, TASK_CARD_PREFIX, type HandTaskOptions, type HandTaskResult } from './task-hand.js';
+
+// 분해 규칙·타입 정본 = TC `src/self-implement/goal-author-decompose.ts`(TIER-SIZED-DECOMPOSE · #29987).
+import { decomposeToTierSizedSlices, type SizedSlice, type TierSizedDecomposeResult } from '../self-implement/goal-author-decompose.js';
+export type { SizedSlice, TierSizedDecomposeResult };
+export type TierSizedDecompose = (goal: string, opts?: { signal?: AbortSignal }) => Promise<TierSizedDecomposeResult>;
+
+/** 기본 분해기 — TC `decomposeToTierSizedSlices`. seam 에 undefined 를 명시하면 «미배선»(decomposer-unavailable). */
+export const DEFAULT_TIER_SIZED_DECOMPOSE: TierSizedDecompose | undefined = decomposeToTierSizedSlices;
+
+export const TIER_SPLIT_UNAVAILABLE = 'decomposer-unavailable';
+
+/** 분해 시간 상한 — LLM 이 매달려도 디스패처의 손 넘김 한 번을 끝없이 붙잡지 않는다. 넘으면 막힘(decompose-timeout). */
+export const TIER_SPLIT_DECOMPOSE_TIMEOUT_MS = 300_000;
+
+/** 조각이 부모 칸에서 물려받는 줄 머리 — hand 의 골 검사(완료 경계 셋)와 계약·경계 문맥. */
+const INHERITED_PARENT_LABELS = /^\s*(?:[-*]\s*)?(현재 계약|완료 경계 코드|완료 경계 실물|완료 경계 증거 명령|경계|증거 보충)\s*:/;
+
+/**
+ * 조각 hand 문면 = 조각 골(대상 경로·동작 — 첫 줄 유지) ⊕ 조각 표지 ⊕ 부모 칸의 계약·완료 경계·경계 줄.
+ * 분해기의 조각 골은 짧은 제목뿐이라 그대로 넘기면 hand 의 골 검사(완료 경계 누락)가 막는다(10-21 DEVICE-FIRST-AUTHORING 발사 0).
+ * 부모에 그 줄이 없으면 아무것도 더하지 않는다 — 검사가 지금처럼 거부한다(보수 쪽).
+ */
+export function composeSliceHandText(sliceGoal: string, parentText: string, marker: { index: number; total: number; fromTier: '상' | '특'; cid: string | null }): string {
+  const sliceLines = sliceGoal.trim().split('\n');
+  const sliceHas = new Set(sliceLines.map((line) => INHERITED_PARENT_LABELS.exec(line)?.[1]).filter(Boolean));
+  const inherited = parentText.split('\n').filter((line) => {
+    const label = INHERITED_PARENT_LABELS.exec(line)?.[1];
+    return label !== undefined && !sliceHas.has(label);
+  });
+  if (inherited.length === 0) return sliceGoal;
+  const tag = `조각 ${marker.index}/${marker.total} — 부모 ${marker.cid ?? '(칸 없음)'}(${marker.fromTier}) 를 중 이하로 나눈 몫. 아래 계약·완료 경계는 부모 칸에서 물려받았다 — 이 조각 범위만 채운다.`;
+  return [...sliceLines, tag, ...inherited].join('\n');
+}
+
+export type TierSplitPlan =
+  | { kind: 'split'; slices: SizedSlice[] }
+  | { kind: 'blocked'; reason: string };
+
+/** 순수 판정 — 분해 결과 → 발사 계획. 이유 없는 상 조각이 하나라도 있으면 결과 전체를 실패로 본다(이유 없는 상 0). */
+export function planTierSplit(result: TierSizedDecomposeResult): TierSplitPlan {
+  if (!result.ok) return { kind: 'blocked', reason: `decompose-failed: ${result.reason}` };
+  if (result.slices.length === 0) return { kind: 'blocked', reason: 'no-slices' };
+  for (const [index, slice] of result.slices.entries()) {
+    if (!['하', '중', '상'].includes(slice.tier)) return { kind: 'blocked', reason: `invalid-slice-tier: #${index + 1} ${String(slice.tier)}` };
+    if (!slice.goal?.trim()) return { kind: 'blocked', reason: `empty-slice-goal: #${index + 1}` };
+    if (slice.tier === '상' && !slice.unavoidable?.trim()) return { kind: 'blocked', reason: `unjustified-상-slice: #${index + 1}` };
+  }
+  return { kind: 'split', slices: result.slices };
+}
+
+export interface TierSplitSliceOutcome { slice: SizedSlice; result?: HandTaskResult; error?: string }
+export type TierSplitHandResult =
+  | { kind: 'whole'; result: HandTaskResult; reason?: string }
+  | { kind: 'blocked'; result: HandTaskResult; reason: string }
+  | { kind: 'split'; group: string; fromTier: '상' | '특'; slices: TierSplitSliceOutcome[] };
+
+export interface TierSplitHandOptions extends HandTaskOptions {
+  /** 분해기 seam — 키를 안 주면 기본(`DEFAULT_TIER_SIZED_DECOMPOSE`) · undefined 를 명시하면 «미배선». */
+  decompose?: TierSizedDecompose;
+  /** 분해 시간 상한(시험 주입) — 기본 `TIER_SPLIT_DECOMPOSE_TIMEOUT_MS`. */
+  decomposeTimeoutMs?: number;
+}
+
+function record(data: Record<string, unknown>): void {
+  try { debug.log('task-agent.hand', 'tier-split', data); } catch { /* fail-soft */ }
+}
+
+/**
+ * `tasks hand` 의 발사 앞단. 분해는 `--live` ⊕ tier 상|특 일 때만 — 중·하·tier 없음·shadow 는 `handTask` 그대로(분해 호출 0).
+ */
+export async function handTaskWithTierSplit(opts: TierSplitHandOptions): Promise<TierSplitHandResult> {
+  const { decompose: injected, decomposeTimeoutMs = TIER_SPLIT_DECOMPOSE_TIMEOUT_MS, ...hand } = opts;
+  const fromTier = hand.tier;
+  if (!hand.live || (fromTier !== '상' && fromTier !== '특')) return { kind: 'whole', result: await handTask(hand) };
+  const decompose = 'decompose' in opts ? injected : DEFAULT_TIER_SIZED_DECOMPOSE;
+  const cid = hand.checklistId ?? null;
+  if (!decompose) {
+    record({ cid, fromTier, outcome: 'whole', reason: TIER_SPLIT_UNAVAILABLE, slices: [], unavoidable: [] });
+    return { kind: 'whole', result: await handTask(hand), reason: TIER_SPLIT_UNAVAILABLE };
+  }
+  let plan: TierSplitPlan;
+  const controller = new AbortController();
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const timedOut = new Promise<'timeout'>((resolve) => { timer = setTimeout(() => { controller.abort(); resolve('timeout'); }, decomposeTimeoutMs); });
+  try {
+    const raced = await Promise.race([decompose(hand.text.trim(), { signal: controller.signal }), timedOut]);
+    plan = raced === 'timeout' ? { kind: 'blocked', reason: `decompose-timeout: ${decomposeTimeoutMs}ms` } : planTierSplit(raced);
+  } catch (error) {
+    plan = { kind: 'blocked', reason: `decompose-threw: ${String((error as Error)?.message ?? error).slice(0, 200)}` };
+  } finally { clearTimeout(timer); }
+  if (plan.kind === 'blocked') {
+    record({ cid, fromTier, outcome: 'blocked', reason: plan.reason, slices: [], unavoidable: [] });
+    return { kind: 'blocked', result: await handTask({ ...hand, tierSplitBlocked: plan.reason }), reason: plan.reason };
+  }
+  const group = `${TASK_CARD_PREFIX}split-${randomBytes(4).toString('hex')}`;
+  const total = plan.slices.length;
+  const unavoidable = plan.slices.filter((slice) => slice.tier === '상').map((slice) => slice.unavoidable!.trim());
+  // 조각은 새 카드다 — 호출자 id·pr·goalId 를 조각마다 복제하면 «PR: #N» 조회·수확이 엇갈린다. 버린 것은 기록에 남긴다.
+  const dropped = { ...(hand.id ? { id: hand.id } : {}), ...(hand.cardFields?.pr !== undefined ? { pr: hand.cardFields.pr } : {}), ...(hand.cardFields?.goalId !== undefined ? { goalId: hand.cardFields.goalId } : {}) };
+  record({ cid, fromTier, outcome: 'split', group, ...(Object.keys(dropped).length ? { dropped } : {}), slices: plan.slices.map((s) => ({ tier: s.tier, files: s.files, behaviours: s.behaviours })), unavoidable });
+  const { id: _wholeId, cardFields, ...rest } = hand;
+  const base = { ...rest, ...(cardFields?.handed !== undefined ? { cardFields: { handed: cardFields.handed } } : {}) };
+  const slices: TierSplitSliceOutcome[] = [];
+  for (const [index, slice] of plan.slices.entries()) {
+    try {
+      const result = await handTask({ ...base, text: composeSliceHandText(slice.goal, hand.text, { index: index + 1, total, fromTier, cid }), tier: slice.tier,
+        tierSplit: { group, fromTier, index: index + 1, total, ...(slice.tier === '상' ? { unavoidable: slice.unavoidable!.trim() } : {}) } });
+      slices.push({ slice, result });
+    } catch (error) {
+      slices.push({ slice, error: error instanceof Error ? error.message : String(error) });
+    }
+  }
+  return { kind: 'split', group, fromTier, slices };
+}

package/src/task-agent/work-order-build.ts

@@ -6,6 +6,7 @@ export interface BuildWorkOrderInput {
   lifeId?: string;
   priority?: string;
   peers?: string;
+  boundary?: string;
 }
 
 /** Build the normalized nine-field core from already-grounded inputs; no CLI, filesystem, or launch side effects. */
@@ -16,6 +17,7 @@ export function buildWorkOrder(input: BuildWorkOrderInput): WorkOrder {
     version: input.version,
     priority: input.priority,
     peers: input.peers,
+    boundary: input.boundary,
   }));
   if (!parsed.ok) throw new Error(parsed.reason);
   return parsed.order;

package/src/task-agent/work-order.ts

@@ -79,8 +79,9 @@ export function parseWorkOrder(source: string): ParseWorkOrderResult {
   const unknownFields: string[] = [];
   const cells = {} as Record<WorkOrderField, string>;
   for (const field of WORK_ORDER_FIELDS) {
-    const text = cellText(record[field]);
-    if (text === WORK_ORDER_UNKNOWN) unknownFields.push(field);
+    const value = record[field];
+    const text = cellText(value);
+    if (value == null || (typeof value === 'string' && !value.trim())) unknownFields.push(field);
     cells[field] = text;
   }
   return { ok: true, order: { cellId: rawCellId.trim(), ...cells, unknownFields } };

package/src/task-orchestrator/generator-prompt.ts

@@ -10,10 +10,13 @@
  */
 import type { DecomposeInput } from './generator.js';
 import type { ProposalValidationError } from './generator-schema.js';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { resolve } from 'node:path';
 
 export type DecomposePromptProfile = 'goal-author-coarse';
 
-export const GOAL_AUTHOR_COARSE_MAX_SLICES = 6;
+/** TaskGenerator's safety ceiling, not an authoring target; goal-author splits by slice size. */
+export const GOAL_AUTHOR_SIZE_SAFETY_MAX_SLICES = 15;
 
 export interface BuildPromptOptions {
   maxTasks: number;
@@ -39,6 +42,35 @@ const CODING_GOAL_KINDS: ReadonlySet<string> = new Set([
   'agentic',
 ]);
 
+/** Read the existing device sources at authoring time; the LLM has no file tools in this phase. */
+let deviceInventoryCache: string[] | undefined;
+function deviceInventory(): string[] {
+  if (deviceInventoryCache) return deviceInventoryCache;
+  const root = resolve(import.meta.dir, '../..');
+  const fallback = ['- Device inventory unavailable in this installation; verify a named device before claiming it exists.'];
+  if (!existsSync(resolve(root, 'src/ux-sim'))) return deviceInventoryCache = fallback;
+  try {
+    const files = readdirSync(resolve(root, 'src/ux-sim'))
+      .filter((name) => name.endsWith('.ts') && !name.endsWith('.test.ts')).sort();
+    const monkey = readFileSync(resolve(root, 'src/ux-sim/event-monkey.ts'), 'utf8');
+    const kinds = monkey.match(/export const EVENT_MONKEY_KINDS = \[([\s\S]*?)\] as const;/)?.[1]
+      ?.match(/'[^']+'/g)?.map((kind) => kind.slice(1, -1)) ?? [];
+    let rows: string[] = [];
+    try {
+      const manual = readFileSync(resolve(root, 'docs/manual/MANUAL-ux-simulation-devices-2026-08-23.md'), 'utf8');
+      rows = manual.split('\n').filter((line) => line.startsWith('|') && line.includes('`src/ux-sim/'));
+    } catch { /* Published packages omit docs/manual; source catalog still applies. */ }
+    return deviceInventoryCache = [
+      `- src/ux-sim files: ${files.join(', ')}`,
+      `- event-monkey kinds: ${kinds.join(', ')}`,
+      ...(rows.length ? [] : ['- manual §1 table unavailable in this installation; use the source files and event kinds above.']),
+      ...rows.map((row) => `- manual §1: ${row.replace(/\s*\|\s*/g, ' · ').slice(0, 500)}`),
+    ];
+  } catch {
+    return deviceInventoryCache = fallback;
+  }
+}
+
 export function buildDecomposePrompt(
   input: DecomposeInput,
   opts: BuildPromptOptions
@@ -53,7 +85,7 @@ export function buildDecomposePrompt(
   lines.push(
     'You are the monad-agent Task Orchestrator decomposition planner.',
     isGoalAuthorCoarse
-      ? `Break the objective into 1-${GOAL_AUTHOR_COARSE_MAX_SLICES} larger, concrete implementation slices.`
+      ? 'Break the objective into implementation slices that a low or medium tier model can finish. Split by slice size, not a target number of slices; the task count limit is only a safety ceiling.'
       : 'Break the objective into 3-7 concrete, single-responsibility tasks.',
     '',
     '## Output (STRICT JSON)',
@@ -119,9 +151,10 @@ export function buildDecomposePrompt(
     '- ★ Complete dependsOn contracts: if a phase CONSUMES another phase\'s output, that producing phase MUST be in this phase\'s `dependsOn` (by index). A consumer with no dependsOn on its producer looks like an ungrounded/orphan dependency to the critique. Trace every consumed symbol to either grounding (exists) or a dependsOn phase (produced this mission).',
     ...(isGoalAuthorCoarse
       ? [
-        '- Coarse scope: permit a larger implementation slice when its related definition, tests, and runtime wiring are necessary for an executable end-to-end path; do not split those related concerns into sibling tasks.',
-        '- One implementation run can complete a large multi-file slice, including its tests, so do not split work that fits in one run.',
-        '- Keep a coarse slice focused on one executable outcome, but it may combine related implementation concerns and exceed the default small-scope LOC guidance.',
+        '- Goal-author size: each slice should touch at most 4 target files, change at most 2 behaviors, and create at most 2 files. Count tests and runtime wiring among target files.',
+        '- Prefer low tier (at most 2 files, 1 behavior, 1 new file), then medium tier (at most 4 files, 2 behaviors, 2 new files). Do not make a high tier slice merely to reduce the number of slices.',
+        '- Keep the executable dependency path through dependsOn; split oversized work into dependent slices rather than hiding multiple behaviors in one title.',
+        '- A high tier slice is allowed only when it cannot be split further without breaking an inseparable operation. State its unavoidable reason in the rationale.',
       ]
       : [
         '- Small scope: keep each task ≈≤250 LOC of change. If a step is bigger, split it into sibling tasks or defer to a recursive decompose (depth) rather than one giant task.',
@@ -155,13 +188,29 @@ export function buildDecomposePrompt(
   if (isGoalAuthorCoarse) {
     lines.push(
       '',
-      '## Goal-author coarse slicing (follow strictly)',
-      '- Prefer fewer, larger implementation slices over small single-concern tasks; use the task budget as a ceiling, not a target.',
-      '- Keep related definition, tests, and runtime wiring together when they are required to make one implementation slice executable end-to-end.',
-      '- A slice may cover multiple related concerns and a larger change scope when splitting them would leave a definition unwired or an execution path incomplete.',
-      '- Every slice title MUST name at least one actual file path or function name because only the title is passed to the next stage; coarse slices must remain grounded and verifiable.',
+      '## Goal-author size-bounded slicing (follow strictly)',
+      '- Use the task budget as a safety ceiling, not a target. Add dependent slices whenever one slice would exceed medium size.',
+      '- Give each slice an executable outcome with tests or runtime wiring inside its size limit; place further wiring in a dependent slice.',
+      '- Every slice title MUST name at least one actual file path or function name because only the title is passed to the next stage; slices must remain grounded and verifiable.',
+      '- Every task JSON must include files, behaviours, newFiles and tier. Example: {"index":0,"title":"대상 경로: src/a.ts · 동작: 연결","files":1,"behaviours":1,"newFiles":0,"tier":"low","surface":{"kind":"llm-direct","prompt":"wire src/a.ts"}}.',
+      '- Only the title reaches the sizing fallback: start it with "대상 경로:" and name all touched paths; add one "동작:" clause per changed behavior and "신규 경로:" for each new file. Keep the title within 80 characters by splitting oversized work.',
       '- Fold non-code investigation or design into the implementation slice that needs it; do not emit it as a standalone slice.',
-      '- Use dependsOn only for genuine ordering between independently completable slices; do not split related definition and runtime wiring merely to create sibling tasks.',
+      '- Use dependsOn for genuine ordering between independently completable slices, including definition before dependent runtime wiring.',
+    );
+    // ── 장치 우선 분해 (DEVICE-FIRST-AUTHORING · 대표 10-21 18:1x 골 저작 지침) ──
+    // 골 저작의 검증 계획(TDD) 절이 무대·층을 고를 때 그 시험에 필요한 mock 장치·주입 사건 정의의
+    // 존재를 먼저 확인하게 한다. 장치가 없으면 «실물 없음»으로 초록이 막히므로 첫 조각이 장치 조각이 된다.
+    lines.push(
+      '',
+      '## Device-first decomposition (DEVICE-FIRST-AUTHORING — follow strictly)',
+      '### Existing device inventory (read from this checkout; use these names before proposing a new device)',
+      ...deviceInventory(),
+      '- The objective\'s verification plan (검증 계획/TDD) section picks a stage and ladder tier (무대·층) — e.g. a `src/ux-sim/*` stage at L2 (fake-llm·fake-bin·fake-clock). BEFORE writing slices, CHECK whether the mock device or injected event definition that this verification plan needs ALREADY EXISTS: look in `src/ux-sim/*`, the §1 device table of `docs/manual/MANUAL-ux-simulation-devices-2026-08-23.md`, and the event-monkey event kinds.',
+      '- Two branches — exactly one applies per needed device:',
+      '  - Device EXISTS: its name MUST go into the verification plan wording — the slice that tests the feature carries the device\'s exact name (device file / §1 table row / event kind) in its acceptance criteria and reuses the device; never re-create it.',
+      '  - Device MISSING: the FIRST slice MUST be a device slice that develops that device feature first — the mock device or injected event definition under `src/ux-sim/*` — and every slice that tests the feature depends on it (구현할 때 해당 시험 mock 장치나 이벤트 정의가 있나 확인하고, 없으면 그 장치 피처를 먼저 개발).',
+      '- Do NOT create the device itself here beyond emitting that device slice (장치 자체는 만들지 않는다 — 조각으로 내보낼 뿐); consumer slices reference it only via dependsOn.',
+      '- Device slices obey the same size bounds and acceptance bar as every other slice — the size rules (TIER-SIZED-DECOMPOSE) and the green-judgment rules are UNCHANGED.',
     );
   }
 

package/src/task-orchestrator/surfaces/pod-account-broker.ts

@@ -149,6 +149,39 @@ export function ownerCodexMirrorCandidate(candidates: readonly RotationCandidate
   });
 }
 
+export interface OwnerCodexMirrorAccount { account: string; usedPercent: number | null; thresholdPercent: number; expiresAt: number }
+
+/** The remote may rotate only across the accounts HQ actually installed in this launch snapshot. */
+export function parseOwnerCodexMirrorAccounts(raw: string): OwnerCodexMirrorAccount[] {
+  let parsed: unknown;
+  try { parsed = JSON.parse(raw); } catch { throw new Error('HQ Codex 미러 계정 목록이 잘못됐다'); }
+  if (!Array.isArray(parsed) || parsed.length === 0 || parsed.length > 16) throw new Error('HQ Codex 미러 계정 목록이 잘못됐다');
+  const seen = new Set<string>();
+  return parsed.map((item: unknown) => {
+    if (!item || typeof item !== 'object') throw new Error('HQ Codex 미러 계정 항목이 잘못됐다');
+    const value = item as Record<string, unknown>;
+    const { account, usedPercent, thresholdPercent, expiresAt } = value;
+    if (typeof account !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(account) || seen.has(account)
+      || (usedPercent !== null && (typeof usedPercent !== 'number' || !Number.isFinite(usedPercent) || usedPercent < 0 || usedPercent > 100))
+      || typeof thresholdPercent !== 'number' || !Number.isFinite(thresholdPercent) || thresholdPercent <= 0 || thresholdPercent > 100
+      || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt) || expiresAt <= 0)
+      throw new Error('HQ Codex 미러 계정 항목이 잘못됐다');
+    seen.add(account);
+    return { account, usedPercent: usedPercent as number | null, thresholdPercent, expiresAt };
+  });
+}
+
+/** Do not plan a Pod against an access token that might expire while it starts and runs. */
+export function freshOwnerCodexMirrorAccounts(accounts: readonly OwnerCodexMirrorAccount[], now = Date.now()): OwnerCodexMirrorAccount[] {
+  return accounts.filter(({ expiresAt }) => expiresAt > now + 3 * 60 * 60 * 1000);
+}
+
+export function selectOwnerCodexMirrorCandidates(candidates: readonly RotationCandidate[], accounts: readonly OwnerCodexMirrorAccount[]): RotationCandidate[] {
+  const selected = accounts.flatMap(({ account, usedPercent }) => ownerCodexMirrorCandidate(candidates, account, usedPercent ?? undefined));
+  if (selected.length !== accounts.length) throw new Error('HQ Codex 미러 계정 일부가 원격 auth-store 후보에 없다');
+  return selected;
+}
+
 /** Job 마다 다음 계정 — 잔량 순으로 돌려 가며. 쓸 계정이 없으면 만들 때 이유를 대고 던진다. */
 export function makePodAccountBroker(plan: PodAccountPlan): () => string {
   if (plan.usable.length === 0) {

package/src/task-orchestrator/surfaces/pod-child-providers.ts

@@ -9,7 +9,7 @@
  */
 // BEDROCK-PROVIDER ② (0.2.24) — bedrock 은 «이름 있는 AWS Secret» 이 클러스터에 있을 때만 뜬다(pod-bedrock-child.ts · 발사 전 거부).
 // ZAI-POD-CHILD (0.2.24) — glm 은 Z.ai GLM Coding Plan(정액 구독) · «이름 있는 ZAI Secret» 이 클러스터에 있을 때만 뜬다(pod-zai-child.ts · 발사 전 거부 · 동시 상한 넘치면 정책대로).
-export const POD_CHILD_PROVIDERS = ['openai-codex', 'grok', 'openrouter', 'anthropic', 'bedrock', 'glm'] as const;
+export const POD_CHILD_PROVIDERS = ['openai-codex', 'grok', 'openrouter', 'opengateway', 'anthropic', 'bedrock', 'glm'] as const;
 export type PodChildProvider = typeof POD_CHILD_PROVIDERS[number];
 
 /** 사람이 쓰는 별칭 → 정식 이름. */