Skip to content

MS4 (#27/#28) — group questions + concepts under learning-map modules#6

Merged
SheeshDarth merged 2 commits into
masterfrom
feature/ms4-module-links
Jul 14, 2026
Merged

MS4 (#27/#28) — group questions + concepts under learning-map modules#6
SheeshDarth merged 2 commits into
masterfrom
feature/ms4-module-links

Conversation

@SheeshDarth

Copy link
Copy Markdown
Owner

Final MS4 item (REVIEW-012). Links the previously-siloed surfaces: explain-back questions and DSA concepts now carry a stable module key, so the learning map shows what belongs to each module.

What's in it

  • Schema: soft module_key on explain_back_questions + concept_links (migration 0010, nullable).
  • learning-map.service: modules gain a stable key slug; moduleKeyForTitle backfills it for pre-existing maps so grouping works retroactively.
  • project-analyzer: deterministic tagging that works on BOTH the AI and offline-heuristic paths (no AI-schema dependency) — questions via a keyword classifier; code-grounded concepts → key-files; conceptual concepts → how-it-works.
  • UI: each module card links to its N questions / M concepts on the explain-back and DSA tabs.

Design note

Deliberately deterministic (not an AI-schema field) so the value lands on the offline analyzer — the product's default path — not just BYOK-AI users.

Gate: lint + typecheck + build + test (22/22) all green.

🤖 Generated with Claude Code

SheeshDarth and others added 2 commits July 14, 2026 15:08
MS4 final item, per REVIEW-012. The five surfaces were siloed: explain-back
questions and DSA concepts were flat lists with no link to the learning-map
modules. Now every question and concept carries a stable module key, so the
learning map shows what belongs to each module.

- schema: soft `module_key` column on explain_back_questions + concept_links
  (migration 0010, nullable — manual entries stay null).
- learning-map.service: modules gain a stable `key` slug; `moduleKeyForTitle`
  backfills it for pre-existing maps (grouping works retroactively). Exported
  MODULE_KEYS.
- project-analyzer: deterministic tagging that works on BOTH the AI and the
  offline-heuristic paths (no AI-schema dependency) — questions via an
  inferQuestionModuleKey keyword classifier; code-grounded concepts → key-files;
  conceptual concepts → how-it-works.
- learning-map page + ModuleCard: each module card links to its N questions /
  M concepts on the explain-back and DSA tabs.
- tests: questions + concepts are tagged with valid keys; code-grounded concepts
  land under key-files; modules carry stable keys. Suite 22/22.

Gate: lint + typecheck + build + test all green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…12 resolved)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@SheeshDarth
SheeshDarth merged commit 4e69ff0 into master Jul 14, 2026
1 check passed
@SheeshDarth
SheeshDarth deleted the feature/ms4-module-links branch July 14, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant