How ivanbbaev/syncrona works
SyncroNow AI is a ServiceNow scoped-application development toolkit: its CLI pulls editable records into a project, supports local build tooling, and pushes changes back. Separate product surfaces provide an instance mirror and an MCP server for AI-assisted ServiceNow work, including analysis and Jira tools. The graph combines documented capabilities with sampled call evidence; unsampled subsystem wiring is intentionally kept broad or omitted.
Main entry points: mirrorCommand.ts Mirror command · PluginManager.ts Plugin manager · toolService.ts Tool service · snClient.ts ServiceNow client
Components 29
CLI sync
- CLI commands
packages/core/src/index.ts - Download pipeline
packages/core/src/downloadPipeline.ts - Push pipeline
packages/core/src/pushPipeline.ts - Project files
packages/core/src/FileUtils.ts
Instance mirror
- Mirror command
packages/core/src/mirrorCommand.ts - Mirror pipeline
packages/mirror/src/pipeline.ts - Table catalog
packages/mirror/src/catalog/catalogService.ts - Mirror transport
packages/mirror/src/http/client.ts - Mirror writer
packages/mirror/src/write/writer.ts - Coverage report
packages/mirror/src/report/coverageReport.ts - Mirror files
packages/mirror/src/write/fs.ts
MCP tools
- MCP server
packages/mcp-server/src/index.ts - Tool dispatch
packages/mcp-server/src/toolDispatch.ts - Tool service
packages/mcp-server/src/toolService.ts - Session tools
packages/mcp-server/src/handlers/sessionHandlers.ts - Analysis tools
packages/mcp-server/src/analysis.ts - MCP ServiceNow
packages/mcp-server/src/servicenowCore.ts - Jira tools
packages/mcp-server/src/handlers/jiraToolHandlers.ts
Shared integrations
- ServiceNow client
packages/core/src/snClient.ts - ServiceNow instance
- Jira
Build plugins
- Plugin manager
packages/core/src/PluginManager.ts - Babel tooling
packages/babel-plugin/src/index.ts - ServiceNow preset
packages/babel-preset-servicenow/src/index.ts - TypeScript tooling
packages/typescript-plugin/src/index.ts - Webpack tooling
packages/webpack-plugin/src/index.ts - Sass tooling
packages/sass-plugin/src/index.ts
Other components
- Developer
- MCP client
Connections 33
- Developer → CLI commands: runs commands
- CLI commands → Download pipeline: downloads records
- Download pipeline → ServiceNow client: fetches records
- ServiceNow client → ServiceNow instance: requests data
- Download pipeline → Project files: writes files
- Developer → Project files: edits code
- CLI commands → Push pipeline: pushes changes
- Push pipeline → Plugin manager: builds files
- Plugin manager → Babel tooling: runs plugin
- Plugin manager → ServiceNow preset: runs plugin
- Plugin manager → TypeScript tooling: runs plugin
- Plugin manager → Webpack tooling: runs plugin
- Plugin manager → Sass tooling: runs plugin
- Push pipeline → ServiceNow client: updates records
- ServiceNow client → ServiceNow instance: writes changes
- Developer → Mirror command: runs mirror
- Mirror command → Table catalog: builds catalog
- Table catalog → Mirror transport: reads metadata
- Mirror command → Mirror transport: fetches records
- Mirror transport → ServiceNow instance: requests data
- Mirror command → Mirror pipeline: serializes rows
- Mirror command → Mirror writer: writes mirror
- Mirror writer → Mirror files: stores files
- Mirror command → Coverage report: generates report
- MCP client → MCP server: sends tools
- MCP server → Tool dispatch: dispatches calls
- Tool dispatch → Tool service: routes tools
- Tool service → Session tools: handles session
- Tool service → Analysis tools: handles analysis
- Tool service → MCP ServiceNow: calls ServiceNow
- MCP ServiceNow → ServiceNow instance: requests data
- Tool service → Jira tools: routes Jira tools
- Jira tools → Jira: reads issues