soturail 0.7.0 → 0.8.0

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

@@ -0,0 +1,202 @@
+import type { AgentId } from "./agent-profile.js";
+export type BrainRecordType = "claim" | "decision" | "bug" | "gap" | "rule" | "stale-event";
+export type BrainClaimKind = "architecture" | "release" | "workflow" | "policy" | "test" | "command" | "docs" | "agent" | "security" | "unknown";
+export type BrainClaimStatus = "verified" | "suspect" | "stale" | "unverified" | "rejected";
+export type BrainConfidence = "high" | "medium" | "low";
+export interface SourceRange {
+    startLine: number;
+    endLine: number;
+}
+export interface BrainClaimRecord {
+    schemaVersion: "soturail.brain.claim.v1";
+    id: string;
+    claim: string;
+    kind: BrainClaimKind;
+    status: BrainClaimStatus;
+    confidence: BrainConfidence;
+    sourcePath: string;
+    sourceCommit: string;
+    sourceRange: SourceRange;
+    fileHash: string;
+    rangeHash: string;
+    validatedBy: string[];
+    relatedWorkflowIds: string[];
+    relatedEvidenceIds: string[];
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface BrainDecisionRecord {
+    schemaVersion: "soturail.brain.decision.v1";
+    id: string;
+    title: string;
+    decision: string;
+    reason: string;
+    status: "active" | "superseded" | "rejected" | "unknown";
+    sourcePath: string;
+    sourceCommit: string;
+    tags: string[];
+    createdAt: string;
+}
+export interface BrainBugRecord {
+    schemaVersion: "soturail.brain.bug.v1";
+    id: string;
+    bug: string;
+    status: "open" | "fixed" | "recurring" | "unknown";
+    sourcePath: string;
+    tags: string[];
+    createdAt: string;
+}
+export interface BrainGapRecord {
+    schemaVersion: "soturail.brain.gap.v1";
+    id: string;
+    gap: string;
+    severity: "low" | "medium" | "high";
+    needsHumanValidation: boolean;
+    sourcePath: string;
+    status: "open" | "resolved" | "accepted-risk";
+    createdAt: string;
+}
+export interface BrainRuleRecord {
+    schemaVersion: "soturail.brain.rule.v1";
+    id: string;
+    rule: string;
+    sourceClaimIds: string[];
+    sourceDecisionIds?: string[];
+    enforcement: "advisory" | "policy-gate" | "test-backed" | "manual-review";
+    status: "active" | "draft" | "deprecated";
+    createdAt: string;
+}
+export interface BrainStaleEventRecord {
+    schemaVersion: "soturail.brain.stale-event.v1";
+    id: string;
+    recordId: string;
+    reason: string;
+    previousHash: string;
+    currentHash: string;
+    status: "suspect" | "stale" | "resolved";
+    createdAt: string;
+}
+export interface BrainProjectProfile {
+    schemaVersion: "soturail.brain.project-profile.v1";
+    projectName: string;
+    packageVersion: string;
+    cliVersion: string;
+    identity: string;
+    mainLanguageRuntime: string[];
+    docsFolders: string[];
+    releaseNotesPath: string;
+    rails: string[];
+    commands: string[];
+    tests: string[];
+    workflowHarnessDiagramEval: Record<string, string>;
+    agentHosts: string[];
+    knownReleaseProcess: string[];
+    counts: BrainCounts;
+    updatedAt: string;
+}
+export interface BrainCounts {
+    claims: number;
+    decisions: number;
+    bugs: number;
+    gaps: number;
+    rules: number;
+    staleEvents: number;
+    suspectOrStale: number;
+}
+export interface BrainArchitectureView {
+    schemaVersion: "soturail.brain.architecture.v1";
+    storage: {
+        jsonl: string[];
+        jsonViews: string[];
+        exports: string[];
+    };
+    rails: Array<{
+        name: string;
+        evidence: string;
+    }>;
+    boundaries: string[];
+    updatedAt: string;
+}
+export interface BrainIndexView {
+    schemaVersion: "soturail.brain.index.v1";
+    updatedAt: string;
+    claims: Array<{
+        id: string;
+        kind: BrainClaimKind;
+        status: BrainClaimStatus;
+        sourcePath: string;
+        tags: string[];
+    }>;
+    decisions: Array<{
+        id: string;
+        status: string;
+        sourcePath: string;
+        tags: string[];
+    }>;
+    gaps: Array<{
+        id: string;
+        severity: string;
+        status: string;
+        sourcePath: string;
+    }>;
+    rules: Array<{
+        id: string;
+        status: string;
+        sourceClaimIds: string[];
+    }>;
+}
+export interface BrainFreshnessView {
+    schemaVersion: "soturail.brain.freshness.v1";
+    updatedAt: string;
+    checkedRecords: number;
+    suspect: number;
+    stale: number;
+    warnings: string[];
+    events: BrainStaleEventRecord[];
+}
+export interface BrainDoctorReport {
+    schemaVersion: "soturail.brain.doctor.v1";
+    ok: boolean;
+    createdAt: string;
+    files: Array<{
+        path: string;
+        present: boolean;
+        validJsonl?: boolean;
+    }>;
+    counts: BrainCounts;
+    findings: string[];
+    nextCommands: string[];
+}
+export type BrainAgentTarget = Extract<AgentId, "claude" | "codex" | "gemini" | "cursor" | "generic">;
+export declare function initBrain(root?: string): Promise<{
+    paths: string[];
+    output: string;
+}>;
+export declare function scanBrain(root?: string): Promise<{
+    profile: BrainProjectProfile;
+    claimsAdded: number;
+    output: string;
+}>;
+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<{
+    freshness: BrainFreshnessView;
+    output: string;
+}>;
+export declare function brainDoctor(root?: string): Promise<{
+    report: BrainDoctorReport;
+    output: string;
+}>;
+export declare function exportBrain(agent: BrainAgentTarget, root?: string): Promise<{
+    path: string;
+    content: string;
+    output: string;
+}>;
+export declare function rulesFromBrain(root?: string): Promise<{
+    rules: BrainRuleRecord[];
+    markdownPath: string;
+    output: string;
+}>;
+export declare function readBrainCounts(root?: string): Promise<BrainCounts>;
+export declare function brainExportExists(root?: string): Promise<boolean>;