Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/workflows/wiki-currency.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
# provenance). It versions with the content it grades, which is why it lives in
# autocti_assistant and not in the release hub. Two triggers feed it:
#
# 1. workflow_call β€” invoked by PyAutoBuild at stack-release time with the new version,
# so a release that moves the API is graded against the wiki immediately. PyAutoBuild
# 1. workflow_call β€” invoked by PyAutoHands at stack-release time with the new version,
# so a release that moves the API is graded against the wiki immediately. PyAutoHands
# only calls and reports; it owns none of the rules below.
# 2. pull_request / schedule / workflow_dispatch β€” runs in this repo against the
# currently-released stack, catching drift introduced by assistant changes themselves.
Expand Down Expand Up @@ -52,7 +52,7 @@ jobs:
PYAUTO_SKIP_WORKSPACE_VERSION_CHECK: "1"
steps:
# Always check out autocti_assistant. On native triggers github.ref already points
# here; under workflow_call github.ref is the *caller's* ref, so PyAutoBuild passes
# here; under workflow_call github.ref is the *caller's* ref, so PyAutoHands passes
# assistant_ref (e.g. main / the release tag) to pin the version of the rules used.
- name: Check out autocti_assistant
uses: actions/checkout@v4
Expand Down
2 changes: 1 addition & 1 deletion autoassistant/tests/test_to_notebook.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Fast and stdlib-only (json + tmp files): pins the cell-split semantics β€” docstring blocks
become markdown cells, code between becomes code cells β€” including the back-to-back
docstring case the PyAutoBuild reference pipeline mis-renders (two adjacent markdown
docstring case the PyAutoHands reference pipeline mis-renders (two adjacent markdown
cells, never a code cell containing literal `# %%`/`'''` markers).
"""

Expand Down
6 changes: 3 additions & 3 deletions autoassistant/to_notebook.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
- the **code between** docstring blocks becomes a **code cell**.

This module is a self-contained, stdlib-only adaptation of the converter the PyAuto
workspaces already use at build time β€” ``PyAutoBuild:autobuild/build_util.py``
(``py_to_notebook``) and ``PyAutoBuild:autobuild/add_notebook_quotes.py`` β€” which pipe
workspaces already use at build time β€” ``PyAutoHands:autobuild/build_util.py``
(``py_to_notebook``) and ``PyAutoHands:autobuild/add_notebook_quotes.py`` β€” which pipe
through the external ``ipynb-py-convert`` tool. It mirrors their cell-split semantics
(a line *starting* with triple quotes toggles docstring mode) but emits nbformat-v4 JSON
directly, so an assistant clone or a science project needs neither PyAutoBuild nor an
directly, so an assistant clone or a science project needs neither PyAutoHands nor an
extra pip dependency.

Usage:
Expand Down
12 changes: 6 additions & 6 deletions modes/maintainer.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,21 +38,21 @@ place**: [`.github/workflows/wiki-currency.yml`](../.github/workflows/wiki-curre
this repo, driving `autoassistant/audit_skill_apis.py`. The check versions with the content
it grades, so it must not be reimplemented anywhere else. Two triggers feed that one check:

- **Release (workflow_call).** PyAutoBuild's `release.yml` β€” the same run that regenerates
- **Release (workflow_call).** PyAutoHands's `release.yml` β€” the same run that regenerates
the workspace/howtolens notebooks and the API baseline β€” invokes `wiki-currency.yml` via
`uses:`, passing the new `stack_version` and `assistant_ref: main`. It installs that exact
stack and runs all four checks. On drift the reusable workflow fails; PyAutoBuild's
stack and runs all four checks. On drift the reusable workflow fails; PyAutoHands's
dependent `if: failure()` job downloads the `wiki-drift-report` artifact and opens a "wiki
drift" issue against this repo. **PyAutoBuild only orchestrates and reports β€” it holds no
copy of the rules.** (If releases ever move off PyAutoBuild, the `repository_dispatch`/
drift" issue against this repo. **PyAutoHands only orchestrates and reports β€” it holds no
copy of the rules.** (If releases ever move off PyAutoHands, the `repository_dispatch`/
`workflow_call` trigger moves to whatever cuts the release; this workflow is unchanged.)
- **Assistant change (pull_request / schedule).** The same workflow runs on every PR and
weekly against the *currently-released* stack, catching drift a wiki/skill edit introduces
before it merges.

Ordering matters at release: PyAutoBuild regenerates + commits the API baseline **before**
Ordering matters at release: PyAutoHands regenerates + commits the API baseline **before**
calling this workflow, so `--check-version` compares the new stack against an already-updated
baseline. When you change the rules, edit them here only; never copy a rule into PyAutoBuild.
baseline. When you change the rules, edit them here only; never copy a rule into PyAutoHands.

## Assistant-as-template: generic vs PyAutoCTI-specific

Expand Down
Loading