@tienne/gestalt 0.99.0 → 0.100.0

package/dist/src/research/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../src/research/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,iEAAiE;AACjE,eAAO,MAAM,YAAY,6BAA8B,CAAC;AACxD,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,4EAOtB,CAAC;AACX,eAAO,MAAM,iBAAiB,2CAA4C,CAAC;AAC3E,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AACX,eAAO,MAAM,wBAAwB;;;;;CAK3B,CAAC;AACX,eAAO,MAAM,iBAAiB,kCAAmC,CAAC;AAClE,0CAA0C;AAC1C,eAAO,MAAM,YAAY,yDAA0D,CAAC;AACpF,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,wEAKtB,CAAC;AAIX,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,OAA2B,CAAC;AAErE,eAAO,MAAM,WAAW,qKAAwC,CAAC;AA+EjE,qEAAqE;AACrE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKF,CAAC;AAe3B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA5FrB,iDAAiD;;QAEjD,oDAAoD;;QAEpD,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiBlD,uBAAuB;;QAEvB,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8E9D,8CAA8C;;IAE9C,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA3DzC,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QASlC,yBAAyB;;QAEzB,8BAA8B;;QAE9B,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmDpB,6CAA6C;;;QA3C7C,qBAAqB;;;;;;;;;;;;;;;IA6CrB,2CAA2C;;;QA5BzC,2BAA2B;;QAE3B,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BtB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAKlD,wCAAwC;AACxC,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU5E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAEnF;AAED,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAezE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,EAAE,CAarE;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAG7D;AAID,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAwGhF"}

package/dist/src/research/target.js

@@ -0,0 +1,323 @@
+import { z } from 'zod';
+import { basisFields, checkBasis } from './evidence.js';
+import { httpsUrlSchema, idSchema, textSchema } from './schema-base.js';
+/** improve: 이미 있는 화면을 고친다. new: 아직 없는 화면이라 기준값을 비슷한 퍼널에서 빌려온다 */
+export const TARGET_MODES = ['improve', 'new'];
+/** 목표치 계산 한 단계가 어디서 온 숫자인지. 위에 있을수록 믿을 만하다 */
+export const TARGET_STEP_METHODS = [
+    'internal',
+    'proxy',
+    'business',
+    'market',
+    'case',
+    'assumption',
+];
+export const TRACKING_STATUSES = ['exists', 'missing', 'planned'];
+export const LIFT_METHOD_LABEL = {
+    experiment: '우리 지난 실험',
+    case: '타사 사례',
+    market: '시장 자료',
+    assumption: '가정',
+};
+export const SHORTFALL_DECISION_LABEL = {
+    'add-hypotheses': '가설 추가',
+    'swap-hypotheses': '효과 큰 가설로 교체',
+    'lower-target': '목표 낮춤',
+    keep: '그대로 둠',
+};
+export const DATA_SOURCE_KINDS = ['amplitude', 'export'];
+/** 가설 기대 효과가 어디서 온 값인지. 위에 있을수록 믿을 만하다 */
+export const LIFT_METHODS = ['experiment', 'case', 'market', 'assumption'];
+/** 가설을 다 성공해도 목표에 못 닿을 때 사용자와 고르는 대응 */
+export const SHORTFALL_DECISIONS = [
+    'add-hypotheses',
+    'swap-hypotheses',
+    'lower-target',
+    'keep',
+];
+/** 분석 도구 키처럼 보이는 값. 프로젝트 이름이나 파일 경로 자리에 키를 붙여 넣는 실수를 막는다 */
+const KEY_LIKE = /\b[0-9a-f]{32}\b/i;
+export const looksLikeKey = (s) => KEY_LIKE.test(s);
+const noKey = (s) => !looksLikeKey(s);
+export const KEY_MESSAGE = '키처럼 보이는 값은 적지 않는다. 키가 있는 파일 경로만 적는다';
+const pctSchema = z.number().min(0).max(100);
+const isUsableBasis = (basis) => basis !== 'unconfirmed' && basis !== 'absent';
+const baselineSchema = z
+    .object({
+    /** 지금 값(%). 못 구했으면 비우고 basis를 unconfirmed로 둔다 */
+    valuePct: pctSchema.optional(),
+    /** 어느 기간의 값인지. 예: "2026-08-01부터 2026-09-25까지 8주" */
+    period: textSchema,
+    /** 신규 화면이라 대신 쓴 기존 퍼널. 예: "포인트 충전 진입 대비 결제 완료" */
+    proxyOf: z.string().optional(),
+    ...basisFields,
+})
+    .superRefine((b, ctx) => {
+    checkBasis(b, ctx);
+    if (b.valuePct === undefined && isUsableBasis(b.basis)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['valuePct'],
+            message: '값이 없으면 basis를 unconfirmed로 두고 이유를 적는다',
+        });
+    }
+});
+const entrantsSchema = z
+    .object({
+    /** 분모에 들어오는 하루 사람 수 */
+    value: z.number().positive(),
+    /** 신규 화면이면 어떻게 추정했는지. 예: "마이 탭 하루 조회 6만 × 비슷한 배너 클릭률 7%" */
+    derivation: z.string().optional(),
+    ...basisFields,
+})
+    .superRefine(checkBasis);
+const rangeSchema = z
+    .object({
+    conservativePct: pctSchema,
+    expectedPct: pctSchema,
+    stretchPct: pctSchema,
+})
+    .refine((r) => r.conservativePct <= r.expectedPct && r.expectedPct <= r.stretchPct, '목표 범위는 보수 ≤ 기대 ≤ 도전 순서다');
+const targetStepSchema = z
+    .object({
+    id: idSchema,
+    label: textSchema,
+    /** 값과 단위를 같이. 예: "하루 4,200명" */
+    value: textSchema,
+    method: z.enum(TARGET_STEP_METHODS),
+    ...basisFields,
+})
+    .superRefine(checkBasis);
+const dataSourceSchema = z.object({
+    kind: z.enum(DATA_SOURCE_KINDS),
+    /** 프로젝트 이름. 키는 적지 않는다 */
+    project: textSchema.refine(noKey, KEY_MESSAGE),
+    /** 같은 숫자를 다시 볼 수 있는 저장된 차트 */
+    chartUrl: httpsUrlSchema.optional(),
+    /** 퍼널 단계마다 쓴 이벤트 */
+    events: z.array(z.object({ step: textSchema, event: textSchema })).default([]),
+    from: textSchema,
+    to: textSchema,
+});
+const trackingItemSchema = z.object({
+    event: textSchema,
+    /** 퍼널의 어느 단계를 재는지 */
+    step: textSchema,
+    status: z.enum(TRACKING_STATUSES),
+    note: z.string().optional(),
+});
+/** 가설의 기대 효과(expectedLiftPp)가 어디서 왔는지. 표본과 목표 도달 계산이 전부 이 값에서 나온다 */
+export const liftBasisSchema = z
+    .object({
+    method: z.enum(LIFT_METHODS),
+    ...basisFields,
+})
+    .superRefine(checkBasis);
+const shortfallSchema = z
+    .object({
+    decision: z.enum(SHORTFALL_DECISIONS),
+    /** 목표를 낮췄으면 처음 기대 목표(%) */
+    originalExpectedPct: pctSchema.optional(),
+    /** 누가 왜 그렇게 정했는지 */
+    note: textSchema,
+})
+    .refine((s) => s.decision !== 'lower-target' || s.originalExpectedPct !== undefined, {
+    message: '목표를 낮췄으면 처음 기대 목표(originalExpectedPct)를 적는다',
+    path: ['originalExpectedPct'],
+});
+export const targetSchema = z.object({
+    mode: z.enum(TARGET_MODES),
+    metric: z.object({
+        name: textSchema,
+        numerator: textSchema,
+        denominator: textSchema,
+    }),
+    baseline: baselineSchema,
+    dailyEntrants: entrantsSchema.optional(),
+    /** 주마다 출렁이는 폭(%p). 이보다 작은 효과는 실험 없이는 안 보인다 */
+    weeklySpreadPp: z.number().nonnegative().optional(),
+    /** 아무것도 안 해도 목표 시점까지 움직일 몫(%p). 내려가면 음수 */
+    trendPp: z.number().optional(),
+    range: rangeSchema.optional(),
+    steps: z.array(targetStepSchema).default([]),
+    dataSource: dataSourceSchema.optional(),
+    /** 가설을 재는 데 필요한 이벤트. 신규 화면이면 심어야 할 목록이 된다 */
+    trackingPlan: z.array(trackingItemSchema).default([]),
+    /** 가설을 다 성공해도 기대 목표에 못 닿았을 때 사용자와 고른 대응 */
+    shortfall: shortfallSchema.optional(),
+});
+// 두 비율 비교, 양측 유의수준 0.05, 검정력 0.8
+const Z_ALPHA = 1.959964;
+const Z_BETA = 0.841621;
+/** 이보다 오래 걸리는 실험은 이 트래픽으로 못 가려낸다고 본다 */
+export const MAX_TEST_DAYS = 56;
+/** 기준 전환율 basePct에서 liftPp만큼 오른 걸 가려내는 데 필요한 군당 표본 */
+export function requiredSamplePerArm(basePct, liftPp) {
+    const p1 = basePct / 100;
+    const p2 = (basePct + liftPp) / 100;
+    if (liftPp <= 0 || p2 >= 1)
+        return Number.POSITIVE_INFINITY;
+    const pBar = (p1 + p2) / 2;
+    const a = Z_ALPHA * Math.sqrt(2 * pBar * (1 - pBar));
+    const b = Z_BETA * Math.sqrt(p1 * (1 - p1) + p2 * (1 - p2));
+    return Math.ceil((a + b) ** 2 / (p2 - p1) ** 2);
+}
+/** 군당 표본 n으로 가려낼 수 있는 가장 작은 효과(%p). 소수 첫째 자리까지 */
+export function minDetectableLiftPp(basePct, nPerArm) {
+    let lo = 0;
+    let hi = 100 - basePct;
+    if (requiredSamplePerArm(basePct, hi - 1e-9) > nPerArm)
+        return Number.POSITIVE_INFINITY;
+    for (let i = 0; i < 40; i++) {
+        const mid = (lo + hi) / 2;
+        if (requiredSamplePerArm(basePct, mid) <= nPerArm)
+            hi = mid;
+        else
+            lo = mid;
+    }
+    return Math.ceil(hi * 10) / 10;
+}
+export function daysNeeded(nPerArm, dailyEntrants, arms = 2) {
+    return Math.ceil((nPerArm * arms) / dailyEntrants);
+}
+/** 기대 효과가 하나도 없거나 기준값, 목표 범위가 없으면 계산하지 않는다 */
+export function liftCoverage(research) {
+    const t = research.target;
+    const base = t?.baseline.valuePct;
+    if (!t?.range || base === undefined)
+        return undefined;
+    const lifts = research.verification.flatMap((v) => v.expectedLiftPp === undefined ? [] : [v.expectedLiftPp]);
+    if (lifts.length === 0)
+        return undefined;
+    const trend = t.trendPp ?? 0;
+    const plannedPp = round1(lifts.reduce((s, x) => s + x, 0));
+    return {
+        neededPp: round1(t.range.expectedPct - base - trend),
+        plannedPp,
+        reachPct: round1(base + trend + plannedPp),
+    };
+}
+/** 기대 효과가 적힌 가설마다 필요한 표본과 걸리는 일수 */
+export function hypothesisPower(research) {
+    const t = research.target;
+    const base = t?.baseline.valuePct;
+    if (!t || base === undefined)
+        return [];
+    return research.verification.flatMap((v, index) => {
+        if (v.expectedLiftPp === undefined)
+            return [];
+        const nPerArm = requiredSamplePerArm(base, v.expectedLiftPp);
+        const days = t.dailyEntrants && Number.isFinite(nPerArm)
+            ? daysNeeded(nPerArm, t.dailyEntrants.value)
+            : undefined;
+        return [{ index, liftPp: v.expectedLiftPp, nPerArm, ...(days === undefined ? {} : { days }) }];
+    });
+}
+/** 기준값을 실제 데이터로 채웠는지. 채웠으면 타사 사례는 교차 확인용으로 내려간다 */
+export function hasUsableBaseline(research) {
+    const b = research.target?.baseline;
+    return !!b && b.valuePct !== undefined && isUsableBasis(b.basis);
+}
+const round1 = (x) => Math.round(x * 10) / 10;
+export function lintTarget(research, warnings) {
+    const t = research.target;
+    if (!t) {
+        if (research.verification.length > 0) {
+            warnings.push({
+                path: 'target',
+                message: '목표치 근거가 없다. 기준값과 하루 진입 수를 기존 데이터에서 뽑아 목표 범위를 계산한다',
+            });
+        }
+        return;
+    }
+    if (!hasUsableBaseline(research)) {
+        warnings.push({
+            path: 'target.baseline',
+            message: '기준값을 아직 못 구했다. 열린 질문(owner: data)으로 넘긴다',
+        });
+    }
+    if (t.mode === 'new' && !t.baseline.proxyOf?.trim()) {
+        warnings.push({
+            path: 'target.baseline.proxyOf',
+            message: '신규 화면인데 기준값을 어느 기존 퍼널에서 빌렸는지 없다',
+        });
+    }
+    if (!t.range) {
+        warnings.push({ path: 'target.range', message: '목표 범위(보수, 기대, 도전)가 없다' });
+    }
+    const coverage = liftCoverage(research);
+    if (coverage && coverage.plannedPp < coverage.neededPp) {
+        const gap = `기대 효과 합 ${coverage.plannedPp}%p, 필요 ${coverage.neededPp}%p`;
+        const decision = t.shortfall?.decision;
+        if (!decision) {
+            warnings.push({
+                path: 'verification',
+                message: `가설을 다 성공해도 목표에 못 닿는다 (${gap}). 가설 추가, 효과 큰 가설로 교체, 목표 낮춤, 그대로 둠 중에서 사용자와 골라 target.shortfall에 적는다`,
+            });
+        }
+        else if (decision !== 'keep') {
+            warnings.push({
+                path: 'target.shortfall',
+                message: `목표에 못 닿아 고른 대응은 '${SHORTFALL_DECISION_LABEL[decision]}'인데 아직 못 닿는다 (${gap})`,
+            });
+        }
+    }
+    if (!coverage && t.range && research.verification.length > 0) {
+        if (!research.verification.some((v) => v.expectedLiftPp !== undefined)) {
+            warnings.push({
+                path: 'verification',
+                message: '기대 효과(expectedLiftPp)가 적힌 가설이 없어서 목표까지 닿는지 못 본다',
+            });
+        }
+    }
+    research.verification.forEach((v, i) => {
+        const lift = v.expectedLiftPp;
+        if (lift !== undefined && !v.liftBasis) {
+            warnings.push({
+                path: `verification.${i}.liftBasis`,
+                message: `기대 효과 ${lift}%p의 근거가 없다 (가설 ${i + 1}). 우리 지난 실험이나 타사 사례를 찾아 liftBasis에 단다`,
+            });
+        }
+        else if (lift !== undefined &&
+            v.liftBasis &&
+            (v.liftBasis.method === 'assumption' || !isUsableBasis(v.liftBasis.basis))) {
+            warnings.push({
+                path: `verification.${i}.liftBasis`,
+                message: `기대 효과 ${lift}%p가 가정이다 (가설 ${i + 1}). 이 값으로 계산한 표본과 목표 도달이 같이 흔들린다`,
+            });
+        }
+        if (lift !== undefined && t.weeklySpreadPp !== undefined && lift < t.weeklySpreadPp) {
+            warnings.push({
+                path: `verification.${i}.expectedLiftPp`,
+                message: `기대 효과 ${lift}%p가 주별 변동 ${t.weeklySpreadPp}%p보다 작다 (가설 ${i + 1}). 실험 없이 전후 비교로는 안 보인다`,
+            });
+        }
+    });
+    for (const p of hypothesisPower(research)) {
+        if (p.days !== undefined && p.days > MAX_TEST_DAYS) {
+            warnings.push({
+                path: `verification.${p.index}.expectedLiftPp`,
+                message: `이 트래픽으로는 못 가려낸다 (가설 ${p.index + 1}: 군당 ${p.nPerArm.toLocaleString('ko-KR')}명, ${p.days}일)`,
+            });
+        }
+    }
+    const tracked = new Map(t.trackingPlan.map((x) => [x.event, x.status]));
+    research.verification.forEach((v, i) => {
+        v.events.forEach((event, k) => {
+            const status = tracked.get(event);
+            if (status === 'missing') {
+                warnings.push({
+                    path: `verification.${i}.events.${k}`,
+                    message: `측정할 이벤트가 없다 (가설 ${i + 1}: ${event}). 심을지 정한다`,
+                });
+            }
+            else if (status === undefined && t.trackingPlan.length > 0) {
+                warnings.push({
+                    path: `verification.${i}.events.${k}`,
+                    message: `이벤트 목록(trackingPlan)에 없는 이벤트다 (가설 ${i + 1}: ${event})`,
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=target.js.map

package/dist/src/research/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../../src/research/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAkB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGxE,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,KAAK,CAAU,CAAC;AACxD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,MAAM;IACN,YAAY;CACJ,CAAC;AACX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,UAAU;IACtB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,IAAI;CACR,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,aAAa;IAChC,cAAc,EAAE,OAAO;IACvB,IAAI,EAAE,OAAO;CACL,CAAC;AACX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAU,CAAC;AAClE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AACpF,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB;IAChB,iBAAiB;IACjB,cAAc;IACd,MAAM;CACE,CAAC;AAEX,4DAA4D;AAC5D,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrE,MAAM,KAAK,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,qCAAqC,CAAC;AAEjE,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7C,MAAM,aAAa,GAAG,CAAC,KAAgB,EAAW,EAAE,CAAC,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,QAAQ,CAAC;AAEnG,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC9B,oDAAoD;IACpD,MAAM,EAAE,UAAU;IAClB,kDAAkD;IAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,GAAG,WAAW;CACf,CAAC;KACD,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;IACtB,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,OAAO,EAAE,uCAAuC;SACjD,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,uBAAuB;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,4DAA4D;IAC5D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,GAAG,WAAW;CACf,CAAC;KACD,WAAW,CAAC,UAAU,CAAC,CAAC;AAE3B,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,eAAe,EAAE,SAAS;IAC1B,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,SAAS;CACtB,CAAC;KACD,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,EAC1E,yBAAyB,CAC1B,CAAC;AAEJ,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,UAAU;IACjB,gCAAgC;IAChC,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IACnC,GAAG,WAAW;CACf,CAAC;KACD,WAAW,CAAC,UAAU,CAAC,CAAC;AAE3B,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IAC/B,yBAAyB;IACzB,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC;IAC9C,8BAA8B;IAC9B,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,oBAAoB;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9E,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,UAAU;CACf,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,UAAU;IACjB,qBAAqB;IACrB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAC5B,GAAG,WAAW;CACf,CAAC;KACD,WAAW,CAAC,UAAU,CAAC,CAAC;AAE3B,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IACrC,2BAA2B;IAC3B,mBAAmB,EAAE,SAAS,CAAC,QAAQ,EAAE;IACzC,oBAAoB;IACpB,IAAI,EAAE,UAAU;CACjB,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,cAAc,IAAI,CAAC,CAAC,mBAAmB,KAAK,SAAS,EAAE;IACnF,OAAO,EAAE,6CAA6C;IACtD,IAAI,EAAE,CAAC,qBAAqB,CAAC;CAC9B,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,UAAU;KACxB,CAAC;IACF,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,cAAc,CAAC,QAAQ,EAAE;IACxC,8CAA8C;IAC9C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACnD,2CAA2C;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACvC,6CAA6C;IAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,2CAA2C;IAC3C,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAIH,iCAAiC;AACjC,MAAM,OAAO,GAAG,QAAQ,CAAC;AACzB,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,sDAAsD;AACtD,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,MAAc;IAClE,MAAM,EAAE,GAAG,OAAO,GAAG,GAAG,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC;IACpC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAC5D,MAAM,IAAI,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,OAAe;IAClE,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC;IACvB,IAAI,oBAAoB,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IACxF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,OAAO;YAAE,EAAE,GAAG,GAAG,CAAC;;YACvD,EAAE,GAAG,GAAG,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,aAAqB,EAAE,IAAI,GAAG,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;AACrD,CAAC;AAWD,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,QAAkB;IAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClC,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAChD,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CACzD,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC;QACpD,SAAS;QACT,QAAQ,EAAE,MAAM,CAAC,IAAI,GAAG,KAAK,GAAG,SAAS,CAAC;KAC3C,CAAC;AACJ,CAAC;AAUD,oCAAoC;AACpC,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClC,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QAChD,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;QAC7D,MAAM,IAAI,GACR,CAAC,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YACzC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;YAC5C,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IACpC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAE9D,MAAM,UAAU,UAAU,CAAC,QAAkB,EAAE,QAA2B;IACxE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,QAAQ;gBACd,OAAO,EACL,mDAAmD;aACtD,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,yCAAyC;SACnD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,iCAAiC;SAC3C,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,WAAW,QAAQ,CAAC,SAAS,UAAU,QAAQ,CAAC,QAAQ,IAAI,CAAC;QACzE,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,yBAAyB,GAAG,uEAAuE;aAC7G,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,oBAAoB,wBAAwB,CAAC,QAAQ,CAAC,iBAAiB,GAAG,GAAG;aACvF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,EAAE,CAAC;YACvE,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,gBAAgB,CAAC,YAAY;gBACnC,OAAO,EAAE,SAAS,IAAI,kBAAkB,CAAC,GAAG,CAAC,uCAAuC;aACrF,CAAC,CAAC;QACL,CAAC;aAAM,IACL,IAAI,KAAK,SAAS;YAClB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAC1E,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,gBAAgB,CAAC,YAAY;gBACnC,OAAO,EAAE,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,iCAAiC;aAC7E,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC;YACpF,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,gBAAgB,CAAC,iBAAiB;gBACxC,OAAO,EAAE,SAAS,IAAI,aAAa,CAAC,CAAC,cAAc,eAAe,CAAC,GAAG,CAAC,wBAAwB;aAChG,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,gBAAgB,CAAC,CAAC,KAAK,iBAAiB;gBAC9C,OAAO,EAAE,uBAAuB,CAAC,CAAC,KAAK,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI;aACrG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE;oBACrC,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,YAAY;iBACxD,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7D,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE;oBACrC,OAAO,EAAE,qCAAqC,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG;iBACjE,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/research/video-transfer.d.ts

@@ -0,0 +1,28 @@
+import { ValidationError } from '../core/errors.js';
+import { type Result } from '../core/result.js';
+import { type Research } from './schema.js';
+export interface SplitOutcome {
+    /** removeFromMain이면 영상 블록을 뺀 본문, 아니면 받은 그대로 */
+    main: Research;
+    video: Research;
+    /** 영상 문서 폴더로 옮길 캡처 이미지의 상대 경로 */
+    imagePaths: string[];
+}
+export interface MergeOutcome {
+    main: Research;
+    /** 본문 폴더로 옮길 캡처 이미지의 상대 경로 */
+    imagePaths: string[];
+}
+/**
+ * 본문의 영상 블록을 `video-analysis` 문서로 떼어낸다. 발견이 가리키는 제품, 프레임 캡처,
+ * 그 캡처의 화면 지도 항목만 따라간다. 본문은 기본으로 그대로 둔다
+ */
+export declare function splitVideo(main: Research, videoSlug: string, opts?: {
+    removeFromMain?: boolean;
+}): Result<SplitOutcome, ValidationError>;
+/**
+ * 영상 문서의 영상 블록을 본문에 합친다. 같은 id가 같은 내용이면 하나로 보고
+ * 내용이 다르면 어느 쪽도 덮어쓰지 않고 멈춘다
+ */
+export declare function mergeVideo(main: Research, videoDoc: Research): Result<MergeOutcome, ValidationError>;
+//# sourceMappingURL=video-transfer.d.ts.map

package/dist/src/research/video-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-transfer.d.ts","sourceRoot":"","sources":["../../../src/research/video-transfer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,8BAA8B;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAWD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAwCvC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CA6CvC"}

package/dist/src/research/video-transfer.js

@@ -0,0 +1,100 @@
+import { ValidationError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+import { parseResearch } from './schema.js';
+import { isValidSlug } from './store.js';
+const fail = (message) => err(new ValidationError(message, [message]));
+const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function reparse(input) {
+    return parseResearch(input);
+}
+/**
+ * 본문의 영상 블록을 `video-analysis` 문서로 떼어낸다. 발견이 가리키는 제품, 프레임 캡처,
+ * 그 캡처의 화면 지도 항목만 따라간다. 본문은 기본으로 그대로 둔다
+ */
+export function splitVideo(main, videoSlug, opts = {}) {
+    if (!isValidSlug(videoSlug))
+        return fail(`영상 문서의 slug가 올바르지 않다: ${videoSlug}`);
+    if (videoSlug === main.meta.slug)
+        return fail('영상 문서의 slug가 본문과 같다');
+    if (main.meta.kind === 'video-analysis')
+        return fail('이미 영상 분석 문서라 더 뗄 게 없다');
+    const block = main.video;
+    if (!block || block.clips.length === 0)
+        return fail('떼어낼 영상 블록이 없다');
+    const copy = structuredClone(main);
+    const productIds = new Set(block.clips.map((c) => c.productId));
+    const captureIds = new Set(block.findings.map((f) => f.captureId).filter((id) => id !== undefined));
+    const captures = copy.captures.filter((c) => captureIds.has(c.id));
+    const screenIds = new Set(captures.map((c) => c.screenMapId).filter(Boolean));
+    const video = reparse({
+        schemaVersion: copy.schemaVersion,
+        meta: {
+            slug: videoSlug,
+            title: `${copy.meta.title} 영상 분석`,
+            task: copy.meta.task,
+            kind: 'video-analysis',
+        },
+        plan: copy.plan,
+        premise: copy.premise,
+        productCandidates: copy.productCandidates.filter((p) => productIds.has(p.id)),
+        screenMap: copy.screenMap.filter((s) => screenIds.has(s.id)),
+        captures,
+        video: copy.video,
+    });
+    if (!video.ok)
+        return video;
+    let nextMain = main;
+    if (opts.removeFromMain) {
+        const { video: _removed, ...rest } = structuredClone(main);
+        const parsed = reparse(rest);
+        if (!parsed.ok)
+            return parsed;
+        nextMain = parsed.value;
+    }
+    return ok({ main: nextMain, video: video.value, imagePaths: captures.map((c) => c.path) });
+}
+/**
+ * 영상 문서의 영상 블록을 본문에 합친다. 같은 id가 같은 내용이면 하나로 보고
+ * 내용이 다르면 어느 쪽도 덮어쓰지 않고 멈춘다
+ */
+export function mergeVideo(main, videoDoc) {
+    const incoming = videoDoc.video;
+    if (!incoming || incoming.clips.length === 0)
+        return fail('합칠 영상 블록이 없다');
+    if (videoDoc.meta.slug === main.meta.slug)
+        return fail('본문과 영상 문서가 같은 문서다');
+    const next = structuredClone(main);
+    const conflicts = [];
+    const mergeById = (label, target, items, key) => {
+        for (const item of items) {
+            const found = target.find((t) => t.id === item.id);
+            if (!found)
+                target.push(structuredClone(item));
+            else if (!same(key(found), key(item)))
+                conflicts.push(`${label} ${item.id}`);
+        }
+    };
+    mergeById('제품', next.productCandidates, videoDoc.productCandidates, (p) => p.name);
+    mergeById('화면 지도', next.screenMap, videoDoc.screenMap, (s) => [s.productId, s.screen]);
+    mergeById('캡처', next.captures, videoDoc.captures, (c) => [c.productId, c.path]);
+    const clips = next.video?.clips ?? [];
+    const findings = next.video?.findings ?? [];
+    mergeById('영상', clips, incoming.clips, (c) => c);
+    for (const f of incoming.findings) {
+        if (!findings.some((x) => same(x, f)))
+            findings.push(structuredClone(f));
+    }
+    if (conflicts.length > 0) {
+        return fail(`같은 id인데 내용이 다르다: ${conflicts.join(', ')}. 한쪽 id를 바꾼 뒤 다시 합친다`);
+    }
+    next.video = { clips, findings };
+    const parsed = reparse(next);
+    if (!parsed.ok)
+        return parsed;
+    const wanted = new Set(videoDoc.captures.map((c) => c.id));
+    return ok({
+        main: parsed.value,
+        imagePaths: parsed.value.captures.filter((c) => wanted.has(c.id)).map((c) => c.path),
+    });
+}
+//# sourceMappingURL=video-transfer.js.map

package/dist/src/research/video-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-transfer.js","sourceRoot":"","sources":["../../../src/research/video-transfer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.99.0",
+  "version": "0.100.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",
@@ -29,7 +29,7 @@
   "scripts": {
     "dev": "tsx bin/gestalt.ts",
     "build": "tsc -p tsconfig.build.json",
-    "postbuild": "rm -rf dist/plugin && mkdir -p dist/plugin && cp -r plugin/agents plugin/role-agents plugin/review-agents plugin/personas plugin/skills dist/plugin/ && cp -r schemas dist/ && cp package.json dist/ && chmod +x dist/bin/gestalt.js dist/bin/gestalt-hook.js && pnpm run verify:plugin && pnpm run verify:rules && pnpm run verify:rule-overlap && pnpm run verify:output-style && pnpm run verify:routing",
+    "postbuild": "rm -rf dist/plugin && mkdir -p dist/plugin && cp -r plugin/agents plugin/role-agents plugin/review-agents plugin/personas plugin/research-sources plugin/skills dist/plugin/ && cp -r schemas dist/ && cp package.json dist/ && chmod +x dist/bin/gestalt.js dist/bin/gestalt-hook.js && pnpm run verify:plugin && pnpm run verify:rules && pnpm run verify:rule-overlap && pnpm run verify:output-style && pnpm run verify:routing",
     "verify:plugin": "tsx scripts/verify-plugin-assets.ts",
     "prepublishOnly": "pnpm build",
     "test": "vitest run",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gestalt",
-  "version": "0.99.0",
+  "version": "0.100.0",
   "description": "Gestalt psychology-driven AI development harness. Transforms scattered requirements into structured, validated specifications through interactive interviews.",
   "author": {
     "name": "tienne"

package/plugin/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.99.0", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.100.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }

package/plugin/mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.99.0", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.100.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }

package/plugin/research-sources/amplitude/SOURCE.md

@@ -0,0 +1,28 @@
+---
+name: amplitude
+description: 우리 제품의 Amplitude에서 목표 지표의 기준값과 하루 진입 수, 주별 변동을 뽑는다
+stage: [baseline]
+access:
+  - mcp: { tools: [get_amplitude_context, query_amplitude_data] }
+evidence: observation
+limits: '프로젝트와 이벤트 이름은 사람마다 다르다. 제품 프로필 없이 이름을 짐작해서 질의하지 않는다. 합계만 가져오고 사용자 단위 데이터는 가져오지 않는다'
+fallback: '담당자에게 퍼널 차트에서 내보낸 숫자(기간, 단계별 사용자 수)를 받는다. 그것도 없으면 기준값을 열린 질문(owner: data)으로 남긴다'
+---
+
+## 찾는 법
+
+1. `ges_research action=profile product=<제품>`으로 제품 프로필을 읽는다. 없으면 제품 코드 경로를 받아 SDK 초기화와 이벤트 호출을 훑어서 먼저 저장한다. `stale`이 true면 다시 훑을지 사람에게 묻는다.
+2. 도구는 `sources` 응답의 `mcpServer`로 부른다. 서버 이름은 사람마다 달라서 짐작하지 않는다. `get_amplitude_context`로 접근 가능한 프로젝트 목록을 받는다. 프로필의 이벤트 이름이 이벤트 목록에 있는 프로젝트를 후보로 올리고 사람에게 한 번 확인받는다. 프로필에 `amplitudeProject`가 있으면 그걸 먼저 제안한다.
+3. 저장된 차트를 먼저 찾는다. 목표 지표 이름이나 퍼널 단계 이벤트로 검색해서 분자와 분모가 맞는 퍼널 차트가 있으면 그 차트를 돌린다. 차트 링크는 `target.dataSource.chartUrl`에 둔다.
+4. 맞는 차트가 없으면 프로필의 이벤트로 퍼널을 직접 질의한다. 이벤트 이름은 짐작하지 않고 프로젝트의 이벤트 목록에서 확인한 것만 쓴다.
+5. 기간은 최근 4~8주로 잡고 주 단위로 나눠 본다. 전체 전환율은 `baseline.valuePct`, 주별 최대와 최소의 차이 절반은 `weeklySpreadPp`, 첫 단계 하루 평균 사용자 수는 `dailyEntrants`에 둔다.
+6. 새로 만드는 화면이면 기능이 붙는 흐름(`premise.attachTo.flow`)의 기존 퍼널을 먼저 후보로 두고 사람과 같이 고른다. 그 퍼널의 전환율을 기준값으로 쓰고 `proxyOf`에 퍼널 이름을 적는다. 진입 수는 진입점 화면 조회 수에 비슷한 진입점의 클릭률을 곱하고 식을 `derivation`에 적는다.
+7. 근거는 `evidence: internal`로 걸고 차트 이름이나 질의 조건을 `source`에 적는다.
+8. 가설의 기대 효과 근거(`liftBasis`)를 찾을 때는 지난 실험 결과를 읽기 전용으로 본다. 실험 도구가 있으면 목록과 결과만 읽고 비슷한 화면을 바꿨던 실험의 효과를 `method: experiment`로 적는다. 실험 이름과 기간을 `evidence: internal`의 `source`에 적는다. 맞는 실험이 없으면 다른 근거로 넘어간다.
+
+## 멈추는 곳
+
+- 프로젝트는 사람이 고른다. 후보가 하나여도 확인받는다.
+- 이벤트나 프로젝트 설정을 바꾸는 도구(이벤트 생성, 속성 수정, 차트 저장, 실험과 플래그 수정)는 부르지 않는다. 읽기만 한다.
+- 사용자 목록, 세션 리플레이, 개별 사용자 속성은 열지 않는다. 합계만 쓴다.
+- API 키나 프로젝트 키 값은 리서치 문서와 프로필에 적지 않는다. 키가 있는 파일 경로만 적는다.

package/plugin/research-sources/app-store-reviews/SOURCE.md

@@ -0,0 +1,25 @@
+---
+name: app-store-reviews
+description: 앱스토어 리뷰 RSS에서 사용자가 같이 쓰는 다른 서비스 이름을 뽑는다
+stage: [product-discovery, evidence]
+axis: [same-problem]
+access:
+  - http: { host: itunes.apple.com }
+evidence: observation
+limits: "한 번에 최근 리뷰 50개 정도만 줘서 표본이 작다"
+fallback: "후보 확장은 검색어를 바꿔 앱스토어 검색을 반복하는 것으로 대신한다"
+---
+
+## 찾는 법
+
+1. 후보 앱의 번들이 아니라 스토어 앱 ID(숫자)를 쓴다. 앱스토어 검색 결과의 `trackId`다.
+2. `https://itunes.apple.com/kr/rss/customerreviews/page=1/id=<앱ID>/sortby=mostrecent/json`을 GET으로 부른다.
+3. 리뷰 본문에서 다른 서비스 이름이 나온 것을 센다. 나온 횟수는 `foundVia.reviewMentions`에 적는다.
+4. 상위 후보의 리뷰에서 새 이름을 뽑고 그 앱의 리뷰를 다시 본다. 새 이름이 안 나오면 멈춘다.
+5. 리뷰 문장을 인용할 때는 작성자 이름과 닉네임을 빼고 문장만 적는다.
+
+## 멈추는 곳
+
+- 리뷰에 개인정보(전화번호, 주문 번호)가 섞여 있으면 인용하지 않는다.
+- 같은 앱을 반복해서 빠르게 부르지 않는다. 앱마다 한 번이면 된다.
+- 표본이 작아서 이름이 한두 번 나온 것은 후보로 올리지 않고 `foundVia`에 참고로만 둔다.

package/plugin/research-sources/app-store-search/SOURCE.md

@@ -0,0 +1,25 @@
+---
+name: app-store-search
+description: 앱스토어 검색 API로 제품 후보와 평점 수(규모 짐작)를 찾는다
+stage: [product-discovery, scale]
+axis: [same-market, same-problem]
+access:
+  - http: { host: itunes.apple.com, probe: "https://itunes.apple.com/search?term=gift&country=kr&entity=software&limit=1" }
+evidence: observation
+limits: "큰 앱 안의 기능은 검색 결과에 안 나온다. 평점 수는 규모의 대용치이지 사용자 수가 아니다"
+fallback: "기술 블로그와 웹 검색으로 후보를 찾는다"
+---
+
+## 찾는 법
+
+1. 사용자가 그 기능을 부르는 일반 말로 검색어를 정한다. 한 가지로 끝내지 않고 비슷한 말로 두세 번 더 돌린다.
+2. `https://itunes.apple.com/search?term=<검색어>&country=kr&entity=software&limit=50`을 GET으로 부른다. 키는 필요 없다.
+3. 결과의 장르(`primaryGenreName`), 평점 수(`userRatingCount`), 번들 ID(`bundleId`), 설명(`description`)을 읽는다.
+4. 장르와 설명에 검색어가 있는지로 먼저 거른다. 남은 것은 같은 시장인지 같은 문제인지 판단해 후보로 올린다. 리워드 앱, 게임, 매장 앱이 섞여 나온다.
+5. 평점 수는 `scale`에 `store-rating-count`로 적는다. 규모를 짐작한 것이라 `(해석)`을 붙인다.
+
+## 멈추는 곳
+
+- 검색어에 공개 전 기획 내용(내부 기능 이름, 가격, 출시 일정)을 넣지 않는다. 사용자가 부르는 일반 말만 쓴다.
+- 요청이 막히거나 오류가 반복되면 간격을 두고 한 번만 다시 시도한 뒤 건너뛴다.
+- 큰 플랫폼 앱 안의 기능은 이 출처로 안 나온다. 기술 블로그와 화면 지도 단계에서 찾는다.