@erclx/aitk 3.8.0 → 3.10.0

package/tooling/base/reference.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-The base layer covers every project the toolkit scaffolds, whatever language sits on top. It ships formatting, spelling, shell linting, conventional commits, git hooks, CI, and three maintenance scripts. Every other stack extends it, so a decision made here is one every stack inherits.
+The base layer covers every project the toolkit scaffolds, whatever language sits on top. It ships formatting, spelling, shell linting, conventional commits, git hooks, CI, and one maintenance script. Every other stack extends it, so a decision made here is one every stack inherits.
 
 A repository with several language roots layers this stack once at the root and skips it per subtree, since git honors only one `core.hooksPath` and a re-dropped husky silently breaks. `docs/target-projects.md` carries the recipe.
 
@@ -18,7 +18,7 @@ Golden config files live in `tooling/base/configs/` and are copied into the targ
 - `.github/workflows/verify.yml`: runs on pull requests targeting `main` and on `workflow_dispatch`.
 - `.github/pull_request_template.md`: `## Summary`, `## Key Changes`, `## Technical Context`, `## Testing`.
 - `.vscode/extensions.json` and `.vscode/settings.json`: editor wiring for Prettier, cspell, shfmt, and shellcheck.
-- `scripts/verify.sh`, `scripts/clean.sh`, `scripts/update.sh`: the maintenance entry points behind `check`, `clean`, and `update`.
+- `scripts/verify.sh`: the maintenance entry point behind `check`.
 
 ## What ships as user-owned seeds
 
@@ -86,13 +86,13 @@ Sticky negative knowledge. Do not relearn.
 
 ## CLI
 
-| Script                 | What it does                                                                                                                                                                                           |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `bun run check`        | Full verification suite via `scripts/verify.sh`. Runs `format` first to auto-fix drifted code, then asserts. Honors `VERIFY_NESTED=true` to suppress timeline boundaries when another script calls it. |
-| `bun run check:format` | Asserts prettier and shfmt formatting without writing                                                                                                                                                  |
-| `bun run check:spell`  | Runs cspell across every file, with context on failures                                                                                                                                                |
-| `bun run check:shell`  | Runs shellcheck at warning severity                                                                                                                                                                    |
-| `bun run format`       | Writes prettier and shfmt formatting in place                                                                                                                                                          |
-| `bun run prepare`      | Initializes husky hooks, run automatically on `bun install`                                                                                                                                            |
-| `bun run clean`        | Removes `node_modules/`, clears the bun cache, reinstalls fresh                                                                                                                                        |
-| `bun run update`       | Runs `bun update --interactive`, then `verify.sh` with `VERIFY_NESTED=true`                                                                                                                            |
+| Script                 | What it does                                                                                                                          |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `bun run check`        | Repairs a checkout via `scripts/verify.sh`. Honors `VERIFY_NESTED=true` to suppress timeline boundaries when another script calls it. |
+| `bun run check:format` | Asserts prettier and shfmt formatting without writing                                                                                 |
+| `bun run check:spell`  | Runs cspell across every file, with context on failures                                                                               |
+| `bun run check:shell`  | Runs shellcheck at warning severity                                                                                                   |
+| `bun run format`       | Writes prettier and shfmt formatting in place                                                                                         |
+| `bun run prepare`      | Initializes husky hooks, run automatically on `bun install`                                                                           |
+
+`bun run check` repairs a checkout rather than gating one. It runs `format` first to auto-fix drifted code, then asserts only what the formatters could not fix. The pull request workflow calls `check:format`, `check:spell`, and `check:shell` directly, and those three are the gate.

package/tooling/base/seeds/.claude/context/development.md

@@ -21,12 +21,10 @@ Owns how the project runs on a developer machine: installing the toolchain, the
 
 ## Scripts
 
-| Command          | Purpose                                              |
-| ---------------- | ---------------------------------------------------- |
-| `bun run check`  | Full verification. Auto-formats, then asserts clean. |
-| `bun run format` | Auto-fix prettier and shfmt formatting.              |
-| `bun run clean`  | Wipe `node_modules/`, clear bun cache, reinstall.    |
-| `bun run update` | Interactive `bun update` followed by verification.   |
+| Command          | Purpose                                                                        |
+| ---------------- | ------------------------------------------------------------------------------ |
+| `bun run check`  | Repairs locally. Auto-formats, then asserts what the formatters could not fix. |
+| `bun run format` | Auto-fix prettier and shfmt formatting.                                        |
 
 ## Shell scripts
 

package/tooling/base/configs/scripts/clean.sh

@@ -1,45 +0,0 @@
-#!/bin/bash
-set -e
-set -o pipefail
-
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-WHITE='\033[1;37m'
-GREY='\033[0;90m'
-NC='\033[0m'
-
-log_info() { echo -e "${GREY}│${NC} ${GREEN}✓${NC} $1"; }
-log_error() {
-  echo -e "${GREY}│${NC} ${RED}✗${NC} $1"
-  exit 1
-}
-log_step() { echo -e "${GREY}│${NC}\n${GREY}├${NC} ${WHITE}$1${NC}"; }
-log_rem() { echo -e "${GREY}│${NC} ${RED}-${NC} $1"; }
-
-check_dependencies() {
-  command -v bun >/dev/null 2>&1 || log_error "bun is not installed"
-}
-
-main() {
-  check_dependencies
-
-  echo -e "${GREY}┌${NC}"
-
-  echo -e "${GREY}├${NC} ${WHITE}Cleaning artifacts${NC}"
-  rm -rf node_modules
-
-  log_rem "node_modules/"
-
-  log_step "Cleaning cache"
-  bun pm cache rm
-  log_info "Package manager cache cleared"
-
-  log_step "Rehydrating project"
-  bun install
-  log_info "Dependencies installed"
-
-  echo -e "${GREY}└${NC}\n"
-  echo -e "${GREEN}✓ Clean complete${NC}"
-}
-
-main "$@"

package/tooling/base/configs/scripts/update.sh

@@ -1,49 +0,0 @@
-#!/bin/bash
-set -e
-set -o pipefail
-
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-RED='\033[0;31m'
-WHITE='\033[1;37m'
-GREY='\033[0;90m'
-NC='\033[0m'
-
-log_info() { echo -e "${GREY}│${NC} ${GREEN}✓${NC} $1"; }
-log_warn() { echo -e "${GREY}│${NC} ${YELLOW}!${NC} $1"; }
-log_error() {
-  echo -e "${GREY}│${NC} ${RED}✗${NC} $1"
-  exit 1
-}
-log_step() { echo -e "${GREY}│${NC}\n${GREY}├${NC} ${WHITE}$1${NC}"; }
-
-pipe_output() { while IFS= read -r line; do echo -e "${GREY}│${NC}  $line"; done; }
-
-check_dependencies() {
-  command -v bun >/dev/null 2>&1 || log_error "bun is not installed"
-}
-
-main() {
-  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-  check_dependencies
-
-  echo -e "${GREY}┌${NC}"
-
-  echo -e "${GREY}├${NC} ${WHITE}Interactive dependency update${NC}"
-  echo -e "${GREY}│${NC}"
-  bun update --interactive
-
-  log_step "Verifying project health"
-  if [ -f "$SCRIPT_DIR/verify.sh" ]; then
-    VERIFY_NESTED=true "$SCRIPT_DIR/verify.sh"
-    log_info "All checks passed"
-  else
-    log_warn "Verification script not found, skipping."
-  fi
-
-  echo -e "${GREY}└${NC}\n"
-  echo -e "${GREEN}✓ Update complete${NC}"
-}
-
-main "$@"