@aiwg/cli 2026.10.12 → 2026.10.15

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 (104) hide show
  1. package/agentic/code/addons/aiwg-utils/rules/anti-laziness.core.md +13 -0
  2. package/agentic/code/addons/aiwg-utils/rules/anti-laziness.md +118 -0
  3. package/agentic/code/providers/pi/aiwg-bridge.ts +44 -1
  4. package/dist/src/artifacts/corpus-tools/cli.js +32 -0
  5. package/dist/src/artifacts/corpus-tools/discovery-log.js +1 -1
  6. package/dist/src/artifacts/corpus-tools/expand-cli.js +89 -0
  7. package/dist/src/artifacts/corpus-tools/expand-queue.js +38 -0
  8. package/dist/src/artifacts/corpus-tools/expand-state.js +40 -0
  9. package/dist/src/artifacts/corpus-tools/expand.js +125 -0
  10. package/dist/src/artifacts/corpus-tools/resolve-cli.js +91 -0
  11. package/dist/src/artifacts/corpus-tools/resolve-corpus.js +41 -0
  12. package/dist/src/artifacts/corpus-tools/resolve.js +105 -0
  13. package/dist/src/cli/handlers/doctor-args.js +40 -0
  14. package/dist/src/cli/handlers/doctor-help.js +4 -2
  15. package/dist/src/cli/handlers/use-bundle-counts.js +32 -6
  16. package/dist/src/cli/handlers/use-skill-assets.js +207 -0
  17. package/dist/src/cli/handlers/use.js +30 -193
  18. package/dist/src/cli/handlers/utilities.js +5 -31
  19. package/dist/src/config/authorization-cli.js +11 -3
  20. package/dist/src/config/worker-context.js +33 -4
  21. package/dist/src/decision/context-pruning-common.js +41 -0
  22. package/dist/src/decision/context-pruning-evaluation.js +366 -0
  23. package/dist/src/decision/context-pruning-pilot.js +431 -0
  24. package/dist/src/decision/context-pruning-types.js +19 -0
  25. package/dist/src/decision/context-pruning.js +5 -847
  26. package/dist/src/decision/ensemble/contract.js +4 -24
  27. package/dist/src/decision/heldout/collector.js +1 -1
  28. package/dist/src/decision/qualification/release.js +5 -62
  29. package/dist/src/extensions/manifest.js +8 -1
  30. package/dist/src/extensions/project-local-doctor.js +78 -2
  31. package/dist/src/extensions/validation.js +10 -11
  32. package/dist/src/features/catalog.js +1 -1
  33. package/dist/src/gates/evaluate.js +5 -15
  34. package/dist/src/gates/heldout.js +42 -0
  35. package/dist/src/gates/index.js +2 -1
  36. package/dist/src/gates/upstream-ceiling.js +111 -0
  37. package/dist/src/models/provider-models.js +5 -8
  38. package/dist/src/models/worker-installation-store.mjs +228 -0
  39. package/dist/src/models/worker-installation.mjs +7 -162
  40. package/dist/src/models/wrapper-definitions.js +14 -0
  41. package/dist/src/models/wrapper-deployment.js +48 -25
  42. package/dist/src/models/wrapper-enforcement.js +72 -0
  43. package/dist/src/policy/hitl-check.js +80 -0
  44. package/dist/src/providers/provider-definitions.js +10 -10
  45. package/dist/src/research/clients/arxiv.js +10 -4
  46. package/dist/src/research/clients/base.js +5 -4
  47. package/dist/src/research/clients/crossref.js +9 -1
  48. package/dist/src/research/clients/semantic-scholar.js +73 -44
  49. package/dist/src/research/identity.js +85 -0
  50. package/dist/src/research/index.js +1 -0
  51. package/dist/src/research/reference-match.js +89 -0
  52. package/dist/src/rules/activation.d.mts +2 -0
  53. package/dist/src/rules/activation.mjs +23 -0
  54. package/dist/src/rules/core-startup.d.mts +2 -0
  55. package/dist/src/rules/core-startup.mjs +31 -0
  56. package/dist/src/skills/adapters/local.js +32 -9
  57. package/dist/src/skills/agent-skills.js +2 -0
  58. package/dist/src/skills/cli-display.js +33 -0
  59. package/dist/src/skills/cli.js +2 -26
  60. package/dist/src/skills/collision-discovery.js +84 -0
  61. package/dist/src/skills/deployer.js +20 -75
  62. package/dist/src/skills/deployment-ownership.js +74 -0
  63. package/dist/src/skills/doctor.js +2 -2
  64. package/dist/src/skills/importer.js +4 -26
  65. package/dist/src/skills/registry.js +22 -7
  66. package/dist/src/smiths/context-pipeline/agents-md.js +34 -0
  67. package/dist/src/smiths/context-pipeline/aiwg-md.js +3 -0
  68. package/dist/src/smiths/context-pipeline/bridge-ownership.js +50 -0
  69. package/dist/src/smiths/context-pipeline/generator.js +40 -104
  70. package/dist/src/smiths/context-pipeline/managed-hook.js +10 -0
  71. package/dist/src/smiths/context-pipeline/parallelism-section.js +7 -3
  72. package/package.json +6 -2
  73. package/tools/agents/deploy-agents.mjs +2 -123
  74. package/tools/agents/providers/antigravity.mjs +4 -6
  75. package/tools/agents/providers/base.mjs +3 -3
  76. package/tools/agents/providers/claude.mjs +3 -5
  77. package/tools/agents/providers/codex.mjs +3 -5
  78. package/tools/agents/providers/context-write.mjs +12 -0
  79. package/tools/agents/providers/copilot.mjs +3 -5
  80. package/tools/agents/providers/cursor.mjs +3 -5
  81. package/tools/agents/providers/factory.mjs +3 -5
  82. package/tools/agents/providers/grok-build.mjs +17 -12
  83. package/tools/agents/providers/hermes-skill-lifecycle.mjs +144 -0
  84. package/tools/agents/providers/hermes-startup.mjs +209 -0
  85. package/tools/agents/providers/hermes.mjs +9 -359
  86. package/tools/agents/providers/model-wrapper.mjs +90 -0
  87. package/tools/agents/providers/muse.mjs +3 -3
  88. package/tools/agents/providers/omp.mjs +3 -1
  89. package/tools/agents/providers/openclaw.mjs +3 -5
  90. package/tools/agents/providers/opencode.mjs +3 -5
  91. package/tools/agents/providers/pi.mjs +1 -1
  92. package/tools/agents/providers/provider-paths-staging.mjs +9 -0
  93. package/tools/agents/providers/rule-delivery.mjs +26 -228
  94. package/tools/agents/providers/rule-presentation.mjs +13 -4
  95. package/tools/agents/providers/rule-projection.mjs +119 -0
  96. package/tools/agents/providers/rule-startup.mjs +70 -0
  97. package/tools/agents/providers/stale-artifact-prune.mjs +128 -0
  98. package/tools/agents/providers/warp.mjs +5 -7
  99. package/tools/agents/providers/windsurf.mjs +14 -62
  100. package/tools/plugin/package-plugins.mjs +2 -2
  101. package/tools/plugin/plugin-links.mjs +3 -0
  102. package/tools/skills/codex-skill-transform.mjs +232 -0
  103. package/tools/skills/deploy-skills-codex.mjs +8 -249
  104. package/tools/warp/warp-content.mjs +548 -0
@@ -0,0 +1,90 @@
1
+ // Apply canonical wrapper pins and read-only controls after each provider's native translation.
2
+ import { load, dump } from 'js-yaml';
3
+ import { importImpl } from '../../_resolve-impl.mjs';
4
+ const { MODEL_WRAPPER_DEFINITIONS } = await importImpl(import.meta.url, 'models/wrapper-definitions.js');
5
+ // These TypeScript graphs import siblings by their compiled .js names, so they
6
+ // load only from dist/. Run `npm run build:cli` before using a checkout's tools.
7
+ async function compiled(module) {
8
+ try { return await importImpl(import.meta.url, module); }
9
+ catch (error) {
10
+ if (error?.code !== 'ERR_MODULE_NOT_FOUND') throw error;
11
+ throw Object.assign(new Error(`provider translators need the compiled ${module} from dist/; run \`npm run build:cli\` first (${error.message})`),
12
+ { code: 'AIWG_BUILD_REQUIRED', cause: error });
13
+ }
14
+ }
15
+ const { loadProviderModelCatalog } = await compiled('models/catalog-policy.js');
16
+ const { resolveWrapperPin } = await compiled('models/wrapper-enforcement.js');
17
+
18
+ function parse(content) {
19
+ const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
20
+ return match ? { metadata: load(match[1]) || {}, body: match[2] } : null;
21
+ }
22
+
23
+ /** Ordinary agents retain their provider translator; only the five canonical wrappers opt in. */
24
+ export function withModelWrapper(provider, translate) {
25
+ return (source, content, opts = {}) => {
26
+ const parsed = parse(content);
27
+ const wrapper = MODEL_WRAPPER_DEFINITIONS.find(item => item.name === parsed?.metadata.name);
28
+ if (!wrapper) return translate(source, content, opts);
29
+ const catalog = opts.modelCatalog || loadProviderModelCatalog();
30
+ const config = opts.modelsConfig?.[provider]?.[wrapper.role];
31
+ const sourceModel = parsed.metadata.model;
32
+ const override = parsed.metadata['model-override'] || opts[`${wrapper.role}Model`]
33
+ || config?.model || (sourceModel && !['opus', 'sonnet', 'haiku', 'inherit', 'auto'].includes(sourceModel) ? sourceModel : undefined);
34
+ // Reuse #2643 election checks, including catalog entries marked user-elected.
35
+ // Wrappers never supply election authority, even if a parent session has it.
36
+ const effort = parsed.metadata['model-effort'] || parsed.metadata.model_reasoning_effort
37
+ || parsed.metadata.reasoningEffort || parsed.metadata.thinkingLevel || parsed.metadata.effort
38
+ || config?.reasoningEffort;
39
+ const { tier, role, model: pin, effort: nativeEffort, controls, enforcement } =
40
+ resolveWrapperPin(provider, wrapper, { catalog, override, effort });
41
+ // Legacy translators read a single tools line; normalize YAML lists before mapping.
42
+ const toolList = parsed.metadata.tools;
43
+ const normalized = Array.isArray(toolList) && ['antigravity', 'copilot', 'factory', 'windsurf'].includes(provider)
44
+ ? content.replace(/^tools:[^\n]*(?:\n[ \t]+- [^\n]*)*/m,
45
+ `tools: ${provider === 'antigravity' ? `[${toolList.join(', ')}]` : JSON.stringify(toolList)}`)
46
+ : content;
47
+ const mapped = translate(source, normalized, opts);
48
+ const notice = `AIWG wrapper tier: ${tier}; catalog role: ${role}. `
49
+ + `Tier enforcement: ${enforcement}; effort: ${nativeEffort ? `pinned (${nativeEffort})` : 'not enforced per wrapper'}. `
50
+ + (pin ? `Model selector: ${pin}.` : 'The automatic selector is not a model pin. Model control is inherited or informational; stop unless the conductor confirms the required non-flagship session.')
51
+ + (provider === 'grok-build' ? ' Native-agent tier enforcement remains gated by #2577; not enforced.' : '');
52
+ if (provider === 'codex') {
53
+ let output = mapped.replace(/^model = .*$/m, `model = ${JSON.stringify(pin)}`);
54
+ if (!pin) throw new Error(`${source}: Codex wrapper needs a catalog model pin`);
55
+ output = output.replace(/^model_reasoning_effort = .*$/m, `model_reasoning_effort = ${JSON.stringify(nativeEffort)}`);
56
+ output = output.replace(/^developer_instructions = (.*)$/m, (_line, value) =>
57
+ `developer_instructions = ${JSON.stringify(`${notice}\n\n${JSON.parse(value)}`)}`);
58
+ if (wrapper.readOnly) output += 'sandbox_mode = "read-only"\n';
59
+ return output;
60
+ }
61
+ const target = parse(mapped);
62
+ if (!target) return `${mapped.trim()}\n\n${notice}\n`;
63
+ const metadata = target.metadata;
64
+ if (pin) metadata[controls.model] = pin;
65
+ else if (!override || provider !== 'grok-build') delete metadata.model;
66
+ // Portable input aliases are not provider controls. Emit only the resolved native field.
67
+ for (const key of ['effort', 'model-effort', 'model_reasoning_effort', 'reasoningEffort', 'thinkingLevel']) {
68
+ if (key !== controls.effort || !nativeEffort) delete metadata[key];
69
+ }
70
+ if (nativeEffort) metadata[controls.effort] = nativeEffort;
71
+ if (metadata['model-tier']) metadata['model-tier'] = tier;
72
+ if (wrapper.readOnly) {
73
+ if (provider === 'opencode') {
74
+ // OpenCode uses permission rules rather than a tools list. Unknown tools deny.
75
+ metadata.permission = { '*': 'deny', read: 'allow', grep: 'allow', glob: 'allow',
76
+ bash: 'ask', edit: 'deny', task: 'deny' };
77
+ } else if (provider === 'cursor') metadata.readonly = true;
78
+ else if (provider === 'claude') metadata.disallowedTools = ['Write', 'Edit', 'Task', 'Agent'];
79
+ }
80
+ let header = dump(metadata, { lineWidth: -1, noRefs: true });
81
+ // Keep the translator's own tools line (Factory JSON, Copilot quoted list);
82
+ // the wrapper never changes tools, and a block list breaks those formats.
83
+ const nativeHeader = mapped.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/)?.[1] ?? '';
84
+ const nativeTools = nativeHeader.match(/^tools:[^\n]*(?:\n[ \t]+- [^\n]*)*/m)?.[0];
85
+ if (nativeTools) header = header.replace(/^tools:[^\n]*(?:\n[ \t]+- [^\n]*)*/m, () => nativeTools);
86
+ // Keep Grok's quoted native model selector, including operator-supplied IDs.
87
+ if (provider === 'grok-build' && metadata.model) header = header.replace(/^model: .*$/m, `model: ${JSON.stringify(metadata.model)}`);
88
+ return `---\n${header}---\n\n${notice}\n\n${target.body.trim()}\n`;
89
+ };
90
+ }
@@ -55,14 +55,14 @@ export const name = 'muse';
55
55
  export const aliases = []; // ADR: no aliases (no muse-spark, muse-code, spark, meta)
56
56
 
57
57
  // Project-relative paths. Skills deploy into the Muse-native project skills
58
- // root; agents/commands/rules have no file surface in this wave (indexed via
59
- // aiwg discover / aiwg show). The discover-first AGENTS.md bridge renders
58
+ // root; agents/commands stay indexed via discover/show, while rules use
59
+ // .muse/rules through the mandatory AGENTS.md hook. The bootstrap renders
60
60
  // via createAgentsMd below.
61
61
  export const paths = {
62
62
  agents: '',
63
63
  commands: '',
64
64
  skills: '.agents/skills',
65
- rules: '',
65
+ rules: '.muse/rules',
66
66
  };
67
67
 
68
68
  // Kernel skills land at the project skills root itself.
@@ -6,6 +6,7 @@ import YAML from 'yaml';
6
6
  import { importImpl } from '../../_resolve-impl.mjs';
7
7
  import { withRuleDeployment, collectFrameworkArtifacts, getAddonFiles, isKernelSkill, listMdFiles, listSkillDirs, normalizeDeploymentMode, resolveAiwgRoot } from './base.mjs';
8
8
 
9
+ import { withModelWrapper } from './model-wrapper.mjs';
9
10
  import { writeContextFileSync } from './context-write.mjs';
10
11
  export const name = 'omp';
11
12
  export const aliases = ['oh-my-pi'];
@@ -23,7 +24,8 @@ function diagnostic(opts, message) { opts.diagnostics?.push(message); if (!opts.
23
24
  // Resolved through the shared resolver: an installed package ships these
24
25
  // modules under dist/src, not src, so a literal path into src fails there.
25
26
  const { resolveOmpPaths } = await importImpl(import.meta.url, 'providers/omp-paths.mjs');
26
- const { transformAgent, mapModel } = await importImpl(import.meta.url, 'providers/omp-agent.mjs');
27
+ const { transformAgent: translateAgent, mapModel } = await importImpl(import.meta.url, 'providers/omp-agent.mjs');
28
+ const transformAgent = withModelWrapper('omp', translateAgent);
27
29
  export { transformAgent, mapModel };
28
30
  const array = value => Array.isArray(value) ? value : typeof value === 'string' ? value.split(',').map(s => s.trim()).filter(Boolean) : [];
29
31
  export function transformCommand(src, content, opts = {}) {
@@ -1,3 +1,4 @@
1
+ import { withModelWrapper } from './model-wrapper.mjs';
1
2
  /**
2
3
  * OpenClaw Provider
3
4
  *
@@ -17,7 +18,6 @@
17
18
  *
18
19
  * See: docs/openclaw-guide.md
19
20
  */
20
-
21
21
  import realFs from 'fs';
22
22
  import { createRequire } from 'module';
23
23
  const _require = createRequire(import.meta.url);
@@ -52,14 +52,11 @@ import {
52
52
  createAgentsMdFromTemplate,
53
53
  createManagedMdFromTemplate,
54
54
  } from './base.mjs';
55
-
56
55
  // ============================================================================
57
56
  // Provider Configuration
58
57
  // ============================================================================
59
-
60
58
  export const name = 'openclaw';
61
59
  export const aliases = [];
62
-
63
60
  const openclawHome = path.join(os.homedir(), '.openclaw');
64
61
 
65
62
  export const paths = {
@@ -141,7 +138,8 @@ export function mapModel(shorthand, modelCfg, modelsConfig) {
141
138
  // Content Transformation (passthrough — OpenClaw uses AIWG native format)
142
139
  // ============================================================================
143
140
 
144
- export function transformAgent(srcPath, content, opts) {
141
+ export const transformAgent = withModelWrapper('openclaw', translateAgent);
142
+ function translateAgent(srcPath, content, opts) {
145
143
  // AIWG's catalog intentionally records configured/<role> placeholders for
146
144
  // OpenClaw because the exact provider/model namespace is installation
147
145
  // specific. Omit the portable Markdown pin and inherit the configured
@@ -1,3 +1,4 @@
1
+ import { withModelWrapper } from './model-wrapper.mjs';
1
2
  /**
2
3
  * OpenCode Provider
3
4
  *
@@ -15,7 +16,6 @@
15
16
  * - Permission system with bash command whitelist
16
17
  * - Temperature and steps per category
17
18
  */
18
-
19
19
  import realFs from 'fs';
20
20
  import { createRequire } from 'module';
21
21
  const _require = createRequire(import.meta.url);
@@ -54,14 +54,11 @@ import {
54
54
  } from './base.mjs';
55
55
  const { assertConfigDestination, writeConfigAtomic } = await importImpl(import.meta.url, 'mcp/config-file.mjs');
56
56
  const modelCatalog = loadRuntimeModelCatalog(staticModelCatalog);
57
-
58
57
  // ============================================================================
59
58
  // Provider Configuration
60
59
  // ============================================================================
61
-
62
60
  export const name = 'opencode';
63
61
  export const aliases = [];
64
-
65
62
  export const paths = {
66
63
  agents: '.opencode/agent/', // Discovered via {agent,agents}/**/*.md glob (#773)
67
64
  commands: '.opencode/command/',
@@ -208,7 +205,8 @@ export function getAgentConfig(category, name) {
208
205
  /**
209
206
  * Transform AIWG agent to OpenCode agent format
210
207
  */
211
- export function transformAgent(srcPath, content, opts) {
208
+ export const transformAgent = withModelWrapper('opencode', translateAgent);
209
+ function translateAgent(srcPath, content, opts) {
212
210
  const { modelsConfig = {} } = opts;
213
211
 
214
212
  // Parse existing frontmatter
@@ -30,7 +30,7 @@ export const paths = {
30
30
  agents: '',
31
31
  commands: '.pi/prompts',
32
32
  skills: '.pi/.aiwg/skills',
33
- rules: '',
33
+ rules: '.pi/rules',
34
34
  };
35
35
 
36
36
  export const extensionBridge = 'agentic/code/providers/pi/aiwg-bridge.ts';
@@ -1,4 +1,13 @@
1
1
  /** Stage and restore provider path overrides without writing through getter-only accessors. */
2
+ import { sep } from 'node:path';
3
+
4
+ export function logicalProviderOutputPath(file, stage, target, mappings = []) {
5
+ const mapping = [...mappings].sort((a, b) => b.to.length - a.to.length)
6
+ .find(item => file === item.to || file.startsWith(`${item.to}${sep}`));
7
+ if (mapping) return mapping.from + file.slice(mapping.to.length);
8
+ return file === stage || file.startsWith(`${stage}${sep}`) ? target + file.slice(stage.length) : file;
9
+ }
10
+
2
11
  export function captureProviderPathDescriptors(provider) {
3
12
  return Object.getOwnPropertyDescriptors(provider.paths);
4
13
  }
@@ -2,7 +2,6 @@
2
2
  import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import os from 'node:os';
5
- import { stringify } from 'yaml';
6
5
  import { createHash, randomUUID } from 'node:crypto';
7
6
  import { importImpl } from '../../_resolve-impl.mjs';
8
7
  import {
@@ -12,7 +11,7 @@ import {
12
11
  addManagedMarker, contentHash, replaceBoundRulesBlock, deployEmulatedBehaviors, filterAgentFiles,
13
12
  } from './base.mjs';
14
13
 
15
- const { parseRuleFrontmatter, inferRuleActivation, readCoreBody, validateCoreSet, CORE_RULES_START, CORE_RULES_END } = await importImpl(import.meta.url, 'rules/activation.mjs');
14
+ const { parseRuleFrontmatter, inferRuleActivation, readCoreBody, validateCoreSet, formatRuleFrontmatterError } = await importImpl(import.meta.url, 'rules/activation.mjs');
16
15
  const { resolveDeployVersion } = await importImpl(import.meta.url, 'providers/deploy-version.mjs');
17
16
  const { trackTemporaryDirectory } = await importImpl(import.meta.url, 'utils/temporary-directory.js');
18
17
  const { loadRulePinConfigs, installedRuleCapabilities, resolveRulePins } = await importImpl(import.meta.url, 'rules/pins.mjs');
@@ -20,10 +19,12 @@ const { guardRulesInlineBudget } = await importImpl(import.meta.url, 'rules/inli
20
19
  const { userConfigFile } = await importImpl(import.meta.url, 'config/user-config-dir.mjs');
21
20
  const { resolveProjectAiwgDir } = await importImpl(import.meta.url, 'config/project-artifacts-runtime.mjs');
22
21
  import { writeContextFileSync, CONTEXT_STAGE_ENV } from './context-write.mjs';
23
- import { captureProviderPathDescriptors, setStagedProviderPath, restoreProviderPaths } from './provider-paths-staging.mjs';
22
+ import { captureProviderPathDescriptors, setStagedProviderPath, restoreProviderPaths, logicalProviderOutputPath } from './provider-paths-staging.mjs';
24
23
  import { resolveDeliveryRuleBindings } from './rule-binding-targets.mjs';
25
- import { projectOnDemandReferences, renderRuleKernelIndex } from './rule-presentation.mjs';
24
+ import { renderRuleKernelIndex } from './rule-presentation.mjs';
26
25
  export { renderRuleKernelIndex } from './rule-presentation.mjs';
26
+ import { retireInlineStartup } from './rule-startup.mjs';
27
+ import { projectRules, inlineStartup, ruleDirectory, nativePathLoader } from './rule-projection.mjs';
27
28
  const PREPARATION_HOOK = Symbol.for('aiwg.provider-preparation-hook.v1');
28
29
 
29
30
  export function installRuleDeploymentPreparationHook(hook) {
@@ -72,14 +73,6 @@ function promoteDirectories(source, destination, skip = () => false, prefix = ''
72
73
  }
73
74
  const read = file => fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
74
75
  const structural = file => /^(RULES-INDEX|RULES-ONDEMAND)\.(md|mdc)$/.test(path.basename(file));
75
- // Verified startup owners from provider-definitions.ts. These providers do not
76
- // need a prose fetch of AIWG.md to activate their compact core contracts.
77
- const inlineStartup = {
78
- copilot: '.github/copilot-instructions.md', factory: 'AGENTS.md', opencode: 'AGENTS.md',
79
- windsurf: 'AGENTS.md', antigravity: 'AGENTS.md', muse: 'AGENTS.md',
80
- omp: '.omp/AGENTS.md', 'grok-build': 'AGENTS.md',
81
- };
82
-
83
76
  /** Collect selected source contracts, before any tier filter or projection. */
84
77
  export function collectDeploymentRuleSources(opts) {
85
78
  if (opts.ruleSources) {
@@ -135,7 +128,7 @@ export async function prepareRuleDelivery(opts) {
135
128
  const rules = collectDeploymentRuleSources(opts).map(file => {
136
129
  const content = fs.readFileSync(file, 'utf8');
137
130
  const parsed = parseRuleFrontmatter(content);
138
- if (!parsed.valid) throw new Error(`${file}: ${parsed.diagnostics.map(d => d.message).join('; ')}`);
131
+ if (!parsed.valid) throw new Error(formatRuleFrontmatterError(opts.logicalInputPath ? opts.logicalInputPath(file) : file, parsed.data, parsed.diagnostics));
139
132
  const behavior = path.basename(file) === 'BEHAVIOR.md';
140
133
  const rule = { ...parsed.rule, file, content, body: parsed.body, behavior,
141
134
  name: behavior ? `behavior/${path.basename(path.dirname(file))}` : parsed.data.name || path.basename(file, '.md') };
@@ -182,208 +175,8 @@ export async function prepareRuleDelivery(opts) {
182
175
  }
183
176
 
184
177
 
185
- function managed(content, opts) {
186
- return addManagedMarker(content, opts.deployVersion, opts.deploySource || 'bundled');
187
- }
188
- function put(file, content) {
189
- fs.mkdirSync(path.dirname(file), { recursive: true });
190
- fs.writeFileSync(file, content);
191
- }
192
- function block(content, body) {
193
- const marker = /\n?<!-- AIWG:rule-startup:start -->[\s\S]*?<!-- AIWG:rule-startup:end -->\n?/g;
194
- const clean = content.replace(marker, '');
195
- return body ? `${clean.trimEnd()}\n\n<!-- AIWG:rule-startup:start -->\n${body}\n<!-- AIWG:rule-startup:end -->\n` : clean;
196
- }
197
-
198
- function putStartup(file, body) {
199
- const content = fs.existsSync(file) ? read(file) : '<!-- aiwg-managed -->\n';
200
- writeContextFileSync(file, block(content, body));
201
- }
202
-
203
- /** Tagged rules bypass legacy aggregate writers. Untagged projections retain their tier policy. */
204
- function projectRules(opts, provider) {
205
- const rules = projectOnDemandReferences(opts.ruleDelivery.rules, ['claude', 'cursor'].includes(provider.name));
206
- if (opts.contextFiles !== false && provider.name === 'hermes') {
207
- // The old context generator carries hardcoded corpus directives. Only the
208
- // selected contracts below may activate policy; preserve operator prose.
209
- const file = path.join(opts.target, 'AGENTS.md');
210
- const content = read(file);
211
- const clean = content.replace(/(<!-- AIWG:hermes-context:start -->)([\s\S]*?)(<!-- AIWG:hermes-context:end -->)/g,
212
- (_, start, body, end) => start + body.replace(/^### Rule: [\s\S]*?(?=^#{1,3} |(?![\s\S]))/gm, '') + end);
213
- if (clean !== content) writeContextFileSync(file, clean);
214
- }
215
- const nativePaths = ['claude', 'cursor'].includes(provider.name);
216
- const rulesDir = path.isAbsolute(provider.paths.rules || '') ? provider.paths.rules : path.join(opts.target, provider.paths.rules || `.${provider.name}/rules`);
217
- const tagged = rules.filter(rule => rule.tagged);
218
- const extension = provider.name === 'cursor' ? '.mdc' : '.md';
219
- const writeRule = (rule, content) => {
220
- const name = rule.behavior ? `behaviors/${path.basename(path.dirname(rule.file))}` : path.basename(rule.file, '.md');
221
- put(path.join(rulesDir, `${name}${extension}`), managed(content, opts));
222
- };
223
- // Legacy projectors may have enumerated the whole corpus. Rebuild managed
224
- // rule output from the canonical selection; preserve operator-owned files.
225
- for (const file of walk(rulesDir)) {
226
- if (/\.(md|mdc)$/.test(file) && /aiwg:managed/.test(read(file))) fs.rmSync(file);
227
- }
228
- const priorManifestPath = path.join(rulesDir, '.aiwg-manifest.json');
229
- const priorSources = fs.existsSync(priorManifestPath) ? JSON.parse(read(priorManifestPath)).ruleSources || [] : [];
230
- for (const source of priorSources.filter(file => !rules.some(rule => rule.file === file))) {
231
- const name = path.basename(source) === 'BEHAVIOR.md' ? `behaviors/${path.basename(path.dirname(source))}` : path.basename(source, '.md');
232
- for (const ext of ['.md', '.mdc']) {
233
- const stale = path.join(rulesDir, name + ext);
234
- if (/aiwg:managed/.test(read(stale))) fs.rmSync(stale);
235
- }
236
- }
237
- // Remove former startup bodies even on activation changes and legacy .md -> .mdc migration.
238
- for (const rule of tagged) {
239
- const name = rule.behavior ? `behaviors/${path.basename(path.dirname(rule.file))}` : path.basename(rule.file, '.md');
240
- for (const ext of ['.md', '.mdc']) {
241
- const dest = path.join(rulesDir, `${name}${ext}`);
242
- if (/aiwg:managed/.test(read(dest))) fs.rmSync(dest);
243
- }
244
- }
245
- // Core rules (#3450): compact bodies in the provider's always-loaded surface,
246
- // independent of deploy mode. Native providers get one core-<name> file each;
247
- // the others get a marked section first in their managed startup block.
248
- const cores = [...new Map(tagged.filter(rule => rule.activation === 'core').map(rule => [rule.name, rule])).values()];
249
- if (fs.existsSync(rulesDir)) {
250
- for (const entry of fs.readdirSync(rulesDir).filter(name => /^core-.+\.(md|mdc)$/.test(name))) {
251
- if (/aiwg:managed/.test(read(path.join(rulesDir, entry)))) fs.rmSync(path.join(rulesDir, entry));
252
- }
253
- }
254
- if (nativePaths) {
255
- for (const rule of cores) {
256
- const body = provider.name === 'cursor' ? `---\nalwaysApply: true\n---\n${rule.coreBody}\n` : `${rule.coreBody}\n`;
257
- const dest = path.join(rulesDir, `core-${path.basename(rule.file, '.md')}${extension}`);
258
- if (fs.existsSync(dest) && !/aiwg:managed/.test(read(dest)) && !opts.force) {
259
- console.warn(`Unmanaged core rule left in place: ${dest}. Re-run with --force to replace it.`);
260
- continue;
261
- }
262
- put(dest, managed(body, opts));
263
- }
264
- }
265
- for (const rule of tagged) {
266
- if (rule.activation === 'kernel' || (nativePaths && rule.activation === 'paths')) {
267
- let content = stripTriggersFromContent(rule.content);
268
- if (rule.pinned) {
269
- const parsed = parseRuleFrontmatter(content);
270
- const data = { ...parsed.data, activation: 'kernel' };
271
- delete data.paths;
272
- delete data.bound_to;
273
- content = `---\n${stringify(data)}---\n${parsed.body}`;
274
- }
275
- if (provider.name === 'cursor') content = provider.transformRule(rule.file, content, opts);
276
- writeRule(rule, content);
277
- }
278
- }
279
- // Explicit local/external bundle deployments predate activation metadata.
280
- // Keep their native rule files reachable while they migrate; missing metadata
281
- // in the shipped corpus still uses the on-demand fallback (#3463).
282
- for (const rule of rules.filter(rule => !rule.tagged && !rule.behavior)) {
283
- const source = opts.logicalInputPath ? opts.logicalInputPath(rule.file) : rule.file;
284
- if (/(?:^|\/)agentic\/code\//.test(source.replaceAll('\\', '/'))) continue;
285
- let content = stripTriggersFromContent(rule.content);
286
- if (provider.name === 'cursor') content = provider.transformRule(rule.file, content, opts);
287
- writeRule(rule, content);
288
- }
289
- // A legacy consolidated index can mention now-bound rules. Replace it with an
290
- // activation-selected index when migration starts; pure legacy deployments keep it.
291
- // Hermes's 20K context limit requires a fixed provider projection: only
292
- // frontmatter-CRITICAL kernel bodies are inline (operator decision 2026-10-19).
293
- // Explicit operator pins retain full bodies; other activation metadata and
294
- // every other provider's projection remain unchanged.
295
- const isCritical = rule => String(rule.enforcement || '').trim().toLowerCase() === 'critical';
296
- const deferredKernels = provider.name === 'hermes'
297
- ? rules.filter(rule => rule.tagged && rule.activation === 'kernel' && !rule.pinned && !isCritical(rule)) : [];
298
- const indexRules = rules;
299
- const index = renderRuleKernelIndex(indexRules, nativePaths);
300
- if (tagged.length) {
301
- for (const ext of ['.md', '.mdc']) {
302
- const file = path.join(rulesDir, `RULES-INDEX${ext}`);
303
- if (/aiwg:managed/.test(read(file))) fs.rmSync(file);
304
- }
305
- if (index) put(path.join(rulesDir, `RULES-INDEX${extension}`), managed(provider.name === 'cursor' ? `---\nalwaysApply: true\n---\n${index}` : index, opts));
306
- }
307
- const legacyDemand = rules.filter(rule => !rule.tagged && !rule.behavior && rule.activation === 'on-demand');
308
- if (legacyDemand.length) put(path.join(rulesDir, `RULES-ONDEMAND${extension}`), managed([
309
- '# On-demand rules', '', 'These rules require explicit activation metadata. Fetch the applicable full rule before governed work.', '',
310
- ...legacyDemand.map(rule => `- \`${rule.name}\` — \`aiwg show rule ${rule.name} --body\``), '',
311
- ].join('\n'), opts));
312
- fs.rmSync(path.join(rulesDir, '.aiwg-rules-budget.json'), { force: true });
313
- const manifestPath = path.join(rulesDir, '.aiwg-manifest.json');
314
- const manifest = fs.existsSync(manifestPath) ? JSON.parse(read(manifestPath)) : { managed: {} };
315
- manifest.ruleSources = rules.map(rule => rule.file);
316
- for (const file of walk(rulesDir).filter(file => /\.(md|mdc)$/.test(file) && /aiwg:managed/.test(read(file)))) {
317
- const name = path.relative(rulesDir, file);
318
- manifest.managed[name] = { ...manifest.managed[name], hash: `sha256:${contentHash(read(file))}` };
319
- }
320
- for (const name of Object.keys(manifest.managed)) if (!fs.existsSync(path.join(rulesDir, name))) delete manifest.managed[name];
321
- put(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
322
- if (!nativePaths && opts.contextFiles !== false) {
323
- // The conventional directory is not a loader: startup reaches the complete
324
- // selected bodies through the provider's existing context owner.
325
- const kernels = rules.filter(rule => rule.activation === 'kernel' &&
326
- rule.tagged && (provider.name !== 'hermes' || rule.pinned || isCritical(rule)));
327
- const routes = [...new Set(opts.definitionRoutes || [])];
328
- const routing = routes.length ? `## Invoked artifact definitions\n\nRead the complete definition before invoking its artifact:\n${routes.map(route => `- ${route}`).join('\n')}` : '';
329
- let startupIndex = index;
330
- let startupRouting = routing;
331
- const fetchKernels = deferredKernels.length ? 'Before every task and subagent task, fetch and follow the kernel rules listed below with `aiwg show rule <name> --body` before governed work. Their full rules are binding.' : '';
332
- const coreSection = cores.length ? `${CORE_RULES_START}\n## Core rules\n\n${cores.map(rule => rule.coreBody).join('\n\n')}\n${CORE_RULES_END}` : '';
333
- const renderBody = () => [coreSection, ...kernels.map(rule => `## Rule: ${rule.name}\n\n${rule.body.trim()}`), fetchKernels, startupIndex, startupRouting].filter(Boolean).join('\n\n');
334
- const dest = path.join(opts.target, 'AGENTS.md');
335
- if (provider.name === 'hermes' && block(read(dest), renderBody()).length > 19_000) {
336
- // The complete summary/path index and definition routes can themselves
337
- // exceed 10K. Keep kernel fetch obligations inline and explicitly reach
338
- // the rest through the existing index, rather than dropping contracts.
339
- if (index || routing) {
340
- const name = `RULES-INDEX${extension}`;
341
- const content = managed([index, routing].filter(Boolean).join('\n\n'), opts);
342
- put(path.join(rulesDir, name), content);
343
- manifest.managed[name] = { ...manifest.managed[name], hash: `sha256:${contentHash(content)}` };
344
- put(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
345
- }
346
- const deferredFiles = new Set(deferredKernels.map(rule => rule.file));
347
- const kernelIndex = renderRuleKernelIndex(indexRules.filter(rule => deferredFiles.has(rule.file)));
348
- startupIndex = [kernelIndex,
349
- index || routing ? 'Before every task and subagent task, read and follow `.hermes/rules/RULES-INDEX.md` for summary rules, path checks, and invoked artifact definitions. Fetch matching full rules before governed work.' : '',
350
- ].filter(Boolean).join('\n\n');
351
- startupRouting = '';
352
- }
353
- const body = renderBody();
354
- if (!body) {
355
- // No activation-selected startup contract: retain legacy context owners
356
- // without inventing an empty policy file or a dangling bootstrap read.
357
- const contexts = ['AIWG.md', 'AGENTS.md', 'WARP.md', '.hermes.md', inlineStartup[provider.name]].filter(Boolean).map(name => path.join(opts.target, name));
358
- if (opts.activeWorkspace) contexts.push(path.join(opts.activeWorkspace, 'AGENTS.md'));
359
- for (const file of contexts) {
360
- if (!fs.existsSync(file)) continue;
361
- const content = read(file);
362
- const clean = block(content, '');
363
- if (clean !== content) writeContextFileSync(file, clean);
364
- }
365
- return;
366
- }
367
- if (inlineStartup[provider.name]) {
368
- // Retire the B1 indirect startup block when migrating to the actual loader.
369
- const former = path.join(opts.target, 'AIWG.md');
370
- if (fs.existsSync(former)) writeContextFileSync(former, block(read(former), ''));
371
- putStartup(path.join(opts.target, inlineStartup[provider.name]), body);
372
- } else if (provider.name === 'hermes') {
373
- const dest = path.join(opts.target, 'AGENTS.md');
374
- putStartup(dest, body);
375
- putStartup(path.join(opts.target, '.hermes.md'), 'Read and follow `AGENTS.md` in this directory before every task and subagent task.');
376
- } else if (provider.name === 'warp') {
377
- const dest = path.join(opts.target, 'WARP.md');
378
- putStartup(dest, body);
379
- } else {
380
- const dest = path.join(opts.target, 'AIWG.md');
381
- putStartup(dest, body);
382
- const bridge = provider.name === 'openclaw' ? path.join(opts.activeWorkspace, 'AGENTS.md') : path.join(opts.target, 'AGENTS.md');
383
- putStartup(bridge, `Read and follow ${JSON.stringify(dest)} before every task and subagent task. It contains the complete activation-selected kernel and rule index.`);
384
- }
385
- }
386
- }
178
+ const managed = (content, opts) => addManagedMarker(content, opts.deployVersion, opts.deploySource || 'bundled');
179
+ function put(file, content) { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, content); }
387
180
 
388
181
  /** External helpers also project skills/flows. Inject into their body, never descriptions. */
389
182
  function finishBindings(opts, provider) {
@@ -511,9 +304,9 @@ function projectBoundFlowSkills(opts, provider, selected) {
511
304
 
512
305
  /** Count rule sections, excluding aggregated agent/command definitions and project prose. */
513
306
  export function warpRuleContent(content) {
514
- const blocks = [...content.matchAll(/<!-- AIWG:rule-startup:start -->[\s\S]*?<!-- AIWG:rule-startup:end -->/g)].map(match => match[0]);
307
+ const blocks = [...content.matchAll(/<!-- AIWG:(rule-(?:startup|core|hook-[\w-]+)):start -->[\s\S]*?<!-- AIWG:\1:end -->/g)].map(match => match[0]);
515
308
  // Remove managed blocks first so their internal headings cannot be counted twice.
516
- const remaining = content.replace(/<!-- AIWG:rule-startup:start -->[\s\S]*?<!-- AIWG:rule-startup:end -->/g, '');
309
+ const remaining = content.replace(/<!-- AIWG:(rule-(?:startup|core|hook-[\w-]+)):start -->[\s\S]*?<!-- AIWG:\1:end -->/g, '');
517
310
  const sections = [...remaining.matchAll(/^## (?:AIWG Rules|On-Demand Rules)\r?\n[\s\S]*?(?=^## |(?![\s\S]))/gm)].map(match => match[0]);
518
311
  return [...sections, ...blocks].join('\n');
519
312
  }
@@ -522,19 +315,19 @@ function startupFiles(opts, provider) {
522
315
  const bridgeNames = { claude: ['CLAUDE.md'], cursor: ['AGENTS.md'], codex: ['AGENTS.md'], hermes: ['AGENTS.md', '.hermes.md'], pi: ['AGENTS.md'], warp: ['WARP.md'], openclaw: [] };
523
316
  const paths = ['AIWG.md', 'WORKSPACE.md', '.aiwg/AIWG.md', ...(bridgeNames[provider.name] || ['AGENTS.md']), inlineStartup[provider.name]].filter(Boolean).map(name => path.join(opts.target, name));
524
317
  if (opts.activeWorkspace) paths.push(path.join(opts.activeWorkspace, 'AGENTS.md'));
525
- if (['claude', 'cursor', 'openclaw'].includes(provider.name)) {
526
- const dir = path.isAbsolute(provider.paths.rules) ? provider.paths.rules : path.join(opts.target, provider.paths.rules);
318
+ {
319
+ // Hook-reached files count too: moving a body must not hide its budget cost.
320
+ const dir = ruleDirectory(opts, provider);
527
321
  paths.push(...walk(dir).filter(file => /\.(md|mdc)$/.test(file)));
528
322
  }
529
323
  return [...new Set(paths)].filter(file => fs.existsSync(file)).map(file => {
530
324
  let content = read(file);
531
- if (['claude', 'cursor'].includes(provider.name)) {
325
+ if (nativePathLoader(provider.name)) {
532
326
  const parsed = parseRuleFrontmatter(content);
533
327
  if (parsed.data?.paths || parsed.data?.globs) content = content.slice(0, content.length - parsed.body.length);
534
328
  }
535
- // WARP.md and Windsurf's AGENTS.md aggregate agents (and Warp's commands)
536
- // as well; only their rule content (managed startup blocks, legacy inline
537
- // rules, and on-demand lists) counts toward the rules startup budget.
329
+ // Count managed rule sections while preserving historical accounting for
330
+ // operator aggregates; discrete hook-reached rule files are counted above.
538
331
  if ((provider.name === 'warp' && path.basename(file) === 'WARP.md')
539
332
  || (provider.name === 'windsurf' && file === path.join(opts.target, 'AGENTS.md'))) content = warpRuleContent(content);
540
333
  return { path: file, content };
@@ -1007,7 +800,7 @@ export async function prepareRuleDeployment(original, provider, deploy) {
1007
800
  for (const dir of new Set([`.${provider.name}`, '.agents', '.aiwg/skills', ...relativeRoots])) mount(path.join(target, dir), path.join(stage, dir));
1008
801
  fs.mkdirSync(path.join(stage, '.aiwg'), { recursive: true });
1009
802
  if (fs.existsSync(projectSnapshot)) materializeInput(projectSnapshot, path.join(stage, '.aiwg', 'aiwg.config'));
1010
- const rootNames = ['AGENTS.md', 'AIWG.md', 'WORKSPACE.md', 'CLAUDE.md', 'WARP.md', '.hermes.md', '.aiwg/AIWG.md', '.aiwg/frameworks/registry.json'];
803
+ const rootNames = ['opencode.json', 'AGENTS.md', 'AIWG.md', 'WORKSPACE.md', 'CLAUDE.md', 'WARP.md', '.hermes.md', '.aiwg/AIWG.md', '.aiwg/frameworks/registry.json'];
1011
804
  if (provider.name === 'windsurf') rootNames.push('.windsurfrules');
1012
805
  for (const framework of getFrameworksForMode(original.srcRoot, original.mode)) {
1013
806
  for (const entry of framework.manifest?.memory?.creates || []) {
@@ -1116,8 +909,10 @@ export async function prepareRuleDeployment(original, provider, deploy) {
1116
909
  }
1117
910
  delivery.bindings = remappedBindings;
1118
911
  preimages.push(...snapshotPreimages([...delivery.rules.map(rule => rule.file), ...delivery.targets.map(entry => entry.source), path.join(target, '.aiwg', 'aiwg.config')]));
1119
- const opts = { ...original, target: stage, dryRun: false, ruleDelivery: delivery,
912
+ const opts = { ...original, target: stage, dryRun: false, ruleDelivery: delivery, logicalOutputPath: file => logicalProviderOutputPath(file, stage, target, mappings),
1120
913
  kernelSkillsPath: kernel, deploymentHome: home, activeWorkspace, hermesLegacySkills, legacyCodexSkills, staging: true };
914
+ if (!opts.deferRuleProjection && (opts.kernelOnly || opts.deployRules || opts.rulesOnly ||
915
+ (!opts.skillsOnly && !opts.commandsOnly && (inlineStartup[provider.name] || ['hermes', 'warp'].includes(provider.name))))) retireInlineStartup(opts, provider);
1121
916
  await deploySelectedSurface(opts, provider, deploy);
1122
917
  if (!opts.commandsOnly && !opts.skillsOnly && !opts.rulesOnly && opts.deployBehaviors !== false) {
1123
918
  deployEmulatedBehaviors(delivery.rules.filter(rule => rule.behavior).map(rule => path.dirname(rule.file)), provider.name, stage, opts);
@@ -1135,10 +930,13 @@ export async function prepareRuleDeployment(original, provider, deploy) {
1135
930
  }
1136
931
  }
1137
932
  projectBoundFlowSkills(opts, provider, selected);
1138
- if (provider.name === 'warp') {
933
+ if (['warp', 'windsurf'].includes(provider.name)) {
934
+ for (const file of walk(path.join(stage, `.${provider.name}`, 'commands'))) {
935
+ if (/\.md$/.test(file)) opts.definitionRoutes.push(`${path.basename(file, '.md')}: .${provider.name}/commands/${path.basename(file)}`);
936
+ }
1139
937
  for (const entry of delivery.targets.filter(entry => entry.type === 'agent' && selected(entry))) {
1140
- const dest = path.join(stage, '.warp', 'agents', path.basename(entry.source));
1141
- if (fs.existsSync(dest)) opts.definitionRoutes.push(`${entry.name}: .warp/agents/${path.basename(entry.source)}`);
938
+ const dest = path.join(stage, `.${provider.name}`, 'agents', path.basename(entry.source));
939
+ if (fs.existsSync(dest)) opts.definitionRoutes.push(`${entry.name}: .${provider.name}/agents/${path.basename(entry.source)}`);
1142
940
  }
1143
941
  }
1144
942
  if (!opts.deferRuleProjection) {
@@ -20,14 +20,23 @@ export function projectOnDemandReferences(rules, nativePaths = false) {
20
20
  });
21
21
  }
22
22
 
23
- export function renderRuleKernelIndex(rules, nativePaths = false) {
23
+ export function renderRuleKernelIndex(rules, nativePaths = false, perRuleFetch = false, kernelFile) {
24
24
  const summary = rules.filter(rule => rule.tagged && (rule.canonicalActivation || rule.activation) === 'summary');
25
25
  const paths = rules.filter(rule => rule.tagged && (rule.canonicalActivation || rule.activation) === 'paths');
26
- const kernels = rules.filter(rule => rule.tagged && (rule.canonicalActivation || rule.activation) === 'kernel');
26
+ const kernels = rules.filter(rule => rule.tagged && (kernelFile || perRuleFetch ? rule.activation : rule.canonicalActivation || rule.activation) === 'kernel');
27
27
  if (!summary.length && !paths.length && !kernels.length) return '';
28
28
  const lines = ['# Rule kernel index', ''];
29
- for (const rule of kernels) lines.push(`- ${rule.name} — ${rule.summary || 'Fetch and follow the full rule before governed work.'} Fetch and follow: \`aiwg show rule ${rule.name} --body\`.`, '');
30
- for (const rule of summary) lines.push(`- ${rule.name} — ${rule.summary} Fetch and follow: \`aiwg show rule ${rule.name} --body\`.`, '');
29
+ // RULES-INDEX receipts are parsed by deployment accounting; retain their command format.
30
+ if (!perRuleFetch) lines.push("Fetch and follow each rule's full body before governed work: `aiwg show rule <name> --body`.", '');
31
+ if (kernelFile && kernels.length) lines.push('Read and follow every kernel file below before every task and subagent task.', '');
32
+ for (const rule of kernels) lines.push(kernelFile
33
+ ? `- ${rule.name} — ${rule.summary || 'Read and follow the complete kernel rule.'} Read and follow: [${kernelFile(rule)}](./${kernelFile(rule)}).`
34
+ : perRuleFetch
35
+ ? `- ${rule.name} — ${rule.summary || 'Fetch and follow the full rule before governed work.'} Fetch and follow: \`aiwg show rule ${rule.name} --body\`.`
36
+ : `- ${rule.name}${rule.summary ? ` — ${rule.summary}` : ''}`, '');
37
+ for (const rule of summary) lines.push(perRuleFetch
38
+ ? `- ${rule.name} — ${rule.summary} Fetch and follow: \`aiwg show rule ${rule.name} --body\`.`
39
+ : `- ${rule.name}${rule.summary ? ` — ${rule.summary}` : ''}`, '');
31
40
  if (paths.length) {
32
41
  lines.push(nativePaths ? '## Path rules (native)' : '## Path rules (prompt emulation)', '',
33
42
  nativePaths ? 'The provider loads these rules for matching paths; full contracts remain available through the commands below.' : 'Before reading or changing files, compare intended project-relative paths with the globs below and fetch matching rules before their first read/write. If paths are initially unknown, check when they become known. An agent-only task has no path match. This is prompt emulation, not a filesystem hook.', '');