pi-ext bugabingas pi extensions
owned by bugabinga
README Source History Refs Compare Notes Search build: rework markdown formatting pipeline 661ef856b29fa10ba6e8ae0095f0745a203dd15b
Oliver Jan Krylow <oliver@bugabinga.net > · 6 Jun 2026
unsigned
Browse files Compare with HEAD
- move dprint out of npm scripts, run as mise step before mdslw
- add bin mapping for mdslw in mise.toml (was mdslw_x86_64-unknown)
- simplify scripts/mdslw.py (remove stale SKIP_FILES)
- fix ruff lint errors in scripts/extensions.py (unused import/variable)
- update markdownlint ignores for test prompts and corrupted files
- add root AGENTS.md with build system docs
- update extensions/AGENTS.md (split from original)
Changed files (6) .markdownlint-cli2.yaml Modified 6 6 -
"skills/*/references/**" 7 7 -
"skills/presenterm/templates/**" 8 8 -
"skills/pi/LICENSE.md" 9 + -
".pi/prompts/test-*.md" 10 + -
"prompts/brain.md" 11 + -
"prompts/brutal.md" 12 + -
"skills/brutal/SKILL.md" new file mode 100644 1 + #
Pi Extensions Workspace 3 + Monorepo for Pi extensions.
4 + Extensions live in `extensions/*`.
8 + `mise` is the singular interface.
9 + `mise.toml` is the source of truth.
13 + | Task | Command | Description |
14 + | ------------ | -------------------------------- | ------------------------------------ |
15 + | List | `mise run list` | List extensions |
16 + | Format | `mise run fmt` | Format repo |
17 + | Lint | `mise run lint` | Verify formatting and lint |
18 + | Test | `mise run test` | Run tests |
19 + | Check | `mise run check` | Static extension checks |
20 + | CI | `mise run ci` | Release gate (lint + test + check) |
21 + | Changelog | `mise run changelog -- {name}` | Generate changelog for extension |
22 + | README | `mise run readme -- {name}` | Generate/update README for extension |
23 + | Demo | `mise run demo -- {name}` | Record demo GIFs |
24 + | Publish | `mise run publish -- {name}` | Publish after release gate |
25 + | Goal pexpect | `mise run goal-pexpect [--idea]` | Run goal pexpect test |
29 + `mise run ci` must pass before pushing.
34 + If the build system itself (`mise.toml`, scripts, or tooling) blocks progress,
36 + Do not work around `mise` or add ad-hoc scripts.
40 + If `mise run` tasks fail with command-not-found errors, run `mise doctor`.
42 + mise not activated, shims missing, tool binary name mismatch.
6 6 markdownlint-cli2 =
"0.22.1" 8 8 "aqua:nushell/nushell" =
"0.112.2" 9 - "github:razziel89/mdslw" =
"0.17.1" 9 + "github:razziel89/mdslw" = {
version =
"0.17.1" ,
bin =
"mdslw" }
12 12 description =
"List tasks" 16 16 description =
"Format repo" 17 - run = [
"npm run fmt" ,
"python3 scripts/mdslw.py" ]
20 + "python3 scripts/mdslw.py" ,
20 24 description =
"Verify formatting and lint" 21 - run = [
"npm run lint" ,
"python3 scripts/mdslw.py --mode check" ,
"python3 scripts/check_skills.py" ]
27 + "python3 scripts/mdslw.py --mode check" ,
28 + "python3 scripts/check_skills.py" ,
24 32 description =
"Run tests" 10 - "fmt" :
"biome check --write . && ruff format . && dprint fmt && yamlfmt ." ,
11 - "lint" :
"biome ci . && ruff format --check . && ruff check . && dprint check && markdownlint-cli2 && yamlfmt -lint ." ,
10 + "fmt" :
"biome check --write . && ruff format . && yamlfmt ." ,
11 + "lint" :
"biome ci . && ruff format --check . && ruff check . && markdownlint-cli2 && yamlfmt -lint ." ,
12 12 "test" :
"vitest run" ,
13 13 "test:watch" :
"vitest" ,
14 14 "typecheck" :
"tsc --noEmit" ,
scripts/extensions.py Modified 226 225 deps
= pkg.get(
"dependencies" , {})
or {}
227 226 peers
= pkg.get(
"peerDependencies" , {})
or {}
228 227 dev
= pkg.get(
"devDependencies" , {})
or {}
229 - scripts
= pkg.get(
"scripts" , {})
or {}
231 228 if dev.get(HARNESS)
is None :
232 229 err(errors, ext,
f "missing devDependency {HARNESS}
" )
251 - s.startswith(
"." )
or s.startswith(
"/" )
or s.startswith(
"node:" )
247 + if not (s.startswith(
"." )
or s.startswith(
"/" )
or s.startswith(
"node:" ))
255 250 for spec
in specs:
863 855 def cmd_test (selected:
list [
str ]) ->
int :
864 856 dirs
= ext_dirs(selected)
865 857 args
= [
str (d.relative_to(ROOT))
for d
in dirs]
if dirs
else []
942 - + [ROOT
/ "README.md" , ROOT
/ "CHANGELOG.md" , ROOT
/ "package.json" , ROOT
/ "package-lock.json" ]
935 + ROOT
/ "README.md" ,
936 + ROOT
/ "CHANGELOG.md" ,
937 + ROOT
/ "package.json" ,
938 + ROOT
/ "package-lock.json" ,
944 941 tag
= create_tag()
10 10 ROOT
= Path(
__file__ ).resolve().parents[
1 ]
11 11 SKIP_DIRS
= {
".git" ,
".jj" ,
".demo" ,
"node_modules" ,
"__pycache__" }
13 - Path(
"extensions/TODO.md" ),
14 - Path(
"skills/pi/LICENSE.md" ),
12 + SKIP_FILES:
set [Path]
= set ()
18 15 def markdown_files () ->
list [
str ]: