Files

Zhongwei Li 419b2c80bb Initial commit

2025-11-29 17:50:54 +08:00

3.0 KiB

Raw Permalink Blame History

description

description
Load complete project context - structure + semantics + memory

/phi context

Load complete project context: structure + semantics + memory.

Usage

/phi context [scope]

Scopes:

quick - File counts, architecture, top issues
full (default) - Complete maps + vessel memories
modules - Detailed module breakdown
memory - Just vessel cross-session insights

What It Does

Compositional context loading:

(let* ((structure (read-file ".phi/PROJECT-MAP.auto.scm"))
       (semantics (read-file ".phi/PROJECT-MAP.scm"))
       (project-name (extract-project-name semantics))
       (memories (vessel-recall project-name 20)))
  (integrate structure semantics memories))

Output (Quick)

φ Context: XLN
══════════════

Structure: 176 files (85% TypeScript, 10% Solidity)
  ├─ jurisdictions/    18 files (smart contracts)
  ├─ runtime/          45 files (consensus logic)
  ├─ frontend/         67 files (3D visualization)
  └─ vibepaper/        12 files (documentation)

Architecture: JEA (Jurisdiction-Entity-Account)
  J: On-chain dispute settlement (Depository.sol, EntityProvider.sol)
  E: Off-chain BFT consensus (entity-consensus.ts, threshold signatures)
  A: Bilateral payment channels (account-manager.ts)

Known Issues: 2
  • 3d-rendering-xlnomies (low) - EntityManager.ts hardcoded single J-Machine
  • consensus-message-ordering (high) - Race condition in state sync

Recent Insights: 5 vessel memories
  → JEA trust boundaries critical for security model
  → Threshold signatures require 2f+1 coordination
  → Visual bugs safe to fix, consensus changes need formal verification

φ = 0.89 (high integrated information)
Ready to work with full context.

Output (Full)

Includes:

Complete module list with purposes
All imports/exports from PROJECT-MAP.auto.scm
Full architectural flows from PROJECT-MAP.scm
All vessel memories with tags
Cross-references between layers

Progressive Disclosure

Start with /phi context quick (< 1000 tokens)
Expand to /phi context modules if needed (module details)
Full context only when necessary (can be 5k+ tokens)

Integration with Agents

Agents can load context on startup:

const context = await executeCommand('/phi context quick');
const systemPrompt = `
You are an XLN expert.

${context}

Use this context to understand the codebase.
`;

Vessel Integration

Cross-references vessel memories:

Tags matching project name
Architecture-related insights
Known issues with solutions
Relief-guided patterns that worked

Relief Signal

When φ = ∫(structure × semantics × memory) is high:

You immediately understand where things are
Architectural decisions make sense
Known issues are visible
Cross-session learnings accessible

That's integrated information working.

Cache Behavior

Context is live - always reflects current state:

PROJECT-MAP.auto.scm regenerated on demand
PROJECT-MAP.scm read from git
Vessel queried fresh each time

No stale context.

3.0 KiB Raw Permalink Blame History Unescape Escape