@agent-pattern-labs/leads-rig 0.1.4 → 0.1.6

package/.claude/agents/general-free.md

@@ -27,7 +27,9 @@ Skip this only if the task explicitly says to attach to an existing session.
 ## Do
 
 - Crawl only public, high-signal company pages.
-- Extract emails, role inboxes, contact forms, public names/titles, source URL, evidence, and warnings.
+- Use your judgment on each email candidate: only emit an email lead when public evidence identifies one specific human owner of the address.
+- Extract high-quality named human emails, contact forms, public names/titles, source URL, evidence, and warnings.
+- If an address is shared, role-based, departmental, generic, blocked, or not tied to a visible named human, do not emit it as an email lead; emit a `contact_path` if useful.
 - Emit JSON/JSONL matching `templates/lead-schema.json`.
 - Run `npx public-leads validate --input <file>` before returning a result.
 - Return file paths and terminal status, not a prose-only summary.

package/.codex/config.toml

@@ -1,4 +1,4 @@
-# generated by @razroo/iso-route — do not hand-edit
+# generated by @agent-pattern-labs/iso-route — do not hand-edit
 model = "gpt-5.4"
 model_provider = "openai"
 

package/.cursor/rules/agent-general-free.mdc

@@ -26,7 +26,9 @@ Skip this only if the task explicitly says to attach to an existing session.
 ## Do
 
 - Crawl only public, high-signal company pages.
-- Extract emails, role inboxes, contact forms, public names/titles, source URL, evidence, and warnings.
+- Use your judgment on each email candidate: only emit an email lead when public evidence identifies one specific human owner of the address.
+- Extract high-quality named human emails, contact forms, public names/titles, source URL, evidence, and warnings.
+- If an address is shared, role-based, departmental, generic, blocked, or not tied to a visible named human, do not emit it as an email lead; emit a `contact_path` if useful.
 - Emit JSON/JSONL matching `templates/lead-schema.json`.
 - Run `npx public-leads validate --input <file>` before returning a result.
 - Return file paths and terminal status, not a prose-only summary.

package/.cursor/rules/main.mdc

@@ -9,7 +9,8 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 
 ## Hard Limits
 
-- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt.
+- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt. The primary goal is named people, not generic company inboxes.
+- [H8] Apply coding-agent judgment to every email candidate. An email may pass only when public source evidence identifies one specific human owner of that email. Shared, role, departmental, generic, blocked, unknown-owner, or unnamed person-like emails must not be emitted as email leads.
 - [H2] Respect robots.txt, terms, rate limits, and site intent. If a page blocks crawling or is not public, record a warning and move on.
 - [H3] Never send outreach from this harness. The output is reviewable lead records and ingest-ready artifacts, not email campaigns.
 - [H4] Use file-backed artifacts before ingest. A subagent prose summary is not enough; write validated JSON/JSONL first, then ingest.
@@ -23,7 +24,7 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 - [D2] Use deterministic local helpers when they can validate, normalize, manifest, preflight, postflight, or ingest artifacts.
 - [D3] Read the active mode file before executing. Mode files own output shapes and gates.
 - [D4] Prefer official company websites and high-signal pages: home, contact, about, team, leadership, people, press, blog, careers, and legal pages.
-- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`.
+- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`. Reject generic catch-all inboxes such as `info@`, `hello@`, `contact@`, `support@`, `team@`, and similar aliases; if no named human email is available, prefer a `contact_path` record instead.
 
 ## Procedure
 

package/.opencode/agents/general-free.md

@@ -36,7 +36,9 @@ Skip this only if the task explicitly says to attach to an existing session.
 ## Do
 
 - Crawl only public, high-signal company pages.
-- Extract emails, role inboxes, contact forms, public names/titles, source URL, evidence, and warnings.
+- Use your judgment on each email candidate: only emit an email lead when public evidence identifies one specific human owner of the address.
+- Extract high-quality named human emails, contact forms, public names/titles, source URL, evidence, and warnings.
+- If an address is shared, role-based, departmental, generic, blocked, or not tied to a visible named human, do not emit it as an email lead; emit a `contact_path` if useful.
 - Emit JSON/JSONL matching `templates/lead-schema.json`.
 - Run `npx public-leads validate --input <file>` before returning a result.
 - Return file paths and terminal status, not a prose-only summary.

package/.pi/skills/general-free/SKILL.md

@@ -26,7 +26,9 @@ Skip this only if the task explicitly says to attach to an existing session.
 ## Do
 
 - Crawl only public, high-signal company pages.
-- Extract emails, role inboxes, contact forms, public names/titles, source URL, evidence, and warnings.
+- Use your judgment on each email candidate: only emit an email lead when public evidence identifies one specific human owner of the address.
+- Extract high-quality named human emails, contact forms, public names/titles, source URL, evidence, and warnings.
+- If an address is shared, role-based, departmental, generic, blocked, or not tied to a visible named human, do not emit it as an email lead; emit a `contact_path` if useful.
 - Emit JSON/JSONL matching `templates/lead-schema.json`.
 - Run `npx public-leads validate --input <file>` before returning a result.
 - Return file paths and terminal status, not a prose-only summary.

package/AGENTS.md

@@ -4,7 +4,8 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 
 ## Hard Limits
 
-- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt.
+- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt. The primary goal is named people, not generic company inboxes.
+- [H8] Apply coding-agent judgment to every email candidate. An email may pass only when public source evidence identifies one specific human owner of that email. Shared, role, departmental, generic, blocked, unknown-owner, or unnamed person-like emails must not be emitted as email leads.
 - [H2] Respect robots.txt, terms, rate limits, and site intent. If a page blocks crawling or is not public, record a warning and move on.
 - [H3] Never send outreach from this harness. The output is reviewable lead records and ingest-ready artifacts, not email campaigns.
 - [H4] Use file-backed artifacts before ingest. A subagent prose summary is not enough; write validated JSON/JSONL first, then ingest.
@@ -18,7 +19,7 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 - [D2] Use deterministic local helpers when they can validate, normalize, manifest, preflight, postflight, or ingest artifacts.
 - [D3] Read the active mode file before executing. Mode files own output shapes and gates.
 - [D4] Prefer official company websites and high-signal pages: home, contact, about, team, leadership, people, press, blog, careers, and legal pages.
-- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`.
+- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`. Reject generic catch-all inboxes such as `info@`, `hello@`, `contact@`, `support@`, `team@`, and similar aliases; if no named human email is available, prefer a `contact_path` record instead.
 
 ## Procedure
 

package/CLAUDE.md

@@ -4,7 +4,8 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 
 ## Hard Limits
 
-- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt.
+- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt. The primary goal is named people, not generic company inboxes.
+- [H8] Apply coding-agent judgment to every email candidate. An email may pass only when public source evidence identifies one specific human owner of that email. Shared, role, departmental, generic, blocked, unknown-owner, or unnamed person-like emails must not be emitted as email leads.
 - [H2] Respect robots.txt, terms, rate limits, and site intent. If a page blocks crawling or is not public, record a warning and move on.
 - [H3] Never send outreach from this harness. The output is reviewable lead records and ingest-ready artifacts, not email campaigns.
 - [H4] Use file-backed artifacts before ingest. A subagent prose summary is not enough; write validated JSON/JSONL first, then ingest.
@@ -18,7 +19,7 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 - [D2] Use deterministic local helpers when they can validate, normalize, manifest, preflight, postflight, or ingest artifacts.
 - [D3] Read the active mode file before executing. Mode files own output shapes and gates.
 - [D4] Prefer official company websites and high-signal pages: home, contact, about, team, leadership, people, press, blog, careers, and legal pages.
-- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`.
+- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`. Reject generic catch-all inboxes such as `info@`, `hello@`, `contact@`, `support@`, `team@`, and similar aliases; if no named human email is available, prefer a `contact_path` record instead.
 
 ## Procedure
 

package/README.md

@@ -6,11 +6,14 @@ Agentic public-web lead discovery harness for portable, source-backed lead artif
 
 - Crawls public company websites through agent workflows.
 - Produces source-backed lead artifacts matching the local lead-ingest contract.
-- Validates lead JSON/JSONL before database handoff.
+- Validates lead JSON/JSONL before database handoff and rejects generic catch-all inboxes such as `info@` and `hello@`.
 - Builds a local manifest for batch auditability.
 - Submits validated payloads to a configured ingest API.
 - Ships OpenCode, Claude Code, Cursor, Codex, and Pi harness config from one `iso/` source.
 
+The harness is optimized to find named people who can actually be contacted. When only a general company contact path exists, it should emit a `contact_path` record rather than a generic organizational inbox.
+CLI summaries distinguish total reviewable records from `goodLeads`; only non-generic `person` email records with a named human owner visible in the evidence count as good leads. Role, shared, departmental, unknown-owner, blocked, unsupported, or unnamed person-like emails are rejected by validation.
+
 ## Core Commands
 
 ```bash
@@ -68,7 +71,7 @@ gh run watch
 You can also publish by creating a GitHub release for the package version:
 
 ```bash
-gh release create v0.1.4 --title v0.1.4 --generate-notes
+gh release create v0.1.6 --title v0.1.6 --generate-notes
 ```
 
 The package version must not already exist on npm.

package/bin/create-leads-harness.mjs

@@ -51,7 +51,7 @@ write('package.json', JSON.stringify({
     'update-harness': 'npm install @agent-pattern-labs/leads-rig@latest && public-leads sync',
   },
   dependencies: {
-    '@agent-pattern-labs/leads-rig': '^0.1.4',
+    '@agent-pattern-labs/leads-rig': '^0.1.6',
   },
   engines: {
     node: '>=20.6.0',

package/bin/lead-harness.mjs

@@ -23,80 +23,80 @@ const commands = {
 };
 
 const helperAliases = {
-  'trace:list': ['@razroo/iso-trace', 'list'],
-  'trace:stats': ['@razroo/iso-trace', 'stats'],
-  'trace:show': ['@razroo/iso-trace', 'show'],
-  'guard:audit': ['@razroo/iso-guard', 'audit'],
-  'guard:explain': ['@razroo/iso-guard', 'explain'],
-  'ledger:status': ['@razroo/iso-ledger', 'status'],
-  'ledger:rebuild': ['@razroo/iso-ledger', 'rebuild'],
-  'ledger:verify': ['@razroo/iso-ledger', 'verify'],
-  'capabilities:list': ['@razroo/iso-capabilities', 'list'],
-  'capabilities:explain': ['@razroo/iso-capabilities', 'explain'],
-  'capabilities:check': ['@razroo/iso-capabilities', 'check'],
-  'context:list': ['@razroo/iso-context', 'list'],
-  'context:explain': ['@razroo/iso-context', 'explain'],
-  'context:plan': ['@razroo/iso-context', 'plan'],
-  'context:check': ['@razroo/iso-context', 'check'],
-  'context:render': ['@razroo/iso-context', 'render'],
-  'cache:key': ['@razroo/iso-cache', 'key'],
-  'cache:has': ['@razroo/iso-cache', 'has'],
-  'cache:get': ['@razroo/iso-cache', 'get'],
-  'cache:put': ['@razroo/iso-cache', 'put'],
-  'cache:status': ['@razroo/iso-cache', 'status'],
-  'cache:list': ['@razroo/iso-cache', 'list'],
-  'cache:verify': ['@razroo/iso-cache', 'verify'],
-  'cache:prune': ['@razroo/iso-cache', 'prune'],
-  'index:build': ['@razroo/iso-index', 'build'],
-  'index:status': ['@razroo/iso-index', 'status'],
-  'index:query': ['@razroo/iso-index', 'query'],
-  'index:has': ['@razroo/iso-index', 'has'],
-  'index:verify': ['@razroo/iso-index', 'verify'],
-  'facts:build': ['@razroo/iso-facts', 'build'],
-  'facts:status': ['@razroo/iso-facts', 'status'],
-  'facts:query': ['@razroo/iso-facts', 'query'],
-  'facts:has': ['@razroo/iso-facts', 'has'],
-  'facts:verify': ['@razroo/iso-facts', 'verify'],
-  'score:compute': ['@razroo/iso-score', 'compute'],
-  'score:verify': ['@razroo/iso-score', 'verify'],
-  'score:check': ['@razroo/iso-score', 'check'],
-  'score:gate': ['@razroo/iso-score', 'gate'],
-  'score:compare': ['@razroo/iso-score', 'compare'],
-  'score:explain': ['@razroo/iso-score', 'explain'],
-  'canon:normalize': ['@razroo/iso-canon', 'normalize'],
-  'canon:key': ['@razroo/iso-canon', 'key'],
-  'canon:compare': ['@razroo/iso-canon', 'compare'],
-  'canon:explain': ['@razroo/iso-canon', 'explain'],
-  'preflight:plan': ['@razroo/iso-preflight', 'plan'],
-  'preflight:check': ['@razroo/iso-preflight', 'check'],
-  'preflight:explain': ['@razroo/iso-preflight', 'explain'],
-  'postflight:status': ['@razroo/iso-postflight', 'status'],
-  'postflight:check': ['@razroo/iso-postflight', 'check'],
-  'postflight:explain': ['@razroo/iso-postflight', 'explain'],
-  'timeline:status': ['@razroo/iso-timeline', 'status'],
-  'timeline:build': ['@razroo/iso-timeline', 'build'],
-  'timeline:plan': ['@razroo/iso-timeline', 'plan'],
-  'timeline:due': ['@razroo/iso-timeline', 'due'],
-  'timeline:check': ['@razroo/iso-timeline', 'check'],
-  'timeline:verify': ['@razroo/iso-timeline', 'verify'],
-  'prioritize:status': ['@razroo/iso-prioritize', 'status'],
-  'prioritize:items': ['@razroo/iso-prioritize', 'items'],
-  'prioritize:build': ['@razroo/iso-prioritize', 'build'],
-  'prioritize:rank': ['@razroo/iso-prioritize', 'rank'],
-  'prioritize:select': ['@razroo/iso-prioritize', 'select'],
-  'prioritize:check': ['@razroo/iso-prioritize', 'check'],
-  'prioritize:verify': ['@razroo/iso-prioritize', 'verify'],
-  'lineage:status': ['@razroo/iso-lineage', 'status'],
-  'lineage:record': ['@razroo/iso-lineage', 'record'],
-  'lineage:check': ['@razroo/iso-lineage', 'check'],
-  'lineage:stale': ['@razroo/iso-lineage', 'stale'],
-  'lineage:verify': ['@razroo/iso-lineage', 'verify'],
-  'redact:scan': ['@razroo/iso-redact', 'scan'],
-  'redact:verify': ['@razroo/iso-redact', 'verify'],
-  'redact:apply': ['@razroo/iso-redact', 'apply'],
-  'migrate:plan': ['@razroo/iso-migrate', 'plan'],
-  'migrate:apply': ['@razroo/iso-migrate', 'apply'],
-  'migrate:check': ['@razroo/iso-migrate', 'check'],
+  'trace:list': ['@agent-pattern-labs/iso-trace', 'list'],
+  'trace:stats': ['@agent-pattern-labs/iso-trace', 'stats'],
+  'trace:show': ['@agent-pattern-labs/iso-trace', 'show'],
+  'guard:audit': ['@agent-pattern-labs/iso-guard', 'audit'],
+  'guard:explain': ['@agent-pattern-labs/iso-guard', 'explain'],
+  'ledger:status': ['@agent-pattern-labs/iso-ledger', 'status'],
+  'ledger:rebuild': ['@agent-pattern-labs/iso-ledger', 'rebuild'],
+  'ledger:verify': ['@agent-pattern-labs/iso-ledger', 'verify'],
+  'capabilities:list': ['@agent-pattern-labs/iso-capabilities', 'list'],
+  'capabilities:explain': ['@agent-pattern-labs/iso-capabilities', 'explain'],
+  'capabilities:check': ['@agent-pattern-labs/iso-capabilities', 'check'],
+  'context:list': ['@agent-pattern-labs/iso-context', 'list'],
+  'context:explain': ['@agent-pattern-labs/iso-context', 'explain'],
+  'context:plan': ['@agent-pattern-labs/iso-context', 'plan'],
+  'context:check': ['@agent-pattern-labs/iso-context', 'check'],
+  'context:render': ['@agent-pattern-labs/iso-context', 'render'],
+  'cache:key': ['@agent-pattern-labs/iso-cache', 'key'],
+  'cache:has': ['@agent-pattern-labs/iso-cache', 'has'],
+  'cache:get': ['@agent-pattern-labs/iso-cache', 'get'],
+  'cache:put': ['@agent-pattern-labs/iso-cache', 'put'],
+  'cache:status': ['@agent-pattern-labs/iso-cache', 'status'],
+  'cache:list': ['@agent-pattern-labs/iso-cache', 'list'],
+  'cache:verify': ['@agent-pattern-labs/iso-cache', 'verify'],
+  'cache:prune': ['@agent-pattern-labs/iso-cache', 'prune'],
+  'index:build': ['@agent-pattern-labs/iso-index', 'build'],
+  'index:status': ['@agent-pattern-labs/iso-index', 'status'],
+  'index:query': ['@agent-pattern-labs/iso-index', 'query'],
+  'index:has': ['@agent-pattern-labs/iso-index', 'has'],
+  'index:verify': ['@agent-pattern-labs/iso-index', 'verify'],
+  'facts:build': ['@agent-pattern-labs/iso-facts', 'build'],
+  'facts:status': ['@agent-pattern-labs/iso-facts', 'status'],
+  'facts:query': ['@agent-pattern-labs/iso-facts', 'query'],
+  'facts:has': ['@agent-pattern-labs/iso-facts', 'has'],
+  'facts:verify': ['@agent-pattern-labs/iso-facts', 'verify'],
+  'score:compute': ['@agent-pattern-labs/iso-score', 'compute'],
+  'score:verify': ['@agent-pattern-labs/iso-score', 'verify'],
+  'score:check': ['@agent-pattern-labs/iso-score', 'check'],
+  'score:gate': ['@agent-pattern-labs/iso-score', 'gate'],
+  'score:compare': ['@agent-pattern-labs/iso-score', 'compare'],
+  'score:explain': ['@agent-pattern-labs/iso-score', 'explain'],
+  'canon:normalize': ['@agent-pattern-labs/iso-canon', 'normalize'],
+  'canon:key': ['@agent-pattern-labs/iso-canon', 'key'],
+  'canon:compare': ['@agent-pattern-labs/iso-canon', 'compare'],
+  'canon:explain': ['@agent-pattern-labs/iso-canon', 'explain'],
+  'preflight:plan': ['@agent-pattern-labs/iso-preflight', 'plan'],
+  'preflight:check': ['@agent-pattern-labs/iso-preflight', 'check'],
+  'preflight:explain': ['@agent-pattern-labs/iso-preflight', 'explain'],
+  'postflight:status': ['@agent-pattern-labs/iso-postflight', 'status'],
+  'postflight:check': ['@agent-pattern-labs/iso-postflight', 'check'],
+  'postflight:explain': ['@agent-pattern-labs/iso-postflight', 'explain'],
+  'timeline:status': ['@agent-pattern-labs/iso-timeline', 'status'],
+  'timeline:build': ['@agent-pattern-labs/iso-timeline', 'build'],
+  'timeline:plan': ['@agent-pattern-labs/iso-timeline', 'plan'],
+  'timeline:due': ['@agent-pattern-labs/iso-timeline', 'due'],
+  'timeline:check': ['@agent-pattern-labs/iso-timeline', 'check'],
+  'timeline:verify': ['@agent-pattern-labs/iso-timeline', 'verify'],
+  'prioritize:status': ['@agent-pattern-labs/iso-prioritize', 'status'],
+  'prioritize:items': ['@agent-pattern-labs/iso-prioritize', 'items'],
+  'prioritize:build': ['@agent-pattern-labs/iso-prioritize', 'build'],
+  'prioritize:rank': ['@agent-pattern-labs/iso-prioritize', 'rank'],
+  'prioritize:select': ['@agent-pattern-labs/iso-prioritize', 'select'],
+  'prioritize:check': ['@agent-pattern-labs/iso-prioritize', 'check'],
+  'prioritize:verify': ['@agent-pattern-labs/iso-prioritize', 'verify'],
+  'lineage:status': ['@agent-pattern-labs/iso-lineage', 'status'],
+  'lineage:record': ['@agent-pattern-labs/iso-lineage', 'record'],
+  'lineage:check': ['@agent-pattern-labs/iso-lineage', 'check'],
+  'lineage:stale': ['@agent-pattern-labs/iso-lineage', 'stale'],
+  'lineage:verify': ['@agent-pattern-labs/iso-lineage', 'verify'],
+  'redact:scan': ['@agent-pattern-labs/iso-redact', 'scan'],
+  'redact:verify': ['@agent-pattern-labs/iso-redact', 'verify'],
+  'redact:apply': ['@agent-pattern-labs/iso-redact', 'apply'],
+  'migrate:plan': ['@agent-pattern-labs/iso-migrate', 'plan'],
+  'migrate:apply': ['@agent-pattern-labs/iso-migrate', 'apply'],
+  'migrate:check': ['@agent-pattern-labs/iso-migrate', 'check'],
 };
 
 const [, , cmd, ...rest] = process.argv;
@@ -161,7 +161,7 @@ function runIsoCli(pkgName, args) {
 
 function defaultIsoArgs(pkgName, subcommand, args) {
   const defaults = [];
-  if (pkgName === '@razroo/iso-trace') {
+  if (pkgName === '@agent-pattern-labs/iso-trace') {
     if (!hasFlag(args, '--cwd')) defaults.push('--cwd', PROJECT_DIR);
     if ((subcommand === 'list' || subcommand === 'stats') && !hasFlag(args, '--since')) {
       defaults.push('--since', '7d');

package/docs/ARCHITECTURE.md

@@ -68,10 +68,10 @@ domain input
 | `scripts/validate-leads.mjs` | Normalizes and validates JSON/JSONL lead artifacts |
 | `scripts/manifest.mjs` | Records validated batches in `data/lead-manifest.json` |
 | `scripts/ingest.mjs` | Posts to the configured ingest endpoint |
-| `scripts/batch-orchestrator.mjs` | Durable batch runner using `@razroo/iso-orchestrator` |
+| `scripts/batch-orchestrator.mjs` | Durable batch runner using `@agent-pattern-labs/iso-orchestrator` |
 | `verify-pipeline.mjs` | Repo/consumer health gate |
 
-The package also carries the `@razroo/iso-*` helper ecosystem for trace, guard, ledger, cache, canon, context, preflight, postflight, prioritize, lineage, redact, migrate, score, and timeline commands.
+The package also carries the `@agent-pattern-labs/iso-*` helper ecosystem for trace, guard, ledger, cache, canon, context, preflight, postflight, prioritize, lineage, redact, migrate, score, and timeline commands.
 
 ## Data Contract
 
@@ -82,4 +82,4 @@ The package also carries the `@razroo/iso-*` helper ecosystem for trace, guard,
 - page visits
 - ingest requests
 
-The validator intentionally accepts the same defaults the local runtime normalizes, but it fails missing source evidence, invalid URL fields, invalid `emailType`, invalid `verificationStatus`, invalid confidence, and person/role leads without email.
+The validator intentionally accepts the same defaults the local runtime normalizes, but it fails missing source evidence, invalid URL fields, invalid `emailType`, invalid `verificationStatus`, invalid confidence, person leads without email, and generic catch-all inboxes such as `info@`, `hello@`, or similar organizational aliases. Any email record must be a named `person` lead with a non-generic email and a human owner visible in the evidence; role inboxes, unknown-owner emails, blocked emails, unsupported emails, and unnamed person-like emails fail validation. Summaries expose `goodLeadCount`, which only counts those high-quality named human email records.

package/docs/CONSTRUCTION.md

@@ -14,7 +14,7 @@
 | Deterministic helpers | `scripts/crawl.mjs`, `scripts/pipeline.mjs`, `scripts/validate-leads.mjs`, `scripts/manifest.mjs`, `scripts/ingest.mjs`, `scripts/batch-orchestrator.mjs` |
 | Consumer scaffold | `create-public-leads-harness <dir>` writes local config, input, output, and ignore files |
 | Consumer sync | `public-leads sync` symlinks shared harness files from the installed package |
-| Batch orchestration | `batch/batch-runner.sh` delegates to `@razroo/iso-orchestrator` with bounded parallelism |
+| Batch orchestration | `batch/batch-runner.sh` delegates to `@agent-pattern-labs/iso-orchestrator` with bounded parallelism |
 | Verification gates | `npm run verify`, `npm run smoke:iso`, sample validate/manifest/ingest, `npm pack` |
 
 ## Maintainer Rules
@@ -37,4 +37,4 @@
 6. Run `npm audit`.
 7. Run `npm pack` and confirm generated runtime surfaces are included.
 8. Scaffold a clean consumer project and test install-time sync from the packed package or source tree.
-9. Publish through GitHub Actions with `gh workflow run publish.yml --ref main`, or create a published release with `gh release create v0.1.4 --title v0.1.4 --generate-notes`.
+9. Publish through GitHub Actions with `gh workflow run publish.yml --ref main`, or create a published release with `gh release create v0.1.6 --title v0.1.6 --generate-notes`.

package/iso/agents/general-free.md

@@ -38,7 +38,9 @@ Skip this only if the task explicitly says to attach to an existing session.
 ## Do
 
 - Crawl only public, high-signal company pages.
-- Extract emails, role inboxes, contact forms, public names/titles, source URL, evidence, and warnings.
+- Use your judgment on each email candidate: only emit an email lead when public evidence identifies one specific human owner of the address.
+- Extract high-quality named human emails, contact forms, public names/titles, source URL, evidence, and warnings.
+- If an address is shared, role-based, departmental, generic, blocked, or not tied to a visible named human, do not emit it as an email lead; emit a `contact_path` if useful.
 - Emit JSON/JSONL matching `templates/lead-schema.json`.
 - Run `npx public-leads validate --input <file>` before returning a result.
 - Return file paths and terminal status, not a prose-only summary.

package/iso/instructions.md

@@ -4,7 +4,8 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 
 ## Hard Limits
 
-- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt.
+- [H1] Only collect public-source business contact data. Do not infer, guess, brute-force, or enrich private email addresses. Every lead needs a source URL and evidence excerpt. The primary goal is named people, not generic company inboxes.
+- [H8] Apply coding-agent judgment to every email candidate. An email may pass only when public source evidence identifies one specific human owner of that email. Shared, role, departmental, generic, blocked, unknown-owner, or unnamed person-like emails must not be emitted as email leads.
 - [H2] Respect robots.txt, terms, rate limits, and site intent. If a page blocks crawling or is not public, record a warning and move on.
 - [H3] Never send outreach from this harness. The output is reviewable lead records and ingest-ready artifacts, not email campaigns.
 - [H4] Use file-backed artifacts before ingest. A subagent prose summary is not enough; write validated JSON/JSONL first, then ingest.
@@ -18,7 +19,7 @@ Agentic public-web lead discovery harness. It crawls company domains, extracts r
 - [D2] Use deterministic local helpers when they can validate, normalize, manifest, preflight, postflight, or ingest artifacts.
 - [D3] Read the active mode file before executing. Mode files own output shapes and gates.
 - [D4] Prefer official company websites and high-signal pages: home, contact, about, team, leadership, people, press, blog, careers, and legal pages.
-- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`.
+- [D5] Keep artifacts source-backed. Every emitted lead should include `domain`, `sourceUrl`, `evidence`, `emailType`, `extractionMethod`, `verificationStatus`, and `confidence`. Reject generic catch-all inboxes such as `info@`, `hello@`, `contact@`, `support@`, `team@`, and similar aliases; if no named human email is available, prefer a `contact_path` record instead.
 
 ## Procedure
 

package/lib/leadharness-crawler.mjs

@@ -1,7 +1,7 @@
 import { createHash } from 'crypto';
 import { lookup, resolveMx } from 'dns/promises';
 import { setTimeout as sleep } from 'timers/promises';
-import { cleanDomains, dedupeLeadRecords, mergeLeadRecords, normalizeDomain } from './leadharness-leads.mjs';
+import { cleanDomains, dedupeLeadRecords, isGoodLead, isRejectedLeadEmail, mergeLeadRecords, normalizeDomain } from './leadharness-leads.mjs';
 
 const DEFAULT_MAX_PAGES = 10;
 const HARD_MAX_PAGES = 25;
@@ -366,7 +366,7 @@ function extractEmails(html) {
   for (const value of values) {
     for (const found of String(value || '').matchAll(EMAIL_RE)) {
       const email = found[0].toLowerCase().replace(/^mailto:/, '').replace(/[.,;:!?()[\]{}<>"']+$/g, '');
-      if (email && !isLikelyAssetEmail(email)) emails.add(email);
+      if (email && !isLikelyAssetEmail(email) && !isRejectedLeadEmail(email)) emails.add(email);
     }
   }
   return [...emails].sort();
@@ -575,6 +575,7 @@ function classifyEmailLocal(local) {
 }
 
 function isRelevantLead(lead, options) {
+  if (lead.email && !isGoodLead(lead)) return false;
   if (!options.includeBlocked && lead.emailType === 'blocked') return false;
   return lead.confidence >= options.minConfidence;
 }

package/lib/leadharness-leads.mjs

@@ -28,6 +28,37 @@ export const ALLOWED_VERIFICATION_STATUSES = new Set([
   'blocked',
   'unknown',
 ]);
+export const REJECTED_EMAIL_LOCAL_PREFIXES = [
+  'admin',
+  'booking',
+  'bookings',
+  'business',
+  'contact',
+  'customerservice',
+  'customer-service',
+  'customersuccess',
+  'customer-success',
+  'events',
+  'hello',
+  'help',
+  'hi',
+  'info',
+  'inquiries',
+  'enquiries',
+  'media',
+  'office',
+  'outreach',
+  'partners',
+  'partnerships',
+  'press',
+  'sales',
+  'service',
+  'services',
+  'speaking',
+  'success',
+  'support',
+  'team',
+];
 
 const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 
@@ -232,6 +263,9 @@ export function validatePayload(payload, { allowEmpty = false } = {}) {
 
   results.forEach((result, index) => {
     validateResult(result, `results[${index}]`, issues);
+    result.leads.forEach((lead, leadIndex) => {
+      validateLead(lead, `results[${index}].leads[${leadIndex}]`, issues);
+    });
   });
 
   const errors = issues.filter((item) => item.severity === 'error').length;
@@ -259,6 +293,12 @@ export function validateLead(lead, path, issues) {
   if (lead.email && !EMAIL_RE.test(lead.email)) {
     issues.push(issue('error', `${path}.email`, 'invalid_email', 'email must be a valid email address when present'));
   }
+  if (lead.email && isRejectedLeadEmail(lead.email)) {
+    issues.push(issue('error', `${path}.email`, 'generic_inbox_rejected', 'generic company inboxes such as info@, hello@, or support@ are not accepted; submit named people instead'));
+  }
+  if (lead.email && !isRejectedLeadEmail(lead.email) && ALLOWED_EMAIL_TYPES.has(lead.emailType) && !isGoodLead(lead)) {
+    issues.push(issue('error', `${path}.emailType`, 'non_person_email_rejected', 'email records must identify one named human visible in the evidence; role, unknown, blocked, unsupported, or unnamed person emails are not accepted'));
+  }
   if (lead.emailType && !ALLOWED_EMAIL_TYPES.has(lead.emailType)) {
     issues.push(issue('error', `${path}.emailType`, 'invalid_email_type', `emailType must be one of ${[...ALLOWED_EMAIL_TYPES].join(', ')}`));
   }
@@ -344,11 +384,13 @@ export function summarizePayload(payload) {
   const byType = {};
   let confidenceTotal = 0;
   let withEmail = 0;
+  let goodLeadCount = 0;
   const uniqueEmails = new Set();
   const mxVerifiedEmails = new Set();
   for (const lead of leads) {
     byType[lead.emailType || 'unknown'] = (byType[lead.emailType || 'unknown'] || 0) + 1;
     confidenceTotal += Number.isFinite(lead.confidence) ? lead.confidence : 0;
+    if (isGoodLead(lead)) goodLeadCount++;
     if (lead.email) {
       withEmail++;
       uniqueEmails.add(String(lead.email).toLowerCase());
@@ -362,6 +404,8 @@ export function summarizePayload(payload) {
     domainCount: domains.length,
     leadCount: leads.length,
     resultCount: results.length,
+    goodLeadCount,
+    reviewOnlyLeadCount: Math.max(0, leads.length - goodLeadCount),
     withEmail,
     uniqueEmailCount: uniqueEmails.size,
     mxVerifiedEmailCount: mxVerifiedEmails.size,
@@ -380,6 +424,7 @@ export function createManifestRecord({ inputPath, payload, validation, generated
     generatedAt,
     domains: payload.domains,
     leadCount: payload.leads.length,
+    goodLeadCount: validation.summary?.goodLeadCount || 0,
     resultCount: payload.results.length,
     errorCount: payload.errors.length,
     validation: {
@@ -611,7 +656,10 @@ function stableLeadKey(lead) {
 }
 
 function leadQualityScore(lead) {
-  return (lead?.confidence || 0) * 1000
+  const goodLead = isGoodLead(lead);
+  return (goodLead ? 50_000 : 0)
+    + (lead?.email && !goodLead ? -20_000 : 0)
+    + (lead?.confidence || 0) * 1000
     + verificationRank(lead?.verificationStatus) * 100
     + pagePriority(lead?.sourceUrl || '') * 10
     + (Array.isArray(lead?.sources) ? lead.sources.length : 0) * 5
@@ -685,6 +733,54 @@ export function fileHash(path) {
   return createHash('sha256').update(readFileSync(path)).digest('hex');
 }
 
+export function isRejectedLeadEmail(email) {
+  const local = String(email || '').trim().toLowerCase().split('@')[0] || '';
+  return isRejectedLeadLocalPart(local);
+}
+
+export function isRejectedLeadLocalPart(local) {
+  const value = normalizeRejectedLeadLocalPart(local);
+  if (!value) return false;
+  return REJECTED_EMAIL_LOCAL_PREFIXES.some((prefix) => {
+    if (value === prefix) return true;
+    if (!value.startsWith(prefix) || value.length === prefix.length) return false;
+    const next = value[prefix.length];
+    return next === '.' || next === '_' || next === '-' || next === '+' || /\d/.test(next);
+  });
+}
+
+export function isGoodLead(lead) {
+  if (!lead || typeof lead !== 'object') return false;
+  if (stringValue(lead.emailType).toLowerCase() !== 'person') return false;
+  if (!lead.email || isRejectedLeadEmail(lead.email)) return false;
+  const contactName = stringValue(lead.contactName);
+  if (!contactName) return false;
+  if (!evidenceIdentifiesContact(lead, contactName)) return false;
+  return true;
+}
+
+function evidenceIdentifiesContact(lead, contactName) {
+  const needle = compactComparable(contactName);
+  if (!needle) return false;
+  const evidence = [
+    lead.evidence,
+    ...(Array.isArray(lead.sources) ? lead.sources.map((source) => source?.evidence) : []),
+  ].map(compactComparable).join(' ');
+  return evidence.includes(needle);
+}
+
+function compactComparable(value) {
+  return stringValue(value).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+}
+
+function normalizeRejectedLeadLocalPart(local) {
+  let value = String(local || '').trim().toLowerCase();
+  for (const noise of ['mailto', 'u003e', 'email']) {
+    if (value.startsWith(noise)) value = value.slice(noise.length);
+  }
+  return value.replace(/^[>._+-]+/, '');
+}
+
 export function issue(severity, path, code, message) {
   return { severity, path, code, message };
 }

package/modes/_shared.md

@@ -28,17 +28,21 @@ Required fields:
 - Prioritize home, contact, about, team, leadership, people, press, blog, careers, and legal pages.
 - Respect robots.txt, paywalls, login walls, and obvious anti-scraping notices.
 - Do not infer email formats. Do not brute-force guessed addresses.
+- Use coding-agent judgment for every email candidate. Only emit an email lead when the source evidence identifies one specific human behind that address.
+- Prefer named people over organizational inboxes. Do not emit generic catch-all emails such as `info@`, `hello@`, `contact@`, `support@`, `team@`, or similar aliases. If only a general contact path exists, emit `contact_path` instead.
+- Reject email records that are role-based, shared, departmental, unknown ownership, blocked operational inboxes, or person-like but missing a visible human name in the source evidence.
 - Keep contact forms as `emailType: "contact_path"` with empty `email`.
 - Mark operational no-contact inboxes such as `noreply`, `abuse`, `security`, and `legal` as `blocked` with confidence `0`.
 
 ## Quality Heuristics
 
-- `person`: named person or person-like email with source context.
-- `role`: public role inbox such as `sales@`, `partnerships@`, or `press@`.
+- `goodLeadCount`: counts only `person` email records with a non-generic email and named `contactName` visible in the evidence. Generic, role, unknown, blocked, unnamed, unsupported, and `contact_path` records are not good leads.
+- `person`: named human with source context tying that person to the email address.
+- `role`: legacy/review-only classification. Do not emit role email records in new artifacts.
 - `contact_path`: public form or page where no email is available.
 - `blocked`: public address that should not be used for outbound.
 
-Confidence should reflect source quality, person specificity, domain match, and verification. Low-confidence records are allowed if they preserve warnings and evidence.
+Confidence should reflect source quality, person specificity, domain match, and verification. Low-confidence contact paths are allowed if they preserve warnings and evidence; email leads should be high-quality named humans only.
 
 ## Local Commands
 

package/modes/batch.md

@@ -10,7 +10,7 @@ Prefer:
 batch/batch-runner.sh --parallel 2
 ```
 
-The runner delegates to `scripts/batch-orchestrator.mjs`, which uses `@razroo/iso-orchestrator` for durable workflow records in `.public-leads-runs/`, bounded fan-out, and state updates.
+The runner delegates to `scripts/batch-orchestrator.mjs`, which uses `@agent-pattern-labs/iso-orchestrator` for durable workflow records in `.public-leads-runs/`, bounded fan-out, and state updates.
 
 ## Input
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-pattern-labs/leads-rig",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Agentic public-web lead discovery harness with portable ingest artifacts",
   "type": "module",
   "author": "Razroo",
@@ -155,32 +155,32 @@
     "fast-uri": "3.1.2"
   },
   "dependencies": {
-    "@razroo/iso-cache": "^0.1.0",
-    "@razroo/iso-canon": "^0.1.0",
-    "@razroo/iso-capabilities": "^0.1.0",
-    "@razroo/iso-context": "^0.1.0",
-    "@razroo/iso-contract": "^0.1.0",
-    "@razroo/iso-facts": "^0.1.0",
-    "@razroo/iso-guard": "^0.1.0",
-    "@razroo/iso-index": "^0.1.0",
-    "@razroo/iso-ledger": "^0.1.0",
-    "@razroo/iso-lineage": "^0.1.0",
-    "@razroo/iso-migrate": "^0.1.0",
-    "@razroo/iso-orchestrator": "^0.2.0",
-    "@razroo/iso-postflight": "^0.1.0",
-    "@razroo/iso-preflight": "^0.1.0",
-    "@razroo/iso-prioritize": "^0.1.0",
-    "@razroo/iso-redact": "^0.1.0",
-    "@razroo/iso-score": "^0.1.0",
-    "@razroo/iso-timeline": "^0.1.0",
-    "@razroo/iso-trace": "^0.5.0",
+    "@agent-pattern-labs/iso-cache": "^0.1.1",
+    "@agent-pattern-labs/iso-canon": "^0.1.1",
+    "@agent-pattern-labs/iso-capabilities": "^0.1.1",
+    "@agent-pattern-labs/iso-context": "^0.1.1",
+    "@agent-pattern-labs/iso-contract": "^0.1.1",
+    "@agent-pattern-labs/iso-facts": "^0.1.1",
+    "@agent-pattern-labs/iso-guard": "^0.1.1",
+    "@agent-pattern-labs/iso-index": "^0.1.1",
+    "@agent-pattern-labs/iso-ledger": "^0.1.1",
+    "@agent-pattern-labs/iso-lineage": "^0.1.1",
+    "@agent-pattern-labs/iso-migrate": "^0.1.1",
+    "@agent-pattern-labs/iso-orchestrator": "^0.2.1",
+    "@agent-pattern-labs/iso-postflight": "^0.1.1",
+    "@agent-pattern-labs/iso-preflight": "^0.1.1",
+    "@agent-pattern-labs/iso-prioritize": "^0.1.1",
+    "@agent-pattern-labs/iso-redact": "^0.1.1",
+    "@agent-pattern-labs/iso-score": "^0.1.1",
+    "@agent-pattern-labs/iso-timeline": "^0.1.1",
+    "@agent-pattern-labs/iso-trace": "^0.5.1",
     "playwright": "^1.58.1"
   },
   "devDependencies": {
-    "@razroo/agentmd": "^0.3.0",
-    "@razroo/iso": "^0.3.1",
-    "@razroo/iso-eval": "^0.4.0",
-    "@razroo/iso-harness": "^0.8.0",
-    "@razroo/iso-route": "^0.6.0"
+    "@agent-pattern-labs/agentmd": "^0.3.1",
+    "@agent-pattern-labs/iso": "^0.3.2",
+    "@agent-pattern-labs/iso-eval": "^0.4.1",
+    "@agent-pattern-labs/iso-harness": "^0.8.1",
+    "@agent-pattern-labs/iso-route": "^0.6.1"
   }
 }

package/scripts/batch-orchestrator.mjs

@@ -6,7 +6,7 @@ import { existsSync } from 'fs';
 import { mkdir, readFile, rm, writeFile } from 'fs/promises';
 import { dirname, join, resolve } from 'path';
 import { fileURLToPath } from 'url';
-import { runWorkflow } from '@razroo/iso-orchestrator';
+import { runWorkflow } from '@agent-pattern-labs/iso-orchestrator';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = resolve(__dirname, '..');

package/scripts/crawl.mjs

@@ -57,7 +57,7 @@ async function main() {
     console.log(JSON.stringify({ output: out, validation, summary: validation.summary }, null, 2));
   } else {
     console.log(`crawl: wrote ${relativeProjectPath(resolveProjectPath(out))}`);
-    console.log(`domains=${validation.summary.domainCount} leads=${validation.summary.leadCount} results=${validation.summary.resultCount} errors=${payload.errors.length}`);
+    console.log(`domains=${validation.summary.domainCount} leads=${validation.summary.leadCount} goodLeads=${validation.summary.goodLeadCount} results=${validation.summary.resultCount} errors=${payload.errors.length}`);
   }
 
   if (!validation.ok) {

package/scripts/manifest.mjs

@@ -50,6 +50,7 @@ try {
     batchCount: manifest.batches.length,
     readyForIngest: manifest.batches.filter((item) => item.readyForIngest).length,
     leadCount: manifest.batches.reduce((sum, item) => sum + item.leadCount, 0),
+    goodLeadCount: manifest.batches.reduce((sum, item) => sum + (item.goodLeadCount || 0), 0),
     errorCount: manifest.batches.reduce((sum, item) => sum + item.validation.errors, 0),
     warningCount: manifest.batches.reduce((sum, item) => sum + item.validation.warnings, 0),
   };
@@ -60,8 +61,8 @@ try {
     console.log(JSON.stringify({ manifest: relativeProjectPath(manifestPath), record, summary: manifest.summary }, null, 2));
   } else {
     console.log(`manifest: ${relativeProjectPath(manifestPath)}`);
-    console.log(`batch: ${record.id} leads=${record.leadCount} ready=${record.readyForIngest}`);
-    console.log(`summary: batches=${manifest.summary.batchCount} ready=${manifest.summary.readyForIngest} leads=${manifest.summary.leadCount}`);
+    console.log(`batch: ${record.id} leads=${record.leadCount} goodLeads=${record.goodLeadCount} ready=${record.readyForIngest}`);
+    console.log(`summary: batches=${manifest.summary.batchCount} ready=${manifest.summary.readyForIngest} leads=${manifest.summary.leadCount} goodLeads=${manifest.summary.goodLeadCount}`);
   }
 
   process.exit(validation.ok ? 0 : 1);

package/scripts/pipeline.mjs

@@ -66,7 +66,7 @@ try {
   const manifest = upsertManifest(manifestPath, out, payload, validation);
   console.log(`pipeline: wrote ${relativeProjectPath(resolveProjectPath(out))}`);
   console.log(`manifest: ${relativeProjectPath(resolveProjectPath(manifestPath))}`);
-  console.log(`domains=${validation.summary.domainCount} leads=${validation.summary.leadCount} results=${validation.summary.resultCount} errors=${payload.errors.length}`);
+  console.log(`domains=${validation.summary.domainCount} leads=${validation.summary.leadCount} goodLeads=${validation.summary.goodLeadCount} results=${validation.summary.resultCount} errors=${payload.errors.length}`);
 
   if (opts.ingest || opts.upload) {
     const ingestResult = await ingestPayload(payload, {
@@ -110,6 +110,7 @@ function upsertManifest(manifestPath, inputPath, payload, validation) {
     batchCount: manifest.batches.length,
     readyForIngest: manifest.batches.filter((item) => item.readyForIngest).length,
     leadCount: manifest.batches.reduce((sum, item) => sum + item.leadCount, 0),
+    goodLeadCount: manifest.batches.reduce((sum, item) => sum + (item.goodLeadCount || 0), 0),
     errorCount: manifest.batches.reduce((sum, item) => sum + item.validation.errors, 0),
     warningCount: manifest.batches.reduce((sum, item) => sum + item.validation.warnings, 0),
   };

package/scripts/validate-leads.mjs

@@ -58,7 +58,7 @@ try {
 function printReport(report) {
   const rel = relativeProjectPath(report.input);
   console.log(`${report.ok ? 'OK' : 'ERROR'} ${rel}`);
-  console.log(`domains=${report.summary.domainCount} leads=${report.summary.leadCount} results=${report.summary.resultCount} avgConfidence=${report.summary.averageConfidence}`);
+  console.log(`domains=${report.summary.domainCount} leads=${report.summary.leadCount} goodLeads=${report.summary.goodLeadCount} results=${report.summary.resultCount} avgConfidence=${report.summary.averageConfidence}`);
   if (Object.keys(report.summary.byType).length > 0) {
     console.log(`types=${Object.entries(report.summary.byType).map(([type, count]) => `${type}:${count}`).join(', ')}`);
   }