feat(psf): implement advanced foundry automation and memory optimization

notes/org-skill-auth-api-key.org

@@ -0,0 +1,55 @@
+#+TITLE: SKILL: API Key Authentication (Universal Literate Note)
+#+ID: skill-auth-api-key
+#+STARTUP: content
+#+FILETAGS: :auth:security:system:psf:
+
+* Overview
+This skill provides the legacy-compatible **Static API Key** authentication method. It retrieves credentials from the system environment variables and provides them to the kernel's neural backends.
+
+* Phase A: Demand (PRD)
+:PROPERTIES:
+:STATUS: FROZEN
+:END:
+
+** 1. Purpose
+Provide a simple, environment-driven authentication mechanism for LLM providers.
+
+** 2. User Needs
+- **Static Retrieval:** Pull `LLM_API_KEY` from `.env`.
+- **Provider Mapping:** Support mapping keys to specific providers (Gemini, OpenAI, etc.).
+- **Reliability:** Return NIL gracefully if no key is found.
+
+* Phase B: Blueprint (PROTOCOL)
+:PROPERTIES:
+:STATUS: SIGNED
+:END:
+
+** 1. Architectural Intent
+Interfaces for credential retrieval. Source of truth is the system environment.
+
+** 2. Semantic Interfaces
+#+begin_src lisp
+(defun auth-api-key-get-credentials ()
+  "Returns a plist containing the :api-key for the default provider.")
+#+end_src
+
+* Phase D: Build (Implementation)
+
+#+begin_src lisp
+(defun auth-api-key-get-credentials ()
+  (let ((key (uiop:getenv "LLM_API_KEY")))
+    (when key
+      (list :api-key key))))
+
+;; Register as the default auth provider for Gemini during transition
+(org-agent:register-auth-provider :gemini #'auth-api-key-get-credentials)
+#+end_src
+
+* Registration
+#+begin_src lisp
+(defskill :skill-auth-api-key
+  :priority 100
+  :trigger (lambda (context) nil)
+  :neuro (lambda (context) nil)
+  :symbolic (lambda (action context) action))
+#+end_src