uncaged/workflow
Archived
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add office-agent document workflow (template + writer + differ) #318

Closed
jiayi wants to merge 19 commits from user/jiayiyan/feat_office-agent-document-template into main
pull from: user/jiayiyan/feat_office-agent-document-template
merge into: uncaged:main
Conversation 0 Commits 19 Files Changed 111
+8673 -16
jiayi commented 2026-05-18 12:07:18 +00:00
Member
Copy Link
Copy Source

Summary

  • workflow-template-document — pure workflow structure: writer/differ role definitions (Zod v4 discriminated union), ModeratorTable, documentWorkflowDefinition, buildDocumentDescriptor()
  • workflow-agent-office — AdapterFn calling office-agent CLI; generate mode produces output.docx, edit mode snapshots original.docx + overwrites modified.docx; exports packageDescriptor
  • workflow-agent-docx-diff — AdapterFn calling docx-diff CLI; treats exit 0/1 as success, exit ≥2 as error; exports packageDescriptor

Both agents implement AdapterFn directly (schema.parse(JSON.parse(raw))), skipping LLM extraction for deterministic CLI output.

Architecture

START → writer ──(edit mode)──→ differ → END
↘(generate mode)→ END

Writer saves two workflow-owned files in edit mode (original.docx + modified.docx), so differ never depends on the user's original path.

## Summary - **`workflow-template-document`** — pure workflow structure: writer/differ role definitions (Zod v4 discriminated union), ModeratorTable, `documentWorkflowDefinition`, `buildDocumentDescriptor()` - **`workflow-agent-office`** — `AdapterFn` calling `office-agent` CLI; generate mode produces `output.docx`, edit mode snapshots `original.docx` + overwrites `modified.docx`; exports `packageDescriptor` - **`workflow-agent-docx-diff`** — `AdapterFn` calling `docx-diff` CLI; treats exit 0/1 as success, exit ≥2 as error; exports `packageDescriptor` Both agents implement `AdapterFn` directly (`schema.parse(JSON.parse(raw))`), skipping LLM extraction for deterministic CLI output. ## Architecture START → writer ──(edit mode)──→ differ → END ↘(generate mode)→ END Writer saves two workflow-owned files in edit mode (`original.docx` + `modified.docx`), so differ never depends on the user's original path.
jiayi added 24 commits 2026-05-18 12:07:19 +00:00
refactor: rename casRef to x-cas-ref for JSON Schema compliance 33f9425848 
Rename .meta({ casRef: true }) to .meta({ 'x-cas-ref': true }) across
all schema annotations. Zod v4 toJSONSchema automatically outputs
x-cas-ref in the generated JSON Schema, so buildDescriptor preserves
the annotation without any code changes.

Add buildDescriptor test verifying x-cas-ref appears in descriptor
output for annotated fields and is absent for plain fields.

220 tests pass, 0 fail.

Fixes #291, Refs #285
Merge pull request 'refactor: rename casRef to x-cas-ref for JSON Schema compliance (Phase 3)' (#292) from feat/285-phase3-x-cas-ref into main ebfb99bf4c
docs: add .cards/ architecture documentation 2b21d981dd 
12 interlinked architecture cards + index, covering:
- Core: Bundle, Thread, CAS, Registry
- Execution: Engine, Role, Agent Binding, Reactor
- Tooling: CLI, Dashboard, Package Map
- Authoring: Workflow Templates

小橘 <xiaoju@shazhou.work>
chore: remove _spec.md from cards (build artifact) bb3618cc42 
小橘 <xiaoju@shazhou.work>
Merge pull request 'docs: add .cards/ architecture documentation' (#293) from docs/architecture-cards into main 0da1aabfab
feat: JSONata moderator engine (Phase 2 of #294) dfeba9d8fc 
- evaluateModerator(rules, context) with JSONata expression evaluation
- Fallback (when: null), conditional branching, no-match → __end__
- Full develop workflow moderator ported to JSONata
- 31 tests passing

Closes #295
小橘 <xiaoju@shazhou.work>
Merge pull request 'feat: JSONata moderator engine (Phase 2 of #294)' (#296) from feat/294-jsonata-moderator into main 6af3059fb4
feat: Phase 3 — workflow JSON definitions in CAS 9e99e58405 
- New package: @uncaged/workflow-json-def
- registerWorkflow/loadWorkflow for CAS round-trip
- solve-issue and develop templates converted to pure JSON
- Zod schemas → JSON Schema, moderator → JSONata
- 30 tests passing, biome clean

Closes #297
小橘 <xiaoju@shazhou.work>
Merge pull request 'feat: Phase 3 — workflow JSON definitions in CAS' (#298) from feat/294-phase3-workflow-json into main f9d3d38008
feat: Phase 4 — json-cas engine (new engine alongside old) e01c08dacb 
- json-cas-engine.ts: new engine using json-cas Store + typed nodes
- json-cas-context.ts: build ThreadContext from thread-step chain
- json-cas-types.ts: engine types (JsonCasEngineIo, JsonCasAgentFn, etc.)
- thread-start/step/end/content nodes in json-cas format
- JSONata moderator via evaluateModerator
- react placeholder (Phase 5 will fill in)
- 21 tests passing, biome clean

Closes #299
小橘 <xiaoju@shazhou.work>
Merge pull request 'feat: Phase 4 — json-cas engine migration' (#300) from feat/294-phase4-engine-migration into main 5af2d54e0f
feat: Phase 5 — React layer instrumentation 94c719870f 
- json-cas-react-recorder.ts: writeReactSession stores full ReAct trace
- ReactTrace/ReactTurnTrace/ReactToolCallTrace types
- JsonCasAgentResult with optional react trace
- Engine integration: real react-session when trace provided, placeholder when null
- 10 new tests (29 total for json-cas engine), biome clean

Closes #301
小橘 <xiaoju@shazhou.work>
Merge pull request 'feat: Phase 5+6 — React layer + Agent model' (#303) from feat/294-phase5-react-layer into main 33cf23ed01
chore: switch json-cas deps from file: to npm ^0.1.0 34e00bebdf 
小橘 <xiaoju@shazhou.work>
chore: remove pnpm-lock.yaml + enforce bun-only installs 67b0dac3e8 
- Delete accidentally committed pnpm-lock.yaml
- Add pnpm-lock.yaml, package-lock.json, yarn.lock to .gitignore
- Add packageManager field (bun@1.3.13)
- Add preinstall script that errors when not using bun
feat: Phase 7 — CLI json-cas commands d1a0a135d4 
- json-cas init/workflow register+show/thread show/node get+list+walk
- Nested subcommand dispatch under 'json-cas' group
- Default store: ~/.uncaged/workflow/json-cas/
- 15 tests passing, biome clean

Closes #304
小橘 <xiaoju@shazhou.work>
Merge pull request 'feat: Phase 7 — CLI json-cas commands' (#305) from feat/294-phase7-cli into main ca5cff0fbd
chore(template): scaffold workflow-template-document package b89a472600 
Add package.json, tsconfig.json, and placeholder src/index.ts for the
@uncaged/workflow-template-document package; register it in root tsconfig.json references.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
feat(template): add workflow-template-document with writer/differ roles and moderator 8d797a3954 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
feat(agent): scaffold workflow-agent-office package 3a2cc2dd45 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
feat(agent): add workflow-agent-office with generate/edit AdapterFn 73d3591230 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
feat(agent): scaffold workflow-agent-docx-diff package 4ccd4c73ba 
Add package.json, tsconfig.json, and placeholder src/index.ts for
@uncaged/workflow-agent-docx-diff; append reference in root tsconfig.json.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
feat(agent): add workflow-agent-docx-diff with docx-diff AdapterFn d9de9aacef 
Implements createDocxDiffAgent (AdapterFn), packageDescriptor, and exports in index.ts; 9 tests pass (runner 6 + agent 3).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
docs(architecture): add workflow-agent-office, workflow-agent-docx-diff, workflow-template-document 5d5cc5810a 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
jiayi force-pushed user/jiayiyan/feat_office-agent-document-template from 5d5cc5810a to 5342fa95f2 2026-05-18 12:18:12 +00:00 Compare
jiayi closed this pull request 2026-05-18 13:27:36 +00:00
This repo is archived. You cannot comment on pull requests.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
1 Participants
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/workflow#318
Delete Branch "user/jiayiyan/feat_office-agent-document-template"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?