Codec Workflow Visualization

Codec Workflow Visualization is a local-first workflow map for AI-assisted work. It helps a human and a Codex-style coding agent keep shared rules, task routing, safety boundaries, and synchronization steps visible as an editable graph.

This public repository is a sanitized release. It contains the generic app code, public documentation, QA scripts, and sample workflow data only.

What This Is

• A static HTML/CSS/JavaScript app.
• A JSON-backed workflow graph.
• A local-first review surface for agent operating rules.
• A reference implementation for turning conversation rules into auditable workflow nodes.

What This Is Not

• It is not a hosted multi-user service.
• It is not a credentials, chat, customer, or mailbox store.
• It does not include a private workflow archive or private deployment history.

Quick Start

node --version
node scripts/validate-workflow-db.mjs
node scripts/qa-public-readiness.mjs
node scripts/local-preview-server.mjs --root app --port 4177

Then open:

http://127.0.0.1:4177/

The public demo database is copied to:

app/database/workflow-db.json

The original sample remains available at:

examples/workflow-db.sample.json

Repository Layout

Path	Purpose
app/	Static UI, graph rendering, workflow document helpers, and optional local server code.
app/database/workflow-db.json	Public sample database used by the app.
examples/	Sanitized example workflow data.
scripts/validate-workflow-db.mjs	JSON database shape validation.
scripts/qa-public-readiness.mjs	Public release QA and private-pattern scan.
docs/codex-agent-guide.md	Handoff guide for future Codex agents.
docs/public-release-boundary.md	Sanitization boundary and release rules.

Codex Agent Handoff

If another Codex agent starts here, read these first:

1. docs/codex-agent-guide.md
2. docs/public-release-boundary.md
3. scripts/qa-public-readiness.mjs
4. scripts/validate-workflow-db.mjs

Verification

node --check app/app.js
node --check app/src/domain/workflow-documents.js
node --check app/src/domain/workflow-file-system.js
node --check scripts/validate-workflow-db.mjs
node --check scripts/qa-public-readiness.mjs
node scripts/validate-workflow-db.mjs
node scripts/qa-public-readiness.mjs
python -m py_compile app/server/workflow_server.py

License

MIT