agent-work-loop 0.0.0 → 0.6.23

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.
Files changed (54) hide show
  1. package/README.md +272 -12
  2. package/dist/brief-Z3JKXEUP.js +181 -0
  3. package/dist/changelog-R7BNBF2C.js +62 -0
  4. package/dist/chunk-46HZN6UB.js +446 -0
  5. package/dist/chunk-4OCSYHYB.js +274 -0
  6. package/dist/chunk-6E7XEQOH.js +27 -0
  7. package/dist/chunk-7SYRDDTX.js +516 -0
  8. package/dist/chunk-BUWGQVHT.js +1243 -0
  9. package/dist/chunk-C7BR2DCS.js +96 -0
  10. package/dist/chunk-D5OINC3G.js +52 -0
  11. package/dist/chunk-DP4O5ME2.js +307 -0
  12. package/dist/chunk-F5LHXBH7.js +209 -0
  13. package/dist/chunk-G5LAJ5TV.js +453 -0
  14. package/dist/chunk-I77CXOEX.js +693 -0
  15. package/dist/chunk-IMB46O6S.js +286 -0
  16. package/dist/chunk-IXMAFR4Y.js +771 -0
  17. package/dist/chunk-QE2CLNBG.js +347 -0
  18. package/dist/chunk-UOPWVM2H.js +727 -0
  19. package/dist/chunk-YTAHVR4P.js +166 -0
  20. package/dist/chunk-ZE6HXOYG.js +904 -0
  21. package/dist/cli.js +374 -13
  22. package/dist/commit-APXIVOSD.js +411 -0
  23. package/dist/config-TFMW7O4T.js +34 -0
  24. package/dist/doctor-SSKNLPGH.js +29 -0
  25. package/dist/evolve-QPD7TWGO.js +38 -0
  26. package/dist/feedback-KAXNFMUY.js +125 -0
  27. package/dist/gotchas-MCA5Y76R.js +43 -0
  28. package/dist/hold-recheck-WN5EG7HD.js +133 -0
  29. package/dist/init-UDM5AXKI.js +79 -0
  30. package/dist/lane-DAZISODH.js +41 -0
  31. package/dist/loop-summary-XAI6KOGB.js +361 -0
  32. package/dist/metrics-WLRZZRTK.js +25 -0
  33. package/dist/record-UKDIUJ5T.js +68 -0
  34. package/dist/review-ZTHDJ47V.js +118 -0
  35. package/dist/rules-R2UZPIVW.js +33 -0
  36. package/dist/state-XM7NZ2HA.js +37 -0
  37. package/dist/status-L6U5KO6T.js +40 -0
  38. package/dist/uninstall-5DFEOFL5.js +545 -0
  39. package/dist/update-AYTBYAHI.js +61 -0
  40. package/dist/verify-L7ARTK42.js +37 -0
  41. package/dist/version-check-LKGU2DNF.js +14 -0
  42. package/dist/work-KEPTGZ6H.js +50 -0
  43. package/engine/skills/claude/awl-loop/SKILL.md +292 -0
  44. package/engine/skills/claude/awl-loop/reference.md +131 -0
  45. package/engine/skills/claude/awl-pipeline/SKILL.md +89 -0
  46. package/engine/skills/claude/awl-pipeline-exec/SKILL.md +200 -0
  47. package/engine/skills/claude/awl-pipeline-plan/SKILL.md +71 -0
  48. package/engine/skills/claude/awl-pipeline-review/SKILL.md +149 -0
  49. package/engine/skills/codex/AGENTS.awl.md +117 -0
  50. package/engine/templates/block-publish.mjs +9 -0
  51. package/engine/templates/pre-push.sample +7 -0
  52. package/engine/templates/related-cmd-examples.md +37 -0
  53. package/engine/version.json +2 -2
  54. package/package.json +10 -4
@@ -0,0 +1,286 @@
1
+ import {
2
+ acquireLock,
3
+ loadGotchaList,
4
+ releaseLock
5
+ } from "./chunk-G5LAJ5TV.js";
6
+ import {
7
+ caps,
8
+ card,
9
+ makeColors,
10
+ rulesDir,
11
+ signal
12
+ } from "./chunk-7SYRDDTX.js";
13
+
14
+ // src/commands/rules.ts
15
+ import { spawnSync } from "child_process";
16
+ import fs from "fs";
17
+ import path from "path";
18
+ function parseRuleFile(text, file) {
19
+ const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text);
20
+ if (!m) {
21
+ return { rule: null, warnings: [`${file}: frontmatter \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4`] };
22
+ }
23
+ const data = {};
24
+ for (const line of (m[1] ?? "").split(/\r?\n/)) {
25
+ const kv = /^(\w+):\s*(.*)$/.exec(line.trim());
26
+ if (kv?.[1]) {
27
+ data[kv[1]] = (kv[2] ?? "").trim();
28
+ }
29
+ }
30
+ const warnings = [];
31
+ if (!data.id) {
32
+ warnings.push(`${file}: id \uC5C6\uC74C`);
33
+ }
34
+ if (!data.applies) {
35
+ warnings.push(`${file}: applies \uC5C6\uC74C (\uD544\uC218)`);
36
+ }
37
+ if (!data.counter) {
38
+ warnings.push(
39
+ `${file}: counter \uC5C6\uC74C (\uD544\uC218 \u2014 \uBC18\uC99D \uC870\uAC74 \uC5C6\uB294 \uADDC\uCE59\uC740 \uAC80\uC99D \uBD88\uAC00\uB2A5\uD55C \uC2E0\uB150\uC774 \uB429\uB2C8\uB2E4)`
40
+ );
41
+ }
42
+ const rule = {
43
+ id: data.id ?? path.basename(file, ".md"),
44
+ scope: data.scope || void 0,
45
+ applies: data.applies ?? "",
46
+ counter: data.counter ?? "",
47
+ violations: data.violations ? Number(data.violations) : 0,
48
+ createdAt: data.createdAt,
49
+ body: (m[2] ?? "").trim(),
50
+ file
51
+ };
52
+ return { rule, warnings };
53
+ }
54
+ function activeRulesDir() {
55
+ return path.join(rulesDir(), "active");
56
+ }
57
+ function loadRules() {
58
+ const dir = activeRulesDir();
59
+ let files;
60
+ try {
61
+ files = fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
62
+ } catch {
63
+ return { rules: [], warnings: [] };
64
+ }
65
+ const rules = [];
66
+ const warnings = [];
67
+ for (const f of files.sort()) {
68
+ let text;
69
+ try {
70
+ text = fs.readFileSync(path.join(dir, f), "utf8");
71
+ } catch {
72
+ continue;
73
+ }
74
+ const parsed = parseRuleFile(text, f);
75
+ warnings.push(...parsed.warnings);
76
+ if (parsed.rule) {
77
+ rules.push(parsed.rule);
78
+ }
79
+ }
80
+ return { rules, warnings };
81
+ }
82
+ function filterRules(rules, opts) {
83
+ return rules.filter((r) => {
84
+ if (opts.scope && r.scope && r.scope !== opts.scope) {
85
+ return false;
86
+ }
87
+ return true;
88
+ });
89
+ }
90
+ function renderRules(rules, warnings, c) {
91
+ const color = makeColors(c.color);
92
+ const out = [];
93
+ for (const w of warnings) {
94
+ out.push(`${color.yellow("\uACBD\uACE0")} ${w}`);
95
+ }
96
+ if (warnings.length > 0) {
97
+ out.push("");
98
+ }
99
+ if (rules.length === 0) {
100
+ out.push("\uC801\uC6A9\uB418\uB294 \uADDC\uCE59\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
101
+ out.push("");
102
+ out.push(color.dim("\uADDC\uCE59\uC740 \uC791\uC5C5\uD558\uB2E4 \uAC19\uC740 \uC2E4\uD328\uB97C \uB450 \uBC88 \uD560 \uB54C \uC313\uC785\uB2C8\uB2E4."));
103
+ return card("\uADDC\uCE59", out, c);
104
+ }
105
+ for (const r of rules) {
106
+ const scope = r.scope ? color.dim(`[${r.scope}]`) : color.dim("[\uBC94\uC6A9]");
107
+ out.push(`${color.bold(r.id)} ${scope}`);
108
+ out.push(` ${r.body.split("\n")[0] ?? ""}`);
109
+ }
110
+ return card(`\uADDC\uCE59 ${rules.length}\uAC1C`, out, c);
111
+ }
112
+ function runRules(opts) {
113
+ if (opts.edit) {
114
+ const dir = activeRulesDir();
115
+ fs.mkdirSync(dir, { recursive: true });
116
+ const editor = process.env.EDITOR || process.env.VISUAL || "vi";
117
+ const r = spawnSync(editor, [dir], { stdio: "inherit" });
118
+ process.exit(r.status ?? 0);
119
+ }
120
+ const { rules, warnings } = loadRules();
121
+ const filtered = filterRules(rules, { scope: opts.scope });
122
+ if (opts.json) {
123
+ process.stdout.write(`${JSON.stringify({ rules: filtered, warnings }, null, 2)}
124
+ `);
125
+ return;
126
+ }
127
+ process.stdout.write(`${renderRules(filtered, warnings, caps())}
128
+ `);
129
+ }
130
+ function nextRuleId() {
131
+ let max = 0;
132
+ try {
133
+ for (const f of fs.readdirSync(activeRulesDir())) {
134
+ const m = /^R-(\d+)\.md$/.exec(f);
135
+ if (m?.[1]) {
136
+ max = Math.max(max, Number(m[1]));
137
+ }
138
+ }
139
+ } catch {
140
+ }
141
+ return `R-${String(max + 1).padStart(3, "0")}`;
142
+ }
143
+ function suggestLinter(lesson) {
144
+ const l = lesson.toLowerCase();
145
+ if (/\bany\b/.test(l)) {
146
+ return {
147
+ rule: "@typescript-eslint/no-explicit-any",
148
+ hint: "eslint \uC758 @typescript-eslint/no-explicit-any \uADDC\uCE59\uC744 \uCF1C\uC138\uC694."
149
+ };
150
+ }
151
+ if (/ts-ignore|ts-expect-error/.test(l)) {
152
+ return {
153
+ rule: "@typescript-eslint/ban-ts-comment",
154
+ hint: "eslint \uC758 @typescript-eslint/ban-ts-comment \uADDC\uCE59\uC744 \uCF1C\uC138\uC694."
155
+ };
156
+ }
157
+ if (/eslint-disable/.test(l)) {
158
+ return {
159
+ rule: "eslint-comments/no-use",
160
+ hint: "eslint-comments \uD50C\uB7EC\uADF8\uC778\uC73C\uB85C \uC8FC\uC11D \uBE44\uD65C\uC131\uD654\uB97C \uB9C9\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4."
161
+ };
162
+ }
163
+ if (/console\.log/.test(l)) {
164
+ return { rule: "no-console", hint: "eslint \uC758 no-console \uADDC\uCE59\uC744 \uCF1C\uC138\uC694." };
165
+ }
166
+ return null;
167
+ }
168
+ var RULE_LOAD_LIMIT = 15;
169
+ function validatePromoteOpts(opts) {
170
+ const missing = [];
171
+ if (!opts.applies || opts.applies.trim() === "") {
172
+ missing.push("applies");
173
+ }
174
+ if (!opts.counter || opts.counter.trim() === "") {
175
+ missing.push("counter");
176
+ }
177
+ return missing;
178
+ }
179
+ function buildRuleFile(ruleId, gotcha, createdAt, opts) {
180
+ return [
181
+ "---",
182
+ `id: ${ruleId}`,
183
+ ...opts.scope ? [`scope: ${opts.scope}`] : [],
184
+ `applies: ${opts.applies}`,
185
+ `counter: ${opts.counter}`,
186
+ "violations: 0",
187
+ `createdAt: ${createdAt}`,
188
+ `source: ${gotcha.id}`,
189
+ "---",
190
+ "",
191
+ gotcha.lesson,
192
+ ""
193
+ ].join("\n");
194
+ }
195
+ function checkRuleLoadLimit(loadedCount) {
196
+ if (loadedCount <= RULE_LOAD_LIMIT) {
197
+ return null;
198
+ }
199
+ return `\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uB85C\uB4DC\uB418\uB294 \uADDC\uCE59\uC774 ${loadedCount}\uAC1C\uC785\uB2C8\uB2E4(${RULE_LOAD_LIMIT}\uAC1C \uAD8C\uC7A5). \uAC80\uC0AC\uAE30\uB85C \uC878\uC5C5\uC2DC\uD0AC \uADDC\uCE59\uC774 \uC5C6\uB294\uC9C0 \uBCF4\uC138\uC694.`;
200
+ }
201
+ function runRulesPromote(gotchaId, opts) {
202
+ const gotcha = loadGotchaList().find((g) => g.id === gotchaId);
203
+ if (!gotcha) {
204
+ process.stderr.write(
205
+ `
206
+ ${signal(caps(), "error")} \uAD50\uD6C8 ${gotchaId} \uC744(\uB97C) \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.
207
+ `
208
+ );
209
+ process.exit(1);
210
+ }
211
+ const missing = validatePromoteOpts(opts);
212
+ if (missing.includes("applies")) {
213
+ process.stderr.write(
214
+ `
215
+ ${signal(caps(), "error")} applies(\uC801\uC6A9 \uC870\uAC74)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. --applies "..." \uB85C \uC8FC\uC138\uC694.
216
+ \uC801\uC6A9 \uC870\uAC74 \uC5C6\uB294 \uADDC\uCE59\uC740 \uB2E4\uB978 \uD504\uB85C\uC81D\uD2B8\uB85C \uC798\uBABB \uB04C\uB824\uAC11\uB2C8\uB2E4.
217
+ `
218
+ );
219
+ process.exit(1);
220
+ }
221
+ if (missing.includes("counter")) {
222
+ process.stderr.write(
223
+ `
224
+ ${signal(caps(), "error")} counter(\uBC18\uC99D \uC870\uAC74)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. --counter "..." \uB85C \uC8FC\uC138\uC694.
225
+ \uBC18\uC99D \uC870\uAC74 \uC5C6\uB294 \uADDC\uCE59\uC740 \uAC80\uC99D \uBD88\uAC00\uB2A5\uD55C \uC2E0\uB150\uC774 \uB429\uB2C8\uB2E4.
226
+ `
227
+ );
228
+ process.exit(1);
229
+ }
230
+ const c = caps();
231
+ const color = makeColors(c.color);
232
+ if (!acquireLock()) {
233
+ process.stderr.write(
234
+ `
235
+ ${signal(c, "warn")} \uB2E4\uB978 evolve/promote \uAC00 \uC2E4\uD589 \uC911\uC785\uB2C8\uB2E4(~/.awl/.lock).
236
+ `
237
+ );
238
+ process.exit(1);
239
+ }
240
+ try {
241
+ const ruleId = nextRuleId();
242
+ const createdAt = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
243
+ const front = buildRuleFile(ruleId, gotcha, createdAt, {
244
+ applies: opts.applies,
245
+ counter: opts.counter,
246
+ scope: opts.scope
247
+ });
248
+ fs.mkdirSync(activeRulesDir(), { recursive: true });
249
+ fs.writeFileSync(path.join(activeRulesDir(), `${ruleId}.md`), front);
250
+ process.stdout.write(`
251
+ ${color.green("\uC2B9\uACA9\uB428")}: ${ruleId} "${gotcha.lesson}"
252
+ `);
253
+ const linter = suggestLinter(gotcha.lesson);
254
+ if (linter) {
255
+ process.stdout.write("\n \uC774 \uADDC\uCE59\uC740 \uAC80\uC0AC\uAE30\uB85C \uB9CC\uB4E4 \uC218 \uC788\uC5B4 \uBCF4\uC785\uB2C8\uB2E4.\n");
256
+ process.stdout.write(
257
+ " \uAC80\uC0AC\uAE30\uB85C \uB9CC\uB4E4\uBA74 \uADDC\uCE59 \uBAA9\uB85D\uC5D0\uC11C \uBE60\uC9C0\uACE0, awl verify \uAC00 \uB300\uC2E0 \uC7A1\uC544\uC90D\uB2C8\uB2E4.\n"
258
+ );
259
+ process.stdout.write(` ${color.dim(`\uC548\uB0B4: ${linter.hint}`)}
260
+ `);
261
+ }
262
+ const loaded = filterRules(loadRules().rules, {});
263
+ const warning = checkRuleLoadLimit(loaded.length);
264
+ if (warning) {
265
+ process.stdout.write(`
266
+ ${color.yellow("\uACBD\uACE0")}: ${warning}
267
+ `);
268
+ }
269
+ } finally {
270
+ releaseLock();
271
+ }
272
+ }
273
+
274
+ export {
275
+ parseRuleFile,
276
+ activeRulesDir,
277
+ loadRules,
278
+ filterRules,
279
+ runRules,
280
+ suggestLinter,
281
+ RULE_LOAD_LIMIT,
282
+ validatePromoteOpts,
283
+ buildRuleFile,
284
+ checkRuleLoadLimit,
285
+ runRulesPromote
286
+ };