aiwg 2026.7.5 → 2026.7.7

package/README.md

@@ -1095,13 +1095,18 @@ The headline operator surface for finding and reading AIWG capabilities. Most AI
 aiwg discover "deploy production"           # → flow-deploy-to-production
 aiwg discover "create intake"               # → intake-* family
 aiwg discover "audit security" --type skill --limit 5
-aiwg discover "<phrase>" --json             # stable schema for sub-agents
+aiwg discover "<phrase>" --format json      # stable ids for sub-agents, no paths
+aiwg discover "<phrase>" --format json --compact
 
 # Fetch the full body of a specific artifact (companion to discover)
+aiwg show skill aiwg:skill:6f1477d99813ca8d
 aiwg show skill flow-deploy-to-production
 aiwg show agent aiwg-steward
 aiwg show command discover
 aiwg show rule no-attribution
+
+# Inspect Fortemi metadata and resolved paths when needed
+aiwg show metadata aiwg:skill:6f1477d99813ca8d --json
 ```
 
 The kernel quickrefs ship **curated, validated discovery phrases per capability domain** — phrases tested against the live scorer to surface the right top-3 candidates. The 6 self-maintenance ops (`steward`, `aiwg-doctor`, `aiwg-refresh`, `aiwg-status`, `aiwg-help`, `use`) stay loaded so the agent retains repair surfaces even when discovery itself is broken. See [`docs/discovery-and-kernel-skills.md`](docs/discovery-and-kernel-skills.md) for the full best-practices guide, ASCII flow diagrams, and verification steps.

package/dist/src/artifacts/browser-export.js

@@ -6,7 +6,7 @@ function stableArtifactId(artifactPath) {
     return ("aiwg:artifact:" +
         createHash("sha256").update(artifactPath).digest("hex").slice(0, 16));
 }
-function stableRecordId(recordType, artifactPath) {
+export function stableRecordId(recordType, artifactPath) {
     if (recordType === "aiwg.artifact")
         return stableArtifactId(artifactPath);
     return (recordType.replaceAll(".", ":") +
@@ -79,7 +79,7 @@ function relationshipsForEntry(entry, graph, recordTypesByPath) {
         return left.target_id.localeCompare(right.target_id);
     });
 }
-function recordTypeForEntry(entry, schemaVersion) {
+export function recordTypeForEntry(entry, schemaVersion) {
     if (schemaVersion === "v1")
         return "aiwg.artifact";
     const normalized = entry.type.toLowerCase().replace(/_/g, "-");

package/dist/src/artifacts/cli.js

@@ -228,6 +228,7 @@ function printIndexUsage() {
     console.log('  aiwg index discover "audit security" --type skill');
     console.log('  aiwg index show skill intake-wizard');
     console.log('  aiwg index show skill flow-deploy-to-production --json');
+    console.log('  aiwg index show metadata aiwg:skill:4840fa441622f676 --json');
     console.log('  aiwg index show agent aiwg-steward');
     console.log('  aiwg index export --format fortemi --graph project --out aiwg-fortemi-index.json');
     console.log('  aiwg index migrate-legacy --scope project --dry-run');
@@ -1113,13 +1114,13 @@ async function handleDiscover(args) {
     if (!phrase) {
         console.error('Error: aiwg index discover requires a search phrase');
         console.log('');
-        console.log('Usage: aiwg index discover "<phrase>" [--type <kinds>] [--limit N] [--json] [--graph <name>] [--backend local|fortemi-core]');
+        console.log('Usage: aiwg index discover "<phrase>" [--type <kinds>] [--limit N] [--json|--format json|text] [--pretty|--compact] [--graph <name>] [--backend local|fortemi-core]');
         console.log('');
         console.log('Examples:');
         console.log('  aiwg index discover "create intake"');
         console.log('  aiwg index discover "deploy production" --limit 5');
         console.log('  aiwg index discover "audit security" --type skill,agent');
-        console.log('  aiwg index discover "intake" --json');
+        console.log('  aiwg index discover "intake" --format json --pretty');
         process.exit(1);
     }
     const typeValue = parseFlagValue(flags, '--type', 'Error: --type requires a value');
@@ -1129,7 +1130,17 @@ async function handleDiscover(args) {
         .filter(Boolean);
     // K=5 default — see query-engine.ts comment (#1218 Wave A).
     const limit = parsePositiveIntegerFlag(flags, '--limit', 5, 'Error: --limit must be a positive integer');
-    const json = flags.includes('--json');
+    const format = parseFlagValue(flags, '--format', 'Error: --format requires text or json') ?? 'text';
+    if (format !== 'text' && format !== 'json') {
+        console.error('Error: --format must be text or json');
+        process.exit(1);
+    }
+    const json = flags.includes('--json') || format === 'json';
+    if (flags.includes('--pretty') && flags.includes('--compact')) {
+        console.error('Error: --pretty and --compact cannot be used together');
+        process.exit(1);
+    }
+    const jsonPretty = !flags.includes('--compact');
     const graph = parseGraphFlag(flags);
     const backend = parseSearchBackendFlag(flags);
     await discoverCapability(cwd, {
@@ -1137,8 +1148,10 @@ async function handleDiscover(args) {
         typeFilter,
         limit,
         json,
+        jsonPretty,
         graph,
         backend,
+        includePaths: false,
     });
 }
 /**
@@ -1155,7 +1168,7 @@ async function handleDiscover(args) {
  * the artifact body so consumers don't need to navigate the filesystem.
  */
 async function handleShow(args) {
-    const { showArtifact } = await import('./query-engine.js');
+    const { showArtifact, showMetadata } = await import('./query-engine.js');
     const cwd = process.cwd();
     const positional = [];
     const flags = [];
@@ -1172,6 +1185,7 @@ async function handleShow(args) {
     const HELP_TEXT = [
         '',
         'Usage: aiwg show <type> <name> [--json] [--first] [--graph <name>] [--backend local|fortemi-core]',
+        '       aiwg show metadata <id-or-name-or-path> [--json] [--first] [--graph <name>] [--backend local|fortemi-core]',
         '       aiwg index show <type> <name> ...',
         '',
         'Types: skill | agent | command | rule',
@@ -1179,16 +1193,22 @@ async function handleShow(args) {
         'Examples:',
         '  aiwg show skill intake-wizard',
         '  aiwg show skill flow-deploy-to-production --json',
+        '  aiwg show metadata aiwg:skill:4840fa441622f676 --json',
         '  aiwg show agent aiwg-steward',
         '  aiwg show command discover',
         '',
-        'Tip: use `aiwg discover "<phrase>"` first to find the right name.',
+        'Tip: use `aiwg discover "<phrase>" --json` first to find the stable id.',
     ].join('\n');
     if (positional.length === 0) {
         console.error('Error: aiwg show requires a type and name');
         console.error(HELP_TEXT);
         process.exit(1);
     }
+    const firstLower = positional[0].toLowerCase();
+    const metadataMode = firstLower === 'metadata';
+    if (metadataMode) {
+        positional.shift();
+    }
     // Wave A (#1218): if the first positional is a known type, treat it
     // as the type. If it's NOT a known type, fall through to single-name
     // mode — `aiwg show intake-wizard` works as long as the name is
@@ -1196,8 +1216,15 @@ async function handleShow(args) {
     // with the disambiguation list (existing behavior in showArtifact).
     let type = null;
     let name;
-    const firstLower = positional[0].toLowerCase();
-    if (ALLOWED_TYPES.includes(firstLower)) {
+    if (metadataMode) {
+        name = positional.join(' ').trim();
+        if (!name) {
+            console.error('Error: aiwg show metadata requires an id, name, or path');
+            console.error(HELP_TEXT);
+            process.exit(1);
+        }
+    }
+    else if (ALLOWED_TYPES.includes(firstLower)) {
         type = firstLower;
         name = positional.slice(1).join(' ').trim();
         if (!name) {
@@ -1225,13 +1252,17 @@ async function handleShow(args) {
     }
     const graph = parseGraphFlag(flags);
     const backend = parseSearchBackendFlag(flags);
-    await showArtifact(cwd, {
+    const params = {
         name,
         typeFilter: type ? [type] : undefined,
         json,
         first,
         graph,
         backend,
-    });
+    };
+    if (metadataMode)
+        await showMetadata(cwd, params);
+    else
+        await showArtifact(cwd, params);
 }
 //# sourceMappingURL=cli.js.map

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

@@ -85,7 +85,7 @@ function matchesPath(recordPath, pattern) {
     }
     return recordPath.includes(pattern);
 }
-function loadFortemiCoreExport(cwd, graph = "project") {
+export function loadFortemiCoreExport(cwd, graph = "project") {
     let status = getFortemiCoreSyncStatus(cwd, graph);
     if ((!status.optedIn || !status.built || status.stale) && graph === "framework") {
         const prebuilt = getFortemiCorePrebuiltStatus(graph);