@growthub/cli 0.9.18 → 0.10.1

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/globals.css

@@ -3965,6 +3965,37 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 .dm-detail-v2-title h2 { margin: 0; font-size: 15px; font-weight: 600; color: #111827; flex: 1; }
 .dm-detail-v2-meta { display: flex; align-items: center; gap: 10px; padding-left: 21px; font-size: 12px; color: #9ca3af; }
 .dm-detail-v2-meta code { font-size: 11px; color: #6b7280; background: #f3f4f6; border-radius: 4px; padding: 2px 6px; }
+.dm-detail-v3 { border: 1px solid #e5e7eb; border-radius: 12px; background: #fff; overflow: hidden; }
+.dm-detail-v3-head { padding-bottom: 14px; }
+.dm-picker { position: relative; min-width: 280px; }
+.dm-picker-trigger { width: min(420px, 100%); display: inline-flex; align-items: center; gap: 10px; min-height: 40px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; color: #0f172a; box-shadow: 0 1px 2px rgba(15,23,42,.05); font: inherit; padding: 0 12px; cursor: pointer; text-align: left; }
+.dm-picker.open .dm-picker-trigger { border-color: #94a3b8; box-shadow: 0 0 0 4px rgba(148,163,184,.14); }
+.dm-picker-trigger-copy { display: grid; min-width: 0; flex: 1; }
+.dm-picker-trigger-copy strong { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 13px; font-weight: 650; color: #111827; }
+.dm-picker-trigger-copy em { font-style: normal; font-size: 11px; color: #94a3b8; }
+.dm-picker-popover { position: absolute; top: calc(100% + 8px); left: 0; z-index: 50; width: 360px; display: grid; gap: 10px; padding: 12px; border: 1px solid #dbe2ea; border-radius: 14px; background: #fff; box-shadow: 0 28px 80px rgba(15,23,42,.24); overflow: visible; }
+.dm-picker-tabs { display: inline-flex; gap: 6px; padding: 4px; border-radius: 999px; background: #f8fafc; }
+.dm-picker-tabs button { height: 28px; border: 0; border-radius: 999px; background: transparent; color: #64748b; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; }
+.dm-picker-tabs button.active { background: #fff; color: #111827; box-shadow: 0 1px 2px rgba(15,23,42,.08); }
+.dm-picker-section { display: grid; gap: 8px; }
+.dm-picker-section > p { margin: 0; font-size: 11px; font-weight: 700; color: #94a3b8; text-transform: uppercase; letter-spacing: .06em; }
+.dm-picker-scroll { display: grid; gap: 4px; max-height: 220px; overflow-y: auto; padding-right: 10px; scrollbar-gutter: stable; }
+.dm-picker-item { position: relative; display: grid; grid-template-columns: minmax(0,1fr) auto; gap: 8px; align-items: center; }
+.dm-picker-row { width: 100%; display: inline-flex; align-items: center; gap: 8px; min-width: 0; min-height: 34px; border: 0; border-radius: 9px; background: transparent; color: #334155; font: inherit; font-size: 12px; font-weight: 500; padding: 0 10px; cursor: pointer; text-align: left; }
+.dm-picker-row:hover, .dm-picker-item.active .dm-picker-row { background: #f1f5f9; color: #111827; }
+.dm-picker-item.active .dm-picker-row span { font-weight: 650; }
+.dm-picker-row span { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dm-picker-actions { position: relative; display: inline-flex; align-items: center; justify-content: center; }
+.dm-picker-icon-btn { display: inline-flex; align-items: center; justify-content: center; width: 26px; height: 26px; border: 1px solid #e2e8f0; border-radius: 7px; background: #fff; color: #94a3b8; cursor: pointer; flex: 0 0 auto; }
+.dm-picker-icon-btn:hover { color: #111827; border-color: #cbd5e1; }
+.dm-picker-icon-btn.danger:hover { color: #b91c1c; border-color: #fecaca; background: #fef2f2; }
+.dm-picker-lock { margin-left: auto; color: #94a3b8; }
+.dm-picker-menu { position: absolute; top: calc(100% + 6px); right: 0; z-index: 55; display: grid; gap: 4px; min-width: 156px; padding: 8px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; box-shadow: 0 20px 44px rgba(15,23,42,.2), 0 4px 12px rgba(15,23,42,.08); }
+.dm-picker-menu button { display: inline-flex; align-items: center; gap: 8px; height: 30px; border: 0; border-radius: 7px; background: transparent; color: #334155; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; text-align: left; }
+.dm-picker-menu button:hover { background: #f1f5f9; color: #111827; }
+.dm-picker-menu button.danger:hover { background: #fef2f2; color: #b91c1c; }
+.dm-picker-create { display: grid; gap: 8px; border-top: 1px solid #edf0f3; padding-top: 10px; }
+.dm-picker-create input { width: 100%; height: 34px; border: 1px solid #cbd5e1; border-radius: 8px; background: #fff; color: #111827; font: inherit; font-size: 12px; padding: 0 10px; }
 
 /* Source validation banner */
 .dm-validation-banner { display: flex; align-items: center; gap: 7px; margin-top: 8px; padding: 7px 10px; background: #fffbeb; border: 1px solid #fde68a; border-radius: 6px; font-size: 12px; color: #92400e; }
@@ -3999,9 +4030,10 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 .dm-records-tab {}
 .dm-records-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 10px; margin-bottom: 12px; }
 .dm-stat-label { font-size: 12px; color: #9ca3af; font-weight: 600; }
-.dm-records-actions { display: flex; align-items: center; gap: 6px; flex-wrap: wrap; }
+.dm-records-actions { display: flex; align-items: center; justify-content: flex-end; gap: 6px; flex-wrap: wrap; margin-left: auto; }
 .dm-btn-ghost { display: inline-flex; align-items: center; gap: 5px; height: 28px; border: 1px solid #e5e7eb; border-radius: 6px; background: #fff; color: #555; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; transition: background .1s, border-color .1s; }
 .dm-btn-ghost:hover { background: #f5f5f5; border-color: #ccc; color: #222; }
+.dm-btn-outline { display: inline-flex; align-items: center; justify-content: center; gap: 5px; height: 28px; border: 1px solid #d1d5db; border-radius: 6px; background: #fff; color: #475569; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; }
 .dm-btn-primary-sm { display: inline-flex; align-items: center; gap: 5px; height: 28px; border: 0; border-radius: 6px; background: #111; color: #fff; font: inherit; font-size: 12px; padding: 0 11px; cursor: pointer; font-weight: 500; transition: background .12s; }
 .dm-btn-primary-sm:hover { background: #333; }
 .dm-btn-primary-sm:disabled { opacity: .45; cursor: not-allowed; }
@@ -4023,24 +4055,77 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 .dm-csv-textarea { width: 100%; margin-bottom: 8px; border: 1px solid #d1d5db; border-radius: 6px; background: #fff; font-family: ui-monospace,SFMono-Regular,Menlo,monospace; font-size: 12px; padding: 7px 10px; box-sizing: border-box; resize: vertical; }
 
 /* Data Model database grid */
-.dm-db-surface { display: flex; flex-direction: column; gap: 10px; padding: 14px; min-height: 0; flex: 1; background: #fff; }
-.dm-db-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.dm-db-surface { display: flex; flex-direction: column; gap: 10px; padding: 14px; min-height: 0; flex: 1; background: #fff; overflow: visible; }
+.dm-db-toolbar { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; overflow: visible; }
 .dm-db-toolbar-title { display: flex; align-items: baseline; gap: 8px; min-width: 0; }
 .dm-db-toolbar-title strong { font-size: 13px; color: #111827; font-weight: 650; }
 .dm-db-toolbar-title span { font-size: 12px; color: #9ca3af; }
-.dm-db-grid-wrap { flex: 1; min-height: 420px; overflow: auto; border: 1px solid #dfe3e8; border-radius: 7px; background: #fff; }
+.dm-inline-panel { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; padding: 10px 12px; border: 1px solid #dfe3e8; border-radius: 10px; background: #fbfdff; }
+.dm-inline-panel input { height: 32px; border: 1px solid #cbd5e1; border-radius: 8px; background: #fff; color: #111827; font: inherit; font-size: 12px; padding: 0 10px; }
+.dm-filter-chip-row { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; min-height: 32px; }
+.dm-filter-chip { display: inline-flex; align-items: center; gap: 6px; height: 30px; border: 1px solid #c7d2fe; border-radius: 8px; background: #eef2ff; color: #3730a3; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; }
+.dm-selection-count { border-color: #d1d5db; background: #fff; color: #475569; cursor: default; }
+.dm-filter-chip span { max-width: 240px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.dm-filter-popover { position: absolute; z-index: 40; display: grid; gap: 8px; width: 320px; padding: 10px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; box-shadow: 0 18px 42px rgba(15,23,42,.18), 0 3px 10px rgba(15,23,42,.08); }
+.dm-filter-popover input { height: 32px; border: 1px solid #cbd5e1; border-radius: 8px; background: #fff; color: #111827; font: inherit; font-size: 12px; padding: 0 10px; }
+.dm-filter-anchor { position: relative; display: inline-flex; }
+.dm-filter-popover-toolbar { top: calc(100% + 6px); left: 0; right: auto; }
+.dm-filter-popover-column { top: calc(100% + 6px); left: 0; }
+.dm-filter-popover-actions { display: flex; justify-content: flex-end; gap: 8px; }
+.dm-db-grid-wrap { display: flex; flex: 1; min-height: 420px; flex-direction: column; overflow: hidden; border: 1px solid #dfe3e8; border-radius: 7px; background: #fff; }
+.dm-db-grid-wrap > .dm-db-grid-scroll { flex: 1 1 auto; overflow: auto; }
 .dm-db-grid { width: 100%; border-collapse: separate; border-spacing: 0; font-size: 12px; color: #1f2937; }
-.dm-db-grid th { position: sticky; top: 0; z-index: 1; height: 32px; background: #f8fafc; color: #475569; border-bottom: 1px solid #dfe3e8; border-right: 1px solid #edf0f3; padding: 0 10px; text-align: left; font-weight: 650; white-space: nowrap; }
+.dm-db-grid th { position: sticky; top: 0; z-index: 1; height: 32px; background: #f8fafc; color: #475569; border-bottom: 1px solid #dfe3e8; border-right: 1px solid #edf0f3; padding: 0; text-align: left; font-weight: 650; white-space: nowrap; }
 .dm-db-grid td { height: 32px; max-width: 260px; border-bottom: 1px solid #f1f5f9; border-right: 1px solid #f1f5f9; padding: 0 10px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; cursor: pointer; }
 .dm-db-grid tbody tr:hover td { background: #f8fafc; }
 .dm-db-grid tbody tr.selected td { background: #eef2ff; }
+.dm-db-grid tbody tr.multi-selected td { background: #f8fafc; }
+.dm-db-head-btn { display: inline-flex; align-items: center; justify-content: flex-start; width: 100%; height: 32px; gap: 6px; border: 0; background: transparent; color: inherit; font: inherit; font-size: 12px; font-weight: inherit; padding: 0 10px; cursor: pointer; }
 .dm-db-rownum { width: 42px; min-width: 42px; text-align: center !important; color: #94a3b8 !important; background: #f8fafc; font-variant-numeric: tabular-nums; }
+.dm-row-select { position: relative; display: inline-flex; align-items: center; justify-content: center; width: 100%; height: 32px; border: 0; background: transparent; color: inherit; font: inherit; cursor: pointer; }
+.dm-row-select-box { position: relative; display: none; width: 16px; height: 16px; border: 1px solid #d1d5db; border-radius: 5px; background: #fff; box-sizing: border-box; }
+.dm-row-select:hover .dm-row-select-box, .dm-row-select[aria-pressed="true"] .dm-row-select-box { border-color: #cbd5e1; background: #fff; box-shadow: 0 1px 3px rgba(15,23,42,.14); }
+.dm-row-select[aria-pressed="true"] .dm-row-select-box { display: inline-flex; }
+.dm-row-select[aria-pressed="true"] .dm-row-select-box::after { content: ""; position: absolute; left: 5px; top: 3px; width: 4px; height: 7px; border: solid #334155; border-width: 0 1.5px 1.5px 0; transform: rotate(45deg); }
+.dm-db-grid tbody tr:hover .dm-row-select-box { display: inline-flex; }
+.dm-row-select[aria-pressed="true"] .dm-row-number, .dm-db-grid tbody tr:hover .dm-row-select .dm-row-number { display: none; }
+.dm-db-rownum-head { position: sticky; overflow: visible; z-index: 4 !important; }
+.dm-row-select-head-wrap { position: relative; display: flex; align-items: center; justify-content: center; height: 32px; }
+.dm-row-select-all { width: 26px; flex: 0 0 26px; }
+.dm-row-select-menu-btn { display: none; }
+.dm-db-rownum-head:hover .dm-row-select-menu-btn, .dm-row-select-menu-btn[aria-expanded="true"] { display: none; }
+.dm-row-select-menu-btn:hover { background: #eef2f7; color: #475569; }
+.dm-db-rownum-head:hover .dm-row-select-all .dm-row-select-box, .dm-row-select-all[aria-pressed="true"] .dm-row-select-box { display: inline-flex; }
+.dm-db-rownum-head:hover .dm-row-select-all .dm-row-number, .dm-row-select-all[aria-pressed="true"] .dm-row-number { display: none; }
+.dm-row-select-menu { position: absolute; top: calc(100% + 6px); left: 6px; z-index: 50; display: grid; gap: 3px; min-width: 150px; padding: 6px; border: 1px solid #dbe2ea; border-radius: 8px; background: #fff; box-shadow: 0 14px 34px rgba(15,23,42,.16), 0 2px 8px rgba(15,23,42,.08); }
+.dm-row-select-menu button { display: flex; align-items: center; height: 28px; border: 0; border-radius: 6px; background: transparent; color: #334155; font: inherit; font-size: 12px; padding: 0 8px; text-align: left; cursor: pointer; }
+.dm-row-select-menu button:hover { background: #f1f5f9; }
+.dm-row-select-menu button:disabled { opacity: .45; cursor: not-allowed; }
 .dm-db-field-type { display: inline-flex; align-items: center; justify-content: center; width: 18px; height: 18px; margin-right: 5px; border-radius: 4px; color: #64748b; background: #eef2f7; vertical-align: middle; }
-.dm-db-add-field { min-width: 118px; }
+.dm-db-add-field { position: relative; min-width: 118px; }
 .dm-db-add-field button { display: inline-flex; align-items: center; gap: 4px; border: 0; background: transparent; color: #64748b; font: inherit; font-size: 12px; cursor: pointer; }
 .dm-db-add-field input { width: 110px; height: 24px; border: 1px solid #cbd5e1; border-radius: 5px; padding: 0 7px; font: inherit; font-size: 12px; }
+.dm-col-menu { position: absolute; top: calc(100% + 6px); left: 0; z-index: 25; display: grid; gap: 3px; min-width: 180px; padding: 8px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; box-shadow: 0 18px 42px rgba(15,23,42,.18), 0 3px 10px rgba(15,23,42,.08); }
+.dm-col-menu button { display: inline-flex; align-items: center; gap: 8px; height: 30px; border: 0; border-radius: 7px; background: transparent; color: #334155; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; text-align: left; }
+.dm-col-menu button:hover { background: #f1f5f9; }
+.dm-field-creator-popover { position: absolute; top: calc(100% + 8px); right: 0; z-index: 35; }
+.dm-field-creator { display: grid; gap: 8px; width: 248px; padding: 10px; border: 1px solid #dbe2ea; border-radius: 10px; background: #fff; box-shadow: 0 18px 42px rgba(15,23,42,.18), 0 3px 10px rgba(15,23,42,.08); }
+.dm-field-creator > input { width: 100%; height: 32px; border: 1px solid #cbd5e1; border-radius: 8px; background: #fff !important; color: #111827 !important; -webkit-text-fill-color: #111827; padding: 0 10px; font: inherit; font-size: 12px; appearance: none; }
+.dm-field-type-grid { display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 6px; }
+.dm-field-type-grid button { display: inline-flex; align-items: center; gap: 6px; justify-content: flex-start; height: 32px; border: 1px solid #e2e8f0; border-radius: 8px; background: #fff; color: #475569; font: inherit; font-size: 12px; padding: 0 9px; cursor: pointer; }
+.dm-field-type-grid button.active { border-color: #c7d2fe; background: #eef2ff; color: #3730a3; }
+.dm-field-creator-actions { display: flex; justify-content: flex-end; gap: 8px; }
 .dm-db-empty-cell { background: #fbfdff; }
 .dm-db-new-row td { color: #64748b; background: #fbfdff; font-weight: 600; }
+.dm-pagination-bar { display: flex; flex: 0 0 auto; align-items: center; justify-content: space-between; gap: 12px; min-height: 36px; padding: 8px 14px; background: #fff; color: #64748b; font-size: 12px; border-top: 1px solid #edf0f3; }
+.dm-pagination-summary { white-space: nowrap; }
+.dm-pagination-controls { display: inline-flex; align-items: center; gap: 8px; }
+.dm-page-size-control { display: inline-flex; align-items: center; gap: 6px; color: #64748b; }
+.dm-page-size-control select { height: 28px; border: 1px solid #dbe2ea; border-radius: 6px; background: #fff; color: #334155; font: inherit; font-size: 12px; padding: 0 22px 0 8px; }
+.dm-pagination-btn { height: 28px; border: 1px solid #dbe2ea; border-radius: 6px; background: #fff; color: #334155; font: inherit; font-size: 12px; padding: 0 10px; cursor: pointer; }
+.dm-pagination-btn:hover:not(:disabled) { background: #f8fafc; border-color: #cbd5e1; }
+.dm-pagination-btn:disabled { opacity: .45; cursor: not-allowed; }
+.dm-pagination-page { min-width: 44px; text-align: center; color: #64748b; }
 .dm-db-status { display: inline-flex; align-items: center; gap: 5px; height: 20px; border: 1px solid #e2e8f0; border-radius: 999px; padding: 0 8px; background: #f8fafc; color: #64748b; font-size: 11px; font-weight: 650; }
 .dm-db-status span { width: 6px; height: 6px; border-radius: 50%; background: #94a3b8; }
 .dm-db-status.ok { border-color: #bbf7d0; background: #f0fdf4; color: #166534; }
@@ -4050,6 +4135,14 @@ code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0
 .dm-record-backdrop { position: fixed; inset: 0; z-index: 80; background: rgba(15,23,42,.12); }
 .dm-record-drawer { position: fixed; top: 0; right: 0; bottom: 0; z-index: 81; display: flex; flex-direction: column; width: min(440px, 100vw); background: #fff; border-left: 1px solid #dfe3e8; box-shadow: -10px 0 34px rgba(15,23,42,.16); }
 .dm-record-drawer-head { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 16px 18px; border-bottom: 1px solid #edf0f3; }
+.dm-record-drawer-actions { display: inline-flex; align-items: center; gap: 8px; }
+.dm-record-drawer-foot { display: flex; justify-content: flex-end; gap: 8px; padding: 14px 16px; border-top: 1px solid #edf0f3; background: #fff; }
+.dm-drawer-field-editor { display: grid; gap: 8px; }
+.dm-drawer-field-row { display: grid; grid-template-columns: minmax(0,1fr) auto auto auto; gap: 8px; align-items: center; }
+.dm-drawer-field-row input { width: 100%; height: 34px; border: 1px solid #cbd5e1; border-radius: 8px; background: #fff; color: #111827; font: inherit; font-size: 12px; padding: 0 10px; }
+.dm-drawer-hidden-fields { display: grid; gap: 8px; margin-top: 10px; }
+.dm-drawer-hidden-fields > span { color: #64748b; font-size: 12px; font-weight: 600; }
+.dm-drawer-hidden-list { display: flex; flex-wrap: wrap; gap: 8px; }
 .dm-record-drawer-head p { margin: 0 0 3px; color: #94a3b8; font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: .05em; }
 .dm-record-drawer-head h2 { margin: 0; color: #111827; font-size: 16px; font-weight: 650; }
 .dm-record-testbar { display: flex; align-items: center; gap: 8px; padding: 10px 18px; border-bottom: 1px solid #edf0f3; background: #fbfdff; }

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/docs/connector-template-authoring.md

@@ -0,0 +1,8 @@
+# Connector template authoring
+
+1. Add `lib/adapters/integrations/templates/<your-template>.js` exporting a `default` object with `schemaVersion: "growthub-resolver-template-v1"`.
+2. Import it from `template-registry.js` and append to the `ALL` array.
+3. Keep `connectorKind`, `capabilities`, and `supportedLanes` honest — they drive operator UX only.
+4. Document the expected resolver `integrationId` and any env refs (`authRef` pattern) in the template `configSchema` entries.
+
+Do not import vendor SDKs into template modules. Provider code stays in resolver files under `resolvers/`.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/docs/data-model-reference-fields.md

@@ -0,0 +1,15 @@
+# Data Model reference fields
+
+Governed reference columns (for example `registryId` on a Data Source or `schedulerRegistryId` on a Sandbox Environment) are declared on each `dataModel.objects[]` entry under `relations[]`. Preset object types ship default relation metadata; older objects pick up the same defaults through `effectiveRelations()` at read time.
+
+## Server option loading
+
+`POST /api/workspace/reference-options` returns normalized `{ value, label, secondaryLabel?, source, objectType?, status?, metadata? }[]` rows. The default path scans local `dataModel.objects[]` rows whose `objectType` matches `targetObjectType`, using optional `valueField`, `labelField`, `statusField`, and `statusAllowlist` on the relation descriptor.
+
+## UI
+
+The Data Model page uses `ReferencePicker` for objects that have a stable `objectId`. Widget-bound tables without an `objectId` keep the legacy client-only picker.
+
+## Authority
+
+The browser never receives provider secrets. Reference options for workspace rows are derived from config only; resolver-backed `listEntities` runs server-side with env/bridge resolution identical to `POST /api/workspace/test-source`.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/docs/mcp-chrome-tool-connectors.md

@@ -0,0 +1,12 @@
+# MCP, Chrome, and tool connectors
+
+AWaC keeps **authority on the server**: MCP sessions, Chrome bridges, and local tool CLIs are reached through resolver `fetchRecords` / optional `listEntities`, sandbox adapters, or serverless scheduler rows — never by embedding tokens into `growthub.config.json`.
+
+Recommended pattern:
+
+1. Model the connector as an **API Registry** row plus optional **Data Source** with `binding.sourceStorage: "workspace-source-records"`.
+2. Implement a resolver whose `integrationId` matches the registry row.
+3. Use `POST /api/workspace/test-source` before binding widgets to the Data Source.
+4. For actions that mutate external systems, prefer **sandbox** lanes (`runLocality: local` with `local-agent-host`, or `serverless` with a scheduler API Registry row) so outputs land in `growthub.source-records.json`.
+
+The `mcp-tool` and `chrome-bridge` templates are scaffolds — replace `integrationId` values with your registered resolver slug after you add resolver files.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/docs/resolver-template-library.md

@@ -0,0 +1,17 @@
+# Resolver template library
+
+Templates live under `lib/adapters/integrations/templates/` and are registered in `template-registry.js`. Each template is **metadata only**: it suggests default API Registry / Data Source shapes and a `configSchema` for operators.
+
+## HTTP API
+
+- `GET /api/workspace/resolver-templates` — list all templates.
+- `GET /api/workspace/resolver-templates?templateId=<id>` — fetch one template.
+
+## Wiring a real resolver
+
+1. Choose a template (for example `custom-http`).
+2. Create an API Registry row whose `integrationId` matches the resolver you will register under `lib/adapters/integrations/resolvers/<id>.js`.
+3. Drop a resolver file that calls `registerSourceResolver({ integrationId, fetchRecords, ... })`.
+4. Test with `POST /api/workspace/test-source` and refresh with `POST /api/workspace/refresh-sources`.
+
+Templates never execute network calls themselves.

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/source-resolver-registry.js

@@ -12,6 +12,11 @@
  *   entityTypes: string[],           // e.g. ["project.tasks", "workspace.users"]
  *   listEntities: async (config, connection) => NormalizedEntity[],
  *   fetchRecords: async (config, connection, binding) => Record[]
+ *   connectorKind?: string,          // http | mcp | chrome | tool | custom
+ *   templateId?: string,
+ *   capabilities?: string[],
+ *   configSchema?: SchemaField[],
+ *   referenceSchema?: Record<string, unknown>
  * }
  *
  * The route and the refresh button reference this registry only — they have
@@ -71,6 +76,7 @@ function listRegisteredResolvers() {
  *     entityTypes:   string[],           // declared by the resolver
  *     hasListEntities: boolean,          // true if resolver.listEntities is a function
  *     configSchema: SchemaField[] | null // optional declarative params schema
+ *     connectorKind, templateId, capabilities, referenceSchema — optional metadata
  *   }
  */
 function describeRegisteredResolvers() {
@@ -79,6 +85,13 @@ function describeRegisteredResolvers() {
     entityTypes: Array.isArray(resolver.entityTypes) ? resolver.entityTypes : [],
     hasListEntities: typeof resolver.listEntities === "function",
     configSchema: Array.isArray(resolver.configSchema) ? resolver.configSchema : null,
+    connectorKind: typeof resolver.connectorKind === "string" ? resolver.connectorKind : null,
+    templateId: typeof resolver.templateId === "string" ? resolver.templateId : null,
+    capabilities: Array.isArray(resolver.capabilities) ? resolver.capabilities : null,
+    referenceSchema:
+      resolver.referenceSchema && typeof resolver.referenceSchema === "object" && !Array.isArray(resolver.referenceSchema)
+        ? resolver.referenceSchema
+        : null
   }));
 }
 

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/README.md

@@ -0,0 +1,12 @@
+# Resolver template library
+
+Shipped templates under this directory are **metadata-only** seeds. They do not register resolvers or execute providers.
+
+- Add a new `*.js` file exporting a `default` object with `schemaVersion: "growthub-resolver-template-v1"`.
+- Register the module in `template-registry.js`.
+- Implement real HTTP/MCP/tool behavior in `lib/adapters/integrations/resolvers/<integrationId>.js` using `registerSourceResolver`.
+
+Runtime surfaces:
+
+- `GET /api/workspace/resolver-templates` — list templates
+- `GET /api/workspace/resolver-templates?templateId=<id>` — fetch one

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/chrome-bridge.js

@@ -0,0 +1,22 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "chrome-bridge",
+  label: "Chrome extension bridge",
+  connectorKind: "chrome",
+  capabilities: ["fetchRecords", "runAction"],
+  apiRegistryDefaults: {
+    integrationId: "chrome-bridge",
+    method: "POST"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "Bridge base URL", type: "url", required: true },
+    { name: "authRef", label: "Bridge token ref", type: "secretRef", required: true }
+  ],
+  supportedLanes: ["sandbox-local", "data-source"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/custom-http.js

@@ -0,0 +1,23 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "custom-http",
+  label: "Custom HTTP connector",
+  connectorKind: "http",
+  capabilities: ["listEntities", "fetchRecords"],
+  apiRegistryDefaults: {
+    integrationId: "custom-http",
+    method: "GET"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "Base URL", type: "url", required: true },
+    { name: "endpoint", label: "Endpoint path", type: "text", required: false },
+    { name: "authRef", label: "Auth env ref", type: "secretRef", required: false }
+  ],
+  supportedLanes: ["data-source", "sandbox-local", "sandbox-serverless"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/generic-commerce.js

@@ -0,0 +1,22 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "generic-commerce",
+  label: "Generic commerce / orders API",
+  connectorKind: "http",
+  capabilities: ["fetchRecords"],
+  apiRegistryDefaults: {
+    integrationId: "generic-commerce",
+    method: "GET"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "Store API base", type: "url", required: true },
+    { name: "authRef", label: "Auth ref", type: "secretRef", required: true }
+  ],
+  supportedLanes: ["data-source"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/generic-crm.js

@@ -0,0 +1,23 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "generic-crm",
+  label: "Generic CRM feed",
+  connectorKind: "http",
+  capabilities: ["listEntities", "fetchRecords"],
+  apiRegistryDefaults: {
+    integrationId: "generic-crm",
+    method: "GET"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "CRM base URL", type: "url", required: true },
+    { name: "entityType", label: "Entity type", type: "text", required: true },
+    { name: "authRef", label: "Auth ref", type: "secretRef", required: true }
+  ],
+  supportedLanes: ["data-source"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/generic-project-management.js

@@ -0,0 +1,22 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "generic-project-management",
+  label: "Generic project management API",
+  connectorKind: "http",
+  capabilities: ["listEntities", "fetchRecords"],
+  apiRegistryDefaults: {
+    integrationId: "generic-pm",
+    method: "GET"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "API base URL", type: "url", required: true },
+    { name: "authRef", label: "Auth ref", type: "secretRef", required: true }
+  ],
+  supportedLanes: ["data-source", "sandbox-serverless"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/generic-spreadsheet.js

@@ -0,0 +1,22 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "generic-spreadsheet",
+  label: "Generic spreadsheet / table feed",
+  connectorKind: "http",
+  capabilities: ["fetchRecords"],
+  apiRegistryDefaults: {
+    integrationId: "generic-spreadsheet",
+    method: "GET"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "Export URL", type: "url", required: true },
+    { name: "authRef", label: "Auth ref", type: "secretRef", required: false }
+  ],
+  supportedLanes: ["data-source"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/mcp-tool.js

@@ -0,0 +1,22 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "mcp-tool",
+  label: "MCP tool bridge",
+  connectorKind: "mcp",
+  capabilities: ["listEntities", "fetchRecords", "runAction"],
+  apiRegistryDefaults: {
+    integrationId: "mcp-local-bridge",
+    method: "POST"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "baseUrl", label: "MCP endpoint", type: "url", required: true },
+    { name: "authRef", label: "Auth ref", type: "secretRef", required: false }
+  ],
+  supportedLanes: ["data-source", "sandbox-local"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/template-registry.js

@@ -0,0 +1,50 @@
+/**
+ * Resolver template registry — operator-facing seeds for API Registry / Data Source rows.
+ *
+ * @typedef {Object} ResolverTemplate
+ * @property {"growthub-resolver-template-v1"} schemaVersion
+ * @property {string} templateId
+ * @property {string} label
+ * @property {"http"|"mcp"|"chrome"|"tool"|"custom"} connectorKind
+ * @property {Array<"listEntities"|"fetchRecords"|"runAction">} capabilities
+ * @property {Object} apiRegistryDefaults
+ * @property {string} apiRegistryDefaults.integrationId
+ * @property {string} [apiRegistryDefaults.authRef]
+ * @property {string} [apiRegistryDefaults.baseUrl]
+ * @property {string} [apiRegistryDefaults.endpoint]
+ * @property {"GET"|"POST"|"PUT"|"PATCH"|"DELETE"} [apiRegistryDefaults.method]
+ * @property {{ objectType: "data-source", binding: { sourceStorage: string } }} [dataSourceDefaults]
+ * @property {Array<{ name: string, label: string, type: string, required?: boolean }>} configSchema
+ * @property {Array<"data-source"|"sandbox-local"|"sandbox-serverless">} supportedLanes
+ */
+
+import customHttp from "./custom-http.js";
+import webhook from "./webhook.js";
+import mcpTool from "./mcp-tool.js";
+import chromeBridge from "./chrome-bridge.js";
+import genericCrm from "./generic-crm.js";
+import genericSpreadsheet from "./generic-spreadsheet.js";
+import genericProjectManagement from "./generic-project-management.js";
+import genericCommerce from "./generic-commerce.js";
+
+const ALL = [
+  customHttp,
+  webhook,
+  mcpTool,
+  chromeBridge,
+  genericCrm,
+  genericSpreadsheet,
+  genericProjectManagement,
+  genericCommerce
+];
+
+function listResolverTemplates() {
+  return ALL.map((t) => ({ ...t }));
+}
+
+function getResolverTemplate(templateId) {
+  const id = String(templateId || "").trim();
+  return ALL.find((t) => t.templateId === id) || null;
+}
+
+export { listResolverTemplates, getResolverTemplate };

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/templates/webhook.js

@@ -0,0 +1,22 @@
+const template = {
+  schemaVersion: "growthub-resolver-template-v1",
+  templateId: "webhook",
+  label: "Inbound webhook",
+  connectorKind: "http",
+  capabilities: ["fetchRecords"],
+  apiRegistryDefaults: {
+    integrationId: "webhook-ingest",
+    method: "POST"
+  },
+  dataSourceDefaults: {
+    objectType: "data-source",
+    binding: { sourceStorage: "workspace-source-records" }
+  },
+  configSchema: [
+    { name: "endpoint", label: "Webhook path", type: "text", required: true },
+    { name: "authRef", label: "Signing secret ref", type: "secretRef", required: false }
+  ],
+  supportedLanes: ["data-source", "sandbox-serverless"]
+};
+
+export default template;

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/references/collect-reference-options.js

@@ -0,0 +1,133 @@
+/**
+ * Server-side orchestration for POST /api/workspace/reference-options.
+ * Dispatches: workspace-rows (default), source-records sidecar, or resolver listEntities.
+ */
+
+import { readAdapterConfig } from "@/lib/adapters/env";
+import { listGovernedWorkspaceIntegrations } from "@/lib/adapters/integrations";
+import { loadAllResolvers } from "@/lib/adapters/integrations/resolver-loader";
+import { getSourceResolver } from "@/lib/adapters/integrations/source-resolver-registry";
+import {
+  findRelationForField,
+  normalizeManualObjects,
+  normalizeReferenceOption,
+  resolveLocalReferenceOptions
+} from "@/lib/workspace-data-model";
+import { resolveSourceRecordReferenceOptions } from "./resolvers/source-records.js";
+
+function normalizeListEntity(entry) {
+  if (!entry || typeof entry !== "object") return null;
+  const id = String(entry.id ?? entry.entityType ?? "").trim();
+  if (!id) return null;
+  return normalizeReferenceOption({
+    value: id,
+    label: String(entry.label ?? id).trim() || id,
+    secondaryLabel: entry.secondaryLabel ? String(entry.secondaryLabel) : undefined,
+    source: "resolver",
+    provider: typeof entry.provider === "string" ? entry.provider : undefined,
+    metadata: entry.meta && typeof entry.meta === "object" ? entry.meta : undefined
+  });
+}
+
+async function collectReferenceOptions(workspaceConfig, parsed) {
+  const { objectId, field, query, cursor, limit, context } = parsed;
+  const objects = normalizeManualObjects(workspaceConfig);
+  const objectItem = objects.find((o) => o.id === objectId);
+  if (!objectItem) {
+    return {
+      ok: false,
+      options: [],
+      nextCursor: null,
+      reason: "unknown-object",
+      error: "dataModel object not found"
+    };
+  }
+  const relation = findRelationForField(objectItem, field);
+  if (!relation) {
+    return {
+      ok: false,
+      options: [],
+      nextCursor: null,
+      reason: "unknown-field",
+      error: "no relation metadata for this field"
+    };
+  }
+
+  if (relation.referenceSource === "source-records") {
+    const sourceId =
+      typeof relation.sidecarSourceId === "string" && relation.sidecarSourceId.trim()
+        ? relation.sidecarSourceId.trim()
+        : typeof context.sourceId === "string"
+          ? context.sourceId.trim()
+          : "";
+    const sr = await resolveSourceRecordReferenceOptions(sourceId, { query, limit });
+    return { ok: true, options: sr.options, nextCursor: null, reason: sr.reason || null };
+  }
+
+  if (relation.resolver && typeof relation.resolver.integrationId === "string" && relation.resolver.integrationId.trim()) {
+    await loadAllResolvers();
+    const integId = relation.resolver.integrationId.trim();
+    const resolver = getSourceResolver(integId);
+    if (!resolver) {
+      return {
+        ok: true,
+        options: [],
+        nextCursor: null,
+        reason: "no-resolver",
+        resolverIntegrationId: integId
+      };
+    }
+    if (typeof resolver.listEntities !== "function") {
+      return { ok: true, options: [], nextCursor: null, reason: "no-list-entities" };
+    }
+    const adapterConfig = readAdapterConfig();
+    let connection = null;
+    try {
+      const integrations = await listGovernedWorkspaceIntegrations();
+      connection =
+        integrations.find((i) => i.provider === integId || i.id === integId) || null;
+    } catch {
+      /* non-fatal */
+    }
+    let entities;
+    try {
+      entities = await resolver.listEntities(adapterConfig, connection, {
+        query,
+        cursor,
+        limit,
+        context,
+        field,
+        objectId
+      });
+    } catch (err) {
+      return {
+        ok: false,
+        options: [],
+        nextCursor: null,
+        reason: "list-error",
+        error: err?.message || "listEntities failed"
+      };
+    }
+    const raw = Array.isArray(entities) ? entities : [];
+    const options = raw.map(normalizeListEntity).filter(Boolean);
+    return { ok: true, options: options.slice(0, limit), nextCursor: null, reason: null };
+  }
+
+  const local = resolveLocalReferenceOptions(workspaceConfig, {
+    objectId,
+    field,
+    query,
+    cursor,
+    limit,
+    relation
+  });
+  return {
+    ok: true,
+    options: local.options,
+    nextCursor: local.nextCursor,
+    reason: local.reason,
+    total: local.total
+  };
+}
+
+export { collectReferenceOptions };