@iris-code/core 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# @iris/core
+
+Shared analysis engine package for Iris.
+
+## Scope
+
+This package is intended to become the single source of truth for:
+
+- scoring logic
+- issue normalization
+- shared analysis result types
+- gate evaluation
+- deterministic, density-ranked workspace Quality Signals
+- workspace-wide, path/role-aware, and fallback per-language file naming checks with ordered glob rules, suggestions, and built-in exemptions
+- fixture-backed parity tests used by both the extension and the CLI
+- Vue and Svelte single-file component script extraction with native line preservation
+
+## Extraction notes
+
+Keep the package pure where possible. Host-specific concerns should stay outside:
+
+- VS Code commands, webviews, and SecretStorage stay in `Iris-extension`
+- CLI argument parsing and output formatting can stay in the CLI shell layer
+- `@iris/core` should receive plain source text and config data, then return structured analysis output
+
+## Publish-ready surface
+
+This package now publishes compiled output from `dist/` rather than exposing raw TypeScript source.
+
+- `pnpm run build` compiles the package
+- `pnpm run test` runs the fixture-backed packaged-surface tests
+- `pnpm pack` will build and test first via `prepack`
+
+## v1.16 analysis surface
+
+`computeQualitySignals` consumes aggregate scan metrics and returns recurring quality signals ranked by density and impact. Each signal preserves its raw count or percentage and carries a simple attention level; it does not create a second workspace score.
+
+`checkFileNaming` enforces the workspace naming policy, with a matching language policy taking precedence. `analyseFile` accepts optional `relativePath` and `baselineFiles` context so extension and CLI callers share baseline-aware behavior without core reading the filesystem.

package/dist/config.d.ts

@@ -0,0 +1,147 @@
+import type { LanguagesConfig } from './languages';
+export interface HealthScoreWeights {
+    errorWarning: number;
+    warningWarning: number;
+    anyUsage: number;
+    tsIgnore: number;
+    consoleLog: number;
+    deepNesting: number;
+    longParamList: number;
+    unusedVar: number;
+    unusedFunction: number;
+    hardcodedSecret: number;
+    evalUsage: number;
+    sqlConcatenation: number;
+    insecureRandom: number;
+    unsafeRegex: number;
+    hardcodedLocalhost: number;
+    disabledTlsVerification: number;
+    debugFlagsEnabled: number;
+    weakHashing: number;
+    openRedirect: number;
+    bareSuppression: number;
+    duplicateCode: number;
+    fileNaming: number;
+}
+export interface InlineDiagnosticsConfig {
+    hardcodedSecrets: boolean;
+    securitySmells: boolean;
+    duplicateCode: boolean;
+    errorWarnings: boolean;
+    warningLevelWarnings: boolean;
+    tsIgnore: boolean;
+    unusedFunctions: boolean;
+    anyUsage: boolean;
+    consoleLogs: boolean;
+    magicNumbers: boolean;
+    longParamLists: boolean;
+    unusedVars: boolean;
+    todos: boolean;
+    fileNaming: boolean;
+}
+export type FileNamingConvention = 'snake_case' | 'kebab-case' | 'camelCase' | 'PascalCase';
+export interface FileNamingPolicy {
+    convention: FileNamingConvention;
+    ignore: string[];
+    scope?: 'new-files' | 'all';
+}
+export interface FileNamingOverride {
+    /** Workspace-relative globs. Overrides are evaluated in order; the last match wins. */
+    files: string[];
+    convention: FileNamingConvention;
+    scope?: 'new-files' | 'all';
+}
+export interface FileNamingConfig extends FileNamingPolicy {
+    /** Role/path rules. Only valid on the top-level workspace policy. */
+    overrides?: FileNamingOverride[];
+}
+export interface IrisConfig {
+    functionLengthThreshold: number;
+    fileLengthThreshold: number;
+    maxFunctionsPerFile: number;
+    maxImportsPerFile: number;
+    maxParameterCount: number;
+    complexityThreshold: number;
+    enableConsoleLogWarnings: boolean;
+    enableMagicNumberDetection: boolean;
+    enableTodoDetection: boolean;
+    enableLongParamDetection: boolean;
+    enableUnusedDetection: boolean;
+    enableMissingReturnTypeWarnings: boolean;
+    enableSecretsDetection: boolean;
+    enableSecuritySmells: boolean;
+    enableDuplicateDetection: boolean;
+    duplicateBlockMinTokens: number;
+    enableCodeLens: boolean;
+    enableStatusBar: boolean;
+    severityOverrides: Partial<Record<string, 'error' | 'warning' | 'info'>>;
+    ignoreFiles: string[];
+    ignoreFunctions: string[];
+    testConvention: 'colocated' | 'dedicated' | 'both';
+    sidebarFontSize: number;
+    ignoreSuppressions: boolean;
+    enableInlineDiagnostics: boolean;
+    inlineDiagnostics: InlineDiagnosticsConfig;
+    healthScoreWeights: HealthScoreWeights;
+    fileNaming?: FileNamingConfig;
+    fileNamingScope: 'new-files' | 'all';
+    languages?: LanguagesConfig;
+}
+export type IrisConfigPresetId = 'strict' | 'balanced' | 'legacy' | 'security' | 'typescript' | 'ai-assisted';
+export interface IrisGeneratedConfig extends Omit<Partial<IrisConfig>, 'inlineDiagnostics' | 'healthScoreWeights'> {
+    presetId?: IrisConfigPresetId;
+    inlineDiagnostics?: Partial<InlineDiagnosticsConfig>;
+    healthScoreWeights?: Partial<HealthScoreWeights>;
+    minHealthScore?: number;
+    trendRegressionThreshold?: number;
+    gateBaselineMode?: boolean;
+    gateMaxSecrets?: number;
+    gateMaxComplexity?: number;
+    gateMaxFileLength?: number;
+    gateMaxSmellsPerFile?: number;
+    gateMaxSecuritySmells?: number;
+    gateMaxSuppressions?: number;
+    gateMaxDuplicateBlocks?: number;
+    gateMaxNamingViolations?: number;
+}
+export interface IrisConfigPresetDefinition {
+    id: IrisConfigPresetId;
+    label: string;
+    description: string;
+    recommendedFor: string[];
+    config: IrisGeneratedConfig;
+}
+export declare const IRIS_WARNING_TYPES: readonly ["file-too-long", "function-too-long", "too-many-functions", "too-many-imports", "no-exports", "hardcoded-secret", "any-usage", "ts-ignore", "unused-function", "unused-var", "console-log", "magic-number", "long-param-list", "todo", "parse-error", "security-smell", "duplicate-code", "file-naming", "method-missing", "mass-assignment", "god-class", "large-class", "catch-all-exception", "async-void", "linq-abuse"];
+export declare const IRIS_HEALTH_WEIGHT_KEYS: readonly ["errorWarning", "warningWarning", "anyUsage", "tsIgnore", "consoleLog", "deepNesting", "longParamList", "unusedVar", "unusedFunction", "hardcodedSecret", "evalUsage", "sqlConcatenation", "insecureRandom", "unsafeRegex", "hardcodedLocalhost", "disabledTlsVerification", "debugFlagsEnabled", "weakHashing", "openRedirect", "bareSuppression", "duplicateCode", "fileNaming"];
+export declare const IRIS_INLINE_DIAGNOSTIC_KEYS: readonly ["hardcodedSecrets", "securitySmells", "duplicateCode", "errorWarnings", "warningLevelWarnings", "tsIgnore", "unusedFunctions", "anyUsage", "consoleLogs", "magicNumbers", "longParamLists", "unusedVars", "todos", "fileNaming"];
+export declare const DEFAULT_IRIS_CONFIG: IrisConfig;
+export declare const IRIS_CONFIG_PRESETS: Record<IrisConfigPresetId, IrisConfigPresetDefinition>;
+export declare function mergeIrisConfig(overrides?: Partial<IrisConfig>): IrisConfig;
+export declare function getIrisConfigPreset(id: IrisConfigPresetId): IrisConfigPresetDefinition;
+export declare function buildGeneratedConfig(presetId: IrisConfigPresetId, overrides?: IrisGeneratedConfig): IrisGeneratedConfig;
+/**
+ * Public URL of the .irisconfig.json JSON schema, written into every generated
+ * config as `$schema`.
+ *
+ * Editors resolve `$schema` themselves, so ONE line in the file gives completion,
+ * hover docs, and unknown-key validation in VS Code, JetBrains, Neovim, and
+ * anything else that speaks JSON schema. The alternative was per-host plumbing:
+ * VS Code contributes `jsonValidation`, and the JetBrains equivalent would have
+ * meant Java against an extension point that lives in a backend-only module in
+ * 2026.2, unverifiable in a remote-dev split.
+ *
+ * Versioned on purpose: a breaking config change publishes /v2 and leaves every
+ * existing file pointing at a schema that still describes it correctly.
+ * Served from Iris-landing/public/schema/v1/ - keep the two in step with
+ * `node scripts/copy-schema.js` in the extension repo.
+ */
+export declare const IRIS_CONFIG_SCHEMA_URL = "https://www.iriscode.co/schema/v1/irisconfig.schema.json";
+export interface SerializeGeneratedConfigOptions {
+    /**
+     * Optional schema reference for development/test generated configs. Release
+     * callers should omit this so configs point at the versioned public schema.
+     */
+    schemaUrl?: string;
+}
+export declare function serializeGeneratedConfigJsonc(values: IrisGeneratedConfig, presetId?: IrisConfigPresetId, options?: SerializeGeneratedConfigOptions): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IAEvB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IAGpB,eAAe,EAAE,MAAM,CAAA;IAEvB,aAAa,EAAE,MAAM,CAAA;IAErB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa,EAAE,OAAO,CAAA;IACtB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAA;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,oBAAoB,CAAA;IAChC,MAAM,EAAE,MAAM,EAAE,CAAA;IAEhB,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,UAAU,EAAE,oBAAoB,CAAA;IAChC,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,qEAAqE;IACrE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,wBAAwB,EAAE,OAAO,CAAA;IACjC,0BAA0B,EAAE,OAAO,CAAA;IACnC,mBAAmB,EAAE,OAAO,CAAA;IAC5B,wBAAwB,EAAE,OAAO,CAAA;IACjC,qBAAqB,EAAE,OAAO,CAAA;IAC9B,+BAA+B,EAAE,OAAO,CAAA;IACxC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,wBAAwB,EAAE,OAAO,CAAA;IAGjC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,OAAO,CAAA;IACxB,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,CAAA;IACxE,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,cAAc,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,CAAA;IAClD,eAAe,EAAE,MAAM,CAAA;IAGvB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,uBAAuB,EAAE,OAAO,CAAA;IAChC,iBAAiB,EAAE,uBAAuB,CAAA;IAC1C,kBAAkB,EAAE,kBAAkB,CAAA;IAGtC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,eAAe,EAAE,WAAW,GAAG,KAAK,CAAA;IAIpC,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,aAAa,CAAA;AAEjB,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAAC;IAChH,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACpD,kBAAkB,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,kBAAkB,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED,eAAO,MAAM,kBAAkB,waA0BrB,CAAA;AAEV,eAAO,MAAM,uBAAuB,8XAuB1B,CAAA;AAEV,eAAO,MAAM,2BAA2B,4OAe9B,CAAA;AAEV,eAAO,MAAM,mBAAmB,EAAE,UAyEjC,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAgPtF,CAAA;AAED,wBAAgB,eAAe,CAAC,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAkB/E;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,kBAAkB,GAAG,0BAA0B,CAEtF;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,GAAE,mBAAwB,GAClC,mBAAmB,CAqBrB;AAiED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,6DACyB,CAAA;AAE5D,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,OAAO,GAAE,+BAAoC,GAC5C,MAAM,CAkER"}