Graphorin

Appearance

Graphorin API reference v0.7.0

Graphorin API reference / @graphorin/tools / / CollisionResolution

Type Alias: CollisionResolution ​

ts
type CollisionResolution = 
  | {
  action: "priority-resolved";
  losers: ReadonlyArray<ToolSource>;
  tieBreakReason: "first-party-precedence" | "explicit-priority" | "registration-order";
  toolName: string;
  winner: ToolSource;
}
  | {
  action: "auto-prefix-applied";
  losers: ReadonlyArray<ToolSource>;
  renamed: {
     from: string;
     namespaceSource: string;
     to: string;
  };
  toolName: string;
  winner: ToolSource;
}
  | {
  action: "manual-rejected";
  conflictingSources: ReadonlyArray<ToolSource>;
  toolName: string;
}
  | {
  action: "first-party-precedence";
  losers: ReadonlyArray<ToolSource>;
  toolName: string;
  winner: ToolSource;
}
  | {
  action: "suppressed";
  losers: ReadonlyArray<ToolSource>;
  toolName: string;
  winner: ToolSource;
};

Defined in: packages/tools/src/registry/types.ts:45

Audit row produced for every collision the registry resolves. The dispatcher writes one record per (toolName, action) pair; the downstream audit emitter and counter increments read from these records so the data path stays single-source.

Union Members ​

Type Literal ​

ts
{
  action: "priority-resolved";
  losers: ReadonlyArray<ToolSource>;
  tieBreakReason: "first-party-precedence" | "explicit-priority" | "registration-order";
  toolName: string;
  winner: ToolSource;
}

Type Literal ​

ts
{
  action: "auto-prefix-applied";
  losers: ReadonlyArray<ToolSource>;
  renamed: {
     from: string;
     namespaceSource: string;
     to: string;
  };
  toolName: string;
  winner: ToolSource;
}

Type Literal ​

ts
{
  action: "manual-rejected";
  conflictingSources: ReadonlyArray<ToolSource>;
  toolName: string;
}

Type Literal ​

ts
{
  action: "first-party-precedence";
  losers: ReadonlyArray<ToolSource>;
  toolName: string;
  winner: ToolSource;
}

Type Literal ​

ts
{
  action: "suppressed";
  losers: ReadonlyArray<ToolSource>;
  toolName: string;
  winner: ToolSource;
}
NameTypeDescriptionDefined in
action"suppressed"W-116: an auto-prefix loser whose rename was impossible (the residual case after the fallback namespace + truncation - e.g. a pathological future source shape). The loser is dropped from the catalogue, but never silently: this record, a tool:collision:suppressed audit row and the tool.collision.suppressed.total counter all mark it.packages/tools/src/registry/types.ts:90
losersReadonlyArray&lt;ToolSource&gt;-packages/tools/src/registry/types.ts:81
toolNamestring-packages/tools/src/registry/types.ts:79
winnerToolSource-packages/tools/src/registry/types.ts:80

Stable ​