@aiwg/cli 2026.11.0 → 2026.11.1

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 (89) hide show
  1. package/agentic/code/providers/flue/README.md +2 -1
  2. package/dist/src/artifacts/cli.js +3 -2
  3. package/dist/src/artifacts/discover-facets.js +2 -0
  4. package/dist/src/artifacts/discover-session-facets.js +14 -0
  5. package/dist/src/artifacts/fortemi-core-query-adapter.js +4 -4
  6. package/dist/src/artifacts/framework-capabilities.js +7 -3
  7. package/dist/src/artifacts/index-builder.js +2 -3
  8. package/dist/src/artifacts/query-engine-discover-output.js +3 -3
  9. package/dist/src/artifacts/query-engine-discover.js +61 -14
  10. package/dist/src/artifacts/query-engine-entries.js +52 -9
  11. package/dist/src/artifacts/query-engine-installation.js +27 -0
  12. package/dist/src/artifacts/query-engine-rules.js +1 -2
  13. package/dist/src/artifacts/query-engine-scoring.js +33 -31
  14. package/dist/src/artifacts/query-engine-show-card.js +6 -2
  15. package/dist/src/artifacts/query-engine-show.js +2 -2
  16. package/dist/src/artifacts/relations.js +17 -10
  17. package/dist/src/cli/handlers/checkpoint.js +143 -0
  18. package/dist/src/cli/handlers/help.js +1 -0
  19. package/dist/src/cli/handlers/index.js +4 -2
  20. package/dist/src/cli/handlers/models-resource-sample.js +7 -3
  21. package/dist/src/cli/handlers/ralph-launcher.js +1 -1
  22. package/dist/src/cli/handlers/script-runner.js +2 -1
  23. package/dist/src/cli/handlers/steward-signing.js +44 -0
  24. package/dist/src/cli/handlers/steward.js +5 -0
  25. package/dist/src/cli/handlers/use-provider-results.js +17 -0
  26. package/dist/src/cli/handlers/use.js +9 -15
  27. package/dist/src/cli/router.js +12 -2
  28. package/dist/src/cli/user-scope-mirror.js +3 -1
  29. package/dist/src/config/aiwg-config.js +5 -1
  30. package/dist/src/config/cli.js +1 -0
  31. package/dist/src/config/delivery-validation.js +21 -0
  32. package/dist/src/config/host-resource-report.d.mts +1 -1
  33. package/dist/src/config/host-resource-report.mjs +23 -4
  34. package/dist/src/config/host-resource-runtime.d.mts +8 -0
  35. package/dist/src/config/host-resource-runtime.mjs +67 -24
  36. package/dist/src/config/index-graph-overrides.js +4 -0
  37. package/dist/src/config/worker-attribution.d.mts +7 -0
  38. package/dist/src/config/worker-attribution.mjs +44 -0
  39. package/dist/src/delivery/git.js +62 -0
  40. package/dist/src/delivery/pr.js +149 -0
  41. package/dist/src/delivery/tracker.js +33 -0
  42. package/dist/src/discovery/interview.js +1 -1
  43. package/dist/src/extensions/claude-hooks-installer.js +1 -0
  44. package/dist/src/extensions/loader.js +2 -1
  45. package/dist/src/issues/cli.js +12 -3
  46. package/dist/src/issues/external-cli.js +76 -0
  47. package/dist/src/issues/live.js +18 -1
  48. package/dist/src/issues/tracker-policy.js +17 -0
  49. package/dist/src/mcp/tools/worker-invoke.mjs +2 -1
  50. package/dist/src/mcp/tools/worker-stdin-runtime.mjs +12 -0
  51. package/dist/src/models/conductor-data-policy.d.mts +3 -2
  52. package/dist/src/models/conductor-data-policy.mjs +94 -5
  53. package/dist/src/models/worker-plan.js +3 -3
  54. package/dist/src/models/worker-selection-policy.js +2 -1
  55. package/dist/src/providers/deployment-lock.js +77 -0
  56. package/dist/src/providers/deployment-ownership.d.mts +12 -2
  57. package/dist/src/providers/deployment-ownership.mjs +115 -21
  58. package/dist/src/providers/deployment-preservation.d.mts +2 -1
  59. package/dist/src/providers/deployment-preservation.mjs +3 -0
  60. package/dist/src/providers/provider-definitions.js +4 -0
  61. package/dist/src/serve/worker-invocation-preparation.js +3 -1
  62. package/dist/src/serve/worker-invocation.js +2 -0
  63. package/dist/src/skills/run.js +5 -0
  64. package/dist/src/smiths/hook-bridge/codex-translator.js +3 -1
  65. package/dist/src/smiths/hook-bridge/hermes-translator.js +3 -1
  66. package/dist/src/smiths/hook-bridge/prompt-discovery-gaps.js +6 -0
  67. package/package.json +4 -2
  68. package/schemas/models/model-config-compatibility.v1.schema.json +4 -0
  69. package/tools/agents/deploy-agents.mjs +15 -0
  70. package/tools/agents/providers/base-contract.mjs +7 -1
  71. package/tools/agents/providers/base-inventory.mjs +35 -13
  72. package/tools/agents/providers/base.mjs +1 -1
  73. package/tools/agents/providers/conductor-data-guard.mjs +35 -11
  74. package/tools/agents/providers/muse-hooks.mjs +4 -0
  75. package/tools/agents/providers/muse-prompt-discovery.mjs +22 -0
  76. package/tools/agents/providers/provider-prepare-coordinator.mjs +15 -10
  77. package/tools/agents/providers/rule-delivery-surface.mjs +6 -3
  78. package/tools/agents/providers/rule-deployment-commit.mjs +10 -0
  79. package/tools/agents/providers/stale-artifact-prune.mjs +9 -8
  80. package/tools/ralph-external/lib/worker-capture.mjs +157 -0
  81. package/tools/ralph-external/lib/worker-health.mjs +3 -0
  82. package/tools/ralph-external/lib/worker-invocation-processes.mjs +9 -6
  83. package/tools/ralph-external/lib/worker-launch-cli.mjs +10 -1
  84. package/tools/ralph-external/lib/worker-process-identity.mjs +30 -0
  85. package/tools/ralph-external/lib/worker-retry-evidence.mjs +87 -6
  86. package/tools/ralph-external/lib/worker-termination.mjs +56 -6
  87. package/tools/ralph-external/process-monitor.mjs +12 -18
  88. package/tools/ralph-external/session-launcher.mjs +43 -29
  89. package/vscode-extension/schemas/aiwg.config.v1.json +15 -0
@@ -2,7 +2,7 @@
2
2
  import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import { getGraphIndexDir } from './types.js';
5
- import { resolveFrameworkIndexRoot } from './framework-index-paths.js';
5
+ import { resolveFrameworkCorpusRoot, resolveFrameworkIndexRoot } from './framework-index-paths.js';
6
6
  import { frameworkSourceDigest } from './framework-source-digest.js';
7
7
  import { createHash } from 'node:crypto';
8
8
  import { loadRulePinConfigs, resolveRulePins } from '../rules/pins.mjs';
@@ -91,8 +91,9 @@ function selectPrebuiltRelationsSource(cwd, cacheSourceDigest = true) {
91
91
  return { reader: null, reason: 'unsupported prebuilt relationship schema' };
92
92
  if (stamp.package_version !== pkg.version)
93
93
  return { reader: null, reason: 'prebuilt relationship package version differs' };
94
- if (stamp.source_digest !== frameworkSourceDigest(root, cacheSourceDigest))
95
- return { reader: null, reason: 'prebuilt relationship source digest differs (modified, added or removed corpus source)' };
94
+ const sourceDigest = frameworkSourceDigest(root, cacheSourceDigest);
95
+ if (stamp.source_digest !== sourceDigest)
96
+ return { reader: null, sourceDigest, reason: 'prebuilt relationship source digest differs (modified, added or removed corpus source)' };
96
97
  const text = fs.readFileSync(path.join(dir, 'relations.json'), 'utf8');
97
98
  if (createHash('sha256').update(text).digest('hex') !== stamp.checksums['relations.json'])
98
99
  return { reader: null, reason: 'prebuilt relationship checksum differs' };
@@ -104,7 +105,7 @@ function selectPrebuiltRelationsSource(cwd, cacheSourceDigest = true) {
104
105
  || index.fingerprint?.version !== RELATIONS_VERSION || !/^sha256:[a-f0-9]{64}$/.test(index.fingerprint.sources)
105
106
  || !index.rules || !index.targets || !index.capabilities || !index.aliases?.targets || !index.aliases.rules)
106
107
  return { reader: null, reason: 'unsupported prebuilt relationship table' };
107
- return { reader: new RelationsReader(index) };
108
+ return { reader: new RelationsReader(index), sourceDigest };
108
109
  }
109
110
  catch {
110
111
  return { reader: null, reason: 'prebuilt relationship tables unavailable or corrupt' };
@@ -113,24 +114,30 @@ function selectPrebuiltRelationsSource(cwd, cacheSourceDigest = true) {
113
114
  /** Apply local pins only after cache validation so policy errors cannot masquerade as cache misses. */
114
115
  export function selectPrebuiltRelations(cwd, pinCwd = cwd, cacheSourceDigest = true) {
115
116
  const selected = selectPrebuiltRelationsSource(cwd, cacheSourceDigest);
116
- return selected.reader ? { reader: readerWithPins(selected.reader.index, pinCwd) } : selected;
117
+ return selected.reader ? { ...selected, reader: readerWithPins(selected.reader.index, pinCwd) } : selected;
117
118
  }
118
119
  /** Synchronous read API: prebuilt first, then this root's built sidecar. */
119
120
  export function loadRelations(cwd, pinCwd = cwd, cacheSourceDigest = true) {
120
121
  return selectPrebuiltRelations(cwd, pinCwd, cacheSourceDigest).reader ?? loadBuiltRelations(cwd, pinCwd);
121
122
  }
122
123
  /** Read paths reconcile through the existing lock/receipt when prebuilt is stale. */
123
- export async function ensureRelations(cwd, pinCwd = cwd) {
124
- const selected = selectPrebuiltRelations(cwd, pinCwd);
124
+ export async function ensureRelations(cwd, pinCwd = cwd, options = {}) {
125
+ const selected = options.selection ?? selectPrebuiltRelations(cwd, pinCwd);
125
126
  if (selected.reader)
126
127
  return selected.reader;
127
128
  const root = resolveFrameworkIndexRoot(cwd);
128
- if (fs.existsSync(path.join(root, PREBUILT_RELATIONS_DIR, 'manifest.json'))) {
129
+ if ((options.verbose || process.argv.includes('--verbose') || process.argv.includes('--debug')
130
+ || ['debug', 'info'].includes(process.env.AIWG_LOG_LEVEL ?? ''))
131
+ && fs.existsSync(path.join(root, PREBUILT_RELATIONS_DIR, 'manifest.json'))) {
129
132
  console.error(`Relationship tables: ${selected.reason}; using the per-root index (rebuilding if stale).`);
130
133
  }
131
134
  const { refreshFrameworkCapabilities } = await import('./framework-capabilities.js');
132
- await refreshFrameworkCapabilities(root, false);
133
- return loadBuiltRelations(cwd, pinCwd);
135
+ if (!options.reconciled)
136
+ await refreshFrameworkCapabilities(root, false);
137
+ const reader = loadBuiltRelations(cwd, pinCwd);
138
+ if (!reader && (resolveFrameworkCorpusRoot(root) || fs.existsSync(path.join(root, PREBUILT_RELATIONS_DIR, 'manifest.json'))))
139
+ throw new Error('Relationship tables unavailable: no usable prebuilt or per-root index. Run `aiwg index build --graph framework`.');
140
+ return reader;
134
141
  }
135
142
  // Convenience entry points; use one loaded reader for a batch of lookups.
136
143
  export function rulesForTarget(type, id, cwd = process.cwd()) {
@@ -0,0 +1,143 @@
1
+ // Create, list, and inspect lightweight workflow checkpoints in the configured artifact root.
2
+ import { randomUUID } from 'node:crypto';
3
+ import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
4
+ import { join } from 'node:path';
5
+ import { boundedExecFileSync } from '../../process/bounded-child-process.mjs';
6
+ import { resolveProjectAiwgDirForWrite } from '../../config/project-artifacts.js';
7
+ const usage = [
8
+ 'aiwg checkpoint — Save or inspect a workflow resume position',
9
+ '',
10
+ 'Usage:',
11
+ ' aiwg checkpoint create [--name N] [--phase P] [--step S] [--artifact <path>]... [--note N]',
12
+ ' aiwg checkpoint list [--json]',
13
+ ' aiwg checkpoint recover [<id|name>] [--json]',
14
+ '',
15
+ 'Recover reports the saved record without changing the repository.',
16
+ 'Duplicate names select the newest matching checkpoint.',
17
+ ].join('\n');
18
+ function parse(args) {
19
+ const [action, ...rest] = args;
20
+ if (!['create', 'list', 'recover'].includes(action))
21
+ throw new Error(`Unknown checkpoint action: ${action ?? '(missing)'}\n${usage}`);
22
+ const values = {};
23
+ const artifacts = [];
24
+ let lookup;
25
+ let json = false;
26
+ for (let i = 0; i < rest.length; i++) {
27
+ const arg = rest[i];
28
+ if (arg === '--json' && action !== 'create') {
29
+ json = true;
30
+ continue;
31
+ }
32
+ if (action === 'create' && /^--(name|phase|step|artifact|note)(=|$)/.test(arg)) {
33
+ const eq = arg.indexOf('=');
34
+ const key = arg.slice(2, eq < 0 ? undefined : eq);
35
+ const value = eq < 0 ? rest[++i] : arg.slice(eq + 1);
36
+ if (!value || (eq < 0 && value.startsWith('-')))
37
+ throw new Error(`--${key} requires a value`);
38
+ if (key === 'artifact')
39
+ artifacts.push(value);
40
+ else {
41
+ if (key in values)
42
+ throw new Error(`--${key} may be given once`);
43
+ values[key] = value;
44
+ }
45
+ }
46
+ else if (action === 'recover' && !arg.startsWith('-') && lookup === undefined) {
47
+ lookup = arg;
48
+ }
49
+ else
50
+ throw new Error(`Unexpected checkpoint argument: ${arg}`);
51
+ }
52
+ return { action, values, artifacts, lookup, json };
53
+ }
54
+ async function records(dir) {
55
+ let files;
56
+ try {
57
+ files = await readdir(dir);
58
+ }
59
+ catch (error) {
60
+ if (error.code === 'ENOENT')
61
+ return [];
62
+ throw error;
63
+ }
64
+ const result = await Promise.all(files.filter(file => file.endsWith('.json')).map(async (file) => {
65
+ const record = JSON.parse(await readFile(join(dir, file), 'utf8'));
66
+ if (!record || typeof record.id !== 'string' || typeof record.cwd !== 'string'
67
+ || typeof record.createdAt !== 'string' || !Number.isFinite(Date.parse(record.createdAt))
68
+ || !Array.isArray(record.artifacts) || !record.artifacts.every(path => typeof path === 'string')
69
+ || ['name', 'gitHead', 'phase', 'step', 'note'].some(key => {
70
+ const value = record[key];
71
+ return value !== undefined && typeof value !== 'string';
72
+ }))
73
+ throw new Error(`Invalid checkpoint record: ${file}`);
74
+ return record;
75
+ }));
76
+ return result.sort((a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt) || b.id.localeCompare(a.id));
77
+ }
78
+ function resumeText(record) {
79
+ return [
80
+ `Checkpoint: ${record.id}${record.name ? ` (${record.name})` : ''}`,
81
+ `Created: ${record.createdAt}`,
82
+ `Resume in: ${record.cwd}`,
83
+ `Phase: ${record.phase ?? '(unspecified)'}`,
84
+ `Step: ${record.step ?? '(unspecified)'}`,
85
+ ...(record.gitHead ? [`Git HEAD: ${record.gitHead}`] : []),
86
+ `Artifacts: ${record.artifacts.length ? record.artifacts.join(', ') : '(none)'}`,
87
+ ...(record.note !== undefined ? [`Note: ${record.note}`] : []),
88
+ ].join('\n');
89
+ }
90
+ export const checkpointHandler = {
91
+ id: 'checkpoint',
92
+ name: 'Workflow Checkpoints',
93
+ description: 'Create, list, or recover a saved workflow position',
94
+ category: 'workspace',
95
+ aliases: [],
96
+ async help() { return { exitCode: 0, message: usage, rawOutput: true }; },
97
+ async execute(ctx) {
98
+ if (ctx.args.includes('--help') || ctx.args.includes('-h') || ctx.args[0] === 'help') {
99
+ return { exitCode: 0, message: usage, rawOutput: true };
100
+ }
101
+ try {
102
+ const { action, values, artifacts, lookup, json } = parse(ctx.args);
103
+ const dir = join(resolveProjectAiwgDirForWrite(ctx.cwd), 'checkpoints');
104
+ if (action === 'create') {
105
+ if (ctx.dryRun)
106
+ return { exitCode: 0, message: `Would create checkpoint in ${dir}`, rawOutput: true };
107
+ let gitHead;
108
+ try {
109
+ gitHead = String(boundedExecFileSync('git', ['rev-parse', '--verify', 'HEAD'], 'quick', {
110
+ cwd: ctx.cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
111
+ })).trim();
112
+ }
113
+ catch { /* Checkpoints also work outside git repositories. */ }
114
+ const record = {
115
+ id: `ckpt_${randomUUID()}`, ...values, createdAt: new Date().toISOString(),
116
+ cwd: ctx.cwd, ...(gitHead ? { gitHead } : {}), artifacts,
117
+ };
118
+ await mkdir(dir, { recursive: true });
119
+ await writeFile(join(dir, `${record.id}.json`), `${JSON.stringify(record, null, 2)}\n`, { flag: 'wx' });
120
+ return { exitCode: 0, message: record.id, rawOutput: true };
121
+ }
122
+ const all = await records(dir);
123
+ if (action === 'list') {
124
+ return {
125
+ exitCode: 0, rawOutput: true,
126
+ message: json ? JSON.stringify(all, null, 2) : all.length
127
+ ? ['ID\tName\tCreated\tPhase / Step', ...all.map(record => `${record.id}\t${record.name ?? '(unnamed)'}\t${record.createdAt}\t${record.phase ?? '-'} / ${record.step ?? '-'}`)].join('\n')
128
+ : 'No checkpoints found.',
129
+ };
130
+ }
131
+ const record = lookup === undefined ? all[0]
132
+ : all.find(record => record.id === lookup) ?? all.find(record => record.name === lookup);
133
+ if (!record)
134
+ throw new Error(lookup === undefined ? 'No checkpoints found.' : `Checkpoint not found: ${lookup}`);
135
+ return { exitCode: 0, message: json ? JSON.stringify(record, null, 2) : resumeText(record), rawOutput: true };
136
+ }
137
+ catch (error) {
138
+ return { exitCode: 1, message: error instanceof Error ? error.message : String(error) };
139
+ }
140
+ },
141
+ };
142
+ export const checkpointHandlers = [checkpointHandler];
143
+ //# sourceMappingURL=checkpoint.js.map
@@ -116,6 +116,7 @@ function displayHelp() {
116
116
  ['cost-report --fleet', 'Observe OpenRouter per-bot MTD spend and correlate local activity'],
117
117
  ]);
118
118
  helpGroup('EVIDENCE', [
119
+ ['checkpoint create|list|recover', 'Save or inspect a workflow resume position'],
119
120
  ['evidence export --output <dir>', 'Package portable activity, report, source, eval, and provenance evidence'],
120
121
  ['evidence verify <bundle>', 'Verify every member hash and the bundle checkpoint'],
121
122
  ['effect record|lookup|reconcile', 'Record, look up or reconcile a side effect in the signed effect ledger'],
@@ -33,6 +33,7 @@ import { regenerateHandler, regenerateHandlers } from './regenerate.js';
33
33
  import { workspaceContextHandler, workspaceContextHandlers } from './workspace-context.js';
34
34
  import { artifactsHandler, artifactsHandlers } from './artifacts.js';
35
35
  import { effectHandler, effectHandlers } from './effect.js';
36
+ import { checkpointHandler, checkpointHandlers } from './checkpoint.js';
36
37
  import { mcHandler, mcHandlers } from './mc.js';
37
38
  import { missionHandlers } from './mission.js';
38
39
  import { sdlcAccelerateHandler } from './sdlc-accelerate.js';
@@ -88,7 +89,7 @@ newBundleHandler, quickrefHandler, newProjectHandler, sessionHandler, sessionsHa
88
89
  // Workspace
89
90
  statusHandler, wizardHandler, migrateWorkspaceHandler, rollbackWorkspaceHandler,
90
91
  // Subcommands
91
- mcpHandler, catalogHandler, modelsHandler, versionsHandler, indexHandler, artifactsHandler, effectHandler, corpusHandler, discoverHandler, showHandler, featuresHandler, skillsHandler, configHandler, opsHandler, storageHandler, activityLogHandler, commandLogHandler, skillUsageHandler, kbHandler, memoryHandler, reflectionsHandler, provenanceHandler, researchStoreHandler, researchQueryHandler, runtimeInfoHandler, agentcardHandler, uhpHandler,
92
+ mcpHandler, catalogHandler, modelsHandler, versionsHandler, indexHandler, artifactsHandler, effectHandler, checkpointHandler, corpusHandler, discoverHandler, showHandler, featuresHandler, skillsHandler, configHandler, opsHandler, storageHandler, activityLogHandler, commandLogHandler, skillUsageHandler, kbHandler, memoryHandler, reflectionsHandler, provenanceHandler, researchStoreHandler, researchQueryHandler, runtimeInfoHandler, agentcardHandler, uhpHandler,
92
93
  // Agentic Tools (RLM)
93
94
  chunkHandler, fanoutHandler, rlmPrepHandler, rlmSearchHandler, rlmStatusCliHandler, rlmCacheHandler,
94
95
  // Utilities
@@ -124,7 +125,7 @@ repoAccessHandler,
124
125
  // Lint
125
126
  lintHandler, };
126
127
  // Re-export handler arrays
127
- export { workspaceHandlers, utilityHandlers, scaffoldingHandlers, housekeeperHandlers, ralphHandlers, subcommandHandlers, mcHandlers, missionHandlers, teamHandlers, stewardHandlers, regenerateHandlers, workspaceContextHandlers, artifactsHandlers, effectHandlers, daemonHandlers, sandboxHandlers, repoAccessHandlers, };
128
+ export { workspaceHandlers, utilityHandlers, scaffoldingHandlers, housekeeperHandlers, ralphHandlers, subcommandHandlers, mcHandlers, missionHandlers, teamHandlers, stewardHandlers, regenerateHandlers, workspaceContextHandlers, artifactsHandlers, effectHandlers, checkpointHandlers, daemonHandlers, sandboxHandlers, repoAccessHandlers, };
128
129
  /**
129
130
  * All registered command handlers
130
131
  *
@@ -186,6 +187,7 @@ export const allHandlers = [
186
187
  indexHandler,
187
188
  artifactsHandler,
188
189
  effectHandler,
190
+ checkpointHandler,
189
191
  corpusHandler,
190
192
  discoverHandler,
191
193
  showHandler,
@@ -1,10 +1,14 @@
1
1
  // Sample the project and actual CLI request filesystems before rendering a worker.
2
2
  import path from 'node:path';
3
- import { readLiveHostResources } from '../../config/host-resource-runtime.mjs';
3
+ import { nearestDispatchPathSync, readLiveHostResources } from '../../config/host-resource-runtime.mjs';
4
4
  import { parseWorkerCommandArgs } from '../../serve/worker-command-request.js';
5
5
  export function sampleWorkerHostResources(ctx, readers) {
6
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 });
7
+ // A final-output folder is normally created by the launch, so sample the
8
+ // filesystem it will land on, under the launcher's fail-closed rules (#3856).
9
+ const paths = request
10
+ ? [ctx.cwd, request.workdir, nearestDispatchPathSync(path.dirname(request.final_output))]
11
+ : [ctx.cwd];
12
+ return readLiveHostResources({ ...readers, paths, workspace: request?.workdir ?? ctx.cwd });
9
13
  }
10
14
  //# sourceMappingURL=models-resource-sample.js.map
@@ -264,7 +264,7 @@ export async function launchExternalRalph(frameworkRoot, projectRoot, options) {
264
264
  while (!identity && process.hrtime.bigint() < identityDeadline) {
265
265
  if ((child.exitCode !== null && child.exitCode !== undefined) || child.signalCode)
266
266
  break;
267
- identity = capture.observe(sampleWorkerIdentity(pid));
267
+ identity = capture.observe(sampleWorkerIdentity(pid, { includeExited: true }));
268
268
  if (!identity)
269
269
  await new Promise(resolve => setTimeout(resolve, 10));
270
270
  }
@@ -15,6 +15,7 @@ import { pathToFileURL } from 'node:url';
15
15
  import { Console } from 'node:console';
16
16
  import { Writable } from 'node:stream';
17
17
  import { writeSync } from 'node:fs';
18
+ import { providerDeploymentLockEnvironment } from '../../providers/deployment-lock.js';
18
19
  // Embedded deployers use process-wide console/environment APIs. Serialize the
19
20
  // complete invocation (including import), and restore them even after failure.
20
21
  let deploymentQueue = Promise.resolve();
@@ -62,7 +63,7 @@ export class DefaultScriptRunner {
62
63
  const stdio = options.capture
63
64
  ? ['pipe', options.stdoutFd ?? 'pipe', 'pipe']
64
65
  : 'inherit';
65
- const environment = { ...process.env, ...options.env };
66
+ const environment = { ...process.env, ...providerDeploymentLockEnvironment(), ...options.env };
66
67
  for (const name of options.omitEnv ?? [])
67
68
  delete environment[name];
68
69
  const child = spawn('node', [fullPath, ...args], {
@@ -0,0 +1,44 @@
1
+ // Offer optional signed local merges with a reviewable preview and an explicit config-only apply.
2
+ import { readAiwgConfig, writeAiwgConfig } from '../../config/aiwg-config.js';
3
+ export async function stewardSignedMerges(args, cwd) {
4
+ const values = new Map();
5
+ for (let i = 0; i < args.length; i++) {
6
+ if (['--apply', '--skip', '--help'].includes(args[i]))
7
+ continue;
8
+ if (!['--key', '--key-file', '--name', '--email', '--format', '--program'].includes(args[i]) || !args[i + 1] || args[i + 1].startsWith('--'))
9
+ throw new Error('Invalid signed-merges option');
10
+ values.set(args[i], args[++i]);
11
+ }
12
+ if (args.includes('--skip')) {
13
+ console.log('Signed merge setup skipped; project configuration preserved.');
14
+ return;
15
+ }
16
+ const config = await readAiwgConfig(cwd);
17
+ if (!config)
18
+ throw new Error('Signed merge setup requires .aiwg/aiwg.config');
19
+ const existing = config.delivery;
20
+ const key = values.get('--key') ?? existing?.signing?.key;
21
+ const name = values.get('--name') ?? existing?.committer?.name;
22
+ const email = values.get('--email') ?? existing?.committer?.email;
23
+ const format = values.get('--format') ?? existing?.signing?.format ?? 'openpgp';
24
+ if (!['openpgp', 'ssh', 'x509'].includes(format))
25
+ throw new Error('Signing format must be openpgp, ssh, or x509');
26
+ if (args.includes('--help') || !key || !name || !email) {
27
+ console.log('Recommended, optional: set up signed merges using an existing signing key and permitted repository policy. Skip when signing is unavailable or unwanted.\naiwg steward signed-merges --key <fingerprint> --name <committer> --email <email> [--format openpgp|ssh|x509] [--key-file <path>] [--program <path>]\nReview the preview, then add --apply to save. Use --skip to preserve unsigned delivery. SSH signing uses --key SHA256:... for verification and --key-file for the signing key path. This step creates no keys and changes no repository policies.');
28
+ if (args.includes('--apply'))
29
+ throw new Error('Applying signed merges requires key, name, and email');
30
+ return;
31
+ }
32
+ const delivery = { ...existing, merge: 'local-signed', require_signed_commits: true,
33
+ committer: { name, email }, signing: { ...existing?.signing, key, format: format, enforce: 'commits',
34
+ ...(values.has('--key-file') ? { key_file: values.get('--key-file') } : {}),
35
+ ...(values.has('--program') ? { program: values.get('--program') } : {}) } };
36
+ console.log(JSON.stringify({ delivery }, null, 2));
37
+ if (args.includes('--apply')) {
38
+ await writeAiwgConfig(cwd, { ...config, delivery });
39
+ console.log('Signed local merge configuration saved.');
40
+ }
41
+ else
42
+ console.log('Preview only. Add --apply to save, or --skip to keep current delivery.');
43
+ }
44
+ //# sourceMappingURL=steward-signing.js.map
@@ -100,6 +100,7 @@ async function handleSteward(args, ctx) {
100
100
  aiwg steward — Provider capability awareness and command routing
101
101
 
102
102
  Usage:
103
+ aiwg steward signed-merges [--apply|--skip] Optional signed local merge setup
103
104
  aiwg steward decision-offload [--json] Offline advisory readiness and adoption report
104
105
  aiwg steward capabilities --provider <name> Capabilities for a specific provider
105
106
  aiwg steward capabilities --feature <name> Provider support matrix for a feature
@@ -129,6 +130,10 @@ async function handleSteward(args, ctx) {
129
130
  `);
130
131
  return;
131
132
  }
133
+ if (subcommand === 'signed-merges') {
134
+ const { stewardSignedMerges } = await import('./steward-signing.js');
135
+ return stewardSignedMerges(args.slice(1), ctx ? getProjectDir(ctx, args) : process.cwd());
136
+ }
132
137
  if (subcommand === 'decision-offload') {
133
138
  const unknown = args.slice(1).filter(arg => arg !== '--json');
134
139
  if (unknown.length)
@@ -0,0 +1,17 @@
1
+ export async function deployEachProvider(providers, deploy) {
2
+ const providerResults = new Map();
3
+ for (const [order, provider] of providers.entries()) {
4
+ try {
5
+ providerResults.set(provider, await deploy(provider, order));
6
+ }
7
+ catch (error) {
8
+ providerResults.set(provider, { exitCode: 1, message: error instanceof Error ? error.message : String(error) });
9
+ }
10
+ }
11
+ const failed = [...providerResults.values()].find(result => result.exitCode !== 0);
12
+ return { exitCode: failed?.exitCode ?? 0, message: failed?.message, providerResults };
13
+ }
14
+ export function resultForProvider(result, provider) {
15
+ return result.providerResults?.get(provider) ?? result;
16
+ }
17
+ //# sourceMappingURL=use-provider-results.js.map
@@ -22,6 +22,7 @@ import { resolveOmpPaths } from '../../providers/omp-paths.mjs';
22
22
  import YAML from 'yaml';
23
23
  import { createScriptRunner } from './script-runner.js';
24
24
  import { finalizePreparedProvider, prepareProviderDeployments } from '../services/provider-prepare-coordinator.js';
25
+ import { deployEachProvider, resultForProvider } from './use-provider-results.js';
25
26
  import { getFrameworkRoot, getVersionInfo } from '../../channel/manager.mjs';
26
27
  import { getRegistry } from '../../extensions/registry.js';
27
28
  import { registerDeployedExtensions } from '../../extensions/deployment-registration.js';
@@ -2522,10 +2523,11 @@ export class UseHandler {
2522
2523
  }
2523
2524
  const providerResults = [];
2524
2525
  for (const provider of providers) {
2526
+ const providerResult = resultForProvider(coreResult, provider);
2525
2527
  const effectiveScope = provider === 'openclaw' || provider === 'openhuman'
2526
2528
  ? 'user'
2527
2529
  : requestedScope;
2528
- if (coreResult.exitCode === 0 && !dryRun) {
2530
+ if (providerResult.exitCode === 0 && !dryRun) {
2529
2531
  try {
2530
2532
  const receiptOptions = {
2531
2533
  projectRoot: projectDir,
@@ -2557,8 +2559,8 @@ export class UseHandler {
2557
2559
  requestedBundles: [requestedBundle],
2558
2560
  contextOptOut,
2559
2561
  invocationStartedAt: dryRun ? undefined : startedAt,
2560
- deploymentExitCode: coreResult.exitCode,
2561
- deploymentMessage: coreResult.message,
2562
+ deploymentExitCode: providerResult.exitCode,
2563
+ deploymentMessage: providerResult.message,
2562
2564
  // A normal first deployment has no authenticated verifier handoff
2563
2565
  // yet, so receipt absence belongs in doctor/status rather than
2564
2566
  // degrading an otherwise successful `aiwg use` result.
@@ -3467,20 +3469,17 @@ export class UseHandler {
3467
3469
  let session;
3468
3470
  try {
3469
3471
  session = await prepareProviderDeployments(frameworkRoot, preparedJobs);
3470
- for (const [order, requested] of providers.entries()) {
3472
+ return await session.run(() => deployEachProvider(providers, async (requested, order) => {
3471
3473
  await session.commit(order);
3472
3474
  const capability = randomUUID();
3473
3475
  this.preparedProviderContinuations.add(capability);
3474
3476
  try {
3475
- const result = await this.execute({ ...ctx, args: [framework, '--provider', requested, preparedFlag, capability, ...remainingArgs] });
3476
- if (result.exitCode !== 0)
3477
- return result;
3477
+ return await this.execute({ ...ctx, args: [framework, '--provider', requested, preparedFlag, capability, ...remainingArgs] });
3478
3478
  }
3479
3479
  finally {
3480
3480
  this.preparedProviderContinuations.delete(capability);
3481
3481
  }
3482
- }
3483
- return { exitCode: 0 };
3482
+ }));
3484
3483
  }
3485
3484
  catch (error) {
3486
3485
  return { exitCode: 1, message: `Concurrent provider preparation failed: ${error instanceof Error ? error.message : String(error)}` };
@@ -3489,12 +3488,7 @@ export class UseHandler {
3489
3488
  await session?.dispose();
3490
3489
  }
3491
3490
  }
3492
- for (const p of providers) {
3493
- const result = await this.execute({ ...ctx, args: [framework, '--provider', p, ...remainingArgs] });
3494
- if (result.exitCode !== 0)
3495
- return result;
3496
- }
3497
- return { exitCode: 0 };
3491
+ return deployEachProvider(providers, p => this.execute({ ...ctx, args: [framework, '--provider', p, ...remainingArgs] }));
3498
3492
  }
3499
3493
  const requestedProvider = providers[0];
3500
3494
  const projectLocalProviderResolution = await resolveProjectLocalProviderAdapter(projectDir, requestedProvider);
@@ -23,6 +23,7 @@ import { maybeAppendCommandLog } from './command-log.js';
23
23
  import { maybeAppendSkillUsage } from './skill-usage.js';
24
24
  // Cached loaded registry
25
25
  let cachedRegistry = null;
26
+ let discoveryRegistry = null;
26
27
  // Global hook registry and executor. Register built-in hooks at module
27
28
  // load time so they fire for every command without per-handler wiring.
28
29
  const hookRegistry = new HookRegistry();
@@ -36,7 +37,16 @@ hookRegistry.register(activityLogPostCommandHook);
36
37
  *
37
38
  * @returns Loaded registry with handlers
38
39
  */
39
- export async function initRouter() {
40
+ export async function initRouter(discoveryOnly = false) {
41
+ if (discoveryOnly && !cachedRegistry) {
42
+ if (!discoveryRegistry) {
43
+ // Keep normal dispatch, hooks and logging; avoid importing every command's
44
+ // implementation and schema validators for the session's first lookup.
45
+ const { discoverHandler, indexHandler } = await import('./handlers/subcommands-discovery.js');
46
+ discoveryRegistry = await loadRegistry({ handlers: [discoverHandler, indexHandler] });
47
+ }
48
+ return discoveryRegistry;
49
+ }
40
50
  if (!cachedRegistry) {
41
51
  cachedRegistry = await loadRegistry({ indexCapabilities: true });
42
52
  }
@@ -85,7 +95,7 @@ export async function run(args, options = {}) {
85
95
  return;
86
96
  }
87
97
  const started = process.hrtime.bigint();
88
- const registry = await initRouter();
98
+ const registry = await initRouter(args[0] === 'discover' || args[0] === 'index' && args[1] === 'discover');
89
99
  // Normalize `help <command>` into the same non-executing help path.
90
100
  const routedArgs = args[0] === 'help' && args[1] && !args[1].startsWith('-')
91
101
  ? [args[1], ...args.slice(2), '--help']
@@ -142,7 +142,9 @@ export async function mirrorArtifactDir(src, dst, ownedThisCall = new Set()) {
142
142
  }
143
143
  if (Object.keys(copiedRecords).length) {
144
144
  const sidecarPath = path.resolve(dst, SIDECAR);
145
- const prior = receipt(before.get(sidecarPath));
145
+ // Receipt sidecars are always captured as bytes.
146
+ const priorBytes = before.get(sidecarPath);
147
+ const prior = receipt(Buffer.isBuffer(priorBytes) ? priorBytes : undefined);
146
148
  const next = { ...prior, managed: { ...object(prior.managed), ...copiedRecords } };
147
149
  await fs.writeFile(sidecarPath, `${JSON.stringify(next, null, 2)}\n`);
148
150
  }
@@ -1,3 +1,4 @@
1
+ import { validateDeliverySettings } from './delivery-validation.js';
1
2
  import { validateInstalled } from './installed-validation.js';
2
3
  import { preserveInstalledSelection } from './installed-selection.js';
3
4
  import { validateHitlPolicy } from '../policy/hitl-validation.js';
@@ -29,7 +30,7 @@ import { readFileSync, existsSync } from 'node:fs';
29
30
  import { readFile, access, readdir } from 'fs/promises';
30
31
  import { createHash } from 'crypto';
31
32
  import { resolve, join, isAbsolute } from 'path';
32
- import { normalizeNamedCaptures } from '../artifacts/index-builder.js';
33
+ import { normalizeNamedCaptures } from './index-graph-overrides.js';
33
34
  import { getProviderDefinition, getProviderKernelSkillPath, PROVIDER_IDS, resolveProviderPathValue, } from '../providers/provider-definitions.js';
34
35
  import { validateAuthorization, } from '../policy/authorization.js';
35
36
  import { projectAiwgPath, projectControlPath, resolveProjectAiwgDir, } from './project-artifacts.js';
@@ -169,6 +170,7 @@ export function resolveDelivery(delivery) {
169
170
  },
170
171
  },
171
172
  merge_style: delivery?.merge_style ?? 'rebase-merge',
173
+ merge: delivery?.merge ?? 'tracker',
172
174
  delete_branch_on_merge: delivery?.delete_branch_on_merge ?? true,
173
175
  require_ci_green: delivery?.require_ci_green ?? true,
174
176
  require_signed_commits: delivery?.require_signed_commits ?? false,
@@ -994,6 +996,7 @@ export async function readAiwgConfigCandidate(projectDir) {
994
996
  const threatAssessmentErrors = [
995
997
  ...validateThreatAssessmentConfig(parsed.security?.threatAssessment),
996
998
  ...validateProjectConfig(parsed.project),
999
+ ...validateDeliverySettings(parsed),
997
1000
  ...validateParallelismConfig(parsed.parallelism),
998
1001
  ...validateDecisionConfig(parsed.decision),
999
1002
  ...validateRulePinCapabilities(parsed.rules, installedRuleCapabilities(loadRulePinConfigs(projectDir, parsed)), loadRulePinConfigs(projectDir, parsed).user.rules?.pin_groups),
@@ -1083,6 +1086,7 @@ async function writeAiwgConfigUnlocked(projectDir, config) {
1083
1086
  const threatAssessmentErrors = [
1084
1087
  ...validateThreatAssessmentConfig(config.security?.threatAssessment),
1085
1088
  ...validateProjectConfig(config.project),
1089
+ ...validateDeliverySettings(config),
1086
1090
  ...validateParallelismConfig(config.parallelism),
1087
1091
  ...validateDecisionConfig(config.decision),
1088
1092
  ...validateRulePinCapabilities(config.rules, installedRuleCapabilities(loadRulePinConfigs(projectDir, config)), loadRulePinConfigs(projectDir, config).user.rules?.pin_groups),
@@ -175,6 +175,7 @@ const ENUM_ALIAS_NOTES = {
175
175
  };
176
176
  const ENUM_RULES = {
177
177
  'delivery.mode': ['direct', 'feature-branch', 'pr-required'],
178
+ 'delivery.merge': ['local-signed', 'local', 'tracker'],
178
179
  'delivery.merge_style': ['rebase-merge', 'squash', 'merge', 'fast-forward-only'],
179
180
  'delivery.force_push_policy': ['never', 'own-branch-only', 'allowed'],
180
181
  'delivery.signing.format': ['openpgp', 'ssh', 'x509'],
@@ -0,0 +1,21 @@
1
+ export function validateDeliverySettings(config) {
2
+ const errors = [];
3
+ const delivery = config.delivery;
4
+ if (delivery?.merge !== undefined && !['local-signed', 'local', 'tracker'].includes(delivery.merge))
5
+ errors.push('delivery.merge must be local-signed, local, or tracker');
6
+ for (const name of ['tracker_actor', 'customer_tracker_actor']) {
7
+ const credential = config.remotes?.[name]?.credential;
8
+ if (credential !== undefined) {
9
+ const entries = credential && typeof credential === 'object' ? Object.entries(credential) : [];
10
+ if (entries.length !== 1 || !entries.every(([key, value]) => typeof value === 'string' &&
11
+ (key === 'env' ? /^[A-Za-z_][A-Za-z0-9_]*$/.test(value) : key === 'store' && /^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/.test(value)))) {
12
+ errors.push(`remotes.${name}.credential requires exactly one store or env reference`);
13
+ }
14
+ }
15
+ }
16
+ if (delivery?.merge === 'local-signed' && (!delivery.signing?.key || !delivery.committer?.name || !delivery.committer.email)) {
17
+ errors.push('delivery.merge=local-signed requires signing.key and committer.name/email');
18
+ }
19
+ return errors;
20
+ }
21
+ //# sourceMappingURL=delivery-validation.js.map
@@ -12,7 +12,7 @@ export interface HostResourceReport {
12
12
  slots: number;
13
13
  ok: boolean;
14
14
  limits: Array<{ threshold: string; slots: number }>;
15
- failures: Array<{ signal: string; reason: string; actual?: number; threshold?: number }>;
15
+ failures: Array<{ signal: string; reason: string; code?: 'OG_HOST_ATTRIBUTION' | 'OG_HOST_CAPACITY'; actual?: number; threshold?: number }>;
16
16
  counting?: string;
17
17
  limitingThreshold?: string;
18
18
  groups: Array<{ group: string; maxParallel: number | null; slots: number | null; reason: string }>;