Trace Ready (Click Play to Start)

Interactive Blueprint Β· Official English Edition

Neo-Secretary: Desk Pet & AI Approval Bridge Showcase

Trace how mobile one-tap approvals and autonomous AI completions flow through Zero-Trust authentication, LangGraph state machines, and SQLite WAL into rich multi-modal reactions.

πŸ“˜ Official Cheatsheets & Guide βž” πŸ‡―πŸ‡΅ ζ—₯本θͺž
Product Vision Β· PO Layer (v1.1.18)

🎯 North Star (Product Purpose & Why)

"Delegate autonomous AI coding to your PC, spend weekends with family in the living room." Upcycle spare smartphones into an ambient living-space companion & notice gateway, salvaging crucial 1-second approvals with a single tap to maximize developer lifespan.
Core Value Proposition

πŸ’Ž 3-Tier Product Architecture (The Core Triad)

πŸ””

[Core] Remote Approval Remote

One-tap command approval for Claude Code, Cline, Cursor, etc. Transparent hook injection (with instant cancel_pending eviction) and standard FastMCP bridge let you advance builds with zero friction while enjoying coffee.

🐾

[Soul] 16-Bit Pixel Pet & Built-in Skins

Breathing pixel companions celebrate build milestones. Powered by 0fps adaptive power-saving sleep that eliminates battery drain, blending into your living room as an ambient companion.

πŸ“–

[Base] Notebook, Habits & iCal Sync

The daily living-space anchor keeping the approval remote standing. Non-competing with dedicated apps like TickTick; quietly supports routines with focused TODOs, habits, and Google Calendar lookaheads.

Truth Ladder

Simple at First Sight, Honest to the Smallest Detail.

A palm-sized desktop companion that guards your focus, celebrates build milestones, and lets you approve commands from your couch.

Module Architecture

Module Blueprint Specification

Entrypoint

pwa-client

Outputs & Feedback

pc-mascot-ui

audio-feedback

Source Code

local-server-srcmain-app-srcdatabase-src
Signal Trace

Trace Real-Time Data Flow Across System Boundaries

Trace Ready (Click Play to Start)

01

1. Mobile PWA Ingress & Zero-Trust Authentication

The local Python server validates Bearer tokens and dispatches action requests sent from the mobile PWA client.

Actor

Mobile Desk Pet (PWA)

Always-on tactile smart display with 8-bit sound synthesis and offline caching.

Decision

Sync Server (LocalSyncServer)

Lightweight HTTP daemon enforcing constant-time Bearer authentication and CORS origin echoing.

Impact
Remote operations from smartphone are blocked.
Symptom
Server logs HTTP 401 Unauthorized errors.
Fallback
Re-issue pairing token instantly via desktop QR code.
02

2. LangGraph State Machine & Agent Supervision

Processes user commands and intercepts external AI agent build completions asynchronously without blocking UI render threads.

Event

Agent Supervision Daemon

Monitors CLI build output and intercepts command approval requests in real time.

Process

LangGraph & LLM Factory

Dynamically switches between Gemini, Claude, and local GGUF models.

Impact
Cloud AI reasoning is temporarily suspended.
Symptom
External API timeout or rate limit exceeded.
Fallback
Gracefully falls back to local GGUF models or preset dialogue lines.
03

3. Local Persistence & Multi-Modal Feedback

Persists state mutations into SQLite WAL and orchestrates desktop overlay animations and synthesized audio chimes.

Store

SQLite WAL Database

Persistent store for tasks, habits, and tamper-resistant approval audit trails.

Actor

Desktop Mascot (Tkinter)

Top-level transparent window rendering breathing pixel sprites and comic balloons.

Event

Audio & Chime Synthesizer

8-bit sound effects and speech synthesis for milestone notifications.

System Architecture Β· Archify Edition

πŸ›οΈ High-Definition System Architecture Blueprint

Interactive high-resolution architecture blueprint. Drag to pan and scroll to zoom.

β›Ά Fullscreen in New Tab β†—
πŸ’‘ Core Component Deep Dives (Tap to inspect details):
Core Concepts

πŸ“š Essential Core Concepts

πŸ”’ Local-First, Least Privilege & Mandatory Approval

Security architecture enforcing Bearer token authentication on all requestsβ€”even within local LANβ€”with zero cloud dependencies or external relays.

πŸ“± Desktop Approval Remote (Desk Pet)

Always-on tactile PWA turning spare smartphones into a companion desk pet to review and authorize AI agent terminal commands with one tap.

πŸ’Ύ SQLite WAL & 3-Tier Defense Engine

Write-Ahead Logging (WAL) prevents concurrency lock contention between GUI and HTTP server, backed by strict anti-self-approval protection against RCE.