RankFlow AI — Citation Network Test Specification

Version: 1.0.0
Date: 2026-06-13
Scope: Network Architecture, Directory Registry, Submission Engine, NAP Monitoring, Owned Blog Sites, Success Metrics
Target: 80% citation success rate, 95% NAP consistency
Source Spec: docs/specs/citation-network.md

---

1. Mock Factories#

1.1 Citation Directory Factory (30 Directories)#

// src/__tests__/factories/citation-directory.ts
import { faker } from "@faker-js/faker";

export const createMockCitationDirectory = (overrides?: Partial<CitationDirectory>) => ({
  id: `dir_${faker.string.nanoid(8)}`,
  name: faker.internet.domainWord(),
  displayName: faker.company.name(),
  domain: faker.internet.domainName(),
  category: faker.helpers.arrayElement(["medical", "general", "local", "maps"]),
  authorityScore: faker.number.int({ min: 20, max: 90 }),
  isActive: true,
  requiresCaptcha: faker.datatype.boolean(),
  requiresPhoneVerify: faker.datatype.boolean(),
  submissionType: faker.helpers.arrayElement(["API", "FORM", "EMAIL"]),
  signupFlow: { steps: [] },
  submissionFields: [],
  rateLimit: {},
  successPatterns: [],
  failurePatterns: [],
  createdAt: new Date(),
  updatedAt: new Date(),
  ...overrides,
});

export const MOCK_CITATION_DIRECTORIES: CitationDirectory[] = [
  // India-specific directories (10)
  { ...createMockCitationDirectory(), name: "justdial", displayName: "Justdial", domain: "justdial.com", category: "medical", submissionType: "FORM", requiresCaptcha: true, requiresPhoneVerify: true },
  { ...createMockCitationDirectory(), name: "practo", displayName: "Practo", domain: "practo.com", category: "medical", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "sulekha", displayName: "Sulekha", domain: "sulekha.com", category: "general", submissionType: "FORM", requiresCaptcha: true, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "lybrate", displayName: "Lybrate", domain: "lybrate.com", category: "medical", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: true },
  { ...createMockCitationDirectory(), name: "1mg", displayName: "1mg", domain: "1mg.com", category: "medical", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "indiamart", displayName: "IndiaMART", domain: "indiamart.com", category: "general", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "medindia", displayName: "Medindia", domain: "medindia.net", category: "medical", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "doctoralia", displayName: "Doctoralia India", domain: "doctoralia.in", category: "medical", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: true },
  { ...createMockCitationDirectory(), name: "clinicspots", displayName: "ClinicSpots", domain: "clinicspots.com", category: "medical", submissionType: "FORM", requiresCaptcha: true, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "sehat", displayName: "Sehat", domain: "sehat.com", category: "medical", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },

  // General directories (10)
  { ...createMockCitationDirectory(), name: "yelp", displayName: "Yelp", domain: "yelp.com", category: "general", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "foursquare", displayName: "Foursquare", domain: "foursquare.com", category: "general", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "hotfrog", displayName: "Hotfrog", domain: "hotfrog.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "brownbook", displayName: "Brownbook", domain: "brownbook.net", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "cylex", displayName: "Cylex", domain: "cylex.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "ezlocal", displayName: "EZlocal", domain: "ezlocal.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "merchantcircle", displayName: "MerchantCircle", domain: "merchantcircle.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: true },
  { ...createMockCitationDirectory(), name: "citysquares", displayName: "CitySquares", domain: "citysquares.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "yalwa", displayName: "Yalwa", domain: "yalwa.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "tupalo", displayName: "Tupalo", domain: "tupalo.com", category: "general", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },

  // Global maps / directories (5)
  { ...createMockCitationDirectory(), name: "bing-places", displayName: "Bing Places", domain: "bingplaces.com", category: "maps", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "apple-maps", displayName: "Apple Maps", domain: "maps.apple.com", category: "maps", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: true },
  { ...createMockCitationDirectory(), name: "tomtom", displayName: "TomTom", domain: "tomtom.com", category: "maps", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "here", displayName: "HERE WeGo", domain: "here.com", category: "maps", submissionType: "API", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "mapquest", displayName: "MapQuest", domain: "mapquest.com", category: "maps", submissionType: "FORM", requiresCaptcha: false, requiresPhoneVerify: false },

  // Owned blog pages (5)
  { ...createMockCitationDirectory(), name: "kerala-health", displayName: "Kerala Health", domain: "kerala-health.rankflow.in", category: "local", submissionType: "OWNED_BLOG", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "medical-guide", displayName: "Medical Guide", domain: "medical-guide.rankflow.in", category: "local", submissionType: "OWNED_BLOG", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "health-tips", displayName: "Health Tips", domain: "health-tips.rankflow.in", category: "local", submissionType: "OWNED_BLOG", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "wellness-blog", displayName: "Wellness Blog", domain: "wellness-blog.rankflow.in", category: "local", submissionType: "OWNED_BLOG", requiresCaptcha: false, requiresPhoneVerify: false },
  { ...createMockCitationDirectory(), name: "care-directory", displayName: "Care Directory", domain: "care-directory.rankflow.in", category: "local", submissionType: "OWNED_BLOG", requiresCaptcha: false, requiresPhoneVerify: false },
];

1.2 NAP Data Factory#

// src/__tests__/factories/nap-data.ts
export const createMockNAP = (overrides?: Partial<NAPData>) => ({
  name: "Dr. Smith Dental Clinic",
  address: "123 Main Street, Kochi, Kerala",
  phone: "+919876543210",
  city: "Kochi",
  email: "contact@drsmithdental.com",
  website: "https://drsmith.rankflow.in",
  category: "Dentists",
  ...overrides,
});

export const createMockNAPVariants = () => ({
  exactMatch: createMockNAP(),
  nameMismatch: createMockNAP({ name: "Dr. Smith Dental Care" }),
  addressMismatch: createMockNAP({ address: "456 Park Avenue, Kochi, Kerala" }),
  phoneMismatch: createMockNAP({ phone: "+919876543211" }),
  allMismatch: createMockNAP({ name: "Different Clinic", address: "789 Other Road", phone: "+910000000000" }),
  notFound: createMockNAP({ name: "", address: "", phone: "" }),
});

1.3 Citation Submission Result Factory#

// src/__tests__/factories/citation-submission.ts
export const createMockSubmissionResult = (overrides?: Partial<SubmissionResult>) => ({
  success: true,
  url: `https://${faker.internet.domainName()}/listing/${faker.string.nanoid(6)}`,
  screenshotUrl: `https://s3.rankflow.in/citations/${faker.string.nanoid(8)}.png`,
  error: undefined,
  requiresManual: false,
  ...overrides,
});

---

2. Network Architecture Tests#

2.1 Unit Tests#

2.2 Integration Tests#

2.3 Success Criteria (Binary)#

• ARC-01: Network contains exactly 30 directories (10 India-specific + 10 general + 5 global maps + 5 owned blogs)
• ARC-02: All directory name fields are unique, lowercase, and contain no spaces
• ARC-03: All directory submissionType values are one of: API, FORM, EMAIL, OWNED_BLOG
• ARC-04: Slug generation produces unique, URL-safe strings for all 30 directories
• ARC-05: Authority scores are integers between 0–100 for all directories

2.4 Agent Context (Pre-conditions)#

• Required DB state: citation_directories table seeded with 30 rows
• Required env vars: DATABASE_URL
• Required external mocks: None (pure DB query)

---

3. Directory Registry Tests#

3.1 Unit Tests#

3.2 Integration Tests#

3.3 Success Criteria (Binary)#

• REG-01: name field is unique across all 30 directories (DB constraint enforced)
• REG-02: submissionType is one of API, FORM, EMAIL, OWNED_BLOG for all directories
• REG-03: All FORM directories have non-empty submissionFields with valid selectors
• REG-04: All API directories have valid apiEndpoint defined in config
• REG-05: isActive false excludes directory from submission queue
• REG-06: JSON fields (signupFlow, submissionFields, rateLimit) parse without error

3.4 Agent Context (Pre-conditions)#

• Required DB state: citation_directories table with schema migrated
• Required env vars: DATABASE_URL
• Required external mocks: None

---

4. Submission Engine Tests#

4.1 Unit Tests#

4.2 Integration Tests#

4.3 E2E Tests#

4.4 Success Criteria (Binary)#

• SUB-01: Submitter factory returns correct submitter type for API, FORM, EMAIL, OWNED_BLOG
• SUB-02: API submitter includes Authorization: Bearer header with correct credentials
• SUB-03: FORM submitter creates browser session, fills all fields, handles CAPTCHA, captures screenshot
• SUB-04: FORM submitter returns requiresManual: true on timeout or unhandled CAPTCHA
• SUB-05: Owned blog submitter creates BlogSitePost with unique slug, correct NAP, LocalBusiness schema
• SUB-06: Description generation produces 30 unique descriptions, no duplicates, all ≤ 500 chars
• SUB-07: Concurrent submission respects concurrency limit (default: 3)
• SUB-08: Partial failure is handled gracefully — success results stored, failures retried
• SUB-09: Overall citation success rate ≥ 80% (24/30 submissions succeed)
• SUB-10: Rate limits are respected per directory (no 429 errors from real APIs in tests)

4.5 Agent Context (Pre-conditions)#

• Required DB state: practice, location, citation_directories (30 rows), citation (empty or with test data)
• Required env vars: DATABASE_URL, HYPERBROWSER_API_KEY, S3_BUCKET, FIRECRAWL_API_KEY
• Required external mocks: MSW handlers for Practo API, Yelp API, IndiaMART API, S3 upload, Hyperbrowser sessions
• Required Inngest: INNGEST_EVENT_KEY for workflow triggering

---

5. NAP Monitoring Tests#

5.1 Unit Tests#

5.2 Integration Tests#

5.3 E2E Tests#

5.4 Success Criteria (Binary)#

• NAP-01: fuzzyMatch returns true for exact strings, case-insensitive, and punctuation-different strings
• NAP-02: normalizePhone strips all non-digit characters consistently
• NAP-03: Phone match uses normalized comparison, not raw string equality
• NAP-04: MATCHED status requires all three fields (name, address, phone) to match
• NAP-05: MISMATCH_NAME triggered when name differs but address and phone match
• NAP-06: MISMATCH_ADDRESS triggered when address differs but name and phone match
• NAP-07: MISMATCH_PHONE triggered when phone differs but name and address match
• NAP-08: MISMATCH_ALL triggered when all three fields differ
• NAP-09: NOT_FOUND triggered when scraped page contains no business name
• NAP-10: Monthly NAP check job processes all SUBMITTED and VERIFIED citations
• NAP-11: Email alert sent when ≥1 mismatches detected in monthly check
• NAP-12: No email sent when zero mismatches detected
• NAP-13: DB updated with matchStatus, lastScannedAt, scanResult after every check
• NAP-14: NAP consistency rate ≥ 95% (MATCHED / total live citations)

5.5 Agent Context (Pre-conditions)#

• Required DB state: citation table with SUBMITTED/VERIFIED records, napSnapshot populated
• Required env vars: DATABASE_URL, FIRECRAWL_API_KEY, RESEND_API_KEY
• Required external mocks: MSW handlers for Firecrawl scrape, Resend email API
• Required job queue: BullMQ processor nap-check registered

---

6. Owned Blog Sites Tests#

6.1 Unit Tests#

6.2 Integration Tests#

6.3 Success Criteria (Binary)#

• OWN-01: OwnedBlogSite created with unique domain, authorityScore default 0
• OWN-02: BlogSitePost slug unique per blog site (@@unique([blogSiteId, slug]))
• OWN-03: Blog post status transitions: DRAFT → PUBLISHED (with publishedAt) or FAILED (with failedReason)
• OWN-04: Published page contains valid LocalBusiness JSON-LD schema with correct NAP
• OWN-05: Published page contains do-follow backlink to practice website
• OWN-06: Blog post description is unique per practice per blog site (no duplicate content across 5 owned blogs)
• OWN-07: SEO fields (seoTitle, seoDescription, focusKeywords) populated for every published post
• OWN-08: Owned blog submission success rate = 99% (direct DB insert, no external dependencies)
• OWN-09: ISR re-render triggered automatically on publish
• OWN-10: postCount and authorityScore updated after each publish

6.4 Agent Context (Pre-conditions)#

• Required DB state: owned_blog_sites (5 rows), blog_site_posts (empty), practice, location
• Required env vars: DATABASE_URL, NEXT_PUBLIC_APP_URL
• Required external mocks: None for DB operations; ISR revalidation mock for publish tests
• Required file system: blog-sites/ directory for ISR revalidation output

---

7. E2E: Full Citation Flow#

7.1 Test Flow Definition#

┌─────────────────────────────────────────────────────────────┐
│          E2E Flow: Complete Citation Build (30 Sites)      │
│                                                              │
│  1. Practice Onboarding                                       │
│     └── Create practice + location with valid NAP            │
│                                                              │
│  2. Trigger Citation Builder                                  │
│     └── POST /api/inngest (skill/13-citation-submit)         │
│                                                              │
│  3. Description Generation                                    │
│     └── AI generates 30 unique descriptions                  │
│                                                              │
│  4. Parallel Submission (30 directories)                     │
│     ├── API dirs: Mocked REST calls (10)                     │
│     ├── FORM dirs: Mocked browser automation (10)            │
│     ├── MAP dirs: Mocked API calls (5)                       │
│     └── OWNED dirs: DB insert + ISR (5)                    │
│                                                              │
│  5. Result Storage                                            │
│     └── 30 Citation records in DB                          │
│                                                              │
│  6. Verification (mocked 7-day sleep)                      │
│     └── NAP check on all submitted URLs                    │
│                                                              │
│  7. Success Metrics                                           │
│     └── successRate ≥ 80%, napConsistency ≥ 95%            │
└─────────────────────────────────────────────────────────────┘

7.2 E2E Test Cases#

7.3 Success Criteria (Binary)#

• E2E-01: Full build flow completes in < 7 days (mocked) from trigger to 30 submissions
• E2E-02: 30 Citation records created in DB, all linked to correct practice + location
• E2E-03: Success rate ≥ 80% (≥24 successful submissions out of 30)
• E2E-04: NAP consistency ≥ 95% (≥95% of live citations show MATCHED)
• E2E-05: All 30 descriptions are unique (no duplicate content across directories)
• E2E-06: All FORM submissions have screenshotUrl stored in S3
• E2E-07: All OWNED_BLOG submissions have publishedUrl and valid LocalBusiness schema
• E2E-08: Failed submissions have errorMessage and requiresManual flag set correctly
• E2E-09: Retry mechanism resubmits failed citations and updates status
• E2E-10: Dashboard accurately reflects all citation statuses and NAP match states
• E2E-11: NAP mismatch alerts trigger email to admin
• E2E-12: NOT_FOUND citations trigger automatic resubmission queue

7.4 Agent Context (Pre-conditions)#

• Required DB state: Full schema migrated, practice, location, citation_directories (30), citation (empty)
• Required env vars: DATABASE_URL, INNGEST_EVENT_KEY, HYPERBROWSER_API_KEY, S3_BUCKET, FIRECRAWL_API_KEY, RESEND_API_KEY, OPENAI_API_KEY (or AI provider key)
• Required external mocks: MSW handlers for all 30 directory APIs/Forms, Firecrawl, S3, Resend, AI generation
• Required services: Inngest dev server, BullMQ worker, Next.js dev server (for E2E)
• Required test data: Valid NAP data for a dental practice in Kochi, Kerala

---

8. Success Metrics & Compliance#

8.1 Metrics Calculation Tests#

8.2 Integration Tests#

8.3 Compliance Tests#

8.4 Success Criteria (Binary)#

• MET-01: Citation success rate calculation: submitted / attempted = ratio 0.0–1.0
• MET-02: Success rate target: ≥ 80% for any practice with 30 directories attempted
• MET-03: NAP consistency rate: matched / total live = ratio 0.0–1.0
• MET-04: NAP consistency target: ≥ 95% for any practice with live citations
• MET-05: Citation uptime rate: live / total submitted = ratio 0.0–1.0
• MET-06: Citation uptime target: ≥ 95%
• MET-07: Time to 30 citations: ≤ 7 days from onboarding trigger
• MET-08: Per-directory metrics tracked: success rate, avg time, CAPTCHA rate
• MET-09: Owned blog authority score target: > 40 (tracked, not guaranteed in tests)
• MET-10: Alert triggered when success rate < 80% or NAP consistency < 95%
• COM-01: No banned medical phrases in any AI-generated citation description
• COM-02: No PII (phone, email) in error logs or unmasked stack traces
• COM-03: Consent logged for every citation submission trigger
• COM-04: DPDPA data export includes all citation records
• COM-05: DPDPA deletion cascades to citation records and triggers directory removal

---

9. Agent Context & Verification#

9.1 Agent Context (Pre-conditions) — Global#

• Required DB state: All Prisma tables migrated (citation_directories, citations, owned_blog_sites, blog_site_posts, practices, locations)
• Required env vars:
  • DATABASE_URL — PostgreSQL connection string
  • INNGEST_EVENT_KEY — Inngest event key for workflow triggering
  • INNGEST_SIGNING_KEY — Inngest signing key for function validation
  • HYPERBROWSER_API_KEY — Browser automation API key (mocked in tests)
  • S3_BUCKET — S3 bucket for screenshots (mocked in tests)
  • FIRECRAWL_API_KEY — Web scraping API key (mocked in tests)
  • RESEND_API_KEY — Email API key (mocked in tests)
  • OPENAI_API_KEY — AI generation API key (mocked in tests)
• Required external mocks (MSW handlers):
  • Practo API POST /api/listings → { listing_url: "..." }
  • Yelp API POST /v3/businesses → { id: "..." }
  • IndiaMART API POST /api/seller → { success: true }
  • Hyperbrowser session creation → { id: "session_123" }
  • Hyperbrowser navigate, fill, click, screenshot → success
  • Hyperbrowser CAPTCHA solve → success (or timeout for failure tests)
  • Firecrawl scrape → { data: { extract: { business_name, address, phone } } }
  • Firecrawl NOT_FOUND → { data: { extract: {} } }
  • S3 upload → { url: "https://s3.rankflow.in/..." }
  • Resend send → { id: "email_123" }
  • AI generate → { content: "unique description..." }
• Required test utilities:
  • prisma-test-utils for test DB transaction isolation
  • msw for HTTP mock server
  • vitest with jsdom or node environment
  • playwright for E2E browser automation
  • inngest-test-utils for workflow step mocking
• Required seed data:
  • 30 citation_directories (see Section 1.1 factory)
  • 1 practice (dental clinic in Kochi, Kerala)
  • 1 location with valid NAP (+91 phone, Indian address)
  • 5 owned_blog_sites with .rankflow.in domains

9.2 Verification Commands#

# ─────────────────────────────────────────────
# UNIT TESTS
# ─────────────────────────────────────────────

# Run all citation network unit tests
pnpm test:unit -- src/__tests__/unit/citation/

# Run specific unit test suites
pnpm test:unit -- src/__tests__/unit/citation/slug.test.ts
pnpm test:unit -- src/__tests__/unit/citation/nap-monitor.test.ts
pnpm test:unit -- src/__tests__/unit/citation/form-submitter.test.ts
pnpm test:unit -- src/__tests__/unit/citation/api-submitter.test.ts
pnpm test:unit -- src/__tests__/unit/citation/description-gen.test.ts
pnpm test:unit -- src/__tests__/unit/citation/submitter-factory.test.ts
pnpm test:unit -- src/__tests__/unit/citation/metrics.test.ts
pnpm test:unit -- src/__tests__/unit/compliance/citation-content.test.ts

# ─────────────────────────────────────────────
# INTEGRATION TESTS
# ─────────────────────────────────────────────

# Run all citation network integration tests
pnpm test:integration -- src/__tests__/integration/citation/

# Run specific integration test suites
pnpm test:integration -- src/__tests__/integration/citation/router.test.ts
pnpm test:integration -- src/__tests__/integration/citation/directory-crud.test.ts
pnpm test:integration -- src/__tests__/integration/citation/api-submitter.test.ts
pnpm test:integration -- src/__tests__/integration/citation/form-submitter.test.ts
pnpm test:integration -- src/__tests__/integration/citation/owned-blog-submitter.test.ts
pnpm test:integration -- src/__tests__/integration/citation/nap-verify.test.ts
pnpm test:integration -- src/__tests__/integration/citation/nap-check-job.test.ts
pnpm test:integration -- src/__tests__/integration/citation/submission-queue.test.ts
pnpm test:integration -- src/__tests__/integration/citation/metrics-api.test.ts

# ─────────────────────────────────────────────
# E2E TESTS
# ─────────────────────────────────────────────

# Run all citation network E2E tests
pnpm test:e2e -- e2e/citation/

# Run specific E2E flows
pnpm test:e2e -- e2e/citation/complete-build-flow.spec.ts
pnpm test:e2e -- e2e/citation/complete-build-with-retry.spec.ts
pnpm test:e2e -- e2e/citation/nap-monitoring-cycle.spec.ts
pnpm test:e2e -- e2e/citation/dashboard-citation-listing.spec.ts
pnpm test:e2e -- e2e/citation/owned-blog-submission-flow.spec.ts

# ─────────────────────────────────────────────
# CONTRACT TESTS (External API Mocks)
# ─────────────────────────────────────────────

pnpm test:contract -- src/__tests__/contract/citation/

# ─────────────────────────────────────────────
# COMPLIANCE TESTS
# ─────────────────────────────────────────────

pnpm test:unit -- src/__tests__/unit/compliance/citation-

# ─────────────────────────────────────────────
# COVERAGE REPORT
# ─────────────────────────────────────────────

pnpm test:unit --coverage -- src/__tests__/unit/citation/
pnpm test:integration --coverage -- src/__tests__/integration/citation/

# ─────────────────────────────────────────────
# FULL VERIFICATION (Pre-commit / CI)
# ─────────────────────────────────────────────

pnpm test -- --grep "citation"

9.3 VERIFY.md Template#

Every agent implementing citation network features MUST produce a VERIFY.md in the task workspace:

# Verification Report — Citation Network Task

## Task: [Feature Name]
## Agent: [Role Label]
## Date: [YYYY-MM-DD]

### Tests Run
| Test Suite | Command | Result | Evidence |
|------------|---------|--------|----------|
| Unit | `pnpm test:unit -- ...` | PASS / FAIL | [output file] |
| Integration | `pnpm test:integration -- ...` | PASS / FAIL | [output file] |
| E2E | `pnpm test:e2e -- ...` | PASS / FAIL | [output file] |

### Success Criteria
- [ ] ARC-01: Network contains exactly 30 directories
- [ ] ARC-02: All directory names are unique
- [ ] SUB-09: Citation success rate ≥ 80%
- [ ] NAP-14: NAP consistency rate ≥ 95%
- [ ] [Add relevant criteria from this spec]

### Binary Checklist
- [ ] All unit tests pass
- [ ] All integration tests pass
- [ ] All E2E tests pass (or marked as known limitation)
- [ ] No hardcoded IDs (factories used)
- [ ] All external APIs mocked with MSW
- [ ] No PII in logs or error messages
- [ ] Medical compliance checks pass

### Final Verdict
[ ] PASS — All criteria met, ready to merge
[ ] FAIL — [Explain which criteria failed and why]

---

End of Citation Network Test Specification — RankFlow AI v1.0.0