Repository navigation
Releases
v1.1.0
v1.0.2
Changelog
Fixes
- fd8052d fix(sam): try two phrases for the signature zone
Documentation
- 0d6afbf docs: use the same tagline as the demo video
- 11985ab docs: name the Meta Model API in the README
- cc28072 docs: add the demo video and the live demo link
- 078c850 docs(examples): give the home loan policy a bank-style layout
Others
- ee2eb69 test: play a full home loan journey through the API
v1.0.1
What's new in v1.0.1
Fixes from a full test with the live Meta models, on policies that the app never saw:
- Scanned policies: a PDF with no text now offers "Read the scan with AI". Muse Spark reads the pages, then the import runs as for a text PDF.
- SAM 3.1: the live model now finds signatures and stamps on scans.
- Citations: the policy text is cut into its real paragraphs, so each step cites its own paragraph.
- Policy update: works on the first draft after an import.
- Language: a French policy gives French steps and roles, and the assistant answers in the language of the request.
- Diagram: ends stay on the right, no label covers a step.
zotra --versionandzotra --helpprint and stop.- The AI replay pack is recorded again for the new prompts.
Try it in 2 minutes
You need Docker with Compose v2.
git clone https://github.com/donovan-ratefison/Zotra.git && cd Zotra
docker compose up -dOpen http://127.0.0.1:8080. No AI key is needed for the demo: the app
replays recorded AI answers for the example policies. The steps are in
examples/ai-replay/README.md. Another PDF or another request needs an
AI key in .env.
The binaries in the archives need PostgreSQL 16: see the Install section
of the README. The compose passwords are for a local trial only.
Changelog
Features
- 6093bca feat(studio): import a scanned policy with the AI page reading
- 6d30640 feat(ai): read the text of a scanned policy with Muse Spark vision
Fixes
- 8a21eb4 fix(studio): scroll the check explanation into view
- d4a6f18 fix(studio): keep the ends on the right and labels off the nodes
- 1ae1d9a fix(ai): answer in the language of the policy and of the request
- 9f046fe fix(studio): cut the policy text into its real paragraphs
- 7a5d3fd fix(cmd): print the version and the help with no server start
- c472358 fix(sam): use the phrases that the live SAM model matches
- 7c9881e fix(ai): draft a policy update for the first version
- 9e09825 fix(ai): explain a replay miss and keep the budget outside the cache
Documentation
- 02804e8 docs: explain the live AI setup with an own Meta key
Others
- 2381626 build: record the AI replay pack again for the new prompts
v1.0.0
Try it in 2 minutes
You need Docker with Compose v2.
git clone https://github.com/donovan-ratefison/Zotra.git && cd Zotra
docker compose up -dOpen http://127.0.0.1:8080. No AI key is needed for the demo: the app
replays recorded AI answers for the example policies. The steps are in
examples/ai-replay/README.md. Another PDF or another request needs an
AI key in .env.
The binaries in the archives need PostgreSQL 16: see the Install section
of the README. The compose passwords are for a local trial only.
Changelog
Features
- e592d9a feat(studio): export the policy draft as a branded HTML file
- 177c5f0 feat(docs): brand the documentation page with the bank profile
- cce7888 feat(web): show the bank profile in the app and the studio
- 1cbf4a5 feat(studio): add the bank settings screen
- 71a0955 feat(web): show the brand loader in every loading view
- e5089fe feat(api): store one bank profile with a logo
- f3865eb feat(web): show the brand loader while the studio waits
- 8b6db3e feat(process): add a percent format to number fields
- 20533eb feat(history): add the demo history command
- b81ac29 feat(history): plan a demo history of the example process
- a2eb7d8 feat(store): create a case and a scan at a given time
- 69f5f36 feat(app): add the live events bar to the supervision
- 1b36a21 feat(app): open a supervised case in the triage deck, read only
- e482029 feat(app): add the side column of the case flow
- ef5d428 feat(app): list the full chain of a case from the triage card
- a4d00bf feat(app): draw the case flow of the closed cases
- 1a65cea feat(app): add the block of a sent decision to the chain
- 1ca91d6 feat(app): open a step panel from the live supervision
- 52331ac feat(app): show the case chain on the triage card
- a5d2f2f feat(app): open the full case from the triage card
- 2c0debd feat(app): draw the live flow diagram in the supervision
- 8d914fc feat(app): open the case documents from the triage card
- d49289b feat(app): add the key figures of the live supervision
- 0fd4c44 feat(api): add the flow figures of a version
- 75365a8 feat(app): add the triage deck screen
- cf67107 feat(app): add the triage model and the check preview client
- 31d2d54 feat(engine): preview the checks of the current step
- 8052a10 feat(studio): show an AI draft of the policy update
- 1644305 feat(ai): draft a policy update for the changes of a version
- 8f7811d feat(studio): upload the policy at import and show the stored policy
- eeaa278 feat(studio): summarize a version compare with the AI
- c8dc911 feat(api): store the policy PDF of a process
- e006a9e feat(studio): open the documentation from the top bar
- 3433681 feat(ai): send document calls to their own endpoint
- 255f749 feat(studio): use the selected step as chat context
- 27f2a23 feat(studio): ask clarifying choices before an AI change
- ab05bd2 feat(studio): compare two versions of a process
- 816b526 feat: generate the documentation of a version
- 2f5e24c feat(studio): archive and restore a process from the library
- 5993ac8 feat(studio): show the external sources of a step on the diagram
- 833a4dc feat(studio): edit link and end details in the side panel
- 8b41ce2 feat(engine): fetch a demo core banking from the example process
- fcae0dd feat(studio): add, link and delete steps by hand on the diagram
- 002ea81 feat(ai): let the AI say that a file is not a credit policy
- 0a222e6 feat(studio): say when a policy PDF has no readable text
- 25c0608 feat(engine): fetch external sources on step entry
- 70d82dd feat(studio): list all processes in a library page
- a8c6764 feat(studio): restate the change request before the AI change
- abcfd86 feat(web): play the animated logo when the studio opens
- 217f734 feat(web): apply the Zotra brand theme to the studio
- 17df951 feat(studio): add the AI assistant chat of the design view
- 71ea450 feat(studio): add the version history and the screen tab of a step
- f2342a2 feat(studio): fit the test screen on one view with a step timeline
- 49b0649 feat(studio): add a guided rule builder for checks
Fixes
- 8df2b6e fix(web): open dialogs with no help tooltip
- 09a549c fix(studio): move the explanation lines into help tooltips
- 83e1b56 fix(web): let the designer choose the currency of a process
- 037adfe fix(studio): compare the inspector with the previous milestone
- 08a0318 fix(app): move the explanation lines into help tooltips
- a77c23b fix(docs): write the process documentation as a policy text
- 4873505 fix(app): draw the case flow without crossing bands
- ea7fea0 fix(studio): show the open state of the Policy button
- 43d3580 fix(studio): show before, after and scope in the test inspector
- 61a41ee fix(app): show a case in two columns
- b9bd5e8 fix(studio): add redo and a status line to the diagram toolbar
- 44b29d7 fix(app): add filter tabs, search, owner and deadline to the inbox
- f4a1f92 fix(app): add a header with the stepper and the deadline to a case
- 7265155 fix(api): keep test cases out of the delivered app
- 0ec7bd9 fix(studio): open the live supervision from the Monitor tab
- ceb6dbe fix(studio): show rates and ratios as percentages
- 411aacd fix(app): put the supervision cards inside the flow area
- 907318a fix(studio): mark the published version that new cases use
- 2e2803c fix(docs): draw the documentation diagram with the studio layout
- 4282914 fix(studio): join split ligatures in the policy text
- 7c8b98e fix(studio): keep links orthogonal after a new gateway
- a085a90 fix(studio): send a decision in one click, after a confirmation
- f99ae6b fix(studio): show scroll buttons on a long test timeline
- 295bb63 fix(studio): create a process from scratch and add a start
- 83a40ca fix(studio): show the final data of a closed test case
- 663bdd5 fix(studio): open a decision that sends the case back
- 562b854 fix(studio): open a readable check in the guided mode
- bc48e3e fix(web): hold the finished logo before the intro fades
- 8ae4730 fix(studio): name checks by number in the audit and the timeline
- d8bca05 fix(studio): count every node as a step in the process library
- 57029d2 fix(studio): keep the path tail in a column and offer other layouts
- 71b8e2e fix(studio): draw the zone boxes on the drawn scan image
- 060f5f9 fix(studio): give each zone of a scan its own key
- 38eab17 fix(studio): name the checks by number and label the document input
- 299b446 fix(studio): keep the process name and the published version in view
- 70ff6df fix(app): show short dates and plain event labels in the app rows
- 286a5a0 fix(ai): send one noun phrase per SAM 3.1 zone request
- cd7777e fix(app): count the open cases of every published version
- f7c70fb fix(studio): open the process library on the studio home
- b2baa1a fix(studio): open the new case form without a tooltip on top
- 65fa4ce fix(web): link a new step an...
v0.3.0 - Delivered app and full test loop
The app leaves the studio: every role works its cases end to end.
Ship. Each role gets a branded app at /app: an inbox of its cases, a case screen with the step form, its documents and scans, supervision with lateness and load, and an audit log with a one-click hash chain check.
Test. The coverage view marks the branches no case has taken, one click asks the AI for the missing test cases, and any past event replays into a fresh case.
Documents. Each step carries its required scans, and the model reads the fields of a scan straight into the form.
Features
- studio: lay out the diagram like the design mockup (446e62a)
- studio: show the branch coverage of the test view (bb9a217)
- web: ship the Inter font with the app (7ac7218)
- studio: give an overview of the process and a live diagram (6994596)
- studio: carry the required documents on the step screen (2cf7749)
- studio: drive the version lifecycle from the top bar (dec6aeb)
- app: deliver the branded app per role (162c727)
- app: add supervision and audit views (9b60b38)
- studio: replay a case from any past event (16df0af)
- app: read the fields of a scan into the step form (b2cd89c)
v0.2.0 - Studio: design and test loops
The studio gains its two main loops.
Design. Import a credit policy PDF, review the AI proposal with diffs, ghost steps and citation chips, then edit each step in the node panel.
Test. Play a case step by step, replay it on the event timeline, watch it move on the diagram, and ask the AI to explain and fix a failed check.
Features
- ai: generate test cases for red edges (354d636)
- studio: draw the process diagram with elk (0dfd477)
- app: store case scans and read their sam zones (eb2dd6e)
- studio: edit a step in the node panel (72fe4c1)
- ai: turn a policy pdf into a process draft (b47a036)
- studio: review the ai proposal before it lands (332e377)
- studio: play a test case on the step screen (c2e366e)
- studio: replay a case on the event timeline (3f2e6e8)
- studio: animate the test case on the diagram (3f73dd8)
- studio: explain a failed check and apply its fix (3a6fa1a)
Fixes
- api: cap the body of a scan upload (f3a424e)
- studio: keep edge pills clear of node cards (815165a)
- studio: keep edge pills off node labels and band the seed (b58ebb5)
Build
- build: skip the local work folder in go vet and go test (84c1c95)
v0.1.1: CI fix
CI fixed: the database tests of the store and api packages ran at the same time on one test database. The check now runs one package at a time, with no test cache. The v0.1.0 code is unchanged.
Fixes
- build: run the go test packages one at a time (d262b77)
Features
- engine: count edge coverage of test cases (dd16735)
v0.1.0: core backend
First working core: format, engine, store and API.
Zotra turns a credit policy into a tested approval app. This first
milestone ships the core backend and the review tooling.
Features
- feat(app): serve the SPA and /api/health from one Go binary
- feat(engine): validate the process file format
- feat(engine): compile and evaluate the CEL rules
- feat(engine): check references of the process file
- feat(engine): validate a full process definition
- feat(engine): run cases on a hash-chained event log
- feat(ai): add the transport modes and the budget guard
- feat(api): store feedback remarks as json files
- feat(web): add the report button and the feedback board
- feat(store): keep processes cases and events in postgresql
- feat(api): serve the process, version and case routes
Build and tests
- build: add a serve target for tests from another machine
- build: serve main for review and capture screenshots
Documentation
- docs: add public README, env example and CI workflow
Refactoring
- refactor: remove references to local files from comments