Lolly
Buka Aplikasi
  1. Otomatiskan
  2. Arsitektur dan kontrak

Document model draft

This draft specification for review, dated 2026-09-24, describes what a complete, portable Lolly tool is made of, so any shell can open one and do the same things with the tool. If you build a shell, write tools at scale or review how Lolly records its work, read the chapter for your work and send what you find.

Catatan: Not normative yet

Nothing in this draft is normative until the status chapter records that the review happened.

The four records: definition, instance, evaluation and artifact, each named with the contract that holds it todayOpen this in Diagram Builder

What the draft says

A Lolly document is a complete tool: its typed interface, the content someone authored, its dependencies, rules and behaviour, and the operations it offers. The glossary defines a tool as a directory holding a manifest, a template and optional hooks. A document is that material plus the state a person authored and the results of running the tool.

Four records carry a document: a definition, an instance, an evaluation and an artifact. Each carries its own schema version, and a reader may upgrade a record when reading one. Records and identity shows which contract in this repository holds each record today.

An operation is what a tool can do: render, transform, extract, inspect, present or perform an authorised action. One tool may offer several. The operation is the shared interface, whatever produces the result. A valid tool never needs a canvas. The on-device utilities take a file in and hand bytes out. Unpack, Prepare, Batch, Lolly Verify and the Lolly Rebrand review are web app routes, not manifest tools. Each gets a typed operation adapter with a typed outcome, and none needs a drawing surface.

Compositions, timelines and recorded sessions are optional. An authored instance and one evaluation of it keep separate identities, so a new organisation policy never rewrites what someone authored. Rules travel with a tool and may also come from a Lolly Work instance, which also supplies the authority that accepts a result. Governance never decides what a render or an operation means; the definition does. Outside a governed instance, the person at the keyboard holds the acceptance authority.

Status

StateWhat it covers
DecidedThirteen confirmed directions (D1 to D13), fifteen resolutions from evidence (R1 to R15) and six answered questions (Q1 to Q6). Nine corrections from the final review (C1 to C9) are folded in.
OpenThe review of the chapters. The draft notice stays until the status chapter records that people have read them.
Not builtEvery type, every schema and every fixture. This draft adds nothing to packages/core and nothing to schemas/.

The chapters cite each point by an id. A D id is a confirmed direction. An R id is a resolution proposed from evidence, which stands unless the review overturns that resolution. A C id is a correction the final review made before drafting started. A Q id is a question the maintainer answered on 2026-10-16, accepting the recommended defaults for Q1 to Q5 and recording Q6 as decided: the specification is public from its first draft.

A review of digital asset management on 2026-10-15, and a production review after it, added requirements, among them exact source files, imported evidence, review scope, current source and processing authority, typed content and locale bindings, explicit action targets and asynchronous readiness. The four records and the Lolly Design, Lolly Chart and Agenda pilots stay as they are. Cases 30 to 44 describe the new requirements, which are not yet contract fixtures. The status chapter records the review's scope and the remaining work.

Where to read the specification

The specification is a web document of twelve chapters. Read it in the app, with the chapter list, the headings and a search field. The same chapters are on this site:

The model

Rules, trust and status

The twelve chapters, in order, are also one file, document-model.md, to read offline or hand to an agent.

How to review a chapter

Read a chapter, then open an issue on the repository that quotes the chapter and heading.

What this draft does not claim