@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/docs/audit/scan.impl.consumer.js

@@ -0,0 +1,321 @@
+import { basename, dirname, isAbsolute, join, relative, resolve } from '@vibesdotdev/filesystem/core';
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client/resolve-adapter';
+import { isJsonObject } from '@vibesdotdev/kernel/schemas/json';
+import { readTextFile } from "../../shared/text-file.js";
+import { walkGlob } from "../../utils/walk-glob.js";
+const IGNORED_SEGMENTS = new Set([
+    'node_modules',
+    'dist',
+    '.git',
+    '.vibes',
+    '.serena',
+    '.crush',
+    '.cursor',
+    '.windsurf',
+    '.gemini'
+]);
+const LOCAL_LINK_RE = /\[[^\]]+\]\(([^)]+)\)/g;
+const CODE_RE = /`([^`\n]+)`/g;
+const BUN_RUN_CODE_RE = /^bun run (?<script>[A-Za-z0-9:_-]+)$/;
+const CROSS_PACKAGE_BUN_RUN_CODE_RE = /^cd (?<directory>[A-Za-z0-9][A-Za-z0-9._-]*(?:\/[A-Za-z0-9][A-Za-z0-9._-]*)*) && bun run (?<script>[A-Za-z0-9:_-]+)$/;
+const LEGACY_PACKAGE_GROUPS = [
+    'apps',
+    'packages',
+    'libraries',
+    'premium-packages',
+    'internal-packages',
+    'tests'
+];
+const FEATURE_PATH_RE = /src\/lib\/vibes\/([a-z0-9-]+)/i;
+const REPO_ROOT_PREFIXES = ['src/', 'docs/', 'scripts/', 'infrastructure/', 'benchmarks/', 'e2e/'];
+function isIgnored(filePath) {
+    if (basename(filePath) === 'ISSUES.md')
+        return true;
+    return filePath.split('/').some((segment) => IGNORED_SEGMENTS.has(segment));
+}
+function lineAt(text, index) {
+    if (index <= 0)
+        return 1;
+    return text.slice(0, index).split('\n').length;
+}
+async function readManifest(fs, directory) {
+    const packageJsonPath = join(directory, 'package.json');
+    if (!(await fs.exists(packageJsonPath)))
+        return undefined;
+    const raw = await readTextFile(fs, packageJsonPath);
+    // SAFETY: Parsed package.json matches PackageManifest partial structure
+    return JSON.parse(raw);
+}
+/**
+ * Markdown is scanned from the workspace root, but `bun run` commands and
+ * `./subpath` entrypoint claims resolve against the package where the
+ * document lives. Using only the workspace package.json makes every
+ * package-local command look stale unless the root happens to expose the
+ * same script name.
+ */
+async function nearestManifest(fs, cwd, relativeFile) {
+    let directory = dirname(join(cwd, relativeFile));
+    while (true) {
+        const manifest = await readManifest(fs, directory);
+        if (manifest)
+            return manifest;
+        if (directory === cwd)
+            break;
+        const parent = dirname(directory);
+        if (parent === directory)
+            break;
+        directory = parent;
+    }
+    return undefined;
+}
+/**
+ * A `./plugin`-style claim inside a package doc is a public-entrypoint
+ * claim, not a filesystem claim. It is satisfied when the package's
+ * `package.json#exports` declares the subpath (exact key or `./x/*`
+ * wildcard pattern).
+ */
+function matchesPackageExport(manifest, candidate) {
+    const exportsField = manifest?.exports;
+    if (!exportsField || !isJsonObject(exportsField))
+        return false;
+    const subpath = candidate === '.' || candidate === './' ? '.' : candidate;
+    for (const key of Object.keys(exportsField)) {
+        if (key === subpath)
+            return true;
+        if (key.includes('*')) {
+            const [prefix = '', suffix = ''] = key.split('*');
+            if (subpath.length >= prefix.length + suffix.length &&
+                subpath.startsWith(prefix) &&
+                subpath.endsWith(suffix)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+const HISTORICAL_MARKER_RE = /\b(removed|deleted|retired|renamed|migrated|formerly|historical(ly)?|no longer|superseded|replaced by|used to)\b/i;
+function normalizeLinkTarget(rawTarget) {
+    const trimmed = rawTarget.trim().replace(/^<|>$/g, '');
+    const noTitle = trimmed.split(/\s+/)[0] ?? '';
+    const noFragment = noTitle.split('#')[0] ?? '';
+    const noQuery = noFragment.split('?')[0] ?? '';
+    return noQuery;
+}
+function resolveFeatureDir(relativeFile, claimOrFact) {
+    const ownMatch = relativeFile.match(FEATURE_PATH_RE);
+    if (ownMatch?.[1])
+        return `src/lib/vibes/${ownMatch[1]}`;
+    const claimMatch = claimOrFact.match(FEATURE_PATH_RE);
+    if (claimMatch?.[1])
+        return `src/lib/vibes/${claimMatch[1]}`;
+    return undefined;
+}
+function normalizeCodeCandidate(rawCandidate) {
+    const trimmed = rawCandidate.trim();
+    const withoutLineRef = trimmed.replace(/:(\d+)([-:]\d+)?$/, '');
+    const withoutAnchor = withoutLineRef.split('#')[0] ?? '';
+    return withoutAnchor.replace(/[),.;]+$/, '');
+}
+function shouldCheckCodeCandidate(candidate) {
+    if (!candidate || candidate.includes(' '))
+        return false;
+    if (candidate.startsWith('http://') || candidate.startsWith('https://') || candidate.startsWith('mailto:'))
+        return false;
+    if (candidate.startsWith('#') || candidate.startsWith('~'))
+        return false;
+    if (candidate.includes('*') || candidate.includes('{') || candidate.includes('}') || candidate.includes('('))
+        return false;
+    if (candidate.startsWith('$env'))
+        return false;
+    if (candidate.startsWith('.') && !candidate.startsWith('./') && !candidate.startsWith('../'))
+        return false;
+    const hasSlash = candidate.includes('/');
+    const startsRelative = candidate.startsWith('./') || candidate.startsWith('../');
+    const startsRepoRoot = REPO_ROOT_PREFIXES.some((prefix) => candidate.startsWith(prefix));
+    const startsRootAbsolute = candidate.startsWith('/src/') || candidate.startsWith('/docs/');
+    const hasKnownExtension = /\.(md|ts|tsx|js|jsx|svelte|json|yaml|yml|toml|sql)$/i.test(candidate.replace(/\/$/, ''));
+    if (!hasSlash && !startsRelative && !startsRepoRoot && !startsRootAbsolute)
+        return false;
+    return hasKnownExtension || startsRelative || startsRepoRoot || startsRootAbsolute;
+}
+async function parseBunRunCodeSpan(fs, cwd, localManifest, rawCode) {
+    const bareMatch = BUN_RUN_CODE_RE.exec(rawCode);
+    if (bareMatch?.groups?.script) {
+        return { command: rawCode, scriptName: bareMatch.groups.script, manifest: localManifest };
+    }
+    const crossPackageMatch = CROSS_PACKAGE_BUN_RUN_CODE_RE.exec(rawCode);
+    if (!crossPackageMatch?.groups?.directory || !crossPackageMatch.groups.script)
+        return undefined;
+    const directory = crossPackageMatch.groups.directory;
+    const literalTarget = resolve(cwd, directory);
+    const relativeTarget = relative(cwd, literalTarget);
+    if (relativeTarget.startsWith('..') || isAbsolute(relativeTarget)) {
+        return {
+            command: rawCode,
+            scriptName: crossPackageMatch.groups.script
+        };
+    }
+    // Split repositories place package owners directly at the repository root.
+    // During migration, documentation can still target a legacy grouped layout.
+    // Resolve the literal flat target first, then the historical groups; never
+    // make the pre-split grouped directory shape the canonical interpretation.
+    const candidates = [
+        literalTarget,
+        ...(directory.includes('/')
+            ? []
+            : LEGACY_PACKAGE_GROUPS.map((group) => join(cwd, group, directory)))
+    ];
+    let manifest;
+    for (const candidate of candidates) {
+        manifest = await readManifest(fs, candidate);
+        if (manifest !== undefined)
+            break;
+    }
+    return {
+        command: rawCode,
+        scriptName: crossPackageMatch.groups.script,
+        manifest
+    };
+}
+function resolveCandidates(cwd, fileDir, candidate) {
+    if (candidate.startsWith('$lib/')) {
+        return [join(cwd, 'src/lib', candidate.slice('$lib/'.length))];
+    }
+    if (candidate.startsWith('/src/') || candidate.startsWith('/docs/')) {
+        return [join(cwd, candidate.slice(1))];
+    }
+    return [resolve(fileDir, candidate), join(cwd, candidate)];
+}
+export async function scanMarkdown(cwd, fs) {
+    const files = [];
+    const findings = [];
+    const findingKeys = new Set();
+    for (const relativeFile of await walkGlob(fs, '**/*.md', { cwd, onlyFiles: true })) {
+        if (isIgnored(relativeFile))
+            continue;
+        files.push(relativeFile);
+        const absoluteFile = join(cwd, relativeFile);
+        const content = await readTextFile(fs, absoluteFile);
+        const fileDir = dirname(absoluteFile);
+        const manifest = await nearestManifest(fs, cwd, relativeFile);
+        const contentLines = content.split('\n');
+        const addFinding = (finding) => {
+            const key = `${finding.file}|${finding.line}|${finding.claim}`;
+            if (findingKeys.has(key))
+                return;
+            findingKeys.add(key);
+            findings.push(finding);
+        };
+        for (const match of content.matchAll(LOCAL_LINK_RE)) {
+            const rawTarget = match[1] ?? '';
+            const target = normalizeLinkTarget(rawTarget);
+            if (!target)
+                continue;
+            if (target.startsWith('http://') || target.startsWith('https://') || target.startsWith('mailto:'))
+                continue;
+            const resolved = target.startsWith('/src/') || target.startsWith('/docs/')
+                ? join(cwd, target.slice(1))
+                : resolve(fileDir, target);
+            if (await fs.exists(resolved))
+                continue;
+            const line = lineAt(content, match.index ?? 0);
+            const historical = HISTORICAL_MARKER_RE.test(contentLines[line - 1] ?? '');
+            addFinding({
+                file: relativeFile,
+                line,
+                kind: historical ? 'doc-stale' : relativeFile.endsWith('SPEC.md') ? 'likely-code-bug' : 'doc-stale',
+                claim: `Local markdown link points to \`${target}\`.`,
+                observed: historical
+                    ? `Resolved path not found: \`${relative(cwd, resolved)}\` — surrounding prose reads as a historical/migration reference.`
+                    : `Resolved path not found: \`${relative(cwd, resolved)}\`.`,
+                suggestedAction: historical
+                    ? 'Historical reference: keep as context (use a code literal instead of a link); do not restore the artifact.'
+                    : 'Update the link target or create/move the referenced file.',
+                featureDir: resolveFeatureDir(relativeFile, target),
+                claimType: historical ? 'historical' : 'artifact'
+            });
+        }
+        for (const match of content.matchAll(CODE_RE)) {
+            const rawCode = (match[1] ?? '').trim();
+            const bunRun = await parseBunRunCodeSpan(fs, cwd, manifest, rawCode);
+            if (bunRun) {
+                const explicitTarget = CROSS_PACKAGE_BUN_RUN_CODE_RE.exec(bunRun.command)?.groups?.directory;
+                if (Object.hasOwn(bunRun.manifest?.scripts ?? {}, bunRun.scriptName))
+                    continue;
+                addFinding({
+                    file: relativeFile,
+                    line: lineAt(content, match.index ?? 0),
+                    kind: 'doc-stale',
+                    claim: `Documented script command uses \`${bunRun.command}\`.`,
+                    observed: bunRun.manifest
+                        ? `No \`${bunRun.scriptName}\` script in \`${explicitTarget ? `${explicitTarget}/package.json` : 'package.json'}\`.`
+                        : explicitTarget
+                            ? `Explicit target \`${explicitTarget}\` has no package.json.`
+                            : 'No package.json was resolved for the document.',
+                    suggestedAction: 'Update command examples or add a matching script.',
+                    featureDir: resolveFeatureDir(relativeFile, bunRun.scriptName)
+                });
+                continue;
+            }
+            const candidate = normalizeCodeCandidate(rawCode);
+            if (!shouldCheckCodeCandidate(candidate))
+                continue;
+            const resolvedCandidates = resolveCandidates(cwd, fileDir, candidate);
+            let candidateFound = false;
+            for (const val of resolvedCandidates) {
+                if (await fs.exists(val)) {
+                    candidateFound = true;
+                    break;
+                }
+            }
+            if (candidateFound)
+                continue;
+            if (candidate.startsWith('./') && matchesPackageExport(manifest, candidate))
+                continue;
+            const line = lineAt(content, match.index ?? 0);
+            const historical = HISTORICAL_MARKER_RE.test(contentLines[line - 1] ?? '');
+            const entrypointClaim = !historical && candidate.startsWith('./') && manifest?.exports !== undefined;
+            addFinding({
+                file: relativeFile,
+                line,
+                kind: historical ? 'doc-stale' : relativeFile.endsWith('SPEC.md') ? 'likely-code-bug' : 'doc-stale',
+                claim: entrypointClaim
+                    ? `Package entrypoint reference \`${candidate}\` is documented as existing.`
+                    : `Code path reference \`${candidate}\` is documented as existing.`,
+                observed: historical
+                    ? 'No matching file exists — surrounding prose reads as a historical/migration reference.'
+                    : entrypointClaim
+                        ? 'No matching file exists and package.json#exports declares no such subpath.'
+                        : 'No matching file exists in the workspace.',
+                suggestedAction: historical
+                    ? 'Historical reference: keep as context; do not restore the artifact.'
+                    : entrypointClaim
+                        ? 'Correct the subpath or declare it in package.json#exports.'
+                        : 'Correct the path or restore the referenced code artifact.',
+                featureDir: resolveFeatureDir(relativeFile, candidate),
+                claimType: historical ? 'historical' : entrypointClaim ? 'package-entrypoint' : 'artifact'
+            });
+        }
+        if (relativeFile.startsWith('docs/vibes/')) {
+            const featureHint = relativeFile.replace(/^docs\/vibes\//, '').split('/')[0] ?? '';
+            addFinding({
+                file: relativeFile,
+                line: 1,
+                kind: 'doc-structure',
+                claim: 'Feature-specific documentation is stored under `docs/vibes/`.',
+                observed: 'Feature docs policy requires docs next to feature code.',
+                suggestedAction: 'Move implementation-specific sections to `src/lib/vibes/<feature>/README.md` and leave process context in docs/.',
+                featureDir: featureHint ? `src/lib/vibes/${featureHint}` : undefined
+            });
+        }
+    }
+    return { files, findings };
+}
+export default {
+    async execute(input = {}, runtime) {
+        const fs = await resolveFileSystemAdapter(runtime);
+        const workspacePath = await runtime.context('runtime/workspace-path');
+        return scanMarkdown(resolve(input.cwd ?? workspacePath), fs);
+    }
+};
+//# sourceMappingURL=scan.impl.consumer.js.map

package/dist/docs/audit/scan.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.impl.consumer.js","sourceRoot":"","sources":["../../../src/docs/audit/scan.impl.consumer.ts"],"names":[],"mappings":"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"}

package/dist/docs/audit/schemas/index.d.ts

@@ -0,0 +1,27 @@
+export type GapType = 'doc-stale' | 'doc-structure' | 'likely-code-bug';
+/**
+ * What kind of claim the finding is about.
+ * - `artifact` — a file-relative path claim (default when omitted).
+ * - `package-entrypoint` — a `./subpath` claim inside a package doc that
+ *   should resolve against that package's `package.json#exports`.
+ * - `historical` — a reference in migration/removal prose; reported as
+ *   context, never as a missing artifact.
+ */
+export type ClaimType = 'artifact' | 'package-entrypoint' | 'historical';
+export interface AuditFinding {
+    file: string;
+    line: number;
+    kind: GapType;
+    claim: string;
+    observed: string;
+    suggestedAction: string;
+    featureDir?: string;
+    claimType?: ClaimType;
+}
+export interface AuditSummary {
+    scannedFiles: number;
+    findings: number;
+    byKind: Record<GapType, number>;
+    featureDirectories: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/docs/audit/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/docs/audit/schemas/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/docs/audit/schemas/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/docs/audit/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/docs/audit/schemas/index.ts"],"names":[],"mappings":""}

package/dist/docs/audit/schemas/types.d.ts

@@ -0,0 +1,13 @@
+import type { JsonObject, JsonValue } from '@vibesdotdev/kernel/schemas/json';
+export interface ExamplePair {
+    input: JsonObject;
+    output?: JsonValue;
+    description?: string;
+}
+export interface AuditResult {
+    toolId: string;
+    examples: ExamplePair[];
+    coverage: number;
+    issues: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/docs/audit/schemas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/docs/audit/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/docs/audit/schemas/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/docs/audit/schemas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/docs/audit/schemas/types.ts"],"names":[],"mappings":""}

package/dist/docs/audit/write-issues.impl.consumer.d.ts

@@ -0,0 +1,13 @@
+import type { FileSystemAdapterInterface } from '@vibesdotdev/filesystem';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { AuditFinding, AuditSummary } from './schemas/index.ts';
+export declare function writeIssueFiles(cwd: string, scannedFiles: number, findings: AuditFinding[], fs: FileSystemAdapterInterface): Promise<AuditSummary>;
+declare const _default: {
+    execute(input: {
+        cwd?: string;
+        scannedFiles: number;
+        findings: AuditFinding[];
+    }, runtime: VibesRuntime): Promise<AuditSummary>;
+};
+export default _default;
+//# sourceMappingURL=write-issues.impl.consumer.d.ts.map

package/dist/docs/audit/write-issues.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-issues.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/docs/audit/write-issues.impl.consumer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAW,MAAM,oBAAoB,CAAC;AA6E9E,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EAAE,EACxB,EAAE,EAAE,0BAA0B,GAC5B,OAAO,CAAC,YAAY,CAAC,CAcvB;;mBAGqB;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;KACzB,WAAW,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;;AALjD,wBAeE"}

package/dist/docs/audit/write-issues.impl.consumer.js

@@ -0,0 +1,97 @@
+import { dirname, join, resolve } from '@vibesdotdev/filesystem/core';
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client/resolve-adapter';
+import { readTextFile } from "../../shared/text-file.js";
+const START_MARKER = '<!-- DOC_AUDIT_START -->';
+const END_MARKER = '<!-- DOC_AUDIT_END -->';
+function groupByFeature(findings) {
+    const grouped = new Map();
+    for (const finding of findings) {
+        const key = finding.featureDir;
+        if (!key)
+            continue;
+        const items = grouped.get(key) ?? [];
+        items.push(finding);
+        grouped.set(key, items);
+    }
+    return grouped;
+}
+function escapeCell(value) {
+    return value.replaceAll('\n', ' ').replaceAll('|', '\\|');
+}
+function renderSection(featureDir, findings) {
+    const date = new Date().toISOString();
+    const lines = [];
+    lines.push(START_MARKER);
+    lines.push('## Documentation Reality Check');
+    lines.push('');
+    lines.push(`Generated: ${date}`);
+    lines.push(`Feature: \`${featureDir}\``);
+    lines.push('');
+    lines.push('| File | Line | Gap Type | Claim | Observed Fact | Suggested Action |');
+    lines.push('| --- | ---: | --- | --- | --- | --- |');
+    for (const finding of findings) {
+        lines.push(`| \`${escapeCell(finding.file)}\` | ${finding.line} | \`${finding.kind}\` | ${escapeCell(finding.claim)} | ${escapeCell(finding.observed)} | ${escapeCell(finding.suggestedAction)} |`);
+    }
+    lines.push('');
+    lines.push(END_MARKER);
+    lines.push('');
+    return lines.join('\n');
+}
+function upsertGeneratedBlock(existing, generated) {
+    const start = existing.indexOf(START_MARKER);
+    const end = existing.indexOf(END_MARKER);
+    if (start >= 0 && end > start) {
+        const before = existing.slice(0, start).trimEnd();
+        const after = existing.slice(end + END_MARKER.length).trimStart();
+        const pieces = [before, generated.trim(), after].filter((item) => item.length > 0);
+        return `${pieces.join('\n\n')}\n`;
+    }
+    const prefix = existing.trimEnd();
+    if (!prefix)
+        return generated;
+    return `${prefix}\n\n${generated}`;
+}
+async function ensureHeaderIfNew(fs, issuePath) {
+    if (await fs.exists(issuePath))
+        return readTextFile(fs, issuePath);
+    return '# ISSUES\n\nGaps identified during documentation-to-code reconciliation.\n';
+}
+function toSummary(findings, featureCount, scannedFiles) {
+    const byKind = {
+        'doc-stale': 0,
+        'doc-structure': 0,
+        'likely-code-bug': 0
+    };
+    for (const finding of findings)
+        byKind[finding.kind] += 1;
+    return {
+        scannedFiles,
+        findings: findings.length,
+        byKind,
+        featureDirectories: featureCount
+    };
+}
+export async function writeIssueFiles(cwd, scannedFiles, findings, fs) {
+    const grouped = groupByFeature(findings);
+    for (const [featureDir, featureFindings] of grouped.entries()) {
+        const resolvedDir = join(cwd, featureDir);
+        if (!(await fs.exists(resolvedDir)))
+            continue;
+        const issuePath = join(resolvedDir, 'ISSUES.md');
+        const sorted = [...featureFindings].sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+        const generated = renderSection(featureDir, sorted);
+        const existing = await ensureHeaderIfNew(fs, issuePath);
+        const next = upsertGeneratedBlock(existing, generated);
+        await fs.mkdir(dirname(issuePath), { recursive: true });
+        await fs.writeFile(issuePath, next, 'utf-8');
+    }
+    return toSummary(findings, grouped.size, scannedFiles);
+}
+export default {
+    async execute(input, runtime) {
+        const fs = await resolveFileSystemAdapter(runtime);
+        const workspacePath = await runtime.context('runtime/workspace-path');
+        return writeIssueFiles(resolve(input.cwd ?? workspacePath), input.scannedFiles, input.findings, fs);
+    }
+};
+//# sourceMappingURL=write-issues.impl.consumer.js.map

package/dist/docs/audit/write-issues.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-issues.impl.consumer.js","sourceRoot":"","sources":["../../../src/docs/audit/write-issues.impl.consumer.ts"],"names":[],"mappings":"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"}

package/dist/docs/authoring.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=authoring.docs.descriptor.d.ts.map

package/dist/docs/authoring.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/authoring.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA4JvE,QAAA,MAAM,UAAU,EAAE,mBAgBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}