67 Commits

Author SHA1 Message Date
89d8189c43 passepartout: v0.3.1 — Parser RCE elimination (*read-eval* nil) 2026-05-06 16:39:21 -04:00
1025290dad passepartout: v0.3.0 release notes full version 2026-05-06 16:12:48 -04:00
97e6af85a2 passepartout: fix README version badge to static v0.3.0 2026-05-06 15:55:47 -04:00
835d638bf3 passepartout: v0.3.0 — Event Orchestration, HITL, Daily-Driver TUI
Test results: 86 pass / 0 fail across 21 suites. TUI integration: 7/7 pass.
Features: 9-vector dispatcher gates, HITL Flight Plan workflow, Event
Orchestrator, Context Manager, Model-Tier Routing, Memory Scope
Segmentation, Async Embedding Gateway, TUI Experience (scrollback,
history, status bar, themes, tab completion), v0.2.x backfill
remediation (14 items), multi-distro deployment, project rename.
Stats: 31 literate Org files with full prose.
2026-05-06 15:52:53 -04:00
6c0e0f4d8d passepartout: 6 QoL fixes — log-message, now, TUI loads, handshake, cascade, daemon boot 2026-05-06 11:40:17 -04:00
a7233931f9 passepartout: v0.3.0 complete — TUI rendering fixed 2026-05-06 11:21:57 -04:00
85cb951816 passepartout: fix input-blocking — agent responses now render immediately 2026-05-06 11:14:50 -04:00
bd959df78c passepartout: connect-daemon retry + TUI connection feedback 2026-05-06 10:46:52 -04:00
9ce0f7b5b2 passepartout: TUI reader loop — silent timeouts, sleep on idle 2026-05-06 10:25:20 -04:00
9351b1c74d passepartout: fix backspace + TUI initial redraw + socket type 2026-05-06 10:12:00 -04:00
5bd20cb7b3 passepartout: fix backspace — normalize Croatoan key structs 2026-05-06 09:48:40 -04:00
f774f53cbd passepartout: pre-warm in setup, TUI rendering diagnostics 2026-05-06 09:20:50 -04:00
aefd3421d3 passepartout: fix TUI agent-responds — text-match instead of unicode arrow 2026-05-06 09:07:22 -04:00
e663663e49 passepartout: cascade parsing test + TUI integration diagnostics 2026-05-06 08:56:14 -04:00
1edf3c3347 passepartout: fix cl-dotenv quote contamination in cascade parsing 2026-05-06 08:27:05 -04:00
6a252d989a passepartout: CLI test, TUI integration harness fixes 2026-05-05 20:58:47 -04:00
6f6ea7a967 passepartout: fix final 4 test bugs — 184 checks, 0 failures 2026-05-05 20:49:05 -04:00
cf67171940 passepartout: fix 12 pre-existing test bugs — 180/185 pass 2026-05-05 20:06:28 -04:00
26093f43d5 passepartout: fix skill loader — preserve test in-package forms, un-jail dispatcher 2026-05-05 19:17:05 -04:00
966b6b8016 passepartout: v0.3.0 complete — embedding gateway finished, all ROADMAP items DONE 2026-05-05 18:24:15 -04:00
6a0bb91f8c passepartout: v0.3.0 deferred features — TUI polish, context persistence, theming 2026-05-05 18:02:56 -04:00
bfd54d3a44 passepartout: v0.3.0 finish — TUI, embedding, gateway, export hygiene 2026-05-05 17:42:09 -04:00
139cc417a7 passepartout: remove TUI :force t 2026-05-05 16:51:51 -04:00
95232f6663 passepartout: TUI harness tuning 2026-05-05 16:45:56 -04:00
0b71f98f37 passepartout: fix paren imbalances 2026-05-05 16:25:28 -04:00
dcbb1279d4 passepartout: deploy fixes 2026-05-05 14:26:27 -04:00
d0117e495a passepartout: TUI ASDF system fix for 3-file split 2026-05-05 14:15:47 -04:00
caabb7f10b passepartout: close remaining test gaps 2026-05-05 13:53:00 -04:00
101b9174df passepartout: cascade-failure detection in TUI tests 2026-05-05 13:44:04 -04:00
4a7ed5ed90 passepartout: TUI integration test improvements 2026-05-05 13:41:58 -04:00
2c7a2ee345 passepartout: integration tests Phase 2+3 2026-05-05 13:38:00 -04:00
ee36d35785 passepartout: system integration tests 2026-05-05 13:26:09 -04:00
ad33e1bde3 passepartout: close high-priority test gaps 2026-05-05 12:53:58 -04:00
45e3c2bc02 passepartout: Tier 3 contracts and tests 2026-05-05 12:36:43 -04:00
b6137e0eff passepartout: contract sections for Tier 2 pipeline modules 2026-05-05 12:19:25 -04:00
8606370c79 passepartout: security module contracts and tests 2026-05-05 12:08:12 -04:00
89c66af5f4 passepartout: architectural intent template 2026-05-05 11:51:18 -04:00
898dd11cbd passepartout: deepen test suites 2026-05-05 10:54:00 -04:00
cf350b2754 passepartout: embedded test migration 2026-05-05 10:29:15 -04:00
a8efd03c2c passepartout: all tests sourced from org (diagnostics rename, orphans adopted) 2026-05-05 09:58:06 -04:00
7065d190ab passepartout: fix dead test suite (export list, stale duplicates, 14/14 pass) 2026-05-05 09:36:24 -04:00
069276b8ee agents: require red-proof in TDD cycle 2026-05-05 09:07:42 -04:00
252229593d passepartout: provider revert 2026-05-04 20:41:48 -04:00
00f7675fb5 passepartout: thread-isolated LLM provider 2026-05-04 19:21:43 -04:00
5b664ea739 passepartout: deepseek-first cascade 2026-05-04 18:46:39 -04:00
595672466e passepartout: fix style-warnings + roadmap update 2026-05-04 18:34:52 -04:00
36c62625fa passepartout: LLM timeout fix 2026-05-04 18:21:10 -04:00
724faad29d passepartout: LLM timeout config 2026-05-04 18:12:23 -04:00
a707f1be71 passepartout: 3-file TUI split 2026-05-04 17:01:21 -04:00
05d4342810 inbox: updated 2026-05-04 16:50:25 -04:00
f6da30f2a8 passepartout: TUI with colors, LLM routing, /eval 2026-05-04 16:42:39 -04:00
eaabac375b AGENTS: add TUI REPL workflow (/eval + Swank) 2026-05-04 16:06:32 -04:00
8725822179 passepartout: TUI rewrite with REPL + Swank 2026-05-04 16:05:48 -04:00
af56cfe789 passepartout: fix TUI crash 2026-05-04 13:42:44 -04:00
5b75527e31 passepartout: commit TUI fix + backtrace diag 2026-05-04 12:57:17 -04:00
7e65580958 passepartout: fix archivist handler-case 2026-05-04 12:04:57 -04:00
a0005850d1 passepartout: fix pre-existing warnings (LISP-STRUCTURAL-CHECK, T-as-variable, SOME arg) 2026-05-04 11:58:25 -04:00
4a3d04e251 passepartout: exclude gateway-tui from skill loader 2026-05-04 11:49:11 -04:00
24b89a1513 passepartout: fix system-config balance 2026-05-04 11:44:31 -04:00
85202fd4f8 passepartout: setup wizard improvements + remove Ollama 2026-05-04 11:41:01 -04:00
c43412f390 passepartout: fix symlink target 2026-05-04 11:32:05 -04:00
ac052440b7 passepartout: fix deploy paths + TUI protocol 2026-05-04 11:28:46 -04:00
dbf3a81962 passepartout: TUI config panel + onboarding 2026-05-04 11:09:22 -04:00
76a0fd407b passepartout: Phase 4 onboarding + TUI config panel 2026-05-04 10:36:29 -04:00
a7cd6c9aac passepartout: TUI config + provider test + slot descriptions 2026-05-04 10:26:54 -04:00
b396cdac60 passepartout: rename/fix/explorer commit 2026-05-04 09:59:12 -04:00
4f34969224 rename: opencortex → passepartout across memex
- .gitmodules: update submodule paths (projects/opencortex → projects/passepartout,
  projects/opencortex-contrib → projects/passepartout-contrib)
- gtd.org, README.org: update project references and display names
- check.lisp, gemini-vision.org, agora/TODO.org: update file paths
- dotemacs: update agenda paths and template config
- system/plans/: update all flight plan references
- system/backups/: update monolithic backup references
2026-05-03 11:47:52 -04:00
27 changed files with 462 additions and 383 deletions

8
.gitmodules vendored
View File

@@ -1,9 +1,9 @@
[submodule "opencortex"] [submodule "opencortex"]
path = opencortex path = opencortex
url = ssh://git@10.10.10.201:2222/amr/opencortex.git url = ssh://git@10.10.10.201:2222/amr/opencortex.git
[submodule "projects/opencortex"] [submodule "projects/passepartout"]
path = projects/opencortex path = projects/passepartout
url = ssh://10.10.10.201:2222/amr/opencortex.git url = ssh://10.10.10.201:2222/amr/opencortex.git
[submodule "projects/opencortex-contrib"] [submodule "projects/passepartout-contrib"]
path = projects/opencortex-contrib path = projects/passepartout-contrib
url = ssh://git@10.10.10.201:2222/amr/opencortex-contrib.git url = ssh://git@10.10.10.201:2222/amr/opencortex-contrib.git

View File

@@ -1,149 +0,0 @@
# OpenCortex Agent Mandate
This file defines the operating policies and engineering guidelines that all autonomous agents MUST follow.
## Vision
- **Pure Lisp + Org-mode**: All intelligence implemented in Lisp, all documentation in Org-mode
- **No JSON, No YAML**: Thin harness, fat skills
- **Constraint**: No temporary scripts in opencortex repo - use `/home/user/memex/system/` instead
## Current Goal
- **v0.2.0**: Self-Improvement + Local LLMs
- org-skill-self-edit (self-modification)
- org-skill-emacs-edit (full org-mode manipulation)
- Local vector search (Ollama embeddings)
- Tool permission tiers (ask/allow/deny)
- Skill hot-reload ✅ DONE
- Engineering Standards skill ✅ DONE
- Literate Programming skill ✅ DONE
## Wake-Up Protocol
When this agent starts, it MUST:
1. **Read this file** (`~/.opencode/AGENTS.md`)
2. **Query the skill catalog**: Before any analysis, check if a skill covers the problem domain
- `(list-skills)` to see all loaded skills
- `(find-skill :keyword)` to check for a specific domain
- Read the skill's org file if found
3. **Verify git status**: Working tree MUST be clean before modification
4. **Read `gtd.org`**: Load current task context from the roadmap
5. **Enter lifecycle**: Follow the Engineering Standards lifecycle (Phase 0 → A → B → C → D → E)
Rationale: Raw LLM reasoning is a fallback, not a starting point. The skill layer encodes the system's accumulated wisdom. Ignoring skills creates drift.
## Engineering Standards
The Engineering Standards skill (`opencortex.skills.org-skill-engineering-standards`) defines the full lifecycle. The summaries below are reminders; the skill org file is authoritative.
### Phase 0: Before You Think
**Skill-First Query Rule**: Before analysis, debugging, or implementation, query the skill catalog. If a relevant skill exists, follow its mandates. Do not duplicate logic.
### Phase A: Design (Test-First)
1. **Define success criteria first** — Write the test or PROTOCOL that proves the feature works
2. **Break the design with chaos** — Three tiers of adversarial testing:
- *Deterministic chaos*: Scripted regression tests on every change
- *Probabilistic chaos*: Randomized fuzzing on every major release
- *Stress chaos*: Load and resource starvation during hardening sprints
### Phase B: Commit (Recovery Point)
3. **Commit Before Modify** — Commit and push (if network available) before any file changes
### Phase C: Build (Implementation)
4. **Literate Programming** — All logic in Org files; generated `.lisp` is derived, not authored
5. **Function-Block Granularity** — One function per `#+begin_src lisp` block
6. **Tangle Mandate** — Edit Org only; never touch generated `.lisp`
7. **Configuration Externalization** — No hardcoded values; use `.env.example`
8. **Org as Thinking Medium** — Document investigation before fixing
### Phase D: Validate (Proof)
9. **Test Verification** — Run the full suite. A change that breaks tests is damage, not a fix.
### Phase E: Document (Audit Trail)
10. **Decision Audit Trail** — Document root cause, options, tradeoffs, and rationale
11. **Stop-and-Wait** — For major changes, propose strategy, state "Waiting for user feedback," yield turn
12. **GTD Synchronization** — Update `gtd.org` with TODO headlines before marking complete
## Literate Programming Rules
The Literate Programming skill (`opencortex.skills.org-skill-literate-programming`) enforces Org discipline:
1. **One Function, One Block** — No bundling multiple definitions
2. **Org-Mode Evaluation Gate**`C-c C-c` after every block change
3. **Pre-Tangle Structural Check** — Verify paren balance before tangling
4. **No Direct `.lisp` Edits** — All changes flow through Org
5. **Code and Prose Together** — Every block preceded by explanatory text
Violating these rules corrupts the skill loader and causes boot failure (as seen in the 2026-04-25 incident).
## Agent Workflow
- **Boot Sequence**: Read AGENTS.md → query skills → verify git → read gtd.org
- **Before Any Modification**: Commit first (Commit Before Modify rule)
- **Plan Mode**: Draft PROTOCOL.md before complex implementations
- **Testing**: Run FiveAM test suite + chaos tests before marking task complete
- **Completion**: Update gtd.org, commit, sync with user
## Self-Enforcement Checklist
This agent MUST verify these conditions before, during, and after each task. Violation is a bug, not a suggestion.
### Before Any Task (Gate)
- [ ] **Git clean** — Working tree must be clean before modification
- [ ] **Skill query** — Check if relevant skill exists in `/home/user/memex/projects/opencortex/skills/`
- [ ] **Skill read** — If found, read the skill's org file before proceeding
- [ ] **GTD read** — Check `gtd.org` for current task context
### During Task (Literate Programming)
- [ ] **REPL-first workflow** — Explore in REPL before writing code
- [ ] **Utils-lisp for structural ops** — Use these functions for any .lisp work:
- `utils-lisp-structural-extract` — Extract function definitions
- `utils-lisp-structural-inject` — Inject forms into definitions
- `utils-lisp-structural-wrap` — Wrap code in let/progn
- `utils-lisp-validate` — Validate code before commit
- `repl-eval` — Test code in REPL
- `repl-inspect` — Inspect variables/functions
- [ ] **Never use edit tool on .lisp** — Only edit .org files; never touch generated .lisp directly
- [ ] **One function per block** — Each `#+begin_src` block contains exactly one definition
- [ ] **Prose before code** — Every block preceded by explanatory text
- [ ] **Prose includes**: What the function does, arguments, return value, rationale
- [ ] **Evaluate each block** — Verify the block compiles/evaluates correctly
- [ ] **Paren balance** — Check balanced parentheses before tangling
### After Task (Validation)
- [ ] **REPL verified** — Code tested in REPL before commit (not just text edit)
- [ ] **Utils-lisp used** — Confirmed structural operations went through utils-lisp
- [ ] **Tests pass** — Run full test suite; 100% pass required
- [ ] **Chaos tier 1** — Deterministic regression tests pass
- [ ] **No artifacts** — No orphaned `.bak`, `.log`, `.tmp`, or untracked test files
- [ ] **Commit** — Stage and commit changes with descriptive message
- [ ] **GTD update** — Update `gtd.org` with completed task state
### For OpenCortex Work Specifically
Reference authoritative skill files:
- Engineering Standards: `projects/opencortex/skills/org-skill-engineering-standards.org`
- Literate Programming: `projects/opencortex/skills/org-skill-literate-programming.org`
- Policy: `projects/opencortex/skills/org-skill-policy.org`
The summaries in this file are reminders; the skill org files are authoritative.
## References
- opencortex repo: `/home/user/memex/projects/opencortex`
- Engineering Standards: `/home/user/memex/projects/opencortex/skills/org-skill-engineering-standards.org`
- Literate Programming: `/home/user/memex/projects/opencortex/skills/org-skill-literate-programming.org`
- Policy Skill: `/home/user/memex/projects/opencortex/skills/org-skill-policy.org`
- Roadmap: `/home/user/memex/gtd.org`
- README: `/home/user/memex/projects/opencortex/README.org`

179
AGENTS.md Normal file
View File

@@ -0,0 +1,179 @@
# AGENTS.md — OpenCode Tool Usage Guide
This file tells AI coding agents which tools are available and when to use them.
It is read by agents working on the Memex / Passepartout project.
## Development Workflow (Must Follow)
All development MUST follow this cycle, beginning to end:
1. **Start in REPL** — Everything begins and ends in the Passepartout REPL (port 9105)
2. **TDD in REPL** — Red-Green-Refactor cycle:
1. Write a FAILING test first (use `(passepartout:deftest name ...)` or `fiveam:test`)
2. **Prove RED**: Run `(passepartout:run-test 'test-name)` — it MUST fail.
If it passes before code exists, the test is broken or testing nothing.
Record the failure output.
3. Develop code in REPL to make the test pass
4. Use lisp-structural-check to validate code while developing
5. Evaluate forms with `eval-defun` or equivalent
6. Run tests again → they should PASS
7. Repeat until feature is complete
3. **Reflect in Org** — Once code works in REPL, reflect it in the .org literate source file
4. **Tangle with Emacs** — Use `org-babel-tangle` to generate .lisp from .org
5. **Validate tangled lisp** — Run `lisp-structural-check` on the result
6. **Commit** — Only after validation passes
**When tools fail**:
- If any recommended tool fails, you MUST explain:
- Why it failed (specific error, missing dependency, etc.)
- How we can make it work (fix, configuration, alternative approach)
- Then **PAUSE** and ask for permission before trying a different method
**Rule**: Do not leave the REPL to develop. If something can't be done in REPL, explain why and ask before proceeding otherwise.
---
## Available Tools — Use These First
### 1. Passepartout REPL (port 9105)
The daemon runs with ALL skills loaded. Use it instead of the deploy-crash-cycle.
**Send forms via Python bridge:**
```python
import socket
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect(("127.0.0.1", 9105))
msg = '(:type :event :payload (:sensor :repl-eval :code "(+ 1 2)"))'
s.sendall(f"{len(msg):06x}".encode() + msg.encode())
```
**Or via SBCL directly (attached to daemon):**
```lisp
(sb-bsd-sockets:socket-send sock payload len)
```
**Key functions available:**
- `(passepartout:lisp-structural-check "code-string")` — returns (values t nil) or (values nil "error")
- `(passepartout:lisp-validate "code-string" :semantic t)` — full validation
- `(passepartout:log-message "format ~a" arg)` — write to daemon log
- Any exported symbol from `passepartout` package
### 2. Lisp Structural Tools (pre-deploy validation)
**ALWAYS run these before tangling/deploying Lisp changes.**
`lisp-structural-check` works on ANY Lisp string, not just Org blocks:
```lisp
;; Via REPL — send to port 9105:
(passepartout:lisp-structural-check "<lisp-code-string>")
;; Returns: (values t nil) on success, (values nil "error details") on failure
```
For Org files:
```lisp
(passepartout:literate-block-balance-check "/path/to/file.org")
```
These catch paren mismatches in <1 second vs. the 60-second deploy-crash cycle.
### 3. Emacs Interactive
Use Emacs for interactive Lisp development:
- `forward-sexp` / `backward-sexp` — navigate balanced expressions
- `show-paren-mode` — visual paren matching
- `eval-defun` (C-M-x) — evaluate the current top-level form
- `eval-region` — evaluate selected region
- `org-babel-tangle` — tangle a single file: `M-x org-babel-tangle`
- Batch tangle: `emacs --batch --eval "(progn (require 'org) (find-file \"file.org\") (org-babel-tangle) (kill-buffer))"`
### 4. Tmux (for TUI testing)
```bash
# Start TUI in detached session
tmux new-session -d -s test "passepartout tui 2>&1 | tee /tmp/tui.log"
# Send keys
tmux send-keys -t test "hello world" Enter
# Capture output
tmux capture-pane -t test -p -S -200
# Clean up
tmux kill-session -t test
```
### 5. Pre-Commit Hook
Validates staged org files by tangling + compiling in daemon:
```
ln -sf ../../scripts/pre-commit-repl-check .git/hooks/pre-commit
```
Run manually: `passepartout setup` or `git commit` (hook auto-runs).
### 6. TUI REPL (via /eval + Swank)
The TUI process has its own REPL for live development:
**Built-in /eval command** — type in the TUI input:
- `/eval (+ 1 2)``=> 3` displayed in chat
- `/eval *state*` → inspect full TUI state plist
- `/eval (view-status sw)` → force status bar re-render
- `/eval (add-msg :system "test")` → inject a test message
**Emacs + Swank REPL** — connect Emacs to the TUI process:
1. Start TUI: `passepartout tui`
2. In Emacs: `M-x slime-connect RET 127.0.0.1 RET 4006`
3. `C-M-x` any form from `org/gateway-tui.org` → evaluates in live TUI process
4. Configure port: `export TUI_SWANK_PORT=4009` (default: 4006)
**Croatoan note**: Rendering functions (`view-status`, `view-chat`, `view-input`) write to the terminal and can't be fully tested from Emacs. Inspect return values instead, and test rendering with `/eval` commands in the TUI itself.
---
## Commands
- Validate code: Send to REPL at port 9105 using socket bridge (see Development Workflow)
- Run tests: `(passepartout:run-tests)` in REPL
- Tangle org: `emacs --batch --eval "(progn (require 'org) (find-file \"file.org\") (org-babel-tangle) (kill-buffer))"`
## Project Structure
- Source (literate): `org/`
- Source (tangled): `lisp/`
- Tests: `tests/`
- Scripts: `scripts/`
- Deployment: `~/.local/share/passepartout/`
- TODO tracking: `docs/ROADMAP.org`
## When Done Means
- Red proof recorded: Test was run and confirmed FAILING before implementation code existed
- Tests pass: `(passepartout:run-tests)` returns success
- Code validated: `lisp-structural-check` returns `(values t nil)`
- Org reflected: Code exists in .org source file
- Org tangled: .lisp generated from .org
- Committed: Only after all above pass
## Boundaries
- **Always do**: Use REPL first for all development, use TDD, prove tests fail FIRST before writing code, validate with lisp-structural-check
- **Ask first**: Before editing .lisp directly (skip org), before deploying, before git commit
- **Never do**: Edit .lisp files manually (they're autogenerated), skip validation before commit
## Iteration
When the agent makes the same mistake twice, add a rule to this file to prevent recurrence.
---
## Project Architecture
- **Thin harness, fat skills** — core provides hooks (`defskill`, `register-actuator`, `*probabilistic-backends*`), skills provide handlers
- **Org is source of truth** — `.org` files tangle to `.lisp`. Never edit `.lisp` directly
- **Package:** `passepartout` exports all symbols in `lisp/core-defpackage.lisp`
- **XDG data dir:** `~/.local/share/passepartout/` (deployed lisp/org files)
- **Config:** `~/.config/passepartout/.env`
---
## Key Libraries
- **Croatoan** — 0-based coordinates, `(setf (cursor-position win) '(y x))` for cursor, `add-string` with `:y`/`:x` keyword args. Source: `~/quicklisp/dists/quicklisp/software/croatoan-20241012-git/src/`
- **Babel** — string encoding/decoding
- **usocket** — TCP sockets
- **bordeaux-threads** — threading primitives

View File

@@ -2,10 +2,10 @@
#+AUTHOR: Amr #+AUTHOR: Amr
#+CREATED: [2026-03-17 Tue] #+CREATED: [2026-03-17 Tue]
#+UPDATED: [2026-04-08 Wed] #+UPDATED: [2026-04-08 Wed]
#+FILETAGS: :memex:psf:opencortex:lisp:sovereignty: #+FILETAGS: :memex:psf:passepartout:lisp:sovereignty:
* Overview * Overview
The *Master Memex* is a sovereign, neurosymbolic intelligence organization system. It is not merely a collection of notes, but a live, programmable environment—a **Personal Software Foundry (PSF)**—where a human (the Sovereign Executive) and agentic co-processes (the `opencortex` kernel and opencode) collaborate within a shared address space. The *Master Memex* is a sovereign, neurosymbolic intelligence organization system. It is not merely a collection of notes, but a live, programmable environment—a **Personal Software Foundry (PSF)**—where a human (the Sovereign Executive) and agentic co-processes (the `passepartout` kernel and opencode) collaborate within a shared address space.
This system synthesizes three core organizational methodologies into a unified "Lisp Machine" experience: This system synthesizes three core organizational methodologies into a unified "Lisp Machine" experience:
- *Zettelkasten:* For atomic, evergreen, and interlinked knowledge. - *Zettelkasten:* For atomic, evergreen, and interlinked knowledge.
@@ -33,7 +33,7 @@ The workspace is strictly divided into these zones to facilitate both human ergo
* The Agentic Inhabitants * The Agentic Inhabitants
The Memex is inhabited by autonomous agents that operate as "Probabilistic" (probabilistic/neural) and "Deterministic" (deterministic/symbolic) layers: The Memex is inhabited by autonomous agents that operate as "Probabilistic" (probabilistic/neural) and "Deterministic" (deterministic/symbolic) layers:
** [[file:projects/opencortex/README.org][opencortex (The Kernel)]] ** [[file:projects/passepartout/README.org][passepartout (The Kernel)]]
A Common Lisp microkernel that maintains a live, threaded Object-Store in RAM. It uses Org-mode as its native Abstract Syntax Tree (AST), allowing it to "perceive" and "act" on the Memex with structural precision. A Common Lisp microkernel that maintains a live, threaded Object-Store in RAM. It uses Org-mode as its native Abstract Syntax Tree (AST), allowing it to "perceive" and "act" on the Memex with structural precision.
** opencode ** opencode

View File

@@ -1,5 +1,5 @@
(handler-case (handler-case
(with-open-file (s "/home/user/memex/projects/opencortex/skills/org-skill-config-manager.org") (with-open-file (s "/home/user/memex/projects/passepartout/skills/org-skill-config-manager.org")
(loop for line = (read-line s nil) (loop for line = (read-line s nil)
while line while line
do (when (search "#+begin_src lisp" line) do (when (search "#+begin_src lisp" line)

218
gtd.org
View File

@@ -21,9 +21,9 @@
- Updated ~/.emacs and internal Org-babel paths to reflect the new location. - Updated ~/.emacs and internal Org-babel paths to reflect the new location.
CLOSED: [2026-04-21 Tue 16:45] CLOSED: [2026-04-21 Tue 16:45]
** DONE Fix emacsclient defaulting to terminal mode ** DONE Fix emacsclient defaulting to terminal mode
- Identified that 'opencortex' setup.org was hardcoded to install emacs-nox. - Identified that 'passepartout' setup.org was hardcoded to install emacs-nox.
- Reinstalled emacs-gtk and restored GUI support. - Reinstalled emacs-gtk and restored GUI support.
- Patched projects/opencortex/harness/setup.org to use 'emacs' metapackage. - Patched projects/passepartout/harness/setup.org to use 'emacs' metapackage.
- Restored missing modules/emacs-ui.org and added it to dotemacs.org. - Restored missing modules/emacs-ui.org and added it to dotemacs.org.
- Added 'em' alias to ~/.bash_aliases for persistent GUI frame creation. - Added 'em' alias to ~/.bash_aliases for persistent GUI frame creation.
CLOSED: [2026-04-21 Tue 17:15] CLOSED: [2026-04-21 Tue 17:15]
@@ -33,7 +33,7 @@
:ID: gtd-projects :ID: gtd-projects
:END: :END:
** NEXT OpenCortex v1.0 ** NEXT Passepartout v1.0
:PROPERTIES: :PROPERTIES:
:ID: proj-opencortex-v1-0 :ID: proj-opencortex-v1-0
:Engineering-STATE: D: BUILD :Engineering-STATE: D: BUILD
@@ -41,7 +41,7 @@
:END: :END:
OpenCortex: A Neurosymbolic AI Agent. OpenCortex: A Neurosymbolic AI Agent.
Full project tasks: [[file:projects/opencortex/TODO.org][OpenCortex TODO.org]] Full project tasks: [[file:projects/passepartout/TODO.org][Passepartout TODO.org]]
** NEXT Engineering Core: Role Automation ** NEXT Engineering Core: Role Automation
:PROPERTIES: :PROPERTIES:
@@ -81,100 +81,15 @@ Drafting the automated behaviors for the Engineering loop.
** Agora: Decentralized Social Network ** Agora: Decentralized Social Network
:PROPERTIES: :PROPERTIES:
:ID: agora-project :ID: agora-project
:END:
*** DONE Create atomic notes for all 10 Agora sections
:PROPERTIES:
:CREATED: [2026-03-16 Mon 14:28] :CREATED: [2026-03-16 Mon 14:28]
:END: :END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-03-17 Tue 12:00]
:END:
All 14 atomic notes created and cross-referenced. Specification gaps filled, 10 requirements sections complete.
Integration task tracking: [[file:projects/agora/TODO.org][Agora TODO.org]]
Passepartout integration plan: See PHASE: PASSEPARTOUT INTEGRATION in the TODO.org
*** IN-PROGRESS Fill CRITICAL and HIGH gaps [5 CRITICAL / 15 HIGH complete] - Key specs drafted: Contract TypeScript interfaces, Content Flag schema, PDS Sync, Delta Sync
**** DONE Section 02: Identity - ALL HIGH priority gaps resolved - Remaining: Integrate scattered spec docs into requirements files (content flag → Sect 04, PDS sync → Sect 03, delta sync → Sect 08)
**** DONE Section 03: Infrastructure - ALL HIGH priority gaps resolved
*** IN-PROGRESS Fill MEDIUM gaps [14/14 complete]
**** DONE ALL MEDIUM PRIORITY GAPS RESOLVED
**** DONE ALL LOW PRIORITY GAPS RESOLVED (10/10)
**** FINAL STATUS: All Agora specification gaps complete (CRITICAL, HIGH, MEDIUM, LOW)
:PROPERTIES:
:CREATED: [2026-03-17 Tue 23:30]
:END:
:LOGBOOK:
- State "IN-PROGRESS" from "TODO" [2026-03-18 Wed 01:00]
:END:
**** DONE CRITICAL: Contract TypeScript/Protobuf Interfaces → FILLED
:PROPERTIES:
:CREATED: [2026-03-18 Wed 01:00]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-03-18 Wed 01:15]
:END:
- INTEGRATED: Reference added to agora-requirements-02-identity.org
- LOCATION: memex/5_projects/agora/agora-contract-schemas.org
**** DONE CRITICAL: Content Flag Schema Validation → FILLED
:PROPERTIES:
:CREATED: [2026-03-18 Wed 01:00]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-03-18 Wed 01:25]
:END:
- LOCATION: memex/5_projects/agora/agora-content-flag-schema.org
- PENDING: Integration into agora-requirements-04-the-primitive.org
**** DONE CRITICAL: PDS-to-PDS Sync Protocol → FILLED
:PROPERTIES:
:CREATED: [2026-03-18 Wed 01:00]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-03-18 Wed 01:35]
:END:
- LOCATION: memex/5_projects/agora/agora-pds-sync-communication.org
- PENDING: Integration into agora-requirements-03-infrastructure.org
**** DONE CRITICAL: Delta Sync Protocol → FILLED
:PROPERTIES:
:CREATED: [2026-03-18 Wed 01:00]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-03-18 Wed 01:50]
:END:
- LOCATION: memex/5_projects/agora/agora-delta-sync-communication.org
- PENDING: Integration into agora-requirements-08-implementation.org
**** DONE CRITICAL: Persona Revocation Protocol → ALREADY-EXISTS
:PROPERTIES:
:CREATED: [2026-03-18 Wed 01:00]
:END:
:LOGBOOK:
- State "DONE" from "TODO" [2026-03-18 Wed 02:00]
:END:
- NOTE: Complete specification already in agora-requirements-02-identity.org
- ACTION: Gap was incorrectly flagged; no work required
**** TODO INTEGRATE scattered specifications into requirements files [1/4]
:PROPERTIES:
:CREATED: [2026-03-18 Wed 02:00]
:END:
- NEXT: Move content flag schema into Section 04
- NEXT: Move PDS sync into Section 03
- NEXT: Move delta sync into Section 08
- NEXT: Delete duplicate documents after integration
**** NEXT Fill HIGH priority gaps
:PROPERTIES:
:CREATED: [2026-03-18 Wed 02:00]
:END:
- Relay Discovery Mechanism (Section 03)
- Relay Pricing Logic (Section 03)
- Shamir's Parameters (Section 03)
** Emacs Configuration Refactor ** Emacs Configuration Refactor
:PROPERTIES: :PROPERTIES:
@@ -284,7 +199,7 @@ Institutionalizing the virtual software house operating system.
- State "DONE" from "NEXT" [2026-03-22 Sun 15:45] - State "DONE" from "NEXT" [2026-03-22 Sun 15:45]
:END: :END:
*** DONE Apply Engineering Loop to `opencortex` Phase 1 (Core Loop) *** DONE Apply Engineering Loop to `passepartout` Phase 1 (Core Loop)
:PROPERTIES: :PROPERTIES:
:CREATED: [2026-03-22 Sun 15:30] :CREATED: [2026-03-22 Sun 15:30]
:ASSIGNED: Technical Analyst :ASSIGNED: Technical Analyst
@@ -313,7 +228,7 @@ Institutionalizing the virtual software house operating system.
IT infrastructure documentation, security hardening, and operational management. IT infrastructure documentation, security hardening, and operational management.
See project documents: [[file:5_projects/infrastructure/README.org][infrastructure/README.org]] See project documents: [[file:projects/infrastructure/README.org][infrastructure/README.org]]
*** TODO Create current state assessment document *** TODO Create current state assessment document
:PROPERTIES: :PROPERTIES:
@@ -363,7 +278,7 @@ See project documents: [[file:5_projects/infrastructure/README.org][infrastructu
Business planning and revenue generation strategy. Business planning and revenue generation strategy.
See project documents: [[file:5_projects/revenue-sustainability/README.org][revenue-sustainability/README.org]] See project documents: [[file:projects/revenue-sustainability/README.org][revenue-sustainability/README.org]]
*** TODO Set up Stripe account (payment processing) *** TODO Set up Stripe account (payment processing)
:PROPERTIES: :PROPERTIES:
@@ -461,112 +376,7 @@ Detected ~1,300 entries missing the `:CREATED:` property during the Engineering
:CREATED: [2026-03-17 Tue 15:15] :CREATED: [2026-03-17 Tue 15:15]
:END: :END:
Cross-reference consolidated gap analysis against actual requirement specs to identify real vs. already-addressed gaps. All gap verification complete. See [[file:projects/agora/TODO.org][Agora TODO.org]] for current integration tasks.
See project documents: [[file:5_projects/agora/agora-consolidated-gap-analysis.org][agora-consolidated-gap-analysis.org]]
*DECOMPOSITION via Work Breakdown Skill:*
Complexity check failed (51 gaps, 10 files, unpredictable scope). Breaking into atomic verification tasks.
*** DONE [1/7] Verify CRITICAL Gap: Contract TypeScript/Protobuf Interfaces → REAL GAP
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "NEXT" from "TODO" [2026-03-17 Tue 15:15]
- State "DONE" from "NEXT" [2026-03-17 Tue 15:59]
:END:
*HOW:* Searched Section 02 for "interface", "type", "struct", "ContractTemplate". Found 5 TypeScript interfaces (all for revocation, not contracts). Line 951 explicitly states "Gap: No sample JSON for each contract type".
*WHAT:* *REAL GAP* - Contracts described conceptually, lack formal TypeScript/Protobuf schemas.
*** DONE [2/7] Verify CRITICAL Gap: Persona Revocation Protocol → IMPLEMENTED
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "TODO" from "" [2026-03-17 Tue 15:15]
- State "DONE" from "TODO" [2026-03-17 Tue 15:59]
:END:
*HOW:* Checked Section 02 lines 229-260. Found complete protocol with 3 scenarios (Key Compromise, Persona Retirement, Master Key Compromise), 4-step process, and TypeScript interfaces.
*WHAT:* *ALREADY IMPLEMENTED* - Full protocol specification exists. Gap analysis incorrectly flagged this.
*** DONE [3/7] Verify CRITICAL Gap: PDS-to-PDS Sync Protocol → IMPLEMENTED
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "TODO" from "" [2026-03-17 Tue 15:15]
- State "DONE" from "TODO" [2026-03-17 Tue 15:59]
:END:
*HOW:* Checked Section 03 lines 142-180. Found complete sync protocol with Concept, 3 Use Cases (Redundancy, Geographic Distribution, Load Balancing), and Merkle DAG Synchronization architecture.
*WHAT:* *ALREADY IMPLEMENTED* - Protocol fully specified. PDSSyncSession interface documented.
*** DONE [4/7] Verify CRITICAL Gap: Content Flag Schema Validation → REAL GAP
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "TODO" from "" [2026-03-17 Tue 15:15]
- State "DONE" from "TODO" [2026-03-17 Tue 15:59]
:END:
*HOW:* Searched Section 05 for "JSON Schema", "flag", "validation". Found 9 flags described narratively (is_public, is_direct, is_ephemeral, etc.) at lines 24-34. No formal JSON Schema found.
*WHAT:* *REAL GAP* - Flags have informal descriptions but lack formal JSON Schema for validation.
*** DOING [5/7] [BATCH] Verify HIGH priority gaps (15 items) - DELEGATED TO SUB-AGENTS
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "TODO" from "" [2026-03-17 Tue 15:15]
- State "NEXT" from "TODO" [2026-03-17 Tue 16:04]
- State "DOING" from "NEXT" [2026-03-17 Tue 16:05]
:END:
*HOW:* Delegated to 5 sub-agents for parallel verification per section. Monitoring progress centrally.
*Sub-Agent Assignments:*
- *Sub-Agent 1:* Section 02 Identity (4 HIGH gaps)
- *Sub-Agent 2:* Section 03 Infrastructure (3 HIGH gaps)
- *Sub-Agent 3:* Section 05 Public Space (4 HIGH gaps)
- *Sub-Agent 4:* Section 06 Advanced Integration (2 HIGH gaps)
- *Sub-Agent 5:* Sections 08-09 Implementation/Strategy (2 HIGH gaps)
*Current focus:* Orchestrating sub-agent verification. CRITICAL gaps complete (2 REAL, 2 IMPLEMENTED).
*** TODO [BATCH] Verify MEDIUM priority gaps (14 items)
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "TODO" from "" [2026-03-17 Tue 15:15]
:END:
Cross-reference 14 MEDIUM gaps. Defer until HIGH gaps complete.
*** TODO Generate verified gap report
:PROPERTIES:
:CREATED: [2026-03-17 Tue 15:15]
:ASSIGNED: Agent
:END:
:LOGBOOK:
- State "TODO" from "" [2026-03-17 Tue 15:15]
:END:
Create summary documenting: which gaps are REAL (need implementation) vs. ALREADY-IMPLEMENTED (documentation only) vs. PARTIAL (needs completion).
** Token Optimization ** Token Optimization
:PROPERTIES: :PROPERTIES:
@@ -576,7 +386,7 @@ Create summary documenting: which gaps are REAL (need implementation) vs. ALREAD
Cost-effective LLM usage strategy and implementation. Cost-effective LLM usage strategy and implementation.
See project documents: [[file:5_projects/token-optimization/README.org][token-optimization/README.org]] See project documents: [[file:projects/token-optimization/README.org][token-optimization/README.org]]
*** TODO Configure Gemini as primary provider *** TODO Configure Gemini as primary provider
:PROPERTIES: :PROPERTIES:

119
inbox.org
View File

@@ -346,3 +346,122 @@ This is the inbox. Everything goes in here when you capture it.
:CREATED: [2026-04-28 Tue 09:51] :CREATED: [2026-04-28 Tue 09:51]
:END: :END:
* [[https://arxiv.org/abs/2603.13247][[2603.13247] ILION: Deterministic Pre-Execution Safety Gates for Agentic AI Systems]]
:PROPERTIES:
:TITLE: [2603.13247] ILION: Deterministic Pre-Execution Safety Gates for Agentic AI Systems
:URI: https://arxiv.org/abs/2603.13247
:CREATED: [2026-05-04 Mon 08:19]
:END:
* [[https://github.com/Athonitul/ilion-framework-simulator/tree/main/benchmark][ilion-framework-simulator/benchmark at main · Athonitul/ilion-framework-simulator]]
:PROPERTIES:
:TITLE: ilion-framework-simulator/benchmark at main · Athonitul/ilion-framework-simulator
:URI: https://github.com/Athonitul/ilion-framework-simulator/tree/main/benchmark
:CREATED: [2026-05-04 Mon 08:19]
:END:
* [[https://iamtitan.tech/][Titan Observatory]]
:PROPERTIES:
:TITLE: Titan Observatory
:URI: https://iamtitan.tech/
:CREATED: [2026-05-04 Mon 08:19]
:END:
* [[https://arxiv.org/abs/2002.06177][[2002.06177] The Next Decade in AI: Four Steps Towards Robust Artificial Intelligence]]
:PROPERTIES:
:TITLE: [2002.06177] The Next Decade in AI: Four Steps Towards Robust Artificial Intelligence
:URI: https://arxiv.org/abs/2002.06177
:CREATED: [2026-05-04 Mon 08:19]
:END:
* [[https://arxiv.org/abs/2604.25850][[2604.25850] Agentic Harness Engineering: Observability-Driven Automatic Evolution of Coding-Agent Harnesses]]
:PROPERTIES:
:TITLE: [2604.25850] Agentic Harness Engineering: Observability-Driven Automatic Evolution of Coding-Agent Harnesses
:URI: https://arxiv.org/abs/2604.25850
:CREATED: [2026-05-04 Mon 08:20]
:END:
* [[https://x.com/i/status/2049883896444055978][Atai Barkai on X: "UI is Dead. Long Live Generative UI" / X]]
:PROPERTIES:
:TITLE: Atai Barkai on X: "UI is Dead. Long Live Generative UI" / X
:URI: https://x.com/i/status/2049883896444055978
:CREATED: [2026-05-04 Mon 08:20]
:END:
* [[https://github.com/CopilotKit/CopilotKit][CopilotKit/CopilotKit: The Frontend Stack for Agents & Generative UI. React + Angular. Makers of the AG-UI Protocol]]
:PROPERTIES:
:TITLE: CopilotKit/CopilotKit: The Frontend Stack for Agents & Generative UI. React + Angular. Makers of the AG-UI Protocol
:URI: https://github.com/CopilotKit/CopilotKit
:CREATED: [2026-05-04 Mon 08:21]
:END:
* [[https://x.com/i/status/2050062045471740303][Ahmad on X: "My Homelab Is Technically the Cloud Now" / X]]
:PROPERTIES:
:TITLE: Ahmad on X: "My Homelab Is Technically the Cloud Now" / X
:URI: https://x.com/i/status/2050062045471740303
:CREATED: [2026-05-04 Mon 08:21]
:END:
* [[https://github.com/garrytan/gstack][garrytan/gstack: Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA]]
:PROPERTIES:
:TITLE: garrytan/gstack: Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA
:URI: https://github.com/garrytan/gstack
:CREATED: [2026-05-04 Mon 08:21]
:END:
* [[https://github.com/garrytan/gbrain][garrytan/gbrain: Garry's Opinionated OpenClaw/Hermes Agent Brain]]
:PROPERTIES:
:TITLE: garrytan/gbrain: Garry's Opinionated OpenClaw/Hermes Agent Brain
:URI: https://github.com/garrytan/gbrain
:CREATED: [2026-05-04 Mon 08:21]
:END:
* [[https://gxl.ai/blog/adding-arxiv-and-abstracts][Adding arXiv and 150M+ abstracts to Paperclip — GXL Blog]]
:PROPERTIES:
:TITLE: Adding arXiv and 150M+ abstracts to Paperclip — GXL Blog
:URI: https://gxl.ai/blog/adding-arxiv-and-abstracts
:CREATED: [2026-05-04 Mon 08:21]
:END:
* [[https://github.com/ciembor/agent-rules-books][ciembor/agent-rules-books: Ready-to-use Codex, Cursor, and Claude Code rules inspired by classic software engineering books.]]
:PROPERTIES:
:TITLE: ciembor/agent-rules-books: Ready-to-use Codex, Cursor, and Claude Code rules inspired by classic software engineering books.
:URI: https://github.com/ciembor/agent-rules-books
:CREATED: [2026-05-04 Mon 08:21]
:END:
* [[https://www.warp.dev/oz][Oz: The Orchestration Platform for Cloud Agents by Warp]]
:PROPERTIES:
:TITLE: Oz: The Orchestration Platform for Cloud Agents by Warp
:URI: https://www.warp.dev/oz
:CREATED: [2026-05-04 Mon 08:22]
:END:
* [[https://arxiv.org/abs/2508.04495][[2508.04495] Causal Reflection with Language Models]]
:PROPERTIES:
:TITLE: [2508.04495] Causal Reflection with Language Models
:URI: https://arxiv.org/abs/2508.04495
:CREATED: [2026-05-04 Mon 08:22]
:END:
* [[https://arxiv.org/abs/2508.15750v1][[2508.15750v1] Active Learning for Neurosymbolic Program Synthesis]]
:PROPERTIES:
:TITLE: [2508.15750v1] Active Learning for Neurosymbolic Program Synthesis
:URI: https://arxiv.org/abs/2508.15750v1
:CREATED: [2026-05-04 Mon 08:22]
:END:
* [[https://abideai.com/blog/whitepaper-aug25][Abide AI]]
:PROPERTIES:
:TITLE: Abide AI
:URI: https://abideai.com/blog/whitepaper-aug25
:CREATED: [2026-05-04 Mon 08:22]
:END:
* [[https://thedarklightx.github.io/Formal_Methods_Philosophy/][Home | Formal Philosophy]]
:PROPERTIES:
:TITLE: Home | Formal Philosophy
:URI: https://thedarklightx.github.io/Formal_Methods_Philosophy/
:CREATED: [2026-05-04 Mon 08:22]
:END:

View File

@@ -1 +0,0 @@
user@amr.154851:1777155215

View File

@@ -234,5 +234,5 @@ This is not a product. It is a philosophy made manifest in code.
* References * References
- [[file:chats-with-gemini.org][Full Chat Transcripts]] - [[file:chats-with-gemini.org][Full Chat Transcripts]]
- [[file:../projects/opencortex/README.org][OpenCortex README]] - [[file:../projects/passepartout/README.org][OpenCortex README]]
- [[file:../projects/opencortex/docs/ROADMAP.org][OpenCortex Roadmap]] - [[file:../projects/passepartout/docs/ROADMAP.org][OpenCortex Roadmap]]

120
projects/agora/TODO.org Normal file
View File

@@ -0,0 +1,120 @@
# Agora Project Tasks
# All Agora-related TODOs live here. gtd.org links to this file.
# Cross-reference: Passepartout integration at projects/passepartout
* PHASE: SPECIFICATION COMPLETE
All 10 requirement sections have been written. Gap analysis is done.
** DONE Create atomic notes for all 10 Agora sections
** DONE Fill CRITICAL and HIGH gaps [5 CRITICAL / 15 HIGH]
** DONE All MEDIUM and LOW gaps resolved
** FINAL STATUS: All Agora specification gaps complete
** PENDING INTEGRATE scattered specifications into requirements files [1/4]
Properties:
CREATED: [2026-03-18 Wed 02:00]
NEXT: Move content flag schema into Section 04
NEXT: Move PDS sync into Section 03
NEXT: Move delta sync into Section 08
NEXT: Delete duplicate documents after integration
* PHASE: PASSEPARTOUT INTEGRATION (Parallel Track)
This is a PARALLEL TRACK — does not block the core Passepartout roadmap (v0.3.0 → v1.0.0).
Identity + DIDComm gateway skills can be built anytime without core changes.
PDS transformation should wait until v1.0.0+.
The goal: make Passepartout a first-class AI Sub-Agent on the Agora network.
Architecture: Passepartout IS the PDS. Notes use plists natively with dual UUID + CID addressing.
Key design decisions (captured 2026-05-02):
1. Passepartout IS the PDS — the agent runs a personal data store in-process
2. Agora Notes use plists natively, not JSON — the PDS speaks Lisp
3. Dual addressing: every Note has a stable UUID (same across edits) and a CID (content hash)
4. Org files on disk ARE the user-facing view of Notes — no separate format
5. Clients and Relays are separate components, can be in any language, speak HTTP
6. The unified plist format is internal to PDS ↔ agent; clients request JSON
7. Integration is a PARALLEL TRACK — does not block or delay the core Passepartout roadmap (v0.3.0 → v1.0.0)
8. Timeline: Identity DID + DIDComm gateway = anytime (small skills). PDS transformation = v1.0.0+
The unified data model bridges memory-object → Agora Note:
| memory-object field | Agora Note field |
|---------------------|------------------|
| org-object-id | uuid (stable) |
| org-object-hash | cid (content hash) |
| getf attrs :TITLE | payload (derived) |
| getf attrs :TAGS | routing/access-control hints |
| org-object-children | child CIDs, reply_to, thread_root |
| org-object-content | payload body |
| merkle hash | CIDv1 (same SHA-256, different formatting)
** DRAFT 1. DID Identity Skill (identity-did.org)
A new skill that manages an Ed25519 keypair and DID document for the agent.
- Generate master keypair on first run (BIP-44 derived or Ed25519 fresh)
- Construct ~did:agora:<fingerprint>~ DID
- Sign outputs with the key for provenance
- Store keys in the vault (~*vault-memory*~, already exists in passepartout.security-vault)
File: ~org/identity-did.org~ (new)
Depends on: ~ironclad~ (already in ASDF deps), ~cl-json~ (already in ASDF deps)
** DRAFT 2. DIDComm Gateway (gateway-didcomm.org)
A new gateway following the same pattern as Telegram/Signal in ~gateway-manager~.
- Register poll/send functions in ~*gateway-registry*~
- Poll: listen for incoming DIDComm messages from the Relay Network or PDS
- Send: wrap an action in a DIDComm encrypted envelope (~JWE~) and deliver via Relay
- Messages arrive as framed protocol plists (same as CLI/TUI/Telegram)
The DIDComm spec is complex (DIDComm v2, JWM/JWE, HMAC, etc.). Initial implementation
can be a thin wrapper: JSON plist → sign with DID key → send to PDS → poll for replies.
File: ~org/gateway-didcomm.org~ (new)
Depends on: ~identity-did~, ~cl-json~, + DIDComm serialization library
** DRAFT 3. Memory — Note Adapter (system-memory-note.org)
Bridges Agora Notes into Passepartout's memory system.
- ~note-ingest~: take a CIDv1 + JSON payload, compute Merkle hash, store in ~*memory-history*~
- ~note-index~: extract key fields (title, author, timestamp) from JSON and store in
~*memory-store*~ as a memory-object with ~:cid~ attribute pointing to the history entry
- ~note-edit~: create a new draft with modifications, new CID, pending signature
- ~note-publish~: sign the draft, push to PDS via DIDComm gateway
This is Option C: Notes are canonical (in history), memory is derivative (in active store).
File: ~org/system-memory-note.org~ (new)
Depends on: ~gateway-didcomm~, ~core-memory~ (existing)
** DRAFT 4. Agent Persona (system-agent-persona.org)
Publish Passepartout itself as an Agora AI Persona (per Section 07).
- Register a DID for the agent
- Expose a "capabilities" Note listing the agent's skills as algorithms
- Accept invocation Notes from other persona owners
- Log all actions to an auditable Note chain
File: ~org/system-agent-persona.org~ (new)
Depends on: ~identity-did~, ~gateway-didcomm~, ~core-skills~
** DRAFT 5. Compute Marketplace (system-compute-provider.org)
Optional: expose Passepartout's LLM backends as a compute offering on Agora's marketplace.
- Register available models (Ollama, etc.) as compute offerings
- Accept inference requests via encrypted DIDComm
- Settle via Lightning Network payments (when Agora's payment layer is implemented)
File: ~org/system-compute-provider.org~ (future)
Depends on: ~identity-did~, ~gateway-didcomm~, ~gateway-llm~, ~gateway-provider~
* PHASE: ALETHEIA ANALYSIS
** TODO Critically analyze Master_Architecture_Document for lessons learned
and incorporation into Agora
Properties:
STATUS: PENDING USER INSTRUCTION
NOTES: User to provide pointers before commencing critical reading.
Do not proceed without explicit instruction.
* REFERENCE LINKS
- Agora requirements: ~/home/user/memex/projects/agora/docs/
- Gap analysis: ~/home/user/memex/projects/agora/docs/agora-consolidated-gap-analysis.org
- Passepartout repo: ~/home/user/memex/projects/passepartout
- Passepartout GTD: ~/home/user/memex/projects/passepartout/TODO.org

View File

@@ -8,6 +8,7 @@
(concat org-directory "/inbox.org") (concat org-directory "/inbox.org")
(concat org-directory "/gtd.org") (concat org-directory "/gtd.org")
(concat org-directory "/org-gtd-tasks.org") (concat org-directory "/org-gtd-tasks.org")
(concat org-directory "/projects/passepartout/TODO.org")
) )
) )

View File

@@ -18,7 +18,7 @@ Agenda files
(concat org-directory "/inbox.org") (concat org-directory "/inbox.org")
(concat org-directory "/gtd.org") (concat org-directory "/gtd.org")
(concat org-directory "/org-gtd-tasks.org") (concat org-directory "/org-gtd-tasks.org")
(concat org-directory "/projects/opencortex/TODO.org") (concat org-directory "/projects/passepartout/TODO.org")
) )
) )

View File

@@ -17,7 +17,7 @@ MEMEX_DAILY="memex/1_daily"
MEMEX_NOTES="memex/2_notes" MEMEX_NOTES="memex/2_notes"
MEMEX_DRAFTS="memex/3_drafts" MEMEX_DRAFTS="memex/3_drafts"
MEMEX_PUBLISHED="memex/4_published" MEMEX_PUBLISHED="memex/4_published"
MEMEX_PROJECTS="memex/5_projects" MEMEX_PROJECTS="memex/projects"
MEMEX_AREAS="memex/6_areas" MEMEX_AREAS="memex/6_areas"
MEMEX_RESOURCES="memex/7_resources" MEMEX_RESOURCES="memex/7_resources"
MEMEX_ARCHIVES="memex/8_archives" MEMEX_ARCHIVES="memex/8_archives"

1
projects/passepartout Submodule

Submodule projects/passepartout added at a31f19045a

View File

@@ -2127,7 +2127,7 @@ On package.el, it is a manual install so far
** OpenCortex ** OpenCortex
#+begin_src elisp #+begin_src elisp
;; 1. Manually add the path to your load-path ;; 1. Manually add the path to your load-path
(add-to-list 'load-path "~/memex/projects/opencortex/src") (add-to-list 'load-path "~/memex/projects/passepartout/src")
;; 2. Explicitly load the file ;; 2. Explicitly load the file
(require 'opencortex) (require 'opencortex)
@@ -2147,7 +2147,7 @@ On package.el, it is a manual install so far
;; (use-package opencortex ;; (use-package opencortex
;; :straight nil ;; :straight nil
;; :load-path "~/memex/projects/opencortex/src" ;; Adjust this to your local clone path ;; :load-path "~/memex/projects/passepartout/src" ;; Adjust this to your local clone path
;; :commands (opencortex-connect opencortex-disconnect) ;; :commands (opencortex-connect opencortex-disconnect)
;; :init ;; :init
;; Remote connection settings ;; Remote connection settings

View File

@@ -10,7 +10,7 @@ The user is seeing the agent's meta-commentary (e.g., "Okay, I've inserted...")
** Coder Phase ** Coder Phase
- [X] Create =inbox/flight-plan-chat-ui-fix.org= (this file). - [X] Create =inbox/flight-plan-chat-ui-fix.org= (this file).
- [ ] Update =projects/opencortex/src/opencortex.el= to replace "Thinking..." lines. - [ ] Update =projects/passepartout/src/opencortex.el= to replace "Thinking..." lines.
- [ ] Update =notes/org-skill-chat.org= to suppress conversational preamble. - [ ] Update =notes/org-skill-chat.org= to suppress conversational preamble.
- [ ] Tangle and restart. - [ ] Tangle and restart.

View File

@@ -22,7 +22,7 @@ This flight plan defines the strict, step-by-step protocol for escaping the Lisp
* Phase B: Tangle & Audit (The Coder) * Phase B: Tangle & Audit (The Coder)
** TODO 3. Tangle the Literate Source ** TODO 3. Tangle the Literate Source
- Action: Run =emacs --batch --eval '(require (quote ob-tangle))' --eval '(org-babel-tangle-file "~/memex/projects/opencortex/docs/README.org")'= - Action: Run =emacs --batch --eval '(require (quote ob-tangle))' --eval '(org-babel-tangle-file "~/memex/projects/passepartout/docs/README.org")'=
- Verification: The command must exit with code 0 and report that blocks were tangled. - Verification: The command must exit with code 0 and report that blocks were tangled.
** TODO 4. Audit the Physical Lisp Files ** TODO 4. Audit the Physical Lisp Files

View File

@@ -11,7 +11,7 @@ The current =opencortex= kernel is a "one-way" sensory system. It receives stimu
** Coder Phase ** Coder Phase
- [X] Create =inbox/flight-plan-emacs-bridge.org= (this file). - [X] Create =inbox/flight-plan-emacs-bridge.org= (this file).
- [ ] Update =projects/opencortex/docs/README.org= (Literate Kernel) with the stream-passing hook. - [ ] Update =projects/passepartout/docs/README.org= (Literate Kernel) with the stream-passing hook.
- [ ] Update =notes/org-skill-emacs-bridge.org= to implement the Harness Protocol outbound writer. - [ ] Update =notes/org-skill-emacs-bridge.org= to implement the Harness Protocol outbound writer.
- [ ] Tangle the updated files. - [ ] Tangle the updated files.
- [ ] Rebuild the daemon binary. - [ ] Rebuild the daemon binary.

View File

@@ -49,5 +49,5 @@ To handle code modifications safely and beautifully:
* Migration Strategy * Migration Strategy
This overhaul requires significant changes to: This overhaul requires significant changes to:
1. `projects/opencortex/src/opencortex.el` (The Emacs client). 1. `projects/passepartout/src/opencortex.el` (The Emacs client).
2. `notes/org-skill-chat.org` (To update the expected payload formats if we move beyond simple `:insert-at-end`). 2. `notes/org-skill-chat.org` (To update the expected payload formats if we move beyond simple `:insert-at-end`).

View File

@@ -11,14 +11,14 @@ Decouple HTTP request logic from the core neuro kernel (`neuro.lisp`) and migrat
- Solution: Move HTTP logic to `org-skill-provider-*` modules. The kernel's `ask-neuro` becomes a pure interface. - Solution: Move HTTP logic to `org-skill-provider-*` modules. The kernel's `ask-neuro` becomes a pure interface.
* Phase C: Success (Quality - Analyst Phase) * Phase C: Success (Quality - Analyst Phase)
- **TDD Requirement:** Create `projects/opencortex/tests/neuro-test.lisp` containing assertions for the new `ask-neuro` contract. - **TDD Requirement:** Create `projects/passepartout/tests/neuro-test.lisp` containing assertions for the new `ask-neuro` contract.
- The tests MUST be executed and PROVE failure before any code is modified. - The tests MUST be executed and PROVE failure before any code is modified.
- Tests will assert that: - Tests will assert that:
1. `ask-neuro` fails gracefully when the `*neuro-backends*` registry is empty. 1. `ask-neuro` fails gracefully when the `*neuro-backends*` registry is empty.
2. `ask-neuro` succeeds when a mock provider is registered and correctly delegates the prompt to the mock function. 2. `ask-neuro` succeeds when a mock provider is registered and correctly delegates the prompt to the mock function.
* Phase D: Build (Engineering - Coder Phase) * Phase D: Build (Engineering - Coder Phase)
- Strip `execute-openrouter-request`, `execute-groq-request`, and `execute-gemini-request` from `projects/opencortex/docs/README.org`. - Strip `execute-openrouter-request`, `execute-groq-request`, and `execute-gemini-request` from `projects/passepartout/docs/README.org`.
- Draft `notes/org-skill-provider-openrouter.org`. - Draft `notes/org-skill-provider-openrouter.org`.
- Draft `notes/org-skill-provider-groq.org`. - Draft `notes/org-skill-provider-groq.org`.
- Draft `notes/org-skill-provider-gemini.org`. - Draft `notes/org-skill-provider-gemini.org`.

View File

@@ -7,7 +7,7 @@
- Goal: Create a dedicated `*opencortex-reasoning*` buffer for internal LLM logs. Add an interrupt hotkey (`C-c C-k`). - Goal: Create a dedicated `*opencortex-reasoning*` buffer for internal LLM logs. Add an interrupt hotkey (`C-c C-k`).
* Phase B: Blueprint (Surgical Edits) * Phase B: Blueprint (Surgical Edits)
- Modify `projects/opencortex/src/opencortex.el` to route `(:log :LOG)` messages to `*opencortex-reasoning*`. - Modify `projects/passepartout/src/opencortex.el` to route `(:log :LOG)` messages to `*opencortex-reasoning*`.
- Add `opencortex-interrupt` command that sends `(:type :EVENT :payload (:sensor :interrupt))` to the kernel. - Add `opencortex-interrupt` command that sends `(:type :EVENT :payload (:sensor :interrupt))` to the kernel.
- Bind `C-c C-k` to `opencortex-interrupt` in the chat buffer. - Bind `C-c C-k` to `opencortex-interrupt` in the chat buffer.
- Open `*opencortex-reasoning*` as a side-window when `opencortex-chat` is called. - Open `*opencortex-reasoning*` as a side-window when `opencortex-chat` is called.

View File

@@ -4,9 +4,9 @@
Implement a recursive `cognitive-cycle` that allows the agent to chain multiple actions (tool calls) and observe results before finalising a response, similar to SOTA agents like Claude Code. Implement a recursive `cognitive-cycle` that allows the agent to chain multiple actions (tool calls) and observe results before finalising a response, similar to SOTA agents like Claude Code.
## Key Files & Context ## Key Files & Context
- `projects/opencortex/docs/README.org`: The primary source of truth for the kernel logic. - `projects/passepartout/docs/README.org`: The primary source of truth for the kernel logic.
- `projects/opencortex/src/core.lisp`: Tangled kernel implementation. - `projects/passepartout/src/core.lisp`: Tangled kernel implementation.
- `projects/opencortex/src/symbolic.lisp`: Contains the `decide` logic. - `projects/passepartout/src/symbolic.lisp`: Contains the `decide` logic.
## Implementation Steps ## Implementation Steps

View File

@@ -9,7 +9,7 @@ Break the cycle of chaotic debugging by performing a hard Git rollback to the la
* Phase A: Purge & Reset (The Scientist) * Phase A: Purge & Reset (The Scientist)
** TODO 1. Hard Rollback ** TODO 1. Hard Rollback
- Action: Execute `git reset --hard` and `git clean -fd` in `~/memex/projects/opencortex`. - Action: Execute `git reset --hard` and `git clean -fd` in `~/memex/projects/passepartout`.
- Verification: Directory is clean of untracked files and uncommitted changes. - Verification: Directory is clean of untracked files and uncommitted changes.
** TODO 2. Nuke the Lisp Cache ** TODO 2. Nuke the Lisp Cache

View File

@@ -9,7 +9,7 @@ Rigorous recovery of the =opencortex= kernel after a series of failed build loop
* Phase A: Purge & Reset (The Scientist) * Phase A: Purge & Reset (The Scientist)
** TODO 1. Hard Git Reset ** TODO 1. Hard Git Reset
- Action: =git reset --hard= and =git clean -fd= in =~/memex/projects/opencortex=. - Action: =git reset --hard= and =git clean -fd= in =~/memex/projects/passepartout=.
- Verification: =git status= must be clean. - Verification: =git status= must be clean.
** TODO 2. Nuke Lisp & Quicklisp Caches ** TODO 2. Nuke Lisp & Quicklisp Caches

View File

@@ -6,7 +6,7 @@
The `cognitive-cycle` pipeline (Consolidation V) established the functional gates (`perceive`, `neuro`, `consensus`, `decide`, `dispatch`). However, the `consensus-gate` remains a pass-through. Furthermore, the `opencortex` currently lacks the ability to formally verify GTD state transitions (Task Integrity) and hand off complex logic to background threads (Delegation). The Task Orchestrator integrates these three capabilities. The `cognitive-cycle` pipeline (Consolidation V) established the functional gates (`perceive`, `neuro`, `consensus`, `decide`, `dispatch`). However, the `consensus-gate` remains a pass-through. Furthermore, the `opencortex` currently lacks the ability to formally verify GTD state transitions (Task Integrity) and hand off complex logic to background threads (Delegation). The Task Orchestrator integrates these three capabilities.
* Scope & Impact * Scope & Impact
- *Target Files:* `projects/opencortex/src/core.lisp`, `projects/opencortex/src/neuro.lisp`, `projects/opencortex/src/symbolic.lisp`. - *Target Files:* `projects/passepartout/src/core.lisp`, `projects/passepartout/src/neuro.lisp`, `projects/passepartout/src/symbolic.lisp`.
- *Impact:* The Probabilistic Engine layer will spawn multiple threads to query providers simultaneously. Deterministic Engine will enforce GTD state integrity and manage sub-agent delegation. - *Impact:* The Probabilistic Engine layer will spawn multiple threads to query providers simultaneously. Deterministic Engine will enforce GTD state integrity and manage sub-agent delegation.
- *Dependencies:* Requires `bordeaux-threads` for sub-agent management and the existing `org-gtd` v4.0 DAG. - *Dependencies:* Requires `bordeaux-threads` for sub-agent management and the existing `org-gtd` v4.0 DAG.
@@ -21,7 +21,7 @@ The `cognitive-cycle` pipeline (Consolidation V) established the functional gate
* Implementation Plan * Implementation Plan
** Phase C: Success (Testing) ** Phase C: Success (Testing)
- Draft `projects/opencortex/tests/orchestrator-test.lisp`. - Draft `projects/passepartout/tests/orchestrator-test.lisp`.
- Assert that `consensus-gate` correctly handles 3 diverging proposals and selects the safest one. - Assert that `consensus-gate` correctly handles 3 diverging proposals and selects the safest one.
- Assert that `task-integrity-check` rejects closing a parent task with active children. - Assert that `task-integrity-check` rejects closing a parent task with active children.