elanous 0.2.4 → 0.2.6

package/graphs/release/release-loop.yaml

@@ -1,3 +1,4 @@
+# Inputs gateRemote (SSH host, e.g. node-b) and gateRemoteMirror (bare mirror path, default ~/mirror/elanous-agent.git): run gate sweeps in temporary remote clones without a matching caller checkout; omit gateRemote for local execution.
 graph_id: release-loop
 loop:
   title: 릴리스
@@ -11,12 +12,15 @@ terminal_nodes: [done, failed]
 nodes:
   - { node_id: version-release, kind: git, recipe: 'cmd:version-release', max_visits: 1 }
   - { node_id: cutoff, kind: judge, recipe: 'cmd:cutoff', max_visits: 1 }
+  - { node_id: checklist-gate, kind: gate, recipe: 'cmd:checklist-gate', max_visits: 1 }
   - { node_id: gate, kind: gate, recipe: 'cmd:gate', max_visits: 1, notify: start }
   - { node_id: pwa, kind: gate, recipe: 'cmd:pwa', max_visits: 1, notify: start }
   - { node_id: prepare, kind: agent, recipe: 'cmd:prepare', max_visits: 1, notify: start }
   - { node_id: upgrade, kind: gate, recipe: 'cmd:upgrade', max_visits: 1 }
   - { node_id: tui, kind: gate, recipe: 'cmd:tui', max_visits: 1 }
   - { node_id: docs, kind: agent, recipe: 'cmd:docs', max_visits: 1 }
+  - { node_id: notes-check, kind: gate, recipe: 'cmd:notes-check', max_visits: 1 }
+  - { node_id: auto-approve, kind: gate, recipe: 'cmd:auto-approve', max_visits: 1 }
   - { node_id: approve-publish, kind: hitl, recipe: 'approval:publish', max_visits: 1 }
   - { node_id: publish, kind: git, recipe: 'cmd:publish-command', max_visits: 1 }
   - { node_id: docs-land, kind: git, recipe: 'cmd:docs-land', max_visits: 1 }
@@ -26,13 +30,16 @@ nodes:
   - { node_id: failed, kind: gate, max_visits: 1 }
 edges:
   - { from: version-release, on: outcome, map: { ok: cutoff, fail: failed, error: failed } }
-  - { from: cutoff, on: outcome, map: { ok: gate, fail: failed, error: failed } }
+  - { from: cutoff, on: outcome, map: { ok: checklist-gate, fail: failed, error: failed } }
+  - { from: checklist-gate, on: outcome, map: { ok: gate, fail: failed, error: failed } }
   - { from: gate, on: outcome, map: { ok: pwa, fail: failed, error: failed } }
   - { from: pwa, on: outcome, map: { ok: prepare, fail: failed, error: failed } }
   - { from: prepare, on: outcome, map: { ok: upgrade, fail: failed, error: failed } }
   - { from: upgrade, on: outcome, map: { ok: tui, fail: failed, error: failed } }
   - { from: tui, on: outcome, map: { ok: docs, fail: failed, error: failed } }
-  - { from: docs, on: outcome, map: { ok: approve-publish, fail: failed, error: failed } }
+  - { from: docs, on: outcome, map: { ok: notes-check, fail: failed, error: failed } }
+  - { from: notes-check, on: outcome, map: { ok: auto-approve, fail: failed, error: failed } }
+  - { from: auto-approve, on: outcome, map: { ok: publish, fail: approve-publish, error: approve-publish } }
   - { from: approve-publish, on: outcome, map: { ok: publish, fail: failed } }
   - { from: publish, on: outcome, map: { ok: docs-land, fail: failed, error: failed } }
   - { from: docs-land, on: outcome, map: { ok: verify, fail: failed, error: failed } }

package/graphs/video/README.md

@@ -42,6 +42,7 @@ fi
 | `exec-standard.yaml` | *"이 파이프라인을 «정기적으로» 어떻게 도나"* | `delivered` · `skipped` · `failed` · `unobserved` |
 | 🆕 `film-production-standard.yaml` | *"편집 앱을 스크립트로 몰아 한 편을 만들고 소셜까지 어떻게 내나"* | `delivered` · `master-only` · `host-blocked` · `blocked` · `unobserved` |
 | 🆕 `character-video-standard.yaml` | *"레퍼런스에서 캐릭터를 세우고, 연출된 컷을 뽑고, 편집까지 어떻게 한 루프로 도나"* | `delivered` · `rendered-unedited` · `blocked` · `unobserved` |
+| 🆕 `explainer-line.yaml` | *"사실 목록으로 «N가지 한 번에» 설명 영상을 어떻게 만들어 검사까지 가나"* (스킬 `explainer-video` · 팩 `video-explainer`) | `delivered` · `needs-human` · `blocked` · `unobserved` |
 | `overlays/render-patient.yaml` | 「같은 회차에서 N번 되돌아왔다」면 예산을 올린다 | — |
 | 🆕 `vlog-found-footage-pipeline.declaration.yaml` | *"남이 찍어 보낸 소재에서 «이야기»를 어떻게 뽑아 납품까지 가나"* | `delivered` · `needs-human` · `blocked` · `unobserved` |
 | 🆕 `video-production-pipeline.declaration.yaml` | *"영상 한 편을 «어느 갈래든» 어떻게 만들어 납품까지 가나"* | `delivered` · `needs-human` · `blocked` · `unobserved` |

package/graphs/video/explainer-line.yaml

@@ -0,0 +1,58 @@
+# «N가지 한 번에 정리» explainer: facts → script → timed VO → composition → checked render → measured QC.
+# Engine = skills/explainer-video (vo.ts · build.mjs). Render/snapshot/check = the existing hyperframes-render recipe.
+# ⚠️ Recipes explainer-script / explainer-vo / explainer-build / explainer-qc are declared here and not yet coded
+#    (src/video-pipeline/recipes) — a walk stops at the first of them as «unknown recipe». Until then the skill runs these steps.
+graph_id: explainer-line
+version: 1
+entry_node: script
+terminal_nodes: [delivered, needs-human, blocked, unobserved]
+nodes:
+  - node_id: script
+    kind: agent
+    recipe: explainer-script
+    max_visits: 3
+    contract: { inputs: [facts, sources], tools: read-only, outputs: [script_path] }
+  - node_id: vo
+    kind: agent
+    recipe: explainer-vo
+    max_visits: 2
+    contract: { inputs: [script_path], tools: network-write, outputs: [vo_dir, narration_seconds] }
+  - node_id: build
+    kind: agent
+    recipe: explainer-build
+    max_visits: 3
+    contract: { inputs: [script_path, vo_dir], tools: workspace-write, outputs: [hyperframes_project, timeline_path] }
+  - node_id: render
+    kind: gate
+    recipe: hyperframes-render
+    max_visits: 2
+    contract: { inputs: [hyperframes_project], tools: workspace-write, outputs: [hf_render_path, hf_snapshot_dir, hf_check] }
+  - node_id: qc
+    kind: gate
+    recipe: explainer-qc
+    max_visits: 2
+    contract: { inputs: [hf_render_path, script_path], tools: read-and-run, outputs: [vo_match, loudness_lufs, true_peak_db] }
+  - node_id: delivered
+    kind: judge
+    recipe: terminal-delivered
+    max_visits: 1
+  - node_id: needs-human
+    kind: judge
+    recipe: terminal-needs-human
+    max_visits: 1
+  - node_id: blocked
+    kind: judge
+    recipe: terminal-blocked
+    max_visits: 1
+  - node_id: unobserved
+    kind: judge
+    recipe: terminal-unobserved
+    max_visits: 1
+edges:
+  - { from: script, on: outcome, map: { ok: vo, no-facts: needs-human, unmeasurable: unobserved } }
+  - { from: vo, on: outcome, map: { ok: build, no-key: needs-human, error: blocked, unmeasurable: unobserved } }
+  - { from: build, on: outcome, map: { ok: render, bad-script: script, error: blocked, unmeasurable: unobserved } }
+  # check/snapshot failures are layout faults → rebuild; a wrong-length render is a timing fault → rebuild too.
+  - { from: render, on: outcome, map: { ok: qc, check-fail: build, render-mismatch: build, unmeasurable: unobserved } }
+  # speech ≠ script → re-voice that line; loudness off → rebuild (mix lives in the composition); public release is a human call.
+  - { from: qc, on: outcome, map: { pass: delivered, vo-mismatch: vo, loudness: build, public: needs-human, unmeasurable: unobserved } }

package/package.json

@@ -1,8 +1,10 @@
 {
   "name": "elanous",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Self-healing coding harness where eyes, hands, and memory all turn on one sentence — it authors its own goals, implements them in isolated worktrees, and reviews its own work.",
   "license": "Apache-2.0",
+  "author": "Elanvital AI",
+  "homepage": "https://elanous.ai",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ElanvitalAI/elanous.git"

package/plugins/card-followup/README.md

@@ -0,0 +1,33 @@
+# card-followup
+
+명함 사진 한 장으로 사람·회사 조사와 팔로업 초안을 만듭니다. 메일과 LinkedIn 메시지는 보내지 않습니다.
+
+## 실행 명령
+
+```bash
+elanous graph run plugins/card-followup/graphs/card-followup.yaml --input '<json>' --json
+```
+
+## 입력
+
+- `image` (필수): 명함 사진의 절대 경로. `png`, `jpg`, `jpeg`, `heic`만 허용합니다. `~/`는 홈 경로로 펼칩니다.
+- `context` (선택): 어디서 만났고 무슨 이야기를 했는지 한두 줄.
+- `sender` (선택): 보내는 사람 이름·회사. 기본값은 비움입니다.
+- `language` (선택): `ko` 또는 `en`. 생략하면 명함에서 읽은 언어를 사용합니다.
+- `outDir` (선택): 보고서 출력 절대 경로. 생략하면 그래프 런 디렉터리를 사용합니다.
+
+## 산출
+
+- `followup.md`: 명함 필드 표, 조사 요약과 출처, 팔로업 메일, LinkedIn 초대 문구, 대화 질문.
+- `followup.json`: 같은 내용의 구조화 데이터. `sent`는 항상 `false`입니다.
+
+## 개인정보 주의
+
+명함 사진과 연락처는 그래프 런 상태에 남습니다. 비공개 경로만 사용하고 공유하지 마세요.
+
+## 릴리스 노트
+
+- 한 줄: feat — New card-followup plugin turns a business card photo into researched follow-up and LinkedIn drafts
+- 종류: feat
+- 문서: plugins/card-followup/README.md
+- 대상: next

package/plugins/card-followup/examples/card-sample.json

@@ -0,0 +1,7 @@
+{
+  "image": "/absolute/path/to/fictional-card.png",
+  "context": "가상 행사에서 가상 제품 데모를 짧게 이야기했습니다.",
+  "sender": "가상 발신자 · 가상 발신 회사",
+  "language": "ko",
+  "outDir": "/absolute/path/to/private-output"
+}

package/plugins/card-followup/graphs/card-followup.yaml

@@ -0,0 +1,16 @@
+graph_id: card-followup
+version: 1
+entry_node: read-card
+terminal_nodes: [done, failed]
+nodes:
+  - { node_id: read-card, kind: agent, recipe: 'cmd:read-card', max_visits: 1 }
+  - { node_id: research, kind: agent, recipe: 'cmd:research', max_visits: 1 }
+  - { node_id: draft, kind: agent, recipe: 'cmd:draft', max_visits: 1 }
+  - { node_id: report, kind: agent, recipe: 'cmd:report', max_visits: 1 }
+  - { node_id: done, kind: gate, max_visits: 1 }
+  - { node_id: failed, kind: gate, max_visits: 1 }
+edges:
+  - { from: read-card, on: outcome, map: { ok: research, fail: failed } }
+  - { from: research, on: outcome, map: { ok: draft, fail: failed } }
+  - { from: draft, on: outcome, map: { ok: report, fail: failed } }
+  - { from: report, on: outcome, map: { ok: done, fail: failed } }

package/plugins/card-followup/graphs/recipes.yaml

@@ -0,0 +1,12 @@
+read-card:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" read-card'
+  timeout_ms: 120000
+research:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" research'
+  timeout_ms: 120000
+draft:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" draft'
+  timeout_ms: 120000
+report:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" report'
+  timeout_ms: 30000

package/plugins/card-followup/graphs/run-step.ts

@@ -0,0 +1,172 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, extname, isAbsolute, join } from 'node:path';
+
+type Data = Record<string, unknown>;
+const object = (v: unknown): Data => v && typeof v === 'object' && !Array.isArray(v) ? v as Data : {};
+const text = (v: unknown): string => typeof v === 'string' ? v.trim() : '';
+const fields = ['name', 'title', 'company', 'email', 'phone', 'url', 'linkedin', 'language'] as const;
+const clean = (v: unknown) => text(v) || null;
+const line = (v: unknown) => text(v).replace(/[\r\n|]/g, ' ');
+
+// Find the first balanced object, respecting JSON string escapes and braces in quoted text.
+function firstObject(raw: string): Data {
+  for (let start = raw.indexOf('{'); start !== -1; start = raw.indexOf('{', start + 1)) {
+    let depth = 0, quoted = false, escaped = false;
+    for (let i = start; i < raw.length; i++) {
+      const ch = raw[i];
+      if (quoted) {
+        if (escaped) escaped = false;
+        else if (ch === '\\') escaped = true;
+        else if (ch === '"') quoted = false;
+      } else if (ch === '"') quoted = true;
+      else if (ch === '{') depth++;
+      else if (ch === '}' && --depth === 0) {
+        try {
+          const parsed = JSON.parse(raw.slice(start, i + 1));
+          if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) return parsed as Data;
+        } catch { /* try the next object */ }
+        break;
+      }
+    }
+  }
+  throw new Error(`JSON 객체 없음: ${raw.slice(0, 200)}`);
+}
+
+async function cli(bin: string, args: string[]): Promise<string> {
+  const child = Bun.spawn([bin, ...args], { stdout: 'pipe', stderr: 'pipe', env: process.env });
+  const [stdout, stderr, status] = await Promise.all([new Response(child.stdout).text(), new Response(child.stderr).text(), child.exited]);
+  if (status !== 0) throw new Error(`${args[0]} 실패: ${(stderr || stdout).slice(0, 200)}`);
+  return stdout;
+}
+
+function absolute(path: string, label: string): string {
+  const expanded = path.startsWith('~/') ? join(homedir(), path.slice(2)) : path;
+  if (!isAbsolute(expanded)) throw new Error(`${label}: 절대 경로 필요`);
+  return expanded;
+}
+
+function sources(raw: string): { title: string; url: string; snippet: string }[] {
+  const data = object(JSON.parse(raw));
+  // research --json exposes the human-readable result in `output`.
+  const output = text(data.output);
+  return output.split('\n').flatMap(row => {
+    const match = row.match(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/) ?? row.match(/(https?:\/\/[^\s)]+)/);
+    if (!match) return [];
+    return [{ title: match[2] ? match[1]! : row.replace(match[0], '').trim(), url: match[2] ?? match[1]!, snippet: row.replace(match[0], '').trim() }];
+  });
+}
+
+const contextFile = process.env.ELANOUS_GRAPH_CONTEXT;
+if (!contextFile) throw new Error('ELANOUS_GRAPH_CONTEXT 필요');
+const context = object(JSON.parse(readFileSync(contextFile, 'utf8')));
+const input = object(context.input);
+const outputs = object(context.outputs);
+const step = process.argv[2];
+const elanous = process.env.CARD_FOLLOWUP_ELANOUS_BIN || 'elanous';
+const codex = process.env.CARD_FOLLOWUP_CODEX_BIN || 'codex';
+const result = (data: Data) => console.log(JSON.stringify(data.outcome ? data : { outcome: 'ok', ...data }));
+
+try {
+  if (step === 'read-card') {
+    const image = absolute(text(input.image), 'image');
+    if (!/\.(png|jpe?g|heic)$/i.test(extname(image))) throw new Error('image: png/jpg/heic 필요');
+    if (!existsSync(image)) throw new Error('image: 파일 없음');
+    const raw = await cli(codex, ['exec', '-i', image, '명함 사진에서 읽을 수 있는 값만 JSON 객체로 출력하라: name, title, company, email, phone, url, linkedin, language. 빈 칸은 null. 추측 금지.']);
+    const card = firstObject(raw);
+    const normalized = Object.fromEntries(fields.map(field => [field, clean(card[field])]));
+    result({ card: normalized, image });
+  } else if (step === 'research') {
+    const read = object(outputs['read-card']);
+    const card = object(read.card ?? read);
+    const company = text(card.company), name = text(card.name);
+    if (!company && !name) throw new Error('조사할 이름·회사 없음');
+    const queries = [company || name, [name, company].filter(Boolean).join(' ')];
+    const hits = (await Promise.all(queries.map(query => cli(elanous, ['--test', 'research', '--json', '--limit', '5', query])))).flatMap(sources);
+    const unique = [...new Map(hits.map(hit => [hit.url, hit])).values()];
+    // Only the exact result text may be reported as a company fact, never a model-invented summary.
+    result({ summary: unique.length ? unique[0]!.title : null, news: unique.slice(1, 3).map(hit => hit.title), sources: unique });
+  } else if (step === 'draft') {
+    const read = object(outputs['read-card']);
+    const card = object(read.card ?? read);
+    const research = object(outputs.research);
+    const evidence = (Array.isArray(research.sources) ? research.sources.map(object) : [])
+      .filter(source => /^https?:\/\//.test(text(source.url)));
+    const language = text(input.language) || text(card.language) || 'ko';
+    if (!['ko', 'en'].includes(language)) throw new Error('language: ko 또는 en 필요');
+    const contextLine = text(input.context);
+    const numbered = evidence.map((source, index) => ({ id: `S${index + 1}`, title: text(source.title), snippet: text(source.snippet) }));
+    const marker = /\s*\[S(\d+)\]/g;
+    const strip = (value: string) => value.replace(marker, '').trim();
+    const sentencesOf = (value: string) => value.split(/(?<=[.!?。！？])\s+|\n+/).map(s => s.trim()).filter(Boolean);
+    const ask = async (payload: Data): Promise<Data> => {
+      const response = JSON.parse(await cli(elanous, ['--test', 'ask', '--json', JSON.stringify(payload)])) as Data;
+      return firstObject(typeof response.reply === 'string' ? response.reply : JSON.stringify(response));
+    };
+    const instruction = 'JSON 객체만 출력: subject, body (120~200자 · [S#] 표시는 글자 수에서 뺀다), linkedin (300자 이하), question. context가 있으면 body에 그 문구를 그대로 한 번 포함. '
+      + '명함 필드(이름·직함·회사)와 context 는 출처 없이 써도 된다. 그 밖의 회사·사람·시장 사실은 evidence 에 있는 것만 쓰고, 그 문장 끝에 근거 번호를 [S1] 처럼 붙인다. '
+      + 'evidence 에 없는 사실(매출·순위·규모·수상·최근 소식 등)은 쓰지 말 것. email이 없으면 메일 주소를 만들지 말 것. 어떤 메시지도 보내지 말 것.';
+    let feedback = '';
+    let accepted: { warnings: string[]; draft: Data; facts: { text: string; url: string }[] } | undefined;
+    let lastProblem = '';
+    for (let attempt = 0; attempt < 3 && !accepted; attempt++) {
+      const draft = await ask({ task: 'draft', instruction: instruction + feedback, card, context: contextLine, sender: text(input.sender), language, evidence: numbered });
+      const parts = { subject: text(draft.subject), body: text(draft.body), linkedin: text(draft.linkedin), question: text(draft.question) };
+      if (!parts.subject || !parts.body || !parts.linkedin || !parts.question) { lastProblem = '초안 필수 필드 없음'; feedback = ' 이전 응답에 필드가 빠졌다.'; continue; }
+      const body = strip(parts.body), linkedin = strip(parts.linkedin);
+      const shape: string[] = [];
+      if (body.length < 120 || body.length > 200) shape.push(`메일 본문 120~200자 범위 밖(${body.length}자)`);
+      // LinkedIn 한도는 한 번 다시 부르고, 그래도 넘으면 막지 않고 보고서에 경고로 남긴다(보내기 전 사람이 고친다).
+      const linkedinOver = linkedin.length > 300;
+      if (linkedinOver && attempt === 0) shape.push(`LinkedIn 300자 초과(${linkedin.length}자)`);
+      if (contextLine && !body.includes(contextLine)) shape.push('메일 본문에 context 없음');
+      const sentences = Object.values(parts).flatMap(sentencesOf).map(sentence => ({
+        raw: sentence, text: strip(sentence), cites: [...sentence.matchAll(marker)].map(match => Number(match[1])),
+      }));
+      const badCite = sentences.find(sentence => sentence.cites.some(n => n < 1 || n > evidence.length));
+      if (badCite) shape.push(`없는 출처 번호: ${badCite.raw}`);
+      if (shape.length) { lastProblem = shape.join(' · '); feedback = ` 이전 초안 문제: ${lastProblem}. 모두 고쳐 다시 작성하라.`; continue; }
+      // Every sentence is judged against the card, the context and only the evidence it cites — a company name alone is identity, not a claim.
+      const verdict = await ask({
+        task: 'verify',
+        instruction: '각 문장에 대해, 받는 사람·그 회사·시장에 관한 사실 주장이 명함 필드, context, 또는 그 문장이 인용한 evidence 로 뒷받침되는지 판정하라. 인사·호칭·명함에 있는 이름/회사/직함 언급·제안·질문·보내는 사람의 의도는 사실 주장이 아니다. JSON 객체만 출력: {"unsupported":[뒷받침 안 되는 문장 번호]}',
+        card, context: contextLine,
+        sentences: sentences.map((sentence, i) => ({ i, text: sentence.text, evidence: sentence.cites.map(n => numbered[n - 1]) })),
+      });
+      if (!Array.isArray(verdict.unsupported)) throw new Error('사실 검증 응답을 읽지 못했다');
+      const unsupported = verdict.unsupported.map(Number).filter(i => Number.isInteger(i) && sentences[i]).map(i => sentences[i]!.text);
+      if (unsupported.length) { lastProblem = `출처 없는 회사 사실: ${unsupported.join(' / ')}`; feedback = ` 이전 초안에서 근거 없는 문장: ${unsupported.join(' / ')}. 그 문장을 빼거나 evidence 로 뒷받침되는 문장으로 바꿔라.`; continue; }
+      const facts = sentences.flatMap(sentence => sentence.cites.map(n => ({ text: sentence.text, url: text(evidence[n - 1]!.url) })));
+      accepted = { warnings: linkedinOver ? ['LinkedIn 문구 300자 초과 — 전송 전 수정 필요'] : [], draft: { subject: strip(parts.subject), body, linkedin, question: strip(parts.question) }, facts: [...new Map(facts.map(f => [`${f.text}\n${f.url}`, f])).values()] };
+    }
+    if (!accepted) throw new Error(lastProblem || '초안 생성 실패');
+    result({ ...accepted.draft, companyFacts: accepted.facts, destination: card.email ? ['email', 'LinkedIn'] : ['LinkedIn'], warnings: accepted.warnings, language });
+  } else if (step === 'report') {
+    const read = object(outputs['read-card']);
+    const card = object(read.card ?? read);
+    const research = object(outputs.research), draft = object(outputs.draft);
+    if (!text(draft.subject) || !text(draft.linkedin) || !text(draft.question)) throw new Error('초안 없음');
+    const fallback = dirname(contextFile).endsWith('.json.contexts') ? dirname(contextFile).slice(0, -'.json.contexts'.length) : dirname(contextFile);
+    const outDir = input.outDir === undefined ? fallback : absolute(text(input.outDir), 'outDir');
+    const hits = Array.isArray(research.sources) ? research.sources.map(object) : [];
+    const warnings = Array.isArray(draft.warnings) ? draft.warnings.map(text).filter(Boolean) : [];
+    const md = ['# 네트워킹 팔로업 초안', '', '## 명함', '| 필드 | 값 |', '| --- | --- |',
+      ...fields.map(field => `| ${field} | ${line(card[field]) || 'null'} |`), '',
+      '## 조사 요약', hits.length ? line(research.summary) : '조사 결과 없음',
+      ...((Array.isArray(research.news) ? research.news : []).map(v => `- ${line(v)}`)),
+      '## 출처', ...(hits.length ? hits.map(hit => `- ${line(hit.title)} — ${text(hit.url)}`) : ['- 조사 결과 없음']), '',
+      '## 보낼 곳', ...((Array.isArray(draft.destination) ? draft.destination : []).map(v => `- ${line(v)}`)), '',
+      '## 팔로업 메일', `제목: ${line(draft.subject)}`, '', text(draft.body), '',
+      '## LinkedIn 초대 문구', text(draft.linkedin), '', '## 대화 이어 갈 질문', text(draft.question), '',
+      '## 초안의 사실과 출처', ...((Array.isArray(draft.companyFacts) && draft.companyFacts.length ? draft.companyFacts : ['출처를 인용한 문장 없음']).map(v => typeof v === 'string' ? `- ${v}` : `- ${line(object(v).text)} — ${text(object(v).url)}`)),
+      ...(warnings.length ? ['## 경고', ...warnings.map(v => `- ${v}`)] : []), '', '※ 초안만 생성했습니다. 전송은 사람이 결정합니다.', ''].join('\n');
+    mkdirSync(outDir, { recursive: true, mode: 0o700 });
+    const report = { card, research, draft, warnings, sent: false };
+    const markdown = join(outDir, 'followup.md'), json = join(outDir, 'followup.json');
+    writeFileSync(markdown, md, { mode: 0o600 });
+    writeFileSync(json, JSON.stringify(report, null, 2) + '\n', { mode: 0o600 });
+    result({ markdown, json });
+  } else throw new Error(`unknown step: ${step}`);
+} catch (error) {
+  result({ outcome: 'fail', reason: error instanceof Error ? error.message : String(error) });
+}

package/plugins/card-followup/plugin.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "card-followup",
+  "version": "0.1.0",
+  "description": "Business card photo to researched follow-up and LinkedIn drafts. Drafts are never sent.",
+  "extensions": {
+    "ai.elanous": {
+      "graphs": [
+        "./graphs/card-followup.yaml"
+      ],
+      "capabilities": [
+        "fs:workdir",
+        "proc:bun",
+        "proc:elanous",
+        "proc:codex"
+      ],
+      "connectors": [],
+      "pricing": {
+        "model": "free"
+      },
+      "trust": "official",
+      "category": "Marketing"
+    }
+  }
+}

package/plugins/geo-check/README.md

@@ -0,0 +1,13 @@
+# geo-check
+
+Run from the repository without installing the plugin:
+
+```sh
+elanous graph run plugins/geo-check/graphs/geo-check.yaml --input '{"brand":"Elanous","domain":"elanous.ai"}' --json
+```
+
+Inputs: `brand` (required name), `domain` (optional website; without it, citation is unknown rather than no), `questions` (optional array of up to 8 questions; `[]` generates five unbranded customer questions), `engines` (optional array of up to 3 distinct provider names; defaults to `openai-codex` and `grok`), and `outDir` (optional output directory, default beside the graph run state file). Questions are passed to each engine via `elanous ask --json`, and searched with `elanous research --json --limit 5`. Each step's final stdout line is JSON with `calls` and `errors`. For test fixtures, `GEO_CHECK_ELANOUS_BIN` substitutes the CLI executable.
+
+Outputs: `report.md` has a one-line summary, question × engine mention/citation/rank/error table, evidence-linked suggestions when any question × engine cell is missing a mention or citation (no suggestions when no cells are missing), and the first 400 characters of each answer. `report.json` contains the same data and full answers. One engine can fail while the other completes; if every answer fails, the graph ends at `failed`. Research failures leave empty URL lists and an error count. The table is **a sample at that instant**, not a stable brand ranking: model answers change between runs.
+
+Release note metadata: feat — New geo-check plugin measures whether AI answer engines mention and cite your brand, and suggests fixes · kind: feat · document: plugins/geo-check/README.md · target: next.

package/plugins/geo-check/examples/brand-sample.json

@@ -0,0 +1,8 @@
+{
+  "brand": "Moonfern Atelier",
+  "domain": "moonfern.example",
+  "questions": [
+    "Which studio makes hand-painted stationery for small events?",
+    "Where can I find custom illustrated invitation cards?"
+  ]
+}

package/plugins/geo-check/graphs/geo-check.yaml

@@ -0,0 +1,20 @@
+graph_id: geo-check
+version: 1
+entry_node: questions
+terminal_nodes: [done, failed]
+nodes:
+  - { node_id: questions, kind: agent, recipe: 'cmd:questions', max_visits: 1 }
+  - { node_id: answers, kind: agent, recipe: 'cmd:answers', max_visits: 1 }
+  - { node_id: web, kind: agent, recipe: 'cmd:web', max_visits: 1 }
+  - { node_id: score, kind: agent, recipe: 'cmd:score', max_visits: 1 }
+  - { node_id: suggest, kind: agent, recipe: 'cmd:suggest', max_visits: 1 }
+  - { node_id: report, kind: agent, recipe: 'cmd:report', max_visits: 1 }
+  - { node_id: done, kind: gate, max_visits: 1 }
+  - { node_id: failed, kind: gate, max_visits: 1 }
+edges:
+  - { from: questions, on: outcome, map: { ok: answers, fail: failed } }
+  - { from: answers, on: outcome, map: { ok: web, fail: failed } }
+  - { from: web, on: outcome, map: { ok: score, fail: failed } }
+  - { from: score, on: outcome, map: { ok: suggest, fail: failed } }
+  - { from: suggest, on: outcome, map: { ok: report, fail: failed } }
+  - { from: report, on: outcome, map: { ok: done, fail: failed } }

package/plugins/geo-check/graphs/recipes.yaml

@@ -0,0 +1,18 @@
+questions:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" questions'
+  timeout_ms: 120000
+answers:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" answers'
+  timeout_ms: 600000
+web:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" web'
+  timeout_ms: 600000
+score:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" score'
+  timeout_ms: 30000
+suggest:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" suggest'
+  timeout_ms: 120000
+report:
+  command: 'bun "$ELANOUS_GRAPH_DIR/run-step.ts" report'
+  timeout_ms: 30000