Onboarding

Tnp

12 cards ~ 59 min Foundational

Foundational walk through the tnp project. Read top to bottom if you're new; no prior context assumed.

  1. tnp beginner 5 min

    TNP System Architecture Overview

    Use when: orienting a new contributor to the tnp-node codebase; explaining TNP's role relative to WEAVE and VEST protocols; deciding which tnp-node module to modify for a given change

  2. tnp intermediate 7 min

    Temporal DAG Data Model

    Use when: tracing why topological sort returns a cycle error; understanding how fork nodes are detected in the operation graph; optimising longest-path traversal for a high-node-count DAG

  3. tnp beginner 5 min

    Timeline & TimelineStatus Lifecycle

    Use when: checking whether a timeline counts toward the active_timelines stat; deciding which TimelineStatus to pass when forking an ephemeral branch; debugging why nodes_before_timestamp returns an empty slice

  4. tnp intermediate 6 min

    Fork Detection & Storage Analysis

    Use when: deciding whether to prune stale branches before storage overhead exceeds the configured cap; tuning max_active_timelines based on measured fork probability; debugging unexpectedly high storage usage in a multi-branch deployment

  5. tnp intermediate 5 min

    Timeline Merge Strategies

    Use when: choosing a MergeStrategy when implementing a merge endpoint; diagnosing why merge returns a Manual error in a non-interactive context; computing which nodes a branch adds beyond the canonical set

  6. tnp intermediate 6 min

    Navigation & Time-Travel Queries

    Use when: implementing a 'view document at point-in-time' feature; computing the diff between two temporal snapshots of a timeline; building a breadcrumb UI trail of historical state changes

  7. tnp intermediate 7 min

    Delta Compression & Merkle Chunking

    Use when: estimating storage savings before enabling delta compression on a large multi-branch deployment; validating that a branch timeline round-trips correctly through encode/decode; building a Merkle proof path for a specific chunk in a content-addressed timeline

  8. tnp beginner 3 min

    Time as a Navigable Dimension, Not a Linear Log

    Use when: writing the TNP one-liner or homepage hero; explaining what category TNP belongs to before going technical

  9. tnp beginner 4 min

    Five Fields Where Parallel Time Already Pays

    Use when: deciding which industry to lead the conversation with; answering 'who would actually buy this?' from an advisor

  10. tnp beginner 3 min

    Three Words to Seed on Purpose: TimeNav, T-Nav, Time Web

    Use when: writing any external-facing TNP copy; deciding which nickname to repeat in slides, blog posts, and SDK names

  11. tnp beginner 4 min

    From Spec to Time Web: A Six-Phase Adoption Arc

    Use when: explaining why TNP is documentation-first and not a launched product; framing the multi-year adoption story to an investor or peer

  12. tnp beginner 4 min

    Not Google Docs, Not Git, Not a CRDT

    Use when: answering 'how is this different from Git?' in a pitch; writing the competitive section of a deck or landing page