Skip to content

About

Hackathon entry — managed by the challenge lane (termux-monorepo coordinator).

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

StudySprint — D1 (Workshop to Ship)

Frozen pick for packet D1, 2026-10-30 (Manager-enacted freeze, owner mandate). Concept detail: the Delphi lane's brief-first generation record on the official brief evidence pack (docs/ops/CHALLENGE-BRIEF-EVIDENCE-2026-10-28.md, D1 section).

What it is

A Strands-wired agent for first-gen college students: a verified syllabus -> a week-by-week study plan, recall quizzes, and re-plans on missed weeks. It extends the D0 mandate-practice agent (Delphi Oracle evidence gate + fetch_evidence, vendored in foundation/) with one new tool, fetch_study_evidence (syllabus + practice_set kinds, same stamped-evidence shape).

Files

File Role
agent.py The agent: D0 gate loop + StudySprint tools + Strands registration
study_tools.py G2 study evidence kinds + plan/quiz/replan tools
foundation/ D0 foundation, verbatim: oracle kernel (blob 9a4a1c78), fetch_evidence (8442d813), census
demo.py / demo-script.md <3-min demo; writes evidence/demo-run.json
article.md Builder Center article draft (submission item 2)
examples/ Sample syllabus + practice set (synthetic)
tests/test_studysprint.py Offline gate tests
tools/resync_parity.py Nov 3 re-sync parity auditor (blob parity vs timerloggedout-spec/studysprint)
tests/test_resync_parity.py Parity audit + Now features tests

Live assets

Product + process

  • FEATURES.md — features a user would want, UI/UX principles, roadmap
  • VERSIONING.md + VERSION + CHANGELOG.md — SemVer process; 1.0.0 = the Nov 4 submission release

Run it

python3 demo.py
python3 -m pytest tests/

Nov 3 Re-sync Parity Test

To verify blob parity between this monorepo's apps/studysprint tree and the upstream timerloggedout-spec/studysprint repo (or a local checkout):

# Against upstream GitHub API:
python3 tools/resync_parity.py

# Against a local checkout pair:
python3 tools/resync_parity.py --target-dir /path/to/studysprint-checkout

# Offline verification (against frozen baseline manifest):
python3 tools/resync_parity.py --offline

# Machine-readable JSON output:
python3 tools/resync_parity.py --json

The re-sync parity script exits 0 on verified parity and 1 (non-zero) on detected drift.

Receipts (sample syllabus): asserted-only -> ABSTAIN; fetched syllabus -> ALLOW_RECOMMENDATION + 12-session plan + quiz + re-plan; credential_mutation -> ESCALATE. No live deployment of StudySprint is claimed; receipts state deployment: False and whether the Strands SDK was importable in the run environment.

About

Hackathon entry — managed by the challenge lane (termux-monorepo coordinator).

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages