@principal-ai/subsystems-react 0.28.7 → 0.30.0

package/src/subsystem/model.ts

@@ -26,6 +26,27 @@ import { purlOwnerName, purlRepoKey } from './paths';
 export type SubsystemConstructDeclaration = GraphifyComponentDetail;
 export type SubsystemDeclarationProvenance = 'verified' | 'authored';
 
+/** One declared parameter in an agent-extracted (augmented) signature. */
+export interface SubsystemSignatureParameter {
+  /** Parameter name when the language declares one. */
+  name?: string;
+  /** Declared type as written in source (empty string when untyped). */
+  type: string;
+  /** True for optional parameters (`?`, defaulted, rest, …). */
+  optional?: boolean;
+}
+
+/**
+ * Language-agnostic declared signature extracted by an agent from source and
+ * accepted as a graphify augmentation. Confirms a function/method when Graphify
+ * has no usable signature edges. Distinct from `declaration` (the model's own
+ * structured shape) and from a graphify-derived signature.
+ */
+export interface SubsystemSignatureClaim {
+  parameters: SubsystemSignatureParameter[];
+  returnType?: string;
+}
+
 export type SubsystemComponentConstruct =
   | 'class'
   | 'function'
@@ -91,7 +112,6 @@ export interface SubsystemDeclToken {
  * Belongs on `relations[]`, not on walkthrough hops.
  */
 export type SubsystemRelationType =
-  | 'imports'
   | 'extends'
   | 'inherits'
   | 'implements'
@@ -120,7 +140,7 @@ export type SubsystemEdgeMechanism =
 /**
  * Which edge vocabulary the canvas draws. The two vocabularies are disjoint;
  * a view shows only edges (and their labels) from the selected source.
- * - `relations`: only topology relation edges (`imports`, `extends`, …)
+ * - `relations`: only topology relation edges (`extends`, `implements`, …)
  * - `walkthroughs`: only walkthrough hop edges (`calls`, `feeds`, …)
  */
 export type SubsystemEdgeView = 'relations' | 'walkthroughs';
@@ -251,6 +271,15 @@ export interface SubsystemComponent {
    * a different language just needs a different tokenizer and text joiner.
    */
   tokens?: SubsystemDeclToken[];
+  /**
+   * Accepted agent-extracted signature (from the graphify augmentation store)
+   * confirming this function/method when Graphify has no usable signature
+   * edges. Populated by the host when serving an enriched graph — never
+   * persisted in the model document. Its presence is how a component knows its
+   * declaration is augmentation-backed; the panel renders no special treatment
+   * yet.
+   */
+  signatureAugmentation?: SubsystemSignatureClaim;
   /**
    * Anchored declaration location: graphify start line + hash of that line's
    * content at capture time. Populated by verify when an exact anchor resolves.
@@ -945,7 +974,6 @@ export type SubsystemGraphEdge = Edge<SubsystemGraphEdgeData>;
  * source (the two unions are disjoint).
  */
 export const SUBSYSTEM_RELATION_TYPES = [
-  'imports',
   'extends',
   'inherits',
   'implements',
@@ -986,7 +1014,6 @@ export function isWalkthroughMechanism(
 }
 
 export const MECHANISM_COLOR: Record<SubsystemEdgeMechanism, string> = {
-  imports: '#0893d2', // blue
   calls: '#4ec9b0', // teal
   extends: '#b48ead', // purple
   inherits: '#9b6fd0', // purple
@@ -1004,7 +1031,6 @@ export const MECHANISM_COLOR: Record<SubsystemEdgeMechanism, string> = {
 };
 
 export const MECHANISM_STYLE: Record<SubsystemEdgeMechanism, 'solid' | 'dashed' | 'dotted'> = {
-  imports: 'solid',
   calls: 'solid',
   extends: 'dashed',
   inherits: 'dashed',
@@ -1024,7 +1050,6 @@ export const MECHANISM_STYLE: Record<SubsystemEdgeMechanism, 'solid' | 'dashed'
 /** Mechanism → [description, verifiable-with-graphify]. Drives the "not
  *  directly verifiable" styling of edge labels. */
 export const MECHANISM_DESCRIPTIONS: [SubsystemEdgeMechanism, string, boolean][] = [
-  ['imports', 'import statement (code-level dependency)', true],
   ['calls', 'function/method call (call graph edge)', true],
   ['extends', 'class inheritance', true],
   ['inherits', 'class inheritance', true],

package/src/subsystem/nodes.tsx

@@ -539,7 +539,7 @@ export function SubsystemEdge({
   markerEnd,
 }: EdgeProps<SubsystemGraphEdge>) {
   const path = data?.elkPath ?? '';
-  const mechanism = data?.mechanism ?? 'imports';
+  const mechanism = data?.mechanism ?? 'uses';
   const color = MECHANISM_COLOR[mechanism] ?? '#888';
   // Dash style comes from the mechanism table (dashed = inverted-control or
   // observational relationships: hierarchy, registration, watches).