@aiready/core 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,61 @@
+
+
+> @aiready/core@0.1.0 build /Users/pengcao/projects/aiready/packages/core
+> tsup src/index.ts --format cjs,esm --dts
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: es2020
+CJS Build start
+ESM Build start
+DTS Build start
+
+[12:59:20 AM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
+
+    package.json:12:6:
+      12 │       "types": "./dist/index.d.ts"
+         ╵       ~~~~~~~
+
+  The "import" condition comes earlier and will be used for all "import" statements:
+
+    package.json:11:6:
+      11 │       "import": "./dist/index.mjs",
+         ╵       ~~~~~~~~
+
+  The "require" condition comes earlier and will be used for all "require" calls:
+
+    package.json:10:6:
+      10 │       "require": "./dist/index.js",
+         ╵       ~~~~~~~~~
+
+
+
+
+[12:59:20 AM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
+
+    package.json:12:6:
+      12 │       "types": "./dist/index.d.ts"
+         ╵       ~~~~~~~
+
+  The "import" condition comes earlier and will be used for all "import" statements:
+
+    package.json:11:6:
+      11 │       "import": "./dist/index.mjs",
+         ╵       ~~~~~~~~
+
+  The "require" condition comes earlier and will be used for all "require" calls:
+
+    package.json:10:6:
+      10 │       "require": "./dist/index.js",
+         ╵       ~~~~~~~~~
+
+
+
+ESM dist/index.mjs 2.02 KB
+ESM ⚡️ Build success in 273ms
+CJS dist/index.js 3.42 KB
+CJS ⚡️ Build success in 274ms
+DTS ⚡️ Build success in 435ms
+DTS dist/index.d.ts  2.48 KB
+DTS dist/index.d.mts 2.48 KB

package/.turbo/turbo-test.log

@@ -0,0 +1,13 @@
+
+
+> @aiready/core@0.1.0 test /Users/pengcao/projects/aiready/packages/core
+> vitest run
+
+
+ RUN  v2.1.9 /Users/pengcao/projects/aiready/packages/core
+
+include: **/*.{test,spec}.?(c|m)[jt]s?(x)
+exclude:  **/node_modules/**, **/dist/**, **/cypress/**, **/.{idea,git,cache,output,temp}/**, **/{karma,rollup,webpack,vite,vitest,jest,ava,babel,nyc,cypress,tsup,build,eslint,prettier}.config.*
+
+No test files found, exiting with code 1
+[?25h ELIFECYCLE  Test failed. See above for more details.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AIReady Team
+
+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.

package/dist/index.d.mts

@@ -0,0 +1,85 @@
+interface AnalysisResult {
+    fileName: string;
+    issues: Issue[];
+    metrics: Metrics;
+}
+interface Issue {
+    type: IssueType;
+    severity: 'critical' | 'major' | 'minor' | 'info';
+    message: string;
+    location: Location;
+    suggestion?: string;
+}
+type IssueType = 'duplicate-pattern' | 'context-fragmentation' | 'doc-drift' | 'naming-inconsistency' | 'dead-code' | 'circular-dependency' | 'missing-types';
+interface Location {
+    file: string;
+    line: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+}
+interface Metrics {
+    tokenCost?: number;
+    complexityScore?: number;
+    consistencyScore?: number;
+    docFreshnessScore?: number;
+}
+interface ScanOptions {
+    rootDir: string;
+    include?: string[];
+    exclude?: string[];
+    maxDepth?: number;
+}
+interface Report {
+    summary: {
+        totalFiles: number;
+        totalIssues: number;
+        criticalIssues: number;
+        majorIssues: number;
+    };
+    results: AnalysisResult[];
+    metrics: {
+        overallScore: number;
+        tokenCostTotal: number;
+        avgConsistency: number;
+    };
+}
+
+declare function scanFiles(options: ScanOptions): Promise<string[]>;
+declare function readFileContent(filePath: string): Promise<string>;
+declare function getFileExtension(filePath: string): string;
+declare function isSourceFile(filePath: string): boolean;
+
+interface ASTNode {
+    type: string;
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+}
+declare function parseCode(code: string, language: string): ASTNode | null;
+declare function extractFunctions(ast: ASTNode): ASTNode[];
+declare function extractImports(ast: ASTNode): string[];
+
+/**
+ * Estimate token count for text (rough approximation)
+ * ~1 token ≈ 4 characters for code
+ */
+declare function estimateTokens(text: string): number;
+/**
+ * Calculate Levenshtein distance between two strings
+ * Useful for similarity detection
+ */
+declare function levenshteinDistance(str1: string, str2: string): number;
+/**
+ * Calculate similarity score (0-1) between two strings
+ */
+declare function similarityScore(str1: string, str2: string): number;
+
+export { type ASTNode, type AnalysisResult, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, estimateTokens, extractFunctions, extractImports, getFileExtension, isSourceFile, levenshteinDistance, parseCode, readFileContent, scanFiles, similarityScore };

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+interface AnalysisResult {
+    fileName: string;
+    issues: Issue[];
+    metrics: Metrics;
+}
+interface Issue {
+    type: IssueType;
+    severity: 'critical' | 'major' | 'minor' | 'info';
+    message: string;
+    location: Location;
+    suggestion?: string;
+}
+type IssueType = 'duplicate-pattern' | 'context-fragmentation' | 'doc-drift' | 'naming-inconsistency' | 'dead-code' | 'circular-dependency' | 'missing-types';
+interface Location {
+    file: string;
+    line: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+}
+interface Metrics {
+    tokenCost?: number;
+    complexityScore?: number;
+    consistencyScore?: number;
+    docFreshnessScore?: number;
+}
+interface ScanOptions {
+    rootDir: string;
+    include?: string[];
+    exclude?: string[];
+    maxDepth?: number;
+}
+interface Report {
+    summary: {
+        totalFiles: number;
+        totalIssues: number;
+        criticalIssues: number;
+        majorIssues: number;
+    };
+    results: AnalysisResult[];
+    metrics: {
+        overallScore: number;
+        tokenCostTotal: number;
+        avgConsistency: number;
+    };
+}
+
+declare function scanFiles(options: ScanOptions): Promise<string[]>;
+declare function readFileContent(filePath: string): Promise<string>;
+declare function getFileExtension(filePath: string): string;
+declare function isSourceFile(filePath: string): boolean;
+
+interface ASTNode {
+    type: string;
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+}
+declare function parseCode(code: string, language: string): ASTNode | null;
+declare function extractFunctions(ast: ASTNode): ASTNode[];
+declare function extractImports(ast: ASTNode): string[];
+
+/**
+ * Estimate token count for text (rough approximation)
+ * ~1 token ≈ 4 characters for code
+ */
+declare function estimateTokens(text: string): number;
+/**
+ * Calculate Levenshtein distance between two strings
+ * Useful for similarity detection
+ */
+declare function levenshteinDistance(str1: string, str2: string): number;
+/**
+ * Calculate similarity score (0-1) between two strings
+ */
+declare function similarityScore(str1: string, str2: string): number;
+
+export { type ASTNode, type AnalysisResult, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, estimateTokens, extractFunctions, extractImports, getFileExtension, isSourceFile, levenshteinDistance, parseCode, readFileContent, scanFiles, similarityScore };

package/dist/index.js

@@ -0,0 +1,126 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  estimateTokens: () => estimateTokens,
+  extractFunctions: () => extractFunctions,
+  extractImports: () => extractImports,
+  getFileExtension: () => getFileExtension,
+  isSourceFile: () => isSourceFile,
+  levenshteinDistance: () => levenshteinDistance,
+  parseCode: () => parseCode,
+  readFileContent: () => readFileContent,
+  scanFiles: () => scanFiles,
+  similarityScore: () => similarityScore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils/file-scanner.ts
+var import_glob = require("glob");
+var import_promises = require("fs/promises");
+var DEFAULT_EXCLUDE = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/.git/**",
+  "**/coverage/**",
+  "**/*.min.js",
+  "**/*.bundle.js"
+];
+async function scanFiles(options) {
+  const {
+    rootDir,
+    include = ["**/*.{ts,tsx,js,jsx,py,java}"],
+    exclude = DEFAULT_EXCLUDE
+  } = options;
+  const files = await (0, import_glob.glob)(include, {
+    cwd: rootDir,
+    ignore: exclude,
+    absolute: true
+  });
+  return files;
+}
+async function readFileContent(filePath) {
+  return (0, import_promises.readFile)(filePath, "utf-8");
+}
+function getFileExtension(filePath) {
+  return filePath.split(".").pop() || "";
+}
+function isSourceFile(filePath) {
+  const ext = getFileExtension(filePath);
+  return ["ts", "tsx", "js", "jsx", "py", "java", "go", "rs"].includes(ext);
+}
+
+// src/utils/ast-parser.ts
+function parseCode(code, language) {
+  return null;
+}
+function extractFunctions(ast) {
+  return [];
+}
+function extractImports(ast) {
+  return [];
+}
+
+// src/utils/metrics.ts
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function levenshteinDistance(str1, str2) {
+  const len1 = str1.length;
+  const len2 = str2.length;
+  const matrix = [];
+  for (let i = 0; i <= len1; i++) {
+    matrix[i] = [i];
+  }
+  for (let j = 0; j <= len2; j++) {
+    matrix[0][j] = j;
+  }
+  for (let i = 1; i <= len1; i++) {
+    for (let j = 1; j <= len2; j++) {
+      const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+      matrix[i][j] = Math.min(
+        matrix[i - 1][j] + 1,
+        matrix[i][j - 1] + 1,
+        matrix[i - 1][j - 1] + cost
+      );
+    }
+  }
+  return matrix[len1][len2];
+}
+function similarityScore(str1, str2) {
+  const distance = levenshteinDistance(str1, str2);
+  const maxLength = Math.max(str1.length, str2.length);
+  return maxLength === 0 ? 1 : 1 - distance / maxLength;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  estimateTokens,
+  extractFunctions,
+  extractImports,
+  getFileExtension,
+  isSourceFile,
+  levenshteinDistance,
+  parseCode,
+  readFileContent,
+  scanFiles,
+  similarityScore
+});

package/dist/index.mjs

@@ -0,0 +1,90 @@
+// src/utils/file-scanner.ts
+import { glob } from "glob";
+import { readFile } from "fs/promises";
+var DEFAULT_EXCLUDE = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/.git/**",
+  "**/coverage/**",
+  "**/*.min.js",
+  "**/*.bundle.js"
+];
+async function scanFiles(options) {
+  const {
+    rootDir,
+    include = ["**/*.{ts,tsx,js,jsx,py,java}"],
+    exclude = DEFAULT_EXCLUDE
+  } = options;
+  const files = await glob(include, {
+    cwd: rootDir,
+    ignore: exclude,
+    absolute: true
+  });
+  return files;
+}
+async function readFileContent(filePath) {
+  return readFile(filePath, "utf-8");
+}
+function getFileExtension(filePath) {
+  return filePath.split(".").pop() || "";
+}
+function isSourceFile(filePath) {
+  const ext = getFileExtension(filePath);
+  return ["ts", "tsx", "js", "jsx", "py", "java", "go", "rs"].includes(ext);
+}
+
+// src/utils/ast-parser.ts
+function parseCode(code, language) {
+  return null;
+}
+function extractFunctions(ast) {
+  return [];
+}
+function extractImports(ast) {
+  return [];
+}
+
+// src/utils/metrics.ts
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function levenshteinDistance(str1, str2) {
+  const len1 = str1.length;
+  const len2 = str2.length;
+  const matrix = [];
+  for (let i = 0; i <= len1; i++) {
+    matrix[i] = [i];
+  }
+  for (let j = 0; j <= len2; j++) {
+    matrix[0][j] = j;
+  }
+  for (let i = 1; i <= len1; i++) {
+    for (let j = 1; j <= len2; j++) {
+      const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+      matrix[i][j] = Math.min(
+        matrix[i - 1][j] + 1,
+        matrix[i][j - 1] + 1,
+        matrix[i - 1][j - 1] + cost
+      );
+    }
+  }
+  return matrix[len1][len2];
+}
+function similarityScore(str1, str2) {
+  const distance = levenshteinDistance(str1, str2);
+  const maxLength = Math.max(str1.length, str2.length);
+  return maxLength === 0 ? 1 : 1 - distance / maxLength;
+}
+export {
+  estimateTokens,
+  extractFunctions,
+  extractImports,
+  getFileExtension,
+  isSourceFile,
+  levenshteinDistance,
+  parseCode,
+  readFileContent,
+  scanFiles,
+  similarityScore
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@aiready/core",
+  "version": "0.1.0",
+  "description": "Shared utilities for AIReady analysis tools",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "aiready",
+    "code-analysis",
+    "utilities"
+  ],
+  "author": "AIReady Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/caopengau/aiready-core.git"
+  },
+  "homepage": "https://github.com/caopengau/aiready-core",
+  "bugs": {
+    "url": "https://github.com/caopengau/aiready-core/issues"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "eslint": "^9.17.0"
+  },
+  "dependencies": {
+    "glob": "^11.0.0",
+    "chalk": "^5.4.1"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './utils/file-scanner';
+export * from './utils/ast-parser';
+export * from './utils/metrics';

package/src/types.ts

@@ -0,0 +1,59 @@
+export interface AnalysisResult {
+  fileName: string;
+  issues: Issue[];
+  metrics: Metrics;
+}
+
+export interface Issue {
+  type: IssueType;
+  severity: 'critical' | 'major' | 'minor' | 'info';
+  message: string;
+  location: Location;
+  suggestion?: string;
+}
+
+export type IssueType =
+  | 'duplicate-pattern'
+  | 'context-fragmentation'
+  | 'doc-drift'
+  | 'naming-inconsistency'
+  | 'dead-code'
+  | 'circular-dependency'
+  | 'missing-types';
+
+export interface Location {
+  file: string;
+  line: number;
+  column?: number;
+  endLine?: number;
+  endColumn?: number;
+}
+
+export interface Metrics {
+  tokenCost?: number;
+  complexityScore?: number;
+  consistencyScore?: number;
+  docFreshnessScore?: number;
+}
+
+export interface ScanOptions {
+  rootDir: string;
+  include?: string[];
+  exclude?: string[];
+  maxDepth?: number;
+}
+
+export interface Report {
+  summary: {
+    totalFiles: number;
+    totalIssues: number;
+    criticalIssues: number;
+    majorIssues: number;
+  };
+  results: AnalysisResult[];
+  metrics: {
+    overallScore: number;
+    tokenCostTotal: number;
+    avgConsistency: number;
+  };
+}

package/src/utils/ast-parser.ts

@@ -0,0 +1,28 @@
+// Placeholder for AST parsing utilities
+// Will be implemented with specific parsers (TypeScript, Babel, etc.)
+
+export interface ASTNode {
+  type: string;
+  loc?: {
+    start: { line: number; column: number };
+    end: { line: number; column: number };
+  };
+}
+
+export function parseCode(code: string, language: string): ASTNode | null {
+  // TODO: Implement language-specific parsing
+  // TypeScript: @typescript-eslint/parser
+  // JavaScript: @babel/parser
+  // Python: tree-sitter-python
+  return null;
+}
+
+export function extractFunctions(ast: ASTNode): ASTNode[] {
+  // TODO: Extract function declarations
+  return [];
+}
+
+export function extractImports(ast: ASTNode): string[] {
+  // TODO: Extract import statements
+  return [];
+}

package/src/utils/file-scanner.ts

@@ -0,0 +1,42 @@
+import { glob } from 'glob';
+import { readFile } from 'fs/promises';
+import { ScanOptions } from '../types';
+
+const DEFAULT_EXCLUDE = [
+  '**/node_modules/**',
+  '**/dist/**',
+  '**/build/**',
+  '**/.git/**',
+  '**/coverage/**',
+  '**/*.min.js',
+  '**/*.bundle.js',
+];
+
+export async function scanFiles(options: ScanOptions): Promise<string[]> {
+  const {
+    rootDir,
+    include = ['**/*.{ts,tsx,js,jsx,py,java}'],
+    exclude = DEFAULT_EXCLUDE,
+  } = options;
+
+  const files = await glob(include, {
+    cwd: rootDir,
+    ignore: exclude,
+    absolute: true,
+  });
+
+  return files;
+}
+
+export async function readFileContent(filePath: string): Promise<string> {
+  return readFile(filePath, 'utf-8');
+}
+
+export function getFileExtension(filePath: string): string {
+  return filePath.split('.').pop() || '';
+}
+
+export function isSourceFile(filePath: string): boolean {
+  const ext = getFileExtension(filePath);
+  return ['ts', 'tsx', 'js', 'jsx', 'py', 'java', 'go', 'rs'].includes(ext);
+}

package/src/utils/metrics.ts

@@ -0,0 +1,47 @@
+/**
+ * Estimate token count for text (rough approximation)
+ * ~1 token ≈ 4 characters for code
+ */
+export function estimateTokens(text: string): number {
+  return Math.ceil(text.length / 4);
+}
+
+/**
+ * Calculate Levenshtein distance between two strings
+ * Useful for similarity detection
+ */
+export function levenshteinDistance(str1: string, str2: string): number {
+  const len1 = str1.length;
+  const len2 = str2.length;
+  const matrix: number[][] = [];
+
+  for (let i = 0; i <= len1; i++) {
+    matrix[i] = [i];
+  }
+
+  for (let j = 0; j <= len2; j++) {
+    matrix[0][j] = j;
+  }
+
+  for (let i = 1; i <= len1; i++) {
+    for (let j = 1; j <= len2; j++) {
+      const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+      matrix[i][j] = Math.min(
+        matrix[i - 1][j] + 1,
+        matrix[i][j - 1] + 1,
+        matrix[i - 1][j - 1] + cost
+      );
+    }
+  }
+
+  return matrix[len1][len2];
+}
+
+/**
+ * Calculate similarity score (0-1) between two strings
+ */
+export function similarityScore(str1: string, str2: string): number {
+  const distance = levenshteinDistance(str1, str2);
+  const maxLength = Math.max(str1.length, str2.length);
+  return maxLength === 0 ? 1 : 1 - distance / maxLength;
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "moduleResolution": "bundler",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}