Skip to content

fix: POSIX sh compatibility and Feynman grammar#406

Merged
rdmueller merged 3 commits into
LLM-Coding:mainfrom
cpoepke:fix/posix-sh-and-feynman-grammar
Apr 6, 2026
Merged

fix: POSIX sh compatibility and Feynman grammar#406
rdmueller merged 3 commits into
LLM-Coding:mainfrom
cpoepke:fix/posix-sh-and-feynman-grammar

Conversation

@cpoepke

@cpoepke cpoepke commented Apr 6, 2026

Copy link
Copy Markdown
Contributor

@rdmueller — these findings from your re-review of #203 and a CodeRabbit catalog-sync check were missing and not addressed before #203/#388 merged.

What's fixed

From re-review of #203

  • POSIX sh (🟡 Medium): prompt-onboarding.sh#!/bin/sh + set -eu (no bash dep, no pipelines in script)
  • Feynman grammar (🟡 Low): "Explain concept simply" → "Explain concepts simply" in both catalog copies

Catalog sync (🟠 Major — CodeRabbit check)

references/catalog.md was missing individual entries for anchors that exist as files in docs/anchors/:

  • 23 individual GoF patterns (Abstract Factory, Builder, Factory Method, Prototype, Singleton, Adapter, Bridge, Composite, Decorator, Facade, Flyweight, Proxy, Chain of Responsibility, Command, Interpreter, Iterator, Mediator, Memento, Observer, State, Strategy, Template Method, Visitor)
  • 5 SOLID sub-principles promoted from #### to ### level (SRP, OCP, LSP, ISP, DIP)
  • 5 test double variants (Dummy, Stub, Spy, Mock, Fake)

Note: Many other "missing" entries in the CodeRabbit report are slug-comparison false positives — entries that exist in the catalog with parenthetical subtitles (e.g. "Five Whys (Ohno)" vs file slug five-whys). These are intentional.

npm audit (🔴 High CI failure)

Test plan

  • dash plugins/semantic-anchors/scripts/prompt-onboarding.sh exits 0
  • Grammar fix confirmed in both skill/ and plugins/ catalog copies
  • npm audit --audit-level=high → 0 vulnerabilities

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Dokumentation
    • Umfangreiche Erweiterung und Umstrukturierung der Referenzinhalte: Test Doubles (5 Typen), SOLID-Prinzipien, GoF‑Muster und erweiterte Themenkategorien; diverse Textverbesserungen und Klarstellungen.
  • Chores
    • Shell‑Skript Kompatibilität verbessert.
    • Paketkonfiguration: zusätzliche Abhängigkeits‑Constraint ergänzt.

@coderabbitai

coderabbitai Bot commented Apr 6, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 18a92559-5a14-41c7-9cf1-59303a683b8d

📥 Commits

Reviewing files that changed from the base of the PR and between 12d34c9 and b5418df.

⛔ Files ignored due to path filters (1)
  • website/package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (1)
  • plugins/semantic-anchors/skills/semantic-anchor-translator/SKILL.md

Walkthrough

Shebang und Shell-Flags in einem Onboarding-Skript reduziert; umfangreiche Umstrukturierung und Erweiterung zweier semantic-anchor-Katalogdokumente (Test-Doubles, SOLID, GoF-Patterns); website/package.json-overrides um tmp >=0.2.4 erweitert.

Changes

Cohort / File(s) Summary
Shell-Skript
plugins/semantic-anchors/scripts/prompt-onboarding.sh
Shebang von #!/bin/bash#!/bin/sh geändert; set -euo pipefailset -eu (Entfernung von pipefail). Keine weiteren Logik- oder API-Änderungen.
Katalog-Dokumentation (Plugin & Skill)
plugins/semantic-anchors/skills/semantic-anchor-translator/references/catalog.md, skill/semantic-anchor-translator/references/catalog.md
„Test Double (Meszaros)“ in separate Subsections (Dummy, Stub, Spy, Mock, Fake) umstrukturiert; SOLID-Prinzipien zu ###-Headings gehoben und „Also known as“-Bullets hinzugefügt; GoF-Patterns in individuelle ### GoF-<Pattern> Pattern-Abschnitte überführt; kleine Textänderung bei Feynman Technique.
SKILL-Metadaten
plugins/semantic-anchors/skills/semantic-anchor-translator/SKILL.md
Erweiterte SKILL-Beschreibung auf „120+ semantic anchors“, Kategorien und Quick-Index überarbeitet und zahlreiche neue Anchor-Begriffe hinzugefügt.
Website package.json
website/package.json
overrides erweitert: neues Eintrag tmp mit Constraint >=0.2.4 hinzugefügt; bestehende minimatch/cookie-Overrides unverändert.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 Minuten

Possibly related PRs

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Der PR-Titel beschreibt die Hauptänderungen des Changesets korrekt: POSIX-Shell-Kompatibilität (#!/bin/sh, set -eu) und Grammatikkorrektur (Feynman-Technik).
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@skill/semantic-anchor-translator/references/catalog.md`:
- Around line 226-229: Die Katalogdatei references/catalog.md ist nicht
vollständig mit docs/anchors/ synchronisiert (nur 92/123 Basisanker erfasst);
update references/catalog.md so that every anchor file in docs/anchors/ is
represented (total 123 unique base anchors), add the missing entries such as all
GoF-Patterns variants, SOLID-Prinzipien, Architecture Patterns (Hexagonal,
Event-Driven, Vertical Slice), Domain-Driven Design, Five Whys, Chain of
Thought, Test-Double-Varianten, and correct the "Feynman Technique" wording if
needed; ensure entries are unique, follow the existing catalog heading format
(e.g., the "### Feynman Technique" block) and regenerate or run any sync
script/test that enforces "references/catalog.md: Muss synchron mit
docs/anchors/ bleiben" to verify counts match.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 9f790870-12c3-4205-ae04-53992c7e7300

📥 Commits

Reviewing files that changed from the base of the PR and between 9ce2102 and f95a9ee.

📒 Files selected for processing (3)
  • plugins/semantic-anchors/scripts/prompt-onboarding.sh
  • plugins/semantic-anchors/skills/semantic-anchor-translator/references/catalog.md
  • skill/semantic-anchor-translator/references/catalog.md

Comment thread skill/semantic-anchor-translator/references/catalog.md
cpoepke and others added 2 commits April 6, 2026 23:05
- prompt-onboarding.sh: #!/bin/bash + pipefail → #!/bin/sh + set -eu
- catalog.md: "Explain concept simply" → "Explain concepts simply"

Addresses review findings from PR LLM-Coding#203.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Catalog (skill/ + synced plugins/):
- Add individual ### entries for all 23 GoF patterns (Abstract Factory,
  Builder, Factory Method, Prototype, Singleton, Adapter, Bridge, Composite,
  Decorator, Facade, Flyweight, Proxy, Chain of Responsibility, Command,
  Interpreter, Iterator, Mediator, Memento, Observer, State, Strategy,
  Template Method, Visitor)
- Promote SOLID sub-principles from #### to ### level (SRP, OCP, LSP, ISP, DIP)
- Add individual ### entries for all 5 test double variants
  (Dummy, Stub, Spy, Mock, Fake)

npm audit (website/):
- Run npm audit fix (resolved high-severity lodash/lodash-es vulnerabilities)
- Add tmp>=0.2.4 override (fixes GHSA-52f5-9888-hmc6 symlink write in @lhci/cli)
- Result: 0 vulnerabilities

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cpoepke cpoepke force-pushed the fix/posix-sh-and-feynman-grammar branch from 74062e5 to 12d34c9 Compare April 6, 2026 21:06
Fixes GHSA-4w7w-66w2-5vf9, GHSA-v2wj-q39q-566r, GHSA-p9ff-h696-f583
(path traversal in .map handling, server.fs.deny bypass, arbitrary
file read via WebSocket dev server).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@rdmueller rdmueller merged commit f27fe15 into LLM-Coding:main Apr 6, 2026
7 checks passed
@cpoepke cpoepke deleted the fix/posix-sh-and-feynman-grammar branch April 6, 2026 22:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants