Control roles in the journal (books.assign_role, books.roles); the MCP reloads wanderbooks.toml on change and reports settings problems (books.settings, digest); new writes a full commented wanderbooks.toml
check / check (push) Canceled after 0s

- core: ControlAccount keys, Ledger::assign_role/check_assign_role/role_account (rules.md B-23): one account per role, of the role's type, balance sheet roles move only when empty; invoices, bills, payroll, remittance, and closes post to the assigned account; an assigned role frees its default code for renumbering
- store: role.assigned journaled and replayed (strict account_id)
- mcp: settings.rs reloads by content at the start of each request, keeps the last good settings on a broken edit; books.settings with chart problems; digest settings_problems; instructions say when to edit the toml
- viewer: journal text for role.assigned
- cli: full example wanderbooks.toml, tested to load with every example uncommented
- tests: spec_roles.rs (25, spec-blind), store roles.rs (6), MCP reload/problems/roles, settings unit tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GWVo7x3UHw5kwCUaWxiejX
This commit is contained in:
swaitsandClaude Opus 5.5 committed 2026-10-15 10:30:16 -06:00
1 parent efa370dfa3
commit 1771d87e0e
19 files changed
+3044 -132

No files matched your search

+36 -3
View File
@@ -1235,7 +1235,8 @@ impl Store {
Ok(())
}
/// Fetch a control account by code, creating it through the journaled
/// Fetch a control role's account (the one assigned to it, else by
/// code), creating it at its code through the journaled
/// account path when missing. The ledger's internal ensure_account
/// then no-ops, which keeps replay deterministic: every account
/// creation is an `account.added` event.
@@ -1243,8 +1244,8 @@ impl Store {
&mut self,
c: &ledger_core::ControlAccount,
) -> Result<AccountId, StoreError> {
if let Some(a) = self.ledger.chart().find_by_code(c.code) {
return Ok(a.id);
if let Some(id) = self.ledger.role_account(c) {
return Ok(id);
}
self.add_account(c.code, c.name, c.account_type, None, false)
}
@@ -2093,6 +2094,25 @@ impl Store {
Ok(())
}
/// Assign a control role an account, or (`None`) return it to its code
/// (see `Ledger::assign_role`). Journaled as `role.assigned`, with the
/// account that filled the role before.
pub fn assign_role(
&mut self,
role: &str,
account: Option<AccountId>,
) -> Result<(), StoreError> {
let c = self.ledger.check_assign_role(role, account)?;
let previous = self.ledger.role_account(c);
let line = self.append_journal(
"role.assigned",
json!({"role": c.key, "account_id": account, "previous_account_id": previous}),
)?;
self.ledger.assign_role(role, account)?;
apply_line_to_sqlite(&self.conn, &line)?;
Ok(())
}
/// Set (or clear) an account's tax category and deductible percent.
/// Journaled as `account.tax_set`.
pub fn set_account_tax(
@@ -3285,6 +3305,15 @@ pub(crate) fn replay_line_into_ledger(
"account.renumbered" => {
ledger.renumber_account(get_u64(p, "account_id")?, get_str(p, "code")?)?;
}
"role.assigned" => {
let account = match p.get("account_id") {
None | Some(Value::Null) => None,
Some(v) => Some(v.as_u64().ok_or_else(|| {
StoreError::JournalCorrupt("role.assigned account_id".into())
})?),
};
ledger.assign_role(get_str(p, "role")?, account)?;
}
"account.tax_set" => {
let pct = match p.get("deductible_percent").and_then(|v| v.as_str()) {
Some(s) => Some(s.parse().map_err(|_| {
@@ -3776,6 +3805,10 @@ fn apply_line_rows(conn: &Connection, line: &JournalLine) -> Result<(), StoreErr
"payroll.taxes_remitted" => {
// The entry was projected by its own events; this only names it.
}
"role.assigned" => {
// Roles live in the ledger (rebuilt by replay); the events
// mirror below keeps the history.
}
"receipt.attached" | "document.filed" => {
conn.execute(
"INSERT OR IGNORE INTO blobs(sha256, size_bytes, mime_type, original_name, created_at) VALUES (?,?,?,?,?)",