cli-jaw 1.3.6 → 1.4.0-preview.20260307160721

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 (52) hide show
  1. package/dist/lib/stt.js +39 -9
  2. package/dist/lib/stt.js.map +1 -1
  3. package/dist/server.js +127 -5
  4. package/dist/server.js.map +1 -1
  5. package/dist/src/agent/spawn.js +38 -2
  6. package/dist/src/agent/spawn.js.map +1 -1
  7. package/dist/src/cli/acp-client.js +5 -3
  8. package/dist/src/cli/acp-client.js.map +1 -1
  9. package/dist/src/cli/command-context.js +11 -1
  10. package/dist/src/cli/command-context.js.map +1 -1
  11. package/dist/src/cli/handlers.js +72 -0
  12. package/dist/src/cli/handlers.js.map +1 -1
  13. package/dist/src/core/config.js +15 -0
  14. package/dist/src/core/config.js.map +1 -1
  15. package/dist/src/core/settings-merge.js +11 -2
  16. package/dist/src/core/settings-merge.js.map +1 -1
  17. package/dist/src/memory/advanced.js +1108 -0
  18. package/dist/src/memory/advanced.js.map +1 -0
  19. package/dist/src/memory/heartbeat-schedule.js +347 -0
  20. package/dist/src/memory/heartbeat-schedule.js.map +1 -0
  21. package/dist/src/memory/heartbeat.js +47 -6
  22. package/dist/src/memory/heartbeat.js.map +1 -1
  23. package/dist/src/memory/memory.js +2 -0
  24. package/dist/src/memory/memory.js.map +1 -1
  25. package/dist/src/orchestrator/distribute.js +2 -1
  26. package/dist/src/orchestrator/distribute.js.map +1 -1
  27. package/dist/src/orchestrator/pipeline.js +85 -7
  28. package/dist/src/orchestrator/pipeline.js.map +1 -1
  29. package/dist/src/orchestrator/research.js +149 -0
  30. package/dist/src/orchestrator/research.js.map +1 -0
  31. package/dist/src/orchestrator/state-machine.js +2 -2
  32. package/dist/src/orchestrator/state-machine.js.map +1 -1
  33. package/dist/src/prompt/builder.js +51 -18
  34. package/dist/src/prompt/builder.js.map +1 -1
  35. package/dist/src/prompt/templates/a1-system.md +3 -1
  36. package/dist/src/prompt/templates/a2-default.md +8 -0
  37. package/dist/src/prompt/templates/research-worker.md +37 -0
  38. package/dist/src/prompt/templates/worker-context.md +3 -0
  39. package/package.json +1 -1
  40. package/public/css/modals.css +46 -1
  41. package/public/dist/bundle.js +68 -57
  42. package/public/dist/bundle.js.map +4 -4
  43. package/public/index.html +142 -3
  44. package/public/js/constants.ts +1 -0
  45. package/public/js/features/employees.ts +2 -0
  46. package/public/js/features/heartbeat.ts +153 -27
  47. package/public/js/features/memory.ts +364 -52
  48. package/public/js/main.ts +72 -5
  49. package/public/js/state.ts +18 -1
  50. package/public/locales/en.json +14 -1
  51. package/public/locales/ko.json +14 -1
  52. package/scripts/release-preview.sh +48 -0
package/public/index.html CHANGED
@@ -503,11 +503,18 @@
503
503
  <div style="display:flex;border-bottom:1px solid var(--border);padding:0 12px">
504
504
  <button class="mem-tab active" id="memTabBtnSettings"
505
505
  style="padding:6px 12px;border:none;background:none;color:var(--text);cursor:pointer;font-size:12px;border-bottom:2px solid transparent">⚙️
506
- Settings</button>
506
+ Basic</button>
507
+ <button class="mem-tab" id="memTabBtnAdvSetup"
508
+ style="padding:6px 12px;border:none;background:none;color:var(--text-dim);cursor:pointer;font-size:12px;border-bottom:2px solid transparent">🧠
509
+ Advanced Setup</button>
510
+ <button class="mem-tab" id="memTabBtnAdvOps"
511
+ style="padding:6px 12px;border:none;background:none;color:var(--text-dim);cursor:pointer;font-size:12px;border-bottom:2px solid transparent">📊
512
+ Advanced Ops</button>
507
513
  <button class="mem-tab" id="memTabBtnFiles"
508
514
  style="padding:6px 12px;border:none;background:none;color:var(--text-dim);cursor:pointer;font-size:12px;border-bottom:2px solid transparent">📂
509
515
  Files</button>
510
516
  </div>
517
+ <div id="advStatusBanner" style="display:none;padding:10px 12px;border-bottom:1px solid var(--border);font-size:11px;color:var(--text-dim)"></div>
511
518
  <div id="memTabSettings" style="padding:12px">
512
519
  <div class="settings-row"><label data-i18n="label.enabled">활성화</label>
513
520
  <div>
@@ -564,8 +571,140 @@
564
571
  flush
565
572
  </div>
566
573
  </div>
574
+ <div id="memTabAdvSetup" style="padding:12px;display:none">
575
+ <div class="settings-row">
576
+ <label>Advanced</label>
577
+ <div>
578
+ <button id="advOff" class="perm-btn">Off</button>
579
+ <button id="advOn" class="perm-btn">On</button>
580
+ </div>
581
+ </div>
582
+ <div class="settings-row">
583
+ <label>Status</label>
584
+ <span id="advEnabledBadge" style="font-size:11px;color:var(--text-dim)">disabled</span>
585
+ </div>
586
+ <div class="settings-row">
587
+ <label>Provider</label>
588
+ <select id="advProvider"
589
+ style="font-size:11px;padding:4px;background:var(--surface);color:var(--text);border:1px solid var(--border);border-radius:4px">
590
+ <option value="gemini">gemini</option>
591
+ <option value="vertex">vertex</option>
592
+ <option value="openai-compatible">openai-compatible</option>
593
+ <option value="local">local</option>
594
+ </select>
595
+ </div>
596
+
597
+ <div class="settings-row sub-row adv-gemini">
598
+ <label>Gemini API Key</label>
599
+ <input type="password" id="advGeminiKey" placeholder="AIza..."
600
+ style="width:100%;font-size:11px;padding:4px">
601
+ </div>
602
+ <div class="settings-row sub-row adv-gemini">
603
+ <label>Gemini Model</label>
604
+ <select id="advGeminiModel">
605
+ <option value="gemini-3.1-flash-lite-preview" selected>gemini-3.1-flash-lite-preview</option>
606
+ <option value="gemini-2.5-flash-lite">gemini-2.5-flash-lite</option>
607
+ <option value="gemini-2.5-flash">gemini-2.5-flash</option>
608
+ <option value="__custom__">✏️ 직접 입력...</option>
609
+ </select>
610
+ <input type="text" id="advGeminiModelCustom" placeholder="모델명 입력"
611
+ style="display:none; margin-top:4px;" />
612
+ </div>
613
+
614
+ <div class="settings-row sub-row adv-vertex" style="display:none">
615
+ <label>Vertex Config JSON</label>
616
+ <textarea id="advVertexConfig" rows="4"
617
+ placeholder='{"project_id":"...","location":"us-central1","credentials_path":"..."}'
618
+ style="width:100%;font-size:11px;padding:4px;font-family:var(--font-mono)"></textarea>
619
+ </div>
620
+ <div class="settings-row sub-row adv-vertex" style="display:none">
621
+ <label>Vertex Model</label>
622
+ <input type="text" id="advVertexModel" placeholder="gemini-3.1-flash-lite-preview"
623
+ style="width:100%;font-size:11px;padding:4px">
624
+ </div>
625
+
626
+ <div class="settings-row sub-row adv-openai" style="display:none">
627
+ <label>Base URL</label>
628
+ <input type="text" id="advOpenaiBaseUrl" placeholder="https://host/v1"
629
+ style="width:100%;font-size:11px;padding:4px">
630
+ </div>
631
+ <div class="settings-row sub-row adv-openai" style="display:none">
632
+ <label>API Key</label>
633
+ <input type="password" id="advOpenaiKey" placeholder="sk-..."
634
+ style="width:100%;font-size:11px;padding:4px">
635
+ </div>
636
+ <div class="settings-row sub-row adv-openai" style="display:none">
637
+ <label>Model</label>
638
+ <input type="text" id="advOpenaiModel" placeholder="gpt-4o-mini"
639
+ style="width:100%;font-size:11px;padding:4px">
640
+ </div>
641
+
642
+ <div class="settings-row">
643
+ <label>Use Active CLI/Model</label>
644
+ <input type="checkbox" id="advBootstrapUseActive" checked>
645
+ </div>
646
+ <div class="settings-row sub-row adv-bootstrap-manual" style="display:none">
647
+ <label>Bootstrap CLI</label>
648
+ <select id="advBootstrapCli"
649
+ style="font-size:11px;padding:4px;background:var(--surface);color:var(--text);border:1px solid var(--border);border-radius:4px">
650
+ <option value="">(active CLI)</option>
651
+ <option>claude</option>
652
+ <option>codex</option>
653
+ <option>gemini</option>
654
+ <option>opencode</option>
655
+ <option>copilot</option>
656
+ </select>
657
+ </div>
658
+ <div class="settings-row sub-row adv-bootstrap-manual" style="display:none">
659
+ <label>Bootstrap Model</label>
660
+ <input type="text" id="advBootstrapModel" placeholder="(active model)"
661
+ style="width:100%;font-size:11px;padding:4px">
662
+ </div>
663
+
664
+ <div class="settings-row">
665
+ <label>Import Sources</label>
666
+ <div style="display:flex;flex-direction:column;gap:4px;font-size:11px">
667
+ <label><input type="checkbox" id="advImportCore" checked> MEMORY.md</label>
668
+ <label><input type="checkbox" id="advImportMarkdown" checked> memory/**/*.md</label>
669
+ <label><input type="checkbox" id="advImportKv" checked> SQLite KV memory</label>
670
+ <label><input type="checkbox" id="advImportClaudeSession" checked> external .claude session memory (read-only)</label>
671
+ </div>
672
+ </div>
673
+ <div style="display:flex;gap:8px;flex-wrap:wrap;margin-top:12px">
674
+ <button class="btn-save" id="advSaveSettingsBtn">💾 Save Advanced Settings</button>
675
+ <button class="btn-clear" id="advInitBtn">🛠️ Initialize Advanced Memory</button>
676
+ <button class="btn-clear" id="advBootstrapBtn">🧩 Re-run Bootstrap</button>
677
+ </div>
678
+ </div>
679
+ <div id="memTabAdvOps" style="padding:12px;display:none">
680
+ <div class="settings-row"><label>Index State</label><span id="advIndexState" style="font-size:11px;color:var(--text-dim)">-</span></div>
681
+ <div class="settings-row"><label>Storage Root</label><span id="advStorageRoot" style="font-size:10px;color:var(--text-dim);font-family:monospace;word-break:break-all">-</span></div>
682
+ <div class="settings-row"><label>Indexed Files</label><span id="advIndexedFiles" style="font-size:11px;color:var(--text-dim)">0</span></div>
683
+ <div class="settings-row"><label>Indexed Chunks</label><span id="advIndexedChunks" style="font-size:11px;color:var(--text-dim)">0</span></div>
684
+ <div class="settings-row"><label>Last Indexed</label><span id="advLastIndexedAt" style="font-size:11px;color:var(--text-dim)">-</span></div>
685
+ <div class="settings-row"><label>Import Status</label><span id="advImportStatus" style="font-size:11px;color:var(--text-dim)">-</span></div>
686
+ <div class="settings-row"><label>Corrupted</label><span id="advCorruptedCount" style="font-size:11px;color:var(--text-dim)">0</span></div>
687
+ <div class="settings-row"><label>Last Expansion</label><span id="advLastExpansion" style="font-size:11px;color:var(--text-dim)">-</span></div>
688
+ <div class="settings-row"><label>Last Error</label><span id="advLastError" style="font-size:11px;color:var(--text-dim)">-</span></div>
689
+ <div
690
+ style="margin-top:8px;padding:6px;background:var(--bg);border-radius:4px;font-size:11px;color:var(--text-dim)">
691
+ Fixed Snapshot Budget: 2800 chars / 4 chunks / 700 chars each
692
+ </div>
693
+ <div style="display:flex;gap:8px;flex-wrap:wrap;margin-top:12px">
694
+ <button class="btn-clear" id="advReindexBtn">🔄 Reindex</button>
695
+ <button class="btn-clear" id="advReimportBtn">📥 Re-import Legacy</button>
696
+ <button class="btn-clear" id="advOpenCorruptedBtn">📂 Open Corrupted Folder</button>
697
+ </div>
698
+ </div>
567
699
  <div id="memTabFiles" style="padding:12px;display:none">
568
- <div id="memFilesList"></div>
700
+ <div style="font-size:12px;font-weight:600;margin-bottom:6px">Basic Memory Files</div>
701
+ <div id="basicMemoryFiles"></div>
702
+ <div style="font-size:12px;font-weight:600;margin:12px 0 6px">Advanced Memory Files</div>
703
+ <div id="advancedMemoryFiles"></div>
704
+ <div style="font-size:12px;font-weight:600;margin:12px 0 6px">Corrupted / Quarantined</div>
705
+ <div id="corruptedMemoryFiles"></div>
706
+ <div style="font-size:12px;font-weight:600;margin:12px 0 6px">Legacy Unmapped</div>
707
+ <div id="legacyUnmappedFiles"></div>
569
708
  </div>
570
709
  </div>
571
710
  </div>
@@ -617,4 +756,4 @@
617
756
  <script type="module" src="/dist/bundle.js"></script>
618
757
  </body>
619
758
 
620
- </html>
759
+ </html>
@@ -136,6 +136,7 @@ export interface RolePreset {
136
136
  export const ROLE_PRESETS: readonly RolePreset[] = [
137
137
  { value: 'frontend', labelKey: 'role.label.frontend', label: 'Frontend', prompt: 'UI/UX, CSS, components', skill: 'dev-frontend' },
138
138
  { value: 'backend', labelKey: 'role.label.backend', label: 'Backend', prompt: 'API, DB, server logic', skill: 'dev-backend' },
139
+ { value: 'research', labelKey: 'role.label.research', label: 'Research', prompt: 'Search, codebase exploration, uncertainty reduction, read-only reports', skill: 'research-worker' },
139
140
  { value: 'data', labelKey: 'role.label.data', label: 'Data', prompt: 'Data pipeline, analysis, ML', skill: 'dev-data' },
140
141
  { value: 'docs', labelKey: 'role.label.docs', label: 'Docs', prompt: 'Documentation, README, API docs', skill: 'documentation' },
141
142
  { value: 'custom', labelKey: 'role.label.custom', label: 'Custom...', prompt: '', skill: null },
@@ -32,6 +32,8 @@ const LEGACY_MAP: Record<string, string> = {
32
32
  '문서화, README, API docs': 'docs',
33
33
  'UI/UX, CSS, components': 'frontend',
34
34
  'API, DB, server logic': 'backend',
35
+ 'Search, codebase exploration, uncertainty reduction, read-only reports': 'research',
36
+ 'Search, codebase exploration, uncertainty reduction, read-only': 'research',
35
37
  'Data pipeline, analysis, ML': 'data',
36
38
  'Documentation, README, API docs': 'docs',
37
39
  };
@@ -1,9 +1,13 @@
1
1
  // ── Heartbeat Feature ──
2
2
  import { state } from '../state.js';
3
- import type { HeartbeatJob } from '../state.js';
3
+ import type { HeartbeatJob, HeartbeatSchedule } from '../state.js';
4
4
  import { t } from './i18n.js';
5
5
  import { api, apiJson } from '../api.js';
6
6
  import { escapeHtml } from '../render.js';
7
+ import {
8
+ validateHeartbeatScheduleInput,
9
+ type HeartbeatScheduleValidationCode,
10
+ } from '../../../src/memory/heartbeat-schedule.js';
7
11
 
8
12
  interface HeartbeatData {
9
13
  jobs: HeartbeatJob[];
@@ -11,7 +15,8 @@ interface HeartbeatData {
11
15
 
12
16
  export async function openHeartbeatModal(): Promise<void> {
13
17
  const data = await api<HeartbeatData>('/api/heartbeat');
14
- state.heartbeatJobs = data?.jobs || [];
18
+ state.heartbeatJobs = (data?.jobs || []).map(normalizeHeartbeatJob);
19
+ state.heartbeatErrors = collectHeartbeatErrors(state.heartbeatJobs as HeartbeatJob[]);
15
20
  renderHeartbeatJobs();
16
21
  document.getElementById('heartbeatModal')?.classList.add('open');
17
22
  }
@@ -24,27 +29,50 @@ export function closeHeartbeatModal(e?: Event): void {
24
29
  export function renderHeartbeatJobs(): void {
25
30
  const container = document.getElementById('hbJobsList');
26
31
  if (!container) return;
27
- const jobs = state.heartbeatJobs as HeartbeatJob[];
32
+ const jobs = (state.heartbeatJobs as HeartbeatJob[]).map(normalizeHeartbeatJob);
33
+ state.heartbeatJobs = jobs;
34
+ state.heartbeatErrors = collectHeartbeatErrors(jobs);
28
35
  if (jobs.length === 0) {
29
36
  container.innerHTML = `<p style="color:var(--text-dim);font-size:12px;text-align:center">${t('hb.empty')}</p>`;
30
37
  } else {
31
- container.innerHTML = jobs.map((job, i) => `
32
- <div class="hb-job-card">
33
- <div class="hb-job-header">
34
- <input type="text" value="${escapeHtml(String(job.name || ''))}" placeholder="${t('hb.name')}"
35
- data-hb-name="${i}">
36
- <span style="font-size:11px;color:var(--text-dim)">every</span>
37
- <input type="number" value="${(job.schedule as Record<string, unknown>)?.minutes || 5}" min="1"
38
- data-hb-minutes="${i}">
39
- <span style="font-size:11px;color:var(--text-dim)">min</span>
40
- <button class="hb-toggle ${job.enabled ? 'on' : 'off'}"
41
- data-hb-toggle="${i}"></button>
42
- <button class="hb-del" data-hb-remove="${i}">✕</button>
38
+ container.innerHTML = jobs.map((job, i) => {
39
+ const schedule = normalizeSchedule(job.schedule);
40
+ const isCron = schedule.kind === 'cron';
41
+ const error = state.heartbeatErrors[job.id];
42
+ const scheduleMeta = error || getHeartbeatScheduleHint(schedule);
43
+ const scheduleMetaClass = error ? 'hb-schedule-meta hb-error' : 'hb-schedule-meta hb-help';
44
+ const scheduleInput = isCron
45
+ ? `<input type="text" value="${escapeHtml(schedule.cron)}" placeholder="${escapeHtml(t('hb.cronPlaceholder'))}"
46
+ data-hb-cron="${i}">`
47
+ : `<input type="number" value="${schedule.minutes}" min="1" data-hb-minutes="${i}">`;
48
+ const scheduleSuffix = isCron
49
+ ? `<span class="hb-chip">${escapeHtml(t('hb.cronLabel'))}</span>`
50
+ : `<span class="hb-chip">${escapeHtml(t('hb.minutesLabel'))}</span>`;
51
+ return `
52
+ <div class="hb-job-card">
53
+ <div class="hb-job-header">
54
+ <input type="text" value="${escapeHtml(String(job.name || ''))}" placeholder="${escapeHtml(t('hb.name'))}"
55
+ data-hb-name="${i}">
56
+ <button class="hb-toggle ${job.enabled ? 'on' : 'off'}"
57
+ data-hb-toggle="${i}"></button>
58
+ <button class="hb-del" data-hb-remove="${i}">✕</button>
59
+ </div>
60
+ <div class="hb-job-schedule">
61
+ <select data-hb-kind="${i}">
62
+ <option value="every"${isCron ? '' : ' selected'}>${escapeHtml(t('hb.kindEvery'))}</option>
63
+ <option value="cron"${isCron ? ' selected' : ''}>${escapeHtml(t('hb.kindCron'))}</option>
64
+ </select>
65
+ ${scheduleInput}
66
+ ${scheduleSuffix}
67
+ <input type="text" value="${escapeHtml(schedule.timeZone || '')}" placeholder="${escapeHtml(timeZonePlaceholder())}"
68
+ data-hb-timezone="${i}">
69
+ </div>
70
+ <p class="${scheduleMetaClass}">${escapeHtml(scheduleMeta)}</p>
71
+ <textarea class="hb-prompt" rows="2" placeholder="${escapeHtml(t('hb.prompt'))}"
72
+ data-hb-prompt="${i}">${escapeHtml(String(job.prompt || ''))}</textarea>
43
73
  </div>
44
- <textarea class="hb-prompt" rows="2" placeholder="${t('hb.prompt')}"
45
- data-hb-prompt="${i}">${escapeHtml(String(job.prompt || ''))}</textarea>
46
- </div>
47
- `).join('');
74
+ `;
75
+ }).join('');
48
76
  }
49
77
  const active = jobs.filter(j => j.enabled).length;
50
78
  const btn = document.getElementById('hbSidebarBtn');
@@ -56,35 +84,133 @@ export function addHeartbeatJob(): void {
56
84
  id: 'hb_' + Date.now(),
57
85
  name: '',
58
86
  enabled: true,
59
- schedule: { kind: 'every', minutes: 5 },
60
- prompt: ''
87
+ schedule: withBrowserTimeZone({ kind: 'every', minutes: 5 }),
88
+ prompt: '',
61
89
  });
62
90
  renderHeartbeatJobs();
63
- saveHeartbeatJobs();
91
+ void saveHeartbeatJobs();
64
92
  }
65
93
 
66
94
  export function removeHeartbeatJob(i: number): void {
67
95
  state.heartbeatJobs.splice(i, 1);
68
96
  renderHeartbeatJobs();
69
- saveHeartbeatJobs();
97
+ void saveHeartbeatJobs();
70
98
  }
71
99
 
72
100
  export function toggleHeartbeatJob(i: number): void {
73
101
  const jobs = state.heartbeatJobs as HeartbeatJob[];
74
- jobs[i].enabled = !jobs[i].enabled;
102
+ const job = jobs[i];
103
+ if (!job) return;
104
+ job.enabled = !job.enabled;
75
105
  renderHeartbeatJobs();
76
- saveHeartbeatJobs();
106
+ void saveHeartbeatJobs();
77
107
  }
78
108
 
79
109
  export async function saveHeartbeatJobs(): Promise<void> {
80
- await apiJson('/api/heartbeat', 'PUT', { jobs: state.heartbeatJobs });
110
+ const jobs = (state.heartbeatJobs as HeartbeatJob[]).map(normalizeHeartbeatJob);
111
+ state.heartbeatJobs = jobs;
112
+ state.heartbeatErrors = collectHeartbeatErrors(jobs);
113
+ if (Object.keys(state.heartbeatErrors).length > 0) {
114
+ renderHeartbeatJobs();
115
+ return;
116
+ }
117
+ const data = await apiJson<HeartbeatData>('/api/heartbeat', 'PUT', { jobs });
118
+ if (data?.jobs) {
119
+ state.heartbeatJobs = data.jobs.map(normalizeHeartbeatJob);
120
+ state.heartbeatErrors = collectHeartbeatErrors(state.heartbeatJobs as HeartbeatJob[]);
121
+ renderHeartbeatJobs();
122
+ }
81
123
  }
82
124
 
83
125
  export async function initHeartbeatBadge(): Promise<void> {
84
126
  try {
85
127
  const d = await api<HeartbeatData>('/api/heartbeat');
86
- const active = (d?.jobs || []).filter(j => j.enabled).length;
128
+ const active = (d?.jobs || []).map(normalizeHeartbeatJob).filter(j => j.enabled).length;
87
129
  const btn = document.getElementById('hbSidebarBtn');
88
130
  if (btn) btn.textContent = `💓 Heartbeat (${active})`;
89
131
  } catch { /* ignore */ }
90
132
  }
133
+
134
+ function normalizeHeartbeatJob(job: HeartbeatJob): HeartbeatJob {
135
+ return {
136
+ id: String(job.id || `hb_${Date.now()}`),
137
+ name: String(job.name || ''),
138
+ enabled: job.enabled !== false,
139
+ schedule: normalizeSchedule(job.schedule),
140
+ prompt: String(job.prompt || ''),
141
+ };
142
+ }
143
+
144
+ function normalizeSchedule(schedule: HeartbeatJob['schedule']): HeartbeatSchedule {
145
+ const timeZone = normalizeTimeZone(schedule?.timeZone);
146
+ if (schedule?.kind === 'cron') {
147
+ const cron = typeof schedule.cron === 'string'
148
+ ? schedule.cron.trim().replace(/\s+/g, ' ')
149
+ : '0 9 * * *';
150
+ return timeZone ? { kind: 'cron', cron, timeZone } : { kind: 'cron', cron };
151
+ }
152
+ const minutes = typeof schedule?.minutes === 'number' && Number.isFinite(schedule.minutes) && schedule.minutes > 0
153
+ ? Math.max(1, Math.floor(schedule.minutes))
154
+ : 5;
155
+ return timeZone ? { kind: 'every', minutes, timeZone } : { kind: 'every', minutes };
156
+ }
157
+
158
+ function normalizeTimeZone(value: unknown): string | undefined {
159
+ const timeZone = typeof value === 'string' ? value.trim() : '';
160
+ return timeZone || undefined;
161
+ }
162
+
163
+ function withBrowserTimeZone(schedule: HeartbeatSchedule): HeartbeatSchedule {
164
+ const timeZone = detectBrowserTimeZone();
165
+ if (!timeZone) return schedule;
166
+ return { ...schedule, timeZone };
167
+ }
168
+
169
+ function detectBrowserTimeZone(): string | undefined {
170
+ try {
171
+ return Intl.DateTimeFormat().resolvedOptions().timeZone || undefined;
172
+ } catch {
173
+ return undefined;
174
+ }
175
+ }
176
+
177
+ function timeZonePlaceholder(): string {
178
+ const browserTimeZone = detectBrowserTimeZone();
179
+ return browserTimeZone ? `${t('hb.timezoneAuto')} ${browserTimeZone}` : t('hb.timezoneAuto');
180
+ }
181
+
182
+ function collectHeartbeatErrors(jobs: HeartbeatJob[]): Record<string, string> {
183
+ const errors: Record<string, string> = {};
184
+ for (const job of jobs) {
185
+ const error = validateHeartbeatDraft(job);
186
+ if (error) errors[job.id] = error;
187
+ }
188
+ return errors;
189
+ }
190
+
191
+ function validateHeartbeatDraft(job: HeartbeatJob): string | null {
192
+ const result = validateHeartbeatScheduleInput(job.schedule);
193
+ if (result.ok) return null;
194
+ return formatHeartbeatValidationError(result.code, result.error);
195
+ }
196
+
197
+ function formatHeartbeatValidationError(code: HeartbeatScheduleValidationCode, fallback: string): string {
198
+ switch (code) {
199
+ case 'invalid_cron':
200
+ return t('hb.invalidCron');
201
+ case 'invalid_timezone':
202
+ return t('hb.invalidTimeZone');
203
+ case 'invalid_minutes':
204
+ return t('hb.invalidMinutes');
205
+ default:
206
+ return fallback || t('hb.invalidSchedule');
207
+ }
208
+ }
209
+
210
+ function getHeartbeatScheduleHint(schedule: HeartbeatSchedule): string {
211
+ const timeZone = schedule.timeZone || detectBrowserTimeZone() || 'Asia/Seoul';
212
+ if (schedule.kind === 'cron') {
213
+ return t('hb.scheduleHintCron', { cron: '0 9 * * *', timeZone });
214
+ }
215
+ return t('hb.scheduleHintEvery', { minutes: schedule.minutes, timeZone });
216
+ }