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
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
import type { FeedbackSettings } from "../settings.js";
|
|
2
|
+
/** Версия контракта payload. Приёмник обязателен принимать только её. */
|
|
3
|
+
export declare const FEEDBACK_SCHEMA_VERSION = 1;
|
|
4
|
+
/** Таймаут одного HTTP-запроса (F-1.2). */
|
|
5
|
+
export declare const FEEDBACK_TIMEOUT_MS = 10000;
|
|
6
|
+
/** Количество повторов после первой попытки (F-1.2). */
|
|
7
|
+
export declare const FEEDBACK_MAX_RETRIES = 2;
|
|
8
|
+
/** Базовая задержка backoff в мс (удваивается на каждом повторе). */
|
|
9
|
+
export declare const FEEDBACK_BACKOFF_MS = 500;
|
|
10
|
+
/** Окно антиспама по хешу описания (F-1.7). */
|
|
11
|
+
export declare const FEEDBACK_ANTISPAM_WINDOW_MS: number;
|
|
12
|
+
/** Лимит отчётов в час по умолчанию (F-1.7). */
|
|
13
|
+
export declare const FEEDBACK_MAX_PER_HOUR = 6;
|
|
14
|
+
/** Максимальное число попыток отправки из outbox. */
|
|
15
|
+
export declare const FEEDBACK_OUTBOX_MAX_ATTEMPTS = 5;
|
|
16
|
+
/** Пределы длин полей (совпадают с валидацией Worker). */
|
|
17
|
+
export declare const FEEDBACK_LIMITS: {
|
|
18
|
+
readonly description: 4000;
|
|
19
|
+
readonly logs: 8000;
|
|
20
|
+
readonly contactEmail: 254;
|
|
21
|
+
readonly taskName: 200;
|
|
22
|
+
};
|
|
23
|
+
export type FeedbackDestination = "author" | "local" | "both";
|
|
24
|
+
/** Контракт, который получает приёмник (F-1.1). */
|
|
25
|
+
export interface FeedbackPayload {
|
|
26
|
+
schemaVersion: 1;
|
|
27
|
+
reportId: string;
|
|
28
|
+
createdAt: string;
|
|
29
|
+
pluginVersion: string;
|
|
30
|
+
os: {
|
|
31
|
+
platform: string;
|
|
32
|
+
release: string;
|
|
33
|
+
arch: string;
|
|
34
|
+
};
|
|
35
|
+
node: string;
|
|
36
|
+
locale: string;
|
|
37
|
+
profile: string;
|
|
38
|
+
taskName?: string;
|
|
39
|
+
description: string;
|
|
40
|
+
contactEmail?: string;
|
|
41
|
+
redactedLogs?: string;
|
|
42
|
+
metrics?: Record<string, number>;
|
|
43
|
+
/** Honeypot: боты заполняют, человек — никогда. Приёмник молча дропает. */
|
|
44
|
+
website?: string;
|
|
45
|
+
}
|
|
46
|
+
/** Входные данные для сборки payload. */
|
|
47
|
+
export interface FeedbackBuildInput {
|
|
48
|
+
description: string;
|
|
49
|
+
taskName?: string;
|
|
50
|
+
contactEmail?: string;
|
|
51
|
+
redactedLogs?: string;
|
|
52
|
+
metrics?: Record<string, number>;
|
|
53
|
+
locale?: string;
|
|
54
|
+
profile?: string;
|
|
55
|
+
reportId?: string;
|
|
56
|
+
now?: Date;
|
|
57
|
+
}
|
|
58
|
+
/** Окружение, подставляемое в payload (легко подменить в тестах). */
|
|
59
|
+
export interface FeedbackBuildEnv {
|
|
60
|
+
platform?: string;
|
|
61
|
+
release?: string;
|
|
62
|
+
arch?: string;
|
|
63
|
+
node?: string;
|
|
64
|
+
pluginVersion?: string;
|
|
65
|
+
}
|
|
66
|
+
/** Результат отправки. */
|
|
67
|
+
export interface FeedbackSendResult {
|
|
68
|
+
ok: boolean;
|
|
69
|
+
reportId: string;
|
|
70
|
+
attempts: number;
|
|
71
|
+
issueUrl?: string;
|
|
72
|
+
error?: string;
|
|
73
|
+
status?: number;
|
|
74
|
+
}
|
|
75
|
+
/** Результат высокоуровневой обработки report_bug. */
|
|
76
|
+
export interface FeedbackReportResult {
|
|
77
|
+
success: boolean;
|
|
78
|
+
reportId: string;
|
|
79
|
+
destination: FeedbackDestination;
|
|
80
|
+
mode: "sent" | "dryRun" | "outbox" | "duplicate" | "local";
|
|
81
|
+
preview?: string;
|
|
82
|
+
error?: string;
|
|
83
|
+
author?: FeedbackSendResult;
|
|
84
|
+
}
|
|
85
|
+
interface OutboxRow {
|
|
86
|
+
id: string;
|
|
87
|
+
report_id: string;
|
|
88
|
+
payload_json: string;
|
|
89
|
+
attempts: number;
|
|
90
|
+
last_error: string | null;
|
|
91
|
+
created_at: string;
|
|
92
|
+
last_attempt_at: string | null;
|
|
93
|
+
}
|
|
94
|
+
interface AntispamRow {
|
|
95
|
+
at: string;
|
|
96
|
+
hash: string;
|
|
97
|
+
}
|
|
98
|
+
type FetchLike = (url: string, init?: Record<string, unknown>) => Promise<{
|
|
99
|
+
ok: boolean;
|
|
100
|
+
status: number;
|
|
101
|
+
text: () => Promise<string>;
|
|
102
|
+
}>;
|
|
103
|
+
export declare function makeReportId(): string;
|
|
104
|
+
/** Стабильный хеш описания для антиспама (без самого текста в БД). */
|
|
105
|
+
export declare function descriptionHash(description: string): string;
|
|
106
|
+
/**
|
|
107
|
+
* Редакция секретов и приватных данных (F-1.4).
|
|
108
|
+
*
|
|
109
|
+
* Порядок важен: сначала Known-паттерны токенов, затем явные значения из
|
|
110
|
+
* manage_secrets (после — home и email). Возвращает plaintext, пригодный
|
|
111
|
+
* для включения в payload; при dryRun ничего не уходит по сети.
|
|
112
|
+
*/
|
|
113
|
+
export declare function redactText(text: string, options?: {
|
|
114
|
+
secrets?: string[];
|
|
115
|
+
home?: string;
|
|
116
|
+
redactEmails?: boolean;
|
|
117
|
+
}): string;
|
|
118
|
+
/** Собирает payload по контракту F-1.1. Никакой сети — только данные. */
|
|
119
|
+
export declare function buildFeedbackPayload(input: FeedbackBuildInput, env?: FeedbackBuildEnv): FeedbackPayload;
|
|
120
|
+
/**
|
|
121
|
+
* Валидация URL приёмника (F-1.3): только http(s), без встроенных учётных
|
|
122
|
+
* данных (username/password) и без фрагмента. http разрешён только для
|
|
123
|
+
* localhost (разработка).
|
|
124
|
+
*/
|
|
125
|
+
export declare function validateFeedbackEndpoint(raw: string): {
|
|
126
|
+
ok: boolean;
|
|
127
|
+
reason?: string;
|
|
128
|
+
};
|
|
129
|
+
/** Красивый preview payload для dryRun и окна подтверждения (F-3.1). */
|
|
130
|
+
export declare function buildReportPreview(payload: FeedbackPayload): string;
|
|
131
|
+
/** Одна попытка POST с таймаутом (F-1.2). */
|
|
132
|
+
export declare function sendFeedbackOnce(payload: FeedbackPayload, endpoint: string, fetchImpl?: FetchLike): Promise<FeedbackSendResult>;
|
|
133
|
+
/** POST с 2 ретраями и экспоненциальным backoff (F-1.2). */
|
|
134
|
+
export declare function sendFeedbackWithRetry(payload: FeedbackPayload, endpoint: string, options?: {
|
|
135
|
+
retries?: number;
|
|
136
|
+
baseDelayMs?: number;
|
|
137
|
+
sleepFn?: (ms: number) => Promise<void>;
|
|
138
|
+
fetchImpl?: FetchLike;
|
|
139
|
+
}): Promise<FeedbackSendResult>;
|
|
140
|
+
export declare function enqueueOutbox(payload: FeedbackPayload): void;
|
|
141
|
+
export declare function listOutbox(limit?: number): OutboxRow[];
|
|
142
|
+
/** Повтор outbox при старте плагина. Никогда не бросает наружу. */
|
|
143
|
+
export declare function flushOutbox(settings: FeedbackSettings, options?: {
|
|
144
|
+
fetchImpl?: FetchLike;
|
|
145
|
+
sleepFn?: (ms: number) => Promise<void>;
|
|
146
|
+
}): Promise<{
|
|
147
|
+
processed: number;
|
|
148
|
+
sent: number;
|
|
149
|
+
}>;
|
|
150
|
+
/** Решение антиспама по истории отправок. Чистая функция. */
|
|
151
|
+
export declare function evaluateAntispam(records: AntispamRow[], description: string, now: Date, maxPerHour?: number): {
|
|
152
|
+
allowed: boolean;
|
|
153
|
+
reason?: "duplicate" | "rate_limited";
|
|
154
|
+
};
|
|
155
|
+
export declare function recordFeedbackSent(payload: FeedbackPayload): void;
|
|
156
|
+
export interface ReportFeedbackOptions {
|
|
157
|
+
settings: FeedbackSettings;
|
|
158
|
+
destination: FeedbackDestination;
|
|
159
|
+
dryRun?: boolean;
|
|
160
|
+
description: string;
|
|
161
|
+
taskName?: string;
|
|
162
|
+
contactEmail?: string;
|
|
163
|
+
redactedLogs?: string;
|
|
164
|
+
metrics?: Record<string, number>;
|
|
165
|
+
locale?: string;
|
|
166
|
+
profile?: string;
|
|
167
|
+
now?: Date;
|
|
168
|
+
secrets?: string[];
|
|
169
|
+
home?: string;
|
|
170
|
+
/** Локальная отправка в каналы репортищего (destination local/both). */
|
|
171
|
+
sendLocal?: (text: string) => Promise<{
|
|
172
|
+
success: boolean;
|
|
173
|
+
message: string;
|
|
174
|
+
}>;
|
|
175
|
+
localText?: string;
|
|
176
|
+
fetchImpl?: FetchLike;
|
|
177
|
+
sleepFn?: (ms: number) => Promise<void>;
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
* Точка входа для report_bug (F-1.5).
|
|
181
|
+
*
|
|
182
|
+
* - dryRun — только preview, сеть не трогается;
|
|
183
|
+
* - author — POST на приёмник; при ошибке fail-open → outbox;
|
|
184
|
+
* - local — старые каналы уведомлений (+ outbox как страховка);
|
|
185
|
+
* - both — и приёмник, и локальные каналы.
|
|
186
|
+
*
|
|
187
|
+
* Если приёмник не настроен или отключён, destination=author деградирует
|
|
188
|
+
* до local (fail-open), что честно отражается в `mode`.
|
|
189
|
+
*/
|
|
190
|
+
export declare function reportFeedback(options: ReportFeedbackOptions): Promise<FeedbackReportResult>;
|
|
191
|
+
export {};
|
|
192
|
+
//# sourceMappingURL=feedback.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,426 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Деталь 3.8 — обратная связь «чужой пользователь → автор» (F-1).
|
|
3
|
+
*
|
|
4
|
+
* Публичный npm-пакет не может содержать токены: в коде только URL write-only
|
|
5
|
+
* приёмника (Cloudflare Worker из infra/feedback-worker). Секреты живут в
|
|
6
|
+
* секретах Worker. При недоступности приёмника отчёт уходит в локальный
|
|
7
|
+
* outbox и НЕ блокирует запуск/завершение задачи (fail-open).
|
|
8
|
+
*/
|
|
9
|
+
import crypto from "node:crypto";
|
|
10
|
+
import os from "node:os";
|
|
11
|
+
import { getDb } from "../db/index.js";
|
|
12
|
+
import { getPluginVersion } from "../version.js";
|
|
13
|
+
/** Версия контракта payload. Приёмник обязателен принимать только её. */
|
|
14
|
+
export const FEEDBACK_SCHEMA_VERSION = 1;
|
|
15
|
+
/** Таймаут одного HTTP-запроса (F-1.2). */
|
|
16
|
+
export const FEEDBACK_TIMEOUT_MS = 10000;
|
|
17
|
+
/** Количество повторов после первой попытки (F-1.2). */
|
|
18
|
+
export const FEEDBACK_MAX_RETRIES = 2;
|
|
19
|
+
/** Базовая задержка backoff в мс (удваивается на каждом повторе). */
|
|
20
|
+
export const FEEDBACK_BACKOFF_MS = 500;
|
|
21
|
+
/** Окно антиспама по хешу описания (F-1.7). */
|
|
22
|
+
export const FEEDBACK_ANTISPAM_WINDOW_MS = 5 * 60000;
|
|
23
|
+
/** Лимит отчётов в час по умолчанию (F-1.7). */
|
|
24
|
+
export const FEEDBACK_MAX_PER_HOUR = 6;
|
|
25
|
+
/** Максимальное число попыток отправки из outbox. */
|
|
26
|
+
export const FEEDBACK_OUTBOX_MAX_ATTEMPTS = 5;
|
|
27
|
+
/** Пределы длин полей (совпадают с валидацией Worker). */
|
|
28
|
+
export const FEEDBACK_LIMITS = {
|
|
29
|
+
description: 4000,
|
|
30
|
+
logs: 8000,
|
|
31
|
+
contactEmail: 254,
|
|
32
|
+
taskName: 200,
|
|
33
|
+
};
|
|
34
|
+
export function makeReportId() {
|
|
35
|
+
return crypto.randomUUID();
|
|
36
|
+
}
|
|
37
|
+
/** Стабильный хеш описания для антиспама (без самого текста в БД). */
|
|
38
|
+
export function descriptionHash(description) {
|
|
39
|
+
return crypto.createHash("sha256").update(description.trim().toLowerCase()).digest("hex");
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Редакция секретов и приватных данных (F-1.4).
|
|
43
|
+
*
|
|
44
|
+
* Порядок важен: сначала Known-паттерны токенов, затем явные значения из
|
|
45
|
+
* manage_secrets (после — home и email). Возвращает plaintext, пригодный
|
|
46
|
+
* для включения в payload; при dryRun ничего не уходит по сети.
|
|
47
|
+
*/
|
|
48
|
+
export function redactText(text, options = {}) {
|
|
49
|
+
let out = String(text ?? "");
|
|
50
|
+
const known = [
|
|
51
|
+
[/\bgh[pousr]_[A-Za-z0-9]{20,}/g, "[REDACTED:github]"],
|
|
52
|
+
[/\bgithub_pat_[A-Za-z0-9_]{20,}/g, "[REDACTED:github]"],
|
|
53
|
+
[/\bsk-[A-Za-z0-9_-]{16,}/g, "[REDACTED:openai]"],
|
|
54
|
+
[/\bxox[baprs]-[A-Za-z0-9-]{10,}/g, "[REDACTED:slack]"],
|
|
55
|
+
[/\b\d{8,}:[A-Za-z0-9_-]{30,}/g, "[REDACTED:bot]"],
|
|
56
|
+
[/\bBearer\s+[A-Za-z0-9._~+/=-]{12,}/gi, "Bearer [REDACTED]"],
|
|
57
|
+
[/\bAKIA[0-9A-Z]{16}\b/g, "[REDACTED:aws]"],
|
|
58
|
+
];
|
|
59
|
+
for (const [re, replacement] of known)
|
|
60
|
+
out = out.replace(re, replacement);
|
|
61
|
+
const secrets = (options.secrets ?? []).filter((v) => v.length >= 4);
|
|
62
|
+
secrets.sort((a, b) => b.length - a.length);
|
|
63
|
+
for (const secret of secrets) {
|
|
64
|
+
out = out.split(secret).join("[REDACTED:secret]");
|
|
65
|
+
}
|
|
66
|
+
const home = options.home ?? os.homedir();
|
|
67
|
+
if (home && home.length > 2) {
|
|
68
|
+
out = out.split(home).join("~");
|
|
69
|
+
// Windows-пути часто приходят с прямыми слешами.
|
|
70
|
+
out = out.split(home.replace(/\\/g, "/")).join("~");
|
|
71
|
+
}
|
|
72
|
+
if (options.redactEmails !== false) {
|
|
73
|
+
out = out.replace(/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, "[EMAIL]");
|
|
74
|
+
}
|
|
75
|
+
return out;
|
|
76
|
+
}
|
|
77
|
+
function clamp(value, max) {
|
|
78
|
+
if (!value)
|
|
79
|
+
return undefined;
|
|
80
|
+
const trimmed = value.trim();
|
|
81
|
+
if (!trimmed)
|
|
82
|
+
return undefined;
|
|
83
|
+
return trimmed.length > max ? `${trimmed.slice(0, max - 1)}…` : trimmed;
|
|
84
|
+
}
|
|
85
|
+
/** Собирает payload по контракту F-1.1. Никакой сети — только данные. */
|
|
86
|
+
export function buildFeedbackPayload(input, env = {}) {
|
|
87
|
+
const now = input.now ?? new Date();
|
|
88
|
+
const payload = {
|
|
89
|
+
schemaVersion: FEEDBACK_SCHEMA_VERSION,
|
|
90
|
+
reportId: input.reportId ?? makeReportId(),
|
|
91
|
+
createdAt: now.toISOString(),
|
|
92
|
+
pluginVersion: clamp(env.pluginVersion ?? getPluginVersion(), 64) ?? "unknown",
|
|
93
|
+
os: {
|
|
94
|
+
platform: clamp(env.platform ?? os.platform(), 64) ?? "unknown",
|
|
95
|
+
release: clamp(env.release ?? os.release(), 128) ?? "unknown",
|
|
96
|
+
arch: clamp(env.arch ?? os.arch(), 32) ?? "unknown",
|
|
97
|
+
},
|
|
98
|
+
node: clamp(env.node ?? process.version, 64) ?? "unknown",
|
|
99
|
+
locale: clamp(input.locale, 16) ?? "ru",
|
|
100
|
+
profile: clamp(input.profile, 64) ?? "default",
|
|
101
|
+
description: clamp(input.description, FEEDBACK_LIMITS.description) ?? "",
|
|
102
|
+
};
|
|
103
|
+
const taskName = clamp(input.taskName, FEEDBACK_LIMITS.taskName);
|
|
104
|
+
if (taskName)
|
|
105
|
+
payload.taskName = taskName;
|
|
106
|
+
const contactEmail = clamp(input.contactEmail, FEEDBACK_LIMITS.contactEmail);
|
|
107
|
+
if (contactEmail)
|
|
108
|
+
payload.contactEmail = contactEmail;
|
|
109
|
+
const redactedLogs = clamp(input.redactedLogs, FEEDBACK_LIMITS.logs);
|
|
110
|
+
if (redactedLogs)
|
|
111
|
+
payload.redactedLogs = redactedLogs;
|
|
112
|
+
if (input.metrics && Object.keys(input.metrics).length > 0)
|
|
113
|
+
payload.metrics = input.metrics;
|
|
114
|
+
return payload;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Валидация URL приёмника (F-1.3): только http(s), без встроенных учётных
|
|
118
|
+
* данных (username/password) и без фрагмента. http разрешён только для
|
|
119
|
+
* localhost (разработка).
|
|
120
|
+
*/
|
|
121
|
+
export function validateFeedbackEndpoint(raw) {
|
|
122
|
+
const value = (raw ?? "").trim();
|
|
123
|
+
if (!value)
|
|
124
|
+
return { ok: false, reason: "endpoint is empty" };
|
|
125
|
+
let url;
|
|
126
|
+
try {
|
|
127
|
+
url = new URL(value);
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
return { ok: false, reason: "endpoint is not a valid URL" };
|
|
131
|
+
}
|
|
132
|
+
if (url.protocol !== "https:" && url.protocol !== "http:") {
|
|
133
|
+
return { ok: false, reason: "only http(s) endpoint is allowed" };
|
|
134
|
+
}
|
|
135
|
+
if (url.protocol === "http:" && !["localhost", "127.0.0.1", "[::1]"].includes(url.hostname)) {
|
|
136
|
+
return { ok: false, reason: "http is allowed only for localhost" };
|
|
137
|
+
}
|
|
138
|
+
if (url.username || url.password) {
|
|
139
|
+
return { ok: false, reason: "endpoint must not contain credentials" };
|
|
140
|
+
}
|
|
141
|
+
if (url.hash)
|
|
142
|
+
return { ok: false, reason: "endpoint must not contain a fragment" };
|
|
143
|
+
if (value.length > 2048)
|
|
144
|
+
return { ok: false, reason: "endpoint is too long" };
|
|
145
|
+
return { ok: true };
|
|
146
|
+
}
|
|
147
|
+
/** Красивый preview payload для dryRun и окна подтверждения (F-3.1). */
|
|
148
|
+
export function buildReportPreview(payload) {
|
|
149
|
+
const lines = [
|
|
150
|
+
"=== FEEDBACK PAYLOAD (dryRun — ничего не отправлено) ===",
|
|
151
|
+
`schemaVersion: ${payload.schemaVersion}`,
|
|
152
|
+
`reportId: ${payload.reportId}`,
|
|
153
|
+
`createdAt: ${payload.createdAt}`,
|
|
154
|
+
`pluginVersion: ${payload.pluginVersion}`,
|
|
155
|
+
`os: ${payload.os.platform} ${payload.os.release} ${payload.os.arch}`,
|
|
156
|
+
`node: ${payload.node}`,
|
|
157
|
+
`locale: ${payload.locale}`,
|
|
158
|
+
`profile: ${payload.profile}`,
|
|
159
|
+
];
|
|
160
|
+
if (payload.taskName)
|
|
161
|
+
lines.push(`taskName: ${payload.taskName}`);
|
|
162
|
+
lines.push(`description: ${payload.description}`);
|
|
163
|
+
if (payload.contactEmail)
|
|
164
|
+
lines.push(`contactEmail: ${payload.contactEmail}`);
|
|
165
|
+
if (payload.redactedLogs)
|
|
166
|
+
lines.push(`redactedLogs (${payload.redactedLogs.length} chars): ${payload.redactedLogs}`);
|
|
167
|
+
if (payload.metrics)
|
|
168
|
+
lines.push(`metrics: ${JSON.stringify(payload.metrics)}`);
|
|
169
|
+
return lines.join("\n");
|
|
170
|
+
}
|
|
171
|
+
function sleep(ms) {
|
|
172
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
173
|
+
}
|
|
174
|
+
/** Одна попытка POST с таймаутом (F-1.2). */
|
|
175
|
+
export async function sendFeedbackOnce(payload, endpoint, fetchImpl = globalThis.fetch) {
|
|
176
|
+
const controller = new AbortController();
|
|
177
|
+
const timer = setTimeout(() => controller.abort(), FEEDBACK_TIMEOUT_MS);
|
|
178
|
+
try {
|
|
179
|
+
const response = await fetchImpl(endpoint, {
|
|
180
|
+
method: "POST",
|
|
181
|
+
headers: {
|
|
182
|
+
"content-type": "application/json",
|
|
183
|
+
"user-agent": `agent-steward/${payload.pluginVersion}`,
|
|
184
|
+
"x-report-id": payload.reportId,
|
|
185
|
+
},
|
|
186
|
+
body: JSON.stringify(payload),
|
|
187
|
+
signal: controller.signal,
|
|
188
|
+
});
|
|
189
|
+
const body = await response.text();
|
|
190
|
+
let parsed = {};
|
|
191
|
+
try {
|
|
192
|
+
parsed = JSON.parse(body);
|
|
193
|
+
}
|
|
194
|
+
catch {
|
|
195
|
+
// Не JSON — считаем ошибкой, textual body не логируем целиком (PII).
|
|
196
|
+
}
|
|
197
|
+
return {
|
|
198
|
+
ok: response.ok,
|
|
199
|
+
reportId: payload.reportId,
|
|
200
|
+
attempts: 1,
|
|
201
|
+
status: response.status,
|
|
202
|
+
issueUrl: typeof parsed.issueUrl === "string" ? parsed.issueUrl : undefined,
|
|
203
|
+
error: response.ok ? undefined : (parsed.error ?? `HTTP ${response.status}`),
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
catch (err) {
|
|
207
|
+
return {
|
|
208
|
+
ok: false,
|
|
209
|
+
reportId: payload.reportId,
|
|
210
|
+
attempts: 1,
|
|
211
|
+
error: err instanceof Error ? err.message : String(err),
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
finally {
|
|
215
|
+
clearTimeout(timer);
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
/** POST с 2 ретраями и экспоненциальным backoff (F-1.2). */
|
|
219
|
+
export async function sendFeedbackWithRetry(payload, endpoint, options = {}) {
|
|
220
|
+
const retries = options.retries ?? FEEDBACK_MAX_RETRIES;
|
|
221
|
+
const delay = options.baseDelayMs ?? FEEDBACK_BACKOFF_MS;
|
|
222
|
+
const sleepFn = options.sleepFn ?? sleep;
|
|
223
|
+
let last = {
|
|
224
|
+
ok: false,
|
|
225
|
+
reportId: payload.reportId,
|
|
226
|
+
attempts: 0,
|
|
227
|
+
error: "no attempt made",
|
|
228
|
+
};
|
|
229
|
+
for (let attempt = 0; attempt <= retries; attempt++) {
|
|
230
|
+
last = await sendFeedbackOnce(payload, endpoint, options.fetchImpl);
|
|
231
|
+
last.attempts = attempt + 1;
|
|
232
|
+
if (last.ok)
|
|
233
|
+
return last;
|
|
234
|
+
// 4xx (кроме 429) — ошибка контракта, повтор не поможет.
|
|
235
|
+
if (last.status && last.status >= 400 && last.status < 500 && last.status !== 429)
|
|
236
|
+
break;
|
|
237
|
+
if (attempt < retries)
|
|
238
|
+
await sleepFn(delay * 2 ** attempt);
|
|
239
|
+
}
|
|
240
|
+
return last;
|
|
241
|
+
}
|
|
242
|
+
/* ------------------------------------------------------------------ */
|
|
243
|
+
/* Outbox (F-1.6) */
|
|
244
|
+
/* ------------------------------------------------------------------ */
|
|
245
|
+
export function enqueueOutbox(payload) {
|
|
246
|
+
const db = getDb();
|
|
247
|
+
db.prepare(`INSERT OR IGNORE INTO feedback_outbox
|
|
248
|
+
(id, report_id, payload_json, attempts, created_at)
|
|
249
|
+
VALUES (?, ?, ?, 0, ?)`).run(payload.reportId, payload.reportId, JSON.stringify(payload), new Date().toISOString());
|
|
250
|
+
}
|
|
251
|
+
export function listOutbox(limit = 20) {
|
|
252
|
+
return getDb()
|
|
253
|
+
.prepare("SELECT id, report_id, payload_json, attempts, last_error, created_at, last_attempt_at FROM feedback_outbox ORDER BY created_at ASC LIMIT ?")
|
|
254
|
+
.all(limit);
|
|
255
|
+
}
|
|
256
|
+
function deleteOutbox(reportId) {
|
|
257
|
+
getDb().prepare("DELETE FROM feedback_outbox WHERE report_id = ?").run(reportId);
|
|
258
|
+
}
|
|
259
|
+
function recordOutboxAttempt(reportId, error) {
|
|
260
|
+
const row = getDb()
|
|
261
|
+
.prepare("SELECT attempts FROM feedback_outbox WHERE report_id = ?")
|
|
262
|
+
.get(reportId);
|
|
263
|
+
const attempts = (row?.attempts ?? 0) + 1;
|
|
264
|
+
if (attempts >= FEEDBACK_OUTBOX_MAX_ATTEMPTS) {
|
|
265
|
+
deleteOutbox(reportId);
|
|
266
|
+
return;
|
|
267
|
+
}
|
|
268
|
+
getDb()
|
|
269
|
+
.prepare("UPDATE feedback_outbox SET attempts = ?, last_error = ?, last_attempt_at = ? WHERE report_id = ?")
|
|
270
|
+
.run(attempts, error.slice(0, 500), new Date().toISOString(), reportId);
|
|
271
|
+
}
|
|
272
|
+
/** Повтор outbox при старте плагина. Никогда не бросает наружу. */
|
|
273
|
+
export async function flushOutbox(settings, options = {}) {
|
|
274
|
+
if (!settings.enabled || !validateFeedbackEndpoint(settings.endpoint).ok) {
|
|
275
|
+
return { processed: 0, sent: 0 };
|
|
276
|
+
}
|
|
277
|
+
let processed = 0;
|
|
278
|
+
let sent = 0;
|
|
279
|
+
for (const row of listOutbox(20)) {
|
|
280
|
+
let payload;
|
|
281
|
+
try {
|
|
282
|
+
payload = JSON.parse(row.payload_json);
|
|
283
|
+
}
|
|
284
|
+
catch {
|
|
285
|
+
deleteOutbox(row.report_id);
|
|
286
|
+
continue;
|
|
287
|
+
}
|
|
288
|
+
processed++;
|
|
289
|
+
const result = await sendFeedbackWithRetry(payload, settings.endpoint, {
|
|
290
|
+
retries: 0,
|
|
291
|
+
sleepFn: options.sleepFn,
|
|
292
|
+
fetchImpl: options.fetchImpl,
|
|
293
|
+
});
|
|
294
|
+
if (result.ok) {
|
|
295
|
+
deleteOutbox(row.report_id);
|
|
296
|
+
sent++;
|
|
297
|
+
}
|
|
298
|
+
else {
|
|
299
|
+
recordOutboxAttempt(row.report_id, result.error ?? "unknown error");
|
|
300
|
+
}
|
|
301
|
+
}
|
|
302
|
+
return { processed, sent };
|
|
303
|
+
}
|
|
304
|
+
/* ------------------------------------------------------------------ */
|
|
305
|
+
/* Антиспам (F-1.7) */
|
|
306
|
+
/* ------------------------------------------------------------------ */
|
|
307
|
+
/** Решение антиспама по истории отправок. Чистая функция. */
|
|
308
|
+
export function evaluateAntispam(records, description, now, maxPerHour = FEEDBACK_MAX_PER_HOUR) {
|
|
309
|
+
const hash = descriptionHash(description);
|
|
310
|
+
const hourAgo = now.getTime() - 60 * 60000;
|
|
311
|
+
const windowAgo = now.getTime() - FEEDBACK_ANTISPAM_WINDOW_MS;
|
|
312
|
+
const recent = records.filter((r) => {
|
|
313
|
+
const at = Date.parse(r.at);
|
|
314
|
+
return Number.isFinite(at) && at >= hourAgo;
|
|
315
|
+
});
|
|
316
|
+
if (recent.some((r) => r.hash === hash && Date.parse(r.at) >= windowAgo)) {
|
|
317
|
+
return { allowed: false, reason: "duplicate" };
|
|
318
|
+
}
|
|
319
|
+
if (recent.length >= maxPerHour)
|
|
320
|
+
return { allowed: false, reason: "rate_limited" };
|
|
321
|
+
return { allowed: true };
|
|
322
|
+
}
|
|
323
|
+
export function recordFeedbackSent(payload) {
|
|
324
|
+
getDb()
|
|
325
|
+
.prepare("INSERT INTO feedback_spam (hash, at) VALUES (?, ?)")
|
|
326
|
+
.run(descriptionHash(payload.description), payload.createdAt);
|
|
327
|
+
}
|
|
328
|
+
function recentAntispam(now) {
|
|
329
|
+
return getDb()
|
|
330
|
+
.prepare("SELECT at, hash FROM feedback_spam WHERE at >= ? ORDER BY at DESC LIMIT 200")
|
|
331
|
+
.all(new Date(now.getTime() - 60 * 60000).toISOString());
|
|
332
|
+
}
|
|
333
|
+
/**
|
|
334
|
+
* Точка входа для report_bug (F-1.5).
|
|
335
|
+
*
|
|
336
|
+
* - dryRun — только preview, сеть не трогается;
|
|
337
|
+
* - author — POST на приёмник; при ошибке fail-open → outbox;
|
|
338
|
+
* - local — старые каналы уведомлений (+ outbox как страховка);
|
|
339
|
+
* - both — и приёмник, и локальные каналы.
|
|
340
|
+
*
|
|
341
|
+
* Если приёмник не настроен или отключён, destination=author деградирует
|
|
342
|
+
* до local (fail-open), что честно отражается в `mode`.
|
|
343
|
+
*/
|
|
344
|
+
export async function reportFeedback(options) {
|
|
345
|
+
const now = options.now ?? new Date();
|
|
346
|
+
const logRedactOptions = {
|
|
347
|
+
secrets: options.secrets,
|
|
348
|
+
home: options.home,
|
|
349
|
+
redactEmails: true,
|
|
350
|
+
};
|
|
351
|
+
const descRedactOptions = { ...logRedactOptions, redactEmails: false };
|
|
352
|
+
const redactedLogs = options.redactedLogs
|
|
353
|
+
? redactText(options.redactedLogs, logRedactOptions)
|
|
354
|
+
: undefined;
|
|
355
|
+
const payload = buildFeedbackPayload({
|
|
356
|
+
description: redactText(options.description, descRedactOptions),
|
|
357
|
+
taskName: options.taskName,
|
|
358
|
+
contactEmail: options.contactEmail,
|
|
359
|
+
redactedLogs,
|
|
360
|
+
metrics: options.metrics,
|
|
361
|
+
locale: options.locale,
|
|
362
|
+
profile: options.profile,
|
|
363
|
+
now,
|
|
364
|
+
}, {});
|
|
365
|
+
if (options.dryRun) {
|
|
366
|
+
return {
|
|
367
|
+
success: true,
|
|
368
|
+
reportId: payload.reportId,
|
|
369
|
+
destination: options.destination,
|
|
370
|
+
mode: "dryRun",
|
|
371
|
+
preview: buildReportPreview(payload),
|
|
372
|
+
};
|
|
373
|
+
}
|
|
374
|
+
const antispam = evaluateAntispam(recentAntispam(now), payload.description, now, options.settings.maxPerHour);
|
|
375
|
+
if (!antispam.allowed) {
|
|
376
|
+
return {
|
|
377
|
+
success: true,
|
|
378
|
+
reportId: payload.reportId,
|
|
379
|
+
destination: options.destination,
|
|
380
|
+
mode: "duplicate",
|
|
381
|
+
error: antispam.reason,
|
|
382
|
+
};
|
|
383
|
+
}
|
|
384
|
+
const endpointOk = options.settings.enabled && validateFeedbackEndpoint(options.settings.endpoint).ok;
|
|
385
|
+
const wantAuthor = options.destination === "author" || options.destination === "both";
|
|
386
|
+
const wantLocal = options.destination === "local" || options.destination === "both" || !endpointOk;
|
|
387
|
+
let author;
|
|
388
|
+
let mode = "local";
|
|
389
|
+
let success = true;
|
|
390
|
+
if (wantAuthor) {
|
|
391
|
+
author = await sendFeedbackWithRetry(payload, options.settings.endpoint, {
|
|
392
|
+
fetchImpl: options.fetchImpl,
|
|
393
|
+
sleepFn: options.sleepFn,
|
|
394
|
+
});
|
|
395
|
+
if (author.ok) {
|
|
396
|
+
mode = "sent";
|
|
397
|
+
recordFeedbackSent(payload);
|
|
398
|
+
}
|
|
399
|
+
else {
|
|
400
|
+
mode = "outbox";
|
|
401
|
+
success = false;
|
|
402
|
+
enqueueOutbox(payload);
|
|
403
|
+
}
|
|
404
|
+
}
|
|
405
|
+
else {
|
|
406
|
+
// Нет рабочего приёмника — сохраняем отчёт локально, чтобы не потерять.
|
|
407
|
+
enqueueOutbox(payload);
|
|
408
|
+
recordFeedbackSent(payload);
|
|
409
|
+
}
|
|
410
|
+
if (wantLocal && options.sendLocal && options.localText) {
|
|
411
|
+
const localResult = await options.sendLocal(options.localText);
|
|
412
|
+
if (!localResult.success && mode !== "sent") {
|
|
413
|
+
success = false;
|
|
414
|
+
}
|
|
415
|
+
if (mode === "local")
|
|
416
|
+
mode = author?.ok ? "sent" : "local";
|
|
417
|
+
}
|
|
418
|
+
return {
|
|
419
|
+
success,
|
|
420
|
+
reportId: payload.reportId,
|
|
421
|
+
destination: options.destination,
|
|
422
|
+
mode,
|
|
423
|
+
author,
|
|
424
|
+
error: author?.error,
|
|
425
|
+
};
|
|
426
|
+
}
|
|
@@ -26,6 +26,42 @@ export declare function verifyGateSnapshot(snapshotFile: string, inputs: GateSna
|
|
|
26
26
|
ok: boolean;
|
|
27
27
|
reason?: string;
|
|
28
28
|
};
|
|
29
|
+
/**
|
|
30
|
+
* PL-25: состояние отслеживаемых исходников на границе прогона.
|
|
31
|
+
*
|
|
32
|
+
* Хэш входов гейта (G-1.2) защищает от подмены самой команды, но не от
|
|
33
|
+
* чужого незакоммиченного кода: параллельная задача может изменить `src/`
|
|
34
|
+
* между стартом runners и post-flight гейтом, и гейт «позеленеет» на
|
|
35
|
+
* уже другом дереве. Фиксируем HEAD + `git status --porcelain` для `src/`.
|
|
36
|
+
*/
|
|
37
|
+
export interface WorktreeSnapshot {
|
|
38
|
+
version: number;
|
|
39
|
+
head: string;
|
|
40
|
+
status: string;
|
|
41
|
+
capturedAt: string;
|
|
42
|
+
}
|
|
43
|
+
export declare const WORKTREE_SNAPSHOT_VERSION = 1;
|
|
44
|
+
/** Пути, за которыми следит гейт; по умолчанию только исходники плагина. */
|
|
45
|
+
export declare function worktreeGuardPaths(env?: NodeJS.ProcessEnv): string[];
|
|
46
|
+
/**
|
|
47
|
+
* PL-47: пути, которые задача изменить вправе (обычно из `-Files` afterScript).
|
|
48
|
+
* Исключаются из сравнения со snapshot: агент спокойно правит свои файлы,
|
|
49
|
+
* а чужие правки в остальной части `src/` по-прежнему срывают гейт.
|
|
50
|
+
*/
|
|
51
|
+
export declare function worktreeAllowPaths(env?: NodeJS.ProcessEnv): string[];
|
|
52
|
+
/** Возвращает null, если каталог не git-репозиторий или git недоступен. */
|
|
53
|
+
export declare function readWorktreeState(dir: string, env?: NodeJS.ProcessEnv): {
|
|
54
|
+
head: string;
|
|
55
|
+
status: string;
|
|
56
|
+
} | null;
|
|
57
|
+
/** Пишет snapshot дерева; null — не git-репозиторий (гейт не блокируем). */
|
|
58
|
+
export declare function captureWorktreeSnapshot(dir: string, outFile: string, env?: NodeJS.ProcessEnv): string | null;
|
|
59
|
+
export declare function readWorktreeSnapshot(file: string): WorktreeSnapshot | null;
|
|
60
|
+
/** Сверяет дерево со snapshot'ом, снятым на старте задачи. */
|
|
61
|
+
export declare function verifyWorktreeSnapshot(dir: string, file: string, env?: NodeJS.ProcessEnv): {
|
|
62
|
+
ok: boolean;
|
|
63
|
+
reason?: string;
|
|
64
|
+
};
|
|
29
65
|
/**
|
|
30
66
|
* CLI для обёрток: `node gate-integrity.js verify --snapshot <file>
|
|
31
67
|
* --gate-file <file> | --gate-command <text> --prompt-file <file> --timeout <n>`.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gate-integrity.d.ts","sourceRoot":"","sources":["../../src/core/gate-integrity.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"gate-integrity.d.ts","sourceRoot":"","sources":["../../src/core/gate-integrity.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAQjE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAWD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,YAAY,SAA6B,GACxC,MAAM,CAaR;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgBlE;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,kBAAkB,GACzB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAclC;AAOD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAKjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAOjF;AAmBD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBzC;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAgB1E;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBlC;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDxE"}
|