elanous 0.2.29 → 0.2.32

package/src/task-orchestrator/surfaces/pod-reuse-cleanup.ts

@@ -0,0 +1,67 @@
+/** Files and caches that survive between requests on a reusable Pod worker. */
+export const POD_REUSE_CLEAN_EXCLUSIONS = [
+  { name: 'node_modules', pattern: 'node_modules' },
+  { name: 'apps/pwa/node_modules', pattern: 'apps/pwa/node_modules' },
+  // Bun's install cache and remote gate cache live outside the worker checkout.
+  { name: 'bun install cache', pattern: null },
+  { name: 'TypeScript build info', pattern: '*.tsbuildinfo' },
+  { name: 'remote gate TypeScript cache', pattern: null },
+] as const;
+
+export type PodReuseCleanupOutcome = 'reuse' | 'discard';
+
+export interface PodReuseCleanupDecisionInput {
+  base: string;
+  resetExitCode: number | null;
+  cleanExitCode: number | null;
+  statusExitCode: number | null;
+  statusPorcelain: string;
+  remainingPaths?: readonly string[];
+  additionalCleanExclusions?: readonly { name: string; pattern: string }[];
+  statusExclusions?: readonly string[];
+}
+
+export interface PodReuseCleanupDecision {
+  resetArgs: readonly string[];
+  cleanArgs: readonly string[];
+  statusArgs: readonly string[];
+  preserved: readonly string[];
+  outcome: PodReuseCleanupOutcome;
+  reason?: 'invalid-base' | 'reset-failed' | 'clean-failed' | 'status-failed' | 'worktree-not-clean';
+  remainingPaths: readonly string[];
+}
+
+/**
+ * Pure policy: return fixed argv and decide whether the worker can be reused
+ * from actual command results. WarmWorkerRuntime owns execution and lifecycle
+ * event emission at the serialized request boundary.
+ */
+export function decidePodReuseCleanup(input: PodReuseCleanupDecisionInput): PodReuseCleanupDecision {
+  const remainingPaths = (input.remainingPaths ?? []).slice(0, 5);
+  const resetArgs = ['reset', '--hard', input.base] as const;
+  const cleanArgs = [
+    'clean', '-ffdx',
+    ...[...POD_REUSE_CLEAN_EXCLUSIONS, ...(input.additionalCleanExclusions ?? [])]
+      .flatMap(({ pattern }) => pattern ? ['-e', pattern] : []),
+  ] as const;
+  const statusArgs = ['status', '--porcelain', '-z', '--', '.', ...(input.statusExclusions ?? [])
+    .map((path) => `:(exclude,top,literal)${path}`)] as const;
+  const preserved = [...POD_REUSE_CLEAN_EXCLUSIONS, ...(input.additionalCleanExclusions ?? [])].map(({ name }) => name);
+
+  let reason: PodReuseCleanupDecision['reason'];
+  if (!/^[0-9a-f]{40}$/i.test(input.base)) reason = 'invalid-base';
+  else if (input.resetExitCode !== 0) reason = 'reset-failed';
+  else if (input.cleanExitCode !== 0) reason = 'clean-failed';
+  else if (input.statusExitCode !== 0) reason = 'status-failed';
+  else if (input.statusPorcelain.trim() !== '') reason = 'worktree-not-clean';
+
+  return {
+    resetArgs,
+    cleanArgs,
+    statusArgs,
+    preserved,
+    outcome: reason ? 'discard' : 'reuse',
+    ...(reason ? { reason } : {}),
+    remainingPaths,
+  };
+}

package/src/task-orchestrator/surfaces/pod-source-receive.ts

@@ -2,6 +2,7 @@
  *  sha·PR·커밋은 형식 검사 전에 스크립트에 넣지 않는다(셸 주입 차단). */
 
 import { execFileSync } from 'node:child_process';
+import { siTaskPodStageShell } from './pod-lifecycle-stages.js';
 
 export type PodSource =
   | { kind: 'default'; base?: string }
@@ -52,17 +53,30 @@ function assertRemoteBase(repoUrl: string, base: string): void {
   }
 }
 
-/** Job 스크립트의 원천 단계. 성공 갈래는 `ELANOUS_POD_SOURCE <kind> <HEAD>` 로 끝난다. */
-export function podSourceScript(source: PodSource, repoUrl: string, mirrorPath = '/host-mirror'): string {
+/** Job 스크립트의 원천 단계. 성공 갈래는 `ELANOUS_POD_SOURCE <kind> <HEAD>` 로 끝난다.
+ *  `stageMarkers` — si-task Job 만: 호스트 미러 `clone --shared` 시도의 시작·성공을 `ELANOUS_POD_STAGE mirror start|end` 로 찍는다
+ *  (건너뛰거나 실패하면 끝 표지가 없다 → 호스트가 missing 으로 읽는다). 기본은 꺼짐 — gate·pod-command Job 의 바이트는 그대로다. */
+export function podSourceScript(source: PodSource, repoUrl: string, mirrorPath = '/host-mirror', options: { stageMarkers?: boolean } = {}): string {
+  const mark = (edge: 'start' | 'end'): string[] => options.stageMarkers ? [siTaskPodStageShell('mirror', edge)] : [];
   const quotedUrl = `'${repoUrl.replace(/'/g, `'\\''`)}'`;
   const quotedMirror = `'${mirrorPath.replace(/'/g, `'\\''`)}'`;
   const clone = `git clone -q --depth 50 ${quotedUrl} repo`;
   const start = [
     'if [ -e repo ]; then exit 5; fi',
-    `if [ -d ${quotedMirror} ] && git -C ${quotedMirror} rev-parse --verify HEAD >/dev/null 2>&1 && git clone -q --shared -- ${quotedMirror} repo && git -C repo rev-parse --verify HEAD >/dev/null 2>&1; then`,
+    // TA-POD-WARMBOOT-PARITY (10-16): the mirror fallback used to be silent — 157 HARD gate Pods all said
+    // `VIA github` and nothing said why (the Job had no /host-mirror mount). Each failed step now names itself.
+    'mirror_skip=',
+    ...mark('start'),
+    `if ! [ -d ${quotedMirror} ]; then mirror_skip=no-mount`,
+    `elif ! git -C ${quotedMirror} rev-parse --verify HEAD >/dev/null 2>&1; then mirror_skip=rev-parse-failed`,
+    `elif ! git clone -q --shared -- ${quotedMirror} repo || ! git -C repo rev-parse --verify HEAD >/dev/null 2>&1; then mirror_skip=clone-failed`,
+    'fi',
+    'if [ -z "$mirror_skip" ]; then',
+    ...mark('end').map((line) => `  ${line}`),
     `  git -C repo remote set-url origin ${quotedUrl} || exit 5`,
     '  source_via=mirror',
     'else',
+    "  printf 'ELANOUS_POD_SOURCE_MIRROR_SKIP %s\\n' \"$mirror_skip\"",
     '  if [ -e repo ]; then rm -r -- repo || exit 5; fi',
     `  ${clone} || exit 5`,
     '  source_via=github',
@@ -143,7 +157,9 @@ export function podSourceScript(source: PodSource, repoUrl: string, mirrorPath =
     '  exit 3',
     'fi',
     'if [ -e repo ]; then exit 5; fi',
+    ...mark('start'),
     `if [ -d ${quotedMirror} ] && git -C ${quotedMirror} rev-parse --verify HEAD >/dev/null 2>&1 && git clone -q --shared -- ${quotedMirror} repo && git -C repo rev-parse --verify HEAD >/dev/null 2>&1; then`,
+    ...mark('end').map((line) => `  ${line}`),
     `  git -C repo remote set-url origin ${quotedUrl} || exit 5`,
     '  if git -C repo bundle verify /tmp/source.bundle >/dev/null 2>&1; then',
     '    git -C repo fetch /tmp/source.bundle "refs/elanous/pod-source/*:refs/remotes/bundle/*" || exit 5',

package/src/task-orchestrator/surfaces/pod-warm-switch.ts

@@ -0,0 +1,141 @@
+/**
+ * warm Pod 재사용 ⑤ — 소비자별 «실전 사용 가능?» 손잡이 (PLAN-warm-reuse-tonight-2026-10-15 §5).
+ *
+ * 관측: 판정마다 `debug.log('pod.warm', 'switch-decision', …)` 한 줄(소비자·live·reason·표본 수).
+ * 판단: config flag(`pod.warmReuse.{gateRecheck,land,ta}` · 기본 false) ⊕ 증거
+ *       (lease 유효 · 카나리아 통과 · 같은 head/main/lock · 최근 mismatch 0 · 연속 일치 표본 ≥ minMatchSamples).
+ * 수복: live=false 면 소비자는 기존 fresh Job 경로를 그대로 탄다 — reason 이 «무엇이 모자랐나»를 넘긴다.
+ *
+ * ⛔ 이 모듈은 판정만 한다. 소비자 결선(pod-command-job · gate-node · self-implement-pod)은 각 소비자 PR 몫이다.
+ * ⛔ 못 잰 증거(undefined)는 «통과»가 아니라 «off» 다 — 모르면 켜지 않는다.
+ * 순서: gate-recheck → land → ta. 앞 소비자가 «자기 증거로» live 가 아니면 뒤 소비자도 live 가 아니다
+ *       (증거는 소비자별 — 뒤 소비자의 증거로 앞 소비자를 대신 판정하지 않는다 · 앞 증거가 없으면 off).
+ */
+import { debug } from '../../debug/log.js';
+
+export type WarmReuseConsumer = 'gate-recheck' | 'land' | 'ta';
+
+/** 켜는 순서 — 뒤 소비자는 바로 앞 소비자가 live 일 때만 live 가 될 수 있다. */
+export const WARM_REUSE_CONSUMER_ORDER: readonly WarmReuseConsumer[] = ['gate-recheck', 'land', 'ta'];
+
+/** 연속 일치 표본 기본 하한(보수적). */
+export const DEFAULT_WARM_MIN_MATCH_SAMPLES = 3;
+
+/** `pod.warmReuse` config 절 — 타입이 어긋난 값은 off/기본값으로 읽는다. */
+export interface WarmReuseSwitchConfig {
+  gateRecheck?: boolean;
+  land?: boolean;
+  ta?: boolean;
+  minMatchSamples?: number;
+}
+
+/** warm 워커 신원 — 기대값(fresh Job 쪽)과 워커 쪽을 같은 칸끼리 대조한다. */
+export interface WarmReuseIdentity {
+  head?: string;
+  main?: string;
+  lock?: string;
+}
+
+/** 판정 증거. 칸이 비면(undefined) «못 쟀다» = off. */
+export interface WarmReuseEvidence {
+  /** 같은 파일 fresh Job 대비 연속 일치(rc ⊕ JUnit 실패 ID) 표본 수. */
+  consecutiveMatchSamples?: number;
+  /** 최근 창의 warm↔fresh mismatch 수 — 0 이어야 live. */
+  recentMismatchCount?: number;
+  /** Nexus `pod-worker-lease` 가 현재 generation 으로 유효한가. */
+  leaseValid?: boolean;
+  /** 정비 뒤 카나리아 통과. */
+  canaryPassed?: boolean;
+  expected?: WarmReuseIdentity;
+  worker?: WarmReuseIdentity;
+}
+
+/** 소비자별 증거 — 판정 대상 ⊕ 그 앞 소비자들의 증거가 모두 있어야 live 가 될 수 있다. */
+export type WarmReuseEvidenceByConsumer = Partial<Record<WarmReuseConsumer, WarmReuseEvidence>>;
+
+export interface WarmReuseDecision {
+  consumer: WarmReuseConsumer;
+  live: boolean;
+  /** `live` 이거나 첫 번째로 걸린 이유(예 `flag-off` · `predecessor-off:land` · `samples-short`). */
+  reason: string;
+}
+
+const FLAG_KEY: Record<WarmReuseConsumer, keyof Pick<WarmReuseSwitchConfig, 'gateRecheck' | 'land' | 'ta'>> = {
+  'gate-recheck': 'gateRecheck',
+  land: 'land',
+  ta: 'ta',
+};
+
+const IDENTITY_FIELDS = ['head', 'main', 'lock'] as const;
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+/** minMatchSamples — 양의 안전 정수만, 아니면 기본값. */
+export function resolveWarmMinMatchSamples(config: unknown): number {
+  const raw = isRecord(config) ? config.minMatchSamples : undefined;
+  return typeof raw === 'number' && Number.isSafeInteger(raw) && raw > 0 ? raw : DEFAULT_WARM_MIN_MATCH_SAMPLES;
+}
+
+/** flag — 문자 그대로 `true` 만 켠다. */
+export function warmReuseFlagOn(config: unknown, consumer: WarmReuseConsumer): boolean {
+  return isRecord(config) && config[FLAG_KEY[consumer]] === true;
+}
+
+function evidenceReason(evidence: WarmReuseEvidence | undefined, minSamples: number): string | null {
+  if (!evidence) return 'evidence-unmeasured';
+  if (evidence.leaseValid !== true) return evidence.leaseValid === false ? 'lease-invalid' : 'lease-unmeasured';
+  if (evidence.canaryPassed !== true) return evidence.canaryPassed === false ? 'canary-failed' : 'canary-unmeasured';
+  for (const field of IDENTITY_FIELDS) {
+    const want = evidence.expected?.[field];
+    const got = evidence.worker?.[field];
+    if (typeof want !== 'string' || !want || typeof got !== 'string' || !got) return `identity-unmeasured:${field}`;
+    // 원값 그대로 정확히 비교한다 — 앞뒤 공백 등 형식이 어긋난 값은 고쳐 읽지 않고 off.
+    if (want !== want.trim() || got !== got.trim()) return `identity-malformed:${field}`;
+    if (want !== got) return `identity-mismatch:${field}`;
+  }
+  const mismatches = evidence.recentMismatchCount;
+  if (typeof mismatches !== 'number' || !Number.isSafeInteger(mismatches) || mismatches < 0) return 'mismatch-unmeasured';
+  if (mismatches > 0) return 'recent-mismatch';
+  const samples = evidence.consecutiveMatchSamples;
+  if (typeof samples !== 'number' || !Number.isSafeInteger(samples) || samples < 0) return 'samples-unmeasured';
+  if (samples < minSamples) return 'samples-short';
+  return null;
+}
+
+function decide(consumer: WarmReuseConsumer, config: unknown, evidence: WarmReuseEvidenceByConsumer | undefined): string {
+  if (!warmReuseFlagOn(config, consumer)) return 'flag-off';
+  const index = WARM_REUSE_CONSUMER_ORDER.indexOf(consumer);
+  if (index > 0) {
+    const predecessor = WARM_REUSE_CONSUMER_ORDER[index - 1]!;
+    if (decide(predecessor, config, evidence) !== 'live') return `predecessor-off:${predecessor}`;
+  }
+  const own = isRecord(evidence) ? evidence[consumer] : undefined;
+  return evidenceReason(isRecord(own) ? own : undefined, resolveWarmMinMatchSamples(config)) ?? 'live';
+}
+
+/**
+ * 소비자 하나가 지금 warm 워커를 «실전»으로 써도 되나.
+ * `config` 는 `getUserConfig().pod?.warmReuse` 를 그대로 넘긴다(없으면 전부 off).
+ * `evidence` 는 소비자별 — 대상 소비자 ⊕ 그 앞 소비자들의 칸이 모두 있어야 한다(앞 칸이 비면 `predecessor-off:<앞>`).
+ */
+export function decideWarmReuse(
+  consumer: WarmReuseConsumer,
+  config: WarmReuseSwitchConfig | undefined,
+  evidence: WarmReuseEvidenceByConsumer | undefined,
+): WarmReuseDecision {
+  const reason = decide(consumer, config, evidence);
+  const live = reason === 'live';
+  const own = isRecord(evidence) && isRecord(evidence[consumer]) ? evidence[consumer] : undefined;
+  debug.log('pod.warm', 'switch-decision', {
+    consumer,
+    live,
+    reason,
+    flag: warmReuseFlagOn(config, consumer),
+    minMatchSamples: resolveWarmMinMatchSamples(config),
+    samples: own?.consecutiveMatchSamples ?? null,
+    recentMismatchCount: own?.recentMismatchCount ?? null,
+  });
+  return { consumer, live, reason };
+}

package/src/task-orchestrator/surfaces/pod-warm-ta-shadow.ts

@@ -0,0 +1,85 @@
+/**
+ * warm Pod 재사용 — 'ta' 소비자의 «그림자 비교» 순수 모듈 (PLAN-warm-reuse-tonight-2026-10-15 §5 · pod-warm-switch.ts 의 'ta' 몫).
+ *
+ * 관측: 이 모듈은 아무것도 관측하지 않는다 — 완료된 si-task Job outcome 과 lease-fenced warm candidate 를
+ *       «받은 값만으로» 비교한다(자체 I/O · 부수효과 없음).
+ * 판단: 후보 키는 원문이 준 두 성분 — same source SHA / child model. lease 펜스(pod-lease.ts 세대 펜스,
+ *       WarmReuseEvidence.leaseValid 와 같은 칸)가 유효하지 않으면 키가 같아도 기각한다(fail-closed).
+ * 수복: match=false 면 호출자는 기존 fresh Job 경로를 그대로 탄다 — reason 이 «무엇이 모자랐나»를 넘긴다.
+ *
+ * ⛔ 이 모듈은 비교만 한다. 소비자 결선(self-implement-pod 연결)은 형제 샤드 몫이다(정의-결선 분리 경계).
+ * ⛔ 못 잰 값(undefined · 빈 값)은 «일치»가 아니라 «기각» 이다 — pod-warm-switch.ts 의
+ *    'unmeasured = off' 규율과 원값 그대로의 정확 비교(앞뒤 공백 등 형식 어긋남은 고쳐 읽지 않는다)를 그대로 잇는다.
+ */
+
+/**
+ * UNRESOLVED — 원문 요청 문면이 `(keyed by same source SHA / child model /` 에서 끊겼다.
+ * child model 뒤에 추가 키 성분이 더 있는지, 그리고 그 뒤에 이어지던 비교 요구가 무엇이었는지 이 문서에서 확정할 수 없다.
+ * 이 모듈은 확정된 두 키(same source SHA / child model)만 비교한다 — 나머지는 의도적으로 미정(unspecified)이며 지어내지 않는다.
+ * 추가 성분은 원문 회수 시 그 표현 그대로만 붙인다.
+ */
+export const TA_SHADOW_UNRESOLVED_NOTE: string =
+  "UNRESOLVED: original ask truncated after '(keyed by same source SHA / child model /' — " +
+  'confirmed keys are source SHA and child model; any further key components or comparison ' +
+  'requirements are intentionally unspecified, not invented.';
+
+/** 완료된 si-task Job outcome — 비교에 쓰는 키 성분만 담는다(원문 확정: same source SHA / child model). */
+export interface SiTaskJobOutcome {
+  /** 이 outcome 을 낸 원본 소스의 SHA — 후보 키 성분 ①. */
+  sourceSha: string;
+  /** 이 outcome 을 낸 자식 모델(self-implement-pod.ts `childModel` 과 같은 문자열 칸) — 후보 키 성분 ②. */
+  childModel: string;
+}
+
+/**
+ * lease-fenced warm candidate — pod-lease.ts 세대 펜스가 붙은 warm 재사용 후보.
+ * `leaseValid` 는 pod-warm-switch.ts `WarmReuseEvidence.leaseValid` 와 같은 칸:
+ * `true` = 현재 generation 유효 · `false` = 펜스 기각 · `undefined` = 못 잰(off).
+ */
+export interface LeaseFencedWarmCandidate {
+  sourceSha: string;
+  childModel: string;
+  leaseValid?: boolean;
+}
+
+/** 비교 결과 — 첫 번째로 걸린 이유를 그대로 넘긴다(«lease-fence rejection passthrough» 포함). */
+export interface TaShadowComparison {
+  match: boolean;
+  reason:
+    | 'match'
+    | 'lease-unmeasured'
+    | 'lease-invalid'
+    | 'source-sha-unmeasured'
+    | 'source-sha-malformed'
+    | 'source-sha-mismatch'
+    | 'child-model-unmeasured'
+    | 'child-model-malformed'
+    | 'child-model-mismatch';
+}
+
+/** 원값 그대로의 정확 비교 — 못 잼(unmeasured) · 형식 어긋남(malformed) · 불일치(mismatch) 를 갈라 뱉는다. */
+function exactString(
+  field: 'source-sha' | 'child-model',
+  outcome: string,
+  candidate: string,
+): TaShadowComparison['reason'] | null {
+  if (typeof outcome !== 'string' || !outcome || typeof candidate !== 'string' || !candidate) return `${field}-unmeasured`;
+  if (outcome !== outcome.trim() || candidate !== candidate.trim()) return `${field}-malformed`;
+  if (outcome !== candidate) return `${field}-mismatch`;
+  return null;
+}
+
+/**
+ * 완료된 si-task Job outcome 과 lease-fenced warm candidate 가 «같은 키» 인지 — 순수 비교.
+ * 순서: lease 펜스 먼저(펜스가 기각이면 키가 같아도 기각이 우선한다) → source SHA → child model.
+ */
+export function compareWarmTaShadow(outcome: SiTaskJobOutcome, candidate: LeaseFencedWarmCandidate): TaShadowComparison {
+  if (candidate.leaseValid !== true) {
+    return { match: false, reason: candidate.leaseValid === false ? 'lease-invalid' : 'lease-unmeasured' };
+  }
+  const sha = exactString('source-sha', outcome.sourceSha, candidate.sourceSha);
+  if (sha !== null) return { match: false, reason: sha };
+  const model = exactString('child-model', outcome.childModel, candidate.childModel);
+  if (model !== null) return { match: false, reason: model };
+  return { match: true, reason: 'match' };
+}