Contracts module
Keeps a register of the obligations in your contracts, each tied to an exact quote, with due dates.
On this page
What it is for
Keeps a register of the obligations in your contracts, each tied to an exact quote, with due dates.
- You signed an agreement and want its duties and dates tracked.
- An agreement was amended and the duties need to change from a set date.
- You want to see what is due in the coming weeks.
Ask your bot
You do not type commands. Ask in plain words and the bot runs the module for you.
- You ask
- Here is the text of the agreement we just signed. What do we have to do, and by when?
- What you get back
- The bot lists each obligation it proposes, the exact sentence it comes from and its due date. Review its reading before you rely on it.
What the bot does with it
- The bot reads a contract you provide as text and proposes obligations with the exact sentence each one comes from.
- The module rejects any quote that is not found word for word, or that appears more than once.
- It works out due dates for one-time and repeating obligations and lists what is due soon.
- The bot passes each suggested task to the tasks module unchanged, so a retry does not create a duplicate.
- The module does not decide what a clause means. A person should review the bot's reading before relying on it.
What it stores
Contract text, amendments, obligations and their history live in one SQLite file, contracts/contracts.sqlite, in the bot's Ambitious folder (/workspace/ambitious by default). The module reads plain text files and does not produce documents.
The module has no screens of its own. It reads JSON, writes JSON, and keeps its data under /workspace/ambitious on the bot's computer. It never sends data anywhere.
Command reference
For the technically curious. You will rarely type these yourself; the bot runs them. Every command answers with the same envelope: whether it worked, which module and command ran, the data, and a list of errors with a hint for each. Open an example to see the command and its output.
ExampleStore a contract from a plain text file. The module returns an identifier and the hash of the file.
Command
echo '{"title":"Service agreement","party":"provider","path":"service-agreement.txt"}' | ambitious-contracts ingest --jsonOutput
{
"ok": true,
"schemaVersion": 1,
"module": "contracts",
"command": "ingest",
"data": {
"contractId": "contract-1",
"sha256": "9f2c4e6a8b0d1f3577a9c1e3052846b8d0f2a4c6e8b1d3f5a7c9e0b2d4f6a8c1"
},
"errors": [],
"meta": { "now": "2026-03-02T09:00:00.000Z", "seed": 7, "version": "0.1.0" }
}ExamplePropose an obligation with a reworded quote. The command succeeds, but the proposal is listed as rejected because the quote is not in the contract word for word.
Command
ambitious-contracts propose --in proposal.json --jsonOutput
{
"ok": true,
"schemaVersion": 1,
"module": "contracts",
"command": "propose",
"data": {
"accepted": [],
"rejected": [
{
"index": 0,
"code": "E_QUOTE_NOT_LITERAL",
"why": "The quote must exactly match a nonempty span of the normalized contract text."
}
]
},
"errors": [],
"meta": { "now": "2026-03-02T09:00:00.000Z", "seed": 7, "version": "0.1.0" }
}Show every command
| commands | Lists every command the module offers. |
|---|---|
| selfcheck | Checks the installed file and the database, applies pending database updates and lists any problems in plain words. |
| ingest | Reads a contract from a plain text file and stores it with its parties and dates. |
| propose | Adds proposed obligations and accepts only those whose quote appears exactly once in the contract text. |
| amend | Applies an amendment to one clause, ending or replacing the obligations it affects. |
| in-force | Lists the obligations that apply on a given date. |
| due | Lists overdue and upcoming work, each with a suggested task. |
| complete | Marks one occurrence of an obligation as done and moves a repeating one to its next due date. |
Source and releases
The module is open source under the Apache license. Each release carries one bundled file and its checksums; the bot installs it for you.