import type { ApplicationGraphEvidence } from "../domain/javascriptApplicationEvidenceSchemas.js";
import type { JavaScriptSemanticGraphNode } from "../domain/javascriptSemanticGraph.js";
import type { JavaScriptSourceRange } from "../domain/javascriptStaticAnalysisTypes.js";
import type { JavaScriptArtifactFile } from "./JavaScriptArtifactFiles.js";

const INFERENCE_LIMITATION =
  "This relationship is a bounded static candidate; it does not prove runtime execution or causal flow.";

/** Exact artifact-backed syntax evidence for one semantic graph node. */
export const observedSemanticEvidence = (
  file: JavaScriptArtifactFile,
  location: JavaScriptSourceRange | null,
): ApplicationGraphEvidence => ({
  authority: "ast-static-analysis",
  state: "observed",
  confidence: "exact",
  artifact: {
    available: true,
    artifact_id: `art_${file.sha256}`,
    sha256: file.sha256,
  },
  location:
    location === null
      ? { available: true, value: { kind: "artifact-path", path: file.path } }
      : {
          available: true,
          value: { kind: "source-range", source: file.path, ...location },
        },
  extractor: {
    name: "rea-javascript-semantic-analysis",
    version: "1",
    operation: "analyze_javascript_application",
    executable_sha256: null,
  },
  coverage: {
    status: "complete",
    truncated: false,
    omitted_count: 0,
    limits: [],
  },
  limitations: [],
  evidence_ids: [],
});

/** Conservative static relationship evidence derived from one syntax node. */
export const inferredSemanticEvidence = (
  source: JavaScriptSemanticGraphNode,
): ApplicationGraphEvidence => ({
  ...source.evidence,
  authority: "static-relationship-inference",
  state: "inferred",
  confidence: "high",
  limitations: [INFERENCE_LIMITATION],
});

/** Static relationship evidence anchored at the syntax that proves the link. */
export const inferredSemanticEvidenceAt = (
  file: JavaScriptArtifactFile,
  location: JavaScriptSourceRange,
): ApplicationGraphEvidence => ({
  ...observedSemanticEvidence(file, location),
  authority: "static-relationship-inference",
  state: "inferred",
  confidence: "high",
  limitations: [INFERENCE_LIMITATION],
});

/** Explicit absence of semantic syntax for an artifact-level fallback root. */
export const unavailableSemanticRootEvidence = (
  rootArtifactSha256: string,
): ApplicationGraphEvidence => ({
  authority: "unknown",
  state: "unavailable",
  confidence: "unknown",
  artifact: {
    available: true,
    artifact_id: `art_${rootArtifactSha256}`,
    sha256: rootArtifactSha256,
  },
  location: {
    available: false,
    reason: "not-observed",
    detail: "No admitted JavaScript source produced semantic IR.",
  },
  extractor: {
    name: "rea-javascript-semantic-analysis",
    version: "1",
    operation: "analyze_javascript_application",
    executable_sha256: null,
  },
  coverage: {
    status: "unavailable",
    truncated: false,
    omitted_count: null,
    limits: [],
  },
  limitations: ["This synthetic graph root does not claim a source location."],
  evidence_ids: [],
});

/** Explicit unknown evidence at one unresolved dynamic syntax location. */
export const unknownSemanticEvidence = (
  file: JavaScriptArtifactFile,
  location: JavaScriptSourceRange,
): ApplicationGraphEvidence => ({
  ...observedSemanticEvidence(file, location),
  authority: "unknown",
  state: "unknown",
  confidence: "unknown",
  limitations: ["Dynamic syntax prevents an exact static relationship."],
});