@esoteric-logic/praxis-harness 2.3.1 → 2.4.0

package/base/CLAUDE.md

@@ -103,6 +103,10 @@ Missing servers are non-blocking — features degrade gracefully.
    - Git operation → `~/.claude/rules/git-workflow.md`
    - Client-facing writing → auto-loaded by `communication-standards` skill
    - Architecture/specs → auto-loaded by `architecture-patterns` skill
+5. Quality re-anchor: read most recent `compact-checkpoint.md` → check the Quality State section.
+   - If lint findings existed before compaction: re-run `golangci-lint run`, confirm status.
+   - If tests were failing before compaction: re-run test command, confirm status.
+   - Do NOT assume pre-compaction state is current. Always re-run fresh.
 
 ## Core Anti-Patterns (NEVER)
 - Silently swallow errors or use empty catch blocks

package/base/configs/linters/.editorconfig

@@ -0,0 +1,29 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{yml,yaml,json,tf,tfvars,md,toml,bicep}]
+indent_style = space
+indent_size = 2
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.go]
+indent_style = tab
+
+[Makefile]
+indent_style = tab
+
+[*.{sh,bash}]
+indent_style = space
+indent_size = 2
+
+[*.ps1]
+indent_style = space
+indent_size = 4

package/base/configs/linters/.golangci.yml

@@ -0,0 +1,63 @@
+run:
+  timeout: 3m
+  modules-download-mode: readonly
+
+linters:
+  enable:
+    # Error handling
+    - errcheck
+    - errchkjson
+    - nilerr
+    - wrapcheck
+    - errorlint
+    # Logic & correctness
+    - govet
+    - staticcheck
+    - exhaustive
+    - nilnil
+    - copyloopvar
+    - bodyclose
+    - sqlclosecheck
+    # Security
+    - gosec
+    # Maintainability
+    - dupl
+    - goconst
+    - funlen
+    - gocognit
+    - unused
+    - ineffassign
+    - unconvert
+    - misspell
+    - goimports
+    - gosimple
+    - revive
+  disable:
+    - depguard
+
+linters-settings:
+  funlen:
+    lines: 60
+    statements: 40
+  gocognit:
+    min-complexity: 20
+  dupl:
+    threshold: 100
+  goconst:
+    min-len: 3
+    min-occurrences: 3
+  errcheck:
+    check-type-assertions: true
+  revive:
+    rules:
+      - name: exported
+        disabled: false
+      - name: unexported-return
+        disabled: false
+      - name: blank-imports
+        disabled: false
+
+issues:
+  max-issues-per-linter: 50
+  max-same-issues: 5
+  exclude-use-default: false

package/base/configs/linters/.hadolint.yaml

@@ -0,0 +1,7 @@
+ignored:
+  - DL3003
+trustedRegistries:
+  - docker.io
+  - mcr.microsoft.com
+  - ghcr.io
+strict-labels: true

package/base/configs/linters/.shellcheckrc

@@ -0,0 +1,4 @@
+shell=bash
+enable=all
+# Suppress "not following sourced file" in hook context
+disable=SC1091

package/base/configs/linters/.tflint.hcl

@@ -0,0 +1,30 @@
+plugin "azurerm" {
+  enabled = true
+  version = "0.27.0"
+  source  = "github.com/terraform-linters/tflint-ruleset-azurerm"
+}
+
+rule "terraform_naming_convention" {
+  enabled = true
+  format  = "snake_case"
+}
+
+rule "terraform_documented_variables" {
+  enabled = true
+}
+
+rule "terraform_documented_outputs" {
+  enabled = true
+}
+
+rule "terraform_unused_declarations" {
+  enabled = true
+}
+
+rule "terraform_typed_variables" {
+  enabled = true
+}
+
+rule "terraform_standard_module_structure" {
+  enabled = true
+}

package/base/configs/linters/commitlint.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [2, 'always', ['feat', 'fix', 'refactor', 'test', 'docs', 'chore', 'ci', 'perf', 'style', 'build', 'revert']],
+    'scope-empty': [1, 'never'],
+    'subject-max-length': [2, 'always', 72],
+    'body-max-line-length': [2, 'always', 100],
+    'subject-case': [2, 'always', 'lower-case'],
+  }
+};

package/base/configs/vale/.vale.ini

@@ -0,0 +1,16 @@
+StylesPath = .vale-styles
+MinAlertLevel = suggestion
+
+Packages = Microsoft, write-good, Readability
+
+# Full suite on Markdown
+[*.md]
+BasedOnStyles = Praxis, Microsoft, write-good, Readability
+
+# Comment-only scanning on code files
+[*.{go,tf,sh,ps1}]
+BasedOnStyles = Praxis
+
+# Praxis rules only on YAML
+[*.{yml,yaml}]
+BasedOnStyles = Praxis

package/base/configs/vale/Praxis/AISlop.yml

@@ -0,0 +1,90 @@
+extends: substitution
+message: "AI vocabulary detected: '%s' — rephrase in plain language."
+level: warning
+ignorecase: true
+swap:
+  delve: "examine, explore, investigate"
+  tapestry: "combination, mix"
+  multifaceted: "complex, varied"
+  leverage: "use"
+  paradigm: "model, approach"
+  synergy: "collaboration, combination"
+  holistic: "complete, whole"
+  robust: "strong, reliable"
+  seamless: "smooth"
+  cutting-edge: "modern, latest"
+  game-changer: "improvement, breakthrough"
+  deep dive: "detailed look, analysis"
+  unpack: "explain, examine"
+  landscape: "field, area, environment"
+  ecosystem: "system, environment"
+  streamline: "simplify"
+  spearhead: "lead"
+  groundbreaking: "new, innovative"
+  transformative: "significant"
+  empower: "enable, help"
+  reimagine: "rethink, redesign"
+  cornerstone: "foundation, basis"
+  pivotal: "important, key"
+  catalyst: "trigger, cause"
+  navigate: "manage, handle"
+  harness: "use"
+  unlock: "enable, reveal"
+  bolster: "strengthen, support"
+  underscore: "highlight, emphasize"
+  illuminate: "explain, clarify"
+  forge: "build, create"
+  foster: "encourage, develop"
+  cultivate: "develop, build"
+  paramount: "important, critical"
+  meticulous: "careful, thorough"
+  intricate: "complex, detailed"
+  nuanced: "subtle"
+  comprehensive: "complete, thorough"
+  invaluable: "very useful, essential"
+  instrumental: "important, helpful"
+  embark: "start, begin"
+  endeavor: "effort, attempt"
+  realm: "area, field"
+  facet: "aspect, part"
+  Moreover: "Also, Additionally"
+  Furthermore: "Also"
+  Notably: "Note that"
+  Importantly: "Note"
+  Essentially: "(omit or rewrite)"
+  Fundamentally: "(omit or rewrite)"
+  Undoubtedly: "(omit or rewrite)"
+  Interestingly: "(omit or rewrite)"
+  testament: "proof, evidence"
+  beacon: "example, guide"
+  resonate: "connect, appeal"
+  bespoke: "custom"
+  elevate: "improve, raise"
+  amplify: "increase, strengthen"
+  augment: "add to, supplement"
+  myriad: "many"
+  plethora: "many, excess"
+  burgeoning: "growing"
+  nascent: "new, early"
+  advent: "arrival, start"
+  proliferation: "spread, growth"
+  propel: "drive, push"
+  overarching: "main, overall"
+  dovetail: "fit, align"
+  tailored: "custom, specific"
+  juxtapose: "compare, contrast"
+  dichotomy: "contrast, split"
+  eponymous: "named after"
+  erstwhile: "former"
+  zeitgeist: "spirit of the time"
+  ethos: "values, character"
+  nexus: "connection, link"
+  crucible: "test, trial"
+  vanguard: "forefront, leading edge"
+  linchpin: "key element"
+  bedrock: "foundation"
+  scaffolding: "framework, structure"
+  underpinning: "basis, foundation"
+  bulwark: "defense, safeguard"
+  bastion: "stronghold"
+  harbinger: "sign, indicator"

package/base/configs/vale/Praxis/CopulaAvoidance.yml

@@ -0,0 +1,22 @@
+extends: existence
+message: "Inflated copula: '%s' — simplify."
+level: suggestion
+ignorecase: true
+tokens:
+  - "serves as a"
+  - "acts as a"
+  - "functions as a"
+  - "plays a pivotal role"
+  - "plays a crucial role"
+  - "plays a vital role"
+  - "plays a key role"
+  - "plays an important role"
+  - "boasts a"
+  - "represents a"
+  - "constitutes a"
+  - "comprises a"
+  - "stands as a"
+  - "remains a"
+  - "proves to be"
+  - "turns out to be"
+  - "happens to be"

package/base/configs/vale/Praxis/ElegantVariation.yml

@@ -0,0 +1,14 @@
+extends: existence
+message: "Elegant variation: '%s' — use the plain term."
+level: suggestion
+ignorecase: true
+tokens:
+  - "the aforementioned"
+  - "the above-mentioned"
+  - "the previously mentioned"
+  - "this individual"
+  - "said individual"
+  - "the eponymous"
+  - "this entity"
+  - "the latter"
+  - "the former"

package/base/configs/vale/Praxis/Hedging.yml

@@ -0,0 +1,22 @@
+extends: existence
+message: "Hedging detected: '%s' — commit to a position or remove."
+level: suggestion
+ignorecase: true
+tokens:
+  - "it could potentially"
+  - "it might potentially"
+  - "it may potentially"
+  - "arguably"
+  - "it remains to be seen"
+  - "only time will tell"
+  - "it is not unreasonable to"
+  - "one could argue"
+  - "some might say"
+  - "it would not be wrong to"
+  - "to some extent"
+  - "to a certain degree"
+  - "in some ways"
+  - "more or less"
+  - "for the most part"
+  - "by and large"
+  - "generally speaking"

package/base/configs/vale/Praxis/NaturalVoice.yml

@@ -0,0 +1,85 @@
+extends: existence
+message: "AI phrasing detected: '%s' — rewrite in your natural voice."
+level: warning
+ignorecase: true
+tokens:
+  # Exhausted openers
+  - "In today's"
+  - "In the realm of"
+  - "In an era of"
+  - "In the world of"
+  - "When it comes to"
+  - "It's worth noting that"
+  - "It's important to note"
+  - "It bears mentioning"
+  - "It goes without saying"
+  - "Needless to say"
+  - "As we all know"
+  - "At the end of the day"
+  - "Let's face it"
+  - "The fact of the matter is"
+  - "The bottom line is"
+  - "The reality is"
+  - "The truth is"
+  - "The thing is"
+  # Sycophantic filler
+  - "That's a great question"
+  - "That's an excellent question"
+  - "Great question"
+  - "Excellent question"
+  - "What a great"
+  - "Absolutely"
+  - "That's a fantastic"
+  # Filler transitions
+  - "With that being said"
+  - "Having said that"
+  - "That said"
+  - "On that note"
+  - "Moving forward"
+  - "Going forward"
+  - "Looking ahead"
+  - "To that end"
+  - "In light of this"
+  - "In light of the above"
+  - "With this in mind"
+  - "Bearing this in mind"
+  - "Taking this into account"
+  - "With the above in mind"
+  # Performative exploration
+  - "Let's explore"
+  - "Let's delve"
+  - "Let's unpack"
+  - "Let's dive into"
+  - "Let's take a closer look"
+  - "Let's examine"
+  - "shall we explore"
+  - "shall we delve"
+  # Filler conclusions
+  - "In conclusion"
+  - "To sum up"
+  - "To summarize"
+  - "In summary"
+  - "All in all"
+  - "By and large"
+  - "On the whole"
+  - "When all is said and done"
+  # Performative framing
+  - "It's crucial to"
+  - "It's essential to"
+  - "It's vital to"
+  - "It's imperative to"
+  - "play a crucial role"
+  - "play a vital role"
+  - "play a pivotal role"
+  - "play an important role"
+  - "serves as a testament"
+  - "serves as a reminder"
+  - "serves as a beacon"
+  # Unnecessary hedging stacks
+  - "might potentially"
+  - "could potentially"
+  - "may potentially"
+  - "would potentially"
+  - "seems to suggest"
+  - "appears to indicate"
+  - "tends to suggest"

package/base/configs/vale/Praxis/Precision.yml

@@ -0,0 +1,60 @@
+extends: existence
+message: "Vague word: '%s' — be specific."
+level: suggestion
+ignorecase: true
+tokens:
+  - "various"
+  - "several"
+  - "numerous"
+  - "a number of"
+  - "a wide range of"
+  - "a broad range of"
+  - "a variety of"
+  - "wide array of"
+  - "enables"
+  - "facilitates"
+  - "utilizes"
+  - "utilize"
+  - "leverages"
+  - "comprehensive solution"
+  - "innovative solution"
+  - "scalable solution"
+  - "world-class"
+  - "best-in-class"
+  - "state-of-the-art"
+  - "end-to-end"
+  - "full-stack"
+  - "next-generation"
+  - "enterprise-grade"
+  - "mission-critical"
+  - "production-ready"
+  - "battle-tested"
+  - "highly scalable"
+  - "highly available"
+  - "highly performant"
+  - "best practices"
+  - "industry standard"
+  - "gold standard"
+  - "significant"
+  - "meaningful"
+  - "impactful"
+  - "thoughtful"
+  - "intentional"
+  - "robust"
+  - "performant"
+  - "elegant"
+  - "powerful"
+  - "flexible"
+  - "extensible"
+  - "modular"
+  - "opinionated"
+  - "batteries-included"
+  - "turnkey"
+  - "frictionless"
+  - "effortless"
+  - "painless"
+  - "blazing fast"
+  - "lightning fast"
+  - "blazingly fast"
+  - "extremely fast"
+  - "incredibly fast"

package/base/hooks/file-guard.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# file-guard.sh — PreToolUse hook
+# Blocks writes to protected paths. Exit 2 = hard block.
+set -euo pipefail
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path // empty')
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# Default protected patterns
+PROTECTED_PATTERNS=(
+  "go\.sum$"
+  "go\.mod$"
+  "\.lock$"
+  "\.lock\.json$"
+  "\.github/workflows/"
+  "^\.claude/"
+)
+
+# Check against protected patterns
+for pattern in "${PROTECTED_PATTERNS[@]}"; do
+  if echo "$FILE_PATH" | grep -qE "$pattern"; then
+    echo "BLOCKED: $FILE_PATH is protected. Explain the intended change before proceeding."
+    exit 2
+  fi
+done
+
+# Check project-level protected files from CLAUDE.md if it exists
+if [ -f "CLAUDE.md" ]; then
+  # Extract paths from ## Protected Files section
+  IN_SECTION=false
+  while IFS= read -r line; do
+    if echo "$line" | grep -qE "^## Protected Files"; then
+      IN_SECTION=true
+      continue
+    fi
+    if $IN_SECTION && echo "$line" | grep -qE "^##"; then
+      break
+    fi
+    if $IN_SECTION && echo "$line" | grep -qE "^- "; then
+      PROTECTED=$(echo "$line" | sed 's/^- //' | sed 's/ *#.*//' | xargs)
+      if [ -n "$PROTECTED" ] && echo "$FILE_PATH" | grep -qE "$PROTECTED"; then
+        echo "BLOCKED: $FILE_PATH matches project-protected pattern '$PROTECTED'. Explain the intended change."
+        exit 2
+      fi
+    fi
+  done < CLAUDE.md
+fi
+
+exit 0

package/base/hooks/post-session-lint.sh

@@ -3,6 +3,11 @@
 # Always exits 0 (never blocks session end).
 set -uo pipefail
 
+INPUT=$(cat)
+if [ "$(echo "$INPUT" | jq -r '.stop_hook_active // false')" = "true" ]; then
+  exit 0
+fi
+
 CONFIG_FILE="$HOME/.claude/praxis.config.json"
 
 # Find project CLAUDE.md by walking up from CWD