iosm-cli 0.1.2 → 0.2.0

package/dist/core/singular.js

@@ -0,0 +1,413 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, join, relative, sep } from "node:path";
+const SCAN_TEXT_EXTENSIONS = new Set([
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".py",
+    ".go",
+    ".rs",
+    ".java",
+    ".json",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".md",
+    ".sh",
+    ".sql",
+    ".html",
+    ".css",
+]);
+const EXCLUDED_DIR_NAMES = new Set([".git", "node_modules", "dist", "build", ".iosm", ".next", "coverage"]);
+const STOP_WORDS = new Set([
+    "a",
+    "an",
+    "the",
+    "and",
+    "or",
+    "for",
+    "with",
+    "from",
+    "into",
+    "about",
+    "что",
+    "как",
+    "для",
+    "это",
+    "надо",
+    "нужно",
+    "добавить",
+    "сделать",
+    "функционал",
+    "feature",
+    "implement",
+    "add",
+]);
+function toPosixPath(value) {
+    return value.split(sep).join("/");
+}
+function getExtension(filePath) {
+    const normalized = filePath.toLowerCase();
+    const index = normalized.lastIndexOf(".");
+    return index >= 0 ? normalized.slice(index) : "";
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function buildRunId(date = new Date()) {
+    const year = date.getUTCFullYear();
+    const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(date.getUTCDate()).padStart(2, "0");
+    const hours = String(date.getUTCHours()).padStart(2, "0");
+    const minutes = String(date.getUTCMinutes()).padStart(2, "0");
+    const seconds = String(date.getUTCSeconds()).padStart(2, "0");
+    return `${year}-${month}-${day}-${hours}${minutes}${seconds}`;
+}
+function normalizeRequestTokens(request) {
+    return request
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}]+/u)
+        .map((token) => token.trim())
+        .filter((token) => token.length >= 3 && !STOP_WORDS.has(token));
+}
+function scoreToComplexity(score) {
+    if (score >= 4)
+        return "high";
+    if (score >= 2)
+        return "medium";
+    return "low";
+}
+function scoreToBlastRadius(score) {
+    if (score >= 4)
+        return "high";
+    if (score >= 2)
+        return "medium";
+    return "low";
+}
+function defaultSuggestedFiles(matches) {
+    if (matches.length > 0)
+        return matches.slice(0, 6);
+    return ["src/**/*", "test/**/*"];
+}
+export class SingularService {
+    constructor(options) {
+        this.cwd = options.cwd;
+    }
+    getAnalysesRoot() {
+        return join(this.cwd, ".iosm", "singular");
+    }
+    getLastRun() {
+        const root = this.getAnalysesRoot();
+        if (!existsSync(root))
+            return undefined;
+        const candidates = readdirSync(root, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort((a, b) => a.localeCompare(b));
+        const runId = candidates[candidates.length - 1];
+        if (!runId)
+            return undefined;
+        const runDir = join(root, runId);
+        const analysisPath = join(runDir, "analysis.json");
+        if (!existsSync(analysisPath))
+            return undefined;
+        const metaPath = join(runDir, "meta.json");
+        let request;
+        let recommendation;
+        let generatedAt;
+        if (existsSync(metaPath)) {
+            try {
+                const parsed = JSON.parse(readFileSync(metaPath, "utf8"));
+                request = typeof parsed.request === "string" ? parsed.request : undefined;
+                recommendation =
+                    parsed.recommendation === "implement_now" ||
+                        parsed.recommendation === "implement_incrementally" ||
+                        parsed.recommendation === "defer"
+                        ? parsed.recommendation
+                        : undefined;
+                generatedAt = typeof parsed.generatedAt === "string" ? parsed.generatedAt : undefined;
+            }
+            catch {
+                // metadata is optional
+            }
+        }
+        return {
+            runId,
+            analysisPath,
+            metaPath: existsSync(metaPath) ? metaPath : undefined,
+            request,
+            recommendation,
+            generatedAt,
+        };
+    }
+    async analyze(options) {
+        const request = options.request.trim();
+        const contract = options.contract ?? {};
+        const autosave = options.autosave !== false;
+        const runId = buildRunId();
+        const generatedAt = nowIso();
+        const scan = this.scanRepository(request);
+        const contractSignals = this.collectContractSignals(contract);
+        const baselineScore = this.estimateComplexityScore(request, scan.matchedFiles.length, scan.testFiles, contractSignals.length);
+        const baselineComplexity = scoreToComplexity(baselineScore);
+        const baselineBlastRadius = scoreToBlastRadius(baselineScore + (scan.matchedFiles.length >= 5 ? 1 : 0));
+        const recommendation = this.buildRecommendation({
+            request,
+            baselineComplexity,
+            testFiles: scan.testFiles,
+            matchedFiles: scan.matchedFiles.length,
+        });
+        const suggestedFiles = defaultSuggestedFiles(scan.matchedFiles);
+        const optionsList = this.buildOptions({
+            request,
+            baselineComplexity,
+            baselineBlastRadius,
+            suggestedFiles,
+            contractSignals,
+        });
+        const result = {
+            runId,
+            request,
+            generatedAt,
+            scannedFiles: scan.scannedFiles,
+            sourceFiles: scan.sourceFiles,
+            testFiles: scan.testFiles,
+            matchedFiles: scan.matchedFiles,
+            baselineComplexity,
+            baselineBlastRadius,
+            recommendation: recommendation.value,
+            recommendationReason: recommendation.reason,
+            contractSignals,
+            options: optionsList,
+        };
+        if (autosave) {
+            this.saveRunArtifacts(result);
+        }
+        return result;
+    }
+    saveAnalysis(result) {
+        this.saveRunArtifacts(result);
+    }
+    saveRunArtifacts(result) {
+        const runDir = join(this.getAnalysesRoot(), result.runId);
+        mkdirSync(runDir, { recursive: true });
+        const analysisPath = join(runDir, "analysis.json");
+        const metaPath = join(runDir, "meta.json");
+        writeFileSync(analysisPath, `${JSON.stringify(result, null, 2)}\n`, "utf8");
+        writeFileSync(metaPath, `${JSON.stringify({
+            runId: result.runId,
+            generatedAt: result.generatedAt,
+            request: result.request,
+            recommendation: result.recommendation,
+            stageFit: result.stageFit,
+            baselineComplexity: result.baselineComplexity,
+            baselineBlastRadius: result.baselineBlastRadius,
+        }, null, 2)}\n`, "utf8");
+    }
+    scanRepository(request) {
+        const files = this.walkFiles();
+        const tokens = normalizeRequestTokens(request);
+        const scored = files
+            .map((absolutePath) => {
+            const relativePath = toPosixPath(relative(this.cwd, absolutePath));
+            const normalizedPath = relativePath.toLowerCase();
+            const fileName = basename(relativePath).toLowerCase();
+            let score = 0;
+            for (const token of tokens) {
+                if (normalizedPath.includes(token))
+                    score += 1;
+                if (fileName.includes(token))
+                    score += 2;
+            }
+            if (/auth|account|profile|cabinet|dashboard|billing|payment/i.test(request) && /auth|user|account|profile|billing|payment|dashboard/i.test(normalizedPath)) {
+                score += 1;
+            }
+            return { relativePath, score };
+        })
+            .filter((item) => item.score > 0)
+            .sort((a, b) => b.score - a.score || a.relativePath.localeCompare(b.relativePath));
+        const matchedFiles = scored.slice(0, 10).map((item) => item.relativePath);
+        const sourceFiles = files.filter((absolutePath) => {
+            const rel = toPosixPath(relative(this.cwd, absolutePath));
+            return rel.startsWith("src/") || rel.startsWith("app/") || rel.startsWith("packages/");
+        }).length;
+        const testFiles = files.filter((absolutePath) => {
+            const rel = toPosixPath(relative(this.cwd, absolutePath)).toLowerCase();
+            return /(^|\/)(test|tests|__tests__)\//.test(rel) || /\.test\./.test(rel) || /\.spec\./.test(rel);
+        }).length;
+        return {
+            scannedFiles: files.length,
+            sourceFiles,
+            testFiles,
+            matchedFiles,
+        };
+    }
+    walkFiles() {
+        const maxFiles = 12_000;
+        const stack = [this.cwd];
+        const files = [];
+        while (stack.length > 0 && files.length < maxFiles) {
+            const dir = stack.pop();
+            if (!dir)
+                break;
+            let entries;
+            try {
+                entries = readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                const absolutePath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (EXCLUDED_DIR_NAMES.has(entry.name))
+                        continue;
+                    stack.push(absolutePath);
+                    continue;
+                }
+                if (!entry.isFile())
+                    continue;
+                if (!SCAN_TEXT_EXTENSIONS.has(getExtension(entry.name)))
+                    continue;
+                try {
+                    if (statSync(absolutePath).size > 800_000)
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                files.push(absolutePath);
+                if (files.length >= maxFiles)
+                    break;
+            }
+        }
+        return files.sort((a, b) => a.localeCompare(b));
+    }
+    collectContractSignals(contract) {
+        const signals = [];
+        if (contract.goal)
+            signals.push(`goal=${contract.goal}`);
+        if ((contract.constraints ?? []).length > 0)
+            signals.push(`constraints=${contract.constraints?.length ?? 0}`);
+        if ((contract.quality_gates ?? []).length > 0)
+            signals.push(`quality_gates=${contract.quality_gates?.length ?? 0}`);
+        if ((contract.definition_of_done ?? []).length > 0) {
+            signals.push(`definition_of_done=${contract.definition_of_done?.length ?? 0}`);
+        }
+        if ((contract.non_goals ?? []).length > 0)
+            signals.push(`non_goals=${contract.non_goals?.length ?? 0}`);
+        if ((contract.risks ?? []).length > 0)
+            signals.push(`risks=${contract.risks?.length ?? 0}`);
+        return signals.slice(0, 8);
+    }
+    estimateComplexityScore(request, matchedFiles, testFiles, contractSignalCount) {
+        let score = 1;
+        const normalized = request.toLowerCase();
+        if (request.length > 70)
+            score += 1;
+        if (matchedFiles >= 5)
+            score += 1;
+        if (matchedFiles >= 8)
+            score += 1;
+        if (testFiles === 0)
+            score += 1;
+        if (contractSignalCount >= 3)
+            score += 1;
+        if (/(migration|refactor|rewrite|billing|payment|security|permission|rbac|role|distributed|event|queue|microservice|oauth|sso|регресс|миграц|рефактор|безопасност|права|роли)/.test(normalized)) {
+            score += 1;
+        }
+        if (/(asap|urgent|критично|срочно|немедленно)/.test(normalized)) {
+            score += 1;
+        }
+        return Math.min(6, score);
+    }
+    buildRecommendation(payload) {
+        const normalized = payload.request.toLowerCase();
+        const urgent = /(asap|urgent|критично|срочно|немедленно)/.test(normalized);
+        if (payload.baselineComplexity === "high" && payload.testFiles === 0) {
+            return {
+                value: "defer",
+                reason: "High complexity with no tests in place. Build a safety net and design first.",
+            };
+        }
+        if (payload.baselineComplexity === "high" || payload.matchedFiles >= 7) {
+            return {
+                value: "implement_incrementally",
+                reason: "The change touches multiple areas. Prefer incremental rollout via an MVP slice.",
+            };
+        }
+        if (urgent) {
+            return {
+                value: "implement_now",
+                reason: "The request is urgent and risk appears manageable. Implement now with a constrained scope.",
+            };
+        }
+        return {
+            value: "implement_now",
+            reason: "Complexity is manageable. Implement now while enforcing quality gates.",
+        };
+    }
+    buildOptions(payload) {
+        const compactFiles = payload.suggestedFiles.slice(0, 6);
+        const broadFiles = payload.suggestedFiles.length > 0 ? payload.suggestedFiles : ["src/**/*", "test/**/*"];
+        const contractGateStep = payload.contractSignals.length > 0
+            ? "Validate contract constraints and quality gates before merge."
+            : "Define explicit quality gates and Definition of Done before rollout.";
+        return [
+            {
+                id: "1",
+                title: "Incremental MVP",
+                summary: "Deliver a minimal usable feature slice quickly with measurable outcomes.",
+                complexity: payload.baselineComplexity === "high" ? "medium" : payload.baselineComplexity,
+                blast_radius: payload.baselineBlastRadius === "high" ? "medium" : payload.baselineBlastRadius,
+                suggested_files: compactFiles,
+                plan: [
+                    "Lock the minimum scope and explicitly exclude non-goals.",
+                    "Implement in 1-2 target areas without cascading refactors.",
+                    "Add smoke/regression tests for the new flow.",
+                    contractGateStep,
+                ],
+                pros: ["Fast time-to-value", "Controlled risk", "Easy rollback"],
+                cons: ["Some UX/infrastructure remains for the next phase"],
+                when_to_choose: "Choose when you need delivery this sprint with controlled blast radius.",
+            },
+            {
+                id: "2",
+                title: "Comprehensive implementation",
+                summary: "Ship the full feature with infrastructure, edge cases, and API expansion.",
+                complexity: "high",
+                blast_radius: "high",
+                suggested_files: broadFiles,
+                plan: [
+                    "Design architecture and module boundaries before coding.",
+                    "Implement domain logic, API/UI layers, and persistence.",
+                    "Cover behavior with integration and contract tests.",
+                    "Roll out in stages with feature flags and metrics.",
+                ],
+                pros: ["Delivers the full capability", "Lower technical debt after release"],
+                cons: ["Higher cost and regression risk", "Requires longer review and test cycle"],
+                when_to_choose: "Choose when this is a strategic milestone and you can afford larger scope.",
+            },
+            {
+                id: "3",
+                title: "Defer implementation",
+                summary: "Do not code now; prepare design, risk map, and migration plan first.",
+                complexity: "low",
+                blast_radius: "low",
+                suggested_files: [],
+                plan: [
+                    "Prepare technical design and impacted-area map.",
+                    "Define readiness criteria and implementation risks.",
+                    "Resume implementation after dependencies are cleared.",
+                ],
+                pros: ["Minimal immediate risk", "Clear plan before coding"],
+                cons: ["Feature is not delivered in current release window"],
+                when_to_choose: "Choose when prerequisites are missing or risk is too high this cycle.",
+            },
+        ];
+    }
+}
+//# sourceMappingURL=singular.js.map

package/dist/core/singular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singular.js","sourceRoot":"","sources":["../../src/core/singular.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from \"node:fs\";\nimport { basename, join, relative, sep } from \"node:path\";\nimport type { EngineeringContract } from \"./contract.js\";\n\nexport type SingularComplexity = \"low\" | \"medium\" | \"high\";\nexport type SingularBlastRadius = \"low\" | \"medium\" | \"high\";\nexport type SingularRecommendation = \"implement_now\" | \"implement_incrementally\" | \"defer\";\nexport type SingularStageFit = \"needed_now\" | \"optional_now\" | \"later\";\n\nexport interface SingularImpactAnalysis {\n\tcodebase: string;\n\tdelivery: string;\n\trisks: string;\n\toperations: string;\n}\n\nexport interface SingularOption {\n\tid: string;\n\ttitle: string;\n\tsummary: string;\n\tcomplexity: SingularComplexity;\n\tblast_radius: SingularBlastRadius;\n\tsuggested_files: string[];\n\tplan: string[];\n\tpros: string[];\n\tcons: string[];\n\twhen_to_choose?: string;\n}\n\nexport interface SingularAnalysisResult {\n\trunId: string;\n\trequest: string;\n\tgeneratedAt: string;\n\tscannedFiles: number;\n\tsourceFiles: number;\n\ttestFiles: number;\n\tmatchedFiles: string[];\n\tbaselineComplexity: SingularComplexity;\n\tbaselineBlastRadius: SingularBlastRadius;\n\trecommendation: SingularRecommendation;\n\trecommendationReason: string;\n\tstageFit?: SingularStageFit;\n\tstageFitReason?: string;\n\timpactAnalysis?: SingularImpactAnalysis;\n\tcontractSignals: string[];\n\toptions: SingularOption[];\n}\n\nexport interface SingularLastRun {\n\trunId: string;\n\tanalysisPath: string;\n\tmetaPath?: string;\n\trequest?: string;\n\trecommendation?: SingularRecommendation;\n\tgeneratedAt?: string;\n}\n\nexport interface SingularAnalyzeOptions {\n\trequest: string;\n\tcontract?: EngineeringContract;\n\tautosave?: boolean;\n}\n\nexport interface SingularServiceOptions {\n\tcwd: string;\n}\n\nconst SCAN_TEXT_EXTENSIONS = new Set([\n\t\".ts\",\n\t\".tsx\",\n\t\".js\",\n\t\".jsx\",\n\t\".mjs\",\n\t\".cjs\",\n\t\".py\",\n\t\".go\",\n\t\".rs\",\n\t\".java\",\n\t\".json\",\n\t\".yaml\",\n\t\".yml\",\n\t\".toml\",\n\t\".md\",\n\t\".sh\",\n\t\".sql\",\n\t\".html\",\n\t\".css\",\n]);\n\nconst EXCLUDED_DIR_NAMES = new Set([\".git\", \"node_modules\", \"dist\", \"build\", \".iosm\", \".next\", \"coverage\"]);\n\nconst STOP_WORDS = new Set([\n\t\"a\",\n\t\"an\",\n\t\"the\",\n\t\"and\",\n\t\"or\",\n\t\"for\",\n\t\"with\",\n\t\"from\",\n\t\"into\",\n\t\"about\",\n\t\"что\",\n\t\"как\",\n\t\"для\",\n\t\"это\",\n\t\"надо\",\n\t\"нужно\",\n\t\"добавить\",\n\t\"сделать\",\n\t\"функционал\",\n\t\"feature\",\n\t\"implement\",\n\t\"add\",\n]);\n\nfunction toPosixPath(value: string): string {\n\treturn value.split(sep).join(\"/\");\n}\n\nfunction getExtension(filePath: string): string {\n\tconst normalized = filePath.toLowerCase();\n\tconst index = normalized.lastIndexOf(\".\");\n\treturn index >= 0 ? normalized.slice(index) : \"\";\n}\n\nfunction nowIso(): string {\n\treturn new Date().toISOString();\n}\n\nfunction buildRunId(date = new Date()): string {\n\tconst year = date.getUTCFullYear();\n\tconst month = String(date.getUTCMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getUTCDate()).padStart(2, \"0\");\n\tconst hours = String(date.getUTCHours()).padStart(2, \"0\");\n\tconst minutes = String(date.getUTCMinutes()).padStart(2, \"0\");\n\tconst seconds = String(date.getUTCSeconds()).padStart(2, \"0\");\n\treturn `${year}-${month}-${day}-${hours}${minutes}${seconds}`;\n}\n\nfunction normalizeRequestTokens(request: string): string[] {\n\treturn request\n\t\t.toLowerCase()\n\t\t.split(/[^\\p{L}\\p{N}]+/u)\n\t\t.map((token) => token.trim())\n\t\t.filter((token) => token.length >= 3 && !STOP_WORDS.has(token));\n}\n\nfunction scoreToComplexity(score: number): SingularComplexity {\n\tif (score >= 4) return \"high\";\n\tif (score >= 2) return \"medium\";\n\treturn \"low\";\n}\n\nfunction scoreToBlastRadius(score: number): SingularBlastRadius {\n\tif (score >= 4) return \"high\";\n\tif (score >= 2) return \"medium\";\n\treturn \"low\";\n}\n\nfunction defaultSuggestedFiles(matches: string[]): string[] {\n\tif (matches.length > 0) return matches.slice(0, 6);\n\treturn [\"src/**/*\", \"test/**/*\"];\n}\n\nexport class SingularService {\n\tprivate readonly cwd: string;\n\n\tconstructor(options: SingularServiceOptions) {\n\t\tthis.cwd = options.cwd;\n\t}\n\n\tgetAnalysesRoot(): string {\n\t\treturn join(this.cwd, \".iosm\", \"singular\");\n\t}\n\n\tgetLastRun(): SingularLastRun | undefined {\n\t\tconst root = this.getAnalysesRoot();\n\t\tif (!existsSync(root)) return undefined;\n\t\tconst candidates = readdirSync(root, { withFileTypes: true })\n\t\t\t.filter((entry) => entry.isDirectory())\n\t\t\t.map((entry) => entry.name)\n\t\t\t.sort((a, b) => a.localeCompare(b));\n\t\tconst runId = candidates[candidates.length - 1];\n\t\tif (!runId) return undefined;\n\n\t\tconst runDir = join(root, runId);\n\t\tconst analysisPath = join(runDir, \"analysis.json\");\n\t\tif (!existsSync(analysisPath)) return undefined;\n\t\tconst metaPath = join(runDir, \"meta.json\");\n\n\t\tlet request: string | undefined;\n\t\tlet recommendation: SingularRecommendation | undefined;\n\t\tlet generatedAt: string | undefined;\n\t\tif (existsSync(metaPath)) {\n\t\t\ttry {\n\t\t\t\tconst parsed = JSON.parse(readFileSync(metaPath, \"utf8\")) as Record<string, unknown>;\n\t\t\t\trequest = typeof parsed.request === \"string\" ? parsed.request : undefined;\n\t\t\t\trecommendation =\n\t\t\t\t\tparsed.recommendation === \"implement_now\" ||\n\t\t\t\t\tparsed.recommendation === \"implement_incrementally\" ||\n\t\t\t\t\tparsed.recommendation === \"defer\"\n\t\t\t\t\t\t? (parsed.recommendation as SingularRecommendation)\n\t\t\t\t\t\t: undefined;\n\t\t\t\tgeneratedAt = typeof parsed.generatedAt === \"string\" ? parsed.generatedAt : undefined;\n\t\t\t} catch {\n\t\t\t\t// metadata is optional\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\trunId,\n\t\t\tanalysisPath,\n\t\t\tmetaPath: existsSync(metaPath) ? metaPath : undefined,\n\t\t\trequest,\n\t\t\trecommendation,\n\t\t\tgeneratedAt,\n\t\t};\n\t}\n\n\tasync analyze(options: SingularAnalyzeOptions): Promise<SingularAnalysisResult> {\n\t\tconst request = options.request.trim();\n\t\tconst contract = options.contract ?? {};\n\t\tconst autosave = options.autosave !== false;\n\t\tconst runId = buildRunId();\n\t\tconst generatedAt = nowIso();\n\n\t\tconst scan = this.scanRepository(request);\n\t\tconst contractSignals = this.collectContractSignals(contract);\n\t\tconst baselineScore = this.estimateComplexityScore(request, scan.matchedFiles.length, scan.testFiles, contractSignals.length);\n\t\tconst baselineComplexity = scoreToComplexity(baselineScore);\n\t\tconst baselineBlastRadius = scoreToBlastRadius(baselineScore + (scan.matchedFiles.length >= 5 ? 1 : 0));\n\n\t\tconst recommendation = this.buildRecommendation({\n\t\t\trequest,\n\t\t\tbaselineComplexity,\n\t\t\ttestFiles: scan.testFiles,\n\t\t\tmatchedFiles: scan.matchedFiles.length,\n\t\t});\n\n\t\tconst suggestedFiles = defaultSuggestedFiles(scan.matchedFiles);\n\t\tconst optionsList = this.buildOptions({\n\t\t\trequest,\n\t\t\tbaselineComplexity,\n\t\t\tbaselineBlastRadius,\n\t\t\tsuggestedFiles,\n\t\t\tcontractSignals,\n\t\t});\n\n\t\tconst result: SingularAnalysisResult = {\n\t\t\trunId,\n\t\t\trequest,\n\t\t\tgeneratedAt,\n\t\t\tscannedFiles: scan.scannedFiles,\n\t\t\tsourceFiles: scan.sourceFiles,\n\t\t\ttestFiles: scan.testFiles,\n\t\t\tmatchedFiles: scan.matchedFiles,\n\t\t\tbaselineComplexity,\n\t\t\tbaselineBlastRadius,\n\t\t\trecommendation: recommendation.value,\n\t\t\trecommendationReason: recommendation.reason,\n\t\t\tcontractSignals,\n\t\t\toptions: optionsList,\n\t\t};\n\n\t\tif (autosave) {\n\t\t\tthis.saveRunArtifacts(result);\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tsaveAnalysis(result: SingularAnalysisResult): void {\n\t\tthis.saveRunArtifacts(result);\n\t}\n\n\tprivate saveRunArtifacts(result: SingularAnalysisResult): void {\n\t\tconst runDir = join(this.getAnalysesRoot(), result.runId);\n\t\tmkdirSync(runDir, { recursive: true });\n\n\t\tconst analysisPath = join(runDir, \"analysis.json\");\n\t\tconst metaPath = join(runDir, \"meta.json\");\n\n\t\twriteFileSync(analysisPath, `${JSON.stringify(result, null, 2)}\\n`, \"utf8\");\n\t\twriteFileSync(\n\t\t\tmetaPath,\n\t\t\t`${JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\trunId: result.runId,\n\t\t\t\t\tgeneratedAt: result.generatedAt,\n\t\t\t\t\trequest: result.request,\n\t\t\t\t\trecommendation: result.recommendation,\n\t\t\t\t\tstageFit: result.stageFit,\n\t\t\t\t\tbaselineComplexity: result.baselineComplexity,\n\t\t\t\t\tbaselineBlastRadius: result.baselineBlastRadius,\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t)}\\n`,\n\t\t\t\"utf8\",\n\t\t);\n\t}\n\n\tprivate scanRepository(request: string): {\n\t\tscannedFiles: number;\n\t\tsourceFiles: number;\n\t\ttestFiles: number;\n\t\tmatchedFiles: string[];\n\t} {\n\t\tconst files = this.walkFiles();\n\t\tconst tokens = normalizeRequestTokens(request);\n\t\tconst scored = files\n\t\t\t.map((absolutePath) => {\n\t\t\t\tconst relativePath = toPosixPath(relative(this.cwd, absolutePath));\n\t\t\t\tconst normalizedPath = relativePath.toLowerCase();\n\t\t\t\tconst fileName = basename(relativePath).toLowerCase();\n\n\t\t\t\tlet score = 0;\n\t\t\t\tfor (const token of tokens) {\n\t\t\t\t\tif (normalizedPath.includes(token)) score += 1;\n\t\t\t\t\tif (fileName.includes(token)) score += 2;\n\t\t\t\t}\n\n\t\t\t\tif (/auth|account|profile|cabinet|dashboard|billing|payment/i.test(request) && /auth|user|account|profile|billing|payment|dashboard/i.test(normalizedPath)) {\n\t\t\t\t\tscore += 1;\n\t\t\t\t}\n\n\t\t\t\treturn { relativePath, score };\n\t\t\t})\n\t\t\t.filter((item) => item.score > 0)\n\t\t\t.sort((a, b) => b.score - a.score || a.relativePath.localeCompare(b.relativePath));\n\n\t\tconst matchedFiles = scored.slice(0, 10).map((item) => item.relativePath);\n\t\tconst sourceFiles = files.filter((absolutePath) => {\n\t\t\tconst rel = toPosixPath(relative(this.cwd, absolutePath));\n\t\t\treturn rel.startsWith(\"src/\") || rel.startsWith(\"app/\") || rel.startsWith(\"packages/\");\n\t\t}).length;\n\t\tconst testFiles = files.filter((absolutePath) => {\n\t\t\tconst rel = toPosixPath(relative(this.cwd, absolutePath)).toLowerCase();\n\t\t\treturn /(^|\\/)(test|tests|__tests__)\\//.test(rel) || /\\.test\\./.test(rel) || /\\.spec\\./.test(rel);\n\t\t}).length;\n\n\t\treturn {\n\t\t\tscannedFiles: files.length,\n\t\t\tsourceFiles,\n\t\t\ttestFiles,\n\t\t\tmatchedFiles,\n\t\t};\n\t}\n\n\tprivate walkFiles(): string[] {\n\t\tconst maxFiles = 12_000;\n\t\tconst stack = [this.cwd];\n\t\tconst files: string[] = [];\n\n\t\twhile (stack.length > 0 && files.length < maxFiles) {\n\t\t\tconst dir = stack.pop();\n\t\t\tif (!dir) break;\n\n\t\t\tlet entries;\n\t\t\ttry {\n\t\t\t\tentries = readdirSync(dir, { withFileTypes: true });\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tfor (const entry of entries) {\n\t\t\t\tconst absolutePath = join(dir, entry.name);\n\t\t\t\tif (entry.isDirectory()) {\n\t\t\t\t\tif (EXCLUDED_DIR_NAMES.has(entry.name)) continue;\n\t\t\t\t\tstack.push(absolutePath);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (!entry.isFile()) continue;\n\t\t\t\tif (!SCAN_TEXT_EXTENSIONS.has(getExtension(entry.name))) continue;\n\t\t\t\ttry {\n\t\t\t\t\tif (statSync(absolutePath).size > 800_000) continue;\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tfiles.push(absolutePath);\n\t\t\t\tif (files.length >= maxFiles) break;\n\t\t\t}\n\t\t}\n\n\t\treturn files.sort((a, b) => a.localeCompare(b));\n\t}\n\n\tprivate collectContractSignals(contract: EngineeringContract): string[] {\n\t\tconst signals: string[] = [];\n\t\tif (contract.goal) signals.push(`goal=${contract.goal}`);\n\t\tif ((contract.constraints ?? []).length > 0) signals.push(`constraints=${contract.constraints?.length ?? 0}`);\n\t\tif ((contract.quality_gates ?? []).length > 0) signals.push(`quality_gates=${contract.quality_gates?.length ?? 0}`);\n\t\tif ((contract.definition_of_done ?? []).length > 0) {\n\t\t\tsignals.push(`definition_of_done=${contract.definition_of_done?.length ?? 0}`);\n\t\t}\n\t\tif ((contract.non_goals ?? []).length > 0) signals.push(`non_goals=${contract.non_goals?.length ?? 0}`);\n\t\tif ((contract.risks ?? []).length > 0) signals.push(`risks=${contract.risks?.length ?? 0}`);\n\t\treturn signals.slice(0, 8);\n\t}\n\n\tprivate estimateComplexityScore(\n\t\trequest: string,\n\t\tmatchedFiles: number,\n\t\ttestFiles: number,\n\t\tcontractSignalCount: number,\n\t): number {\n\t\tlet score = 1;\n\t\tconst normalized = request.toLowerCase();\n\n\t\tif (request.length > 70) score += 1;\n\t\tif (matchedFiles >= 5) score += 1;\n\t\tif (matchedFiles >= 8) score += 1;\n\t\tif (testFiles === 0) score += 1;\n\t\tif (contractSignalCount >= 3) score += 1;\n\n\t\tif (\n\t\t\t/(migration|refactor|rewrite|billing|payment|security|permission|rbac|role|distributed|event|queue|microservice|oauth|sso|регресс|миграц|рефактор|безопасност|права|роли)/.test(\n\t\t\t\tnormalized,\n\t\t\t)\n\t\t) {\n\t\t\tscore += 1;\n\t\t}\n\n\t\tif (/(asap|urgent|критично|срочно|немедленно)/.test(normalized)) {\n\t\t\tscore += 1;\n\t\t}\n\n\t\treturn Math.min(6, score);\n\t}\n\n\tprivate buildRecommendation(payload: {\n\t\trequest: string;\n\t\tbaselineComplexity: SingularComplexity;\n\t\ttestFiles: number;\n\t\tmatchedFiles: number;\n\t}): { value: SingularRecommendation; reason: string } {\n\t\tconst normalized = payload.request.toLowerCase();\n\t\tconst urgent = /(asap|urgent|критично|срочно|немедленно)/.test(normalized);\n\n\t\tif (payload.baselineComplexity === \"high\" && payload.testFiles === 0) {\n\t\t\treturn {\n\t\t\t\tvalue: \"defer\",\n\t\t\t\treason: \"High complexity with no tests in place. Build a safety net and design first.\",\n\t\t\t};\n\t\t}\n\t\tif (payload.baselineComplexity === \"high\" || payload.matchedFiles >= 7) {\n\t\t\treturn {\n\t\t\t\tvalue: \"implement_incrementally\",\n\t\t\t\treason: \"The change touches multiple areas. Prefer incremental rollout via an MVP slice.\",\n\t\t\t};\n\t\t}\n\t\tif (urgent) {\n\t\t\treturn {\n\t\t\t\tvalue: \"implement_now\",\n\t\t\t\treason: \"The request is urgent and risk appears manageable. Implement now with a constrained scope.\",\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tvalue: \"implement_now\",\n\t\t\treason: \"Complexity is manageable. Implement now while enforcing quality gates.\",\n\t\t};\n\t}\n\n\tprivate buildOptions(payload: {\n\t\trequest: string;\n\t\tbaselineComplexity: SingularComplexity;\n\t\tbaselineBlastRadius: SingularBlastRadius;\n\t\tsuggestedFiles: string[];\n\t\tcontractSignals: string[];\n\t}): SingularOption[] {\n\t\tconst compactFiles = payload.suggestedFiles.slice(0, 6);\n\t\tconst broadFiles = payload.suggestedFiles.length > 0 ? payload.suggestedFiles : [\"src/**/*\", \"test/**/*\"];\n\t\tconst contractGateStep =\n\t\t\tpayload.contractSignals.length > 0\n\t\t\t\t? \"Validate contract constraints and quality gates before merge.\"\n\t\t\t\t: \"Define explicit quality gates and Definition of Done before rollout.\";\n\n\t\treturn [\n\t\t\t{\n\t\t\t\tid: \"1\",\n\t\t\t\ttitle: \"Incremental MVP\",\n\t\t\t\tsummary: \"Deliver a minimal usable feature slice quickly with measurable outcomes.\",\n\t\t\t\tcomplexity: payload.baselineComplexity === \"high\" ? \"medium\" : payload.baselineComplexity,\n\t\t\t\tblast_radius: payload.baselineBlastRadius === \"high\" ? \"medium\" : payload.baselineBlastRadius,\n\t\t\t\tsuggested_files: compactFiles,\n\t\t\t\tplan: [\n\t\t\t\t\t\"Lock the minimum scope and explicitly exclude non-goals.\",\n\t\t\t\t\t\"Implement in 1-2 target areas without cascading refactors.\",\n\t\t\t\t\t\"Add smoke/regression tests for the new flow.\",\n\t\t\t\t\tcontractGateStep,\n\t\t\t\t],\n\t\t\t\tpros: [\"Fast time-to-value\", \"Controlled risk\", \"Easy rollback\"],\n\t\t\t\tcons: [\"Some UX/infrastructure remains for the next phase\"],\n\t\t\t\twhen_to_choose: \"Choose when you need delivery this sprint with controlled blast radius.\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: \"2\",\n\t\t\t\ttitle: \"Comprehensive implementation\",\n\t\t\t\tsummary: \"Ship the full feature with infrastructure, edge cases, and API expansion.\",\n\t\t\t\tcomplexity: \"high\",\n\t\t\t\tblast_radius: \"high\",\n\t\t\t\tsuggested_files: broadFiles,\n\t\t\t\tplan: [\n\t\t\t\t\t\"Design architecture and module boundaries before coding.\",\n\t\t\t\t\t\"Implement domain logic, API/UI layers, and persistence.\",\n\t\t\t\t\t\"Cover behavior with integration and contract tests.\",\n\t\t\t\t\t\"Roll out in stages with feature flags and metrics.\",\n\t\t\t\t],\n\t\t\t\tpros: [\"Delivers the full capability\", \"Lower technical debt after release\"],\n\t\t\t\tcons: [\"Higher cost and regression risk\", \"Requires longer review and test cycle\"],\n\t\t\t\twhen_to_choose: \"Choose when this is a strategic milestone and you can afford larger scope.\",\n\t\t\t},\n\t\t\t{\n\t\t\t\tid: \"3\",\n\t\t\t\ttitle: \"Defer implementation\",\n\t\t\t\tsummary: \"Do not code now; prepare design, risk map, and migration plan first.\",\n\t\t\t\tcomplexity: \"low\",\n\t\t\t\tblast_radius: \"low\",\n\t\t\t\tsuggested_files: [],\n\t\t\t\tplan: [\n\t\t\t\t\t\"Prepare technical design and impacted-area map.\",\n\t\t\t\t\t\"Define readiness criteria and implementation risks.\",\n\t\t\t\t\t\"Resume implementation after dependencies are cleared.\",\n\t\t\t\t],\n\t\t\t\tpros: [\"Minimal immediate risk\", \"Clear plan before coding\"],\n\t\t\t\tcons: [\"Feature is not delivered in current release window\"],\n\t\t\t\twhen_to_choose: \"Choose when prerequisites are missing or risk is too high this cycle.\",\n\t\t\t},\n\t\t];\n\t}\n}\n"]}

package/dist/core/slash-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,mBAAmB,CAsErE,CAAC"}
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,mBAAmB,CAqFrE,CAAC"}

package/dist/core/slash-commands.js

@@ -31,6 +31,18 @@ export const BUILTIN_SLASH_COMMANDS = [
         name: "memory",
         description: "Memory manager: /memory (interactive), /memory <text>, /memory edit <index> <text>, /memory rm <index>",
     },
+    {
+        name: "semantic",
+        description: "Semantic search manager: /semantic (interactive UI), /semantic setup|auto-index|status|index|rebuild|query <text> [--top-k N]",
+    },
+    {
+        name: "contract",
+        description: "Engineering contract manager: /contract (interactive field editor), /contract show|edit|clear --scope <project|session>",
+    },
+    {
+        name: "singular",
+        description: "Feature feasibility analyzer: /singular <request> (builds implementation options and recommendations)",
+    },
     { name: "settings", description: "Open settings menu" },
     {
         name: "permissions",

package/dist/core/slash-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACzE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0EAA0E,EAAE;IACzG;QACC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0FAA0F;KACvG;IACD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,4MAA4M;KAC7M;IACD;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EACV,qHAAqH;KACtH;IACD,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,qDAAqD,EAAE;IAC7F;QACC,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,yGAAyG;KACtH;IACD,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,gEAAgE,EAAE;IACpG,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,0EAA0E,EAAE;IAChH,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACvD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,oEAAoE,EAAE;IACzG,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,kEAAkE,EAAE;IACzG,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,uDAAuD,EAAE;IAC9F;QACC,IAAI,EAAE,KAAK;QACX,WAAW,EACV,iIAAiI;KAClI;IACD;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EACV,wGAAwG;KACzG;IACD,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACvD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,gKAAgK;KACjK;IACD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kDAAkD,EAAE;IACjF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC3E,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0EAA0E,EAAE;IAC3G,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACrE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gGAAgG;KAC7G;IACD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAChF,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,6DAA6D,EAAE;IAChG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;IAC5D,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC1E,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACxE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,oEAAoE,EAAE;IACpG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACjD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;IACpF,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACnD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE;IAChD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACjF,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE;CAC1C,CAAC","sourcesContent":["export type SlashCommandSource = \"extension\" | \"prompt\" | \"skill\";\n\nexport type SlashCommandLocation = \"user\" | \"project\" | \"path\";\n\nexport interface SlashCommandInfo {\n\tname: string;\n\tdescription?: string;\n\tsource: SlashCommandSource;\n\tlocation?: SlashCommandLocation;\n\tpath?: string;\n}\n\nexport interface BuiltinSlashCommand {\n\tname: string;\n\tdescription: string;\n}\n\nexport const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [\n\t{ name: \"init\", description: \"Initialize iosm.yaml and .iosm scaffold in current (or target) directory\" },\n\t{\n\t\tname: \"iosm\",\n\t\tdescription: \"Run IOSM auto-improvement loop: /iosm [target-index] [--max-iterations N] [--force-init]\",\n\t},\n\t{\n\t\tname: \"orchestrate\",\n\t\tdescription:\n\t\t\t\"Run orchestrated subagents: /orchestrate (--parallel|--sequential) --agents N [--max-parallel N] [--profile <name>|--profiles p1,p2] [--cwd p1,p2] [--locks l1,l2] [--worktree] [--depends 2>1,3>2] <task>\",\n\t},\n\t{\n\t\tname: \"agents\",\n\t\tdescription:\n\t\t\t\"Interactive agent menu: browse/use/create/edit/delete custom agents and inspect source precedence from .iosm/agents\",\n\t},\n\t{ name: \"subagent-runs\", description: \"List recent subagent runs from .iosm/subagents/runs\" },\n\t{\n\t\tname: \"subagent-resume\",\n\t\tdescription: \"Resume from prior subagent output: /subagent-resume [run-id] [extra instructions] (picker when omitted)\",\n\t},\n\t{ name: \"team-runs\", description: \"List recent team orchestration runs from .iosm/subagents/teams\" },\n\t{ name: \"team-status\", description: \"Show a team run status: /team-status [team-run-id] (picker when omitted)\" },\n\t{ name: \"cycle-list\", description: \"List IOSM cycles\" },\n\t{ name: \"cycle-plan\", description: \"Plan a new IOSM cycle: /cycle-plan [--id <id>] [--force] <goal...>\" },\n\t{ name: \"cycle-status\", description: \"Show IOSM cycle completeness and gates: /cycle-status [cycle-id]\" },\n\t{ name: \"cycle-report\", description: \"Show IOSM cycle report JSON: /cycle-report [cycle-id]\" },\n\t{\n\t\tname: \"mcp\",\n\t\tdescription:\n\t\t\t\"MCP server manager: /mcp (interactive UI), /mcp add <name> ..., /mcp list, /mcp tools [name], /mcp enable|disable|remove <name>\",\n\t},\n\t{\n\t\tname: \"memory\",\n\t\tdescription:\n\t\t\t\"Memory manager: /memory (interactive), /memory <text>, /memory edit <index> <text>, /memory rm <index>\",\n\t},\n\t{ name: \"settings\", description: \"Open settings menu\" },\n\t{\n\t\tname: \"permissions\",\n\t\tdescription:\n\t\t\t\"Permission controls: /permissions (interactive menu) or /permissions [ask|auto|yolo|status|hooks] and /permissions [allow|deny] [list|add|remove] <tool:match>\",\n\t},\n\t{ name: \"yolo\", description: \"Toggle permission prompts: /yolo [on|off|status]\" },\n\t{ name: \"model\", description: \"Select model (provider-first selector UI)\" },\n\t{ name: \"scoped-models\", description: \"Enable/disable models for Ctrl+P cycling\" },\n\t{ name: \"export\", description: \"Export session to HTML file: /export [output-path] (wizard when omitted)\" },\n\t{ name: \"share\", description: \"Share session as a secret GitHub gist\" },\n\t{ name: \"copy\", description: \"Copy last agent message to clipboard\" },\n\t{ name: \"name\", description: \"Set session display name\" },\n\t{ name: \"session\", description: \"Show session info and stats\" },\n\t{\n\t\tname: \"doctor\",\n\t\tdescription: \"Run runtime diagnostics (model/auth/MCP/CLI tools/hooks/paths) with optional interactive fixes\",\n\t},\n\t{ name: \"checkpoint\", description: \"Create/list checkpoints for safe rollback\" },\n\t{ name: \"rollback\", description: \"Rollback session tree to a checkpoint (picker when omitted)\" },\n\t{ name: \"changelog\", description: \"Show changelog entries\" },\n\t{ name: \"hotkeys\", description: \"Show all keyboard shortcuts\" },\n\t{ name: \"fork\", description: \"Create a new fork from a previous message\" },\n\t{ name: \"tree\", description: \"Navigate session tree (switch branches)\" },\n\t{ name: \"login\", description: \"Authenticate with provider (OAuth incl. Qwen + OpenRouter API key)\" },\n\t{ name: \"auth\", description: \"Alias for /login\" },\n\t{ name: \"logout\", description: \"Remove saved provider credentials (OAuth/API key)\" },\n\t{ name: \"new\", description: \"Start a new session\" },\n\t{ name: \"clear\", description: \"Alias for /new\" },\n\t{ name: \"compact\", description: \"Manually compact the session context\" },\n\t{ name: \"resume\", description: \"Resume a different session\" },\n\t{ name: \"reload\", description: \"Reload extensions, skills, prompts, and themes\" },\n\t{ name: \"quit\", description: \"Quit iosm\" },\n];\n"]}
+{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACzE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0EAA0E,EAAE;IACzG;QACC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0FAA0F;KACvG;IACD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,4MAA4M;KAC7M;IACD;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EACV,qHAAqH;KACtH;IACD,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,qDAAqD,EAAE;IAC7F;QACC,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,yGAAyG;KACtH;IACD,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,gEAAgE,EAAE;IACpG,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,0EAA0E,EAAE;IAChH,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACvD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,oEAAoE,EAAE;IACzG,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,kEAAkE,EAAE;IACzG,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,uDAAuD,EAAE;IAC9F;QACC,IAAI,EAAE,KAAK;QACX,WAAW,EACV,iIAAiI;KAClI;IACD;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EACV,wGAAwG;KACzG;IACD;QACC,IAAI,EAAE,UAAU;QAChB,WAAW,EACV,+HAA+H;KAChI;IACD;QACC,IAAI,EAAE,UAAU;QAChB,WAAW,EACV,yHAAyH;KAC1H;IACD;QACC,IAAI,EAAE,UAAU;QAChB,WAAW,EACV,uGAAuG;KACxG;IACD,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACvD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,gKAAgK;KACjK;IACD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kDAAkD,EAAE;IACjF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC3E,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0EAA0E,EAAE;IAC3G,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACrE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gGAAgG;KAC7G;IACD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAChF,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,6DAA6D,EAAE;IAChG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;IAC5D,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC1E,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACxE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,oEAAoE,EAAE;IACpG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACjD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;IACpF,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACnD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE;IAChD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACjF,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE;CAC1C,CAAC","sourcesContent":["export type SlashCommandSource = \"extension\" | \"prompt\" | \"skill\";\n\nexport type SlashCommandLocation = \"user\" | \"project\" | \"path\";\n\nexport interface SlashCommandInfo {\n\tname: string;\n\tdescription?: string;\n\tsource: SlashCommandSource;\n\tlocation?: SlashCommandLocation;\n\tpath?: string;\n}\n\nexport interface BuiltinSlashCommand {\n\tname: string;\n\tdescription: string;\n}\n\nexport const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [\n\t{ name: \"init\", description: \"Initialize iosm.yaml and .iosm scaffold in current (or target) directory\" },\n\t{\n\t\tname: \"iosm\",\n\t\tdescription: \"Run IOSM auto-improvement loop: /iosm [target-index] [--max-iterations N] [--force-init]\",\n\t},\n\t{\n\t\tname: \"orchestrate\",\n\t\tdescription:\n\t\t\t\"Run orchestrated subagents: /orchestrate (--parallel|--sequential) --agents N [--max-parallel N] [--profile <name>|--profiles p1,p2] [--cwd p1,p2] [--locks l1,l2] [--worktree] [--depends 2>1,3>2] <task>\",\n\t},\n\t{\n\t\tname: \"agents\",\n\t\tdescription:\n\t\t\t\"Interactive agent menu: browse/use/create/edit/delete custom agents and inspect source precedence from .iosm/agents\",\n\t},\n\t{ name: \"subagent-runs\", description: \"List recent subagent runs from .iosm/subagents/runs\" },\n\t{\n\t\tname: \"subagent-resume\",\n\t\tdescription: \"Resume from prior subagent output: /subagent-resume [run-id] [extra instructions] (picker when omitted)\",\n\t},\n\t{ name: \"team-runs\", description: \"List recent team orchestration runs from .iosm/subagents/teams\" },\n\t{ name: \"team-status\", description: \"Show a team run status: /team-status [team-run-id] (picker when omitted)\" },\n\t{ name: \"cycle-list\", description: \"List IOSM cycles\" },\n\t{ name: \"cycle-plan\", description: \"Plan a new IOSM cycle: /cycle-plan [--id <id>] [--force] <goal...>\" },\n\t{ name: \"cycle-status\", description: \"Show IOSM cycle completeness and gates: /cycle-status [cycle-id]\" },\n\t{ name: \"cycle-report\", description: \"Show IOSM cycle report JSON: /cycle-report [cycle-id]\" },\n\t{\n\t\tname: \"mcp\",\n\t\tdescription:\n\t\t\t\"MCP server manager: /mcp (interactive UI), /mcp add <name> ..., /mcp list, /mcp tools [name], /mcp enable|disable|remove <name>\",\n\t},\n\t{\n\t\tname: \"memory\",\n\t\tdescription:\n\t\t\t\"Memory manager: /memory (interactive), /memory <text>, /memory edit <index> <text>, /memory rm <index>\",\n\t},\n\t{\n\t\tname: \"semantic\",\n\t\tdescription:\n\t\t\t\"Semantic search manager: /semantic (interactive UI), /semantic setup|auto-index|status|index|rebuild|query <text> [--top-k N]\",\n\t},\n\t{\n\t\tname: \"contract\",\n\t\tdescription:\n\t\t\t\"Engineering contract manager: /contract (interactive field editor), /contract show|edit|clear --scope <project|session>\",\n\t},\n\t{\n\t\tname: \"singular\",\n\t\tdescription:\n\t\t\t\"Feature feasibility analyzer: /singular <request> (builds implementation options and recommendations)\",\n\t},\n\t{ name: \"settings\", description: \"Open settings menu\" },\n\t{\n\t\tname: \"permissions\",\n\t\tdescription:\n\t\t\t\"Permission controls: /permissions (interactive menu) or /permissions [ask|auto|yolo|status|hooks] and /permissions [allow|deny] [list|add|remove] <tool:match>\",\n\t},\n\t{ name: \"yolo\", description: \"Toggle permission prompts: /yolo [on|off|status]\" },\n\t{ name: \"model\", description: \"Select model (provider-first selector UI)\" },\n\t{ name: \"scoped-models\", description: \"Enable/disable models for Ctrl+P cycling\" },\n\t{ name: \"export\", description: \"Export session to HTML file: /export [output-path] (wizard when omitted)\" },\n\t{ name: \"share\", description: \"Share session as a secret GitHub gist\" },\n\t{ name: \"copy\", description: \"Copy last agent message to clipboard\" },\n\t{ name: \"name\", description: \"Set session display name\" },\n\t{ name: \"session\", description: \"Show session info and stats\" },\n\t{\n\t\tname: \"doctor\",\n\t\tdescription: \"Run runtime diagnostics (model/auth/MCP/CLI tools/hooks/paths) with optional interactive fixes\",\n\t},\n\t{ name: \"checkpoint\", description: \"Create/list checkpoints for safe rollback\" },\n\t{ name: \"rollback\", description: \"Rollback session tree to a checkpoint (picker when omitted)\" },\n\t{ name: \"changelog\", description: \"Show changelog entries\" },\n\t{ name: \"hotkeys\", description: \"Show all keyboard shortcuts\" },\n\t{ name: \"fork\", description: \"Create a new fork from a previous message\" },\n\t{ name: \"tree\", description: \"Navigate session tree (switch branches)\" },\n\t{ name: \"login\", description: \"Authenticate with provider (OAuth incl. Qwen + OpenRouter API key)\" },\n\t{ name: \"auth\", description: \"Alias for /login\" },\n\t{ name: \"logout\", description: \"Remove saved provider credentials (OAuth/API key)\" },\n\t{ name: \"new\", description: \"Start a new session\" },\n\t{ name: \"clear\", description: \"Alias for /new\" },\n\t{ name: \"compact\", description: \"Manually compact the session context\" },\n\t{ name: \"resume\", description: \"Resume a different session\" },\n\t{ name: \"reload\", description: \"Reload extensions, skills, prompts, and themes\" },\n\t{ name: \"quit\", description: \"Quit iosm\" },\n];\n"]}

package/dist/core/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAsBhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,CAoPhF"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AA0BhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,CAuRhF"}

package/dist/core/system-prompt.js

@@ -12,14 +12,15 @@ const toolDescriptions = {
     grep: "Search file contents for patterns (respects .gitignore)",
     find: "Find files by glob pattern (respects .gitignore)",
     ls: "List directory contents",
-    rg: "Run ripgrep directly for advanced regex search",
+    rg: "Run ripgrep directly for advanced regex search (prefer explicit path args, e.g. -n pattern .)",
     fd: "Run fd directly for fast file discovery",
-    ast_grep: "Run ast-grep for AST/syntax-aware structural code search",
-    comby: "Run comby for structural pattern search/rewrite previews (no in-place edits)",
+    ast_grep: "Run ast-grep for AST/syntax-aware structural code search (prefer run --pattern; retry with scan/-p on older versions)",
+    comby: "Run comby for structural pattern search/rewrite previews (prefer explicit -matcher; no in-place edits)",
     jq: "Run jq for JSON querying/transformation",
     yq: "Run yq for YAML/JSON/TOML querying/transformation",
     semgrep: "Run semgrep for structural/static security checks",
     sed: "Run sed for stream editing/extraction previews (no in-place edits)",
+    semantic_search: "Semantic embeddings search over the project index (actions: status, index, rebuild, query)",
     task: "Run a specialized subagent (supports profile, cwd, lock_key for optional write serialization, run_id/task_id, model override, background mode for detached runs, and agent=<custom name from .iosm/agents>)",
 };
 /** Build the system prompt with tools, guidelines, and context */
@@ -102,6 +103,7 @@ export function buildSystemPrompt(options = {}) {
     const hasYq = tools.includes("yq");
     const hasSemgrep = tools.includes("semgrep");
     const hasSed = tools.includes("sed");
+    const hasSemanticSearch = tools.includes("semantic_search");
     const hasRead = tools.includes("read");
     // File exploration guidelines
     if (hasBash && !hasGrep && !hasFind && !hasLs && !hasRg && !hasFd) {
@@ -110,6 +112,9 @@ export function buildSystemPrompt(options = {}) {
     else if (hasBash && (hasGrep || hasFind || hasLs || hasRg || hasFd)) {
         addGuideline("Prefer grep/find/ls/rg/fd tools over bash for codebase exploration (faster and less noisy)");
     }
+    if (hasRg || hasFd || hasAstGrep || hasComby || hasJq || hasYq || hasSemgrep || hasSed || hasSemanticSearch) {
+        addGuideline("Route work to specialized tools first: rg/fd (search/discovery), semantic_search (concept-level retrieval), ast_grep/comby (structural code queries), jq/yq (data/config transforms), semgrep (risk scans), sed (stream extraction)");
+    }
     if (hasAstGrep || hasComby) {
         addGuideline("Use ast_grep/comby for syntax-aware structural queries before falling back to broad regex");
     }
@@ -125,6 +130,17 @@ export function buildSystemPrompt(options = {}) {
     if (hasSed) {
         addGuideline("Use sed for preview/extraction workflows only; perform final file edits with edit/write");
     }
+    if (hasSemanticSearch) {
+        addGuideline("Use semantic_search for intent/meaning queries that are hard to express with regex; use rg/ast_grep for exact symbol and syntax matches");
+        addGuideline("semantic_search query can auto-refresh stale indexes when semantic auto-index is enabled (default); if disabled or if provider/chunk/filter changes require it, run semantic_search index/rebuild explicitly");
+    }
+    if (hasRg || hasAstGrep || hasComby) {
+        addGuideline("For rg/ast_grep/comby, pass explicit target paths to avoid cwd ambiguity; if syntax errors occur (especially ast_grep), retry once with version-compatible command forms before concluding no matches");
+    }
+    if (hasBash &&
+        (hasRg || hasFd || hasAstGrep || hasComby || hasJq || hasYq || hasSemgrep || hasSed || hasSemanticSearch)) {
+        addGuideline("If a required CLI tool is missing, install it first when permitted (rg/fd can be auto-managed; others via brew/apt/pipx/npm), then continue with that tool instead of broad bash fallback. For semantic_search, configure provider/index first via /semantic setup.");
+    }
     // Read before edit guideline
     if (hasRead && hasEdit) {
         addGuideline("Use read to examine files before editing. You must use this tool instead of cat or sed.");
@@ -150,6 +166,8 @@ export function buildSystemPrompt(options = {}) {
     addGuideline("Do not claim success without evidence; if you could not verify, say so explicitly");
     addGuideline("Complete the requested task end-to-end when possible instead of stopping at analysis");
     addGuideline("For code review requests, lead with findings and risks before summaries");
+    addGuideline("When an active engineering contract is present in context, treat its constraints, quality gates, and definition_of_done as execution requirements unless user overrides them.");
+    addGuideline("For major feature forks, run a /singular feasibility pass before coding to compare implementation options.");
     for (const guideline of promptGuidelines ?? []) {
         const normalized = guideline.trim();
         if (normalized.length > 0) {