bkper 4.16.6 → 4.16.8

package/lib/docs/app-building.md

@@ -539,7 +539,9 @@ See [Event Handlers](https://bkper.com/docs/build/apps/event-handlers.md) for de
 
 ### Properties schema
 
-The `propertiesSchema` field defines autocomplete suggestions for custom properties in the Bkper UI, helping users discover the correct property keys and values for your app:
+The `propertiesSchema` field defines autocomplete suggestions for custom properties in the Bkper UI, helping users discover the correct property keys and values for your app.
+
+Suggested keys must follow the same custom property rules as user-entered keys, including the 30-character maximum after normalization.
 
 ```yaml
 propertiesSchema:

package/lib/docs/taxes.md

@@ -14,20 +14,22 @@ Prefer existing trusted routes before creating new ones. If none exists, recomme
 
 ## Loading tax rules
 
-When no trusted local tax route exists, or when the user asks to load jurisdiction rules, use external tax-rule libraries only as discovery sources. They may identify candidate rates, thresholds, deadlines, forms, classifications, and citations, but they are not a final computation route.
+When no trusted local tax route exists, or when the user asks to load jurisdiction rules, use external tax-rule libraries only as live discovery sources. They may identify candidate rates, thresholds, deadlines, forms, classifications, and citations, but they are not a final computation route. Figures derived from bundle data remain provisional until reviewed by a local qualified accountant or advisor.
 
-Do not produce tax numbers from loaded rules until the rule source, tax period, assumptions, and Bkper mappings have been reviewed or approved.
+Do not produce tax numbers from loaded rules until the rule source, tax period, assumptions, and Bkper mappings have been reviewed or approved. If the relevant bundle or skill is not accountant-verified, or verifier status is missing or pending, surface that status to the user and label outputs exploratory / provisional.
 
 Preferred non-MCP OpenAccountants route:
 
-1. Start from `https://www.openaccountants.com/llms.txt`.
-2. Resolve the jurisdiction code, such as `BR`, `GB`, `DE`, `US-CA`, or `CA-ON`.
-3. Fetch `https://www.openaccountants.com/api/bundle/<CODE>`.
-4. Do not use MCP unless the user explicitly requests it.
-5. Record source URL, retrieval date, tax year, quality tier, verifier if present, and citations.
+1. Resolve the jurisdiction code or name, such as `BR`, `GB`, `DE`, `US-CA`, `CA-ON`, or `brazil`.
+2. Fetch `https://www.openaccountants.com/api/bundle/<CODE_OR_NAME>` live for each rule-loading run; do not compute from cached bundle content.
+3. Do not use MCP unless the user explicitly requests it.
+4. If the bundle cannot be resolved, ask the user for the exact jurisdiction or source URL instead of guessing.
+5. Record source URL, retrieval date, tax year, quality tier, verifier if present, and citations, and surface the quality tier to the user.
 6. Map rules only to user-approved Bkper Groups, Accounts, properties, or hashtags.
 
-Example: for Brazil, resolve `BR` and fetch `https://www.openaccountants.com/api/bundle/BR`, then clarify whether the scope is IRPF, Carnê-Leão, payroll, indirect tax, e-invoice compliance, or another Brazil tax area.
+Example: for Brazil, fetch `https://www.openaccountants.com/api/bundle/BR` or `https://www.openaccountants.com/api/bundle/brazil`, then clarify whether the scope is IRPF, Carnê-Leão, payroll, indirect tax, e-invoice compliance, or another Brazil tax area.
+
+For multi-layer jurisdictions, first determine whether the scope is national/federal-only, sub-jurisdiction-only, or both. Use a national/federal code such as `US` or `US-FED` for US federal-only rules. Use structured sub-jurisdiction codes such as `US-CA` for California or `CA-ON` for Ontario when state or provincial rules are relevant. If both layers matter, load and record each applicable bundle, and verify that the returned bundle title matches the requested layer.
 
 ## Bkper tax semantics
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.16.6",
+    "version": "4.16.8",
     "description": "Command line client for Bkper",
     "bin": {
         "bkper": "./lib/cli.js"