opencode-windows-scheduler 1.3.0 → 1.4.0
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 +23 -1
- package/README.md +9 -3
- package/ROADMAP-STRATEGY.md +11 -11
- package/ROADMAP.md +2 -7
- package/dist/core/audit.d.ts +68 -0
- package/dist/core/audit.d.ts.map +1 -0
- package/dist/core/audit.js +206 -0
- package/dist/core/secrets.d.ts +57 -0
- package/dist/core/secrets.d.ts.map +1 -0
- package/dist/core/secrets.js +331 -0
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +9 -0
- package/dist/db/schema.d.ts +1 -1
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +15 -0
- package/dist/index.d.ts +24 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +342 -19
- package/dist/rpc.d.ts +400 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +146 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +67 -0
- package/dist/settings.d.ts +16 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +29 -0
- package/dist/workspaces.d.ts +8 -2
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +21 -4
- package/docs/ARCHITECTURE.md +13 -5
- package/docs/FEATURES.md +29 -1
- package/docs/README.ru.md +13 -3
- package/gui-experimental.cjs +4 -4
- package/package.json +4 -2
- package/src/core/audit.ts +291 -0
- package/src/core/secrets.ts +385 -0
- package/src/core/structured-log.ts +9 -0
- package/src/db/schema.ts +15 -0
- package/src/gui.tsx +323 -0
- package/src/index.ts +452 -19
- package/src/rpc.ts +157 -0
- package/src/server.ts +67 -0
- package/src/settings.ts +51 -0
- package/src/workspaces.ts +22 -4
package/dist/server.js
CHANGED
|
@@ -16,6 +16,7 @@ import { authenticateHookRequest, extractHookSignature, extractHookToken, readRe
|
|
|
16
16
|
import { appendStructuredLog, readStructuredLogs } from "./core/structured-log.js";
|
|
17
17
|
import { PROMETHEUS_CONTENT_TYPE, renderPrometheusMetrics } from "./core/prometheus.js";
|
|
18
18
|
import { buildOtlpExport } from "./core/otel.js";
|
|
19
|
+
import { readAuditLog, recordAudit } from "./core/audit.js";
|
|
19
20
|
/**
|
|
20
21
|
* Локальный веб-дашборд (Спринт 5).
|
|
21
22
|
* Встроенный модуль http из Node.js — без внешних зависимостей.
|
|
@@ -446,6 +447,7 @@ async function handleRequest(req, res, deps) {
|
|
|
446
447
|
pathname === "/api/history/export" ||
|
|
447
448
|
pathname === "/api/export-db" ||
|
|
448
449
|
pathname === "/api/workspaces" ||
|
|
450
|
+
pathname === "/api/audit" ||
|
|
449
451
|
pathname === "/api/health" ||
|
|
450
452
|
pathname === "/api/logs" ||
|
|
451
453
|
pathname === "/metrics" ||
|
|
@@ -711,6 +713,27 @@ async function handleRequest(req, res, deps) {
|
|
|
711
713
|
}
|
|
712
714
|
return;
|
|
713
715
|
}
|
|
716
|
+
// Журнал аудита (Спринт 26): GET /api/audit?action=…&actor=…&limit=…
|
|
717
|
+
if (req.method === "GET" && pathname === "/api/audit") {
|
|
718
|
+
try {
|
|
719
|
+
const limitRaw = Number(url.searchParams.get("limit"));
|
|
720
|
+
const result = readAuditLog({
|
|
721
|
+
action: url.searchParams.get("action") ?? undefined,
|
|
722
|
+
target: url.searchParams.get("target") ?? undefined,
|
|
723
|
+
actor: url.searchParams.get("actor") ?? undefined,
|
|
724
|
+
since: url.searchParams.get("since") ?? undefined,
|
|
725
|
+
until: url.searchParams.get("until") ?? undefined,
|
|
726
|
+
limit: Number.isFinite(limitRaw) ? limitRaw : undefined,
|
|
727
|
+
});
|
|
728
|
+
sendJson(res, 200, { success: true, ...result });
|
|
729
|
+
}
|
|
730
|
+
catch (err) {
|
|
731
|
+
sendJson(res, 500, {
|
|
732
|
+
error: err instanceof Error ? err.message : String(err),
|
|
733
|
+
});
|
|
734
|
+
}
|
|
735
|
+
return;
|
|
736
|
+
}
|
|
714
737
|
// Входящий webhook-триггер (Спринт 22): POST /api/hooks/:task?token=…
|
|
715
738
|
const hookMatch = req.method === "POST" && pathname.match(/^\/api\/hooks\/(.+)$/);
|
|
716
739
|
if (hookMatch) {
|
|
@@ -788,6 +811,15 @@ async function handleRequest(req, res, deps) {
|
|
|
788
811
|
? `Задача "${task.name}" уже выполняется.`
|
|
789
812
|
: `Задача "${task.name}" запущена по webhook.`;
|
|
790
813
|
logHook(202, "accepted", undefined, bodyResult.body.length);
|
|
814
|
+
recordAudit({
|
|
815
|
+
action: "task.run",
|
|
816
|
+
targetType: "task",
|
|
817
|
+
target: task.name,
|
|
818
|
+
actor: "http",
|
|
819
|
+
source: "POST /api/hooks/:name",
|
|
820
|
+
remote,
|
|
821
|
+
details: { trigger: "hook" },
|
|
822
|
+
});
|
|
791
823
|
sendJson(res, 202, {
|
|
792
824
|
success: true,
|
|
793
825
|
task: task.name,
|
|
@@ -812,6 +844,15 @@ async function handleRequest(req, res, deps) {
|
|
|
812
844
|
}
|
|
813
845
|
try {
|
|
814
846
|
const result = await deps.runTask(name);
|
|
847
|
+
recordAudit({
|
|
848
|
+
action: "task.run",
|
|
849
|
+
targetType: "task",
|
|
850
|
+
target: name,
|
|
851
|
+
actor: "http",
|
|
852
|
+
source: "POST /api/run/:name",
|
|
853
|
+
remote: req.socket.remoteAddress ?? null,
|
|
854
|
+
details: { alreadyRunning: Boolean(result?.alreadyRunning) },
|
|
855
|
+
});
|
|
815
856
|
sendJson(res, 200, {
|
|
816
857
|
success: true,
|
|
817
858
|
message: result?.alreadyRunning
|
|
@@ -841,6 +882,15 @@ async function handleRequest(req, res, deps) {
|
|
|
841
882
|
}
|
|
842
883
|
try {
|
|
843
884
|
const result = await deps.cancelMatrix(name);
|
|
885
|
+
recordAudit({
|
|
886
|
+
action: "matrix.cancel",
|
|
887
|
+
targetType: "matrix",
|
|
888
|
+
target: name,
|
|
889
|
+
actor: "http",
|
|
890
|
+
source: "POST /api/cancel-matrix/:name",
|
|
891
|
+
remote: req.socket.remoteAddress ?? null,
|
|
892
|
+
details: { cancelled: result.cancelled },
|
|
893
|
+
});
|
|
844
894
|
sendJson(res, 200, {
|
|
845
895
|
success: true,
|
|
846
896
|
message: result.message,
|
|
@@ -863,6 +913,15 @@ async function handleRequest(req, res, deps) {
|
|
|
863
913
|
}
|
|
864
914
|
try {
|
|
865
915
|
const removed = await deps.cleanupMatrixOrphans();
|
|
916
|
+
recordAudit({
|
|
917
|
+
action: "matrix.cleanup",
|
|
918
|
+
targetType: "matrix",
|
|
919
|
+
target: "orphans",
|
|
920
|
+
actor: "http",
|
|
921
|
+
source: "POST /api/matrix-cleanup",
|
|
922
|
+
remote: req.socket.remoteAddress ?? null,
|
|
923
|
+
details: { removed: removed.length },
|
|
924
|
+
});
|
|
866
925
|
sendJson(res, 200, {
|
|
867
926
|
success: true,
|
|
868
927
|
removed,
|
|
@@ -889,6 +948,14 @@ async function handleRequest(req, res, deps) {
|
|
|
889
948
|
}
|
|
890
949
|
try {
|
|
891
950
|
await deps.deleteTask(name);
|
|
951
|
+
recordAudit({
|
|
952
|
+
action: "task.delete",
|
|
953
|
+
targetType: "task",
|
|
954
|
+
target: name,
|
|
955
|
+
actor: "http",
|
|
956
|
+
source: "POST /api/delete/:name",
|
|
957
|
+
remote: req.socket.remoteAddress ?? null,
|
|
958
|
+
});
|
|
892
959
|
sendJson(res, 200, { success: true, message: `Задача "${name}" удалена.` });
|
|
893
960
|
}
|
|
894
961
|
catch (err) {
|
package/dist/settings.d.ts
CHANGED
|
@@ -159,6 +159,15 @@ export interface IntegrationSettings {
|
|
|
159
159
|
/** Входящие webhook-триггеры из CI/CD. */
|
|
160
160
|
hooks: HookSettings;
|
|
161
161
|
}
|
|
162
|
+
/** Настройки журнала аудита (Спринт 26). */
|
|
163
|
+
export interface AuditSettings {
|
|
164
|
+
/** Вести журнал мутаций. */
|
|
165
|
+
enabled: boolean;
|
|
166
|
+
/** Сколько дней хранить записи; 0 — без ограничения по времени. */
|
|
167
|
+
retentionDays: number;
|
|
168
|
+
/** Максимум записей; старые удаляются первыми. */
|
|
169
|
+
maxRecords: number;
|
|
170
|
+
}
|
|
162
171
|
/**
|
|
163
172
|
* Глобальные настройки плагина, которые меняются из GUI.
|
|
164
173
|
* Хранятся в settings.json рядом с tasks.json / history.json.
|
|
@@ -174,6 +183,8 @@ export interface SchedulerSettings {
|
|
|
174
183
|
history: HistorySettings;
|
|
175
184
|
/** Внешние интеграции: входящие webhook-триггеры. */
|
|
176
185
|
integrations: IntegrationSettings;
|
|
186
|
+
/** Журнал аудита мутаций (Спринт 26). */
|
|
187
|
+
audit: AuditSettings;
|
|
177
188
|
}
|
|
178
189
|
export declare const SETTINGS_FILE: string;
|
|
179
190
|
export declare const DEFAULT_MAX_CONCURRENT = 1;
|
|
@@ -188,6 +199,11 @@ export declare const DEFAULT_STUCK_AFTER_MINUTES = 60;
|
|
|
188
199
|
/** Входящие хуки (Спринт 22): тело до 256 KiB, timestamp ±5 минут. */
|
|
189
200
|
export declare const DEFAULT_HOOK_MAX_BODY_BYTES: number;
|
|
190
201
|
export declare const DEFAULT_HOOK_TIMESTAMP_TOLERANCE_SECONDS = 300;
|
|
202
|
+
/** Аудит (Спринт 26): включён, 90 дней и не больше 10 000 записей. */
|
|
203
|
+
export declare const DEFAULT_AUDIT_RETENTION_DAYS = 90;
|
|
204
|
+
export declare const DEFAULT_AUDIT_MAX_RECORDS = 10000;
|
|
205
|
+
/** Значения аудита по умолчанию. */
|
|
206
|
+
export declare function defaultAuditSettings(): AuditSettings;
|
|
191
207
|
/** Значения интеграций по умолчанию: хуки выключены, подпись обязательна. */
|
|
192
208
|
export declare function defaultIntegrations(): IntegrationSettings;
|
|
193
209
|
/** Генерирует криптостойкие учётные данные для входящего хука. */
|
package/dist/settings.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAKA,6DAA6D;AAC7D,MAAM,WAAW,2BAA2B;IAC1C,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,0BAA0B;IACzC,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,SAAS,EAAE,eAAe,CAAC;IAC3B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG,EAAE,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAExE,8CAA8C;AAC9C,MAAM,WAAW,4BAA4B;IAC3C,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,iBAAiB,CAAC;IAC7B,4BAA4B;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qEAAqE;IACrE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6CAA6C;IAC7C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,0BAA0B;IACzC,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IACxC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,kBAAkB;IAClB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,oBAAoB,CAAC;IACpC,gCAAgC;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,qDAAqD;IACrD,YAAY,EAAE,mBAAmB,CAAC;IAClC,yCAAyC;IACzC,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,QAAyC,CAAC;AACpE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AACpD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,QAAa,CAAC;AACtD,eAAO,MAAM,wCAAwC,MAAM,CAAC;AAI5D,sEAAsE;AACtE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,oCAAoC;AACpC,wBAAgB,oBAAoB,IAAI,aAAa,CAMpD;AAqBD,6EAA6E;AAC7E,wBAAgB,mBAAmB,IAAI,mBAAmB,CAWzD;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAK3E;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAkCD,uEAAuE;AACvE,wBAAgB,oBAAoB,IAAI,oBAAoB,CAiD3D;AAgTD,0EAA0E;AAC1E,wBAAsB,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAsC/D;AAED,iEAAiE;AACjE,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA0C5B"}
|
package/dist/settings.js
CHANGED
|
@@ -17,6 +17,29 @@ export const DEFAULT_HOOK_MAX_BODY_BYTES = 256 * 1024;
|
|
|
17
17
|
export const DEFAULT_HOOK_TIMESTAMP_TOLERANCE_SECONDS = 300;
|
|
18
18
|
const MAX_HOOK_BODY_BYTES = 5 * 1024 * 1024;
|
|
19
19
|
const MAX_HOOK_CREDENTIAL_LENGTH = 512;
|
|
20
|
+
/** Аудит (Спринт 26): включён, 90 дней и не больше 10 000 записей. */
|
|
21
|
+
export const DEFAULT_AUDIT_RETENTION_DAYS = 90;
|
|
22
|
+
export const DEFAULT_AUDIT_MAX_RECORDS = 10000;
|
|
23
|
+
/** Значения аудита по умолчанию. */
|
|
24
|
+
export function defaultAuditSettings() {
|
|
25
|
+
return {
|
|
26
|
+
enabled: true,
|
|
27
|
+
retentionDays: DEFAULT_AUDIT_RETENTION_DAYS,
|
|
28
|
+
maxRecords: DEFAULT_AUDIT_MAX_RECORDS,
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
/** Приводит настройки аудита к безопасному виду. */
|
|
32
|
+
function normalizeAuditSettings(value, fallback) {
|
|
33
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) {
|
|
34
|
+
return { ...fallback };
|
|
35
|
+
}
|
|
36
|
+
const raw = value;
|
|
37
|
+
return {
|
|
38
|
+
enabled: typeof raw.enabled === "boolean" ? raw.enabled : fallback.enabled,
|
|
39
|
+
retentionDays: normalizeRetentionLimit(raw.retentionDays, fallback.retentionDays),
|
|
40
|
+
maxRecords: normalizeRetentionLimit(raw.maxRecords, fallback.maxRecords),
|
|
41
|
+
};
|
|
42
|
+
}
|
|
20
43
|
/** Значения интеграций по умолчанию: хуки выключены, подпись обязательна. */
|
|
21
44
|
export function defaultIntegrations() {
|
|
22
45
|
return {
|
|
@@ -352,6 +375,7 @@ export async function loadSettings() {
|
|
|
352
375
|
const fallbackNotifications = defaultNotifications();
|
|
353
376
|
const fallbackHistory = defaultHistorySettings();
|
|
354
377
|
const fallbackIntegrations = defaultIntegrations();
|
|
378
|
+
const fallbackAudit = defaultAuditSettings();
|
|
355
379
|
try {
|
|
356
380
|
const raw = await fs.readFile(SETTINGS_FILE, "utf8");
|
|
357
381
|
const parsed = JSON.parse(raw);
|
|
@@ -361,6 +385,7 @@ export async function loadSettings() {
|
|
|
361
385
|
notifications: normalizeNotifications(parsed?.notifications, fallbackNotifications),
|
|
362
386
|
history: normalizeHistorySettings(parsed?.history, fallbackHistory),
|
|
363
387
|
integrations: normalizeIntegrations(parsed?.integrations, fallbackIntegrations),
|
|
388
|
+
audit: normalizeAuditSettings(parsed?.audit, fallbackAudit),
|
|
364
389
|
};
|
|
365
390
|
}
|
|
366
391
|
catch {
|
|
@@ -370,6 +395,7 @@ export async function loadSettings() {
|
|
|
370
395
|
notifications: fallbackNotifications,
|
|
371
396
|
history: fallbackHistory,
|
|
372
397
|
integrations: fallbackIntegrations,
|
|
398
|
+
audit: fallbackAudit,
|
|
373
399
|
};
|
|
374
400
|
}
|
|
375
401
|
}
|
|
@@ -392,6 +418,9 @@ export async function saveSettings(patch) {
|
|
|
392
418
|
integrations: patch.integrations !== undefined
|
|
393
419
|
? normalizeIntegrations(patch.integrations, current.integrations)
|
|
394
420
|
: current.integrations,
|
|
421
|
+
audit: patch.audit !== undefined
|
|
422
|
+
? normalizeAuditSettings(patch.audit, current.audit)
|
|
423
|
+
: current.audit,
|
|
395
424
|
};
|
|
396
425
|
// Удобство: при включении хуков без явных учётных данных генерируем их,
|
|
397
426
|
// чтобы функция сразу работала, а секреты не приходилось придумывать вручную.
|
package/dist/workspaces.d.ts
CHANGED
|
@@ -50,12 +50,18 @@ export declare function parseEnvFileContent(content: string): Record<string, str
|
|
|
50
50
|
export declare function readWorkspaceEnvFile(envFile?: string): Record<string, string>;
|
|
51
51
|
/**
|
|
52
52
|
* Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
|
|
53
|
-
* (пары важнее файла).
|
|
53
|
+
* (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
|
|
54
|
+
* зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
|
|
55
|
+
* строку и предупреждение с именем — без значения. Никогда не бросает.
|
|
54
56
|
*/
|
|
55
57
|
export declare function resolveWorkspaceEnv(workspace: Workspace | undefined): Record<string, string>;
|
|
56
58
|
/** Маскирует значение секрета для логов. */
|
|
57
59
|
export declare function maskSecretValue(): string;
|
|
58
|
-
/**
|
|
60
|
+
/**
|
|
61
|
+
* Копия env для логов: значения «секретных» ключей заменены на ***.
|
|
62
|
+
* Чистые ссылки `${secret:NAME}` сохраняются как есть — это не секрет,
|
|
63
|
+
* а указатель, и он помогает диагностике (Спринт 26).
|
|
64
|
+
*/
|
|
59
65
|
export declare function maskEnvForLog(env: Record<string, string> | undefined): Record<string, string>;
|
|
60
66
|
/**
|
|
61
67
|
* Каталог env-файлов задач внутри каталога плагина (по одному файлу на задачу).
|
package/dist/workspaces.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"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"}
|
package/dist/workspaces.js
CHANGED
|
@@ -4,6 +4,7 @@ import { basename, join, resolve } from "node:path";
|
|
|
4
4
|
import { spawnSync } from "node:child_process";
|
|
5
5
|
import { getDb } from "./db/index.js";
|
|
6
6
|
import { clearWorkspaceAssignments } from "./db/tasks-repo.js";
|
|
7
|
+
import { hasSecretRef, resolveSecretRefs } from "./core/secrets.js";
|
|
7
8
|
/** Максимум пар env на workspace — защита от раздувания строки JSON. */
|
|
8
9
|
export const MAX_WORKSPACE_ENV_PAIRS = 100;
|
|
9
10
|
/** Палитра цветных маркеров для GUI/дашборда. */
|
|
@@ -88,28 +89,44 @@ export function readWorkspaceEnvFile(envFile) {
|
|
|
88
89
|
}
|
|
89
90
|
/**
|
|
90
91
|
* Итоговые env-переменные workspace: сначала .env-файл, затем явные пары
|
|
91
|
-
* (пары важнее файла).
|
|
92
|
+
* (пары важнее файла). Ссылки `${secret:NAME}` разворачиваются из
|
|
93
|
+
* зашифрованного хранилища (Спринт 26); отсутствующий секрет даёт пустую
|
|
94
|
+
* строку и предупреждение с именем — без значения. Никогда не бросает.
|
|
92
95
|
*/
|
|
93
96
|
export function resolveWorkspaceEnv(workspace) {
|
|
94
97
|
if (!workspace)
|
|
95
98
|
return {};
|
|
96
|
-
|
|
99
|
+
const merged = {
|
|
97
100
|
...readWorkspaceEnvFile(workspace.envFile),
|
|
98
101
|
...(workspace.env ?? {}),
|
|
99
102
|
};
|
|
103
|
+
const resolved = resolveSecretRefs(merged);
|
|
104
|
+
if (resolved.missing.length > 0) {
|
|
105
|
+
console.warn(`[workspace] "${workspace.name}": не найдены секреты: ${resolved.missing.join(", ")}`);
|
|
106
|
+
}
|
|
107
|
+
return resolved.env;
|
|
100
108
|
}
|
|
101
109
|
/** Маскирует значение секрета для логов. */
|
|
102
110
|
export function maskSecretValue() {
|
|
103
111
|
return "***";
|
|
104
112
|
}
|
|
105
113
|
const SECRET_KEY_RE = /(TOKEN|SECRET|PASS|PASSWORD|KEY|CREDENTIAL|AUTH)/i;
|
|
106
|
-
/**
|
|
114
|
+
/**
|
|
115
|
+
* Копия env для логов: значения «секретных» ключей заменены на ***.
|
|
116
|
+
* Чистые ссылки `${secret:NAME}` сохраняются как есть — это не секрет,
|
|
117
|
+
* а указатель, и он помогает диагностике (Спринт 26).
|
|
118
|
+
*/
|
|
107
119
|
export function maskEnvForLog(env) {
|
|
108
120
|
if (!env)
|
|
109
121
|
return {};
|
|
110
122
|
const masked = {};
|
|
111
123
|
for (const [key, value] of Object.entries(env)) {
|
|
112
|
-
|
|
124
|
+
if (hasSecretRef(value)) {
|
|
125
|
+
masked[key] = String(value);
|
|
126
|
+
}
|
|
127
|
+
else {
|
|
128
|
+
masked[key] = SECRET_KEY_RE.test(key) ? maskSecretValue() : value;
|
|
129
|
+
}
|
|
113
130
|
}
|
|
114
131
|
return masked;
|
|
115
132
|
}
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -120,7 +120,7 @@ from their clones instead of their own last run.
|
|
|
120
120
|
|
|
121
121
|
| Path | Role |
|
|
122
122
|
| --- | --- |
|
|
123
|
-
| `src/index.ts` | Plugin lifecycle,
|
|
123
|
+
| `src/index.ts` | Plugin lifecycle, 24 agent tools, RPC handlers, task CRUD, view assembly |
|
|
124
124
|
| `src/rpc.ts` | JSON-schema contracts for every RPC method |
|
|
125
125
|
| `src/gui.tsx` | OpenCode sidebar panel (SolidJS, built to `gui-experimental.cjs`) |
|
|
126
126
|
| `src/server.ts` | Local web dashboard HTTP server and HTML rendering |
|
|
@@ -129,10 +129,12 @@ from their clones instead of their own last run.
|
|
|
129
129
|
| `src/profiles.ts` | Profile directory resolution: per-profile plugin dir (base for `default`, `<base>/profiles/<name>` for named profiles); profile name, marker, port, create/delete/switch |
|
|
130
130
|
| `src/workspaces.ts` | Workspace registry and path validation; env pairs and `.env` file resolution with secret masking |
|
|
131
131
|
| `src/templates.ts` | Reusable task templates |
|
|
132
|
-
| `src/settings.ts` | Plugin settings: notifications
|
|
132
|
+
| `src/settings.ts` | Plugin settings: notifications, history retention, audit |
|
|
133
133
|
| `src/notifications.ts` | Multi-channel delivery (webhook, Telegram, native OS) with retries/backoff, templates, task filters, quiet hours, matrix and stuck-clone notifications, daily/weekly digest |
|
|
134
134
|
| `src/core/telegram.ts` | Telegram Bot API `sendMessage`: parse-mode escaping, dashboard link, token validation and masking |
|
|
135
135
|
| `src/core/native-notify.ts` | Native OS notifications: Windows Toast (PowerShell/WinRT), macOS `osascript`, Linux `notify-send`; no external dependency |
|
|
136
|
+
| `src/core/secrets.ts` | Encrypted secret store (AES-256-GCM, `secrets.key` 0600, `${secret:NAME}` refs, redaction) |
|
|
137
|
+
| `src/core/audit.ts` | SQLite audit journal (`audit_log`), redacted details, retention cleanup |
|
|
136
138
|
| `src/history.ts` | History model and status types |
|
|
137
139
|
| `src/version.ts` | Runtime plugin version (reads package.json) |
|
|
138
140
|
| `src/core/retention.ts` | Daily history prune and incremental vacuum |
|
|
@@ -306,7 +308,7 @@ never requires a manual migration.
|
|
|
306
308
|
|
|
307
309
|
| Interface | Audience | Entry point |
|
|
308
310
|
| --- | --- | --- |
|
|
309
|
-
| Agent tools | AI agent |
|
|
311
|
+
| Agent tools | AI agent | 24 tools registered via `ctx.tool.transform` |
|
|
310
312
|
| Agent skill | AI agent | `skills/scheduled-job-best-practices` |
|
|
311
313
|
| RPC | Sidebar GUI | `src/rpc.ts` contracts, ~30 methods |
|
|
312
314
|
| Sidebar GUI | Human | `gui-experimental.cjs` |
|
|
@@ -320,8 +322,14 @@ never requires a manual migration.
|
|
|
320
322
|
- `allowedTools` / `deniedTools` are **metadata passed to the run**, not a sandbox.
|
|
321
323
|
They are recorded in history for audit, but they do not constrain `opencode` at the
|
|
322
324
|
OS level.
|
|
323
|
-
-
|
|
324
|
-
|
|
325
|
+
- Task prompts, hooks and Quality Gate scripts are **plain text** executed with your
|
|
326
|
+
user privileges; only secrets (in `secrets.json`, AES-256-GCM) are encrypted.
|
|
327
|
+
Workspace `env` can reference secrets as `${secret:NAME}`; values are masked in
|
|
328
|
+
logs, history and audit. Treat task creation like granting shell access.
|
|
329
|
+
- Secrets are stored encrypted in `<PLUGIN_DIR>/secrets.json` (AES-256-GCM) with a
|
|
330
|
+
32-byte key file `secrets.key` (rights 0600). Workspace `env` can reference them
|
|
331
|
+
as `${secret:NAME}`; values are substituted at run time and masked in logs,
|
|
332
|
+
history and audit.
|
|
325
333
|
- Workspace paths are validated, but hooks are not sandboxed: only schedule jobs from
|
|
326
334
|
repositories you trust.
|
|
327
335
|
|
package/docs/FEATURES.md
CHANGED
|
@@ -436,6 +436,33 @@ and native OS notifications — configurable in settings and testable with
|
|
|
436
436
|
and reports per-channel success/failure. Failures in one channel never block the
|
|
437
437
|
others and never throw into the task run.
|
|
438
438
|
|
|
439
|
+
### Secrets (Спринт 26)
|
|
440
|
+
|
|
441
|
+
Encrypted secret storage in `<PLUGIN_DIR>/secrets.json` with AES-256-GCM and a
|
|
442
|
+
32-byte key file `secrets.key` (rights 0600). The `manage_secrets` tool (and the
|
|
443
|
+
«🔐 Секреты» GUI panel) supports `list`, `set` and `delete`. Secret names match
|
|
444
|
+
`[A-Za-z0-9_.-]` and are up to 64 characters; list shows only name, masked preview
|
|
445
|
+
(`••••` + last 4 chars) and update time — never the value.
|
|
446
|
+
|
|
447
|
+
In task workspace `env`, reference a secret as `${secret:NAME}`. The value is
|
|
448
|
+
substituted at run time (missing secrets resolve to an empty string with a
|
|
449
|
+
name-only warning). Secret references survive masking — they are shown verbatim in
|
|
450
|
+
the GUI env editor — while literal secret-like values (`TOKEN=`, `PASSWORD=`, …)
|
|
451
|
+
are masked as `***` in logs, structured logs, history and audit.
|
|
452
|
+
|
|
453
|
+
### Audit log (Спринт 26)
|
|
454
|
+
|
|
455
|
+
Every mutation — task create/update/delete/run, settings, templates, profiles,
|
|
456
|
+
workspaces, secrets, import, history cleanup — is recorded in an `audit_log`
|
|
457
|
+
table in SQLite with action, target type/target, actor (`mcp`/`gui`/`http`),
|
|
458
|
+
source, redacted details and remote address. Indexes on `ts` and `action`;
|
|
459
|
+
retention defaults to 90 days / 10 000 records with automatic cleanup.
|
|
460
|
+
|
|
461
|
+
The `get_audit_log` tool (and the «📜 Журнал аудита» GUI panel) reads the journal
|
|
462
|
+
with filters by `action`, `target`, `actor`, `since`/`until` and `limit`. Also
|
|
463
|
+
available as RPC `get_audit` and HTTP `GET /api/audit`. Secret values in details
|
|
464
|
+
are redacted; `${secret:NAME}` references are preserved verbatim.
|
|
465
|
+
|
|
439
466
|
### Crash recovery
|
|
440
467
|
|
|
441
468
|
Runs left in `running` after a crash are marked `error` on the next plugin start, so
|
|
@@ -453,11 +480,12 @@ the `cleanup_history` RPC and the GUI's «Очистить сейчас» button
|
|
|
453
480
|
|
|
454
481
|
## Agent interface
|
|
455
482
|
|
|
456
|
-
Twenty-
|
|
483
|
+
Twenty-four tools: `schedule_task`, `list_tasks`, `update_task`, `delete_task`,
|
|
457
484
|
`run_task_now`, `pause_task`, `resume_task`, `get_history`, `get_task_logs`, `dry_run`,
|
|
458
485
|
`manage_workspaces`, `matrix_control` (results/cancel/cleanup/preview), `get_metrics`,
|
|
459
486
|
`get_analytics`, `manage_settings`, `manage_templates`, `manage_profiles`,
|
|
460
487
|
`transfer_tasks`, `send_notification`, `get_dashboard_info`, `cleanup_history`,
|
|
488
|
+
`manage_secrets`, `get_audit_log`,
|
|
461
489
|
`emit_event`.
|
|
462
490
|
|
|
463
491
|
A bundled skill, `scheduled-job-best-practices`, teaches the agent safe defaults:
|
package/docs/README.ru.md
CHANGED
|
@@ -38,8 +38,8 @@ English version: [README.md](../README.md).
|
|
|
38
38
|
| Триггеры | cron, одноразовый запуск (`triggerType: "once"`), изменение файла (chokidar), MCP-события, входящие webhooks (`POST /api/hooks/:task` с HMAC) |
|
|
39
39
|
| Мультирепо | workspaces с валидацией путей, запуски по workspace, матрица поверх родительской задачи |
|
|
40
40
|
| Наблюдаемость | история SQLite (success / error / timeout / partial / running), метрики (длительность, токены, стоимость), JSONL-логи с `/api/logs`, Prometheus `/metrics`, экспорт OTLP, логи по задачам, веб-дашборд с аналитикой за 14 дней, ретеншн истории и экспорт CSV/JSON |
|
|
41
|
-
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, уведомления по нескольким каналам (webhook, Telegram, нативные toast), тихие часы, дайджест, настройки |
|
|
42
|
-
| Интерфейсы | панель OpenCode GUI, веб-дашборд,
|
|
41
|
+
| Эксплуатация | dry-run, экспорт/импорт JSON, шаблоны, уведомления по нескольким каналам (webhook, Telegram, нативные toast), тихие часы, дайджест, зашифрованные секреты (`${secret:NAME}`), журнал аудита, настройки |
|
|
42
|
+
| Интерфейсы | панель OpenCode GUI, веб-дашборд, 24 инструмента для агента, встроенный скилл |
|
|
43
43
|
|
|
44
44
|
## Установка
|
|
45
45
|
|
|
@@ -80,7 +80,7 @@ npm run build && npm run build:gui
|
|
|
80
80
|
|
|
81
81
|
## Инструменты для агента
|
|
82
82
|
|
|
83
|
-
Агенту доступен весь функционал —
|
|
83
|
+
Агенту доступен весь функционал — 24 инструмента: расписание, пайплайны, эксплуатация, аналитика и администрирование.
|
|
84
84
|
|
|
85
85
|
| Инструмент | Аргументы | Что делает |
|
|
86
86
|
|---|---|---|
|
|
@@ -158,6 +158,10 @@ src/
|
|
|
158
158
|
dry-run.ts симуляция пайплайна
|
|
159
159
|
lock.ts защита от наложения запусков
|
|
160
160
|
file-watcher.ts триггеры chokidar
|
|
161
|
+
telegram.ts доставка в Telegram Bot API
|
|
162
|
+
native-notify.ts нативные уведомления (Windows/macOS/Linux)
|
|
163
|
+
secrets.ts зашифрованное хранилище секретов (AES-256-GCM)
|
|
164
|
+
audit.ts журнал аудита (audit_log в SQLite)
|
|
161
165
|
db/ SQLite: задачи, история, метрики, настройки
|
|
162
166
|
task-transfer.ts экспорт / импорт / валидация
|
|
163
167
|
```
|
|
@@ -201,6 +205,12 @@ Windows (Планировщик Windows), macOS (launchd) и Linux (crontab). Р
|
|
|
201
205
|
**Можно ли отключить уведомления на ночь?**
|
|
202
206
|
Да. Задайте `notifications.quietHours` (`enabled`, `from`, `to` в `HH:MM`). В этом окне успешные и `partial` запуски не отправляются, а ошибки и таймауты приходят всегда.
|
|
203
207
|
|
|
208
|
+
**Как хранить секреты?**
|
|
209
|
+
Используйте `manage_secrets` (или панель «🔐 Секреты» в сайдбаре). Секреты хранятся в `<PLUGIN_DIR>/secrets.json` с шифрованием AES-256-GCM и ключевым файлом `secrets.key` (права 0600). В `env` задачи секрет ссылается как `${secret:NAME}` — значение подставляется при запуске и маскируется в логах, истории и аудите.
|
|
210
|
+
|
|
211
|
+
**Можно ли посмотреть, кто что изменил?**
|
|
212
|
+
Да. Журнал аудита (`get_audit_log`, панель «📜 Журнал аудита», `GET /api/audit`) записывает каждую мутацию — создание/изменение/удаление/запуск задачи, настройки, шаблоны, профили, workspace, секреты, импорт, очистку истории — с aktёром (mcp/gui/http), источником, временной меткой и замаскированными деталями. Ретеншн по умолчанию 90 дней / 10 000 записей.
|
|
213
|
+
|
|
204
214
|
**Чем это отличается от `experimental.schedules` в OpenCode?**
|
|
205
215
|
Встроенный планировщик выполняет задачи, пока OpenCode запущен. Этот плагин использует нативный планировщик ОС и добавляет DAG-пайплайны, матричные сборки, Quality Gates, webhooks и наблюдаемость.
|
|
206
216
|
|