justin/ai-workflow-course

Fork 0

Files

T

History

claude a2aa953761

CI / check (pull_request) Successful in 5s

Details

feat(ci): add tools/check.sh test suite + PR CI (build=render, test=check)

Prereqs for autopilot full-auto-merge eligibility (and useful CI on their own):
- tools/check.sh: dependency-light test suite (lab py-compile, sh/json/yaml parse,
  no-em-dash slop guard, per-module template-section structure check). Exits non-zero
  on any failure. The autopilot review gate runs this as its `test` command.
- .gitea/.github workflows/ci.yml: run on every PR + push on the docker runners;
  build = render the wiki from the tree, test = tools/check.sh. The PR commit status
  is what the autopilot gate's CI precondition reads.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT

2026-06-23 09:47:36 -04:00

build_wiki.py

Remove em-dashes from the wiki generator + README (#95 )

2026-06-22 23:25:31 -04:00

check.sh

feat(ci): add tools/check.sh test suite + PR CI (build=render, test=check)

2026-06-23 09:47:36 -04:00

README.md

De-slop internal docs + config (repo now fully em-dash-free) (#98 )

2026-06-23 08:51:38 -04:00

README.md

tools/

`build_wiki.py`: render the course into a wiki

The course wiki (the "textbook" view under the Wiki tab) is generated build output. The single source of truth is modules/**/README.md + capstone/README.md. Never hand-edit the wiki; edits there are overwritten on the next sync.

build_wiki.py is host-agnostic: it writes Markdown pages into a wiki working directory (Home.md, _Sidebar.md, _Footer.md, one page per module + capstone), rewriting lab/… and repo-root links to absolute URLs back in the main repo (so the runnable labs stay in the repo and are linked, never copied into the wiki).

Run it manually

# clone the wiki repo (Gitea)
git clone https://git.jpaul.io/justin/ai-workflow-course.wiki.git wiki

# render into it
python3 tools/build_wiki.py --repo-root . --out wiki \
    --web-base https://git.jpaul.io/justin/ai-workflow-course --branch main --host gitea

# publish
cd wiki && git add -A && git commit -m "docs(wiki): sync from modules/" && git push

For GitHub, use --host github and --web-base https://github.com/<owner>/<repo>.

Automated sync (CI)

Gitea: .gitea/workflows/sync-wiki.yml runs on every push to main that touches modules/**, capstone/**, README.md, or this generator.
GitHub: .github/workflows/sync-wiki.yml does the same on the mirror.

Both need, one time:

an Actions runner attached (Gitea: Settings → Actions → Runners);
a repo secret WIKI_TOKEN with wiki write (a scoped PAT/deploy token, not a site-admin token; on GitHub the default GITHUB_TOKEN can't push the wiki);
the wiki initialized once (Gitea is already initialized; on GitHub create one page in the UI first so <repo>.wiki.git exists).

README.md

tools/

build_wiki.py: render the course into a wiki

Run it manually

Automated sync (CI)

`build_wiki.py`: render the course into a wiki