agent-quality-kit 0.4.0 → 0.4.1

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/README.md CHANGED
@@ -125,6 +125,21 @@ replaces. So `aqk badge` prints nothing over a red gate, and `aqk badge --check`
125
125
  pipeline on the day the README and the repository part ways. The badge at the top of this file
126
126
  is checked that way on every push.
127
127
 
128
+ ## In your pipeline
129
+
130
+ ```yaml
131
+ - uses: arsen-ask-lx/Agent_Quality_Kit@v0.4.1
132
+ with:
133
+ min: 1 # the build fails below AQK-1, or if any declared gate failed
134
+ ```
135
+
136
+ The action is a thin wrapper around one command and holds no logic of its own — without it,
137
+ the same thing in a single line:
138
+
139
+ ```yaml
140
+ - run: npx agent-quality-kit doctor --run --min 1
141
+ ```
142
+
128
143
  ## Installing a gate
129
144
 
130
145
  ```bash
package/README.ru.md CHANGED
@@ -124,6 +124,21 @@ aqk badge --check # в конвейере: код 1 в тот день, ког
124
124
  роняет конвейер в тот день, когда README и репозиторий разошлись. Значок в начале этого файла
125
125
  проверяется так на каждом пуше.
126
126
 
127
+ ## В твоём конвейере
128
+
129
+ ```yaml
130
+ - uses: arsen-ask-lx/Agent_Quality_Kit@v0.4.1
131
+ with:
132
+ min: 1 # сборка падает ниже AQK-1 или если упал любой объявленный гейт
133
+ ```
134
+
135
+ Действие — тонкая обёртка над одной командой и своей логики не имеет; без него то же самое
136
+ одной строкой:
137
+
138
+ ```yaml
139
+ - run: npx agent-quality-kit doctor --run --min 1
140
+ ```
141
+
127
142
  ## Поставить гейт
128
143
 
129
144
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-quality-kit",
3
- "version": "0.4.0",
3
+ "version": "0.4.1",
4
4
  "description": "AQK — Agent Quality Kit: переносимый комплект, приводящий проект в состояние, пригодное для работы агентов. Правила, механические упоры, накопленные уроки. Одна команда, любой инструмент.",
5
5
  "type": "module",
6
6
  "bin": {
package/tool/i18n/en.mjs CHANGED
@@ -361,7 +361,7 @@ export const en = {
361
361
  notReached: (cmd) => `AQK-0 is not reached — there is nothing to put on a badge. What is missing: ${cmd}`,
362
362
  redGates: (n, names) =>
363
363
  `Red gates: ${n} (${names}). A badge issued over a red gate is the author's claim, not a machine's fact.`,
364
- hint: (n) => `Proven by a run: ${n} gates, all green. Paste the line above into your README.`,
364
+ hint: (n) => `Proven by a run. Green gates: ${n}. Paste the line above into your README.`,
365
365
  keepTrue: (cmd) => `To keep the badge from turning into a lie, put this in your pipeline: ${cmd}`,
366
366
  checkMissing: (places) => `No AQK badge in any of: ${places}. This is the line to paste:`,
367
367
  checkMismatch: (where, level) => `The badge lies: ${where}, while the run says AQK-${level}. Replace it with:`,
package/tool/i18n/ru.mjs CHANGED
@@ -362,7 +362,7 @@ export const ru = {
362
362
  notReached: (cmd) => `AQK-0 не достигнут — значок выдавать не за что. Чего не хватает: ${cmd}`,
363
363
  redGates: (n, names) =>
364
364
  `Красных гейтов: ${n} (${names}). Значок при красном гейте — заявление автора, а не факт машины.`,
365
- hint: (n) => `Проверено прогоном: гейтов ${n}, все зелёные. Строку выше — в README.`,
365
+ hint: (n) => `Проверено прогоном. Зелёных гейтов: ${n}. Строку выше — в README.`,
366
366
  keepTrue: (cmd) => `Чтобы значок не превратился во враньё, поставь в конвейер: ${cmd}`,
367
367
  checkMissing: (places) => `Значка AQK нет ни в одном из файлов: ${places}. Вставить нужно этот:`,
368
368
  checkMismatch: (where, level) => `Значок врёт: ${where}, а прогон говорит AQK-${level}. Заменить на:`,
@@ -42,6 +42,7 @@ Running them is your job. The human looks at the list of holes and decides which
42
42
  | \`aqk find "…"\` | searches by meaning for an existing check | before inventing your own |
43
43
  | \`aqk note "…"\` | writes a lesson into the shared journal | the process or an instrument let you down: a check lied, a rule was bypassed |
44
44
  | \`aqk report\` | assembles a report from an actual run: what is in place and with which recipe, what is missing, what the kit told you to read | **mandatory** at the end of working with the kit — instead of a summary from memory |
45
+ | \`aqk badge\` | prints a level badge for the README — but only after running the declared gates, and stays silent over a red one; \`--check\` fails the pipeline when the badge stops matching the run | the human asked to show the level, or you are setting up CI |
45
46
 
46
47
  If there is no \`aqk\` command on the system, the kit was used without installing. Then write
47
48
  \`npx agent-quality-kit\` instead of \`aqk\`. Every command prints the invocation that will
@@ -47,6 +47,7 @@ const AGENTS_MD = `# AGENTS.md
47
47
  | \`aqk find "…"\` | ищет по смыслу, есть ли уже такая проверка | прежде чем изобретать свою |
48
48
  | \`aqk note "…"\` | пишет урок в общий журнал | процесс или прибор подвели: проверка соврала, правило обошли |
49
49
  | \`aqk report\` | собирает прогоном отчёт: что стоит и каким рецептом, чего нет, что комплект велел прочитать | **обязательно** в конце работы с комплектом — вместо пересказа по памяти |
50
+ | \`aqk badge\` | печатает значок уровня для README — но только после прогона объявленных гейтов, а при красном молчит; \`--check\` роняет конвейер, когда значок разошёлся с прогоном | человек попросил показать уровень; настраиваешь конвейер |
50
51
 
51
52
  Если команды \`aqk\` нет в системе — комплект ставили разово, без установки. Тогда вместо
52
53
  \`aqk\` пиши \`npx agent-quality-kit\`. Любая команда сама печатает тот