@tienne/gestalt 0.98.0 → 0.100.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/CLAUDE.md +2 -1
  2. package/README.md +3 -2
  3. package/dist/package.json +2 -2
  4. package/dist/plugin/research-sources/amplitude/SOURCE.md +28 -0
  5. package/dist/plugin/research-sources/app-store-reviews/SOURCE.md +25 -0
  6. package/dist/plugin/research-sources/app-store-search/SOURCE.md +25 -0
  7. package/dist/plugin/research-sources/tech-blog-search/SOURCE.md +27 -0
  8. package/dist/plugin/research-sources/uibowl/SOURCE.md +26 -0
  9. package/dist/plugin/research-sources/web-search/SOURCE.md +24 -0
  10. package/dist/plugin/skills/_shared/proactive-routing.md +5 -0
  11. package/dist/plugin/skills/architecture/SKILL.md +1 -1
  12. package/dist/plugin/skills/market-scan/SKILL.md +61 -0
  13. package/dist/plugin/skills/research/SKILL.md +438 -0
  14. package/dist/plugin/skills/research/references/design.md +938 -0
  15. package/dist/plugin/skills/research/references/output-template.md +366 -0
  16. package/dist/plugin/skills/research/scripts/pii-vision.swift +327 -0
  17. package/dist/plugin/skills/research/scripts/slide-extract.mjs +223 -0
  18. package/dist/plugin/skills/reverse-plan/SKILL.md +52 -0
  19. package/dist/plugin/skills/screen-ref/SKILL.md +63 -0
  20. package/dist/plugin/skills/ux-research/SKILL.md +51 -0
  21. package/dist/src/architecture/validator.d.ts +17 -1
  22. package/dist/src/architecture/validator.d.ts.map +1 -1
  23. package/dist/src/architecture/validator.js +61 -45
  24. package/dist/src/architecture/validator.js.map +1 -1
  25. package/dist/src/core/config.d.ts +17 -0
  26. package/dist/src/core/config.d.ts.map +1 -1
  27. package/dist/src/core/config.js +4 -0
  28. package/dist/src/core/config.js.map +1 -1
  29. package/dist/src/core/source-location.d.ts +32 -0
  30. package/dist/src/core/source-location.d.ts.map +1 -0
  31. package/dist/src/core/source-location.js +87 -0
  32. package/dist/src/core/source-location.js.map +1 -0
  33. package/dist/src/execute/orchestrators/evolution.d.ts +3 -1
  34. package/dist/src/execute/orchestrators/evolution.d.ts.map +1 -1
  35. package/dist/src/execute/orchestrators/evolution.js +4 -2
  36. package/dist/src/execute/orchestrators/evolution.js.map +1 -1
  37. package/dist/src/execute/orchestrators/execution.d.ts +3 -1
  38. package/dist/src/execute/orchestrators/execution.d.ts.map +1 -1
  39. package/dist/src/execute/orchestrators/execution.js +4 -2
  40. package/dist/src/execute/orchestrators/execution.js.map +1 -1
  41. package/dist/src/execute/passthrough-engine.d.ts +2 -1
  42. package/dist/src/execute/passthrough-engine.d.ts.map +1 -1
  43. package/dist/src/execute/passthrough-engine.js +3 -3
  44. package/dist/src/execute/passthrough-engine.js.map +1 -1
  45. package/dist/src/execute/prompts.d.ts.map +1 -1
  46. package/dist/src/execute/prompts.js +20 -2
  47. package/dist/src/execute/prompts.js.map +1 -1
  48. package/dist/src/mcp/schemas.d.ts +93 -0
  49. package/dist/src/mcp/schemas.d.ts.map +1 -1
  50. package/dist/src/mcp/schemas.js +110 -0
  51. package/dist/src/mcp/schemas.js.map +1 -1
  52. package/dist/src/mcp/server.d.ts.map +1 -1
  53. package/dist/src/mcp/server.js +12 -2
  54. package/dist/src/mcp/server.js.map +1 -1
  55. package/dist/src/mcp/tools/execute/evaluate.js +1 -1
  56. package/dist/src/mcp/tools/execute/evaluate.js.map +1 -1
  57. package/dist/src/mcp/tools/research-passthrough.d.ts +21 -0
  58. package/dist/src/mcp/tools/research-passthrough.d.ts.map +1 -0
  59. package/dist/src/mcp/tools/research-passthrough.js +566 -0
  60. package/dist/src/mcp/tools/research-passthrough.js.map +1 -0
  61. package/dist/src/memory/project-memory-store.d.ts +7 -0
  62. package/dist/src/memory/project-memory-store.d.ts.map +1 -1
  63. package/dist/src/memory/project-memory-store.js +17 -0
  64. package/dist/src/memory/project-memory-store.js.map +1 -1
  65. package/dist/src/research/canvas-view.d.ts +5 -0
  66. package/dist/src/research/canvas-view.d.ts.map +1 -0
  67. package/dist/src/research/canvas-view.js +274 -0
  68. package/dist/src/research/canvas-view.js.map +1 -0
  69. package/dist/src/research/evidence.d.ts +145 -0
  70. package/dist/src/research/evidence.d.ts.map +1 -0
  71. package/dist/src/research/evidence.js +50 -0
  72. package/dist/src/research/evidence.js.map +1 -0
  73. package/dist/src/research/figma-plan.d.ts +80 -0
  74. package/dist/src/research/figma-plan.d.ts.map +1 -0
  75. package/dist/src/research/figma-plan.js +527 -0
  76. package/dist/src/research/figma-plan.js.map +1 -0
  77. package/dist/src/research/figma-script.d.ts +19 -0
  78. package/dist/src/research/figma-script.d.ts.map +1 -0
  79. package/dist/src/research/figma-script.js +363 -0
  80. package/dist/src/research/figma-script.js.map +1 -0
  81. package/dist/src/research/index.d.ts +8 -0
  82. package/dist/src/research/index.d.ts.map +1 -0
  83. package/dist/src/research/index.js +8 -0
  84. package/dist/src/research/index.js.map +1 -0
  85. package/dist/src/research/pii-core.d.ts +16 -0
  86. package/dist/src/research/pii-core.d.ts.map +1 -0
  87. package/dist/src/research/pii-core.js +345 -0
  88. package/dist/src/research/pii-core.js.map +1 -0
  89. package/dist/src/research/pii-dom.d.ts +13 -0
  90. package/dist/src/research/pii-dom.d.ts.map +1 -0
  91. package/dist/src/research/pii-dom.js +208 -0
  92. package/dist/src/research/pii-dom.js.map +1 -0
  93. package/dist/src/research/pii-image.d.ts +71 -0
  94. package/dist/src/research/pii-image.d.ts.map +1 -0
  95. package/dist/src/research/pii-image.js +163 -0
  96. package/dist/src/research/pii-image.js.map +1 -0
  97. package/dist/src/research/pii.d.ts +21 -0
  98. package/dist/src/research/pii.d.ts.map +1 -0
  99. package/dist/src/research/pii.js +47 -0
  100. package/dist/src/research/pii.js.map +1 -0
  101. package/dist/src/research/product-profile.d.ts +108 -0
  102. package/dist/src/research/product-profile.d.ts.map +1 -0
  103. package/dist/src/research/product-profile.js +104 -0
  104. package/dist/src/research/product-profile.js.map +1 -0
  105. package/dist/src/research/render-html.d.ts +203 -0
  106. package/dist/src/research/render-html.d.ts.map +1 -0
  107. package/dist/src/research/render-html.js +901 -0
  108. package/dist/src/research/render-html.js.map +1 -0
  109. package/dist/src/research/schema-base.d.ts +5 -0
  110. package/dist/src/research/schema-base.d.ts.map +1 -0
  111. package/dist/src/research/schema-base.js +10 -0
  112. package/dist/src/research/schema-base.js.map +1 -0
  113. package/dist/src/research/schema.d.ts +5142 -0
  114. package/dist/src/research/schema.d.ts.map +1 -0
  115. package/dist/src/research/schema.js +991 -0
  116. package/dist/src/research/schema.js.map +1 -0
  117. package/dist/src/research/source-create.d.ts +79 -0
  118. package/dist/src/research/source-create.d.ts.map +1 -0
  119. package/dist/src/research/source-create.js +226 -0
  120. package/dist/src/research/source-create.js.map +1 -0
  121. package/dist/src/research/source-registry.d.ts +29 -0
  122. package/dist/src/research/source-registry.d.ts.map +1 -0
  123. package/dist/src/research/source-registry.js +74 -0
  124. package/dist/src/research/source-registry.js.map +1 -0
  125. package/dist/src/research/source-schema.d.ts +158 -0
  126. package/dist/src/research/source-schema.d.ts.map +1 -0
  127. package/dist/src/research/source-schema.js +215 -0
  128. package/dist/src/research/source-schema.js.map +1 -0
  129. package/dist/src/research/source-status.d.ts +40 -0
  130. package/dist/src/research/source-status.d.ts.map +1 -0
  131. package/dist/src/research/source-status.js +109 -0
  132. package/dist/src/research/source-status.js.map +1 -0
  133. package/dist/src/research/store.d.ts +24 -0
  134. package/dist/src/research/store.d.ts.map +1 -0
  135. package/dist/src/research/store.js +60 -0
  136. package/dist/src/research/store.js.map +1 -0
  137. package/dist/src/research/target-view.d.ts +33 -0
  138. package/dist/src/research/target-view.d.ts.map +1 -0
  139. package/dist/src/research/target-view.js +133 -0
  140. package/dist/src/research/target-view.js.map +1 -0
  141. package/dist/src/research/target.d.ts +883 -0
  142. package/dist/src/research/target.d.ts.map +1 -0
  143. package/dist/src/research/target.js +323 -0
  144. package/dist/src/research/target.js.map +1 -0
  145. package/dist/src/research/video-transfer.d.ts +28 -0
  146. package/dist/src/research/video-transfer.d.ts.map +1 -0
  147. package/dist/src/research/video-transfer.js +100 -0
  148. package/dist/src/research/video-transfer.js.map +1 -0
  149. package/dist/src/spec/generator.d.ts.map +1 -1
  150. package/dist/src/spec/generator.js +3 -2
  151. package/dist/src/spec/generator.js.map +1 -1
  152. package/dist/src/spec/passthrough-generator.d.ts.map +1 -1
  153. package/dist/src/spec/passthrough-generator.js +6 -4
  154. package/dist/src/spec/passthrough-generator.js.map +1 -1
  155. package/package.json +2 -2
  156. package/plugin/.codex-plugin/plugin.json +1 -1
  157. package/plugin/.mcp.json +1 -1
  158. package/plugin/mcp.json +1 -1
  159. package/plugin/research-sources/amplitude/SOURCE.md +28 -0
  160. package/plugin/research-sources/app-store-reviews/SOURCE.md +25 -0
  161. package/plugin/research-sources/app-store-search/SOURCE.md +25 -0
  162. package/plugin/research-sources/tech-blog-search/SOURCE.md +27 -0
  163. package/plugin/research-sources/uibowl/SOURCE.md +26 -0
  164. package/plugin/research-sources/web-search/SOURCE.md +24 -0
  165. package/plugin/skills/_shared/proactive-routing.md +5 -0
  166. package/plugin/skills/architecture/SKILL.md +1 -1
  167. package/plugin/skills/market-scan/SKILL.md +61 -0
  168. package/plugin/skills/research/SKILL.md +438 -0
  169. package/plugin/skills/research/references/design.md +938 -0
  170. package/plugin/skills/research/references/output-template.md +366 -0
  171. package/plugin/skills/research/scripts/pii-vision.swift +327 -0
  172. package/plugin/skills/research/scripts/slide-extract.mjs +223 -0
  173. package/plugin/skills/reverse-plan/SKILL.md +52 -0
  174. package/plugin/skills/screen-ref/SKILL.md +63 -0
  175. package/plugin/skills/ux-research/SKILL.md +51 -0
@@ -0,0 +1,163 @@
1
+ import { execFile } from 'node:child_process';
2
+ import { copyFileSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { extname, join } from 'node:path';
5
+ import { promisify } from 'node:util';
6
+ const execFileAsync = promisify(execFile);
7
+ function union(boxes) {
8
+ const x1 = Math.min(...boxes.map((b) => b.x));
9
+ const y1 = Math.min(...boxes.map((b) => b.y));
10
+ const x2 = Math.max(...boxes.map((b) => b.x + b.w));
11
+ const y2 = Math.max(...boxes.map((b) => b.y + b.h));
12
+ return { x: x1, y: y1, w: x2 - x1, h: y2 - y1 };
13
+ }
14
+ /** 라벨 줄의 값은 같은 행 오른쪽이나 바로 아래 줄에 있다 */
15
+ function valueLineFor(label, lines, labelIdx) {
16
+ const lb = label.box;
17
+ const cy = lb.y + lb.h / 2;
18
+ let best = -1;
19
+ let bestDist = Infinity;
20
+ lines.forEach((cand, i) => {
21
+ if (i === labelIdx)
22
+ return;
23
+ const cb = cand.box;
24
+ const sameRow = Math.abs(cb.y + cb.h / 2 - cy) < Math.max(lb.h, cb.h) * 0.6 && cb.x >= lb.x + lb.w * 0.5;
25
+ const below = cb.y >= lb.y + lb.h * 0.8 &&
26
+ cb.y - (lb.y + lb.h) < lb.h * 2.5 &&
27
+ Math.abs(cb.x - lb.x) < Math.max(lb.w, lb.h * 6);
28
+ if (!sameRow && !below)
29
+ return;
30
+ const dist = sameRow
31
+ ? cb.x - (lb.x + lb.w)
32
+ : (cb.y - (lb.y + lb.h)) * 2 + Math.abs(cb.x - lb.x);
33
+ if (dist < bestDist) {
34
+ bestDist = dist;
35
+ best = i;
36
+ }
37
+ });
38
+ return best;
39
+ }
40
+ function spanBox(line, start, end) {
41
+ const hit = line.tokens.filter((t) => t.start < end && t.end > start);
42
+ if (hit.length === 0) {
43
+ const len = Math.max(1, line.text.length);
44
+ const b = line.box;
45
+ return {
46
+ box: { x: b.x + (b.w * start) / len, y: b.y, w: (b.w * (end - start)) / len, h: b.h },
47
+ coverStart: start,
48
+ coverEnd: end,
49
+ };
50
+ }
51
+ return {
52
+ box: union(hit.map((t) => t.box)),
53
+ coverStart: Math.min(...hit.map((t) => t.start)),
54
+ coverEnd: Math.max(...hit.map((t) => t.end)),
55
+ };
56
+ }
57
+ /** OCR 결과에서 가려야 할 칸과 그 자리에 그릴 가짜 값을 정한다. 이미지는 건드리지 않는다 */
58
+ export function planRedaction(ocr, pii) {
59
+ const items = [];
60
+ const counts = { text: 0, avatars: 0, barcodes: 0 };
61
+ const ctxByLine = new Map();
62
+ ocr.lines.forEach((line, i) => {
63
+ const kind = pii.labelKindOf(line.text);
64
+ if (!kind)
65
+ return;
66
+ const target = valueLineFor(line, ocr.lines, i);
67
+ if (target >= 0 && !ctxByLine.has(target))
68
+ ctxByLine.set(target, kind);
69
+ });
70
+ ocr.lines.forEach((line, i) => {
71
+ if (pii.labelKindOf(line.text))
72
+ return;
73
+ const spans = pii.detect(line.text, ctxByLine.get(i) ?? null);
74
+ for (const span of spans) {
75
+ const { box, coverStart, coverEnd } = spanBox(line, span.start, span.end);
76
+ const text = line.text.slice(coverStart, span.start) +
77
+ span.replacement +
78
+ line.text.slice(span.end, coverEnd);
79
+ items.push({ type: 'text', box, text });
80
+ counts.text++;
81
+ }
82
+ });
83
+ for (const face of ocr.faces) {
84
+ items.push({ type: 'avatar', box: face });
85
+ counts.avatars++;
86
+ }
87
+ for (const code of ocr.barcodes) {
88
+ const fake = code.payload ? pii.fakeDigits(code.payload) : undefined;
89
+ items.push({ type: 'barcode', box: code.box, ...(fake ? { text: fake } : {}) });
90
+ counts.barcodes++;
91
+ }
92
+ return { items, counts };
93
+ }
94
+ export function swiftRunner(scriptPath, timeoutMs = 180_000) {
95
+ return async (args) => {
96
+ const { stdout } = await execFileAsync('swift', [scriptPath, ...args], {
97
+ timeout: timeoutMs,
98
+ maxBuffer: 64 * 1024 * 1024,
99
+ });
100
+ return stdout;
101
+ };
102
+ }
103
+ let visionProbe;
104
+ /** macOS이고 swift 도구체인이 있을 때만 Vision을 쓸 수 있다. 첫 호출 결과를 프로세스 동안 재사용한다 */
105
+ export function isVisionAvailable() {
106
+ visionProbe ??=
107
+ process.platform !== 'darwin'
108
+ ? Promise.resolve(false)
109
+ : execFileAsync('swift', ['--version'], { timeout: 15_000 }).then(() => true, () => false);
110
+ return visionProbe;
111
+ }
112
+ export function outputExtFor(inputPath, replaced) {
113
+ const ext = extname(inputPath).toLowerCase();
114
+ if (!replaced)
115
+ return ext;
116
+ return ext === '.png' ? '.png' : '.jpg';
117
+ }
118
+ /**
119
+ * 이미지 한 장의 개인정보를 가짜 값으로 바꿔 저장한다.
120
+ * - Vision을 못 쓰면 원본을 그대로 복사하고 `unchecked`로 남긴다
121
+ * - 탐지가 0건이면 원본을 복사하고 `none`이다. 라벨 없는 이름은 못 잡을 수 있어서 보증은 아니다
122
+ */
123
+ export async function redactImageFile(opts) {
124
+ const warnings = [];
125
+ const emptyCounts = { text: 0, avatars: 0, barcodes: 0 };
126
+ const copyAs = (replaced) => {
127
+ const out = opts.outputBase + outputExtFor(opts.inputPath, replaced);
128
+ copyFileSync(opts.inputPath, out);
129
+ return out;
130
+ };
131
+ if (!opts.run) {
132
+ warnings.push('Vision을 쓸 수 없는 환경이라 개인정보 치환을 못 했다. 캡처는 unchecked로 남고 공유용 HTML 렌더가 막힌다.');
133
+ return { pii: 'unchecked', outputPath: copyAs(false), counts: emptyCounts, warnings };
134
+ }
135
+ let ocr;
136
+ try {
137
+ ocr = JSON.parse(await opts.run(['ocr', opts.inputPath]));
138
+ }
139
+ catch (e) {
140
+ warnings.push(`OCR을 못 돌려 치환을 건너뛰었다: ${e instanceof Error ? e.message : String(e)}`);
141
+ return { pii: 'unchecked', outputPath: copyAs(false), counts: emptyCounts, warnings };
142
+ }
143
+ const plan = planRedaction(ocr, opts.pii);
144
+ if (plan.items.length === 0) {
145
+ return { pii: 'none', outputPath: copyAs(false), counts: plan.counts, warnings };
146
+ }
147
+ const outputPath = opts.outputBase + outputExtFor(opts.inputPath, true);
148
+ const dir = mkdtempSync(join(tmpdir(), 'ges-pii-'));
149
+ try {
150
+ const planPath = join(dir, 'plan.json');
151
+ writeFileSync(planPath, JSON.stringify({ items: plan.items }), { mode: 0o600 });
152
+ await opts.run(['paint', opts.inputPath, planPath, outputPath]);
153
+ }
154
+ catch (e) {
155
+ warnings.push(`치환 그리기에 실패했다: ${e instanceof Error ? e.message : String(e)}`);
156
+ return { pii: 'unchecked', outputPath: copyAs(false), counts: emptyCounts, warnings };
157
+ }
158
+ finally {
159
+ rmSync(dir, { recursive: true, force: true });
160
+ }
161
+ return { pii: 'replaced', outputPath, counts: plan.counts, warnings };
162
+ }
163
+ //# sourceMappingURL=pii-image.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pii-image.js","sourceRoot":"","sources":["../../../src/research/pii-image.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ export interface PiiSpan {
2
+ kind: string;
3
+ start: number;
4
+ end: number;
5
+ replacement: string;
6
+ }
7
+ export interface PiiRedactor {
8
+ detect(text: string, ctxKind?: string | null): PiiSpan[];
9
+ redactText(text: string, ctxKind?: string | null): {
10
+ text: string;
11
+ spans: PiiSpan[];
12
+ };
13
+ labelKindOf(text: string): string | null;
14
+ kindFromHints(hints: string): string | null;
15
+ fakeDigits(value: string): string;
16
+ }
17
+ /** 같은 seed면 같은 값에 같은 가명을 준다. 실제 값과 가명의 대응표는 만들지 않는다 */
18
+ export declare function createPiiRedactor(seed: string): PiiRedactor;
19
+ export declare function seedFor(slug: string): string;
20
+ export declare function redactorFor(slug: string): PiiRedactor;
21
+ //# sourceMappingURL=pii.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pii.d.ts","sourceRoot":"","sources":["../../../src/research/pii.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,CAAC;IACzD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACtF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AA0BD,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAY3D;AAQD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAErD"}
@@ -0,0 +1,47 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import vm from 'node:vm';
3
+ import { PII_CORE_SOURCE } from './pii-core.js';
4
+ let factory;
5
+ function loadFactory() {
6
+ factory ??= vm.runInNewContext(PII_CORE_SOURCE, {}, { timeout: 2000 });
7
+ return factory;
8
+ }
9
+ function plainSpans(spans) {
10
+ return spans.map((s) => ({
11
+ kind: s.kind,
12
+ start: s.start,
13
+ end: s.end,
14
+ replacement: s.replacement,
15
+ }));
16
+ }
17
+ /** 같은 seed면 같은 값에 같은 가명을 준다. 실제 값과 가명의 대응표는 만들지 않는다 */
18
+ export function createPiiRedactor(seed) {
19
+ const core = loadFactory()(seed);
20
+ return {
21
+ detect: (text, ctxKind) => plainSpans(core.detect(text, ctxKind ?? null)),
22
+ redactText: (text, ctxKind) => {
23
+ const r = core.redactText(text, ctxKind ?? null);
24
+ return { text: r.text, spans: plainSpans(r.spans) };
25
+ },
26
+ labelKindOf: (text) => core.labelKindOf(text),
27
+ kindFromHints: (hints) => core.kindFromHints(hints),
28
+ fakeDigits: (value) => core.fakeDigits(value),
29
+ };
30
+ }
31
+ /**
32
+ * 리서치(slug)마다 프로세스 메모리에만 두는 seed.
33
+ * 디스크에 쓰지 않으므로 서버가 재시작되면 같은 값도 다른 가명이 된다.
34
+ */
35
+ const seeds = new Map();
36
+ export function seedFor(slug) {
37
+ let seed = seeds.get(slug);
38
+ if (!seed) {
39
+ seed = randomUUID();
40
+ seeds.set(slug, seed);
41
+ }
42
+ return seed;
43
+ }
44
+ export function redactorFor(slug) {
45
+ return createPiiRedactor(seedFor(slug));
46
+ }
47
+ //# sourceMappingURL=pii.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pii.js","sourceRoot":"","sources":["../../../src/research/pii.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAyBhD,IAAI,OAA8B,CAAC;AAEnC,SAAS,WAAW;IAClB,OAAO,KAAK,EAAE,CAAC,eAAe,CAAC,eAAe,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAc,CAAC;IACpF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,KAAgB;IAClC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;QACzE,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;YACjD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,CAAC;QACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7C,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QACnD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,108 @@
1
+ import { z } from 'zod';
2
+ export declare const productProfileSchema: z.ZodEffects<z.ZodObject<{
3
+ product: z.ZodEffects<z.ZodString, string, string>;
4
+ /** 제품 코드 경로. 상대 경로면 리서치를 돌린 레포 기준 */
5
+ repo: z.ZodString;
6
+ commit: z.ZodString;
7
+ scannedAt: z.ZodString;
8
+ /** 예: @amplitude/analytics-browser 2.x, 사내 래퍼 이름 */
9
+ sdk: z.ZodString;
10
+ /** 키가 있는 파일 경로. 값은 적지 않는다 */
11
+ keyLocation: z.ZodString;
12
+ amplitudeProject: z.ZodOptional<z.ZodString>;
13
+ events: z.ZodArray<z.ZodObject<{
14
+ name: z.ZodString;
15
+ /** 이벤트가 나가는 화면. 코드에서 읽은 이름 그대로 */
16
+ screen: z.ZodString;
17
+ /** 사용자가 한 일. 예: 상세 진입, 구매 버튼 누름 */
18
+ action: z.ZodString;
19
+ /** 호출 자리. repo 기준 상대 경로 */
20
+ file: z.ZodString;
21
+ properties: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
22
+ }, "strip", z.ZodTypeAny, {
23
+ file: string;
24
+ name: string;
25
+ screen: string;
26
+ action: string;
27
+ properties?: string[] | undefined;
28
+ }, {
29
+ file: string;
30
+ name: string;
31
+ screen: string;
32
+ action: string;
33
+ properties?: string[] | undefined;
34
+ }>, "many">;
35
+ }, "strip", z.ZodTypeAny, {
36
+ events: {
37
+ file: string;
38
+ name: string;
39
+ screen: string;
40
+ action: string;
41
+ properties?: string[] | undefined;
42
+ }[];
43
+ repo: string;
44
+ commit: string;
45
+ product: string;
46
+ scannedAt: string;
47
+ sdk: string;
48
+ keyLocation: string;
49
+ amplitudeProject?: string | undefined;
50
+ }, {
51
+ events: {
52
+ file: string;
53
+ name: string;
54
+ screen: string;
55
+ action: string;
56
+ properties?: string[] | undefined;
57
+ }[];
58
+ repo: string;
59
+ commit: string;
60
+ product: string;
61
+ scannedAt: string;
62
+ sdk: string;
63
+ keyLocation: string;
64
+ amplitudeProject?: string | undefined;
65
+ }>, {
66
+ events: {
67
+ file: string;
68
+ name: string;
69
+ screen: string;
70
+ action: string;
71
+ properties?: string[] | undefined;
72
+ }[];
73
+ repo: string;
74
+ commit: string;
75
+ product: string;
76
+ scannedAt: string;
77
+ sdk: string;
78
+ keyLocation: string;
79
+ amplitudeProject?: string | undefined;
80
+ }, {
81
+ events: {
82
+ file: string;
83
+ name: string;
84
+ screen: string;
85
+ action: string;
86
+ properties?: string[] | undefined;
87
+ }[];
88
+ repo: string;
89
+ commit: string;
90
+ product: string;
91
+ scannedAt: string;
92
+ sdk: string;
93
+ keyLocation: string;
94
+ amplitudeProject?: string | undefined;
95
+ }>;
96
+ export type ProductProfile = z.infer<typeof productProfileSchema>;
97
+ /** `.gestalt/research/_products/`. slug는 `_`로 못 시작해서 리서치 디렉토리와 안 겹친다 */
98
+ export declare function productsDir(repoRoot: string): string;
99
+ export declare function profilePath(repoRoot: string, product: string): string;
100
+ export declare function listProfiles(repoRoot: string): string[];
101
+ /** 없으면 null. 깨졌으면 `.corrupt-*`로 옮기고 null */
102
+ export declare function loadProfile(repoRoot: string, product: string): ProductProfile | null;
103
+ export declare function saveProfile(repoRoot: string, profile: ProductProfile): string;
104
+ /** 제품 코드의 지금 HEAD. git이 아니거나 못 읽으면 undefined */
105
+ export declare function currentCommit(repoRoot: string, repo: string): string | undefined;
106
+ /** 저장한 커밋이 HEAD와 같은지. 짧은 해시로 저장했으면 앞부분만 맞춘다 */
107
+ export declare function isStale(profile: ProductProfile, head: string | undefined): boolean | undefined;
108
+ //# sourceMappingURL=product-profile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"product-profile.d.ts","sourceRoot":"","sources":["../../../src/research/product-profile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,eAAO,MAAM,oBAAoB;;IAG7B,qCAAqC;;;;IAIrC,oDAAoD;;IAEpD,6BAA6B;;;;;QAlB/B,kCAAkC;;QAElC,mCAAmC;;QAEnC,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBzB,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAWlE,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvD;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAQpF;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAI7E;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUhF;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAG9F"}
@@ -0,0 +1,104 @@
1
+ import { execFileSync } from 'node:child_process';
2
+ import { existsSync, readdirSync } from 'node:fs';
3
+ import { isAbsolute, join, resolve } from 'node:path';
4
+ import { z } from 'zod';
5
+ import { readJsonOrQuarantine, writeJsonAtomic } from '../core/json-file.js';
6
+ import { isValidSlug } from './store.js';
7
+ import { KEY_MESSAGE, looksLikeKey } from './target.js';
8
+ /**
9
+ * 제품 코드에서 분석 이벤트를 미리 훑어 둔 지도. 리서치마다 다시 훑지 않으려고 제품 단위로 둔다.
10
+ * 키 값은 담지 않고 키가 있는 파일 경로만 담는다.
11
+ */
12
+ const text = z.string().trim().min(1);
13
+ const profileEventSchema = z.object({
14
+ name: text,
15
+ /** 이벤트가 나가는 화면. 코드에서 읽은 이름 그대로 */
16
+ screen: text,
17
+ /** 사용자가 한 일. 예: 상세 진입, 구매 버튼 누름 */
18
+ action: text,
19
+ /** 호출 자리. repo 기준 상대 경로 */
20
+ file: text,
21
+ properties: z.array(text).optional(),
22
+ });
23
+ export const productProfileSchema = z
24
+ .object({
25
+ product: text.refine(isValidSlug, '제품 이름은 소문자, 숫자, -만 쓴다(최대 64자)'),
26
+ /** 제품 코드 경로. 상대 경로면 리서치를 돌린 레포 기준 */
27
+ repo: text,
28
+ commit: z.string().regex(/^[0-9a-f]{7,40}$/, '커밋은 해시로 적는다'),
29
+ scannedAt: text,
30
+ /** 예: @amplitude/analytics-browser 2.x, 사내 래퍼 이름 */
31
+ sdk: text,
32
+ /** 키가 있는 파일 경로. 값은 적지 않는다 */
33
+ keyLocation: text,
34
+ amplitudeProject: text.optional(),
35
+ events: z.array(profileEventSchema).min(1, '이벤트를 하나도 못 찾았으면 저장하지 않는다'),
36
+ })
37
+ .superRefine((p, ctx) => {
38
+ const { commit: _commit, ...rest } = p;
39
+ for (const path of keyLikePaths(rest)) {
40
+ ctx.addIssue({ code: z.ZodIssueCode.custom, path, message: KEY_MESSAGE });
41
+ }
42
+ });
43
+ function keyLikePaths(value, path = []) {
44
+ if (typeof value === 'string')
45
+ return looksLikeKey(value) ? [path] : [];
46
+ if (Array.isArray(value))
47
+ return value.flatMap((v, i) => keyLikePaths(v, [...path, i]));
48
+ if (value && typeof value === 'object') {
49
+ return Object.entries(value).flatMap(([k, v]) => keyLikePaths(v, [...path, k]));
50
+ }
51
+ return [];
52
+ }
53
+ /** `.gestalt/research/_products/`. slug는 `_`로 못 시작해서 리서치 디렉토리와 안 겹친다 */
54
+ export function productsDir(repoRoot) {
55
+ return join(repoRoot, '.gestalt', 'research', '_products');
56
+ }
57
+ export function profilePath(repoRoot, product) {
58
+ if (!isValidSlug(product))
59
+ throw new Error(`제품 이름이 올바르지 않다: ${product}`);
60
+ return join(productsDir(repoRoot), `${product}.json`);
61
+ }
62
+ export function listProfiles(repoRoot) {
63
+ const dir = productsDir(repoRoot);
64
+ if (!existsSync(dir))
65
+ return [];
66
+ return readdirSync(dir)
67
+ .filter((f) => f.endsWith('.json'))
68
+ .map((f) => f.slice(0, -'.json'.length))
69
+ .filter(isValidSlug)
70
+ .sort();
71
+ }
72
+ /** 없으면 null. 깨졌으면 `.corrupt-*`로 옮기고 null */
73
+ export function loadProfile(repoRoot, product) {
74
+ const raw = readJsonOrQuarantine(profilePath(repoRoot, product), (v) => productProfileSchema.safeParse(v).success);
75
+ if (raw === undefined)
76
+ return null;
77
+ const parsed = productProfileSchema.safeParse(raw);
78
+ return parsed.success ? parsed.data : null;
79
+ }
80
+ export function saveProfile(repoRoot, profile) {
81
+ const path = profilePath(repoRoot, profile.product);
82
+ writeJsonAtomic(path, profile);
83
+ return path;
84
+ }
85
+ /** 제품 코드의 지금 HEAD. git이 아니거나 못 읽으면 undefined */
86
+ export function currentCommit(repoRoot, repo) {
87
+ const dir = isAbsolute(repo) ? repo : resolve(repoRoot, repo);
88
+ try {
89
+ return execFileSync('git', ['-C', dir, 'rev-parse', 'HEAD'], {
90
+ encoding: 'utf-8',
91
+ stdio: ['ignore', 'pipe', 'ignore'],
92
+ }).trim();
93
+ }
94
+ catch {
95
+ return undefined;
96
+ }
97
+ }
98
+ /** 저장한 커밋이 HEAD와 같은지. 짧은 해시로 저장했으면 앞부분만 맞춘다 */
99
+ export function isStale(profile, head) {
100
+ if (!head)
101
+ return undefined;
102
+ return !head.startsWith(profile.commit);
103
+ }
104
+ //# sourceMappingURL=product-profile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"product-profile.js","sourceRoot":"","sources":["../../../src/research/product-profile.ts"],"names":[],"mappings":"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"}