iosm-cli 0.1.2 → 0.2.0

package/dist/core/semantic/types.d.ts

@@ -0,0 +1,157 @@
+export type SemanticScope = "user" | "project";
+export type SemanticProviderType = "openrouter" | "ollama" | "custom_openai";
+export type SemanticAction = "status" | "index" | "rebuild" | "query";
+export type SemanticStaleReason = "missing_index" | "provider_changed" | "chunking_changed" | "index_filters_changed" | "files_changed" | "dimension_mismatch";
+export interface SemanticProviderConfig {
+    type: SemanticProviderType;
+    model: string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    headers?: Record<string, string>;
+    batchSize: number;
+    timeoutMs: number;
+}
+export interface SemanticIndexConfig {
+    includeGlobs: string[];
+    excludeGlobs: string[];
+    chunkMaxChars: number;
+    chunkOverlapChars: number;
+    maxFileBytes: number;
+    maxFiles: number;
+}
+export interface SemanticSearchConfig {
+    enabled: boolean;
+    autoIndex: boolean;
+    provider: SemanticProviderConfig;
+    index: SemanticIndexConfig;
+}
+export interface SemanticConfigFile {
+    semanticSearch?: Partial<{
+        enabled: boolean;
+        autoIndex: boolean;
+        provider: Partial<{
+            type: SemanticProviderType;
+            model: string;
+            baseUrl: string;
+            apiKeyEnv: string;
+            headers: Record<string, string>;
+            batchSize: number;
+            timeoutMs: number;
+        }>;
+        index: Partial<{
+            includeGlobs: string[];
+            excludeGlobs: string[];
+            chunkMaxChars: number;
+            chunkOverlapChars: number;
+            maxFileBytes: number;
+            maxFiles: number;
+        }>;
+    }>;
+}
+export interface SemanticScopedLoadResult {
+    scope: SemanticScope;
+    path: string;
+    file: SemanticConfigFile;
+    error?: Error;
+}
+export interface SemanticMergedConfig {
+    config?: SemanticSearchConfig;
+    errors: string[];
+    scoped: SemanticScopedLoadResult[];
+}
+export interface SemanticFileFingerprint {
+    path: string;
+    size: number;
+    mtimeMs: number;
+    hash: string;
+    chunks: string[];
+}
+export interface SemanticIndexMeta {
+    version: 1;
+    cwd: string;
+    projectHash: string;
+    providerFingerprint: string;
+    providerType: SemanticProviderType;
+    model: string;
+    dimension: number;
+    builtAt: string;
+    chunkConfigFingerprint: string;
+    indexFilterFingerprint: string;
+    fileMap: Record<string, SemanticFileFingerprint>;
+}
+export interface SemanticIndexedChunk {
+    id: string;
+    path: string;
+    lineStart: number;
+    lineEnd: number;
+    preview: string;
+    hash: string;
+}
+export interface SemanticIndexedVector {
+    id: string;
+    vector: number[];
+    norm: number;
+}
+export interface SemanticChunkForEmbedding extends SemanticIndexedChunk {
+    text: string;
+}
+export interface SemanticIndexOperationResult {
+    action: "index" | "rebuild";
+    indexPath: string;
+    durationMs: number;
+    processedFiles: number;
+    newFiles: number;
+    changedFiles: number;
+    removedFiles: number;
+    reusedFiles: number;
+    chunks: number;
+    dimension: number;
+    builtAt: string;
+}
+export interface SemanticStatusResult {
+    action: "status";
+    configured: boolean;
+    enabled: boolean;
+    autoIndex: boolean;
+    indexed: boolean;
+    stale: boolean;
+    staleReason?: SemanticStaleReason;
+    provider?: SemanticProviderType;
+    model?: string;
+    files: number;
+    chunks: number;
+    dimension?: number;
+    ageSeconds?: number;
+    indexPath: string;
+    configPathUser: string;
+    configPathProject: string;
+}
+export interface SemanticQueryHit {
+    score: number;
+    path: string;
+    lineStart: number;
+    lineEnd: number;
+    snippet: string;
+}
+export interface SemanticQueryResult {
+    action: "query";
+    query: string;
+    topK: number;
+    autoRefreshed: boolean;
+    hits: SemanticQueryHit[];
+}
+export type SemanticToolResult = SemanticStatusResult | SemanticIndexOperationResult | SemanticQueryResult;
+export declare class SemanticConfigError extends Error {
+}
+export declare class SemanticConfigMissingError extends Error {
+    readonly userConfigPath: string;
+    readonly projectConfigPath: string;
+    constructor(userConfigPath: string, projectConfigPath: string);
+}
+export declare class SemanticRebuildRequiredError extends Error {
+    constructor(message: string);
+}
+export declare class SemanticIndexRequiredError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/semantic/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/semantic/types.ts"],"names":[],"mappings":"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"}

package/dist/core/semantic/types.js

@@ -0,0 +1,23 @@
+export class SemanticConfigError extends Error {
+}
+export class SemanticConfigMissingError extends Error {
+    constructor(userConfigPath, projectConfigPath) {
+        super(`Semantic search config not found. Create one with /semantic setup or write ${userConfigPath} (user) or ${projectConfigPath} (project).`);
+        this.name = "SemanticConfigMissingError";
+        this.userConfigPath = userConfigPath;
+        this.projectConfigPath = projectConfigPath;
+    }
+}
+export class SemanticRebuildRequiredError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SemanticRebuildRequiredError";
+    }
+}
+export class SemanticIndexRequiredError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SemanticIndexRequiredError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/semantic/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/semantic/types.ts"],"names":[],"mappings":"AAyKA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;CAAG;AAEjD,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAIpD,YAAY,cAAsB,EAAE,iBAAyB;QAC5D,KAAK,CACJ,8EAA8E,cAAc,cAAc,iBAAiB,aAAa,CACxI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC5C,CAAC;CACD;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACtD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC5C,CAAC;CACD;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACpD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC1C,CAAC;CACD","sourcesContent":["export type SemanticScope = \"user\" | \"project\";\nexport type SemanticProviderType = \"openrouter\" | \"ollama\" | \"custom_openai\";\nexport type SemanticAction = \"status\" | \"index\" | \"rebuild\" | \"query\";\nexport type SemanticStaleReason =\n\t| \"missing_index\"\n\t| \"provider_changed\"\n\t| \"chunking_changed\"\n\t| \"index_filters_changed\"\n\t| \"files_changed\"\n\t| \"dimension_mismatch\";\n\nexport interface SemanticProviderConfig {\n\ttype: SemanticProviderType;\n\tmodel: string;\n\tbaseUrl?: string;\n\tapiKeyEnv?: string;\n\theaders?: Record<string, string>;\n\tbatchSize: number;\n\ttimeoutMs: number;\n}\n\nexport interface SemanticIndexConfig {\n\tincludeGlobs: string[];\n\texcludeGlobs: string[];\n\tchunkMaxChars: number;\n\tchunkOverlapChars: number;\n\tmaxFileBytes: number;\n\tmaxFiles: number;\n}\n\nexport interface SemanticSearchConfig {\n\tenabled: boolean;\n\tautoIndex: boolean;\n\tprovider: SemanticProviderConfig;\n\tindex: SemanticIndexConfig;\n}\n\nexport interface SemanticConfigFile {\n\tsemanticSearch?: Partial<{\n\t\tenabled: boolean;\n\t\tautoIndex: boolean;\n\t\tprovider: Partial<{\n\t\t\ttype: SemanticProviderType;\n\t\t\tmodel: string;\n\t\t\tbaseUrl: string;\n\t\t\tapiKeyEnv: string;\n\t\t\theaders: Record<string, string>;\n\t\t\tbatchSize: number;\n\t\t\ttimeoutMs: number;\n\t\t}>;\n\t\tindex: Partial<{\n\t\t\tincludeGlobs: string[];\n\t\t\texcludeGlobs: string[];\n\t\t\tchunkMaxChars: number;\n\t\t\tchunkOverlapChars: number;\n\t\t\tmaxFileBytes: number;\n\t\t\tmaxFiles: number;\n\t\t}>;\n\t}>;\n}\n\nexport interface SemanticScopedLoadResult {\n\tscope: SemanticScope;\n\tpath: string;\n\tfile: SemanticConfigFile;\n\terror?: Error;\n}\n\nexport interface SemanticMergedConfig {\n\tconfig?: SemanticSearchConfig;\n\terrors: string[];\n\tscoped: SemanticScopedLoadResult[];\n}\n\nexport interface SemanticFileFingerprint {\n\tpath: string;\n\tsize: number;\n\tmtimeMs: number;\n\thash: string;\n\tchunks: string[];\n}\n\nexport interface SemanticIndexMeta {\n\tversion: 1;\n\tcwd: string;\n\tprojectHash: string;\n\tproviderFingerprint: string;\n\tproviderType: SemanticProviderType;\n\tmodel: string;\n\tdimension: number;\n\tbuiltAt: string;\n\tchunkConfigFingerprint: string;\n\tindexFilterFingerprint: string;\n\tfileMap: Record<string, SemanticFileFingerprint>;\n}\n\nexport interface SemanticIndexedChunk {\n\tid: string;\n\tpath: string;\n\tlineStart: number;\n\tlineEnd: number;\n\tpreview: string;\n\thash: string;\n}\n\nexport interface SemanticIndexedVector {\n\tid: string;\n\tvector: number[];\n\tnorm: number;\n}\n\nexport interface SemanticChunkForEmbedding extends SemanticIndexedChunk {\n\ttext: string;\n}\n\nexport interface SemanticIndexOperationResult {\n\taction: \"index\" | \"rebuild\";\n\tindexPath: string;\n\tdurationMs: number;\n\tprocessedFiles: number;\n\tnewFiles: number;\n\tchangedFiles: number;\n\tremovedFiles: number;\n\treusedFiles: number;\n\tchunks: number;\n\tdimension: number;\n\tbuiltAt: string;\n}\n\nexport interface SemanticStatusResult {\n\taction: \"status\";\n\tconfigured: boolean;\n\tenabled: boolean;\n\tautoIndex: boolean;\n\tindexed: boolean;\n\tstale: boolean;\n\tstaleReason?: SemanticStaleReason;\n\tprovider?: SemanticProviderType;\n\tmodel?: string;\n\tfiles: number;\n\tchunks: number;\n\tdimension?: number;\n\tageSeconds?: number;\n\tindexPath: string;\n\tconfigPathUser: string;\n\tconfigPathProject: string;\n}\n\nexport interface SemanticQueryHit {\n\tscore: number;\n\tpath: string;\n\tlineStart: number;\n\tlineEnd: number;\n\tsnippet: string;\n}\n\nexport interface SemanticQueryResult {\n\taction: \"query\";\n\tquery: string;\n\ttopK: number;\n\tautoRefreshed: boolean;\n\thits: SemanticQueryHit[];\n}\n\nexport type SemanticToolResult =\n\t| SemanticStatusResult\n\t| SemanticIndexOperationResult\n\t| SemanticQueryResult;\n\nexport class SemanticConfigError extends Error {}\n\nexport class SemanticConfigMissingError extends Error {\n\treadonly userConfigPath: string;\n\treadonly projectConfigPath: string;\n\n\tconstructor(userConfigPath: string, projectConfigPath: string) {\n\t\tsuper(\n\t\t\t`Semantic search config not found. Create one with /semantic setup or write ${userConfigPath} (user) or ${projectConfigPath} (project).`,\n\t\t);\n\t\tthis.name = \"SemanticConfigMissingError\";\n\t\tthis.userConfigPath = userConfigPath;\n\t\tthis.projectConfigPath = projectConfigPath;\n\t}\n}\n\nexport class SemanticRebuildRequiredError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"SemanticRebuildRequiredError\";\n\t}\n}\n\nexport class SemanticIndexRequiredError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"SemanticIndexRequiredError\";\n\t}\n}\n"]}

package/dist/core/shadow-guard.d.ts

@@ -0,0 +1,30 @@
+export interface ShadowGuardOptions {
+    getActiveTools: () => string[];
+    getAllTools: () => string[];
+    setActiveTools: (toolNames: string[]) => void;
+}
+export interface ShadowGuardState {
+    enabled: boolean;
+    strict: boolean;
+    blockedTools: string[];
+}
+export declare class ShadowGuard {
+    private readonly getActiveTools;
+    private readonly getAllTools;
+    private readonly setActiveTools;
+    private enabled;
+    private strict;
+    private restoreToolNames;
+    constructor(options: ShadowGuardOptions);
+    getState(): ShadowGuardState;
+    isEnabled(): boolean;
+    getRestoreToolNames(): string[];
+    setRestoreToolNames(toolNames: string[]): void;
+    enable(): ShadowGuardState;
+    disable(): ShadowGuardState;
+    reset(): void;
+    enforceReadOnlyToolsIfEnabled(): void;
+    shouldDenyTool(toolName: string): boolean;
+    private applyReadOnlyTools;
+}
+//# sourceMappingURL=shadow-guard.d.ts.map

package/dist/core/shadow-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-guard.d.ts","sourceRoot":"","sources":["../../src/core/shadow-guard.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IAClC,cAAc,EAAE,MAAM,MAAM,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAaD,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,OAAO,EAAE,kBAAkB;IAMvC,QAAQ,IAAI,gBAAgB;IAQ5B,SAAS,IAAI,OAAO;IAIpB,mBAAmB,IAAI,MAAM,EAAE;IAI/B,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAI9C,MAAM,IAAI,gBAAgB;IAS1B,OAAO,IAAI,gBAAgB;IAa3B,KAAK,IAAI,IAAI;IAKb,6BAA6B,IAAI,IAAI;IAKrC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC,OAAO,CAAC,kBAAkB;CAS1B"}

package/dist/core/shadow-guard.js

@@ -0,0 +1,81 @@
+import { readOnlyTools } from "./tools/index.js";
+const SHADOW_MUTATING_TOOLS = new Set(["edit", "write", "bash", "task"]);
+const SHADOW_SAFE_ADDITIONAL_TOOLS = new Set(["todo_read", "ask_user"]);
+function uniqueTools(names) {
+    const seen = new Set();
+    const result = [];
+    for (const name of names) {
+        if (!name || seen.has(name))
+            continue;
+        seen.add(name);
+        result.push(name);
+    }
+    return result;
+}
+export class ShadowGuard {
+    constructor(options) {
+        this.enabled = false;
+        this.strict = true;
+        this.restoreToolNames = [];
+        this.getActiveTools = options.getActiveTools;
+        this.getAllTools = options.getAllTools;
+        this.setActiveTools = options.setActiveTools;
+    }
+    getState() {
+        return {
+            enabled: this.enabled,
+            strict: this.strict,
+            blockedTools: [...SHADOW_MUTATING_TOOLS],
+        };
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    getRestoreToolNames() {
+        return [...this.restoreToolNames];
+    }
+    setRestoreToolNames(toolNames) {
+        this.restoreToolNames = uniqueTools(toolNames);
+    }
+    enable() {
+        if (!this.enabled) {
+            this.restoreToolNames = uniqueTools(this.getActiveTools());
+            this.enabled = true;
+        }
+        this.applyReadOnlyTools();
+        return this.getState();
+    }
+    disable() {
+        if (!this.enabled) {
+            return this.getState();
+        }
+        const restore = uniqueTools(this.restoreToolNames);
+        if (restore.length > 0) {
+            this.setActiveTools(restore);
+        }
+        this.enabled = false;
+        return this.getState();
+    }
+    reset() {
+        this.enabled = false;
+        this.restoreToolNames = [];
+    }
+    enforceReadOnlyToolsIfEnabled() {
+        if (!this.enabled)
+            return;
+        this.applyReadOnlyTools();
+    }
+    shouldDenyTool(toolName) {
+        return this.enabled && this.strict && SHADOW_MUTATING_TOOLS.has(toolName);
+    }
+    applyReadOnlyTools() {
+        const availableTools = new Set(this.getAllTools());
+        const whitelist = new Set([
+            ...readOnlyTools.map((tool) => tool.name),
+            ...SHADOW_SAFE_ADDITIONAL_TOOLS,
+        ]);
+        const nextActive = [...availableTools].filter((toolName) => whitelist.has(toolName));
+        this.setActiveTools(uniqueTools(nextActive));
+    }
+}
+//# sourceMappingURL=shadow-guard.js.map

package/dist/core/shadow-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-guard.js","sourceRoot":"","sources":["../../src/core/shadow-guard.ts"],"names":[],"mappings":"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","sourcesContent":["import { readOnlyTools } from \"./tools/index.js\";\n\nconst SHADOW_MUTATING_TOOLS = new Set([\"edit\", \"write\", \"bash\", \"task\"]);\nconst SHADOW_SAFE_ADDITIONAL_TOOLS = new Set([\"todo_read\", \"ask_user\"]);\n\nexport interface ShadowGuardOptions {\n\tgetActiveTools: () => string[];\n\tgetAllTools: () => string[];\n\tsetActiveTools: (toolNames: string[]) => void;\n}\n\nexport interface ShadowGuardState {\n\tenabled: boolean;\n\tstrict: boolean;\n\tblockedTools: string[];\n}\n\nfunction uniqueTools(names: string[]): string[] {\n\tconst seen = new Set<string>();\n\tconst result: string[] = [];\n\tfor (const name of names) {\n\t\tif (!name || seen.has(name)) continue;\n\t\tseen.add(name);\n\t\tresult.push(name);\n\t}\n\treturn result;\n}\n\nexport class ShadowGuard {\n\tprivate readonly getActiveTools: () => string[];\n\tprivate readonly getAllTools: () => string[];\n\tprivate readonly setActiveTools: (toolNames: string[]) => void;\n\tprivate enabled = false;\n\tprivate strict = true;\n\tprivate restoreToolNames: string[] = [];\n\n\tconstructor(options: ShadowGuardOptions) {\n\t\tthis.getActiveTools = options.getActiveTools;\n\t\tthis.getAllTools = options.getAllTools;\n\t\tthis.setActiveTools = options.setActiveTools;\n\t}\n\n\tgetState(): ShadowGuardState {\n\t\treturn {\n\t\t\tenabled: this.enabled,\n\t\t\tstrict: this.strict,\n\t\t\tblockedTools: [...SHADOW_MUTATING_TOOLS],\n\t\t};\n\t}\n\n\tisEnabled(): boolean {\n\t\treturn this.enabled;\n\t}\n\n\tgetRestoreToolNames(): string[] {\n\t\treturn [...this.restoreToolNames];\n\t}\n\n\tsetRestoreToolNames(toolNames: string[]): void {\n\t\tthis.restoreToolNames = uniqueTools(toolNames);\n\t}\n\n\tenable(): ShadowGuardState {\n\t\tif (!this.enabled) {\n\t\t\tthis.restoreToolNames = uniqueTools(this.getActiveTools());\n\t\t\tthis.enabled = true;\n\t\t}\n\t\tthis.applyReadOnlyTools();\n\t\treturn this.getState();\n\t}\n\n\tdisable(): ShadowGuardState {\n\t\tif (!this.enabled) {\n\t\t\treturn this.getState();\n\t\t}\n\n\t\tconst restore = uniqueTools(this.restoreToolNames);\n\t\tif (restore.length > 0) {\n\t\t\tthis.setActiveTools(restore);\n\t\t}\n\t\tthis.enabled = false;\n\t\treturn this.getState();\n\t}\n\n\treset(): void {\n\t\tthis.enabled = false;\n\t\tthis.restoreToolNames = [];\n\t}\n\n\tenforceReadOnlyToolsIfEnabled(): void {\n\t\tif (!this.enabled) return;\n\t\tthis.applyReadOnlyTools();\n\t}\n\n\tshouldDenyTool(toolName: string): boolean {\n\t\treturn this.enabled && this.strict && SHADOW_MUTATING_TOOLS.has(toolName);\n\t}\n\n\tprivate applyReadOnlyTools(): void {\n\t\tconst availableTools = new Set(this.getAllTools());\n\t\tconst whitelist = new Set<string>([\n\t\t\t...readOnlyTools.map((tool) => tool.name),\n\t\t\t...SHADOW_SAFE_ADDITIONAL_TOOLS,\n\t\t]);\n\t\tconst nextActive = [...availableTools].filter((toolName) => whitelist.has(toolName));\n\t\tthis.setActiveTools(uniqueTools(nextActive));\n\t}\n}\n"]}

package/dist/core/singular.d.ts

@@ -0,0 +1,73 @@
+import type { EngineeringContract } from "./contract.js";
+export type SingularComplexity = "low" | "medium" | "high";
+export type SingularBlastRadius = "low" | "medium" | "high";
+export type SingularRecommendation = "implement_now" | "implement_incrementally" | "defer";
+export type SingularStageFit = "needed_now" | "optional_now" | "later";
+export interface SingularImpactAnalysis {
+    codebase: string;
+    delivery: string;
+    risks: string;
+    operations: string;
+}
+export interface SingularOption {
+    id: string;
+    title: string;
+    summary: string;
+    complexity: SingularComplexity;
+    blast_radius: SingularBlastRadius;
+    suggested_files: string[];
+    plan: string[];
+    pros: string[];
+    cons: string[];
+    when_to_choose?: string;
+}
+export interface SingularAnalysisResult {
+    runId: string;
+    request: string;
+    generatedAt: string;
+    scannedFiles: number;
+    sourceFiles: number;
+    testFiles: number;
+    matchedFiles: string[];
+    baselineComplexity: SingularComplexity;
+    baselineBlastRadius: SingularBlastRadius;
+    recommendation: SingularRecommendation;
+    recommendationReason: string;
+    stageFit?: SingularStageFit;
+    stageFitReason?: string;
+    impactAnalysis?: SingularImpactAnalysis;
+    contractSignals: string[];
+    options: SingularOption[];
+}
+export interface SingularLastRun {
+    runId: string;
+    analysisPath: string;
+    metaPath?: string;
+    request?: string;
+    recommendation?: SingularRecommendation;
+    generatedAt?: string;
+}
+export interface SingularAnalyzeOptions {
+    request: string;
+    contract?: EngineeringContract;
+    autosave?: boolean;
+}
+export interface SingularServiceOptions {
+    cwd: string;
+}
+export declare class SingularService {
+    private readonly cwd;
+    constructor(options: SingularServiceOptions);
+    getAnalysesRoot(): string;
+    getLastRun(): SingularLastRun | undefined;
+    analyze(options: SingularAnalyzeOptions): Promise<SingularAnalysisResult>;
+    saveAnalysis(result: SingularAnalysisResult): void;
+    private saveRunArtifacts;
+    private scanRepository;
+    private walkFiles;
+    private collectContractSignals;
+    private estimateComplexityScore;
+    private buildRecommendation;
+    private buildOptions;
+}
+//# sourceMappingURL=singular.d.ts.map

package/dist/core/singular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singular.d.ts","sourceRoot":"","sources":["../../src/core/singular.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,yBAAyB,GAAG,OAAO,CAAC;AAC3F,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,EAAE,mBAAmB,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,cAAc,EAAE,sBAAsB,CAAC;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAC;CACZ;AAoGD,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,EAAE,sBAAsB;IAI3C,eAAe,IAAI,MAAM;IAIzB,UAAU,IAAI,eAAe,GAAG,SAAS;IA4CnC,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAoD/E,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAIlD,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,YAAY;CAmEpB"}