Skip to content
Menu

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 --json

Output

{
  "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 --json

Output

{
  "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
commandsLists every command the module offers.
selfcheckChecks the installed file and the database, applies pending database updates and lists any problems in plain words.
ingestReads a contract from a plain text file and stores it with its parties and dates.
proposeAdds proposed obligations and accepts only those whose quote appears exactly once in the contract text.
amendApplies an amendment to one clause, ending or replacing the obligations it affects.
in-forceLists the obligations that apply on a given date.
dueLists overdue and upcoming work, each with a suggested task.
completeMarks 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.