Forge Seeds • Help & Documentation Manual

🌱 1. Quick Start & Botanical Mastery Allegory

Getting Started

Seeds by Forgeboro represents conceptual retention through a plant growth allegory. As you practice active recall, concepts naturally evolve across 4 acquisition stages:

🌱

Unplanted

Brand-new concept in your vault. Not yet practiced or recall failed (interval = 0 days).

🌿

Seeded

Initial review complete with 1–2 successful recalls. Basic familiarity established (interval 1–6 days).

🌲

Sprouting

Consistent active recall across increasing spaced intervals (3–4 reviews, interval 7–20 days).

🌳

Deep Rooted

Long-term retention achieved (5+ consecutive recalls, interval ≥ 21 days).

📚 2. Term Authoring, LaTeX Math & Aliases

Rich Authoring

Each term incorporates a punchy Short Definition (ideal for rapid flashcards and hover balloons) and an expandable Long Definition with rich HTML formatting and mathematical equations.

📐 LaTeX Mathematical Formulas (KaTeX)

Seeds natively renders mathematical, scientific, and algorithmic notation using KaTeX. Delimit inline math with $...$ or $...$ and display equations with $$...$$.

Inline: $O(N \log N)$ or $\sigma = \sqrt{\frac{1}{N}\sum (x_i - \mu)^2}$

Display: $$\lim_{n \to \infty} \left(1 + \frac{1}{n}\right)^n = e$$

🏷️ Aliases and Synonyms

Add acronyms or alternate names (e.g. WAL for Write-Ahead Logging). Search queries and knowledge graph connections match against aliases instantly.

Terms with aliases automatically respond to searches for both the primary term name and any alias token, with visual badge markers in lexicon cards.

🧠 3. SuperMemo SM-2 Spaced Repetition Engine

Learning Algorithm

Seeds incorporates a standalone implementation of the SuperMemo SM-2 algorithm (lib/srs.ts). Every study interaction calculates optimal interval days and updates concept ease factors.

Rating	Key	Effect on Interval	Effect on Ease Factor	Recommendation
Hard (Score 1)	`1`	Resets to 1 day; repetition set to 0	-0.20 (min 1.3)	Concept failed or required significant effort
Good (Score 3)	`2`	Multiplies interval by current Ease Factor	-0.14	Recalled with moderate hesitation
Easy (Score 5)	`3`	Multiplies interval by Ease Factor with bonus	+0.10	Instant, effortless conceptual recall

🎴 4. Study Mode (Flashcards) & Adaptive Quiz Mode

Practice Modes

🎴 Study Mode (3D Flashcards)

Interactive 3D card flips animate front (term name) and back (definition and aliases).

Press Space or click the card to flip between term and definition.
Rate recall with 1 (Needs Review) or 2 (Got It!).
Completion screen visualizes historical accuracy graph and updated plant mastery stage distribution.

🎯 Quiz Mode (AI Distractors)

10-question adaptive quiz featuring 4 multiple-choice options with AI-generated distractors.

Press keys 1, 2, 3, or 4 to select answer options.
Immediate visual feedback (emerald border for correct, red line-through for incorrect).
Press Enter to advance to the next question.

✨ 5. Magic Topic Explorer & AI Batch Rules

AI Engine

Powered by Google Gemini 2.5 Flash, the Magic Topic Explorer enables rapid generation of starter glossaries across STEM and related disciplines (Engineering, Computer Science, Biology, Chemistry, Physics, and Business fields including Finance, Marketing, Operations, and Economics).

Batch Generation Thresholds & Safety Rules:

35 Terms Starter

Generates 35 core foundational concepts with 3 AI distractors each for instant quizzes.

36–100 Terms Custom

Generates definitions while safely omitting distractors to avoid serverless timeout limits.

100-Term Safety Cap

Requests exceeding 100 items are automatically capped to 100 to protect system throughput.

🕸️ 6. 2D Interactive Physics Knowledge Graph

Graph View

Accessible in the app via /graph, the knowledge graph visualizes semantic interconnectedness across all terms in your vocabulary.

• Force-Directed Physics: Nodes repel one another while spring links pull related concepts into natural semantic clusters.

• Dynamic Link Generation: Links form between terms sharing identical tags or referencing each other's names or aliases.

• Interaction Controls: Pan across the canvas, zoom in/out with the scroll wheel, and drag nodes to inspect relationships.

🔗 7. Automatic Cross-Referencing Algorithm

Hyperlink Engine

Seeds scans term definitions and injects clickable hyperlinks to sibling concepts in your glossary. The algorithm adheres to four strict architectural constraints:

1. First-Occurrence Rule

Only the first mention of any term is converted into a hyperlink. Subsequent mentions remain plain text to prevent visual noise.

2. Self-Reference Prevention

A term will never link to itself within its own definition or alias breakdown.

3. LaTeX Formula Preservation

Any formulas enclosed in KaTeX delimiters ( $...$ or $$...$$) are protected and never parsed as link targets.

4. Greedy Matching

Longer compound concepts take precedence over shorter substrings (e.g. “B+ Tree Index” links before “Tree”).

⌨️ 8. Keyboard Shortcuts Cheat Sheet

Productivity

Key Shortcut	Category	Action Description
`?`	General	Toggle in-app Help & Documentation modal
`Esc`	General	Close active modal or dismiss flyout tooltip
`/`	Navigation	Focus and highlight Lexicon Search input
`Alt` + `T`	Navigation	Switch to All Terms lexicon view
`Alt` + `G`	Navigation	Switch to My Glossaries collection
`Alt` + `C`	Navigation	Switch to Community Glossaries tab
`Alt` + `E`	Navigation	Open Magic Topic Explorer
`Alt` + `N`	Authoring	Create new Term or Glossary
`Alt` + `P`	General	Cycle color palette aesthetic (K-Pop, Librarian, Patriotic, Spring Break)
`Alt` + `D`	General	Toggle light / dark mode
`Space`	Study	Flip active 3D flashcard
`1`, `2`, `3`	Study / Quiz	Rate flashcard (Hard, Good, Easy) or select Quiz option 1–3
`4`	Quiz	Select Quiz option 4
`Enter`	Quiz	Advance to next Quiz question

🤖 9. AI Agent Automation Protocol

Download agent-spec.json →

Seeds by Forgeboro implements a declarative, machine-readable automation specification engineered for autonomous LLM agents, browser extensions, scraping tools, and headless end-to-end test suites.

1. Semantic DOM Selectors

Every interactive control exposes standardized data-tool and data-action attributes following the canonical query pattern:

[data-tool="{toolName}"][data-action="{actionName}"]

2. Runtime Controller (`window.__SEEDS_AGENT_SPEC__`)

At runtime, the browser attaches a global agent reflection and execution controller:

// 1. Inspect available actions currently mounted in DOM
const actions = window.__SEEDS_AGENT_SPEC__.getAvailableActions();

// 2. Programmatically execute an action
window.__SEEDS_AGENT_SPEC__.executeAction("navigation", "open-glossaries");

// 3. Search for a term programmatically
window.__SEEDS_AGENT_SPEC__.executeAction("search", "search-terms", { value: "B+ Tree" });

⚙️ 10. Data Management & REST API Reference

Data & APIs

Seeds provides lossless JSON backup and Word (.docx) document compilation. In addition, authenticated clients can communicate directly via REST APIs:

Method	Endpoint	Auth	Description
GET	/api/terms	Required	Fetch all personal terms
POST	/api/terms	Required	Create a term with definitions, tags & aliases
PUT	/api/terms/[id]	Required	Update existing term
DELETE	/api/terms/[id]	Required	Delete a term
GET	/api/glossaries	Public	Fetch personal and public community glossaries
POST	/api/glossaries	Required	Create new glossary collection
POST	/api/glossaries/[id]/clone	Required	Fork a community glossary to personal library
POST	/api/topic/explore	Required	Explore topic and generate starter terms
GET	/api/export	Required	Download complete JSON backup
GET	/api/export/docx	Required	Compile formatted Word .docx document
POST	/api/import	Required	Import terms and glossaries JSON

Seeds by Forgeboro Documentation & Knowledge Guide

🌱 1. Quick Start & Botanical Mastery Allegory

Unplanted

Seeded

Sprouting

Deep Rooted

📚 2. Term Authoring, LaTeX Math & Aliases

📐 LaTeX Mathematical Formulas (KaTeX)

🏷️ Aliases and Synonyms

🧠 3. SuperMemo SM-2 Spaced Repetition Engine

🎴 4. Study Mode (Flashcards) & Adaptive Quiz Mode

🎴 Study Mode (3D Flashcards)

🎯 Quiz Mode (AI Distractors)

✨ 5. Magic Topic Explorer & AI Batch Rules

Batch Generation Thresholds & Safety Rules:

🕸️ 6. 2D Interactive Physics Knowledge Graph

🔗 7. Automatic Cross-Referencing Algorithm

1. First-Occurrence Rule

2. Self-Reference Prevention

3. LaTeX Formula Preservation

4. Greedy Matching

⌨️ 8. Keyboard Shortcuts Cheat Sheet

🤖 9. AI Agent Automation Protocol

1. Semantic DOM Selectors

2. Runtime Controller (`window.__SEEDS_AGENT_SPEC__`)

⚙️ 10. Data Management & REST API Reference

No help topics found matching your query

Seeds by Forgeboro Documentation & Knowledge Guide

🌱 1. Quick Start & Botanical Mastery Allegory

Unplanted

Seeded

Sprouting

Deep Rooted

📚 2. Term Authoring, LaTeX Math & Aliases

📐 LaTeX Mathematical Formulas (KaTeX)

🏷️ Aliases and Synonyms

🧠 3. SuperMemo SM-2 Spaced Repetition Engine

🎴 4. Study Mode (Flashcards) & Adaptive Quiz Mode

🎴 Study Mode (3D Flashcards)

🎯 Quiz Mode (AI Distractors)

✨ 5. Magic Topic Explorer & AI Batch Rules

Batch Generation Thresholds & Safety Rules:

🕸️ 6. 2D Interactive Physics Knowledge Graph

🔗 7. Automatic Cross-Referencing Algorithm

1. First-Occurrence Rule

2. Self-Reference Prevention

3. LaTeX Formula Preservation

4. Greedy Matching

⌨️ 8. Keyboard Shortcuts Cheat Sheet

🤖 9. AI Agent Automation Protocol

1. Semantic DOM Selectors

2. Runtime Controller (window.__SEEDS_AGENT_SPEC__)

⚙️ 10. Data Management & REST API Reference

No help topics found matching your query

2. Runtime Controller (`window.__SEEDS_AGENT_SPEC__`)