Skip to content

Plan: Adopt shared df12-lints plugin - #17

Draft
lodyai[bot] wants to merge 2 commits into
mainfrom
docs/adopt-shared-df12-lints
Draft

Plan: Adopt shared df12-lints plugin#17
lodyai[bot] wants to merge 2 commits into
mainfrom
docs/adopt-shared-df12-lints

Conversation

@lodyai

@lodyai lodyai Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a DRAFT ExecPlan, docs/execplans/use-shared-df12-lints.md, planning the
replacement of the in-repo oxlint plugin (tools/oxlint-plugin-df12) with the
shared df12-lints package pinned at
fe04adc80cfd8d3fc3df987f8022863a2f27a2a0, consumed via the
df12-lints/oxlint-plugin export.

The plan preserves the four df12/ rules and the 83-entry
.jsdoc-baseline.json suppressions, gating the switch on a before/after
oxlint output diff. It includes the mandatory living sections and a list of
deployment concerns and behavioural discrepancies to file upstream against
df12-lints.

This PR is plan-only; no implementation has been performed yet (awaiting
approval per the ExecPlan approval gate).

Upstream discrepancies identified (for filing against df12-lints)

  • Broken . export in git installs (dist/ is git-ignored, no prepare build script)
  • No LICENSE file despite package.json declaring ISC
  • private: true / unpublished — forces commit-pinned git installs
  • No files whitelist in package.json
  • Baseline caching removed; loadBaseline() now returns a result object, not a Set
  • Working-directory resolution changed from process.cwd() to context.cwd
  • Malformed .jsdoc-baseline.json now emits a diagnostic instead of being swallowed
  • complex-conditional maxLogicalOperators is now validated/coerced

Incidental fix

Wraps the pre-existing docs/mocking-services-...md guidance document to 80
columns so the repo's local make markdownlint gate passes. The change is
content-preserving (whitespace-insensitive token stream identical to before);
only over-length prose paragraphs were reflowed.

Validation

  • make markdownlint — 0 errors across 16 files
  • make nixie — all diagrams validated

🤖 Generated with Claude Code

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Sorry @LodyAI[bot], you have reached your weekly rate limit of 2500000 diff characters.

Please try again later or upgrade to continue using Sourcery

@coderabbitai

coderabbitai Bot commented Jun 8, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f36da7f7-61a8-4a4e-a486-e39ddab27161

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/adopt-shared-df12-lints

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

codescene-delta-analysis[bot]

This comment was marked as outdated.

@leynos leynos changed the title Add ExecPlan for adopting shared df12-lints plugin Plan: Adopt shared df12-lints plugin Jun 15, 2026
leynos and others added 2 commits June 16, 2026 01:34
Plan the replacement of the in-repo oxlint plugin
(tools/oxlint-plugin-df12) with the shared df12-lints package pinned at
fe04adc, consuming it through the df12-lints/oxlint-plugin export. The
plan preserves the four df12/ rules and the .jsdoc-baseline.json
suppressions, gating the switch on a before/after oxlint output diff.

It also records the deployment concerns and behavioural discrepancies in
the shared package (broken "." export in git installs, missing LICENSE,
unpublished/private package, removed baseline caching, process.cwd vs
context.cwd resolution, new baseline diagnostics, and maxLogicalOperators
validation) so they can be filed as upstream bugs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The guidance document carried 77 unwrapped prose paragraphs that failed
the repository's markdownlint MD013 line-length gate (the convention every
other doc follows). markdownlint is a local-only gate, not part of CI's
`make all`, which is how the unwrapped file landed.

Reflow only the over-length paragraph lines to 80 columns, leaving code
fences, tables, headings, and lists untouched and keeping long tokens
unbroken. The change is content-preserving: the whitespace-insensitive
token stream is identical to the previous version.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lodyai
lodyai Bot force-pushed the docs/adopt-shared-df12-lints branch from 4e2062e to 7aac523 Compare June 15, 2026 23:36
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.

1 participant