@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.
- package/agentic/code/addons/aiwg-utils/rules/anti-laziness.core.md +13 -0
- package/agentic/code/addons/aiwg-utils/rules/anti-laziness.md +118 -0
- package/agentic/code/providers/pi/aiwg-bridge.ts +44 -1
- package/dist/src/artifacts/corpus-tools/cli.js +32 -0
- package/dist/src/artifacts/corpus-tools/discovery-log.js +1 -1
- package/dist/src/artifacts/corpus-tools/expand-cli.js +89 -0
- package/dist/src/artifacts/corpus-tools/expand-queue.js +38 -0
- package/dist/src/artifacts/corpus-tools/expand-state.js +40 -0
- package/dist/src/artifacts/corpus-tools/expand.js +125 -0
- package/dist/src/artifacts/corpus-tools/resolve-cli.js +91 -0
- package/dist/src/artifacts/corpus-tools/resolve-corpus.js +41 -0
- package/dist/src/artifacts/corpus-tools/resolve.js +105 -0
- package/dist/src/cli/handlers/doctor-args.js +40 -0
- package/dist/src/cli/handlers/doctor-help.js +4 -2
- package/dist/src/cli/handlers/use-bundle-counts.js +32 -6
- package/dist/src/cli/handlers/use-skill-assets.js +207 -0
- package/dist/src/cli/handlers/use.js +30 -193
- package/dist/src/cli/handlers/utilities.js +5 -31
- package/dist/src/config/authorization-cli.js +11 -3
- package/dist/src/config/worker-context.js +33 -4
- package/dist/src/decision/context-pruning-common.js +41 -0
- package/dist/src/decision/context-pruning-evaluation.js +366 -0
- package/dist/src/decision/context-pruning-pilot.js +431 -0
- package/dist/src/decision/context-pruning-types.js +19 -0
- package/dist/src/decision/context-pruning.js +5 -847
- package/dist/src/decision/ensemble/contract.js +4 -24
- package/dist/src/decision/heldout/collector.js +1 -1
- package/dist/src/decision/qualification/release.js +5 -62
- package/dist/src/extensions/manifest.js +8 -1
- package/dist/src/extensions/project-local-doctor.js +78 -2
- package/dist/src/extensions/validation.js +10 -11
- package/dist/src/features/catalog.js +1 -1
- package/dist/src/gates/evaluate.js +5 -15
- package/dist/src/gates/heldout.js +42 -0
- package/dist/src/gates/index.js +2 -1
- package/dist/src/gates/upstream-ceiling.js +111 -0
- package/dist/src/models/provider-models.js +5 -8
- package/dist/src/models/worker-installation-store.mjs +228 -0
- package/dist/src/models/worker-installation.mjs +7 -162
- package/dist/src/models/wrapper-definitions.js +14 -0
- package/dist/src/models/wrapper-deployment.js +48 -25
- package/dist/src/models/wrapper-enforcement.js +72 -0
- package/dist/src/policy/hitl-check.js +80 -0
- package/dist/src/providers/provider-definitions.js +10 -10
- package/dist/src/research/clients/arxiv.js +10 -4
- package/dist/src/research/clients/base.js +5 -4
- package/dist/src/research/clients/crossref.js +9 -1
- package/dist/src/research/clients/semantic-scholar.js +73 -44
- package/dist/src/research/identity.js +85 -0
- package/dist/src/research/index.js +1 -0
- package/dist/src/research/reference-match.js +89 -0
- package/dist/src/rules/activation.d.mts +2 -0
- package/dist/src/rules/activation.mjs +23 -0
- package/dist/src/rules/core-startup.d.mts +2 -0
- package/dist/src/rules/core-startup.mjs +31 -0
- package/dist/src/skills/adapters/local.js +32 -9
- package/dist/src/skills/agent-skills.js +2 -0
- package/dist/src/skills/cli-display.js +33 -0
- package/dist/src/skills/cli.js +2 -26
- package/dist/src/skills/collision-discovery.js +84 -0
- package/dist/src/skills/deployer.js +20 -75
- package/dist/src/skills/deployment-ownership.js +74 -0
- package/dist/src/skills/doctor.js +2 -2
- package/dist/src/skills/importer.js +4 -26
- package/dist/src/skills/registry.js +22 -7
- package/dist/src/smiths/context-pipeline/agents-md.js +34 -0
- package/dist/src/smiths/context-pipeline/aiwg-md.js +3 -0
- package/dist/src/smiths/context-pipeline/bridge-ownership.js +50 -0
- package/dist/src/smiths/context-pipeline/generator.js +40 -104
- package/dist/src/smiths/context-pipeline/managed-hook.js +10 -0
- package/dist/src/smiths/context-pipeline/parallelism-section.js +7 -3
- package/package.json +6 -2
- package/tools/agents/deploy-agents.mjs +2 -123
- package/tools/agents/providers/antigravity.mjs +4 -6
- package/tools/agents/providers/base.mjs +3 -3
- package/tools/agents/providers/claude.mjs +3 -5
- package/tools/agents/providers/codex.mjs +3 -5
- package/tools/agents/providers/context-write.mjs +12 -0
- package/tools/agents/providers/copilot.mjs +3 -5
- package/tools/agents/providers/cursor.mjs +3 -5
- package/tools/agents/providers/factory.mjs +3 -5
- package/tools/agents/providers/grok-build.mjs +17 -12
- package/tools/agents/providers/hermes-skill-lifecycle.mjs +144 -0
- package/tools/agents/providers/hermes-startup.mjs +209 -0
- package/tools/agents/providers/hermes.mjs +9 -359
- package/tools/agents/providers/model-wrapper.mjs +90 -0
- package/tools/agents/providers/muse.mjs +3 -3
- package/tools/agents/providers/omp.mjs +3 -1
- package/tools/agents/providers/openclaw.mjs +3 -5
- package/tools/agents/providers/opencode.mjs +3 -5
- package/tools/agents/providers/pi.mjs +1 -1
- package/tools/agents/providers/provider-paths-staging.mjs +9 -0
- package/tools/agents/providers/rule-delivery.mjs +26 -228
- package/tools/agents/providers/rule-presentation.mjs +13 -4
- package/tools/agents/providers/rule-projection.mjs +119 -0
- package/tools/agents/providers/rule-startup.mjs +70 -0
- package/tools/agents/providers/stale-artifact-prune.mjs +128 -0
- package/tools/agents/providers/warp.mjs +5 -7
- package/tools/agents/providers/windsurf.mjs +14 -62
- package/tools/plugin/package-plugins.mjs +2 -2
- package/tools/plugin/plugin-links.mjs +3 -0
- package/tools/skills/codex-skill-transform.mjs +232 -0
- package/tools/skills/deploy-skills-codex.mjs +8 -249
- 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
|
|
59
|
-
//
|
|
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
|
|
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
|
|
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
|
|
@@ -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,
|
|
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 {
|
|
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(
|
|
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
|
-
|
|
186
|
-
|
|
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:
|
|
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:
|
|
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
|
-
|
|
526
|
-
|
|
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 (
|
|
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
|
-
//
|
|
536
|
-
//
|
|
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
|
|
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,
|
|
1141
|
-
if (fs.existsSync(dest)) opts.definitionRoutes.push(`${entry.name}: .
|
|
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
|
-
|
|
30
|
-
|
|
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.', '');
|