Almanac

BuiltRendered from 46a-almanac.md in the public repository. Edits belong there.

Almanac creates farm fields and plots as nodes of a sandbox's local domain, plans plantings on them, and searches the shared taxonomy.


Package	`almanac`, version 1.1.0
Kind	App. Hub tool `almanac`, a declared hub
Marketplace	Listed under Oveure (`descends_from`)
For	An instance that keeps fields and plots
Own sandbox	None; it works in the sandbox it is opened on
Ports	None
Preview	Demo. The taxonomy search is public at micyte.com/tools/almanac

What it turns on

Installing exposes two tools: almanac (the hub) and taxonomy_browser. The hub draws five tabs.

Tab	Drawn when	Content
Fields	Always	The farm tab of `agronomics_viewer`: the farm profile and `object_manager` (infrastructure and people). Without a `farm_profile` it states what is missing.
Plan	The sandbox holds a `farm_profile`	The plan tab of `agronomics_viewer`: `plot_overview`, `planting_map`, `planting_calendar`, `plot_manager`
Taxa	Always; the default tab	`taxonomy_browser`: the txa tree of the taxonomy sandbox, searchable, with each taxon's parent, level and profile. The level is inferred until the store has a rank column.
Products	The sandbox holds a `farm_profile`	`taxa_product_table`: the farm's product profiles grouped by taxon. Read-only.
Domain	Always; last	`lcl_editor` on the sandbox's local domain

The tools composed into Fields and Plan are registered tools that no package lists. Almanac draws them; installing it does not expose them separately.

What it reads and writes

Requires the lcl_domain document (archetype local_domain_log). Installing provisions it when it is absent.
Reads the sandbox's farm_profile and local domain, and the txa tree of the taxonomy sandbox.
The package declares no writes of its own. The tools it draws declare these:

Tool	Declared writes
`object_manager`	`create_object`, `save_object`, `delete_object`
`plot_manager`	`save_field`, `save_cluster`, `delete_cluster`, `save_plots`, `delete_plots`, `effective_day`
`planting_map`	`add_planting`
`lcl_editor`	The editor's node and document writes, listed on Oveure

Installing grants none of these; the host checks each write against the instance's write grants.

Status

Built and published. A demo exists.

Source

micyte/tools/almanac.py: the declaration and its tabs
micyte/tools/agronomics_viewer.py: Fields and Plan
micyte/tools/taxonomy_browser.py and micyte/tools/taxa_product_table.py
micyte/tools/_packages.py: _almanac_package