Lockfile → Watchlist Transformer

Parse a Brewfile, package.json, requirements.txt, or Cargo.toml into normalized watchlist rows ready to feed Collin’s live delta monitors (Homebrew / npm) — or carry a clear PyPI / crates suggestion when no live Actor exists yet.

Status: Publishing under standing auth (B). Hygiene complete (real exampleRunInput / INPUT.example.json, schemas avoid reserved dataset fields title/description, tests green).

Pricing (pay per event — document now, Console later):

Event	Suggested price	Notes
watchlist-row (primary)	$0.001 per emitted row	Stateless transform; charge per useful row
Actor start	platform small event (~$0.00005)	—

No LAST_SEEN baseline — every successful parse emits rows (PPE-friendly for agent/MCP one-shots).

Why this exists

• Agents / n8n / MCP runners already have lockfiles, not curated Store inputs
• Upsells owned inventory: suggestedActor points at live collinjreynolds/*-delta-monitor names
• Pure local parse = ToS-safe, $0 infra, standby/MCP friendly

Input

Field	Required	Description
lockfileText	yes	Raw Brewfile / package.json / requirements.txt / Cargo.toml text
format	yes	brewfile | package-json | requirements-txt | cargo-toml
targetActor	no	Optional filter/hint (e.g. collinjreynolds/homebrew-version-delta-monitor)
includeDevDependencies	no	Include dev/optional/peer / Cargo dev+build deps (default true)

Example / exampleRunInput (Brewfile — not helloWorld)

Canonical publish-day input: ./INPUT.example.json (= .actor/example_run_input.json).

{
  "lockfileText": "brew \"wget\"\nbrew \"git\"\nbrew \"jq\"\ncask \"iterm2\"\ncask \"visual-studio-code\"\n",
  "format": "brewfile",
  "includeDevDependencies": true
}

Example (package.json)

{
  "lockfileText": "{\"dependencies\":{\"lodash\":\"^4.17.21\",\"axios\":\"^1.7.0\"}}",
  "format": "package-json",
  "includeDevDependencies": true
}

Output

Each dataset item:

Field	Meaning
ecosystem	homebrew | npm | pypi | crates
name	Package / formula / cask / crate
kind	e.g. formula, cask, dependency, devDependency, requirement, crate
constraint	Version pin/range from the file when present
suggestedActor	Live Store name or “not live yet” note
suggestedInput	Sibling-shaped fragment (formulae / casks / packages / crates)
note	Extra guidance for PyPI/crates
source_format	Echo of input format

suggestedActor map (accurate as of scaffold)

Ecosystem	suggestedActor
Homebrew formulae/casks	collinjreynolds/homebrew-version-delta-monitor (LIVE)
npm packages	collinjreynolds/npm-package-version-delta-monitor (LIVE)
PyPI requirements	pypi-package-version-delta-monitor (Store-ready local scaffold; not published under collinjreynolds yet)
crates.io	crates-io-version-delta-monitor (Store-ready local scaffold; not published under collinjreynolds yet)

Related live portfolio (not auto-mapped from these lockfiles):
github-releases-delta-monitor, docker-hub-tag-digest-delta-monitor, gitlab-releases-delta-monitor.

suggestedInput shapes match sibling inputs, e.g.:

• Homebrew formula → { "formulae": ["wget"] }
• Homebrew cask → { "casks": ["iterm2"] }
• npm → { "packages": ["lodash"] }

A KV TRANSFORM_SUMMARY also stores an aggregated sibling input blob for the whole run.

Local development

cd /workspace/revenue-ops/apify-actors/lockfile-to-watchlist-transformer
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt pytest
pytest -q
python scripts/run_offline_demo.py

ToS / scope

Parse-only. Never executes installs. No third-party fetches in v1. See ./AGREEMENT.md.

Store / Console

• Publish checklist: exampleRunInput = Brewfile text (not helloWorld); PPE watchlist-row $0.001; LIMITED_PERMISSIONS; categories DEVELOPER_TOOLS/AI; memory 512; timeout 300.