@tienne/gestalt 0.99.0 → 0.101.0

package/dist/src/research/source-schema.d.ts

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+import { ValidationError } from '../core/errors.js';
+import { type Result } from '../core/result.js';
+export declare const SOURCE_STAGES: readonly ["product-discovery", "scale", "screen-map", "evidence", "baseline"];
+export declare const SOURCE_ACCESS_KINDS: readonly ["mcp", "browser", "http", "env"];
+export declare const SOURCE_EVIDENCE: readonly ["observation", "company-statement", "interpretation", "estimate"];
+export declare const SOURCE_AXES: readonly ["same-market", "same-problem"];
+export type SourceStage = (typeof SOURCE_STAGES)[number];
+export type SourceAccessKind = (typeof SOURCE_ACCESS_KINDS)[number];
+/** 파일 하나의 크기 상한. 개인 디렉토리라도 통째로 읽으므로 막아둔다 */
+export declare const SOURCE_MAX_BYTES: number;
+/** 사설 주소로 가는 길을 막는다. 숫자 주소와 점 없는 이름은 정규식에서 이미 걸러진다 */
+export declare function isPublicHostname(host: string): boolean;
+/** 비밀번호나 키가 SOURCE.md에 들어가는 걸 막는다. 환경변수 이름만 적는다 */
+export declare function findSecret(text: string): string | undefined;
+export declare const sourceFrontmatterSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    stage: z.ZodEffects<z.ZodArray<z.ZodEnum<["product-discovery", "scale", "screen-map", "evidence", "baseline"]>, "many">, ("evidence" | "product-discovery" | "scale" | "screen-map" | "baseline")[], unknown>;
+    axis: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodEnum<["same-market", "same-problem"]>, "many">>, ("same-market" | "same-problem")[], unknown>;
+    access: z.ZodArray<z.ZodEffects<z.ZodUnknown, {
+        server?: string | undefined;
+        tools?: string[] | undefined;
+        kind: "mcp";
+        name?: undefined;
+    } | {
+        site: string;
+        login?: "none" | "human" | undefined;
+        kind: "browser";
+        name?: undefined;
+    } | {
+        host: string;
+        probe?: string | undefined;
+        kind: "http";
+        name?: undefined;
+    } | {
+        kind: "env";
+        name: string;
+    }, unknown>, "many">;
+    requires: z.ZodDefault<z.ZodObject<{
+        mcpServer: z.ZodOptional<z.ZodString>;
+        env: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], unknown>;
+        browserLogin: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        env: string[];
+        mcpServer?: string | undefined;
+        browserLogin?: string | undefined;
+    }, {
+        env?: unknown;
+        mcpServer?: string | undefined;
+        browserLogin?: string | undefined;
+    }>>;
+    /** estimate는 제3자 추정치라 근거 상태에서는 해석으로 받는다 */
+    evidence: z.ZodEffects<z.ZodDefault<z.ZodEnum<["observation", "company-statement", "interpretation", "estimate"]>>, "observation" | "company-statement" | "interpretation", "observation" | "company-statement" | "interpretation" | "estimate" | undefined>;
+    limits: z.ZodOptional<z.ZodString>;
+    /** 이 출처를 못 쓸 때 대신 쓰는 방법. 0번 전제의 근거 한계 문장에 들어간다 */
+    fallback: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    requires: {
+        env: string[];
+        mcpServer?: string | undefined;
+        browserLogin?: string | undefined;
+    };
+    stage: ("evidence" | "product-discovery" | "scale" | "screen-map" | "baseline")[];
+    evidence: "observation" | "company-statement" | "interpretation";
+    axis: ("same-market" | "same-problem")[];
+    access: ({
+        server?: string | undefined;
+        tools?: string[] | undefined;
+        kind: "mcp";
+        name?: undefined;
+    } | {
+        site: string;
+        login?: "none" | "human" | undefined;
+        kind: "browser";
+        name?: undefined;
+    } | {
+        host: string;
+        probe?: string | undefined;
+        kind: "http";
+        name?: undefined;
+    } | {
+        kind: "env";
+        name: string;
+    })[];
+    limits?: string | undefined;
+    fallback?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    access: unknown[];
+    requires?: {
+        env?: unknown;
+        mcpServer?: string | undefined;
+        browserLogin?: string | undefined;
+    } | undefined;
+    stage?: unknown;
+    evidence?: "observation" | "company-statement" | "interpretation" | "estimate" | undefined;
+    axis?: unknown;
+    limits?: string | undefined;
+    fallback?: string | undefined;
+}>, {
+    name: string;
+    description: string;
+    requires: {
+        env: string[];
+        mcpServer?: string | undefined;
+        browserLogin?: string | undefined;
+    };
+    stage: ("evidence" | "product-discovery" | "scale" | "screen-map" | "baseline")[];
+    evidence: "observation" | "company-statement" | "interpretation";
+    axis: ("same-market" | "same-problem")[];
+    access: ({
+        server?: string | undefined;
+        tools?: string[] | undefined;
+        kind: "mcp";
+        name?: undefined;
+    } | {
+        site: string;
+        login?: "none" | "human" | undefined;
+        kind: "browser";
+        name?: undefined;
+    } | {
+        host: string;
+        probe?: string | undefined;
+        kind: "http";
+        name?: undefined;
+    } | {
+        kind: "env";
+        name: string;
+    })[];
+    limits?: string | undefined;
+    fallback?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    access: unknown[];
+    requires?: {
+        env?: unknown;
+        mcpServer?: string | undefined;
+        browserLogin?: string | undefined;
+    } | undefined;
+    stage?: unknown;
+    evidence?: "observation" | "company-statement" | "interpretation" | "estimate" | undefined;
+    axis?: unknown;
+    limits?: string | undefined;
+    fallback?: string | undefined;
+}>;
+export type SourceFrontmatter = z.infer<typeof sourceFrontmatterSchema>;
+export type SourceAccess = SourceFrontmatter['access'][number];
+export interface SourceDefinition {
+    frontmatter: SourceFrontmatter;
+    body: string;
+}
+export declare function parseSourceMd(content: string): Result<SourceDefinition, ValidationError>;
+//# sourceMappingURL=source-schema.d.ts.map

package/dist/src/research/source-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-schema.d.ts","sourceRoot":"","sources":["../../../src/research/source-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,aAAa,+EAMhB,CAAC;AACX,eAAO,MAAM,mBAAmB,4CAA6C,CAAC;AAC9E,eAAO,MAAM,eAAe,6EAKlB,CAAC;AACX,eAAO,MAAM,WAAW,0CAA2C,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAkB1C,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAgBD,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3D;AA4ED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAehC,2CAA2C;;;IAM3C,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBlD,CAAC;AAEL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAgBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CA0CxF"}

package/dist/src/research/source-schema.js

@@ -0,0 +1,215 @@
+import matter from 'gray-matter';
+import { z } from 'zod';
+import { ValidationError } from '../core/errors.js';
+import { err, ok } from '../core/result.js';
+export const SOURCE_STAGES = [
+    'product-discovery',
+    'scale',
+    'screen-map',
+    'evidence',
+    'baseline',
+];
+export const SOURCE_ACCESS_KINDS = ['mcp', 'browser', 'http', 'env'];
+export const SOURCE_EVIDENCE = [
+    'observation',
+    'company-statement',
+    'interpretation',
+    'estimate',
+];
+export const SOURCE_AXES = ['same-market', 'same-problem'];
+/** 파일 하나의 크기 상한. 개인 디렉토리라도 통째로 읽으므로 막아둔다 */
+export const SOURCE_MAX_BYTES = 64 * 1024;
+const NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,39}$/;
+const ENV_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+/** `claude.ai Amplitude`처럼 커넥터 이름에 공백이 들어간다. 연속 공백과 끝 공백은 막는다 */
+const MCP_SERVER_PATTERN = /^(?!.* {2})(?!.* $)[A-Za-z0-9][A-Za-z0-9_.: -]{0,63}$/;
+const MCP_TOOL_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+const HOST_PATTERN = /^(?=.{1,253}$)([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}$/;
+const PRIVATE_HOST_SUFFIXES = [
+    '.local',
+    '.internal',
+    '.localhost',
+    '.lan',
+    '.corp',
+    '.home',
+    '.intranet',
+];
+/** 사설 주소로 가는 길을 막는다. 숫자 주소와 점 없는 이름은 정규식에서 이미 걸러진다 */
+export function isPublicHostname(host) {
+    const h = host.toLowerCase();
+    return HOST_PATTERN.test(h) && !PRIVATE_HOST_SUFFIXES.some((s) => h.endsWith(s));
+}
+const SECRET_PATTERNS = [
+    [/\b(?:sk|pk|rk)-[A-Za-z0-9_-]{16,}/, 'API 키로 보이는 문자열'],
+    [/\b(?:ghp|gho|ghu|ghs|github_pat)_[A-Za-z0-9_]{16,}/, 'GitHub 토큰으로 보이는 문자열'],
+    [/\bxox[abprs]-[A-Za-z0-9-]{10,}/, 'Slack 토큰으로 보이는 문자열'],
+    [/\bAKIA[0-9A-Z]{12,}/, 'AWS 키로 보이는 문자열'],
+    [/\bAIza[0-9A-Za-z_-]{20,}/, 'Google API 키로 보이는 문자열'],
+    [/\bBearer\s+[A-Za-z0-9._~+/-]{16,}/i, 'Bearer 토큰'],
+    [/https?:\/\/[^\s/:@]+:[^\s/@]+@/, '주소에 박힌 계정과 비밀번호'],
+    [
+        /(?:password|passwd|secret|token|api[_-]?key)\s*[:=]\s*["']?[A-Za-z0-9+/=._-]{12,}/i,
+        '비밀번호나 키 값',
+    ],
+];
+/** 비밀번호나 키가 SOURCE.md에 들어가는 걸 막는다. 환경변수 이름만 적는다 */
+export function findSecret(text) {
+    for (const [pattern, label] of SECRET_PATTERNS) {
+        if (pattern.test(text))
+            return label;
+    }
+    return undefined;
+}
+const hostSchema = z
+    .string()
+    .transform((s) => s.toLowerCase())
+    .refine(isPublicHostname, '공개 호스트 이름만 쓴다 (IP 주소, localhost, 사내 이름 불가)');
+const accessEntrySchema = z.unknown().transform((raw, ctx) => {
+    const fail = (message) => {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message });
+        return z.NEVER;
+    };
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        return fail('access 항목은 `mcp: {...}` 같은 한 키짜리 객체다');
+    }
+    const keys = Object.keys(raw);
+    const kind = keys[0];
+    if (keys.length !== 1 || !kind || !SOURCE_ACCESS_KINDS.includes(kind)) {
+        return fail(`access 방법은 ${SOURCE_ACCESS_KINDS.join(', ')}만 쓴다 (받은 키: ${keys.join(', ') || '없음'})`);
+    }
+    const value = raw[kind];
+    const parse = (schema) => {
+        const r = schema.safeParse(value);
+        if (r.success)
+            return r.data;
+        for (const issue of r.error.issues) {
+            ctx.addIssue({ ...issue, path: [kind, ...issue.path] });
+        }
+        return z.NEVER;
+    };
+    switch (kind) {
+        case 'mcp':
+            return {
+                kind: 'mcp',
+                ...parse(z
+                    .object({
+                    server: z
+                        .string()
+                        .regex(MCP_SERVER_PATTERN, 'MCP 서버 이름 형식이 아니다')
+                        .optional(),
+                    /** 서버 이름은 사람마다 달라서 도구 이름으로 알아본다. 하나라도 세션에 있으면 연결된 걸로 본다 */
+                    tools: z
+                        .array(z.string().regex(MCP_TOOL_PATTERN, 'MCP 도구 이름 형식이 아니다'))
+                        .min(1)
+                        .optional(),
+                })
+                    .strict()
+                    .refine((m) => m.server || m.tools, 'MCP는 server나 tools 중 하나는 적는다')),
+            };
+        case 'browser':
+            return {
+                kind: 'browser',
+                ...parse(z
+                    .object({ site: hostSchema, login: z.enum(['human', 'none']).default('human') })
+                    .strict()),
+            };
+        case 'http':
+            return {
+                kind: 'http',
+                ...parse(z.object({ host: hostSchema, probe: z.string().url().optional() }).strict()),
+            };
+        default:
+            return {
+                kind: 'env',
+                name: parse(z.string().regex(ENV_NAME_PATTERN, '환경변수 이름은 대문자와 _만 쓴다')),
+            };
+    }
+});
+const toArray = (v) => (v === undefined || Array.isArray(v) ? v : [v]);
+export const sourceFrontmatterSchema = z
+    .object({
+    name: z.string().regex(NAME_PATTERN, '이름은 소문자, 숫자, -만 쓴다 (40자까지)'),
+    description: z.string().min(1),
+    stage: z.preprocess(toArray, z.array(z.enum(SOURCE_STAGES)).min(1)),
+    axis: z.preprocess(toArray, z.array(z.enum(SOURCE_AXES)).default([])),
+    access: z.array(accessEntrySchema).min(1),
+    requires: z
+        .object({
+        mcpServer: z.string().regex(MCP_SERVER_PATTERN).optional(),
+        env: z.preprocess(toArray, z.array(z.string().regex(ENV_NAME_PATTERN)).default([])),
+        browserLogin: hostSchema.optional(),
+    })
+        .strict()
+        .default({}),
+    /** estimate는 제3자 추정치라 근거 상태에서는 해석으로 받는다 */
+    evidence: z
+        .enum(SOURCE_EVIDENCE)
+        .default('observation')
+        .transform((e) => (e === 'estimate' ? 'interpretation' : e)),
+    limits: z.string().optional(),
+    /** 이 출처를 못 쓸 때 대신 쓰는 방법. 0번 전제의 근거 한계 문장에 들어간다 */
+    fallback: z.string().optional(),
+})
+    .superRefine((fm, ctx) => {
+    fm.access.forEach((a, i) => {
+        if (a.kind !== 'http' || !a.probe)
+            return;
+        let url;
+        try {
+            url = new URL(a.probe);
+        }
+        catch {
+            return;
+        }
+        const hostOk = url.hostname === a.host || url.hostname.endsWith(`.${a.host}`);
+        if (url.protocol !== 'https:' || url.username || url.password || !hostOk) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['access', i, 'http', 'probe'],
+                message: 'probe는 같은 호스트의 https 주소만 쓴다 (계정 정보 불가)',
+            });
+        }
+    });
+});
+const REQUIRED_SECTIONS = ['찾는 법', '멈추는 곳'];
+/** gray-matter의 js 엔진은 frontmatter를 코드로 실행한다. 개인 디렉토리 파일이라도 막는다 */
+const SAFE_MATTER_OPTIONS = {
+    engines: {
+        js: () => {
+            throw new Error('js frontmatter는 쓰지 않는다');
+        },
+        javascript: () => {
+            throw new Error('js frontmatter는 쓰지 않는다');
+        },
+    },
+};
+export function parseSourceMd(content) {
+    if (Buffer.byteLength(content, 'utf-8') > SOURCE_MAX_BYTES) {
+        return err(new ValidationError('SOURCE.md가 너무 크다 (64KB 상한)', []));
+    }
+    const secret = findSecret(content);
+    if (secret) {
+        return err(new ValidationError(`SOURCE.md에 ${secret}이 들어 있다. 비밀번호와 키는 적지 않고 환경변수 이름이나 MCP 서버 이름만 적는다`, [secret]));
+    }
+    let data;
+    let body;
+    try {
+        const parsed = matter(content, SAFE_MATTER_OPTIONS);
+        data = parsed.data;
+        body = parsed.content.trim();
+    }
+    catch (e) {
+        return err(new ValidationError(`frontmatter를 읽지 못했다: ${e instanceof Error ? e.message : String(e)}`, []));
+    }
+    const fm = sourceFrontmatterSchema.safeParse(data);
+    if (!fm.success) {
+        const issues = fm.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`);
+        return err(new ValidationError(`SOURCE.md frontmatter 오류: ${issues.join('; ')}`, issues));
+    }
+    const missing = REQUIRED_SECTIONS.filter((s) => !new RegExp(`^##\\s+${s}\\s*$`, 'm').test(body));
+    if (missing.length > 0) {
+        return err(new ValidationError(`본문에 절이 빠졌다: ${missing.map((s) => `## ${s}`).join(', ')}`, missing));
+    }
+    return ok({ frontmatter: fm.data, body });
+}
+//# sourceMappingURL=source-schema.js.map

package/dist/src/research/source-schema.js.map

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

package/dist/src/research/source-status.d.ts

@@ -0,0 +1,40 @@
+import type { LoadedSource } from './source-registry.js';
+import type { SourceAccess, SourceStage } from './source-schema.js';
+/** 같은 세션의 다른 MCP 연결과 브라우저 로그인은 ges 서버가 못 본다. 세션이 알려준다 */
+export interface SessionAvailability {
+    mcpServers?: string[];
+    /** 세션의 MCP 도구 이름(`mcp__<서버>__<도구>`). 서버 이름이 사람마다 달라서 도구 이름으로 출처를 알아본다 */
+    mcpTools?: string[];
+    browserLogins?: string[];
+}
+export type SourceStatus = 'usable' | 'fallback' | 'skipped';
+export interface SourceEvaluation {
+    status: SourceStatus;
+    /** 실제로 쓰게 될 접근 방법. 건너뛰면 없다 */
+    via?: SourceAccess['kind'];
+    /** MCP로 쓸 때 이 세션에서 부를 서버. 도구 이름으로 찾았으면 그 도구의 접두어에서 뽑는다 */
+    mcpServer?: string;
+    note: string;
+}
+/** access를 위에서부터 시도해 첫 번째로 되는 방법을 고른다 */
+export declare function evaluateSource(source: LoadedSource, avail: SessionAvailability, env?: NodeJS.ProcessEnv): SourceEvaluation;
+export interface SourceReportRow {
+    name: string;
+    description: string;
+    stage: SourceStage[];
+    origin: LoadedSource['origin'];
+    overridden: boolean;
+    evidence: LoadedSource['frontmatter']['evidence'];
+    status: SourceStatus;
+    via?: SourceAccess['kind'];
+    mcpServer?: string;
+    note: string;
+    limits?: string;
+}
+export interface SourceReport {
+    sources: SourceReportRow[];
+    /** 0번 전제의 근거 한계에 그대로 옮겨 적는 문장 */
+    evidenceLimits: string[];
+}
+export declare function buildSourceReport(sources: LoadedSource[], avail: SessionAvailability, env?: NodeJS.ProcessEnv, stageFilter?: SourceStage): SourceReport;
+//# sourceMappingURL=source-status.d.ts.map

package/dist/src/research/source-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-status.d.ts","sourceRoot":"","sources":["../../../src/research/source-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpE,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AA6DD,yCAAyC;AACzC,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,mBAAmB,EAC1B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,gBAAgB,CAwBlB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,iCAAiC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,mBAAmB,EAC1B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,WAAW,CAAC,EAAE,WAAW,GACxB,YAAY,CA+Bd"}

package/dist/src/research/source-status.js

@@ -0,0 +1,109 @@
+/** 세션에서 이 MCP 출처를 맡는 서버. 없으면 undefined */
+function findMcpServer(access, avail) {
+    if (access.server && avail.mcpServers?.includes(access.server))
+        return access.server;
+    for (const full of avail.mcpTools ?? []) {
+        const m = /^mcp__(.+)__([^_].*)$/.exec(full);
+        const [server, tool] = m ? [m[1], m[2]] : [undefined, full];
+        if (access.tools?.includes(tool))
+            return server ?? access.server ?? '';
+    }
+    return undefined;
+}
+const mcpLabel = (access) => access.server ?? access.tools?.join(', ') ?? '';
+const VIA_LABEL = {
+    mcp: 'MCP',
+    browser: '브라우저',
+    http: '공개 API',
+    env: 'API 키',
+};
+function unmetReason(access, avail, env) {
+    switch (access.kind) {
+        case 'mcp':
+            return findMcpServer(access, avail) === undefined
+                ? `MCP(${mcpLabel(access)}) 미연결`
+                : undefined;
+        case 'browser':
+            if (access.login === 'none')
+                return undefined;
+            return avail.browserLogins?.includes(access.site) ? undefined : `${access.site} 로그인 안 됨`;
+        case 'http':
+            return undefined;
+        case 'env':
+            return env[access.name] ? undefined : `환경변수 ${access.name} 없음`;
+    }
+}
+function unmetRequirement(source, avail, env) {
+    const req = source.frontmatter.requires;
+    if (req.mcpServer && !avail.mcpServers?.includes(req.mcpServer)) {
+        return `MCP(${req.mcpServer}) 미연결`;
+    }
+    const missingEnv = req.env.find((name) => !env[name]);
+    if (missingEnv)
+        return `환경변수 ${missingEnv} 없음`;
+    if (req.browserLogin && !avail.browserLogins?.includes(req.browserLogin)) {
+        return `${req.browserLogin} 로그인 안 됨`;
+    }
+    return undefined;
+}
+/** access를 위에서부터 시도해 첫 번째로 되는 방법을 고른다 */
+export function evaluateSource(source, avail, env = process.env) {
+    const requirement = unmetRequirement(source, avail, env);
+    if (requirement)
+        return { status: 'skipped', note: `${requirement}이라 건너뜀` };
+    // 같은 종류끼리는 연결 이름만 다른 같은 경로라(예: 커넥터 MCP와 직접 띄운 MCP) 대체로 치지 않는다
+    const reasons = [];
+    for (const access of source.frontmatter.access) {
+        const reason = unmetReason(access, avail, env);
+        if (!reason) {
+            const other = reasons.find((r) => r.kind !== access.kind);
+            const server = access.kind === 'mcp' ? findMcpServer(access, avail) : undefined;
+            const mcp = server ? { mcpServer: server } : {};
+            return !other
+                ? { status: 'usable', via: access.kind, ...mcp, note: '사용 가능' }
+                : {
+                    status: 'fallback',
+                    via: access.kind,
+                    ...mcp,
+                    note: `${other.reason}이라 ${VIA_LABEL[access.kind]}로`,
+                };
+        }
+        reasons.push({ kind: access.kind, reason });
+    }
+    return { status: 'skipped', note: `${reasons[0].reason}이라 건너뜀` };
+}
+export function buildSourceReport(sources, avail, env = process.env, stageFilter) {
+    const rows = [];
+    const evidenceLimits = [];
+    for (const s of sources) {
+        const fm = s.frontmatter;
+        if (stageFilter && !fm.stage.includes(stageFilter))
+            continue;
+        const ev = evaluateSource(s, avail, env);
+        rows.push({
+            name: fm.name,
+            description: fm.description,
+            stage: fm.stage,
+            origin: s.origin,
+            overridden: s.overridden,
+            evidence: fm.evidence,
+            status: ev.status,
+            ...(ev.via ? { via: ev.via } : {}),
+            ...(ev.mcpServer ? { mcpServer: ev.mcpServer } : {}),
+            note: ev.note,
+            ...(fm.limits ? { limits: fm.limits } : {}),
+        });
+        if (ev.status === 'skipped') {
+            const tail = fm.fallback ? `${fm.fallback}` : '이 출처가 맡던 부분은 못 채웠다';
+            evidenceLimits.push(`${fm.name}: ${ev.note.replace(/이라 건너뜀$/, '')}이라 쓰지 못했다. ${tail}`);
+        }
+        else {
+            if (ev.status === 'fallback')
+                evidenceLimits.push(`${fm.name}: ${ev.note}`);
+            if (fm.limits)
+                evidenceLimits.push(`${fm.name}: ${fm.limits}`);
+        }
+    }
+    return { sources: rows, evidenceLimits };
+}
+//# sourceMappingURL=source-status.js.map

package/dist/src/research/source-status.js.map

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

package/dist/src/research/store.d.ts

@@ -0,0 +1,24 @@
+import { type Research } from './schema.js';
+export type ResearchAudience = 'private' | 'shared';
+export declare const SLUG_PATTERN: RegExp;
+export declare function isValidSlug(slug: string): boolean;
+/**
+ * 리서치 결과 저장소: `<repoRoot>/.gestalt/research/<slug>/`.
+ * `.gestalt/`는 gitignore 대상이라 캡처와 근거 자료가 커밋에 딸려가지 않는다.
+ */
+export declare class ResearchStore {
+    private readonly root;
+    constructor(repoRoot: string);
+    /** slug는 경로 조각이라 패턴을 통과한 것만 받는다 */
+    dir(slug: string): string;
+    capturesDir(slug: string): string;
+    jsonPath(slug: string): string;
+    htmlPath(slug: string, audience: ResearchAudience): string;
+    /** 없으면 null. 깨졌거나 스키마에 안 맞으면 `.corrupt-*`로 옮기고 null */
+    load(slug: string): Research | null;
+    save(research: Research): string;
+    saveHtml(slug: string, audience: ResearchAudience, html: string): string;
+    /** research 폴더 바로 아래에 파생 파일(figma-plan.json 등)을 쓴다 */
+    saveFile(slug: string, name: string, content: string): string;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/research/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD,eAAO,MAAM,YAAY,QAA8B,CAAC;AAExD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,QAAQ,EAAE,MAAM;IAI5B,mCAAmC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKzB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAI1D,uDAAuD;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAOnC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAMhC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAOxE,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAM9D"}

package/dist/src/research/store.js

@@ -0,0 +1,60 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJsonOrQuarantine, writeJsonAtomic } from '../core/json-file.js';
+import { parseResearch } from './schema.js';
+export const SLUG_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+export function isValidSlug(slug) {
+    return SLUG_PATTERN.test(slug);
+}
+/**
+ * 리서치 결과 저장소: `<repoRoot>/.gestalt/research/<slug>/`.
+ * `.gestalt/`는 gitignore 대상이라 캡처와 근거 자료가 커밋에 딸려가지 않는다.
+ */
+export class ResearchStore {
+    root;
+    constructor(repoRoot) {
+        this.root = join(repoRoot, '.gestalt', 'research');
+    }
+    /** slug는 경로 조각이라 패턴을 통과한 것만 받는다 */
+    dir(slug) {
+        if (!isValidSlug(slug))
+            throw new Error(`slug가 올바르지 않다: ${slug}`);
+        return join(this.root, slug);
+    }
+    capturesDir(slug) {
+        return join(this.dir(slug), 'captures');
+    }
+    jsonPath(slug) {
+        return join(this.dir(slug), 'research.json');
+    }
+    htmlPath(slug, audience) {
+        return join(this.dir(slug), audience === 'shared' ? 'research.shared.html' : 'research.html');
+    }
+    /** 없으면 null. 깨졌거나 스키마에 안 맞으면 `.corrupt-*`로 옮기고 null */
+    load(slug) {
+        const raw = readJsonOrQuarantine(this.jsonPath(slug), (v) => parseResearch(v).ok);
+        if (raw === undefined)
+            return null;
+        const parsed = parseResearch(raw);
+        return parsed.ok ? parsed.value : null;
+    }
+    save(research) {
+        const path = this.jsonPath(research.meta.slug);
+        writeJsonAtomic(path, research);
+        return path;
+    }
+    saveHtml(slug, audience, html) {
+        const path = this.htmlPath(slug, audience);
+        mkdirSync(this.dir(slug), { recursive: true });
+        writeFileSync(path, html, 'utf-8');
+        return path;
+    }
+    /** research 폴더 바로 아래에 파생 파일(figma-plan.json 등)을 쓴다 */
+    saveFile(slug, name, content) {
+        const path = join(this.dir(slug), name);
+        mkdirSync(this.dir(slug), { recursive: true });
+        writeFileSync(path, content, 'utf-8');
+        return path;
+    }
+}
+//# sourceMappingURL=store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/research/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAI3D,MAAM,CAAC,MAAM,YAAY,GAAG,2BAA2B,CAAC;AAExD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IACP,IAAI,CAAS;IAE9B,YAAY,QAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IAED,mCAAmC;IACnC,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,QAA0B;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAChG,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC,IAAY;QACf,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,QAAkB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,QAA0B,EAAE,IAAY;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,QAAQ,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACxC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}