@anydocs/core 1.0.0

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export * from './project-config.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1 @@
+export * from "./project-config.js";

package/dist/config/project-config.d.ts

@@ -0,0 +1,10 @@
+import { type ProjectConfig } from '../types/project.ts';
+export declare const ANYDOCS_CONFIG_FILE = "anydocs.config.json";
+export declare const ANYDOCS_WORKFLOW_FILE = "anydocs.workflow.json";
+export declare const DEFAULT_PROJECT_ID = "default";
+export declare const DEFAULT_PROJECT_NAME = "Anydocs Project";
+export declare const DEFAULT_PROJECT_LANGUAGES: readonly ["en"];
+export declare function createDefaultProjectConfig(overrides?: Partial<ProjectConfig>): ProjectConfig;
+export declare function resolveProjectRoot(repoRoot: string, _projectId?: string): string;
+export declare function assertValidProjectId(projectId: string): void;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/config/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzG,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,yBAAyB,iBAAkB,CAAC;AAIzD,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GACrC,aAAa,CAsBf;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAkB5D"}

package/dist/config/project-config.js

@@ -0,0 +1,52 @@
+import path from 'node:path';
+import { ValidationError } from "../errors/validation-error.js";
+import { DEFAULT_DOCS_CODE_THEME, DEFAULT_DOCS_THEME_ID } from "../types/project.js";
+export const ANYDOCS_CONFIG_FILE = 'anydocs.config.json';
+export const ANYDOCS_WORKFLOW_FILE = 'anydocs.workflow.json';
+export const DEFAULT_PROJECT_ID = 'default';
+export const DEFAULT_PROJECT_NAME = 'Anydocs Project';
+export const DEFAULT_PROJECT_LANGUAGES = ['en'];
+const PROJECT_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export function createDefaultProjectConfig(overrides = {}) {
+    const defaultLanguage = overrides.defaultLanguage ?? 'en';
+    const languages = overrides.languages ?? [defaultLanguage];
+    return {
+        version: 1,
+        projectId: overrides.projectId ?? DEFAULT_PROJECT_ID,
+        name: overrides.name ?? DEFAULT_PROJECT_NAME,
+        defaultLanguage,
+        languages,
+        site: {
+            theme: {
+                id: overrides.site?.theme?.id ?? DEFAULT_DOCS_THEME_ID,
+                ...(overrides.site?.theme?.branding ? { branding: overrides.site.theme.branding } : {}),
+                ...(overrides.site?.theme?.chrome ? { chrome: overrides.site.theme.chrome } : {}),
+                ...(overrides.site?.theme?.colors ? { colors: overrides.site.theme.colors } : {}),
+                codeTheme: overrides.site?.theme?.codeTheme ?? DEFAULT_DOCS_CODE_THEME,
+            },
+            ...(overrides.site?.navigation ? { navigation: overrides.site.navigation } : {}),
+        },
+        ...(overrides.build ? { build: overrides.build } : {}),
+    };
+}
+export function resolveProjectRoot(repoRoot, _projectId) {
+    return path.resolve(repoRoot);
+}
+export function assertValidProjectId(projectId) {
+    if (typeof projectId !== 'string' || projectId.trim().length === 0) {
+        throw new ValidationError('Project id must be a non-empty string.', {
+            entity: 'project-id',
+            rule: 'project-id-required',
+            remediation: 'Provide a non-empty projectId using lowercase letters, numbers, and hyphens only.',
+            metadata: { received: projectId },
+        });
+    }
+    if (!PROJECT_ID_PATTERN.test(projectId)) {
+        throw new ValidationError(`Invalid project id "${projectId}".`, {
+            entity: 'project-id',
+            rule: 'project-id-format',
+            remediation: 'Use lowercase letters, numbers, and hyphens only for projectId values passed into core workflows.',
+            metadata: { received: projectId },
+        });
+    }
+}

package/dist/errors/domain-error.d.ts

@@ -0,0 +1,12 @@
+export type DomainErrorDetails = {
+    entity: string;
+    rule: string;
+    remediation?: string;
+    metadata?: Record<string, unknown>;
+};
+export declare class DomainError extends Error {
+    readonly code: string;
+    readonly details: DomainErrorDetails;
+    constructor(code: string, message: string, details: DomainErrorDetails);
+}
+//# sourceMappingURL=domain-error.d.ts.map

package/dist/errors/domain-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-error.d.ts","sourceRoot":"","sources":["../../src/errors/domain-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;gBAEzB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;CAMvE"}

package/dist/errors/domain-error.js

@@ -0,0 +1,8 @@
+export class DomainError extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'DomainError';
+        this.code = code;
+        this.details = details;
+    }
+}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export * from './domain-error.ts';
+export * from './validation-error.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,2 @@
+export * from "./domain-error.js";
+export * from "./validation-error.js";

package/dist/errors/validation-error.d.ts

@@ -0,0 +1,5 @@
+import { DomainError, type DomainErrorDetails } from './domain-error.ts';
+export declare class ValidationError extends DomainError {
+    constructor(message: string, details: DomainErrorDetails);
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/errors/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../src/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;CAIzD"}

package/dist/errors/validation-error.js

@@ -0,0 +1,7 @@
+import { DomainError } from "./domain-error.js";
+export class ValidationError extends DomainError {
+    constructor(message, details) {
+        super('VALIDATION_ERROR', message, details);
+        this.name = 'ValidationError';
+    }
+}

package/dist/fs/api-source-repository.d.ts

@@ -0,0 +1,16 @@
+import type { DocsLang } from '../types/docs.ts';
+import type { ApiSourceDoc } from '../types/api-source.ts';
+export type ApiSourceRepository = {
+    projectRoot: string;
+    apiSourcesRoot: string;
+};
+export declare function createApiSourceRepository(projectRoot: string): ApiSourceRepository;
+export declare function initializeApiSourceRepository(repository: ApiSourceRepository): Promise<void>;
+export declare function loadApiSource(repository: ApiSourceRepository, sourceId: string): Promise<ApiSourceDoc | null>;
+export declare function listApiSources(repository: ApiSourceRepository, options?: {
+    lang?: DocsLang;
+    status?: ApiSourceDoc['status'];
+}): Promise<ApiSourceDoc[]>;
+export declare function saveApiSource(repository: ApiSourceRepository, source: ApiSourceDoc): Promise<ApiSourceDoc>;
+export declare function deleteApiSource(repository: ApiSourceRepository, sourceId: string): Promise<void>;
+//# sourceMappingURL=api-source-repository.d.ts.map

package/dist/fs/api-source-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-source-repository.d.ts","sourceRoot":"","sources":["../../src/fs/api-source-repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAuBF,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAKlF;AAED,wBAAsB,6BAA6B,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElG;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CASnH;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CAC5B,GACL,OAAO,CAAC,YAAY,EAAE,CAAC,CAkCzB;AAED,wBAAsB,aAAa,CAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAIhH;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStG"}

package/dist/fs/api-source-repository.js

@@ -0,0 +1,89 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { validateApiSourceDoc } from "../schemas/api-source-schema.js";
+function isMissingFileError(error) {
+    return !!error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';
+}
+async function readJson(filePath) {
+    const raw = await fs.readFile(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+async function writeJsonAtomic(filePath, value) {
+    const dir = path.dirname(filePath);
+    const tempFilePath = path.join(dir, `.${path.basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(tempFilePath, JSON.stringify(value, null, 2) + '\n', 'utf8');
+    await fs.rename(tempFilePath, filePath);
+}
+function sourceFile(repository, sourceId) {
+    return path.join(repository.apiSourcesRoot, `${sourceId}.json`);
+}
+export function createApiSourceRepository(projectRoot) {
+    return {
+        projectRoot,
+        apiSourcesRoot: path.join(projectRoot, 'api-sources'),
+    };
+}
+export async function initializeApiSourceRepository(repository) {
+    await fs.mkdir(repository.apiSourcesRoot, { recursive: true });
+}
+export async function loadApiSource(repository, sourceId) {
+    try {
+        return validateApiSourceDoc(await readJson(sourceFile(repository, sourceId)));
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function listApiSources(repository, options = {}) {
+    let entries = [];
+    try {
+        entries = await fs.readdir(repository.apiSourcesRoot);
+    }
+    catch {
+        return [];
+    }
+    const items = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.json')) {
+            continue;
+        }
+        try {
+            const source = validateApiSourceDoc(await readJson(path.join(repository.apiSourcesRoot, entry)));
+            if (options.lang && source.lang !== options.lang) {
+                continue;
+            }
+            if (options.status && source.status !== options.status) {
+                continue;
+            }
+            items.push(source);
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    items.sort((left, right) => left.id.localeCompare(right.id));
+    return items;
+}
+export async function saveApiSource(repository, source) {
+    const validated = validateApiSourceDoc(source);
+    await writeJsonAtomic(sourceFile(repository, validated.id), validated);
+    return validated;
+}
+export async function deleteApiSource(repository, sourceId) {
+    try {
+        await fs.unlink(sourceFile(repository, sourceId));
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return;
+        }
+        throw error;
+    }
+}

package/dist/fs/content-repository.d.ts

@@ -0,0 +1,13 @@
+import { ValidationError } from '../errors/validation-error.ts';
+import type { ProjectConfig, ProjectContract } from '../types/project.ts';
+export type Result<T, E extends Error = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+export declare function loadProjectContract(repoRoot: string, projectId?: string, outputDir?: string): Promise<Result<ProjectContract, ValidationError>>;
+export declare function validateProjectContract(repoRoot: string, projectId?: string): Promise<Result<ProjectConfig, ValidationError>>;
+export declare function updateProjectConfig(repoRoot: string, patch: Partial<ProjectConfig>, projectId?: string): Promise<Result<ProjectConfig, ValidationError>>;
+//# sourceMappingURL=content-repository.d.ts.map

package/dist/fs/content-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-repository.d.ts","sourceRoot":"","sources":["../../src/fs/content-repository.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOhE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkE1E,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,GAAG,KAAK,IACzC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAmD5B,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAuEnD;AAED,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAUjD;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CA4BjD"}

package/dist/fs/content-repository.js

@@ -0,0 +1,171 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { assertValidProjectId, ANYDOCS_CONFIG_FILE, resolveProjectRoot } from "../config/project-config.js";
+import { ValidationError } from "../errors/validation-error.js";
+import { validateProjectConfig } from "../schemas/project-schema.js";
+import { assertWorkflowStandardMatchesContract, createWorkflowStandardDefinition, readWorkflowStandardDefinition, } from "../services/workflow-standard-service.js";
+import { assertProjectContractStructure, createProjectPathContract, } from "./project-paths.js";
+import { createDocsRepository, initializeDocsRepository, loadNavigation } from "./docs-repository.js";
+function collectReferencedTopNavGroupIds(config) {
+    return (config.site.navigation?.topNav ?? [])
+        .filter((item) => item.type === 'nav-group')
+        .map((item) => item.groupId);
+}
+function collectTopLevelGroupIds(items) {
+    return items.flatMap((item) => item.type === 'section' || item.type === 'folder'
+        ? item.id
+            ? [item.id]
+            : []
+        : []);
+}
+async function assertTopNavGroupsExistForLanguages(config, paths) {
+    const requiredGroupIds = [...new Set(collectReferencedTopNavGroupIds(config))];
+    if (requiredGroupIds.length === 0) {
+        return;
+    }
+    const repository = createDocsRepository(paths.projectRoot);
+    for (const language of config.languages) {
+        const navigation = await loadNavigation(repository, language);
+        const topLevelGroupIds = collectTopLevelGroupIds(navigation.items);
+        const seen = new Set();
+        for (const groupId of topLevelGroupIds) {
+            if (!seen.has(groupId)) {
+                seen.add(groupId);
+                continue;
+            }
+            throw new ValidationError(`Navigation for "${language}" contains duplicate top-level group id "${groupId}".`, {
+                entity: 'navigation-doc',
+                rule: 'navigation-top-level-group-id-unique',
+                remediation: 'Use unique ids for top-level section and folder items in each language navigation file.',
+                metadata: { lang: language, groupId },
+            });
+        }
+        for (const groupId of requiredGroupIds) {
+            if (seen.has(groupId)) {
+                continue;
+            }
+            throw new ValidationError(`Top navigation references missing group "${groupId}" in language "${language}".`, {
+                entity: 'project-config',
+                rule: 'site-navigation-top-nav-group-exists',
+                remediation: 'Create the matching top-level section or folder id in every enabled language navigation file, or update site.navigation.topNav to reference an existing group.',
+                metadata: { lang: language, groupId },
+            });
+        }
+    }
+}
+function toValidationResult(work) {
+    return work()
+        .then((value) => ({ ok: true, value }))
+        .catch((error) => {
+        if (error instanceof ValidationError) {
+            return { ok: false, error };
+        }
+        throw error;
+    });
+}
+async function ensureExists(targetPath, entity, remediation) {
+    try {
+        await fs.access(targetPath);
+    }
+    catch {
+        throw new ValidationError(`Missing required ${entity} at "${targetPath}".`, {
+            entity,
+            rule: 'required-path-exists',
+            remediation,
+            metadata: { targetPath },
+        });
+    }
+}
+async function readProjectConfigFile(configPath) {
+    const rawConfig = await fs.readFile(configPath, 'utf8');
+    try {
+        return JSON.parse(rawConfig);
+    }
+    catch (error) {
+        throw new ValidationError(`Project configuration at "${configPath}" is not valid JSON.`, {
+            entity: 'project-config-file',
+            rule: 'project-config-json-valid',
+            remediation: 'Fix anydocs.config.json so it contains valid JSON before loading the project contract.',
+            metadata: {
+                configPath,
+                cause: error instanceof Error ? error.message : String(error),
+            },
+        });
+    }
+}
+async function writeJsonAtomic(targetPath, value) {
+    const tempPath = `${targetPath}.${process.pid}.${Date.now()}.tmp`;
+    await fs.writeFile(tempPath, JSON.stringify(value, null, 2) + '\n', 'utf8');
+    await fs.rename(tempPath, targetPath);
+}
+export async function loadProjectContract(repoRoot, projectId, outputDir) {
+    return toValidationResult(async () => {
+        if (projectId) {
+            assertValidProjectId(projectId);
+        }
+        const projectRoot = resolveProjectRoot(repoRoot, projectId);
+        const configPath = path.join(projectRoot, ANYDOCS_CONFIG_FILE);
+        await ensureExists(configPath, 'project-config-file', 'Create anydocs.config.json in the canonical project root before loading the contract.');
+        const rawConfig = await readProjectConfigFile(configPath);
+        const config = validateProjectConfig(rawConfig);
+        if (projectId && config.projectId !== projectId) {
+            throw new ValidationError(`Project configuration at "${configPath}" declares projectId "${config.projectId}" but the requested project is "${projectId}".`, {
+                entity: 'project-config',
+                rule: 'project-id-matches-requested-project-root',
+                remediation: 'Update anydocs.config.json so projectId matches the canonical project directory, or load the project using the matching projectId.',
+                metadata: {
+                    configPath,
+                    expectedProjectId: projectId,
+                    receivedProjectId: config.projectId,
+                },
+            });
+        }
+        const paths = createProjectPathContract(repoRoot, config, outputDir);
+        assertProjectContractStructure(config, paths);
+        await ensureExists(paths.workflowFile, 'workflow-standard-file', 'Create anydocs.workflow.json in the canonical project root before loading the workflow standard.');
+        const workflow = await readWorkflowStandardDefinition(paths.workflowFile);
+        assertWorkflowStandardMatchesContract(workflow, { config, paths });
+        await ensureExists(paths.pagesRoot, 'pages-root', 'Create the pages directory for the canonical project structure.');
+        await ensureExists(paths.navigationRoot, 'navigation-root', 'Create the navigation directory for the canonical project structure.');
+        for (const language of config.languages) {
+            await ensureExists(paths.languageRoots[language].pagesDir, 'pages-language-root', `Create the pages/${language} directory for the canonical project structure.`);
+            await ensureExists(paths.languageRoots[language].navigationFile, 'navigation-language-file', `Create navigation/${language}.json for every enabled language.`);
+        }
+        await assertTopNavGroupsExistForLanguages(config, paths);
+        return { config, paths };
+    });
+}
+export async function validateProjectContract(repoRoot, projectId) {
+    const result = await loadProjectContract(repoRoot, projectId);
+    if (!result.ok) {
+        return result;
+    }
+    return {
+        ok: true,
+        value: result.value.config,
+    };
+}
+export async function updateProjectConfig(repoRoot, patch, projectId) {
+    const contractResult = await loadProjectContract(repoRoot, projectId);
+    if (!contractResult.ok) {
+        return contractResult;
+    }
+    return toValidationResult(async () => {
+        const currentConfig = contractResult.value.config;
+        const nextConfig = validateProjectConfig({
+            ...currentConfig,
+            ...patch,
+            projectId: currentConfig.projectId,
+            version: currentConfig.version,
+        });
+        const nextPaths = createProjectPathContract(repoRoot, nextConfig);
+        await assertTopNavGroupsExistForLanguages(nextConfig, nextPaths);
+        await writeJsonAtomic(contractResult.value.paths.configFile, nextConfig);
+        await writeJsonAtomic(contractResult.value.paths.workflowFile, createWorkflowStandardDefinition({
+            config: nextConfig,
+            paths: nextPaths,
+        }));
+        await initializeDocsRepository(createDocsRepository(nextPaths.projectRoot), nextConfig.languages);
+        return nextConfig;
+    });
+}

package/dist/fs/docs-repository.d.ts

@@ -0,0 +1,26 @@
+import { type PageDocValidationOptions } from '../schemas/docs-schema.ts';
+import type { DocsLang, NavigationDoc, PageDoc } from '../types/docs.ts';
+export type DocsRepository = {
+    projectRoot: string;
+    pagesRoot: string;
+    navigationRoot: string;
+};
+export type NavigationValidationOptions = {
+    existingPageIds?: Iterable<string>;
+    requiredTopLevelGroupIds?: Iterable<string>;
+};
+export type DeletePageResult = {
+    pageId: string;
+    lang: DocsLang;
+    removedNavigationRefs: number;
+};
+export declare function createDocsRepository(projectRoot: string): DocsRepository;
+export declare function initializeDocsRepository(repository: DocsRepository, languages?: DocsLang[]): Promise<void>;
+export declare function loadNavigation(repository: DocsRepository, lang: DocsLang): Promise<NavigationDoc>;
+export declare function saveNavigation(repository: DocsRepository, lang: DocsLang, navigation: NavigationDoc, options?: NavigationValidationOptions): Promise<NavigationDoc>;
+export declare function listPages<TContent = unknown>(repository: DocsRepository, lang: DocsLang, options?: PageDocValidationOptions): Promise<PageDoc<TContent>[]>;
+export declare function loadPage<TContent = unknown>(repository: DocsRepository, lang: DocsLang, pageId: string, options?: PageDocValidationOptions): Promise<PageDoc<TContent> | null>;
+export declare function savePage<TContent = unknown>(repository: DocsRepository, lang: DocsLang, page: PageDoc<TContent>, options?: PageDocValidationOptions): Promise<PageDoc<TContent>>;
+export declare function findPageBySlug<TContent = unknown>(repository: DocsRepository, lang: DocsLang, slug: string, options?: PageDocValidationOptions): Promise<PageDoc<TContent> | null>;
+export declare function deletePage(repository: DocsRepository, lang: DocsLang, pageId: string): Promise<DeletePageResult>;
+//# sourceMappingURL=docs-repository.d.ts.map

package/dist/fs/docs-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-repository.d.ts","sourceRoot":"","sources":["../../src/fs/docs-repository.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGzE,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,wBAAwB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAeF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAcxE;AA8FD,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,cAAc,EAC1B,SAAS,GAAE,QAAQ,EAAiB,GACnC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,aAAa,CAAC,CAUxB;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,aAAa,EACzB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,aAAa,CAAC,CAkCxB;AAED,wBAAsB,SAAS,CAAC,QAAQ,GAAG,OAAO,EAChD,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CA+B9B;AAED,wBAAsB,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAC/C,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAgBnC;AAED,wBAAsB,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAC/C,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EACvB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAiE5B;AAED,wBAAsB,cAAc,CAAC,QAAQ,GAAG,OAAO,EACrD,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAInC;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC,CAyB3B"}