initial commit

Author: veldica

.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish Package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+      
+      - name: Publish to NPM
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      
+      - name: Setup for GitHub Packages
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://npm.pkg.github.com'
+          scope: '@veldica'
+          
+      - name: Publish to GitHub Packages
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+.DS_Store
+*.log
+GEMINI.md
+.env
+.idea/
+.vscode/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+coverage/

CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Veldica
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,71 @@
+# @veldica/prose-linter
+
+A deterministic style-contract library and AI-writing style audit for high-quality prose.
+
+`@veldica/prose-linter` provides the engine for evaluating text against explicit structural targets (sentence length, lexical density, scannability) and identifies common "AI-style" markers. It is designed to be used programmatically in CLIs, editors, and agent feedback loops.
+
+## Features
+
+- **Deterministic Style Contracts**: Define targets for word counts, complexity, and structural variety.
+- **AI Marker Inventory**: Detect stock phrases, assistant residue, and repetitive structural patterns common in LLM output.
+- **Actionable Revision Levers**: Get prioritized advice on how to fix style violations.
+- **Readability Integration**: Built-in support for Gunning-Fog, Flesch-Kincaid, and more.
+
+## Installation
+
+```bash
+npm install @veldica/prose-linter
+```
+
+## API Usage
+
+### Linting Text
+
+The `lintText` function is the primary entry point for evaluating text against a profile.
+
+```typescript
+import { lintText } from '@veldica/prose-linter';
+
+const profile = {
+  targets: {
+    sentence_metrics: {
+      avg_words_per_sentence: { value: 20, operator: 'at_most' },
+      sentence_length_stddev: { value: 5, operator: 'at_least' }
+    }
+  },
+  track_ai_patterns: true
+};
+
+const result = lintText("Your prose goes here...", profile);
+
+console.log(result.summary.score); // Fit score out of 100
+console.log(result.violations);    // Array of failed CheckResults
+```
+
+### Inventory AI Markers
+
+Audit a document specifically for "AI-ish" patterns without full structural linting.
+
+```typescript
+import { inventoryMarkers } from '@veldica/prose-linter';
+
+const analysis = inventoryMarkers(text, { track_ai_patterns: true });
+
+console.log(analysis.style_band); // "low" | "moderate" | "high" | "very_high"
+console.log(analysis.matches);    // Array of matches with line/column locations
+```
+
+## Result Structure
+
+The `LintResult` object returned by `lintText` includes:
+
+- `summary`: High-level compliance numbers (score, counts).
+- `checks`: All checks performed (passed, failed, and skipped).
+- `violations`: Specifically failed checks.
+- `skipped_checks`: Checks that couldn't be run due to missing data.
+- `ai_analysis`: Detailed report on AI-style markers.
+- `revision_levers`: Ranked suggestions for improvement.
+
+## License
+
+MIT