Rust text frequency inverse document frequency pipe friendly capabilities
  • Rust 58.9%
  • Shell 41.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Andrew Briscoe 336a58d37f
chore(tooling): refresh tai workflows and tfidf manual
Capabilities:
- Added AI-assisted maintenance workflows under 'tools/' for:
  - commit message generation from 'git diff --cached'
  - clippy fix report generation
  - shellcheck/tooling fix report generation
  - documentation fix report generation
  - generated report discovery and display
- Changed completion and manual generation scripts to use 'tai.env' and newer 'terminal-ai' option syntax.
- Expanded 'man/tfidf.1' into a more complete reference for CLI behavior, path resolution, tokenization, scoring, output formats, files, and exit status.
- Removed obsolete local helper scripts that duplicated or predated the new 'terminal-ai' workflow.

Operations / Workflows:
- Updated 'create-completions.sh':
  - sources 'tai.env' instead of 'lit.env'
  - writes generated completion drafts to '.new' files
  - passes '-o NO_USER_STDOUT,CONTENT_ONLY,NO_USER_ARTIFACT' using separated option syntax
- Updated 'create-manual.sh':
  - sources 'tai.env'
  - sets 'TAI_MODEL=gpt-5.6-sol'
  - writes generated manual drafts to 'man/tfidf.1.new'
  - is now executable
- Added 'tools/generate-commit-msg.sh':
  - captures staged diffs
  - sends them to 'terminal-ai'
  - writes generated messages to '.generated/changes-<UUIDv7>'
  - displays the latest generated message through 'tools/view-last-commit-msg.sh'
- Added fix-report workflows:
  - 'tools/fix.sh' runs 'cargo clippy' and asks 'terminal-ai' for fixes
  - 'tools/fix-tools.sh' runs 'shellcheck' across shell scripts
  - 'tools/fix-doc.sh' renders documentation and reference context for documentation repair prompts
  - 'tools/show-fix.sh' displays the latest generated fix report

Systems & Integration:
- Added 'tai.env' with 'TAI_TRANSCRIPT_DIR=.generated/transcripts'.
- Added 'tools/ask-tai.sh' for direct repository-scoped 'terminal-ai' prompts against 'src/main.rs'.
- Added 'tools/list-generated-files.sh' to list '.generated/' artifacts by UUIDv7 time, type, and repository-relative path.
- Added 'tools/view-last-commit-msg.sh' to print the newest generated commit message artifact.
- Replaced older helper scripts:
  - removed 'tools/create-commit-msg'
  - removed 'tools/commit-message-history'
  - removed 'tools/recorded-commit-issues'
  - removed 'tools/context.sh'
  - removed 'tools/fix-script'

Data & Information:
- Expanded 'man/tfidf.1' with clearer sections for:
  - synopsis and command forms
  - 'save' path handling and legacy index-path heuristic
  - 'query list', 'query terms', 'query similar', and 'query search'
  - '--index', '--top', '--', '-h', and '--help'
  - 'TFIDF_INDEX', 'TFIDF_DATA_DIR', 'TFIDF_APPNAME', 'XDG_DATA_HOME', 'XDG_CONFIG_HOME', and 'HOME'
  - stopword file discovery and reload behavior
  - tokenizer rules and TF-IDF scoring formulas
  - output formats, files, examples, notes, and exit status
- Documented operational details such as broken-pipe success, non-atomic full index replacement, non-canonicalized document paths, and unstable ordering for tied results.

Obsolete / Replaced:
- Replaced ad hoc commit-message and context scripts with reusable 'terminal-ai' workflows centered on '.generated/' artifacts.
- Replaced the old single-purpose 'tools/fix-script' with dedicated fix workflows for code, shell tooling, and documentation.
- Superseded direct generated manual/completion overwrite behavior with '.new' draft outputs for review before replacement.

Issues / Risks:
- New scripts assume external tools are available, including 'terminal-ai', 'fd', 'parallel', 'bat', 'mdless', 'uuidgen', 'uuidparse', 'shellcheck', and nightly Cargo support for '-Z unstable-options'.
- Some shell scripts rely on Bash-specific process substitution and arrays, so they are intentionally Bash scripts rather than portable 'sh'.
- Generated artifacts remain review-oriented and are not automatically validated or applied.
2026-07-28 05:33:56 +08:00
completions feat(tooling): add tfidf man page and AI-generated shell completions 2026-07-22 13:53:37 +08:00
docs wip(docs): Add work in progress (to be documented on main-line merge) 2026-01-09 15:05:18 +08:00
man chore(tooling): refresh tai workflows and tfidf manual 2026-07-28 05:33:56 +08:00
src refactor(cli): make index resolution stateless and data-dir based 2026-06-23 15:34:18 +08:00
tools chore(tooling): refresh tai workflows and tfidf manual 2026-07-28 05:33:56 +08:00
.gitignore feat(tooling): add commit history/issue extractors and ignore local .stash 2026-06-23 16:09:48 +08:00
ask-tai.sh feat(tooling): add tfidf man page and AI-generated shell completions 2026-07-22 13:53:37 +08:00
Cargo.toml refactor(cli): make index resolution stateless and data-dir based 2026-06-23 15:34:18 +08:00
create-completions.sh chore(tooling): refresh tai workflows and tfidf manual 2026-07-28 05:33:56 +08:00
create-manual.sh chore(tooling): refresh tai workflows and tfidf manual 2026-07-28 05:33:56 +08:00
install.sh refactor(cli): make index resolution stateless and data-dir based 2026-06-23 15:34:18 +08:00
tai.env chore(tooling): refresh tai workflows and tfidf manual 2026-07-28 05:33:56 +08:00