Skip to content

docs: catch the README, skill, and test-header notes up to the code - #71

Open
Ref34t wants to merge 1 commit into
PostHog:mainfrom
Ref34t:docs-readme-catchup
Open

docs: catch the README, skill, and test-header notes up to the code#71
Ref34t wants to merge 1 commit into
PostHog:mainfrom
Ref34t:docs-readme-catchup

Conversation

@Ref34t

@Ref34t Ref34t commented Aug 19, 2026

Copy link
Copy Markdown

Four prose spots still describe states the repo has moved past. Each fix is verified against the code at main:

  • README said the Warlock is CommonJS and explained scan()'s asyncness via the CJS/ESM bridge. package.json has "type": "module" since the 0.2.x ESM migration — the dynamic import('@virustotal/yara-x') survives for lazy WASM init, so the section now describes that (and the real cost: CJS consumers need a dynamic import of their own).
  • README's Category reference listed 6 of the 7 values in CATEGORIEShardcoded_secret was missing.
  • README described the wizard migration in future tense and pointed at src/lib/yara-scanner.ts, which was deleted when wizard#804 landed. Now past tense, pointing at the wizard's actual wiring (yara-hooks.ts).
  • rules.test.ts's header said four categories were "coming in future PRs" — they shipped and moved to per-rule files under __tests__/rules/. The header now routes new rule tests to the right place.

Also: the warlock skill referenced INTEGRATING.md twice as authoritative, but the file doesn't exist — the references now point at README's API sections. If an INTEGRATING.md is still planned, happy to swap these back (or draft it).

Deliberately not touched: the action enum values in README/CONTRIBUTING — #34 already covers those.

pnpm test (530 passing) and pnpm build pass.

Four places still describe states the repo has moved past:

- README called the Warlock a CommonJS package and explained scan()'s
  asyncness via the CJS/ESM bridge. It has been ESM since the 0.2.x
  migration; the dynamic import survives for lazy WASM init, so describe
  that instead.
- README's Category reference listed 6 of the 7 CATEGORIES values —
  hardcoded_secret was missing.
- README described the wizard's scanner replacement in future tense and
  pointed at src/lib/yara-scanner.ts, deleted when wizard#804 landed the
  migration.
- rules.test.ts's header said four rule categories were 'coming in
  future PRs'; they shipped and live in per-rule files under
  __tests__/rules/ — say so, so new rule tests land in the right place.

Also drop the two references to INTEGRATING.md in the warlock skill —
the file does not exist; point at README's API sections instead.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants