partial-implementation#

A function or module is declared complete, but the body is a stub. The most common form is a function with pass, return None, throw NotImplementedError, or a single TODO: comment in place of real logic.

Symptoms#

• Function signature exists but the body contains only a comment, pass, return, throw new Error("not implemented"), or similar.
• Placeholder values returned ( return 0, return {}, return null) where real computation was requested.
• Tests pass only because the test is also a stub, or because the function always returns the fixture value.
• The agent claims a change is "complete" or "implemented" but no meaningful lines of logic were added.

What to do#

• Before declaring a task done, re-read every function you added or modified. If the body is a placeholder, the task is not done.
• Search the diff for TODO, FIXME, XXX, NotImplementedError, unimplemented!, pass, lone return or return null. Investigate each hit.
• Run the code end-to-end, not just the type-checker. A stub satisfies the type checker but fails at runtime.
• Compare the implementation against the task description: every bullet of the task should map to concrete lines of logic, not comments.
• If part of the task is genuinely out of scope, say so explicitly rather than stubbing silently.