agentic-workflow-manager 9.6.1 → 9.7.1

package/README.md

@@ -69,6 +69,8 @@ and one JSON argv integration command. Start or resume with `awm watch`; inspect
 `awm track status`. Track workers commit only their assigned files and request
 `awm track join`. The plan supervisor freezes and merges tracks, runs global QA once on the
 final HEAD, executes the canonical integration job once, then applies the interlock.
+`awm track remove` requests a safe cancellation of the complete cohort; only demonstrably
+owned resources are removed before returning to serial execution.
 
 Any missing declaration, overlap, global file class, unavailable worktree, or failed
 preparation degrades to serial with an event naming the cause. `BLOCKED` means ownership or

package/dist/src/commands/doctor.js

@@ -19,6 +19,7 @@ const collect_1 = require("../core/dashboard/collect");
 const render_html_1 = require("../core/dashboard/render-html");
 const render_terminal_1 = require("../core/dashboard/render-terminal");
 const write_html_1 = require("../core/dashboard/write-html");
+const bundles_1 = require("../core/bundles");
 function glyph(status) {
     if (status === 'ok')
         return picocolors_1.default.green('✔');
@@ -127,6 +128,7 @@ function renderProviderReport(report) {
 }
 function runDoctor(opts = {}) {
     const resolveTargets = opts.resolveTargets ?? agent_targets_1.resolveAgentTargets;
+    const reporter = opts.reporter ?? (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
     const invalid = (message) => { process.stderr.write(`awm doctor: ${message}\n`); return 2; };
     const htmlRequested = opts.html !== undefined;
     if (opts.json && opts.full)
@@ -143,7 +145,7 @@ function runDoctor(opts = {}) {
             const target = htmlRequested ? (0, write_html_1.resolveHtmlTarget)({ cwd, target: opts.html, force: opts.force }) : undefined;
             const targets = resolveTargets({ prefs: (0, config_1.readPreferences)(), explicit: opts.agent });
             const collectSnapshot = opts.collectSnapshot ?? collect_1.collectDashboardSnapshot;
-            const context = (0, context_1.gatherContext)({ cwd, agents: targets });
+            const context = (0, context_1.gatherContext)({ cwd, agents: targets, reporter });
             const snapshot = collectSnapshot({ cwd, now: new Date().toISOString(), adapters: {
                     ...(0, collect_1.productionDashboardAdapters)(context),
                 } });
@@ -175,7 +177,7 @@ function runDoctor(opts = {}) {
     }
     let report;
     try {
-        const ctx = (0, context_1.gatherContext)({ cwd: opts.cwd, agents: targets });
+        const ctx = (0, context_1.gatherContext)({ cwd: opts.cwd, agents: targets, reporter });
         const providers = ctx.providers ?? [];
         report = { providers, overall: (0, checks_1.computeProviderOverall)(providers) };
     }

package/dist/src/commands/export.js

@@ -8,14 +8,17 @@ exports.registerExportCommand = registerExportCommand;
 const picocolors_1 = __importDefault(require("picocolors"));
 const path_1 = __importDefault(require("path"));
 const export_1 = require("../core/export");
+const bundles_1 = require("../core/bundles");
 function runExportCommand(name, flags, deps = {}) {
     const log = deps.log ?? console.log;
+    const reporter = deps.reporter ?? (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
     const opts = {
         name,
         target: flags.target,
         out: flags.out,
         roots: deps.roots,
         zip: deps.zip,
+        reporter,
     };
     const summary = (0, export_1.runExport)(opts);
     log(picocolors_1.default.dim(`Exported ${summary.kind} "${name}"`));

package/dist/src/commands/init.js

@@ -138,6 +138,14 @@ async function runInit(opts = {}) {
         (0, paths_1.noteWindowsCaveat)((m) => console.log(picocolors_1.default.dim(`ℹ ${m}`)));
     }
     const cwd = opts.cwd ?? process.cwd();
+    const report = opts.reporter ?? (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
+    const reportedDiagnostics = new Set();
+    const reporter = (diagnostic) => {
+        if (reportedDiagnostics.has(diagnostic))
+            return;
+        reportedDiagnostics.add(diagnostic);
+        report(diagnostic);
+    };
     const agent = opts.agent === undefined ? 'claude-code' : (0, providers_1.requireAgentTarget)(opts.agent);
     // R2: gate BEFORE anything is read or written — an unsupported provider
     // version must never touch preferences.json or any provider file.
@@ -190,7 +198,7 @@ async function runInit(opts = {}) {
         // that exact run won't roll those specific artifacts back — every
         // other target (preferences, hook, injection, previously-installed
         // bundle content) is covered.
-        const preSyncBundles = (0, bundles_1.discoverAllBundles)();
+        const preSyncBundles = (0, bundles_1.discoverAllBundles)(undefined, reporter);
         const mutationTargets = (0, mutation_targets_1.planInitMutationTargets)({
             cwd,
             agent,
@@ -207,7 +215,7 @@ async function runInit(opts = {}) {
                 // step's failure instead of being reported as its own cause.
                 (0, registries_1.assertSyncedRegistriesUsable)((await mergedActions.syncCache()) ?? []);
             }
-            const bundles = (0, bundles_1.discoverAllBundles)();
+            const bundles = (0, bundles_1.discoverAllBundles)(undefined, reporter);
             const ctx = (0, context_1.gatherContext)({ cwd, bundles, agent });
             // In machineOnly mode, null out the project context so project steps are skipped
             const effectiveCtx = opts.machineOnly

package/dist/src/commands/registry/add.js

@@ -26,7 +26,7 @@ function deriveRegistryName(remote) {
     const base = remote.replace(/[/\\]+$/, '').split(/[/\\:]/).pop() ?? '';
     return base.replace(/\.git$/, '');
 }
-async function addRegistry(remote, nameOverride) {
+async function addRegistry(remote, nameOverride, reporter) {
     const name = nameOverride ?? deriveRegistryName(remote);
     if (!name || name === '.' || name.includes('..') || /[/\\]/.test(name)) {
         return { ok: false, error: `Invalid registry name "${name}" — use --name <simple-dir-name>` };
@@ -61,7 +61,7 @@ async function addRegistry(remote, nameOverride) {
         (0, discovery_1.discoverSkills)(roots);
         (0, discovery_1.discoverWorkflows)(roots);
         (0, discovery_1.discoverAgents)(roots);
-        (0, bundles_1.discoverAllBundles)(roots);
+        (0, bundles_1.discoverAllBundles)(roots, reporter);
     }
     catch (e) {
         fs_1.default.rmSync(dest, { recursive: true, force: true });

package/dist/src/commands/registry/index.js

@@ -28,10 +28,11 @@ function registerRegistryCommand(program) {
         .option('--install-all', 'install every bundle from the new registry for the default agent')
         .option('--no-install', 'skip the bundle install offer')
         .action(async (remote, options) => {
+        const reporter = (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
         (0, prompts_1.intro)(picocolors_1.default.bgCyan(picocolors_1.default.black(' AWM - Add Registry ')));
         const s = (0, prompts_1.spinner)();
         s.start('Cloning and validating registry...');
-        const result = await (0, add_1.addRegistry)(remote, options.name);
+        const result = await (0, add_1.addRegistry)(remote, options.name, reporter);
         if (!result.ok) {
             s.stop('Failed.');
             console.error(picocolors_1.default.red(result.error));
@@ -49,7 +50,7 @@ function registerRegistryCommand(program) {
         }
         // Bundle install offer — failure NEVER reverts the add.
         try {
-            const available = (0, install_bundles_1.bundlesInRegistry)(result.contentRoot);
+            const available = (0, install_bundles_1.bundlesInRegistry)(result.contentRoot, reporter);
             if (available.length > 0) {
                 const prefs = (0, config_1.getPreferences)();
                 const projectRoot = (0, profile_1.findProjectRoot)(process.cwd()) ?? process.cwd();
@@ -82,7 +83,7 @@ function registerRegistryCommand(program) {
                     }
                 }
                 if (selection) {
-                    for (const r of (0, install_bundles_1.installBundlesFromRegistry)(result.contentRoot, selection, agents, projectRoot)) {
+                    for (const r of (0, install_bundles_1.installBundlesFromRegistry)(result.contentRoot, selection, agents, projectRoot, reporter)) {
                         for (const line of r.installed)
                             console.log(picocolors_1.default.green(`  ✓ ${line}`));
                         for (const sk of r.skipped)
@@ -103,6 +104,7 @@ function registerRegistryCommand(program) {
     reg.command('list')
         .description('list configured additional registries')
         .action(() => {
+        const reporter = (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
         const regs = (0, registries_1.listRegistries)();
         if (regs.length === 0) {
             console.log(picocolors_1.default.dim('No additional registries. Add one with `awm registry add <git-url>`.'));
@@ -125,12 +127,12 @@ function registerRegistryCommand(program) {
             try {
                 const counts = [
                     `${(0, discovery_1.discoverSkills)([r.contentRoot]).length} skills`,
-                    `${(0, bundles_1.discoverAllBundles)([r.contentRoot]).length} bundles`,
+                    `${(0, bundles_1.discoverAllBundles)([r.contentRoot], reporter).length} bundles`,
                     `${(0, discovery_1.discoverWorkflows)([r.contentRoot]).length} workflows`,
                     `${(0, discovery_1.discoverAgents)([r.contentRoot]).length} agents`,
                 ].join(', ');
                 console.log(`${picocolors_1.default.cyan(r.name)}  ${r.remote}  ${picocolors_1.default.dim(counts)}`);
-                for (const o of (0, status_1.overrideStatus)(r.contentRoot, earlier)) {
+                for (const o of (0, status_1.overrideStatus)(r.contentRoot, earlier, reporter)) {
                     console.log(o.active
                         ? picocolors_1.default.yellow(`    ↑ override active: ${o.name}`)
                         : picocolors_1.default.dim(`    ∅ override with no effect: ${o.name}`));

package/dist/src/commands/registry/install-bundles.js

@@ -9,16 +9,16 @@ const bundles_1 = require("../../core/bundles");
 const bundle_install_1 = require("../../core/bundle-install");
 /** Bundles disponibles en un content root concreto (candidatos a instalar tras el add).
  * Uses single-root discovery to avoid surfacing cross-registry collision errors here. */
-function bundlesInRegistry(contentRoot) {
-    return (0, bundles_1.discoverBundles)(contentRoot).map((b) => b.name);
+function bundlesInRegistry(contentRoot, reporter) {
+    return (0, bundles_1.discoverBundles)(contentRoot, reporter).map((b) => b.name);
 }
 /**
  * Instala bundles del registry `contentRoot` para los agentes dados.
  * `selection` = 'all' instala todos los del registry; una lista instala solo esos.
  * Las dependencias se resuelven contra TODOS los roots (pueden vivir en el base).
  */
-function installBundlesFromRegistry(contentRoot, selection, agents, projectRoot) {
-    const allBundles = (0, bundles_1.discoverAllBundles)();
+function installBundlesFromRegistry(contentRoot, selection, agents, projectRoot, reporter) {
+    const allBundles = (0, bundles_1.discoverAllBundles)(undefined, reporter);
     const candidates = allBundles.filter((b) => b.contentRoot === contentRoot);
     const wanted = selection === 'all' ? candidates : candidates.filter((b) => selection.includes(b.name));
     const results = [];

package/dist/src/commands/registry/status.js

@@ -13,7 +13,7 @@ const bundles_1 = require("../../core/bundles");
 function canDiscoverRegistryContent(contentRoot, safeRoots) {
     return safeRoots.has(contentRoot);
 }
-function artifactNamesInRoot(root) {
+function artifactNamesInRoot(root, reporter) {
     const names = new Set();
     for (const s of (0, discovery_1.discoverSkills)([root]))
         names.add(s.name);
@@ -21,17 +21,17 @@ function artifactNamesInRoot(root) {
         names.add(w.name);
     for (const a of (0, discovery_1.discoverAgents)([root]))
         names.add(a.name);
-    for (const b of (0, bundles_1.discoverAllBundles)([root]))
+    for (const b of (0, bundles_1.discoverAllBundles)([root], reporter))
         names.add(b.name);
     return names;
 }
-function overrideStatus(contentRoot, earlierRoots) {
+function overrideStatus(contentRoot, earlierRoots, reporter) {
     const declared = Array.from((0, registries_1.readRegistryManifest)(contentRoot).overrides);
     if (declared.length === 0)
         return [];
     const earlier = new Set();
     for (const root of earlierRoots) {
-        for (const n of artifactNamesInRoot(root))
+        for (const n of artifactNamesInRoot(root, reporter))
             earlier.add(n);
     }
     return declared.map((name) => ({ name, active: earlier.has(name) }));

package/dist/src/commands/sync.js

@@ -51,6 +51,7 @@ async function runSyncCore(options, deps = {}) {
     // emission point for this command (mirrors `runInit`/`runUpdateCore`).
     (0, paths_1.noteWindowsCaveat)((m) => console.log(picocolors_1.default.dim(`ℹ ${m}`)));
     const d = { ...defaultDeps, ...deps };
+    const reporter = options.reporter ?? (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
     const cwd = options.cwd ?? process.cwd();
     const projectRoot = (0, profile_1.findProjectRoot)(cwd);
     if (!projectRoot) {
@@ -130,7 +131,7 @@ async function runSyncCore(options, deps = {}) {
     const method = options.method === 'copy' ? 'copy' : 'symlink';
     let result;
     try {
-        result = d.syncProfile({ projectRoot, bundles: (0, bundles_1.discoverAllBundles)(), agents: selectedAgents, method });
+        result = d.syncProfile({ projectRoot, bundles: (0, bundles_1.discoverAllBundles)(undefined, reporter), agents: selectedAgents, method });
     }
     catch (e) {
         console.error(picocolors_1.default.red(e.message));

package/dist/src/commands/track/index.js

@@ -104,14 +104,10 @@ function registerTrackCommand(program) {
         }
         process.stdout.write(JSON.stringify({ requestId: r.requestId, idempotencyKey: r.idempotencyKey, qaHeadSha: r.qaHeadSha }, null, 2) + '\n');
     });
-    // NO IMPLEMENTADO del lado del supervisor: no hay handler para `track-teardown-request`,
-    // así que la request se emite y el supervisor la RECHAZA (`request-rejected-invalid`).
-    // La descripción lo dice en vez de prometer un desmantelamiento que no ocurre — hasta
-    // este release afirmaba que el supervisor desmantelaba worktree/rama, y no lo hacía.
-    // El teardown que sí funciona es el automático de la degradación a serial
-    // (`begin-teardown` desde `FALLBACK_PENDING`), que no pasa por este verbo.
+    // Request-only: el supervisor persiste la intención, cancela la cohorte completa y
+    // reutiliza el teardown fail-closed antes de volver a ejecución serial.
     track.command('remove')
-        .description('NO IMPLEMENTADO: emite track-teardown-request, que el supervisor todavía no sabe aplicar y rechaza')
+        .description('emite track-teardown-request — cancela la cohorte y solicita teardown seguro antes del fallback serial')
         .requiredOption('--generation <token>', 'token de la generacion vigente')
         .argument('<trackId>')
         .action((trackId, opts) => {

package/dist/src/commands/update.js

@@ -29,6 +29,7 @@ const registries_1 = require("../core/registries");
 const paths_2 = require("../core/paths");
 const regenerate_1 = require("../core/context/regenerate");
 const reconciliation_1 = require("../core/reconciliation");
+const bundles_1 = require("../core/bundles");
 const install_transaction_1 = require("../core/install-transaction");
 const resync_1 = require("../commands/hooks/resync");
 const defaultDeps = {
@@ -79,6 +80,7 @@ async function runUpdateCore(options = {}, deps = {}) {
     // single emission point for this command (mirrors `runInit`/`runSyncCore`).
     (0, paths_1.noteWindowsCaveat)((m) => console.log(picocolors_1.default.dim(`ℹ ${m}`)));
     const d = { ...defaultDeps, ...deps };
+    const reporter = options.reporter ?? (0, bundles_1.createBundleDiagnosticReporter)((message) => process.stderr.write(`${message}\n`));
     const prefs = (0, config_1.getPreferences)();
     const resolved = (0, agent_targets_1.resolveAgentTargetsOrError)({ prefs, explicit: options.agent });
     if (!resolved.ok) {
@@ -154,7 +156,7 @@ async function runUpdateCore(options = {}, deps = {}) {
         console.log(picocolors_1.default.green(`  ✓ Regenerated AWM context for: ${refreshed.join(', ')}`));
     let artifactResult;
     try {
-        const artifactPlan = d.planReconciliation({ targets: selectedAgents, roots: (0, registries_1.contentRoots)() });
+        const artifactPlan = d.planReconciliation({ targets: selectedAgents, roots: (0, registries_1.contentRoots)(), reporter });
         artifactResult = d.applyInstallPlan(artifactPlan);
     }
     catch (e) {

package/dist/src/commands/watch/apply.js

@@ -250,6 +250,21 @@ function applyRequestToState(s, env, digest, repoRoot) {
         (0, requests_1.applyOutcome)(s, { ...base, outcome: 'applied', resultRef: trackId });
         return;
     }
+    if (env.kind === 'track-teardown-request') {
+        const p = env.payload;
+        if (typeof p.trackId !== 'string' || p.trackId.length === 0)
+            throw new Error('track-teardown-request requiere trackId');
+        const trackId = p.trackId;
+        const ref = s.tracks?.find((t) => t.trackId === trackId);
+        if (ref === undefined)
+            throw new Error(`track-teardown-request: track desconocido: ${trackId}`);
+        if (s.tracks === undefined || s.tracks.length < 2 || s.cohortPhase === undefined) {
+            throw new Error('track-teardown-request requiere una cohorte válida de al menos dos tracks');
+        }
+        ref.teardownRequested = true;
+        (0, requests_1.applyOutcome)(s, { ...base, outcome: 'applied', resultRef: trackId });
+        return;
+    }
     if (env.kind === 'track-freeze-request') {
         // R5.2/R6.3 (Task 10): request administrativa CROSS-JOURNAL — el
         // supervisor del PLAN la emite directamente al `requestsDir` de ESTE

package/dist/src/commands/watch/tracks.js

@@ -135,13 +135,22 @@ function applyProtocolToState(state, protocol) {
     // `expectedPlanHeadSha` incorrecto.
     if (protocol.planHeadSha !== undefined)
         next.cohortPlanHeadSha = protocol.planHeadSha;
-    // R7/C3 (Task 12): mismo criterio que `cohortPlanHeadSha` arriba — valores
-    // que solo avanzan (nunca retroceden a `undefined` una vez fijados por
-    // `reconcileProtocol`).
-    if (protocol.globalQaHeadSha !== undefined)
-        next.globalQaHeadSha = protocol.globalQaHeadSha;
-    if (protocol.finalIntegrationJobId !== undefined)
-        next.finalIntegrationJobId = protocol.finalIntegrationJobId;
+    // R7/C3 (Task 12): los valores finales normalmente solo avanzan, salvo
+    // que fallback abandone explícitamente esa ruta. En ese caso el reducer
+    // ya invalidó su evidencia y el mirror durable DEBE borrarla también;
+    // conservarla permitiría que un restart reconstruyera un protocolo que
+    // contradice los tracks en teardown.
+    if (protocol.cohortPhase === 'FALLBACK_PENDING') {
+        next.globalQaHeadSha = undefined;
+        next.finalIntegrationJobId = undefined;
+        next.qaFinalizeRequested = undefined;
+    }
+    else {
+        if (protocol.globalQaHeadSha !== undefined)
+            next.globalQaHeadSha = protocol.globalQaHeadSha;
+        if (protocol.finalIntegrationJobId !== undefined)
+            next.finalIntegrationJobId = protocol.finalIntegrationJobId;
+    }
     if (protocol.fallbackReason !== undefined)
         next.cohortFallbackReason = protocol.fallbackReason;
     next.tracks = (next.tracks ?? []).map((ref) => {
@@ -818,6 +827,46 @@ async function reconcileTracks(planRoot, branch, state, runtime, maxParallel) {
         if (s.tracks === undefined || s.tracks.length < 2 || s.cohortPhase === undefined) {
             return { state: s, effectExecuted: null };
         }
+        // La request de teardown se consume en dos pasos durables, igual que
+        // join: `apply.ts` solo deja el marcador y este reconciler traduce la
+        // intención al reducer. BLOCKED, SERIAL y COMPLETE no admiten nueva
+        // transición: limpiar únicamente el marcador preserva el estado seguro.
+        const pendingTeardown = (s.tracks ?? []).find((track) => track.teardownRequested === true);
+        if (pendingTeardown !== undefined) {
+            const moot = ['BLOCKED', 'SERIAL', 'COMPLETE'].includes(s.cohortPhase);
+            if (moot) {
+                const next = structuredClone(s);
+                for (const track of next.tracks ?? [])
+                    if (track.trackId === pendingTeardown.trackId)
+                        track.teardownRequested = undefined;
+                s = persist(planRoot, branch, next);
+                (0, store_1.appendEvent)(planRoot, branch, {
+                    kind: 'track-teardown-moot', trackId: pendingTeardown.trackId, phase: s.cohortPhase,
+                });
+                return { state: s, effectExecuted: null };
+            }
+            const protocolBefore = toProtocol(s, maxParallel);
+            const observed = (0, protocol_1.reconcileProtocol)(protocolBefore, { kind: 'teardown-requested', trackId: pendingTeardown.trackId });
+            const next = applyProtocolToState(s, observed);
+            for (const track of next.tracks ?? [])
+                if (track.trackId === pendingTeardown.trackId)
+                    track.teardownRequested = undefined;
+            s = persist(planRoot, branch, next);
+            // El lock pertenece al proceso vivo que alcanzó la integración.
+            // Al abandonar FINAL_INTERLOCK debe soltarse en este mismo proceso;
+            // tras un crash el lease muerto se reclama por identidad al iniciar.
+            if (protocolBefore.cohortPhase === 'FINAL_INTERLOCK' && s.cohortPhase === 'FALLBACK_PENDING') {
+                runtime.releaseIntegrationLockIfHeld();
+            }
+            (0, store_1.appendEvent)(planRoot, branch, {
+                kind: 'track-teardown-observed', trackId: pendingTeardown.trackId,
+                phase: s.tracks?.find((t) => t.trackId === pendingTeardown.trackId)?.phase,
+            });
+            // El marcador es una frontera durable por sí mismo. No se consume
+            // otro marcador ni se entra a begin-teardown hasta la siguiente
+            // llamada, para que un crash conserve el resto de las requests.
+            return { state: s, effectExecuted: null };
+        }
         // El pedido de join del controller (`joinRequested`, marcado declarativamente al
         // consumir `track-join-request`) se convierte ACÁ en la observación que el reducer
         // entiende. La regla de si eso mueve la fase vive en `reconcileProtocol` (solo

package/dist/src/core/bundle-install.js

@@ -28,8 +28,8 @@ function bundleArtifacts(b, contentDir) {
     // estructural sobre la ruta ya resuelta.
     const refs = [];
     for (const s of b.skills) {
-        (0, artifact_name_1.assertSafeArtifactName)(s.name, 'skill');
-        refs.push({ name: s.name, type: 'skill', installName: s.name, sourcePath: path_1.default.join(contentDir, 'skills', s.name) });
+        (0, artifact_name_1.assertSafeArtifactName)(s, 'skill');
+        refs.push({ name: s, type: 'skill', installName: s, sourcePath: path_1.default.join(contentDir, 'skills', s) });
     }
     for (const w of b.workflows) {
         (0, artifact_name_1.assertSafeArtifactName)(w, 'workflow');

package/dist/src/core/bundles.js

@@ -4,15 +4,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readCatalog = readCatalog;
+exports.inspectBundles = inspectBundles;
+exports.createBundleDiagnosticReporter = createBundleDiagnosticReporter;
 exports.discoverBundles = discoverBundles;
 exports.resolveBundleSkills = resolveBundleSkills;
 exports.resolveBundleAgents = resolveBundleAgents;
 exports.defaultScopeForBundle = defaultScopeForBundle;
+exports.inspectAllBundles = inspectAllBundles;
 exports.discoverAllBundles = discoverAllBundles;
 exports.resolveBundleClosure = resolveBundleClosure;
 const fs_1 = __importDefault(require("fs"));
+const crypto_1 = __importDefault(require("crypto"));
 const path_1 = __importDefault(require("path"));
 const registries_1 = require("./registries");
+const text_1 = require("./text");
 function catalogPath(contentDir) {
     return path_1.default.join(contentDir, 'catalog.json');
 }
@@ -85,29 +90,63 @@ function readCatalog(contentDir) {
     // TypeError opaco mas adelante; se descarta aca, nombrando el archivo.
     return bundles.filter((entry) => entry !== null && typeof entry === 'object' && typeof entry.source === 'string');
 }
-/** Tolera `skills` ausente o mal formado: lo que no sea un array se trata como
- *  vacio en vez de tirar `(raw ?? []).map is not a function`, y cada entrada se
- *  valida individualmente. */
-function normalizeSkillRefs(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    return raw.flatMap((s) => {
-        if (typeof s === 'string')
-            return [{ name: s, onSignal: false }];
-        if (s !== null && typeof s === 'object' && typeof s.name === 'string') {
-            return [{ name: s.name, onSignal: s.onSignal === true }];
+function safeManifestIdentity(manifestPath) {
+    const sanitized = (0, text_1.sanitizeDiagnosticText)(manifestPath);
+    if (sanitized.length <= 240)
+        return sanitized;
+    const suffix = crypto_1.default.createHash('sha256').update(sanitized).digest('hex').slice(0, 16);
+    return `${sanitized.slice(0, 220)}…#${suffix}`;
+}
+function boundedDiagnostic(diagnostic) {
+    return (0, text_1.sanitizeDiagnosticText)(diagnostic).slice(0, 512);
+}
+/** Normaliza la única forma de compatibilidad CLI 9 antes de que el manifest
+ * alcance consumidores operativos. Los objetos nunca salen de este límite. */
+function normalizeSkillRefs(raw, manifestPath) {
+    const identity = safeManifestIdentity(manifestPath);
+    if (!Array.isArray(raw)) {
+        throw new Error(`${identity}: "skills" must be an array.`);
+    }
+    const skills = [];
+    let legacyCount = 0;
+    raw.forEach((ref, index) => {
+        const location = `${identity}: skills[${index}]`;
+        if (typeof ref === 'string') {
+            if (ref === '')
+                throw new Error(`${location} must be a non-empty string.`);
+            skills.push(ref);
+            return;
         }
-        return [];
+        if (ref === null || typeof ref !== 'object' || Array.isArray(ref)) {
+            throw new Error(`${location} must be a non-empty string or a supported legacy object.`);
+        }
+        const legacy = ref;
+        const keys = Object.keys(legacy);
+        if (!keys.every((key) => key === 'name' || key === 'onSignal')) {
+            throw new Error(`${location} legacy object may contain only "name" and optional "onSignal".`);
+        }
+        if (typeof legacy.name !== 'string' || legacy.name === '') {
+            throw new Error(`${location} legacy object "name" must be a non-empty string.`);
+        }
+        if (legacy.onSignal !== undefined && typeof legacy.onSignal !== 'boolean') {
+            throw new Error(`${location} legacy object "onSignal" must be a boolean.`);
+        }
+        skills.push(legacy.name);
+        legacyCount++;
     });
+    const diagnostics = legacyCount === 0 ? [] : [boundedDiagnostic(`${identity}: ${legacyCount} legacy object skill reference(s) accepted for CLI 9; ` +
+            'replace with canonical skills: ["skill-name"]. Legacy object support is removed in v10.')];
+    return { skills, diagnostics };
 }
 /** Array de strings, o vacio. Cualquier otra forma en el contenido del registry
  *  se ignora en vez de propagarse hasta un crash aguas abajo. */
 function stringArray(raw) {
     return Array.isArray(raw) ? raw.filter((v) => typeof v === 'string') : [];
 }
-function discoverBundles(contentDir) {
+function inspectBundles(contentDir) {
     const entries = readCatalog(contentDir);
     const bundles = [];
+    const diagnostics = [];
     for (const entry of entries) {
         const manifestPath = bundleManifestPath(contentDir, entry.source);
         if (!(0, registries_1.assertRegularRegistryFile)(manifestPath))
@@ -128,6 +167,8 @@ function discoverBundles(contentDir) {
         if (typeof m.name !== 'string' || m.name === '') {
             throw new Error(`${manifestPath}: "name" must be a non-empty string.`);
         }
+        const normalizedSkills = normalizeSkillRefs(m.skills, manifestPath);
+        diagnostics.push(...normalizedSkills.diagnostics);
         bundles.push({
             name: m.name,
             description: typeof m.description === 'string' ? m.description : '',
@@ -135,13 +176,36 @@ function discoverBundles(contentDir) {
             scope: m.scope ?? 'project',
             visibility: m.visibility ?? 'public',
             dependsOn: stringArray(m.dependsOn),
-            skills: normalizeSkillRefs(m.skills),
+            skills: normalizedSkills.skills,
             workflows: stringArray(m.workflows),
             agents: stringArray(m.agents),
             contentRoot: contentDir,
         });
     }
-    return bundles;
+    return { bundles, diagnostics };
+}
+/** Creates the command-scoped CLI reporter used by discovery facades. */
+function createBundleDiagnosticReporter(write = (message) => console.error(message)) {
+    const emitted = new Set();
+    return (diagnostic) => {
+        const safeDiagnostic = boundedDiagnostic(diagnostic);
+        if (emitted.has(safeDiagnostic))
+            return;
+        emitted.add(safeDiagnostic);
+        write(`warning: ${safeDiagnostic}`);
+    };
+}
+const defaultBundleDiagnosticReporter = createBundleDiagnosticReporter();
+function reportDiagnostics(diagnostics, reporter) {
+    const emit = reporter ?? defaultBundleDiagnosticReporter;
+    for (const diagnostic of new Set(diagnostics))
+        emit(diagnostic);
+}
+/** Compatibility facade for callers that only need bundle definitions. */
+function discoverBundles(contentDir, reporter) {
+    const result = inspectBundles(contentDir);
+    reportDiagnostics(result.diagnostics, reporter);
+    return result.bundles;
 }
 function resolveBundleSkills(bundleName, bundles) {
     const byName = new Map(bundles.map((b) => [b.name, b]));
@@ -157,7 +221,7 @@ function resolveBundleSkills(bundleName, bundles) {
         for (const dep of b.dependsOn)
             visit(dep);
         for (const s of b.skills)
-            skills.add(s.name);
+            skills.add(s);
     };
     visit(bundleName);
     return Array.from(skills);
@@ -192,11 +256,14 @@ function defaultScopeForBundle(scope) {
 /** Descubre bundles de TODOS los roots (base + registries adicionales).
  *  Colisión de nombre entre roots: override declarado en awm-registry.json
  *  del root posterior → reemplaza; no declarado → error nombrando ambas fuentes. */
-function discoverAllBundles(roots = (0, registries_1.contentRoots)()) {
+function inspectAllBundles(roots = (0, registries_1.contentRoots)()) {
     const byName = new Map();
+    const diagnostics = [];
     for (const root of roots) {
         const overrides = (0, registries_1.readRegistryManifest)(root).overrides;
-        for (const b of discoverBundles(root)) {
+        const result = inspectBundles(root);
+        diagnostics.push(...result.diagnostics);
+        for (const b of result.bundles) {
             const prev = byName.get(b.name);
             if (!prev) {
                 byName.set(b.name, b);
@@ -210,7 +277,13 @@ function discoverAllBundles(roots = (0, registries_1.contentRoots)()) {
                 `Remove or rename one of them, or declare "${b.name}" in "overrides" of the later registry's awm-registry.json.`);
         }
     }
-    return Array.from(byName.values());
+    return { bundles: Array.from(byName.values()), diagnostics: Array.from(new Set(diagnostics)) };
+}
+/** Compatibility facade for callers that only need bundle definitions. */
+function discoverAllBundles(roots = (0, registries_1.contentRoots)(), reporter) {
+    const result = inspectAllBundles(roots);
+    reportDiagnostics(result.diagnostics, reporter);
+    return result.bundles;
 }
 /**
  * Resolves the dependency closure of a bundle in deps-first order, deduped.

package/dist/src/core/diagnostics/context.js

@@ -307,7 +307,7 @@ function gatherProject(root, bundles, agent = 'claude-code') {
 }
 function gatherContext(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
-    const bundles = opts.bundles ?? (0, bundles_1.discoverAllBundles)();
+    const bundles = opts.bundles ?? (0, bundles_1.discoverAllBundles)(undefined, opts.reporter);
     const agent = opts.agent ?? 'claude-code';
     const root = (0, profile_1.findProjectRoot)(cwd);
     const agents = opts.agents ?? [agent];

package/dist/src/core/export/index.js

@@ -23,7 +23,7 @@ function runExport(opts) {
     }
     const roots = opts.roots ?? (0, registries_1.contentRoots)();
     const outDir = path_1.default.join(opts.out ?? path_1.default.join(process.cwd(), 'awm-export'), target);
-    const resolution = (0, resolve_1.resolveExport)(opts.name, roots);
+    const resolution = (0, resolve_1.resolveExport)(opts.name, roots, opts.reporter);
     fs_1.default.mkdirSync(outDir, { recursive: true });
     const exported = [];
     let zipAvailable = true;

package/dist/src/core/export/resolve.js

@@ -44,8 +44,8 @@ function assertOverrideConsistency(s) {
         throw new Error(`Inconsistent metadata for skill "${s.name}": ${OVERRIDE_FILE} exists but SKILL.md does not declare portable: true.`);
     }
 }
-function resolveExport(requested, roots) {
-    const bundles = (0, bundles_1.discoverAllBundles)(roots);
+function resolveExport(requested, roots, reporter) {
+    const bundles = (0, bundles_1.discoverAllBundles)(roots, reporter);
     if (bundles.some((b) => b.name === requested)) {
         const skills = [];
         const skipped = [];

package/dist/src/core/journal/types.js

@@ -246,6 +246,7 @@ function isWellFormedTrackRef(x) {
         && (x.supervisorProcessRef === undefined || isWellFormedProcessRef(x.supervisorProcessRef))
         && (x.joinIntent === undefined || isWellFormedJoinIntent(x.joinIntent))
         && (x.teardownIntent === undefined || isWellFormedTeardownIntent(x.teardownIntent))
+        && (x.teardownRequested === undefined || typeof x.teardownRequested === 'boolean')
         && (x.joinedCommitSha === undefined || typeof x.joinedCommitSha === 'string')
         && (x.blockedReason === undefined || typeof x.blockedReason === 'string');
 }

package/dist/src/core/reconciliation.js

@@ -16,7 +16,7 @@ function intentKey(intent) {
  */
 function planReconciliation(params) {
     const { targets, roots } = params;
-    const bundles = params.bundles ?? (0, bundles_1.discoverAllBundles)(roots);
+    const bundles = params.bundles ?? (0, bundles_1.discoverAllBundles)(roots, params.reporter);
     const contentDir = roots[0] ?? '';
     const machineBundles = bundles.filter((b) => b.scope === 'baseline' || b.scope === 'ambient');
     const seen = new Set();