# Builder's Journal

Structured memory for agents building MoltNet, before MoltNet exists to hold it.

See [BUILDER_JOURNAL.md](../BUILDER_JOURNAL.md) for the full method specification.

## How to Use

**Starting a session:** Read the most recent `handoff` entry below.

**During a session:** Write `decision`, `discovery`, `problem`, `progress`, `reflection`, or `correction` entries as they happen.

**Ending a session:** Write a `handoff` entry and commit.

## Entries

| Date       | Type       | Title                                                                                                                                              |
| ---------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2026-01-30 | decision   | [Project Genesis](2026-01-30-01-project-genesis.md)                                                                                                |
| 2026-01-30 | progress   | [Monorepo Scaffolding](2026-01-30-02-monorepo-scaffolding.md)                                                                                      |
| 2026-01-30 | discovery  | [OpenClaw Analysis](2026-01-30-03-openclaw-analysis.md)                                                                                            |
| 2026-01-30 | decision   | [Journal Method](2026-01-30-04-journal-method.md)                                                                                                  |
| 2026-01-30 | handoff    | [Session Handoff](2026-01-30-05-session-handoff.md)                                                                                                |
| 2026-01-31 | progress   | [Observability Library](2026-01-31-01-observability-library.md)                                                                                    |
| 2026-01-31 | decision   | [@fastify/otel Integration](2026-01-31-02-fastify-otel-integration.md)                                                                             |
| 2026-01-31 | progress   | [CI Pipeline & Safeguards](2026-01-31-03-ci-pipeline-safeguards.md)                                                                                |
| 2026-01-31 | handoff    | [Session Handoff](2026-01-31-04-session-handoff.md)                                                                                                |
| 2026-01-31 | decision   | [dotenvx Split-File](2026-01-31-05-dotenvx-split-file.md)                                                                                          |
| 2026-01-31 | progress   | [Ory Config Consolidation](2026-01-31-06-ory-config-consolidation.md)                                                                              |
| 2026-01-31 | handoff    | [Session Handoff](2026-01-31-07-session-handoff.md)                                                                                                |
| 2026-01-31 | handoff    | [Design System Handoff](2026-01-31-08-session-handoff.md)                                                                                          |
| 2026-01-31 | decision   | [Agent Coordination Framework](2026-01-31-09-agent-coordination-framework.md)                                                                      |
| 2026-01-31 | handoff    | [Session Handoff](2026-01-31-10-session-handoff.md)                                                                                                |
| 2026-01-31 | reflection | [Mission Integrity Analysis](2026-01-31-11-mission-integrity-analysis.md)                                                                          |
| 2026-01-31 | handoff    | [pnpm Migration with Catalogs](2026-01-31-12-pnpm-migration.md)                                                                                    |
| 2026-01-31 | handoff    | [Knip Code Analysis & Audit CI](2026-01-31-13-knip-code-analysis-ci.md)                                                                            |
| 2026-01-31 | progress   | [Visual Identity — The Molt Mark](2026-01-31-12-visual-identity.md)                                                                                |
| 2026-01-31 | progress   | [Landing Page](2026-01-31-14-landing-page.md)                                                                                                      |
| 2026-01-31 | discovery  | [TS Project References](2026-01-31-15-tsconfig-project-references.md)                                                                              |
| 2026-01-31 | handoff    | [Visual Identity V2 & Landing Integration](2026-01-31-16-visual-identity-v2-handoff.md)                                                            |
| 2026-01-31 | handoff    | [API Client Generation & MCP Migration](2026-01-31-17-api-client-openapi.md)                                                                       |
| 2026-01-31 | handoff    | [ESLint v9 Flat Config Migration](2026-01-31-18-eslint-v9-flat-config.md)                                                                          |
| 2026-01-31 | handoff    | [Orchestrate Skill](2026-01-31-19-orchestrate-skill.md)                                                                                            |
| 2026-01-31 | progress   | [Docker Compose Local Dev](2026-01-31-20-docker-compose-local-dev.md)                                                                              |
| 2026-01-31 | handoff    | [Config Module with TypeBox Validation](2026-01-31-20-config-module-handoff.md)                                                                    |
| 2026-01-31 | progress   | [Landing Page UI Fixes](2026-01-31-20-landing-page-ui-fixes.md)                                                                                    |
| 2026-02-01 | handoff    | [Diary Service Integration Tests & Hybrid Search](2026-02-01-01-diary-service-integration.md)                                                      |
| 2026-02-01 | handoff    | [@moltnet/embedding-service](2026-02-01-01-embedding-service.md)                                                                                   |
| 2026-02-01 | handoff    | [Auth Library — Dual Token Validation](2026-02-01-01-auth-library-jwks-support.md)                                                                 |
| 2026-02-01 | handoff    | [State Audit & Task Realignment](2026-02-01-02-state-audit-realignment.md)                                                                         |
| 2026-02-03 | discovery  | [Webhook Routes 404: Fastify Encapsulation](2026-02-03-01-webhook-routes-404-fastify-encapsulation.md)                                             |
| 2026-02-01 | handoff    | [WS7 Phase 1 — Landing Page Deployed](2026-02-01-03-ws7-landing-deployment.md)                                                                     |
| 2026-02-01 | handoff    | [pnpm v10 inject-workspace-packages + TS Project References](2026-02-01-04-pnpm-v10-inject-workspace-packages.md)                                  |
| 2026-02-01 | handoff    | [WS11 — Human Participation Plan](2026-02-01-05-human-participation-plan.md)                                                                       |
| 2026-02-02 | handoff    | [REST API E2E Tests with Real Auth](2026-02-02-01-rest-api-e2e-tests.md)                                                                           |
| 2026-02-03 | handoff    | [Keto Namespace Configuration Fix](2026-02-03-02-keto-namespace-fix.md)                                                                            |
| 2026-02-03 | handoff    | [Merge main into PR #62 and fix CI failures](2026-02-03-03-merge-main-fix-pr62.md)                                                                 |
| 2026-02-03 | progress   | [Landing Page Accuracy Update](2026-02-03-04-landing-page-accuracy-update.md)                                                                      |
| 2026-02-04 | handoff    | [RFC 9457 Error Responses](2026-02-04-01-rfc9457-error-responses.md)                                                                               |
| 2026-02-04 | handoff    | [E2E Auth Lifecycle Tests](2026-02-04-02-e2e-auth-lifecycle-tests.md)                                                                              |
| 2026-02-04 | handoff    | [Workspace Tasks Standardization](2026-02-04-03-workspace-tasks-standardization.md)                                                                |
| 2026-02-04 | handoff    | [Landing Page — MoltNet Focus](2026-02-04-03-landing-page-moltnet-focus.md)                                                                        |
| 2026-02-05 | handoff    | [Keto as Sole Authorization Authority](2026-02-05-01-keto-sole-authority.md)                                                                       |
| 2026-02-05 | progress   | [Agent Discovery Layer](2026-02-05-02-agent-discovery-layer.md)                                                                                    |
| 2026-02-05 | progress   | [Security Hardening](2026-02-05-03-security-hardening.md)                                                                                          |
| 2026-02-06 | correction | [DBOS Atomicity Fix](2026-02-06-01-dbos-atomicity-fix.md)                                                                                          |
| 2026-02-06 | handoff    | [pnpm + TS References + Vite SSR Builds](2026-02-06-01-pnpm-ts-references-vite-ssr.md)                                                             |
| 2026-02-06 | handoff    | [GitHub Projects Agent Sync](2026-02-06-02-github-projects-agent-sync.md)                                                                          |
| 2026-02-06 | handoff    | [Harden Docker Images](2026-02-06-03-harden-docker-images.md)                                                                                      |
| 2026-02-06 | progress   | [Embedding Vector Leakage Fix](2026-02-06-04-embedding-vector-leakage-fix.md)                                                                      |
| 2026-02-06 | handoff    | [Voucher Race Condition Fix](2026-02-06-05-voucher-race-condition-fix.md)                                                                          |
| 2026-02-06 | handoff    | [Harden Ory Network Config](2026-02-06-04-harden-ory-configs.md)                                                                                   |
| 2026-02-06 | discovery  | [Ory CLI auto-loads .env, breaking dotenvx](2026-02-06-06-ory-cli-dotenvx-fix.md)                                                                  |
| 2026-02-06 | handoff    | [Combined Server Deploy](2026-02-06-06-combined-server-deploy.md)                                                                                  |
| 2026-02-06 | progress   | [Upgrade Drizzle ORM/Kit and DBOS SDK](2026-02-06-07-upgrade-drizzle-dbos.md)                                                                      |
| 2026-02-06 | handoff    | [Hook-Driven Task Lifecycle](2026-02-06-08-hook-driven-task-lifecycle.md)                                                                          |
| 2026-02-07 | handoff    | [E2E Tests Against Docker Container](2026-02-07-01-e2e-docker-container-tests.md)                                                                  |
| 2026-02-07 | discovery  | [Issue Triage Bot Fix](2026-02-07-02-issue-triage-bot-fix.md)                                                                                      |
| 2026-02-07 | handoff    | [REST API Error Handling](2026-02-07-03-rest-api-error-handling.md)                                                                                |
| 2026-02-07 | progress   | [Genesis Bootstrap Script](2026-02-07-04-genesis-bootstrap-script.md)                                                                              |
| 2026-02-07 | handoff    | [Genesis Bootstrap Handoff](2026-02-07-05-genesis-bootstrap-handoff.md)                                                                            |
| 2026-02-07 | handoff    | [eslint-plugin-boundaries for Workspace Boundaries](2026-02-07-01-eslint-plugin-boundaries.md)                                                     |
| 2026-02-07 | handoff    | [MCP-First Demo Agents with Persona System](2026-02-07-02-mcp-first-demo-agents.md)                                                                |
| 2026-02-08 | handoff    | [Project Board Automation & Stop Hook Bugfix](2026-02-08-01-project-automation-workflow.md)                                                        |
| 2026-02-08 | handoff    | [Landing Page — The Experiment Section](2026-02-08-02-landing-experiment-section.md)                                                               |
| 2026-02-08 | handoff    | [MCP Server Rewrite to @getlarge/fastify-mcp](2026-02-08-03-mcp-fastify-plugin-rewrite.md)                                                         |
| 2026-02-08 | handoff    | [@moltnet/mcp-auth-proxy Plugin](2026-02-08-02-mcp-auth-proxy-plugin.md)                                                                           |
| 2026-02-08 | handoff    | [MCP Server E2E Tests & Vouch Unit Tests](2026-02-08-04-mcp-server-e2e-tests.md)                                                                   |
| 2026-02-08 | handoff    | [DBOS Signing Workflow](2026-02-08-03-dbos-signing-workflow.md)                                                                                    |
| 2026-02-08 | correction | [DBOS Workflows Must Start Outside runTransaction()](2026-02-08-05-dbos-transaction-discipline-correction.md)                                      |
| 2026-02-09 | handoff    | [Deploy Preflight Check for Missing Fly.io Secrets](2026-02-09-01-deploy-preflight-secrets.md)                                                     |
| 2026-02-09 | handoff    | [MCP Server Fly.io Deployment Config](2026-02-09-02-mcp-server-fly-deploy.md)                                                                      |
| 2026-02-08 | handoff    | [Drizzle Migration Tooling](2026-02-08-06-drizzle-migration-tooling.md)                                                                            |
| 2026-02-09 | handoff    | [Demo Agent Signing, Auth Fixes, Self-Service Registration](2026-02-09-03-demo-agent-signing-auth-fixes.md)                                        |
| 2026-02-10 | handoff    | [Landing Page Restructure — Multi-Page SPA](2026-02-10-01-landing-page-restructure.md)                                                             |
| 2026-02-11 | progress   | [AsyncLocalStorage Transaction Propagation](2026-02-11-01-transaction-propagation-als.md)                                                          |
| 2026-02-11 | handoff    | [Auth Register Proxy + Registration Skill](2026-02-11-02-auth-register-proxy.md)                                                                   |
| 2026-02-11 | handoff    | [WS11 Public Feed API](2026-02-11-03-public-feed-api.md)                                                                                           |
| 2026-02-12 | handoff    | [Agent SDK and Go CLI — Registration On-Ramp](2026-02-12-01-agent-sdk-go-cli.md)                                                                   |
| 2026-02-12 | handoff    | [Agent Identity Visualisation Components](2026-02-12-01-agent-identity-visualisation.md)                                                           |
| 2026-02-12 | handoff    | [Bump @getlarge/fastify-mcp to 1.3.0-getlarge.1](2026-02-12-01-bump-fastify-mcp.md)                                                                |
| 2026-02-13 | handoff    | [Automate Ory Network Config Deployment](2026-02-13-01-deploy-ory-ci.md)                                                                           |
| 2026-02-13 | handoff    | [Agent Fingerprint Colors](2026-02-13-02-agent-fingerprint-colors.md)                                                                              |
| 2026-02-13 | handoff    | [SDK Documentation in README and Landing Page](2026-02-13-02-sdk-docs-readme-landing.md)                                                           |
| 2026-02-13 | handoff    | [Migrate from @ory/client to @ory/client-fetch](2026-02-13-03-ory-client-fetch-migration.md)                                                       |
| 2026-02-13 | handoff    | [Homebrew Tap + npm CLI Wrapper](2026-02-13-04-homebrew-npm-cli-wrapper.md)                                                                        |
| 2026-02-13 | handoff    | [Registration Admin API + DBOS Workflow](2026-02-13-01-registration-admin-api.md)                                                                  |
| 2026-02-13 | handoff    | [Draft Releases for Immutable Release Compatibility](2026-02-13-05-draft-immutable-releases.md)                                                    |
| 2026-02-13 | handoff    | [MCP Config Metadata & Transport Update](2026-02-13-06-mcp-config-metadata.md)                                                                     |
| 2026-02-13 | handoff    | [TypeBox Type Provider Refactor](2026-02-13-06-typebox-type-provider.md)                                                                           |
| 2026-02-13 | handoff    | [Public Feed UI](2026-02-13-07-public-feed-ui.md)                                                                                                  |
| 2026-02-13 | handoff    | [CodeQL Security Alert Remediation](2026-02-13-08-codeql-security-hardening.md)                                                                    |
| 2026-02-14 | handoff    | [Identity & Soul Diary System](2026-02-14-01-identity-soul-diary.md)                                                                               |
| 2026-02-14 | handoff    | [API Validation Hardening](2026-02-14-01-api-validation-hardening.md)                                                                              |
| 2026-02-14 | handoff    | [OpenClaw Skill Package (ClawHub + GitHub Release)](2026-02-14-02-openclaw-skill-package.md)                                                       |
| 2026-02-14 | handoff    | [Parallelize CI Docker Builds](2026-02-14-03-parallelize-ci-docker-builds.md)                                                                      |
| 2026-02-14 | handoff    | [Protect Recovery Flow](2026-02-14-04-protect-recovery-flow.md)                                                                                    |
| 2026-02-15 | handoff    | [Public Feed Semantic Search](2026-02-15-01-public-feed-search.md)                                                                                 |
| 2026-02-15 | handoff    | [moltnet_info Discovery Tool](2026-02-15-01-moltnet-info-discovery.md)                                                                             |
| 2026-02-15 | handoff    | [Split Landing + Consolidate Server into REST API](2026-02-15-02-split-landing-consolidate-server.md)                                              |
| 2026-02-15 | handoff    | [Fix ClawHub Suspicious Skill Review](2026-02-15-02-clawhub-skill-review-fix.md)                                                                   |
| 2026-02-16 | progress   | [/llms.txt Endpoint and NETWORK_INFO Rules](2026-02-16-01-llms-txt-endpoint.md)                                                                    |
| 2026-02-16 | handoff    | [OAuth2 Token Proxy + ClawHub Skill Compliance](2026-02-16-01-oauth2-token-proxy.md)                                                               |
| 2026-02-16 | handoff    | [Agent Git Identity — Signed Commits with MoltNet Keys](2026-02-16-01-agent-git-identity.md)                                                       |
| 2026-02-16 | handoff    | [LeGreffier Skill, MCP Config, and Claude Code Hooks](2026-02-16-02-legreffier-skill-and-mcp.md)                                                   |
| 2026-02-16 | decision   | [Externalize DBOS Workflow Registration](2026-02-16-02-dbos-plugin-externalize-workflows.md)                                                       |
| 2026-02-17 | handoff    | [Diary Tags Filter](2026-02-17-01-diary-tags-filter.md)                                                                                            |
| 2026-02-17 | handoff    | [Technical Architecture Diagrams](2026-02-17-01-architecture-diagrams.md)                                                                          |
| 2026-02-18 | handoff    | [SDK Connect + Token Management](2026-02-18-01-sdk-connect-token-management.md)                                                                    |
| 2026-02-18 | handoff    | [Documentation Consolidation](2026-02-18-02-docs-consolidation.md)                                                                                 |
| 2026-02-18 | handoff    | [SDK namespace interfaces derived from api-client Data types](2026-02-18-02-sdk-diary-types-drift-fix.md)                                          |
| 2026-02-18 | handoff    | [Deterministic Signing Payload via SHA-256 Pre-Hash](2026-02-18-03-deterministic-signing-payload.md)                                               |
| 2026-02-19 | handoff    | [Diary Schema Enrichment & Weighted Scoring](2026-02-19-01-diary-schema-enrichment.md)                                                             |
| 2026-02-19 | handoff    | [Signature-Only Verification + Nonce-First Signing](2026-02-19-02-signature-verify-nonce.md)                                                       |
| 2026-02-19 | handoff    | [Quickstart Consistency + Discovery Source of Truth](2026-02-19-03-quickstart-discovery-centralization.md)                                         |
| 2026-02-19 | handoff    | [MCP Snake-Case Inputs from Generated API Types](2026-02-19-03-mcp-snake-case-api-types.md)                                                        |
| 2026-02-19 | handoff    | [Fix: signing_payload Misdirection in crypto_prepare_signature](2026-02-19-04-signing-payload-misdirection-fix.md)                                 |
| 2026-02-20 | handoff    | [Go CLI: Authenticated API Operations](2026-02-20-01-go-cli-api-operations.md)                                                                     |
| 2026-02-20 | decision   | [Content-Signed Immutable Diary Entries](2026-02-20-01-content-signed-immutable-entries.md)                                                        |
| 2026-02-20 | decision   | [MoltNet Memory Consolidation Skill](2026-02-20-02-moltnet-memory-consolidation-skill.md)                                                          |
| 2026-02-21 | problem    | [onnxruntime-node Native Addon Bundled by Vite SSR — Silent Embedding Failure](2026-02-21-02-onnxruntime-vite-bundle-fix.md)                       |
| 2026-02-21 | handoff    | [Signing Input Protocol — signing_input field, SDK signBytes, Go CLI, MCP update](2026-02-21-03-signing-input-protocol.md)                         |
| 2026-02-21 | handoff    | [Multi-Diary: Full Implementation + Keto E2E Tests](2026-02-20-01-keto-permission-e2e-tests.md)                                                    |
| 2026-02-21 | handoff    | [SDK dts Bundle Fix](2026-02-21-01-sdk-dts-bundle-fix.md)                                                                                          |
| 2026-02-22 | handoff    | [CI Image Promotion — Build Once, Deploy the Tested Image](2026-02-22-01-ci-image-promotion.md)                                                    |
| 2026-02-23 | handoff    | [Multi-Diary PR #258 — Code Review Fixes](2026-02-23-01-multi-diary-pr-review-fixes.md)                                                            |
| 2026-02-23 | handoff    | [MCP Tool Rename — `diary_*` → `diaries_*` / `entries_*` / `reflect`](2026-02-23-02-mcp-diary-entry-rename.md)                                     |
| 2026-02-23 | handoff    | [README Redesign — Remove Stale Tool Tables, Add Scalar UI](2026-02-23-03-readme-redesign.md)                                                      |
| 2026-02-24 | handoff    | [LeGreffier Skill Consolidation — Multi-Diary Model and MCP Tool Rename](2026-02-24-01-legreffier-skill-consolidation.md)                          |
| 2026-02-24 | handoff    | [Sponsor Agent Infrastructure — `issueUnlimited()` + `SPONSOR_AGENT_ID` Config](2026-02-24-02-sponsor-agent-infrastructure.md)                     |
| 2026-02-24 | handoff    | [Structured Logging Strategy — ALS Context + Pino Mixin](2026-02-24-03-logging-strategy.md)                                                        |
| 2026-02-24 | handoff    | [LeGreffier Onboarding Workflow — DBOS workflow + 4 public endpoints](2026-02-24-04-legreffier-onboarding-workflow.md)                             |
| 2026-02-24 | handoff    | [OTel Direct-to-Axiom + Auto-Instrumentation — initInstrumentation, MCP server observability, SDK 2.x upgrade](2026-02-24-03-otel-direct-axiom.md) |
| 2026-02-25 | handoff    | [OTel Axiom Region Fix + BigInt Crash Fix — EU endpoint, undefined startTime guard](2026-02-25-01-otel-axiom-region-bigint-fix.md)                 |
| 2026-02-25 | handoff    | [Security Hardening — Audit #202 Findings](2026-02-25-02-security-hardening-audit.md)                                                              |
| 2026-02-26 | handoff    | [LeGreffier Init CLI — Full Happy Path + Polished UX](2026-02-26-01-legreffier-init-cli.md)                                                        |
| 2026-02-26 | handoff    | [LeGreffier E2E Tests + CLI Test Fixes](2026-02-26-02-legreffier-e2e-tests.md)                                                                     |
| 2026-02-27 | handoff    | [LeGreffier CLI Polish — Config Centralization, Skill Upgrades, Publishing](2026-02-27-01-legreffier-cli-polish.md)                                |
| 2026-02-27 | handoff    | [Landing Page — Privacy & Encryption Workstream](2026-02-27-01-landing-privacy-workstream.md)                                                      |
| 2026-02-27 | handoff    | [`legreffier setup` Subcommand and Codex Adapter](2026-02-27-02-legreffier-setup-codex.md)                                                         |
| 2026-02-27 | handoff    | [X25519 Key Derivation & Sealed Envelope Encryption](2026-02-27-02-x25519-key-derivation.md)                                                       |
| 2026-02-28 | handoff    | [Diary Search Negation Fix & E5-base-v2 Analysis](2026-02-28-01-diary-search-negation-fix.md)                                                      |
| 2026-03-01 | handoff    | [Context Flywheel Roadmap Teaser and WS16 Setup](2026-03-01-01-context-flywheel-status-workstream.md)                                              |
| 2026-03-02 | problem    | [Fix @themoltnet/legreffier Published with Unpublished Workspace Deps](2026-03-02-01-fix-legreffier-publish.md)                                    |
| 2026-03-02 | decision   | [LeGreffier Scan Skill — Codebase Evidence Generation](2026-03-02-01-legreffier-scan-skill.md)                                                     |
| 2026-03-03 | handoff    | [Fix Release Workflow Resilient to Draft Release Failures](2026-03-03-01-fix-release-workflow-draft-resilience.md)                                 |
| 2026-03-03 | handoff    | [GitHub Token Subcommand](2026-03-03-02-github-token-subcommand.md)                                                                                |
| 2026-03-04 | progress   | [File-Based Token Caching & Scoped gh Commands](2026-03-04-01-token-caching-scoped-gh.md)                                                          |
| 2026-03-04 | discovery  | [OTel Runtime Metrics & Distributed Trace Propagation Fix](2026-03-04-01-otel-runtime-metrics-trace-propagation.md)                                |
| 2026-03-05 | handoff    | [Phase 1: @moltnet/context-distill Library](2026-03-05-01-context-distill-library.md)                                                              |
| 2026-03-05 | handoff    | [Docker Build Speedup: Model Stage Isolation + .dockerignore Fixes](2026-03-05-02-docker-build-speedup.md)                                         |
| 2026-03-06 | handoff    | [Context Distill Phase 2 — DBOS Workflows + API Endpoints](2026-03-06-01-context-distill-phase2.md)                                                |
| 2026-03-06 | handoff    | [Entry-Centric Routes + SDK Distill Surface (Issues #377 + #379)](2026-03-06-02-entry-centric-routes-sdk-distill.md)                               |
| 2026-03-21 | handoff    | [Custom Pack Preview + Create API (Issue #456)](2026-03-21-01-custom-pack-preview-create-api.md)                                                   |
| 2026-03-21 | handoff    | [Custom Pack MCP Tools, Generated Clients, and E2E Coverage](2026-03-21-02-custom-pack-mcp-sdk-e2e.md)                                             |
