living-ai-documentation 1.0.0

package/README.md

@@ -0,0 +1,344 @@
+# Living Documentation
+
+[🇫🇷 Lire en français](./README.fr.md)
+
+> **Local Markdown documentation hub with a built-in MCP server — coding agents create ADRs, draw diagrams, and detect drift while you code.**
+
+Markdown on disk, no cloud, no database, no build step. Point it at a folder, open `http://localhost:4321`. Plug any MCP-aware AI agent into it (Claude Code, Claude Desktop, Cursor…) and your documentation maintains itself as your code evolves.
+
+![npm](https://img.shields.io/npm/v/living-ai-documentation) ![Node.js](https://img.shields.io/badge/Node.js-18%2B-green) ![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue) ![License](https://img.shields.io/badge/License-AGPL--3.0-blue) ![MCP](https://img.shields.io/badge/MCP-Streamable_HTTP-purple)
+
+```bash
+npx living-ai-documentation                # interactive wizard (EN/FR)
+npx living-ai-documentation ./docs         # serve an existing folder
+```
+
+![Living Documentation viewer](./images/living_documentation.jpg)
+
+---
+
+## Two ways to use it
+
+### 1. With an AI coding agent — the killer feature
+
+Living Documentation ships an **MCP server** on `POST /mcp`. Any MCP-aware agent can read, create and audit your project's documentation autonomously.
+
+| You say…                                                   | The agent triggers…           | What happens                                                                                                                            |
+| ---------------------------------------------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| _"feature done"_ / _"feature terminée"_                    | `create-adr`                  | Searches existing ADRs, supersedes the obsolete one if any, writes a new ADR at `To be validated`, binds the source files via metadata. |
+| _"audit the ADRs"_ / _"vérifie la fiabilité des ADR"_      | `audit-adrs-drift`            | Lists every ADR below 80% reliability and brings each back in sync — re-baseline or supersede after your confirmation.                  |
+| _"review this ADR"_ / _"vérifie la pertinence de cet ADR"_ | `review-adr-relevance`        | Reviews a single ADR against the bound source files; refreshes hashes or proposes supersession.                                         |
+| _"backfill ADRs from git"_ / _"retrodocumente depuis git"_ | `retrodocument-adrs-from-git` | Walks git history oldest-first and creates ADRs for the durable decisions that were never documented.                                   |
+| _"give me the big picture"_                                | `generate-context-diagram`    | Creates a C4 context diagram **derived from the docs**, never invented.                                                                 |
+
+**All new ADRs land at `To be validated`.** _You_ promote them. The agent never promotes on your behalf.
+
+### 2. Solo, no AI
+
+A personal docs hub: ADRs, meeting notes, dev journals, feature plans, architecture sketches — all kept as Markdown on disk, git-friendly, zero vendor lock-in. Inline editor, snippets, image paste, file attachments, diagram editor, full-text search, PDF/HTML/Notion/Confluence export.
+
+The two modes mix freely: jot notes solo all week, then let your agent record the ADR when the feature actually lands.
+
+---
+
+## Quick start
+
+```bash
+# Interactive wizard — creates a starter doc folder (EN or FR), scaffolds
+# AGENTS.md / CLAUDE.md / memory/MEMORY.md at the project root and symlinks
+# them into <docs>/AI/ so AI agents can find them.
+npx living-ai-documentation
+
+# Or serve an existing folder
+npx living-ai-documentation ./docs
+npx living-ai-documentation ./docs --port 4000 --open
+```
+
+Then open [http://localhost:4321](http://localhost:4321) (viewer) and [http://localhost:4321/admin](http://localhost:4321/admin) (config).
+
+> The folder argument must be a **relative path** (`./docs`, `../shared/docs`…). Absolute paths and `~` are rejected so the generated `.living-doc.json` stays portable and can be committed.
+
+### Install
+
+```bash
+npx living-ai-documentation                 # zero-install
+npm install -g living-ai-documentation      # global
+```
+
+---
+
+## Connect your AI agent
+
+### Claude Code
+
+```bash
+claude mcp add --transport http living-ai-documentation http://localhost:4321/mcp
+```
+
+Or manually in `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "living-ai-documentation": {
+      "type": "http",
+      "url": "http://localhost:4321/mcp"
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+In `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), then restart:
+
+```json
+{
+  "mcpServers": {
+    "living-ai-documentation": {
+      "type": "http",
+      "url": "http://localhost:4321/mcp"
+    }
+  }
+}
+```
+
+### Cursor, Continue, any MCP client
+
+Use the same HTTP endpoint: `http://localhost:4321/mcp` (Streamable HTTP transport, stateless).
+
+> The Living Documentation server must be running first (`npx living-ai-documentation ./docs`) before the agent connects.
+
+---
+
+## Core concepts
+
+- **Markdown on disk** — each document is a `.md` file. Configuration lives in `.living-doc.json` next to it. Both are git-friendly.
+- **Filename pattern** — default `YYYY_MM_DD_HH_mm_[Category]_title.md`. The pattern is configurable; date, category and title are parsed from it. Files that don't match still appear under **General**.
+- **Folders → categories → docs** in the sidebar. Folder names become the labels; numeric prefixes (`1_TUTORIAL`, `2_REFERENCE`) control order without showing in the UI.
+- **ADRs** are the canonical decision record. The MCP server enforces a normalized frontmatter (`**date:**`, `**status:**`, `**description:**`, `**tags:**`) and a `To be validated` initial status that only a human can promote.
+- **`sourceRoot`** points to the project's code. The MCP source tools (`list_source_files`, `read_source_file`, `search_source`) and the metadata binding rely on it. Defaults to the parent of the docs folder.
+- **Source-file metadata + reliability gauge** — bind a doc to the source files it describes. Each binding stores a SHA-256. The gauge in the doc header (`🔴 → 🟡 → 🟢`) reflects `unchanged / total`. As soon as one bound file is modified or deleted, drift is visible. **God files** (`package.json`, lock files, manifests, barrels) are excluded by convention.
+- **Diagrams are derived views** — they cite the documents they're built from (`evidence`). They cannot introduce concepts absent from the docs.
+
+---
+
+## MCP reference
+
+### Tools (19)
+
+| Group                  | Tool                          | Description                                                                                                                            |
+| ---------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| Onboarding             | `get_server_guide`            | Returns the server guide: workflow, conventions, diagram rules.                                                                        |
+| Documents              | `list_documents`              | Inventory: `id`, `title`, `category`, `folder`, `linkHref`.                                                                            |
+|                        | `read_document`               | Raw Markdown content of a document.                                                                                                    |
+|                        | `create_document`             | Create a new `.md` file (filename from configured pattern, optional `date` override for retrodoc).                                     |
+|                        | `update_document`             | Overwrite an existing doc (drift correction, supersede).                                                                               |
+| Diagrams               | `list_diagrams`               | List saved diagrams.                                                                                                                   |
+|                        | `read_diagram`                | Read nodes + edges of one diagram.                                                                                                     |
+|                        | `create_diagram`              | Create / overwrite a diagram (server-side guardrails enforce C4 progression and edge labels).                                          |
+| Source code (fallback) | `list_source_files`           | List files under `sourceRoot` (ignored: `node_modules`, `dist`, `.git`…).                                                              |
+|                        | `read_source_file`            | Read a file under `sourceRoot`.                                                                                                        |
+|                        | `search_source`               | Grep-like text search under `sourceRoot`.                                                                                              |
+| Metadata               | `list_metadata`               | Source-file bindings of a doc.                                                                                                         |
+|                        | `get_accuracy`                | Per-entry status (`unchanged` / `modified` / `missing`) + weighted accuracy ∈ [0, 1].                                                  |
+|                        | `add_metadata`                | Bind a source file (path under `sourceRoot`), records SHA-256. **Skips god files.**                                                    |
+|                        | `remove_metadata`             | Detach a binding (idempotent — for renames/deletes).                                                                                   |
+|                        | `refresh_metadata`            | Re-hash every binding (re-baseline after an update).                                                                                   |
+| ADR audit              | `list_adrs_below_accuracy`    | Up to 10 ADRs whose accuracy < 80%, sorted most-degraded first. Excludes `SuperSeeded` and non-ADRs.                                   |
+|                        | `review_adr_relevance`        | Factual report on one ADR + drifted files to re-read. Returns a `state` to drive the LLM decision tree.                                |
+| Retrodocumentation     | `retrodocument_adrs_from_git` | Up to 200 git commits (oldest first) classified `candidate` / `trivial` / `merge`, with god-file flags. Used to backfill missing ADRs. |
+
+### Prompts (10)
+
+| Group         | Prompt                        | When                                                                                                      |
+| ------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------- |
+| ADR lifecycle | `create-adr`                  | A feature has just been implemented or modified. Records the decision, supersedes a prior ADR if any.     |
+|               | `audit-adrs-drift`            | Batch audit: bring every drifting ADR back to a clear state (re-baseline or user-confirmed supersession). |
+|               | `review-adr-relevance`        | Single ADR review against its bound source files.                                                         |
+|               | `retrodocument-adrs-from-git` | Backfill ADRs from git history when the project lacks them.                                               |
+| Diagrams      | `generate-context-diagram`    | DEFAULT. C4 context diagram, gated server-side.                                                           |
+|               | `generate-container-diagram`  | Explicit-only. C4 container diagram of one system.                                                        |
+|               | `generate-uml-diagram`        | Explicit-only. UML class/sequence/state/activity/use-case.                                                |
+|               | `generate-screen-guide`       | Explicit-only. Annotated screenshot with post-it callouts.                                                |
+|               | `update-diagram-from-docs`    | Re-read source documents to update existing diagrams.                                                     |
+|               | `flow`, `erd`                 | Linear flow / entity-relationship diagrams.                                                               |
+
+A `GET http://localhost:4321/mcp` returns the live tool + prompt schemas for inspection.
+
+---
+
+## Authoring features
+
+- **Inline editor** — edit any doc in the browser, saves to disk instantly.
+- **Snippets panel** (`🧩 Snippets`) — pre-built Markdown constructs at the cursor: collapsible blocks, links (in-doc, cross-doc, anchor), lists, code blocks, blockquotes, separators, images. Plus a **table editor** (dynamic grid → aligned Markdown table) and a **tree editor** (indentation → ASCII tree with `├──` / `└──`). Selecting an existing snippet **detects its type** and pre-fills the form for editing.
+- **Image paste** — paste from clipboard while editing, auto-uploaded to `<docs>/images/`, inserted as Markdown.
+- **File attachments** — drag, drop, paste or pick any non-image file (PDF, archive, office doc). Uploaded under `<docs>/files/`, inserted as a paperclip pill. Blocked extensions and size limits configurable in Admin.
+- **Full-text search** — instant filename filter + server-side content search; for each file lists every occurrence, highlights and jumps to them.
+- **`metadata://<filename>` search prefix** — reverse-lookup: which documents reference this attachment?
+- **Annotations** — persistent highlight markers per document (yellow / pink / green / blue).
+- **Anchor navigation** — `[label](#heading-slug)` scrolls correctly after async render; IDs auto-generated.
+- **Dark mode** — follows system preference, manually toggleable. Syntax highlighting always dark.
+
+![Sidebar grouped by folder → category](./images/readme-sidebar.png)
+
+![Full-text search](./images/readme-intelligent-search-demo.jpg)
+
+---
+
+## Diagram editor
+
+Built-in canvas diagram editor (vis-network), accessible at `/diagram?id=...`.
+
+- **C4 progression enforced** — context first (default), container/component only on explicit request. UML on explicit request.
+- **Architectural `kind` vs visual `renderAs`** — separate the concept (`software_system`, `database`, `queue`, `api`, `cloud_service`…) from the shape (`box`, `ellipse`, `database`, `actor`, `post-it`…). The MCP picks sensible defaults for each `kind`.
+- **Evidence provenance** — every architectural node/edge can cite the document and section that justifies it. The editor surfaces missing-evidence warnings.
+- **Custom shape libraries** at `/shape-editor` — define your own shapes (SVG icons, ports, default colors) and reuse them across diagrams.
+- **Ports** for anchored edges, **alignment guides**, **undo/redo**, **snap-to-grid**, **paste images**, **PNG export**, **deep-link** to a diagram by id.
+
+---
+
+## File organization
+
+```
+docs/
+├── 2024_01_15_09_30_[DevOps]_deploy.md          → category: DevOps
+├── 1_tutorial/                                   → folder: Tutorial (prefix hidden in UI)
+│   └── 2024_03_01_10_00_[Onboarding]_setup.md   → folder: Tutorial / category: Onboarding
+├── adrs/
+│   └── 2024_04_01_10_15_[Architecture]_event_sourcing.md
+└── 2_reference/
+    └── api.md                                    → folder: Reference / category: General
+```
+
+- The `[Category]` tag is parsed from the filename regardless of the folder.
+- Files without a `[Category]` fall under **General**. **General** is always rendered first.
+- Folders are sorted alphabetically — prefix with `1_`, `2_`… to force an order; the prefix is hidden in the UI but visible on hover.
+- Subdirectory nesting is supported recursively.
+
+![Filename pattern](./images/readme-filename-pattern.png)
+
+---
+
+## Configuration (`.living-doc.json`)
+
+Created automatically in your docs folder on first run. Edit in the Admin panel or by hand.
+
+```json
+{
+  "filenamePattern": "YYYY_MM_DD_HH_mm_[Category]_title",
+  "title": "Living Documentation",
+  "theme": "system",
+  "port": 4321,
+  "extraFiles": ["../README.md", "../CLAUDE.md"],
+  "sourceRoot": "../src",
+  "blockedFileExtensions": [".exe", ".bin"]
+}
+```
+
+| Field                   | Role                                                                                                        |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `filenamePattern`       | Filename convention used to parse date / category / title. `[Category]` token mandatory, exactly once.      |
+| `extraFiles`            | Ordered Markdown files **outside** the docs folder (e.g. `README.md`, `CLAUDE.md`). Shown in General first. |
+| `sourceRoot`            | Where your code lives (relative to docs folder). Defaults to `..`. Used by MCP source + metadata tools.     |
+| `blockedFileExtensions` | File-attachment safety list, editable from Admin.                                                           |
+
+**All paths are relative POSIX** so `.living-doc.json` stays portable. Legacy absolute paths are silently migrated on first read.
+
+![Extra files](./images/readme-extra-files.png)
+
+---
+
+## Export
+
+| Format                 | Endpoint                    | Notes                                              |
+| ---------------------- | --------------------------- | -------------------------------------------------- |
+| PDF (per doc)          | `POST /api/export/html`     | Browser print dialog from the rendered HTML.       |
+| HTML — Notion mode     | `POST /api/export/html`     | Single HTML bundle suitable for Notion import.     |
+| HTML — Confluence mode | `POST /api/export/html`     | Zipped HTML bundle suitable for Confluence import. |
+| Markdown bundle        | `POST /api/export/markdown` | Zip of every document with normalized links.       |
+
+---
+
+## UI surfaces
+
+| URL             | Page                                                                                         |
+| --------------- | -------------------------------------------------------------------------------------------- |
+| `/`             | Viewer — sidebar, document rendering, inline edit, snippets, search, attachments.            |
+| `/admin`        | Config — title, theme, filename pattern, extra files, source root, file safety list.         |
+| `/diagram?id=`  | Diagram editor (vis-network) with C4 conventions, ports, alignment guides, undo/redo.        |
+| `/shape-editor` | Custom shape library editor — SVG icons, default colors, ports.                              |
+| `/context`      | AI context page — instructions, rules, memory, **MCP explorer** (try tools live in-browser). |
+
+---
+
+## REST API
+
+<details>
+<summary>Full HTTP API (click to expand)</summary>
+
+| Method   | Endpoint                       | Description                                                                                                  |
+| -------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| `GET`    | `/api/documents`               | List documents with metadata (includes extra files).                                                         |
+| `GET`    | `/api/documents/:id`           | Document content + rendered HTML.                                                                            |
+| `POST`   | `/api/documents`               | Create from `{ title, category, folder?, content?, date? }`.                                                 |
+| `PUT`    | `/api/documents/:id`           | Save content to disk.                                                                                        |
+| `DELETE` | `/api/documents/:id`           | Delete a document.                                                                                           |
+| `GET`    | `/api/documents/search?q=`     | Full-text search.                                                                                            |
+| `GET`    | `/api/config`                  | Read config.                                                                                                 |
+| `PUT`    | `/api/config`                  | Update config (`title`, `theme`, `filenamePattern`, `extraFiles`, `sourceRoot`, `blockedFileExtensions`, …). |
+| `GET`    | `/api/browse?path=`            | List directories and `.md` files at a path.                                                                  |
+| `POST`   | `/api/browse/mkdir`            | Create a folder under the docs root.                                                                         |
+| `POST`   | `/api/images/upload`           | Upload a base64 image → `<docs>/images/`.                                                                    |
+| `POST`   | `/api/files/upload`            | Upload a base64 attachment → `<docs>/files/`.                                                                |
+| `GET`    | `/api/files`                   | List every attachment (chronological).                                                                       |
+| `PUT`    | `/api/files/:filename`         | Replace an attachment.                                                                                       |
+| `DELETE` | `/api/files/:filename`         | Delete an attachment.                                                                                        |
+| `GET`    | `/api/metadata/:docId`         | Reliability report for one doc.                                                                              |
+| `POST`   | `/api/metadata/:docId`         | Add or replace a binding.                                                                                    |
+| `DELETE` | `/api/metadata/:docId`         | Remove a binding.                                                                                            |
+| `POST`   | `/api/metadata/:docId/refresh` | Re-baseline hashes.                                                                                          |
+| `GET`    | `/api/browse-source?path=`     | Navigate the source tree rooted at `sourceRoot`.                                                             |
+| `GET`    | `/api/diagrams`                | List saved diagrams.                                                                                         |
+| `GET`    | `/api/diagrams/:id`            | Read a single diagram (nodes + edges).                                                                       |
+| `PUT`    | `/api/diagrams/:id`            | Create or update a diagram.                                                                                  |
+| `DELETE` | `/api/diagrams/:id`            | Delete a diagram.                                                                                            |
+| `GET`    | `/api/shape-libraries`         | List custom shape libraries.                                                                                 |
+| `PUT`    | `/api/shape-libraries/:id`     | Save a shape library.                                                                                        |
+| `GET`    | `/api/annotations[/:docId]`    | List annotations (all docs / one doc).                                                                       |
+| `POST`   | `/api/annotations/:docId`      | Add an annotation.                                                                                           |
+| `DELETE` | `/api/annotations/:docId/:id`  | Delete one annotation.                                                                                       |
+| `POST`   | `/api/export/html`             | HTML export — Notion / Confluence modes.                                                                     |
+| `POST`   | `/api/export/markdown`         | Markdown bundle export.                                                                                      |
+| `GET`    | `/api/wordcloud?path=&ext=`    | Recursively concatenate matching source files as raw text.                                                   |
+| `POST`   | `/mcp`                         | Model Context Protocol endpoint (Streamable HTTP).                                                           |
+| `GET`    | `/mcp`                         | Live tool + prompt schema summary.                                                                           |
+
+</details>
+
+---
+
+## Build & test
+
+```bash
+git clone https://github.com/craftskillz/living-documentation.git
+cd living-documentation
+npm install
+npm run setup-hooks                      # one-time: enable .githooks/ as core.hooksPath
+npm run dev -- ./documentation          # nodemon + ts-node, watches src + bin
+npm run build                            # tsc → dist/ + copy frontend assets
+npm run test:e2e                         # Playwright end-to-end (~3 s, ~30 MCP specs)
+npm run test:coverage                    # c8 V8-native coverage
+```
+
+End-to-end tests use **Playwright**. Each test spawns a real CLI child process against a fresh fixture on a random port — no leaking state, runs in parallel. Server-side coverage via **c8** (V8 native, ~72% baseline overall, 83% on `src/routes` and `src/lib`).
+
+### Contributing
+
+This repository ships with a `pre-commit` hook (under `.githooks/`) that enforces the bilingual README contract: if you touch `README.md` you must also touch `README.fr.md`, and vice-versa. Run `npm run setup-hooks` once after cloning to activate it. The same check runs in CI on every PR (see `.github/workflows/readme-sync.yml`), so the rule is enforced even if a contributor forgets the local setup.
+
+---
+
+## License
+
+[AGPL-3.0](./LICENSE) — © Youssef MEDAGHRI-ALAOUI.

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const promises_1 = require("readline/promises");
+const server_1 = require("../src/server");
+// Handle SIGTERM gracefully so V8 flushes NODE_V8_COVERAGE (used by c8 in tests).
+// Also good hygiene — without this, process exits with code 143 and Express sockets
+// may be dropped mid-flight. process.exit(0) runs pending exit handlers.
+process.once("SIGTERM", () => process.exit(0));
+const program = new commander_1.Command();
+function parseInitLanguage(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "en" || normalized === "fr") {
+        return normalized;
+    }
+    return null;
+}
+function copyDir(src, dest) {
+    fs_1.default.mkdirSync(dest, { recursive: true });
+    for (const entry of fs_1.default.readdirSync(src)) {
+        const srcPath = path_1.default.join(src, entry);
+        const destPath = path_1.default.join(dest, entry);
+        if (fs_1.default.statSync(srcPath).isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs_1.default.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+function docsFolderReference(docsPath) {
+    const projectRoot = path_1.default.dirname(docsPath);
+    return path_1.default.relative(projectRoot, docsPath).split(path_1.default.sep).join("/") || ".";
+}
+function replaceDocsFolderPlaceholders(rootPath, docsFolder) {
+    for (const entry of fs_1.default.readdirSync(rootPath, { withFileTypes: true })) {
+        const fullPath = path_1.default.join(rootPath, entry.name);
+        if (entry.isDirectory()) {
+            replaceDocsFolderPlaceholders(fullPath, docsFolder);
+            continue;
+        }
+        if (!entry.isFile() || path_1.default.extname(entry.name).toLowerCase() !== ".md") {
+            continue;
+        }
+        const content = fs_1.default.readFileSync(fullPath, "utf-8");
+        if (!content.includes("DOCS_FOLDER")) {
+            continue;
+        }
+        fs_1.default.writeFileSync(fullPath, content.split("DOCS_FOLDER").join(docsFolder), "utf-8");
+    }
+}
+function validateRelativeFolder(folder) {
+    if (path_1.default.isAbsolute(folder) || folder.startsWith("~")) {
+        console.error(`\nError: The docs folder must be a relative path (got: ${folder}).\n` +
+            `  Example: npx living-ai-documentation ./mydocs\n` +
+            `  Absolute paths are rejected so .living-doc.json stays portable across machines.\n`);
+        process.exit(1);
+    }
+}
+function scaffoldStarter(docsPath, initLanguage) {
+    const starterDir = initLanguage === "fr" ? "starter-doc-fr" : "starter-doc";
+    const starterDocPath = path_1.default.join(__dirname, "..", starterDir);
+    if (!fs_1.default.existsSync(starterDocPath)) {
+        console.error(`\nError: Starter template not found: ${starterDir}\n`);
+        process.exit(1);
+    }
+    copyDir(starterDocPath, docsPath);
+    console.log(`\nInitialized ${initLanguage} documentation project in ${docsPath}\n`);
+}
+function initInstructionFiles(docsPath) {
+    const projectRoot = path_1.default.dirname(docsPath);
+    const aiPath = path_1.default.join(docsPath, "AI");
+    return [
+        {
+            sourcePath: path_1.default.join(docsPath, "AI", "default", "AGENTS.md"),
+            copyPath: path_1.default.join(projectRoot, "AGENTS.md"),
+            aiLinkPath: path_1.default.join(aiPath, "AGENTS.md"),
+            aiLinkTarget: path_1.default.relative(aiPath, path_1.default.join(projectRoot, "AGENTS.md")),
+        },
+        {
+            sourcePath: path_1.default.join(docsPath, "AI", "default", "CLAUDE.md"),
+            copyPath: path_1.default.join(projectRoot, "CLAUDE.md"),
+            aiLinkPath: path_1.default.join(aiPath, "CLAUDE.md"),
+            aiLinkTarget: path_1.default.relative(aiPath, path_1.default.join(projectRoot, "CLAUDE.md")),
+        },
+        {
+            sourcePath: path_1.default.join(docsPath, "AI", "default", "MEMORY.md"),
+            copyPath: path_1.default.join(projectRoot, "memory", "MEMORY.md"),
+            aiLinkPath: path_1.default.join(aiPath, "MEMORY.md"),
+            aiLinkTarget: path_1.default.relative(aiPath, path_1.default.join(projectRoot, "memory", "MEMORY.md")),
+        },
+    ];
+}
+function tryLstat(filePath) {
+    try {
+        return fs_1.default.lstatSync(filePath);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+function isMissingOrEmptyFile(filePath) {
+    const stat = tryLstat(filePath);
+    if (!stat) {
+        return true;
+    }
+    return stat.isFile() && stat.size === 0;
+}
+function validateInitInstructionTargets(docsPath, instructionFiles) {
+    const projectRoot = path_1.default.dirname(docsPath);
+    const memoryPath = path_1.default.join(projectRoot, "memory");
+    if (fs_1.default.existsSync(memoryPath) && !fs_1.default.lstatSync(memoryPath).isDirectory()) {
+        console.error(`\nError: Cannot create memory/MEMORY.md because memory is not a directory: ${memoryPath}\n`);
+        process.exit(1);
+    }
+    for (const { copyPath } of instructionFiles) {
+        if (!isMissingOrEmptyFile(copyPath)) {
+            console.error(`\nError: Cannot initialize because ${path_1.default.relative(projectRoot, copyPath)} already exists and is not empty.\n` +
+                `  Move it, empty it, or choose another project root before running the initializer.\n`);
+            process.exit(1);
+        }
+    }
+}
+function createInitInstructionFiles(instructionFiles) {
+    for (const { sourcePath, copyPath, aiLinkPath, aiLinkTarget } of instructionFiles) {
+        fs_1.default.mkdirSync(path_1.default.dirname(copyPath), { recursive: true });
+        if (tryLstat(copyPath)) {
+            fs_1.default.unlinkSync(copyPath);
+        }
+        fs_1.default.copyFileSync(sourcePath, copyPath);
+        if (tryLstat(aiLinkPath)) {
+            fs_1.default.unlinkSync(aiLinkPath);
+        }
+        fs_1.default.symlinkSync(aiLinkTarget, aiLinkPath, "file");
+    }
+}
+function removeStarterDefaults(docsPath) {
+    fs_1.default.rmSync(path_1.default.join(docsPath, "AI", "default"), { recursive: true, force: true });
+}
+async function runInitWizard(options) {
+    const rl = (0, promises_1.createInterface)({ input: process.stdin, output: process.stdout });
+    try {
+        const folderAnswer = await rl.question("Documentation folder to create / Dossier de documentation à créer: ");
+        const folder = folderAnswer.trim();
+        if (!folder) {
+            console.error("\nError: Documentation folder is required.\n");
+            process.exit(1);
+        }
+        validateRelativeFolder(folder);
+        const docsPath = path_1.default.resolve(process.cwd(), folder);
+        let shouldCreateDocsPath = false;
+        if (options.starterLanguage && !parseInitLanguage(options.starterLanguage)) {
+            console.error("\nError: Invalid init language. Expected en or fr.\n");
+            process.exit(1);
+        }
+        if (fs_1.default.existsSync(docsPath)) {
+            const stat = fs_1.default.statSync(docsPath);
+            if (!stat.isDirectory()) {
+                console.error(`\nError: Not a directory: ${docsPath}\n`);
+                process.exit(1);
+            }
+            const existing = fs_1.default.readdirSync(docsPath);
+            if (existing.length > 0) {
+                console.error(`\nError: Folder is not empty: ${docsPath}\n`);
+                process.exit(1);
+            }
+        }
+        else {
+            shouldCreateDocsPath = true;
+        }
+        validateInitInstructionTargets(docsPath, initInstructionFiles(docsPath));
+        let initLanguage = options.starterLanguage ? parseInitLanguage(options.starterLanguage) : null;
+        if (!initLanguage && !process.stdin.isTTY) {
+            initLanguage = "en";
+        }
+        while (!initLanguage) {
+            const answer = await rl.question("Choose starter language / Choisissez la langue du starter [en/fr] (en): ");
+            initLanguage = answer.trim() === "" ? "en" : parseInitLanguage(answer);
+            if (!initLanguage) {
+                console.log("Please answer en or fr.");
+            }
+        }
+        if (shouldCreateDocsPath) {
+            fs_1.default.mkdirSync(docsPath, { recursive: true });
+        }
+        scaffoldStarter(docsPath, initLanguage);
+        replaceDocsFolderPlaceholders(docsPath, docsFolderReference(docsPath));
+        const instructionFiles = initInstructionFiles(docsPath);
+        createInitInstructionFiles(instructionFiles);
+        removeStarterDefaults(docsPath);
+        const port = parseInt(options.port, 10);
+        if (isNaN(port) || port < 1 || port > 65535) {
+            console.error("\nError: Invalid port number\n");
+            process.exit(1);
+        }
+        await (0, server_1.startServer)({ docsPath, port, openBrowser: options.open ?? false });
+    }
+    finally {
+        rl.close();
+    }
+}
+program
+    .name("living-ai-documentation")
+    .description("Serve a local Markdown documentation viewer over HTTP on your machine.")
+    .version("1.0.0")
+    .argument("[folder]", "Relative path to an existing documentation folder. Omit it to start the interactive initializer.")
+    .option("--starter-language <language>", "Starter language for the interactive initializer: en or fr")
+    .option("-p, --port <number>", "HTTP port to listen on (1-65535)", "4321")
+    .option("-o, --open", "Open the viewer in the default browser after startup")
+    .addHelpText("after", `
+Examples:
+  $ npx living-ai-documentation                         Create a new documentation project interactively
+  $ npx living-ai-documentation ./mydocs                Serve existing docs at http://localhost:4321
+  $ npx living-ai-documentation ./mydocs -p 5000 -o     Serve on port 5000 and open the browser
+
+Notes:
+  - The folder argument must be a relative path. Absolute paths (/abs/...) and ~-expansion are rejected
+    so .living-doc.json can be checked into git and shared across machines.
+  - When no folder is provided, the initializer asks for the target folder and starter language.
+  - The initializer copies AGENTS.md, CLAUDE.md and memory/MEMORY.md to the parent
+    of the documentation folder, then exposes them in <folder>/AI/ through symbolic links.
+    If one already exists with content, initialization stops instead of overwriting it.
+  - Configuration is persisted to <folder>/.living-doc.json. Edit it via the admin panel at /admin.
+`)
+    .action(async (folder, options) => {
+    if (!folder) {
+        await runInitWizard(options);
+        return;
+    }
+    validateRelativeFolder(folder);
+    const docsPath = path_1.default.resolve(process.cwd(), folder);
+    if (!fs_1.default.existsSync(docsPath)) {
+        console.error(`\nError: Folder not found: ${docsPath}\n`);
+        process.exit(1);
+    }
+    const stat = fs_1.default.statSync(docsPath);
+    if (!stat.isDirectory()) {
+        console.error(`\nError: Not a directory: ${docsPath}\n`);
+        process.exit(1);
+    }
+    const port = parseInt(options.port, 10);
+    if (isNaN(port) || port < 1 || port > 65535) {
+        console.error("\nError: Invalid port number\n");
+        process.exit(1);
+    }
+    await (0, server_1.startServer)({ docsPath, port, openBrowser: options.open ?? false });
+});
+program.parseAsync().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\nError: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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