@aigentdocs/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rodrigo-amc and AIGenticDocs contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @aigentdocs/core
+
+Shared domain model and validation logic for the [AIGentDocs](https://github.com/rodrigo-amc/AIGentDocs) tooling: frontmatter parsing, the deterministic lint rule engine, scaffolding, adapter generation, and standard updates.
+
+You probably want the CLI instead: [`aigentdocs`](https://www.npmjs.com/package/aigentdocs). This package exists so the CLI and the future MCP server share one implementation.

package/dist/src/adapt.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `adapt` — generate thin per-tool adapter files (Layer 4).
+ *
+ * Most AI coding tools read AGENTS.md natively (Antigravity since v1.20.3,
+ * Codex, Cursor, Copilot, and others), so adapters do not duplicate content:
+ * they are generated pointers to AGENTS.md — the single canonical source —
+ * for tools that use their own file name or support tool-specific overrides.
+ *
+ * Files carry a generation marker; adapt only overwrites files it generated
+ * itself and refuses to touch hand-edited ones.
+ */
+export declare const GENERATION_MARKER = "Generated by `aigentdocs adapt` \u2014 edit AGENTS.md instead; this file is regenerated.";
+export interface AdapterTarget {
+    /** File to generate, relative to the repository root. */
+    file: string;
+    description: string;
+    content: string;
+}
+export declare const ADAPTER_TARGETS: Record<string, AdapterTarget>;
+export interface AdaptResult {
+    written: Array<{
+        file: string;
+        description: string;
+    }>;
+    skipped: Array<{
+        file: string;
+        reason: string;
+    }>;
+}
+/** Generate adapter files for the given tools (default: all registered). */
+export declare function adaptProject(targetDir: string, tools?: string[]): Promise<AdaptResult>;

package/dist/src/adapt.js

@@ -0,0 +1,96 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+/**
+ * `adapt` — generate thin per-tool adapter files (Layer 4).
+ *
+ * Most AI coding tools read AGENTS.md natively (Antigravity since v1.20.3,
+ * Codex, Cursor, Copilot, and others), so adapters do not duplicate content:
+ * they are generated pointers to AGENTS.md — the single canonical source —
+ * for tools that use their own file name or support tool-specific overrides.
+ *
+ * Files carry a generation marker; adapt only overwrites files it generated
+ * itself and refuses to touch hand-edited ones.
+ */
+export const GENERATION_MARKER = "Generated by `aigentdocs adapt` — edit AGENTS.md instead; this file is regenerated.";
+const marker = (commentOpen, commentClose) => `${commentOpen} ${GENERATION_MARKER} ${commentClose}`;
+export const ADAPTER_TARGETS = {
+    claude: {
+        file: "CLAUDE.md",
+        description: "Claude Code entry file (imports AGENTS.md)",
+        content: `${marker("<!--", "-->")}
+
+@AGENTS.md
+`,
+    },
+    cursor: {
+        file: ".cursor/rules/aigentdocs.mdc",
+        description: "Cursor project rule pointing to AGENTS.md",
+        content: `---
+description: AIGentDocs project instructions
+alwaysApply: true
+---
+
+${marker("<!--", "-->")}
+
+Follow the AI agent instructions in \`AGENTS.md\` at the repository root.
+The project documentation under \`docs/project/\` is the source of truth;
+start from \`docs/standard/AGENT.md\`.
+`,
+    },
+    copilot: {
+        file: ".github/copilot-instructions.md",
+        description: "GitHub Copilot instructions pointing to AGENTS.md",
+        content: `${marker("<!--", "-->")}
+
+Follow the AI agent instructions in \`AGENTS.md\` at the repository root.
+The project documentation under \`docs/project/\` is the source of truth;
+start from \`docs/standard/AGENT.md\`.
+`,
+    },
+    antigravity: {
+        file: "GEMINI.md",
+        description: "Antigravity-specific overrides (Antigravity reads AGENTS.md natively)",
+        content: `${marker("<!--", "-->")}
+
+<!-- Antigravity (CLI, IDE, and agent tooling) reads AGENTS.md natively, and
+     this file takes priority over it for Antigravity-specific behavior.
+     Keep it empty of duplicated rules: add only Antigravity-specific
+     overrides below. -->
+
+Follow the AI agent instructions in \`AGENTS.md\` at the repository root.
+`,
+    },
+};
+const exists = (p) => access(p).then(() => true, () => false);
+/** Generate adapter files for the given tools (default: all registered). */
+export async function adaptProject(targetDir, tools) {
+    const requested = tools === undefined || tools.length === 0 ? Object.keys(ADAPTER_TARGETS) : tools;
+    for (const tool of requested) {
+        if (!(tool in ADAPTER_TARGETS)) {
+            throw new Error(`unknown tool '${tool}' (available: ${Object.keys(ADAPTER_TARGETS).join(", ")})`);
+        }
+    }
+    if (!(await exists(path.join(targetDir, "AGENTS.md")))) {
+        throw new Error(`'AGENTS.md' not found in '${targetDir}' — adapters point to it. Run 'aigentdocs init' first.`);
+    }
+    const result = { written: [], skipped: [] };
+    for (const tool of requested) {
+        const target = ADAPTER_TARGETS[tool];
+        if (target === undefined) {
+            continue;
+        }
+        const filePath = path.join(targetDir, target.file);
+        if (await exists(filePath)) {
+            const current = await readFile(filePath, "utf8");
+            if (!current.includes(GENERATION_MARKER)) {
+                result.skipped.push({ file: target.file, reason: "exists and was not generated by adapt — left untouched" });
+                continue;
+            }
+        }
+        await mkdir(path.dirname(filePath), { recursive: true });
+        await writeFile(filePath, target.content);
+        result.written.push({ file: target.file, description: target.description });
+    }
+    return result;
+}
+//# sourceMappingURL=adapt.js.map

package/dist/src/adapt.js.map

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

package/dist/src/consistency.d.ts

@@ -0,0 +1,16 @@
+import { type Finding } from "./index.js";
+import type { ProjectModel } from "./project.js";
+/**
+ * Lint v1 — cross-document consistency checks (Mechanical layer of
+ * AGENT_REVIEW.md, "Consistency Validation"):
+ *
+ * - tech_stack.yaml ADR references resolve to files in 04_adrs/
+ *   (empty `adr` is a suggestion: the Lite profile allows it).
+ * - ADR supersedes/superseded_by reciprocity and superseded status.
+ * - Domain module code_paths point to paths that exist in the repository.
+ * - Roadmap references using the standard's `(see X.md)` / `(ver X.md)`
+ *   convention resolve to project documents.
+ * - project_status.yaml (when present) agrees with module frontmatter
+ *   states — the authority rule of the Project Status Artifacts.
+ */
+export declare function checkConsistency(model: ProjectModel): Promise<Finding[]>;

package/dist/src/consistency.js

@@ -0,0 +1,154 @@
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { STATES } from "./index.js";
+/**
+ * Lint v1 — cross-document consistency checks (Mechanical layer of
+ * AGENT_REVIEW.md, "Consistency Validation"):
+ *
+ * - tech_stack.yaml ADR references resolve to files in 04_adrs/
+ *   (empty `adr` is a suggestion: the Lite profile allows it).
+ * - ADR supersedes/superseded_by reciprocity and superseded status.
+ * - Domain module code_paths point to paths that exist in the repository.
+ * - Roadmap references using the standard's `(see X.md)` / `(ver X.md)`
+ *   convention resolve to project documents.
+ * - project_status.yaml (when present) agrees with module frontmatter
+ *   states — the authority rule of the Project Status Artifacts.
+ */
+export async function checkConsistency(model) {
+    const findings = [];
+    const add = (rule, severity, file, message) => {
+        findings.push({ rule, severity, file, message });
+    };
+    const docsByType = new Map();
+    for (const doc of model.documents) {
+        const type = doc.frontmatter?.["type"];
+        if (typeof type === "string") {
+            const list = docsByType.get(type) ?? [];
+            list.push(doc);
+            docsByType.set(type, list);
+        }
+    }
+    // --- tech_stack.yaml → ADR references -----------------------------------
+    if (model.techStack !== undefined) {
+        if (model.techStack.parseError !== undefined) {
+            add("yaml/invalid", "critical", model.techStack.relPath, `does not parse: ${model.techStack.parseError}`);
+        }
+        else {
+            for (const [keyPath, adrRef] of collectAdrRefs(model.techStack.data, [])) {
+                if (adrRef === "") {
+                    add("ref/tech-stack-adr-empty", "suggestion", model.techStack.relPath, `'${keyPath}' has no ADR recorded (allowed in the Lite profile; required in Full)`);
+                    continue;
+                }
+                const adrPath = path.join(model.repoRoot, "docs", "project", "04_adrs", adrRef);
+                const exists = await access(adrPath).then(() => true, () => false);
+                if (!exists) {
+                    add("ref/tech-stack-adr", "critical", model.techStack.relPath, `'${keyPath}' references ADR '${adrRef}', which does not exist in 04_adrs/`);
+                }
+            }
+        }
+    }
+    // --- ADR reciprocity ------------------------------------------------------
+    const adrs = (docsByType.get("adr") ?? []).map((doc) => ({
+        doc,
+        id: typeof doc.frontmatter?.["id"] === "number" ? doc.frontmatter["id"] : undefined,
+        status: doc.frontmatter?.["status"],
+        supersedes: doc.frontmatter?.["supersedes"] ?? null,
+        supersededBy: doc.frontmatter?.["superseded_by"] ?? null,
+    }));
+    const adrById = new Map(adrs.filter((a) => a.id !== undefined).map((a) => [a.id, a]));
+    for (const adr of adrs) {
+        if (typeof adr.supersedes === "number") {
+            const target = adrById.get(adr.supersedes);
+            if (target === undefined) {
+                add("ref/adr-supersedes-target", "critical", adr.doc.relPath, `supersedes ADR ${adr.supersedes}, which does not exist`);
+            }
+            else if (target.supersededBy !== adr.id) {
+                add("adr/supersedes-reciprocity", "critical", target.doc.relPath, `must carry 'superseded_by: ${adr.id}' (it is superseded by ${adr.doc.relPath})`);
+            }
+        }
+        if (adr.supersededBy !== null && adr.status !== "superseded") {
+            add("adr/superseded-status", "warning", adr.doc.relPath, `has 'superseded_by' set, so its status should be 'superseded' (got '${String(adr.status)}')`);
+        }
+    }
+    // --- Domain module code_paths ----------------------------------------------
+    for (const doc of docsByType.get("domain_module") ?? []) {
+        const codePaths = doc.frontmatter?.["code_paths"];
+        if (!Array.isArray(codePaths)) {
+            continue; // shape already reported by lint v0
+        }
+        for (const entry of codePaths) {
+            if (typeof entry !== "string" || entry === "") {
+                continue;
+            }
+            const target = path.join(model.repoRoot, entry.replace(/^\//, ""));
+            const exists = await access(target).then(() => true, () => false);
+            if (!exists) {
+                add("ref/code-paths", "warning", doc.relPath, `code path '${entry}' does not exist in the repository`);
+            }
+        }
+    }
+    // --- Roadmap references: the standard's "(see X.md)" convention -------------
+    const basenames = new Set(model.documents.map((doc) => path.posix.basename(doc.relPath)));
+    const REF = /\((?:see|ver)\s+([A-Za-z0-9_.-]+\.(?:md|yaml))\)/g;
+    for (const doc of docsByType.get("roadmap") ?? []) {
+        for (const match of doc.content.matchAll(REF)) {
+            const ref = match[1] ?? "";
+            if (!basenames.has(ref) && ref !== "tech_stack.yaml" && ref !== "project_status.yaml") {
+                add("ref/roadmap-reference", "warning", doc.relPath, `references '${ref}', which does not exist under docs/project/`);
+            }
+        }
+    }
+    // --- project_status.yaml authority rule -------------------------------------
+    if (model.projectStatus !== undefined) {
+        const statusFile = model.projectStatus.relPath;
+        if (model.projectStatus.parseError !== undefined) {
+            add("yaml/invalid", "critical", statusFile, `does not parse: ${model.projectStatus.parseError}`);
+            return findings;
+        }
+        const data = model.projectStatus.data;
+        const modules = (data?.["modules"] ?? {});
+        const moduleDocs = new Map((docsByType.get("domain_module") ?? []).map((doc) => [
+            String(doc.frontmatter?.["module_name"] ?? path.posix.basename(doc.relPath, ".md")),
+            doc,
+        ]));
+        if (modules !== null && typeof modules === "object" && !Array.isArray(modules)) {
+            for (const [name, value] of Object.entries(modules)) {
+                const state = value?.["state"];
+                if (typeof state !== "string" || !STATES.includes(state)) {
+                    add("status/state-value", "critical", statusFile, `module '${name}' has invalid state '${String(state)}'`);
+                    continue;
+                }
+                const moduleDoc = moduleDocs.get(name);
+                if (moduleDoc === undefined) {
+                    add("status/unknown-module", "warning", statusFile, `module '${name}' has no document in domain_modules/`);
+                }
+                else if (moduleDoc.frontmatter?.["state"] !== state) {
+                    add("status/module-state-sync", "critical", moduleDoc.relPath, `frontmatter state '${String(moduleDoc.frontmatter?.["state"])}' contradicts project_status.yaml ('${state}') — project_status.yaml is authoritative`);
+                }
+            }
+            for (const [name, doc] of moduleDocs) {
+                if (!(name in modules)) {
+                    add("status/module-missing", "warning", doc.relPath, `module '${name}' is not registered in project_status.yaml`);
+                }
+            }
+        }
+    }
+    return findings;
+}
+/** Recursively collect every `adr:` string value with its key path. */
+function collectAdrRefs(node, keyPath) {
+    if (node === null || typeof node !== "object") {
+        return [];
+    }
+    const refs = [];
+    for (const [key, value] of Object.entries(node)) {
+        if (key === "adr" && typeof value === "string") {
+            refs.push([keyPath.join("."), value]);
+        }
+        else {
+            refs.push(...collectAdrRefs(value, [...keyPath, key]));
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=consistency.js.map

package/dist/src/consistency.js.map

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

package/dist/src/frontmatter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Result of looking for a YAML frontmatter block at the top of a markdown file.
+ * `yaml` is the only module allowed to be imported here (ADR-0003); everything
+ * else in the tooling goes through this wrapper.
+ */
+export interface FrontmatterResult {
+    /** True when a `---` ... `---` block exists at the very top of the file. */
+    found: boolean;
+    /** The parsed mapping, when found and valid. */
+    data?: Record<string, unknown>;
+    /** Parse or shape error, when found but unusable. */
+    error?: string;
+}
+/** Parse a full YAML document. Throws on invalid YAML (caller decides severity). */
+export declare function parseYaml(text: string): unknown;
+export declare function extractFrontmatter(markdown: string): FrontmatterResult;

package/dist/src/frontmatter.js

@@ -0,0 +1,24 @@
+import { parse } from "yaml";
+const FENCE = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
+/** Parse a full YAML document. Throws on invalid YAML (caller decides severity). */
+export function parseYaml(text) {
+    return parse(text);
+}
+export function extractFrontmatter(markdown) {
+    const match = FENCE.exec(markdown);
+    if (!match) {
+        return { found: false };
+    }
+    let parsed;
+    try {
+        parsed = parse(match[1] ?? "");
+    }
+    catch (error) {
+        return { found: true, error: error instanceof Error ? error.message : String(error) };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { found: true, error: "frontmatter is not a YAML mapping" };
+    }
+    return { found: true, data: parsed };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/src/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAgB7B,MAAM,KAAK,GAAG,wCAAwC,CAAC;AAEvD,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACxF,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAiC,EAAE,CAAC;AAClE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @aigentdocs/core — shared domain model for the AIGentDocs tooling.
+ *
+ * The values here mirror the standard (docs/standard/): if the standard
+ * changes its allowed values, this module is the single place to update.
+ */
+/** Severity scale of a lint finding, as defined in AGENT_REVIEW.md. */
+export type Severity = "critical" | "warning" | "suggestion";
+/** One result of a mechanical validation against an adopting project. */
+export interface Finding {
+    /** Lint rule ID, e.g. "frontmatter/required-fields". */
+    rule: string;
+    severity: Severity;
+    /** Path of the offending file, relative to the repository root. */
+    file: string;
+    message: string;
+}
+/** Adoption depth declared by an adopting project. */
+export type AdoptionProfile = "lite" | "full";
+/** Allowed values of the `state` frontmatter field (working documents). */
+export declare const STATES: readonly ["pending", "doing", "done", "deprecated"];
+export type State = (typeof STATES)[number];
+/** Allowed values of the `status` frontmatter field of ADRs. */
+export declare const ADR_STATUSES: readonly ["proposed", "accepted", "rejected", "superseded"];
+export type AdrStatus = (typeof ADR_STATUSES)[number];
+/** Allowed values of the `status` frontmatter field of Correction Records. */
+export declare const CORRECTION_STATUSES: readonly ["proposed", "approved", "applied", "rejected"];
+export type CorrectionStatus = (typeof CORRECTION_STATUSES)[number];
+/** Frontmatter fields required on every content document of the standard. */
+export declare const REQUIRED_COMMON_FIELDS: readonly ["type", "version", "last_updated"];
+export { extractFrontmatter, parseYaml, type FrontmatterResult } from "./frontmatter.js";
+export { lintMarkdown, lintProject, type LintProjectResult } from "./lint.js";
+export { loadProject, type ProjectDocument, type ProjectModel, type YamlArtifact } from "./project.js";
+export { checkConsistency } from "./consistency.js";
+export { initProject, type InitProfile, type InitResult } from "./scaffold.js";
+export { adaptProject, ADAPTER_TARGETS, GENERATION_MARKER, type AdaptResult, type AdapterTarget } from "./adapt.js";
+export { compareVersions, updateStandard, type ChangelogEntry, type UpdateResult } from "./update.js";

package/dist/src/index.js

@@ -0,0 +1,22 @@
+/**
+ * @aigentdocs/core — shared domain model for the AIGentDocs tooling.
+ *
+ * The values here mirror the standard (docs/standard/): if the standard
+ * changes its allowed values, this module is the single place to update.
+ */
+/** Allowed values of the `state` frontmatter field (working documents). */
+export const STATES = ["pending", "doing", "done", "deprecated"];
+/** Allowed values of the `status` frontmatter field of ADRs. */
+export const ADR_STATUSES = ["proposed", "accepted", "rejected", "superseded"];
+/** Allowed values of the `status` frontmatter field of Correction Records. */
+export const CORRECTION_STATUSES = ["proposed", "approved", "applied", "rejected"];
+/** Frontmatter fields required on every content document of the standard. */
+export const REQUIRED_COMMON_FIELDS = ["type", "version", "last_updated"];
+export { extractFrontmatter, parseYaml } from "./frontmatter.js";
+export { lintMarkdown, lintProject } from "./lint.js";
+export { loadProject } from "./project.js";
+export { checkConsistency } from "./consistency.js";
+export { initProject } from "./scaffold.js";
+export { adaptProject, ADAPTER_TARGETS, GENERATION_MARKER } from "./adapt.js";
+export { compareVersions, updateStandard } from "./update.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAG1E,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC;AAGxF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAG5F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,CAAU,CAAC;AAEnF,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAA0B,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,WAAW,EAA0B,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,WAAW,EAA8D,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAqC,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAwC,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,eAAe,EAAE,cAAc,EAA0C,MAAM,aAAa,CAAC"}

package/dist/src/lint.d.ts

@@ -0,0 +1,13 @@
+import { type Finding } from "./index.js";
+/** Lint a single markdown document. `file` is used verbatim in findings. */
+export declare function lintMarkdown(file: string, content: string): Finding[];
+export interface LintProjectResult {
+    findings: Finding[];
+    filesChecked: number;
+}
+/**
+ * Lint everything under `<repoRoot>/docs/project/`: per-document frontmatter
+ * rules (v0) plus cross-document consistency rules (v1).
+ * Throws if the directory does not exist (not an AIGentDocs repository).
+ */
+export declare function lintProject(repoRoot: string): Promise<LintProjectResult>;

package/dist/src/lint.js

@@ -0,0 +1,121 @@
+import { ADR_STATUSES, CORRECTION_STATUSES, REQUIRED_COMMON_FIELDS, STATES, } from "./index.js";
+import { extractFrontmatter } from "./frontmatter.js";
+import { checkConsistency } from "./consistency.js";
+import { checkSections } from "./sections.js";
+import { loadProject } from "./project.js";
+/**
+ * Lint v0 — the frontmatter slice of the Mechanical layer of AGENT_REVIEW.md:
+ * block presence, required common fields, allowed state/status values,
+ * date format, and array-typed fields.
+ */
+/** Document types whose frontmatter carries the `state` field. */
+const STATE_BEARING_TYPES = new Set([
+    "quality_attributes",
+    "system_overview",
+    "data_flow",
+    "infrastructure",
+    "testing_strategy",
+    "api_guidelines",
+    "domain_module",
+]);
+const KNOWN_TYPES = new Set([...STATE_BEARING_TYPES, "vision", "roadmap", "adr", "correction", "todo"]);
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function isValidIsoDate(value) {
+    if (typeof value !== "string" || !DATE_RE.test(value)) {
+        return false;
+    }
+    const [y, m, d] = value.split("-").map(Number);
+    const date = new Date(Date.UTC(y ?? 0, (m ?? 1) - 1, d ?? 0));
+    return date.getUTCFullYear() === y && date.getUTCMonth() === (m ?? 1) - 1 && date.getUTCDate() === d;
+}
+function isOneOf(value, allowed) {
+    return typeof value === "string" && allowed.includes(value);
+}
+/** Lint a single markdown document. `file` is used verbatim in findings. */
+export function lintMarkdown(file, content) {
+    const findings = [];
+    const add = (rule, severity, message) => {
+        findings.push({ rule, severity, file, message });
+    };
+    const fm = extractFrontmatter(content);
+    if (!fm.found) {
+        add("frontmatter/missing", "critical", "no YAML frontmatter block at the top of the file");
+        return findings;
+    }
+    if (fm.error !== undefined || fm.data === undefined) {
+        add("frontmatter/invalid-yaml", "critical", `frontmatter does not parse: ${fm.error ?? "unknown error"}`);
+        return findings;
+    }
+    const data = fm.data;
+    for (const field of REQUIRED_COMMON_FIELDS) {
+        if (data[field] === undefined || data[field] === null || data[field] === "") {
+            add("frontmatter/required-fields", "critical", `missing required field '${field}'`);
+        }
+    }
+    if (data["last_updated"] !== undefined && data["last_updated"] !== null && !isValidIsoDate(data["last_updated"])) {
+        add("frontmatter/date-format", "critical", `'last_updated' must be a valid YYYY-MM-DD date, got '${String(data["last_updated"])}'`);
+    }
+    const type = data["type"];
+    if (typeof type !== "string" || type === "") {
+        return findings; // already reported by required-fields; nothing type-specific to check
+    }
+    if (!KNOWN_TYPES.has(type)) {
+        add("frontmatter/unknown-type", "warning", `unknown document type '${type}'`);
+        return findings;
+    }
+    findings.push(...checkSections(file, type, content, data));
+    if (STATE_BEARING_TYPES.has(type)) {
+        const state = data["state"];
+        if (state === undefined || state === null) {
+            add("frontmatter/state-missing", "warning", `documents of type '${type}' carry a 'state' field`);
+        }
+        else if (!isOneOf(state, STATES)) {
+            add("frontmatter/state-value", "critical", `'state' must be one of ${STATES.join(" | ")}, got '${String(state)}'`);
+        }
+    }
+    if (type === "adr") {
+        const status = data["status"];
+        if (!isOneOf(status, ADR_STATUSES)) {
+            add("frontmatter/adr-status", "critical", `ADR 'status' must be one of ${ADR_STATUSES.join(" | ")}, got '${String(status)}'`);
+        }
+        if (typeof data["id"] !== "number") {
+            add("frontmatter/adr-id", "warning", "ADR frontmatter should carry a numeric 'id'");
+        }
+        if (data["date"] !== undefined && data["date"] !== null && !isValidIsoDate(data["date"])) {
+            add("frontmatter/date-format", "critical", `'date' must be a valid YYYY-MM-DD date, got '${String(data["date"])}'`);
+        }
+    }
+    if (type === "correction") {
+        const status = data["status"];
+        if (!isOneOf(status, CORRECTION_STATUSES)) {
+            add("frontmatter/correction-status", "critical", `Correction 'status' must be one of ${CORRECTION_STATUSES.join(" | ")}, got '${String(status)}'`);
+        }
+    }
+    if (type === "domain_module") {
+        if (!Array.isArray(data["code_paths"])) {
+            add("frontmatter/code-paths", "critical", "domain modules must carry 'code_paths' as an array");
+        }
+        for (const field of ["entities", "depends_on"]) {
+            if (data[field] !== undefined && data[field] !== null && !Array.isArray(data[field])) {
+                add("frontmatter/array-fields", "warning", `'${field}' should be an array`);
+            }
+        }
+    }
+    return findings;
+}
+/**
+ * Lint everything under `<repoRoot>/docs/project/`: per-document frontmatter
+ * rules (v0) plus cross-document consistency rules (v1).
+ * Throws if the directory does not exist (not an AIGentDocs repository).
+ */
+export async function lintProject(repoRoot) {
+    const model = await loadProject(repoRoot);
+    const findings = [];
+    for (const doc of model.documents) {
+        findings.push(...lintMarkdown(doc.relPath, doc.content));
+    }
+    findings.push(...(await checkConsistency(model)));
+    const filesChecked = model.documents.length + (model.techStack === undefined ? 0 : 1) + (model.projectStatus === undefined ? 0 : 1);
+    return { findings, filesChecked };
+}
+//# sourceMappingURL=lint.js.map

package/dist/src/lint.js.map

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

package/dist/src/project.d.ts

@@ -0,0 +1,26 @@
+/** One markdown document under docs/project/, with its frontmatter pre-parsed. */
+export interface ProjectDocument {
+    /** Path relative to the repository root, POSIX-style. */
+    relPath: string;
+    content: string;
+    /** Parsed frontmatter mapping; undefined when missing or unparseable. */
+    frontmatter?: Record<string, unknown>;
+}
+/** A YAML artifact (tech_stack.yaml, project_status.yaml). */
+export interface YamlArtifact {
+    relPath: string;
+    /** Parsed content; undefined when the file does not parse. */
+    data?: unknown;
+    parseError?: string;
+}
+export interface ProjectModel {
+    repoRoot: string;
+    documents: ProjectDocument[];
+    techStack?: YamlArtifact;
+    projectStatus?: YamlArtifact;
+}
+/**
+ * Load every documentation artifact under `<repoRoot>/docs/project/`.
+ * Throws if the directory does not exist (not an AIGentDocs repository).
+ */
+export declare function loadProject(repoRoot: string): Promise<ProjectModel>;

package/dist/src/project.js

@@ -0,0 +1,49 @@
+import { access, readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { extractFrontmatter, parseYaml } from "./frontmatter.js";
+async function loadYamlArtifact(repoRoot, relPath) {
+    const absPath = path.join(repoRoot, relPath);
+    const exists = await access(absPath).then(() => true, () => false);
+    if (!exists) {
+        return undefined;
+    }
+    const text = await readFile(absPath, "utf8");
+    try {
+        return { relPath, data: parseYaml(text) };
+    }
+    catch (error) {
+        return { relPath, parseError: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Load every documentation artifact under `<repoRoot>/docs/project/`.
+ * Throws if the directory does not exist (not an AIGentDocs repository).
+ */
+export async function loadProject(repoRoot) {
+    const projectDir = path.join(repoRoot, "docs", "project");
+    await access(projectDir).catch(() => {
+        throw new Error(`'${projectDir}' not found — is this an AIGentDocs repository?`);
+    });
+    const entries = await readdir(projectDir, { recursive: true, withFileTypes: true });
+    const files = entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+        .map((entry) => path.join(entry.parentPath, entry.name))
+        .sort();
+    const documents = [];
+    for (const file of files) {
+        const content = await readFile(file, "utf8");
+        const fm = extractFrontmatter(content);
+        documents.push({
+            relPath: path.relative(repoRoot, file).split(path.sep).join("/"),
+            content,
+            frontmatter: fm.data,
+        });
+    }
+    return {
+        repoRoot,
+        documents,
+        techStack: await loadYamlArtifact(repoRoot, "docs/project/03_engineering/tech_stack.yaml"),
+        projectStatus: await loadYamlArtifact(repoRoot, "docs/project/project_status.yaml"),
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/src/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA0BjE,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACzF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAClC,MAAM,IAAI,KAAK,CAAC,IAAI,UAAU,iDAAiD,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SACvD,IAAI,EAAE,CAAC;IAEV,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvC,SAAS,CAAC,IAAI,CAAC;YACb,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChE,OAAO;YACP,WAAW,EAAE,EAAE,CAAC,IAAI;SACrB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,SAAS,EAAE,MAAM,gBAAgB,CAAC,QAAQ,EAAE,6CAA6C,CAAC;QAC1F,aAAa,EAAE,MAAM,gBAAgB,CAAC,QAAQ,EAAE,kCAAkC,CAAC;KACpF,CAAC;AACJ,CAAC"}

package/dist/src/scaffold.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `init` — scaffold the AIGentDocs structure into a repository.
+ *
+ * - full: docs/standard/ + empty docs/project/ tree + status artifacts
+ *   (project_status.yaml, TODO.md, stamped with today's date) + AGENTS.md.
+ *   Content documents are NOT created: sessions create them from templates
+ *   (empty placeholders would wrongly signal Onboarding Mode).
+ * - lite: docs/standard/ + the three Lite files copied from templates
+ *   (vision.md, roadmap.md, tech_stack.yaml) + AGENTS.md. Running `lint`
+ *   right after a lite init lists the empty [REQUIRED] sections — that is
+ *   the adopter's documentation to-do list, by design.
+ */
+export type InitProfile = "full" | "lite";
+export interface InitResult {
+    profile: InitProfile;
+    /** Paths created, relative to the target directory. */
+    created: string[];
+}
+export declare function initProject(targetDir: string, standardDir: string, profile: InitProfile): Promise<InitResult>;

package/dist/src/scaffold.js

@@ -0,0 +1,52 @@
+import { access, cp, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+const exists = (p) => access(p).then(() => true, () => false);
+const FULL_PROJECT_DIRS = [
+    "01_product/domain_modules",
+    "02_architecture",
+    "03_engineering",
+    "04_adrs",
+    "05_corrections",
+];
+export async function initProject(targetDir, standardDir, profile) {
+    const docsDir = path.join(targetDir, "docs");
+    if (await exists(docsDir)) {
+        throw new Error(`'${docsDir}' already exists — refusing to overwrite. Remove it or run init in a clean repository.`);
+    }
+    if (!(await exists(path.join(standardDir, "AGENT.md")))) {
+        throw new Error(`'${standardDir}' does not look like the standard (AGENT.md not found)`);
+    }
+    const created = [];
+    const today = new Date().toISOString().slice(0, 10);
+    await mkdir(docsDir, { recursive: true });
+    await cp(standardDir, path.join(docsDir, "standard"), { recursive: true });
+    created.push("docs/standard/");
+    const copyTemplate = async (template, relTarget) => {
+        const target = path.join(targetDir, relTarget);
+        await mkdir(path.dirname(target), { recursive: true });
+        const content = await readFile(path.join(standardDir, "templates", template), "utf8");
+        await writeFile(target, content.replaceAll("YYYY-MM-DD", today));
+        created.push(relTarget);
+    };
+    if (profile === "lite") {
+        await copyTemplate("vision.md", "docs/project/01_product/vision.md");
+        await copyTemplate("roadmap.md", "docs/project/01_product/roadmap.md");
+        await copyTemplate("tech_stack.yaml", "docs/project/03_engineering/tech_stack.yaml");
+    }
+    else {
+        for (const dir of FULL_PROJECT_DIRS) {
+            await mkdir(path.join(targetDir, "docs", "project", dir), { recursive: true });
+            created.push(`docs/project/${dir}/`);
+        }
+        await copyTemplate("project_status.yaml", "docs/project/project_status.yaml");
+        await copyTemplate("TODO.md", "docs/project/TODO.md");
+    }
+    if (await exists(path.join(targetDir, "AGENTS.md"))) {
+        created.push("(AGENTS.md already present — left untouched)");
+    }
+    else {
+        await copyTemplate("AGENTS.md", "AGENTS.md");
+    }
+    return { profile, created };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/src/scaffold.js.map

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

package/dist/src/sections.d.ts

@@ -0,0 +1,2 @@
+import type { Finding } from "./index.js";
+export declare function checkSections(file: string, type: string, content: string, frontmatter?: Record<string, unknown>): Finding[];

package/dist/src/sections.js

@@ -0,0 +1,133 @@
+/**
+ * Lint v2 — [REQUIRED] section presence/non-emptiness per document type and
+ * countable thresholds (US with too many or zero ACs, oversized Mermaid
+ * diagrams), per AGENT_REVIEW.md Mechanical layer.
+ *
+ * Section names are the canonical English headings of the standard's
+ * templates. Projects documented in another language are not yet covered
+ * by these checks (per-language catalogs are future work).
+ */
+/** Canonical [REQUIRED] headings per document type. */
+const REQUIRED_SECTIONS = {
+    vision: ["Elevator Pitch", "Problem It Solves", "Target Users (Personas)", "Project Scope", "Domain Glossary", "Domain Entity Map"],
+    roadmap: ["Current Phase/Milestone", "Task Board"],
+    quality_attributes: ["Performance", "Security"],
+    domain_module: ["Description", "Attributes / Properties", "Business Rules", "User Stories", "Relationships"],
+    system_overview: ["Context Diagram (C4 Level 1)", "Container Diagram (C4 Level 2)", "Folder Structure", "Architectural Patterns"],
+    data_flow: ["Global Process View", "Data Model"],
+    infrastructure: ["Environment", "Deployment Diagram", "CI/CD", "Variables and Secrets"],
+    testing_strategy: ["Required Test Types", "Testing Tools", "Minimum Expected Coverage", "Test File Structure"],
+    api_guidelines: ["API Standard", "Endpoint Conventions", "Request/Response Format", "Authentication and Authorization"],
+    adr: ["Context and Problem", "Decision", "Consequences"],
+    correction: ["Defect Report", "Impact Map"],
+};
+const MERMAID_NODE_LIMIT = 20;
+const US_AC_LIMIT = 6;
+function parseHeadings(lines) {
+    const headings = [];
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        if (/^\s*```/.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        const match = inFence ? null : /^(#{1,6})\s+(.+?)\s*$/.exec(line);
+        if (match) {
+            headings.push({ level: match[1]?.length ?? 1, text: match[2] ?? "", line: i });
+        }
+    }
+    return headings;
+}
+const normalize = (text) => text.toLowerCase().replace(/\s+/g, " ").replace(/\s*\/\s*/g, "/").trim();
+/** Body of a section: from its heading to the next heading of same or higher level. */
+function sectionBody(lines, headings, index) {
+    const start = (headings[index]?.line ?? 0) + 1;
+    const level = headings[index]?.level ?? 1;
+    let end = lines.length;
+    for (let i = index + 1; i < headings.length; i++) {
+        if ((headings[i]?.level ?? 6) <= level) {
+            end = headings[i]?.line ?? lines.length;
+            break;
+        }
+    }
+    return lines.slice(start, end).join("\n");
+}
+const isEmptyBody = (body) => body.replace(/<!--[\s\S]*?-->/g, "").replace(/^---\s*$/gm, "").trim() === "";
+export function checkSections(file, type, content, frontmatter) {
+    const findings = [];
+    const add = (rule, severity, message) => {
+        findings.push({ rule, severity, file, message });
+    };
+    const lines = content.split(/\r?\n/);
+    const headings = parseHeadings(lines);
+    const byName = new Map();
+    headings.forEach((h, i) => {
+        if (!byName.has(normalize(h.text))) {
+            byName.set(normalize(h.text), i);
+        }
+    });
+    // --- [REQUIRED] sections: present and non-empty ---------------------------
+    for (const section of REQUIRED_SECTIONS[type] ?? []) {
+        const index = byName.get(normalize(section));
+        if (index === undefined) {
+            add("section/missing", "critical", `missing [REQUIRED] section '${section}'`);
+        }
+        else if (isEmptyBody(sectionBody(lines, headings, index))) {
+            add("section/empty", "critical", `[REQUIRED] section '${section}' is empty`);
+        }
+    }
+    // --- Correction Records: Resolution is required once applied --------------
+    if (type === "correction" && frontmatter?.["status"] === "applied") {
+        const index = byName.get(normalize("Resolution"));
+        if (index === undefined || isEmptyBody(sectionBody(lines, headings, index))) {
+            add("section/correction-resolution", "critical", "an applied Correction Record must have a non-empty 'Resolution' section");
+        }
+    }
+    // --- User Stories: every US needs ACs; more than 6 needs a human decision --
+    if (type === "domain_module") {
+        headings.forEach((h, i) => {
+            const usMatch = /^(US-\d+)/i.exec(h.text);
+            if (!usMatch) {
+                return;
+            }
+            const acCount = (sectionBody(lines, headings, i).match(/^\s*[-*]\s*\[[ xX]\]\s*AC-/gm) ?? []).length;
+            if (acCount === 0) {
+                add("us/no-acceptance-criteria", "critical", `${usMatch[1]} has no Acceptance Criteria (expected '- [ ] AC-NN: ...' items)`);
+            }
+            else if (acCount > US_AC_LIMIT) {
+                add("threshold/us-ac-count", "warning", `${usMatch[1]} has ${acCount} ACs (> ${US_AC_LIMIT}): ask the human to split it or approve it as indivisible`);
+            }
+        });
+    }
+    // --- Mermaid diagrams: rough node-count heuristic --------------------------
+    for (const block of content.matchAll(/```mermaid\r?\n([\s\S]*?)```/g)) {
+        const nodes = countMermaidNodes(block[1] ?? "");
+        if (nodes > MERMAID_NODE_LIMIT) {
+            add("threshold/mermaid-size", "suggestion", `a Mermaid diagram has ~${nodes} nodes (> ${MERMAID_NODE_LIMIT}): consider splitting it`);
+        }
+    }
+    return findings;
+}
+const MERMAID_KEYWORDS = new Set([
+    "graph", "flowchart", "subgraph", "end", "direction", "sequencediagram", "participant", "actor",
+    "erdiagram", "classdiagram", "statediagram", "note", "over", "alt", "else", "opt", "loop", "par",
+    "and", "rect", "activate", "deactivate", "title", "td", "tb", "lr", "rl", "bt",
+]);
+/** Heuristic: unique identifiers appearing on relationship/edge lines. */
+function countMermaidNodes(source) {
+    const ids = new Set();
+    for (const line of source.split(/\r?\n/)) {
+        if (!/-->|---|==>|\.\.>|\|\|--|}o--|\|o--|}\|--|->>|-->>|--x|-x/.test(line)) {
+            continue;
+        }
+        for (const token of line.matchAll(/[A-Za-z_][A-Za-z0-9_]*/g)) {
+            const id = token[0];
+            if (!MERMAID_KEYWORDS.has(id.toLowerCase())) {
+                ids.add(id);
+            }
+        }
+    }
+    return ids.size;
+}
+//# sourceMappingURL=sections.js.map

package/dist/src/sections.js.map

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

package/dist/src/update.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `update` — upgrade an adopter's docs/standard/ to the standard bundled
+ * with the CLI.
+ *
+ * Version detection needs no configuration: the adopter's own copy of
+ * changelog.yaml declares the installed version (top entry), and the
+ * packaged standard declares the available one. The entries between the
+ * two ARE the migration notes.
+ *
+ * README.md is the adopter's customization point (title, conventions), so
+ * a customized README is preserved and the incoming one is written next to
+ * it as README.md.new for manual merging. An uncustomized README (still
+ * carrying the generic title) is simply replaced.
+ */
+export interface ChangelogEntry {
+    version: string;
+    date?: string;
+    summary?: string;
+}
+export interface UpdateResult {
+    status: "up-to-date" | "would-update" | "updated" | "ahead";
+    /** Installed standard version (top of the adopter's changelog copy). */
+    from: string;
+    /** Packaged standard version. */
+    to: string;
+    /** Changelog entries newer than `from` — the migration notes. */
+    notes: ChangelogEntry[];
+    /** True when README.md was preserved and README.md.new needs a manual merge. */
+    readmeNeedsMerge: boolean;
+}
+/** Compare dotted numeric versions ("1.4.3" vs "1.4"): -1 | 0 | 1. */
+export declare function compareVersions(a: string, b: string): number;
+export declare function updateStandard(targetDir: string, packagedStandardDir: string, options?: {
+    check?: boolean;
+}): Promise<UpdateResult>;

package/dist/src/update.js

@@ -0,0 +1,60 @@
+import { access, cp, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parseYaml } from "./frontmatter.js";
+const GENERIC_README_TITLE = "# Documentation Standard for AI-Augmented Software Engineering";
+/** Compare dotted numeric versions ("1.4.3" vs "1.4"): -1 | 0 | 1. */
+export function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0) {
+            return diff < 0 ? -1 : 1;
+        }
+    }
+    return 0;
+}
+async function readChangelog(standardDir) {
+    const file = path.join(standardDir, "changelog.yaml");
+    const parsed = parseYaml(await readFile(file, "utf8"));
+    if (!Array.isArray(parsed) || parsed.length === 0 || typeof parsed[0].version !== "string") {
+        throw new Error(`'${file}' does not look like a standard changelog`);
+    }
+    return parsed;
+}
+export async function updateStandard(targetDir, packagedStandardDir, options = {}) {
+    const installedDir = path.join(targetDir, "docs", "standard");
+    await access(installedDir).catch(() => {
+        throw new Error(`'${installedDir}' not found — is this an AIGentDocs repository?`);
+    });
+    const from = (await readChangelog(installedDir))[0]?.version ?? "0.0.0";
+    const packaged = await readChangelog(packagedStandardDir);
+    const to = packaged[0]?.version ?? "0.0.0";
+    const base = { status: "up-to-date", from, to, notes: [], readmeNeedsMerge: false };
+    const cmp = compareVersions(from, to);
+    if (cmp === 0) {
+        return base;
+    }
+    if (cmp > 0) {
+        return { ...base, status: "ahead" };
+    }
+    const notes = packaged.filter((entry) => compareVersions(entry.version, from) > 0);
+    if (options.check === true) {
+        return { ...base, status: "would-update", notes };
+    }
+    const theirReadme = await readFile(path.join(installedDir, "README.md"), "utf8").catch(() => undefined);
+    await rm(installedDir, { recursive: true, force: true });
+    await cp(packagedStandardDir, installedDir, { recursive: true });
+    let readmeNeedsMerge = false;
+    const customized = theirReadme !== undefined && !theirReadme.startsWith(GENERIC_README_TITLE);
+    if (customized) {
+        const incoming = await readFile(path.join(installedDir, "README.md"), "utf8");
+        if (incoming !== theirReadme) {
+            await writeFile(path.join(installedDir, "README.md"), theirReadme);
+            await writeFile(path.join(installedDir, "README.md.new"), incoming);
+            readmeNeedsMerge = true;
+        }
+    }
+    return { ...base, status: "updated", notes, readmeNeedsMerge };
+}
+//# sourceMappingURL=update.js.map

package/dist/src/update.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@aigentdocs/core",
+  "version": "0.1.0",
+  "description": "Shared domain model and validation logic for the AIGentDocs tooling (frontmatter parsing, deterministic lint rules, scaffolding, adapters, standard updates).",
+  "license": "MIT",
+  "homepage": "https://github.com/rodrigo-amc/AIGentDocs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rodrigo-amc/AIGentDocs.git",
+    "directory": "packages/core"
+  },
+  "keywords": ["documentation", "docs-as-code", "ai-agents", "lint"],
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  }
+}