agent-steward 0.0.1 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +399 -0
- package/CROSS_PLATFORM.md +151 -0
- package/README.md +307 -15
- package/ROADMAP-STRATEGY.md +196 -0
- package/ROADMAP.md +184 -0
- package/dist/core/analytics.d.ts +132 -0
- package/dist/core/analytics.d.ts.map +1 -0
- package/dist/core/analytics.js +290 -0
- package/dist/core/audit.d.ts +96 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +297 -0
- package/dist/core/cron-to-schtasks.d.ts +12 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -0
- package/dist/core/cron-to-schtasks.js +175 -0
- package/dist/core/dry-run.d.ts +102 -0
- package/dist/core/dry-run.d.ts.map +1 -0
- package/dist/core/dry-run.js +447 -0
- package/dist/core/file-watcher.d.ts +31 -0
- package/dist/core/file-watcher.d.ts.map +1 -0
- package/dist/core/file-watcher.js +186 -0
- package/dist/core/git-trigger.d.ts +82 -0
- package/dist/core/git-trigger.d.ts.map +1 -0
- package/dist/core/git-trigger.js +312 -0
- package/dist/core/glob.d.ts +38 -0
- package/dist/core/glob.d.ts.map +1 -0
- package/dist/core/glob.js +233 -0
- package/dist/core/local-ai.d.ts +52 -0
- package/dist/core/local-ai.d.ts.map +1 -0
- package/dist/core/local-ai.js +119 -0
- package/dist/core/lock.d.ts +57 -0
- package/dist/core/lock.d.ts.map +1 -0
- package/dist/core/lock.js +193 -0
- package/dist/core/matrix.d.ts +167 -0
- package/dist/core/matrix.d.ts.map +1 -0
- package/dist/core/matrix.js +724 -0
- package/dist/core/native-notify.d.ts +36 -0
- package/dist/core/native-notify.d.ts.map +1 -0
- package/dist/core/native-notify.js +113 -0
- package/dist/core/one-shot.d.ts +90 -0
- package/dist/core/one-shot.d.ts.map +1 -0
- package/dist/core/one-shot.js +182 -0
- package/dist/core/otel.d.ts +4 -0
- package/dist/core/otel.d.ts.map +1 -0
- package/dist/core/otel.js +98 -0
- package/dist/core/permissions.d.ts +69 -0
- package/dist/core/permissions.d.ts.map +1 -0
- package/dist/core/permissions.js +143 -0
- package/dist/core/prometheus.d.ts +23 -0
- package/dist/core/prometheus.d.ts.map +1 -0
- package/dist/core/prometheus.js +146 -0
- package/dist/core/ps-wrapper.d.ts +73 -0
- package/dist/core/ps-wrapper.d.ts.map +1 -0
- package/dist/core/ps-wrapper.js +1091 -0
- package/dist/core/record-history.d.ts +25 -0
- package/dist/core/record-history.d.ts.map +1 -0
- package/dist/core/record-history.js +471 -0
- package/dist/core/retention.d.ts +29 -0
- package/dist/core/retention.d.ts.map +1 -0
- package/dist/core/retention.js +98 -0
- package/dist/core/savings.d.ts +70 -0
- package/dist/core/savings.d.ts.map +1 -0
- package/dist/core/savings.js +87 -0
- package/dist/core/schedule-gate.d.ts +2 -0
- package/dist/core/schedule-gate.d.ts.map +1 -0
- package/dist/core/schedule-gate.js +211 -0
- package/dist/core/schedule-v2.d.ts +116 -0
- package/dist/core/schedule-v2.d.ts.map +1 -0
- package/dist/core/schedule-v2.js +586 -0
- package/dist/core/scheduler/at-fallback.d.ts +42 -0
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -0
- package/dist/core/scheduler/at-fallback.js +70 -0
- package/dist/core/scheduler/index.d.ts +32 -0
- package/dist/core/scheduler/index.d.ts.map +1 -0
- package/dist/core/scheduler/index.js +63 -0
- package/dist/core/scheduler/linux.d.ts +46 -0
- package/dist/core/scheduler/linux.d.ts.map +1 -0
- package/dist/core/scheduler/linux.js +261 -0
- package/dist/core/scheduler/logs.d.ts +11 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -0
- package/dist/core/scheduler/logs.js +34 -0
- package/dist/core/scheduler/mac.d.ts +46 -0
- package/dist/core/scheduler/mac.d.ts.map +1 -0
- package/dist/core/scheduler/mac.js +256 -0
- package/dist/core/scheduler/posix.d.ts +40 -0
- package/dist/core/scheduler/posix.d.ts.map +1 -0
- package/dist/core/scheduler/posix.js +100 -0
- package/dist/core/scheduler/registry.d.ts +43 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -0
- package/dist/core/scheduler/registry.js +57 -0
- package/dist/core/scheduler/types.d.ts +86 -0
- package/dist/core/scheduler/types.d.ts.map +1 -0
- package/dist/core/scheduler/types.js +1 -0
- package/dist/core/scheduler/windows.d.ts +112 -0
- package/dist/core/scheduler/windows.d.ts.map +1 -0
- package/dist/core/scheduler/windows.js +749 -0
- package/dist/core/secrets.d.ts +66 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +433 -0
- package/dist/core/self-analysis.d.ts +117 -0
- package/dist/core/self-analysis.d.ts.map +1 -0
- package/dist/core/self-analysis.js +539 -0
- package/dist/core/session.d.ts +42 -0
- package/dist/core/session.d.ts.map +1 -0
- package/dist/core/session.js +134 -0
- package/dist/core/shutdown.d.ts +26 -0
- package/dist/core/shutdown.d.ts.map +1 -0
- package/dist/core/shutdown.js +49 -0
- package/dist/core/structured-log.d.ts +84 -0
- package/dist/core/structured-log.d.ts.map +1 -0
- package/dist/core/structured-log.js +146 -0
- package/dist/core/summary.d.ts +69 -0
- package/dist/core/summary.d.ts.map +1 -0
- package/dist/core/summary.js +250 -0
- package/dist/core/telegram.d.ts +55 -0
- package/dist/core/telegram.d.ts.map +1 -0
- package/dist/core/telegram.js +344 -0
- package/dist/core/triage-chain.d.ts +40 -0
- package/dist/core/triage-chain.d.ts.map +1 -0
- package/dist/core/triage-chain.js +80 -0
- package/dist/core/triage-compare.d.ts +68 -0
- package/dist/core/triage-compare.d.ts.map +1 -0
- package/dist/core/triage-compare.js +184 -0
- package/dist/core/triage-rules.d.ts +23 -0
- package/dist/core/triage-rules.d.ts.map +1 -0
- package/dist/core/triage-rules.js +196 -0
- package/dist/core/triage-shadow.d.ts +91 -0
- package/dist/core/triage-shadow.d.ts.map +1 -0
- package/dist/core/triage-shadow.js +160 -0
- package/dist/core/triage-worker.d.ts +55 -0
- package/dist/core/triage-worker.d.ts.map +1 -0
- package/dist/core/triage-worker.js +314 -0
- package/dist/core/triage.d.ts +76 -0
- package/dist/core/triage.d.ts.map +1 -0
- package/dist/core/triage.js +271 -0
- package/dist/core/watch-paths.d.ts +6 -0
- package/dist/core/watch-paths.d.ts.map +1 -0
- package/dist/core/watch-paths.js +62 -0
- package/dist/core/wrappers/bash.d.ts +95 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -0
- package/dist/core/wrappers/bash.js +413 -0
- package/dist/db/git-state-repo.d.ts +16 -0
- package/dist/db/git-state-repo.d.ts.map +1 -0
- package/dist/db/git-state-repo.js +38 -0
- package/dist/db/history-repo.d.ts +110 -0
- package/dist/db/history-repo.d.ts.map +1 -0
- package/dist/db/history-repo.js +300 -0
- package/dist/db/index.d.ts +49 -0
- package/dist/db/index.d.ts.map +1 -0
- package/dist/db/index.js +128 -0
- package/dist/db/metrics-repo.d.ts +46 -0
- package/dist/db/metrics-repo.d.ts.map +1 -0
- package/dist/db/metrics-repo.js +103 -0
- package/dist/db/migrate.d.ts +24 -0
- package/dist/db/migrate.d.ts.map +1 -0
- package/dist/db/migrate.js +244 -0
- package/dist/db/recovery.d.ts +11 -0
- package/dist/db/recovery.d.ts.map +1 -0
- package/dist/db/recovery.js +38 -0
- package/dist/db/run-journal.d.ts +60 -0
- package/dist/db/run-journal.d.ts.map +1 -0
- package/dist/db/run-journal.js +143 -0
- package/dist/db/run-resume.d.ts +48 -0
- package/dist/db/run-resume.d.ts.map +1 -0
- package/dist/db/run-resume.js +137 -0
- package/dist/db/runs-repo.d.ts +120 -0
- package/dist/db/runs-repo.d.ts.map +1 -0
- package/dist/db/runs-repo.js +319 -0
- package/dist/db/schema.d.ts +38 -0
- package/dist/db/schema.d.ts.map +1 -0
- package/dist/db/schema.js +325 -0
- package/dist/db/settings-repo.d.ts +8 -0
- package/dist/db/settings-repo.d.ts.map +1 -0
- package/dist/db/settings-repo.js +27 -0
- package/dist/db/tasks-repo.d.ts +26 -0
- package/dist/db/tasks-repo.d.ts.map +1 -0
- package/dist/db/tasks-repo.js +120 -0
- package/dist/db/templates-repo.d.ts +17 -0
- package/dist/db/templates-repo.d.ts.map +1 -0
- package/dist/db/templates-repo.js +57 -0
- package/dist/history.d.ts +60 -0
- package/dist/history.d.ts.map +1 -0
- package/dist/history.js +70 -0
- package/dist/i18n.d.ts +75 -0
- package/dist/i18n.d.ts.map +1 -0
- package/dist/i18n.js +357 -0
- package/dist/index.d.ts +858 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5209 -0
- package/dist/integrations.d.ts +72 -0
- package/dist/integrations.d.ts.map +1 -0
- package/dist/integrations.js +233 -0
- package/dist/notifications.d.ts +199 -0
- package/dist/notifications.d.ts.map +1 -0
- package/dist/notifications.js +967 -0
- package/dist/profiles.d.ts +64 -0
- package/dist/profiles.d.ts.map +1 -0
- package/dist/profiles.js +305 -0
- package/dist/rpc.d.ts +3915 -0
- package/dist/rpc.d.ts.map +1 -0
- package/dist/rpc.js +1596 -0
- package/dist/schtasks.d.ts +32 -0
- package/dist/schtasks.d.ts.map +1 -0
- package/dist/schtasks.js +45 -0
- package/dist/server.d.ts +128 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +2414 -0
- package/dist/settings.d.ts +389 -0
- package/dist/settings.d.ts.map +1 -0
- package/dist/settings.js +770 -0
- package/dist/shared/jobs-view.d.ts +59 -0
- package/dist/shared/jobs-view.d.ts.map +1 -0
- package/dist/shared/jobs-view.js +146 -0
- package/dist/skill.d.ts +15 -0
- package/dist/skill.d.ts.map +1 -0
- package/dist/skill.js +93 -0
- package/dist/task-transfer.d.ts +252 -0
- package/dist/task-transfer.d.ts.map +1 -0
- package/dist/task-transfer.js +632 -0
- package/dist/templates.d.ts +57 -0
- package/dist/templates.d.ts.map +1 -0
- package/dist/templates.js +16 -0
- package/dist/types.d.ts +112 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +158 -0
- package/dist/version.d.ts +8 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +27 -0
- package/dist/workspaces.d.ts +113 -0
- package/dist/workspaces.d.ts.map +1 -0
- package/dist/workspaces.js +393 -0
- package/docs/ARCHITECTURE.md +559 -0
- package/docs/COMPATIBILITY.md +237 -0
- package/docs/CONCEPT.md +242 -0
- package/docs/CROSS_PLATFORM.ru.md +152 -0
- package/docs/CROSS_PLATFORM.zh.md +148 -0
- package/docs/FAQ.md +52 -0
- package/docs/FAQ.ru.md +53 -0
- package/docs/FAQ.zh.md +43 -0
- package/docs/FEATURES.md +699 -0
- package/docs/FEATURES.zh.md +656 -0
- package/docs/LOCAL-AI.md +300 -0
- package/docs/MIGRATION.md +363 -0
- package/docs/README.ru.md +287 -0
- package/docs/README.zh.md +306 -0
- package/docs/SAVINGS.md +61 -0
- package/docs/SAVINGS.ru.md +60 -0
- package/docs/SAVINGS.zh.md +52 -0
- package/docs/V1-V2-COMPATIBILITY-PLAN.md +366 -0
- package/docs/ZH-LOCALE-PLAN.md +324 -0
- package/docs/dashboard.png +0 -0
- package/docs/spikes/local-model-structured-output.md +81 -0
- package/docs/spikes/ollama-qwen3-4b-smoke.json +28 -0
- package/docs/spikes/ollama-qwen3-4b.json +163 -0
- package/gui-experimental.cjs +9 -0
- package/index.js +2 -0
- package/locales/en.json +781 -0
- package/locales/ru.json +781 -0
- package/locales/zh.json +781 -0
- package/package.json +154 -13
- package/scripts/bench-local.mjs +321 -0
- package/scripts/check-zh-locale.mjs +218 -0
- package/scripts/demo-dashboard.mjs +209 -0
- package/scripts/run-tests.mjs +236 -0
- package/scripts/spike-local-structured.mjs +182 -0
- package/scripts/test-locale.mjs +45 -0
- package/skills/scheduled-job-best-practices/SKILL.md +158 -0
- package/skills/scheduled-job-best-practices/references/recipes.md +163 -0
- package/src/core/analytics.ts +424 -0
- package/src/core/audit.ts +418 -0
- package/src/core/cron-to-schtasks.ts +209 -0
- package/src/core/dry-run.ts +601 -0
- package/src/core/file-watcher.ts +245 -0
- package/src/core/git-trigger.ts +391 -0
- package/src/core/glob.ts +226 -0
- package/src/core/local-ai.ts +173 -0
- package/src/core/lock.ts +219 -0
- package/src/core/matrix.ts +947 -0
- package/src/core/native-notify.ts +157 -0
- package/src/core/one-shot.ts +239 -0
- package/src/core/otel.ts +128 -0
- package/src/core/permissions.ts +200 -0
- package/src/core/prometheus.ts +215 -0
- package/src/core/ps-wrapper.ts +1160 -0
- package/src/core/record-history.ts +615 -0
- package/src/core/retention.ts +141 -0
- package/src/core/savings.ts +150 -0
- package/src/core/schedule-gate.ts +253 -0
- package/src/core/schedule-v2.ts +668 -0
- package/src/core/scheduler/at-fallback.ts +113 -0
- package/src/core/scheduler/index.ts +82 -0
- package/src/core/scheduler/linux.ts +308 -0
- package/src/core/scheduler/logs.ts +37 -0
- package/src/core/scheduler/mac.ts +322 -0
- package/src/core/scheduler/posix.ts +128 -0
- package/src/core/scheduler/registry.ts +101 -0
- package/src/core/scheduler/types.ts +90 -0
- package/src/core/scheduler/windows.ts +881 -0
- package/src/core/secrets.ts +503 -0
- package/src/core/self-analysis.ts +744 -0
- package/src/core/session.ts +150 -0
- package/src/core/shutdown.ts +69 -0
- package/src/core/structured-log.ts +214 -0
- package/src/core/summary.ts +318 -0
- package/src/core/telegram.ts +436 -0
- package/src/core/triage-chain.ts +125 -0
- package/src/core/triage-compare.ts +277 -0
- package/src/core/triage-rules.ts +238 -0
- package/src/core/triage-shadow.ts +240 -0
- package/src/core/triage-worker.ts +344 -0
- package/src/core/triage.ts +366 -0
- package/src/core/watch-paths.ts +70 -0
- package/src/core/wrappers/bash.ts +532 -0
- package/src/db/git-state-repo.ts +62 -0
- package/src/db/history-repo.ts +492 -0
- package/src/db/index.ts +176 -0
- package/src/db/metrics-repo.ts +170 -0
- package/src/db/migrate.ts +328 -0
- package/src/db/recovery.ts +46 -0
- package/src/db/run-journal.ts +212 -0
- package/src/db/run-resume.ts +220 -0
- package/src/db/runs-repo.ts +481 -0
- package/src/db/schema.ts +349 -0
- package/src/db/settings-repo.ts +31 -0
- package/src/db/tasks-repo.ts +162 -0
- package/src/db/templates-repo.ts +77 -0
- package/src/gui.tsx +5222 -0
- package/src/history.ts +128 -0
- package/src/i18n.ts +413 -0
- package/src/index.ts +6642 -0
- package/src/integrations.ts +297 -0
- package/src/notifications.ts +1346 -0
- package/src/profiles.ts +345 -0
- package/src/rpc.ts +1704 -0
- package/src/schtasks.ts +75 -0
- package/src/server.ts +2663 -0
- package/src/settings.ts +1369 -0
- package/src/shared/jobs-view.ts +188 -0
- package/src/skill.ts +113 -0
- package/src/task-transfer.ts +946 -0
- package/src/templates.ts +67 -0
- package/src/tui-v1.tsx +341 -0
- package/src/tui.tsx +329 -0
- package/src/types.ts +226 -0
- package/src/version.ts +27 -0
- package/src/workspaces.ts +487 -0
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Политика прав фоновых задач (Спринт 32 / релиз 1.6).
|
|
3
|
+
*
|
|
4
|
+
* OpenCode запускается с `--auto`, поэтому единственный барьер между
|
|
5
|
+
* автономной задачей и файловой системой/шеллом — сгенерированный
|
|
6
|
+
* OPENCODE_CONFIG_CONTENT. Здесь находится единый источник истины для
|
|
7
|
+
* PowerShell- и bash-обёрток, чтобы они не расходились в трактовке
|
|
8
|
+
* allowedTools/deniedTools.
|
|
9
|
+
*
|
|
10
|
+
* Важно: это политика на момент СОЗДАНИЯ/ОБНОВЛЕНИЯ задачи. Отдельный
|
|
11
|
+
* процесс обёртки не имеет доступа к SQLite, поэтому аудит фиксирует
|
|
12
|
+
* сгенерированную политику, а не попытки вызова инструментов.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/** Действия OpenCode v2, которые понимает permissions. */
|
|
16
|
+
export const PERMISSION_ACTIONS = [
|
|
17
|
+
"read",
|
|
18
|
+
"edit",
|
|
19
|
+
"glob",
|
|
20
|
+
"grep",
|
|
21
|
+
"shell",
|
|
22
|
+
"subagent",
|
|
23
|
+
"skill",
|
|
24
|
+
"question",
|
|
25
|
+
"webfetch",
|
|
26
|
+
"websearch",
|
|
27
|
+
] as const;
|
|
28
|
+
|
|
29
|
+
export type PermissionAction = (typeof PERMISSION_ACTIONS)[number];
|
|
30
|
+
|
|
31
|
+
/** Имена инструментов, которые OpenCode отображает на действия. */
|
|
32
|
+
export const ACTION_ALIASES: Record<PermissionAction, readonly string[]> = {
|
|
33
|
+
read: ["read"],
|
|
34
|
+
edit: ["write", "edit", "apply_patch", "remove"],
|
|
35
|
+
glob: ["glob"],
|
|
36
|
+
grep: ["grep"],
|
|
37
|
+
shell: ["bash", "shell"],
|
|
38
|
+
subagent: ["subagent"],
|
|
39
|
+
skill: ["skill"],
|
|
40
|
+
question: ["question"],
|
|
41
|
+
webfetch: ["webfetch"],
|
|
42
|
+
websearch: ["websearch"],
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
export const PERMISSION_POLICIES = ["hybrid", "secure", "legacy"] as const;
|
|
46
|
+
export type PermissionPolicy = (typeof PERMISSION_POLICIES)[number];
|
|
47
|
+
export const DEFAULT_PERMISSION_POLICY: PermissionPolicy = "hybrid";
|
|
48
|
+
|
|
49
|
+
/** Базовые политики: какие действия разрешены без учёта списков задачи. */
|
|
50
|
+
const POLICY_BASE: Record<PermissionPolicy, readonly PermissionAction[]> = {
|
|
51
|
+
// Гибрид: агенту можно менять файлы, но не выполнять команды и не задавать
|
|
52
|
+
// вопросы (автономная задача всё равно некому на них ответить).
|
|
53
|
+
hybrid: ["read", "edit", "glob", "grep", "subagent", "skill", "webfetch", "websearch"],
|
|
54
|
+
// Строгий режим: только чтение и анализ исходников.
|
|
55
|
+
secure: ["read", "glob", "grep", "skill"],
|
|
56
|
+
// Прежнее поведение 1.5.x: разрешено всё.
|
|
57
|
+
legacy: [...PERMISSION_ACTIONS],
|
|
58
|
+
};
|
|
59
|
+
|
|
60
|
+
export interface PermissionInput {
|
|
61
|
+
/** Глобальная политика из SchedulerSettings.permissions.defaultPolicy. */
|
|
62
|
+
policy?: PermissionPolicy | string | null;
|
|
63
|
+
/** Переходный флаг задачи: вернуть shell в гибридной политике. */
|
|
64
|
+
legacyShell?: boolean;
|
|
65
|
+
/** Явный allowlist задачи (уже нормализованный или сырой). */
|
|
66
|
+
allowedTools?: readonly string[] | null;
|
|
67
|
+
/** Явный denylist задачи. */
|
|
68
|
+
deniedTools?: readonly string[] | null;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export interface EffectivePermission {
|
|
72
|
+
action: PermissionAction;
|
|
73
|
+
resource: "*";
|
|
74
|
+
effect: "allow" | "deny";
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export interface DeniedByPolicy {
|
|
78
|
+
action: PermissionAction;
|
|
79
|
+
hint: string;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
export interface EffectivePermissions {
|
|
83
|
+
policy: PermissionPolicy;
|
|
84
|
+
legacyShell: boolean;
|
|
85
|
+
permissions: EffectivePermission[];
|
|
86
|
+
/**
|
|
87
|
+
* Действия, запрещённые именно политикой по умолчанию (а не списками
|
|
88
|
+
* задачи). Используется для аудита и подсказок в логе.
|
|
89
|
+
*/
|
|
90
|
+
deniedByPolicy: DeniedByPolicy[];
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** Приводит произвольное значение к известной политике. */
|
|
94
|
+
export function normalizePolicy(
|
|
95
|
+
value: unknown,
|
|
96
|
+
fallback: PermissionPolicy = DEFAULT_PERMISSION_POLICY,
|
|
97
|
+
): PermissionPolicy {
|
|
98
|
+
return typeof value === "string" &&
|
|
99
|
+
(PERMISSION_POLICIES as readonly string[]).includes(value)
|
|
100
|
+
? (value as PermissionPolicy)
|
|
101
|
+
: fallback;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** Нормализует список инструментов: trim, lower-case, без пустых и дублей. */
|
|
105
|
+
export function normalizeToolList(
|
|
106
|
+
value: readonly string[] | null | undefined,
|
|
107
|
+
): string[] {
|
|
108
|
+
return Array.from(
|
|
109
|
+
new Set(
|
|
110
|
+
(value ?? [])
|
|
111
|
+
.map((tool) => String(tool).trim().toLowerCase())
|
|
112
|
+
.filter(Boolean),
|
|
113
|
+
),
|
|
114
|
+
);
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function actionsForTools(tools: Iterable<string>): Set<PermissionAction> {
|
|
118
|
+
const result = new Set<PermissionAction>();
|
|
119
|
+
for (const tool of tools) {
|
|
120
|
+
for (const action of PERMISSION_ACTIONS) {
|
|
121
|
+
if (ACTION_ALIASES[action].includes(tool)) result.add(action);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
return result;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function hintFor(action: PermissionAction): string {
|
|
128
|
+
switch (action) {
|
|
129
|
+
case "shell":
|
|
130
|
+
return "shell запрещён политикой: добавьте shell в allowedTools задачи либо вынесите команду в qualityGate/afterScript.";
|
|
131
|
+
case "question":
|
|
132
|
+
return "question запрещён политикой: автономная задача не может ответить на вопрос; уберите интерактивный шаг или добавьте question в allowedTools.";
|
|
133
|
+
case "edit":
|
|
134
|
+
return "edit запрещён политикой secure: добавьте edit/write в allowedTools или выберите политику hybrid/legacy.";
|
|
135
|
+
default:
|
|
136
|
+
return `${action} запрещён политикой secure: добавьте ${action} в allowedTools или выберите политику hybrid/legacy.`;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* Вычисляет эффективные права задачи.
|
|
142
|
+
*
|
|
143
|
+
* Порядок:
|
|
144
|
+
* 1. базовая политика (hybrid/secure/legacy), legacyShell возвращает shell;
|
|
145
|
+
* 2. deniedTools переводит действие в deny (выигрывает всегда);
|
|
146
|
+
* 3. непустой allowedTools превращается в allowlist и может явно вернуть
|
|
147
|
+
* действие, запрещённое политикой (кроме явно запрещённых deniedTools).
|
|
148
|
+
*/
|
|
149
|
+
export function resolvePermissions(input: PermissionInput = {}): EffectivePermissions {
|
|
150
|
+
const policy = normalizePolicy(input.policy);
|
|
151
|
+
const legacyShell = input.legacyShell === true;
|
|
152
|
+
const allowed = actionsForTools(normalizeToolList(input.allowedTools));
|
|
153
|
+
const denied = actionsForTools(normalizeToolList(input.deniedTools));
|
|
154
|
+
|
|
155
|
+
const base = new Set<PermissionAction>(POLICY_BASE[policy]);
|
|
156
|
+
if (policy === "hybrid" && legacyShell) base.add("shell");
|
|
157
|
+
|
|
158
|
+
const permissions: EffectivePermission[] = PERMISSION_ACTIONS.map((action) => {
|
|
159
|
+
let effect: "allow" | "deny" = base.has(action) ? "allow" : "deny";
|
|
160
|
+
if (denied.has(action)) effect = "deny";
|
|
161
|
+
else if (allowed.size > 0) effect = allowed.has(action) ? "allow" : "deny";
|
|
162
|
+
return { action, resource: "*", effect };
|
|
163
|
+
});
|
|
164
|
+
|
|
165
|
+
const deniedByPolicy: DeniedByPolicy[] = [];
|
|
166
|
+
for (const entry of permissions) {
|
|
167
|
+
if (entry.effect !== "deny") continue;
|
|
168
|
+
if (denied.has(entry.action)) continue;
|
|
169
|
+
// Если список allowedTools непустой, запрет мог быть вызван им.
|
|
170
|
+
if (allowed.size > 0) continue;
|
|
171
|
+
deniedByPolicy.push({
|
|
172
|
+
action: entry.action,
|
|
173
|
+
hint: hintFor(entry.action),
|
|
174
|
+
});
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
return { policy, legacyShell, permissions, deniedByPolicy };
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** Готовый OPENCODE_CONFIG_CONTENT для обёрток. */
|
|
181
|
+
export function buildOpencodeConfig(input: PermissionInput = {}): string {
|
|
182
|
+
const effective = resolvePermissions(input);
|
|
183
|
+
return JSON.stringify(
|
|
184
|
+
{
|
|
185
|
+
$schema: "https://opencode.ai/config.json",
|
|
186
|
+
permissions: effective.permissions,
|
|
187
|
+
},
|
|
188
|
+
null,
|
|
189
|
+
2,
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** Краткое описание политики для лога задачи. */
|
|
194
|
+
export function formatPolicyLog(effective: EffectivePermissions): string {
|
|
195
|
+
const denied = effective.permissions
|
|
196
|
+
.filter((p) => p.effect === "deny")
|
|
197
|
+
.map((p) => p.action);
|
|
198
|
+
const legacyShell = effective.legacyShell ? ", legacyShell=true" : "";
|
|
199
|
+
return `policy=${effective.policy}${legacyShell}, denied=${denied.length > 0 ? denied.join(",") : "none"}`;
|
|
200
|
+
}
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import { getAllMetrics } from "../db/metrics-repo.js";
|
|
2
|
+
import { countHistory, countRunningRecords, getHistory } from "../db/history-repo.js";
|
|
3
|
+
import { getPluginVersion } from "../version.js";
|
|
4
|
+
import { getProfileName } from "../profiles.js";
|
|
5
|
+
import { getSchedulerTitle } from "./scheduler/index.js";
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Prometheus-метрики (Спринт 22).
|
|
9
|
+
*
|
|
10
|
+
* Формат — текстовый exposition format 0.0.4, отдаётся по GET /metrics.
|
|
11
|
+
* Никаких клиентских библиотек: собираем снимок из SQLite и рендерим строку.
|
|
12
|
+
*
|
|
13
|
+
* Имена метрик стабильны и документированы в docs/FEATURES.md:
|
|
14
|
+
* opencode_scheduler_info
|
|
15
|
+
* opencode_scheduler_up
|
|
16
|
+
* opencode_scheduler_queue_depth
|
|
17
|
+
* opencode_scheduler_history_records
|
|
18
|
+
* opencode_scheduler_runs_total{task,status}
|
|
19
|
+
* opencode_scheduler_errors_total{task}
|
|
20
|
+
* opencode_scheduler_tokens_total{task}
|
|
21
|
+
* opencode_scheduler_cost_usd_total{task}
|
|
22
|
+
* opencode_scheduler_run_duration_seconds{task,le} (+ _sum/_count)
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
export const PROMETHEUS_CONTENT_TYPE = "text/plain; version=0.0.4; charset=utf-8";
|
|
26
|
+
|
|
27
|
+
const DURATION_BUCKETS_SECONDS = [1, 5, 15, 30, 60, 120, 300, 600, 1800, 3600];
|
|
28
|
+
|
|
29
|
+
/** Экранирование значения label по правилам Prometheus. */
|
|
30
|
+
export function escapePrometheusLabel(value: string): string {
|
|
31
|
+
return String(value)
|
|
32
|
+
.replace(/\\/g, "\\\\")
|
|
33
|
+
.replace(/"/g, '\\"')
|
|
34
|
+
.replace(/\n/g, "\\n");
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function labels(pairs: Record<string, string | number>): string {
|
|
38
|
+
const entries = Object.entries(pairs);
|
|
39
|
+
if (entries.length === 0) return "";
|
|
40
|
+
return `{${entries
|
|
41
|
+
.map(([key, value]) => `${key}="${escapePrometheusLabel(String(value))}"`)
|
|
42
|
+
.join(",")}}`;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function formatNumber(value: number): string {
|
|
46
|
+
if (!Number.isFinite(value)) return "0";
|
|
47
|
+
if (Number.isInteger(value)) return String(value);
|
|
48
|
+
return value.toFixed(6).replace(/0+$/, "").replace(/\.$/, "");
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function metric(
|
|
52
|
+
lines: string[],
|
|
53
|
+
name: string,
|
|
54
|
+
type: "counter" | "gauge" | "histogram",
|
|
55
|
+
help: string,
|
|
56
|
+
samples: { labels?: Record<string, string | number>; value: number }[],
|
|
57
|
+
): void {
|
|
58
|
+
lines.push(`# HELP ${name} ${help}`);
|
|
59
|
+
lines.push(`# TYPE ${name} ${type}`);
|
|
60
|
+
for (const sample of samples) {
|
|
61
|
+
lines.push(`${name}${labels(sample.labels ?? {})} ${formatNumber(sample.value)}`);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
interface DurationStats {
|
|
66
|
+
buckets: number[];
|
|
67
|
+
sumSeconds: number;
|
|
68
|
+
count: number;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function emptyDurationStats(): DurationStats {
|
|
72
|
+
return { buckets: new Array(DURATION_BUCKETS_SECONDS.length).fill(0), sumSeconds: 0, count: 0 };
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** Собирает и рендерит снимок метрик. Чистая функция от состояния БД. */
|
|
76
|
+
export function renderPrometheusMetrics(): string {
|
|
77
|
+
const metrics = getAllMetrics(false);
|
|
78
|
+
const history = getHistory(null, 100000);
|
|
79
|
+
const queueDepth = countRunningRecords();
|
|
80
|
+
const historyRecords = countHistory();
|
|
81
|
+
|
|
82
|
+
const durations = new Map<string, DurationStats>();
|
|
83
|
+
for (const record of history) {
|
|
84
|
+
if (record.status === "running") continue;
|
|
85
|
+
const durationMs = Number(record.durationMs ?? 0);
|
|
86
|
+
if (!Number.isFinite(durationMs) || durationMs < 0) continue;
|
|
87
|
+
const task = record.taskName;
|
|
88
|
+
const stats = durations.get(task) ?? emptyDurationStats();
|
|
89
|
+
const seconds = durationMs / 1000;
|
|
90
|
+
stats.sumSeconds += seconds;
|
|
91
|
+
stats.count += 1;
|
|
92
|
+
for (let i = 0; i < DURATION_BUCKETS_SECONDS.length; i += 1) {
|
|
93
|
+
if (seconds <= DURATION_BUCKETS_SECONDS[i]) stats.buckets[i] += 1;
|
|
94
|
+
}
|
|
95
|
+
durations.set(task, stats);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
const lines: string[] = [];
|
|
99
|
+
|
|
100
|
+
metric(lines, "opencode_scheduler_info", "gauge", "Информация о планировщике.", [
|
|
101
|
+
{
|
|
102
|
+
labels: {
|
|
103
|
+
version: getPluginVersion(),
|
|
104
|
+
profile: getProfileName(),
|
|
105
|
+
scheduler: getSchedulerTitle(),
|
|
106
|
+
},
|
|
107
|
+
value: 1,
|
|
108
|
+
},
|
|
109
|
+
]);
|
|
110
|
+
metric(lines, "opencode_scheduler_up", "gauge", "1 — HTTP-сервер метрик доступен.", [
|
|
111
|
+
{ value: 1 },
|
|
112
|
+
]);
|
|
113
|
+
metric(
|
|
114
|
+
lines,
|
|
115
|
+
"opencode_scheduler_queue_depth",
|
|
116
|
+
"gauge",
|
|
117
|
+
"Количество незавершённых запусков (глубина очереди).",
|
|
118
|
+
[{ value: queueDepth }],
|
|
119
|
+
);
|
|
120
|
+
metric(
|
|
121
|
+
lines,
|
|
122
|
+
"opencode_scheduler_history_records",
|
|
123
|
+
"gauge",
|
|
124
|
+
"Количество записей в истории запусков.",
|
|
125
|
+
[{ value: historyRecords }],
|
|
126
|
+
);
|
|
127
|
+
|
|
128
|
+
const runSamples: { labels: Record<string, string | number>; value: number }[] = [];
|
|
129
|
+
const errorSamples: { labels: Record<string, string | number>; value: number }[] = [];
|
|
130
|
+
const tokenSamples: { labels: Record<string, string | number>; value: number }[] = [];
|
|
131
|
+
const costSamples: { labels: Record<string, string | number>; value: number }[] = [];
|
|
132
|
+
for (const row of metrics) {
|
|
133
|
+
runSamples.push({
|
|
134
|
+
labels: { task: row.taskName, status: "success" },
|
|
135
|
+
value: row.success,
|
|
136
|
+
});
|
|
137
|
+
runSamples.push({
|
|
138
|
+
labels: { task: row.taskName, status: "error" },
|
|
139
|
+
value: row.error,
|
|
140
|
+
});
|
|
141
|
+
runSamples.push({
|
|
142
|
+
labels: { task: row.taskName, status: "partial" },
|
|
143
|
+
value: row.partial,
|
|
144
|
+
});
|
|
145
|
+
errorSamples.push({ labels: { task: row.taskName }, value: row.error });
|
|
146
|
+
tokenSamples.push({ labels: { task: row.taskName }, value: row.tokens });
|
|
147
|
+
costSamples.push({ labels: { task: row.taskName }, value: row.costUsd });
|
|
148
|
+
}
|
|
149
|
+
metric(
|
|
150
|
+
lines,
|
|
151
|
+
"opencode_scheduler_runs_total",
|
|
152
|
+
"counter",
|
|
153
|
+
"Количество завершённых запусков по задачам и статусам.",
|
|
154
|
+
runSamples,
|
|
155
|
+
);
|
|
156
|
+
metric(
|
|
157
|
+
lines,
|
|
158
|
+
"opencode_scheduler_errors_total",
|
|
159
|
+
"counter",
|
|
160
|
+
"Количество ошибок и таймаутов по задачам (partial не входит).",
|
|
161
|
+
errorSamples,
|
|
162
|
+
);
|
|
163
|
+
metric(
|
|
164
|
+
lines,
|
|
165
|
+
"opencode_scheduler_tokens_total",
|
|
166
|
+
"counter",
|
|
167
|
+
"Суммарное количество токенов по задачам.",
|
|
168
|
+
tokenSamples,
|
|
169
|
+
);
|
|
170
|
+
metric(
|
|
171
|
+
lines,
|
|
172
|
+
"opencode_scheduler_cost_usd_total",
|
|
173
|
+
"counter",
|
|
174
|
+
"Суммарная стоимость запусков в USD по задачам.",
|
|
175
|
+
costSamples,
|
|
176
|
+
);
|
|
177
|
+
|
|
178
|
+
lines.push(
|
|
179
|
+
"# HELP opencode_scheduler_run_duration_seconds Длительность запусков в секундах.",
|
|
180
|
+
);
|
|
181
|
+
lines.push("# TYPE opencode_scheduler_run_duration_seconds histogram");
|
|
182
|
+
const taskNames = Array.from(durations.keys()).sort((a, b) => a.localeCompare(b));
|
|
183
|
+
for (const task of taskNames) {
|
|
184
|
+
const stats = durations.get(task)!;
|
|
185
|
+
let cumulative = 0;
|
|
186
|
+
for (let i = 0; i < DURATION_BUCKETS_SECONDS.length; i += 1) {
|
|
187
|
+
cumulative += stats.buckets[i];
|
|
188
|
+
lines.push(
|
|
189
|
+
`opencode_scheduler_run_duration_seconds_bucket${labels({
|
|
190
|
+
task,
|
|
191
|
+
le: DURATION_BUCKETS_SECONDS[i],
|
|
192
|
+
})} ${cumulative}`,
|
|
193
|
+
);
|
|
194
|
+
}
|
|
195
|
+
lines.push(
|
|
196
|
+
`opencode_scheduler_run_duration_seconds_bucket${labels({ task, le: "+Inf" })} ${stats.count}`,
|
|
197
|
+
);
|
|
198
|
+
lines.push(
|
|
199
|
+
`opencode_scheduler_run_duration_seconds_sum${labels({ task })} ${formatNumber(
|
|
200
|
+
stats.sumSeconds,
|
|
201
|
+
)}`,
|
|
202
|
+
);
|
|
203
|
+
lines.push(
|
|
204
|
+
`opencode_scheduler_run_duration_seconds_count${labels({ task })} ${stats.count}`,
|
|
205
|
+
);
|
|
206
|
+
}
|
|
207
|
+
if (taskNames.length === 0) {
|
|
208
|
+
// Пустой histogram всё равно должен быть валидным: отдаём +Inf = 0.
|
|
209
|
+
lines.push(`opencode_scheduler_run_duration_seconds_bucket${labels({ le: "+Inf" })} 0`);
|
|
210
|
+
lines.push("opencode_scheduler_run_duration_seconds_sum 0");
|
|
211
|
+
lines.push("opencode_scheduler_run_duration_seconds_count 0");
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
return `${lines.join("\n")}\n`;
|
|
215
|
+
}
|