background-jobs · diff
git:20260904.5ed75bb to git:20260915.566d610
8 added, 11 removed. Audit A to A.
---
name: background-jobs
description: "Фоновые и регламентные задания 1С. Используй когда нужно спроектировать, проверить или диагностировать background jobs, расписания, очереди, зависания, retry-логику и журналирование."
---
# Background Jobs
## MCP routing
- - Preferred path: use MCP `unica` tools `unica.view {}`, `unica.code.search`, `unica.meta.info`, `unica.code.diagnostics`, `unica.docs`, and `unica.runtime.execute`.
- - По INV-MCP-RUNTIME-RECEIPT и ADR-0074: `unica.runtime.execute` с `dryRun: true`
- показывает запланированную команду без побочных эффектов, а с `dryRun: false`
- исполняет классифицированную операцию и отвечает её терминальным результатом в
- том же вызове, приложив названную причину риска (`runtime_risk_*`)
- предупреждением; неклассифицированная операция по-прежнему отказывает
- `runtime_operation_unbounded` до обнаружения рабочего пространства. Preview
- исполнением не является. Работу, которую вызов ждать не должен, запускай через
- `unica.runtime.job.start`. Не обходи контракт прямым runner-ом или через
- `unica.build.*`.
+ - Preferred path: use MCP `unica` tools `unica.view {}`, `unica.code.search`, `unica.meta.info`, `unica.code.diagnostics`, `unica.docs`, and `unica.run`.
+ - Runtime идёт через `unica.run`: вызов без `op` отдаёт словарь операций и
+ контракт каждой — `argsSchema`, `execution`, `previewRequired`,
+ `ifRevRequiredOnApply`. Контракт вызова бери оттуда, а не из этого текста;
+ выбирай только операцию с `implemented: true` и не выдумывай аргументов
+ записи с `argsSchema: null`; превью исполнением не является. Не обходи
+ контракт прямым runner-ом.
- Use `unica.view` on the role node when job behavior depends on user context or permissions.
- Do not call internal runtime, analyzer, standards, or package adapters directly. They are hidden behind MCP `unica`.
## References
- Read `../../references/platform/platform-mechanics.md` for background job context, temporary storage, and security boundaries.
- Read `../../references/platform/transactions-locks.md` when the job reads and then writes shared state; this skill keeps only job restartability.
- Read `../../references/platform/runtime-diagnostics.md` when the task includes ЖР/ТЖ, hangs, retries, or process/session evidence.
## Workflow
1. Identify job type: scheduled job, background job launched from code, queue worker, exchange worker, or deferred integration retry.
2. Find entry points with `unica.code.search`; inspect related metadata with `unica.meta.info` and project layout with `unica.view {}`.
3. Define execution contract: parameters, user context, transaction scope, idempotency key, lock strategy, timeout, retry count, and logging fields.
4. Check failure behavior before implementation: duplicate launch, partial write, stale lock, external service failure, session termination, and restart after crash.
- 5. Run `unica.code.diagnostics`; use `unica.runtime.execute` to preview typed syntax/test/launch arguments and, with `dryRun: false`, to run it, and record runtime verification as unavailable unless separate evidence is supplied.
+ 5. Run `unica.code.diagnostics`; check syntax with `unica.check`, launch a client through `unica.run` (`client.run`) when the diagnosis needs one, and record runtime verification as unavailable unless separate evidence is supplied: test runs are outside the v0.13 surface.
6. For diagnosis, build a timeline from ЖР/ТЖ and map the first failure back to module code.
## Review checklist
- Job can be safely restarted or retried.
- Long work is split or checkpointed.
- Logs use structured logging fields: job id, parameters summary, correlation id,
retry count, result, and sanitized error context, but no secrets.
- Shared state a job reads and then writes is handled per `transactions-locks`,
and the lock does not block unrelated users or tenants.
- Failure paths distinguish retryable and permanent errors.
## Contract gaps
If public MCP `unica` cannot inspect schedules, active jobs, lock state, or runtime artifacts needed for the task, report a Unica MCP contract gap with the missing operation.