docs: rewrite README and AGENTS.md, add admin sync button

frontend/src/api.ts

@@ -5,6 +5,7 @@ export interface FlowDefinition {
   name: string;
   description: string;
   status: string;
+  source_path: string | null;
   continuation_flow_id: string | null;
   created_at: string;
 }
@@ -60,6 +61,14 @@ export interface Decision {
   continuation_run: Run | null;
 }
 
+export interface SyncReport {
+  added: string[];
+  updated: string[];
+  deleted: string[];
+  skipped: string[];
+  errors: Record<string, string>;
+}
+
 export class ApiError extends Error {
   status: number;
   constructor(status: number, message: string) {
@@ -135,4 +144,8 @@ export const api = {
     ),
   listLangflow: () =>
     req<{ id: string; name: string }[]>("/api/flows/langflow/available"),
+  syncFlows: () =>
+    req<SyncReport>("/api/flows/sync", {
+      method: "POST",
+    }),
 };