elanous 0.2.40 → 0.2.41

package/src/self-implement/graph-variant.ts

@@ -31,10 +31,38 @@ export interface GraphVariantGoalAnalysis {
   readonly targetPathCount: number;
 }
 
+/** 한 런이 읽은 unit 선언의 원문 — 해시 근거를 만들 입력이며 결과에는 실리지 않는다. */
+export interface GraphVariantUnitDeclaration {
+  readonly path: string;
+  readonly content: string;
+}
+
+/** 선택된 unit 선언의 근거 — 경로와 내용 해시만. 본문은 로그·원장에 복제하지 않는다. */
+export interface GraphVariantUnitDeclarationEvidence {
+  readonly path: string;
+  readonly contentHash: string;
+}
+
 /** 최초 graph variant 선택 — id·선택 이유가 런 원장 옆 .graph.yaml 에 함께 저장되고 재조회된다. */
 export interface GraphVariantSelection {
   readonly variantId: string;
   readonly reason: string;
+  /** 선택된 unit 선언의 경로·내용 해시 — 선언이 없으면 키 자체가 없다(기존 두 키 계약 불변). */
+  readonly unitDeclarations?: readonly GraphVariantUnitDeclarationEvidence[];
+}
+
+/** unit 선언 본문의 sha256 — 내용 대신 이 값만 근거에 남긴다(goalContentHash 와 같은 해시-only 예비). */
+export function hashUnitDeclarationContent(content: string): string {
+  return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+
+/** 경로 오름차순·경로당 한 줄로 정렬한 근거 — 선언 순서가 달라도 같은 값을 낸다. */
+function unitDeclarationEvidence(unitDeclarations: readonly GraphVariantUnitDeclaration[]): GraphVariantUnitDeclarationEvidence[] {
+  const byPath = new Map<string, string>();
+  for (const declaration of [...unitDeclarations].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0)) {
+    byPath.set(declaration.path, hashUnitDeclarationContent(declaration.content));
+  }
+  return [...byPath].map(([path, contentHash]) => ({ path, contentHash }));
 }
 
 export type GraphVariantRejection =
@@ -55,14 +83,17 @@ export type GraphVariantResult =
   | { readonly ok: true; readonly overlay: GraphOverlaySpec; readonly template: GraphTemplateSpec; readonly patches: readonly OverlayPatchOp[]; readonly selection?: GraphVariantSelection }
   | { readonly ok: false; readonly rejections: readonly GraphVariantRejection[] };
 
-/** 최초 변형 선택(id·선택 이유)의 결정론적 유도 — 같은 종류·대상 경로 수면 항상 같은 값을 낸다. */
-export function initialGraphVariantSelection(analysis: GraphVariantGoalAnalysis): GraphVariantSelection {
+/** 최초 변형 선택(id·선택 이유 + 선택된 unit 선언의 경로·해시)의 결정론적 유도 — 같은 입력이면 항상 같은 값을 낸다. */
+export function initialGraphVariantSelection(analysis: GraphVariantGoalAnalysis,
+    unitDeclarations: readonly GraphVariantUnitDeclaration[] = []): GraphVariantSelection {
   const variantId = `variant-${analysis.goalType}-${createHash('sha256')
     .update(JSON.stringify({ goalType: analysis.goalType, targetPathCount: analysis.targetPathCount }))
     .digest('hex').slice(0, 12)}`;
+  const evidence = unitDeclarationEvidence(unitDeclarations);
   return {
     variantId,
     reason: `initial graph variant selected from goal type ${analysis.goalType} with ${analysis.targetPathCount} target path${analysis.targetPathCount === 1 ? '' : 's'}`,
+    ...(evidence.length === 0 ? {} : { unitDeclarations: evidence }),
   };
 }
 
@@ -72,8 +103,10 @@ export function createGraphVariant(input: {
   readonly goal: string;
   readonly plan: GraphVariantPlan;
   readonly goalAnalysis?: GraphVariantGoalAnalysis;
+  /** 이 런이 읽은 unit 선언 — 경로·내용 해시만 근거에 실리고 본문은 결과에 남지 않는다. */
+  readonly unitDeclarations?: readonly GraphVariantUnitDeclaration[];
 }): GraphVariantResult {
-  const { template, goal, plan, goalAnalysis } = input;
+  const { template, goal, plan, goalAnalysis, unitDeclarations = [] } = input;
   const known = new Set(template.nodes.map((node) => node.nodeId));
   const rejections: GraphVariantRejection[] = [];
   if (!/^g_[a-z0-9_-]+$/i.test(goal)) rejections.push({ kind: 'invalid-goal' });
@@ -82,7 +115,7 @@ export function createGraphVariant(input: {
     if (!GOAL_TYPES.includes(goalAnalysis.goalType) || !Number.isSafeInteger(goalAnalysis.targetPathCount) || goalAnalysis.targetPathCount < 0) {
       rejections.push({ kind: 'invalid-goal-analysis' });
     } else {
-      selection = initialGraphVariantSelection(goalAnalysis);
+      selection = initialGraphVariantSelection(goalAnalysis, unitDeclarations);
     }
   }
   if (plan.growth) {

package/src/self-implement/host-regate.ts

@@ -65,7 +65,7 @@ export function provideCheckoutDependencies(candidate: string, sourceRoot: strin
   } else install(join(candidate, dir));
 }
 
-export interface HostRegateInput { prNumber: number; headCommit: string; repoRoot: string; goalFile?: string; verifyOnly?: boolean; /** TA-LIVE-LAND-2: run the full landing gates (release-path hold · neighbours · PR re-read) but stop before the freeze admission and `gh pr merge` — the task agent lands it later via `pr land --expected-head`. */ noMerge?: true; /** Called by a resume sweep that already holds this PR's claim. */ resumed?: true }
+export interface HostRegateInput { prNumber: number; headCommit: string; repoRoot: string; goalFile?: string; verifyOnly?: boolean; /** STOP-HEAL-WINNOW: measurement only on a preserved draft; never valid for landing. */ allowDraft?: true; /** TA-LIVE-LAND-2: run the full landing gates (release-path hold · neighbours · PR re-read) but stop before the freeze admission and `gh pr merge` — the task agent lands it later via `pr land --expected-head`. */ noMerge?: true; /** Called by a resume sweep that already holds this PR's claim. */ resumed?: true }
 export interface HostRegateResult { passed: boolean; failures: HostRegateFailure[]; os: string; status?: 'passed' | 'failed' | 'unmeasured' | 'frozen'; /** verifyOnly: 실제로 얹어 잰 base 끝 */ baseCommit?: string }
 /** Only a missing host repository is recoverable by selecting the run's recorded root. Gate failures are final. */
 export function hostRepositoryUnavailable(result: HostRegateResult): boolean {
@@ -382,7 +382,7 @@ export async function runHostRegate(input: HostRegateInput, deps: HostRegateDeps
     return run('git', ['rev-parse', ref], input.repoRoot);
   };
   try {
-    if (!Number.isSafeInteger(input.prNumber) || input.prNumber <= 0 || !/^[0-9a-f]{40}$/i.test(input.headCommit)) return result('unmeasured', 'input', 'invalid PR number or checked head SHA');
+    if (!Number.isSafeInteger(input.prNumber) || input.prNumber <= 0 || !/^[0-9a-f]{40}$/i.test(input.headCommit) || (input.allowDraft && !input.verifyOnly)) return result('unmeasured', 'input', 'invalid PR number, checked head SHA, or draft measurement mode');
     release = await (deps.acquire ?? acquireSlot)(input.repoRoot);
     type PrView = { headRefOid?: string; baseRefName?: string; baseRefOid?: string; state?: string; isDraft?: boolean };
     const readPr = (): PrView => JSON.parse(run('gh', ['pr', 'view', String(input.prNumber), '--json', 'headRefOid,baseRefName,baseRefOid,state,isDraft'], input.repoRoot));
@@ -392,7 +392,7 @@ export async function runHostRegate(input: HostRegateInput, deps: HostRegateDeps
     let view: PrView;
     try { view = readPr(); }
     catch (e) { return result('unmeasured', 'pr-view', String(e)); }
-    if (view.headRefOid !== input.headCommit || view.state !== 'OPEN' || view.isDraft !== false || !view.baseRefName || !/^[0-9a-f]{40}$/i.test(view.baseRefOid ?? '')) return prHeadFailure(view);
+    if (view.headRefOid !== input.headCommit || view.state !== 'OPEN' || (view.isDraft !== false && !(input.allowDraft && view.isDraft === true)) || !view.baseRefName || !/^[0-9a-f]{40}$/i.test(view.baseRefOid ?? '')) return prHeadFailure(view);
     const baseRefName = view.baseRefName;
     // verifyOnly(승인 탭): PR 에 기록된 base(baseRefOid)는 main 의 «지금 끝»보다 늙을 수 있다 — 지금 끝에 얹어 잰다.
     let baseCommit = view.baseRefOid!;
@@ -621,7 +621,7 @@ export async function runHostRegate(input: HostRegateInput, deps: HostRegateDeps
     let current: PrView;
     try { current = readPr(); }
     catch (e) { return result('unmeasured', 'pr-view', String(e)); }
-    if (current.headRefOid !== input.headCommit || current.baseRefName !== baseRefName || (!input.verifyOnly && current.baseRefOid !== (stalePrBase ?? baseCommit)) || current.state !== 'OPEN' || current.isDraft !== false) {
+    if (current.headRefOid !== input.headCommit || current.baseRefName !== baseRefName || (!input.verifyOnly && current.baseRefOid !== (stalePrBase ?? baseCommit)) || current.state !== 'OPEN' || current.isDraft !== view.isDraft) {
       return result('unmeasured', 'pr-base-changed', 'PR head or base changed during host regate; rerun against the new base');
     }
     // --match-head-commit pins the head. gh has no base pin, so the base was re-read just

package/src/self-implement/knowhow-pack.ts

@@ -309,6 +309,44 @@ function relevance(goal: string, section: string, targetPaths?: readonly string[
   return score;
 }
 
+/** Selects explicit, active failure-signature remedies from repository-contained KNOWHOW files. */
+export function selectHealKnowhowPack(repo: string, signature: string): KnowhowPack {
+  const empty = (reason: KnowhowPack['reason']): KnowhowPack => ({ text: '', ids: [], bytes: 0, reason });
+  if (!/^[a-z][a-z0-9-]*$/.test(signature)) return empty('no-promoted-section');
+  const rolesDir = resolve(repo, 'docs/roles');
+  let realRoles: string;
+  try {
+    realRoles = realpathSync(rolesDir);
+    if (!inside(realpathSync(repo), realRoles)) return empty('source-unreadable');
+  } catch { return empty('source-unreadable'); }
+  let seats: string[];
+  try { seats = readdirSync(rolesDir).sort(); } catch { return empty('source-unreadable'); }
+  const selected: Array<{ id: string; remedy: string }> = [];
+  for (const seat of seats) {
+    if (!/^[A-Z]{2,4}$/.test(seat)) continue;
+    const file = join(rolesDir, seat, 'KNOWHOW.md');
+    try {
+      if (lstatSync(file).isSymbolicLink()) continue;
+      const real = realpathSync(file);
+      if (!inside(realRoles, real) || !statSync(real).isFile() || statSync(real).size > 2_000_000) continue;
+      for (const section of promotedSections(readFileSync(real, 'utf8'))) {
+        const explicit = /^- 원인 서명:\s*([a-z][a-z0-9-]*)\s*$/m.exec(section.text)?.[1];
+        const remedy = /^- 처방(?:\(힐링\))?:\s*(\S[^\r\n]*)$/m.exec(section.text)?.[1];
+        if (explicit !== signature || !remedy || selected.some((item) => item.id === section.id)) continue;
+        const next = [...selected, { id: section.id, remedy }];
+        const text = `[SUPERVISOR-HEAL-PACK signature=${signature} ids=${next.map((item) => item.id).join(',')}]\n${next.map((item) => `${item.id}: ${item.remedy}`).join('\n')}`;
+        if (Buffer.byteLength(text, 'utf8') <= KNOWHOW_PACK_MAX_BYTES) selected.push({ id: section.id, remedy });
+        if (selected.length === 3) break;
+      }
+    } catch { /* Missing or unreadable files contribute no remedy. */ }
+    if (selected.length === 3) break;
+  }
+  if (!selected.length) return empty('no-promoted-section');
+  const ids = selected.map((item) => item.id);
+  const text = `[SUPERVISOR-HEAL-PACK signature=${signature} ids=${ids.join(',')}]\n${selected.map((item) => `${item.id}: ${item.remedy}`).join('\n')}`;
+  return { ids, text, bytes: Buffer.byteLength(text, 'utf8'), reason: 'selected' };
+}
+
 /** Reads only 내부 문서 `KNOWHOW` inside the supplied repository. Verified target paths narrow relevance when supplied. */
 function selectKnowhowOnly(repo: string, goal: string, targetPaths: readonly string[] | undefined, maxBytes: number): KnowhowPack {
   const empty = (reason: KnowhowPack['reason']): KnowhowPack => ({ text: '', ids: [], bytes: 0, reason });