@doxbrix/doxloop 0.1.0

package/dist/validation.js

@@ -0,0 +1,478 @@
+import { access, readFile } from 'node:fs/promises';
+import { dirname, extname, join, relative, resolve } from 'node:path';
+import { pathExists, resolveContainedDirectory } from './fs.js';
+import { loadGeneratorAdapter } from './generators.js';
+import { loadPages, loadProject, loadSiteConfig, pageId, readPage, relativePath, siteConfigPath, } from './project.js';
+export async function validateProject(root) {
+    const issues = [];
+    const project = await loadProject(root);
+    const contentRoot = await resolveContainedDirectory(root, project.contentDir, 'Validation content directory');
+    const files = await loadPages(root, project);
+    const pages = files.map((path) => pageId(contentRoot, path));
+    const pageSet = new Set(pages);
+    const adapter = project.generator === 'doxbrix'
+        ? undefined
+        : await loadGeneratorAdapter(root, project);
+    if (project.generator === 'doxbrix') {
+        const site = await loadSiteConfig(root, project);
+        const configFile = relativePath(root, await siteConfigPath(root, project));
+        validateDoxbrixNavigation(site.spaces, pageSet, pages, configFile, issues);
+        await validateDoxbrixTheme(site.theme, contentRoot, configFile, issues);
+    }
+    else {
+        issues.push(...(await adapter.validate({
+            root,
+            contentRoot,
+            project,
+            pages: files,
+            pageIds: pages,
+        })));
+    }
+    for (const path of files) {
+        const file = relativePath(root, path);
+        const raw = await readFile(path, 'utf8');
+        const page = adapter?.readPage ? await adapter.readPage(path) : await readPage(path);
+        if (page.title === '') {
+            issues.push(error('missing-title', 'Page frontmatter needs a title.', file));
+        }
+        if (page.description === undefined || page.description === '') {
+            issues.push(error('missing-description', 'Page frontmatter needs an outcome-focused description.', file));
+        }
+        if (page.body.trim() === '') {
+            issues.push(error('empty-page', 'Page content cannot be empty.', file));
+        }
+        if ((adapter?.project.contentFormat ?? 'markdown') === 'markdown') {
+            const fences = raw.match(/^```/gm)?.length ?? 0;
+            if (fences % 2 !== 0) {
+                issues.push(error('code-fence', 'Code fences are not balanced.', file));
+            }
+        }
+        if (project.generator === 'doxbrix') {
+            issues.push(...validateDoxbrixComponents(raw, file));
+        }
+        issues.push(...validateProfessionalContent(page.body, raw, file));
+        if ((adapter?.project.contentFormat ?? 'markdown') === 'markdown') {
+            issues.push(...(await validateLinks(path, contentRoot, raw, root, adapter)));
+        }
+    }
+    const errors = issues.filter((issue) => issue.severity === 'error').length;
+    const warnings = issues.length - errors;
+    return { issues, pages, errors, warnings };
+}
+function validateDoxbrixNavigation(spaces, pageSet, pages, configFile, issues) {
+    const navigation = new Set();
+    if (spaces.length === 0) {
+        issues.push(error('navigation-spaces', 'Doxbrix docs.json needs at least one space.', configFile));
+    }
+    const visit = (nodes, location) => {
+        for (const [index, node] of nodes.entries()) {
+            const nodeLocation = `${location} item ${index + 1}`;
+            if (!node || typeof node !== 'object' || typeof node.type !== 'string') {
+                issues.push(error('navigation-node', `${nodeLocation} is invalid.`, configFile));
+                continue;
+            }
+            if (node.type === 'page') {
+                if (typeof node.file !== 'string' || node.file.trim() === '') {
+                    issues.push(error('navigation-page', `${nodeLocation} needs a page file.`, configFile));
+                    continue;
+                }
+                if (navigation.has(node.file)) {
+                    issues.push(error('duplicate-navigation', `"${node.file}" appears more than once.`, configFile));
+                }
+                navigation.add(node.file);
+                if (!pageSet.has(node.file)) {
+                    issues.push(error('missing-page', `Navigation references missing page "${node.file}".`, configFile));
+                }
+            }
+            else if (node.type === 'group') {
+                if (typeof node.label !== 'string' || !Array.isArray(node.items)) {
+                    issues.push(error('navigation-group', `${nodeLocation} needs a label and items array.`, configFile));
+                    continue;
+                }
+                visit(node.items, `group "${node.label}"`);
+            }
+            else if (!['label', 'divider', 'link', 'api'].includes(node.type)) {
+                issues.push(error('navigation-node', `${nodeLocation} has unsupported type "${node.type}".`, configFile));
+            }
+        }
+    };
+    for (const [index, space] of spaces.entries()) {
+        if (typeof space.name !== 'string' || !Array.isArray(space.nav)) {
+            issues.push(error('navigation-space', `Space ${index + 1} must have a name and nav array.`, configFile));
+            continue;
+        }
+        visit(space.nav, `space "${space.name}"`);
+    }
+    for (const id of pages) {
+        if (!navigation.has(id)) {
+            issues.push(error('unnavigated-page', `Page "${id}" is not in Doxbrix navigation.`));
+        }
+    }
+}
+async function validateDoxbrixTheme(value, contentRoot, configFile, issues) {
+    if (value === undefined)
+        return;
+    if (value === 'light' || value === 'dark' || value === 'system')
+        return;
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        issues.push(error('theme-config', 'Doxbrix theme must be an object.', configFile));
+        return;
+    }
+    const theme = value;
+    const colorKeys = [
+        'primaryColor',
+        'lightColor',
+        'darkColor',
+        'backgroundColorLight',
+        'backgroundColorDark',
+    ];
+    for (const key of colorKeys) {
+        const color = theme[key];
+        if (color !== undefined && (typeof color !== 'string' || !/^#[0-9a-f]{6}$/i.test(color))) {
+            issues.push(error('theme-color', `Doxbrix theme.${key} must be a six-digit hex color.`, configFile));
+        }
+    }
+    if (theme.mode !== undefined &&
+        !['light', 'dark', 'system'].includes(String(theme.mode))) {
+        issues.push(error('theme-mode', 'Doxbrix theme.mode must be light, dark, or system.', configFile));
+    }
+    for (const key of ['font', 'headingFont', 'codeFont']) {
+        const font = theme[key];
+        if (font !== undefined && (typeof font !== 'string' || font.trim() === '')) {
+            issues.push(error('theme-font', `Doxbrix theme.${key} must be a font-family name.`, configFile));
+        }
+    }
+    if (theme.logoHref !== undefined &&
+        (typeof theme.logoHref !== 'string' || !isThemeAssetReference(theme.logoHref))) {
+        issues.push(error('theme-link', 'Doxbrix theme.logoHref must be an HTTPS or root-relative URL.', configFile));
+    }
+    for (const key of [
+        'logoLight',
+        'logoDark',
+        'favicon',
+        'faviconLight',
+        'faviconDark',
+        'backgroundImage',
+    ]) {
+        const asset = theme[key];
+        if (asset === undefined)
+            continue;
+        if (typeof asset !== 'string' || !isThemeAssetReference(asset)) {
+            issues.push(error('theme-asset', `Doxbrix theme.${key} must be an HTTPS or root-relative asset path.`, configFile));
+            continue;
+        }
+        if (asset.startsWith('/') && !(await localThemeAssetExists(contentRoot, asset))) {
+            issues.push(error('missing-theme-asset', `Doxbrix theme.${key} is missing "${asset}".`, configFile));
+        }
+    }
+    if (theme.fontSources !== undefined && !Array.isArray(theme.fontSources)) {
+        issues.push(error('theme-font-source', 'Doxbrix theme.fontSources must be an array.', configFile));
+        return;
+    }
+    for (const [index, entry] of (theme.fontSources ?? []).entries()) {
+        if (!entry || typeof entry !== 'object') {
+            issues.push(error('theme-font-source', `Doxbrix font source ${index + 1} is invalid.`, configFile));
+            continue;
+        }
+        const source = entry;
+        if (typeof source.family !== 'string' ||
+            source.family.trim() === '' ||
+            typeof source.source !== 'string' ||
+            !isThemeAssetReference(source.source)) {
+            issues.push(error('theme-font-source', `Doxbrix font source ${index + 1} needs a family and HTTPS or root-relative source.`, configFile));
+            continue;
+        }
+        if (source.source.startsWith('/') &&
+            !(await localThemeAssetExists(contentRoot, source.source))) {
+            issues.push(error('missing-theme-asset', `Doxbrix font source ${index + 1} is missing "${source.source}".`, configFile));
+        }
+    }
+}
+function isThemeAssetReference(value) {
+    return value.startsWith('/') || /^https:\/\//i.test(value);
+}
+async function localThemeAssetExists(contentRoot, reference) {
+    const path = resolve(contentRoot, `.${reference}`);
+    if (relative(contentRoot, path).startsWith('..'))
+        return false;
+    return pathExists(path);
+}
+const DOXBRIX_CONTAINER_COMPONENTS = [
+    'Info',
+    'Note',
+    'Tip',
+    'Check',
+    'Warning',
+    'Danger',
+    'Steps',
+    'Step',
+    'Tabs',
+    'Tab',
+    'Accordion',
+    'AccordionGroup',
+    'AccordionItem',
+    'Expandable',
+    'CardGroup',
+    'Card',
+    'Columns',
+    'Column',
+    'CodeGroup',
+    'Terminal',
+    'Frame',
+    'Update',
+    'Mermaid',
+    'Math',
+    'ApiEndpoint',
+    'Param',
+    'Response',
+    'ParameterTable',
+    'ResponseExample',
+];
+function validateDoxbrixComponents(content, file) {
+    const issues = [];
+    const withoutFences = content.replace(/```[\s\S]*?```/g, '');
+    for (const name of DOXBRIX_CONTAINER_COMPONENTS) {
+        const openings = withoutFences.match(new RegExp(`<${name}(?:\\s[^>]*)?(?<!/)>`, 'g'))?.length ?? 0;
+        const closings = withoutFences.match(new RegExp(`</${name}>`, 'g'))?.length ?? 0;
+        if (openings !== closings) {
+            issues.push(error('component-tag', `<${name}> tags are not balanced (${openings} opening, ${closings} closing).`, file));
+        }
+    }
+    issues.push(...validateDoxbrixApiEndpoints(withoutFences, file));
+    return issues;
+}
+function validateDoxbrixApiEndpoints(content, file) {
+    const issues = [];
+    for (const [index, match] of [
+        ...content.matchAll(/<ApiEndpoint\b([^>]*)>([\s\S]*?)<\/ApiEndpoint>/g),
+    ].entries()) {
+        const label = `API endpoint ${index + 1}`;
+        const attributes = componentAttributes(match[1] ?? '');
+        const body = match[2] ?? '';
+        const method = stringAttribute(attributes.method).toUpperCase();
+        const path = stringAttribute(attributes.path);
+        const baseUrl = stringAttribute(attributes.baseUrl);
+        if (!['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(method)) {
+            issues.push(error('api-endpoint-method', `${label} needs method GET, POST, PUT, PATCH, or DELETE.`, file));
+        }
+        if (!path.startsWith('/')) {
+            issues.push(error('api-endpoint-path', `${label} needs an absolute API path beginning with "/".`, file));
+        }
+        if (!/^https?:\/\/[^/\s]+/i.test(baseUrl)) {
+            issues.push(error('api-endpoint-base-url', `${label} needs an absolute HTTP or HTTPS baseUrl so Doxbrix can generate the request example.`, file));
+        }
+        if (stringAttribute(attributes.summary) === '' ||
+            stringAttribute(attributes.description) === '') {
+            issues.push(warning('api-endpoint-description', `${label} should include both summary and description attributes.`, file));
+        }
+        const pathParameters = new Set();
+        const paramPattern = /<Param\b([^>]*)>([\s\S]*?)<\/Param>/g;
+        for (const [paramIndex, paramMatch] of [
+            ...body.matchAll(paramPattern),
+        ].entries()) {
+            const param = componentAttributes(paramMatch[1] ?? '');
+            const name = stringAttribute(param.name);
+            const location = stringAttribute(param.in);
+            const type = stringAttribute(param.type);
+            if (name === '' || type === '' || !['path', 'query', 'header', 'body'].includes(location)) {
+                issues.push(error('api-endpoint-param', `${label} parameter ${paramIndex + 1} needs name, type, and in="path|query|header|body".`, file));
+            }
+            if (location === 'path') {
+                pathParameters.add(name);
+                if (!trueAttribute(param.required)) {
+                    issues.push(error('api-endpoint-path-param', `${label} path parameter "${name}" must set required.`, file));
+                }
+            }
+            if (stringAttribute(param.example) === '') {
+                issues.push(warning('api-endpoint-param-example', `${label} parameter "${name || paramIndex + 1}" should include a verified example for the generated request.`, file));
+            }
+        }
+        for (const placeholder of path.matchAll(/\{([^}]+)}/g)) {
+            const name = placeholder[1] ?? '';
+            if (!pathParameters.has(name)) {
+                issues.push(error('api-endpoint-path-param', `${label} path placeholder "{${name}}" needs a matching required <Param in="path">.`, file));
+            }
+        }
+        const responses = [...body.matchAll(/<Response\b([^>]*)>([\s\S]*?)<\/Response>/g)];
+        if (responses.length === 0) {
+            issues.push(error('api-endpoint-response', `${label} needs at least one <Response> with a verified example body.`, file));
+        }
+        for (const [responseIndex, responseMatch] of responses.entries()) {
+            const response = componentAttributes(responseMatch[1] ?? '');
+            const status = stringAttribute(response.status);
+            if (!/^\d{3}$/.test(status)) {
+                issues.push(error('api-endpoint-response', `${label} response ${responseIndex + 1} needs a numeric status such as status={200}.`, file));
+            }
+            if (stringAttribute(response.contentType) === '' ||
+                stringAttribute(response.description) === '') {
+                issues.push(warning('api-endpoint-response-metadata', `${label} response ${status || responseIndex + 1} should include contentType and description.`, file));
+            }
+            if ((responseMatch[2] ?? '').trim() === '') {
+                issues.push(error('api-endpoint-response', `${label} response ${status || responseIndex + 1} needs an example body.`, file));
+            }
+        }
+    }
+    return issues;
+}
+function componentAttributes(source) {
+    const attributes = {};
+    const pattern = /([A-Za-z_][\w-]*)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|\{([^}]*)\}))?/g;
+    for (const match of source.matchAll(pattern)) {
+        const name = match[1];
+        if (name === undefined)
+            continue;
+        attributes[name] =
+            match[2] ?? match[3] ?? match[4]?.trim().replace(/^['"]|['"]$/g, '') ?? true;
+    }
+    return attributes;
+}
+function stringAttribute(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function trueAttribute(value) {
+    return value === true || value === 'true';
+}
+function validateProfessionalContent(body, raw, file) {
+    const issues = [];
+    const prose = stripCodeFences(body);
+    if (/(?:<!--|\{\/\*)\s*doxloop:starter-page\s*(?:-->|\*\/\})/i.test(prose) ||
+        /\b(?:replace this starter|the authoring agent will replace this starter)\b/i.test(prose)) {
+        issues.push(error('starter-content', 'Replace generated starter content before validation or publishing.', file));
+    }
+    if (/^\s*(?:TODO|TBD|FIXME)(?:\s*:|\b)/im.test(prose)) {
+        issues.push(error('unresolved-placeholder', 'Resolve TODO, TBD, or FIXME placeholder content.', file));
+    }
+    const secretPatterns = [
+        {
+            pattern: /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/,
+            label: 'private key',
+        },
+        { pattern: /\bAKIA[0-9A-Z]{16}\b/, label: 'AWS access key' },
+        {
+            pattern: /\bgh[pousr]_[A-Za-z0-9]{36,}\b/,
+            label: 'GitHub token',
+        },
+    ];
+    for (const secret of secretPatterns) {
+        if (secret.pattern.test(raw)) {
+            issues.push(error('sensitive-content', `Remove the apparent ${secret.label} from reader-facing content.`, file));
+        }
+    }
+    if (/\/(?:Users|home)\/[A-Za-z0-9._-]+\//.test(prose) ||
+        /[A-Za-z]:\\Users\\[^\\\s]+\\/i.test(prose)) {
+        issues.push(error('private-path', 'Replace the local user path with a portable placeholder or project-relative path.', file));
+    }
+    for (const match of prose.matchAll(/<img\b[^>]*>/gi)) {
+        if (!/\balt\s*=/i.test(match[0])) {
+            issues.push(error('missing-image-alt', 'HTML images need an alt attribute.', file));
+        }
+    }
+    if (/!\[\s*]\([^)]+\)/.test(prose)) {
+        issues.push(warning('empty-image-alt', 'Confirm that every image with empty alternative text is decorative.', file));
+    }
+    for (const match of prose.matchAll(/(?<!!)\[([^\]]+)]\([^)]+\)/g)) {
+        const label = match[1]?.trim().toLowerCase();
+        if (label !== undefined &&
+            ['click here', 'here', 'read more', 'learn more', 'this link'].includes(label)) {
+            issues.push(warning('weak-link-text', `Replace vague link text "${match[1]}" with a descriptive destination or action.`, file));
+        }
+    }
+    let previousHeading = 0;
+    for (const match of prose.matchAll(/^(#{1,6})\s+\S.*$/gm)) {
+        const level = match[1]?.length ?? 0;
+        if (previousHeading > 0 && level > previousHeading + 1) {
+            issues.push(warning('heading-order', `Heading level jumps from h${previousHeading} to h${level}.`, file));
+        }
+        previousHeading = level;
+    }
+    let insideFence = false;
+    for (const line of body.split(/\r?\n/)) {
+        const fence = line.match(/^```(.*)$/);
+        if (!fence)
+            continue;
+        if (!insideFence && fence[1]?.trim() === '') {
+            issues.push(warning('code-language', 'Add a language identifier to the fenced code block when known.', file));
+        }
+        insideFence = !insideFence;
+    }
+    return issues;
+}
+function stripCodeFences(content) {
+    return content.replace(/```[\s\S]*?```/g, '');
+}
+async function validateLinks(pagePath, contentRoot, content, projectRoot, adapter) {
+    const issues = [];
+    const pattern = /!?\[[^\]]*]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g;
+    for (const match of content.matchAll(pattern)) {
+        const href = match[1];
+        if (href === undefined ||
+            href.startsWith('#') ||
+            /^[a-z][a-z0-9+.-]*:/i.test(href)) {
+            continue;
+        }
+        let decoded;
+        try {
+            decoded = decodeURIComponent(href.split('#')[0] ?? '');
+        }
+        catch {
+            issues.push(error('invalid-link', `Local link is not valid URL syntax: ${href}`, relativePath(projectRoot, pagePath)));
+            continue;
+        }
+        if (decoded === '')
+            continue;
+        const base = decoded.startsWith('/')
+            ? resolve(contentRoot, `.${decoded}`)
+            : resolve(dirname(pagePath), decoded);
+        const candidates = extname(base) === ''
+            ? [base, `${base}.md`, `${base}.mdx`, join(base, 'index.md'), join(base, 'index.mdx')]
+            : [base];
+        const generatorAsset = adapter?.resolveLocalAsset?.({
+            root: projectRoot,
+            contentRoot,
+            pagePath,
+            reference: decoded,
+        });
+        if (generatorAsset)
+            candidates.push(generatorAsset);
+        let found = false;
+        for (const candidate of candidates) {
+            const relation = relative(contentRoot, candidate);
+            const projectRelation = relative(projectRoot, candidate);
+            if (relation.startsWith('..') &&
+                (candidate !== generatorAsset || projectRelation.startsWith('..'))) {
+                continue;
+            }
+            try {
+                await access(candidate);
+                found = true;
+                break;
+            }
+            catch {
+                // Try the next supported form.
+            }
+        }
+        if (!found) {
+            issues.push(error('broken-link', `Local link target does not exist: ${decoded}`, relativePath(projectRoot, pagePath)));
+        }
+    }
+    return issues;
+}
+export function formatValidation(result) {
+    const lines = result.issues.map((issue) => {
+        const location = issue.file ? `${issue.file}: ` : '';
+        return `${issue.severity === 'error' ? 'error' : 'warning'} ${issue.code} ${location}${issue.message}`;
+    });
+    lines.push(`${result.pages.length} page${result.pages.length === 1 ? '' : 's'}, ${result.errors} error${result.errors === 1 ? '' : 's'}, ${result.warnings} warning${result.warnings === 1 ? '' : 's'}`);
+    return lines.join('\n');
+}
+function error(code, message, file) {
+    return file === undefined
+        ? { severity: 'error', code, message }
+        : { severity: 'error', code, message, file };
+}
+function warning(code, message, file) {
+    return file === undefined
+        ? { severity: 'warning', code, message }
+        : { severity: 'warning', code, message, file };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const PACKAGE_NAME: string;
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,QAAgB,CAAA;AACzC,eAAO,MAAM,OAAO,QAAmB,CAAA"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { readFileSync } from 'node:fs';
+const metadata = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+export const PACKAGE_NAME = metadata.name;
+export const VERSION = metadata.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC7B,CAAA;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAA;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA"}

package/docs/agent-compatibility.md

@@ -0,0 +1,41 @@
+# Agent compatibility
+
+Doxloop supports Codex, Claude Code, and Gemini CLI. It discovers executables on
+`PATH` or accepts an explicit `--agent`.
+
+## Invocation modes
+
+| Workflow | Codex | Claude Code | Gemini CLI |
+| --- | --- | --- | --- |
+| Create/update | Interactive prompt | Interactive prompt | Interactive `-i` prompt |
+| Review | Read-only ephemeral execution | Print with plan permissions | Plan approval mode |
+| External IDE | `--print` prepared prompt | `--print` prepared prompt | `--print` prepared prompt |
+
+Review is deliberately non-interactive so it can remain read-only. Create may
+pause once for consolidated reader or scope decisions.
+
+Doxloop forwards `--model` using each CLI's native model option. The
+`--reasoning` option is Codex-only and accepts `minimal`, `low`, `medium`,
+`high`, or `xhigh`.
+
+## Project skills
+
+Initialization installs the shared authoring skill and selected format skill
+under `.agents/skills` for Codex and Gemini and `.claude/skills` for Claude
+Code. Use:
+
+```bash
+doxloop agent status
+doxloop agent update
+```
+
+`review` does not install or replace skills because that would mutate the
+project. Run `doxloop agent setup` before review if skills were removed.
+
+## Compatibility policy
+
+Agent CLIs evolve independently. Release checks validate argument construction,
+and optional real-agent evaluations exercise installed CLIs. A release should
+record the tested CLI versions in its release notes. When an invocation fails,
+run the agent directly to confirm its installed version and then use
+`doxloop create --print` as a version-independent fallback.

package/docs/ci-and-automation.md

@@ -0,0 +1,56 @@
+# CI and automation
+
+Deterministic validation is suitable for pull requests. Agent authoring is
+optional because it may require credentials, model access, and interactive
+decisions.
+
+## Validate in CI
+
+```bash
+pnpm install --frozen-lockfile
+doxloop test
+```
+
+`doxloop test` exits with status 1 when validation errors remain. Warnings are
+reported but do not change the exit status.
+
+Use structured output when another tool consumes the result:
+
+```bash
+doxloop test --format json > doxloop-validation.json
+doxloop status --format json
+```
+
+Run the selected generator's strict build after Doxloop validation. Obtain the
+command and output directory with:
+
+```bash
+doxloop generator doctor
+doxloop generator info <generator>
+```
+
+## Agent evaluations
+
+```bash
+pnpm eval:agents -- --agent codex --case cli
+```
+
+Real-agent evaluations run reviews in read-only/plan mode. A case must:
+
+- exit successfully;
+- identify the required behavior signals;
+- cite enough configured source evidence;
+- prioritize findings;
+- report a score out of 100; and
+- leave the fixture project byte-for-byte unchanged.
+
+Evaluation output is written below the Git-ignored `evals/results/` directory.
+Use a scheduled or manually approved job for model-backed evaluations; keep the
+deterministic typecheck, tests, skill validation, build, and package checks on
+every pull request.
+
+## Publishing
+
+Never run `doxloop deploy` in an untrusted pull-request context. Use protected
+environments and short-lived or scoped credentials. Run `doxloop deploy
+--dry-run` before an approved deployment.