: null,
}));
const summary = {
todayQuotaUsed: 10,
queueCounts: { pending: 0, running: 0, completed24h: 0, failed: 0 },
recentFailures: [],
customDomainIndexing: {
active: 1,
indexed: 0,
settling: 0,
needsAttention: 1,
neverInspected: 0,
lastSweepAt: '2026-05-15T03:04:00.000Z',
needsAttentionList: [
{
dealerId: 'dealer-42',
customDomain: 'joessoil.com',
indexStatus: 'not_indexed',
submittedAt: '2026-04-20T00:00:00.000Z',
inspectedAt: '2026-05-15T03:04:00.000Z',
},
],
neverInspectedList: [],
},
};
beforeEach(() => {
global.fetch = jest.fn().mockResolvedValue({
ok: true,
status: 200,
json: async () => summary,
}) as unknown as typeof fetch;
});
afterEach(() => jest.restoreAllMocks());
describe('GscAdminPage — custom-domain card wiring', () => {
it('renders the rollup card from fetched summary data', async () => {
// Falsely-passes guard: a page that never renders CustomDomainIndexing fails this.
render();
expect(await screen.findByText('Custom Domain Indexing')).toBeInTheDocument();
expect(screen.getByTestId('cd-count-needsAttention')).toHaveTextContent('1');
});
it('opens DealerDetailModal with the dealerId when a flagged row is clicked', async () => {
// Falsely-passes guard: wiring that drops the dealerId (or never mounts the modal)
// fails — the stub only renders when isOpen and echoes the dealerId.
render();
const row = await screen.findByRole('button', { name: /joessoil\.com/ });
fireEvent.click(row);
await waitFor(() =>
expect(screen.getByTestId('detail-modal')).toHaveTextContent('modal for dealer-42'),
);
});
});
```
- [ ] **Step 2: Run test to verify it fails**
Run: `npx jest app/admin/gsc/__tests__/page.test.tsx --no-coverage`
Expected: FAIL — `Unable to find an element with the text: Custom Domain Indexing` (the page does not render the card yet).
- [ ] **Step 3: Implement the wiring (four precise edits to `app/admin/gsc/page.tsx`)**
**Edit 3a — imports.** Replace this exact block near the top:
```tsx
import React, { useState, useEffect, useCallback } from 'react';
import styles from './page.module.css';
import { INDEXING_API_DAILY_CAP } from '@/lib/gsc-constants';
```
with:
```tsx
import React, { useState, useEffect, useCallback } from 'react';
import styles from './page.module.css';
import { INDEXING_API_DAILY_CAP } from '@/lib/gsc-constants';
import { CustomDomainIndexing, type CustomDomainIndexingData } from './CustomDomainIndexing';
import { DealerDetailModal } from '@/components/admin/DealerDetailModal';
```
**Edit 3b — extend `SummaryData`.** Replace this exact interface:
```tsx
interface SummaryData {
todayQuotaUsed: number;
queueCounts: QueueCounts;
recentFailures: RecentFailure[];
}
```
with:
```tsx
interface SummaryData {
todayQuotaUsed: number;
queueCounts: QueueCounts;
recentFailures: RecentFailure[];
customDomainIndexing: CustomDomainIndexingData;
propertyHeadroom?: { ownedEstimate: number; cap: number };
}
```
**Edit 3c — add modal state.** In `export default function GscAdminPage() {`, replace:
```tsx
const [data, setData] = useState(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState(null);
```
with:
```tsx
const [data, setData] = useState(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState(null);
const [selectedDealerId, setSelectedDealerId] = useState(null);
```
**Edit 3d — render the card + modal.** Replace this exact block:
```tsx
{data && (
<>
)}
);
}
```
with:
```tsx
{data && (
<>
)}
setSelectedDealerId(null)}
dealerId={selectedDealerId}
/>
);
}
```
> If Task 4 was skipped: keep `propertyHeadroom?` in `SummaryData` and the `propertyHeadroom={data.propertyHeadroom}` prop exactly as written — `data.propertyHeadroom` is simply `undefined` and the component already hides the line when it is absent. No change needed.
- [ ] **Step 4: Run test to verify it passes**
Run: `npx jest app/admin/gsc/__tests__/page.test.tsx --no-coverage`
Expected: PASS — 2 passed.
- [ ] **Step 5: Type-check**
Run: `npx tsc --noEmit`
Expected: no new errors.
- [ ] **Step 6: Commit**
```bash
git add app/admin/gsc/page.tsx app/admin/gsc/__tests__/page.test.tsx
git commit -m "feat(gsc): wire custom-domain rollup card + detail modal into /admin/gsc"
```
---
## Task 7: Full verification
**Files:** none (verification gate — no success claim without this output).
- [ ] **Step 1: Run the full GSC-related test set**
Run: `npx jest gsc-index-buckets gsc/summary gsc/__tests__/CustomDomainIndexing gsc/__tests__/page --no-coverage`
Expected: PASS — all suites green (classifier 8, summary 7 or 8, component 5, page 2).
- [ ] **Step 2: Full type-check**
Run: `npx tsc --noEmit`
Expected: no new errors versus the pre-Task-1 baseline. If the repo had pre-existing errors, confirm the set is unchanged (none added by these files).
- [ ] **Step 3: Lint the changed files**
Run: `npx eslint lib/gsc-index-buckets.ts app/admin/gsc/CustomDomainIndexing.tsx app/admin/gsc/page.tsx app/api/admin/gsc/summary/route.ts`
Expected: clean (no errors). Fix any reported issues, re-run, then amend the relevant task's commit if needed.
- [ ] **Step 4: Confirm scope — no alerting, no migration, no Google calls**
Run: `git diff --stat 46a3a0c..HEAD`
Expected: only the files listed in the File Structure table changed. Confirm there is **no** new migration, **no** new `lib/google/*` call, and **no** email/anomaly code (alerting was explicitly deferred).
- [ ] **Step 5: Report**
State the actual test counts and `tsc`/`eslint` results. Do not claim completion without the Step 1–4 output. Then hand back to the user: the work is committed on `feature/gsc-indexing` but **not pushed** — pushing PR #849 is the user's call.
---
## Self-Review (completed by plan author)
**Spec coverage:**
- Decision 1 (no account/sharding) → no code; recorded in plan intro. ✓
- Decision 2 (invisible by design) → no code (absence of delegation); recorded in plan intro. ✓
- Decision 3 (at-a-glance only; alerting deferred) → card built (Tasks 5–6); zero alerting tasks; Task 7 Step 4 asserts no alerting code added. ✓
- Decision 4 (4-bucket, 14-day cutoff, catch-all) → Task 2 classifier + boundary/anomaly tests. ✓
- Rollup card (counts, lists, default expand/collapse, last sweep, row→modal) → Tasks 5–6. ✓
- Data source (extend summary API, cohort filter, no new tables/Google/quota) → Task 3; Task 7 Step 4 verifies. ✓
- `propertyHeadroom` (pending confirmation, cuttable) → Task 4, isolated and explicitly skippable. ✓
- Constants → Task 1 (+ Task 4 for property constants, kept with the optional work so skipping leaves no dead code). ✓
- Falsely-passes guards on every behavioral test → present in Tasks 2/3/4/5/6. ✓
- Rollout (commits on `feature/gsc-indexing`, inert until audit runs) → branch noted; "inert until audit" is natural (everything reads as Never inspected until the daily audit populates data — itself a useful signal). ✓
**Placeholder scan:** No TBD/TODO/"add error handling"/"similar to Task N". Every code step shows complete code. ✓
**Type consistency:** `IndexBucket` union ('indexed'|'settling'|'needsAttention'|'neverInspected') is consistent across `lib/gsc-index-buckets.ts`, the route's `counts` object keys, and `CustomDomainIndexingData`. Route output keys (`active, indexed, settling, needsAttention, neverInspected, lastSweepAt, needsAttentionList, neverInspectedList`, plus optional `propertyHeadroom {ownedEstimate, cap}`) match `CustomDomainIndexingData` and the page's `SummaryData` extension exactly. List item shapes match between route and component (`needsAttentionList`: `{dealerId, customDomain, indexStatus, submittedAt, inspectedAt}`; `neverInspectedList`: `{dealerId, customDomain}`). `DealerDetailModal` is invoked with exactly its real props `{ isOpen, onClose, dealerId }` (verified against `components/admin/DealerDetailModal.tsx` and the existing call site in `components/admin/DealerTable.tsx`). ✓