xiaoju
8ce1dd3cca
refactor: remove JSON output requirement from reviewer prompt
...
Let extractMetaOrThrow do its job — agent outputs naturally,
LLM extract handles structuring.
2026-05-06 10:35:53 +00:00
xiaoju
4b27943871
refactor: simplify reviewer — discriminated union meta, minimal prompt
...
- ReviewerMeta → discriminated union: approved | rejected (with issues)
- Remove method-heavy prompt — agent has built-in code review capability
- Prompt now just says: project path, threadId for context, approve or reject
- No non-blocking suggestions (they get ignored anyway)
- ReviewerConfig simplified to just { cwd }
2026-05-06 10:29:48 +00:00
xiaoju
8d5b97c67e
feat: add threadId to ThreadContext and WorkflowFnOptions
...
Agentic roles can now access ctx.threadId to query thread details
via uncaged-workflow CLI for richer context.
2026-05-06 10:23:25 +00:00
xiaoju
513c006ce3
refactor: rename workflow-role-llm → workflow-agent-llm
...
The package only contains createLlmAdapter (OpenAI chat → AgentFn),
which is an agent adapter, not a role. Aligns with workflow-agent-cursor
and workflow-agent-hermes naming.
2026-05-06 10:14:35 +00:00
xiaoju
2cd2a7d713
Merge pull request 'fix(workflow): add typecheck script and fix remaining type errors' ( #18 ) from fix/review-feedback-and-typecheck into main
2026-05-06 10:11:47 +00:00
xingyue
94fa964b84
fix(workflow): add typecheck script and fix remaining type errors
...
- Add typecheck script (bunx tsc --build) to package.json
- Update check script to run typecheck before biome
- Fix mock fetch casts in test files (bun-types preconnect)
- Fix RequestInfo → Request | string | URL in llm-extract test
- Fix ThreadContext generic cast in solve-issue-template test
- Fix git-exec.ts missing return and module resolution
- Remove @types/node from workflow-role-committer
- Add exports field to workflow-util-agent/package.json
2026-05-06 18:10:25 +08:00
xiaoju
2c642b1a53
refactor: committer as pure agent role with discriminated union meta ( #17 )
...
- Remove hardcoded git commands (git-exec.ts deleted)
- CommitterMeta is now a discriminated union: committed | failed
- Agent handles git operations, committer extracts structured result
- Moderator can route on meta.status for retry logic
Closes #17
2026-05-06 10:06:27 +00:00
xiaoju
c15a5554c0
refactor: replace gitExec with spawnCli from workflow-util-agent
...
Remove hand-rolled execFile + promisify, delegate to spawnCli.
Same throw-on-error interface, better error messages.
2026-05-06 09:51:06 +00:00
xiaoju
e38852a761
Merge pull request 'fix(workflow): resolve type errors across all packages' ( #16 ) from fix/type-errors-and-tsbuildinfo into main
2026-05-06 09:44:49 +00:00
xiaoju
fd8f1f2491
refactor: move createRole to workflow-util-role
...
workflow-role-llm now only contains createLlmAdapter (OpenAI chat
completions → AgentFn). All role infrastructure lives in util-role.
2026-05-06 09:42:49 +00:00
xingyue
98b6153070
fix(workflow): resolve type errors across all packages and remove tsbuildinfo from tracking
...
- Add bun-types and @types/xxhashjs to root devDependencies
- Add types: ['bun-types'] to root and package tsconfigs
- Fix AST Node type narrowing in bundle-validator.ts with AcornNode type and narrowNode helper
- Fix generic ThreadContext variance in create-role-moderator.ts
- Add explicit parameter types in worker.ts
- Fix ChildProcess type in worker-spawn.ts to match spawn() stdio config
- Remove all tsconfig.tsbuildinfo from git tracking
- Add tsconfig.tsbuildinfo to .gitignore
2026-05-06 17:41:11 +08:00
xiaoju
c04e7c31af
refactor: move llmExtract, extractMeta, buildDescriptor, types to workflow-util-role
...
workflow-role-llm now only contains LLM-as-agent specifics:
- createRole (wires agent + extract)
- createLlmAdapter (OpenAI chat completions agent)
workflow-util-role now provides all role infrastructure:
- decorators (decorateRole, withDryRun, onFail)
- llmExtract / extractMetaOrThrow (structured extraction)
- buildDescriptorFromRoles (zod → JSON Schema)
- LlmProvider, LlmMessage types
2026-05-06 08:13:27 +00:00
xiaoju
6e62c7458d
refactor: remove schemaDefaults, use caller-provided dryRunMeta
...
Cursor completed removal of schemaDefaults. All dry-run paths now
use explicit dryRunMeta from the caller.
2026-05-06 08:10:40 +00:00
xiaoju
82d3478895
refactor: extract @uncaged/workflow-util-role from role-llm ( #15 )
...
Move pure role utilities (decorateRole, withDryRun, onFail, schemaDefaults)
into @uncaged/workflow-util-role. extractMetaOrThrow stays in role-llm
since it depends on LLM capabilities.
Dependency graph (no cycles):
util-role → workflow
role-llm → workflow, util-role
committer → workflow, util-role, role-llm
Closes #15
2026-05-06 07:27:11 +00:00
xiaoju
2a71454c10
refactor: extract @uncaged/workflow-util-agent + smart prompt
...
- New package: spawn-cli + build-agent-prompt shared utils
- Smart prompt: start + meta summaries for middle steps + last step full
- Cursor/Hermes adapters now import from util-agent (no duplicate code)
- 109 tests pass, biome clean
Closes #14
小橘 <xiaoju@shazhou.work >
2026-05-06 07:17:59 +00:00
xiaoju
db5cbd49e2
feat: @uncaged/workflow-template-solve-issue — first workflow template
...
planner → coder → reviewer → committer flow with retry logic.
- createSolveIssueWorkflow factory (agent-agnostic)
- buildSolveIssueDescriptor with zod@4 JSON Schema
- Moderator: reviewer reject → coder retry, maxRounds → END
- 103 tests pass, biome clean
Closes #13
小橘 <xiaoju@shazhou.work >
2026-05-06 07:04:28 +00:00
xiaoju
78d883ec5d
feat: @uncaged/workflow-role-committer + @uncaged/workflow-role-reviewer
...
- Committer: git add/commit/push with LLM-generated branch+message
- Reviewer: code review role with approval meta
- Both use zod@4 schemas, no nerve-core deps
- 98 tests pass, biome clean
Closes #12
小橘 <xiaoju@shazhou.work >
2026-05-06 06:59:44 +00:00
xiaoju
f21014fcdd
feat: @uncaged/workflow-agent-cursor + @uncaged/workflow-agent-hermes
...
- Cursor adapter: spawn cursor-agent CLI, auto/specified model
- Hermes adapter: spawn hermes chat CLI
- Both: AgentFn interface, no nerve-core deps, Result-based config validation
- 93 tests pass, biome clean
Closes #10 , Closes #11
小橘 <xiaoju@shazhou.work >
2026-05-06 06:54:24 +00:00
xiaoju
c2a8f2d81b
feat: @uncaged/workflow-role-llm — role factory + zod@4 schema
...
Migrated from nerve/workflow-utils:
- createRole with zod@4 schema → typed meta + JSON Schema
- createLlmAdapter — LLM provider abstraction
- llmExtract/llmExtractWithRetry — structured output extraction
- decorateRole/withDryRun/onFail — role decorators
- buildDescriptorFromRoles — auto-generate descriptor from zod schemas
- Zero nerve-core dependencies
- 83 tests pass, biome clean
Closes #9
小橘 <xiaoju@shazhou.work >
2026-05-06 06:50:19 +00:00
xiaoju
3467b772e6
refactor: named exports (run + descriptor), remove build pipeline
...
- Bundle contract: export const run + export const descriptor (no default export)
- add only accepts .esm.js, extracts descriptor via dynamic import → .yaml
- Removed: build-pipeline, generate-types, json-schema-to-ts
- Worker loads mod.run instead of mod.default
- Biome: no more noDefaultExport overrides for bundles
- 62 tests pass, biome clean
Closes #8
小橘 <xiaoju@shazhou.work >
2026-05-06 06:39:15 +00:00
xiaoju
e670047e6a
feat: build pipeline — .ts → .esm.js + .yaml + .d.ts 三件套
...
- add command auto-detects .ts vs .esm.js input
- .ts: Bun.build → bundle + descriptor extraction + JSON Schema → .d.ts
- .esm.js: requires .yaml alongside, .d.ts optional
- JSON Schema → TypeScript type converter
- hello-world example workflow
- 63 tests pass, biome clean
Closes #7
小橘 <xiaoju@shazhou.work >
2026-05-06 06:26:14 +00:00
xiaoju
47e8fdf5b3
chore: replace hand-written xxhashjs.d.ts with @types/xxhashjs
...
小橘 <xiaoju@shazhou.work >
2026-05-06 06:21:46 +00:00
xiaoju
dfbba0f58c
feat: Phase 4 — fork threads + bun publish verified
...
- fork-thread.ts: parse .data.jsonl, trim steps by role
- cmd-fork.ts: --from-role <role> or retry last step
- engine: forkFrom lineage tracking, prefilled step replay
- worker: accept steps in run IPC command
- bun publish --dry-run: both packages pass
- 53 tests pass, biome clean
Closes #5
小橘 <xiaoju@shazhou.work >
2026-05-06 05:45:01 +00:00
xiaoju
0becafeb44
feat: Phase 3 — version history/rollback + pause/resume threads
...
- CLI: history, rollback, pause, resume commands
- Registry: rollbackWorkflowToHistoryHash
- Engine: awaitAfterEachYield hook for pause gate
- Worker: ThreadPauseGate with Promise-based latch
- TCP IPC: bidirectional response for kill/pause/resume
- 44 tests pass, biome clean
小橘 <xiaoju@shazhou.work >
2026-05-06 05:36:33 +00:00
xiaoju
9943f21f5c
refactor: WorkflowFn input → ThreadInput, remove threadId from bundle contract
...
- WorkflowFn first param is now ThreadInput { prompt, steps }
- threadId removed from WorkflowFnOptions and ThreadContext (engine-only)
- createRoleModerator seeds context from input.steps (fork/resume ready)
- New test: pre-filled steps skip already-completed roles
Closes #6
小橘 <xiaoju@shazhou.work >
2026-05-06 05:27:14 +00:00
xiaoju
9a4cec2b2d
docs(rfc-001): WorkflowFn input → ThreadInput for fork/resume support
...
- First param is now { prompt, steps } instead of bare prompt
- steps: [] for new thread, pre-filled for fork/resume
- createRoleModerator naturally handles resume via moderator routing
- No special replay logic needed
小橘 <xiaoju@shazhou.work >
2026-05-06 05:25:00 +00:00
xiaoju
eda00d1c8e
docs(rfc-001): bundle contract → AsyncGenerator, Role/Moderator → helper pattern
...
Breaking design change:
- Section 2: WorkflowFn is now an AsyncGenerator that yields RoleOutput
- Section 8: Role/Moderator demoted from contract to optional helper
- Engine controls the loop via generator protocol (DIP)
- Zero injection — bundles don't import engine types
小橘 <xiaoju@shazhou.work >
2026-05-06 05:18:56 +00:00
xiaoju
7582a88d6b
feat: Phase 2 — Thread lifecycle, execution engine, worker, CLI
...
- types.ts: START/END, RoleMeta, ThreadContext, Role, Moderator, WorkflowDefinition
- engine.ts: executeThread with JSONL persistence + AbortSignal
- worker.ts: per-bundle process, TCP IPC, kill individual threads
- CLI: run/ps/kill/threads/thread/thread rm commands
- 32 tests pass, biome clean
小橘 <xiaoju@shazhou.work >
2026-05-06 04:59:54 +00:00
xiaoju
01e930df8f
docs(rfc-001): add execution model — Role, Moderator, Agent types
...
Ported from nerve's workflow types. Covers ThreadContext, StartStep,
RoleStep, Moderator (pure router), Role (async actor), AgentFn (LLM adapter),
WorkflowDefinition, and execution flow.
小橘 <xiaoju@shazhou.work >
2026-05-06 04:41:52 +00:00
xiaoju
e9729fbe3a
chore: add structured logging convention + ban console.*
...
- biome.json: noConsole rule (nursery)
- CLAUDE.md: logging section — fixed 8-char Crockford Base32 tag per call site,
createLogger() API, CLI exception documented
小橘 <xiaoju@shazhou.work >
2026-05-06 04:33:33 +00:00
xiaoju
eeb5fa0d75
chore: add coding conventions from nerve
...
- CLAUDE.md: functional-first, type over interface, no optional props, Result type
- biome.json: lint + format config (Biome 1.9)
- tsconfig.json: strict mode, composite project references
- .cursor/rules: global conventions + no-dynamic-import
Adapted from uncaged/nerve for bun workspace.
小橘 <xiaoju@shazhou.work >
2026-05-06 04:26:03 +00:00
xiaoju
8939194133
init: bun workspace + RFC-001 workflow engine design
...
- @uncaged/workflow (core lib) + @uncaged/cli-workflow (CLI)
- RFC-001: full design doc covering storage, threading, CLI
小橘 <xiaoju@shazhou.work >
2026-05-06 04:20:05 +00:00