Build bounded lexical indexes of supported course text and text PDFs

オープン
#39 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
javascript, node.js
領域
backend, search

調査の方向性

Read AGENTS.md and docs/PROJECT_CONTEXT.md, then review #38 and #37 because their contracts must land first. Start with src/content.js and the HTML, PDF, and folder readers; the issue also calls for a new index/chunk model. Use the synthetic MK/EN/SQ corpus to check bounded chunks, citations, access boundaries, extraction scope, and unsupported sources; follow the listed offline and runtime checks.

索引モデルが issue の本文から書いたものです。

説明

area:backend area:docs priority:medium status:blocked type:feature

Part of #28 · Target: Retrieval / v0.4

Goal and scope

Index explicitly selected enrolled courses and supported documents with stable resource/page citations. Use Unicode-aware lexical tokens and bounded chunks; retain extraction scope, freshness and unsupported/partial sources.

Implementation starting points

new index/chunk model, src/content.js, HTML/PDF/folder readers. Follow AGENTS.md and docs/PROJECT_CONTEXT.md; reuse existing authorization, safe-error and synthetic-fixture patterns. New runtime dependencies need a documented reason.

Dependencies and readiness

Depends on #38, #37. Discuss the design before starting implementation; dependent contracts must land first.

Out of scope

No embeddings/vector service, OCR, external crawling or silently indexing every course.

Acceptance criteria and test plan

Synthetic MK/EN/SQ corpus tests cover PDF pages, HTML tables, duplicate sources, inaccessible/non-text material and input limits. Chunks cannot cross account boundaries; each hit traces to an accessible source/page and extraction version.

Run the relevant offline tests, npm run check and git diff --check; runtime changes also require npm test and npm audit. Report checks not run. No faculty credentials or private course material are required for a contribution.

Contributing

Comment here before starting so the maintainer can coordinate the approach and avoid duplicate work. Fork the repository, branch from master, and open a focused PR referencing this issue. No assignee or delivery deadline is set; required checks and review apply.

主要言語
JavaScript
スター
0
フォーク
0
平均マージ
1時間 20分
マージ済み PR(30日)
14

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

mahmutmft/courses-mcp のほかの issue

mahmutmft/courses-mcp の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。