Workflow Agent TS

This is a small TypeScript CLI project that demonstrates one credible agent-style workflow: take a structured recruiting task, plan the steps, search and rank mock profiles, stop at an approval gate before side effects, write approved candidates to a mock ATS, and emit a trace plus summary.

Focus

The main CLI flow is:

1. ingest a structured task
2. create a plan
3. search mock profiles
4. rank them against a role spec
5. stop at an approval gate before side effects
6. write approved candidates to a mock ATS
7. produce a trace and final summary

Commands

npm install
npm run demo
npm run evaluate
npm test

On Windows PowerShell, use npm.cmd if npm is blocked by execution policy:

npm.cmd install
npm.cmd run demo

Smallest mental model

If you want to understand the repo quickly, start with these files:

• src/cli.ts: commands and evaluation loop
• src/orchestration/planner.ts: the explicit plan
• src/orchestration/orchestrator.ts: run loop, retries, approvals, and summaries
• src/tools/workflowTools.ts: actual tool behavior
• src/domain.ts: task, plan, state, and schema definitions
• src/persistence/fileStore.ts: local JSON persistence
• src/permissions/permissionPolicy.ts: approval rules
• src/services/profileCatalog.ts: mock profile search and reads

Persistence

The TypeScript repo uses JSON-backed local persistence under runtime/ for speed and portability:

• memory.json
• tasks.json
• ats.json
• runs.json
• traces/*.json

Why JSON here

JSON keeps the project easy to run and easy to inspect. For this project, portability and clarity matter more than heavier storage infrastructure.