FintheFinder
FintheFinder pauses research runs for human approval and audits citations deterministically. Its repository includes contracts and test files.
Project details
- Classification
- Open-source project
- Repository
- Alexi5000/FintheFinder
- Language
- TypeScript
- License
- Custom license (GitHub reports NOASSERTION)
- Status
- Maintained
- Tests
- 3 test notes
- Last verified
- 2026-07-04
What it is
I use FintheFinder to pause research work at approval boundaries. A person reviews the proposed action before the run resumes. Citation checks run without model calls. You can inspect the contracts and tests; those checks do not assess a source’s quality.
Architecture
- Mastra-based run graph with suspend and resume at approval boundaries.
- Deterministic citation audit: no model participates in verifying a source.
- Contracts directory holds the typed interfaces between research, approval, and audit stages.
- Supabase stores state, and Next.js provides the interface.
Tests and gates
- GitHub Actions ci workflow plus a tests directory and a Playwright configuration for end-to-end runs.
- Type-test tsconfig is checked in separately from the build tsconfig.
- Docker Compose brings up the full stack for reproducible local runs.
Limits
- Approval gates only help if a human actually reads the payload.
- The citation audit verifies that a source resolves and matches the claim's anchor; it does not judge source quality.
- Search coverage depends on the configured providers.
Source files and examples
Related methods
Acceptance tests for agent work →
Executable checks test the task and detect regressions.
Evaluation tests for releases →
A fixed evaluation suite checks release requirements.
MCP tool permissions →
The server checks which tools a caller may use.
Recording agent runs →
A shared trace ID connects the records of a run.
Spending limits for agent runs →
Budget checks run before provider requests.
Pausing for human approval →
The run waits for approval before the action executes.
Related projects
ClawKeeper →
ClawKeeper checks proposed Claude agent actions against explicit rules before a model call. Autonomous spend defaults to zero, and the database enforces an append-only audit log.
TechTide Harness Kit →
TechTide Harness Kit uses JSON Schema to declare skill permissions, risk tiers, network access, and approval requirements. Automated checks validate declarations and run prompt-injection fixtures.
CipherClaw →
CipherClaw analyzes recorded agent activity without model calls. It builds causal graphs, scores possible causes, and flags failure patterns.
Swarm 357 →
357 Claude agent roles across six business layers, with portable memory, enforced cost caps, a bash policy gate, and durable checkpoints.
I document the project here. TechTide AI publishes current service scope, prices, and terms.
Systems Decision Audit at TechTide AI→© 2026 Alex Cinovoj · TechTide AI · Columbus, OH