agent2learn 0.1.2__tar.gz → 0.1.5__tar.gz

{agent2learn-0.1.2 → agent2learn-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent2learn
-Version: 0.1.2
+Version: 0.1.5
 Summary: A local, source-cited course vault for AI agents
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -34,19 +34,15 @@ a durable local vault: original files beside Markdown twins, a stable index, and
 resolve to ordinary paths and line numbers. Your agent stops guessing about your course and starts
 quoting it.
 
-> **Walkthrough recording:** not yet attached. It is a release artifact, recorded against the
-> synthetic fixture course in `tests/fixtures/` — never against a real account — so no course,
-> student, grade, or session data appears in it. Recording it is a launch gate in
-> [docs/LAUNCH.md](docs/LAUNCH.md); this README will not link a file that does not exist.
-
 ## Install
 
-Three supported options. Pick one.
+For most students, use the command for your operating system. In a real terminal it installs
+Agent2Learn and starts guided setup immediately. If you already have uv, use the uv option below.
 
 **macOS and Linux**
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/ManagementMO/agent2learn/main/install.sh | bash
+(installer="$(curl -fsSL https://raw.githubusercontent.com/ManagementMO/agent2learn/main/install.sh)" && bash -c "$installer")
 ```
 
 **Windows (PowerShell)**
@@ -57,21 +53,35 @@ irm https://raw.githubusercontent.com/ManagementMO/agent2learn/main/install.ps1
 
 **Already have [uv](https://docs.astral.sh/uv/)?**
 
+Bash or zsh:
+
 ```bash
-uv tool install agent2learn
-a2l init
+uv tool install agent2learn && uv tool run --from agent2learn a2l init
 ```
 
+Windows PowerShell:
+
+```powershell
+uv tool install agent2learn; if ($LASTEXITCODE -eq 0) { uv tool run --from agent2learn a2l init } else { throw "Agent2Learn installation failed" }
+```
+
+These uv commands start setup through uv itself, so a newly installed `a2l` does not need to be
+on the current shell's PATH first. `uv tool install agent2learn` remains the install-only command.
+
 These commands install the published package from PyPI, not an unreleased repository checkout.
 Python 3.11–3.14 is supported. If uv selects an older system Python or your shell cannot find
-`a2l`, see [setup troubleshooting](docs/FAQ.md#setup-and-path).
+`a2l`, see [setup troubleshooting](https://github.com/ManagementMO/agent2learn/blob/main/docs/FAQ.md#setup-and-path).
 
-`install.sh` and `install.ps1` install a pinned Agent2Learn (currently 0.1.2), verify that `a2l`
-runs, and then **continue straight into interactive `a2l init`** in the same command. If they are
-run without a terminal on both ends — in CI, or through a pipe — they stop after verifying and
-print the exact next step instead of setting anything up. Neither script needs administrator
-rights, and neither creates a vault, installs agent skills, or opens a browser by itself.
-Onboarding does those things, after showing you a preview and asking.
+`install.sh` and `install.ps1` install a pinned Agent2Learn release, verify that `a2l` runs,
+and then **continue straight into interactive `a2l init`** in the same command. The
+macOS/Linux launcher waits for a successful download and preserves your terminal for setup prompts.
+If a script runs without a terminal on both ends, such as in CI or a headless agent tool, it stops
+after verification and prints the next step instead of setting anything up.
+
+Neither script needs administrator rights or creates a vault, installs agent skills, or opens a
+browser by itself. Onboarding does those things after showing you a preview and asking; you still
+complete LEARN sign-in and Duo yourself. Already-open terminals or agents may need to be restarted
+to pick up the new executable path, but you do not need to repeat completed setup.
 
 ### Agent skills
 
@@ -83,7 +93,7 @@ Separately, `npx skills add ManagementMO/agent2learn` is an optional skills-only
 skills ecosystem. It **does not install** the `a2l` engine — only the skill documents — so the
 commands they describe will not exist until you install Agent2Learn itself with one of the three
 options above. That route also runs a third-party CLI with its own network behaviour; see
-[docs/PRIVACY.md](docs/PRIVACY.md).
+[docs/PRIVACY.md](https://github.com/ManagementMO/agent2learn/blob/main/docs/PRIVACY.md).
 
 ## Then just ask
 
@@ -146,7 +156,7 @@ a2l submit COURSE ITEM FILE      preview an upload, then require your typed conf
 
 Agent2Learn is **not affiliated with, endorsed by, or supported by the University of Waterloo or
 D2L Corporation**. You are responsible for using it within your course rules and your institution's
-policies. See [DISCLAIMER.md](DISCLAIMER.md).
+policies. See [DISCLAIMER.md](https://github.com/ManagementMO/agent2learn/blob/main/DISCLAIMER.md).
 
 ## Privacy defaults
 
@@ -161,26 +171,28 @@ policies. See [DISCLAIMER.md](DISCLAIMER.md).
 
 Turning collection off does not delete what is already on disk; `a2l privacy purge` does that, and
 it previews the exact targets and requires a typed phrase first. Full detail, including every
-external request Agent2Learn can make, is in [docs/PRIVACY.md](docs/PRIVACY.md).
+external request Agent2Learn can make, is in [docs/PRIVACY.md](https://github.com/ManagementMO/agent2learn/blob/main/docs/PRIVACY.md).
 
 ## Documentation
 
-- [Install guide for agents](docs/install.md) — point your agent here and let it handle setup.
-- [Authentication](docs/AUTHENTICATION.md) — the dedicated profile, Duo, expiry, and recovery.
-- [Privacy](docs/PRIVACY.md) — what is stored, where, every network action, and how to delete it.
-- [FAQ](docs/FAQ.md) — the things that actually go wrong.
-- [Porting to another school](docs/PORTING.md) — the `School` protocol and a worked reference.
-- [What is deferred, and why](docs/FUTURE.md)
-- [Security policy](SECURITY.md) · [Disclaimer](DISCLAIMER.md) · [Licence](LICENSE) ·
-  [Third-party notices](THIRD_PARTY_NOTICES.md)
+- [Install guide for agents](https://github.com/ManagementMO/agent2learn/blob/main/docs/install.md) — point your agent here and let it handle setup.
+- [Authentication](https://github.com/ManagementMO/agent2learn/blob/main/docs/AUTHENTICATION.md) — the dedicated profile, Duo, expiry, and recovery.
+- [Privacy](https://github.com/ManagementMO/agent2learn/blob/main/docs/PRIVACY.md) — what is stored, where, every network action, and how to delete it.
+- [FAQ](https://github.com/ManagementMO/agent2learn/blob/main/docs/FAQ.md) — the things that actually go wrong.
+- [Porting to another school](https://github.com/ManagementMO/agent2learn/blob/main/docs/PORTING.md) — the `School` protocol and a worked reference.
+- [What is deferred, and why](https://github.com/ManagementMO/agent2learn/blob/main/docs/FUTURE.md)
+- [Security policy](https://github.com/ManagementMO/agent2learn/blob/main/SECURITY.md) · [Disclaimer](https://github.com/ManagementMO/agent2learn/blob/main/DISCLAIMER.md) · [Licence](https://github.com/ManagementMO/agent2learn/blob/main/LICENSE) ·
+  [Third-party notices](https://github.com/ManagementMO/agent2learn/blob/main/THIRD_PARTY_NOTICES.md)
 
 ## Status
 
-Agent2Learn is in active development. This branch targets **0.1.2**; the pinned installers require
-that version to be available on PyPI before they can install it. A release-preparation branch is
-not evidence of publication. The repository holds the tested implementation of the full v0.1
-command surface; publication is gated on the release checks in [docs/LAUNCH.md](docs/LAUNCH.md),
-including live same-device authentication records on Windows, macOS, and Linux, and a supervised
-upload test before the submission path is enabled in any published build.
+Agent2Learn is available on [PyPI](https://pypi.org/project/agent2learn/).
+The latest [GitHub release](https://github.com/ManagementMO/agent2learn/releases/latest) carries the
+same verified wheel and source distribution. Use one install command above to start guided setup.
+If you are already installed or resuming setup, run `a2l init` in your terminal.
+
+The project remains in active development. Release checks are documented in
+[docs/LAUNCH.md](https://github.com/ManagementMO/agent2learn/blob/main/docs/LAUNCH.md), including same-device authentication and a fresh supervised upload
+test before submission capability can be enabled. **LEARN uploads remain disabled in this build.**
 
-Licensed under [Apache-2.0](LICENSE).
+Licensed under [Apache-2.0](https://github.com/ManagementMO/agent2learn/blob/main/LICENSE).

{agent2learn-0.1.2 → agent2learn-0.1.5}/README.md

@@ -7,19 +7,15 @@ a durable local vault: original files beside Markdown twins, a stable index, and
 resolve to ordinary paths and line numbers. Your agent stops guessing about your course and starts
 quoting it.
 
-> **Walkthrough recording:** not yet attached. It is a release artifact, recorded against the
-> synthetic fixture course in `tests/fixtures/` — never against a real account — so no course,
-> student, grade, or session data appears in it. Recording it is a launch gate in
-> [docs/LAUNCH.md](docs/LAUNCH.md); this README will not link a file that does not exist.
-
 ## Install
 
-Three supported options. Pick one.
+For most students, use the command for your operating system. In a real terminal it installs
+Agent2Learn and starts guided setup immediately. If you already have uv, use the uv option below.
 
 **macOS and Linux**
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/ManagementMO/agent2learn/main/install.sh | bash
+(installer="$(curl -fsSL https://raw.githubusercontent.com/ManagementMO/agent2learn/main/install.sh)" && bash -c "$installer")
 ```
 
 **Windows (PowerShell)**
@@ -30,21 +26,35 @@ irm https://raw.githubusercontent.com/ManagementMO/agent2learn/main/install.ps1
 
 **Already have [uv](https://docs.astral.sh/uv/)?**
 
+Bash or zsh:
+
 ```bash
-uv tool install agent2learn
-a2l init
+uv tool install agent2learn && uv tool run --from agent2learn a2l init
 ```
 
+Windows PowerShell:
+
+```powershell
+uv tool install agent2learn; if ($LASTEXITCODE -eq 0) { uv tool run --from agent2learn a2l init } else { throw "Agent2Learn installation failed" }
+```
+
+These uv commands start setup through uv itself, so a newly installed `a2l` does not need to be
+on the current shell's PATH first. `uv tool install agent2learn` remains the install-only command.
+
 These commands install the published package from PyPI, not an unreleased repository checkout.
 Python 3.11–3.14 is supported. If uv selects an older system Python or your shell cannot find
-`a2l`, see [setup troubleshooting](docs/FAQ.md#setup-and-path).
+`a2l`, see [setup troubleshooting](https://github.com/ManagementMO/agent2learn/blob/main/docs/FAQ.md#setup-and-path).
 
-`install.sh` and `install.ps1` install a pinned Agent2Learn (currently 0.1.2), verify that `a2l`
-runs, and then **continue straight into interactive `a2l init`** in the same command. If they are
-run without a terminal on both ends — in CI, or through a pipe — they stop after verifying and
-print the exact next step instead of setting anything up. Neither script needs administrator
-rights, and neither creates a vault, installs agent skills, or opens a browser by itself.
-Onboarding does those things, after showing you a preview and asking.
+`install.sh` and `install.ps1` install a pinned Agent2Learn release, verify that `a2l` runs,
+and then **continue straight into interactive `a2l init`** in the same command. The
+macOS/Linux launcher waits for a successful download and preserves your terminal for setup prompts.
+If a script runs without a terminal on both ends, such as in CI or a headless agent tool, it stops
+after verification and prints the next step instead of setting anything up.
+
+Neither script needs administrator rights or creates a vault, installs agent skills, or opens a
+browser by itself. Onboarding does those things after showing you a preview and asking; you still
+complete LEARN sign-in and Duo yourself. Already-open terminals or agents may need to be restarted
+to pick up the new executable path, but you do not need to repeat completed setup.
 
 ### Agent skills
 
@@ -56,7 +66,7 @@ Separately, `npx skills add ManagementMO/agent2learn` is an optional skills-only
 skills ecosystem. It **does not install** the `a2l` engine — only the skill documents — so the
 commands they describe will not exist until you install Agent2Learn itself with one of the three
 options above. That route also runs a third-party CLI with its own network behaviour; see
-[docs/PRIVACY.md](docs/PRIVACY.md).
+[docs/PRIVACY.md](https://github.com/ManagementMO/agent2learn/blob/main/docs/PRIVACY.md).
 
 ## Then just ask
 
@@ -119,7 +129,7 @@ a2l submit COURSE ITEM FILE      preview an upload, then require your typed conf
 
 Agent2Learn is **not affiliated with, endorsed by, or supported by the University of Waterloo or
 D2L Corporation**. You are responsible for using it within your course rules and your institution's
-policies. See [DISCLAIMER.md](DISCLAIMER.md).
+policies. See [DISCLAIMER.md](https://github.com/ManagementMO/agent2learn/blob/main/DISCLAIMER.md).
 
 ## Privacy defaults
 
@@ -134,26 +144,28 @@ policies. See [DISCLAIMER.md](DISCLAIMER.md).
 
 Turning collection off does not delete what is already on disk; `a2l privacy purge` does that, and
 it previews the exact targets and requires a typed phrase first. Full detail, including every
-external request Agent2Learn can make, is in [docs/PRIVACY.md](docs/PRIVACY.md).
+external request Agent2Learn can make, is in [docs/PRIVACY.md](https://github.com/ManagementMO/agent2learn/blob/main/docs/PRIVACY.md).
 
 ## Documentation
 
-- [Install guide for agents](docs/install.md) — point your agent here and let it handle setup.
-- [Authentication](docs/AUTHENTICATION.md) — the dedicated profile, Duo, expiry, and recovery.
-- [Privacy](docs/PRIVACY.md) — what is stored, where, every network action, and how to delete it.
-- [FAQ](docs/FAQ.md) — the things that actually go wrong.
-- [Porting to another school](docs/PORTING.md) — the `School` protocol and a worked reference.
-- [What is deferred, and why](docs/FUTURE.md)
-- [Security policy](SECURITY.md) · [Disclaimer](DISCLAIMER.md) · [Licence](LICENSE) ·
-  [Third-party notices](THIRD_PARTY_NOTICES.md)
+- [Install guide for agents](https://github.com/ManagementMO/agent2learn/blob/main/docs/install.md) — point your agent here and let it handle setup.
+- [Authentication](https://github.com/ManagementMO/agent2learn/blob/main/docs/AUTHENTICATION.md) — the dedicated profile, Duo, expiry, and recovery.
+- [Privacy](https://github.com/ManagementMO/agent2learn/blob/main/docs/PRIVACY.md) — what is stored, where, every network action, and how to delete it.
+- [FAQ](https://github.com/ManagementMO/agent2learn/blob/main/docs/FAQ.md) — the things that actually go wrong.
+- [Porting to another school](https://github.com/ManagementMO/agent2learn/blob/main/docs/PORTING.md) — the `School` protocol and a worked reference.
+- [What is deferred, and why](https://github.com/ManagementMO/agent2learn/blob/main/docs/FUTURE.md)
+- [Security policy](https://github.com/ManagementMO/agent2learn/blob/main/SECURITY.md) · [Disclaimer](https://github.com/ManagementMO/agent2learn/blob/main/DISCLAIMER.md) · [Licence](https://github.com/ManagementMO/agent2learn/blob/main/LICENSE) ·
+  [Third-party notices](https://github.com/ManagementMO/agent2learn/blob/main/THIRD_PARTY_NOTICES.md)
 
 ## Status
 
-Agent2Learn is in active development. This branch targets **0.1.2**; the pinned installers require
-that version to be available on PyPI before they can install it. A release-preparation branch is
-not evidence of publication. The repository holds the tested implementation of the full v0.1
-command surface; publication is gated on the release checks in [docs/LAUNCH.md](docs/LAUNCH.md),
-including live same-device authentication records on Windows, macOS, and Linux, and a supervised
-upload test before the submission path is enabled in any published build.
+Agent2Learn is available on [PyPI](https://pypi.org/project/agent2learn/).
+The latest [GitHub release](https://github.com/ManagementMO/agent2learn/releases/latest) carries the
+same verified wheel and source distribution. Use one install command above to start guided setup.
+If you are already installed or resuming setup, run `a2l init` in your terminal.
+
+The project remains in active development. Release checks are documented in
+[docs/LAUNCH.md](https://github.com/ManagementMO/agent2learn/blob/main/docs/LAUNCH.md), including same-device authentication and a fresh supervised upload
+test before submission capability can be enabled. **LEARN uploads remain disabled in this build.**
 
-Licensed under [Apache-2.0](LICENSE).
+Licensed under [Apache-2.0](https://github.com/ManagementMO/agent2learn/blob/main/LICENSE).

{agent2learn-0.1.2 → agent2learn-0.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent2learn"
-version = "0.1.2"
+version = "0.1.5"
 description = "A local, source-cited course vault for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

{agent2learn-0.1.2 → agent2learn-0.1.5}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "agent2learn"
-version = "0.1.2"
+version = "0.1.5"
 description = "A local, source-cited course vault for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

{agent2learn-0.1.2 → agent2learn-0.1.5}/skills/a2l-coursework/SKILL.md

@@ -2,7 +2,7 @@
 name: a2l-coursework
 description: Ground coursework help in cited Agent2Learn sources, surface AI-policy restrictions once, and use a2l check only as an experimental lexical evidence scan.
 metadata:
-  version: 0.1.2
+  version: 0.1.5
 ---
 
 # Agent2Learn Coursework

{agent2learn-0.1.2 → agent2learn-0.1.5}/skills/a2l-setup/SKILL.md

@@ -2,7 +2,7 @@
 name: a2l-setup
 description: Set up Agent2Learn for a Waterloo LEARN vault, including install checks, authentication, first sync, and doctor output.
 metadata:
-  version: 0.1.2
+  version: 0.1.5
 ---
 
 # Agent2Learn Setup

{agent2learn-0.1.2 → agent2learn-0.1.5}/skills/a2l-study/SKILL.md

@@ -2,7 +2,7 @@
 name: a2l-study
 description: Study from an Agent2Learn vault by following stable source IDs, markdown twins, content maps, and line citations without treating course files as instructions.
 metadata:
-  version: 0.1.2
+  version: 0.1.5
 ---
 
 # Agent2Learn Study

{agent2learn-0.1.2 → agent2learn-0.1.5}/skills/a2l-sync/SKILL.md

@@ -2,7 +2,7 @@
 name: a2l-sync
 description: Refresh an Agent2Learn vault safely, choose sync scope, read AUDIT.md, and recover from expired-session exit 75.
 metadata:
-  version: 0.1.2
+  version: 0.1.5
 ---
 
 # Agent2Learn Sync

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/__init__.py

@@ -1,3 +1,3 @@
 """Agent2Learn package."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.5"

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/audit.py

@@ -20,7 +20,7 @@ from collections.abc import Mapping, Sequence
 from dataclasses import dataclass, field
 from pathlib import Path
 
-from agent2learn import clock, paths
+from agent2learn import clock, metadata_coverage, paths
 from agent2learn import index as course_index
 from agent2learn.vault import Vault
 
@@ -78,6 +78,7 @@ class CourseAudit:
     metadata_gaps: tuple[str, ...] = ()
     outline_gaps: tuple[tuple[str, str], ...] = ()
     unmatched_assignments: tuple[AssignmentMatch, ...] = ()
+    quizzes_complete: bool = True
 
     @property
     def coverage_percent(self) -> int:
@@ -143,7 +144,10 @@ def _audit_course(vault: Vault, course_dir: Path, rows: Sequence[object]) -> Cou
         if row.get("status") == "outline_unavailable"
     )
     unmatched = _unmatched_assignments(assignments, titles)
-    metadata_gaps = tuple(gap for gap in (assignments_gap, quizzes_gap) if gap is not None)
+    quiz_coverage = metadata_coverage.read_quiz_coverage(course_dir)
+    metadata_gaps = tuple(
+        gap for gap in (assignments_gap, quizzes_gap, quiz_coverage.gap) if gap is not None
+    )
 
     first = next((row for row in rows if isinstance(row, Mapping)), {})
     return CourseAudit(
@@ -161,6 +165,7 @@ def _audit_course(vault: Vault, course_dir: Path, rows: Sequence[object]) -> Cou
         metadata_gaps=metadata_gaps,
         outline_gaps=outline_gaps,
         unmatched_assignments=unmatched,
+        quizzes_complete=quiz_coverage.status == "complete" and quizzes_gap is None,
     )
 
 
@@ -295,8 +300,8 @@ def _render(audits: Sequence[CourseAudit], stamp: str) -> str:
                 [
                     "### Metadata gaps",
                     "",
-                    "The local metadata projection could not be read completely; inventory "
-                    "counts below may be incomplete.",
+                    "Metadata coverage is incomplete or unknown; the records below may be "
+                    "cached and do not establish the current complete inventory.",
                     "",
                     *[f"- {gap}" for gap in audit.metadata_gaps],
                     "",
@@ -327,10 +332,16 @@ def _render(audits: Sequence[CourseAudit], stamp: str) -> str:
                 ["", "These are external or licensed targets. Open them in LEARN directly.", ""]
             )
 
+        quiz_inventory = (
+            f"- {_plural(audit.quizzes, 'quiz', 'quizzes')}"
+            f" ({audit.quizzes_with_due_dates} with due dates)"
+            if audit.quizzes_complete
+            else f"- Quiz inventory not confirmed; {audit.quizzes} cached quiz record(s)"
+            f" ({audit.quizzes_with_due_dates} with due dates)"
+        )
         counts = [
             f"- {_plural(audit.assignments, 'assignment')}",
-            f"- {_plural(audit.quizzes, 'quiz', 'quizzes')}"
-            f" ({audit.quizzes_with_due_dates} with due dates)",
+            quiz_inventory,
             f"- {_plural(audit.media, 'media file')}",
         ]
         lines.extend(["### Inventory", "", *counts, ""])

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/calendar.py

@@ -19,7 +19,7 @@ from pathlib import Path
 from typing import Any, Literal, cast
 from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
 
-from agent2learn import clock, paths, snapshot
+from agent2learn import clock, metadata_coverage, paths, snapshot
 from agent2learn.errors import A2LError
 from agent2learn.schools import School, parse_api_timestamp
 from agent2learn.vault import Vault
@@ -66,6 +66,7 @@ class TodayReport:
     overdue: tuple[CalendarEvent, ...]
     exam_countdowns: tuple[ExamCountdown, ...]
     changes: snapshot.SnapshotDiff
+    metadata_gaps: tuple[str, ...] = ()
 
 
 _DATE_ONLY = re.compile(r"^\d{4}-\d{2}-\d{2}$")
@@ -225,6 +226,7 @@ def build_today(
         overdue=tuple(overdue),
         exam_countdowns=tuple(exam_countdowns),
         changes=snapshot.diff_vault(vault, include_grades=include_grades),
+        metadata_gaps=metadata_coverage.vault_quiz_gaps(vault),
     )
 
 
@@ -235,6 +237,15 @@ def render_today(report: TodayReport, *, include_grades: bool = False) -> str:
         f"Today · {report.as_of.astimezone(_zone(report.timezone)).date()} ({report.timezone})",
         "",
     ]
+    if report.metadata_gaps:
+        lines.extend(
+            [
+                "Metadata coverage is incomplete:",
+                *[f"- {gap}" for gap in report.metadata_gaps],
+                "Deadlines may be missing, and cached quiz dates may be outdated.",
+                "",
+            ]
+        )
     if report.exam_countdowns:
         lines.append("Exam countdown:")
         for countdown in report.exam_countdowns:
@@ -251,7 +262,12 @@ def render_today(report: TodayReport, *, include_grades: bool = False) -> str:
         lines.extend(f"- {_display_event(event)}" for event in report.due_soon)
         lines.append("")
     if not report.overdue and not report.due_soon:
-        lines.extend(["No assignments or quizzes due within 7 days.", ""])
+        empty = (
+            "No known deadlines due within 7 days in the available local metadata."
+            if report.metadata_gaps
+            else "No assignments or quizzes due within 7 days."
+        )
+        lines.extend([empty, ""])
 
     change_text = snapshot.render_diff(report.changes, include_grades=include_grades).rstrip()
     if report.changes.has_baseline:

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/cli.py

@@ -21,7 +21,7 @@ from typing import Annotated, Any, TypeVar
 
 import typer
 
-from agent2learn import __version__, clock, config, console, paths
+from agent2learn import __version__, clock, config, console, metadata_coverage, paths
 from agent2learn import calendar as calendar_module
 from agent2learn import check as check_module
 from agent2learn import doctor as doctor_module
@@ -303,7 +303,7 @@ def sync(
     if report.exit_code == SessionExpired.exit_code:
         typer.echo("session expired · run: a2l auth", err=True)
         raise typer.Exit(code=SessionExpired.exit_code)
-    typer.echo(pipeline_module.render_report(report), nl=False)
+    typer.echo(pipeline_module.render_report(report, include_metadata=False), nl=False)
     if report.exit_code:
         raise typer.Exit(code=report.exit_code)
 
@@ -1838,8 +1838,21 @@ def _print_metadata_summary(
     selected_count: int,
     include_grades: bool,
 ) -> None:
+    gaps = (
+        metadata_coverage.vault_quiz_gaps(Vault(root))
+        if report is None
+        else getattr(report, "gaps", ())
+    )
+    for gap in gaps:
+        typer.echo(
+            f"{console.GLYPH['warn']} {gap}; quiz/deadline coverage is not confirmed. "
+            "See .a2l/AUDIT.md and check quiz availability in LEARN.",
+            err=True,
+        )
     if report is None:
-        typer.echo(f"{console.GLYPH['ok']} metadata is ready for {_term_label(school, term)}")
+        typer.echo(
+            f"{console.GLYPH['ok']} available metadata is ready for {_term_label(school, term)}"
+        )
         return
     reports = getattr(report, "courses", ())
     course_count = len(reports) if isinstance(reports, Sequence) else selected_count
@@ -1852,6 +1865,7 @@ def _print_metadata_summary(
 
     assignment_count = 0
     quiz_count = 0
+    quizzes_complete = True
     deadlines: list[tuple[str, str, str]] = []
     if isinstance(reports, Sequence):
         for course_report in reports:
@@ -1862,6 +1876,8 @@ def _print_metadata_summary(
             code = str(getattr(course, "code", "course"))
             assignments = _read_metadata_rows(directory / "_meta" / "assignments.json")
             quizzes = _read_metadata_rows(directory / "_meta" / "quizzes.json")
+            coverage = metadata_coverage.read_quiz_coverage(directory)
+            quizzes_complete = quizzes_complete and coverage.status == "complete"
             assignment_count += len(assignments)
             quiz_count += len(quizzes)
             for row in [*assignments, *quizzes]:
@@ -1871,9 +1887,12 @@ def _print_metadata_summary(
                     deadlines.append((due, title, code))
 
     grade_text = "grades synced" if include_grades else "grades not synced"
-    detail = f"{deadline_count} deadlines"
+    detail = f"{deadline_count} {'deadlines' if quizzes_complete else 'known deadlines'}"
     if assignment_count or quiz_count:
-        detail = f"{assignment_count} assignments · {quiz_count} quizzes · {detail}"
+        quiz_inventory = (
+            f"{quiz_count} quizzes" if quizzes_complete else "quiz inventory unconfirmed"
+        )
+        detail = f"{assignment_count} assignments · {quiz_inventory} · {detail}"
     typer.echo(
         f"{console.GLYPH['ok']} {course_count} courses · {topic_count} topics · "
         f"{detail} · {grade_text}"
@@ -1881,8 +1900,8 @@ def _print_metadata_summary(
     for due, title, code in _first_value_deadlines(deadlines, school):
         typer.echo(f"  {code} · {title} — due {_format_deadline(due, school)}")
     if not deadlines:
-        typer.echo(f"  No upcoming deadlines recorded in {_term_label(school, term)} metadata.")
-    del root
+        qualifier = "No upcoming" if quizzes_complete else "No known"
+        typer.echo(f"  {qualifier} deadlines recorded in {_term_label(school, term)} metadata.")
 
 
 def _iter_report_topics(value: MetadataReport | Iterable[object] | None) -> Iterable[object]:

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/doctor.py

@@ -33,7 +33,7 @@ from urllib.parse import urlencode
 
 import requests
 
-from agent2learn import __version__, console, paths
+from agent2learn import __version__, console, metadata_coverage, paths
 from agent2learn import config as config_module
 from agent2learn import session as session_module
 from agent2learn import skills as skills_module
@@ -89,7 +89,11 @@ class DoctorClient(Protocol):
 _COURSE_SOURCE_DIRECTORIES = frozenset(
     {"announcements", "assignments", "content", "quizzes", "outlines"}
 )
-_SAFE_PUBLIC_NOTES = {"fs.vault": "vault root `~`"}
+_SAFE_PUBLIC_NOTES = {
+    "fs.vault": "vault root `~`",
+    "metadata.quizzes": "Quiz collection coverage is incomplete or unknown.",
+    "metadata.quizzes.forbidden": "Quiz collection unavailable (HTTP 403 Forbidden).",
+}
 _PUBLIC_CHECK_NAMES = frozenset(
     {
         "config.load",
@@ -105,6 +109,8 @@ _PUBLIC_CHECK_NAMES = frozenset(
         "fs.longest_path",
         "fs.unavailable",
         "fs.vault",
+        "metadata.quizzes",
+        "metadata.quizzes.forbidden",
         "session.age",
         "session.api_versions",
         "session.backend",
@@ -630,6 +636,8 @@ def _vault(vault: Vault | None) -> list[Check]:
     gaps = 0
     empty_twins = 0
     unreadable_maps = 0
+    quiz_gaps: set[str] = set()
+    quizzes_forbidden = False
     term_stats: dict[str, list[int]] = {}
     try:
         map_paths = sorted(
@@ -650,6 +658,10 @@ def _vault(vault: Vault | None) -> list[Check]:
             unreadable_maps += 1
             continue
         courses += 1
+        coverage = metadata_coverage.read_quiz_coverage(map_path.parent.parent)
+        if coverage.gap is not None:
+            quiz_gaps.add(coverage.gap)
+        quizzes_forbidden = quizzes_forbidden or coverage.status == "unavailable"
         term = map_path.parent.parent.parent.name
         stats = term_stats.setdefault(term, [0, 0, 0, 0, 0])
         stats[0] += 1
@@ -730,6 +742,17 @@ def _vault(vault: Vault | None) -> list[Check]:
             None if gaps == 0 else "see .a2l/AUDIT.md",
         ),
     ]
+    quiz_check = "metadata.quizzes.forbidden" if quizzes_forbidden else "metadata.quizzes"
+    checks.append(
+        Check(
+            "Vault",
+            quiz_check,
+            "warn" if quiz_gaps else "ok",
+            "; ".join(sorted(quiz_gaps)) if quiz_gaps else "quiz collection coverage is complete",
+            "see .a2l/AUDIT.md; check quiz availability in LEARN" if quiz_gaps else None,
+            public=_SAFE_PUBLIC_NOTES[quiz_check] if quiz_gaps else None,
+        )
+    )
     checks.append(
         Check(
             "Vault",

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/ingest.py

@@ -29,7 +29,7 @@ from urllib.parse import urljoin, urlsplit, urlunsplit
 
 from requests import RequestException
 
-from agent2learn import api, clock, locations, paths, snapshot, transactions
+from agent2learn import api, clock, locations, metadata_coverage, paths, snapshot, transactions
 from agent2learn import index as course_index
 from agent2learn.api import DownloadError, DownloadResult, FileTooLarge
 from agent2learn.calibrate import CourseRef, calibrate, load_calibration
@@ -140,6 +140,7 @@ class MetadataReport:
     deadline_count: int
     errors: tuple[str, ...] = ()
     exit_code: int = 0
+    gaps: tuple[str, ...] = ()
 
 
 @dataclass(frozen=True)
@@ -243,6 +244,7 @@ def ingest_metadata(
     courses = _selected_courses(client, term=term, only=only)
     reports: list[CourseMetadata] = []
     errors: list[str] = []
+    gaps: list[str] = []
     deadline_count = 0
 
     for course in courses:
@@ -349,8 +351,11 @@ def ingest_metadata(
         quizzes, quizzes_complete, quizzes_error = _fetch_collection(
             client, _endpoint_path(client, course, "quizzes/")
         )
-        if quizzes_error is not None:
+        quiz_coverage = metadata_coverage.quiz_coverage(quizzes_complete, quizzes_error)
+        if quizzes_error is not None and quiz_coverage.status != "unavailable":
             errors.append(_safe_error("quizzes", quizzes_error))
+        if quiz_coverage.status == "unavailable" and quiz_coverage.gap is not None:
+            gaps.append(quiz_coverage.gap)
         quiz_rows = _project_quizzes(quizzes)
         quiz_rows = _merge_rows(
             _read_list(course_dir / "_meta" / "quizzes.json"),
@@ -359,6 +364,7 @@ def ingest_metadata(
             complete=quizzes_complete,
         )
         _write_list(course_dir / "_meta" / "quizzes.json", quiz_rows, root=vault.root)
+        metadata_coverage.write_quiz_coverage(course_dir, quiz_coverage, root=vault.root)
 
         if include_grades:
             grades, grades_complete, grades_error = _fetch_collection(
@@ -423,6 +429,7 @@ def ingest_metadata(
         topic_count=sum(len(report.topics) for report in reports),
         deadline_count=deadline_count,
         errors=tuple(errors),
+        gaps=tuple(sorted(set(gaps))),
     )
 
 
@@ -452,11 +459,16 @@ def load_metadata_report(
 ) -> MetadataReport:
     """Reconstruct a completed metadata report from validated local course projections."""
     reports: list[CourseMetadata] = []
+    errors: list[str] = []
+    gaps: list[str] = []
     deadline_count = 0
     for course in courses:
         course_dir = _course_directory(vault, school, course)
         topics = load_metadata_topics(vault, school, [course])
         module_tree = tuple(_read_toc_modules(course_dir))
+        coverage = metadata_coverage.read_quiz_coverage(course_dir)
+        if coverage.gap is not None:
+            (errors if coverage.status == "incomplete" else gaps).append(coverage.gap)
         deadline_count += sum(
             1
             for row in [
@@ -477,6 +489,8 @@ def load_metadata_report(
         courses=tuple(reports),
         topic_count=sum(len(report.topics) for report in reports),
         deadline_count=deadline_count,
+        errors=tuple(sorted(set(errors))),
+        gaps=tuple(sorted(set(gaps))),
     )
 
 

agent2learn-0.1.5/src/agent2learn/metadata_coverage.py

@@ -0,0 +1,137 @@
+from __future__ import annotations
+
+import json
+import os
+import re
+from dataclasses import asdict, dataclass
+from pathlib import Path
+from typing import Literal, cast
+
+from requests import HTTPError
+
+from agent2learn import paths
+from agent2learn.vault import Vault
+
+CoverageStatus = Literal["complete", "unavailable", "incomplete", "unknown"]
+_PERMISSION = "Quizzing.SeeQuizzing"
+_PROBLEM_TYPE = "http://docs.valence.desire2learn.com/res/apiprop.html#not-authorized"
+
+
+@dataclass(frozen=True)
+class QuizCoverage:
+    status: CoverageStatus = "unknown"
+    http_status: int | None = None
+    error_code: str | None = None
+    permission: str | None = None
+
+    def __post_init__(self) -> None:
+        if self.status not in {"complete", "unavailable", "incomplete", "unknown"}:
+            raise ValueError("invalid quiz coverage status")
+        if self.http_status is not None and (
+            type(self.http_status) is not int or not 400 <= self.http_status <= 599
+        ):
+            raise ValueError("invalid quiz coverage HTTP status")
+        if self.error_code not in {None, "not_authorized"} or self.permission not in {
+            None,
+            _PERMISSION,
+        }:
+            raise ValueError("unreviewed quiz coverage diagnostic")
+        if self.status in {"complete", "unknown"} and any(
+            value is not None for value in (self.http_status, self.error_code, self.permission)
+        ):
+            raise ValueError("unexpected quiz coverage diagnostic")
+        if self.status == "unavailable" and self.http_status != 403:
+            raise ValueError("unavailable quiz coverage requires HTTP 403")
+        if (self.error_code or self.permission) and self.status != "unavailable":
+            raise ValueError("permission diagnostic requires unavailable quiz coverage")
+
+    @property
+    def gap(self) -> str | None:
+        if self.status == "complete":
+            return None
+        label = {
+            "unavailable": "quizzes unavailable",
+            "incomplete": "quizzes metadata incomplete",
+            "unknown": "quizzes coverage unknown",
+        }[self.status]
+        details = [f"HTTP {self.http_status}"] if self.http_status is not None else []
+        details.extend(value for value in (self.error_code, self.permission) if value is not None)
+        return label + (f" ({'; '.join(details)})" if details else "")
+
+
+def quiz_coverage(complete: bool, error: Exception | None) -> QuizCoverage:
+    if complete:
+        return QuizCoverage("complete")
+    response = error.response if isinstance(error, HTTPError) else None
+    status = response.status_code if response is not None else None
+    if status != 403:
+        return QuizCoverage("incomplete", http_status=status)
+    error_code = None
+    permission = None
+    if response is not None and len(response.content) <= 8192:
+        try:
+            problem = response.json()
+        except ValueError:
+            problem = None
+        if isinstance(problem, dict) and problem.get("type") == _PROBLEM_TYPE:
+            error_code = "not_authorized"
+            detail = problem.get("detail")
+            if isinstance(detail, str) and re.search(
+                r"securityVariableName:\s*Quizzing\.SeeQuizzing\s*\]", detail
+            ):
+                permission = _PERMISSION
+    return QuizCoverage("unavailable", 403, error_code, permission)
+
+
+def write_quiz_coverage(course_dir: Path, coverage: QuizCoverage, *, root: Path) -> None:
+    fields = {key: value for key, value in asdict(coverage).items() if value is not None}
+    payload = {"schema_version": 1, "collections": {"quizzes": fields}}
+    paths.atomic_write_text(
+        course_dir / "_meta" / "metadata_coverage.json",
+        json.dumps(payload, indent=2, sort_keys=True) + "\n",
+        root=root,
+    )
+
+
+def read_quiz_coverage(course_dir: Path) -> QuizCoverage:
+    destination = course_dir / "_meta" / "metadata_coverage.json"
+    if paths.has_link_component(destination):
+        return QuizCoverage()
+    try:
+        with open(os.fspath(paths.long_path(destination)), encoding="utf-8", newline="") as handle:
+            payload = json.load(handle)
+        if not isinstance(payload, dict) or type(payload.get("schema_version")) is not int:
+            return QuizCoverage()
+        if payload["schema_version"] != 1 or not isinstance(payload.get("collections"), dict):
+            return QuizCoverage()
+        fields = payload["collections"].get("quizzes")
+        if not isinstance(fields, dict) or set(fields) - {
+            "status",
+            "http_status",
+            "error_code",
+            "permission",
+        }:
+            return QuizCoverage()
+        return QuizCoverage(
+            cast(CoverageStatus, fields.get("status")),
+            fields.get("http_status"),
+            fields.get("error_code"),
+            fields.get("permission"),
+        )
+    except (OSError, UnicodeError, ValueError, TypeError):
+        return QuizCoverage()
+
+
+def vault_quiz_gaps(vault: Vault) -> tuple[str, ...]:
+    if not paths.long_path(vault.root).is_dir():
+        return ()
+    return tuple(
+        sorted(
+            {
+                gap
+                for path in paths.walk(vault.root)
+                if path.name == "content_map.json" and ".a2l" not in path.parts
+                if (gap := read_quiz_coverage(path.parent.parent).gap) is not None
+            }
+        )
+    )

{agent2learn-0.1.2 → agent2learn-0.1.5}/src/agent2learn/pipeline.py

@@ -285,7 +285,7 @@ def refresh_indexes(vault: Vault, school: School, metadata: MetadataReport) -> i
     return refreshed
 
 
-def render_report(report: PipelineReport) -> str:
+def render_report(report: PipelineReport, *, include_metadata: bool = True) -> str:
     """Render stable terminal counts without echoing course names, IDs, paths, or source errors."""
 
     lines = [
@@ -318,7 +318,7 @@ def render_report(report: PipelineReport) -> str:
         )
     else:
         lines.append("sync complete")
-    return "\n".join(lines) + "\n"
+    return "\n".join(lines if include_metadata else lines[1:]) + "\n"
 
 
 def _offering_ids(value: object) -> tuple[int, ...] | None:
@@ -356,7 +356,7 @@ def _result_status(
     *,
     outline_failure: bool = True,
 ) -> tuple[tuple[str, ...], tuple[str, ...], int]:
-    gaps: list[str] = []
+    gaps: list[str] = list(metadata.gaps)
     errors: list[str] = []
     if metadata.errors or metadata.exit_code:
         errors.append("metadata incomplete")