elanous 0.2.28 → 0.2.29

package/src/panes/log-pane.ts

@@ -7,7 +7,7 @@
 import { C, stripAnsi, truncate, visibleWidth } from '../tui.js';
 import type { FoldMode } from '../log-entry.js';
 import { paneTitle } from './pane-title.js';
-import { highlightLineSegments } from '../log-pane/search.js';
+import { highlightLineSegments, type LogSearchResult } from '../log-pane/search.js';
 import type { PaneSpec, RenderCtx } from '../plugins/core/types.js';
 
 export interface LogPaneState {
@@ -60,6 +60,64 @@ export interface LogPaneViewport {
   visibleLineIndices: number[];
 }
 
+/** Dashboard scroll offsets count painted rows, while freeze/copy indices
+ *  still address original entries. Match the pane's filter before scrolling.
+ *  The common no-filter path counts delimiters without allocating rows. */
+export function physicalLogRowCount(
+  lines: readonly string[],
+  beforeIndex = lines.length,
+  filterQuery = '',
+): number {
+  let count = 0;
+  const query = filterQuery.trim().toLowerCase();
+  for (let i = 0; i < Math.min(beforeIndex, lines.length); i++) {
+    const entry = lines[i] ?? '';
+    if (query) {
+      count += entry.split(/\r\n|\r|\n/).filter(line => stripAnsi(line).toLowerCase().includes(query)).length;
+      continue;
+    }
+    count++;
+    for (let j = 0; j < entry.length; j++) {
+      if (entry[j] === '\n') count++;
+      else if (entry[j] === '\r') {
+        count++;
+        if (entry[j + 1] === '\n') j++;
+      }
+    }
+  }
+  return count;
+}
+
+export function visibleSearchRowOffset(
+  lines: readonly string[],
+  result: LogSearchResult,
+  filterQuery = '',
+): number {
+  const precedingRows = physicalLogRowCount(lines, result.lineIdx, filterQuery);
+  const entryRowsBeforeMatch = (lines[result.lineIdx] ?? '')
+    .split(/\r\n|\r|\n/)
+    .slice(0, result.physicalRowInEntry ?? 0);
+  const filter = filterQuery.trim().toLowerCase();
+  const withinEntry = filter
+    ? entryRowsBeforeMatch.filter(line => stripAnsi(line).toLowerCase().includes(filter)).length
+    : entryRowsBeforeMatch.length;
+  return precedingRows + withinEntry;
+}
+
+export function logPaneContentHeight(height: number, hasFooter: boolean, hasQueueRow: boolean): number {
+  return Math.max(0, height - 1 - (hasFooter ? (hasQueueRow ? 3 : 2) : 0));
+}
+
+export function maxLogPaneScroll(
+  lines: readonly string[],
+  height: number,
+  opts: { filterQuery?: string; frozenTailIndex?: number | null; hasFooter?: boolean; hasQueueRow?: boolean } = {},
+): number {
+  const sourceCount = opts.frozenTailIndex ?? lines.length;
+  const visibleRows = physicalLogRowCount(lines, sourceCount, opts.filterQuery);
+  return Math.max(0, visibleRows - logPaneContentHeight(height, !!opts.hasFooter, !!opts.hasQueueRow));
+}
+
 function buildScrollStatusLine(opts: {
   start: number;
   visibleCount: number;
@@ -96,11 +154,13 @@ export function buildLogPaneViewport(state: LogPaneState, ctx: RenderCtx): LogPa
   const frozenLines = frozen != null ? state.lines.slice(0, frozen) : state.lines;
   const hiddenBehindFreeze = frozen != null ? Math.max(0, state.lines.length - frozen) : 0;
   const filterQuery = state.filterQuery?.trim() ?? '';
-  const filtered = frozenLines.flatMap((line, index) => {
-    if (!filterQuery) return [{ line, index }];
-    return stripAnsi(line).toLowerCase().includes(filterQuery.toLowerCase())
-      ? [{ line, index }]
-      : [];
+  // Each source entry can contain embedded newlines. Expand it before
+  // viewport math so one array item never paints over the footer/input rows.
+  const physicalLines = frozenLines.flatMap((entry, index) =>
+    entry.split(/\r\n|\r|\n/).map(line => ({ line, index })));
+  const filtered = physicalLines.filter(({ line }) => {
+    if (!filterQuery) return true;
+    return stripAnsi(line).toLowerCase().includes(filterQuery.toLowerCase());
   });
   const visibleLines = filtered.map(item => item.line);
   const visibleLineIndices = filtered.map(item => item.index);
@@ -130,8 +190,7 @@ export function buildLogPaneViewport(state: LogPaneState, ctx: RenderCtx): LogPa
   // breathing gap above + 1-row footer) so the streamed text doesn't
   // feel crammed against the indicator.
   const hasQueueRow = hasFooter && state.queueRow != null && state.queueRow !== '';
-  const footerReserve = hasFooter ? (hasQueueRow ? 3 : 2) : 0;
-  const contentH = Math.max(0, bodyH - footerReserve);
+  const contentH = logPaneContentHeight(ctx.height, hasFooter, hasQueueRow);
   const maxScroll = Math.max(0, visibleLines.length - contentH);
   const start = state.scrollOffset < 0
     ? maxScroll

package/src/persona/presets.ts

@@ -225,3 +225,47 @@ export function describePreset(p: PersonaPreset): string[] {
     `  하지 않는 것: ${p.doesNot.join(' / ')}`,
   ];
 }
+
+// ── 0.2.29 PERSONA-STARTER — 첫 실행 직업 질문의 «경영» 스타터 계약 ────────
+//
+// persona-presets/*.yaml(MK 카탈로그)와는 다른 층이다: 첫 실행 wizard 의 직업
+// 질문에서 «경영»을 고른 순간 «한 장» 만들어 주는 계약 원본. 카탈로그 YAML
+// 원본은 그대로 두고 이 계약은 presets.ts 에서 정의해 기존 clonePreset 파이프라인으로
+// persona store 에 복제한다(마케팅·현장·교육 스타터는 후속 조각).
+
+/** 첫 실행 «경영» 스타터 — persona store 에 정확히 한 장 쓰인다. */
+const MANAGEMENT_STARTER_PRESET: PersonaPreset = {
+  personaId: 'starter-management',
+  displayName: '경영 스타터',
+  names: ['경영 스타터', '경영', 'starter-management'],
+  role: '경영 파트너',
+  title: '첫 실행 스타터',
+  oneLine: '회사 방향·판단·운영을 같이 세우는 짝.',
+  voice: {
+    rule: '짧고 단정하게 — 결론 먼저, 근거 한 줄.',
+    examples: [
+      '이번 주 우선순위는 셋뿐입니다. 첫째는 매출 회수입니다.',
+      '그 결정은 근거가 부족합니다 — 가장 싼 실험부터 하시죠.',
+    ],
+  },
+  tasks: [
+    { when: '아침 루프', what: '할 일·일정·미결 회의를 한 화면에 모아 첫 판단을 준다' },
+    { when: '판단이 갈릴 때', what: '선택지를 셋으로 좁혀 근거·비용·되돌림 수단을 나란히 놓는다' },
+    { when: '주간 정산', what: '지난 결정과 실제 결과를 대조해 다음 판단 기준을 고친다' },
+  ],
+  tools: [],
+  firstQuestions: [
+    '지금 가장 급한 경영 판단은 무엇인가요?',
+    '이번 주에 꼭 정해야 할 일이 있나요?',
+  ],
+  doesNot: [
+    '회사 기밀을 외부에 전송하지 않는다',
+    '합의되지 않은 지출·계약을 대신 실행하지 않는다',
+  ],
+  forWhom: '처음 elanous 를 여는 경영자 — 방향·판단·운영을 함께 시작하려는 사람.',
+};
+
+/** 첫 실행 «경영» 선택이 부르는 유일한 제작 입구 — 스타터 계약 한 장을 persona store 에 쓴다. */
+export function createManagementStarterContract(opts: PersonaWriteOptions = {}): PersonaWriteResult {
+  return clonePreset(MANAGEMENT_STARTER_PRESET, MANAGEMENT_STARTER_PRESET.displayName, opts);
+}

package/src/plugins/maker/wizard-generate.ts

@@ -63,8 +63,9 @@ export function generateWizardFiles(dir: string, slug: string, draft: WizardRese
   }
   const skillPath = join(dir, `skills/${slug}/SKILL.md`);
   const readmePath = join(dir, 'README.md');
-  const wizardReadme = options.regenerate && existsSync(readmePath) &&
-    readFileSync(readmePath, 'utf8').includes('Research draft only. Connector declarations contain credential names, not values.');
+  const readmeNotice = 'Research draft only. Connector declarations contain credential names, not values. The graph cannot perform the requested processing yet: implement and validate its steps, then remove extensions["ai.elanous"].researchDraft from plugin.json before installing or running it. No messages are sent.';
+  const wizardReadme = options.regenerate && existing && existsSync(readmePath) &&
+    readFileSync(readmePath, 'utf8') === `# ${slug}\n\n${existing.description}\n\n${readmeNotice}\n`;
   if (options.regenerate) {
     if (!existing || existing.extensions['ai.elanous'].researchDraft !== true || !existsSync(skillPath)) {
       throw new Error('wizard regeneration requires an existing research draft');
@@ -80,7 +81,8 @@ export function generateWizardFiles(dir: string, slug: string, draft: WizardRese
     requires: undefined as { knowledgePacks?: string[]; [key: string]: unknown } | undefined,
     extensions: { 'ai.elanous': { graphs: [`./graphs/${slug}.yaml`],
       capabilities: ['fs:workdir', 'proc:bun', 'proc:elanous'], connectors: [] as unknown[], researchDraft: true } } };
-  if (options.regenerate) manifest.description = draft.description;
+  // A maker scaffold may have no description or an earlier description; the research draft owns this field.
+  manifest.description = draft.description;
   if (draft.requires?.knowledgePacks !== undefined) {
     manifest.requires = { ...manifest.requires, knowledgePacks: [...new Set(draft.requires.knowledgePacks)] };
   }
@@ -108,7 +110,7 @@ console.log(JSON.stringify({ outcome: 'fail', error: step === 'prepare' || step
 process.exitCode = 1;
 `],
     ['examples/input.json', '{}\n'],
-    ['README.md', `# ${slug}\n\n${draft.description}\n\nResearch draft only. Connector declarations contain credential names, not values. The graph cannot perform the requested processing yet: implement and validate its steps, then remove extensions["ai.elanous"].researchDraft from plugin.json before installing or running it. No messages are sent.\n`],
+    ['README.md', `# ${slug}\n\n${draft.description}\n\n${readmeNotice}\n`],
     [`skills/${slug}/SKILL.md`, `---\n${stringifyYaml({ name: slug, description: draft.skill?.description ?? draft.description, requires: [...new Set(requires)] })}---\n\n${draft.skill?.instructions ?? draft.description}\n`],
   ];
   const generated = existing ? files.filter(([path]) => path === 'plugin.json' || path.startsWith('skills/') ||

package/src/preview/terminal.ts

@@ -85,6 +85,13 @@ export interface PreviewTerminalOpts {
    *  로 받아 같은 에뮬레이터/탭에 먹인다(정체성·크로스서피스 goto 획득). bun onData-死는 registry bun-native
    *  openpty 가 해결. ⚠️ 라이브 렌더(yazi DA2·마우스·커서·alt-screen) 검증은 기기 세션 필요(대표) → 기본 off. */
   useRegistry?: boolean;
+  /** Shared PTY identity for registry-backed popups. Defaults to preview. */
+  registryKind?: string;
+  /** Human-readable purpose shown by PTY inventory. */
+  registryNickname?: string;
+  registryOrigin?: { originRoot: string; controller?: string };
+  registryPurpose?: string;
+  registrySeat?: string;
   /** P13 — OSC 9/99/777 notification hook. Fires when the child
    *  emits one of:
    *    ESC ] 9 ; <title> BEL                  (iTerm2 growl)
@@ -337,7 +344,13 @@ export class PreviewTerminal {
       this.registryHandle = this.registryDeps.startPty({
         // 합성자 = registry(resolveSpawnShape) — 여기서는 overlay 만 넘긴다.
         cmd: shell, args, workdir: this.opts.cwd, env: childEnv,
-        cols: this.term.cols, rows: this.term.rows, kind: 'preview', accessMode: 'write',
+        cols: this.term.cols, rows: this.term.rows,
+        kind: this.opts.registryKind ?? 'preview',
+        nickname: this.opts.registryNickname,
+        origin: this.opts.registryOrigin,
+        purpose: this.opts.registryPurpose,
+        seat: this.opts.registrySeat,
+        accessMode: 'write',
       });
       this.alive = true;
     } else {

package/src/prompt-cache/types.ts

@@ -15,6 +15,8 @@
 export interface LLMUsage {
   /** Origin provider — lets the metrics module tag accumulated tokens. */
   provider?: 'anthropic' | 'openai';
+  /** 이 사용량을 낸 턴의 모델(내보내는 쪽이 알 때만). 턴 지표가 설정 모델 대신 이것으로 ctx 최대치·단가를 잡는다. */
+  model?: string;
   inputTokens?: number;
   outputTokens?: number;
   cacheReadInputTokens?: number;

package/src/prompt-enhance/enhance.ts

@@ -134,7 +134,11 @@ function askMarkerCount(ask: string): number {
   return (ask.match(/(?:^|\s)(?:불변식|경계|판정\s*신호|invariant|boundary|decision\s+signal)\s*:/gi) ?? []).length;
 }
 
-type EnhanceSelectionSource = 'opts' | 'env' | 'config-role' | 'default';
+type EnhanceSelectionSource = 'opts' | 'env' | 'config-role' | 'fallback-child' | 'default';
+const PLANNING_FALLBACK_REASONS = new Set(['quota-exhausted', 'quota-unmeasured', 'quota-unavailable', 'no-credential-source', 'expiring', 'credential-shape', 'credential-error', 'credential-unavailable', 'unavailable']);
+export function normalizePlanningFallbackReason(value: unknown): string {
+  return typeof value === 'string' && PLANNING_FALLBACK_REASONS.has(value) ? value : 'unavailable';
+}
 
 /** Select the authoring knobs independently; a planning effort alone cannot change the model. */
 export function selectEnhanceLlm(
@@ -146,8 +150,10 @@ export function selectEnhanceLlm(
   const configuredModel = opts.model === undefined && !env.ELANOUS_PROMPT_ENHANCE_MODEL
     && planning && (planning.model || planning.tier || planning.provider)
     ? resolveRoleLlm('planning', { config, overrides: {} }).model : undefined;
+  const forwardedModelSource = env.ELANOUS_PROMPT_ENHANCE_MODEL_RELAY === 'pod' ? env.ELANOUS_PROMPT_ENHANCE_MODEL_SOURCE : undefined;
   const modelSource: EnhanceSelectionSource = opts.model !== undefined ? 'opts'
-    : env.ELANOUS_PROMPT_ENHANCE_MODEL ? 'env'
+    : env.ELANOUS_PROMPT_ENHANCE_MODEL
+      ? forwardedModelSource === 'config-role' || forwardedModelSource === 'fallback-child' || forwardedModelSource === 'default' ? forwardedModelSource : 'env'
     : configuredModel !== undefined ? 'config-role' : 'default';
   const model = opts.model ?? (env.ELANOUS_PROMPT_ENHANCE_MODEL || configuredModel || env.ELANOUS_PR_REVIEW_MODEL || tierModel('better'));
   const envEffort = env.ELANOUS_PROMPT_ENHANCE_EFFORT;
@@ -170,15 +176,25 @@ export function selectEnhanceLlm(
 export function selectPlanningLlm(
   env: NodeJS.ProcessEnv = process.env,
   config: UserConfig = getUserConfig(),
-): { model: string | undefined; effort: 'low' | 'medium' | 'high' } {
+): { model: string | undefined; effort: 'low' | 'medium' | 'high'; modelSource: 'env' | 'config-role' | 'fallback-child' | 'default'; fallbackReason?: string; requestedModel?: string; requestedSource?: string } {
   const planning = config.roleLlm?.planning;
-  const model = env.ELANOUS_PROMPT_ENHANCE_MODEL
-    || (planning && (planning.model || planning.tier || planning.provider)
-      ? resolveRoleLlm('planning', { config, overrides: {} }).model
-      : undefined);
+  const envModel = env.ELANOUS_PROMPT_ENHANCE_MODEL;
+  const roleModel = !envModel && planning && (planning.model || planning.tier || planning.provider)
+    ? resolveRoleLlm('planning', { config, overrides: {} }).model : undefined;
+  const model = envModel || roleModel || undefined;
+  // Pod authoring receives the host's selection through env. Preserve its origin for the grounding log.
+  const relayed = env.ELANOUS_PROMPT_ENHANCE_MODEL_RELAY === 'pod';
+  const forwardedSource = relayed ? env.ELANOUS_PROMPT_ENHANCE_MODEL_SOURCE : undefined;
+  const modelSource = envModel
+    ? forwardedSource === 'config-role' || forwardedSource === 'fallback-child' || forwardedSource === 'default' ? forwardedSource : 'env'
+    : roleModel ? 'config-role' : 'default';
   const envEffort = env.ELANOUS_PROMPT_ENHANCE_EFFORT;
   const validEnvEffort = envEffort === 'low' || envEffort === 'medium' || envEffort === 'high' ? envEffort : undefined;
-  return { model, effort: validEnvEffort ?? planning?.effort ?? 'high' };
+  const fallbackReason = modelSource === 'fallback-child' ? normalizePlanningFallbackReason(env.ELANOUS_PROMPT_ENHANCE_MODEL_FALLBACK_REASON) : undefined;
+  const requestedModel = fallbackReason ? env.ELANOUS_PROMPT_ENHANCE_REQUESTED_MODEL : undefined;
+  const requestedSource = fallbackReason ? env.ELANOUS_PROMPT_ENHANCE_REQUESTED_SOURCE : undefined;
+  return { model, effort: validEnvEffort ?? planning?.effort ?? 'high', modelSource,
+    ...(fallbackReason ? { fallbackReason } : {}), ...(requestedModel ? { requestedModel } : {}), ...(requestedSource ? { requestedSource } : {}) };
 }
 
 /** 스캐폴드 생성 LLM 시스템 프롬프트 — 가산·원문불가침 규율. */