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

package/dist/cli/docs.cli-group.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLIGroupAssetDescriptor } from '@vibesdotdev/cli/schemas/descriptors';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=docs.cli-group.descriptor.d.ts.map

package/dist/cli/docs.cli-group.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/docs.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/docs.cli-group.descriptor.js

@@ -0,0 +1,11 @@
+const descriptor = {
+    kind: 'cli/group',
+    id: 'docs',
+    name: 'docs',
+    description: 'Browse and render registered documentation topics',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=docs.cli-group.descriptor.js.map

package/dist/cli/docs.cli-group.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cli-group.descriptor.js","sourceRoot":"","sources":["../../src/cli/docs.cli-group.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,mDAAmD;IAChE,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/client/citations.d.ts

@@ -0,0 +1,11 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type CitationOwner } from '@vibesdotdev/shared/citations';
+import type { DocsTopicDescriptor } from '../schemas/topic.schema.ts';
+interface DocsCitationReader {
+    list(): Promise<DocsTopicDescriptor[]>;
+    read(topic: DocsTopicDescriptor): string | null;
+}
+/** Topic discovery and body reads remain with the existing Docs client. */
+export declare function createDocsCitations(runtime: RuntimeRef, reader: DocsCitationReader): CitationOwner;
+export {};
+//# sourceMappingURL=citations.d.ts.map

package/dist/client/citations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.d.ts","sourceRoot":"","sources":["../../src/client/citations.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIjG,OAAO,EAC2E,KAAK,aAAa,EACnG,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,UAAU,kBAAkB;IAC3B,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,aAAa,CA0IlG"}

package/dist/client/citations.js

@@ -0,0 +1,197 @@
+import * as z from 'zod/v4';
+import { CapabilityError, settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { getVibesCitationsClient } from '@vibesdotdev/workspace/citations';
+import { DocumentFreshnessAssessmentSchema } from '@vibesdotdev/docs-contracts';
+import { CitationLocateContextSchema, CitationSchema } from '@vibesdotdev/shared/citations';
+import { sha256Hex } from '@vibesdotdev/shared/hashing';
+import { DocsCitationQuerySchema, DocsCitationSubjectSchema } from "../schemas/citations.schema.js";
+/** Topic discovery and body reads remain with the existing Docs client. */
+export function createDocsCitations(runtime, reader) {
+    function scope(expected) {
+        const current = z.string().min(1).safeParse(runtime.invocationWorkspace?.id);
+        if (!current.success)
+            throw refusal('docs-citation-scope-required', 'UNAVAILABLE');
+        if (expected !== undefined && expected !== current.data)
+            throw refusal('docs-citation-scope-mismatch', 'PERMISSION_DENIED');
+        return current.data;
+    }
+    function citation(input) {
+        const selected = CitationSchema.parse(input);
+        if (selected.link.kind !== 'docs' || selected.link.source !== 'docs')
+            throw refusal('docs-citation-kind-invalid', 'INVALID_INPUT');
+        scope(selected.scope);
+        if (selected.anchor !== undefined && selected.anchor.kind !== 'region')
+            throw refusal('docs-citation-anchor-unsupported', 'INVALID_INPUT');
+        return selected;
+    }
+    async function topic(selected) {
+        const matches = (await reader.list()).filter(topic => topic.id === selected.link.id);
+        if (matches.length > 1)
+            throw refusal('docs-citation-topic-ambiguous', 'CONFLICT');
+        return matches[0];
+    }
+    async function freshness(topic, currentScope, stalenessThresholdDays) {
+        const policy = topic.citationFreshness;
+        if (policy === undefined)
+            return undefined;
+        const citations = getVibesCitationsClient(runtime);
+        const observe = async (selected) => {
+            if (selected.scope !== currentScope)
+                throw refusal('docs-freshness-scope-mismatch', 'PERMISSION_DENIED');
+            // Prior annotations are evidence, not a clock issued by this observation's owner.
+            const request = { scope: selected.scope, link: selected.link, revision: selected.revision };
+            if (selected.anchor !== undefined)
+                request.anchor = selected.anchor;
+            const observed = await citations.metadata(request);
+            if (observed.status !== 'current')
+                throw refusal(`docs-freshness-source-${observed.status}`, 'UNAVAILABLE');
+            return observed.citation;
+        };
+        const document = await observe(policy.document);
+        const read = await citations.resolve(document);
+        if (read.status !== 'resolved')
+            throw refusal(`docs-freshness-document-${read.status}`, 'UNAVAILABLE');
+        const text = reader.read(topic);
+        if (text === null || read.text !== text)
+            throw refusal('docs-freshness-document-not-equivalent', 'CONFLICT');
+        const references = [];
+        for (const reference of policy.references)
+            references.push(await observe(reference));
+        const clock = (citation) => {
+            const result = {
+                id: JSON.stringify([citation.scope, citation.link.source, citation.link.kind, citation.link.id])
+            };
+            if (citation.freshness?.modifiedAt !== undefined)
+                result.modifiedAt = citation.freshness.modifiedAt;
+            return result;
+        };
+        const input = { document: clock(document), references: references.map(clock) };
+        if (stalenessThresholdDays !== undefined)
+            input.stalenessThresholdDays = stalenessThresholdDays;
+        const assessor = await getVibesClient('knowledge', runtime);
+        if (!assessor.assessDocumentFreshness)
+            throw refusal('docs-freshness-assessor-unavailable', 'UNAVAILABLE');
+        return DocumentFreshnessAssessmentSchema.parse(await assessor.assessDocumentFreshness(input));
+    }
+    const owner = {
+        async metadata(input) {
+            const selected = citation(input);
+            const current = await topic(selected);
+            if (current === undefined)
+                return { status: 'gone' };
+            const revision = revisionOf(current);
+            if (revision === undefined)
+                return { status: 'unavailable', reason: 'docs-citation-body-unsupported' };
+            return { status: 'current', citation: { ...selected, revision } };
+        },
+        async resolve(input) {
+            const selected = citation(input);
+            const current = await topic(selected);
+            if (current === undefined)
+                return { status: 'gone' };
+            const revision = revisionOf(current);
+            if (revision === undefined)
+                return { status: 'unavailable', reason: 'docs-citation-body-unsupported' };
+            if (revision.scheme !== selected.revision.scheme || revision.value !== selected.revision.value)
+                throw changed();
+            const text = reader.read(current);
+            if (text === null)
+                return { status: 'unavailable', reason: 'docs-citation-body-unavailable' };
+            if (textRevision(text).value !== revision.value)
+                throw changed();
+            const observed = await topic(selected);
+            const after = observed === undefined ? undefined : revisionOf(observed);
+            if (after?.scheme !== revision.scheme || after.value !== revision.value)
+                throw changed();
+            if (selected.anchor?.kind === 'region' && selected.anchor.end > text.length)
+                throw refusal('docs-citation-anchor-invalid', 'INVALID_INPUT');
+            const result = { status: 'resolved', text: selected.anchor?.kind === 'region' ? text.slice(selected.anchor.start, selected.anchor.end) : text, revision };
+            return selected.anchor === undefined && current.citationOrigin !== undefined
+                ? { ...result, origin: current.citationOrigin }
+                : result;
+        },
+        async locate(kind, query, context) {
+            if (kind !== 'docs')
+                throw refusal('docs-citation-kind-invalid', 'INVALID_INPUT');
+            const selected = DocsCitationQuerySchema.parse(query);
+            const binding = CitationLocateContextSchema.parse(context);
+            const currentScope = scope(binding.workspaceId);
+            const subject = 'subject' in selected ? DocsCitationSubjectSchema.safeParse(selected.subject) : undefined;
+            if (subject !== undefined && !subject.success)
+                throw refusal('docs-citation-canonical-subject-required', 'INVALID_INPUT');
+            const topics = (await reader.list()).filter(topic => 'ids' in selected ? selected.ids.includes(topic.id)
+                : subject?.success && topic.subject?.kind === subject.data.kind && topic.subject?.id === subject.data.id);
+            const grouped = new Map();
+            for (const topic of topics)
+                grouped.set(topic.id, [...(grouped.get(topic.id) ?? []), topic]);
+            const places = [];
+            const failures = [];
+            for (const id of [...grouped.keys()].sort()) {
+                const candidates = grouped.get(id);
+                if (candidates.length !== 1) {
+                    failures.push('docs-citation-topic-ambiguous');
+                    continue;
+                }
+                if (selected.maxTopics !== undefined && places.length >= selected.maxTopics) {
+                    failures.push('docs-citation-truncated');
+                    break;
+                }
+                const revision = revisionOf(candidates[0]);
+                if (revision === undefined) {
+                    failures.push('docs-citation-body-unsupported');
+                    continue;
+                }
+                const place = CitationSchema.parse({ link: { kind: 'docs', source: 'docs', id, role: 'evidence' }, scope: currentScope, revision });
+                const assessment = await settle(() => freshness(candidates[0], currentScope, selected.stalenessThresholdDays));
+                if (!assessment.ok) {
+                    const facts = valueFreeFailure(assessment.cause);
+                    failures.push(`docs-freshness: ${facts.code ?? facts.name}${facts.reason === undefined ? '' : ` (${facts.reason})`}`);
+                }
+                else if (assessment.value?.status === 'unknown') {
+                    failures.push('docs-freshness-clock-unavailable');
+                }
+                else if (assessment.value !== undefined) {
+                    place.freshness = {
+                        modifiedAt: assessment.value.documentModifiedAt,
+                        stale: assessment.value.status !== 'current'
+                    };
+                }
+                places.push(place);
+            }
+            return failures.length > 0 ? { status: 'partial', places, reason: [...new Set(failures)].join('; ') } : { status: 'complete', places };
+        },
+        async find(input, text, at) {
+            const selected = citation(input);
+            const needle = z.string().min(1).parse(text);
+            const occurrence = z.object({ start: z.number().int().nonnegative() }).optional().parse(at);
+            const read = await owner.resolve(selected);
+            if (read.status !== 'resolved')
+                throw refusal('docs-citation-body-unavailable', 'UNAVAILABLE');
+            const base = selected.anchor?.kind === 'region' ? selected.anchor.start : 0;
+            const matches = [];
+            if (occurrence !== undefined) {
+                if (read.text.slice(occurrence.start, occurrence.start + needle.length) === needle)
+                    matches.push({ kind: 'region', start: base + occurrence.start, end: base + occurrence.start + needle.length });
+                return matches;
+            }
+            let offset = read.text.indexOf(needle);
+            while (offset !== -1) {
+                matches.push({ kind: 'region', start: base + offset, end: base + offset + needle.length });
+                offset = read.text.indexOf(needle, offset + 1);
+            }
+            return matches;
+        },
+        async rootOf(input) { return citation(input); }
+    };
+    return owner;
+}
+function revisionOf(topic) {
+    return topic.body.type === 'markdown' && topic.body.sourceType === 'raw' ? textRevision(topic.body.source) : undefined;
+}
+function textRevision(text) { return { scheme: 'docs-raw-text-v1', value: sha256Hex(text) }; }
+function changed() { return new CapabilityError('The topic changed after location.', 'CONFLICT', { reason: 'citation-revision-changed', retryable: true }); }
+function refusal(reason, code) {
+    return new CapabilityError('The Docs citation selection is unavailable or invalid.', code, { reason });
+}
+//# sourceMappingURL=citations.js.map

package/dist/client/citations.js.map

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

package/dist/client/docs-client.d.ts

@@ -0,0 +1,51 @@
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import { type DocsTopicDescriptor } from '../schemas/topic.schema.ts';
+import type { IDocsClient, ListOptions, SubjectRef } from './types.ts';
+import type { CitationOwner } from '@vibesdotdev/shared/citations';
+import type { MarkdownSectionRequest } from '@vibesdotdev/docs-contracts';
+/**
+ * Canonical Docs client — descriptor discovery + body resolution.
+ *
+ * `findBySubject` is implemented as a local filter (no new runtime query
+ * helper). Body resolution today only handles `sourceType: 'raw'` markdown
+ * bodies; `package` source resolution is the Tier 2 problem (web) and the
+ * registering plugin's problem (CLI — package authors inline content via
+ * `sourceType: 'raw'` for the canonical case).
+ */
+export declare class DocsClient extends BaseRuntimeClient implements IDocsClient {
+    selectMarkdownSection(input: MarkdownSectionRequest): {
+        status: "selected";
+        section: {
+            slug: string;
+            title: string;
+            level: number;
+            start: number;
+            end: number;
+        };
+    } | {
+        status: "missing";
+    } | {
+        status: "ambiguous";
+        sections: {
+            slug: string;
+            title: string;
+            level: number;
+            start: number;
+            end: number;
+        }[];
+    };
+    readonly citations: CitationOwner;
+    constructor(descriptor?: RuntimeClientDescriptor, context?: KindContext, runtime?: VibesRuntime);
+    private allTopics;
+    findById(id: string): DocsTopicDescriptor | null;
+    findBySubject(subject: SubjectRef): DocsTopicDescriptor | null;
+    private lookupSubjectDescriptor;
+    private synthesizeSubjectTopic;
+    list(opts?: ListOptions): DocsTopicDescriptor[];
+    resolveBody(descriptor: DocsTopicDescriptor): string | null;
+    search(query: string): DocsTopicDescriptor[];
+    siblingTopicIds(descriptor: DocsTopicDescriptor): string[];
+}
+//# sourceMappingURL=docs-client.d.ts.map

package/dist/client/docs-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-client.d.ts","sourceRoot":"","sources":["../../src/client/docs-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,UAAW,SAAQ,iBAAkB,YAAW,WAAW;IACvE,qBAAqB,CAAC,KAAK,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;;IAGnD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;gBAEjC,UAAU,GAAE,uBAAgE,EAC5E,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,YAAY;IAWvB,OAAO,CAAC,SAAS;IAYjB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAehD,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI;IAS9D,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,sBAAsB;IA+B9B,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,mBAAmB,EAAE;IAsBnD,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAe3D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAc5C,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,EAAE;CAO1D"}

package/dist/client/docs-client.js

@@ -0,0 +1,298 @@
+import * as z from 'zod/v4';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { DocsTopicDescriptorSchema } from "../schemas/topic.schema.js";
+import { createDocsCitations } from "./citations.js";
+import { selectMarkdownSection } from "../render/sections.js";
+/**
+ * Canonical Docs client — descriptor discovery + body resolution.
+ *
+ * `findBySubject` is implemented as a local filter (no new runtime query
+ * helper). Body resolution today only handles `sourceType: 'raw'` markdown
+ * bodies; `package` source resolution is the Tier 2 problem (web) and the
+ * registering plugin's problem (CLI — package authors inline content via
+ * `sourceType: 'raw'` for the canonical case).
+ */
+export class DocsClient extends BaseRuntimeClient {
+    selectMarkdownSection(input) {
+        return selectMarkdownSection(input);
+    }
+    citations;
+    constructor(descriptor = { id: 'docs', kind: 'runtime/client' }, context, runtime) {
+        super(descriptor, context, runtime);
+        this.citations = createDocsCitations(this.runtime, {
+            list: async () => (await this.runtime.query('docs/topic').enabled()
+                .filter(topic => !topic.hardware?.length || topic.hardware.includes(this.runtime.scope.hardware))
+                .descriptorsAsync()).map(topic => DocsTopicDescriptorSchema.parse(topic)),
+            read: topic => this.resolveBody(topic)
+        });
+    }
+    allTopics() {
+        const rawDescriptors = this.runtime.query('docs/topic').descriptors();
+        const result = [];
+        for (const raw of rawDescriptors) {
+            const parsed = DocsTopicDescriptorSchema.safeParse(raw);
+            if (parsed.success) {
+                result.push(parsed.data);
+            }
+        }
+        return result;
+    }
+    findById(id) {
+        const authored = this.allTopics().find((t) => t.id === id);
+        if (authored)
+            return authored;
+        for (const fallback of FALLBACK_SUBJECT_SPECS) {
+            if (id.startsWith(fallback.idPrefix)) {
+                const subjectId = id.slice(fallback.idPrefix.length);
+                if (subjectId) {
+                    const synthesized = this.synthesizeSubjectTopic({ kind: fallback.kind, id: subjectId });
+                    if (synthesized)
+                        return synthesized;
+                }
+            }
+        }
+        return null;
+    }
+    findBySubject(subject) {
+        const authored = this.allTopics().find((t) => t.subject?.kind === subject.kind && t.subject?.id === subject.id);
+        if (authored)
+            return authored;
+        return this.synthesizeSubjectTopic(subject);
+    }
+    lookupSubjectDescriptor(kind, id) {
+        const candidates = kind === 'runbooks/runbook'
+            ? ['runbooks/runbook', 'runbook']
+            : kind === 'runbook'
+                ? ['runbook', 'runbooks/runbook']
+                : [kind];
+        for (const candidateKind of candidates) {
+            if (!this.runtime.hasKind(candidateKind))
+                continue;
+            const found = this.runtime
+                .query(candidateKind)
+                .descriptors()
+                .find((d) => d.id === id);
+            const parsed = SubjectDocDescriptorSchema.safeParse(found);
+            if (parsed.success) {
+                return { kind: candidateKind, raw: parsed.data };
+            }
+        }
+        return null;
+    }
+    synthesizeSubjectTopic(subject) {
+        const resolved = this.lookupSubjectDescriptor(subject.kind, subject.id);
+        if (!resolved)
+            return null;
+        const { raw } = resolved;
+        const spec = FALLBACK_SUBJECT_SPECS.find((entry) => entry.kind === subject.kind || entry.aliases?.includes(subject.kind));
+        const topicId = spec
+            ? `${spec.idPrefix}${subject.id}`
+            : `${subject.kind.replace(/\//g, '.')}.${subject.id}`;
+        const title = firstNonEmptyString(raw.title, raw.name, subject.id) ?? subject.id;
+        const summary = firstNonEmptyString(raw.summary, raw.plainSummary, raw.description, raw.message);
+        const candidate = {
+            kind: 'docs/topic',
+            id: topicId,
+            title,
+            tags: spec?.tags ?? [subject.kind.split('/')[0] ?? 'docs'],
+            surfaces: ['cli', 'web', 'in-app', 'mcp'],
+            subject: { kind: subject.kind, id: subject.id },
+            body: { type: 'descriptor-ref', kind: resolved.kind, id: subject.id }
+        };
+        if (summary) {
+            candidate.summary = summary;
+        }
+        if (spec?.parent) {
+            candidate.parent = spec.parent;
+        }
+        const parsed = DocsTopicDescriptorSchema.safeParse(candidate);
+        return parsed.success ? parsed.data : null;
+    }
+    list(opts = {}) {
+        let topics = this.allTopics().filter((t) => t.enabled !== false);
+        if (opts.tag) {
+            const tag = opts.tag;
+            topics = topics.filter((t) => t.tags.includes(tag));
+        }
+        if (opts.parent) {
+            const parent = opts.parent;
+            topics = topics.filter((t) => t.parent === parent);
+        }
+        if (opts.surface) {
+            const surface = opts.surface;
+            topics = topics.filter((t) => t.surfaces.includes(surface));
+        }
+        return topics.sort((a, b) => {
+            const ao = a.order ?? Number.MAX_SAFE_INTEGER;
+            const bo = b.order ?? Number.MAX_SAFE_INTEGER;
+            if (ao !== bo)
+                return ao - bo;
+            return a.id.localeCompare(b.id);
+        });
+    }
+    resolveBody(descriptor) {
+        const body = descriptor.body;
+        if (body.type === 'descriptor-ref') {
+            const resolved = this.lookupSubjectDescriptor(body.kind, body.id);
+            if (!resolved)
+                return null;
+            return renderDescriptorMarkdown(body.kind, body.id, resolved.raw);
+        }
+        if (body.type !== 'markdown')
+            return null;
+        if (body.sourceType === 'raw')
+            return body.source;
+        // 'package' source resolution is the registering plugin's responsibility
+        // for the CLI surface (inline as 'raw' for Tier 1). Web surface picks
+        // this up via import.meta.glob at Tier 2.
+        return null;
+    }
+    search(query) {
+        const q = query.toLowerCase().trim();
+        if (!q)
+            return [];
+        return this.allTopics()
+            .filter((t) => t.enabled !== false)
+            .filter((t) => {
+            if (t.id.toLowerCase().includes(q))
+                return true;
+            if (t.title.toLowerCase().includes(q))
+                return true;
+            if ((t.summary ?? '').toLowerCase().includes(q))
+                return true;
+            return t.tags.some((tag) => tag.toLowerCase().includes(q));
+        })
+            .sort((a, b) => a.id.localeCompare(b.id));
+    }
+    siblingTopicIds(descriptor) {
+        if (!descriptor.parent)
+            return [];
+        const parent = descriptor.parent;
+        return this.allTopics()
+            .filter((t) => t.parent === parent && t.id !== descriptor.id)
+            .map((t) => t.id);
+    }
+}
+const SubjectDocDescriptorSchema = z.object({
+    id: z.string(),
+    title: z.string().optional(),
+    name: z.string().optional(),
+    summary: z.string().optional(),
+    plainSummary: z.string().optional(),
+    description: z.string().optional(),
+    message: z.string().optional(),
+    severity: z.string().optional(),
+    enforcer: z.string().optional(),
+    verify: z.string().optional(),
+    type: z.string().optional(),
+    category: z.string().optional(),
+    cost: z.string().optional(),
+    writes: z.string().optional(),
+    roles: z.array(z.string()).readonly().optional(),
+    scope: z.unknown().optional(),
+    guidance: z.string().optional(),
+    fix: z.string().optional(),
+    remediation: z.unknown().optional(),
+    authority: z.array(z.string()).readonly().optional(),
+    provenance: z.unknown().optional(),
+    expose: z.array(z.unknown()).readonly().optional(),
+    checklist: z.array(z.string()).readonly().optional()
+});
+const FALLBACK_SUBJECT_SPECS = [
+    {
+        kind: 'rules/rule',
+        idPrefix: 'rules.rule.',
+        parent: 'workspace.rules.contributing',
+        tags: ['rules']
+    },
+    {
+        kind: 'runnable/runnable',
+        idPrefix: 'runnables.',
+        parent: 'runnable',
+        tags: ['runnables']
+    },
+    {
+        kind: 'runbook',
+        aliases: ['runbooks/runbook'],
+        idPrefix: 'runbooks.runbook.',
+        parent: 'runbooks',
+        tags: ['runbooks']
+    },
+    {
+        kind: 'diagnostics/check',
+        idPrefix: 'diagnostics.check.',
+        parent: 'diagnostics.checks',
+        tags: ['diagnostics', 'checks']
+    }
+];
+function firstNonEmptyString(...values) {
+    for (const value of values) {
+        if (value !== undefined && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+const StringSchema = z.string();
+function renderDescriptorMarkdown(kind, id, raw) {
+    const title = firstNonEmptyString(raw.title, raw.name, id) ?? id;
+    const summary = firstNonEmptyString(raw.summary, raw.plainSummary, raw.description, raw.message);
+    const badges = [`\`${id}\``, `kind \`${kind}\``];
+    const badgeFields = [
+        ['severity', raw.severity],
+        ['enforcer', raw.enforcer],
+        ['verify', raw.verify],
+        ['type', raw.type],
+        ['category', raw.category],
+        ['cost', raw.cost],
+        ['writes', raw.writes]
+    ];
+    for (const [key, value] of badgeFields) {
+        if (value) {
+            badges.push(`${key} \`${value}\``);
+        }
+    }
+    if (raw.roles && raw.roles.length > 0) {
+        badges.push(`roles ${raw.roles.map((r) => `\`${r}\``).join(', ')}`);
+    }
+    const sections = [`# ${title}`, badges.join(' · ')];
+    if (summary)
+        sections.push(summary);
+    if (raw.scope !== undefined && raw.scope !== null) {
+        sections.push(`## Where it applies\n\`\`\`json\n${JSON.stringify(raw.scope, null, 2)}\n\`\`\``);
+    }
+    if (raw.guidance?.trim()) {
+        sections.push(`## Guidance\n${raw.guidance.trim()}`);
+    }
+    if (raw.fix?.trim()) {
+        sections.push(`## Fixed by\n\`${raw.fix.trim()}\``);
+    }
+    if (raw.remediation !== undefined && raw.remediation !== null) {
+        const parsedRemediation = StringSchema.safeParse(raw.remediation);
+        const text = parsedRemediation.success
+            ? parsedRemediation.data
+            : `\`\`\`json\n${JSON.stringify(raw.remediation, null, 2)}\n\`\`\``;
+        sections.push(`## Remediation\n${text}`);
+    }
+    if (raw.authority && raw.authority.length > 0) {
+        sections.push(`## Authority\n${raw.authority.map((entry) => `- ${entry}`).join('\n')}`);
+    }
+    if (raw.provenance !== undefined && raw.provenance !== null) {
+        sections.push(`## Provenance\n\`\`\`json\n${JSON.stringify(raw.provenance, null, 2)}\n\`\`\``);
+    }
+    if (raw.expose && raw.expose.length > 0) {
+        sections.push(`## Exposed as\n${raw.expose
+            .map((target) => {
+            const parsedTarget = StringSchema.safeParse(target);
+            return parsedTarget.success
+                ? `- \`${parsedTarget.data}\``
+                : `- \`${JSON.stringify(target)}\``;
+        })
+            .join('\n')}`);
+    }
+    if (raw.checklist && raw.checklist.length > 0) {
+        sections.push(`## Steps\n${raw.checklist.map((step, index) => `${index + 1}. ${step}`).join('\n')}`);
+    }
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=docs-client.js.map

package/dist/client/docs-client.js.map

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