Run it
Clone the repository and execute the demo with Python 3.10 or newer:
Terminal
git clone https://github.com/tydandou/tracebook.git cd tracebook python demo/cross_session_demo.py
For machine-readable output:
Terminal
python demo/cross_session_demo.py --json
What the demo proves
- Isolation: the business repository and knowledge root are separate temporary directories.
- Activation: preflight reports the new project needs explicit activation, then resolve registers it.
- Evidence-gated capture: Session 1 stores a durable rule with a source reference and stable knowledge ID.
- Health verification: the capture result drives a scoped check using the exact changed and new paths.
- Cross-session retrieval: Session 2 asks about refund retry behavior and receives the current authority page.
- Cleanup: the temporary directory is deleted on exit, including when the demo fails.
Expected result
Illustrative output
SESSION 1 verified refund retry policy CAPTURE refund-retry-policy · current · evidence attached CHECK Light · no broken links or missing sources SESSION 2 query: refund retry timeout RECALLED refund-retry-policy FACT Refunds retry at most twice with a 3-second timeout. RESULT cross-session retrieval verified
This is a workflow demonstration, not a token benchmark.
It verifies persistence, evidence, isolation, and retrieval. It does not invent a percentage for token savings or claim that every task will become faster.
Inspect the implementation
The script is intentionally small and uses only the Python standard library plus the runner already in this repository. Read demo/cross_session_demo.py before running it.