ai-engineering-loop 1.14.0 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/.agents/{workflows/ai-engineering-loop.md → skills/ai-engineering-loop/SKILL.md} +9 -7
  2. package/{.gemini → .agents}/skills/ai-engineering-loop/references/loop-deliver.md +1 -0
  3. package/.agents/skills/ai-engineering-loop/references/loop-hosts.md +48 -0
  4. package/.agents/skills/ai-engineering-loop/references/loop-maker.md +13 -0
  5. package/{.gemini → .agents}/skills/ai-engineering-loop/references/loop-review.md +2 -0
  6. package/.claude/skills/ai-engineering-loop/SKILL.md +10 -11
  7. package/.claude/skills/ai-engineering-loop/references/loop-deliver.md +1 -0
  8. package/.claude/skills/ai-engineering-loop/references/loop-hosts.md +48 -0
  9. package/.claude/skills/ai-engineering-loop/references/loop-maker.md +6 -1
  10. package/.claude/skills/ai-engineering-loop/references/loop-review.md +2 -0
  11. package/CHANGELOG.md +83 -0
  12. package/README.md +54 -6
  13. package/adapters/README.md +22 -0
  14. package/adapters/dot/README.md +19 -9
  15. package/adapters/dot/gitlab.md +49 -0
  16. package/adapters/dot/mattermost.md +10 -0
  17. package/adapters/dot/skills/dot-dev-workflow/SKILL.md +27 -5
  18. package/adapters/dot/sonar.md +90 -0
  19. package/adapters/generate-adapter/SKILL.md +6 -5
  20. package/adapters/{dot → quality}/skills/task-impact-inquiry/SKILL.md +10 -7
  21. package/agents/instruction-only/AGENTS.md +24 -0
  22. package/bin/ai-engineering-loop.js +320 -34
  23. package/core/grill-policy.md +1 -1
  24. package/core/orchestration-model.md +11 -0
  25. package/core/runtime-safety.md +2 -1
  26. package/lib/adapter-check.js +102 -0
  27. package/lib/adapter-detect.js +125 -0
  28. package/lib/auto-update.js +3 -1
  29. package/lib/cli-args.js +11 -0
  30. package/lib/doctor.js +13 -17
  31. package/lib/gates.js +28 -1
  32. package/lib/generate-adapter.js +6 -30
  33. package/lib/host-skill-build.js +25 -15
  34. package/lib/hosts/agent-formats.js +135 -0
  35. package/lib/hosts/commands.js +126 -0
  36. package/lib/hosts/detect.js +56 -0
  37. package/lib/hosts/doctor.js +77 -0
  38. package/lib/hosts/redetect.js +60 -0
  39. package/lib/hosts/registry.js +298 -0
  40. package/lib/hosts/table.js +43 -0
  41. package/lib/orchestration.js +39 -6
  42. package/lib/run-abandon.js +116 -0
  43. package/lib/studio-server.js +1 -0
  44. package/lib/sync-hosts.js +156 -112
  45. package/package.json +2 -3
  46. package/schemas/report.schema.json +52 -5
  47. package/.agents/devil-advocate.md +0 -79
  48. package/.agents/judge.md +0 -58
  49. package/.claude/commands/ai-engineering-loop.md +0 -11
  50. package/.gemini/skills/ai-engineering-loop/SKILL.md +0 -61
  51. package/.gemini/skills/ai-engineering-loop/references/loop-maker.md +0 -8
  52. package/.gemini/skills/animate/RECIPES.md +0 -324
  53. package/.gemini/skills/animate/SKILL.md +0 -207
  54. package/.gemini/skills/animate-expo/RECIPES.md +0 -385
  55. package/.gemini/skills/animate-expo/SKILL.md +0 -263
  56. package/.gemini/skills/animation-vocabulary/SKILL.md +0 -181
  57. package/.gemini/skills/apple-design/SKILL.md +0 -290
  58. package/.gemini/skills/ask-sonner/API.md +0 -64
  59. package/.gemini/skills/ask-sonner/SKILL.md +0 -88
  60. package/.gemini/skills/backend-development/SKILL.md +0 -272
  61. package/.gemini/skills/backend-development/references/api-design-guidelines.md +0 -95
  62. package/.gemini/skills/backend-development/references/query-and-database-best-practices.md +0 -53
  63. package/.gemini/skills/backend-development/references/security-checklist.md +0 -60
  64. package/.gemini/skills/emil-design-eng/SKILL.md +0 -674
  65. package/.gemini/skills/find-animation-opportunities/SKILL.md +0 -140
  66. package/.gemini/skills/improve-animations/AUDIT.md +0 -115
  67. package/.gemini/skills/improve-animations/PLAN-TEMPLATE.md +0 -73
  68. package/.gemini/skills/improve-animations/SKILL.md +0 -109
  69. package/.gemini/skills/mobile-native/SKILL.md +0 -311
  70. package/.gemini/skills/pick-ui-library/SKILL.md +0 -85
  71. package/.gemini/skills/prototype/PICKER.md +0 -197
  72. package/.gemini/skills/prototype/SKILL.md +0 -98
  73. package/.gemini/skills/review-animations/SKILL.md +0 -120
  74. package/.gemini/skills/review-animations/STANDARDS.md +0 -187
  75. package/.gemini/skills/write-swift/SKILL.md +0 -396
  76. package/.grok/commands/ai-engineering-loop.md +0 -11
  77. package/.grok/skills/ai-engineering-loop/SKILL.md +0 -62
  78. package/.grok/skills/ai-engineering-loop/references/loop-commands.md +0 -20
  79. package/.grok/skills/ai-engineering-loop/references/loop-deliver.md +0 -8
  80. package/.grok/skills/ai-engineering-loop/references/loop-goal.md +0 -10
  81. package/.grok/skills/ai-engineering-loop/references/loop-maker.md +0 -8
  82. package/.grok/skills/ai-engineering-loop/references/loop-review.md +0 -18
  83. package/.grok/skills/ai-engineering-loop/references/loop-risky.md +0 -9
  84. package/.grok/skills/ai-engineering-loop/references/loop-verify.md +0 -20
  85. package/.grok/skills/animate/RECIPES.md +0 -324
  86. package/.grok/skills/animate/SKILL.md +0 -207
  87. package/.grok/skills/animate-expo/RECIPES.md +0 -385
  88. package/.grok/skills/animate-expo/SKILL.md +0 -263
  89. package/.grok/skills/animation-vocabulary/SKILL.md +0 -181
  90. package/.grok/skills/apple-design/SKILL.md +0 -290
  91. package/.grok/skills/ask-sonner/API.md +0 -64
  92. package/.grok/skills/ask-sonner/SKILL.md +0 -88
  93. package/.grok/skills/backend-development/SKILL.md +0 -272
  94. package/.grok/skills/backend-development/references/api-design-guidelines.md +0 -95
  95. package/.grok/skills/backend-development/references/query-and-database-best-practices.md +0 -53
  96. package/.grok/skills/backend-development/references/security-checklist.md +0 -60
  97. package/.grok/skills/emil-design-eng/SKILL.md +0 -674
  98. package/.grok/skills/find-animation-opportunities/SKILL.md +0 -140
  99. package/.grok/skills/improve-animations/AUDIT.md +0 -115
  100. package/.grok/skills/improve-animations/PLAN-TEMPLATE.md +0 -73
  101. package/.grok/skills/improve-animations/SKILL.md +0 -109
  102. package/.grok/skills/mobile-native/SKILL.md +0 -311
  103. package/.grok/skills/pick-ui-library/SKILL.md +0 -85
  104. package/.grok/skills/prototype/PICKER.md +0 -197
  105. package/.grok/skills/prototype/SKILL.md +0 -98
  106. package/.grok/skills/review-animations/SKILL.md +0 -120
  107. package/.grok/skills/review-animations/STANDARDS.md +0 -187
  108. package/.grok/skills/write-swift/SKILL.md +0 -396
  109. /package/{.gemini → .agents}/skills/ai-engineering-loop/references/loop-commands.md +0 -0
  110. /package/{.gemini → .agents}/skills/ai-engineering-loop/references/loop-goal.md +0 -0
  111. /package/{.gemini → .agents}/skills/ai-engineering-loop/references/loop-risky.md +0 -0
  112. /package/{.gemini → .agents}/skills/ai-engineering-loop/references/loop-verify.md +0 -0
@@ -573,16 +573,21 @@ function buildGrokReviewSpawnPlan({
573
573
  /**
574
574
  * 12. Truthful Review Report Generator
575
575
  * Enforces mandatory reporting headers and strictly prevents misleading phrasing.
576
+ * When a non-independent mode is reported although native subagent invocation
577
+ * is AVAILABLE, the Execution Mode line must carry the reason (#57), so the
578
+ * header never looks contradictory.
576
579
  */
577
- function formatExecutionReport({ selectedMode, capabilityRegistry = {} }) {
578
- const isContextOnly = selectedMode.id === EXECUTION_MODES.CONTEXT_ISOLATION_ONLY.id;
580
+ const DEFAULT_ISOLATION_REASON = 'subagent available but no reviewer subagent returned its own result';
579
581
 
580
- const nativeSubagentState = capabilityRegistry.nativeSubagent?.invocationAvailable
581
- ? 'AVAILABLE'
582
- : 'UNAVAILABLE';
582
+ function formatExecutionReport({ selectedMode, capabilityRegistry = {}, reason = null }) {
583
+ const isContextOnly = selectedMode.id === EXECUTION_MODES.CONTEXT_ISOLATION_ONLY.id;
584
+ const nativeAvailable = Boolean(capabilityRegistry.nativeSubagent?.invocationAvailable);
585
+ const nativeSubagentState = nativeAvailable ? 'AVAILABLE' : 'UNAVAILABLE';
586
+ const needsReason = !selectedMode.isIndependentExecutionProven && (nativeAvailable || reason);
587
+ const why = String(reason || '').trim() || DEFAULT_ISOLATION_REASON;
583
588
 
584
589
  const lines = [
585
- `Execution Mode: ${selectedMode.id}`,
590
+ `Execution Mode: ${selectedMode.id}${needsReason ? ` (reason: ${why})` : ''}`,
586
591
  `Independent LLM Execution: ${selectedMode.isIndependentExecutionProven ? 'PROVEN' : 'NOT PROVEN'}`,
587
592
  `Native Subagent Invocation: ${nativeSubagentState}`,
588
593
  `Review Method: ${isContextOnly ? 'Clean-Slate Artifact Isolation Barrier' : selectedMode.label}`
@@ -591,6 +596,32 @@ function formatExecutionReport({ selectedMode, capabilityRegistry = {} }) {
591
596
  return lines.join('\n');
592
597
  }
593
598
 
599
+ /**
600
+ * 13. REPORT_ONLY (recipe `audit`) review policy (#57).
601
+ * A report-only audit has no Maker diff and no Judge, but its findings still
602
+ * benefit from one independent challenge when it is cheap: if the host can
603
+ * invoke a native subagent, spawn ONE fresh `devil-advocate` sibling on
604
+ * report.json before `gate report` (no Judge, no iteration loop). Otherwise the
605
+ * same check runs in-session as CONTEXT_ISOLATION_ONLY with an explicit reason.
606
+ */
607
+ function reportOnlyReviewPlan(capabilityRegistry = {}) {
608
+ const nativeAvailable = Boolean(capabilityRegistry.nativeSubagent?.invocationAvailable);
609
+ if (nativeAvailable) {
610
+ return {
611
+ spawn: 'devil-advocate',
612
+ judge: false,
613
+ expectedMode: EXECUTION_MODES.TRUE_INDEPENDENT_AGENT.id,
614
+ reason: null
615
+ };
616
+ }
617
+ return {
618
+ spawn: null,
619
+ judge: false,
620
+ expectedMode: EXECUTION_MODES.CONTEXT_ISOLATION_ONLY.id,
621
+ reason: 'no native subagent tool in this session'
622
+ };
623
+ }
624
+
594
625
  module.exports = {
595
626
  EXECUTION_MODES,
596
627
  EXECUTION_MODE_ALIASES,
@@ -605,6 +636,8 @@ module.exports = {
605
636
  isBlockingFinding,
606
637
  computeJudgeVerdict,
607
638
  formatExecutionReport,
639
+ reportOnlyReviewPlan,
640
+ DEFAULT_ISOLATION_REASON,
608
641
  detectGrokRuntime,
609
642
  createGrokCapabilityEvidence,
610
643
  buildGrokReviewSpawnPlan
@@ -0,0 +1,116 @@
1
+ 'use strict';
2
+
3
+ // `run --abandon` (issue #46): close a run that will never finish so it stops
4
+ // holding `refresh --non-destructive` and `update auto` back. The run moves to
5
+ // CANCELLED with reason, actor, and time in its history ledger (workflow runs
6
+ // also get a RUN_CANCELLED event in events.jsonl). Run data is never deleted.
7
+ // The current.json pointer is released only when it pointed at that run.
8
+
9
+ const fs = require('fs');
10
+ const {
11
+ RUN_STATES,
12
+ TERMINAL_STATES,
13
+ assertRunId,
14
+ atomicWriteJson,
15
+ currentRunPath,
16
+ loadRun,
17
+ transitionRun
18
+ } = require('./run-state.js');
19
+ const { redactSecrets } = require('./safe-context.js');
20
+
21
+ const STALE_RUN_DAYS = 7;
22
+ const DAY_MS = 24 * 60 * 60 * 1000;
23
+
24
+ function abandonError(message, code, exitCode = 1) {
25
+ const err = new Error(message);
26
+ err.code = code;
27
+ err.exitCode = exitCode;
28
+ return err;
29
+ }
30
+
31
+ function currentPointerRunId(rootDir) {
32
+ try {
33
+ const { runId } = JSON.parse(fs.readFileSync(currentRunPath(rootDir), 'utf8'));
34
+ return assertRunId(runId);
35
+ } catch {
36
+ return null;
37
+ }
38
+ }
39
+
40
+ // { stale, idleDays } for an active run; terminal runs are never stale.
41
+ function staleRunInfo(run, { now = new Date(), days = STALE_RUN_DAYS } = {}) {
42
+ if (!run || TERMINAL_STATES.has(run.state)) return { stale: false, idleDays: 0 };
43
+ const last = Date.parse(run.updatedAt || run.createdAt);
44
+ if (!Number.isFinite(last)) return { stale: false, idleDays: 0 };
45
+ const idleDays = Math.floor((now.getTime() - last) / DAY_MS);
46
+ return { stale: idleDays >= days, idleDays };
47
+ }
48
+
49
+ function abandonCommand(runId) {
50
+ return `ai-engineering-loop run --abandon${runId ? ` --run ${runId}` : ''} --reason "<why>" --by <name>`;
51
+ }
52
+
53
+ // Validates everything before writing anything.
54
+ function planAbandon(rootDir, { runId = null, reason, by } = {}) {
55
+ const pointer = currentPointerRunId(rootDir);
56
+ const target = runId || pointer;
57
+ if (!target) {
58
+ throw abandonError('No current run to abandon. Pass --run <id> (see `ai-engineering-loop history`).', 'NO_ACTIVE_RUN', 2);
59
+ }
60
+ const run = loadRun(rootDir, assertRunId(target));
61
+ if (TERMINAL_STATES.has(run.state)) {
62
+ throw abandonError(`Run ${run.runId} is already finished (${run.state}); nothing to abandon.`, 'RUN_ALREADY_FINISHED', 2);
63
+ }
64
+ const actor = String(by || '').trim();
65
+ if (!/^[A-Za-z0-9@._-]{1,64}$/.test(actor)) {
66
+ throw abandonError('--by <name> is required (letters, digits, @._-; max 64).', 'INVALID_RUN_ACTOR');
67
+ }
68
+ const cleanReason = redactSecrets(String(reason || '').trim()).text;
69
+ if (!cleanReason || cleanReason.length > 500) {
70
+ throw abandonError('--reason "<text>" is required (1-500 characters).', 'INVALID_ABANDON_REASON');
71
+ }
72
+ return { run, pointer, actor, reason: cleanReason };
73
+ }
74
+
75
+ function abandonRun(rootDir, { runId = null, reason, by, now = new Date() } = {}) {
76
+ const plan = planAbandon(rootDir, { runId, reason, by });
77
+ const { run, pointer, actor } = plan;
78
+ const fromState = run.state;
79
+ let next;
80
+ if (run.workflow) {
81
+ next = require('./workflow-runtime.js').cancelWorkflowRun(rootDir, {
82
+ runId: run.runId,
83
+ actor,
84
+ reason: `Abandoned: ${plan.reason}`,
85
+ now
86
+ }).run;
87
+ } else {
88
+ next = transitionRun(rootDir, run.runId, RUN_STATES.CANCELLED, {
89
+ gate: 'run-abandoned',
90
+ reason: plan.reason,
91
+ historyMetadata: { actor, action: 'abandon' },
92
+ now
93
+ });
94
+ }
95
+ // transitionRun rewrote current.json to this run. Release it, or put back
96
+ // the pointer to the other run that was current before.
97
+ let released = false;
98
+ if (pointer && pointer !== run.runId) {
99
+ atomicWriteJson(currentRunPath(rootDir), { schemaVersion: 1, runId: pointer });
100
+ } else {
101
+ fs.rmSync(currentRunPath(rootDir), { force: true });
102
+ released = Boolean(pointer);
103
+ }
104
+ return {
105
+ runId: run.runId,
106
+ from: fromState,
107
+ state: next.state,
108
+ reason: plan.reason,
109
+ by: actor,
110
+ at: now.toISOString(),
111
+ released,
112
+ current: pointer && pointer !== run.runId ? pointer : null
113
+ };
114
+ }
115
+
116
+ module.exports = { STALE_RUN_DAYS, staleRunInfo, abandonCommand, planAbandon, abandonRun, currentPointerRunId };
@@ -162,6 +162,7 @@ function bootstrap(rootDir) {
162
162
  types: SHIPPED_TYPES,
163
163
  current: adapterHints.existingType || null,
164
164
  recommended: adapterHints.recommended,
165
+ reason: adapterHints.reason,
165
166
  ciProvider: adapterHints.ciProvider
166
167
  },
167
168
  live: liveSnapshot(rootDir)
package/lib/sync-hosts.js CHANGED
@@ -2,6 +2,9 @@
2
2
 
3
3
  const fs = require('fs');
4
4
  const path = require('path');
5
+ const { AGENTS, FORMATS, renderAgent, agentFileName } = require('./hosts/agent-formats.js');
6
+ const { HOSTS, HOST_IDS, SHARED_SKILLS_DIR, usesSharedSkills } = require('./hosts/registry.js');
7
+ const { detectHosts } = require('./hosts/detect.js');
5
8
  const {
6
9
  homeDir,
7
10
  sha256,
@@ -22,16 +25,6 @@ const HOST_PACKS = Object.freeze(['core', 'backend', 'design', 'quality']);
22
25
  const DEFAULT_HOST_PACKS = Object.freeze(['core']);
23
26
  const MANIFEST_FILE = 'host-manifest.json';
24
27
 
25
- function applyGrokSkillOverlay(content) {
26
- const normalized = String(content).replace(/\r\n?/g, '\n');
27
- const match = normalized.match(/^---\n([\s\S]*?)\n---\n/);
28
- if (!match) return normalized;
29
- const yaml = match[1];
30
- if (/^user-invocable:\s*true\s*$/m.test(yaml)) return normalized;
31
- const nextYaml = `${yaml.replace(/\s*$/, '')}\nuser-invocable: true`;
32
- return `---\n${nextYaml}\n---\n${normalized.slice(match[0].length)}`;
33
- }
34
-
35
28
  const BACKEND_SKILL_FILES = [
36
29
  'SKILL.md',
37
30
  'references/api-design-guidelines.md',
@@ -71,24 +64,22 @@ const EMIL_KOWALSKI_SKILL_FILES = Object.freeze({
71
64
  'write-swift': ['SKILL.md']
72
65
  });
73
66
 
74
- function backendSkillFiles(srcRoot, destRoot, { grokSkillOverlay = false } = {}) {
67
+ function backendSkillFiles(srcRoot, destRoot) {
75
68
  return BACKEND_SKILL_FILES.map((file) => ({
76
69
  src: path.posix.join(srcRoot, file),
77
70
  dest: path.join(destRoot, file),
78
71
  mode: 'upsert',
79
- pack: 'backend',
80
- ...(grokSkillOverlay && file === 'SKILL.md' ? { grokSkillOverlay: true } : {})
72
+ pack: 'backend'
81
73
  }));
82
74
  }
83
75
 
84
- function emilKowalskiSkillFiles(srcRoot, destRoot, { grokSkillOverlay = false } = {}) {
76
+ function emilKowalskiSkillFiles(srcRoot, destRoot) {
85
77
  return EMIL_KOWALSKI_SKILLS.flatMap((skill) => (
86
78
  EMIL_KOWALSKI_SKILL_FILES[skill].map((file) => ({
87
79
  src: path.posix.join(srcRoot, skill, file),
88
80
  dest: path.join(destRoot, skill, file),
89
81
  mode: 'upsert',
90
- pack: 'design',
91
- ...(grokSkillOverlay && file === 'SKILL.md' ? { grokSkillOverlay: true } : {})
82
+ pack: 'design'
92
83
  }))
93
84
  ));
94
85
  }
@@ -97,17 +88,15 @@ function emilKowalskiSkillFiles(srcRoot, destRoot, { grokSkillOverlay = false }
97
88
  // pack (ael-code-simplifier, ael-receiving-code-review) is opt-in.
98
89
  const QUALITY_SKILLS = Object.freeze(['ael-code-simplifier', 'ael-receiving-code-review']);
99
90
 
100
- function adoptedSkillFiles(destRoot, { grokSkillOverlay = false } = {}) {
101
- const overlay = grokSkillOverlay ? { grokSkillOverlay: true } : {};
91
+ function adoptedSkillFiles(destRoot) {
102
92
  return [
103
- { src: 'adapters/project-onboarding/SKILL.md', dest: path.join(destRoot, 'project-onboarding/SKILL.md'), mode: 'upsert', ...overlay },
93
+ { src: 'adapters/project-onboarding/SKILL.md', dest: path.join(destRoot, 'project-onboarding/SKILL.md'), mode: 'upsert' },
104
94
  { src: 'adapters/project-onboarding/references/output.md', dest: path.join(destRoot, 'project-onboarding/references/output.md'), mode: 'upsert' },
105
95
  ...QUALITY_SKILLS.map((skill) => ({
106
96
  src: `adapters/quality/skills/${skill}/SKILL.md`,
107
97
  dest: path.join(destRoot, skill, 'SKILL.md'),
108
98
  mode: 'upsert',
109
- pack: 'quality',
110
- ...overlay
99
+ pack: 'quality'
111
100
  }))
112
101
  ];
113
102
  }
@@ -117,6 +106,7 @@ const LOOP_REFERENCE_FILES = Object.freeze([
117
106
  'loop-commands.md',
118
107
  'loop-deliver.md',
119
108
  'loop-goal.md',
109
+ 'loop-hosts.md',
120
110
  'loop-maker.md',
121
111
  'loop-review.md',
122
112
  'loop-risky.md',
@@ -131,87 +121,124 @@ function loopReferenceFiles(srcDir, destDir) {
131
121
  }));
132
122
  }
133
123
 
134
- function hostFileMap(home) {
135
- const claude = path.join(home, '.claude');
136
- const grok = path.join(home, '.grok');
137
- const gemini = path.join(home, '.gemini');
138
- const agents = path.join(home, '.agents');
124
+ // The host-neutral core skill (#48): one source, byte-identical everywhere.
125
+ const CORE_SKILL_SRC = '.agents/skills/ai-engineering-loop';
126
+
127
+ // Every skill a host's skill folder gets: core loop skill, helpers, packs.
128
+ function skillFolderFiles(skillsDir) {
139
129
  return [
140
- {
141
- id: 'claude',
142
- root: claude,
143
- files: [
144
- { src: '.claude/skills/ai-engineering-loop/SKILL.md', dest: path.join(claude, 'skills/ai-engineering-loop/SKILL.md'), mode: 'upsert' },
145
- ...loopReferenceFiles('.claude/skills/ai-engineering-loop', path.join(claude, 'skills/ai-engineering-loop')),
146
- ...backendSkillFiles('.claude/skills/backend-development', path.join(claude, 'skills/backend-development')),
147
- ...emilKowalskiSkillFiles('.claude/skills', path.join(claude, 'skills')),
148
- { src: 'adapters/dot/skills/task-impact-inquiry/SKILL.md', dest: path.join(claude, 'skills/task-impact-inquiry/SKILL.md'), mode: 'upsert' },
149
- { src: 'adapters/generate-adapter/SKILL.md', dest: path.join(claude, 'skills/generate-adapter/SKILL.md'), mode: 'upsert' },
150
- { src: 'adapters/generate-workflow/SKILL.md', dest: path.join(claude, 'skills/generate-workflow/SKILL.md'), mode: 'upsert' },
151
- ...adoptedSkillFiles(path.join(claude, 'skills')),
152
- { src: '.claude/agents/devil-advocate.md', dest: path.join(claude, 'agents/devil-advocate.md'), mode: 'upsert' },
153
- { src: '.claude/agents/judge.md', dest: path.join(claude, 'agents/judge.md'), mode: 'upsert' },
154
- { src: '.claude/commands/ai-engineering-loop.md', dest: path.join(claude, 'commands/ai-engineering-loop.md'), mode: 'upsert' }
155
- ]
156
- },
157
- {
158
- id: 'grok',
159
- root: grok,
160
- files: [
161
- { src: '.grok/skills/ai-engineering-loop/SKILL.md', dest: path.join(grok, 'skills/ai-engineering-loop/SKILL.md'), mode: 'upsert', grokSkillOverlay: true },
162
- ...loopReferenceFiles('.grok/skills/ai-engineering-loop', path.join(grok, 'skills/ai-engineering-loop')),
163
- ...backendSkillFiles('.grok/skills/backend-development', path.join(grok, 'skills/backend-development'), { grokSkillOverlay: true }),
164
- ...emilKowalskiSkillFiles('.grok/skills', path.join(grok, 'skills'), { grokSkillOverlay: true }),
165
- { src: 'adapters/dot/skills/task-impact-inquiry/SKILL.md', dest: path.join(grok, 'skills/task-impact-inquiry/SKILL.md'), mode: 'upsert', grokSkillOverlay: true },
166
- { src: 'adapters/generate-adapter/SKILL.md', dest: path.join(grok, 'skills/generate-adapter/SKILL.md'), mode: 'upsert', grokSkillOverlay: true },
167
- { src: 'adapters/generate-workflow/SKILL.md', dest: path.join(grok, 'skills/generate-workflow/SKILL.md'), mode: 'upsert', grokSkillOverlay: true },
168
- ...adoptedSkillFiles(path.join(grok, 'skills'), { grokSkillOverlay: true }),
169
- { src: '.grok/agents/devil-advocate.md', dest: path.join(grok, 'agents/devil-advocate.md'), mode: 'upsert' },
170
- { src: '.grok/agents/judge.md', dest: path.join(grok, 'agents/judge.md'), mode: 'upsert' },
171
- { src: '.grok/commands/ai-engineering-loop.md', dest: path.join(grok, 'commands/ai-engineering-loop.md'), mode: 'upsert' }
172
- ]
173
- },
174
- {
175
- id: 'gemini',
176
- root: gemini,
177
- files: [
178
- { src: '.gemini/skills/ai-engineering-loop/SKILL.md', dest: path.join(gemini, 'config/skills/ai-engineering-loop/SKILL.md'), mode: 'upsert' },
179
- ...loopReferenceFiles('.gemini/skills/ai-engineering-loop', path.join(gemini, 'config/skills/ai-engineering-loop')),
180
- ...backendSkillFiles('.gemini/skills/backend-development', path.join(gemini, 'config/skills/backend-development')),
181
- ...emilKowalskiSkillFiles('.gemini/skills', path.join(gemini, 'config/skills')),
182
- { src: 'adapters/dot/skills/task-impact-inquiry/SKILL.md', dest: path.join(gemini, 'config/skills/task-impact-inquiry/SKILL.md'), mode: 'upsert' },
183
- { src: 'adapters/generate-adapter/SKILL.md', dest: path.join(gemini, 'config/skills/generate-adapter/SKILL.md'), mode: 'upsert' },
184
- { src: 'adapters/generate-workflow/SKILL.md', dest: path.join(gemini, 'config/skills/generate-workflow/SKILL.md'), mode: 'upsert' },
185
- ...adoptedSkillFiles(path.join(gemini, 'config/skills'))
186
- ]
187
- },
188
- {
189
- id: 'antigravity',
190
- root: agents,
191
- files: [
192
- ...backendSkillFiles('.agents/skills/backend-development', path.join(agents, 'skills/backend-development')),
193
- ...emilKowalskiSkillFiles('.agents/skills', path.join(agents, 'skills')),
194
- ...adoptedSkillFiles(path.join(agents, 'skills')),
195
- { src: '.agents/devil-advocate.md', dest: path.join(agents, 'devil-advocate.md'), mode: 'upsert' },
196
- { src: '.agents/judge.md', dest: path.join(agents, 'judge.md'), mode: 'upsert' },
197
- { src: '.agents/workflows/ai-engineering-loop.md', dest: path.join(agents, 'workflows/ai-engineering-loop.md'), mode: 'upsert' }
198
- ]
199
- },
200
- {
201
- id: 'dot',
202
- root: null,
203
- files: [
204
- { src: 'adapters/dot/skills/dot-dev-skill-router/SKILL.md', dest: path.join(claude, 'skills/dot-dev-skill-router/SKILL.md'), mode: 'update-if-exists', hostRoot: claude },
205
- { src: 'adapters/dot/skills/dot-dev-workflow/SKILL.md', dest: path.join(claude, 'skills/dot-dev-workflow/SKILL.md'), mode: 'update-if-exists', hostRoot: claude },
206
- { src: 'adapters/dot/skills/dot-dev-skill-router/SKILL.md', dest: path.join(grok, 'skills/dot-dev-skill-router/SKILL.md'), mode: 'update-if-exists', hostRoot: grok, grokSkillOverlay: true },
207
- { src: 'adapters/dot/skills/dot-dev-workflow/SKILL.md', dest: path.join(grok, 'skills/dot-dev-workflow/SKILL.md'), mode: 'update-if-exists', hostRoot: grok, grokSkillOverlay: true },
208
- { src: 'adapters/dot/skills/dot-dev-skill-router/SKILL.md', dest: path.join(gemini, 'config/skills/dot-dev-skill-router/SKILL.md'), mode: 'update-if-exists', hostRoot: gemini },
209
- { src: 'adapters/dot/skills/dot-dev-workflow/SKILL.md', dest: path.join(gemini, 'config/skills/dot-dev-workflow/SKILL.md'), mode: 'update-if-exists', hostRoot: gemini }
210
- ]
211
- }
130
+ { src: `${CORE_SKILL_SRC}/SKILL.md`, dest: path.join(skillsDir, 'ai-engineering-loop/SKILL.md'), mode: 'upsert' },
131
+ ...loopReferenceFiles(CORE_SKILL_SRC, path.join(skillsDir, 'ai-engineering-loop')),
132
+ ...backendSkillFiles('.agents/skills/backend-development', path.join(skillsDir, 'backend-development')),
133
+ ...emilKowalskiSkillFiles('.agents/skills', skillsDir),
134
+ // Adapter-neutral (#64): installed by default, not part of the opt-in quality pack.
135
+ { src: 'adapters/quality/skills/task-impact-inquiry/SKILL.md', dest: path.join(skillsDir, 'task-impact-inquiry/SKILL.md'), mode: 'upsert' },
136
+ { src: 'adapters/generate-adapter/SKILL.md', dest: path.join(skillsDir, 'generate-adapter/SKILL.md'), mode: 'upsert' },
137
+ { src: 'adapters/generate-workflow/SKILL.md', dest: path.join(skillsDir, 'generate-workflow/SKILL.md'), mode: 'upsert' },
138
+ ...adoptedSkillFiles(skillsDir)
212
139
  ];
213
140
  }
214
141
 
142
+ function agentFiles(host, home) {
143
+ if (!host.agents) return [];
144
+ const dir = path.join(home, host.agents.dir);
145
+ const format = FORMATS[host.agents.format];
146
+ if (!format) throw new Error(`${host.id}: unknown agent format ${host.agents.format}`);
147
+ return AGENTS.map((name) => {
148
+ const dest = path.join(dir, agentFileName(host.agents.format, name));
149
+ // Canonical repo copies (Claude, Grok) ship as files; others are rendered.
150
+ if (format.src) return { src: format.src(name), dest, mode: 'upsert' };
151
+ return { src: `agents/shared/${name}.body.md`, dest, mode: 'upsert', agentFormat: host.agents.format, agentName: name };
152
+ });
153
+ }
154
+
155
+ // Which hosts get files. After `setup` / `hosts enable|disable` the saved
156
+ // config decides. Before that (legacy installs) a host counts when one of its
157
+ // config directories exists, exactly like earlier releases; PATH binaries only
158
+ // feed `setup` and `hosts list`, so an automatic sync never creates folders for
159
+ // an agent the user has not opted into.
160
+ function resolveHostSelection(home) {
161
+ const config = readUserConfig(home);
162
+ const saved = config.hosts && typeof config.hosts === 'object' ? config.hosts : null;
163
+ if (saved && Array.isArray(saved.enabled)) {
164
+ const enabled = new Set(saved.enabled.filter((id) => HOST_IDS.includes(id)));
165
+ const disabled = new Set((Array.isArray(saved.disabled) ? saved.disabled : []).filter((id) => HOST_IDS.includes(id) && !enabled.has(id)));
166
+ return { enabled, disabled, source: 'config', mode: saved.mode === 'auto' ? 'auto' : 'manual' };
167
+ }
168
+ const enabled = new Set(detectHosts({ home, env: { PATH: '' } }).filter((d) => d.detected).map((d) => d.id));
169
+ // An earlier sync already installed files for this host: keep it.
170
+ const tracked = Object.keys(readHostManifest(home).files).map((file) => path.resolve(file));
171
+ for (const host of HOSTS) {
172
+ const dirs = [usesSharedSkills(host) ? null : host.skills.dir, host.agents && host.agents.dir].filter(Boolean)
173
+ .map((dir) => path.resolve(home, dir) + path.sep);
174
+ if (tracked.some((file) => dirs.some((dir) => file.startsWith(dir)))) enabled.add(host.id);
175
+ }
176
+ return { enabled, disabled: new Set(), source: 'legacy-dirs', mode: null };
177
+ }
178
+
179
+ // Groups of files per host, plus the shared ~/.agents/skills folder and
180
+ // update-only DOT skills. A file wanted by any enabled group is never pruned
181
+ // on behalf of a disabled one (Antigravity IDE and CLI share an agents dir).
182
+ function hostFileMap(home, selection = resolveHostSelection(home)) {
183
+ const groups = [];
184
+ const sharedUsers = HOSTS.filter((host) => usesSharedSkills(host));
185
+ const sharedEnabled = sharedUsers.some((host) => selection.enabled.has(host.id));
186
+ const sharedDisabled = !sharedEnabled && selection.source === 'config' && sharedUsers.some((host) => selection.disabled.has(host.id));
187
+ const skillDirs = [];
188
+ for (const host of HOSTS) {
189
+ const files = [];
190
+ if (!usesSharedSkills(host)) files.push(...skillFolderFiles(path.join(home, host.skills.dir)));
191
+ files.push(...agentFiles(host, home));
192
+ const enabled = selection.enabled.has(host.id);
193
+ if (enabled && !usesSharedSkills(host)) skillDirs.push(path.join(home, host.skills.dir));
194
+ groups.push({ id: host.id, enabled, disabled: selection.disabled.has(host.id), files });
195
+ }
196
+ groups.push({
197
+ id: 'shared',
198
+ enabled: sharedEnabled,
199
+ disabled: sharedDisabled,
200
+ files: skillFolderFiles(path.join(home, SHARED_SKILLS_DIR))
201
+ });
202
+ if (sharedEnabled) skillDirs.push(path.join(home, SHARED_SKILLS_DIR));
203
+ groups.push({
204
+ id: 'dot',
205
+ enabled: true,
206
+ disabled: false,
207
+ files: [...new Set(skillDirs)].flatMap((dir) => DOT_SKILLS.map((skill) => ({
208
+ src: `adapters/dot/skills/${skill}/SKILL.md`,
209
+ dest: path.join(dir, skill, 'SKILL.md'),
210
+ mode: 'update-if-exists'
211
+ })))
212
+ });
213
+ const wanted = new Set();
214
+ for (const group of groups) {
215
+ if (!group.enabled) continue;
216
+ group.files = group.files.filter((file) => {
217
+ const key = path.resolve(file.dest);
218
+ if (wanted.has(key)) return false;
219
+ wanted.add(key);
220
+ return true;
221
+ });
222
+ }
223
+ for (const group of groups) {
224
+ if (group.enabled) continue;
225
+ group.files = group.files.filter((file) => !wanted.has(path.resolve(file.dest)));
226
+ }
227
+ return groups;
228
+ }
229
+
230
+ const DOT_SKILLS = Object.freeze(['dot-dev-skill-router', 'dot-dev-workflow']);
231
+
232
+ // Directories AEL may own files under (obsolete-file cleanup is limited to them).
233
+ function managedRoots(home) {
234
+ const roots = new Set([path.join(home, '.agents')]);
235
+ for (const host of HOSTS) {
236
+ if (!usesSharedSkills(host)) roots.add(path.dirname(path.join(home, host.skills.dir)));
237
+ if (host.agents) roots.add(path.dirname(path.join(home, host.agents.dir)));
238
+ }
239
+ return [...roots].map((root) => path.resolve(root));
240
+ }
241
+
215
242
  function destExists(dest) {
216
243
  try {
217
244
  fs.lstatSync(dest);
@@ -290,12 +317,13 @@ function readFileText(dest) {
290
317
  }
291
318
 
292
319
  function packageContent(root, file) {
320
+ if (file.agentFormat) return renderAgent(root, file.agentFormat, file.agentName);
293
321
  const srcAbs = path.join(root, file.src);
294
- let content = fs.readFileSync(srcAbs, 'utf8').replace(/\r\n?/g, '\n');
295
- if (file.grokSkillOverlay) content = applyGrokSkillOverlay(content);
296
- return content;
322
+ return fs.readFileSync(srcAbs, 'utf8').replace(/\r\n?/g, '\n');
297
323
  }
298
324
 
325
+
326
+
299
327
  // Pack selection precedence: explicit argument > saved user config > legacy
300
328
  // auto-detect (a non-core pack stays selected while any of its files is already
301
329
  // installed, so upgrading never silently freezes an existing install).
@@ -304,7 +332,7 @@ function resolvePacks({ packs, home }) {
304
332
  const config = readUserConfig(home);
305
333
  if (Array.isArray(config.hostPacks)) return { packs: normalizePacks(config.hostPacks), source: 'config' };
306
334
  const detected = new Set(DEFAULT_HOST_PACKS);
307
- for (const group of hostFileMap(home)) {
335
+ for (const group of hostFileMap(home, { enabled: new Set(HOST_IDS), disabled: new Set(), source: 'all' })) {
308
336
  for (const file of group.files) {
309
337
  if (file.pack && file.pack !== 'core' && destExists(file.dest)) detected.add(file.pack);
310
338
  }
@@ -312,14 +340,15 @@ function resolvePacks({ packs, home }) {
312
340
  return { packs: normalizePacks([...detected]), source: detected.size > 1 ? 'detected' : 'default' };
313
341
  }
314
342
 
315
- function planHostSync({ packageRoot: root = packageRoot(), home = homeDir(), packs = null, prune = false } = {}) {
343
+ function planHostSync({ packageRoot: root = packageRoot(), home = homeDir(), packs = null, prune = false, hosts = null } = {}) {
316
344
  const results = [];
317
345
  const selection = resolvePacks({ packs, home });
346
+ const hostSelection = hosts || resolveHostSelection(home);
318
347
  const manifest = readHostManifest(home);
319
- for (const group of hostFileMap(home)) {
348
+ const groups = hostFileMap(home, hostSelection);
349
+ for (const group of groups) {
320
350
  for (const file of group.files) {
321
351
  const srcAbs = path.join(root, file.src);
322
- const hostRoot = file.hostRoot || group.root;
323
352
  const pack = file.pack || 'core';
324
353
  const item = {
325
354
  id: group.id,
@@ -328,8 +357,17 @@ function planHostSync({ packageRoot: root = packageRoot(), home = homeDir(), pac
328
357
  mode: file.mode,
329
358
  pack
330
359
  };
331
- if (hostRoot && !fs.existsSync(hostRoot)) {
332
- results.push({ ...item, action: 'skip', reason: 'host-missing' });
360
+ if (!group.enabled) {
361
+ const existing = group.disabled && destExists(file.dest) ? readFileText(file.dest) : null;
362
+ if (existing === null) {
363
+ results.push({ ...item, action: 'skip', reason: group.disabled ? 'host-disabled' : 'host-missing' });
364
+ continue;
365
+ }
366
+ // `hosts disable`: remove what AEL wrote, keep what the user edited.
367
+ const tracked = manifest.files[file.dest];
368
+ results.push(tracked && tracked.sha256 === sha256(existing)
369
+ ? { ...item, action: 'prune', reason: 'host-disabled' }
370
+ : { ...item, action: 'skip', reason: 'modified' });
333
371
  continue;
334
372
  }
335
373
  if (!fs.existsSync(srcAbs)) {
@@ -381,7 +419,7 @@ function planHostSync({ packageRoot: root = packageRoot(), home = homeDir(), pac
381
419
  // earlier sync but no longer shipped (for example a renamed skill). Removed
382
420
  // when still byte-identical to what AEL wrote; edited ones are kept.
383
421
  const known = new Set(results.map((item) => path.resolve(item.dest)));
384
- const hostRoots = hostFileMap(home).map((group) => path.resolve(group.root || path.dirname(group.files[0] ? group.files[0].dest : home)));
422
+ const hostRoots = managedRoots(home);
385
423
  for (const [dest, tracked] of Object.entries(manifest.files || {})) {
386
424
  const abs = path.resolve(dest);
387
425
  if (known.has(abs)) continue;
@@ -398,6 +436,8 @@ function planHostSync({ packageRoot: root = packageRoot(), home = homeDir(), pac
398
436
  }
399
437
  results.packs = selection.packs;
400
438
  results.packSource = selection.source;
439
+ results.hosts = [...hostSelection.enabled];
440
+ results.hostSource = hostSelection.source;
401
441
  return results;
402
442
  }
403
443
 
@@ -406,7 +446,7 @@ function removeEmptyParents(dir, home) {
406
446
  let current = path.resolve(dir);
407
447
  const stop = path.resolve(home);
408
448
  for (let depth = 0; depth < 3; depth += 1) {
409
- if (path.basename(current) === 'skills' || path.dirname(current) === stop || current === stop) return;
449
+ if (['skills', 'agents'].includes(path.basename(current)) || path.dirname(current) === stop || current === stop) return;
410
450
  try {
411
451
  if (fs.readdirSync(current).length > 0) return;
412
452
  fs.rmdirSync(current);
@@ -443,9 +483,10 @@ function applyHostSync({
443
483
  dryRun = false,
444
484
  packs = null,
445
485
  prune = false,
446
- version = null
486
+ version = null,
487
+ hosts = null
447
488
  } = {}) {
448
- const plan = planHostSync({ packageRoot: root, home, packs, prune });
489
+ const plan = planHostSync({ packageRoot: root, home, packs, prune, hosts });
449
490
  const applied = [];
450
491
  const manifest = readHostManifest(home);
451
492
  let manifestChanged = false;
@@ -515,6 +556,8 @@ function applyHostSync({
515
556
  if (!dryRun && packs != null) writeUserConfig({ hostPacks: plan.packs }, home);
516
557
  applied.packs = plan.packs;
517
558
  applied.packSource = plan.packSource;
559
+ applied.hosts = plan.hosts;
560
+ applied.hostSource = plan.hostSource;
518
561
  return applied;
519
562
  }
520
563
 
@@ -591,10 +634,11 @@ module.exports = {
591
634
  hostSkillStatus,
592
635
  packageRoot,
593
636
  homeDir,
594
- applyGrokSkillOverlay,
595
637
  EMIL_KOWALSKI_SKILLS,
596
638
  EMIL_KOWALSKI_SKILL_FILES,
597
639
  hostFileMap,
640
+ resolveHostSelection,
641
+ managedRoots,
598
642
  planHostSync,
599
643
  applyHostSync,
600
644
  summarizeHostSync,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-engineering-loop",
3
- "version": "1.14.0",
3
+ "version": "1.16.0",
4
4
  "description": "A visual workspace that helps AI coding agents plan, build, review, and ship reliable software.",
5
5
  "main": "bin/ai-engineering-loop.js",
6
6
  "bin": {
@@ -21,9 +21,7 @@
21
21
  "evals/",
22
22
  ".agents/",
23
23
  ".grok/",
24
- ".gemini/skills/",
25
24
  ".claude/agents/",
26
- ".claude/commands/",
27
25
  ".claude/skills/",
28
26
  "LICENSE",
29
27
  "THIRD_PARTY_NOTICES.md",
@@ -43,6 +41,7 @@
43
41
  "prepublishOnly": "npm run check:skills && npm test && npm run doctor && npm run eval && npm run audit:package",
44
42
  "build:skills": "node scripts/build-host-skills.js",
45
43
  "check:skills": "node scripts/build-host-skills.js --check",
44
+ "build:hosts-table": "node scripts/build-host-table.js",
46
45
  "measure": "node scripts/measure.js"
47
46
  },
48
47
  "engines": {