feat: UUIDv4 IDs, GTD conventions, backdate ROADMAP

- memory-id-generate now produces UUIDv4 (id-87917806-...)

- GTD Conventions added to programming-standards.org

- ROADMAP.org v0.3.0 tasks have :ID:, :CREATED:, :LOGBOOK:, CLOSED:
This commit is contained in:
2026-05-03 08:14:53 -04:00
parent 0760dc8012
commit e2fde5914e
4 changed files with 50 additions and 5 deletions

View File

@@ -50,10 +50,26 @@ Unified control plane and Human-in-the-Loop state management.
** Tasks
*** DONE Project Renaming (Bouncer → Dispatcher) [2026-05-02 Sat]
*** DONE Project Renaming (Bouncer → Dispatcher)
:PROPERTIES:
:ID: id-9e779580-287b-b3d1-37b9-bcefd750bf9e
:CREATED: [2026-05-01 Fri 15:40]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-05-02 Sat 22:00]
:END:
CLOSED: [2026-05-02 Sat 22:00]
The Dispatcher's role has evolved beyond security guard. It is the seed of the deterministic engine — it learns to execute procedures without invoking the neural net.
*** DONE Event Orchestrator (unified hooks+cron+routing)
:PROPERTIES:
:ID: id-d35aea3d-2e5f-4a12-a9b0-1c2d3e4f5a6b
:CREATED: [2026-05-02 Sat 14:00]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-05-02 Sat 22:36]
:END:
CLOSED: [2026-05-02 Sat 22:36]
Unified control plane for hooks, cron, and complexity-based routing.
- *hook-registry* + *cron-registry* + tier classifier
- Hooks via ~#+HOOK:~ Org-mode properties
@@ -62,6 +78,10 @@ Unified control plane for hooks, cron, and complexity-based routing.
- Rule-based tier classifier (overrideable via ~*tier-classifier*~)
*** TODO Context Manager (project scoping)
:PROPERTIES:
:ID: id-a10ed34e-9f37-4a15-b499-46672c00d951
:CREATED: [2026-05-02 Sat 23:00]
:END:
Stack-based context with ~push-context~ / ~pop-context~.
Path resolution relative to current context.
Memory scope: ~:scope~ property on memory-objects (memex/session/project).

View File

@@ -19,8 +19,8 @@
(nreverse results)))
(defun memory-id-generate ()
"Generates a timestamp-based unique ID."
(format nil "id-~36r" (get-universal-time)))
"Generates a UUIDv4 unique ID. Compatible with Agora Note UUIDs."
(concatenate 'string "id-" (string-downcase (format nil "~a" (uuid:make-v4-uuid)))))
(defstruct memory-object
id type attributes content vector parent-id children version last-sync hash)

View File

@@ -85,8 +85,8 @@ Generates a unique identifier string for a new Org node. Uses the universal time
#+begin_src lisp
(defun memory-id-generate ()
"Generates a timestamp-based unique ID."
(format nil "id-~36r" (get-universal-time)))
"Generates a UUIDv4 unique ID. Compatible with Agora Note UUIDs."
(concatenate 'string "id-" (string-downcase (format nil "~a" (uuid:make-v4-uuid)))))
#+end_src
** The Data Structure (memory-object)

View File

@@ -59,6 +59,31 @@ If a LOADER ERROR or reader-error occurs:
Rationale: The two tracks prevent the two failure modes we have observed. Writing implementation code directly in Org (without REPL prototyping) produces syntax errors that require external tools to debug. Skipping Org-first test writing produces code without verified success criteria. The split is not bureaucratic — it is the mechanism by which both failures are prevented.
** GTD Conventions
Every task headline in the project's ROADMAP.org and gtd.org follows these rules:
1. **:ID:** — generated by ~memory-id-generate~ (UUIDv4 with ~id-~ prefix), never written manually. Use ~(memory-id-generate)~ in the REPL to produce one.
2. **:CREATED:** — ISO-8601 timestamp: ~[2026-05-02 Sat 14:30]~. Set when the headline is first created, never changed.
3. **:LOGBOOK:** — each state transition is logged: ~- State "DONE" from "TODO" [2026-05-02 Sat 15:00]~.
4. **CLOSED:** — set when the task reaches DONE: ~CLOSED: [2026-05-02 Sat 15:00]~.
5. **TODO keywords** follow the standard sequence: ~TODO~~NEXT~~IN-PROGRESS~~DONE~ / ~BLOCKED~ / ~CANCELLED~.
6. **The Agent** updates these automatically during Phase E of the lifecycle. The human never needs to write a UUID or timestamp manually — the agent generates and inserts them.
Example:
#+begin_src org
*** DONE Event Orchestrator
:PROPERTIES:
:ID: id-4a2b9c8f-3d7e-4f12-a9b0-1c2d3e4f5a6b
:CREATED: [2026-05-02 Sat]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-05-02 Sat 18:00]
:END:
CLOSED: [2026-05-02 Sat 18:00]
#+end_src
* Implementation
** Standards Enforcement