@ivorycanvas/qamap 0.3.5 → 0.4.1

package/dist/behavior-manifest.js

@@ -0,0 +1,221 @@
+import path from "node:path";
+import { createBehaviorEdge, createBehaviorNodeId, } from "./behavior.js";
+export function createManifestBehaviorAdapter(options) {
+    return {
+        id: "qamap.verification-manifest",
+        version: "1",
+        detect: () => ({
+            confidence: manifestDetectionConfidence(options.matches),
+            reason: options.matches.length > 0
+                ? "The repository verification manifest matched this branch and can supply reviewed behavior evidence."
+                : "No verification manifest entries matched this branch.",
+            evidence: uniqueStrings(options.matches.map((match) => match.manifestPath)).slice(0, 12),
+        }),
+        analyze: (context) => buildManifestBehaviorFragment(context, options.matches),
+    };
+}
+function buildManifestBehaviorFragment(context, matches) {
+    const nodes = [];
+    const edges = [];
+    const changedFiles = new Set(context.changedFiles.map((file) => file.path));
+    const flowMatches = new Map(matches.filter((match) => match.kind === "flow").map((match) => [match.id, match]));
+    const domainNodes = [];
+    const flowNodes = [];
+    for (const match of [...matches].sort(compareManifestMatches)) {
+        const files = manifestFilesForContext(context, match.matchedFiles);
+        const nodeKind = nodeKindForMatch(match);
+        const nodeId = manifestNodeId(nodeKind, match.id);
+        const impact = manifestImpact(context, files, changedFiles);
+        const evidence = manifestEvidence(match, files);
+        nodes.push({
+            id: nodeId,
+            kind: nodeKind,
+            label: match.name,
+            confidence: match.confidence,
+            evidence,
+            attributes: manifestAttributes(match),
+            impact,
+        });
+        if (match.kind === "domain") {
+            domainNodes.push({ match, nodeId, files });
+        }
+        else if (match.kind === "flow") {
+            flowNodes.push({ match, nodeId, files });
+        }
+        for (const file of files) {
+            const sourceId = createBehaviorNodeId("source", file);
+            const direct = changedFiles.has(file);
+            nodes.push({
+                id: sourceId,
+                kind: "source",
+                label: file,
+                confidence: "high",
+                evidence: [
+                    { kind: direct ? "diff" : "source", value: file, file },
+                    { kind: "manifest", value: match.manifestPath, file },
+                ],
+                attributes: { path: file },
+                impact: direct ? { kind: "direct", changedFiles: [file] } : undefined,
+            });
+            edges.push(direct
+                ? createBehaviorEdge("impacts", sourceId, nodeId, "high", [{ kind: "manifest", value: match.manifestPath, file }])
+                : createBehaviorEdge("implemented-by", nodeId, sourceId, match.confidence, [
+                    { kind: "manifest", value: match.manifestPath, file },
+                ]));
+        }
+        if (match.kind === "flow" && match.entryRoute) {
+            const surfaceId = createBehaviorNodeId("surface", "manifest-route", match.entryRoute, match.id);
+            nodes.push({
+                id: surfaceId,
+                kind: "surface",
+                label: `route: ${match.entryRoute}`,
+                confidence: match.confidence,
+                evidence: [{ kind: "manifest", value: match.manifestPath }],
+                attributes: { entrypointKind: "route", value: match.entryRoute, surface: "web", source: "manifest" },
+            });
+            edges.push(createBehaviorEdge("enters-at", nodeId, surfaceId, match.confidence, evidence));
+        }
+        if (match.kind === "check") {
+            const flowId = parentFlowId(match.id);
+            const parentMatch = flowMatches.get(flowId);
+            const parentNodeId = manifestNodeId("flow", flowId);
+            if (!parentMatch) {
+                nodes.push({
+                    id: parentNodeId,
+                    kind: "flow",
+                    label: flowId,
+                    confidence: match.confidence,
+                    evidence,
+                    attributes: { manifestId: flowId, source: "manifest" },
+                    impact,
+                });
+            }
+            edges.push(createBehaviorEdge("expects", parentNodeId, nodeId, match.confidence, evidence));
+            if (match.checkSelector) {
+                const locatorId = createBehaviorNodeId("locator", "manifest", match.checkSelector, match.id);
+                nodes.push({
+                    id: locatorId,
+                    kind: "locator",
+                    label: `manifest selector: ${match.checkSelector}`,
+                    confidence: match.confidence,
+                    evidence: [{ kind: "manifest", value: match.manifestPath }],
+                    attributes: { value: match.checkSelector, source: "manifest" },
+                });
+                edges.push(createBehaviorEdge("located-by", nodeId, locatorId, match.confidence, evidence));
+            }
+        }
+    }
+    for (const domain of domainNodes) {
+        for (const flow of flowNodes) {
+            if (!filesOverlap(domain.files, flow.files)) {
+                continue;
+            }
+            edges.push(createBehaviorEdge("contains", domain.nodeId, flow.nodeId, weakerConfidence(domain.match.confidence, flow.match.confidence), [
+                { kind: "manifest", value: domain.match.manifestPath },
+                { kind: "manifest", value: flow.match.manifestPath },
+            ]));
+        }
+    }
+    return { nodes, edges };
+}
+function manifestNodeId(kind, id) {
+    return createBehaviorNodeId(kind, "manifest", id);
+}
+function nodeKindForMatch(match) {
+    if (match.kind === "domain") {
+        return "domain";
+    }
+    if (match.kind === "flow") {
+        return "flow";
+    }
+    return "assertion";
+}
+function manifestDetectionConfidence(matches) {
+    if (matches.some((match) => match.kind === "flow" || match.kind === "check")) {
+        return "high";
+    }
+    return matches.length > 0 ? "medium" : "none";
+}
+function manifestImpact(context, matchedFiles, changedFiles) {
+    const directFiles = uniqueStrings(matchedFiles).filter((file) => changedFiles.has(file));
+    if (directFiles.length > 0) {
+        return { kind: "direct", changedFiles: directFiles };
+    }
+    const propagatedFiles = context.changedFiles.map((file) => file.path).slice(0, 12);
+    return propagatedFiles.length > 0 ? { kind: "propagated", changedFiles: propagatedFiles } : undefined;
+}
+function manifestEvidence(match, files) {
+    return [
+        { kind: "manifest", value: match.manifestPath },
+        ...match.evidenceSources.map((source) => ({ kind: "manifest", value: source })),
+        ...files.slice(0, 12).map((file) => ({ kind: "source", value: file, file })),
+    ];
+}
+function manifestFilesForContext(context, matchedFiles) {
+    const workspaceRoot = context.workspaceRoot ? path.resolve(context.workspaceRoot) : undefined;
+    const root = path.resolve(context.root);
+    if (!workspaceRoot || workspaceRoot === root) {
+        return uniqueStrings(matchedFiles.map(toPosixPath));
+    }
+    const packagePrefix = toPosixPath(path.relative(workspaceRoot, root)).replace(/^\.\/+|\/+$/g, "");
+    if (!packagePrefix || packagePrefix.startsWith("..")) {
+        return uniqueStrings(matchedFiles.map(toPosixPath));
+    }
+    return uniqueStrings(matchedFiles.map((file) => {
+        const normalized = toPosixPath(file).replace(/^\.\/+/, "");
+        return normalized.startsWith(`${packagePrefix}/`) ? normalized.slice(packagePrefix.length + 1) : normalized;
+    }));
+}
+function manifestAttributes(match) {
+    const attributes = {
+        manifestId: match.id,
+        matchKind: match.kind,
+        source: "manifest",
+        updatePath: match.updatePath,
+    };
+    if (match.criticality) {
+        attributes.criticality = match.criticality;
+    }
+    if (match.runner) {
+        attributes.runner = match.runner;
+    }
+    if (match.entryRoute) {
+        attributes.entryRoute = match.entryRoute;
+    }
+    if (match.checkType) {
+        attributes.checkType = match.checkType;
+    }
+    if (match.checkSelector) {
+        attributes.checkSelector = match.checkSelector;
+    }
+    if (match.checkValue) {
+        attributes.checkValue = match.checkValue;
+    }
+    if (match.checkSteps && match.checkSteps.length > 0) {
+        attributes.checkSteps = match.checkSteps;
+    }
+    return attributes;
+}
+function parentFlowId(checkId) {
+    const parts = checkId.split(".");
+    return parts.length > 1 ? parts.slice(0, -1).join(".") : checkId;
+}
+function filesOverlap(left, right) {
+    const leftFiles = new Set(left);
+    return right.some((file) => leftFiles.has(file));
+}
+function weakerConfidence(left, right) {
+    const rank = { low: 1, medium: 2, high: 3 };
+    return rank[left] <= rank[right] ? left : right;
+}
+function compareManifestMatches(left, right) {
+    const kindRank = { domain: 0, flow: 1, check: 2 };
+    return kindRank[left.kind] - kindRank[right.kind] || left.id.localeCompare(right.id);
+}
+function uniqueStrings(items) {
+    return [...new Set(items.map((item) => item.trim()).filter(Boolean))];
+}
+function toPosixPath(value) {
+    return value.split(path.sep).join("/");
+}
+//# sourceMappingURL=behavior-manifest.js.map

package/dist/behavior-manifest.js.map

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

package/dist/behavior.d.ts

@@ -0,0 +1,151 @@
+export declare const behaviorGraphSchemaVersion: 1;
+export declare const behaviorGraphSchemaUrl = "https://raw.githubusercontent.com/IvoryCanvas/qamap/main/schema/qamap-behavior.schema.json";
+export declare const behaviorSurfaceKinds: readonly ["web", "mobile", "api", "cli", "artifact", "unknown"];
+export declare const behaviorNodeKinds: readonly ["domain", "flow", "surface", "action", "state", "effect", "contract", "assertion", "fixture", "locator", "source"];
+export declare const behaviorEdgeKinds: readonly ["contains", "enters-at", "precedes", "expects", "uses-fixture", "located-by", "implemented-by", "impacts"];
+export declare const behaviorEvidenceKinds: readonly ["commit", "diff", "source", "manifest", "selector", "fixture", "test", "inference"];
+export type BehaviorConfidence = "low" | "medium" | "high";
+export type BehaviorAdapterConfidence = "none" | BehaviorConfidence;
+export type BehaviorSurfaceKind = (typeof behaviorSurfaceKinds)[number];
+export type BehaviorNodeKind = (typeof behaviorNodeKinds)[number];
+export type BehaviorEdgeKind = (typeof behaviorEdgeKinds)[number];
+export type BehaviorEvidenceKind = (typeof behaviorEvidenceKinds)[number];
+export type BehaviorImpactKind = "direct" | "propagated";
+export type BehaviorDiagnosticSeverity = "info" | "warning";
+export type BehaviorAttributeValue = string | number | boolean | string[];
+export interface BehaviorEvidence {
+    kind: BehaviorEvidenceKind;
+    value: string;
+    file?: string;
+    previousFile?: string;
+    symbol?: string;
+    commit?: string;
+    relation?: "direct" | "supporting" | "contextual";
+    side?: "base" | "head";
+    startLine?: number;
+    endLine?: number;
+    hunkHeader?: string;
+}
+export interface BehaviorImpact {
+    kind: BehaviorImpactKind;
+    changedFiles: string[];
+}
+export interface BehaviorNode {
+    id: string;
+    kind: BehaviorNodeKind;
+    label: string;
+    confidence: BehaviorConfidence;
+    evidence: BehaviorEvidence[];
+    attributes?: Record<string, BehaviorAttributeValue>;
+    impact?: BehaviorImpact;
+}
+export interface BehaviorEdge {
+    id: string;
+    kind: BehaviorEdgeKind;
+    from: string;
+    to: string;
+    confidence: BehaviorConfidence;
+    evidence: BehaviorEvidence[];
+}
+export interface BehaviorDiagnostic {
+    severity: BehaviorDiagnosticSeverity;
+    message: string;
+    adapterId?: string;
+}
+export interface BehaviorAdapterDetection {
+    confidence: BehaviorAdapterConfidence;
+    reason: string;
+    evidence: string[];
+}
+export interface BehaviorAdapterRun {
+    id: string;
+    version: string;
+    status: "used" | "skipped" | "failed";
+    detection: BehaviorAdapterDetection;
+    nodeCount: number;
+    edgeCount: number;
+}
+export interface BehaviorGraphSummary {
+    nodes: number;
+    edges: number;
+    impactedNodes: number;
+    byKind: Record<BehaviorNodeKind, number>;
+}
+export interface BehaviorGraph {
+    $schema?: string;
+    schemaVersion: typeof behaviorGraphSchemaVersion;
+    root: string;
+    workspaceRoot?: string;
+    base: string;
+    head: string;
+    surface: BehaviorSurfaceKind;
+    adapters: BehaviorAdapterRun[];
+    nodes: BehaviorNode[];
+    edges: BehaviorEdge[];
+    diagnostics: BehaviorDiagnostic[];
+    summary: BehaviorGraphSummary;
+}
+export interface BehaviorChangedFile {
+    path: string;
+    status: string;
+    previousPath?: string;
+}
+export interface BehaviorAnalysisContext {
+    root: string;
+    workspaceRoot?: string;
+    base: string;
+    head: string;
+    projectType: string;
+    surface: BehaviorSurfaceKind;
+    runner?: string;
+    changedFiles: BehaviorChangedFile[];
+}
+export interface BehaviorGraphFragment {
+    nodes: BehaviorNode[];
+    edges: BehaviorEdge[];
+    diagnostics?: BehaviorDiagnostic[];
+}
+export interface BehaviorAnalyzerAdapter {
+    id: string;
+    version: string;
+    detect(context: BehaviorAnalysisContext): BehaviorAdapterDetection | Promise<BehaviorAdapterDetection>;
+    analyze(context: BehaviorAnalysisContext): BehaviorGraphFragment | Promise<BehaviorGraphFragment>;
+}
+export interface InferredBehaviorEntrypoint {
+    kind: "route" | "screen" | "command";
+    value: string;
+    file: string;
+    confidence: BehaviorConfidence;
+}
+export interface InferredBehaviorSelector {
+    kind: string;
+    value: string;
+    file: string;
+    addedInDiff?: boolean;
+}
+export interface InferredBehaviorCoverage {
+    title: string;
+    priority: string;
+    reason: string;
+    checks: string[];
+}
+export interface InferredBehaviorFlow {
+    kind: string;
+    title: string;
+    reason: string;
+    files: string[];
+    steps: string[];
+    entrypoints: InferredBehaviorEntrypoint[];
+    selectors: InferredBehaviorSelector[];
+    coverage: InferredBehaviorCoverage[];
+    fixtureStatus: string;
+    fixtureFiles: string[];
+}
+export interface InferredFlowAdapterOptions {
+    flows: InferredBehaviorFlow[];
+}
+export declare function analyzeBehaviorGraph(context: BehaviorAnalysisContext, adapters: BehaviorAnalyzerAdapter[]): Promise<BehaviorGraph>;
+export declare function mergeBehaviorGraphFragments(fragments: BehaviorGraphFragment[]): BehaviorGraphFragment;
+export declare function createInferredFlowBehaviorAdapter(options: InferredFlowAdapterOptions): BehaviorAnalyzerAdapter;
+export declare function createBehaviorNodeId(kind: BehaviorNodeKind, ...parts: string[]): string;
+export declare function createBehaviorEdge(kind: BehaviorEdgeKind, from: string, to: string, confidence: BehaviorConfidence, evidence?: BehaviorEvidence[]): BehaviorEdge;