{"id":51306869,"url":"https://github.com/motus-os/motus-work-ledger","last_synced_at":"2026-07-01T00:30:57.126Z","repository":{"id":358088775,"uuid":"1239923797","full_name":"motus-os/motus-work-ledger","owner":"motus-os","description":"Workflow-neutral work ledger schemas, semantic conventions, conformance, and receipt validation for human, AI, CI, and tool-driven work.","archived":false,"fork":false,"pushed_at":"2026-05-15T18:29:41.000Z","size":101,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T19:25:49.515Z","etag":null,"topics":["ai-agents","ci","conformance","developer-tools","evidence","local-first","provenance","semantic-conventions","work-ledger","work-receipts"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/motus-os.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T15:28:13.000Z","updated_at":"2026-05-15T18:27:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/motus-os/motus-work-ledger","commit_stats":null,"previous_names":["motus-os/motus-work-ledger"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/motus-os/motus-work-ledger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motus-os%2Fmotus-work-ledger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motus-os%2Fmotus-work-ledger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motus-os%2Fmotus-work-ledger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motus-os%2Fmotus-work-ledger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/motus-os","download_url":"https://codeload.github.com/motus-os/motus-work-ledger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/motus-os%2Fmotus-work-ledger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34988712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ci","conformance","developer-tools","evidence","local-first","provenance","semantic-conventions","work-ledger","work-receipts"],"created_at":"2026-07-01T00:30:56.404Z","updated_at":"2026-07-01T00:30:57.112Z","avatar_url":"https://github.com/motus-os.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Motus Work Ledger\n\n\u003e Motus Work Ledger is a workflow-neutral model for consequential human, AI,\n\u003e CI, and tool-driven work. It records work as append-only events and produces\n\u003e verifiable Work Receipts.\n\nThis repository is the canonical portable surface for Motus-compatible Work\nReceipts. It defines the model, schemas, semantic conventions, conformance\nfixtures, validation rules, and examples that other systems can implement\nwithout using the `/motus` reference CLI.\n\n## Why Work Needs A Ledger\n\nImportant work is increasingly performed across pull requests, tickets, CI\nlogs, chat, agent transcripts, scripts, and human approvals. Later, a reviewer\nneeds direct answers:\n\n1. What work was attempted?\n2. Who or what performed it?\n3. What evidence existed?\n4. What outcome was claimed?\n5. What was accepted?\n6. What should happen next?\n\nMotus Work Ledger gives those answers a common structure.\n\n## Core Model\n\n```text\nWork Journal -\u003e Work Ledger -\u003e Work Receipt\n```\n\n- The **Work Journal** is the append-only event stream.\n- The **Work Ledger** is the organized durable work truth.\n- The **Work Receipt** is the portable proof object projected from that truth.\n\nWorkflow tools do the work. Control planes steer the work. Motus records the\nwork. Receipts prove the work.\n\n## What This Repo Contains\n\n- `spec/` - Work Ledger RFC, Work Receipt envelope, canonicalization, and conformance levels.\n- `schemas/` - strict JSON schemas for receipts, events, runs, evidence, routes, and handoffs.\n- `semconv/` - shared semantic attributes and schema mapping.\n- `conformance/` - validator, fixtures, golden hashes, and independent implementations.\n- `examples/` - receipt examples for human, AI, CI, and tool-driven work.\n- `docs/` - technical review, implementation, privacy, terminology, and adoption guidance.\n\nUseful starting points:\n\n- [Technical Review Guide](docs/technical-review-guide.md)\n- [Two-Repo Review Package](docs/two-repo-review-package.md)\n- [Repo Map](docs/repo-map.md)\n- [Terminology](docs/terminology.md)\n- [Work Journal](spec/work-journal.md)\n- [Privacy And Security](docs/privacy-and-security.md)\n- [External Review Checklist](docs/external-review-package.md)\n- [Controlled Design-Partner Pilot](docs/design-partner-pilot.md)\n- [Design-Partner Pilot Runbook](docs/design-partner-runbook.md)\n- [Versioning](VERSIONING.md)\n- [Changelog](CHANGELOG.md)\n- [Schema Registry](schemas/index.json)\n\n## Five-Minute Validation\n\nInstall the validator dependency:\n\n```bash\npython3 -m venv .venv\nsource .venv/bin/activate\npython -m pip install -r conformance/validator/requirements.txt\n```\n\nValidate the registry, conformance suite, and bundled examples:\n\n```bash\npython conformance/validator/check_schema_registry.py\npython conformance/validator/check_semconv_schema_map.py\npython conformance/validator/check_conformance.py\npython conformance/validator/validate_receipt.py examples/*/receipt.json\n```\n\nGenerate and validate a receipt from an implementation that does not import\n`/motus`:\n\n```bash\npython conformance/implementations/receipt-only-python/emit_receipt.py \\\n  --input conformance/implementations/receipt-only-python/input.example.json \\\n  --output /tmp/motus-work-receipt.json\npython conformance/validator/validate_receipt.py /tmp/motus-work-receipt.json\n```\n\nGenerate and validate an event-backed receipt projection:\n\n```bash\npython conformance/implementations/event-backed-python/emit_from_events.py \\\n  --input conformance/implementations/event-backed-python/input.example.json \\\n  --output-dir /tmp/motus-work-ledger-event-backed\npython conformance/validator/validate_receipt.py \\\n  /tmp/motus-work-ledger-event-backed/receipt.json\n```\n\n## Relationship To `/motus`\n\n`/motus` is the reference implementation. It provides the CLI, local Store\nruntime, adapters, and compatibility paths that exercise this model.\n\nThis repository is the canonical portable model. Other systems can emit\nMotus-compatible Work Receipts without importing or running `/motus`.\n\n## Non-Goals\n\nMotus Work Ledger is not:\n\n1. a workflow engine,\n2. an agent runtime,\n3. a model router,\n4. a hosted control tower,\n5. a compliance product,\n6. employee surveillance,\n7. a blockchain,\n8. a raw transcript archive.\n\nMotus records consequential work facts, not worker activity streams.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmotus-os%2Fmotus-work-ledger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmotus-os%2Fmotus-work-ledger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmotus-os%2Fmotus-work-ledger/lists"}