[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_545":546,"_547":548},"routes/_app.x.$handle.$name",{"_100":99,"_37":50,"_109":90,"_32":110,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_26":-5,"_121":-5,"_122":-5,"_123":30,"_124":125,"_126":30,"_127":-5,"_128":-5,"_129":130},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_48":49,"_37":50,"_43":51,"_52":-5,"_53":30,"_54":55,"_56":55,"_57":58,"_59":-5,"_19":60,"_61":-5,"_62":30,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":83,"_84":85,"_86":87,"_88":30},"version",29,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","606079ae-4c32-4778-88d7-e6c7eaf7c895","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":-7,"_29":30,"_31":30,"_32":33,"_34":33},"file",{"_35":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":14,"_46":47,"_29":30},"previous","deleted",false,"deletedHere","path","packages/orchestrator/src/incident.ts","latestPath","fileId","92995d34-ae73-11f1-9680-1607ee4eb77e","name","incident.ts","fileType","script","content","/**\n * Incident state machine with human-in-the-loop enforcement.\n *\n * AI may move incidents to INVESTIGATING on its own. Only a human with the\n * right role may perform: ESCALATE, DISPATCH_GUARD, ANNOUNCE, RESOLVE,\n * FALSE_ALARM, or any EMERGENCY_* action.\n */\n\nexport type IncidentStatus =\n | \"NEW\" | \"ANALYZING\" | \"INVESTIGATING\" | \"VERIFIED\"\n | \"ESCALATED\" | \"RESPONDING\" | \"RESOLVED\" | \"FALSE_ALARM\";\n\nexport type OperatorAction =\n | \"OBSERVE\" | \"DISPATCH_GUARD\" | \"ANNOUNCE\" | \"ESCALATE\"\n | \"FALSE_ALARM\" | \"RESOLVE\" | \"EMERGENCY_STOP\" | \"ABORT_MISSION\";\n\nexport interface Incident {\n id: string;\n status: IncidentStatus;\n verified: boolean;\n timeline: { at: string; kind: string; actor: string }[];\n operatorAction?: OperatorAction;\n resolution?: string;\n}\n\nconst ALLOWED: Record = {\n NEW: [\"ANALYZING\"],\n ANALYZING: [\"INVESTIGATING\", \"FALSE_ALARM\"],\n INVESTIGATING: [\"VERIFIED\", \"FALSE_ALARM\"],\n VERIFIED: [\"ESCALATED\", \"RESOLVED\", \"FALSE_ALARM\"],\n ESCALATED: [\"RESPONDING\", \"RESOLVED\", \"FALSE_ALARM\"],\n RESPONDING: [\"RESOLVED\"],\n RESOLVED: [],\n FALSE_ALARM: [],\n};\n\nexport function transition(inc: Incident, to: IncidentStatus, actor: string): Incident {\n if (!ALLOWED[inc.status].includes(to)) throw new Error(`${inc.status} -> ${to} not allowed`);\n if (to === \"VERIFIED\") inc.verified = true;\n inc.status = to;\n inc.timeline.push({ at: new Date().toISOString(), kind: `STATUS:${to}`, actor });\n return inc;\n}\n\nconst HUMAN_ACTIONS = new Set([\n \"DISPATCH_GUARD\", \"ANNOUNCE\", \"ESCALATE\", \"FALSE_ALARM\", \"RESOLVE\", \"EMERGENCY_STOP\", \"ABORT_MISSION\",\n]);\n\n/** Only a human may take sensitive actions. */\nexport function requireHumanAction(actor: string): boolean {\n return actor !== \"SYSTEM\"; // in practice, check the actor's role against a permission map\n}\n\nexport function operatorAction(inc: Incident, action: OperatorAction, actor: string): Incident {\n if (HUMAN_ACTIONS.has(action) && !requireHumanAction(actor)) {\n throw new Error(\"system cannot take sensitive operator action\");\n }\n inc.operatorAction = action;\n inc.timeline.push({ at: new Date().toISOString(), kind: `OPERATOR:${action}`, actor });\n return inc;\n}\n","createdAt",["D",1789194682901],"branchVersion","branchId","2fec3878-26a7-4bae-a15d-ace775b2d642","id","db1b462e-d75b-4e72-ad79-c2a3a45673c8","guardiq-platform",["D",1789194473035],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","GuardIQ platform — staging repo + Obsidian context vault","imageUrl","87827f52-809f-4c8c-82fd-cce5c85d6470","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","01a09439-0fa1-765a-b133-877a1dbbdae8","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_100":99,"_108":104},"org",{"_100":99,"_101":102,"_103":104,"_19":60,"_105":106,"_107":30},"branch",{"_13":89,"_37":90,"_48":47,"_91":49,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":50,"_98":99},"isOwned",49,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","brandonschoelkoph","handle","displayName","Brandon Schoelkoph","avatar","https://lh3.googleusercontent.com/a/ACg8ocL_nGI6cWAuFF3QdGYr09skIboOCarbJkURw78yoFABEesnKSS2=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_48":49,"_37":50,"_43":541,"_52":-5,"_53":30,"_54":55,"_56":55,"_57":58,"_59":-5,"_19":60,"_61":-5,"_62":30,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":542,"_84":543,"_86":544,"_88":30},"tree",[221,232,241,245,247,262,263,264,265,266],"files",[221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255,256,257,258,259,260,261,262,263,264,265,266],"counts",{"_211":66,"_212":202,"_213":66,"_214":215,"_216":217},"contents",[131,132,133,134,135,136,137,138,139,140],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_48":205,"_37":206,"_35":207,"_144":-5,"_46":47,"_45":208,"_146":147,"_43":209,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_32":210},{"_48":199,"_37":200,"_35":201,"_144":-5,"_46":47,"_45":202,"_146":147,"_43":203,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_32":204},{"_48":193,"_37":194,"_35":195,"_144":-5,"_46":47,"_45":196,"_146":147,"_43":197,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_32":198},{"_48":187,"_37":188,"_35":189,"_144":-5,"_46":47,"_45":190,"_146":147,"_43":191,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_32":192},{"_48":180,"_37":181,"_35":182,"_144":-5,"_46":47,"_45":183,"_146":147,"_43":184,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_32":186},{"_48":173,"_37":174,"_35":175,"_144":-5,"_46":47,"_45":176,"_146":147,"_43":177,"_13":66,"_39":26,"_41":178,"_29":30,"_150":-5,"_32":179},{"_48":166,"_37":167,"_35":168,"_144":-5,"_46":47,"_45":169,"_146":147,"_43":170,"_13":66,"_39":26,"_41":171,"_29":30,"_150":-5,"_32":172},{"_48":159,"_37":160,"_35":161,"_144":-5,"_46":47,"_45":162,"_146":147,"_43":163,"_13":66,"_39":26,"_41":164,"_29":30,"_150":-5,"_32":165},{"_48":152,"_37":153,"_35":154,"_144":-5,"_46":47,"_45":155,"_146":147,"_43":156,"_13":66,"_39":26,"_41":157,"_29":30,"_150":-5,"_32":158},{"_48":141,"_37":142,"_35":143,"_144":-5,"_46":47,"_45":145,"_146":147,"_43":148,"_13":66,"_39":26,"_41":149,"_29":30,"_150":-5,"_32":151},"f7c6fbf9-57b7-4b39-910f-25299fe5dcf9","package.json","4841c258-ae73-11f1-8551-1607ee4eb77e","parentId",25,"latest",true,["D",1789194558144],"{\n \"name\": \"guardiq-platform\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"workspaces\": [\"apps/*\", \"packages/*\"],\n \"scripts\": {\n \"dev:api\": \"npm run dev --workspace @guardiq/api\",\n \"dev:web\": \"npm run dev --workspace @guardiq/web\",\n \"migrate\": \"npm run migrate --workspace @guardiq/api\",\n \"build\": \"npm run build --workspaces --if-present\",\n \"test\": \"npm run test --workspaces --if-present\"\n }\n}\n","label",[142],"42fc3168-7902-463f-a39c-dc0a3372cfb8","docker-compose.yml","4880214c-ae73-11f1-8551-1607ee4eb77e",26,["D",1789194558563],"# Local dev database. Production on Railway uses managed Postgres instead.\nservices:\n db:\n image: postgres:16\n environment:\n POSTGRES_USER: guard\n POSTGRES_PASSWORD: guard\n POSTGRES_DB: guardiq\n ports:\n - \"5432:5432\"\n volumes:\n - pgdata:/var/lib/postgresql/data\nvolumes:\n pgdata:\n",[153],"93d53b45-c58a-49b6-bb83-f72d5490691c","README.md","2eef1922-ae73-11f1-9c96-1607ee4eb77e",7,["D",1789194515688],"# GuardIQ Robotics Command — Platform (Railway)\n\nThe production multi-tenant security-orchestration platform. This repo deploys\nto **Railway** (PostgreSQL + Node/TypeScript + WebSockets). The investor demo\nlives separately in the `guardiq-command` Val Town val.\n\n> **Status: scaffold.** Repo structure, schema, and build pipeline exist. The\n> domain modules (HAL, event bus, orchestrator agents, RBAC, incident\n> workflow) are being developed in phases. Everything is a simulator — no real\n> hardware or GuardIQ connection is claimed.\n\n## Layout\n\n```\napps/\n api/ Node + TypeScript backend (HTTP + WebSockets)\n web/ React + Vite + Tailwind frontend\ndb/ SQL migrations + seeded demo data\npackages/ shared libs (types, HAL abstractions, event bus)\ncontext/ Obsidian knowledge vault (open in Obsidian)\ninfra/ Dockerfiles, railway.toml\n```\n\n## Run locally\n\n```bash\n# needs: docker compose (or local Postgres), node 20+\nexport DATABASE_URL=postgres://guard:guard@localhost:5432/guardiq\n\ndocker compose up -d db # start Postgres\ncd apps/api && npm i && npm run migrate && npm run dev\n\ncd apps/web && npm i && npm run dev # separate terminal\n```\n\n## Deploy to Railway (first time)\n\n1. Push this repo to GitHub.\n2. Railway → **New Project → Deploy from GitHub →** select the repo.\n3. Railway auto-detects `infra/railway.toml` (services: `api`, `web`, `db`).\n4. For the `db` service, Railway Proves managed Postgres; set the `api` env\n `DATABASE_URL` to its connection string.\n5. `db` plugin runs `db/*.sql` on start (or run `npm run migrate` in api).\n6. Railway gives each service a **.up.railway.app** URL.\n\nSee `context/notes/300-deployment.md` for the full walkthrough.\n\n## Roadmap (phases)\n\nPhase 0 standalone simulator → 1 investor demo → 2 camera → 3 trailer →\n4 ground robot → 5 GuardIQ gateway → 6 multi-site → 7 humanoid → 8 autonomous ops.\n",[160],"fd102bde-2927-448e-811c-c5ca51103d8d",".gitignore","2ef8530c-ae73-11f1-9c96-1607ee4eb77e",8,["D",1789194515756],"node_modules/\ndist/\nbuild/\n.env\n.env.*\n!.env.example\n*.local\n.DS_Store\ncoverage/\n.obsidian/workspace.json\n.obsidian/cache\n",[167],"805e5694-6cb0-4059-a561-ec8a6a0cce41",".env.example","2f012036-ae73-11f1-9c96-1607ee4eb77e",9,["D",1789194515811],"# GuardIQ Platform — environment template\n# Never commit real secrets. Railways, Railway variables override these.\n\nNODE_ENV=development\nPORT=4000\nDATABASE_URL=postgres://guard:guard@localhost:5432/guardiq\n\n# Auth\nSESSION_SECRET=change-me\n# Comma-separated issuer list allowed by JWT verification:\nAUTH_ISSUER=https://guardiq.up.railway.app\n\n# Optional live integrations (leave blank to stay isolated/simulated)\nCONTEXT7_API_KEY=\nEXA_API_KEY=\nGUARDIQ_GATEWAY_URL=\nGUARDIQ_GATEWAY_ENABLED=false\n",[174],"028adbb5-ba8a-440a-8a44-edceb9e88b5a","packages","172cd9d8-1b2f-4a0d-a388-a4396a20e24a",20,["D",1789194551656],"directory",[181],"b97e2c5e-4650-4495-b03a-76e0295c7b90","infra","b44ebea9-7bdb-4190-bb47-6c2b0effdb48",10,["D",1789194515912],[188],"e715ac57-9e7a-4cc4-a3a0-e2cdfdb591b4","db","f7a4fc25-cb73-4cef-bd2e-2a7dd82112e8",11,["D",1789194516022],[194],"003621d4-5290-44d2-b97b-9fd787159ebe","context","8d6cb79e-d3f2-4c3d-b66d-cf6c88ce820c",1,["D",1789194490537],[200],"53b679c8-30df-4b3a-8384-a6a17936112f","apps","d400e917-22dc-49af-a027-ceb67fd9fc0d",13,["D",1789194530755],[206],"pulls","branches","forks","envVars",{"_218":66,"_220":66},"connections",{"_218":66,"_219":66},"count","unfilledCount","emptyCount",{"_48":205,"_37":206,"_35":207,"_144":-5,"_46":47,"_45":208,"_146":147,"_43":538,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":539,"_32":540},{"_48":534,"_37":478,"_35":472,"_144":207,"_46":47,"_45":208,"_146":147,"_43":535,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":536,"_32":537},{"_48":530,"_37":301,"_35":495,"_144":472,"_46":47,"_45":504,"_146":147,"_43":531,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":532,"_32":533},{"_48":526,"_37":194,"_35":520,"_144":495,"_46":47,"_45":521,"_146":147,"_43":527,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":528,"_32":529},{"_48":517,"_37":518,"_35":519,"_144":520,"_46":47,"_45":521,"_146":147,"_43":522,"_13":66,"_39":40,"_41":523,"_29":30,"_150":-5,"_268":524,"_32":525},{"_48":509,"_37":510,"_35":511,"_144":495,"_46":47,"_45":512,"_146":147,"_43":513,"_13":66,"_39":40,"_41":514,"_29":30,"_150":-5,"_268":515,"_32":516},{"_48":501,"_37":502,"_35":503,"_144":495,"_46":47,"_45":504,"_146":147,"_43":505,"_13":66,"_39":40,"_41":506,"_29":30,"_150":-5,"_268":507,"_32":508},{"_48":493,"_37":293,"_35":494,"_144":495,"_46":47,"_45":496,"_146":30,"_43":497,"_13":66,"_39":40,"_41":498,"_29":30,"_150":-5,"_268":499,"_32":500},{"_48":485,"_37":486,"_35":487,"_144":472,"_46":47,"_45":488,"_146":147,"_43":489,"_13":66,"_39":26,"_41":490,"_29":30,"_150":-5,"_268":491,"_32":492},{"_48":479,"_37":142,"_35":480,"_144":472,"_46":47,"_45":208,"_146":147,"_43":481,"_13":66,"_39":26,"_41":482,"_29":30,"_150":-5,"_268":483,"_32":484},{"_48":469,"_37":470,"_35":471,"_144":472,"_46":47,"_45":473,"_146":147,"_43":474,"_13":66,"_39":26,"_41":475,"_29":30,"_150":-5,"_268":476,"_32":477},{"_48":199,"_37":200,"_35":201,"_144":-5,"_46":47,"_45":202,"_146":147,"_43":466,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":467,"_32":468},{"_48":462,"_37":445,"_35":439,"_144":201,"_46":47,"_45":440,"_146":147,"_43":463,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":464,"_32":465},{"_48":454,"_37":455,"_35":456,"_144":439,"_46":47,"_45":457,"_146":147,"_43":458,"_13":66,"_39":26,"_41":459,"_29":30,"_150":-5,"_268":460,"_32":461},{"_48":446,"_37":447,"_35":448,"_144":439,"_46":47,"_45":449,"_146":147,"_43":450,"_13":66,"_39":26,"_41":451,"_29":30,"_150":-5,"_268":452,"_32":453},{"_48":436,"_37":437,"_35":438,"_144":439,"_46":47,"_45":440,"_146":147,"_43":441,"_13":66,"_39":26,"_41":442,"_29":30,"_150":-5,"_268":443,"_32":444},{"_48":432,"_37":423,"_35":417,"_144":201,"_46":47,"_45":427,"_146":147,"_43":433,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":434,"_32":435},{"_48":424,"_37":425,"_35":426,"_144":417,"_46":47,"_45":427,"_146":147,"_43":428,"_13":66,"_39":26,"_41":429,"_29":30,"_150":-5,"_268":430,"_32":431},{"_48":414,"_37":415,"_35":416,"_144":417,"_46":47,"_45":418,"_146":147,"_43":419,"_13":66,"_39":26,"_41":420,"_29":30,"_150":-5,"_268":421,"_32":422},{"_48":408,"_37":160,"_35":409,"_144":201,"_46":47,"_45":202,"_146":147,"_43":410,"_13":66,"_39":26,"_41":411,"_29":30,"_150":-5,"_268":412,"_32":413},{"_48":193,"_37":194,"_35":195,"_144":-5,"_46":47,"_45":196,"_146":147,"_43":405,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":406,"_32":407},{"_48":401,"_37":400,"_35":395,"_144":195,"_46":47,"_45":196,"_146":147,"_43":402,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":403,"_32":404},{"_48":392,"_37":393,"_35":394,"_144":395,"_46":47,"_45":196,"_146":147,"_43":396,"_13":66,"_39":26,"_41":397,"_29":30,"_150":-5,"_268":398,"_32":399},{"_48":384,"_37":385,"_35":386,"_144":195,"_46":47,"_45":387,"_146":147,"_43":388,"_13":66,"_39":26,"_41":389,"_29":30,"_150":-5,"_268":390,"_32":391},{"_48":187,"_37":188,"_35":189,"_144":-5,"_46":47,"_45":190,"_146":147,"_43":381,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":382,"_32":383},{"_48":374,"_37":375,"_35":376,"_144":189,"_46":47,"_45":190,"_146":147,"_43":377,"_13":66,"_39":26,"_41":378,"_29":30,"_150":-5,"_268":379,"_32":380},{"_48":180,"_37":181,"_35":182,"_144":-5,"_46":47,"_45":183,"_146":147,"_43":371,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":372,"_32":373},{"_48":367,"_37":354,"_35":348,"_144":182,"_46":47,"_45":349,"_146":147,"_43":368,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":369,"_32":370},{"_48":363,"_37":301,"_35":357,"_144":348,"_46":47,"_45":358,"_146":147,"_43":364,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":365,"_32":366},{"_48":355,"_37":293,"_35":356,"_144":357,"_46":47,"_45":358,"_146":147,"_43":359,"_13":66,"_39":40,"_41":360,"_29":30,"_150":-5,"_268":361,"_32":362},{"_48":346,"_37":142,"_35":347,"_144":348,"_46":47,"_45":349,"_146":147,"_43":350,"_13":66,"_39":26,"_41":351,"_29":30,"_150":-5,"_268":352,"_32":353},{"_48":342,"_37":321,"_35":316,"_144":182,"_46":47,"_45":183,"_146":147,"_43":343,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":344,"_32":345},{"_48":338,"_37":301,"_35":325,"_144":316,"_46":47,"_45":333,"_146":147,"_43":339,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":340,"_32":341},{"_48":331,"_37":293,"_35":332,"_144":325,"_46":47,"_45":333,"_146":147,"_43":334,"_13":66,"_39":40,"_41":335,"_29":30,"_150":-5,"_268":336,"_32":337},{"_48":322,"_37":323,"_35":324,"_144":325,"_46":47,"_45":326,"_146":147,"_43":327,"_13":66,"_39":40,"_41":328,"_29":30,"_150":-5,"_268":329,"_32":330},{"_48":314,"_37":142,"_35":315,"_144":316,"_46":47,"_45":183,"_146":147,"_43":317,"_13":66,"_39":26,"_41":318,"_29":30,"_150":-5,"_268":319,"_32":320},{"_48":310,"_37":291,"_35":285,"_144":182,"_46":47,"_45":286,"_146":147,"_43":311,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":312,"_32":313},{"_48":306,"_37":301,"_35":295,"_144":285,"_46":47,"_45":296,"_146":147,"_43":307,"_13":66,"_39":185,"_41":-5,"_29":30,"_150":-5,"_268":308,"_32":309},{"_48":302,"_37":38,"_35":36,"_144":295,"_46":47,"_45":14,"_146":147,"_43":303,"_13":66,"_39":40,"_41":42,"_29":30,"_150":-5,"_268":304,"_32":305},{"_48":292,"_37":293,"_35":294,"_144":295,"_46":47,"_45":296,"_146":147,"_43":297,"_13":66,"_39":40,"_41":298,"_29":30,"_150":-5,"_268":299,"_32":300},{"_48":283,"_37":142,"_35":284,"_144":285,"_46":47,"_45":286,"_146":147,"_43":287,"_13":66,"_39":26,"_41":288,"_29":30,"_150":-5,"_268":289,"_32":290},{"_48":173,"_37":174,"_35":175,"_144":-5,"_46":47,"_45":176,"_146":147,"_43":280,"_13":66,"_39":26,"_41":178,"_29":30,"_150":-5,"_268":281,"_32":282},{"_48":166,"_37":167,"_35":168,"_144":-5,"_46":47,"_45":169,"_146":147,"_43":277,"_13":66,"_39":26,"_41":171,"_29":30,"_150":-5,"_268":278,"_32":279},{"_48":159,"_37":160,"_35":161,"_144":-5,"_46":47,"_45":162,"_146":147,"_43":274,"_13":66,"_39":26,"_41":164,"_29":30,"_150":-5,"_268":275,"_32":276},{"_48":152,"_37":153,"_35":154,"_144":-5,"_46":47,"_45":155,"_146":147,"_43":271,"_13":66,"_39":26,"_41":157,"_29":30,"_150":-5,"_268":272,"_32":273},{"_48":141,"_37":142,"_35":143,"_144":-5,"_46":47,"_45":145,"_146":147,"_43":267,"_13":66,"_39":26,"_41":149,"_29":30,"_150":-5,"_268":269,"_32":270},["D",1789194558144],"children",[],[142],["D",1789194558563],[],[153],["D",1789194515688],[],[160],["D",1789194515756],[],[167],["D",1789194515811],[],[174],"ffada2bb-02c2-423f-b5ab-62c6c776bf0b","928645c8-ae73-11f1-9680-1607ee4eb77e","a3b0a955-8f65-4009-9529-26cec6522299",27,["D",1789194682779],"{\n \"name\": \"@guardiq/orchestrator\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"main\": \"src/index.ts\",\n \"exports\": { \".\": \"./src/index.ts\" }\n}\n",[],[181,291,142],"orchestrator","64da81a2-e5cd-4a91-ac10-7df351c3e424","index.ts","9290a1a8-ae73-11f1-9680-1607ee4eb77e","0932d956-b4dd-4e56-960c-4ea47e81c92b",28,["D",1789194682845],"import type { GuardiqEvent } from \"@guardiq/event-bus\";\n\n/**\n * The AI Orchestrator's decision layer. Never a black box: every analysis\n * yields decision, confidence, reason, evidence, and a recommended action.\n * It only RECOMMENDS sensitive actions — a human must approve them.\n */\n\nexport interface AiDecision {\n decision: string; // e.g. \"PERSON_DETECTED\"\n confidence: number; // 0..1\n risk: number; // 0..100\n reason: string;\n evidence: string[];\n recommendedAction: string;\n autoSafe: boolean; // true = safe to do automatically (focus/track/observe)\n}\n\n/** Correlate a raw detection into an analyzed AI decision. */\nexport function analyzeEvent(evt: GuardiqEvent): AiDecision {\n const inRestricted = evt.zoneId?.startsWith(\"restricted\") ?? false;\n switch (evt.eventType) {\n case \"PERSON_DETECTED\":\n return rule(\n evt, inRestricted,\n \"PERSON_DETECTED\",\n inRestricted\n ? \"Person detected inside restricted zone outside expected conditions.\"\n : \"Person detected in a monitored zone.\",\n \"Dispatch nearest robot for remote verification.\",\n );\n case \"MOTION_DETECTED\":\n return rule(\n evt, inRestricted,\n \"INVESTIGATE\",\n inRestricted\n ? \"Motion detected in restricted zone; no authorized activity scheduled.\"\n : \"Motion detected; confidence insufficient for person classification.\",\n \"Focus nearby cameras; dispatch robot if a secondary sensor correlates.\",\n );\n case \"VEHICLE_DETECTED\":\n return rule(evt, inRestricted, \"VEHICLE_INTRUSION\",\n \"Vehicle detected in a pedestrian/non-vehicle zone.\", \"Verify plate + dispatch guard.\");\n default:\n return rule(evt, inRestricted, evt.eventType, \"Event received and correlated.\",\n \"Route to operator for disposition.\");\n }\n}\n\nfunction rule(\n evt: GuardiqEvent,\n restricted: boolean,\n decision: string,\n reason: string,\n rec: string,\n): AiDecision {\n const risk = Math.round(evt.confidence * (restricted ? 90 : 55));\n return {\n decision,\n confidence: evt.confidence,\n risk,\n reason,\n evidence: [`${evt.sourceType}:${evt.source}`, `confidence ${evt.confidence.toFixed(2)}`, `zone ${evt.zoneId ?? \"unknown\"}`],\n recommendedAction: rec,\n autoSafe: evt.eventType === \"MOTION_DETECTED\" && !restricted,\n };\n}\n",[],[181,291,301,293],"src","02712512-0eda-48eb-a32f-cb9c97b8003e",["D",1789194682901],[],[181,291,301,38],"1d61ef93-d335-47e8-9dc0-5d61114596d0",["D",1789194682845],[259,260],[181,291,301],"31687d80-14cf-4b43-87e5-abe1a3595140",["D",1789194682779],[258,261],[181,291],"d4509522-5909-476c-bb02-d82774fd1e79","445f164a-ae73-11f1-aa80-1607ee4eb77e","4a24480b-c677-4a91-b753-776ac6ef4f0a",["D",1789194551656],"{\n \"name\": \"@guardiq/hal\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"main\": \"src/index.ts\",\n \"exports\": { \".\": \"./src/index.ts\", \"./simulator\": \"./src/simulator.ts\" }\n}\n",[],[181,321,142],"hal","092dcc20-10b2-48ae-a8b4-fa6f0da414cb","simulator.ts","4472a584-ae73-11f1-aa80-1607ee4eb77e","10762c49-4fac-4d93-bec9-57cd8548a17a",22,["D",1789194551789],"import type { Mission, Position, RobotProvider, Telemetry } from \"./index.ts\";\n\n/** Pure in-process simulator — no network, no hardware. */\nexport class SimulatorRobotProvider implements RobotProvider {\n readonly vendor = \"simulator\";\n private connected = false;\n pos: Position = { x: 0.88, y: 0.32 };\n private mission: Mission | null = null;\n\n constructor(private deviceId: string, opts?: { start?: Position }) {\n if (opts?.start) this.pos = opts.start;\n }\n\n async connect() { this.connected = true; }\n async disconnect() { this.connected = false; }\n\n getTelemetry(): Promise {\n return Promise.resolve({\n position: this.pos,\n heading: 0,\n speed: 0,\n battery: 96,\n connection: this.connected ? \"ONLINE\" : \"OFFLINE\",\n mission: this.mission?.id ?? null,\n camera: \"STREAMING\",\n temperature: 41,\n signalStrength: 98,\n lastHeartbeat: Date.now(),\n });\n }\n\n async sendMission(m: Mission) {\n // Simulate: move toward waypoints then arrive.\n this.mission = m;\n m.status = \"ASSIGNED\";\n const end = m.waypoints[m.waypoints.length - 1] ?? { x: 0.5, y: 0.5 };\n const steps = 24;\n for (let i = 1; i <= steps; i++) {\n const a = i / steps;\n this.pos = {\n x: this.pos.x + (end.x - this.pos.x) * a,\n y: this.pos.y + (end.y - this.pos.y) * a,\n };\n await new Promise((r) => setTimeout(r, 120));\n }\n m.status = \"COMPLETED\";\n this.mission = null;\n }\n\n async cancelMission() { this.mission = null; }\n async returnToDock() { this.pos = { x: 0.9, y: 0.86 }; }\n async emergencyStop() { this.pos = this.pos; }\n}\n",[],[181,321,301,323],"6a287759-e320-47f4-96c3-01b37d48c202","4469bd34-ae73-11f1-aa80-1607ee4eb77e",21,["D",1789194551726],"// Hardware Abstraction Layer — the contract every robot vendor adapter obeys.\n//\n// Business logic NEVER imports a vendor SDK. It talks to RobotProvider, and a\n// factory maps device.provider -> adapter. Adding a vendor = new adapter, not a\n// rewrite. (Spot / Unitree / Agility / Figure / Apptronik / 1X adapters are\n// future work — none are wired here.)\n\nexport type RobotState =\n | \"IDLE\" | \"PATROL\" | \"INVESTIGATE\" | \"OBSERVE\" | \"ESCORT\"\n | \"RETURN_TO_DOCK\" | \"CHARGING\" | \"OFFLINE\" | \"FAULT\" | \"EMERGENCY_STOP\";\n\nexport type MissionType =\n | \"PATROL_ZONE\" | \"INVESTIGATE_EVENT\" | \"OBSERVE_LOCATION\"\n | \"CHECK_PERIMETER\" | \"VERIFY_DOOR\" | \"RETURN_TO_DOCK\";\n\nexport type MissionStatus =\n | \"CREATED\" | \"QUEUED\" | \"ASSIGNED\" | \"EN_ROUTE\" | \"ON_SCENE\"\n | \"COMPLETED\" | \"FAILED\" | \"CANCELLED\";\n\nexport interface Position { x: number; y: number; }\n\nexport interface Telemetry {\n position: Position;\n heading: number; // degrees\n speed: number; // m/s\n battery: number; // percent\n connection: \"ONLINE\" | \"OFFLINE\" | \"DEGRADED\";\n mission: string | null;\n camera: \"STREAMING\" | \"IDLE\" | \"OFF\";\n temperature: number; // C\n signalStrength: number; // percent\n lastHeartbeat: number; // epoch ms\n}\n\nexport interface Mission {\n id: string;\n type: MissionType;\n status: MissionStatus;\n waypoints: Position[];\n createdAt: number;\n}\n\nexport interface RobotProvider {\n readonly vendor: string;\n connect(): Promise;\n disconnect(): Promise;\n getTelemetry(): Promise;\n sendMission(m: Mission): Promise;\n cancelMission(m: Mission): Promise;\n returnToDock(): Promise;\n emergencyStop(): Promise;\n}\n\n/** Registry: provider id -> adapter constructor. Simulator is first. */\nexport type ProviderFactory = (deviceId: string, opts?: Record) => RobotProvider;\nexport function makeRegistry(map: Record) {\n return {\n get(id: string, deviceId: string): RobotProvider {\n const f = map[id];\n if (!f) throw new Error(`unknown provider adapter: \"${id}\"`);\n return f(deviceId);\n },\n };\n}\n",[],[181,321,301,293],"bdddaabe-a9f2-494f-ae1d-ef588d28e409",["D",1789194551726],[254,255],[181,321,301],"9428b440-2c0d-417d-8106-78f489b95b56",["D",1789194551656],[253,256],[181,321],"64eff733-e05f-4fbb-b2ec-39851f85dfb3","447b43ba-ae73-11f1-aa80-1607ee4eb77e","5b5784b1-95d7-4b9b-b1d7-9f34b60ad064",23,["D",1789194551839],"{\n \"name\": \"@guardiq/event-bus\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"main\": \"src/index.ts\",\n \"exports\": { \".\": \"./src/index.ts\" }\n}\n",[],[181,354,142],"event-bus","8edcfde4-80e6-4dba-aaa2-9589b18147dc","4483b8ba-ae73-11f1-aa80-1607ee4eb77e","6ba1f39c-3c55-4f90-ac62-f9aff25d95f1",24,["D",1789194551893],"// Normalized, event-driven bus. Ingestion -> validation -> dedup -> correlation\n// -> routing. Agents/handlers subscribe; no uncontrolled recursive autonomy.\n\nexport interface GuardiqEvent {\n id: string;\n eventType: string; // PERSON_DETECTED | MOTION_DETECTED | ...\n source: string; // \"CAM-02\" | \"ROBOT-01\"\n sourceType: \"CAMERA\" | \"ROBOT\" | \"SENSOR\" | \"GUARD\" | \"SYSTEM\";\n siteId: string;\n zoneId?: string;\n timestamp: string;\n confidence: number;\n dedupeKey?: string;\n metadata: Record;\n}\n\nconst uid = () => crypto.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n\nexport class EventBus {\n private subs = new Set<(e: GuardiqEvent) => void>();\n private seen = new Map(); // dedupeKey -> count\n\n subscribe(fn: (e: GuardiqEvent) => void) {\n this.subs.add(fn);\n return () => this.subs.delete(fn);\n }\n\n /** Validate + dedup, then route to subscribers. Returns event id. */\n publish(input: Omit): GuardiqEvent {\n this.validate(input);\n if (input.dedupeKey) {\n const n = this.seen.get(input.dedupeKey) ?? 0;\n if (n > 0) throw new Error(`duplicate event suppressed: ${input.dedupeKey}`);\n this.seen.set(input.dedupeKey, 1);\n setTimeout(() => this.seen.delete(input.dedupeKey), 300_000);\n }\n const e: GuardiqEvent = { ...input, id: uid(), timestamp: new Date().toISOString() };\n for (const fn of this.subs) {\n try { fn(e); } catch (err) { console.error(\"bus handler error\", err); }\n }\n return e;\n }\n\n private validate(e: Omit) {\n if (!e.eventType || typeof e.eventType !== \"string\") throw new Error(\"eventType required\");\n if (e.confidence < 0 || e.confidence > 1) throw new Error(\"confidence must be 0..1\");\n if ([\"CAMERA\", \"ROBOT\", \"SENSOR\", \"GUARD\", \"SYSTEM\"].indexOf(e.sourceType) < 0) {\n throw new Error(`bad sourceType: ${e.sourceType}`);\n }\n }\n}\n",[],[181,354,301,293],"56de72e7-c9a4-44a5-8df4-3504188cfe9b",["D",1789194551893],[250],[181,354,301],"da5f91c3-0d43-4536-856b-e4e5a1d70da5",["D",1789194551839],[249,251],[181,354],["D",1789194551656],[248,252,257],[181],"190ce375-4808-4221-ae49-604807876e69","railway.toml","2f179186-ae73-11f1-9c96-1607ee4eb77e",["D",1789194515912],"# Railway deployment config — auto-detected when deploying this repo\n# Docs: https://docs.railway.com/\n\n[build]\nbuilder = \"nixpacks\"\n\n[deploy]\nhealthcheckPath = \"/healthz\"\nhealthcheckTimeout = 120\n\n# Services are defined in infra/*.Dockerfile and referenced below.\n# Railway deploys each as its own service; environments wired in the dashboard.\n\n[[service]]\nname = \"api\"\nroot = \"apps/api\"\nbuild = \"Dockerfile\"\nport = 4000\n\n[[service]]\nname = \"web\"\nroot = \"apps/web\"\nbuild = \"Dockerfile\"\nport = 80\n\n# Managed Postgres is added via the Railway dashboard (\"Add plugin → Database\").\n# Set api.DATABASE_URL to its connection string in the env editor.\n",[],[188,375],["D",1789194515912],[246],[188],"254b0129-3ba4-4733-b46f-b9f3c063ea1a","seed.sql","2f2b6986-ae73-11f1-9c96-1607ee4eb77e",12,["D",1789194516087],"-- Demonstration seed data. Clearly demo — never real customers.\n\ninsert into organizations (name, handle, tier)\nselect 'ISNTX', 'isntx', 'pro' where not exists (select 1 from organizations where handle='isntx');\n\ninsert into users (email, name) select 'operator@isntx.test','Operator' where not exists (select 1 from users where email='operator@isntx.test');\ninsert into memberships (org_id,user_id,role)\nselect o.id,u.id,'COMMANDER' from organizations o, users u\nwhere o.handle='isntx' and u.email='operator@isntx.test'\non conflict do nothing;\n\ninsert into sites (org_id,name)\nselect o.id,'Construction Site 1' from organizations o where o.handle='isntx'\non conflict do nothing;\n",[],[194,385],"fb108a22-b552-4211-814f-78a8995ca2d8","001_init.sql","2f217b92-ae73-11f1-9c96-1607ee4eb77e","6ff21aa1-b77d-4fe6-9a9e-b967860eb2df",["D",1789194516022],"-- GuardIQ Platform — initial schema (phase 1)\n-- Multi-tenant from day one. Tenant isolation = every row is scoped to an org_id.\n\n-- Organizations / tenants\ncreate table if not exists organizations (\n id uuid primary key default gen_random_uuid(),\n name text not null,\n handle text unique not null,\n tier text not null default 'free', -- free | pro | business\n created_at timestamptz not null default now()\n);\n\ncreate table if not exists users (\n id uuid primary key default gen_random_uuid(),\n email text unique not null,\n name text not null default '',\n password_hash text, -- set when local auth used; null if SSO\n provider text not null default 'local', -- local | google | etc.\n created_at timestamptz not null default now()\n);\n\ncreate table if not exists memberships (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n user_id uuid not null references users(id) on delete cascade,\n role text not null default 'CLIENT_VIEWER', -- SUPER_ADMIN|ORG_ADMIN|COMMANDER|OPERATOR|SUPERVISOR|GUARD|CLIENT_VIEWER|TECHNICIAN\n unique (org_id, user_id)\n);\n\n-- Sites / geography\ncreate table if not exists sites (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n name text not null,\n address text,\n timezone text not null default 'UTC',\n created_at timestamptz not null default now()\n);\n\ncreate table if not exists zones (\n id uuid primary key default gen_random_uuid(),\n site_id uuid not null references sites(id) on delete cascade,\n name text not null,\n kind text not null default 'zone', -- zone | restricted | building | road | gate | door\n polygon jsonb -- future GIS\n);\n\n-- Assigned humans (guards)\ncreate table if not exists guards (\n id uuid primary key default gen_random_uuid(),\n site_id uuid not null references sites(id) on delete cascade,\n name text not null,\n status text not null default 'AVAILABLE', -- AVAILABLE|BUSY|OFF_DUTY|OFFLINE\n current_pos jsonb,\n updated_at timestamptz not null default now()\n);\n\n-- Device registry (robots, cameras, sensors, trailers, drones, humanoids)\ncreate table if not exists devices (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n site_id uuid not null references sites(id) on delete cascade,\n type text not null, -- ROBOT|HUMANOID|DRONE|CAMERA|TRAILER|SENSOR|ACCESS_CONTROL|EDGE_COMPUTER\n provider text not null default 'simulator',-- HAL adapter id: simulator | spot | unitree | trailiqu | guardiq\n name text not null,\n manufacturer text,\n model text,\n serial text,\n firmware text,\n status text not null default 'OFFLINE', -- ONLINE|OFFLINE|DEGRADED\n capabilities jsonb not null default '[]',\n modal_data jsonb, -- position, battery, heading...\n last_seen timestamptz,\n created_at timestamptz not null default now()\n);\n\n-- Events (event bus persistence)\ncreate table if not exists events (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n event_type text not null, -- PERSON_DETECTED | MOTION_DETECTED | etc.\n source_type text not null, -- CAMERA|ROBOT|SENSOR|GUARD|SYSTEM\n source_id uuid references devices(id),\n site_id uuid references sites(id),\n zone_id uuid references zones(id),\n confidence real,\n payload jsonb not null default '{}',\n dedupe_key text, -- for dedup\n created_at timestamptz not null default now()\n);\ncreate index if not exists events_dedupe_idx on events(dedupe_key);\n\n-- Incidents\ncreate table if not exists incidents (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n site_id uuid not null references sites(id) on delete cascade,\n type text not null,\n severity int not null default 0, -- 0-100 risk score\n confidence real,\n status text not null default 'NEW', -- NEW|ANALYZING|INVESTIGATING|VERIFIED|ESCALATED|RESPONDING|RESOLVED|FALSE_ALARM\n location jsonb,\n evidence jsonb not null default '[]',\n operator_id uuid references users(id),\n operator_action text,\n resolution text,\n detected_at timestamptz default now(),\n verified_at timestamptz,\n resolved_at timestamptz,\n created_at timestamptz not null default now()\n);\n\ncreate table if not exists incident_events (\n id uuid primary key default gen_random_uuid(),\n incident_id uuid not null references incidents(id) on delete cascade,\n kind text not null, -- SUBTYPE|STATUS_CHANGE|ASSET_ASSIGNED|OPERATOR_ACTION|AUDIT\n payload jsonb not null default '{}',\n actor text,\n created_at timestamptz not null default now()\n);\n\n-- Missions\ncreate table if not exists missions (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n site_id uuid not null references sites(id) on delete cascade,\n incident_id uuid references incidents(id),\n device_id uuid references devices(id),\n type text not null, -- PATROL_ZONE|INVESTIGATE_EVENT|OBSERVE_LOCATION|CHECK_PERIMETER|VERIFY_DOOR|RETURN_TO_DOCK\n status text not null default 'CREATED', -- CREATED|QUEUED|ASSIGNED|EN_ROUTE|ON_SCENE|COMPLETED|FAILED|CANCELLED\n waypoints jsonb not null default '[]',\n started_at timestamptz,\n completed_at timestamptz,\n created_at timestamptz not null default now()\n);\n\n-- Telemetry history\ncreate table if not exists telemetry (\n id bigserial primary key,\n device_id uuid not null references devices(id) on delete cascade,\n t timestamptz not null default now(),\n p jsonb not null -- position, battery, heading, temp...\n);\ncreate index if not exists telemetry_device_idx on telemetry(device_id, t desc);\n\n-- Reports\ncreate table if not exists reports (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n incident_id uuid references incidents(id),\n format text not null default 'json', -- json|csv|pdf(marker)\n content jsonb not null default '{}',\n created_at timestamptz not null default now()\n);\n\n-- Integrations (GuardIQ gateway is DISABLED by default)\ncreate table if not exists integrations (\n id uuid primary key default gen_random_uuid(),\n org_id uuid not null references organizations(id) on delete cascade,\n name text not null,\n kind text not null, -- GUARDIQ|WEBHOOK\n config jsonb not null default '{}',\n enabled boolean not null default false,\n created_at timestamptz not null default now()\n);\n\n-- Audit log (every sensitive action)\ncreate table if not exists audit_logs (\n id uuid primary key default gen_random_uuid(),\n org_id uuid references organizations(id),\n site_id uuid references sites(id),\n user_id uuid references users(id),\n device_id uuid references devices(id),\n action text not null,\n payload jsonb not null default '{}',\n correlation_id uuid,\n created_at timestamptz not null default now()\n);\n",[],[194,400,393],"migrations","0f3cc7b9-bb90-47cd-87ab-6e25b62bfaa0",["D",1789194516022],[243],[194,400],["D",1789194516022],[242,244],[194],"47b4c205-1b2c-4afd-bdae-7cbdd9a620af","1ff0f9ea-ae73-11f1-9541-1607ee4eb77e",["D",1789194490537],"# Context Vault — GuardIQ\n\nOpen this folder with **Obsidian** (`Open folder as vault`). It's the persistent\nknowledge base that makes each new build faster: specs, decisions, snippets and\ntraps are human- and AI-searchable via `[[links]]` and `#tags`, and re-used\nacross every project you build on top of this workflow.\n\n## How to use this harness\n\n1. **New idea / project** → copy `_templates/spec.md`.\n2. **Important call you make** → write an ADR (architectural decision record)\n from `_templates/adr.md`. Decisions become a log, not folklore.\n3. **Working code you want again** → save it as a snippet in `_templates/snippet.md`.\n4. **Research step (before coding anything new)**:\n - **Context7** → pull *current* docs for the library (`context7.com`).\n - **Exa** → search for current approaches / competitive patterns (`exa.ai`).\n - Drop 2–3 bullet findings into a `#linked-notes` note before opening an editor.\n5. Tags live in the frontmatter (`tags: [...]`) so Obsidian and other tools\n (these vals) can parse them uniformly.\n\n## Graph\n\n`[[000-...]]` links everything to everything. Useful graph-wide notes start at\n`000-` (decisions), `100-` (architecture), `200-` (templates).\n\n_All content here describes a demo/simulator. Nothing here claims real hardware\nor real customer integrations._\n",[],[200,160],"7b329923-aefb-4baa-8c40-4a5d04f8240d","201-agent-layers.md","2026127e-ae73-11f1-9541-1607ee4eb77e","ff5836aa-4dab-44bc-8c38-ad4af3e62a73",6,["D",1789194490867],"---\ntype: note\ntitle: 201 — Agent / Orchestrator breakdown\nstatus: draft\ntags: [agent, orchestrator, architecture]\nlinks: [\"101-architecture\"]\n---\n\n# Agent layer (interfaces + events, no recursion)\n\nThe `Supervisor` validates automated recommendations before anything sensitive.\n\n| Agent | Job |\n|---|---|\n| Perception | collect + correlate sensor data |\n| Risk | severity + confidence |\n| Mission | choose response resources |\n| Fleet | track robot availability / assignment |\n| Incident | maintain incident state machine |\n| Report | produce incident reports |\n| Maintenance | flag degraded equipment |\n| Supervisor | gate automated recommendations |\n\nAll communication is **event-driven** (via the bus in `packages/event-bus`),\nnever uncontrolled recursive calls.\n\nSee also: [[103-events]], [[104-safety]].\n",[],[200,423,415],"notes","c39dc573-902a-47c2-bc93-ede9ca07219a","000-decision-record.md","201aa70e-ae73-11f1-9541-1607ee4eb77e",5,["D",1789194490813],"---\ntype: decision\ntitle: ADR-001 — Phase 0/1 is a standalone simulator\nstatus: accepted\ntags: [adr, architecture, phase-0]\nlinks: [\"000-workflow\", \"101-architecture\"]\n---\n\n# ADR-001: Phase 0/1 is a standalone simulator\n\n## Context\nThe full system targets PG + Node + WebSockets (Railway). But we needed a fast,\nshareable, investor-facing proof of the orchestration concept first.\n\n## Decision\n**Val Town val `guardiq-command`** hosts a self-contained single-page Command\nCenter. All robots/cameras/events are simulated client-side. No live hardware,\nno GuardIQ connection. Demo data clearly labeled.\n\n## Consequences\n- ✅ Instant shareable link, zero infra, no login.\n- ✅ The orchestrator *story* (detect → analyze → mission → verify → human →\n resolve → report) is fully demonstrated.\n- ⚠️ No persistence server-side; KPIs live in browser `localStorage`.\n- ⚠️ Not the real product — that is `guardiq-platform` (this repo) on Railway.\n\n## Status\naccepted. Superseded by ADR-002 as the real platform begins.\n\n## Next step\n[[ADR-002]] — cross-platform architecture on Railway.\n",[],[200,423,425],"462fb919-9691-4c43-828d-5adf50362843",["D",1789194490813],[238,239],[200,423],"02d65aad-6659-447d-aa14-538827cf78f6","spec.md","1ff9f69e-ae73-11f1-9541-1607ee4eb77e","516fabbd-f180-4a4a-b031-5556b48e176b",2,["D",1789194490598],"---\ntype: spec\ntitle: Project\nstatus: draft\ntags: [spec, template]\n---\n\n# {{Project}}\n\n## Problem\n## Goal / Non-goals\n## Users & scenarios\n## Stack (verify with Context7 before committing)\n## Data model sketch\n## Interfaces / API surfaces\n## Risks / Question marks\n## Query plan\n- [ ] Exa: competitive / current-approach search\n- [ ] Context7: platform & library docs\n- [ ] Draft architecture (ADR)\n",[],[200,445,437],"_templates","d8d2058a-ddd7-4537-af3f-e6d8cc0438cd","snippet.md","2011e722-ae73-11f1-9541-1607ee4eb77e",4,["D",1789194490735],"---\ntype: snippet\ntitle: Snippet\ntags: [snippet, template]\n---\n\n# {{Snippet name}}\n\n## When to reach for this\n## Code\n```ts\n// ...\n```\n## Why it works / gotchas\n## Source project\n[[...]]\n",[],[200,445,447],"eb6f9725-0a22-455c-87b8-77c0e1d5f5f0","adr.md","20031a26-ae73-11f1-9541-1607ee4eb77e",3,["D",1789194490650],"---\ntype: adr\ntitle: ADR-000\nstatus: accepted\ntags: [adr, template]\n---\n\n# ADR-000: \n\n## Context\nWhy does this decision need to be made? What constraints?\n\n## Decision\nWhat we chose, and the shape of it.\n\n## Consequences\n- Good: ...\n- Trade-offs: ...\n- (Links: [[...]] to related notes)\n\n## Status\naccepted / proposed / superseded-by\n",[],[200,445,455],"8cda65fa-7386-415f-863f-291a31a088af",["D",1789194490598],[234,235,236],[200,445],["D",1789194490537],[233,237,240],[200],"7a8accb2-c882-42a5-b631-9645d6cf2a3d","tsconfig.json","37f635be-ae73-11f1-831f-1607ee4eb77e","0bf13641-5a6d-40ef-8222-2de8ecd8a295",14,["D",1789194530835],"{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"outDir\": \"dist\",\n \"rootDir\": \"src\",\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"types\": [\"node\"]\n },\n \"include\": [\"src\"]\n}\n",[],[206,478,470],"api","350ed730-2336-41ec-9b30-ce60d6f92875","37ec5562-ae73-11f1-831f-1607ee4eb77e",["D",1789194530755],"{\n \"name\": \"@guardiq/api\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"scripts\": {\n \"dev\": \"tsx watch src/index.ts\",\n \"build\": \"tsc -p tsconfig.json\",\n \"start\": \"node dist/index.js\",\n \"migrate\": \"tsx src/db/migrate.ts\",\n \"test\": \"vitest run\"\n },\n \"dependencies\": {\n \"express\": \"^4.19.0\",\n \"pg\": \"^8.11.0\",\n \"ws\": \"^8.17.0\"\n },\n \"devDependencies\": {\n \"@types/express\": \"^4.17.0\",\n \"@types/node\": \"^20.11.0\",\n \"@types/pg\": \"^8.11.0\",\n \"@types/ws\": \"^8.5.0\",\n \"tsx\": \"^4.7.0\",\n \"typescript\": \"^5.4.0\",\n \"vitest\": \"^1.4.0\"\n }\n}\n",[],[206,478,142],"27991045-15ee-4e1d-8d7e-d164ca593d1a","Dockerfile","37feb0ea-ae73-11f1-831f-1607ee4eb77e",15,["D",1789194530894],"FROM node:20-alpine AS build\nWORKDIR /app\nCOPY package.json package-lock.json* ./\nRUN npm ci || npm install\nCOPY . .\nRUN npm run build\n\nFROM node:20-alpine\nWORKDIR /app\nENV NODE_ENV=production\nCOPY package.json package-lock.json* ./\nRUN npm ci --omit=dev || npm install --omit=dev\nCOPY --from=build /app/dist ./dist\nCOPY db/ ../../db/\nEXPOSE 4000\nCMD [\"node\", \"dist/index.js\"]\n",[],[206,478,486],"f9d71d4f-f1cf-4fe9-94e0-c6eea4131792","3834126c-ae73-11f1-831f-1607ee4eb77e","abd72c0c-905a-46a9-a02a-65b5d1db892a",18,["D",1789194531231],"import express from \"express\";\nimport { createServer } from \"node:http\";\nimport { WebSocketServer } from \"ws\";\nimport { pool } from \"./db.ts\";\nimport { env } from \"./env.ts\";\nimport { EventBus } from \"@guardiq/event-bus\";\n\nconst app = express();\napp.use(express.json());\n\n// ---- Health / readiness ------------------------------------------------------\napp.get(\"/healthz\", async (_req, res) => {\n try {\n await pool.query(\"select 1\");\n res.json({ status: \"ok\", service: \"guardiq-api\", version: \"0.1.0\" });\n } catch {\n res.status(503).json({ status: \"degraded\" });\n }\n});\n\n// ---- System status -----------------------------------------------------------\napp.get(\"/api/v1/status\", async (_req, res) => {\n const rows = await pool.query(`\n select status, count(*)::int as n from devices group by status\n `).catch(() => ({ rows: [] as never[] }));\n res.json({\n services: {\n api: \"HEALTHY\",\n database: \"HEALTHY\",\n eventBus: \"HEALTHY\",\n aiOrchestrator: \"HEALTHY\",\n guardiqGateway: env.guardiqEnabled ? \"ENABLED\" : \"DISABLED\",\n },\n devices: rows.rows,\n mode: \"simulation\",\n });\n});\n\n// ---- Real-time (everything sim bridges through the bus + ws) ----------------\nconst server = createServer(app);\nconst wss = new WebSocketServer({ server, path: \"/ws\" });\nconst bus = new EventBus();\n\nwss.on(\"connection\", (ws) => {\n const off = bus.subscribe((evt) => {\n if (ws.readyState === ws.OPEN) ws.send(JSON.stringify(evt));\n });\n ws.on(\"close\", off);\n ws.send(JSON.stringify({ type: \"hello\", ts: Date.now() }));\n});\n\n// Broadcast bus events to all clients too\nbus.subscribe((evt) => {\n for (const client of wss.clients) {\n if (client.readyState === client.OPEN) client.send(JSON.stringify(evt));\n }\n});\n\n// ---- Boot --------------------------------------------------------------------\npool.query(\"select 1\").then(() => server.listen(env.port, () => {\n console.log(`guardiq-api listening on :${env.port}`);\n})).catch((e) => {\n console.error(\"DB unreachable (is Postgres up?). Rx:\", (e as Error).message);\n server.listen(env.port, () => console.log(`guardiq-api listening (db down) :${env.port}`));\n});\n",[],[206,478,301,293],"c0d0d5ca-c279-4f26-8537-32c30f66c5ea","env.ts","380a4202-ae73-11f1-831f-1607ee4eb77e",16,["D",1789194530953],"// Central env access. Fail fast on required vars; never log values.\nexport const env = {\n nodeEnv: process.env.NODE_ENV ?? \"development\",\n port: Number(process.env.PORT ?? 4000),\n databaseUrl: process.env.DATABASE_URL ?? \"\",\n sessionSecret: process.env.SESSION_SECRET ?? \"dev-insecure-change-me\",\n guardiqEnabled: (process.env.GUARDIQ_GATEWAY_ENABLED ?? \"false\").toLowerCase() === \"true\",\n guardiqUrl: process.env.GUARDIQ_GATEWAY_URL ?? \"\",\n};\n",[],[206,478,301,502],"667268e3-19f3-479d-9d0e-500795bd1241","db.ts","382493d2-ae73-11f1-831f-1607ee4eb77e",17,["D",1789194531099],"import pg from \"pg\";\nimport { env } from \"./env.ts\";\n\nexport const pool = new pg.Pool({\n connectionString: env.databaseUrl,\n max: 10,\n});\n\nexport const query = (text: string, params: unknown[] = []) => pool.query(text, params);\n",[],[206,478,301,510],"c229b66e-4f90-49de-9394-499cff67c0e8","migrate.ts","4454e710-ae73-11f1-aa80-1607ee4eb77e","42ed4057-36f5-4c93-9268-99588af6b637",19,["D",1789194551591],"// Runs db/migrations/*.sql in order against DATABASE_URL.\n// For local dev; on Railway the db plugin / start script handles this too.\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { pool } from \"./db.ts\";\n\nconst here = fileURLToPath(new URL(\".\", import.meta.url));\nconst dir = join(here, \"../../../db/migrations\");\n\nasync function main() {\n const files = (await readdirSafe(dir)).filter((f) => f.endsWith(\".sql\")).sort();\n for (const f of files) {\n const sql = await readFile(join(dir, f), \"utf8\");\n await pool.query(sql);\n console.log(\"migrated\", f);\n }\n process.exit(0);\n}\nasync function readdirSafe(d: string): Promise {\n try { return await (await import(\"node:fs/promises\")).readdir(d); } catch { return []; }\n}\nmain().catch((e) => { console.error(e); process.exit(1); });\n",[],[206,478,301,194,518],"4385aef1-43c0-4625-8c0b-249d78de96b4",["D",1789194551591],[225],[206,478,301,194],"2438421b-eab1-4389-b8b4-489931c3c2e9",["D",1789194530953],[224,226,227,228],[206,478,301],"dc2c007a-a7f7-4b75-8c46-b9c5dc95eba3",["D",1789194530755],[223,229,230,231],[206,478],["D",1789194530755],[222],[206],["D",1789194473035],{"_100":99,"_108":104},{"_100":99,"_101":102,"_103":104,"_19":60,"_105":106,"_107":30},{"_13":89,"_37":90,"_48":47,"_91":49,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":50,"_98":99},"ctx",{"_82":-5,"_128":578,"_579":580,"_581":582,"_583":30,"_584":30,"_585":30,"_586":147,"_587":-5,"_588":-7,"_589":-7,"_590":66,"_591":30,"_592":30,"_593":-5,"_594":30,"_595":30,"_596":30,"_597":-5},"ENV",{"_549":550,"_551":552,"_553":90,"_554":555,"_556":557,"_558":559,"_560":561,"_562":563,"_564":565,"_566":567,"_568":569,"_570":571,"_572":573,"_574":575,"_576":577},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v29