@aiwg/cli 2026.8.15 → 2026.8.16

package/dist/src/artifacts/index-builder.js

@@ -17,30 +17,10 @@ import { DEFAULT_INDEX_EXTENSIONS, INDEX_EXTRACTOR_VERSION, INDEX_VERSION, INDEX
 import { parseCitationSidecar, citationResultToEdges, buildRefToPathMap } from './citation-parser.js';
 import { writeIndexFile, resolveIndexDir, loadGraphIndexFile } from './index-reader.js';
 import { loadManifest, writeManifest, statMatches, makeEntry } from './checksum-manifest.js';
-import { workspaceLinkedFiles } from '../smiths/context-pipeline/workspace-context.js';
 import { normalizeOperationalState } from './operational-state.js';
 import { DEFAULT_PROJECT_AIWG_DIR, resolveProjectAiwgDir, } from '../config/project-artifacts.js';
 import { normalizeStateTransferProjection } from './state-transfer.js';
-function pathContains(parent, child) {
-    const relative = path.relative(parent, child);
-    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
-}
-function toPosixPath(value) {
-    return value.split(path.sep).join('/');
-}
-function indexPathFor(cwd, fullPath, graph) {
-    if (!graph || graph === 'project') {
-        const artifactRoot = resolveProjectAiwgDir(cwd);
-        if (pathContains(artifactRoot, fullPath)) {
-            const relative = toPosixPath(path.relative(artifactRoot, fullPath));
-            return relative ? `${DEFAULT_PROJECT_AIWG_DIR}/${relative}` : DEFAULT_PROJECT_AIWG_DIR;
-        }
-    }
-    const rel = path.relative(cwd, fullPath);
-    if (!rel.startsWith('..') && !path.isAbsolute(rel))
-        return toPosixPath(rel);
-    return fullPath;
-}
+import { collectGraphIndexFiles, findArtifactFiles, indexPathFor } from './index-files.js';
 function absoluteEntryPath(cwd, entryPath, graph) {
     if ((!graph || graph === 'project') && entryPath.startsWith(`${DEFAULT_PROJECT_AIWG_DIR}/`)) {
         return path.join(resolveProjectAiwgDir(cwd), entryPath.slice(DEFAULT_PROJECT_AIWG_DIR.length + 1));
@@ -587,31 +567,6 @@ function applyMetadataSupplements(entries, supplements, cwd) {
         }
     }
 }
-/**
- * Recursively find all indexable files under a directory
- */
-function findArtifactFiles(dir, extensions = [...DEFAULT_INDEX_EXTENSIONS]) {
-    const results = [];
-    if (!fs.existsSync(dir))
-        return results;
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isSymbolicLink() && !fs.existsSync(fullPath)) {
-            continue;
-        }
-        if (entry.isDirectory()) {
-            // Skip hidden dirs and .index
-            if (entry.name.startsWith('.'))
-                continue;
-            results.push(...findArtifactFiles(fullPath, extensions));
-        }
-        else if (extensions.some(ext => entry.name.endsWith(ext))) {
-            results.push(fullPath);
-        }
-    }
-    return results;
-}
 /**
  * Build the artifact index
  */
@@ -798,24 +753,9 @@ export async function buildIndex(cwd, options = {}) {
         pruned: 0,
     };
     // Collect files from all scan directories
-    const files = [];
-    for (const dir of existingDirs) {
-        files.push(...findArtifactFiles(dir, fileExtensions));
-    }
-    // WORKSPACE.md is the root of the project context graph. Index it and its
-    // local Markdown-linked nodes without copying them into provider trees.
-    if (!scope && (!graph || graph === 'project')) {
-        const workspacePath = path.join(cwd, 'WORKSPACE.md');
-        const contextFiles = [
-            ...(fs.existsSync(workspacePath) ? [workspacePath] : []),
-            ...await workspaceLinkedFiles(cwd),
-        ];
-        for (const contextFile of contextFiles) {
-            if (fileExtensions.some((extension) => contextFile.endsWith(extension)) && !files.includes(contextFile)) {
-                files.push(contextFile);
-            }
-        }
-    }
+    const files = scope
+        ? existingDirs.flatMap(dir => findArtifactFiles(dir, fileExtensions))
+        : await collectGraphIndexFiles(cwd, graph);
     const entries = {};
     const tagIndex = {};
     const depGraph = {};

package/dist/src/artifacts/index-files.js

@@ -0,0 +1,80 @@
+/**
+ * Shared artifact source-file enumeration.
+ *
+ * Index builds and coverage reporting must use the same file set so project
+ * context files cannot inflate the indexed count beyond the reported total.
+ *
+ * @implements jmagly/aiwg#146
+ */
+import fs from 'fs';
+import path from 'path';
+import { DEFAULT_INDEX_EXTENSIONS, GRAPH_CONFIGS, resolveGraphScanDir, } from './types.js';
+import { DEFAULT_PROJECT_AIWG_DIR, resolveProjectAiwgDir, } from '../config/project-artifacts.js';
+import { workspaceLinkedFiles } from '../smiths/context-pipeline/workspace-context.js';
+function pathContains(parent, child) {
+    const relative = path.relative(parent, child);
+    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+}
+function toPosixPath(value) {
+    return value.split(path.sep).join('/');
+}
+export function indexPathFor(cwd, fullPath, graph) {
+    if (!graph || graph === 'project') {
+        const artifactRoot = resolveProjectAiwgDir(cwd);
+        if (pathContains(artifactRoot, fullPath)) {
+            const relative = toPosixPath(path.relative(artifactRoot, fullPath));
+            return relative ? `${DEFAULT_PROJECT_AIWG_DIR}/${relative}` : DEFAULT_PROJECT_AIWG_DIR;
+        }
+    }
+    const relative = path.relative(cwd, fullPath);
+    if (!relative.startsWith('..') && !path.isAbsolute(relative))
+        return toPosixPath(relative);
+    return fullPath;
+}
+/** Recursively find indexable files, excluding hidden directories such as .index. */
+export function findArtifactFiles(dir, extensions = DEFAULT_INDEX_EXTENSIONS) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isSymbolicLink() && !fs.existsSync(fullPath))
+            continue;
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith('.'))
+                continue;
+            results.push(...findArtifactFiles(fullPath, extensions));
+        }
+        else if (extensions.some(extension => entry.name.endsWith(extension))) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/** Return the exact current source-file set used by a standard graph build. */
+export async function collectGraphIndexFiles(cwd, graph) {
+    const config = graph ? GRAPH_CONFIGS[graph] : undefined;
+    const scanDirs = config
+        ? config.scanDirs.map(directory => resolveGraphScanDir(cwd, directory))
+        : [resolveProjectAiwgDir(cwd)];
+    const extensions = config?.extensions ?? [...DEFAULT_INDEX_EXTENSIONS];
+    const files = new Set();
+    for (const scanDir of scanDirs) {
+        for (const file of findArtifactFiles(scanDir, extensions))
+            files.add(file);
+    }
+    if (!graph || graph === 'project') {
+        const workspacePath = path.join(cwd, 'WORKSPACE.md');
+        const contextFiles = [
+            ...(fs.existsSync(workspacePath) ? [workspacePath] : []),
+            ...await workspaceLinkedFiles(cwd),
+        ];
+        for (const contextFile of contextFiles) {
+            if (extensions.some(extension => contextFile.endsWith(extension)))
+                files.add(contextFile);
+        }
+    }
+    return [...files];
+}
+//# sourceMappingURL=index-files.js.map

package/dist/src/artifacts/stats.js

@@ -7,40 +7,23 @@
  * @source @src/artifacts/types.ts
  * @tests @test/unit/artifacts/stats.test.ts
  */
-import fs from 'fs';
-import path from 'path';
-import { GRAPH_CONFIGS, loadUserGraphConfigs, resolveGraphScanDir } from './types.js';
+import { GRAPH_CONFIGS, loadUserGraphConfigs } from './types.js';
 import { loadIndexStats, loadGraphIndexFile } from './index-reader.js';
-/**
- * Count total indexable files under scan directories (excluding .index/)
- */
-function countArtifactFiles(cwd, graphType) {
-    const config = graphType ? GRAPH_CONFIGS[graphType] : undefined;
-    const scanDirs = config
-        ? config.scanDirs.map(d => resolveGraphScanDir(cwd, d))
-        : [resolveGraphScanDir(cwd, '.aiwg')];
-    const extensions = config?.extensions ?? ['.md', '.yaml', '.json'];
-    let count = 0;
-    function walk(dir) {
-        if (!fs.existsSync(dir))
-            return;
-        const entries = fs.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const full = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                if (entry.name.startsWith('.'))
-                    continue; // Skip .index, etc.
-                walk(full);
-            }
-            else if (extensions.some(ext => entry.name.endsWith(ext))) {
-                count++;
-            }
-        }
-    }
-    for (const dir of scanDirs) {
-        walk(dir);
-    }
-    return count;
+import { collectGraphIndexFiles, indexPathFor } from './index-files.js';
+/** Calculate coverage over the same current file set used by the index builder. */
+async function calculateCoverage(cwd, stats, graphType) {
+    const sourcePaths = new Set((await collectGraphIndexFiles(cwd, graphType))
+        .map(file => indexPathFor(cwd, file, graphType)));
+    const index = loadGraphIndexFile(cwd, 'metadata.json', graphType);
+    const indexed = index
+        ? Object.keys(index.entries).filter(entryPath => sourcePaths.has(entryPath)).length
+        : Math.min(stats.totalArtifacts, sourcePaths.size);
+    const totalFiles = sourcePaths.size;
+    return {
+        indexed,
+        totalFiles,
+        percentage: totalFiles > 0 ? Math.round((indexed / totalFiles) * 100) : 100,
+    };
 }
 /**
  * Show artifact index statistics
@@ -84,14 +67,10 @@ export async function showStats(cwd, options = {}) {
         // JSON mode: aggregate all graphs into one response
         const combined = {};
         for (const { type, stats: s } of availableGraphs) {
-            const totalFiles = countArtifactFiles(cwd, type);
+            const coverage = await calculateCoverage(cwd, s, type);
             combined[type] = {
                 ...s,
-                coverage: {
-                    indexed: s.totalArtifacts,
-                    totalFiles,
-                    percentage: totalFiles > 0 ? Math.round((s.totalArtifacts / totalFiles) * 100) : 100,
-                },
+                coverage,
             };
         }
         console.log(JSON.stringify(combined, null, 2));
@@ -108,14 +87,10 @@ export async function showStats(cwd, options = {}) {
  */
 async function renderStats(cwd, stats, options, graphType) {
     if (options.json) {
-        const totalFiles = countArtifactFiles(cwd, graphType);
+        const coverage = await calculateCoverage(cwd, stats, graphType);
         console.log(JSON.stringify({
             ...stats,
-            coverage: {
-                indexed: stats.totalArtifacts,
-                totalFiles,
-                percentage: totalFiles > 0 ? Math.round((stats.totalArtifacts / totalFiles) * 100) : 100,
-            },
+            coverage,
         }, null, 2));
         return;
     }
@@ -167,11 +142,8 @@ async function renderStats(cwd, stats, options, graphType) {
     }
     console.log('');
     // Coverage
-    const totalFiles = countArtifactFiles(cwd, graphType);
-    const coverage = totalFiles > 0
-        ? Math.round((stats.totalArtifacts / totalFiles) * 100)
-        : 100;
+    const coverage = await calculateCoverage(cwd, stats, graphType);
     console.log('Index Health:');
-    console.log(`  Coverage: ${stats.totalArtifacts}/${totalFiles} artifacts indexed (${coverage}%)`);
+    console.log(`  Coverage: ${coverage.indexed}/${coverage.totalFiles} artifacts indexed (${coverage.percentage}%)`);
 }
 //# sourceMappingURL=stats.js.map

package/package.json

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