Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

Merge branch 'origin/main' into codex/issue-386

morluto76d3cd5d1810
diff --cc AGENTS.md
index 8859be902,1ec6b4142..7b0ec76d0
--- a/AGENTS.md
+++ b/AGENTS.md
@@@ -64,12 -74,11 +74,13 @@@ See [docs/architecture.mermaid](docs/ar
- `npm run verify:ghidra:windows`: build and run the real Windows Ghidra verifier against `GHIDRA_INSTALL_DIR` and the source-owned x64 PE fixture.
- `npm run verify:browser`: build and run the real Chrome verifier against `REA_BROWSER_EXECUTABLE` or a platform-default Chrome-family executable.
- `npm run verify:managed`: build and run the source-owned managed PE/CLI conformance verifier for artifact triage, member inspection, managed/native boundary declarations, token drift comparison, malformed metadata, non-managed degradation, managed application-graph projection, manifest-verifier self-test, and optional BYO ILSpy oracle checks; set `REA_MANAGED_APP_MANIFEST_PATH` to verify an operator-local managed app manifest, including optional graph/trace assertions, and set `REA_ILSPY_CMD_PATH` to an absolute `ilspycmd` path to run the real ILSpy reconstruction oracle.
+- `npm run evidence:generate`: regenerate the managed conformance manifest and Evidence v2 completion ledger from live verifier output.
+- `npm run evidence:check`: rerun managed conformance and fail on generated manifest, completion ledger, or bundled skill drift.
- `npm run verify:replay`: build and run the real Linux Bubblewrap/seccomp/cgroup verifier against source-owned replay fixtures; set `REA_REPLAY_INPUT_PATH` to verify an operator-local manifest.
- `npm run verify:package`: pack and test the CLI, setup transaction, skill, and canonical target-free MCP catalog in an isolated environment.
- - `npm run docs:generate`: generate API documentation from JSDoc comments into `docs/api/` using TypeDoc.
- - `npm run docs:check`: verify generated package metadata, the canonical product catalog, caller-visible documentation facts, TypeDoc output, and the error JSON schema without rewriting them.
+ - `npm run docs:api`: render uncommitted API documentation from JSDoc comments into `build/api-docs/` using TypeDoc.
+ - `npm run docs:generate`: refresh committed metadata and render the uncommitted API documentation.
+ - `npm run docs:check`: verify generated package metadata, the canonical product catalog, caller-visible documentation facts, TypeDoc rendering, and the error JSON schema.
- `npm run config:print -- /path/to/binary`: print an MCP server config with absolute paths.
- `HOPPER_TARGET_PATH=/path/to/binary npm start`: launch Hopper and run the built stdio MCP server.
diff --cc package.json
index c98eaebc2,74133f2d1..ff610b2c0
--- a/package.json
+++ b/package.json
@@@ -86,19 -105,19 +105,21 @@@
"build:fixtures": "node scripts/build-conformance-fixtures.mjs",
"build:ghidra-windows-fixture": "node scripts/create-ghidra-windows-fixture.mjs",
"verify:fixtures": "npm run build:fixtures && node scripts/verify-conformance-fixtures.mjs",
- "verify:package": "npm run build && node scripts/verify-package.mjs",
- "verify:package:windows": "npm run build && node scripts/verify-windows-package.mjs",
- "probe:windows-capabilities": "npm run build && node scripts/windows-capabilities.mjs",
+ "verify:package": "npm run build:cached && node scripts/verify-package.mjs",
+ "verify:package:windows": "npm run build:cached && node scripts/verify-windows-package.mjs",
+ "probe:windows-capabilities": "npm run build:cached && node scripts/windows-capabilities.mjs",
"verify:published": "node scripts/verify-published-package.mjs",
"config:print": "node scripts/print-mcp-config.mjs",
- "evidence:generate": "npm run build && node scripts/generate-completion-ledger.mjs",
- "evidence:check": "npm run build && node scripts/generate-completion-ledger.mjs --check",
- "docs:generate": "npm run build && node scripts/generate-skill-metadata.mjs && node scripts/generate-product-catalog.mjs && node scripts/generate-completion-ledger.mjs && typedoc && node scripts/generate-error-schema.mjs",
- "docs:check": "node scripts/generate-package-metadata.mjs --check && npm run build && node scripts/generate-skill-metadata.mjs --check && node scripts/generate-product-catalog.mjs --check && node scripts/generate-completion-ledger.mjs --check && node scripts/check-doc-facts.mjs && node scripts/check-typedoc.mjs && node scripts/generate-error-schema.mjs --check",
- "docs:error-schema": "npm run build && node scripts/generate-error-schema.mjs",
- "prepack": "npm run deps:check && node scripts/generate-skill-metadata.mjs --check",
++ "evidence:generate": "npm run build:cached && node scripts/generate-completion-ledger.mjs",
++ "evidence:check": "npm run build:cached && node scripts/generate-completion-ledger.mjs --check",
+ "docs:api": "typedoc",
- "docs:generate": "npm run metadata:generate && npm run build:cached && node scripts/generate-skill-metadata.mjs && node scripts/generate-product-catalog.mjs && npm run docs:api && node scripts/generate-error-schema.mjs",
++ "docs:generate": "npm run metadata:generate && npm run build:cached && node scripts/generate-skill-metadata.mjs && node scripts/generate-product-catalog.mjs && node scripts/generate-completion-ledger.mjs && npm run docs:api && node scripts/generate-error-schema.mjs",
+ "docs:check": "turbo run docs:check:built",
- "docs:check:built": "node scripts/generate-package-metadata.mjs --check && node scripts/generate-skill-metadata.mjs --check && node scripts/generate-product-catalog.mjs --check && node scripts/check-doc-facts.mjs && npm run docs:api && node scripts/generate-error-schema.mjs --check",
++ "docs:check:built": "node scripts/generate-package-metadata.mjs --check && node scripts/generate-skill-metadata.mjs --check && node scripts/generate-product-catalog.mjs --check && node scripts/generate-completion-ledger.mjs --check && node scripts/check-doc-facts.mjs && npm run docs:api && node scripts/generate-error-schema.mjs --check",
+ "docs:error-schema": "npm run build:cached && node scripts/generate-error-schema.mjs",
+ "prepack": "node scripts/prepack.mjs",
"prepublishOnly": "npm run deps:check && node scripts/generate-skill-metadata.mjs --check",
- "prepare": "npm run build && husky"
+ "prepare": "node scripts/prepare.mjs"
},
"lint-staged": {
"*.{ts,mjs,json,md,yml,yaml}": "prettier --write",
diff --cc typedoc.json
index cb37616e4,96e20d809..d8f9d462e
--- a/typedoc.json
+++ b/typedoc.json
@@@ -14,15 -14,9 +14,15 @@@
"src/server"
],
"entryPointStrategy": "expand",
- "out": "docs/api",
+ "out": "build/api-docs",
"tsconfig": "tsconfig.json",
- "exclude": ["**/*.test.ts", "tests/**", "dist/**", "node_modules/**"],
+ "exclude": [
+ "**/*.test.ts",
+ "tests/**",
+ "dist/**",
+ "node_modules/**",
+ "src/application/LoopbackReplayRecorder.ts"
+ ],
"excludeExternals": true,
"excludePrivate": true,
"excludeProtected": false,