@linxiraos/pi-stats 1.0.0

package/dist/types/user-metrics.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Behavioral metrics extracted from a single user message.
+ *
+ * Pure, side-effect free. Designed for batch use during session ingestion
+ * and standalone testing.
+ */
+export interface UserMessageMetrics {
+    /** Total characters of analyzed text. */
+    chars: number;
+    /** Whitespace-delimited word count. */
+    words: number;
+    /**
+     * Number of "yelling" sentences: sentences where more than half of the
+     * alphabetic characters are uppercase (and there are enough letters to
+     * make the ratio meaningful - short acronyms like "OK" don't count).
+     * A sentence also needs either two uppercase runs ("WHAT THE HELL") or
+     * one elongated run ("CMOOON") so a lone acronym/env var ("use JSON",
+     * "HOME=/tmp") doesn't register.
+     */
+    yelling: number;
+    /** Profanity hits (word-boundary, case-insensitive). */
+    profanity: number;
+    /**
+     * Catch-all "obviously upset" signal computed on a *prose-only* body
+     * (code fences, XML/HTML tags, URLs, file mentions, and quoted lines
+     * are stripped first; messages whose remaining prose is >=3 lines score
+     * zero because formatted prompts aren't tantrums).
+     *
+     * Sum of:
+     * - drama runs: 3+ `!` / `?` (with `1`-mishit fallout)
+     * - interjections, elongated where the short form is ambiguous:
+     *   `noooo`, `ahhh`, `ugh(h)`, `argh`, `grr`, `stooop`, `whyyy`,
+     *   `fuuu(ck)`, `wtfff`, `omggg`, `yesss`, `goddd`, `bruhh`
+     * - standalone `dude`
+     * - sad emoticons: `:(`, `;(`, `:-(((`
+     */
+    anguish: number;
+    /**
+     * Corrective negation: the user is telling us we got it wrong.
+     *
+     * Counted on the same prose-only body as {@link anguish}.
+     *
+     * - line-leading `nope` / `nah` / `nvm` / `wrong` / `incorrect`
+     *   (word-bounded, so `now`, `nobody`, `north` don't match)
+     * - line-leading `no` when used as an interjection - followed by
+     *   punctuation, end-of-text, or a discourse word (`no i meant`,
+     *   `no, wait`). Determiner `no` (`no extensions to the page`,
+     *   `no auto start`) doesn't count.
+     * - `that(?:'s)? not (what|right|it)` and `not what i (meant|asked|said|wanted)`
+     * - `makes (no|zero) sense`
+     */
+    negation: number;
+    /**
+     * The user is repeating themselves - strong signal the previous turn
+     * missed the ask. Counts hits for:
+     *
+     * - `i (meant|said|asked|told you|already (said|told|did|asked|wrote))`
+     * - `(like|as) i (said|told you|asked)`
+     * - `still (doesn't|isn't|not|broken|wrong|fails|failing|the same|same)`
+     *
+     * Bare `still` / `again` are too ambiguous to count alone (they show up
+     * in normal speech like "try again" or "still works").
+     */
+    repetition: number;
+    /**
+     * Direct second-person reproach pinned on the agent:
+     *
+     * - `you (didn't|did not|broke|missed|forgot|keep|always|never|still|ignored)`
+     * - `why (would|did) (you|u)`
+     * - sentence-leading `stop <verb>ing` imperatives
+     */
+    blame: number;
+}
+/**
+ * Compute behavioral metrics for a user message.
+ *
+ * `text` may be empty or whitespace; in that case every metric is 0.
+ */
+export declare function computeUserMessageMetrics(text: string): UserMessageMetrics;
+/** Empty metrics constant for callers that need a default. */
+export declare const EMPTY_USER_METRICS: UserMessageMetrics;

package/package.json

@@ -0,0 +1,94 @@
+{
+	"type": "module",
+	"name": "@linxiraos/pi-stats",
+	"version": "1.0.0",
+	"description": "Local observability dashboard for pi AI usage statistics",
+	"homepage": "https://linxira-os.github.io",
+	"author": "Can Boluk",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Linxira-OS/linxira-zeta.git",
+		"directory": "packages/stats"
+	},
+	"bugs": {
+		"url": "https://github.com/can1357/oh-my-pi/issues"
+	},
+	"keywords": [
+		"ai",
+		"observability",
+		"metrics",
+		"dashboard",
+		"llm",
+		"statistics"
+	],
+	"main": "./src/index.ts",
+	"types": "./dist/types/index.d.ts",
+	"bin": {
+		"omp-stats": "./src/index.ts"
+	},
+	"scripts": {
+		"gen:stats": "bun scripts/generate-client-bundle.ts --generate",
+		"gen:stats:reset": "bun scripts/generate-client-bundle.ts --reset",
+		"build": "bun run build.ts",
+		"dev": "bun run src/index.ts",
+		"check": "biome check . && bun run check:types",
+		"check:types": "tsgo -p tsconfig.json --noEmit && tsgo -p tsconfig.client.json --noEmit",
+		"lint": "biome lint .",
+		"fix": "biome check --write --unsafe .",
+		"fmt": "biome format --write ."
+	},
+	"dependencies": {
+		"@tailwindcss/node": "^4.3.2",
+		"chart.js": "^4.5.1",
+		"lucide-react": "^1.24.0",
+		"react": "19.2.7",
+		"react-chartjs-2": "^5.3.1",
+		"react-dom": "19.2.7",
+		"tailwindcss": "^4.3.2",
+		"@linxiraos/pi-ai": "1.0.0",
+		"@linxiraos/pi-catalog": "1.0.0",
+		"@linxiraos/pi-utils": "1.0.0"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3.14",
+		"@types/react": "^19.2.17",
+		"@types/react-dom": "^19.2.3",
+		"postcss": "^8.5.16"
+	},
+	"engines": {
+		"bun": ">=1.3.14"
+	},
+	"files": [
+		"src",
+		"build.ts",
+		"tailwind.config.js",
+		"README.md",
+		"CHANGELOG.md",
+		"dist/types",
+		"dist/client"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./src/index.ts"
+		},
+		"./*": {
+			"types": "./dist/types/*.d.ts",
+			"import": "./src/*.ts"
+		},
+		"./client": {
+			"types": "./dist/types/client/index.d.ts",
+			"import": "./src/client/index.tsx"
+		},
+		"./client/*": {
+			"types": "./dist/types/client/*.d.ts",
+			"import": "./src/client/*.ts"
+		},
+		"./client/components/*": {
+			"types": "./dist/types/client/components/*.d.ts",
+			"import": "./src/client/components/*.ts"
+		},
+		"./*.js": "./src/*.ts"
+	}
+}