How seethb/adlc-demo works
This repository combines an IoT asset-intelligence demo with ADLC Studio, which demonstrates how shared Meko memory supports a six-stage, guarded agent workflow and measures token savings. The product path runs from simulated telemetry through anomaly detection and maintenance actions, with fleet queries as a read-only branch. Studio exposes that workflow and live product state through a React UI and Node API. Relationships among the less-sampled edge stages and Studio pages are documented capability links, not claims about uninspected calls; unsampled subsystems use exact enclosing directories.
Main entry points: orchestrator.js Stage orchestrator · index.js Studio API · ask.js Fleet Q&A · meko.js Meko datapack
Components 30
Edge intelligence
- Telemetry simulator
edge/features/F01-iot-simulator/index.js - Fleet model
edge/reference/fleet.js - Anomaly detection
edge/features/F02-anomaly-detection/index.js - Work orders
edge/features/F03-work-orders/index.js - Corrective reports
edge/features/F04-corrective-action/index.js - Parts inventory
edge/features/F05-inventory/index.js - Asset queries
edge/features/F06-nl-asset-query/index.js - Reference services
edge/reference/index.js - Edge runtime
server/edge/runtime.js - Fleet Q&A
server/edge/ask.js
Agent lifecycle
- Stage orchestrator
server/adlc/orchestrator.js - Feature specs
server/adlc/specs.js - Gates and guardrails
server/adlc/guardrails.js - Memory evaluation
server/adlc/contextBench.js - Token economics
server/adlc/economics.js - Shared knowledge seed
server/seed/knowledge.js
External services
- Privacy shield
server/security/privacy.js - Meko datapack
server/live/meko.js - Claude client
server/live/claude.js - GitHub client
server/live/github.js
ADLC Studio
- State and event bus
server/core.js - Studio API
server/index.js - Live API store
src/api.js - Studio navigation
src/App.jsx - Studio views
src/pages - Shared UI components
src/components/ui.jsx
Other components
- Engineer
- Meko / MCP
- Anthropic
- GitHub
Connections 43
- Telemetry simulator → Fleet model: uses asset model
edge/features/F01-iot-simulator/index.js - Anomaly detection → Fleet model: uses asset model
edge/features/F02-anomaly-detection/index.js - Asset queries → Fleet model: reads fleet data
edge/features/F06-nl-asset-query/index.js - Edge runtime → Reference services: loads reference services
server/edge/runtime.js - Edge runtime → State and event bus: uses state and events
server/edge/runtime.js - Fleet Q&A → Asset queries: queries assets
server/edge/ask.js - Fleet Q&A → Anomaly detection: reads anomaly data
server/edge/ask.js - Fleet Q&A → Meko datapack: recalls knowledge
server/edge/ask.js - Fleet Q&A → Claude client: generates answer
server/edge/ask.js - Work orders → Parts inventory: reserves parts
README.md - Work orders → Corrective reports: triggers critical reports
README.md - Stage orchestrator → Feature specs: loads feature specs
server/adlc/orchestrator.js - Stage orchestrator → Gates and guardrails: runs gates
server/adlc/orchestrator.js - Stage orchestrator → Meko datapack: recalls shared memory
server/adlc/orchestrator.js - Stage orchestrator → Claude client: requests agent steps
server/adlc/orchestrator.js - Stage orchestrator → GitHub client: updates workflow
server/adlc/orchestrator.js - Stage orchestrator → Token economics: records stage costs
server/adlc/orchestrator.js - Stage orchestrator → Shared knowledge seed: uses seeded knowledge
server/adlc/orchestrator.js - Memory evaluation → Meko datapack: evaluates retrieval
server/adlc/contextBench.js - Memory evaluation → Claude client: counts baseline tokens
server/adlc/contextBench.js - Memory evaluation → Shared knowledge seed: measures knowledge input
server/adlc/contextBench.js - Gates and guardrails → Feature specs: checks feature rules
server/adlc/guardrails.js - Gates and guardrails → Privacy shield: runs PII scan
server/adlc/guardrails.js - Meko datapack → Privacy shield: redacts outbound data
server/live/meko.js - Claude client → Privacy shield: redacts prompts
server/live/claude.js - GitHub client → Privacy shield: redacts outbound data
server/security/privacy.js - Meko datapack → Meko / MCP: calls datapack
- Claude client → Anthropic: calls model
- GitHub client → GitHub: reads repo activity
- Studio API → State and event bus: reads shared state
server/index.js - Studio API → Stage orchestrator: serves pipeline actions
server/index.js - Studio API → Meko datapack: serves Meko data
server/index.js - Studio API → GitHub client: refreshes repository snapshot
server/index.js - Studio API → Token economics: serves economics
server/index.js - Studio API → Edge runtime: serves edge state
server/index.js - Studio API → Fleet Q&A: routes fleet questions
server/index.js - Live API store → Studio API: fetches and streams updates
src/api.js - Studio navigation → Live API store: subscribes to live state
src/App.jsx - Studio navigation → Studio views: selects views
src/App.jsx - Studio views → Shared UI components: uses shared components
src/pages/Architecture.jsx - Engineer → Studio navigation: uses Studio
README.md - Engineer → Telemetry simulator: injects telemetry faults
README.md - Engineer → Fleet Q&A: asks fleet questions
README.md