@aiwg/cli 2026.10.16 → 2026.10.19

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 (155) hide show
  1. package/agentic/code/providers/capability-matrix.yaml +51 -0
  2. package/agentic/code/providers/flue/README.md +62 -0
  3. package/agentic/code/providers/flue/templates/aiwg/tools.ts +120 -0
  4. package/agentic/code/providers/model-capabilities.v1.json +23 -0
  5. package/agentic/code/providers/model-catalog.v1.json +9 -0
  6. package/dist/src/artifacts/corpus-tools/resolve.js +28 -6
  7. package/dist/src/artifacts/query-engine-corpus.js +217 -0
  8. package/dist/src/artifacts/query-engine-discover-output.js +229 -0
  9. package/dist/src/artifacts/query-engine-discover.js +285 -0
  10. package/dist/src/artifacts/query-engine-entries.js +188 -0
  11. package/dist/src/artifacts/query-engine-index.js +249 -0
  12. package/dist/src/artifacts/query-engine-matching.js +143 -0
  13. package/dist/src/artifacts/query-engine-options.js +2 -0
  14. package/dist/src/artifacts/query-engine-rules.js +202 -0
  15. package/dist/src/artifacts/query-engine-scoring.js +436 -0
  16. package/dist/src/artifacts/query-engine-show-card.js +194 -0
  17. package/dist/src/artifacts/query-engine-show-load.js +211 -0
  18. package/dist/src/artifacts/query-engine-show.js +300 -0
  19. package/dist/src/artifacts/query-engine.js +7 -2576
  20. package/dist/src/cli/handlers/help.js +1 -1
  21. package/dist/src/cli/handlers/init.js +1 -0
  22. package/dist/src/cli/handlers/mc-agents.js +111 -0
  23. package/dist/src/cli/handlers/mc-args.js +54 -0
  24. package/dist/src/cli/handlers/mc-control.js +227 -0
  25. package/dist/src/cli/handlers/mc-dispatch.js +203 -0
  26. package/dist/src/cli/handlers/mc-help.js +171 -0
  27. package/dist/src/cli/handlers/mc-run.js +343 -0
  28. package/dist/src/cli/handlers/mc-session.js +138 -0
  29. package/dist/src/cli/handlers/mc-status.js +258 -0
  30. package/dist/src/cli/handlers/mc-summary.js +43 -0
  31. package/dist/src/cli/handlers/mc-types.js +3 -0
  32. package/dist/src/cli/handlers/mc-worker.js +205 -0
  33. package/dist/src/cli/handlers/mc.js +12 -1665
  34. package/dist/src/cli/handlers/models-refusal.js +13 -0
  35. package/dist/src/cli/handlers/models.js +2 -1
  36. package/dist/src/cli/handlers/remove-bundled.js +133 -0
  37. package/dist/src/cli/handlers/remove-options.js +31 -0
  38. package/dist/src/cli/handlers/remove-user.js +174 -0
  39. package/dist/src/cli/handlers/remove.js +201 -0
  40. package/dist/src/cli/handlers/subcommands-bundles.js +257 -0
  41. package/dist/src/cli/handlers/subcommands-discovery.js +165 -0
  42. package/dist/src/cli/handlers/subcommands-list-format.js +129 -0
  43. package/dist/src/cli/handlers/subcommands-list.js +250 -0
  44. package/dist/src/cli/handlers/subcommands-plugins.js +213 -0
  45. package/dist/src/cli/handlers/subcommands-quickref.js +58 -0
  46. package/dist/src/cli/handlers/subcommands-rlm.js +113 -0
  47. package/dist/src/cli/handlers/subcommands-services.js +66 -0
  48. package/dist/src/cli/handlers/subcommands-storage.js +259 -0
  49. package/dist/src/cli/handlers/subcommands.js +18 -1984
  50. package/dist/src/cli/handlers/use.js +11 -5
  51. package/dist/src/cli/scope-resolver.js +1 -142
  52. package/dist/src/cli/services/deployment-verification.js +3 -0
  53. package/dist/src/cli/user-scope-mirror.js +173 -0
  54. package/dist/src/config/dispatch-host-thresholds.js +2 -0
  55. package/dist/src/config/dispatch-thresholds-runtime.mjs +4 -0
  56. package/dist/src/config/host-resource-report.d.mts +5 -0
  57. package/dist/src/config/host-resource-report.mjs +36 -6
  58. package/dist/src/config/host-resource-runtime.d.mts +3 -0
  59. package/dist/src/config/host-resource-runtime.mjs +9 -6
  60. package/dist/src/decision/ensemble-study/artifacts.js +7 -0
  61. package/dist/src/decision/ensemble-study/gate-policy.js +58 -0
  62. package/dist/src/decision/ensemble-study/gates.js +78 -0
  63. package/dist/src/decision/ensemble-study/protocol.js +18 -21
  64. package/dist/src/decision/ensemble-study/score.js +3 -2
  65. package/dist/src/decision/ensemble-study/statistics.js +7 -26
  66. package/dist/src/decision/sensitivity/comparative-gates.js +135 -0
  67. package/dist/src/decision/sensitivity/comparative.js +18 -41
  68. package/dist/src/extensions/claude-hooks-installer.js +18 -0
  69. package/dist/src/gates/evaluate.js +2 -358
  70. package/dist/src/gates/observations.js +363 -0
  71. package/dist/src/gates/pack-composition.js +270 -0
  72. package/dist/src/gates/pack-tightening.js +197 -0
  73. package/dist/src/gates/pack-validation.js +262 -0
  74. package/dist/src/gates/registry-error.js +5 -0
  75. package/dist/src/gates/registry.js +13 -685
  76. package/dist/src/mcp/json-document.mjs +29 -0
  77. package/dist/src/mcp/muse-native-config.mjs +1 -28
  78. package/dist/src/memory/provider-memory-adapter.js +1 -0
  79. package/dist/src/mission-protocol/worker-review-gate.js +7 -0
  80. package/dist/src/models/model-capabilities.v1.json +23 -0
  81. package/dist/src/models/model-catalog.v1.json +9 -0
  82. package/dist/src/models/policy-resources.js +1 -1
  83. package/dist/src/models/worker-plan.js +5 -5
  84. package/dist/src/plugin/command-ownership.js +34 -0
  85. package/dist/src/plugin/skill-command-frontmatter.js +197 -0
  86. package/dist/src/plugin/skill-command-translator.js +6 -232
  87. package/dist/src/providers/capability-matrix.yaml +51 -0
  88. package/dist/src/providers/context-output-ownership.js +26 -0
  89. package/dist/src/providers/deployment-ownership.d.mts +20 -0
  90. package/dist/src/providers/deployment-ownership.mjs +236 -0
  91. package/dist/src/providers/deployment-removal.js +222 -0
  92. package/dist/src/providers/provider-context-contracts.js +8 -0
  93. package/dist/src/providers/provider-definition-schema.js +1 -0
  94. package/dist/src/providers/provider-definitions.js +1 -0
  95. package/dist/src/providers/provider-seeds-3.js +18 -0
  96. package/dist/src/providers/removal-transaction.js +86 -0
  97. package/dist/src/providers/settings-document.d.mts +3 -0
  98. package/dist/src/providers/settings-document.mjs +47 -0
  99. package/dist/src/providers/settings-removal.js +190 -0
  100. package/dist/src/providers/skill-ownership.d.mts +20 -2
  101. package/dist/src/providers/skill-ownership.mjs +12 -4
  102. package/dist/src/providers/transformation-receipt-integration.js +15 -271
  103. package/dist/src/providers/transformation-receipt-outputs.js +99 -0
  104. package/dist/src/providers/transformation-receipt-source.js +194 -0
  105. package/dist/src/research/identity.js +8 -2
  106. package/dist/src/research/reference-match.js +66 -8
  107. package/dist/src/rules/activation.mjs +15 -6
  108. package/dist/src/rules/core-startup.mjs +2 -2
  109. package/dist/src/serve/mission-conductor.js +4 -0
  110. package/dist/src/serve/mission-summary.js +56 -0
  111. package/dist/src/skills/deployment-ownership.js +2 -2
  112. package/dist/src/skills/deployment-policy.js +9 -0
  113. package/dist/src/smiths/context-pipeline/aiwg-md.js +23 -0
  114. package/dist/src/smiths/context-pipeline/context-file-safety.js +3 -0
  115. package/dist/src/smiths/context-pipeline/flue-context.js +25 -0
  116. package/dist/src/smiths/context-pipeline/generator.js +7 -2
  117. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +9 -7
  118. package/dist/src/smiths/hook-bridge/index.js +9 -0
  119. package/package.json +5 -1
  120. package/schemas/decision/D17StudyProtocol.v1.schema.json +39 -67
  121. package/tools/agents/deploy-agents.mjs +21 -680
  122. package/tools/agents/deploy-command-mirrors.mjs +229 -0
  123. package/tools/agents/deploy-options.mjs +267 -0
  124. package/tools/agents/deploy-support.mjs +165 -0
  125. package/tools/agents/providers/base-addon-discovery.mjs +139 -0
  126. package/tools/agents/providers/base-behaviors.mjs +168 -0
  127. package/tools/agents/providers/base-context.mjs +205 -0
  128. package/tools/agents/providers/base-contract.mjs +116 -0
  129. package/tools/agents/providers/base-files.mjs +252 -0
  130. package/tools/agents/providers/base-flat-artifacts.mjs +233 -0
  131. package/tools/agents/providers/base-framework-discovery.mjs +309 -0
  132. package/tools/agents/providers/base-frontmatter.mjs +196 -0
  133. package/tools/agents/providers/base-inventory.mjs +269 -0
  134. package/tools/agents/providers/base-kernel-skills.mjs +354 -0
  135. package/tools/agents/providers/base-migrations.mjs +258 -0
  136. package/tools/agents/providers/base-models-platforms.mjs +273 -0
  137. package/tools/agents/providers/base-rule-index.mjs +450 -0
  138. package/tools/agents/providers/base-runtime.mjs +60 -0
  139. package/tools/agents/providers/base-skill-copy.mjs +273 -0
  140. package/tools/agents/providers/base.mjs +16 -3364
  141. package/tools/agents/providers/claude-post-deploy.mjs +10 -2
  142. package/tools/agents/providers/flue-project.mjs +79 -0
  143. package/tools/agents/providers/flue-specialists.mjs +64 -0
  144. package/tools/agents/providers/flue.mjs +50 -0
  145. package/tools/agents/providers/hermes-startup.mjs +0 -5
  146. package/tools/agents/providers/muse.mjs +7 -2
  147. package/tools/agents/providers/rule-delivery-surface.mjs +33 -5
  148. package/tools/agents/providers/rule-deployment-commit.mjs +19 -15
  149. package/tools/agents/providers/rule-deployment-prepare.mjs +13 -3
  150. package/tools/agents/providers/rule-projection.mjs +3 -0
  151. package/tools/agents/providers/rule-startup.mjs +3 -3
  152. package/tools/agents/use-rule-selection.mjs +17 -0
  153. package/tools/ralph-external/lib/worker-invocation-processes.mjs +4 -2
  154. package/tools/ralph-external/lib/worker-termination.mjs +15 -8
  155. package/vscode-extension/schemas/aiwg.config.v1.json +2 -4
@@ -20,7 +20,8 @@ export function parsePartialReference(input, year) {
20
20
  else if (date)
21
21
  rest = rest.replace(date[0], '');
22
22
  rest = rest.replace(/^[\s.,;:()[\]{}"']+|[\s.,;:()[\]{}"']+$/g, '').trim();
23
- return { input, identifier, title: normalizeTitle(rest) ? rest : undefined, year: year ?? (inferredYear ? Number(inferredYear) : undefined), firstAuthor };
23
+ const publicationYear = Number.isInteger(year) ? year : (inferredYear ? Number(inferredYear) : undefined);
24
+ return { input, identifier, title: normalizeTitle(rest) ? rest : undefined, year: publicationYear, firstAuthor };
24
25
  }
25
26
  /** Token coverage discounted by sequence order; ordered prefixes retain coverage scores. */
26
27
  export function titleSimilarity(left, right) {
@@ -45,16 +46,51 @@ export function titleSimilarity(left, right) {
45
46
  const repetition = Math.min(uniqueA.size / a.length, uniqueB.size / b.length);
46
47
  return coverage * row[b.length] / Math.min(a.length, b.length) * repetition;
47
48
  }
48
- /** Incomplete short/generic titles require an ID; unqualified very short titles need metadata. */
49
+ /** Caution needs competing candidates or an unqualified generic topic, never length alone with metadata. */
49
50
  export function needsTitleDisambiguation(reference, candidates, incomplete) {
50
- if (!reference.title || candidates[0]?.score_parts.identifier === 1)
51
+ if (!reference.title || !candidates.length || candidates[0]?.score_parts.identifier === 1)
52
+ return false;
53
+ const unqualified = reference.year === undefined && !reference.firstAuthor;
54
+ // A 0.25 window preserves caution for short titles sharing three of four tokens
55
+ // (~0.24 behind with author corroboration), excluding weaker hits like 1.000 vs 0.711.
56
+ const competing = candidates.slice(1).some(candidate => classifyCandidates([candidate]) !== 'unresolved' &&
57
+ candidates[0].score - candidate.score <= 0.25 + 1e-12);
58
+ if (!competing && !unqualified)
51
59
  return false;
52
60
  const title = normalizeTitle(reference.title);
53
61
  const tokens = title.split(' ');
54
62
  const informative = tokens.filter(token => !/^(?:a|an|the|of|for|in|on|and|with|to|is|all|you)$/.test(token));
55
63
  const exact = candidates.filter(candidate => normalizeTitle(candidate.paper.title) === title).length;
64
+ // Overview headings and common topic phrases remain generic even after a complete search.
65
+ // Single names/acronyms and distinctive technical phrases keep their complete-search behavior.
66
+ const overview = /^(?:(?:a|an|the) )?(?:tutorial|theory)\b/.test(title);
67
+ const commonTopic = informative.every(token => /^(?:deep|learning|scaling|laws|logical|physical|clocks)$/.test(token));
68
+ const generic = tokens.length > 1 && (tokens.length <= 2 ||
69
+ (informative.length <= 4 && (overview || commonTopic)));
56
70
  return (incomplete && (tokens.length <= 4 || informative.length <= 4 || exact > 1)) ||
57
- (tokens.length <= 2 && reference.year === undefined && !reference.firstAuthor);
71
+ (generic && (unqualified || competing));
72
+ }
73
+ const preprintDoi = (doi) => Boolean(parseArxivId(doi) || /^10\.2139\/ssrn\./i.test(doi));
74
+ function paperSources(paper) {
75
+ const { source, type, arxivId, doi, venue, publicationVenue } = paper;
76
+ return paper.mergedSources ?? [{ source, type, arxivId, doi, venue, publicationVenue }];
77
+ }
78
+ /** Exact titles need corroboration to tolerate one year of preprint/venue lag. */
79
+ export function needsYearReview(reference, candidate) {
80
+ if (reference.year === undefined || !candidate || candidate.score_parts.year !== 0)
81
+ return false;
82
+ const sources = paperSources(candidate.paper);
83
+ const preprint = sources.some(record => record.source === 'arxiv' || record.type === 'preprint' ||
84
+ (record.doi && preprintDoi(record.doi)) || (record.source === 'semantic-scholar' && record.arxivId));
85
+ const venue = sources.some(record => record.doi && !preprintDoi(record.doi) &&
86
+ (record.source === 'crossref' || record.source === 'unpaywall' || record.type === 'conference' ||
87
+ record.type === 'journal' || record.venue || record.publicationVenue?.name));
88
+ // An arXiv id alone cannot prove a preprint/venue split: require both ids and source
89
+ // evidence for both versions (including S2's linked venue), a verified supplied id,
90
+ // or a matching supplied first author. Only exact titles and a one-year gap qualify.
91
+ const supportsLag = Boolean((candidate.paper.arxivId && candidate.paper.doi && preprint && venue) ||
92
+ candidate.score_parts.identifier === 1 || (reference.firstAuthor && candidate.score_parts.first_author === 1));
93
+ return !supportsLag || candidate.score_parts.title !== 1 || Math.abs(reference.year - candidate.paper.year) !== 1;
58
94
  }
59
95
  function surname(name) {
60
96
  return normalizeTitle(name.includes(',') ? name.split(',')[0] : name.trim().split(/\s+/).at(-1) ?? '');
@@ -87,18 +123,34 @@ export function classifyCandidates(candidates) {
87
123
  const margin = best - (candidates[1]?.score ?? 0);
88
124
  return best + 1e-12 >= 0.92 && margin + 1e-12 >= 0.05 ? 'resolved' : 'ambiguous';
89
125
  }
90
- /** Shared IDs require title similarity >= 0.5; title agreement never establishes identity. */
126
+ /** Shared IDs or corroborated preprint/publication metadata establish a work, never title alone. */
91
127
  export function mergePapers(papers) {
92
128
  const ids = ['arxivId', 'doi', 's2PaperId', 'openReviewId', 'aclId'];
93
- const published = (paper) => Boolean(paper.doi && !parseArxivId(paper.doi));
129
+ const published = (paper) => Boolean(paper.doi && !preprintDoi(paper.doi));
130
+ const preprint = (paper) => !published(paper) && Boolean(paper.arxivId || (paper.doi && preprintDoi(paper.doi)));
131
+ const sameWorkMetadata = (left, right) => {
132
+ if (!((preprint(left) && published(right)) || (preprint(right) && published(left))))
133
+ return false;
134
+ if (!Number.isInteger(left.year) || !Number.isInteger(right.year) || Math.abs(left.year - right.year) > 2)
135
+ return false;
136
+ if (!normalizeTitle(left.title) || normalizeTitle(left.title) !== normalizeTitle(right.title))
137
+ return false;
138
+ const names = new Set(left.authors.map(author => normalizeTitle(author.name)).filter(Boolean));
139
+ return right.authors.some(author => names.has(normalizeTitle(author.name)));
140
+ };
94
141
  const linked = (left, right) => {
95
142
  const a = normalizeIdentity(left), b = normalizeIdentity(right);
96
143
  if (titleSimilarity(a.title ?? '', b.title ?? '') < 0.5)
97
144
  return false;
145
+ if (published(left) && published(right) && a.doi !== b.doi)
146
+ return false;
147
+ const metadataMatch = sameWorkMetadata(left, right);
148
+ const sharedDoi = [a.doi, ...(a.alternateDois ?? [])].some(doi => doi && [b.doi, ...(b.alternateDois ?? [])].includes(doi));
98
149
  if (ids.some(key => a[key] && b[key] && a[key] !== b[key] &&
99
- !(key === 'doi' && a.arxivId && a.arxivId === b.arxivId && (parseArxivId(a.doi) || parseArxivId(b.doi)))))
150
+ !(key === 'doi' && (metadataMatch || sharedDoi ||
151
+ (a.arxivId && a.arxivId === b.arxivId && (parseArxivId(a.doi) || parseArxivId(b.doi)))))))
100
152
  return false;
101
- return ids.some(key => a[key] && a[key] === b[key]);
153
+ return metadataMatch || sharedDoi || ids.some(key => a[key] && a[key] === b[key]);
102
154
  };
103
155
  const combine = (left, right) => {
104
156
  // A published CrossRef record owns proceedings metadata; other sources fill gaps.
@@ -112,6 +164,12 @@ export function mergePapers(papers) {
112
164
  result[key] = value;
113
165
  }
114
166
  }
167
+ const alternateDois = [...new Set([primary.doi, alternate.doi,
168
+ ...(primary.alternateDois ?? []), ...(alternate.alternateDois ?? [])])]
169
+ .filter((doi) => Boolean(doi && doi !== result.doi));
170
+ if (alternateDois.length)
171
+ result.alternateDois = alternateDois;
172
+ result.mergedSources = [...paperSources(left), ...paperSources(right)];
115
173
  return result;
116
174
  };
117
175
  const merged = [];
@@ -12,8 +12,8 @@ export const RULE_ACTIVATIONS = Object.freeze(['core', 'kernel', 'summary', 'bou
12
12
  // `aiwg show rule <name>`, never an @ import.
13
13
  export const CORE_BODY_MAX_BYTES = 1024;
14
14
  export const CORE_TOTAL_MAX_BYTES = 6144;
15
- export const CORE_RULES_START = '<!-- AIWG:core-rules:start -->';
16
- export const CORE_RULES_END = '<!-- AIWG:core-rules:end -->';
15
+ export const CORE_RULES_START = '<!-- AIWG:rule-core:start -->';
16
+ export const CORE_RULES_END = '<!-- AIWG:rule-core:end -->';
17
17
  const AT_IMPORT = /(?:^|[\s(`"'])@[\w$.\/-]*[\/.][\w$.\/-]*/m;
18
18
 
19
19
  export const RULE_BINDING_TYPES = Object.freeze({ skills: 'skill', agents: 'agent', flows: 'flow' });
@@ -147,12 +147,21 @@ export function measureDeployedCoreRules(target, provider, rulesDir) {
147
147
  const file = path.join(target, name);
148
148
  if (!existsSync(file)) continue;
149
149
  const content = readFileSync(file, 'utf8');
150
- const start = content.indexOf(CORE_RULES_START);
151
- const end = content.indexOf(CORE_RULES_END);
152
- if (start >= 0 && end > start) {
153
- bodies.push({ name, bytes: Buffer.byteLength(content.slice(start + CORE_RULES_START.length, end).trim(), 'utf8') });
150
+ for (const [startMarker, endMarker] of [[CORE_RULES_START, CORE_RULES_END],
151
+ ['<!-- AIWG:core-rules:start -->', '<!-- AIWG:core-rules:end -->']]) {
152
+ const start = content.indexOf(startMarker);
153
+ const end = content.indexOf(endMarker);
154
+ if (start < 0 || end <= start) continue;
155
+ const section = content.slice(start + startMarker.length, end).trim();
156
+ const parts = section.replace(/^## Core rules\s*/, '').split(/(?=^# Core: )/m).filter(text => text.trim());
157
+ const named = parts.every(text => /^# Core: /m.test(text));
158
+ for (const text of named ? parts : [section]) {
159
+ const ruleName = text.match(/aiwg show rule ([\w-]+)/)?.[1];
160
+ bodies.push({ name: ruleName || name, bytes: Buffer.byteLength(text.trim(), 'utf8') });
161
+ }
154
162
  break;
155
163
  }
164
+ if (bodies.length) break;
156
165
  }
157
166
  }
158
167
  return { bodies, bytes: bodies.reduce((sum, item) => sum + item.bytes, 0), limit: CORE_TOTAL_MAX_BYTES };
@@ -3,13 +3,13 @@ import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import { fileURLToPath } from 'node:url';
5
5
  import { findPackageRoot } from '../cli/find-package-root.js';
6
- import { parseRuleFrontmatter, readCoreBody, validateCoreSet } from './activation.mjs';
6
+ import { parseRuleFrontmatter, readCoreBody, validateCoreSet, CORE_RULES_START, CORE_RULES_END } from './activation.mjs';
7
7
 
8
8
  export function renderCoreStartup(rules) {
9
9
  const cores = [...new Map(rules.filter(rule => rule.coreBody !== undefined).map(rule => [rule.name, rule])).values()];
10
10
  const errors = validateCoreSet(cores.map(rule => ({ name: rule.name, text: rule.coreBody })));
11
11
  if (errors.length) throw new Error(errors.join('; '));
12
- return cores.length ? `<!-- AIWG:rule-core:start -->\n## Core rules\n\n${cores.map(rule => rule.coreBody).join('\n\n')}\n<!-- AIWG:rule-core:end -->\n` : '';
12
+ return cores.length ? `${CORE_RULES_START}\n## Core rules\n\n${cores.map(rule => rule.coreBody).join('\n\n')}\n${CORE_RULES_END}\n` : '';
13
13
  }
14
14
 
15
15
  export function ensureCoreStartup(content) {
@@ -28,6 +28,7 @@ import { assertMissionWorkerHandoff } from '../mission-protocol/codecs.js';
28
28
  import { lookupEffect, reconcileEffect, recordIntent } from '../effects/ledger.js';
29
29
  import { createVerifierRegistry } from '../effects/verifiers/registry.js';
30
30
  import { fileDigestVerifier } from '../effects/verifiers/file.js';
31
+ export { summarizeMissionLedger } from './mission-summary.js';
31
32
  /**
32
33
  * The cross-stack Mission conductor. Decomposes a Mission into worker cycles,
33
34
  * dispatches each to an executor of the chosen runtime via `routeMission`, and
@@ -157,6 +158,7 @@ export class MissionConductor {
157
158
  continue;
158
159
  }
159
160
  let output;
161
+ let workerResult;
160
162
  let cost = 0;
161
163
  let reason = routing.selected.matchReason;
162
164
  try {
@@ -194,6 +196,7 @@ export class MissionConductor {
194
196
  if (!recovered) {
195
197
  const ran = await this.runWorker(cycle, executor, invocation);
196
198
  output = ran.output;
199
+ workerResult = ran.workerResult === undefined ? undefined : structuredClone(ran.workerResult);
197
200
  cost = ran.cost ?? 0;
198
201
  if (intent) {
199
202
  const checked = await reconcile(intent.effectId);
@@ -226,6 +229,7 @@ export class MissionConductor {
226
229
  routed: true,
227
230
  reason,
228
231
  output,
232
+ ...(workerResult ? { workerResult } : {}),
229
233
  cost,
230
234
  ...(graph ? { graph } : {}),
231
235
  };
@@ -0,0 +1,56 @@
1
+ // Read-only classification of conductor checkpoints and existing verifier results.
2
+ import { validateWorkerPayload } from '../mission-protocol/codecs.js';
3
+ import { hasIndependentWorkerAcceptance } from '../mission-protocol/worker-review-gate.js';
4
+ function classify(ledger, cycle) {
5
+ const entry = (status, reason, evidence = []) => ({ cycleId: cycle.cycleId, status, reason, evidence: structuredClone(evidence) });
6
+ if (ledger.checkpoint.failed.includes(cycle.cycleId))
7
+ return entry('failed', 'Conductor recorded failure');
8
+ if (ledger.executionMode !== undefined && !['plan-only', 'executed'].includes(ledger.executionMode)) {
9
+ return entry('unknown', `Unrecognized execution mode: ${String(ledger.executionMode)}`);
10
+ }
11
+ if (ledger.executionMode === 'plan-only' || !cycle.routed
12
+ || !ledger.checkpoint.completed.includes(cycle.cycleId)
13
+ || ledger.checkpoint.pending.includes(cycle.cycleId)) {
14
+ return entry('unknown', 'No completed execution measurement');
15
+ }
16
+ const result = cycle.workerResult;
17
+ if (result !== undefined) {
18
+ const definition = result && typeof result === 'object' && 'mode' in result && result.mode === 'direct'
19
+ ? 'workerDirectResult' : 'workerResult';
20
+ if (!validateWorkerPayload(definition, result).valid || result.taskId !== cycle.cycleId) {
21
+ return entry('unknown', 'Invalid or unbound worker measurement');
22
+ }
23
+ if (result.execution.status === 'failed')
24
+ return entry('failed', 'Adapter recorded worker failure');
25
+ if (result.execution.status !== 'completed')
26
+ return entry('unknown', 'Worker execution is not complete');
27
+ // The result codec already requires confirmed, successful terminal execution
28
+ // and completed worker claims for an accepted verifier verdict.
29
+ if (Date.parse(result.execution.endedAt) >= Date.parse(result.execution.startedAt)
30
+ && hasIndependentWorkerAcceptance(result.verification)) {
31
+ return entry('accepted', 'Independent review accepted with evidence', result.verification.evidence);
32
+ }
33
+ }
34
+ else if (ledger.executionMode !== 'executed') {
35
+ return entry('unknown', 'Legacy checkpoint lacks an execution measurement');
36
+ }
37
+ return entry('completed', 'Worker finished; independent acceptance with evidence is unavailable');
38
+ }
39
+ /** Project existing observations only; no scoring, file reads, sync or writes. */
40
+ export function summarizeMissionLedger(ledger) {
41
+ const counts = { accepted: 0, completed: 0, failed: 0, unknown: 0 };
42
+ const cycles = ledger.cycles.map(cycle => classify(ledger, cycle));
43
+ const measured = new Set(cycles.map(cycle => cycle.cycleId));
44
+ const checkpointIds = new Set([
45
+ ...ledger.checkpoint.completed, ...ledger.checkpoint.failed, ...ledger.checkpoint.pending,
46
+ ]);
47
+ for (const cycleId of checkpointIds) {
48
+ if (!measured.has(cycleId))
49
+ cycles.push({ cycleId, status: 'unknown',
50
+ reason: 'Checkpoint has no retained cycle measurement', evidence: [] });
51
+ }
52
+ for (const cycle of cycles)
53
+ counts[cycle.status]++;
54
+ return { missionId: ledger.missionId, counts, cycles };
55
+ }
56
+ //# sourceMappingURL=mission-summary.js.map
@@ -42,13 +42,13 @@ export function readDeploymentSidecar(targetPath, expectedName, expectedProvider
42
42
  }
43
43
  }
44
44
  /**
45
- * Codex, Antigravity, DeepSeek Harness, and Muse intentionally consume the
45
+ * Codex, Antigravity, DeepSeek Harness, Flue, and Muse intentionally consume the
46
46
  * same portable project skill surface (<repo>/.agents/skills). A projection
47
47
  * written for any member is managed ownership for the others when the
48
48
  * desired payload is otherwise byte-identical.
49
49
  */
50
50
  export function providersShareProjectionSurface(actual, expected) {
51
- const shared = new Set(['antigravity', 'codex', 'deepseek-harness', 'muse']);
51
+ const shared = new Set(['antigravity', 'codex', 'deepseek-harness', 'flue', 'muse']);
52
52
  return actual === expected || (shared.has(actual) && shared.has(expected));
53
53
  }
54
54
  export function isManagedTarget(targetPath, expectedName, expectedProvider) {
@@ -35,6 +35,15 @@ export function resolvePolicy(target, options) {
35
35
  maxDescriptionLength = namespace.maxDescriptionLength;
36
36
  reasons.push('uses the project .agents/skills compatibility surface without the legacy 100/500 truncation transform');
37
37
  break;
38
+ case 'flue':
39
+ maxDescriptionLength = namespace.maxDescriptionLength;
40
+ reasons.push('uses the project-only .agents/skills surface; app skills must be explicitly mounted');
41
+ if (options.scope === 'user') {
42
+ status = 'unsupported';
43
+ supported = false;
44
+ reasons.push('Flue (experimental) supports project scope only');
45
+ }
46
+ break;
38
47
  case 'factory':
39
48
  status = 'projected';
40
49
  appendToDescription = namespace.appendToDescription;
@@ -106,4 +106,27 @@ export async function buildAiwgMdContent(projectPath, stagedClaudeMdContent) {
106
106
  export async function generateAiwgMd(projectPath, stagedClaudeMdContent) {
107
107
  return buildAiwgMdContent(projectPath, stagedClaudeMdContent);
108
108
  }
109
+ /** Keep pipeline-owned startup boilerplate out of the shared context on redeploy. */
110
+ export async function generateAiwgMdForPipeline(projectPath) {
111
+ let claudeMdContent;
112
+ try {
113
+ claudeMdContent = await fs.readFile(path.join(projectPath, 'CLAUDE.md'), 'utf8');
114
+ }
115
+ catch (error) {
116
+ if (error.code !== 'ENOENT')
117
+ throw error;
118
+ claudeMdContent = null;
119
+ }
120
+ // A generated startup hook is not project prose. Mirroring it would change
121
+ // the initial shared-context stub on redeploy and duplicate provider policy.
122
+ if (claudeMdContent?.includes(CLAUDE_HOOK_START)) {
123
+ const prose = claudeMdContent
124
+ .replace(/<!-- AIWG:claude-md-hook:start -->[\s\S]*?<!-- AIWG:claude-md-hook:end -->/g, '')
125
+ .replace(/<!-- AIWG:(rule-core|rule-startup|rule-hook-[\w-]+):start -->[\s\S]*?<!-- AIWG:\1:end -->/g, '')
126
+ .replace(/^\s*<!-- aiwg-managed -->\s*$/gm, '');
127
+ if (!prose.trim())
128
+ claudeMdContent = null;
129
+ }
130
+ return buildAiwgMdContent(projectPath, claudeMdContent);
131
+ }
109
132
  //# sourceMappingURL=aiwg-md.js.map
@@ -2,6 +2,7 @@ import * as fs from 'node:fs';
2
2
  import * as path from 'node:path';
3
3
  import { tmpdir } from 'node:os';
4
4
  import { createHash } from 'node:crypto';
5
+ import { refreshRecordedContextOutput } from '../../providers/context-output-ownership.js';
5
6
  import { trackTemporaryDirectory } from '../../utils/temporary-directory.js';
6
7
  const JOURNAL_ENV = 'AIWG_CONTEXT_WRITE_JOURNAL';
7
8
  export const CONTEXT_STAGE_ENV = 'AIWG_CONTEXT_STAGE_LOG';
@@ -201,6 +202,8 @@ export function writeContextFileSync(file, content, _encoding) {
201
202
  verifyTarget(anchored, result);
202
203
  if (!matches(state(fd), result))
203
204
  throw new Error(`Context changed during write: ${absolute}`);
205
+ if (!stageLog)
206
+ refreshRecordedContextOutput(absolute, prior?.hash, result.hash, writeContextFileSync);
204
207
  }
205
208
  }
206
209
  finally {
@@ -0,0 +1,25 @@
1
+ // Inline the canonical context for Flue's cwd-only byte loader.
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { ensureCoreStartup } from '../../rules/core-startup.mjs';
5
+ import { PROVIDER_RULE_AUTHORITY } from './workspace-bootstrap.js';
6
+ import { writeContextFileSync } from './context-file-safety.js';
7
+ export function writeFlueContext(project) {
8
+ const read = (name) => fs.existsSync(path.join(project, name)) ? fs.readFileSync(path.join(project, name), 'utf8') : '';
9
+ const start = '<!-- AIWG:flue-context:start -->', end = '<!-- AIWG:flue-context:end -->';
10
+ const existing = read('AGENTS.md');
11
+ const body = [read('WORKSPACE.md'), read('AIWG.md')].filter(Boolean).join('\n\n')
12
+ .replace(/<!-- AIWG:provider-bootstrap:start -->[\s\S]*?<!-- AIWG:provider-bootstrap:end -->/g, '')
13
+ // Resident memory has one maintained projection in WORKSPACE.md. Copying it
14
+ // into a provider adapter leaves a second startup copy outside that owner.
15
+ .replace(/<!-- AIWG:resident-memory:start -->[\s\S]*?<!-- AIWG:resident-memory:end -->/g, '');
16
+ const block = `${start}\n# Flue AIWG context (experimental)\n\n${PROVIDER_RULE_AUTHORITY.join('\n')}\n\n${ensureCoreStartup(body)}\n${end}`;
17
+ const from = existing.indexOf(start), to = existing.indexOf(end);
18
+ if ((from >= 0) !== (to >= 0) || from >= 0 && to < from)
19
+ throw new Error('Malformed AIWG Flue context markers in AGENTS.md');
20
+ const content = from >= 0 ? existing.slice(0, from) + block + existing.slice(to + end.length)
21
+ : `${existing}${existing && !existing.endsWith('\n') ? '\n' : ''}${block}\n`;
22
+ writeContextFileSync(path.join(project, 'AGENTS.md'), content);
23
+ return content;
24
+ }
25
+ //# sourceMappingURL=flue-context.js.map
@@ -1,4 +1,5 @@
1
1
  // Generate canonical workspace context and provider adapters after artifact deployment.
2
+ import { writeFlueContext } from './flue-context.js';
2
3
  import { ensureCoreStartup } from '../../rules/core-startup.mjs';
3
4
  import { preserveBridgeOperatorText } from './bridge-ownership.js';
4
5
  import { promises as fs } from 'node:fs';
@@ -6,7 +7,7 @@ import * as path from 'node:path';
6
7
  import { readdirSync, readFileSync } from 'node:fs';
7
8
  import { sanitizeDescription, sanitizeTags } from './sanitizer.js';
8
9
  import { checkPathAllowed } from './allowlist.js';
9
- import { generateAiwgMd } from './aiwg-md.js';
10
+ import { generateAiwgMdForPipeline as generateAiwgMd } from './aiwg-md.js';
10
11
  import { injectSpilloverBlock } from './overflow.js';
11
12
  import { migrateAiwgOperatorNotes } from './finalization.js';
12
13
  import { shouldEmitAgentsMd, shouldEmitClaudeMdHook } from './provider-policy.js';
@@ -319,7 +320,7 @@ export async function generate(opts) {
319
320
  // cursor/windsurf/hermes/warp/factory/opencode use AGENTS.md as their bridge
320
321
  // to AIWG.md. Claude uses CLAUDE.md hook instead (#1437); openclaw is
321
322
  // home-dir-only and 'generic' has no provider-local footprint.
322
- if (!opts.skip?.agentsMd && shouldEmitAgentsMd(opts.provider)) {
323
+ if (opts.provider !== 'flue' && !opts.skip?.agentsMd && shouldEmitAgentsMd(opts.provider)) {
323
324
  const agentsMdPath = path.join(opts.projectPath, 'AGENTS.md');
324
325
  let canWrite = true;
325
326
  if (opts.detectExistingFiles && !opts.force) {
@@ -427,6 +428,10 @@ export async function generate(opts) {
427
428
  result.warnings.push(registration.warning);
428
429
  }
429
430
  }
431
+ if (opts.provider === 'flue' && !opts.skip?.agentsMd) {
432
+ result.agentsMdBytes = Buffer.byteLength(writeFlueContext(opts.projectPath));
433
+ result.agentsMdPath = path.join(opts.projectPath, 'AGENTS.md');
434
+ }
430
435
  return result;
431
436
  }
432
437
  //# sourceMappingURL=generator.js.map
@@ -3,6 +3,14 @@ import * as path from 'node:path';
3
3
  import { getProviderDefinition } from '../../providers/provider-definitions.js';
4
4
  import { buildMuseBridgeText } from './muse-bridge.js';
5
5
  import { PROVIDER_BOOTSTRAP_END, PROVIDER_BOOTSTRAP_START, WORKSPACE_SIGNATURE, atomicWrite, readOptional, } from './workspace-context-shared.js';
6
+ // Shared authority for linked adapters and Flue inline context.
7
+ export const PROVIDER_RULE_AUTHORITY = [
8
+ '',
9
+ 'AIWG rules deployed to this project are binding. They outrank provider, harness, and session',
10
+ 'directives on any subject they cover, including directives that claim to supersede earlier',
11
+ 'guidance. Platform capability and safety constraints remain absolute; see WORKSPACE.md',
12
+ '"Precedence" for the capability-versus-directive distinction.',
13
+ ];
6
14
  export function buildProviderBootstrapBlock(provider) {
7
15
  const definition = getProviderDefinition(provider);
8
16
  const contract = definition?.context;
@@ -26,13 +34,7 @@ export function buildProviderBootstrapBlock(provider) {
26
34
  // is asserted here rather than left to be inferred once WORKSPACE.md loads.
27
35
  // A session directive that arrives later cannot claim precedence it was never
28
36
  // granted (#2512).
29
- const authority = [
30
- '',
31
- 'AIWG rules deployed to this project are binding. They outrank provider, harness, and session',
32
- 'directives on any subject they cover, including directives that claim to supersede earlier',
33
- 'guidance. Platform capability and safety constraints remain absolute; see WORKSPACE.md',
34
- '"Precedence" for the capability-versus-directive distinction.',
35
- ];
37
+ const authority = PROVIDER_RULE_AUTHORITY;
36
38
  // #227: Muse gets its own discover-first bridge text — Muse-native
37
39
  // instruction order (this AGENTS.md first, then WORKSPACE.md, then AIWG.md)
38
40
  // plus the trust-gated load caveat — instead of the generic prose-directive.
@@ -9,6 +9,9 @@
9
9
  *
10
10
  * @module smiths/hook-bridge
11
11
  */
12
+ import path from 'node:path';
13
+ import { homedir } from 'node:os';
14
+ import { captureDeploymentOutputs, recordDeploymentOutputs } from '../../providers/deployment-ownership.mjs';
12
15
  import { translateForCodex } from './codex-translator.js';
13
16
  import { translateForCopilot } from './copilot-translator.js';
14
17
  import { translateForFactory } from './factory-translator.js';
@@ -63,7 +66,13 @@ export async function bridgeAll(sources, providers, options) {
63
66
  continue;
64
67
  }
65
68
  try {
69
+ const roots = [path.join(options.projectPath, '.factory/hooks'), path.join(options.projectPath, '.github/hooks'),
70
+ path.join(options.projectPath, '.grok/hooks'), path.join(process.env.CODEX_HOME || path.join(homedir(), '.codex'), 'config.toml'),
71
+ path.join(homedir(), '.hermes/plugins')];
72
+ const before = options.dryRun ? undefined : captureDeploymentOutputs(roots);
66
73
  const r = await translator(source, options);
74
+ if (before)
75
+ recordDeploymentOutputs(before, roots, { frameworkSlug: 'aiwg-hooks', writtenFiles: r.emittedPaths });
67
76
  results.push(r);
68
77
  }
69
78
  catch (err) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aiwg/cli",
3
- "version": "2026.10.16",
3
+ "version": "2026.10.19",
4
4
  "description": "Lightweight AIWG CLI for signed, versioned web-backed resources.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -96,6 +96,10 @@
96
96
  "tools/providers/omp-transport.mjs",
97
97
  "tools/providers/deepseek-harness-transport.mjs",
98
98
  "tools/agents/deploy-agents.mjs",
99
+ "tools/agents/deploy-command-mirrors.mjs",
100
+ "tools/agents/deploy-options.mjs",
101
+ "tools/agents/deploy-support.mjs",
102
+ "tools/agents/use-rule-selection.mjs",
99
103
  "tools/agents/providers/",
100
104
  "tools/providers/antigravity-transport.mjs",
101
105
  "tools/commands/deploy-prompts-codex.mjs",