@guiho/xdocs 0.1.0

package/library/help.js

@@ -0,0 +1,165 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { readFileSync } from 'node:fs';
+/** Read the package version from package.json. */
+export const readPackageVersion = () => {
+    try {
+        const raw = readFileSync(new URL('../package.json', import.meta.url), 'utf8');
+        const pkg = JSON.parse(raw);
+        return typeof pkg['version'] === 'string' ? pkg['version'] : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+};
+/** Show the xdocs version string. */
+export const showVersion = () => `xdocs ${readPackageVersion()}`;
+/** Show the main help text. */
+export const showHelp = () => `
+xdocs - Structured documentation system for codebases
+
+Usage: xdocs <command> [options]
+
+Commands:
+  init                  Initialize xdocs in a project
+  scan                  Scan the project for xdocs files
+  generate [path]       Generate documentation for a directory or the project
+  prompt                Output a ready-made prompt for AI
+  merge [path]          Merge xdocs files from a directory into one file
+  tree                  Display the project hierarchy tree
+  list [path]           List files with descriptions
+
+Global Flags:
+  -h, --help            Show help for a command
+  -v, --version         Show the xdocs version
+  --cwd <path>          Run as if started in this directory
+  --config <path>       Path to xdocs.config.toml
+  --verbose             Show detailed output
+
+Examples:
+  xdocs init
+  xdocs scan
+  xdocs generate ./src/auth
+  xdocs prompt --name=write
+  xdocs merge ./src/domain
+  xdocs tree
+  xdocs list ./src/auth
+`.trim();
+/** Show help for a specific command. */
+export const showCommandHelp = (command) => {
+    const help = commandHelpMap[command];
+    if (help)
+        return help;
+    return `Unknown command: ${command}\n\nRun \`xdocs --help\` for available commands.`;
+};
+const commandHelpMap = {
+    init: `
+xdocs init - Initialize xdocs in a project
+
+Usage: xdocs init
+
+Creates:
+  - XDOCS.md              Root documentation file
+  - xdocs.config.toml     Configuration with defaults
+  - Updates AGENTS.md     Adds xdocs instructions for AI agents
+  - Installs agent skills Prompts for AI tool and skill directory
+
+Flags:
+  --cwd <path>            Target directory (default: current directory)
+  --verbose               Show detailed output
+`.trim(),
+    scan: `
+xdocs scan - Scan the project for xdocs files
+
+Usage: xdocs scan
+
+Walks every directory and subdirectory (respecting exclude rules),
+matches files against configured extensions, and reports coverage.
+
+Flags:
+  --format <format>       Output format: text, json (default: text)
+  --cwd <path>            Target directory (default: current directory)
+  --config <path>         Path to xdocs.config.toml
+  --verbose               Show detailed output
+`.trim(),
+    generate: `
+xdocs generate - Generate documentation
+
+Usage: xdocs generate [path]
+
+When a path is given, generates an xdocs file for that directory/module.
+When no path is given, generates documentation for the entire project.
+
+Flags:
+  --output <path>         Output file path
+  --format <format>       Output format: text, markdown (default: markdown)
+  --cwd <path>            Target directory (default: current directory)
+  --config <path>         Path to xdocs.config.toml
+  --verbose               Show detailed output
+`.trim(),
+    prompt: `
+xdocs prompt - Output a ready-made prompt for AI
+
+Usage: xdocs prompt --name=<name>
+
+Outputs a self-contained instruction prompt for an AI agent to execute
+a specific xdocs task. Both flag styles are supported:
+  xdocs prompt --name=write
+  xdocs prompt --name write
+
+Available prompts:
+  write                   How to scan a directory and write xdocs documentation
+  update                  How to update existing xdocs files after code changes
+  agents                  How to update AGENTS.md with xdocs instructions
+  generate                How to generate comprehensive documentation
+
+Flags:
+  --name <name>           The prompt to output (required)
+  --cwd <path>            Target directory (default: current directory)
+  --config <path>         Path to xdocs.config.toml
+`.trim(),
+    merge: `
+xdocs merge - Merge xdocs files into a single file
+
+Usage: xdocs merge [path]
+
+Takes all xdocs files within the given directory and produces
+one consolidated Markdown document.
+
+Flags:
+  --output <path>         Output file path (default: stdout)
+  --cwd <path>            Target directory (default: current directory)
+  --config <path>         Path to xdocs.config.toml
+  --verbose               Show detailed output
+`.trim(),
+    tree: `
+xdocs tree - Display the project hierarchy tree
+
+Usage: xdocs tree
+
+Scans all xdocs files, reads their metadata, and assembles the
+parent-child hierarchy. Shows modules only, not individual files.
+
+Flags:
+  --format <format>       Output format: text, markdown (default: text)
+  --output <path>         Output file path (default: stdout)
+  --cwd <path>            Target directory (default: current directory)
+  --config <path>         Path to xdocs.config.toml
+  --verbose               Show detailed output
+`.trim(),
+    list: `
+xdocs list - List files with descriptions
+
+Usage: xdocs list [path]
+
+Lists every file in the given scope with a short description
+of its purpose, pulled from xdocs metadata.
+
+Flags:
+  --format <format>       Output format: text, json (default: text)
+  --cwd <path>            Target directory (default: current directory)
+  --config <path>         Path to xdocs.config.toml
+  --verbose               Show detailed output
+`.trim(),
+};

package/library/metadata.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { XDocsFile, XDocsMetadata } from './types.js';
+/** Parse an xdocs file from disk into an XDocsFile object. */
+export declare const parseXDocsFile: (filePath: string, cwd: string) => Promise<XDocsFile>;
+/** Extract YAML frontmatter and body from a Markdown string. */
+export declare const extractFrontmatter: (content: string) => {
+    frontmatter: string | null;
+    body: string;
+};
+/** Validate parsed YAML as XDocsMetadata. */
+export declare const validateMetadata: (parsed: unknown) => {
+    valid: true;
+    metadata: XDocsMetadata;
+    errors: never[];
+} | {
+    valid: false;
+    metadata: null;
+    errors: string[];
+};
+//# sourceMappingURL=metadata.d.ts.map

package/library/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../source/metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1D,8DAA8D;AAC9D,eAAO,MAAM,cAAc,GAAU,UAAU,MAAM,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,SAAS,CAqCrF,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAiB9F,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,OAAO,KAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CA4D9J,CAAA"}

package/library/metadata.js

@@ -0,0 +1,110 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, relative } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/** Parse an xdocs file from disk into an XDocsFile object. */
+export const parseXDocsFile = async (filePath, cwd) => {
+    const content = await readFile(filePath, 'utf8');
+    const errors = [];
+    const { frontmatter, body } = extractFrontmatter(content);
+    let metadata = null;
+    if (frontmatter) {
+        let parsed;
+        try {
+            parsed = parseYaml(frontmatter);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(`Invalid YAML frontmatter: ${message}`);
+        }
+        if (parsed !== undefined && parsed !== null) {
+            const result = validateMetadata(parsed);
+            if (result.valid) {
+                metadata = result.metadata;
+            }
+            else {
+                errors.push(...result.errors);
+            }
+        }
+    }
+    return {
+        path: filePath,
+        relativePath: relative(cwd, filePath),
+        directory: dirname(filePath),
+        metadata,
+        body,
+        valid: metadata !== null && errors.length === 0,
+        errors,
+    };
+};
+/** Extract YAML frontmatter and body from a Markdown string. */
+export const extractFrontmatter = (content) => {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith('---')) {
+        return { frontmatter: null, body: content };
+    }
+    const endIndex = trimmed.indexOf('\n---', 3);
+    if (endIndex === -1) {
+        return { frontmatter: null, body: content };
+    }
+    const frontmatter = trimmed.slice(3, endIndex).trim();
+    const body = trimmed.slice(endIndex + 4).trim();
+    return { frontmatter, body };
+};
+/** Validate parsed YAML as XDocsMetadata. */
+export const validateMetadata = (parsed) => {
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        return { valid: false, metadata: null, errors: ['Frontmatter must be a YAML object.'] };
+    }
+    const record = parsed;
+    const errors = [];
+    if (typeof record['subject'] !== 'string' || record['subject'].length === 0) {
+        errors.push('Missing or invalid "subject" field. Expected a non-empty string.');
+    }
+    if (typeof record['description'] !== 'string' || record['description'].length === 0) {
+        errors.push('Missing or invalid "description" field. Expected a non-empty string.');
+    }
+    if (record['parent'] !== null && typeof record['parent'] !== 'string') {
+        errors.push('Invalid "parent" field. Expected a string or null.');
+    }
+    if (!Array.isArray(record['children'])) {
+        errors.push('Missing or invalid "children" field. Expected an array.');
+    }
+    else if (record['children'].some((child) => typeof child !== 'string')) {
+        errors.push('Invalid "children" field. All entries must be strings.');
+    }
+    if (typeof record['files'] !== 'object' || record['files'] === null || Array.isArray(record['files'])) {
+        errors.push('Missing or invalid "files" field. Expected an object mapping filenames to descriptions.');
+    }
+    if (!Array.isArray(record['tags'])) {
+        errors.push('Missing or invalid "tags" field. Expected an array of strings.');
+    }
+    else if (record['tags'].some((tag) => typeof tag !== 'string')) {
+        errors.push('Invalid "tags" field. All entries must be strings.');
+    }
+    if (!Array.isArray(record['flags'])) {
+        errors.push('Missing or invalid "flags" field. Expected an array of strings.');
+    }
+    else if (record['flags'].some((flag) => typeof flag !== 'string')) {
+        errors.push('Invalid "flags" field. All entries must be strings.');
+    }
+    if (errors.length > 0) {
+        return { valid: false, metadata: null, errors };
+    }
+    return {
+        valid: true,
+        errors: [],
+        metadata: {
+            subject: record['subject'],
+            description: record['description'],
+            parent: record['parent'] ?? null,
+            children: record['children'],
+            files: record['files'],
+            tags: record['tags'],
+            flags: record['flags'],
+            status: typeof record['status'] === 'string' ? record['status'] : undefined,
+        },
+    };
+};

package/library/prompts.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ *
+ * Prompt loader. Each .md file in prompts/ is imported as text at build time
+ * so that `bun build --compile` embeds them in the binary. Adding a new prompt
+ * requires two steps: create the .md file, then add an import here.
+ */
+import type { XDocsPrompt } from './types.js';
+/** All available prompts, keyed by name. */
+export declare const prompts: ReadonlyMap<string, XDocsPrompt>;
+/** Get a prompt by name or return undefined. */
+export declare const getPrompt: (name: string) => XDocsPrompt | undefined;
+/** Get all prompt names. */
+export declare const getPromptNames: () => string[];
+//# sourceMappingURL=prompts.d.ts.map

package/library/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../source/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA0B7C,4CAA4C;AAC5C,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CASjD,CAAA;AAEJ,gDAAgD;AAChD,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,WAAW,GAAG,SACpC,CAAA;AAEnB,4BAA4B;AAC5B,eAAO,MAAM,cAAc,QAAO,MAAM,EACnB,CAAA"}

package/library/prompts.js

@@ -0,0 +1,49 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ *
+ * Prompt loader. Each .md file in prompts/ is imported as text at build time
+ * so that `bun build --compile` embeds them in the binary. Adding a new prompt
+ * requires two steps: create the .md file, then add an import here.
+ */
+// @ts-expect-error -- Bun text import, no TS declaration needed
+import writeRaw from '../prompts/write.md' with { type: 'text' };
+// @ts-expect-error -- Bun text import, no TS declaration needed
+import updateRaw from '../prompts/update.md' with { type: 'text' };
+// @ts-expect-error -- Bun text import, no TS declaration needed
+import agentsRaw from '../prompts/agents.md' with { type: 'text' };
+// @ts-expect-error -- Bun text import, no TS declaration needed
+import generateRaw from '../prompts/generate.md' with { type: 'text' };
+import { extractFrontmatter } from './metadata.js';
+const rawFiles = [writeRaw, updateRaw, agentsRaw, generateRaw];
+/** Parse a raw prompt file into an XDocsPrompt. */
+const parsePrompt = (raw) => {
+    const { frontmatter, body } = extractFrontmatter(raw);
+    if (!frontmatter) {
+        throw new Error('Prompt file is missing YAML frontmatter.');
+    }
+    // Lightweight parse — prompts only have `name` and `description`.
+    const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    if (!nameMatch?.[1])
+        throw new Error('Prompt frontmatter missing "name" field.');
+    if (!descMatch?.[1])
+        throw new Error('Prompt frontmatter missing "description" field.');
+    return {
+        name: nameMatch[1].trim(),
+        description: descMatch[1].trim(),
+        body: body.trim(),
+    };
+};
+/** All available prompts, keyed by name. */
+export const prompts = (() => {
+    const map = new Map();
+    for (const raw of rawFiles) {
+        const prompt = parsePrompt(raw);
+        map.set(prompt.name, prompt);
+    }
+    return map;
+})();
+/** Get a prompt by name or return undefined. */
+export const getPrompt = (name) => prompts.get(name);
+/** Get all prompt names. */
+export const getPromptNames = () => [...prompts.keys()];

package/library/tree.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { XDocsFile, XDocsTreeNode, XDocsTreeValidation } from './types.js';
+/** Build a hierarchy tree from a list of xdocs files. */
+export declare const buildTree: (files: XDocsFile[]) => XDocsTreeNode;
+/** Validate tree integrity. */
+export declare const validateTree: (files: XDocsFile[]) => XDocsTreeValidation;
+/** Render a tree as an indented text string. */
+export declare const renderTree: (node: XDocsTreeNode, indent?: number) => string;
+/** Render a tree as Markdown. */
+export declare const renderTreeMarkdown: (node: XDocsTreeNode, indent?: number) => string;
+//# sourceMappingURL=tree.d.ts.map

package/library/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../source/tree.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAE/E,yDAAyD;AACzD,eAAO,MAAM,SAAS,GAAI,OAAO,SAAS,EAAE,KAAG,aA8D9C,CAAA;AAED,+BAA+B;AAC/B,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,EAAE,KAAG,mBAmCjD,CAAA;AAED,gDAAgD;AAChD,eAAO,MAAM,UAAU,GAAI,MAAM,aAAa,EAAE,eAAU,KAAG,MAe5D,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,GAAI,MAAM,aAAa,EAAE,eAAU,KAAG,MAWpE,CAAA"}

package/library/tree.js

@@ -0,0 +1,114 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+/** Build a hierarchy tree from a list of xdocs files. */
+export const buildTree = (files) => {
+    const nodeMap = new Map();
+    // Create nodes for every file with valid metadata
+    for (const file of files) {
+        if (!file.metadata)
+            continue;
+        nodeMap.set(file.metadata.subject, {
+            subject: file.metadata.subject,
+            description: file.metadata.description,
+            path: file.relativePath,
+            children: [],
+        });
+    }
+    // Find or create the root node
+    let root;
+    for (const file of files) {
+        if (!file.metadata)
+            continue;
+        if (file.metadata.parent === null) {
+            root = nodeMap.get(file.metadata.subject);
+            continue;
+        }
+        const parentNode = nodeMap.get(file.metadata.parent);
+        const childNode = nodeMap.get(file.metadata.subject);
+        if (parentNode && childNode) {
+            parentNode.children.push(childNode);
+        }
+    }
+    // Also add children declared in metadata but not yet linked
+    for (const file of files) {
+        if (!file.metadata)
+            continue;
+        const parentNode = nodeMap.get(file.metadata.subject);
+        if (!parentNode)
+            continue;
+        for (const childSubject of file.metadata.children) {
+            const childNode = nodeMap.get(childSubject);
+            if (childNode && !parentNode.children.includes(childNode)) {
+                parentNode.children.push(childNode);
+            }
+        }
+    }
+    if (!root) {
+        root = {
+            subject: '(root)',
+            description: 'No root xdocs file found.',
+            path: null,
+            children: [...nodeMap.values()].filter((node) => !files.some((f) => f.metadata && f.metadata.children.includes(node.subject))),
+        };
+    }
+    return root;
+};
+/** Validate tree integrity. */
+export const validateTree = (files) => {
+    const warnings = [];
+    const errors = [];
+    const subjects = new Set();
+    for (const file of files) {
+        if (!file.metadata)
+            continue;
+        if (subjects.has(file.metadata.subject)) {
+            errors.push(`Duplicate subject: "${file.metadata.subject}" in ${file.relativePath}`);
+        }
+        subjects.add(file.metadata.subject);
+    }
+    for (const file of files) {
+        if (!file.metadata)
+            continue;
+        // Check parent references
+        if (file.metadata.parent !== null && !subjects.has(file.metadata.parent)) {
+            errors.push(`Orphan subject: "${file.metadata.subject}" references non-existent parent "${file.metadata.parent}" in ${file.relativePath}`);
+        }
+        // Check children references
+        for (const child of file.metadata.children) {
+            if (!subjects.has(child)) {
+                warnings.push(`Missing child: "${file.metadata.subject}" references non-existent child "${child}" in ${file.relativePath}`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        warnings,
+        errors,
+    };
+};
+/** Render a tree as an indented text string. */
+export const renderTree = (node, indent = 0) => {
+    const prefix = '  '.repeat(indent);
+    const lines = [];
+    if (indent === 0) {
+        lines.push(`${node.subject}`);
+    }
+    else {
+        lines.push(`${prefix}${node.subject}`);
+    }
+    for (const child of node.children) {
+        lines.push(renderTree(child, indent + 1));
+    }
+    return lines.join('\n');
+};
+/** Render a tree as Markdown. */
+export const renderTreeMarkdown = (node, indent = 0) => {
+    const prefix = '  '.repeat(indent);
+    const lines = [];
+    lines.push(`${prefix}- **${node.subject}**: ${node.description}`);
+    for (const child of node.children) {
+        lines.push(renderTreeMarkdown(child, indent + 1));
+    }
+    return lines.join('\n');
+};

package/library/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+/** Supported output formats for CLI commands. */
+export type XDocsFormat = 'text' | 'json' | 'markdown';
+/** AI behavior mode for documentation updates. */
+export type XDocsAiMode = 'prompt' | 'auto';
+/** Command names recognized by the CLI. */
+export type XDocsCommand = 'init' | 'scan' | 'generate' | 'prompt' | 'merge' | 'tree' | 'list';
+/** Raw configuration as parsed from xdocs.config.toml. */
+export type XDocsRawConfig = Partial<{
+    schema: number;
+    extensions: Partial<{
+        supported: string[];
+    }>;
+    ai: Partial<{
+        mode: string;
+    }>;
+    scan: Partial<{
+        exclude: string[];
+    }>;
+    project: Partial<{
+        name: string;
+    }>;
+}>;
+/** Normalized, validated configuration. */
+export type XDocsConfig = {
+    schema: 1;
+    cwd: string;
+    configPath?: string;
+    extensions: {
+        supported: string[];
+    };
+    ai: {
+        mode: XDocsAiMode;
+    };
+    scan: {
+        exclude: string[];
+    };
+    project: {
+        name: string;
+    };
+};
+/** YAML frontmatter metadata from an xdocs file. */
+export type XDocsMetadata = {
+    subject: string;
+    description: string;
+    parent: string | null;
+    children: string[];
+    files: Record<string, string>;
+    tags: string[];
+    flags: string[];
+    status?: string;
+};
+/** A discovered xdocs file with its path and parsed metadata. */
+export type XDocsFile = {
+    path: string;
+    relativePath: string;
+    directory: string;
+    metadata: XDocsMetadata | null;
+    body: string;
+    valid: boolean;
+    errors: string[];
+};
+/** A node in the xdocs hierarchy tree. */
+export type XDocsTreeNode = {
+    subject: string;
+    description: string;
+    path: string | null;
+    children: XDocsTreeNode[];
+};
+/** Result of a tree integrity check. */
+export type XDocsTreeValidation = {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+};
+/** Parsed CLI arguments. */
+export type XDocsParsedArgs = {
+    command: string | undefined;
+    positionals: string[];
+    flags: Record<string, string | boolean | string[]>;
+};
+/** Options passed through the CLI to command handlers. */
+export type XDocsCliOptions = {
+    cwd: string;
+    config?: string;
+    format: XDocsFormat;
+    verbose: boolean;
+};
+/** Scan result for a single directory. */
+export type XDocsScanResult = {
+    totalFiles: number;
+    totalDirectories: number;
+    coveredDirectories: number;
+    uncoveredDirectories: number;
+    xdocsFiles: XDocsFile[];
+    uncoveredPaths: string[];
+};
+/** Available prompt names for xdocs prompt --name. */
+export type XDocsPromptName = 'write' | 'update' | 'agents' | 'generate';
+/** A parsed prompt loaded from a .md file. */
+export type XDocsPrompt = {
+    name: string;
+    description: string;
+    body: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/library/types.d.ts.map

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

package/library/types.js

@@ -0,0 +1,4 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export {};