@sibyllinesoft/arbiter 0.1.0

package/dist/templates/plopfiles/_modules/quality/biome/templates/biome.json.hbs

@@ -0,0 +1,126 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.0/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "complexity": {
+        "noBannedTypes": "error",
+        "noExcessiveCognitiveComplexity": {
+          "level": "warn",
+          "options": {
+            "maxAllowedComplexity": 15
+          }
+        },
+        "noForEach": "warn",
+        "noUselessTypeConstraint": "error"
+      },
+      "correctness": {
+        "noUnusedImports": "error",
+        "noUnusedVariables": "error",
+        "useExhaustiveDependencies": "warn",
+        "useHookAtTopLevel": "error"
+      },
+      "performance": {
+        "noAccumulatingSpread": "warn",
+        "noDelete": "warn"
+      },
+      "style": {
+        "noNonNullAssertion": "warn",
+        "useBlockStatements": "error",
+        "useCollapsedElseIf": "error",
+        "useConsistentArrayType": {
+          "level": "error",
+          "options": {
+            "syntax": "shorthand"
+          }
+        },
+        "useConst": "error",
+        "useExportType": "error",
+        "useImportType": "error",
+        "useNamingConvention": {
+          "level": "warn",
+          "options": {
+            "strictCase": false,
+            "conventions": [
+              {
+                "selector": { "kind": "function" },
+                "formats": ["camelCase", "PascalCase"]
+              },
+              {
+                "selector": { "kind": "variable" },
+                "formats": ["camelCase", "PascalCase", "CONSTANT_CASE"]
+              },
+              {
+                "selector": { "kind": "typeLike" },
+                "formats": ["PascalCase"]
+              }
+            ]
+          }
+        },
+        "useShorthandFunctionType": "error",
+        "useSingleVarDeclarator": "error",
+        "useTemplate": "error"
+      },
+      "suspicious": {
+        "noArrayIndexKey": "warn",
+        "noAssignInExpressions": "error",
+        "noConsoleLog": "warn",
+        "noDoubleEquals": "error",
+        "noExplicitAny": "warn",
+        "noImplicitAnyLet": "error"
+      },
+      "nursery": {
+        "useSortedClasses": {
+          "level": "warn",
+          "options": {}
+        }
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100,
+    "lineEnding": "lf"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "jsxQuoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "all",
+      "arrowParentheses": "always"
+    }
+  },
+  "json": {
+    "formatter": {
+      "indentWidth": 2,
+      "lineWidth": 100
+    }
+  },
+  "files": {
+    "ignore": [
+      "node_modules",
+      "dist",
+      "build",
+      ".next",
+      ".nuxt",
+      "coverage",
+      "*.min.js",
+      "*.d.ts",
+      "package-lock.json",
+      "pnpm-lock.yaml",
+      "bun.lockb"
+    ]
+  },
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  }
+}

package/dist/templates/plopfiles/_modules/quality/clippy/module.js

@@ -0,0 +1,40 @@
+/**
+ * Clippy & Rustfmt Module
+ *
+ * Sets up Clippy linting and Rustfmt formatting for Rust projects.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "addMany",
+      destination: `{{projectDir}}`,
+      base: templatesDir,
+      templateFiles: `${templatesDir}/**/*.hbs`,
+      stripExtensions: ["hbs"],
+      data,
+    },
+  ];
+}
+
+export const description = "Clippy & Rustfmt - Rust linting and formatting";
+
+export const dependencies = {};
+
+export const devDependencies = {};
+
+export const scripts = {
+  "lint:rust": "cargo clippy --all-targets --all-features -- -D warnings",
+  "lint:rust:fix": "cargo clippy --fix --allow-dirty --allow-staged",
+  "format:rust": "cargo fmt",
+  "format:rust:check": "cargo fmt -- --check",
+  "check:rust": "cargo check --all-targets --all-features",
+};
+
+export const envVars = {};

package/dist/templates/plopfiles/_modules/quality/clippy/templates/clippy.toml.hbs

@@ -0,0 +1,29 @@
+# Clippy configuration
+# https://doc.rust-lang.org/clippy/configuration.html
+
+# Cognitive complexity threshold
+cognitive-complexity-threshold = 25
+
+# Maximum number of lines in a function
+too-many-lines-threshold = 100
+
+# Allowed wildcard imports
+allowed-wildcard-imports = []
+
+# Minimum amount of lines to match for "large types"
+large-error-threshold = 128
+
+# Maximum bytes for small values (stack)
+trivial-copy-size-limit = 16
+
+# Upper bound for large arrays
+array-size-threshold = 512000
+
+# Allowed duplicate modules (none by default)
+allowed-duplicate-crates = []
+
+# Third-party crates organization names
+third-party = ["{{snakeCase name}}"]
+
+# Standard library configuration
+msrv = "1.75"

package/dist/templates/plopfiles/_modules/quality/clippy/templates/rustfmt.toml.hbs

@@ -0,0 +1,44 @@
+# Rustfmt configuration
+# https://rust-lang.github.io/rustfmt/
+
+edition = "2021"
+max_width = 100
+hard_tabs = false
+tab_spaces = 4
+newline_style = "Unix"
+
+# Imports
+imports_granularity = "Crate"
+group_imports = "StdExternalCrate"
+reorder_imports = true
+reorder_modules = true
+
+# Items
+reorder_impl_items = true
+use_field_init_shorthand = true
+use_try_shorthand = true
+
+# Formatting
+format_code_in_doc_comments = true
+format_macro_matchers = true
+format_strings = true
+wrap_comments = true
+comment_width = 100
+
+# Struct/Enum
+struct_lit_single_line = true
+enum_discrim_align_threshold = 20
+
+# Functions
+fn_single_line = false
+fn_args_layout = "Tall"
+
+# Control flow
+match_arm_blocks = true
+match_arm_leading_pipes = "Never"
+match_block_trailing_comma = true
+force_multiline_blocks = false
+
+# Misc
+normalize_comments = true
+normalize_doc_attributes = true

package/dist/templates/plopfiles/_modules/quality/golangci-lint/module.js

@@ -0,0 +1,40 @@
+/**
+ * golangci-lint Module
+ *
+ * Sets up golangci-lint for Go projects.
+ * The most comprehensive linter aggregator for Go.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "addMany",
+      destination: `{{projectDir}}`,
+      base: templatesDir,
+      templateFiles: `${templatesDir}/**/*.hbs`,
+      stripExtensions: ["hbs"],
+      data,
+    },
+  ];
+}
+
+export const description = "golangci-lint - Fast Go linter aggregator";
+
+export const dependencies = {};
+
+export const devDependencies = {};
+
+export const scripts = {
+  "lint:go": "golangci-lint run",
+  "lint:go:fix": "golangci-lint run --fix",
+  "format:go": "gofmt -s -w .",
+  "format:go:check": "test -z $(gofmt -l .)",
+};
+
+export const envVars = {};

package/dist/templates/plopfiles/_modules/quality/golangci-lint/templates/.golangci.yml.hbs

@@ -0,0 +1,199 @@
+# golangci-lint configuration
+# https://golangci-lint.run/usage/configuration/
+
+run:
+  timeout: 5m
+  issues-exit-code: 1
+  tests: true
+  build-tags: []
+  modules-download-mode: readonly
+
+output:
+  formats:
+    - format: colored-line-number
+  print-issued-lines: true
+  print-linter-name: true
+  sort-results: true
+
+linters-settings:
+  errcheck:
+    check-type-assertions: true
+    check-blank: true
+
+  govet:
+    enable-all: true
+    disable:
+      - fieldalignment
+
+  gocyclo:
+    min-complexity: 15
+
+  gocognit:
+    min-complexity: 20
+
+  dupl:
+    threshold: 100
+
+  goconst:
+    min-len: 3
+    min-occurrences: 3
+
+  gocritic:
+    enabled-tags:
+      - diagnostic
+      - experimental
+      - opinionated
+      - performance
+      - style
+    disabled-checks:
+      - dupImport
+      - ifElseChain
+      - octalLiteral
+      - whyNoLint
+
+  gofmt:
+    simplify: true
+
+  goimports:
+    local-prefixes: github.com/{{author}}/{{name}}
+
+  revive:
+    ignore-generated-header: true
+    severity: warning
+    rules:
+      - name: blank-imports
+      - name: context-as-argument
+      - name: context-keys-type
+      - name: dot-imports
+      - name: error-return
+      - name: error-strings
+      - name: error-naming
+      - name: exported
+      - name: increment-decrement
+      - name: var-naming
+      - name: package-comments
+      - name: range
+      - name: receiver-naming
+      - name: time-naming
+      - name: unexported-return
+      - name: indent-error-flow
+      - name: errorf
+
+  staticcheck:
+    checks: ["all"]
+
+  stylecheck:
+    checks: ["all", "-ST1000", "-ST1003"]
+
+  gosec:
+    excludes:
+      - G104
+    config:
+      global:
+        audit: true
+
+  nakedret:
+    max-func-lines: 30
+
+  prealloc:
+    simple: true
+    range-loops: true
+    for-loops: true
+
+  nolintlint:
+    allow-unused: false
+    allow-no-explanation: []
+    require-explanation: true
+    require-specific: true
+
+  misspell:
+    locale: US
+
+  lll:
+    line-length: 120
+    tab-width: 4
+
+  godot:
+    scope: declarations
+    capital: true
+
+  godox:
+    keywords:
+      - TODO
+      - BUG
+      - FIXME
+      - HACK
+
+linters:
+  disable-all: true
+  enable:
+    # Default linters
+    - errcheck
+    - gosimple
+    - govet
+    - ineffassign
+    - staticcheck
+    - unused
+    # Additional linters
+    - asasalint
+    - bidichk
+    - bodyclose
+    - contextcheck
+    - copyloopvar
+    - dupl
+    - durationcheck
+    - errname
+    - errorlint
+    - exhaustive
+    - gochecknoinits
+    - gocognit
+    - goconst
+    - gocritic
+    - gocyclo
+    - godot
+    - godox
+    - gofmt
+    - goimports
+    - gosec
+    - lll
+    - misspell
+    - nakedret
+    - nestif
+    - nilerr
+    - nilnil
+    - noctx
+    - nolintlint
+    - prealloc
+    - predeclared
+    - revive
+    - stylecheck
+    - tenv
+    - testableexamples
+    - thelper
+    - unconvert
+    - unparam
+    - usestdlibvars
+    - wastedassign
+    - whitespace
+
+issues:
+  exclude-rules:
+    # Exclude some linters from running on tests
+    - path: _test\.go
+      linters:
+        - dupl
+        - gosec
+        - gocyclo
+        - gocognit
+        - errcheck
+        - funlen
+
+    # Exclude some linters from running on main
+    - path: main\.go
+      linters:
+        - gochecknoinits
+
+  exclude-use-default: false
+  max-issues-per-linter: 0
+  max-same-issues: 0
+  new: false

package/dist/templates/plopfiles/_modules/quality/ruff/module.js

@@ -0,0 +1,43 @@
+/**
+ * Ruff Linting & Formatting Module
+ *
+ * Sets up Ruff for Python projects.
+ * Ruff is an extremely fast Python linter and formatter.
+ */
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templatesDir = resolve(__dirname, "templates");
+
+export default function (data) {
+  return [
+    {
+      type: "addMany",
+      destination: `{{projectDir}}`,
+      base: templatesDir,
+      templateFiles: `${templatesDir}/**/*.hbs`,
+      stripExtensions: ["hbs"],
+      data,
+    },
+  ];
+}
+
+export const description = "Ruff - Extremely fast Python linter and formatter";
+
+export const dependencies = {};
+
+export const devDependencies = {};
+
+export const scripts = {
+  "lint:python": "ruff check .",
+  "lint:python:fix": "ruff check --fix .",
+  "format:python": "ruff format .",
+  "format:python:check": "ruff format --check .",
+};
+
+export const envVars = {};
+
+// Python dev dependencies
+export const pythonDevDependencies = ["ruff>=0.8.0", "mypy>=1.13.0"];

package/dist/templates/plopfiles/_modules/quality/ruff/templates/mypy.ini.hbs

@@ -0,0 +1,48 @@
+[mypy]
+# Python version
+python_version = 3.12
+
+# Strict mode
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+
+# Disallow dynamic typing
+disallow_any_generics = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+
+# None/Optional handling
+strict_optional = true
+no_implicit_optional = true
+
+# Import discovery
+namespace_packages = true
+explicit_package_bases = true
+
+# Error output
+show_error_codes = true
+show_column_numbers = true
+show_error_context = true
+pretty = true
+
+# Plugins
+plugins = []
+
+# Ignore missing imports for third-party packages
+ignore_missing_imports = false
+
+# Per-module configuration
+[mypy-tests.*]
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+
+[mypy-conftest]
+disallow_untyped_defs = false

package/dist/templates/plopfiles/_modules/quality/ruff/templates/ruff.toml.hbs

@@ -0,0 +1,111 @@
+# Ruff configuration
+# https://docs.astral.sh/ruff/configuration/
+
+# Target Python version
+target-version = "py312"
+
+# Line length
+line-length = 100
+
+# Exclude paths
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+    "*.pyi",
+]
+
+[lint]
+# Enable rules
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # Pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "ARG",    # flake8-unused-arguments
+    "SIM",    # flake8-simplify
+    "TCH",    # flake8-type-checking
+    "PTH",    # flake8-use-pathlib
+    "ERA",    # eradicate (commented code)
+    "PL",     # Pylint
+    "RUF",    # Ruff-specific rules
+    "PERF",   # Performance
+    "FURB",   # Refurbishing
+    "LOG",    # Logging
+    "D",      # pydocstyle
+]
+
+# Ignore specific rules
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "D100",   # Missing docstring in public module
+    "D104",   # Missing docstring in public package
+    "D107",   # Missing docstring in __init__
+    "D203",   # 1 blank line required before class docstring
+    "D213",   # Multi-line docstring summary should start at the second line
+    "PLR0913", # Too many arguments to function call
+]
+
+# Allow autofix for all enabled rules
+fixable = ["ALL"]
+unfixable = []
+
+# Allow unused variables when underscore-prefixed
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[lint.per-file-ignores]
+# Tests can use magic values and assertions
+"tests/**/*" = ["PLR2004", "S101", "D"]
+"**/conftest.py" = ["D"]
+
+[lint.isort]
+known-first-party = ["{{snakeCase name}}"]
+force-single-line = false
+combine-as-imports = true
+
+[lint.pydocstyle]
+convention = "google"
+
+[lint.pylint]
+max-args = 8
+max-branches = 12
+max-returns = 6
+max-statements = 50
+
+[format]
+# Use double quotes
+quote-style = "double"
+
+# Indent with spaces
+indent-style = "space"
+
+# Respect magic trailing comma
+skip-magic-trailing-comma = false
+
+# Unix line endings
+line-ending = "lf"
+
+# Format docstrings
+docstring-code-format = true
+docstring-code-line-length = "dynamic"