@aiwg/cli 2026.9.21 → 2026.9.24

package/dist/src/artifacts/cli.js

@@ -526,22 +526,21 @@ async function handleBuild(args) {
     loadUserGraphConfigs(cwd);
     loadGlobalGraphConfigs();
     let jsonBuilt = false;
-    let projectGraphBuilt = false;
+    const builtGraphs = new Set();
     if (graph) {
         // --graph X: build the JSON graph if X is one; otherwise X may be a
         // research-corpus markdown view, rendered below.
         if (graph in GRAPH_CONFIGS) {
             await buildIndex(cwd, { force, verbose, scope, graph, explicit: true });
             jsonBuilt = true;
-            projectGraphBuilt = graph === 'project';
+            builtGraphs.add(graph);
         }
     }
     else if (all) {
         // Build all known graphs — user asked for everything, but don't hard-error on missing dirs
         for (const [name] of orderedGraphEntries(Object.entries(GRAPH_CONFIGS))) {
             await buildIndex(cwd, { force, verbose, graph: name, explicit: false });
-            if (name === 'project')
-                projectGraphBuilt = true;
+            builtGraphs.add(name);
         }
         jsonBuilt = true;
     }
@@ -550,8 +549,7 @@ async function handleBuild(args) {
         for (const [name, config] of orderedGraphEntries(Object.entries(GRAPH_CONFIGS))) {
             if (config.defaultBuild) {
                 await buildIndex(cwd, { force, verbose, scope: name === Object.keys(GRAPH_CONFIGS)[0] ? scope : undefined, graph: name, explicit: false });
-                if (name === 'project')
-                    projectGraphBuilt = true;
+                builtGraphs.add(name);
             }
         }
         jsonBuilt = true;
@@ -583,21 +581,28 @@ async function handleBuild(args) {
     if (viewResults.some((r) => r.status === 'unsupported')) {
         process.exit(1);
     }
-    if (projectGraphBuilt) {
-        await syncProjectFortemiCoreCacheAfterBuild(cwd, verbose);
+    if (builtGraphs.size > 0) {
+        await syncFortemiCoreCachesAfterBuild(cwd, builtGraphs, verbose);
     }
 }
-async function syncProjectFortemiCoreCacheAfterBuild(cwd, verbose) {
-    try {
-        const { syncFortemiCoreIndex } = await import('./fortemi-core-sync.js');
-        const manifest = syncFortemiCoreIndex(cwd, { graph: 'project' });
-        if (verbose) {
-            console.log(`Fortemi Core project sync: ${manifest.status}, ${manifest.item_count} item(s) → ${manifest.export_path}`);
+async function syncFortemiCoreCachesAfterBuild(cwd, graphs, verbose) {
+    const { syncFortemiCoreIndex } = await import('./fortemi-core-sync.js');
+    const { loadGraphIndexFile } = await import('./index-reader.js');
+    for (const graph of graphs) {
+        // Some default-build graphs skip cleanly when their scan roots are absent.
+        // Only materialize a cache when this build left an actual source index.
+        if (!loadGraphIndexFile(cwd, 'metadata.json', graph))
+            continue;
+        try {
+            const manifest = syncFortemiCoreIndex(cwd, { graph });
+            if (verbose) {
+                console.log(`Fortemi Core ${graph} sync: ${manifest.status}, ${manifest.item_count} item(s) → ${manifest.export_path}`);
+            }
+        }
+        catch (err) {
+            console.error(`Warning: Fortemi Core ${graph} sync failed: ${err instanceof Error ? err.message : String(err)}`);
+            console.error(`Run \`aiwg index sync --graph ${graph}\` before using Fortemi-backed commands for '${graph}' artifacts.`);
         }
-    }
-    catch (err) {
-        console.error(`Warning: Fortemi Core project sync failed: ${err instanceof Error ? err.message : String(err)}`);
-        console.error('Run `aiwg index sync --graph project` before using Fortemi-backed `aiwg discover` or `aiwg show` for project-local artifacts.');
     }
 }
 /**

package/dist/src/artifacts/fortemi-core-query-adapter.js

@@ -168,7 +168,11 @@ export function loadFortemiCoreExport(cwd, graph = "project", sourcePaths) {
         }
     }
     let status = getFortemiCoreSyncStatus(cwd, graph);
-    if ((!status.optedIn || !status.built || status.stale) && graph === "framework") {
+    // The packaged framework index is a bootstrap fallback for an absent shared
+    // cache. Once a shared cache exists, its stale state proves that the local
+    // source index is newer; silently replacing it with an older packaged index
+    // would hide newly authored capabilities.
+    if ((!status.optedIn || !status.built) && !status.stale && graph === "framework") {
         const prebuilt = getFortemiCorePrebuiltStatus(graph);
         if (prebuilt.optedIn && prebuilt.built && !prebuilt.stale) {
             status = prebuilt;
@@ -182,7 +186,7 @@ export function loadFortemiCoreExport(cwd, graph = "project", sourcePaths) {
     if (!status.built || status.stale) {
         return {
             reason: `${status.reason ??
-                `Fortemi Core static index for graph '${graph}' is stale or incomplete`}. Re-run 'aiwg index sync' or pass '--backend local' to use the legacy local index.`,
+                `Fortemi Core static index for graph '${graph}' is stale or incomplete`}. Re-run 'aiwg index sync${graph === "project" ? "" : ` --graph ${graph}`}' or pass '--backend local' to use the legacy local index.`,
         };
     }
     try {

package/dist/src/artifacts/query-engine.js

@@ -949,8 +949,12 @@ export async function discoverCapability(cwd, params) {
                     continue;
                 }
             }
-            if (loaded.reason)
+            if (loaded.reason) {
                 unavailableReason ??= loaded.reason;
+                if (graph === 'framework' && !params.graph) {
+                    console.error(`Warning: framework capabilities are unavailable: ${loaded.reason}`);
+                }
+            }
             entries.push(...loaded.entries.map((entry) => withIndexProvenance(entry, graph)));
             const discovered = await queryFortemiCoreAiwgDiscovery(cwd, {
                 graph,
@@ -1171,7 +1175,7 @@ export async function discoverCapability(cwd, params) {
     // broader phrase / type filter, and a capability refresh via `aiwg use`.
     const emptyResultHint = scored.length === 0
         ? backend === 'fortemi-core'
-            ? `No capability matched "${params.phrase}" among ${entries.length} Fortemi Core static-cache capabilities. Try a broader phrase or a \`--type\` filter. If the local index changed, refresh the cache with \`aiwg index sync\`, or pass \`--backend local\` to use the legacy local index.`
+            ? `No capability matched "${params.phrase}" among ${entries.length} Fortemi Core static-cache capabilities. Try a broader phrase or a \`--type\` filter. If the local index changed, refresh the cache with \`aiwg index sync ${params.graph ? `--graph ${params.graph}` : '--all'}\`, or pass \`--backend local\` to use the legacy local index.`
             : `No capability matched "${params.phrase}" among ${entries.length} indexed capabilities. Try a broader phrase or a \`--type\` filter. If you just installed or authored capabilities, refresh discovery with \`aiwg use <framework>\` (or \`aiwg index build\`).`
         : null;
     const includePaths = params.includePaths ?? true;
@@ -1272,7 +1276,9 @@ export async function discoverCapability(cwd, params) {
     }
     if (scored.length === 0) {
         console.log(`No discovery matches for "${params.phrase}" in types: ${types.join(',')}.`);
-        console.log('Try a broader phrase or a `--type` filter. If capabilities were just added, refresh with `aiwg use <framework>` (or `aiwg index build`).');
+        console.log(backend === 'fortemi-core'
+            ? emptyResultHint
+            : 'Try a broader phrase or a `--type` filter. If capabilities were just added, refresh with `aiwg use <framework>` (or `aiwg index build`).');
         return;
     }
     const relaxedNote = relaxed ? ' — relaxed match (verbose query)' : '';
@@ -1410,8 +1416,12 @@ async function loadShowEntries(cwd, params) {
                     continue;
                 }
             }
-            if (loaded.reason)
+            if (loaded.reason) {
                 unavailableReason ??= loaded.reason;
+                if (graph === 'framework' && !params.graph) {
+                    console.error(`Warning: framework capabilities are unavailable: ${loaded.reason}`);
+                }
+            }
             entries.push(...loaded.entries.map((entry) => withIndexProvenance(entry, graph)));
         }
         if (entries.length === 0 && unavailableReason) {

package/dist/src/decision/qualification/load.js

@@ -226,11 +226,18 @@ export async function runDecisionLoadHarness(options) {
 export function compareDecisionLoadBounds(manifest, observations, resources) {
     const bounds = manifest.bounds;
     const atMost = (bound, observed) => ({ bound, limit: bounds[bound], observed, pass: observed <= bounds[bound] });
+    // The wall-clock fallback is process-wide (runner plus sibling workers), so it
+    // cannot bound harness CPU: it fails conforming code on shared runners. The
+    // manifest CPU bound only gates isolated thread-CPU measurement. The observed
+    // value stays in resources for informational use.
+    const cpu = resources.cpuSource === 'thread'
+        ? [atMost('maximumCpuPercentOneCore', resources.cpuPercentOneCore)]
+        : [];
     return [
         atMost('maximumActiveCalls', observations.maximumActiveCalls),
         atMost('maximumQueuedCalls', observations.maximumQueuedCalls),
         atMost('maximumHeapUsedMiB', resources.heapUsedMiB),
-        atMost('maximumCpuPercentOneCore', resources.cpuPercentOneCore),
+        ...cpu,
         atMost('maximumEligibleLaneWaitMs', observations.maximumEligibleLaneWaitMs),
         atMost('maximumRetryAmplificationRatio', observations.retryAmplificationRatio),
         atMost('maximumCancellationLatencyMs', observations.maximumCancellationLatencyMs),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwg/cli",
-  "version": "2026.9.21",
+  "version": "2026.9.24",
   "description": "Lightweight AIWG CLI for signed, versioned web-backed resources.",
   "type": "module",
   "license": "MIT",