@agent-pattern-labs/leads-rig 0.1.3

package/modes/crawl.md

@@ -0,0 +1,25 @@
+# Crawl Mode
+
+Use this for one or more assigned domains.
+
+## Procedure
+
+1. Normalize the domain to lowercase without protocol or `www.`.
+2. Visit only bounded public pages from the official site.
+3. Prefer the deterministic crawler when no browser-only blocker exists:
+   `npx public-leads crawl --input data/domains.tsv --out data/lead-results.json`
+4. Extract public email addresses, person names/titles when visible nearby, contact forms, source URLs, page titles, evidence snippets, and warnings.
+5. Emit a JSON payload matching `templates/lead-schema.json`.
+6. Save the payload to `data/lead-results.json` for single-domain runs or `batch/lead-results-{id}.json` for batch workers.
+7. Run `npx public-leads validate --input <artifact>`.
+8. Return the artifact path and validation status.
+
+## Output Contract
+
+For worker/batch mode, end with one JSON status line:
+
+```json
+{"id":"<id>","status":"completed|failed","domain":"example.com","leadCount":0,"artifact":"batch/lead-results-<id>.json","error":null}
+```
+
+No source-backed lead should be described only in prose.

package/modes/ingest.md

@@ -0,0 +1,33 @@
+# Ingest Mode
+
+Use this when the user asks to store validated leads in a configured ingest API.
+
+## Preflight
+
+1. Validate the artifact:
+   ```bash
+   npx public-leads validate --input <artifact>
+   ```
+2. Update the manifest:
+   ```bash
+   npx public-leads manifest --input <artifact>
+   ```
+3. Confirm ingest credentials and request settings are available through `config/profile.yml` and the configured environment variable. Do not print token values.
+
+## Dry Run
+
+Use dry-run before live ingest unless the user explicitly requested live submission:
+
+```bash
+npx public-leads ingest --input <artifact> --dry-run --out data/ingest-response.json
+```
+
+## Live Ingest
+
+```bash
+npx public-leads ingest --input <artifact> --target-project /path/to/cold-agent-leads --out data/ingest-response.json
+```
+
+## Output
+
+Return HTTP status, job ID if present, lead count, and response artifact path.

package/modes/pipeline.md

@@ -0,0 +1,27 @@
+# Pipeline Mode
+
+Use this when the user supplies a list of domains or wants the local domain queue processed.
+
+## Inputs
+
+Read domains from the first available source:
+
+1. Domains in the user's request.
+2. `data/domains.tsv` with columns `domain`, optional `company`, optional `notes`.
+3. `data/pipeline.md` checkbox lines such as `- [ ] example.com | Example | notes`.
+
+## Procedure
+
+1. Build a deduped candidate list.
+2. Drop domains already represented in the manifest unless the user asks to retry.
+3. Prefer the deterministic end-to-end command for normal public pages:
+   `npx public-leads pipeline --input data/domains.tsv --out data/lead-results.json`
+4. Use browser/MCP workers only when the deterministic crawler cannot reach a public page or the site requires rendering.
+5. For browser-heavy batch work, use `batch/batch-runner.sh --parallel 2`.
+6. Validate every artifact with `npx public-leads validate`.
+7. Merge validated artifacts into a manifest with `npx public-leads manifest --input <artifact>`.
+8. Ingest with `npx public-leads pipeline --ingest --target-project /path/to/cold-agent-leads` only when upload is requested.
+
+## Output
+
+List processed artifact paths, validation status, manifest path, and the next ingest command.

package/modes/reference-local-helpers.md

@@ -0,0 +1,13 @@
+# Local Helper Reference
+
+Use deterministic helpers instead of repeating schema logic in prompts.
+
+| Need | Command |
+|---|---|
+| Validate a lead artifact | `npx public-leads validate --input <file>` |
+| Build/update manifest | `npx public-leads manifest --input <file>` |
+| Dry-run ingest | `npx public-leads ingest --input <file> --dry-run` |
+| Live ingest | `npx public-leads ingest --input <file>` |
+| Full gate | `npx public-leads verify` |
+| Batch dry-run | `batch/batch-runner.sh --dry-run` |
+| Batch execute | `batch/batch-runner.sh --parallel 2` |

package/modes/review.md

@@ -0,0 +1,15 @@
+# Review Mode
+
+Use this to inspect local lead artifacts, manifest state, or ingest responses.
+
+## Procedure
+
+1. Run `npx public-leads verify`.
+2. Inspect `data/lead-manifest.json` if present.
+3. Validate any specific artifact requested by the user.
+4. Summarize counts by domain and `emailType`.
+5. Surface validation errors before summaries.
+
+## Output
+
+Findings first, then concise summary and next action.

package/modes/setup.md

@@ -0,0 +1,25 @@
+# Setup Mode
+
+Use this when the user asks to configure or inspect the lead harness.
+
+## Checklist
+
+1. Confirm `config/profile.yml` exists. If it is missing, copy from `config/profile.example.yml` in a consumer project.
+2. Confirm at least one domain input exists:
+   - `data/domains.tsv`
+   - `data/pipeline.md`
+   - direct domains in the user request
+3. Confirm the ingest API settings:
+   - `api.base_url`
+   - `api.ingest_path`
+   - `api.operator_email`
+   - `api.operator_email_header`
+   - `api.auth_header`
+   - `api.auth_scheme`
+   - `api.auth_token_env`
+   - `api.target_project` when using a local Cold Agent Leads checkout for `.env` credentials
+4. Run `npx public-leads verify`.
+
+## Output
+
+Return a concise setup status with missing files, the command to run next, and no secrets.

package/opencode.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "opencode-go/deepseek-v4-flash",
+  "agent": {
+    "fast": {
+      "model": "opencode-go/deepseek-v4-flash"
+    },
+    "quality": {
+      "model": "opencode-go/deepseek-v4-flash"
+    },
+    "minimal": {
+      "model": "opencode-go/deepseek-v4-flash"
+    }
+  },
+  "mcp": {
+    "geometra": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "@geometra/mcp@1.61.3"
+      ],
+      "environment": {}
+    },
+    "state-trace": {
+      "type": "local",
+      "command": [
+        "state-trace-mcp"
+      ],
+      "environment": {
+        "STATE_TRACE_STORAGE_PATH": ".state-trace/memory.db",
+        "STATE_TRACE_NAMESPACE": "public-leads-harness",
+        "STATE_TRACE_CAPACITY_LIMIT": "256"
+      }
+    }
+  },
+  "instructions": [
+    "templates/lead-schema.json",
+    "templates/states.yml",
+    ".opencode/instructions.md"
+  ],
+  "small_model": "opencode-go/deepseek-v4-flash"
+}

package/package.json

@@ -0,0 +1,186 @@
+{
+  "name": "@agent-pattern-labs/leads-rig",
+  "version": "0.1.3",
+  "description": "Agentic public-web lead discovery harness with portable ingest artifacts",
+  "type": "module",
+  "author": "Razroo",
+  "homepage": "https://github.com/Agent-Pattern-Labs/leads-rig#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Agent-Pattern-Labs/leads-rig.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Agent-Pattern-Labs/leads-rig/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "public-leads": "bin/lead-harness.mjs",
+    "create-public-leads-harness": "bin/create-leads-harness.mjs",
+    "lead-harness": "bin/lead-harness.mjs",
+    "create-leads-harness": "bin/create-leads-harness.mjs"
+  },
+  "scripts": {
+    "verify": "node verify-pipeline.mjs",
+    "build:config": "iso-route build models.yaml --out . && iso-harness build",
+    "smoke:iso": "iso-route build models.yaml --out . --dry-run && iso-harness build --dry-run",
+    "lead:crawl": "node bin/lead-harness.mjs crawl",
+    "lead:pipeline": "node bin/lead-harness.mjs pipeline",
+    "lead:validate": "node bin/lead-harness.mjs validate",
+    "lead:manifest": "node bin/lead-harness.mjs manifest",
+    "lead:ingest": "node bin/lead-harness.mjs ingest",
+    "batch": "batch/batch-runner.sh",
+    "trace:list": "node bin/lead-harness.mjs trace:list",
+    "trace:stats": "node bin/lead-harness.mjs trace:stats",
+    "trace:show": "node bin/lead-harness.mjs trace:show",
+    "guard:audit": "node bin/lead-harness.mjs guard:audit",
+    "guard:explain": "node bin/lead-harness.mjs guard:explain",
+    "ledger:status": "node bin/lead-harness.mjs ledger:status",
+    "ledger:rebuild": "node bin/lead-harness.mjs ledger:rebuild",
+    "ledger:verify": "node bin/lead-harness.mjs ledger:verify",
+    "capabilities:list": "node bin/lead-harness.mjs capabilities:list",
+    "capabilities:explain": "node bin/lead-harness.mjs capabilities:explain",
+    "capabilities:check": "node bin/lead-harness.mjs capabilities:check",
+    "context:list": "node bin/lead-harness.mjs context:list",
+    "context:explain": "node bin/lead-harness.mjs context:explain",
+    "context:plan": "node bin/lead-harness.mjs context:plan",
+    "context:check": "node bin/lead-harness.mjs context:check",
+    "context:render": "node bin/lead-harness.mjs context:render",
+    "cache:key": "node bin/lead-harness.mjs cache:key",
+    "cache:has": "node bin/lead-harness.mjs cache:has",
+    "cache:get": "node bin/lead-harness.mjs cache:get",
+    "cache:put": "node bin/lead-harness.mjs cache:put",
+    "cache:status": "node bin/lead-harness.mjs cache:status",
+    "cache:list": "node bin/lead-harness.mjs cache:list",
+    "cache:verify": "node bin/lead-harness.mjs cache:verify",
+    "cache:prune": "node bin/lead-harness.mjs cache:prune",
+    "index:build": "node bin/lead-harness.mjs index:build",
+    "index:status": "node bin/lead-harness.mjs index:status",
+    "index:query": "node bin/lead-harness.mjs index:query",
+    "index:has": "node bin/lead-harness.mjs index:has",
+    "index:verify": "node bin/lead-harness.mjs index:verify",
+    "facts:build": "node bin/lead-harness.mjs facts:build",
+    "facts:status": "node bin/lead-harness.mjs facts:status",
+    "facts:query": "node bin/lead-harness.mjs facts:query",
+    "facts:has": "node bin/lead-harness.mjs facts:has",
+    "facts:verify": "node bin/lead-harness.mjs facts:verify",
+    "score:compute": "node bin/lead-harness.mjs score:compute",
+    "score:verify": "node bin/lead-harness.mjs score:verify",
+    "score:check": "node bin/lead-harness.mjs score:check",
+    "score:gate": "node bin/lead-harness.mjs score:gate",
+    "score:compare": "node bin/lead-harness.mjs score:compare",
+    "score:explain": "node bin/lead-harness.mjs score:explain",
+    "canon:normalize": "node bin/lead-harness.mjs canon:normalize",
+    "canon:key": "node bin/lead-harness.mjs canon:key",
+    "canon:compare": "node bin/lead-harness.mjs canon:compare",
+    "canon:explain": "node bin/lead-harness.mjs canon:explain",
+    "preflight:plan": "node bin/lead-harness.mjs preflight:plan",
+    "preflight:check": "node bin/lead-harness.mjs preflight:check",
+    "preflight:explain": "node bin/lead-harness.mjs preflight:explain",
+    "postflight:status": "node bin/lead-harness.mjs postflight:status",
+    "postflight:check": "node bin/lead-harness.mjs postflight:check",
+    "postflight:explain": "node bin/lead-harness.mjs postflight:explain",
+    "timeline:status": "node bin/lead-harness.mjs timeline:status",
+    "timeline:build": "node bin/lead-harness.mjs timeline:build",
+    "timeline:plan": "node bin/lead-harness.mjs timeline:plan",
+    "timeline:due": "node bin/lead-harness.mjs timeline:due",
+    "timeline:check": "node bin/lead-harness.mjs timeline:check",
+    "timeline:verify": "node bin/lead-harness.mjs timeline:verify",
+    "prioritize:status": "node bin/lead-harness.mjs prioritize:status",
+    "prioritize:items": "node bin/lead-harness.mjs prioritize:items",
+    "prioritize:build": "node bin/lead-harness.mjs prioritize:build",
+    "prioritize:rank": "node bin/lead-harness.mjs prioritize:rank",
+    "prioritize:select": "node bin/lead-harness.mjs prioritize:select",
+    "prioritize:check": "node bin/lead-harness.mjs prioritize:check",
+    "prioritize:verify": "node bin/lead-harness.mjs prioritize:verify",
+    "lineage:status": "node bin/lead-harness.mjs lineage:status",
+    "lineage:record": "node bin/lead-harness.mjs lineage:record",
+    "lineage:check": "node bin/lead-harness.mjs lineage:check",
+    "lineage:stale": "node bin/lead-harness.mjs lineage:stale",
+    "lineage:verify": "node bin/lead-harness.mjs lineage:verify",
+    "redact:scan": "node bin/lead-harness.mjs redact:scan",
+    "redact:verify": "node bin/lead-harness.mjs redact:verify",
+    "redact:apply": "node bin/lead-harness.mjs redact:apply",
+    "migrate:plan": "node bin/lead-harness.mjs migrate:plan",
+    "migrate:apply": "node bin/lead-harness.mjs migrate:apply",
+    "migrate:check": "node bin/lead-harness.mjs migrate:check",
+    "prepack": "npm run build:config",
+    "postinstall": "node bin/sync.mjs"
+  },
+  "files": [
+    "bin/",
+    "iso/",
+    "models.yaml",
+    ".claude/settings.json",
+    ".claude/iso-route.resolved.json",
+    ".claude/agents/",
+    ".cursor/mcp.json",
+    ".cursor/rules/",
+    ".cursor/iso-route.md",
+    ".opencode/",
+    ".codex/",
+    ".pi/",
+    ".mcp.json",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "opencode.json",
+    "modes/",
+    "templates/",
+    "config/profile.example.yml",
+    "batch/batch-prompt.md",
+    "batch/batch-runner.sh",
+    "batch/README.md",
+    "docs/",
+    "examples/",
+    "lib/",
+    "scripts/",
+    "verify-pipeline.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai",
+    "agentic",
+    "lead-discovery",
+    "public-source",
+    "contact-discovery",
+    "automation"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "overrides": {
+    "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",
+    "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.5.3"
+  }
+}