@texra-ai/cli 0.38.8 → 0.38.9

package/dist/resources/skills/mathematical-enhancer/references/enhancement-checklist.md

@@ -0,0 +1,30 @@
+# Enhancement Checklist
+
+Use this checklist when trying to improve a paper's mathematics rather than just its exposition.
+
+## Look for
+
+- Brute-force proofs that could be replaced by a cleaner idea
+- Standard results that could shorten or strengthen the argument
+- Generalizations that preserve the paper's point while broadening scope
+- Tighter bounds, sharper constants, or cleaner structural statements
+- Loose ends or assumptions that can actually be resolved
+
+## Separate two classes of ideas
+
+- Tractable improvements: implement them fully and verify them
+- Speculative improvements: leave them as explicit suggestions with rationale
+
+## Impact and confidence
+
+- High impact, high confidence: implement
+- High impact, low confidence: annotate as a substantial suggestion
+- Moderate impact, high confidence: implement if it clarifies or strengthens the paper cleanly
+- Low impact: avoid churn unless it unlocks something more important
+
+## Quality control
+
+- Do not claim a stronger result unless you have actually justified it.
+- Keep the improved mathematics readable and trustworthy.
+- Prefer substantial gains over decorative cleverness.
+- Fall back to the original route cleanly if the enhancement does not survive scrutiny.

package/dist/resources/skills/scientific-presenter/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: scientific-presenter
+description: Build or revise scientific talks, posters, and Beamer slide decks from papers, codebases, figures, or LaTeX templates. Use when Codex needs to turn technical research into a clear presentation, preserve an existing slide theme, generate or improve figures, or iteratively compile and visually check presentation output.
+---
+
+# Scientific Presenter
+
+## When to use this skill
+
+Use this skill for research talks, posters, code walkthrough decks, paper-to-slides conversions, and presentation revisions where visual quality matters as much as technical accuracy.
+
+## Workflow
+
+1. Read any provided `.tex`, `.sty`, poster template, or slide template before planning content. Preserve the existing theme, typography, colors, macros, and structure unless the user asks for a redesign.
+2. Survey the workspace before editing. Identify the core claims, algorithms, figures, tables, equations, and code artifacts that actually belong in the presentation.
+3. Plan the deck around a story rather than around the paper's section order. Make each slide answer one question or advance one idea.
+4. Prefer visual communication. Turn architecture, pipelines, derivations, and comparisons into diagrams, tables, overlays, or compact equations instead of dense prose blocks.
+5. Keep code excerpts short and purposeful. Show only the lines needed to explain the mechanism, result, or design decision.
+6. Compile early and often. After each substantial change, inspect the rendered output and fix layout, overflow, readability, and figure quality issues before continuing.
+7. If figures or plots are generated from code, rerun the code when feasible and verify the resulting assets instead of mocking them by description.
+
+## Quality Bar
+
+- Keep body text readable at presentation scale. Split crowded slides instead of shrinking everything.
+- Use equations sparingly and only when they clarify the argument. Define notation before using it on slides.
+- Keep aspect ratios intact for figures and ensure axes, legends, and units are visible.
+- Use progressive disclosure when the audience must absorb a derivation, algorithm, or workflow in stages.
+- Treat visual QA as mandatory. A slide that compiles but clips, overlaps, or hides labels is not done.
+
+For a stricter final pass, use [references/slide-quality-checklist.md](references/slide-quality-checklist.md) to review slide density, figure quality, poster layout, and Beamer-specific issues.

package/dist/resources/skills/scientific-presenter/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: 'Scientific Presenter'
+  short_description: 'Build and refine research slide decks'
+  default_prompt: 'Use $scientific-presenter to turn this paper or codebase into a polished scientific talk.'

package/dist/resources/skills/scientific-presenter/references/slide-quality-checklist.md

@@ -0,0 +1,34 @@
+# Slide Quality Checklist
+
+Use this checklist when a deck or poster is mostly complete and needs a rigorous visual pass.
+
+## Story and structure
+
+- Make each slide answer one concrete question.
+- Put the thesis, method, result, and takeaway in a visible narrative order.
+- Split slides that mix too many jobs.
+
+## Visual QA
+
+- Check for overflow, clipping, overlapping elements, and unreadably small text.
+- Keep figure aspect ratios intact.
+- Confirm axes, legends, units, and captions are visible.
+- Balance whitespace across slides and poster columns.
+
+## Code and equations
+
+- Show only the lines or formulas needed for the point being made.
+- Prefer pseudocode, overlays, or side-by-side explanation over raw dumps.
+- Define notation before using it on a slide.
+
+## Figures and generated assets
+
+- Regenerate plots from source code when feasible.
+- Inspect generated images or PDFs directly after compilation.
+- Fix missing labels, cropped legends, and poor contrast before moving on.
+
+## Beamer and poster specifics
+
+- Use slide titles consistently.
+- Keep navigation, sectioning, and slide numbers coherent with the chosen template.
+- For posters, check column balance, block boundaries, and header/footer clipping.

package/dist/resources/skills/scientific-simplifier/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: scientific-simplifier
+description: Simplify scientific code, LaTeX, and technical prose while preserving exact behavior, results, and meaning. Use when Codex needs to remove duplication, reduce unnecessary abstraction, clean up AI-generated bloat, or make a research codebase or manuscript clearer without changing its substance.
+---
+
+# Scientific Simplifier
+
+## When to use this skill
+
+Use this skill when a scientific project feels bloated, repetitive, over-abstracted, or harder to read than it should be, but the underlying behavior and mathematics must remain unchanged.
+
+## Workflow
+
+1. Inspect the target area before editing. Identify what is duplicated, indirect, dead, formulaic, or misleadingly complex.
+2. Preserve outputs and meaning. Treat simplification as an expression change, not a behavior change.
+3. Remove duplication only after verifying the repeated pieces serve the same purpose, not merely a similar shape.
+4. Prefer direct, idiomatic language and native constructs over custom wrappers or ornamental abstractions.
+5. Tighten scientific prose aggressively: delete filler openings, redundant transitions, vague significance claims, and conversation leakage.
+6. Simplify one logical piece at a time and verify after each change with tests, compilation, or equivalent checks.
+7. Stop when the code or prose reads like a deliberate design, not a pile of edits.
+
+## Quality Bar
+
+- Do not collapse distinct scientific regimes or assumptions into one helper just to save lines.
+- Do not replace clear control flow with clever one-liners.
+- Do not remove notation, equations, or comments that carry real meaning.
+- Prefer smaller, safer edits over sweeping rewrites when the verification surface is large.
+- If a simplification changes results, semantics, or narrative emphasis, revert it.
+
+For a broader cleanup pass, use [references/simplification-checklist.md](references/simplification-checklist.md) when the codebase is large, the prose shows obvious AI artifacts, or you need a more systematic review of duplication and abstraction.

package/dist/resources/skills/scientific-simplifier/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: 'Scientific Simplifier'
+  short_description: 'Simplify code and technical prose safely'
+  default_prompt: 'Use $scientific-simplifier to make this scientific code or LaTeX clearer without changing its behavior or meaning.'

package/dist/resources/skills/scientific-simplifier/references/simplification-checklist.md

@@ -0,0 +1,23 @@
+# Simplification Checklist
+
+Use this checklist for a deeper pass when a codebase or manuscript has accumulated obvious complexity.
+
+## Code structure
+
+- Find wrappers, dispatch layers, and factories that add no real abstraction.
+- Remove dead code, unreachable branches, and commented-out blocks.
+- Consolidate true duplicates only after checking semantics.
+- Replace hand-rolled utilities with clear native constructs when that improves readability.
+
+## Scientific prose
+
+- Delete filler openings, repetitive transitions, and empty significance claims.
+- Remove conversation leakage such as change notes or assistant-style narration.
+- Replace vague claims with specific statements or cut them.
+- Introduce notation once and stop re-explaining it.
+
+## Safety checks
+
+- Run tests, compile, or otherwise verify after each logical change.
+- Revert any simplification that changes behavior, results, or scientific meaning.
+- Prefer the smallest edit that materially improves clarity.

package/dist/resources/skills/tikz-figure-builder/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: tikz-figure-builder
+description: Create or refine TikZ figures for technical papers and slides. Use when Codex needs to add a new diagram, improve an existing figure, align a visual with manuscript notation, or iteratively compile and visually read the rendered output until the figure is correct and readable.
+---
+
+# TikZ Figure Builder
+
+## When to use this skill
+
+Use this skill for architecture diagrams, workflows, commutative diagrams, tensor-network sketches, algorithm schematics, annotated plots, and figure cleanups where the final output should be TikZ or closely integrated with LaTeX.
+
+## Workflow
+
+1. Read the surrounding manuscript or slide context before drawing. Match the figure to the notation, vocabulary, and mathematical meaning already in use.
+2. Decide what the figure must communicate. Reduce the diagram to the essential objects, relationships, flow, or geometry.
+3. Prefer reusable styles and compact structure over copy-pasted node formatting.
+4. Compile every substantial TikZ change and visually read the rendered image or PDF, not just the source code. Treat this as an automatic loop: edit, build, read, fix, and rebuild until the figure is stable.
+5. Fix clipping, crowding, label collisions, uneven spacing, unreadable labels, and style drift immediately instead of deferring them.
+6. For mathematically meaningful diagrams, verify that topology, arrow direction, labels, and adjacency actually match the equations or constructions they represent.
+7. Keep captions and in-text references synchronized with the final figure.
+
+## Quality Bar
+
+- A pretty but mathematically wrong diagram is a failure.
+- Labels must be legible and consistent with manuscript notation.
+- Spacing should make structure obvious without decorative clutter.
+- Avoid duplicated style definitions across multiple figures when a shared style can live in the preamble or a common file.
+- Do not stop at source edits alone when a build is possible; the default is to compile, visually read the rendered result, and refine until it is clean.
+- Ensure the figure integrates cleanly into the surrounding text and layout.
+
+For dense or math-sensitive figures, use [references/figure-checklist.md](references/figure-checklist.md) to run a stricter pass over layout, consistency, and rendered correctness.

package/dist/resources/skills/tikz-figure-builder/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: 'TikZ Figure Builder'
+  short_description: 'Create and refine TikZ diagrams'
+  default_prompt: 'Use $tikz-figure-builder to create or improve a TikZ figure, then iteratively compile and visually read the rendered result until it is clean.'

package/dist/resources/skills/tikz-figure-builder/references/figure-checklist.md

@@ -0,0 +1,25 @@
+# Figure Checklist
+
+Use this file when a TikZ figure needs a stricter validation pass.
+
+## Technical correctness
+
+- Check that node relationships, arrows, labels, and topology match the underlying math or algorithm.
+- Confirm the figure uses the same notation as the surrounding document.
+
+## Layout
+
+- Check for clipped edges, overlapping labels, uneven spacing, and hard-to-follow routing.
+- Make the visual hierarchy obvious without decorative clutter.
+
+## Reuse and consistency
+
+- Factor repeated styles into shared definitions when multiple figures use the same look.
+- Keep captions and in-text references aligned with the final figure.
+
+## Compile-and-inspect loop
+
+- Recompile after meaningful edits.
+- Visually read the rendered figure, not just the source.
+- Fix layout defects immediately instead of stacking more edits on top.
+- Repeat the loop until clipping, collisions, spacing defects, and notation mismatches are gone rather than stopping after the first successful build.

package/dist/resources/skills/writing-commenter/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: writing-commenter
+description: Review research writing by leaving inline comments on logic, notation, narrative flow, positioning, and editorial impact. Use when Codex needs to annotate a paper or draft with reader-facing comments instead of silently rewriting it, especially for argument structure, symbol consistency, and publication-oriented presentation.
+---
+
+# Writing Commenter
+
+## When to use this skill
+
+Use this skill when the main job is to comment on a manuscript rather than to silently edit it. It is suited to three distinct review modes: logical-flow review, notation review, and editorial elevation where the author should see the reasoning behind suggested changes.
+
+## Workflow
+
+1. Read the full manuscript before commenting. Understand the paper's argument, notation, structure, and current maturity level.
+2. Choose the review mode up front unless the user explicitly asks for a mixed pass:
+   - logical flow: structure, transitions, narrative coherence, balance of explanation
+   - notation: symbol consistency, definition order, convention conflicts, graceful renaming
+   - editorial elevation: title, abstract, framing, audience fit, rhetorical rhythm, figure-caption storytelling
+3. Keep strict scope within the chosen mode. Do not drift into mathematical correctness, generic line edits, or copyediting unless the user asked for that.
+4. Prefer inline comments that point to concrete issues and propose actionable fixes. If the document already has an annotation convention, preserve it.
+5. In logic mode, comment where the reader loses the thread: weak transitions, misplaced paragraphs, unsupported jumps, and broken narrative arc.
+6. In notation mode, comment where symbols are inconsistent, reused confusingly, or introduced too late, and prefer graceful solutions that minimize document-wide churn.
+7. In editorial mode, comment where the paper undersells its contribution, flattens important ideas, fails to position itself for likely reviewers, or misuses figures, tables, and captions as mere decoration.
+8. Keep the comments self-contained and compile-safe when they live inside LaTeX. The document should remain readable and buildable with the comments present.
+
+## Quality Bar
+
+- Comments should be specific enough that an author can act on them immediately.
+- Prefer fewer, higher-signal comments over annotating every sentence.
+- Distinguish local fixes from systemic issues. Do not pretend a document-wide reorganization is a one-line tweak.
+- Preserve the author's voice and technical content; the goal is to diagnose and guide, not to overwrite reflexively.
+- If the document already uses an inline comment macro, match its style and syntax correctly.
+- For a mixed-mode review, still label the issue mentally by mode so the feedback does not blur into generic “make it better” commentary.
+
+For a stricter pass over comment discipline, issue selection, and compile-safe inline annotations, use [references/commenting-checklist.md](references/commenting-checklist.md).

package/dist/resources/skills/writing-commenter/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: 'Writing Commenter'
+  short_description: 'Leave inline comments on research writing'
+  default_prompt: 'Use $writing-commenter to annotate this draft with high-signal inline comments about logic, notation, and editorial impact.'

package/dist/resources/skills/writing-commenter/references/commenting-checklist.md

@@ -0,0 +1,33 @@
+# Commenting Checklist
+
+Use this checklist when annotating a paper directly instead of silently rewriting it.
+
+## Focus
+
+- Choose one primary mode unless the user explicitly wants a combined pass.
+- Separate structural issues, notation issues, and editorial-impact issues.
+- Comment on the strongest problems first.
+- Avoid flooding the manuscript with low-value marginal notes.
+
+## Logic and structure
+
+- Flag weak transitions, abrupt jumps, misplaced content, and broken section-to-section flow.
+- Mark concepts used before they are introduced.
+- Distinguish local fixes from problems that require real reorganization.
+
+## Notation
+
+- Track conflicting symbols, reused notation, and undefined quantities.
+- Prefer graceful solutions that minimize unnecessary document-wide renaming.
+
+## Editorial impact
+
+- Mark titles, abstracts, introductions, captions, and claims that undersell or overstate the contribution.
+- Comment from the reader's perspective: what would confuse, bore, or trigger skepticism?
+- Calibrate to audience: editor, expert reviewer, broad peer, or outsider.
+
+## Inline comment discipline
+
+- Keep comments actionable and brief.
+- If the comments live inside LaTeX, keep them compile-safe.
+- Match the document's existing annotation convention when one already exists.

package/dist/resources/tool_use_agents/review.yaml

@@ -36,11 +36,11 @@ prompts:
     (1) For every key derivation, reproduce it step-by-step. Check that each step follows logically from the previous one. When a step is nontrivial, write out the intermediate algebra explicitly.
     (2) Verify limiting cases and special cases of results. Does the general formula reduce correctly when a parameter vanishes or diverges?
     (3) Check dimensional consistency of equations.
-    (4) Verify numerical values, coefficients, and prefactors by independent computation.
+    (4) Verify numerical values, coefficients, and prefactors by independent computation when they are substantive or not easily checked by inspection.
     (5) For inequalities or bounds, test with concrete examples to confirm they hold.
     (6) For differential equations, verify that stated solutions satisfy the original equation.
-    (7) Use the wolfram tool to verify symbolic algebra, evaluate integrals, check identities, and perform numerical spot-checks. Sessions do NOT persist between wolfram tool calls — each execution starts fresh. For multi-step verifications needing persistence, write to a .wl file and run via bash.
-    (8) If wolfram is unavailable, fall back to bash with short Python/SymPy scripts for the same computational checks.
+    (7) Prefer direct mathematical review when a claim can be checked by hand. Use the wolfram tool only when computation adds real evidence for nontrivial symbolic algebra, integrals, identities, or numerical spot-checks; do not request external computation for elementary facts such as nonnegativity of squares or $x^2 = 0$ over the reals. Sessions do NOT persist between wolfram tool calls — each execution starts fresh. For multi-step verifications needing persistence, write to a .wl file and run via bash.
+    (8) If computational verification is warranted and wolfram is unavailable, fall back to bash with short Python/SymPy scripts for the same checks.
 
     Notation Consistency:
     (1) Use grep to find all occurrences of key symbols and variables across the manuscript.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@texra-ai/cli",
-  "version": "0.38.8",
+  "version": "0.38.9",
   "description": "TeXRA CLI — your AI theorist in the terminal.",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "TeXRA.ai",
@@ -77,6 +77,7 @@
     "react": "^19.2.7",
     "semver": "^7.8.4",
     "string-width": "^8.0.0",
+    "strip-ansi": "^7.2.0",
     "typescript": "^6.0.3",
     "wrap-ansi": "^10.0.0"
   }