Compute fib(n) recursively. Cache each fib(k) in a memo map so each subproblem is solved at most once.

Algorithm

Canonical input n = 6 produces fib(6) = 8. Replay highlights every memo write and every cache hit.

memoization A table `memo` keyed by `n` stores each completed subproblem. Before recursing, check `memo[n] ~= nil`: a hit returns immediately, a miss descends.
explicit memo state The memo is threaded through the recursion as the second parameter so the lesson stays about caching, not a closure upvalue.

Basic Implementation

basic.lua
Replay: real traced execution (multi-file project)
local function fib(n, memo)
	if memo[n] ~= nil then
		return memo[n]
	end
	if n < 2 then
		memo[n] = n
		return n
	end
	local value = fib(n - 1, memo) + fib(n - 2, memo)
	memo[n] = value
	return value
end

local memo = {}
local result = fib(6, memo)
print(result)
  1. memo ← {}, action ← miss -> descend fib(5)

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{}memomiss -> descend fib(5)action6n
  2. memo ← {}, action ← miss -> descend fib(4)

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{}memomiss -> descend fib(4)action5n
  3. memo ← {}, action ← miss -> descend fib(3)

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{}memomiss -> descend fib(3)action4n
  4. memo ← {}, action ← miss -> descend fib(2)

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{}memomiss -> descend fib(2)action3n
  5. memo ← {}, action ← miss -> descend fib(1)

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{}memomiss -> descend fib(1)action2n
  6. memo ← {1: 1}, action ← base 1; memo[1] = 1; return

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{1: 1}memobase 1; memo[1] = 1; returnaction1n
  7. memo ← {0: 0, 1: 1}, action ← base 0; memo[0] = 0; fib(2)=1; memo[2] = 1

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{0: 0, 1: 1}memobase 0; memo[0] = 0; fib(2)=1; memo[2] = 1action0n
  8. memo ← {0: 0, 1: 1, 2: 1, 3: 2}, action ← hit 1; fib(3)=2; memo[3] = 2

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{0: 0, 1: 1, 2: 1, 3: 2}memohit 1; fib(3)=2; memo[3] = 2action1n
  9. memo ← {0: 0, 1: 1, 2: 1, 3: 2, 4: 3}, action ← hit 1; fib(4)=3; memo[4] = 3

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{0: 0, 1: 1, 2: 1, 3: 2, 4: 3}memohit 1; fib(4)=3; memo[4] = 3action2n
  10. memo ← {0: 0, 1: 1, 2: 1, 3: 2, 4: 3, 5: 5}, action ← hit 2; fib(5)=5; memo[5] = 5

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{0: 0, 1: 1, 2: 1, 3: 2, 4: 3, 5: 5}memohit 2; fib(5)=5; memo[5] = 5action3n
  11. memo ← {0: 0, 1: 1, 2: 1, 3: 2, 4: 3, 5: 5, 6: 8}, action ← hit 3; fib(6)=8; memo[6] = 8

    8end9local value = fib(n - 1, memo) + fib(n - 2, memo)10memo[n] = value
    values this step{0: 0, 1: 1, 2: 1, 3: 2, 4: 3, 5: 5, 6: 8}memohit 3; fib(6)=8; memo[6] = 8action4n
  12. stdout ← 8

    15local result = fib(6, memo)16print(result)
    values this step8stdout8result

Complexity

  • Time: O(n) with memoization (vs. O(2^n) without)
  • Space: O(n) memo + O(n) call stack

Implementation notes

  • Lua: the recursion takes the memo as a parameter rather than as an upvalue or a module-level cache, which keeps state explicit without hiding the lesson behind a shared global. Tables pass by reference, so the recursive calls share the same memo without an explicit return-the-memo dance.
  • memo[n] ~= nil is the explicit cache-check predicate; Lua's table-default behaviour returns nil for absent keys, so the predicate stays parallel to the lesson spec instead of leaning on metatable defaults.
  • The replay shows the call stack on one side and the memo map on the other so memo writes and cache hits are visually distinct.