PSF: Mass-regeneration complete. 53/53 high-fidelity blueprints and TDD suites established. Zero-cost Pro bridge active.

notes/org-skill-gtd.org

@@ -25,59 +25,38 @@ Define the interfaces for task perception, project tracking, and commitment mana
 *** TODO PSF-State Transition Verification
 *** TODO Stalled Project Identification
 
+
 * Phase B: Blueprint (PROTOCOL)
 :PROPERTIES:
 :STATUS: SIGNED
 :END:
 
+
+* Phase B: Blueprint (PROTOCOL)
+:PROPERTIES:
+:STATUS: DRAFT
+:END:
+
 ** 1. Architectural Intent
-Interfaces for querying and updating the GTD state. Source of truth is `gtd.org` and related agenda files.
+The GTD Execution Hub will be implemented as a collection of functions operating on the `org-gtd` v4.0 DAG. It will provide a consistent interface for task capture, clarification, and execution status monitoring.  Key elements include:
 
-** 2. Semantic Interfaces
-#+begin_src lisp
-(defun gtd-perceive-commitments ()
-  "Returns a list of all active NEXT actions.")
+- *Capture and Clarify:* Functions to create, process, and integrate new tasks into the DAG.
+- *Dependency Management:*  Functions to navigate and update dependencies based on `:TRIGGER:` and `:BLOCKER:` properties.
+- *PSF-State Tracking:*  Functions to monitor and report on `:PSF-STATE:` transitions.
+- *Completion Review:* Functions to summarize completed projects and extract lessons learned.
 
-(defun gtd-update-project-state (project-id new-state)
-  "Updates the :PSF-STATE: property of a project.")
+The system should be modular and extensible, allowing for easy integration with other PSF components and external data sources.
 
-(defun gtd-breakdown-project (project-id)
-  "Uses the Long-Horizon Planning agent to generate NEXT steps for a stalled project.")
-#+end_src
+** 2. Semantic Interfaces (Lisp Signatures)
 
-* Phase D: Build (Implementation)
+*** Function: `gtd/capture-task`
+Capture a new task and integrate it into the appropriate context.
 
-** Commitment Perception
-#+begin_src lisp :tangle projects/org-skill-gtd/src/gtd-logic.lisp
-(defun gtd-perceive-commitments ()
-  "Returns a list of all active NEXT actions across the agenda files."
-  (let ((gtd-file (or (uiop:getenv "GTD_FILE") "gtd.org")))
-    (kernel-log "GTD - Scanning commitments in ~a" gtd-file)
-    (uiop:run-program (list "grep" "^\\*\\* NEXT" gtd-file) :output :string)))
+    :signature `((description string) (context keyword) &optional (project org-id)) :returns org-id`
+    :description "Capture a new task described by DESCRIPTION and add it to CONTEXT.  If PROJECT is specified, link the new task as a subtask of PROJECT."
 
-(defun gtd-breakdown-project (project-id)
-  "Autonomously expands a complex project into actionable NEXT steps."
-  (let* ((obj (org-agent:lookup-object project-id))
-         (title (getf (org-agent:org-object-attributes obj) :TITLE))
-         (content (org-agent:org-object-content obj)))
-    (org-agent:spawn-task 
-     (format nil "Break down the project '~a' into 3 actionable NEXT steps. Context: ~a" title content))))
-#+end_src
+*** Function: `gtd/clarify-task`
+Process a newly captured task, adding details and dependencies.
 
-** Shadow Orchestration
-#+begin_src lisp :tangle projects/org-skill-gtd/src/gtd-logic.lisp
-(defun gtd-get-psf-state (project-id)
-  "Retrieves the :PSF-STATE: property for a specific project ID."
-  (let ((gtd-file (or (uiop:getenv "GTD_FILE") "gtd.org")))
-    ;; Logic to parse project and return state
-    (format nil "Retrieving state for: ~a" project-id)))
-#+end_src
-
-* Registration
-#+begin_src lisp
-(defskill :skill-gtd
-  :priority 100
-  :trigger (lambda (context) nil)
-  :neuro (lambda (context) nil)
-  :symbolic #'gtd-perceive-commitments)
-#+end_src
+    :signature `((task-id org-id) (details alist)) :returns org-id`
+    :description "Clarify a task, adding details and dependencies specified in the DETAILS alist. Example: '((:priority \