@fringetools/cli 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+interface CliOpts {
+    log?: (s: string) => void;
+    cwd?: string;
+    err?: (s: string) => void;
+}
+declare function runCli(argv: string[], opts?: CliOpts): Promise<number>;
+
+export { type CliOpts, runCli };

package/dist/index.js

@@ -0,0 +1,6 @@
+import {
+  runCli
+} from "./chunk-AOUZJDQL.js";
+export {
+  runCli
+};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@fringetools/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "fringe": "dist/bin.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "skill"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/bin.ts --format esm --dts --outDir dist --clean",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm build && pnpm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.29.9",
+    "parse5": "^7.3.0",
+    "postcss": "^8.5.31"
+  },
+  "description": "UX-quality checker for AI coding agents: accessibility, states, dark patterns, token drift, AI-look.",
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "lint",
+    "ux",
+    "ai-agents",
+    "claude-code"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/skc-learn/fringe.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/skc-learn/fringe#readme",
+  "bugs": {
+    "url": "https://github.com/skc-learn/fringe/issues"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: fringe
+description: Use when writing or changing frontend code (JSX/TSX, HTML, CSS, Vue, Svelte). Runs the Fringe checker so accessibility, state handling, dark patterns, token drift and the generic "AI look" are measured, not guessed.
+---
+
+# Fringe
+
+Ponytail trims your code. Fringe handles your edges. Work the ladder in order.
+
+1. **Flow (judged).** Before building, ask what the user can skip. Cut steps, screens or options nobody needs. Write each decision with its evidence to `.fringe/manifest.json`: `{"flows":[{"action":"cut"|"kept","what":"...","evidence":"..."}]}`. No evidence, no cut.
+2. **Edges (verified, gates).** After every edit the hook runs `fringe check --claude-hook` and feeds errors back to you. Fix every listed finding. If there is no hook, run `fringe check --hook` yourself from the project root and do not finish while `block` is `true`.
+3. **Polish (verified, never gates).** Run `fringe check` once before finishing. Fix `review` items you agree with. Fix `signal` items that are cheap. Say which you left and why.
+
+When done: `fringe check --record --manifest .fringe/manifest.json`. Report the health score as measured; never estimate it yourself.
+
+Rules of the road:
+- Never grade your own work where the checker can measure it.
+- Do not silence a rule with `ignore`/`disable` in `fringe.config.json` to get green. Fix the code, or tell the user why the rule is wrong.
+- A `// fringe-ignore FR-123` comment is allowed only for a real false positive. Say so in your final message with the rule and why; the run output counts suppressions (`N suppressed`) and a reviewer will see them.
+- If `fringe` is not installed, say so. Do not skip the check silently.
+- Hook wiring and the full rule table: `packages/cli/README.md`.