@aiwg/cli 2026.10.15 → 2026.10.16

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 (180) hide show
  1. package/agentic/code/providers/pi/aiwg-bridge.ts +45 -7
  2. package/dist/src/artifacts/citation-parser.js +7 -6
  3. package/dist/src/artifacts/corpus-tools/citation-densify.js +4 -2
  4. package/dist/src/artifacts/corpus-tools/cli.js +8 -3
  5. package/dist/src/artifacts/corpus-tools/discovery-log.js +26 -24
  6. package/dist/src/artifacts/corpus-tools/expand-cli.js +3 -2
  7. package/dist/src/artifacts/corpus-tools/expand-dates.js +107 -0
  8. package/dist/src/artifacts/corpus-tools/expand-queue.js +4 -1
  9. package/dist/src/artifacts/corpus-tools/expand-review.js +104 -0
  10. package/dist/src/artifacts/corpus-tools/expand-state.js +17 -1
  11. package/dist/src/artifacts/corpus-tools/expand.js +16 -17
  12. package/dist/src/artifacts/corpus-tools/induction-audit.js +7 -6
  13. package/dist/src/artifacts/corpus-tools/integrity-scan.js +3 -3
  14. package/dist/src/artifacts/corpus-tools/radar-shared.js +7 -9
  15. package/dist/src/artifacts/corpus-tools/ref-files.js +11 -0
  16. package/dist/src/artifacts/corpus-tools/resolve-cli.js +11 -3
  17. package/dist/src/artifacts/corpus-tools/resolve.js +23 -9
  18. package/dist/src/artifacts/corpus-tools/retrieval-lab.js +2 -1
  19. package/dist/src/artifacts/corpus-tools/sidecar-lint.js +4 -4
  20. package/dist/src/artifacts/corpus-tools/sidecar-repair.js +2 -1
  21. package/dist/src/artifacts/corpus-views/ref-parser.js +3 -17
  22. package/dist/src/artifacts/graph-query.js +5 -3
  23. package/dist/src/artifacts/hybrid-query.js +11 -2
  24. package/dist/src/artifacts/index-refresh.js +2 -0
  25. package/dist/src/cli/handlers/daemon.js +17 -1
  26. package/dist/src/cli/handlers/doctor-args.js +10 -5
  27. package/dist/src/cli/handlers/doctor-help.js +4 -1
  28. package/dist/src/cli/handlers/index.js +2 -2
  29. package/dist/src/cli/handlers/models-resource-sample.js +10 -0
  30. package/dist/src/cli/handlers/models.js +3 -2
  31. package/dist/src/cli/handlers/regenerate.js +8 -16
  32. package/dist/src/cli/handlers/sessions.js +7 -7
  33. package/dist/src/cli/handlers/subcommands.js +8 -0
  34. package/dist/src/cli/handlers/update.js +157 -0
  35. package/dist/src/cli/handlers/use.js +14 -4
  36. package/dist/src/cli/handlers/utilities.js +3 -560
  37. package/dist/src/cli/handlers/utility-doctor.js +412 -0
  38. package/dist/src/cli/services/deployment-verification.js +0 -1
  39. package/dist/src/config/aiwg-config.js +2 -1
  40. package/dist/src/config/authorization-cli.js +7 -3
  41. package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
  42. package/dist/src/config/dispatch-thresholds-runtime.mjs +17 -7
  43. package/dist/src/config/framework-aliases.js +12 -0
  44. package/dist/src/config/host-resource-report.d.mts +19 -0
  45. package/dist/src/config/host-resource-report.mjs +80 -0
  46. package/dist/src/config/host-resource-runtime.d.mts +34 -0
  47. package/dist/src/config/host-resource-runtime.mjs +293 -0
  48. package/dist/src/config/installed-selection.js +22 -0
  49. package/dist/src/config/worker-invocation-marker.d.mts +1 -0
  50. package/dist/src/config/worker-invocation-marker.mjs +2 -0
  51. package/dist/src/decision/heldout/access.js +74 -0
  52. package/dist/src/decision/heldout/calibration.js +1 -0
  53. package/dist/src/decision/heldout/collector.js +8 -1
  54. package/dist/src/effects/verifiers/file.js +22 -5
  55. package/dist/src/extensions/claude-attribution.js +82 -0
  56. package/dist/src/extensions/claude-hooks-installer.js +115 -69
  57. package/dist/src/extensions/commands/daemon.js +109 -0
  58. package/dist/src/extensions/commands/definitions.js +5 -89
  59. package/dist/src/gates/heldout.js +17 -7
  60. package/dist/src/lint/check-patterns.js +163 -0
  61. package/dist/src/lint/checks.js +268 -0
  62. package/dist/src/lint/reference-resolution.js +54 -0
  63. package/dist/src/lint/runner.js +3 -465
  64. package/dist/src/mcp/helpers.mjs +11 -1
  65. package/dist/src/memory/project-registry.js +44 -4
  66. package/dist/src/models/worker-plan.js +36 -5
  67. package/dist/src/models/wrapper-deployment.js +25 -12
  68. package/dist/src/models/wrapper-enforcement.js +47 -7
  69. package/dist/src/network-analysis/research.js +2 -1
  70. package/dist/src/policy/hitl-check.js +14 -4
  71. package/dist/src/policy/hitl-consume.js +54 -0
  72. package/dist/src/policy/hitl-receipt.js +2 -0
  73. package/dist/src/policy/hitl.js +11 -3
  74. package/dist/src/providers/provider-context-contracts.js +162 -0
  75. package/dist/src/providers/provider-definition-schema.js +136 -0
  76. package/dist/src/providers/provider-definitions.js +8 -1298
  77. package/dist/src/providers/provider-seeds-1.js +360 -0
  78. package/dist/src/providers/provider-seeds-2.js +387 -0
  79. package/dist/src/providers/provider-seeds-3.js +262 -0
  80. package/dist/src/research/clients/arxiv.js +4 -30
  81. package/dist/src/research/clients/base.js +48 -22
  82. package/dist/src/research/identity.js +34 -2
  83. package/dist/src/research/query-cli.js +3 -87
  84. package/dist/src/research/query-options.js +87 -0
  85. package/dist/src/research/reference-match.js +70 -24
  86. package/dist/src/research/services/acquisition.js +9 -7
  87. package/dist/src/research/services/citation.js +5 -2
  88. package/dist/src/research/types.js +2 -0
  89. package/dist/src/serve/mission-conductor.js +48 -4
  90. package/dist/src/sessions/adapters/grok-build-native.js +23 -0
  91. package/dist/src/sessions/adapters/grok-build.js +14 -7
  92. package/dist/src/sessions/workspace-discovery.js +5 -5
  93. package/dist/src/smiths/context-pipeline/aiwg-md.js +16 -46
  94. package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
  95. package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
  96. package/dist/src/smiths/context-pipeline/finalization.js +81 -51
  97. package/dist/src/smiths/context-pipeline/generator.js +9 -10
  98. package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
  99. package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
  100. package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
  101. package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
  102. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
  103. package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
  104. package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
  105. package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
  106. package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
  107. package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
  108. package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
  109. package/package.json +10 -1
  110. package/schemas/decision/D29Study.v10.schema.json +65 -0
  111. package/tools/agents/deploy-agents.mjs +10 -0
  112. package/tools/agents/providers/claude-post-deploy.mjs +12 -1
  113. package/tools/agents/providers/context-write.mjs +4 -0
  114. package/tools/agents/providers/pi.mjs +3 -1
  115. package/tools/agents/providers/rule-delivery-surface.mjs +332 -0
  116. package/tools/agents/providers/rule-delivery.mjs +20 -1144
  117. package/tools/agents/providers/rule-deployment-commit.mjs +144 -0
  118. package/tools/agents/providers/rule-deployment-prepare.mjs +452 -0
  119. package/tools/agents/providers/rule-deployment-state.mjs +300 -0
  120. package/tools/daemon/README.md +511 -0
  121. package/tools/daemon/adapters/base-adapter.mjs +84 -0
  122. package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
  123. package/tools/daemon/agent-supervisor.mjs +299 -0
  124. package/tools/daemon/automation-engine.mjs +310 -0
  125. package/tools/daemon/autonomous-engine.mjs +346 -0
  126. package/tools/daemon/behavior-loader.mjs +316 -0
  127. package/tools/daemon/behavior.mjs +174 -0
  128. package/tools/daemon/concierge/intent-router.mjs +401 -0
  129. package/tools/daemon/concierge/orchestrator.mjs +272 -0
  130. package/tools/daemon/concierge/response-translator.mjs +462 -0
  131. package/tools/daemon/config.mjs +377 -0
  132. package/tools/daemon/cron-scheduler.mjs +178 -0
  133. package/tools/daemon/daemon-main.mjs +1169 -0
  134. package/tools/daemon/event-router.mjs +84 -0
  135. package/tools/daemon/file-watcher.mjs +383 -0
  136. package/tools/daemon/index.mjs +1181 -0
  137. package/tools/daemon/init-profile.mjs +124 -0
  138. package/tools/daemon/ipc-client.mjs +197 -0
  139. package/tools/daemon/ipc-ops-handlers.mjs +236 -0
  140. package/tools/daemon/ipc-server.mjs +275 -0
  141. package/tools/daemon/maintenance-owner.mjs +79 -0
  142. package/tools/daemon/memory-manager.mjs +386 -0
  143. package/tools/daemon/message-router.mjs +194 -0
  144. package/tools/daemon/provider-watcher.mjs +585 -0
  145. package/tools/daemon/pty-adapter.mjs +420 -0
  146. package/tools/daemon/repl-chat.mjs +359 -0
  147. package/tools/daemon/resource-bounds.mjs +88 -0
  148. package/tools/daemon/sandbox-transport.mjs +295 -0
  149. package/tools/daemon/scheduled-task-runner.mjs +535 -0
  150. package/tools/daemon/task-store.mjs +450 -0
  151. package/tools/daemon/tmux-manager.mjs +324 -0
  152. package/tools/daemon/update-policy.mjs +517 -0
  153. package/tools/daemon/web-server.mjs +399 -0
  154. package/tools/daemon/web-ui/index.html +585 -0
  155. package/tools/daemon/web-ui/styles.css +156 -0
  156. package/tools/docker/Dockerfile.daemon +35 -0
  157. package/tools/docker/container-manager.mjs +291 -0
  158. package/tools/messaging/adapter-registry.mjs +230 -0
  159. package/tools/messaging/adapters/base.mjs +326 -0
  160. package/tools/messaging/adapters/discord.mjs +462 -0
  161. package/tools/messaging/adapters/slack.mjs +402 -0
  162. package/tools/messaging/adapters/telegram.mjs +552 -0
  163. package/tools/messaging/chat-handler.mjs +297 -0
  164. package/tools/messaging/command-router.mjs +269 -0
  165. package/tools/messaging/event-bus.mjs +199 -0
  166. package/tools/messaging/index.mjs +456 -0
  167. package/tools/messaging/message-formatter.mjs +320 -0
  168. package/tools/messaging/room-manager.mjs +277 -0
  169. package/tools/messaging/types.mjs +94 -0
  170. package/tools/providers/pi-bridge-policy.mjs +4 -0
  171. package/tools/ralph-external/daemon-supervisor.mjs +394 -0
  172. package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
  173. package/tools/ralph-external/lib/worker-invocation-processes.mjs +3 -2
  174. package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
  175. package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
  176. package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
  177. package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
  178. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
  179. package/tools/ralph-external/session-launcher.mjs +7 -7
  180. package/tools/scripts/resource-preflight.mjs +3 -242
@@ -0,0 +1,10 @@
1
+ // Sample the project and actual CLI request filesystems before rendering a worker.
2
+ import path from 'node:path';
3
+ import { readLiveHostResources } from '../../config/host-resource-runtime.mjs';
4
+ import { parseWorkerCommandArgs } from '../../serve/worker-command-request.js';
5
+ export function sampleWorkerHostResources(ctx, readers) {
6
+ const request = ctx.args[0] === 'resolve' ? parseWorkerCommandArgs(ctx.args.slice(1)) : undefined;
7
+ const paths = request ? [ctx.cwd, request.workdir, path.dirname(request.final_output)] : [ctx.cwd];
8
+ return readLiveHostResources({ ...readers, paths });
9
+ }
10
+ //# sourceMappingURL=models-resource-sample.js.map
@@ -2,6 +2,7 @@ import { MODELS_HELP } from './models-help.js';
2
2
  import { updateJson } from '../../models/config-writer.js';
3
3
  import { atomicConfigWrite as atomicWrite } from '../../config/worker-write.js';
4
4
  import { handleWorkerAdoptionArgs } from '../../config/worker-adoption-cli.js';
5
+ import { sampleWorkerHostResources } from './models-resource-sample.js';
5
6
  import { resolveParallelism } from '../../config/aiwg-config.js';
6
7
  /**
7
8
  * Safe model-policy audit, resolution, and mutation commands.
@@ -33,7 +34,7 @@ function approvalFacts(row) {
33
34
  * without shelling out to the CLI. No new loader is introduced; this is the
34
35
  * CLI's own existing default `ModelsWorkerServices.load`.
35
36
  */
36
- export async function loadWorkerInputs(ctx) {
37
+ export async function loadWorkerInputs(ctx, resourceReaders) {
37
38
  const config = await readAiwgConfig(ctx.cwd) ?? emptyConfig();
38
39
  const loader = new ConfigLoader(ctx.cwd);
39
40
  const models = await loader.load(config.parallelism);
@@ -116,7 +117,7 @@ export async function loadWorkerInputs(ctx) {
116
117
  }) };
117
118
  }
118
119
  return { snapshot: { config, models, modelDigests: loader.getInputDigests(), catalog,
119
- registry: qualifiedRegistry, installations }, drivers };
120
+ registry: qualifiedRegistry, installations, hostResources: sampleWorkerHostResources(ctx, { ...resourceReaders, groupNames: Object.keys(config.parallelism?.groups ?? {}) }) }, drivers };
120
121
  }
121
122
  async function resolveDirect(ctx, services) {
122
123
  let shell = false;
@@ -19,13 +19,11 @@
19
19
  * @issue #1266
20
20
  */
21
21
  import * as path from 'path';
22
- import { promises as fs } from 'node:fs';
23
22
  import { AiwgError, EXIT_CODES, handlerResultFromError } from '../errors.js';
24
23
  import * as ui from '../ui.js';
25
- import { generate as generateContextFiles, discoverDeployedArtifacts, shouldEmitContextFiles, buildNormalizedAiwgMd, writeNormalizedAiwgMd, injectLegacyContext, migrateWorkspaceContext, extractExistingProjectContext, } from '../../smiths/context-pipeline/index.js';
24
+ import { generate as generateContextFiles, discoverDeployedArtifacts, shouldEmitContextFiles, generateAiwgMd, writeNormalizedAiwgMd, injectLegacyContext, migrateWorkspaceContext, extractExistingProjectContext, } from '../../smiths/context-pipeline/index.js';
26
25
  import { resolveActiveProvider } from '../provider-resolution.js';
27
26
  import { getProviderContextDiscoveryPathStrings } from '../../providers/provider-definitions.js';
28
- import { projectControlPath } from '../../config/project-artifacts.js';
29
27
  import { selectRegenerateBranch } from '../regenerate-selector.js';
30
28
  async function handleRegenerate(args, cwd) {
31
29
  if (args.includes('--help') || args.includes('-h')) {
@@ -212,16 +210,10 @@ async function handleRegenerate(args, cwd) {
212
210
  if (legacy) {
213
211
  if (skipWorkspaceMd)
214
212
  console.log(' Note: --no-workspace-md is implicit in legacy mode.');
215
- const normalizedPath = projectControlPath(target, 'AIWG.md');
216
- let existing = '';
217
- try {
218
- existing = await fs.readFile(normalizedPath, 'utf8');
219
- }
220
- catch (error) {
221
- if (error.code !== 'ENOENT')
222
- throw error;
223
- }
224
- const normalizedContent = await buildNormalizedAiwgMd(target, existing);
213
+ const normalizedPath = path.join(target, 'AIWG.md');
214
+ // Legacy startup files contain our previous output. Render independently
215
+ // of CLAUDE.md so neither the inline payload nor root context feeds it back.
216
+ const normalizedContent = await generateAiwgMd(target, null);
225
217
  const result = skipAgentsMd
226
218
  ? { targets: [], backups: [], changed: [], dryRun, warnings: [] }
227
219
  : await injectLegacyContext(provider, target, normalizedContent, { dryRun });
@@ -229,7 +221,7 @@ async function handleRegenerate(args, cwd) {
229
221
  console.log('');
230
222
  console.log(' Would regenerate:');
231
223
  if (!skipAiwgMd)
232
- console.log(` - ${normalizedPath} (normalized framework source)`);
224
+ console.log(` - ${normalizedPath} (generated framework context)`);
233
225
  for (const changed of result.changed)
234
226
  console.log(` - ${changed} (legacy inline markers)`);
235
227
  for (const warning of result.warnings)
@@ -239,7 +231,7 @@ async function handleRegenerate(args, cwd) {
239
231
  return;
240
232
  }
241
233
  if (!skipAiwgMd)
242
- await writeNormalizedAiwgMd(target);
234
+ await writeNormalizedAiwgMd(target, null);
243
235
  for (const changed of result.changed)
244
236
  console.log(` OK Injected AIWG context into ${path.relative(target, changed)}`);
245
237
  for (const backup of result.backups)
@@ -260,7 +252,7 @@ async function handleRegenerate(args, cwd) {
260
252
  console.log(` Would regenerate:`);
261
253
  if (!skipWorkspaceMd)
262
254
  console.log(` - ${path.join(target, 'WORKSPACE.md')} (managed graph; operator section preserved)`);
263
- console.log(` - ${projectControlPath(target, 'AIWG.md')}`);
255
+ console.log(' - optional .aiwg/AIWG.md operator notes (migrate legacy generated sections only)');
264
256
  if (!skipAiwgMd)
265
257
  console.log(` - ${aiwgMd}`);
266
258
  if (provider === 'claude') {
@@ -3,7 +3,7 @@ import { randomUUID } from 'node:crypto';
3
3
  import { basename, dirname, isAbsolute, join, resolve, } from 'node:path';
4
4
  import { pathToFileURL } from 'node:url';
5
5
  import { providerScopeWarnings } from '../../sessions/coverage-preflight.js';
6
- import { CLAUDE_ADAPTER_VERSION, ClaudeSessionAdapter, CODEX_ADAPTER_VERSION, CodexSessionAdapter, COPILOT_ADAPTER_VERSION, CopilotSessionAdapter, CURSOR_ADAPTER_VERSION, CursorSessionAdapter, FACTORY_ADAPTER_VERSION, FactorySessionAdapter, HERMES_ADAPTER_VERSION, HermesSessionAdapter, OPENCODE_ADAPTER_VERSION, OpenCodeSessionAdapter, OPENCLAW_ADAPTER_VERSION, OpenClawSessionAdapter, OPENHUMAN_ADAPTER_VERSION, OpenHumanSessionAdapter, GROKBOT_ADAPTER_VERSION, GROKBOT_NATIVE_REPLICA_LOCATOR_CLASS, GrokbotSessionAdapter, GROK_BUILD_ADAPTER_VERSION, GROK_BUILD_CLI_EXPORT_LOCATOR_CLASS, GROK_BUILD_NATIVE_LOCATOR_CLASS, GrokBuildSessionAdapter, grokBuildList, grokBuildSearch, grokBuildExport, grokHeadlessSessionIdFromFile, MUSE_ADAPTER_VERSION, MuseSessionAdapter, PI_ADAPTER_VERSION, PiSessionAdapter, DEEPSEEK_HARNESS_ADAPTER_VERSION, DeepSeekHarnessSessionAdapter, OmpSessionAdapter, OMP_ADAPTER_VERSION, WARP_ADAPTER_VERSION, WarpSessionAdapter, DEVIN_DESKTOP_ADAPTER_VERSION, DevinDesktopSessionAdapter, CandidateExtractionService, GENERIC_ADAPTER_VERSION, GenericSessionInterchangeAdapter, IncrementalSessionImporter, ImportLeaseContentionError, FilesystemMemoryDestination, FilesystemPromotionDispositionCoordinator, MemoryPromotionGateway, SESSION_CONTRACT_VERSION, SessionContractError, SessionRepository, SessionSourceSchema, StructuralCandidateExtractor, resolveMemoryConsumerManifest, assertSessionProviderId, acquireImportLease, countUniqueSessionsAcrossCatalogs, defaultDiscoveryManifestPath, defaultHostCatalogPath, HOST_CATALOG_WORKSPACE_ID, indexIdentitiesBySessionId, manifestNeedsHostCatalog, mergeCrossCatalogRows, mergeSessionLists, resolveHostReferences, summarizeSessionAnalyticsFacts, discoverWorkspaceHistories, createSessionAdapterRegistry, providerDiscoveryCapability, coveragePreflight, expectedSessionProviders, deriveSessionTimeline, importDiscoveryManifest, previewDiscoveryImport, publicDiscoveryManifest, readDiscoveryManifest, redactSourceLocator, sha256, parseTimelineGap, writeDiscoveryManifest, buildSessionExportPlan, reverifySessionExportPlan, buildSessionAiwgFortemiIndexExport, recoverAiwgFortemiIndexFromFullV1Shard, embedAttachmentsInFullV1Shard, recoverEmbeddedAttachments, SESSION_EXPORT_PLAN_SCHEMA_VERSION, } from '../../sessions/index.js';
6
+ import { CLAUDE_ADAPTER_VERSION, ClaudeSessionAdapter, CODEX_ADAPTER_VERSION, CodexSessionAdapter, COPILOT_ADAPTER_VERSION, CopilotSessionAdapter, CURSOR_ADAPTER_VERSION, CursorSessionAdapter, FACTORY_ADAPTER_VERSION, FactorySessionAdapter, HERMES_ADAPTER_VERSION, HermesSessionAdapter, OPENCODE_ADAPTER_VERSION, OpenCodeSessionAdapter, OPENCLAW_ADAPTER_VERSION, OpenClawSessionAdapter, OPENHUMAN_ADAPTER_VERSION, OpenHumanSessionAdapter, GROKBOT_ADAPTER_VERSION, GROKBOT_NATIVE_REPLICA_LOCATOR_CLASS, GrokbotSessionAdapter, GROK_BUILD_ADAPTER_VERSION, GROK_BUILD_CLI_EXPORT_LOCATOR_CLASS, GROK_BUILD_NATIVE_LOCATOR_CLASS, GrokBuildSessionAdapter, grokBuildNativeAvailability, grokBuildList, grokBuildSearch, grokBuildExport, grokHeadlessSessionIdFromFile, MUSE_ADAPTER_VERSION, MuseSessionAdapter, PI_ADAPTER_VERSION, PiSessionAdapter, DEEPSEEK_HARNESS_ADAPTER_VERSION, DeepSeekHarnessSessionAdapter, OmpSessionAdapter, OMP_ADAPTER_VERSION, WARP_ADAPTER_VERSION, WarpSessionAdapter, DEVIN_DESKTOP_ADAPTER_VERSION, DevinDesktopSessionAdapter, CandidateExtractionService, GENERIC_ADAPTER_VERSION, GenericSessionInterchangeAdapter, IncrementalSessionImporter, ImportLeaseContentionError, FilesystemMemoryDestination, FilesystemPromotionDispositionCoordinator, MemoryPromotionGateway, SESSION_CONTRACT_VERSION, SessionContractError, SessionRepository, SessionSourceSchema, StructuralCandidateExtractor, resolveMemoryConsumerManifest, assertSessionProviderId, acquireImportLease, countUniqueSessionsAcrossCatalogs, defaultDiscoveryManifestPath, defaultHostCatalogPath, HOST_CATALOG_WORKSPACE_ID, indexIdentitiesBySessionId, manifestNeedsHostCatalog, mergeCrossCatalogRows, mergeSessionLists, resolveHostReferences, summarizeSessionAnalyticsFacts, discoverWorkspaceHistories, createSessionAdapterRegistry, providerDiscoveryCapability, coveragePreflight, expectedSessionProviders, deriveSessionTimeline, importDiscoveryManifest, previewDiscoveryImport, publicDiscoveryManifest, readDiscoveryManifest, redactSourceLocator, sha256, parseTimelineGap, writeDiscoveryManifest, buildSessionExportPlan, reverifySessionExportPlan, buildSessionAiwgFortemiIndexExport, recoverAiwgFortemiIndexFromFullV1Shard, embedAttachmentsInFullV1Shard, recoverEmbeddedAttachments, SESSION_EXPORT_PLAN_SCHEMA_VERSION, } from '../../sessions/index.js';
7
7
  import { resolveImportExclusions } from '../../sessions/import-exclusions.js';
8
8
  import { resolveImportLimits } from '../../sessions/import-limits.js';
9
9
  import { classifyGrokbotBlobName } from '../../sessions/adapters/grokbot-locator.js';
@@ -87,8 +87,8 @@ Options:
87
87
  --muse-root <path> Explicitly authorize a Muse Code sessions root
88
88
  --dsh-root <path> Explicitly authorize a DeepSeek Harness sessions root
89
89
  --grokbot-root <path> Explicitly authorize a Grok Bot sand-client-persistence root
90
- --grok-root <path> Explicitly authorize a Grok Build sessions root (native chat_history.jsonl discovery)
91
- --grok-active-sessions <path> Explicitly authorize active_sessions.json for Grok Build live detection (read-only; requires --grok-root)
90
+ --grok-root <path> Authorize experimental Grok Build native sessions (requires AIWG_GROK_BUILD_NATIVE_EXPERIMENTAL=1; unqualified)
91
+ --grok-active-sessions <path> Authorize experimental active_sessions.json live detection (same opt-in; requires --grok-root)
92
92
  --hermes-root <path> Explicitly authorize a Hermes home for a read-only state.db backup snapshot
93
93
  --grok-bin <path> Absolute Grok Build CLI path for grok-list/grok-search/grok-export
94
94
  (default: grok on PATH, then $GROK_HOME/bin/grok)
@@ -1714,12 +1714,12 @@ function providerDisposition(provider) {
1714
1714
  };
1715
1715
  }
1716
1716
  if (provider === 'grok-build') {
1717
+ const adapter = new GrokBuildSessionAdapter();
1717
1718
  return {
1718
1719
  provider, disposition: 'implemented', operationalState: 'available',
1719
- supportedOperations: ['discover', 'inspect', 'stream'],
1720
- acquisitionModes: ['manual-export', 'jsonl'],
1721
- reasonCode: null,
1722
- remediation: 'Pass --grok-root with an explicitly authorized sessions root for native chat_history.jsonl discovery, optionally with --grok-active-sessions for live detection; or run `grok export <session-id> <session-id>.md` and import the explicitly authorized Markdown file.',
1720
+ supportedOperations: adapter.supportedOperations,
1721
+ acquisitionModes: adapter.acquisitionModes,
1722
+ ...grokBuildNativeAvailability(),
1723
1723
  evidence: {
1724
1724
  adapterVersion: GROK_BUILD_ADAPTER_VERSION,
1725
1725
  verifiedAt: '2026-09-21',
@@ -26,6 +26,8 @@ import { releaseSkillOwnership } from "../../providers/skill-ownership.mjs";
26
26
  import { formatDeployedWorkspaceSignalPlan, readWorkspaceSignalPlan } from "../workspace-signals.js";
27
27
  import * as path from "node:path";
28
28
  import * as fsSync from "node:fs";
29
+ import { removeClaudeAttribution } from "../../extensions/claude-hooks-installer.js";
30
+ import * as os from "node:os";
29
31
  import { pathToFileURL } from "node:url";
30
32
  /** Generate or deploy the canonical project quickref. */
31
33
  export const quickrefHandler = {
@@ -688,6 +690,8 @@ async function removeUserScopeDeploy(args) {
688
690
  else {
689
691
  await removeUserDeploy({ framework: positional });
690
692
  }
693
+ if (providersToRevert.includes('claude') && !Object.values((await readUserRegistry()).installed).some(item => item.deployedTo.claude))
694
+ await removeClaudeAttribution(os.homedir());
691
695
  linesOut.push('');
692
696
  if (conservativeFallbackUsed) {
693
697
  linesOut.push('Registry updated. Some providers had no per-artifact manifest (pre-Cycle-3 deploys); inspect the dirs listed above and clean up manually if needed.');
@@ -890,6 +894,8 @@ export const removeHandler = {
890
894
  if (Object.keys(entry.deployedTo).length === 0)
891
895
  delete config.installed[positionalArg];
892
896
  await writeAiwgConfig(projectDir, config);
897
+ if (providers.includes('claude') && !Object.values(config.installed).some(item => item.deployedTo.claude))
898
+ await removeClaudeAttribution(projectDir);
893
899
  }
894
900
  if (dryRun) {
895
901
  lines.push(ctx.args.includes('--keep-registry')
@@ -923,6 +929,8 @@ export const removeHandler = {
923
929
  console.log(lines.join('\n'));
924
930
  if (!dryRun) {
925
931
  await writeAiwgConfig(projectDir, config);
932
+ if (result.revertedProviders.includes('claude') && !Object.values(config.installed).some(item => item.deployedTo.claude))
933
+ await removeClaudeAttribution(projectDir);
926
934
  }
927
935
  // Note: source under .aiwg/<type>/<name>/ is intentionally NOT
928
936
  // deleted (load-bearing invariant from #1048 design).
@@ -0,0 +1,157 @@
1
+ // Update planning and redeployment of the existing project selection.
2
+ import fs from 'fs';
3
+ import { updateInstallation } from '../../update/service.mjs';
4
+ import { useHandler as useFrameworkHandler } from './use.js';
5
+ import { projectAiwgPath } from '../../config/project-artifacts.js';
6
+ import { getConfigPath } from '../../config/aiwg-config.js';
7
+ import { withInstalledSelection } from '../../config/installed-selection.js';
8
+ import { REGISTRY_ID_TO_USE_NAME } from '../../config/framework-aliases.js';
9
+ /**
10
+ * Read the installed frameworks from the on-disk registry.
11
+ */
12
+ function readFrameworkRegistry(cwd) {
13
+ const registryPath = projectAiwgPath(cwd, 'frameworks', 'registry.json');
14
+ if (!fs.existsSync(registryPath)) {
15
+ return null;
16
+ }
17
+ try {
18
+ return JSON.parse(fs.readFileSync(registryPath, 'utf8'));
19
+ }
20
+ catch {
21
+ return null;
22
+ }
23
+ }
24
+ /**
25
+ * Handler for update command
26
+ *
27
+ * Updates AIWG and re-deploys installed frameworks/addons.
28
+ * - Checks for npm/git updates first
29
+ * - Uses aiwg.config installed; reports legacy fallback for old projects
30
+ * - Re-deploys only those (preserving the user's current selection)
31
+ * - Use --all to deploy and record everything (equivalent to `aiwg use all`)
32
+ *
33
+ * Usage:
34
+ * aiwg update # Update + re-deploy installed frameworks
35
+ * aiwg update --all # Update + deploy everything
36
+ * aiwg update --dry-run # Show what would be updated
37
+ * aiwg update --provider <name> # Pass through provider to deployment
38
+ * aiwg update --skip-check # Skip npm/git update check, only re-deploy
39
+ *
40
+ * @issue #342
41
+ */
42
+ export const updateHandler = {
43
+ id: 'update',
44
+ name: 'Update',
45
+ description: 'Update AIWG and re-deploy installed frameworks',
46
+ category: 'maintenance',
47
+ aliases: ['-update', '--update', 'upgrade'],
48
+ async execute(ctx) {
49
+ const args = ctx.args;
50
+ const deployAll = args.includes('--all');
51
+ const dryRun = args.includes('--dry-run');
52
+ const skipCheck = args.includes('--skip-check');
53
+ // Extract --provider value if present
54
+ const providerIdx = args.findIndex(a => a === '--provider' || a === '--platform');
55
+ const providerArgs = providerIdx >= 0 && args[providerIdx + 1]
56
+ ? ['--provider', args[providerIdx + 1]]
57
+ : [];
58
+ // Step 1: Check for package updates (unless --skip-check)
59
+ if (!skipCheck) {
60
+ try {
61
+ console.log('Updating AIWG installation...\n');
62
+ const update = await updateInstallation({
63
+ dryRun,
64
+ offline: args.includes('--offline'),
65
+ });
66
+ console.log(`${update.message}\n`);
67
+ }
68
+ catch (error) {
69
+ if (error.code === 'AIWG_INSTALLATION_DRIFT'
70
+ || error.code === 'AIWG_INSTALLATION_INVALID') {
71
+ return { exitCode: 78, message: error instanceof Error ? error.message : String(error) };
72
+ }
73
+ console.error(`Warning: Update check failed: ${error instanceof Error ? error.message : String(error)}`);
74
+ console.log('Continuing with re-deployment...\n');
75
+ }
76
+ }
77
+ // Read the control-plane file before normalization: the loader defaults an
78
+ // absent installed block to {}, which would hide the legacy fallback gate.
79
+ let installed;
80
+ try {
81
+ const configPath = getConfigPath(ctx.cwd);
82
+ if (fs.existsSync(configPath)) {
83
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
84
+ if (Object.hasOwn(config, 'installed')) {
85
+ if (!config.installed || typeof config.installed !== 'object' || Array.isArray(config.installed)) {
86
+ throw new Error('installed must be an object');
87
+ }
88
+ installed = config.installed;
89
+ }
90
+ }
91
+ }
92
+ catch (error) {
93
+ return { exitCode: 1, message: `Cannot plan update from aiwg.config: ${error instanceof Error ? error.message : String(error)}` };
94
+ }
95
+ const useName = (id) => REGISTRY_ID_TO_USE_NAME[id] ?? id;
96
+ // With config authority the registry is diagnostic only; it never supplies
97
+ // deployment candidates. Only an absent installed block enables fallback.
98
+ const registry = readFrameworkRegistry(ctx.cwd);
99
+ const configured = installed === undefined ? undefined : Object.keys(installed);
100
+ if (configured === undefined) {
101
+ console.log('Legacy fallback: aiwg.config has no installed block; using .aiwg/frameworks/registry.json');
102
+ }
103
+ else if (!deployAll) {
104
+ const selected = new Set(configured.map(useName));
105
+ const skipped = (registry?.frameworks ?? []).filter(item => !selected.has(useName(item.id)));
106
+ if (skipped.length)
107
+ console.log(`Skipped legacy registry frameworks: ${skipped.map(item => item.id).join(', ')}`);
108
+ }
109
+ const installedFrameworks = deployAll ? ['all'] : [...new Set((configured ?? registry?.frameworks.map(item => item.id) ?? []).map(useName))];
110
+ if (installedFrameworks.length === 0) {
111
+ console.log('No installed frameworks to re-deploy. Use aiwg use <framework> to install one.');
112
+ return { exitCode: 0 };
113
+ }
114
+ // Report what will be updated
115
+ console.log(`Installed frameworks: ${installedFrameworks.join(', ')}`);
116
+ console.log('');
117
+ if (dryRun) {
118
+ console.log('Dry run: Would re-deploy the following frameworks:');
119
+ for (const fw of installedFrameworks) {
120
+ console.log(` - aiwg use ${[fw, ...providerArgs].join(' ')}`);
121
+ }
122
+ return { exitCode: 0 };
123
+ }
124
+ // Step 3: Re-deploy each installed framework
125
+ const results = [];
126
+ for (const fw of installedFrameworks) {
127
+ console.log(`Re-deploying ${fw}...`);
128
+ const deploy = () => useFrameworkHandler.execute({
129
+ ...ctx,
130
+ args: [fw, ...providerArgs],
131
+ });
132
+ const result = await (deployAll ? deploy() : withInstalledSelection(ctx.cwd, installed, deploy));
133
+ results.push({ framework: fw, exitCode: result.exitCode });
134
+ if (result.exitCode !== 0) {
135
+ console.error(`Warning: Failed to re-deploy ${fw}`);
136
+ }
137
+ }
138
+ // Step 4: Report summary
139
+ console.log('');
140
+ console.log('Update Summary:');
141
+ const succeeded = results.filter(r => r.exitCode === 0);
142
+ const failed = results.filter(r => r.exitCode !== 0);
143
+ for (const r of results) {
144
+ const status = r.exitCode === 0 ? 'updated' : 'FAILED';
145
+ console.log(` ${r.framework}: ${status}`);
146
+ }
147
+ console.log('');
148
+ console.log(`Updated: ${succeeded.length}/${results.length}`);
149
+ return {
150
+ exitCode: failed.length > 0 ? 1 : 0,
151
+ message: failed.length > 0
152
+ ? `Some frameworks failed to update: ${failed.map(f => f.framework).join(', ')}`
153
+ : `Successfully updated ${succeeded.length} framework(s)`,
154
+ };
155
+ },
156
+ };
157
+ //# sourceMappingURL=update.js.map
@@ -1464,7 +1464,7 @@ const USE_BOOLEAN_FLAGS = new Set([
1464
1464
  '--no-aiwg-md', '--no-agents-md', '--force-context-files', '--global', '--user',
1465
1465
  '--no-utils', '--ci-hooks-enabled', '--skip-conflicts', '--no-harness-agents',
1466
1466
  '--workspace-signals', '--no-workspace-signals', '--yes', '-y', '--non-interactive',
1467
- '--allow-over-budget', '--no-hooks', '--enable-cross-provider-hooks',
1467
+ '--allow-over-budget', '--no-hooks', '--no-attribution', '--enable-cross-provider-hooks',
1468
1468
  '--skip-commands-migration', '--listing-budget', '--mcp', '--as-agents-md',
1469
1469
  '--create-agents-md', '--commands-only', '--skills-only', '--rules-only',
1470
1470
  '--save', '--save-user', '--help', '-h',
@@ -1516,6 +1516,8 @@ function useDeploymentArgs(args) {
1516
1516
  forwarded.push('--deploy-version', useDeployment.version);
1517
1517
  if (useDeployment?.skipContextFiles && !forwarded.includes('--no-context-files'))
1518
1518
  forwarded.push('--no-context-files');
1519
+ if (useDeployment?.skipAttribution && !forwarded.includes('--no-attribution'))
1520
+ forwarded.push('--no-attribution');
1519
1521
  return forwarded;
1520
1522
  }
1521
1523
  function deploymentVersion(root) {
@@ -2343,6 +2345,7 @@ Additional options:
2343
2345
  Suppress individual context files
2344
2346
  --force-context-files Replace context files
2345
2347
  --no-hooks Skip managed hooks
2348
+ --no-attribution Leave Claude attribution settings untouched
2346
2349
  --enable-cross-provider-hooks
2347
2350
  Enable cross-provider hooks
2348
2351
  --ci-hooks-enabled Deploy CI workflows
@@ -2394,6 +2397,7 @@ export class UseHandler {
2394
2397
  useDeployment = {
2395
2398
  resourceCredentials,
2396
2399
  version: previousDeployment?.version ?? resolveDeployVersion(ctx.frameworkRoot || await getFrameworkRoot()),
2400
+ skipAttribution: previousDeployment?.skipAttribution || ctx.args.includes('--no-attribution'),
2397
2401
  skipContextFiles: previousDeployment?.skipContextFiles || ctx.args.includes('--no-context-files'),
2398
2402
  contextFiles: previousDeployment?.contextFiles ?? [],
2399
2403
  };
@@ -2561,6 +2565,14 @@ export class UseHandler {
2561
2565
  }
2562
2566
  }
2563
2567
  }
2568
+ // Captured deploy passes suppress stderr on success; report operator choices here.
2569
+ if (coreResult.exitCode === 0 && !dryRun && providers.includes('claude') && !useDeployment?.skipAttribution) {
2570
+ for (const root of new Set([projectDir, ...(requestedScope === 'user' ? [os.homedir()] : [])])) {
2571
+ const settings = await installAiwgHooks({ projectPath: root, frameworkRoot, hooks: false, dryRun: true });
2572
+ for (const warning of settings?.warnings || [])
2573
+ originalConsole.warn(`Claude settings: ${warning}`);
2574
+ }
2575
+ }
2564
2576
  const providerResults = [];
2565
2577
  for (const provider of providers) {
2566
2578
  const effectiveScope = provider === 'openclaw' || provider === 'openhuman'
@@ -4102,6 +4114,7 @@ export class UseHandler {
4102
4114
  const r = await installAiwgHooks({
4103
4115
  projectPath: target,
4104
4116
  frameworkRoot,
4117
+ attribution: !useDeployment?.skipAttribution && !remainingArgs.includes('--no-attribution'),
4105
4118
  dryRun,
4106
4119
  verbose,
4107
4120
  });
@@ -4241,9 +4254,6 @@ export class UseHandler {
4241
4254
  if (verbose && ctxResult.aiwgMdPath) {
4242
4255
  ui.dim(` Wrote AIWG.md`);
4243
4256
  }
4244
- if (verbose && ctxResult.normalizedAiwgMdPath) {
4245
- ui.dim(` Wrote .aiwg/AIWG.md`);
4246
- }
4247
4257
  if (verbose && ctxResult.claudeMdHookPath && ctxResult.claudeMdHookAction && ctxResult.claudeMdHookAction !== 'unchanged') {
4248
4258
  // #1437: CLAUDE.md hook for claude provider; mirrors AGENTS.md for other providers.
4249
4259
  const verb = ctxResult.claudeMdHookAction === 'created' ? 'Created' :