docs/f0/api-entry-doors.json

1{

2 "schema": "folio-f0-entry-doors-v1",

3 "frozen_at_commit": "17d29bb74c31424bc9daabf61f9e2c20c1b99435",

4 "startup": {

5 "entry": "(folio main):main",

6 "root_source": "FOLIO_ROOT environment variable",

7 "side_effects": ["store-ensure-dirs!", "make-folio-index", "index-reconcile!", "MCP stdio loop"],

8 "optional": ["--web", "--web-port PORT"]

9 },

10 "discovery": {

11 "inbox": "(folio store):store-inbox-path -> <root>/inbox.md",

12 "projects": "(folio store):store-project-files -> flat projects/*.md",

13 "notes": "(folio store):store-note-files -> recursive notes/**/*.md",

14 "archives": "paths exist but current store discovery/query does not enumerate them"

15 },

16 "library_query_entry_doors": [

17 "(folio query):all-tasks", "(folio query):filter-tasks", "(folio query):folio-status",

18 "(folio note):all-notes", "(folio note):search-notes", "(folio links):find-orphaned-notes",

19 "(folio index):search-index"

20 ],

21 "index_entry_doors": [

22 "make-folio-index", "index-reconcile!", "index-rebuild!", "index-note!",

23 "index-note-by-name!", "remove-note-from-index!", "rename-note-in-index!"

24 ],

25 "mutation_entry_doors": {

26 "inbox": ["inbox-add!", "inbox-remove-by-id!", "inbox-sweep!"],

27 "project": ["project-create!", "project-add-task!", "project-add-log!", "project-archive!", "project-clean!"],

    "note": ["note-create!", "note-edit!", "note-edit-tasks!", "note-append!", "note-patch!", "note-rename!", "rename-crosslinks!"],

    "store_level_tools_helpers": ["complete-task-in-store!", "uncomplete-task-in-store!", "update-task-in-store!", "move-task-in-store!"],

30 "migration": ["migrate-buried-plan", "migrate-buried-apply!"],

    "warning": "Current writes are direct read/transform/write operations; there is no shared revision/coordinator transaction boundary."

32 },

33 "external_entry_doors": {

34 "mcp": "register-folio-tools! registers the folio/* tools frozen in mcp-tools.txt",

35 "web": "(folio web):start-folio-web-server!; handlers call the same store/query/mutation modules",

36 "cli": "bundled folio executable; --version and MCP stdio by default; --web/--web-port adds HTTP"

37 }

38}