soturail 0.8.0 → 0.9.0

package/dist/core/native-candidates.js

@@ -0,0 +1,163 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { detectNativeEngine } from "./native-engine.js";
+import { getWorkspacePaths, relativeToRoot, writeJson } from "./config.js";
+export async function nativeStatus(root = process.cwd()) {
+    const info = await detectNativeEngine(root);
+    return {
+        schemaVersion: "soturail.native.status.v1",
+        createdAt: new Date().toISOString(),
+        native_available: info.available,
+        native_engine: info.available ? "rust" : "none",
+        native_path: info.path,
+        native_version: info.version,
+        fallback: "typescript",
+        npm_install_requires_native: false,
+        safe_to_use: true,
+        checked_paths: info.checked_paths
+    };
+}
+export async function writeNativeCandidateReport(root = process.cwd()) {
+    const status = await nativeStatus(root);
+    const report = {
+        schemaVersion: "soturail.native.candidates.v1",
+        createdAt: new Date().toISOString(),
+        engine: {
+            nativeAvailable: status.native_available,
+            fallback: "typescript",
+            normalInstallRequiresNative: false
+        },
+        candidates: nativeCandidates()
+    };
+    const dir = path.join(getWorkspacePaths(root).workspace, "native");
+    const jsonPath = path.join(dir, "candidates.json");
+    const markdownPath = path.join(dir, "candidates.md");
+    await fs.mkdir(dir, { recursive: true });
+    await writeJson(jsonPath, report);
+    await fs.writeFile(markdownPath, renderNativeCandidates(report), "utf8");
+    return {
+        report,
+        markdownPath,
+        jsonPath,
+        output: [
+            "SotuRail native candidates",
+            `schemaVersion: ${report.schemaVersion}`,
+            `native_available: ${report.engine.nativeAvailable}`,
+            `fallback: ${report.engine.fallback}`,
+            `normal_install_requires_native: ${report.engine.normalInstallRequiresNative}`,
+            `candidates_count: ${report.candidates.length}`,
+            `good_candidates: ${report.candidates.filter((item) => item.classification === "good-candidate").length}`,
+            `json: ${relativeToRoot(root, jsonPath)}`,
+            `markdown: ${relativeToRoot(root, markdownPath)}`
+        ].join("\n") + "\n"
+    };
+}
+export function renderNativeStatus(report) {
+    return [
+        "SotuRail native status",
+        `schemaVersion: ${report.schemaVersion}`,
+        `native_available: ${report.native_available}`,
+        `native_engine: ${report.native_engine}`,
+        `native_path: ${report.native_path ?? "not found"}`,
+        `native_version: ${report.native_version ?? "unknown"}`,
+        `fallback: ${report.fallback}`,
+        `npm_install_requires_native: ${report.npm_install_requires_native}`,
+        `safe_to_use: ${report.safe_to_use}`,
+        "checked_paths:",
+        ...report.checked_paths.map((item) => `- ${item}`)
+    ].join("\n") + "\n";
+}
+export async function nativeDoctor(root = process.cwd()) {
+    const status = await nativeStatus(root);
+    const paths = getWorkspacePaths(root);
+    const candidateJson = path.join(paths.workspace, "native", "candidates.json");
+    const benchJson = path.join(paths.workspace, "bench", "latest.json");
+    const candidatePresent = await exists(candidateJson);
+    const benchPresent = await exists(benchJson);
+    return [
+        "SotuRail native doctor",
+        "typescript_fallback: OK",
+        `native_optional: ${status.native_available ? "OK" : "Unavailable"}`,
+        `native_available: ${status.native_available}`,
+        `native_engine: ${status.native_engine}`,
+        "normal_npm_install_requires_rust: NO",
+        "normal_npm_install_requires_native: NO",
+        `benchmarks_available: ${benchPresent ? "YES" : "NO"}`,
+        `candidate_report: ${candidatePresent ? relativeToRoot(root, candidateJson) : "missing"}`,
+        "decision_policy: benchmark-before-native",
+        "recommended_next_command:",
+        candidatePresent ? "- soturail bench run --suite brain" : "- soturail native candidates",
+        "- soturail native compare"
+    ].join("\n") + "\n";
+}
+export async function nativeCompare(root = process.cwd()) {
+    const status = await nativeStatus(root);
+    if (!status.native_available) {
+        return [
+            "SotuRail native compare",
+            "native_available: false",
+            "result: skipped",
+            "typescript_fallback: OK",
+            "reason: optional native engine is unavailable; no native speedup is claimed",
+            "next: soturail bench run --suite brain"
+        ].join("\n") + "\n";
+    }
+    return [
+        "SotuRail native compare",
+        "native_available: true",
+        "result: ready",
+        "typescript_fallback: OK",
+        "next: soturail bench compare-engines",
+        "note: promote native acceleration only after a local benchmark report shows justified speedup."
+    ].join("\n") + "\n";
+}
+function nativeCandidates() {
+    return [
+        candidate("large log reducers", "good-candidate", "Large terminal logs already have reducer fixtures and can be compared against TypeScript output.", "reducer-large-log", "medium", "high"),
+        candidate("rangeHash computation", "good-candidate", "Range hashing repeats over source evidence during stale checks.", "range-hash", "low", "medium"),
+        candidate("JSONL scanning", "good-candidate", "Append-only brain records and metrics grow with local usage.", "jsonl-read-write", "low", "medium"),
+        candidate("source-range relocation", "maybe-candidate", "Relocation uses simple text windows and should be measured before native work.", "brain-stale", "medium", "medium"),
+        candidate("duplicate claim clustering", "maybe-candidate", "Claim consolidation scales with record count and token overlap checks.", "brain-consolidate", "medium", "medium"),
+        candidate("recursive file scanning", "maybe-candidate", "Large repositories may spend time walking files, but ignores and file limits must stay identical.", "file-scan", "medium", "medium"),
+        candidate("reverse claims", "maybe-candidate", "Heuristic extraction may benefit from parser help later, but TypeScript remains adequate on small repos.", "reverse-claims", "medium", "medium"),
+        candidate("diagram validation", "not-worth-it-yet", "Current validation is lightweight string logic, not a measured bottleneck.", "workflow-evidence", "low", "low", "keep-typescript"),
+        candidate("workflow evidence generation", "not-worth-it-yet", "Evidence rendering is I/O and Markdown assembly, not a native hot path yet.", "workflow-evidence", "low", "low", "keep-typescript"),
+        candidate("agent brief rendering", "not-worth-it-yet", "Brief rendering is bounded and review-oriented; native code would add maintenance risk without evidence.", "brain-scan", "low", "low", "keep-typescript"),
+        candidate("release preflight", "blocked", "Release gates are orchestration, npm, audit and pack checks; native acceleration would not simplify them.", "release-preflight", "high", "low", "blocked-until-measured")
+    ];
+}
+function candidate(area, classification, reason, benchmarkCategory, risk, estimatedBenefit, recommendation = "benchmark-before-native") {
+    return {
+        area,
+        classification,
+        reason,
+        currentEngine: "typescript",
+        benchmarkCategory,
+        risk,
+        estimatedBenefit,
+        fallback: "typescript",
+        recommendation
+    };
+}
+function renderNativeCandidates(report) {
+    return [
+        "# SotuRail Native Candidate Report",
+        "",
+        "No benchmark, no native rewrite. TypeScript remains the portable baseline.",
+        "",
+        `schemaVersion: ${report.schemaVersion}`,
+        `createdAt: ${report.createdAt}`,
+        `nativeAvailable: ${report.engine.nativeAvailable}`,
+        `fallback: ${report.engine.fallback}`,
+        `normalInstallRequiresNative: ${report.engine.normalInstallRequiresNative}`,
+        "",
+        "| area | classification | benchmark | risk | benefit | recommendation | reason |",
+        "|---|---|---|---|---|---|---|",
+        ...report.candidates.map((item) => `| ${item.area} | ${item.classification} | ${item.benchmarkCategory} | ${item.risk} | ${item.estimatedBenefit} | ${item.recommendation} | ${item.reason} |`),
+        ""
+    ].join("\n");
+}
+async function exists(filePath) {
+    return fs.access(filePath).then(() => true).catch(() => false);
+}
+//# sourceMappingURL=native-candidates.js.map

package/dist/core/native-candidates.js.map

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

package/dist/core/project-brain.d.ts

@@ -74,7 +74,10 @@ export interface BrainStaleEventRecord {
     reason: string;
     previousHash: string;
     currentHash: string;
-    status: "suspect" | "stale" | "resolved";
+    status: "suspect" | "stale" | "resolved" | "relocated";
+    previousRange?: SourceRange;
+    candidateRange?: SourceRange;
+    similarity?: number;
     createdAt: string;
 }
 export interface BrainProjectProfile {
@@ -165,10 +168,64 @@ export interface BrainDoctorReport {
         validJsonl?: boolean;
     }>;
     counts: BrainCounts;
+    duplicateClaimGroups?: number;
+    integrationStatus?: Record<string, string>;
+    repairPlanPath?: string;
     findings: string[];
     nextCommands: string[];
 }
 export type BrainAgentTarget = Extract<AgentId, "claude" | "codex" | "gemini" | "cursor" | "generic">;
+export interface BrainStaleOptions {
+    repairPlan?: boolean;
+}
+export interface BrainRepairSuggestion {
+    recordId: string;
+    type: "claim" | "decision" | "rule";
+    text: string;
+    reason: string;
+    sourcePath: string;
+    affectedRange?: SourceRange;
+    candidateRange?: SourceRange;
+    similarity?: number;
+    recommendedCommand: string;
+    recommendedHumanAction: string;
+    relatedValidation: string[];
+}
+export interface BrainRepairPlan {
+    schemaVersion: "soturail.brain.repair-plan.v1";
+    createdAt: string;
+    suggestions: BrainRepairSuggestion[];
+}
+export interface BrainConsolidationGroup {
+    canonicalId: string;
+    duplicateIds: string[];
+    reason: string;
+    score: number;
+    claims: Array<{
+        id: string;
+        status: BrainClaimStatus;
+        confidence: BrainConfidence;
+        sourcePath: string;
+        claim: string;
+    }>;
+}
+export interface BrainConsolidationReport {
+    schemaVersion: "soturail.brain.consolidation.v1";
+    createdAt: string;
+    dryRun: boolean;
+    claimsRead: number;
+    duplicateGroups: number;
+    mergedClaims: number;
+    canonicalClaims: number;
+    groups: BrainConsolidationGroup[];
+}
+export interface BrainExportOptions {
+    limit?: number;
+    includeSuspect?: boolean;
+}
+export interface BrainDoctorOptions {
+    repairPlan?: boolean;
+}
 export declare function initBrain(root?: string): Promise<{
     paths: string[];
     output: string;
@@ -180,15 +237,23 @@ export declare function scanBrain(root?: string): Promise<{
 }>;
 export declare function brainProfile(root?: string): Promise<string>;
 export declare function recallBrain(query: string, root?: string, limit?: number): Promise<string>;
-export declare function staleBrain(root?: string): Promise<{
+export declare function staleBrain(root?: string, options?: BrainStaleOptions): Promise<{
     freshness: BrainFreshnessView;
+    repairPlan?: BrainRepairPlan;
+    output: string;
+}>;
+export declare function consolidateBrain(root?: string, options?: {
+    dryRun?: boolean;
+}): Promise<{
+    report: BrainConsolidationReport;
     output: string;
 }>;
-export declare function brainDoctor(root?: string): Promise<{
+export declare function brainDoctor(root?: string, options?: BrainDoctorOptions): Promise<{
     report: BrainDoctorReport;
+    repairPlan?: BrainRepairPlan;
     output: string;
 }>;
-export declare function exportBrain(agent: BrainAgentTarget, root?: string): Promise<{
+export declare function exportBrain(agent: BrainAgentTarget, root?: string, options?: BrainExportOptions): Promise<{
     path: string;
     content: string;
     output: string;
@@ -196,6 +261,7 @@ export declare function exportBrain(agent: BrainAgentTarget, root?: string): Pro
 export declare function rulesFromBrain(root?: string): Promise<{
     rules: BrainRuleRecord[];
     markdownPath: string;
+    jsonPath: string;
     output: string;
 }>;
 export declare function readBrainCounts(root?: string): Promise<BrainCounts>;