docs: complete function reference, drop unicode punctuation

Documents refresh_hierarchy_cache, is_rule_valid and org_in_scope, and
corrects the get_org_scope scope list which still omitted unattributed
and all.

Replaces em dashes and other typographic unicode with ASCII throughout
the schema comments, the test suite and the documentation. Comments and
prose are ASCII only.

src/auth_cache.sql

@@ -125,7 +125,7 @@ CREATE TRIGGER trg_invalidate_cache_user_rules
 AFTER INSERT OR UPDATE OR DELETE ON morbac.user_rules
 FOR EACH ROW EXECUTE FUNCTION morbac.invalidate_cache_on_user_rule_change();
 
--- Global rules have no org scope — any change invalidates the entire cache
+-- Global rules have no org scope - any change invalidates the entire cache
 CREATE OR REPLACE FUNCTION morbac.invalidate_cache_on_global_rule_change()
 RETURNS TRIGGER
 LANGUAGE plpgsql
@@ -141,7 +141,7 @@ CREATE TRIGGER trg_invalidate_cache_global_rules
 AFTER INSERT OR UPDATE OR DELETE ON morbac.global_rules
 FOR EACH ROW EXECUTE FUNCTION morbac.invalidate_cache_on_global_rule_change();
 
--- system_principals changes affect prohibition bypass — invalidate per user
+-- system_principals changes affect prohibition bypass - invalidate per user
 CREATE OR REPLACE FUNCTION morbac.invalidate_cache_on_system_principal_change()
 RETURNS TRIGGER
 LANGUAGE plpgsql