LQ Memory

Local prototype for an LQ agent memory system.

The v0 design keeps the canonical index inspectable:

• output/index/manifest.json
• output/index/xmap.json
• output/index/files.jsonl
• output/index/reports.jsonl

SQLite lives at data/lq_memory.sqlite as an accelerator and join sidecar.

Quick Start

cd /space/repo/notes/lq-memory
python3 -m memory.cli index --full-rebuild
python3 -m memory.cli ingest-repro --auto-discover /space/repo/notes/repro_runner /space/repo/notes
python3 -m memory.cli refresh-docs --roots /space/obsidian-all/lq-confluence /space/obsidian-all/agent-skills
python3 -m memory.cli context --test-id C14281183 --env cms_test3

Wrapper scripts in scripts/ call the same commands.

Pi Code Usage

Pi Code should use this tool through the CLI only.

Runtime contract:

cd /space/repo/notes/lq-memory
python3 -m memory.cli <command>

Recommended first command in a session:

python3 -m memory.cli health-check

Recommended query flow:

python3 scripts/detect_changes.py --mode working-tree --out output/changed_paths.json
python3 scripts/index_incremental.py --changed output/changed_paths.json
python3 -m memory.cli context --test-id C14281183 --env cms_test3 --out output/context-C14281183.md
python3 -m memory.cli rca --test-id C14281183 --env cms_test3 --out output/rca-C14281183.md

Pi Code should read the generated context pack and report these sections:

• Application Influence
• Log Locations
• Database Schema Signals
• Confluence Hits
• Other Doc Hits
• Recommended Next Step

When asked for RCA or a fix proposal, Pi Code should also read the generated RCA pack and report:

• Evidence Summary
• Documentation Signals
• RCA Hypotheses
• Evidence Collection Plan
• Fix Proposal Workflow
• Confidence Policy
• Wiki Update

The rca command updates the LLM wiki by default:

• wiki/index.md
• wiki/log.md
• wiki/features/*.md
• wiki/apps/*.md
• wiki/db/*.md

Detailed Pi instructions live in:

• docs/pi-code-agent-guide.md
• docs/pi-code-playbooks.md
• docs/pi-code-bootstrap-prompt.md
• docs/pi-code-prompt-template.md
• docs/llm-wiki-memory.md
• docs/daily-summary-2026-04-29.md
• pi-code-skill/lq-memory-rca/SKILL.md

Safety

Indexers are read-only. They redact likely secret values and store only pointers, aliases, and key names for sensitive config.