refactor: replace all @fluently/scorer references with fluently-scorer

faical-yannick-congo · claude · faical-yannick-congo · commit 6722567d72ab · 2026-03-24T00:32:31.000+01:00
Update all import statements, tsconfig path aliases, vitest aliases, and
README docs to use the published package name fluently-scorer consistently.

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/packages/cli/README.md b/packages/cli/README.md
@@ -112,7 +112,7 @@ Browse the full community knowledge base at **[fluently-org.github.io/fluently/k
 - **GitHub repo** — [github.com/Fluently-Org/fluently](https://github.com/Fluently-Org/fluently)
 - **Issues / discussions** — [github.com/Fluently-Org/fluently/issues](https://github.com/Fluently-Org/fluently/issues)
 - **MCP server** — [npmjs.com/package/fluently-mcp-server](https://www.npmjs.com/package/fluently-mcp-server)
-- **Scorer library** — [npmjs.com/package/@fluently/scorer](https://www.npmjs.com/package/@fluently/scorer)
+- **Scorer library** — [npmjs.com/package/fluently-scorer](https://www.npmjs.com/package/fluently-scorer)
 
 ---
 
diff --git a/packages/cli/__tests__/commands.test.ts b/packages/cli/__tests__/commands.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
-import { scoreTask, loadKnowledgeEntries } from '@fluently/scorer';
-import { knowledgeEntrySchema } from '@fluently/scorer/schema';
+import { scoreTask, loadKnowledgeEntries } from 'fluently-scorer';
+import { knowledgeEntrySchema } from 'fluently-scorer/schema';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
diff --git a/packages/cli/src/commands/compare.ts b/packages/cli/src/commands/compare.ts
@@ -14,7 +14,7 @@
 import { Command } from "commander";
 import ora from "ora";
 import chalk from "chalk";
-import { scoreTask } from "@fluently/scorer";
+import { scoreTask } from "fluently-scorer";
 import { knowledgeDir } from "../utils/paths.js";
 import { renderScoreRow, averageScore } from "../utils/display.js";
 
diff --git a/packages/cli/src/commands/contribute.ts b/packages/cli/src/commands/contribute.ts
@@ -12,9 +12,9 @@ import inquirer from "inquirer";
 import yaml from "js-yaml";
 import fs from "fs";
 import path from "path";
-import { buildKnowledgeSchemas, BUNDLED_4D_FRAMEWORK } from "@fluently/scorer/schema";
-import { checkPrivacy } from "@fluently/scorer";
-import type { FrameworkDefinition } from "@fluently/scorer";
+import { buildKnowledgeSchemas, BUNDLED_4D_FRAMEWORK } from "fluently-scorer/schema";
+import { checkPrivacy } from "fluently-scorer";
+import type { FrameworkDefinition } from "fluently-scorer";
 
 const DOMAINS = ["coding", "writing", "research", "customer-support", "education", "legal", "healthcare", "general"] as const;
 
diff --git a/packages/cli/src/commands/list.ts b/packages/cli/src/commands/list.ts
@@ -7,7 +7,7 @@
 
 import { Command } from "commander";
 import chalk from "chalk";
-import { loadKnowledgeEntries } from "@fluently/scorer";
+import { loadKnowledgeEntries } from "fluently-scorer";
 import { knowledgeDir } from "../utils/paths.js";
 
 export function registerList(program: Command): void {
diff --git a/packages/cli/src/commands/score.ts b/packages/cli/src/commands/score.ts
@@ -11,7 +11,7 @@
 import { Command } from "commander";
 import ora from "ora";
 import chalk from "chalk";
-import { scoreTask } from "@fluently/scorer";
+import { scoreTask } from "fluently-scorer";
 import { knowledgeDir } from "../utils/paths.js";
 import { renderScoreRow, renderEntryHeader, averageScore } from "../utils/display.js";
 
diff --git a/packages/cli/tsconfig.json b/packages/cli/tsconfig.json
@@ -9,8 +9,8 @@
     "strictNullChecks": false,
     "noImplicitAny": false,
     "paths": {
-      "@fluently/scorer": ["packages/scorer/dist/index"],
-      "@fluently/scorer/schema": ["packages/scorer/dist/schema"]
+      "fluently-scorer": ["packages/scorer/dist/index"],
+      "fluently-scorer/schema": ["packages/scorer/dist/schema"]
     }
   },
   "include": ["src/**/*"],
diff --git a/packages/mcp-server/README.md b/packages/mcp-server/README.md
@@ -153,7 +153,7 @@ Use this server when you need:
 - **Contribute a cycle** — [fluently-org.github.io/fluently/contribute.html](https://fluently-org.github.io/fluently/contribute.html)
 - **GitHub repo** — [github.com/Fluently-Org/fluently](https://github.com/Fluently-Org/fluently)
 - **CLI** — [npmjs.com/package/fluently-cli](https://www.npmjs.com/package/fluently-cli)
-- **Scorer library** — [npmjs.com/package/@fluently/scorer](https://www.npmjs.com/package/@fluently/scorer)
+- **Scorer library** — [npmjs.com/package/fluently-scorer](https://www.npmjs.com/package/fluently-scorer)
 
 ---
 
diff --git a/packages/mcp-server/__tests__/tools.test.ts b/packages/mcp-server/__tests__/tools.test.ts
@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeAll } from 'vitest';
-import { loadKnowledgeEntries } from '@fluently/scorer';
+import { loadKnowledgeEntries } from 'fluently-scorer';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
diff --git a/packages/mcp-server/src/tools/handlers.ts b/packages/mcp-server/src/tools/handlers.ts
@@ -13,8 +13,8 @@
  *   - No numeric scores are ever exposed to the agent — the agent reasons.
  */
 
-import { buildKnowledgeSchemas } from "@fluently/scorer/schema";
-import { checkPrivacy, evaluateCompliance } from "@fluently/scorer";
+import { buildKnowledgeSchemas } from "fluently-scorer/schema";
+import { checkPrivacy, evaluateCompliance } from "fluently-scorer";
 import type { KnowledgeConnector, KnowledgeEntry, FrameworkDefinition } from "../connectors/types.js";
 import { GitHubPublicConnector } from "../connectors/github-public.js";
 import { getKnowledge, refreshKnowledge, getFrameworks, invalidateCache } from "../knowledge.js";
diff --git a/packages/mcp-server/tsconfig.json b/packages/mcp-server/tsconfig.json
@@ -9,8 +9,8 @@
     "strictNullChecks": false,
     "noImplicitAny": false,
     "paths": {
-      "@fluently/scorer": ["packages/scorer/dist/index"],
-      "@fluently/scorer/schema": ["packages/scorer/dist/schema"]
+      "fluently-scorer": ["packages/scorer/dist/index"],
+      "fluently-scorer/schema": ["packages/scorer/dist/schema"]
     }
   },
   "include": ["src/**/*"],
diff --git a/packages/scorer/README.md b/packages/scorer/README.md
@@ -1,10 +1,10 @@
-# @fluently/scorer
+# fluently-scorer
 
 **Shared scoring engine for the [Fluently 4D Framework](https://fluently-org.github.io/fluently/).** Validates knowledge YAML against the schema and ranks cycles by keyword similarity for any AI task.
 
 Used internally by both `fluently-cli` and `fluently-mcp-server`. Expose it in your own tools to build on top of the Fluently knowledge base.
 
-[![npm version](https://img.shields.io/npm/v/@fluently/scorer.svg)](https://www.npmjs.com/package/@fluently/scorer)
+[![npm version](https://img.shields.io/npm/v/fluently-scorer.svg)](https://www.npmjs.com/package/fluently-scorer)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](../../LICENSE)
 [![Node ≥ 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
 
@@ -13,7 +13,7 @@ Used internally by both `fluently-cli` and `fluently-mcp-server`. Expose it in y
 ## Install
 
 ```bash
-npm install @fluently/scorer
+npm install fluently-scorer
 ```
 
 Requires Node.js 20+. Pure local computation — no network calls, no credentials.
@@ -28,7 +28,7 @@ Load and Zod-validate every `.yaml` file in a directory.
 Throws if any file fails schema validation — keeps CI strict about malformed entries.
 
 ```typescript
-import { loadKnowledgeEntries } from '@fluently/scorer';
+import { loadKnowledgeEntries } from 'fluently-scorer';
 
 const entries = loadKnowledgeEntries('./knowledge');
 // → KnowledgeEntry[]  (Zod-validated)
@@ -45,8 +45,8 @@ console.log(entries[0].tags);    // ["code-review", "triage", "automation"]
 Score a task against all loaded cycles and return the top 3 matches ordered by similarity.
 
 ```typescript
-import { scoreTask } from '@fluently/scorer';
-import type { TaskInput } from '@fluently/scorer';
+import { scoreTask } from 'fluently-scorer';
+import type { TaskInput } from 'fluently-scorer';
 
 const input: TaskInput = {
     description:       'AI reviews PRs for style issues, humans approve before merge',
@@ -78,8 +78,8 @@ Scan text for tokens that may indicate private data (names, emails, keys, etc.).
 Useful as a pre-flight check before sending content to an AI provider.
 
 ```typescript
-import { checkPrivacy } from '@fluently/scorer';
-import type { PrivacyCheckOptions } from '@fluently/scorer';
+import { checkPrivacy } from 'fluently-scorer';
+import type { PrivacyCheckOptions } from 'fluently-scorer';
 
 const result = checkPrivacy('Contact john.doe@example.com about the API_KEY leak', {
     flagEmails: true,
@@ -95,10 +95,10 @@ console.log(result.issues);
 
 ---
 
-### Schema validation (`@fluently/scorer/schema`)
+### Schema validation (`fluently-scorer/schema`)
 
 ```typescript
-import { knowledgeEntrySchema, domainEnum, dimensionSchema } from '@fluently/scorer/schema';
+import { knowledgeEntrySchema, domainEnum, dimensionSchema } from 'fluently-scorer/schema';
 
 // Validate a raw YAML object
 const entry = knowledgeEntrySchema.parse(rawYaml);
@@ -120,7 +120,7 @@ const dim = dimensionSchema.parse({
 ## TypeScript types
 
 ```typescript
-import type { TaskInput, KnowledgeEntry, PrivacyCheckResult, PrivacyIssue, PrivacyCheckOptions } from '@fluently/scorer';
+import type { TaskInput, KnowledgeEntry, PrivacyCheckResult, PrivacyIssue, PrivacyCheckOptions } from 'fluently-scorer';
 ```
 
 | Type | Description |
diff --git a/tsconfig.base.json b/tsconfig.base.json
@@ -10,8 +10,8 @@
     "declaration": true,
     "baseUrl": ".",
     "paths": {
-      "@fluently/scorer": ["packages/scorer/src/index.ts"],
-      "@fluently/scorer/*": ["packages/scorer/src/*"]
+      "fluently-scorer": ["packages/scorer/dist/index"],
+      "fluently-scorer/schema": ["packages/scorer/dist/schema"]
     }
   }
 }
diff --git a/vitest.config.ts b/vitest.config.ts
@@ -8,8 +8,8 @@ export default defineConfig({
   },
   resolve: {
     alias: {
-      '@fluently/scorer': path.resolve(__dirname, 'packages/scorer/src'),
-      '@fluently/scorer/': path.resolve(__dirname, 'packages/scorer/src/'),
+      'fluently-scorer': path.resolve(__dirname, 'packages/scorer/src'),
+      'fluently-scorer/': path.resolve(__dirname, 'packages/scorer/src/'),
     },
   },
 });
