jamdesk 1.1.149 → 1.1.151

package/dist/__tests__/unit/frontmatter-write.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { setFrontmatterField } from '../../lib/frontmatter-write.js';
+describe('setFrontmatterField', () => {
+    it('adds a description to existing frontmatter, body intact', () => {
+        const src = '---\ntitle: Setup\n---\n\n## Introduction\n';
+        const out = setFrontmatterField(src, 'description', 'A concise summary.');
+        expect(out).toMatch(/title: Setup/);
+        expect(out).toMatch(/description: A concise summary\./);
+        expect(out).toMatch(/## Introduction/);
+    });
+    it('creates frontmatter when none exists', () => {
+        const out = setFrontmatterField('# Hello\n', 'description', 'Hi');
+        expect(out.startsWith('---\n')).toBe(true);
+        expect(out).toMatch(/description: Hi/);
+        expect(out).toMatch(/# Hello/);
+    });
+    it('does not corrupt a body that contains its own --- divider', () => {
+        const src = '---\ntitle: Setup\n---\n\nIntro\n\n---\n\nMore prose\n';
+        const out = setFrontmatterField(src, 'description', 'A summary.');
+        expect(out).toMatch(/description: A summary\./);
+        // both the intro and the post-divider prose survive
+        expect(out).toMatch(/Intro/);
+        expect(out).toMatch(/More prose/);
+    });
+    it('round-trips an all-frontmatter source with an empty body', () => {
+        const out = setFrontmatterField('---\ntitle: Setup\n---\n', 'description', 'A summary.');
+        expect(out).toMatch(/title: Setup/);
+        expect(out).toMatch(/description: A summary\./);
+    });
+});
+//# sourceMappingURL=frontmatter-write.test.js.map

package/dist/__tests__/unit/frontmatter-write.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-write.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/frontmatter-write.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAAG,6CAA6C,CAAC;QAC1D,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC;QAC1E,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,mBAAmB,CAAC,WAAW,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,wDAAwD,CAAC;QACrE,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAChD,oDAAoD;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,mBAAmB,CAAC,0BAA0B,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/unit/heading-extractor-sync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=heading-extractor-sync.test.d.ts.map

package/dist/__tests__/unit/heading-extractor-sync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-extractor-sync.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/heading-extractor-sync.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/heading-extractor-sync.test.js

@@ -0,0 +1,16 @@
+// builder/cli/src/__tests__/unit/heading-extractor-sync.test.ts
+import { describe, it, expect } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const stripHeader = (s) => s.replace(/^\/\*\*[\s\S]*?\*\/\s*\n/, '');
+describe('heading-extractor sync', () => {
+    it('CLI body matches build-service canonical (excluding header)', () => {
+        const cli = stripHeader(fs.readFileSync(path.resolve(__dirname, '../../lib/heading-extractor.ts'), 'utf-8'));
+        const canonical = stripHeader(fs.readFileSync(path.resolve(__dirname, '../../../../build-service/lib/heading-extractor.ts'), 'utf-8'));
+        expect(cli).not.toBe('');
+        expect(cli).toBe(canonical);
+    });
+});
+//# sourceMappingURL=heading-extractor-sync.test.js.map

package/dist/__tests__/unit/heading-extractor-sync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-extractor-sync.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/heading-extractor-sync.test.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;AAE7E,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gCAAgC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7G,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oDAAoD,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACvI,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/unit/missing-description-scan.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=missing-description-scan.test.d.ts.map

package/dist/__tests__/unit/missing-description-scan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-description-scan.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/missing-description-scan.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/missing-description-scan.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect } from 'vitest';
+import { scanMissingDescriptions } from '../../lib/missing-description-scan.js';
+const pages = {
+    'setup': '---\ntitle: Setup\n---\n\nInstall the CLI and run it.\n',
+    'about': '---\ntitle: About\ndescription: Already has one\n---\n\nBody.\n',
+};
+const readPage = (p) => pages[p] ?? null;
+describe('scanMissingDescriptions', () => {
+    it('returns only pages missing a description, with title + body text', () => {
+        const out = scanMissingDescriptions(['setup', 'about'], readPage);
+        expect(out).toHaveLength(1);
+        expect(out[0].file).toBe('setup.mdx');
+        expect(out[0].title).toBe('Setup');
+        expect(out[0].pageText).toContain('Install the CLI');
+    });
+    it('skips unreadable pages', () => {
+        expect(scanMissingDescriptions(['missing'], readPage)).toEqual([]);
+    });
+    it('treats a whitespace-only description as missing', () => {
+        const read = (p) => (p === 'blank' ? '---\ntitle: Blank\ndescription: "   "\n---\n\nBody.\n' : null);
+        const out = scanMissingDescriptions(['blank'], read);
+        expect(out).toHaveLength(1);
+        expect(out[0].file).toBe('blank.mdx');
+    });
+    it('falls back to the first H1 when frontmatter has no title', () => {
+        const read = (p) => (p === 'guide' ? '# Getting Started\n\nWelcome.\n' : null);
+        const out = scanMissingDescriptions(['guide'], read);
+        expect(out[0].title).toBe('Getting Started');
+    });
+    it('falls back to the slug (last path segment) when there is no title or H1', () => {
+        const read = (p) => (p === 'docs/nested/page' ? 'Just prose, no heading.\n' : null);
+        const out = scanMissingDescriptions(['docs/nested/page'], read);
+        expect(out[0].title).toBe('page');
+    });
+    it('emits the resolver-supplied on-disk path for a dir-index page', () => {
+        // "api" is backed by api/index.mdx, so the write target must be that real file,
+        // not a fabricated api.mdx (which would crash the description write with ENOENT).
+        const read = (p) => (p === 'api' ? '---\ntitle: API\n---\n\nReference.\n' : null);
+        const resolveFile = (p) => (p === 'api' ? 'api/index.mdx' : null);
+        const out = scanMissingDescriptions(['api'], read, resolveFile);
+        expect(out).toHaveLength(1);
+        expect(out[0].file).toBe('api/index.mdx');
+    });
+    it('skips a page the resolver cannot place on disk', () => {
+        const read = (p) => (p === 'ghost' ? '---\ntitle: Ghost\n---\n\nBody.\n' : null);
+        const resolveFile = () => null;
+        expect(scanMissingDescriptions(['ghost'], read, resolveFile)).toEqual([]);
+    });
+});
+//# sourceMappingURL=missing-description-scan.test.js.map

package/dist/__tests__/unit/missing-description-scan.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-description-scan.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/missing-description-scan.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/fix.d.ts

@@ -0,0 +1,97 @@
+import { type FixWarning, type FixResult, type LocaleInfo, type EngineHeading } from '../lib/fix-engine.js';
+import { type MissingDescription } from '../lib/missing-description-scan.js';
+import { type AiFixRequest, type AiFixResponse } from '../lib/ai-fix-client.js';
+export interface AiAnchorMeta {
+    warning: FixWarning;
+    targetPage: string;
+    linkPath: string;
+    fragment: string;
+}
+export declare function buildAiRequest(input: {
+    skipped: Array<{
+        warning: FixWarning;
+        reason: string;
+    }>;
+    missing: MissingDescription[];
+    headingsOf: (p: string) => EngineHeading[] | null;
+    resolveTarget: (href: string) => string | null;
+}): {
+    request: AiFixRequest;
+    anchorMeta: AiAnchorMeta[];
+};
+export declare function anchorEditsFromResponse(resp: AiFixResponse, anchorMeta: AiAnchorMeta[], headingsOf: (p: string) => EngineHeading[] | null): FixPlan['fixed'];
+/** Remove from `skipped` any entry whose warning the AI resolved. Object-reference
+ *  equality holds: anchorMeta carries the same `warning` object that came from
+ *  plan.skipped, so an AI-fixed warning is never double-counted (fixed AND skipped). */
+export declare function dropResolvedSkips(skipped: FixPlan['skipped'], resolved: FixPlan['fixed']): FixPlan['skipped'];
+export interface DescriptionWrite {
+    index: number;
+    text: string;
+    file: string;
+}
+/** Decide which AI descriptions to surface for confirmation. PURE so the safety
+ *  rules are provable without driving the interactive shell. Note there is NO
+ *  `yes` parameter: --yes CANNOT bypass the description confirm by construction —
+ *  an AI-written description is a content judgement that always needs a human y/N.
+ *  - filters to descriptions with text AND a matching `missing` page
+ *  - caps at `cap` per run (`overflow` = how many were deferred to a later run)
+ *  - `skippedNoTty`: in a non-TTY run (CI/pipe) `confirm` can't read a keypress, so
+ *    the caller skips writing entirely rather than auto-write or hang. Dry-run is
+ *    NOT a skip — it still lists proposals (the caller just doesn't write). */
+export declare function planDescriptionWrites(input: {
+    descriptions: AiFixResponse['descriptions'];
+    missing: MissingDescription[];
+    cap: number;
+    isTTY: boolean;
+    dryRun: boolean;
+}): {
+    toReview: DescriptionWrite[];
+    overflow: number;
+    skippedNoTty: boolean;
+};
+export interface FixPlan {
+    fixed: Array<{
+        warning: FixWarning;
+        edits: FixResult['edits'];
+    }>;
+    skipped: Array<{
+        warning: FixWarning;
+        reason: string;
+    }>;
+}
+interface PlanDeps {
+    hostAtDocs: boolean;
+    locales: LocaleInfo;
+    headingsOf: (pagePath: string) => EngineHeading[] | null;
+    pageExists: (pagePath: string) => boolean;
+}
+/** Pure: turn warnings into a fix plan. No filesystem writes. */
+export declare function planFixes(warnings: FixWarning[], deps: PlanDeps): FixPlan;
+export interface FileIO {
+    readFile: (absPath: string) => string;
+    writeFile: (absPath: string, content: string) => void;
+}
+export interface ApplyOutcome {
+    written: string[];
+    failed: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+/**
+ * Apply a fix plan to files. Groups edits by file; a file whose source no longer
+ * matches an edit (changed since the scan) is recorded as failed and skipped —
+ * the others are still written. NEVER writes a partial/wrong edit. Pure except
+ * for the injected FileIO, so the failure mode is unit-testable without disk.
+ */
+export declare function applyPlanToFiles(plan: FixPlan, projectDir: string, io: FileIO): ApplyOutcome;
+export interface FixOptions {
+    dryRun: boolean;
+    yes: boolean;
+    types?: string[];
+    noAi: boolean;
+    project?: string;
+}
+export declare function runFix(options: FixOptions): Promise<void>;
+export {};
+//# sourceMappingURL=fix.d.ts.map

package/dist/commands/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/commands/fix.ts"],"names":[],"mappings":"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"}

package/dist/commands/fix.js

@@ -0,0 +1,348 @@
+// builder/cli/src/commands/fix.ts
+import fs from 'fs-extra';
+import path from 'path';
+import { execFileSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import { output } from '../lib/output.js';
+import { spinner } from '../lib/spinner.js';
+import { loadDocsConfig, getAllPagePaths } from '../lib/docs-config.js';
+import { extractHeadings } from '../lib/heading-extractor.js';
+import { runFixer, applyEdits, normalizeLinkPath, parseHref, isRealAnchor, NEEDS_AI_MARKER, } from '../lib/fix-engine.js';
+import { scanMissingDescriptions } from '../lib/missing-description-scan.js';
+import { setFrontmatterField } from '../lib/frontmatter-write.js';
+import { requestAiFixes } from '../lib/ai-fix-client.js';
+// The engine tags AI-deferrable skips by appending NEEDS_AI_MARKER (imported from
+// fix-engine) to the skip reason — we match on it as a substring so the engine and the
+// CLI can never drift on the exact marker text.
+// Per-run cap on AI descriptions surfaced for confirmation. Bounds review fatigue and
+// cost on a first run over a large docs set; the rest are picked up on the next run.
+const DESC_WRITE_CAP = 25;
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function buildAiRequest(input) {
+    const anchorMeta = [];
+    const anchors = [];
+    for (const s of input.skipped) {
+        if (s.warning.type !== 'broken_link' || !s.reason.includes(NEEDS_AI_MARKER))
+            continue;
+        // An anchor edit needs a line to place; a null-line warning can't be safely
+        // edited (mirrors the guard in collectAiAnchorSuggestions). Unreachable today —
+        // the engine emits a distinct null-line skip reason that never carries NEEDS_AI —
+        // but kept for defense-in-depth symmetry so a future engine change can't slip a
+        // `line: null as number` edit through applyEdits.
+        if (s.warning.line == null)
+            continue;
+        const { path: linkPath, fragment } = parseHref(s.warning.link);
+        if (!linkPath || !fragment)
+            continue;
+        const targetPage = input.resolveTarget(s.warning.link);
+        if (!targetPage)
+            continue;
+        const headings = input.headingsOf(targetPage);
+        if (!headings || headings.length === 0)
+            continue;
+        anchors.push({ brokenFragment: fragment, targetHeadingIds: headings.map((h) => h.id) });
+        anchorMeta.push({ warning: s.warning, targetPage, linkPath, fragment });
+    }
+    const descriptions = input.missing.map((m) => ({ title: m.title, pageText: m.pageText }));
+    return { request: { projectId: '', anchors, descriptions }, anchorMeta };
+}
+export function anchorEditsFromResponse(resp, anchorMeta, headingsOf) {
+    const fixed = [];
+    for (const a of resp.anchors) {
+        const meta = anchorMeta[a.index];
+        if (!a.id || !meta)
+            continue;
+        const headings = headingsOf(meta.targetPage);
+        if (!headings || !isRealAnchor(a.id, headings))
+            continue; // hallucination guard
+        fixed.push({ warning: meta.warning, edits: [{ file: meta.warning.file, line: meta.warning.line, oldText: meta.warning.link, newText: `${meta.linkPath}#${a.id}` }] });
+    }
+    return fixed;
+}
+/** Remove from `skipped` any entry whose warning the AI resolved. Object-reference
+ *  equality holds: anchorMeta carries the same `warning` object that came from
+ *  plan.skipped, so an AI-fixed warning is never double-counted (fixed AND skipped). */
+export function dropResolvedSkips(skipped, resolved) {
+    const resolvedWarnings = new Set(resolved.map((f) => f.warning));
+    return skipped.filter((s) => !resolvedWarnings.has(s.warning));
+}
+/** Decide which AI descriptions to surface for confirmation. PURE so the safety
+ *  rules are provable without driving the interactive shell. Note there is NO
+ *  `yes` parameter: --yes CANNOT bypass the description confirm by construction —
+ *  an AI-written description is a content judgement that always needs a human y/N.
+ *  - filters to descriptions with text AND a matching `missing` page
+ *  - caps at `cap` per run (`overflow` = how many were deferred to a later run)
+ *  - `skippedNoTty`: in a non-TTY run (CI/pipe) `confirm` can't read a keypress, so
+ *    the caller skips writing entirely rather than auto-write or hang. Dry-run is
+ *    NOT a skip — it still lists proposals (the caller just doesn't write). */
+export function planDescriptionWrites(input) {
+    const writable = [];
+    for (const d of input.descriptions) {
+        const m = input.missing[d.index];
+        if (d.text && m)
+            writable.push({ index: d.index, text: d.text, file: m.file });
+    }
+    const toReview = writable.slice(0, input.cap);
+    const overflow = writable.length - toReview.length;
+    const skippedNoTty = toReview.length > 0 && !input.dryRun && !input.isTTY;
+    return { toReview: skippedNoTty ? [] : toReview, overflow, skippedNoTty };
+}
+/** Pure: turn warnings into a fix plan. No filesystem writes. */
+export function planFixes(warnings, deps) {
+    const plan = { fixed: [], skipped: [] };
+    for (const w of warnings) {
+        const result = runFixer(w, {
+            currentPagePath: w.file.replace(/\.mdx$/, ''),
+            locales: deps.locales,
+            resolveLinkPagePath: (href) => {
+                const linkPath = parseHref(href).path;
+                if (!linkPath)
+                    return null;
+                const p = normalizeLinkPath(linkPath, deps.hostAtDocs);
+                return deps.pageExists(p) ? p : null;
+            },
+            headingsOf: deps.headingsOf,
+        });
+        if (result.status === 'fixed')
+            plan.fixed.push({ warning: w, edits: result.edits });
+        else
+            plan.skipped.push({ warning: w, reason: result.reason });
+    }
+    return plan;
+}
+/**
+ * Apply a fix plan to files. Groups edits by file; a file whose source no longer
+ * matches an edit (changed since the scan) is recorded as failed and skipped —
+ * the others are still written. NEVER writes a partial/wrong edit. Pure except
+ * for the injected FileIO, so the failure mode is unit-testable without disk.
+ */
+export function applyPlanToFiles(plan, projectDir, io) {
+    const byFile = new Map();
+    for (const f of plan.fixed) {
+        const list = byFile.get(f.warning.file);
+        if (list)
+            list.push(...f.edits);
+        else
+            byFile.set(f.warning.file, [...f.edits]);
+    }
+    const outcome = { written: [], failed: [] };
+    for (const [file, edits] of byFile) {
+        const abs = path.join(projectDir, file);
+        try {
+            io.writeFile(abs, applyEdits(io.readFile(abs), edits));
+            outcome.written.push(file);
+        }
+        catch (err) {
+            outcome.failed.push({ file, error: err.message });
+        }
+    }
+    return outcome;
+}
+function localesFromConfig(config) {
+    const nav = (config.navigation ?? {});
+    const langs = nav.languages ?? [];
+    if (langs.length === 0)
+        return { codes: [], defaultCode: '' };
+    const def = langs.find((l) => l.default) ?? langs[0];
+    return { codes: langs.map((l) => l.language), defaultCode: def.language };
+}
+function readPageFactory(projectDir) {
+    // Memoize across the whole runFix invocation: pageExists + headingsOf both call
+    // this, and many warnings can target the same page — without the cache each page
+    // is re-read (and re-parsed) once per warning that links to it.
+    const cache = new Map();
+    return (pagePath) => {
+        if (cache.has(pagePath))
+            return cache.get(pagePath);
+        let result = null;
+        const mdx = path.join(projectDir, pagePath + '.mdx');
+        if (fs.existsSync(mdx))
+            result = fs.readFileSync(mdx, 'utf-8');
+        else {
+            const idx = path.join(projectDir, pagePath, 'index.mdx');
+            if (fs.existsSync(idx))
+                result = fs.readFileSync(idx, 'utf-8');
+        }
+        cache.set(pagePath, result);
+        return result;
+    };
+}
+// Resolve a nav page key to its actual on-disk relative path, mirroring
+// readPageFactory's mdx-then-index lookup. Used as the write target for AI
+// descriptions so a dir-index page ("api" → "api/index.mdx") is edited in place
+// instead of fabricating a stray "api.mdx".
+function resolvePageFile(projectDir, pagePath) {
+    if (fs.existsSync(path.join(projectDir, `${pagePath}.mdx`)))
+        return `${pagePath}.mdx`;
+    if (fs.existsSync(path.join(projectDir, pagePath, 'index.mdx')))
+        return `${pagePath}/index.mdx`;
+    return null;
+}
+async function confirm(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((res) => rl.question(`${question} (y/N) `, res));
+    rl.close();
+    return /^y(es)?$/i.test(answer.trim());
+}
+export async function runFix(options) {
+    const projectDir = process.cwd();
+    const config = await loadDocsConfig('docs.json');
+    if (!config) {
+        output.error('Could not load docs.json');
+        process.exit(1);
+    }
+    const hostAtDocs = config.hostAtDocs === true;
+    const locales = localesFromConfig(config);
+    const readPage = readPageFactory(projectDir);
+    const headingsOf = (p) => {
+        const c = readPage(p);
+        return c == null ? null : extractHeadings(c);
+    };
+    const pageExists = (p) => readPage(p) !== null;
+    const spin = spinner('Scanning for fixable warnings...');
+    const validateScript = path.join(__dirname, '../../vendored/scripts/validate-links.cjs');
+    let warnings = [];
+    try {
+        const out = execFileSync('node', [validateScript, '--json'], {
+            cwd: projectDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, CONTENT_DIR: projectDir },
+        });
+        warnings = JSON.parse(out);
+    }
+    catch (error) {
+        // validate-links.cjs may exit non-zero while still printing JSON to stdout
+        // (mirrors broken-links.ts). Guard the parse so non-JSON stdout fails cleanly.
+        const e = error;
+        if (e.stdout) {
+            try {
+                warnings = JSON.parse(e.stdout);
+            }
+            catch {
+                spin.fail('Scan failed');
+                process.exit(1);
+            }
+        }
+        else {
+            spin.fail('Scan failed');
+            process.exit(1);
+        }
+    }
+    spin.stop();
+    if (options.types?.length)
+        warnings = warnings.filter((wn) => options.types.includes(wn.type));
+    const plan = planFixes(warnings, { hostAtDocs, locales, headingsOf, pageExists });
+    // ---- AI fallback tier -------------------------------------------------------
+    if (!options.noAi) {
+        const hasNeedsAiSkips = plan.skipped.some((s) => s.reason.includes(NEEDS_AI_MARKER));
+        const missing = scanMissingDescriptions(getAllPagePaths(config), (p) => readPage(p), (p) => resolvePageFile(projectDir, p));
+        if (hasNeedsAiSkips || missing.length > 0) {
+            const projectId = options.project ?? config.projectId ?? '';
+            if (!projectId) {
+                output.hint('AI fixes need a project — pass --project <id> or set "projectId" in docs.json. Skipping the AI tier.');
+            }
+            else {
+                const resolveTarget = (href) => {
+                    const lp = parseHref(href).path;
+                    if (!lp)
+                        return null;
+                    const norm = normalizeLinkPath(lp, hostAtDocs);
+                    return pageExists(norm) ? norm : null;
+                };
+                const { request, anchorMeta } = buildAiRequest({ skipped: plan.skipped, missing, headingsOf, resolveTarget });
+                if (request.anchors.length || request.descriptions.length) {
+                    request.projectId = projectId;
+                    const spin2 = spinner('Asking AI to resolve the remaining warnings...');
+                    const resp = await requestAiFixes(request);
+                    spin2.stop();
+                    const aiAnchorEdits = anchorEditsFromResponse(resp, anchorMeta, headingsOf);
+                    if (aiAnchorEdits.length) {
+                        console.log('\nAI-resolved anchors:');
+                        for (const f of aiAnchorEdits)
+                            for (const e of f.edits) {
+                                console.log(`  ${f.warning.file}:${f.warning.line}  ${e.oldText} → ${e.newText}`);
+                            }
+                        plan.fixed.push(...aiAnchorEdits);
+                        plan.skipped = dropResolvedSkips(plan.skipped, aiAnchorEdits); // no double-count
+                    }
+                    // Descriptions: ALWAYS interactive, per-item confirm — the decision is the
+                    // pure planDescriptionWrites() (no `yes` param, so --yes cannot bypass it).
+                    // An AI-generated description is a content judgement a human must approve;
+                    // `--yes` governs only the validated link rewrites above.
+                    const { toReview, overflow, skippedNoTty } = planDescriptionWrites({
+                        descriptions: resp.descriptions, missing, cap: DESC_WRITE_CAP,
+                        isTTY: !!process.stdin.isTTY, dryRun: !!options.dryRun,
+                    });
+                    if (overflow > 0)
+                        output.hint(`AI proposed ${overflow} more description(s); reviewing the first ${DESC_WRITE_CAP} this run — re-run jamdesk fix for the rest.`);
+                    if (skippedNoTty) {
+                        output.hint('AI description suggestions need interactive confirmation — re-run jamdesk fix in a terminal to review them. Skipped (descriptions are never written unattended).');
+                    }
+                    for (const d of toReview) {
+                        console.log(`\nProposed description for ${d.file}:\n  "${d.text}"`);
+                        if (options.dryRun) {
+                            console.log('  (dry run — not written)');
+                            continue;
+                        }
+                        const abs = path.join(projectDir, d.file);
+                        // Defense in depth: never read/write a target that isn't on disk (an
+                        // unresolved page would otherwise throw ENOENT mid-write).
+                        if (!fs.existsSync(abs)) {
+                            output.hint(`Skipped ${d.file} — file not found on disk.`);
+                            continue;
+                        }
+                        if (await confirm(`Write this description to ${d.file}?`)) {
+                            fs.writeFileSync(abs, setFrontmatterField(fs.readFileSync(abs, 'utf-8'), 'description', d.text), 'utf-8');
+                            output.success(`Wrote description to ${d.file}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // ---- end AI fallback tier ---------------------------------------------------
+    if (plan.fixed.length === 0) {
+        output.info(`Nothing to auto-fix. (${plan.skipped.length} warning(s) left for manual review.)`);
+        printSkips(plan);
+        process.exit(0);
+    }
+    console.log('\nPlanned fixes:\n');
+    for (const f of plan.fixed) {
+        console.log(`  ${f.warning.file}:${f.warning.line ?? '?'}`);
+        for (const e of f.edits)
+            console.log(`    ${e.oldText}  →  ${e.newText}`);
+    }
+    if (options.dryRun) {
+        console.log('\n(dry run — no files written)');
+        printSkips(plan);
+        process.exit(0);
+    }
+    if (!options.yes && !(await confirm(`\nApply ${plan.fixed.length} fix(es) to local files?`))) {
+        output.info('Aborted — no files changed.');
+        process.exit(0);
+    }
+    const io = {
+        readFile: (p) => fs.readFileSync(p, 'utf-8'),
+        writeFile: (p, c) => fs.writeFileSync(p, c, 'utf-8'),
+    };
+    const outcome = applyPlanToFiles(plan, projectDir, io);
+    for (const f of outcome.failed)
+        output.error(`Could not fix ${f.file}: ${f.error}`);
+    if (outcome.failed.length > 0) {
+        output.warn(`Fixed ${outcome.written.length} file(s), ${outcome.failed.length} failed; ${plan.skipped.length} warning(s) left for manual review.`);
+    }
+    else {
+        output.success(`Fixed ${outcome.written.length} file(s); ${plan.skipped.length} warning(s) left for manual review.`);
+    }
+    printSkips(plan);
+    if (outcome.failed.length > 0)
+        process.exit(1);
+}
+function printSkips(plan) {
+    if (plan.skipped.length === 0)
+        return;
+    console.log('\nNot auto-fixed (manual review):');
+    for (const s of plan.skipped)
+        console.log(`  ${s.warning.file}:${s.warning.line ?? '?'} — ${s.reason}`);
+}
+//# sourceMappingURL=fix.js.map

package/dist/commands/fix.js.map

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

package/dist/index.js

@@ -185,6 +185,25 @@ Output shows the file, line number, and suggests corrections:
     const { brokenLinks } = await import('./commands/broken-links.js');
     await brokenLinks({ verbose });
 });
+// Fix command
+program
+    .command('fix')
+    .description('Auto-fix doc warnings where the fix is known (broken internal links). Edits local files.')
+    .option('--dry-run', 'Show planned fixes without writing files', false)
+    .option('-y, --yes', 'Apply fixes without confirmation', false)
+    .option('--types <types>', 'Comma-separated warning types to fix (default: all supported)')
+    .option('--no-ai', 'Skip the AI fallback tier (deterministic only)')
+    .option('--project <id>', 'Project id for AI fixes (defaults to docs.json projectId)')
+    .action(async (opts) => {
+    const { runFix } = await import('./commands/fix.js');
+    await runFix({
+        dryRun: !!opts.dryRun,
+        yes: !!opts.yes,
+        types: opts.types ? String(opts.types).split(',').map((s) => s.trim()) : undefined,
+        noAi: !opts.ai,
+        project: opts.project,
+    });
+});
 // Spellcheck command
 program
     .command('spellcheck')