GuardIQ Robotics Command

\n \n \n\n","label",[152,153,65],"apps","web","pulls","branches",1,"forks","envVars",{"_162":26,"_164":26},"connections",{"_162":26,"_163":26},"count","unfilledCount","emptyCount",{"_32":712,"_13":152,"_63":611,"_42":-5,"_34":35,"_144":626,"_145":146,"_36":713,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":714,"_17":715},{"_32":708,"_13":623,"_63":617,"_42":611,"_34":35,"_144":626,"_145":146,"_36":709,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":710,"_17":711},{"_32":704,"_13":295,"_63":662,"_42":617,"_34":35,"_144":678,"_145":146,"_36":705,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":706,"_17":707},{"_32":700,"_13":448,"_63":694,"_42":662,"_34":35,"_144":695,"_145":146,"_36":701,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":702,"_17":703},{"_32":691,"_13":692,"_63":693,"_42":694,"_34":35,"_144":695,"_145":146,"_36":696,"_38":26,"_66":291,"_148":697,"_67":24,"_150":-5,"_240":698,"_17":699},{"_32":683,"_13":684,"_63":685,"_42":662,"_34":35,"_144":686,"_145":146,"_36":687,"_38":26,"_66":291,"_148":688,"_67":24,"_150":-5,"_240":689,"_17":690},{"_32":675,"_13":676,"_63":677,"_42":662,"_34":35,"_144":678,"_145":146,"_36":679,"_38":26,"_66":291,"_148":680,"_67":24,"_150":-5,"_240":681,"_17":682},{"_32":668,"_13":297,"_63":669,"_42":662,"_34":35,"_144":670,"_145":146,"_36":671,"_38":501,"_66":291,"_148":672,"_67":24,"_150":-5,"_240":673,"_17":674},{"_32":659,"_13":660,"_63":661,"_42":662,"_34":35,"_144":663,"_145":146,"_36":664,"_38":26,"_66":291,"_148":665,"_67":24,"_150":-5,"_240":666,"_17":667},{"_32":655,"_13":647,"_63":641,"_42":617,"_34":35,"_144":642,"_145":146,"_36":656,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":657,"_17":658},{"_32":648,"_13":649,"_63":650,"_42":641,"_34":35,"_144":106,"_145":146,"_36":651,"_38":26,"_66":291,"_148":652,"_67":24,"_150":-5,"_240":653,"_17":654},{"_32":638,"_13":639,"_63":640,"_42":641,"_34":35,"_144":642,"_145":146,"_36":643,"_38":26,"_66":291,"_148":644,"_67":24,"_150":-5,"_240":645,"_17":646},{"_32":631,"_13":574,"_63":632,"_42":617,"_34":35,"_144":633,"_145":146,"_36":634,"_38":26,"_66":21,"_148":635,"_67":24,"_150":-5,"_240":636,"_17":637},{"_32":624,"_13":235,"_63":625,"_42":617,"_34":35,"_144":626,"_145":146,"_36":627,"_38":26,"_66":21,"_148":628,"_67":24,"_150":-5,"_240":629,"_17":630},{"_32":615,"_13":540,"_63":616,"_42":617,"_34":35,"_144":618,"_145":146,"_36":619,"_38":26,"_66":21,"_148":620,"_67":24,"_150":-5,"_240":621,"_17":622},{"_32":610,"_13":153,"_63":143,"_42":611,"_34":35,"_144":565,"_145":146,"_36":612,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":613,"_17":614},{"_32":606,"_13":295,"_63":584,"_42":143,"_34":35,"_144":585,"_145":146,"_36":607,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":608,"_17":609},{"_32":598,"_13":599,"_63":600,"_42":584,"_34":35,"_144":601,"_145":146,"_36":602,"_38":26,"_66":291,"_148":603,"_67":24,"_150":-5,"_240":604,"_17":605},{"_32":590,"_13":591,"_63":592,"_42":584,"_34":35,"_144":593,"_145":146,"_36":594,"_38":26,"_66":21,"_148":595,"_67":24,"_150":-5,"_240":596,"_17":597},{"_32":581,"_13":582,"_63":583,"_42":584,"_34":35,"_144":585,"_145":146,"_36":586,"_38":26,"_66":291,"_148":587,"_67":24,"_150":-5,"_240":588,"_17":589},{"_32":573,"_13":574,"_63":575,"_42":143,"_34":35,"_144":576,"_145":146,"_36":577,"_38":26,"_66":21,"_148":578,"_67":24,"_150":-5,"_240":579,"_17":580},{"_32":142,"_13":65,"_63":64,"_42":143,"_34":35,"_144":39,"_145":146,"_36":570,"_38":26,"_66":21,"_148":149,"_67":24,"_150":-5,"_240":571,"_17":572},{"_32":563,"_13":235,"_63":564,"_42":143,"_34":35,"_144":565,"_145":146,"_36":566,"_38":26,"_66":21,"_148":567,"_67":24,"_150":-5,"_240":568,"_17":569},{"_32":555,"_13":556,"_63":557,"_42":143,"_34":35,"_144":558,"_145":146,"_36":559,"_38":26,"_66":291,"_148":560,"_67":24,"_150":-5,"_240":561,"_17":562},{"_32":547,"_13":548,"_63":549,"_42":143,"_34":35,"_144":550,"_145":146,"_36":551,"_38":26,"_66":291,"_148":552,"_67":24,"_150":-5,"_240":553,"_17":554},{"_32":539,"_13":540,"_63":541,"_42":143,"_34":35,"_144":542,"_145":146,"_36":543,"_38":26,"_66":21,"_148":544,"_67":24,"_150":-5,"_240":545,"_17":546},{"_32":531,"_13":532,"_63":533,"_42":143,"_34":35,"_144":534,"_145":146,"_36":535,"_38":26,"_66":291,"_148":536,"_67":24,"_150":-5,"_240":537,"_17":538},{"_32":527,"_13":474,"_63":469,"_42":-5,"_34":35,"_144":156,"_145":146,"_36":528,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":529,"_17":530},{"_32":523,"_13":506,"_63":500,"_42":469,"_34":35,"_144":501,"_145":146,"_36":524,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":525,"_17":526},{"_32":515,"_13":516,"_63":517,"_42":500,"_34":35,"_144":518,"_145":146,"_36":519,"_38":26,"_66":21,"_148":520,"_67":24,"_150":-5,"_240":521,"_17":522},{"_32":507,"_13":508,"_63":509,"_42":500,"_34":35,"_144":510,"_145":146,"_36":511,"_38":26,"_66":21,"_148":512,"_67":24,"_150":-5,"_240":513,"_17":514},{"_32":497,"_13":498,"_63":499,"_42":500,"_34":35,"_144":501,"_145":146,"_36":502,"_38":26,"_66":21,"_148":503,"_67":24,"_150":-5,"_240":504,"_17":505},{"_32":493,"_13":484,"_63":478,"_42":469,"_34":35,"_144":488,"_145":146,"_36":494,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":495,"_17":496},{"_32":485,"_13":486,"_63":487,"_42":478,"_34":35,"_144":488,"_145":146,"_36":489,"_38":26,"_66":21,"_148":490,"_67":24,"_150":-5,"_240":491,"_17":492},{"_32":475,"_13":476,"_63":477,"_42":478,"_34":35,"_144":479,"_145":146,"_36":480,"_38":26,"_66":21,"_148":481,"_67":24,"_150":-5,"_240":482,"_17":483},{"_32":467,"_13":252,"_63":468,"_42":469,"_34":35,"_144":156,"_145":146,"_36":470,"_38":26,"_66":21,"_148":471,"_67":24,"_150":-5,"_240":472,"_17":473},{"_32":463,"_13":448,"_63":442,"_42":-5,"_34":35,"_144":453,"_145":146,"_36":464,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":465,"_17":466},{"_32":459,"_13":458,"_63":452,"_42":442,"_34":35,"_144":453,"_145":146,"_36":460,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":461,"_17":462},{"_32":449,"_13":450,"_63":451,"_42":452,"_34":35,"_144":453,"_145":146,"_36":454,"_38":26,"_66":21,"_148":455,"_67":24,"_150":-5,"_240":456,"_17":457},{"_32":439,"_13":440,"_63":441,"_42":442,"_34":35,"_144":443,"_145":146,"_36":444,"_38":26,"_66":21,"_148":445,"_67":24,"_150":-5,"_240":446,"_17":447},{"_32":435,"_13":434,"_63":428,"_42":-5,"_34":35,"_144":429,"_145":146,"_36":436,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":437,"_17":438},{"_32":425,"_13":426,"_63":427,"_42":428,"_34":35,"_144":429,"_145":146,"_36":430,"_38":26,"_66":21,"_148":431,"_67":24,"_150":-5,"_240":432,"_17":433},{"_32":421,"_13":283,"_63":318,"_42":-5,"_34":35,"_144":325,"_145":146,"_36":422,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":423,"_17":424},{"_32":417,"_13":388,"_63":382,"_42":318,"_34":35,"_144":383,"_145":146,"_36":418,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":419,"_17":420},{"_32":413,"_13":295,"_63":392,"_42":382,"_34":35,"_144":393,"_145":146,"_36":414,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":415,"_17":416},{"_32":405,"_13":406,"_63":407,"_42":392,"_34":35,"_144":408,"_145":146,"_36":409,"_38":26,"_66":291,"_148":410,"_67":24,"_150":-5,"_240":411,"_17":412},{"_32":398,"_13":297,"_63":399,"_42":392,"_34":35,"_144":400,"_145":146,"_36":401,"_38":26,"_66":291,"_148":402,"_67":24,"_150":-5,"_240":403,"_17":404},{"_32":389,"_13":390,"_63":391,"_42":392,"_34":35,"_144":393,"_145":146,"_36":394,"_38":26,"_66":291,"_148":395,"_67":24,"_150":-5,"_240":396,"_17":397},{"_32":380,"_13":235,"_63":381,"_42":382,"_34":35,"_144":383,"_145":146,"_36":384,"_38":26,"_66":21,"_148":385,"_67":24,"_150":-5,"_240":386,"_17":387},{"_32":376,"_13":363,"_63":357,"_42":318,"_34":35,"_144":358,"_145":146,"_36":377,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":378,"_17":379},{"_32":372,"_13":295,"_63":366,"_42":357,"_34":35,"_144":367,"_145":146,"_36":373,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":374,"_17":375},{"_32":364,"_13":297,"_63":365,"_42":366,"_34":35,"_144":367,"_145":146,"_36":368,"_38":26,"_66":291,"_148":369,"_67":24,"_150":-5,"_240":370,"_17":371},{"_32":355,"_13":235,"_63":356,"_42":357,"_34":35,"_144":358,"_145":146,"_36":359,"_38":26,"_66":21,"_148":360,"_67":24,"_150":-5,"_240":361,"_17":362},{"_32":351,"_13":330,"_63":324,"_42":318,"_34":35,"_144":325,"_145":146,"_36":352,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":353,"_17":354},{"_32":347,"_13":295,"_63":334,"_42":324,"_34":35,"_144":342,"_145":146,"_36":348,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":349,"_17":350},{"_32":340,"_13":297,"_63":341,"_42":334,"_34":35,"_144":342,"_145":146,"_36":343,"_38":26,"_66":291,"_148":344,"_67":24,"_150":-5,"_240":345,"_17":346},{"_32":331,"_13":332,"_63":333,"_42":334,"_34":35,"_144":335,"_145":146,"_36":336,"_38":26,"_66":291,"_148":337,"_67":24,"_150":-5,"_240":338,"_17":339},{"_32":322,"_13":235,"_63":323,"_42":324,"_34":35,"_144":325,"_145":146,"_36":326,"_38":26,"_66":21,"_148":327,"_67":24,"_150":-5,"_240":328,"_17":329},{"_32":317,"_13":284,"_63":277,"_42":318,"_34":35,"_144":278,"_145":146,"_36":319,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":320,"_17":321},{"_32":312,"_13":295,"_63":288,"_42":277,"_34":35,"_144":299,"_145":146,"_36":313,"_38":26,"_66":314,"_148":-5,"_67":24,"_150":-5,"_240":315,"_17":316},{"_32":304,"_13":305,"_63":306,"_42":288,"_34":35,"_144":307,"_145":146,"_36":308,"_38":26,"_66":291,"_148":309,"_67":24,"_150":-5,"_240":310,"_17":311},{"_32":296,"_13":297,"_63":298,"_42":288,"_34":35,"_144":299,"_145":146,"_36":300,"_38":26,"_66":291,"_148":301,"_67":24,"_150":-5,"_240":302,"_17":303},{"_32":285,"_13":286,"_63":287,"_42":288,"_34":35,"_144":289,"_145":146,"_36":290,"_38":26,"_66":291,"_148":292,"_67":24,"_150":-5,"_240":293,"_17":294},{"_32":275,"_13":235,"_63":276,"_42":277,"_34":35,"_144":278,"_145":146,"_36":279,"_38":26,"_66":21,"_148":280,"_67":24,"_150":-5,"_240":281,"_17":282},{"_32":267,"_13":268,"_63":269,"_42":-5,"_34":35,"_144":270,"_145":146,"_36":271,"_38":26,"_66":21,"_148":272,"_67":24,"_150":-5,"_240":273,"_17":274},{"_32":259,"_13":260,"_63":261,"_42":-5,"_34":35,"_144":262,"_145":146,"_36":263,"_38":26,"_66":21,"_148":264,"_67":24,"_150":-5,"_240":265,"_17":266},{"_32":251,"_13":252,"_63":253,"_42":-5,"_34":35,"_144":254,"_145":146,"_36":255,"_38":26,"_66":21,"_148":256,"_67":24,"_150":-5,"_240":257,"_17":258},{"_32":243,"_13":244,"_63":245,"_42":-5,"_34":35,"_144":246,"_145":146,"_36":247,"_38":26,"_66":21,"_148":248,"_67":24,"_150":-5,"_240":249,"_17":250},{"_32":234,"_13":235,"_63":236,"_42":-5,"_34":35,"_144":237,"_145":146,"_36":238,"_38":26,"_66":21,"_148":239,"_67":24,"_150":-5,"_240":241,"_17":242},"f7c6fbf9-57b7-4b39-910f-25299fe5dcf9","package.json","4841c258-ae73-11f1-8551-1607ee4eb77e",25,["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","children",[],[235],"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",[],[244],"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",[],[252],"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",[],[260],"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",[],[268],"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",[],[283,284,235],"packages","orchestrator","47343143-0088-4dcb-ae29-3694d3cff884","mission.ts","92b459fe-ae73-11f1-9680-1607ee4eb77e","0932d956-b4dd-4e56-960c-4ea47e81c92b",30,["D",1789194683031],"script","import type { Mission } from \"@guardiq/hal\";\n\n/** Simple fleet-aware mission selector: nearest & healthy wins. */\nexport interface Candidate { deviceId: string; dist: number; battery: number; available: boolean; }\n\nexport function pickRobot(candidates: Candidate[], priority: \"INVESTIGATE\" | \"PATROL\" | \"RETURN\"): string | null {\n const pool = candidates.filter((c) => c.available && c.battery >= 30);\n if (pool.length === 0) return null;\n return pool.sort((a, b) => a.dist - b.dist || b.battery - a.battery)[0].deviceId;\n}\n\nexport function buildMission(id: string, type: Mission[\"type\"], waypoints: Mission[\"waypoints\"]): Mission {\n return { id, type, status: \"CREATED\", waypoints, createdAt: Date.now() };\n}\n",[],[283,284,295,286],"src","64da81a2-e5cd-4a91-ac10-7df351c3e424","index.ts","9290a1a8-ae73-11f1-9680-1607ee4eb77e",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",[],[283,284,295,297],"02712512-0eda-48eb-a32f-cb9c97b8003e","incident.ts","92995d34-ae73-11f1-9680-1607ee4eb77e",29,["D",1789194682901],"/**\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",[],[283,284,295,305],"1d61ef93-d335-47e8-9dc0-5d61114596d0",["D",1789194682845],"directory",[225,226,227],[283,284,295],"31687d80-14cf-4b43-87e5-abe1a3595140","172cd9d8-1b2f-4a0d-a388-a4396a20e24a",["D",1789194682779],[224,228],[283,284],"d4509522-5909-476c-bb02-d82774fd1e79","445f164a-ae73-11f1-aa80-1607ee4eb77e","4a24480b-c677-4a91-b753-776ac6ef4f0a",20,["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",[],[283,330,235],"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",[],[283,330,295,332],"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",[],[283,330,295,297],"bdddaabe-a9f2-494f-ae1d-ef588d28e409",["D",1789194551726],[220,221],[283,330,295],"9428b440-2c0d-417d-8106-78f489b95b56",["D",1789194551656],[219,222],[283,330],"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",[],[283,363,235],"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",[],[283,363,295,297],"56de72e7-c9a4-44a5-8df4-3504188cfe9b",["D",1789194551893],[216],[283,363,295],"da5f91c3-0d43-4536-856b-e4e5a1d70da5",["D",1789194551839],[215,217],[283,363],"39e205c6-5a74-46c6-b8b3-e3c045632833","5942ac0c-ae8c-11f1-8cde-1607ee4eb77e","c47885c2-c1df-4f80-bd0e-e4795da0e9e3",42,["D",1789205324120],"{\n \"name\": \"@guardiq/auth\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"main\": \"src/index.ts\",\n \"exports\": { \".\": \"./src/index.ts\" }\n}\n",[],[283,388,235],"auth","f9705bac-5326-4b6a-a48e-793af4320274","rbac.ts","594bb7b6-ae8c-11f1-8cde-1607ee4eb77e","30b636c8-3ae3-4118-81c5-14466a7e8171",43,["D",1789205324183],"/**\n * Role-based access control (§12). Least privilege: every role grants exactly\n * the permissions below. Check permissions at the route layer — never trust the\n * client to self-clamp.\n */\n\nexport type Role =\n | \"SUPER_ADMIN\" | \"ORG_ADMIN\" | \"COMMANDER\" | \"OPERATOR\"\n | \"SUPERVISOR\" | \"GUARD\" | \"CLIENT_VIEWER\" | \"TECHNICIAN\";\n\nexport type Permission =\n | \"sites.read\" | \"sites.write\"\n | \"robots.read\" | \"robots.write\" | \"robots.emergency\"\n | \"missions.read\" | \"missions.write\"\n | \"incidents.read\" | \"incidents.write\"\n | \"reports.read\" | \"reports.export\"\n | \"users.manage\"\n | \"integrations.manage\"\n | \"config.manage\"\n | \"audit.read\";\n\nexport const ROLE_PERMISSIONS: Record = {\n SUPER_ADMIN: [\"sites.read\", \"sites.write\", \"robots.read\", \"robots.write\", \"robots.emergency\", \"missions.read\", \"missions.write\", \"incidents.read\", \"incidents.write\", \"reports.read\", \"reports.export\", \"users.manage\", \"integrations.manage\", \"config.manage\", \"audit.read\"],\n ORG_ADMIN: [\"sites.read\", \"sites.write\", \"robots.read\", \"robots.write\", \"robots.emergency\", \"missions.read\", \"missions.write\", \"incidents.read\", \"incidents.write\", \"reports.read\", \"reports.export\", \"users.manage\", \"config.manage\", \"audit.read\"],\n COMMANDER: [\"sites.read\", \"sites.write\", \"robots.read\", \"robots.write\", \"robots.emergency\", \"missions.read\", \"missions.write\", \"incidents.read\", \"incidents.write\", \"reports.read\", \"reports.export\"],\n OPERATOR: [\"sites.read\", \"robots.read\", \"robots.write\", \"missions.read\", \"missions.write\", \"incidents.read\", \"incidents.write\", \"reports.read\"],\n SUPERVISOR: [\"sites.read\", \"robots.read\", \"missions.read\", \"incidents.read\", \"incidents.write\", \"reports.read\"],\n GUARD: [\"sites.read\", \"incidents.read\", \"missions.read\"],\n CLIENT_VIEWER: [\"sites.read\", \"incidents.read\", \"reports.read\"],\n TECHNICIAN: [\"sites.read\", \"robots.read\", \"robots.write\", \"config.manage\"],\n};\n\nexport function roleHas(role: Role, perm: Permission): boolean {\n return ROLE_PERMISSIONS[role]?.includes(perm) ?? false;\n}\n\n/** Require any of the given permissions for a role. */\nexport function requirePermission(role: Role, needed: Permission[]): boolean {\n return needed.some((p) => roleHas(role, p));\n}\n",[],[283,388,295,390],"c3dbbc1c-b9fc-473f-91d6-4116a74fc76b","595e5164-ae8c-11f1-8cde-1607ee4eb77e",45,["D",1789205324296],"export { roleHas, requirePermission, ROLE_PERMISSIONS, type Role, type Permission } from \"./rbac.ts\";\nexport { resolveAuth, type AuthContext } from \"./context.ts\";\n",[],[283,388,295,297],"4f04a14a-69f5-459c-ad4a-209ab0e58a15","context.ts","595387a2-ae8c-11f1-8cde-1607ee4eb77e",44,["D",1789205324236],"import type { Role } from \"./rbac.ts\";\n\n/**\n * Authenticated request context: which tenant (org/site) and role this caller\n * holds. In production, this is resolved from a verified session/JWT. In this\n * scaffold it's resolved from explicit dev headers so the platform runs without\n * a configured identity provider. Tenant isolation is enforced structurally:\n * every query must include the caller's org_id.\n */\nexport interface AuthContext {\n userId: string;\n role: Role;\n orgId: string;\n siteId: string | null;\n}\n\nconst VALID_ROLES: Role[] = [\n \"SUPER_ADMIN\", \"ORG_ADMIN\", \"COMMANDER\", \"OPERATOR\",\n \"SUPERVISOR\", \"GUARD\", \"CLIENT_VIEWER\", \"TECHNICIAN\",\n];\n\n/** Dev auth. Real impl verifies a JWT/session against users+memberships. */\nexport function resolveAuth(headers: Record): AuthContext {\n const h = (k: string) => (Array.isArray(headers[k]) ? headers[k][0] : headers[k]);\n const role = (h(\"x-guardiq-role\") || \"OPERATOR\").toUpperCase() as Role;\n return {\n userId: h(\"x-guardiq-user\") || \"dev-operator\",\n role: VALID_ROLES.includes(role as Role) ? role : \"CLIENT_VIEWER\",\n orgId: h(\"x-guardiq-org\") || \"dev-org\",\n siteId: h(\"x-guardiq-site\") || null,\n };\n}\n",[],[283,388,295,406],"c86935eb-91d8-4be1-97f7-1dd506719100",["D",1789205324183],[210,211,212],[283,388,295],"f192ae52-09ee-4e04-9b8b-d1b0865a3928",["D",1789205324120],[209,213],[283,388],"028adbb5-ba8a-440a-8a44-edceb9e88b5a",["D",1789194551656],[208,214,218,223],[283],"190ce375-4808-4221-ae49-604807876e69","railway.toml","2f179186-ae73-11f1-9c96-1607ee4eb77e","b44ebea9-7bdb-4190-bb47-6c2b0effdb48",10,["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",[],[434,426],"infra","b97e2c5e-4650-4495-b03a-76e0295c7b90",["D",1789194515912],[206],[434],"254b0129-3ba4-4733-b46f-b9f3c063ea1a","seed.sql","2f2b6986-ae73-11f1-9c96-1607ee4eb77e","f7a4fc25-cb73-4cef-bd2e-2a7dd82112e8",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",[],[448,440],"db","fb108a22-b552-4211-814f-78a8995ca2d8","001_init.sql","2f217b92-ae73-11f1-9c96-1607ee4eb77e","6ff21aa1-b77d-4fe6-9a9e-b967860eb2df",11,["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",[],[448,458,450],"migrations","0f3cc7b9-bb90-47cd-87ab-6e25b62bfaa0",["D",1789194516022],[203],[448,458],"e715ac57-9e7a-4cc4-a3a0-e2cdfdb591b4",["D",1789194516022],[202,204],[448],"47b4c205-1b2c-4afd-bdae-7cbdd9a620af","1ff0f9ea-ae73-11f1-9541-1607ee4eb77e","8d6cb79e-d3f2-4c3d-b66d-cf6c88ce820c",["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",[],[474,252],"context","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",[],[474,484,476],"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",[],[474,484,486],"462fb919-9691-4c43-828d-5adf50362843",["D",1789194490813],[198,199],[474,484],"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",[],[474,506,498],"_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",[],[474,506,508],"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",[],[474,506,516],"8cda65fa-7386-415f-863f-291a31a088af",["D",1789194490598],[194,195,196],[474,506],"003621d4-5290-44d2-b97b-9fd787159ebe",["D",1789194490537],[193,197,200],[474],"b1e7fcdc-86bf-4a71-a931-bf839b63fa93","vite.config.ts","3b1f2684-ae81-11f1-94d2-1607ee4eb77e",33,["D",1789200549063],"import { defineConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\nexport default defineConfig({\n plugins: [react()],\n server: {\n port: 5173,\n proxy: {\n // dev: forward API + websocket to the backend\n \"/api\": \"http://localhost:4000\",\n \"/healthz\": \"http://localhost:4000\",\n \"/ws\": { target: \"ws://localhost:4000\", ws: true },\n },\n },\n});\n",[],[152,153,532],"ba9f5439-0c9d-4435-9ed3-598c5fd7bc18","tsconfig.json","3ba5d22e-ae81-11f1-94d2-1607ee4eb77e",34,["D",1789200549689],"{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"lib\": [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"jsx\": \"react-jsx\",\n \"strict\": true,\n \"noEmit\": true,\n \"skipLibCheck\": true,\n \"isolatedModules\": true,\n \"useDefineForClassFields\": true\n },\n \"include\": [\"src\", \"vite.config.ts\"]\n}\n",[],[152,153,540],"e551404a-1f37-4888-943a-c20a4066011d","tailwind.config.js","3c1a7b42-ae81-11f1-94d2-1607ee4eb77e",36,["D",1789200550735],"/** @type {import('tailwindcss').Config} */\nexport default {\n content: [\"./index.html\", \"./src/**/*.{ts,tsx}\"],\n theme: {\n extend: {\n colors: {\n panel: \"#11161f\",\n panel2: \"#0d1117\",\n line: \"#1f2733\",\n ink: \"#dbe4ee\",\n muted: \"#7d8ba1\",\n accent: \"#3aa0ff\",\n good: \"#27c77b\",\n warn: \"#f5a623\",\n bad: \"#ff5d5d\",\n },\n },\n },\n plugins: [],\n};\n",[],[152,153,548],"de2dff04-f390-48d1-a1a7-efc52cb9a224","postcss.config.js","3c91fad2-ae81-11f1-94d2-1607ee4eb77e",37,["D",1789200551529],"export default {\n plugins: { tailwindcss: {}, autoprefixer: {} },\n};\n",[],[152,153,556],"e97b86f1-92bf-4c4e-8a48-b113d724735b","3b0d6340-ae81-11f1-94d2-1607ee4eb77e",32,["D",1789200548944],"{\n \"name\": \"@guardiq/web\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"tsc -b && vite build\",\n \"preview\": \"vite preview\",\n \"test\": \"vitest run\"\n },\n \"dependencies\": {\n \"react\": \"^18.3.0\",\n \"react-dom\": \"^18.3.0\"\n },\n \"devDependencies\": {\n \"@vitejs/plugin-react\": \"^4.2.0\",\n \"@types/react\": \"^18.2.0\",\n \"@types/react-dom\": \"^18.2.0\",\n \"autoprefixer\": \"^10.4.0\",\n \"postcss\": \"^8.4.0\",\n \"tailwindcss\": \"^3.4.0\",\n \"typescript\": \"^5.4.0\",\n \"vite\": \"^5.2.0\",\n \"vitest\": \"^1.4.0\"\n }\n}\n",[],[152,153,235],["D",1789200550349],[],[152,153,65],"e969b0c1-0c80-4d11-8b57-b14a7de02abc","Dockerfile","3cb9c38c-ae81-11f1-94d2-1607ee4eb77e",38,["D",1789200551743],"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 nginx:alpine\nCOPY --from=build /app/dist /usr/share/nginx/html\nEXPOSE 80\n",[],[152,153,574],"496e5561-7be6-40e3-a1d9-efddabb82c39","main.tsx","484949de-ae81-11f1-8a0a-1607ee4eb77e","34b65a93-cdc5-4277-868b-6cf1f12afb30",39,["D",1789200571184],"import React from \"react\";\nimport ReactDOM from \"react-dom/client\";\nimport { App } from \"./App.tsx\";\nimport \"./index.css\";\n\nReactDOM.createRoot(document.getElementById(\"root\")!).render(\n \n \n ,\n);\n",[],[152,153,295,582],"6b032ece-1e7b-4375-8542-fae29d3f053e","index.css","48512aaa-ae81-11f1-8a0a-1607ee4eb77e",40,["D",1789200571229],"@tailwind base;\n@tailwind components;\n@tailwind utilities;\n\nbody { @apply bg-[#0a0e14] text-ink antialiased; margin: 0; }\n",[],[152,153,295,591],"cf7fdfd1-6015-4aac-9a71-994a03431d2f","App.tsx","485fd9e2-ae81-11f1-8a0a-1607ee4eb77e",41,["D",1789200571311],"import { useEffect, useState } from \"react\";\n\ninterface Status { status?: string; services?: Record; mode?: string; devices?: { status: string; n: number }[]; }\ninterface BusEvent { id: string; eventType: string; source: string; sourceType: string; confidence: number; zoneId?: string; }\n\n/** Resolve ws URL for dev (proxied) and prod (same host). */\nfunction wsUrl() {\n const loc = window.location;\n const proto = loc.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n return `${proto}//${loc.host}/ws`;\n}\n\nexport function App() {\n const [status, setStatus] = useState(null);\n const [events, setEvents] = useState([]);\n\n // fetch system status\n useEffect(() => {\n fetch(\"/api/v1/status\").then((r) => r.json()).then(setStatus).catch(() => {});\n }, []);\n\n // live event stream\n useEffect(() => {\n const ws = new WebSocket(wsUrl());\n ws.onmessage = (m) => {\n try {\n const data = JSON.parse(m.data as string);\n if (data.eventType) setEvents((prev) => [data, ...prev].slice(0, 60));\n } catch { /* hello frames etc. */ }\n };\n return () => ws.close();\n }, []);\n\n return (\n

\n {/* top bar */}\n

GUARDIQ ROBOTICS COMMAND

\n DEMONSTRATION DATA — SIMULATED\n {Object.entries(status?.services ?? {}).map(([k, v]) => (\n \n \n {k.replace(/([a-z])([A-Z])/g, \"$1 $2\").toUpperCase()}\n {v}\n \n ))}\n

\n\n {/* left nav */}\n \n\n {/* center facility */}\n

\n Facility Digital Twin\n mode: {status?.mode ?? \"…\"}\n

\n {/* zones */}\n

WAREHOUSE

RESTRICTED

\n {/* assets */}\n {[\n [\"CAM-01\", 0.82, 0.22], [\"CAM-02\", 0.4, 0.1], [\"CAM-03\", 0.74, 0.58],\n [\"ROBOT-01\", 0.88, 0.32], [\"GUARD-01\", 0.88, 0.76],\n ].map(([name, x, y]) => (\n

\n {(name as string).startsWith(\"CAM\") ? \"◉\" : (name as string).startsWith(\"ROBOT\") ? \"🤖\" : \"🛡\"}\n

\n {name}\n

\n ))}\n {status &&

N devices online: {(status.devices ?? []).find((d) => d.status === \"ONLINE\")?.n ?? 0}

}\n

\n\n {/* right live feed */}\n \n

\n );\n}\n",[],[152,153,295,599],"c6266071-4914-4981-a7e7-9222cca5f0b6",["D",1789200571184],[182,183,184],[152,153,295],"53e2f101-d42a-4669-a1c1-cfe6408b0137","d400e917-22dc-49af-a027-ceb67fd9fc0d",["D",1789200548944],[181,185,186,187,188,189,190,191],[152,153],"7a8accb2-c882-42a5-b631-9645d6cf2a3d","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",[],[152,623,540],"api","350ed730-2336-41ec-9b30-ce60d6f92875","37ec5562-ae73-11f1-831f-1607ee4eb77e",13,["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",[],[152,623,235],"27991045-15ee-4e1d-8d7e-d164ca593d1a","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",[],[152,623,574],"506bc9e3-09ac-4759-9d40-23758ad710e8","scenario.test.ts","92c0e962-ae73-11f1-9680-1607ee4eb77e","e4ef4224-4cf1-4624-a240-c7af6f545438",31,["D",1789194683165],"// Automated end-to-end scenario test (headless):\n// attack -> event -> AI analyze -> mission -> robot arrives -> verify ->\n// operator action -> resolve -> report. No network, no DB.\nimport { describe, it, expect, vi } from \"vitest\";\nimport { EventBus } from \"@guardiq/event-bus\";\nimport { analyzeEvent } from \"@guardiq/orchestrator\";\nimport { buildMission, pickRobot } from \"@guardiq/orchestrator/mission\";\nimport { SimulatorRobotProvider } from \"@guardiq/hal/simulator\";\nimport { Incident, operatorAction, transition } from \"@guardiq/orchestrator/incident\";\n\nconst SITE = \"site-1\";\n\ndescribe(\"invasion demo scenario\", () => {\n it(\"runs the full flow\", async () => {\n const bus = new EventBus();\n const robot = new SimulatorRobotProvider(\"ROBOT-01\", { start: { x: 0.88, y: 0.32 } });\n\n // 1. camera emits motion\n const evt = bus.publish({\n eventType: \"PERSON_DETECTED\", source: \"CAM-02\", sourceType: \"CAMERA\",\n siteId: SITE, zoneId: \"restricted-nw\", confidence: 0.91,\n dedupeKey: `${SITE}/CAM-02/person/1`, metadata: {},\n });\n // dedup rejects second copy\n expect(() => bus.publish({ ...evt, dedupeKey: evt.dedupeKey } as any)).toThrow();\n\n // 2. orchestrator analyzes\n const d = analyzeEvent(evt);\n expect(d.decision).toBe(\"PERSON_DETECTED\");\n expect(d.confidence).toBeCloseTo(0.91);\n expect(d.risk).toBeGreaterThan(60);\n expect(d.autoSafe).toBe(false); // restricted zone -> not silently auto-actioned\n expect(d.reason.length).toBeGreaterThan(0);\n\n // 3. fleet picks robot\n const who = pickRobot([\n { deviceId: \"ROBOT-02\", dist: 9, battery: 20, available: true }, // low battery -> skipped\n { deviceId: \"ROBOT-01\", dist: 4, battery: 96, available: true },\n ], \"INVESTIGATE\");\n expect(who).toBe(\"ROBOT-01\");\n\n // 4. mission created + executed\n const m = buildMission(\"m-1\", \"INVESTIGATE_EVENT\", [{ x: 0.32, y: 0.42 }]);\n await robot.sendMission(m);\n expect(m.status).toBe(\"COMPLETED\");\n expect(Math.hypot(robot.pos.x - 0.32, robot.pos.y - 0.42)).toBeLessThan(0.12);\n\n // 5. incident lifecycle with human gate\n const inc: Incident = { id: \"i-1\", status: \"ANALYZING\", verified: false, timeline: [] };\n transition(inc, \"INVESTIGATING\", \"SYSTEM\").status; // robot verifying\n transition(inc, \"VERIFIED\", \"ROBOT-01\");\n expect(inc.verified).toBe(true);\n operatorAction(inc, \"DISPATCH_GUARD\", \"USER/OPERATOR\");\n expect(inc.operatorAction).toBe(\"DISPATCH_GUARD\");\n // system may NOT take a sensitive action\n expect(() => operatorAction(inc, \"RESOLVE\", \"SYSTEM\")).toThrow();\n transition(inc, \"RESPONDING\", \"GUARD-01\");\n transition(inc, \"RESOLVED\", \"USER/OPERATOR\");\n expect(inc.status).toBe(\"RESOLVED\");\n expect(inc.timeline.length).toBeGreaterThanOrEqual(5);\n });\n});\n",[],[152,623,647,639],"tests","e6ed4933-7a08-414a-802d-67641630acf5","rbac.test.ts","6529967a-ae8c-11f1-a3d9-1607ee4eb77e",["D",1789205344096],"import { describe, it, expect } from \"vitest\";\nimport { roleHas, requirePermission, resolveAuth } from \"@guardiq/auth\";\n\ndescribe(\"role-based access\", () => {\n it(\"grants least-privilege per role\", () => {\n expect(roleHas(\"CLIENT_VIEWER\", \"sites.read\")).toBe(true);\n expect(roleHas(\"CLIENT_VIEWER\", \"robots.emergency\")).toBe(false);\n expect(roleHas(\"OPERATOR\", \"incidents.write\")).toBe(true);\n expect(roleHas(\"GUARD\", \"incidents.write\")).toBe(false);\n });\n\n it(\"requires any of the given permissions\", () => {\n expect(requirePermission(\"COMMANDER\", [\"robots.emergency\", \"incidents.read\"])).toBe(true);\n expect(requirePermission(\"CLIENT_VIEWER\", [\"robots.emergency\", \"config.manage\"])).toBe(false);\n });\n\n it(\"resolves a caller context from headers\", () => {\n const ctx = resolveAuth({\n \"x-guardiq-role\": \"commander\",\n \"x-guardiq-org\": \"isntx\",\n \"x-guardiq-user\": \"u1\",\n });\n expect(ctx.role).toBe(\"COMMANDER\");\n expect(ctx.orgId).toBe(\"isntx\");\n });\n\n it(\"defaults unknown roles down to CLIENT_VIEWER (security)\", () => {\n expect(resolveAuth({ \"x-guardiq-role\": \"hacker\" }).role).toBe(\"CLIENT_VIEWER\");\n });\n});\n",[],[152,623,647,649],"1fb9df6a-c3fd-4eef-a9ee-7530f446374c",["D",1789194683165],[175,176],[152,623,647],"f697f62a-8c7e-4e01-bf0c-c5906433a758","middleware.ts","5969861a-ae8c-11f1-8cde-1607ee4eb77e","abd72c0c-905a-46a9-a02a-65b5d1db892a",46,["D",1789205324376],"import type { NextFunction, Request, Response } from \"express\";\nimport { resolveAuth, requirePermission, type AuthContext, type Permission } from \"@guardiq/auth\";\n\ndeclare global {\n namespace Express {\n interface Request { auth?: AuthContext }\n }\n}\n\n/** Resolve the tenant + role for every request; attach to req.auth. */\nexport function authn(req: Request, _res: Response, next: NextFunction) {\n req.auth = resolveAuth(req.headers as Record);\n next();\n}\n\n/** RBAC gate factory: require one of `perms` on the caller's role. */\nexport function requirePerm(...perms: Permission[]) {\n return (req: Request, res: Response, next: NextFunction) => {\n if (!req.auth) return res.status(401).json({ error: \"unauthenticated\" });\n if (!requirePermission(req.auth.role, perms)) {\n return res.status(403).json({ error: `forbidden for role ${req.auth.role}`, need: perms });\n }\n next();\n };\n}\n\n/** Tenant guard: does this caller own the site/org in play? Prevents cross-tenant reads. */\nexport function sameTenant(req: Request, res: Response, next: NextFunction) {\n const { orgId } = req.auth!;\n const targetOrg = req.body?.orgId ?? req.query?.orgId ?? orgId;\n if (targetOrg !== orgId) {\n return res.status(403).json({ error: \"cross-tenant access denied\" });\n }\n next();\n}\n",[],[152,623,295,660],"244b3b99-47fa-4b69-8d7e-8114b31093bd","3834126c-ae73-11f1-831f-1607ee4eb77e",48,["D",1789205344037],"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\";\nimport { authn, requirePerm, sameTenant } from \"./middleware.ts\";\n\nconst app = express();\napp.use(express.json());\napp.use(authn); // resolve tenant + role per request\n\n// ---- Tenant-scoped IPC -------------------------------------------------------\n// Every resource query is scoped to req.auth.orgId. Cross-tenant requests are\n// rejected by sameTenant. RBAC gates each route by least-privilege.\n\napp.get(\"/api/v1/incidents\", requirePerm(\"incidents.read\", \"sites.read\"), async (req, res) => {\n const { orgId } = req.auth!;\n const rows = await pool.query(\n `select id, status, severity, type, detected_at from incidents where org_id = $1 order by detected_at desc limit 50`,\n [orgId],\n ).catch(() => ({ rows: [] as never[] }));\n res.json({ orgId, incidents: rows.rows });\n});\n\napp.post(\"/api/v1/incidents/:id/action\", requirePerm(\"incidents.write\"), sameTenant, async (req, res) => {\n const { action } = req.body as { action?: string };\n if (!action || ![\"OBSERVE\", \"DISPATCH_GUARD\", \"ANNOUNCE\", \"ESCALATE\", \"FALSE_ALARM\", \"RESOLVE\"].includes(action)) {\n return res.status(400).json({ error: \"invalid operator action\" });\n }\n // Human-only sensitive actions are enforced here (role check above already\n // requires incidents.write; expand with a human-mode check in production).\n await pool.query(`insert into incident_events (incident_id, kind, payload, actor) values ($1, 'OPERATOR_ACTION', $2::jsonb, $3)`,\n [req.params.id, JSON.stringify({ action }), req.auth!.userId]);\n res.json({ ok: true, action, actor: req.auth!.userId });\n});\n\napp.post(\"/api/v1/robots/:id/emergency\", requirePerm(\"robots.emergency\"), sameTenant, async (req, res) => {\n // Safety engine: emergency stop is gated to roles with robots.emergency and\n // always writes an audit trail.\n await pool.query(`insert into audit_logs (org_id, device_id, action, payload) values ($1, $2, 'EMERGENCY_STOP', $3::jsonb)`,\n [req.auth!.orgId, req.params.id, JSON.stringify({ by: req.auth!.userId })]);\n res.json({ ok: true, action: \"EMERGENCY_STOP\" });\n});\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",[],[152,623,295,297],"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",[],[152,623,295,676],"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",[],[152,623,295,684],"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",[],[152,623,295,448,692],"4385aef1-43c0-4625-8c0b-249d78de96b4",["D",1789194551591],[169],[152,623,295,448],"2438421b-eab1-4389-b8b4-489931c3c2e9",["D",1789194530953],[168,170,171,172,173],[152,623,295],"dc2c007a-a7f7-4b75-8c46-b9c5dc95eba3",["D",1789194530755],[167,174,177,178,179],[152,623],"53b679c8-30df-4b3a-8384-a6a17936112f",["D",1789194530755],[166,180],[152],["D",1789194473035],{"_11":12,"_120":70},{"_11":12,"_115":116,"_69":70,"_30":68,"_117":118,"_119":24},{"_38":106,"_13":16,"_32":35,"_107":72,"_108":-5,"_109":-5,"_110":-5,"_111":-5,"_112":-5,"_113":14,"_114":12},"ctx",{"_53":-5,"_139":753,"_754":755,"_756":757,"_758":24,"_759":24,"_760":24,"_761":146,"_762":-5,"_763":-7,"_764":-7,"_765":26,"_766":24,"_767":24,"_768":-5,"_769":24,"_770":24,"_771":24,"_772":-5},"ENV",{"_724":725,"_726":727,"_728":16,"_729":730,"_731":732,"_733":734,"_735":736,"_737":738,"_739":740,"_741":742,"_743":744,"_745":746,"_747":748,"_749":750,"_751":752},"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"]

History · index.html