Process Trace

map://{repository}/process/{process_id}

interface ProcessTraceResponse {
  id: string;
  label: string;
  process_type: 'intra_community' | 'cross_community';
  communities: string[];     // Communities traversed
  trace: TraceStep[];
  related: RelatedProcessItem[];
}

interface TraceStep {
  step: number;
  name: string;           // Function name
  location: string;       // file:line
}

interface RelatedProcessItem {
  id: string;
  label: string;
  common_entry_point?: string;
}

{
  "id": "proc_login",
  "label": "UserLogin",
  "process_type": "cross_community",
  "communities": ["API", "Authentication", "DataAccess"],
  "trace": [
    {
      "step": 1,
      "name": "handleLoginRequest",
      "location": "src/api/auth.ts:45"
    },
    {
      "step": 2,
      "name": "authenticateUser",
      "location": "src/auth/authenticate.ts:67"
    },
    {
      "step": 3,
      "name": "getUserByEmail",
      "location": "src/data/users.ts:23"
    },
    {
      "step": 4,
      "name": "createSession",
      "location": "src/auth/session.ts:89"
    }
  ],
  "related": [
    {
      "id": "proc_signup",
      "label": "UserSignup",
      "common_entry_point": "handleAuthRequest"
    }
  ]
}

const process = await getResource('map://my-app/process/{id}');

for (const step of process.trace) {
  console.log(`Step ${step.step}: ${step.name} at ${step.location}`);
}

// Which communities does this process touch?
console.log(`Traverses: ${process.communities.join(' -> ')}`);

// Explore similar processes
for (const related of process.related) {
  const relatedTrace = await getResource(`map://my-app/process/${related.id}`);
}