agent-steward 0.0.5 → 0.0.6
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 +176 -1
- package/README.md +9 -7
- package/ROADMAP-STRATEGY.md +5 -5
- package/ROADMAP.md +107 -17
- package/dist/cli.js +5 -0
- package/dist/core/analytics.d.ts +6 -0
- package/dist/core/analytics.d.ts.map +1 -1
- package/dist/core/analytics.js +20 -3
- package/dist/core/audit.d.ts +6 -0
- package/dist/core/audit.d.ts.map +1 -1
- package/dist/core/audit.js +24 -0
- package/dist/core/budget.d.ts +118 -0
- package/dist/core/budget.d.ts.map +1 -0
- package/dist/core/budget.js +206 -0
- package/dist/core/cron-to-schtasks.d.ts.map +1 -1
- package/dist/core/cron-to-schtasks.js +38 -0
- package/dist/core/dry-run.d.ts +26 -1
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +199 -8
- package/dist/core/feedback.d.ts +192 -0
- package/dist/core/feedback.d.ts.map +1 -0
- package/dist/core/feedback.js +426 -0
- package/dist/core/gate-integrity.d.ts +36 -0
- package/dist/core/gate-integrity.d.ts.map +1 -1
- package/dist/core/gate-integrity.js +144 -1
- package/dist/core/local-ai.d.ts.map +1 -1
- package/dist/core/local-ai.js +7 -3
- package/dist/core/matrix.d.ts +8 -0
- package/dist/core/matrix.d.ts.map +1 -1
- package/dist/core/matrix.js +57 -2
- package/dist/core/mission.d.ts +20 -0
- package/dist/core/mission.d.ts.map +1 -1
- package/dist/core/mission.js +45 -5
- package/dist/core/opencode-models.d.ts +2 -2
- package/dist/core/opencode-models.d.ts.map +1 -1
- package/dist/core/opencode-models.js +28 -21
- package/dist/core/opencode-usage.d.ts +35 -0
- package/dist/core/opencode-usage.d.ts.map +1 -0
- package/dist/core/opencode-usage.js +132 -0
- package/dist/core/pipeline-io.d.ts +1 -1
- package/dist/core/pipeline-io.d.ts.map +1 -1
- package/dist/core/pipeline-io.js +26 -12
- package/dist/core/pipeline-map.d.ts +6 -0
- package/dist/core/pipeline-map.d.ts.map +1 -1
- package/dist/core/pipeline-map.js +12 -0
- package/dist/core/ps-wrapper.d.ts +10 -2
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +176 -5
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +76 -4
- package/dist/core/run-mode.d.ts +12 -0
- package/dist/core/run-mode.d.ts.map +1 -0
- package/dist/core/run-mode.js +17 -0
- package/dist/core/scheduler/logs.d.ts +4 -0
- package/dist/core/scheduler/logs.d.ts.map +1 -1
- package/dist/core/scheduler/logs.js +25 -1
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +18 -8
- package/dist/core/self-analysis.d.ts +32 -2
- package/dist/core/self-analysis.d.ts.map +1 -1
- package/dist/core/self-analysis.js +38 -27
- package/dist/core/shutdown.d.ts +33 -2
- package/dist/core/shutdown.d.ts.map +1 -1
- package/dist/core/shutdown.js +58 -2
- package/dist/core/structured-log.d.ts +30 -0
- package/dist/core/structured-log.d.ts.map +1 -1
- package/dist/core/structured-log.js +37 -0
- package/dist/core/usage-surface.d.ts +25 -0
- package/dist/core/usage-surface.d.ts.map +1 -0
- package/dist/core/usage-surface.js +41 -0
- package/dist/core/wrappers/bash.d.ts +2 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +58 -6
- package/dist/db/history-repo.d.ts +32 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +85 -7
- package/dist/db/metrics-repo.d.ts +20 -2
- package/dist/db/metrics-repo.d.ts.map +1 -1
- package/dist/db/metrics-repo.js +33 -11
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +37 -17
- package/dist/db/recovery.d.ts +3 -1
- package/dist/db/recovery.d.ts.map +1 -1
- package/dist/db/recovery.js +9 -4
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +71 -56
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +70 -1
- package/dist/db/templates-repo.d.ts +2 -2
- package/dist/db/templates-repo.d.ts.map +1 -1
- package/dist/db/templates-repo.js +5 -3
- package/dist/history.d.ts +6 -1
- package/dist/history.d.ts.map +1 -1
- package/dist/history.js +4 -2
- package/dist/hook-output.d.ts +2 -0
- package/dist/hook-output.d.ts.map +1 -0
- package/dist/hook-output.js +31 -0
- package/dist/index.d.ts +247 -53
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +999 -211
- package/dist/notifications.d.ts +31 -2
- package/dist/notifications.d.ts.map +1 -1
- package/dist/notifications.js +132 -13
- package/dist/profiles.d.ts.map +1 -1
- package/dist/profiles.js +66 -15
- package/dist/rpc.d.ts +108 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +28 -0
- package/dist/server.d.ts +17 -2
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +77 -12
- package/dist/settings.d.ts +42 -0
- package/dist/settings.d.ts.map +1 -1
- package/dist/settings.js +82 -0
- package/dist/task-transfer.d.ts +5 -0
- package/dist/task-transfer.d.ts.map +1 -1
- package/dist/task-transfer.js +48 -3
- package/dist/templates.d.ts +2 -2
- package/dist/templates.d.ts.map +1 -1
- package/dist/templates.js +3 -3
- package/dist/types.d.ts +22 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +34 -11
- package/docs/ARCHITECTURE.md +49 -12
- package/docs/COMPATIBILITY.md +2 -2
- package/docs/EXECUTION-LOOP.md +6 -3
- package/docs/FEATURES.md +65 -4
- package/docs/FEATURES.zh.md +45 -2
- package/docs/QA-A2-GUI-TUI.md +205 -0
- package/docs/README.ru.md +3 -3
- package/docs/README.zh.md +2 -2
- package/gui-experimental.cjs +9 -9
- package/locales/en.json +42 -3
- package/locales/ru.json +42 -3
- package/locales/zh.json +42 -3
- package/package.json +15 -2
- package/scripts/check-eslint-baseline.mjs +139 -0
- package/scripts/gen-test-plan-counters.mjs +117 -0
- package/scripts/github-ci-fetch.ps1 +37 -0
- package/scripts/pl-commit.ps1 +112 -0
- package/scripts/qa-a2-commit.ps1 +104 -0
- package/scripts/test-home.mjs +26 -2
- package/skills/scheduled-job-best-practices/SKILL.md +95 -1
- package/skills/scheduled-job-best-practices/references/recipes.md +139 -0
- package/src/cli.ts +5 -0
- package/src/core/analytics.ts +27 -4
- package/src/core/audit.ts +25 -0
- package/src/core/budget.ts +340 -0
- package/src/core/cron-to-schtasks.ts +42 -0
- package/src/core/dry-run.ts +233 -10
- package/src/core/feedback.ts +582 -0
- package/src/core/gate-integrity.ts +171 -1
- package/src/core/local-ai.ts +7 -3
- package/src/core/matrix.ts +63 -2
- package/src/core/mission.ts +51 -5
- package/src/core/opencode-models.ts +30 -21
- package/src/core/opencode-usage.ts +182 -0
- package/src/core/pipeline-io.ts +28 -11
- package/src/core/pipeline-map.ts +19 -0
- package/src/core/ps-wrapper.ts +173 -4
- package/src/core/record-history.ts +94 -4
- package/src/core/run-mode.ts +19 -0
- package/src/core/scheduler/logs.ts +32 -1
- package/src/core/secrets.ts +18 -11
- package/src/core/self-analysis.ts +75 -29
- package/src/core/shutdown.ts +90 -4
- package/src/core/structured-log.ts +67 -0
- package/src/core/usage-surface.ts +70 -0
- package/src/core/wrappers/bash.ts +60 -5
- package/src/db/history-repo.ts +153 -19
- package/src/db/metrics-repo.ts +38 -11
- package/src/db/migrate.ts +57 -32
- package/src/db/recovery.ts +10 -4
- package/src/db/runs-repo.ts +113 -61
- package/src/db/schema.ts +70 -1
- package/src/db/templates-repo.ts +5 -3
- package/src/gui.tsx +261 -5
- package/src/history.ts +10 -3
- package/src/hook-output.ts +39 -0
- package/src/index.ts +1407 -345
- package/src/notifications.ts +189 -39
- package/src/profiles.ts +72 -16
- package/src/rpc.ts +30 -0
- package/src/server.ts +107 -23
- package/src/settings.ts +120 -0
- package/src/task-transfer.ts +59 -6
- package/src/templates.ts +3 -3
- package/src/types.ts +23 -2
- package/src/workspaces.ts +37 -14
|
@@ -11,13 +11,38 @@ export interface HealthScore {
|
|
|
11
11
|
score: number;
|
|
12
12
|
/** Описание уровня здоровья. */
|
|
13
13
|
level: "excellent" | "good" | "fair" | "poor" | "critical";
|
|
14
|
-
/**
|
|
14
|
+
/**
|
|
15
|
+
* Детальные метрики, из которых сложился балл.
|
|
16
|
+
*
|
|
17
|
+
* ВАЖНО (QA 2026-11-19, roadmap-qa-01; уточнено QA-P1.4): successRate/errorRate —
|
|
18
|
+
* это НОРМАЛИЗОВАННЫЕ БАЛЛЫ 0..100 (чем выше, тем лучше; обратная совместимость
|
|
19
|
+
* с self_analysis tool), а avgDurationMs/timeoutRate/crashRecoveryRate —
|
|
20
|
+
* РЕАЛЬНЫЕ значения из отчёта (мс и доли 0..1), ранее сюда ошибочно писались
|
|
21
|
+
* score-значения, из-за чего avgDurationMs показывал 66 вместо 101597.
|
|
22
|
+
*
|
|
23
|
+
* QA-P1.4: `errorRate` — НЕ доля ошибок, а инвертированный балл
|
|
24
|
+
* `100 - 100 * error / total`. Поэтому при 322 success / 250 error из 573
|
|
25
|
+
* получаются `successRate=56.2` и `errorRate=56.37` — это согласуемые значения:
|
|
26
|
+
* доля ошибок 43.63%, а балл ошибок 56.37. Не путать с `totals.errorRate`,
|
|
27
|
+
* если он когда-либо будет добавлен как реальная доля.
|
|
28
|
+
*/
|
|
15
29
|
components: {
|
|
30
|
+
/** Балл успешности 0..100 (нормализованный). */
|
|
16
31
|
successRate: number;
|
|
32
|
+
/** Балл частоты ошибок 0..100 (нормализованный, чем выше, тем меньше ошибок). */
|
|
17
33
|
errorRate: number;
|
|
34
|
+
/** Реальная средняя длительность запуска в мс. */
|
|
18
35
|
avgDurationMs: number;
|
|
36
|
+
/** Реальная доля таймаутов 0..1. */
|
|
19
37
|
timeoutRate: number;
|
|
38
|
+
/** Реальная доля прерванных (crash recovery) запусков 0..1. */
|
|
20
39
|
crashRecoveryRate: number;
|
|
40
|
+
/** Балл длительности 0..100 (нормализованный, использовался в score). */
|
|
41
|
+
avgDurationScore: number;
|
|
42
|
+
/** Балл таймаутов 0..100 (нормализованный). */
|
|
43
|
+
timeoutScore: number;
|
|
44
|
+
/** Балл восстановления после сбоев 0..100 (нормализованный). */
|
|
45
|
+
crashRecoveryScore: number;
|
|
21
46
|
};
|
|
22
47
|
/** Рекомендации по улучшению. */
|
|
23
48
|
recommendations: string[];
|
|
@@ -83,11 +108,16 @@ export interface SelfAnalysisReport {
|
|
|
83
108
|
recommendations: Recommendation[];
|
|
84
109
|
/** Краткое резюме. */
|
|
85
110
|
summary: string;
|
|
86
|
-
/** Метаданные источников
|
|
111
|
+
/** Метаданные источников данных (PL-13/PL-29/PL-31: единицы указаны в комментариях). */
|
|
87
112
|
sources: {
|
|
113
|
+
/** Записей истории всего (до фильтрации по окну). */
|
|
88
114
|
historyRecords: number;
|
|
115
|
+
/** Записей истории внутри окна days. */
|
|
89
116
|
recordsInWindow: number;
|
|
117
|
+
/** Число definition задач (НЕ уникальных имён в истории). */
|
|
90
118
|
tasksAnalyzed: number;
|
|
119
|
+
/** Явное имя того же счётчика definition — без двусмысленности «analyzed». */
|
|
120
|
+
taskDefinitions: number;
|
|
91
121
|
};
|
|
92
122
|
}
|
|
93
123
|
/** Опции для генерации отчёта самоанализа. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"self-analysis.d.ts","sourceRoot":"","sources":["../../src/core/self-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"self-analysis.d.ts","sourceRoot":"","sources":["../../src/core/self-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;AAUxB,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3D;;;;;;;;;;;;;;OAcG;IACH,UAAU,EAAE;QACV,gDAAgD;QAChD,WAAW,EAAE,MAAM,CAAC;QACpB,iFAAiF;QACjF,SAAS,EAAE,MAAM,CAAC;QAClB,kDAAkD;QAClD,aAAa,EAAE,MAAM,CAAC;QACtB,oCAAoC;QACpC,WAAW,EAAE,MAAM,CAAC;QACpB,+DAA+D;QAC/D,iBAAiB,EAAE,MAAM,CAAC;QAC1B,yEAAyE;QACzE,gBAAgB,EAAE,MAAM,CAAC;QACzB,+CAA+C;QAC/C,YAAY,EAAE,MAAM,CAAC;QACrB,gEAAgE;QAChE,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,iCAAiC;IACjC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,6BAA6B;AAC7B,MAAM,WAAW,OAAO;IACtB,oBAAoB;IACpB,IAAI,EACA,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,aAAa,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAqB;AACrB,MAAM,WAAW,KAAK;IACpB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC7D,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EACJ,aAAa,GACb,aAAa,GACb,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,UAAU,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,uBAAuB;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,gCAAgC;AAChC,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,sBAAsB;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,oBAAoB;IACpB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,OAAO,EAAE;QACP,qDAAqD;QACrD,cAAc,EAAE,MAAM,CAAC;QACvB,wCAAwC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,6DAA6D;QAC7D,aAAa,EAAE,MAAM,CAAC;QACtB,8EAA8E;QAC9E,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CAC5D;AAID,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAuEzE;AAID,sCAAsC;AACtC,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,mBAAwB,GAChC,OAAO,EAAE,CA0CX;AA4LD,iCAAiC;AACjC,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,mBAAwB,GAChC,KAAK,EAAE,CAsET;AAID,8CAA8C;AAC9C,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,OAAO,EAAE,EACpB,MAAM,EAAE,KAAK,EAAE,GACd,cAAc,EAAE,CAoIlB;AAID,2CAA2C;AAC3C,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA4CpB"}
|
|
@@ -5,16 +5,23 @@
|
|
|
5
5
|
* рекомендации по оптимизации на основе исторических данных.
|
|
6
6
|
*/
|
|
7
7
|
import { buildAnalytics, } from "./analytics.js";
|
|
8
|
+
import { t } from "../i18n.js";
|
|
8
9
|
// ==================== Health Score ====================
|
|
9
10
|
/** Рассчитывает общий балл здоровья системы. */
|
|
10
11
|
export function calculateHealthScore(report) {
|
|
11
12
|
const { totals, tasks, errors } = report;
|
|
12
|
-
//
|
|
13
|
+
// Реальные метрики (то, что видит пользователь в self_analysis).
|
|
14
|
+
const realAvgDurationMs = totals.avgDurationMs;
|
|
15
|
+
const realTimeoutRate = errors.filter((e) => e.message.includes("timeout")).length /
|
|
16
|
+
Math.max(1, totals.total);
|
|
17
|
+
const realCrashRecoveryRate = errors.filter((e) => e.message.includes("Прервано")).length /
|
|
18
|
+
Math.max(1, totals.total);
|
|
19
|
+
// Компоненты здоровья — нормализованные баллы 0..100 (обратная совместимость).
|
|
13
20
|
const successRateScore = totals.successRate;
|
|
14
21
|
const errorRateScore = Math.max(0, 100 - (totals.error / Math.max(1, totals.total)) * 100);
|
|
15
|
-
const avgDurationScore = Math.min(100, Math.max(0, 100 - (
|
|
16
|
-
const timeoutRateScore = Math.min(100, Math.max(0, 100 -
|
|
17
|
-
const crashRecoveryRateScore = Math.min(100, Math.max(0, 100 -
|
|
22
|
+
const avgDurationScore = Math.min(100, Math.max(0, 100 - (realAvgDurationMs / 300000) * 100)); // 5 минут = 0 баллов
|
|
23
|
+
const timeoutRateScore = Math.min(100, Math.max(0, 100 - realTimeoutRate * 100));
|
|
24
|
+
const crashRecoveryRateScore = Math.min(100, Math.max(0, 100 - realCrashRecoveryRate * 100));
|
|
18
25
|
// Взвешенная сумма
|
|
19
26
|
const score = Math.round(successRateScore * 0.35 +
|
|
20
27
|
errorRateScore * 0.25 +
|
|
@@ -36,19 +43,19 @@ export function calculateHealthScore(report) {
|
|
|
36
43
|
// Рекомендации
|
|
37
44
|
const recommendations = [];
|
|
38
45
|
if (successRateScore < 80) {
|
|
39
|
-
recommendations.push("
|
|
46
|
+
recommendations.push(t("selfAnalysis.rec.successRate"));
|
|
40
47
|
}
|
|
41
48
|
if (errorRateScore < 80) {
|
|
42
|
-
recommendations.push("
|
|
49
|
+
recommendations.push(t("selfAnalysis.rec.errorRate"));
|
|
43
50
|
}
|
|
44
51
|
if (avgDurationScore < 70) {
|
|
45
|
-
recommendations.push("
|
|
52
|
+
recommendations.push(t("selfAnalysis.rec.duration"));
|
|
46
53
|
}
|
|
47
54
|
if (timeoutRateScore < 80) {
|
|
48
|
-
recommendations.push("
|
|
55
|
+
recommendations.push(t("selfAnalysis.rec.timeouts"));
|
|
49
56
|
}
|
|
50
57
|
if (crashRecoveryRateScore < 90) {
|
|
51
|
-
recommendations.push("
|
|
58
|
+
recommendations.push(t("selfAnalysis.rec.crashes"));
|
|
52
59
|
}
|
|
53
60
|
return {
|
|
54
61
|
score,
|
|
@@ -56,9 +63,14 @@ export function calculateHealthScore(report) {
|
|
|
56
63
|
components: {
|
|
57
64
|
successRate: successRateScore,
|
|
58
65
|
errorRate: errorRateScore,
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
66
|
+
// Реальные значения (исправление roadmap-qa-01).
|
|
67
|
+
avgDurationMs: realAvgDurationMs,
|
|
68
|
+
timeoutRate: realTimeoutRate,
|
|
69
|
+
crashRecoveryRate: realCrashRecoveryRate,
|
|
70
|
+
// Нормализованные баллы (прежняя семантика этих трёх полей).
|
|
71
|
+
avgDurationScore,
|
|
72
|
+
timeoutScore: timeoutRateScore,
|
|
73
|
+
crashRecoveryScore: crashRecoveryRateScore,
|
|
62
74
|
},
|
|
63
75
|
recommendations,
|
|
64
76
|
};
|
|
@@ -496,43 +508,42 @@ export function generateSelfAnalysisReport(records, options = {}) {
|
|
|
496
508
|
sources: {
|
|
497
509
|
historyRecords: records.length,
|
|
498
510
|
recordsInWindow: analyticsReport.sources.recordsInWindow,
|
|
499
|
-
|
|
511
|
+
// PL-13/PL-29/PL-31: options.tasks — это definitions, а analyticsReport.tasks —
|
|
512
|
+
// задачи, попавшие в историю; последнее число могло быть больше на 15+.
|
|
513
|
+
tasksAnalyzed: options.tasks?.length ?? analyticsReport.tasks.length,
|
|
514
|
+
taskDefinitions: options.tasks?.length ?? analyticsReport.tasks.length,
|
|
500
515
|
},
|
|
501
516
|
};
|
|
502
517
|
}
|
|
503
518
|
function generateSummary(health, anomalies, trends, recommendations) {
|
|
504
519
|
const parts = [];
|
|
505
520
|
// Здоровье
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
poor: "плохое",
|
|
511
|
-
critical: "критическое",
|
|
512
|
-
};
|
|
513
|
-
parts.push(`Здоровье системы: ${levelNames[health.level]} (${health.score}/100)`);
|
|
521
|
+
parts.push(t("selfAnalysis.health", {
|
|
522
|
+
level: t(`selfAnalysis.level.${health.level}`),
|
|
523
|
+
score: health.score,
|
|
524
|
+
}));
|
|
514
525
|
// Аномалии
|
|
515
526
|
if (anomalies.length > 0) {
|
|
516
527
|
const highSeverity = anomalies.filter(a => a.severity > 70).length;
|
|
517
528
|
if (highSeverity > 0) {
|
|
518
|
-
parts.push(
|
|
529
|
+
parts.push(t("selfAnalysis.anomaliesHigh", { count: highSeverity }));
|
|
519
530
|
}
|
|
520
531
|
else {
|
|
521
|
-
parts.push(
|
|
532
|
+
parts.push(t("selfAnalysis.anomaliesAll", { count: anomalies.length }));
|
|
522
533
|
}
|
|
523
534
|
}
|
|
524
535
|
else {
|
|
525
|
-
parts.push("
|
|
536
|
+
parts.push(t("selfAnalysis.noAnomalies"));
|
|
526
537
|
}
|
|
527
538
|
// Тренды
|
|
528
|
-
const degradingTrends = trends.filter(
|
|
539
|
+
const degradingTrends = trends.filter(trend => trend.direction === "degrading").length;
|
|
529
540
|
if (degradingTrends > 0) {
|
|
530
|
-
parts.push(
|
|
541
|
+
parts.push(t("selfAnalysis.degrading", { count: degradingTrends }));
|
|
531
542
|
}
|
|
532
543
|
// Рекомендации
|
|
533
544
|
const highPriority = recommendations.filter(r => r.priority >= 7).length;
|
|
534
545
|
if (highPriority > 0) {
|
|
535
|
-
parts.push(
|
|
546
|
+
parts.push(t("selfAnalysis.highPriority", { count: highPriority }));
|
|
536
547
|
}
|
|
537
548
|
return parts.join(". ") + ".";
|
|
538
549
|
}
|
package/dist/core/shutdown.d.ts
CHANGED
|
@@ -5,16 +5,47 @@
|
|
|
5
5
|
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
6
|
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
7
|
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*
|
|
9
|
+
* PL-10/QV-2: состояние ворот наблюдаемо (причина, время, PID, активные
|
|
10
|
+
* операции), а «зависшие» ворота (begin без complete, нет активных операций,
|
|
11
|
+
* прошло больше STALE_MS) автоматически открываются при первом же запросе.
|
|
12
|
+
* Так hot-reload каталога инструментов не блокирует in-process запуски,
|
|
13
|
+
* пока ОС-планировщик продолжает тикать.
|
|
8
14
|
*/
|
|
9
15
|
export interface ShutdownWaitResult {
|
|
10
16
|
timedOut: boolean;
|
|
11
17
|
remaining: number;
|
|
12
18
|
}
|
|
19
|
+
export interface ShutdownGateState {
|
|
20
|
+
shuttingDown: boolean;
|
|
21
|
+
/** Причина, по которой ворота были закрыты (обычно «plugin unload»). */
|
|
22
|
+
reason: string | null;
|
|
23
|
+
/** ISO-время вызова begin(). */
|
|
24
|
+
startedAt: string | null;
|
|
25
|
+
/** PID процесса, в котором ворота закрыты. */
|
|
26
|
+
pid: number;
|
|
27
|
+
/** Число ещё выполняемых in-process операций. */
|
|
28
|
+
activeCount: number;
|
|
29
|
+
/** true после complete() — выгрузка действительно завершена. */
|
|
30
|
+
unloadCompleted: boolean;
|
|
31
|
+
/** Диагностика последнего автоматического сброса. */
|
|
32
|
+
lastAutoReset: string | null;
|
|
33
|
+
}
|
|
13
34
|
export interface ShutdownGate {
|
|
14
|
-
/** true после begin()
|
|
35
|
+
/** true после begin(), пока ворота не открылись повторно. */
|
|
15
36
|
isShuttingDown(): boolean;
|
|
16
37
|
/** Переводит ворота в режим выгрузки. */
|
|
17
|
-
begin(): void;
|
|
38
|
+
begin(reason?: string): void;
|
|
39
|
+
/** Подтверждает, что выгрузка завершена (запрещает автосброс). */
|
|
40
|
+
complete(): void;
|
|
41
|
+
/**
|
|
42
|
+
* PL-45: принудительно открывает ворота. Вызывается при повторной
|
|
43
|
+
* регистрации плагина (V2 setup / V1 hooks), когда хост ранее вызвал
|
|
44
|
+
* begin()+complete(), но модуль остался в памяти (Code Mode / hot-reload).
|
|
45
|
+
*/
|
|
46
|
+
reset(): void;
|
|
47
|
+
/** Снимок состояния для диагностики и структурированных ошибок. */
|
|
48
|
+
state(): ShutdownGateState;
|
|
18
49
|
/** Учитывает промис до его завершения (успех или ошибка). */
|
|
19
50
|
track<T>(promise: Promise<T>): Promise<T>;
|
|
20
51
|
/** Сколько операций ещё выполняется. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/core/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,cAAc,IAAI,OAAO,CAAC;IAC1B,yCAAyC;IACzC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,IAAI,IAAI,CAAC;IACjB;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;IACd,mEAAmE;IACnE,KAAK,IAAI,iBAAiB,CAAC;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,wCAAwC;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CA4FjD"}
|
package/dist/core/shutdown.js
CHANGED
|
@@ -5,15 +5,71 @@
|
|
|
5
5
|
* in-process операций (запуск задачи, matrix, DAG-триггер) перед закрытием
|
|
6
6
|
* SQLite и HTTP-сервера. Внешние процессы планировщика ОС эти ворота не
|
|
7
7
|
* отслеживают: их жизненным циклом управляет сама ОС.
|
|
8
|
+
*
|
|
9
|
+
* PL-10/QV-2: состояние ворот наблюдаемо (причина, время, PID, активные
|
|
10
|
+
* операции), а «зависшие» ворота (begin без complete, нет активных операций,
|
|
11
|
+
* прошло больше STALE_MS) автоматически открываются при первом же запросе.
|
|
12
|
+
* Так hot-reload каталога инструментов не блокирует in-process запуски,
|
|
13
|
+
* пока ОС-планировщик продолжает тикать.
|
|
8
14
|
*/
|
|
15
|
+
/** Порог «зависших» ворот; переопределяется для тестов через env. */
|
|
16
|
+
const STALE_GATE_MS = Number(process.env.AGENT_STEWARD_SHUTDOWN_STALE_MS ?? 30000);
|
|
9
17
|
export function createShutdownGate() {
|
|
10
18
|
let shuttingDown = false;
|
|
19
|
+
let reason = null;
|
|
20
|
+
let startedAtMs = null;
|
|
21
|
+
let unloadCompleted = false;
|
|
22
|
+
let lastAutoReset = null;
|
|
11
23
|
const active = new Set();
|
|
24
|
+
const maybeResetStale = () => {
|
|
25
|
+
if (!shuttingDown ||
|
|
26
|
+
active.size !== 0 ||
|
|
27
|
+
startedAtMs === null ||
|
|
28
|
+
Date.now() - startedAtMs < STALE_GATE_MS) {
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
const waitedMs = Date.now() - startedAtMs;
|
|
32
|
+
lastAutoReset =
|
|
33
|
+
`ворота оставались закрытыми ${waitedMs} мс без активных операций ` +
|
|
34
|
+
(unloadCompleted
|
|
35
|
+
? "после complete() без выгрузки модуля — автосброс в Code Mode"
|
|
36
|
+
: "и без complete() — автосброс после hot-reload");
|
|
37
|
+
shuttingDown = false;
|
|
38
|
+
reason = null;
|
|
39
|
+
startedAtMs = null;
|
|
40
|
+
};
|
|
12
41
|
return {
|
|
13
|
-
isShuttingDown: () =>
|
|
14
|
-
|
|
42
|
+
isShuttingDown: () => {
|
|
43
|
+
maybeResetStale();
|
|
44
|
+
return shuttingDown;
|
|
45
|
+
},
|
|
46
|
+
begin: (why = "plugin unload") => {
|
|
15
47
|
shuttingDown = true;
|
|
48
|
+
reason = why;
|
|
49
|
+
startedAtMs = Date.now();
|
|
50
|
+
unloadCompleted = false;
|
|
51
|
+
},
|
|
52
|
+
complete: () => {
|
|
53
|
+
unloadCompleted = true;
|
|
54
|
+
},
|
|
55
|
+
reset: () => {
|
|
56
|
+
if (shuttingDown) {
|
|
57
|
+
lastAutoReset = "ворота открыты повторной регистрацией плагина (PL-45)";
|
|
58
|
+
}
|
|
59
|
+
shuttingDown = false;
|
|
60
|
+
reason = null;
|
|
61
|
+
startedAtMs = null;
|
|
62
|
+
unloadCompleted = false;
|
|
16
63
|
},
|
|
64
|
+
state: () => ({
|
|
65
|
+
shuttingDown,
|
|
66
|
+
reason,
|
|
67
|
+
startedAt: startedAtMs === null ? null : new Date(startedAtMs).toISOString(),
|
|
68
|
+
pid: process.pid,
|
|
69
|
+
activeCount: active.size,
|
|
70
|
+
unloadCompleted,
|
|
71
|
+
lastAutoReset,
|
|
72
|
+
}),
|
|
17
73
|
track(promise) {
|
|
18
74
|
const tracked = promise.finally(() => {
|
|
19
75
|
active.delete(tracked);
|
|
@@ -32,6 +32,22 @@ export interface StructuredLogRecord {
|
|
|
32
32
|
workspaceId?: string | null;
|
|
33
33
|
preFlightStatus?: string;
|
|
34
34
|
postFlightStatus?: string;
|
|
35
|
+
/**
|
|
36
|
+
* PL-7.2: реальный код завершения хуков. Диагностика Git уходит в stderr
|
|
37
|
+
* даже при успешном push — без разделения потоков «пуш не состоялся» и
|
|
38
|
+
* «Git пишет в stderr» неразличимы.
|
|
39
|
+
*/
|
|
40
|
+
preFlightExitCode?: number | null;
|
|
41
|
+
/** PL-7.2: stdout beforeScript — отдельно от диагностики. */
|
|
42
|
+
preFlightStdout?: string;
|
|
43
|
+
/** PL-7.2: stderr beforeScript. */
|
|
44
|
+
preFlightStderr?: string;
|
|
45
|
+
/** PL-7.2: реальный код завершения afterScript (post-flight). */
|
|
46
|
+
postFlightExitCode?: number | null;
|
|
47
|
+
/** PL-7.2: stdout afterScript — отдельно от диагностики. */
|
|
48
|
+
postFlightStdout?: string;
|
|
49
|
+
/** PL-7.2: stderr afterScript — может содержать diagnostics успешного git push. */
|
|
50
|
+
postFlightStderr?: string;
|
|
35
51
|
/** Источник события: schedule, dashboard, hook, cli, mcp и т.п. */
|
|
36
52
|
source?: string;
|
|
37
53
|
/** HTTP-статус ответа на hook.received. */
|
|
@@ -78,6 +94,20 @@ export declare const STRUCTURED_LOG_MAX_BYTES: number;
|
|
|
78
94
|
export declare function appendStructuredLog(record: Omit<StructuredLogRecord, "ts"> & {
|
|
79
95
|
ts?: string;
|
|
80
96
|
}): boolean;
|
|
97
|
+
/** PL-7.2: данные одного хука (pre/post-flight) для журнала. */
|
|
98
|
+
export interface HookOutputDetails {
|
|
99
|
+
/** Реальный код завершения процесса, а не «успех/ошибка» обёртки. */
|
|
100
|
+
exitCode: number | null;
|
|
101
|
+
stdout?: string;
|
|
102
|
+
stderr?: string;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* PL-7.2: пишет отдельное событие `hook.output` с разделёнными stdout/stderr и
|
|
106
|
+
* реальным exit code. Обёртка вызывает его, когда хочет отличить «команда не
|
|
107
|
+
* выполнилась» от «команда выполнилась, но написала диагностику в stderr»
|
|
108
|
+
* (типичный случай git push под PowerShell $ErrorActionPreference='Stop').
|
|
109
|
+
*/
|
|
110
|
+
export declare function appendHookOutputLog(phase: "preFlight" | "postFlight", task: string, details: HookOutputDetails, runId?: number): boolean;
|
|
81
111
|
/**
|
|
82
112
|
* Читает JSONL-лог (текущий + архив), фильтрует и сортирует новые сверху.
|
|
83
113
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,2BAA2B,GAC3B,cAAc,GACd,MAAM,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,QAAmC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAA6B,CAAC;AACjE,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAiCzD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,
|
|
1
|
+
{"version":3,"file":"structured-log.d.ts","sourceRoot":"","sources":["../../src/core/structured-log.ts"],"names":[],"mappings":"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"}
|
|
@@ -57,6 +57,20 @@ export function appendStructuredLog(record) {
|
|
|
57
57
|
if (typeof payload.reason === "string") {
|
|
58
58
|
payload.reason = redactSecretsInText(payload.reason);
|
|
59
59
|
}
|
|
60
|
+
// PL-7.2: потоки хуков тоже могут содержать токены/URL — применяем ту же
|
|
61
|
+
// редакцию, что и к error/reason, до записи в JSONL.
|
|
62
|
+
if (typeof payload.preFlightStdout === "string") {
|
|
63
|
+
payload.preFlightStdout = redactSecretsInText(payload.preFlightStdout);
|
|
64
|
+
}
|
|
65
|
+
if (typeof payload.preFlightStderr === "string") {
|
|
66
|
+
payload.preFlightStderr = redactSecretsInText(payload.preFlightStderr);
|
|
67
|
+
}
|
|
68
|
+
if (typeof payload.postFlightStdout === "string") {
|
|
69
|
+
payload.postFlightStdout = redactSecretsInText(payload.postFlightStdout);
|
|
70
|
+
}
|
|
71
|
+
if (typeof payload.postFlightStderr === "string") {
|
|
72
|
+
payload.postFlightStderr = redactSecretsInText(payload.postFlightStderr);
|
|
73
|
+
}
|
|
60
74
|
fs.appendFileSync(STRUCTURED_LOG_FILE, `${JSON.stringify(payload)}\n`, "utf8");
|
|
61
75
|
return true;
|
|
62
76
|
}
|
|
@@ -65,6 +79,29 @@ export function appendStructuredLog(record) {
|
|
|
65
79
|
return false;
|
|
66
80
|
}
|
|
67
81
|
}
|
|
82
|
+
/**
|
|
83
|
+
* PL-7.2: пишет отдельное событие `hook.output` с разделёнными stdout/stderr и
|
|
84
|
+
* реальным exit code. Обёртка вызывает его, когда хочет отличить «команда не
|
|
85
|
+
* выполнилась» от «команда выполнилась, но написала диагностику в stderr»
|
|
86
|
+
* (типичный случай git push под PowerShell $ErrorActionPreference='Stop').
|
|
87
|
+
*/
|
|
88
|
+
export function appendHookOutputLog(phase, task, details, runId) {
|
|
89
|
+
const base = { event: "hook.output", task, runId };
|
|
90
|
+
if (phase === "postFlight") {
|
|
91
|
+
return appendStructuredLog({
|
|
92
|
+
...base,
|
|
93
|
+
postFlightExitCode: details.exitCode,
|
|
94
|
+
postFlightStdout: details.stdout ?? "",
|
|
95
|
+
postFlightStderr: details.stderr ?? "",
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
return appendStructuredLog({
|
|
99
|
+
...base,
|
|
100
|
+
preFlightExitCode: details.exitCode,
|
|
101
|
+
preFlightStdout: details.stdout ?? "",
|
|
102
|
+
preFlightStderr: details.stderr ?? "",
|
|
103
|
+
});
|
|
104
|
+
}
|
|
68
105
|
function readLines(file) {
|
|
69
106
|
try {
|
|
70
107
|
return fs
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* QV-11.1: офлайн-оценка размера поверхности инструментов без вызова платной
|
|
3
|
+
* модели. Точный tiktoken не нужен: нам важна сравнимая метрика «было/стало»
|
|
4
|
+
* и число description', чтобы видеть раздувание реестра.
|
|
5
|
+
*/
|
|
6
|
+
export interface ToolSurfaceSpec {
|
|
7
|
+
name: string;
|
|
8
|
+
description?: string;
|
|
9
|
+
input?: unknown;
|
|
10
|
+
}
|
|
11
|
+
export interface ToolSurfaceMeasurement {
|
|
12
|
+
tools: number;
|
|
13
|
+
descriptionChars: number;
|
|
14
|
+
schemaChars: number;
|
|
15
|
+
descriptionCount: number;
|
|
16
|
+
estimatedTokens: number;
|
|
17
|
+
}
|
|
18
|
+
/** Резервная грубая оценка: ~4 символа на токен (только без токенайзера). */
|
|
19
|
+
export declare function estimateTokens(text: string): number;
|
|
20
|
+
export interface MeasureToolSurfaceOptions {
|
|
21
|
+
/** Реальный офлайн-токенайзер (например, encode из gpt-tokenizer). */
|
|
22
|
+
countTokens?: (text: string) => number;
|
|
23
|
+
}
|
|
24
|
+
export declare function measureToolSurface(specs: readonly ToolSurfaceSpec[], options?: MeasureToolSurfaceOptions): ToolSurfaceMeasurement;
|
|
25
|
+
//# sourceMappingURL=usage-surface.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"usage-surface.d.ts","sourceRoot":"","sources":["../../src/core/usage-surface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,OAAO,GAAE,yBAA8B,GACtC,sBAAsB,CAoCxB"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* QV-11.1: офлайн-оценка размера поверхности инструментов без вызова платной
|
|
3
|
+
* модели. Точный tiktoken не нужен: нам важна сравнимая метрика «было/стало»
|
|
4
|
+
* и число description', чтобы видеть раздувание реестра.
|
|
5
|
+
*/
|
|
6
|
+
/** Резервная грубая оценка: ~4 символа на токен (только без токенайзера). */
|
|
7
|
+
export function estimateTokens(text) {
|
|
8
|
+
return Math.ceil(text.length / 4);
|
|
9
|
+
}
|
|
10
|
+
export function measureToolSurface(specs, options = {}) {
|
|
11
|
+
let descriptionChars = 0;
|
|
12
|
+
let schemaChars = 0;
|
|
13
|
+
let descriptionCount = 0;
|
|
14
|
+
for (const spec of specs) {
|
|
15
|
+
if (spec.description) {
|
|
16
|
+
descriptionChars += spec.description.length;
|
|
17
|
+
descriptionCount += 1;
|
|
18
|
+
}
|
|
19
|
+
if (spec.input !== undefined) {
|
|
20
|
+
try {
|
|
21
|
+
schemaChars += JSON.stringify(spec.input).length;
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
schemaChars += "[unserializable]".length;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
return {
|
|
29
|
+
tools: specs.length,
|
|
30
|
+
descriptionChars,
|
|
31
|
+
schemaChars,
|
|
32
|
+
descriptionCount,
|
|
33
|
+
estimatedTokens: options.countTokens
|
|
34
|
+
? options.countTokens(specs
|
|
35
|
+
.map((spec) => `${spec.name} ${spec.description ?? ""} ${JSON.stringify(spec.input ?? null)}`)
|
|
36
|
+
.join("\n"))
|
|
37
|
+
: estimateTokens(specs
|
|
38
|
+
.map((spec) => `${spec.name} ${spec.description ?? ""} ${JSON.stringify(spec.input ?? null)}`)
|
|
39
|
+
.join("\n")),
|
|
40
|
+
};
|
|
41
|
+
}
|
|
@@ -75,6 +75,8 @@ export interface BashWrapperOptions {
|
|
|
75
75
|
guards?: TaskGuards;
|
|
76
76
|
/** Путь к dist/core/guard-run.js (обязателен при guards). */
|
|
77
77
|
guardHelper?: string;
|
|
78
|
+
/** PL-47: пути, которые задача вправе изменить (из -Files afterScript). */
|
|
79
|
+
gateAllowPaths?: string;
|
|
78
80
|
}
|
|
79
81
|
/**
|
|
80
82
|
* B6: разбор PID из lock-токена для bash-обёртки.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/wrappers/bash.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,kSASjC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAmnB1E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE7D;AAYD,wBAAgB,mBAAmB,CACjC,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,MAAM,CAAC,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,OAAO,GACpB,MAAM,CAER"}
|