From 3f424137aca70f01cb60f9b845328459cd4d78b3 Mon Sep 17 00:00:00 2001
From: Tiara Rodney <tiara.rodney@byteb4rb1e.me>
Date: Fri, 13 Mar 2026 23:02:46 +0100
Subject: [PATCH] chore: add roadmap issues 10-13

Add issues for documentation, async support, OCSF formatter, and
browser local storage handler from the README roadmap.
---
 TODO | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/TODO b/TODO
index 3cb8d82..145ef93 100644
--- a/TODO
+++ b/TODO
@@ -149,3 +149,66 @@ Description: Manager.getLogger() does not establish parent-child
              The Placeholder fixup logic is incomplete. Logger propagation
              depends on this hierarchy being correctly built so that child
              loggers forward records to parent handlers.
+
+--ISSUE
+Content-Type: application/issue
+
+ID: 10
+Type: feature
+Title: add documentation
+Status: open
+Priority: medium
+Created: 2026-03-13
+Relationships:
+Description: write user-facing documentation covering module usage, API
+             reference, and configuration. The docs/ directory has stubs
+             (README.md, logging-cookbook.md) that need to be fleshed out.
+             TypeDoc generates API docs from source but a prose guide with
+             examples is needed for onboarding.
+
+--ISSUE
+Content-Type: application/issue
+
+ID: 11
+Type: feature
+Title: add support for asynchronous calls
+Status: open
+Priority: low
+Created: 2026-03-13
+Relationships:
+Description: introduce async-aware logging so that handlers which perform
+             I/O (e.g. network, storage) do not block the caller. This may
+             involve an AsyncHandler base class or async emit() overloads,
+             and consideration of how log record ordering is preserved
+             across concurrent async contexts.
+
+--ISSUE
+Content-Type: application/issue
+
+ID: 12
+Type: feature
+Title: implement OCSF formatter
+Status: open
+Priority: low
+Created: 2026-03-13
+Relationships:
+Description: implement a Formatter subclass that outputs log records in
+             Open Cybersecurity Schema Framework (OCSF) format. This
+             enables structured security event logging compatible with
+             SIEM systems and security analytics tooling.
+
+--ISSUE
+Content-Type: application/issue
+
+ID: 13
+Type: feature
+Title: implement browser local storage handler
+Status: open
+Priority: medium
+Created: 2026-03-13
+Relationships: dependsOn:8
+Description: implement a Handler subclass that persists log records to
+             browser localStorage or IndexedDB as a replacement for
+             FileHandler in browser environments. Should support log
+             rotation by size or entry count to avoid exceeding storage
+             quotas.