@doxbrix/doxloop 0.1.0

package/dist/sync.js

@@ -0,0 +1,221 @@
+import { execFile } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { lstat, readFile, readlink, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { pathExists, readJson } from './fs.js';
+export const SYNC_STATE_FILE = join('.doxloop', 'sync-state.json');
+const MAX_LISTED_FILES = 40;
+const run = promisify(execFile);
+export async function readSyncState(root) {
+    const path = join(root, SYNC_STATE_FILE);
+    if (!(await pathExists(path)))
+        return { schemaVersion: 1, sources: {} };
+    const state = await readJson(path);
+    if (state.schemaVersion !== 1 || !isSourceRecords(state.sources)) {
+        return { schemaVersion: 1, sources: {} };
+    }
+    return { schemaVersion: 1, sources: state.sources };
+}
+export async function recordSyncState(root, sources) {
+    const state = { schemaVersion: 1, sources: {} };
+    for (const source of sources) {
+        const commit = await headCommit(resolve(root, source.path));
+        if (commit) {
+            const sourcePath = resolve(root, source.path);
+            state.sources[source.name] = {
+                commit,
+                recordedAt: new Date().toISOString(),
+                contentFingerprint: await sourceContentFingerprint(sourcePath),
+            };
+        }
+    }
+    await writeFile(join(root, SYNC_STATE_FILE), `${JSON.stringify(state, null, 2)}\n`, 'utf8');
+    return state;
+}
+export async function collectSourceChanges(root, sources) {
+    const state = await readSyncState(root);
+    const changes = [];
+    for (const source of sources) {
+        const path = resolve(root, source.path);
+        if (!(await pathExists(path))) {
+            changes.push({ ...source, kind: 'missing-path' });
+            continue;
+        }
+        const head = await headCommit(path);
+        if (!head) {
+            changes.push({ ...source, kind: 'not-git' });
+            continue;
+        }
+        const uncommittedFiles = await uncommittedChanges(path);
+        const contentFingerprint = await sourceContentFingerprint(path);
+        const record = state.sources[source.name];
+        if (!record) {
+            changes.push({ ...source, kind: 'no-baseline', head, uncommittedFiles });
+            continue;
+        }
+        if (!(await commitExists(path, record.commit))) {
+            changes.push({ ...source, kind: 'baseline-lost', head, uncommittedFiles });
+            continue;
+        }
+        const matchesRecordedContent = record.contentFingerprint !== undefined &&
+            record.contentFingerprint === contentFingerprint;
+        const changedFiles = matchesRecordedContent
+            ? []
+            : await committedChanges(path, record.commit);
+        changes.push({
+            ...source,
+            kind: matchesRecordedContent || (changedFiles.length === 0 && uncommittedFiles.length === 0)
+                ? 'unchanged'
+                : 'changed',
+            baseline: record.commit,
+            head,
+            changedFiles,
+            uncommittedFiles: matchesRecordedContent ? [] : uncommittedFiles,
+        });
+    }
+    return changes;
+}
+export function formatSourceChanges(changes) {
+    if (changes.length === 0)
+        return '';
+    const sections = changes.map((change) => {
+        const heading = `Source "${change.name}" (${change.path})`;
+        switch (change.kind) {
+            case 'missing-path':
+                return `${heading}: the configured path does not exist. Report this instead of guessing.`;
+            case 'not-git':
+                return `${heading}: not a Git repository, so no change baseline is available. Inspect the source directly.`;
+            case 'no-baseline':
+                return withUncommitted(`${heading}: no documentation sync baseline is recorded yet. Inspect the source directly; a baseline is recorded when this task completes.`, change.uncommittedFiles);
+            case 'baseline-lost':
+                return withUncommitted(`${heading}: the recorded baseline commit no longer exists (history rewritten?). Inspect the source directly; the baseline is re-recorded when this task completes.`, change.uncommittedFiles);
+            case 'unchanged':
+                return withUncommitted(`${heading}: no source-content changes since the last documentation sync (${short(change.baseline)}).`, change.uncommittedFiles);
+            case 'changed':
+                return withUncommitted(change.changedFiles.length > 0
+                    ? `${heading}: changed since the last documentation sync (${short(change.baseline)} -> ${short(change.head)}).\nCommitted changes:\n${fileList(change.changedFiles)}\nInspect details with \`git -C ${change.path} diff ${short(change.baseline)}..HEAD -- <file>\`.`
+                    : `${heading}: the working tree changed since the last documentation sync (${short(change.baseline)}).`, change.uncommittedFiles);
+        }
+    });
+    return `Source changes since the last documentation sync:\n\n${sections.join('\n\n')}`;
+}
+function withUncommitted(text, uncommittedFiles) {
+    if (uncommittedFiles.length === 0)
+        return text;
+    return `${text}\nUncommitted working-tree changes:\n${fileList(uncommittedFiles)}`;
+}
+function fileList(files) {
+    const listed = files.slice(0, MAX_LISTED_FILES).map((file) => `- ${file}`);
+    if (files.length > MAX_LISTED_FILES) {
+        listed.push(`- ...and ${files.length - MAX_LISTED_FILES} more files`);
+    }
+    return listed.join('\n');
+}
+function short(commit) {
+    return commit.slice(0, 12);
+}
+async function headCommit(path) {
+    const output = await git(path, ['rev-parse', 'HEAD']);
+    return output?.trim() || undefined;
+}
+async function commitExists(path, commit) {
+    return (await git(path, ['cat-file', '-e', `${commit}^{commit}`])) !== undefined;
+}
+async function committedChanges(path, baseline) {
+    const output = await git(path, [
+        'diff',
+        '--name-status',
+        `${baseline}..HEAD`,
+        '--',
+        '.',
+    ]);
+    return lines(output);
+}
+async function uncommittedChanges(path) {
+    const output = await git(path, ['status', '--porcelain', '--', '.']);
+    return lines(output).map((line) => line.trim());
+}
+async function sourceContentFingerprint(path) {
+    const output = await git(path, [
+        'ls-files',
+        '-co',
+        '--exclude-standard',
+        '-z',
+    ]);
+    const files = (output ?? '').split('\0').filter(Boolean).sort();
+    const hash = createHash('sha256');
+    for (const file of files) {
+        if (isSensitiveSourcePath(file))
+            continue;
+        const absolute = resolve(path, file);
+        let content;
+        try {
+            const stats = await lstat(absolute);
+            if (stats.isSymbolicLink()) {
+                content = `link:${await readlink(absolute)}`;
+            }
+            else if (stats.isFile()) {
+                content = await readFile(absolute);
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                continue;
+            throw error;
+        }
+        hash.update(file);
+        hash.update('\0');
+        if (content !== undefined)
+            hash.update(content);
+        hash.update('\0');
+    }
+    return hash.digest('hex');
+}
+function isSensitiveSourcePath(path) {
+    const segments = path.toLowerCase().split(/[\\/]/);
+    const name = segments.at(-1) ?? '';
+    return (segments.includes('.ssh') ||
+        (name === '.env' || (name.startsWith('.env.') && name !== '.env.example')) ||
+        name === 'credentials' ||
+        name === 'credentials.json' ||
+        name === 'id_rsa' ||
+        name === 'id_ed25519' ||
+        name.endsWith('.key') ||
+        name.endsWith('.pem') ||
+        name.endsWith('.p12') ||
+        name.endsWith('.pfx'));
+}
+function lines(output) {
+    return (output ?? '')
+        .split('\n')
+        .map((line) => line.trimEnd())
+        .filter(Boolean);
+}
+async function git(path, args) {
+    try {
+        const result = await run('git', ['-C', path, ...args], {
+            maxBuffer: 16 * 1024 * 1024,
+        });
+        return result.stdout;
+    }
+    catch {
+        // Missing git, not a repository, or an unknown commit all mean the same
+        // thing here: no baseline information is available for this source.
+        return undefined;
+    }
+}
+function isSourceRecords(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        Object.values(value).every((record) => record !== null &&
+            typeof record === 'object' &&
+            typeof record.commit === 'string' &&
+            typeof record.recordedAt === 'string' &&
+            (record.contentFingerprint ===
+                undefined ||
+                typeof record
+                    .contentFingerprint === 'string')));
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+export type AgentName = 'codex' | 'claude' | 'gemini';
+export type GeneratorName = 'doxbrix' | 'docusaurus' | 'mkdocs' | 'sphinx' | 'hugo' | 'vitepress' | 'markdoc' | 'nextra' | 'starlight' | 'jekyll' | 'static';
+export interface SourceBinding {
+    name: string;
+    path: string;
+}
+export interface DesignReference {
+    url: string;
+}
+export type ScreenshotPolicy = 'requested' | 'auto' | 'off';
+export interface ApplicationScreenshots {
+    policy: ScreenshotPolicy;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    highlight?: boolean;
+}
+export interface ApplicationConfig {
+    baseUrl: string;
+    source?: string;
+    startCommand?: string;
+    readyPath?: string;
+    screenshots?: ApplicationScreenshots;
+}
+export type DocumentationExperienceLevel = 'beginner' | 'intermediate' | 'advanced' | 'mixed';
+export interface DocumentationBrief {
+    primaryAudience?: string;
+    experienceLevel?: DocumentationExperienceLevel;
+    priorityOutcomes?: string[];
+    locale: string;
+    tone: string[];
+    standardsProfile: string;
+    styleGuide: string;
+    terminology: Record<string, string>;
+    exclusions: string[];
+    accessibilityTarget: string;
+}
+export interface DoxloopProject {
+    schemaVersion: 1;
+    title: string;
+    contentDir: string;
+    generator: GeneratorName;
+    generatorPackage?: string;
+    sources: SourceBinding[];
+    designReferences: DesignReference[];
+    application?: ApplicationConfig;
+    documentation: DocumentationBrief;
+}
+export type DoxbrixNavNode = {
+    type: 'page';
+    file: string;
+    title?: string;
+    icon?: string;
+    hidden?: boolean;
+} | {
+    type: 'group';
+    label: string;
+    icon?: string;
+    hidden?: boolean;
+    items: DoxbrixNavNode[];
+} | {
+    type: 'label';
+    text: string;
+} | {
+    type: 'divider';
+} | {
+    type: 'link';
+    title: string;
+    href: string;
+    icon?: string;
+} | {
+    type: 'api';
+    title: string;
+    spec: string;
+    icon?: string;
+};
+export interface DoxbrixSpace {
+    name: string;
+    slug?: string;
+    locale?: string;
+    parent?: string;
+    icon?: string;
+    tag?: string;
+    nav: DoxbrixNavNode[];
+}
+export interface DoxbrixSiteConfig {
+    version: 1;
+    name?: string;
+    description?: string;
+    spaces: DoxbrixSpace[];
+    theme?: Record<string, unknown> | 'light' | 'dark' | 'system';
+    site?: Record<string, unknown>;
+}
+export interface SourceSyncRecord {
+    commit: string;
+    recordedAt: string;
+    contentFingerprint?: string;
+}
+export interface SyncState {
+    schemaVersion: 1;
+    sources: Record<string, SourceSyncRecord>;
+}
+export type SourceChange = SourceBinding & ({
+    kind: 'missing-path';
+} | {
+    kind: 'not-git';
+} | {
+    kind: 'no-baseline';
+    head: string;
+    uncommittedFiles: string[];
+} | {
+    kind: 'baseline-lost';
+    head: string;
+    uncommittedFiles: string[];
+} | {
+    kind: 'unchanged' | 'changed';
+    baseline: string;
+    head: string;
+    changedFiles: string[];
+    uncommittedFiles: string[];
+});
+export type IssueSeverity = 'error' | 'warning';
+export interface ValidationIssue {
+    severity: IssueSeverity;
+    code: string;
+    message: string;
+    file?: string;
+}
+export interface ValidationResult {
+    issues: ValidationIssue[];
+    pages: string[];
+    errors: number;
+    warnings: number;
+}
+export interface ParsedArgs {
+    command?: string;
+    positionals: string[];
+    flags: Map<string, string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,4 @@
+import type { ValidationResult } from './types.js';
+export declare function validateProject(root: string): Promise<ValidationResult>;
+export declare function formatValidation(result: ValidationResult): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqE7E;AAqqBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CASjE"}