@justyork/repo-mind 0.7.2 → 0.8.1

package/.cursor/skills/repomind-docs/reference.md

@@ -0,0 +1,209 @@
+# RepoMind docs — reference
+
+See **[structure.md](structure.md)** for the full documentation tree and domain×type matrix.
+
+## Frontmatter schema
+
+| Field | Type | Required | Validation |
+|-------|------|----------|------------|
+| `type` | string | yes (structured) | Must be one of `DOC_TYPES` below |
+| `domain` | string | yes (structured) | Must be one of `DOC_DOMAINS` below; should match path prefix |
+| `slug` | string | yes | `^[a-z0-9][a-z0-9-]*$`; unique across all indexed files |
+| `status` | string | yes | Must be one of `DOC_STATUSES` below |
+| `title` | string | recommended | Used in UI, search snippets, wikilink fallback |
+| `tags` | string[] | optional | Flat list; used for MCP `list_docs` filter |
+| `related` | string[] | optional | Each entry must match an existing doc slug |
+| `owner` | string | optional | Free text |
+| `updated` | string | optional | ISO date `YYYY-MM-DD` |
+
+### Documentation domains (`domain`)
+
+| Value | Label | Primary content |
+|-------|-------|-----------------|
+| `product` | Product | PRD, roadmap, user value, product open questions |
+| `technical` | Technical | ADR, API, architecture, infra |
+| `game-design` | Game design | Mechanics, balance, system specs |
+| `analytics` | Analytics | Events, metrics, experiments |
+| `art` | Art | Visual style, asset guidelines |
+| `narrative` | Narrative | Lore, story, dialogue |
+| `ops` | Operations | Runbooks, release, liveops |
+| `shared` | Shared | Global glossary, agent rules, cross-domain wiki |
+
+Path inference: first segment under `docs/` if it matches a domain id; otherwise `shared`.
+
+MCP filters: `list_docs({ domain: "game-design" })`, `search_docs({ query, domain: "technical" })`.
+
+### Doc types (`type`)
+
+| Value | Folder | Typical use |
+|-------|--------|-------------|
+| `adr` | `adr/` | Architecture Decision Records |
+| `feature-spec` | `specs/` | Feature/product specifications |
+| `glossary-term` | `glossary/` | Domain vocabulary definitions |
+| `open-question` | `open-questions/` | Unresolved decisions |
+| `agent-instruction` | `agents/` | Rules/workflows for AI agents |
+| `wiki-page` | `wiki/` | General wiki content |
+
+### Status values (`status`)
+
+| Value | Meaning |
+|-------|---------|
+| `draft` | Work in progress; may be incomplete |
+| `proposed` | Ready for review; not yet accepted |
+| `accepted` | Current, authoritative content |
+| `superseded` | Replaced by another doc; keep for history, link to successor |
+
+## Slug rules
+
+- Pattern: `^[a-z0-9][a-z0-9-]*$`
+- Lowercase only; hyphens allowed; no underscores or spaces
+- Globally unique across markdown + yaml/json under `docs/`
+- Explicit `slug:` in frontmatter survives file renames better than path inference
+- Path inference (`slugFromRelativePath`): tries `segments.join('-')` then last segment basename
+
+## Link kinds (LinkIndex)
+
+| Kind | Source | Notes |
+|------|--------|-------|
+| `related` | frontmatter `related:` array | Directed edge; used by `explore_graph` |
+| `wikilink` | body `[[target]]` or `[[label\|target]]` | Backlinks computed automatically |
+| `parent_of` | folder README → child pages | Tree navigation edges |
+
+### Wikilink syntax
+
+```
+[[slug]]
+[[Human Title|slug]]
+```
+
+Regex: `\[\[([^\]|]+)(?:\|([^\]]+))?\]\]`
+
+Resolution order:
+
+1. `target` matches a known slug exactly
+2. Case-insensitive match on slug or document `title`
+
+Broken wikilinks: warning in `repo-mind check` (not a hard violation for `related:`-level errors on wikilinks — check implementation warns on broken wikilink targets).
+
+## Structured files
+
+| Extension | contentKind | Frontmatter | Slug example |
+|-----------|-------------|-------------|--------------|
+| `.md` | markdown | yes (structured) | from frontmatter or path |
+| `.yaml`, `.yml` | yaml | no | `config-app` from `config/app.yaml` |
+| `.json` | json | no | path-derived |
+
+## CLI commands
+
+```bash
+repo-mind init [--cwd <dir>]
+repo-mind setup [--cursor] [--claude] [--force]
+repo-mind check [--cwd <dir>]
+repo-mind export [--force] [--cwd <dir>]
+repo-mind prepare [--all] [--dry-run] [--cwd <dir>] [relative-path]
+repo-mind sync-links [--dry-run] [--no-convert-body] [--no-sync-related] [--cwd <dir>]
+repo-mind mcp
+repo-mind ui [--port <n>] [--cwd <dir>]
+```
+
+### prepare
+
+- Single file: `repo-mind prepare wiki/legacy-page.md`
+- Batch: `repo-mind prepare --all`
+- Skips files that already have valid `type:`
+- Infers `type` from folder; generates `slug`, `title`, empty `tags`/`related`, sets `updated` to today
+
+### sync-links
+
+Default behavior:
+
+1. Convert resolvable `[text](relative.md)` in body to `[[slug]]`
+2. Merge outbound wikilink + markdown-link slugs into frontmatter `related` (deduplicated)
+
+Flags:
+
+- `--dry-run` — report changes without writing
+- `--no-convert-body` — only sync `related`, leave markdown links
+- `--no-sync-related` — only convert body links to wikilinks
+
+## MCP tools
+
+| Tool | Input | Output highlights |
+|------|-------|-------------------|
+| `list_docs` | optional type, status, tag filters | slug list |
+| `search_docs` | query string | ranked matches |
+| `get_doc` | slug | frontmatter + body |
+| `get_glossary_term` | name | definition + related |
+| `explore_graph` | slug, depth | nodes, edges, broken_links |
+
+## repo-mind check
+
+**Violations (fail):**
+
+- Invalid `type` or `status`
+- Missing slug
+- Broken `related:` slug (target doc not found)
+- Duplicate slug across docs
+
+**Warnings (pass with notice):**
+
+- Broken wikilink targets in body
+- Missing image assets referenced in markdown
+- Orphaned `.worktrees/` older than 7 days
+
+## Anti-patterns
+
+| Problem | Why it hurts | Fix |
+|---------|--------------|-----|
+| Duplicate slug | MCP/UI cannot disambiguate | Rename slug or merge docs |
+| Uppercase or spaced slug | Fails validation | Use kebab-case |
+| `related: [missing-slug]` | CI check fails | Create target doc or remove entry |
+| Wikilink by title only | Breaks if title changes | Use `[[slug]]` or `[[Label\|slug]]` |
+| Wrong folder for type | Confusing tree | Use `docs/{domain}/{type-folder}/` |
+| `domain` mismatch with path | check warning | Align frontmatter and path |
+| Product content under wrong domain | Wrong ownership in tree | Move to `product/`, `game-design/`, etc. |
+| Every inline link in `related:` | Noisy graph | Keep 2–5 strategic `related:` entries |
+| Editing only drafts forever | MCP never sees content | Publish to `docs/` |
+| Hard-coded absolute paths in links | Break on move | Use wikilinks or relative md paths |
+| Skipping `updated` | Stale metadata in exports/search | Set date on substantive edits |
+
+## File layout convention
+
+```
+docs/
+├── README.md
+├── assets/
+├── product/
+│   ├── README.md
+│   ├── specs/
+│   ├── wiki/
+│   └── open-questions/
+├── technical/
+│   ├── README.md
+│   ├── adr/
+│   ├── specs/
+│   ├── glossary/
+│   └── wiki/
+├── game-design/
+│   ├── README.md
+│   ├── specs/
+│   ├── glossary/
+│   └── wiki/
+├── analytics/
+│   ├── README.md
+│   ├── specs/
+│   └── wiki/
+├── art/ … narrative/ … ops/ …
+└── shared/
+    ├── README.md
+    ├── agents/
+    ├── glossary/
+    └── wiki/
+```
+
+Legacy flat layout (`docs/adr/`, `docs/specs/` without domain prefix) → `domain: shared`.
+
+## Skill installation
+
+- **Project copy:** `.cursor/skills/repomind-docs/` (versioned in repo)
+- **Personal copy:** copy to `~/.cursor/skills/repomind-docs/` for use in any RepoMind project

package/.cursor/skills/repomind-docs/structure.md

@@ -0,0 +1,132 @@
+# RepoMind documentation structure
+
+Two orthogonal axes organize every page under `docs/`:
+
+| Axis | Field / path | Question it answers |
+|------|----------------|---------------------|
+| **Domain** | `domain:` + first path segment | *Which area of the project?* |
+| **Type** | `type:` + type subfolder | *What kind of document?* |
+
+```mermaid
+flowchart TB
+  subgraph docsRoot [docs/]
+    README[README.md]
+    assets[assets/]
+    subgraph domains [Domains]
+      product[product/]
+      technical[technical/]
+      gameDesign[game-design/]
+      analytics[analytics/]
+      art[art/]
+      narrative[narrative/]
+      ops[ops/]
+      shared[shared/]
+    end
+  end
+  product --> productSpecs[specs/]
+  product --> productWiki[wiki/]
+  technical --> techAdr[adr/]
+  technical --> techSpecs[specs/]
+  gameDesign --> gdSpecs[specs/]
+  shared --> sharedAgents[agents/]
+  shared --> sharedGlossary[glossary/]
+```
+
+## Domain catalog
+
+| Domain id | Label | Scope | Typical content |
+|-----------|-------|-------|-----------------|
+| `product` | Product | User value, roadmap, prioritization | PRD, user stories, product specs, product open questions |
+| `technical` | Technical | Engineering, architecture, delivery | ADR, API specs, infra, technical glossary |
+| `game-design` | Game design | Mechanics, balance, player loops | System specs, tuning docs, design glossary |
+| `analytics` | Analytics | Measurement, experiments | Event dictionaries, metric definitions, dashboard specs |
+| `art` | Art | Visual identity, assets | Style guides, asset specs, UI art wiki |
+| `narrative` | Narrative | Story and text | Lore bible, quest outlines, character wiki |
+| `ops` | Operations | Live service, releases | Runbooks, release checklists, incident playbooks |
+| `shared` | Shared | Cross-domain | Global glossary, agent instructions, project-wide wiki |
+
+## Type subfolders per domain
+
+Created by `repo-mind init`:
+
+| Domain | Subfolders |
+|--------|------------|
+| `product` | `specs/`, `wiki/`, `open-questions/` |
+| `technical` | `adr/`, `specs/`, `glossary/`, `wiki/` |
+| `game-design` | `specs/`, `glossary/`, `wiki/` |
+| `analytics` | `specs/`, `wiki/` |
+| `art` | `wiki/`, `specs/` |
+| `narrative` | `wiki/`, `specs/` |
+| `ops` | `specs/`, `wiki/` |
+| `shared` | `agents/`, `glossary/`, `wiki/` |
+
+You may add subfolders (e.g. `technical/specs/api/`) — type is inferred from the nearest matching segment (`specs` → `feature-spec`).
+
+## Canonical path pattern
+
+```
+docs/{domain}/{type-folder}/{slug}.md
+```
+
+Examples:
+
+```
+docs/product/specs/onboarding-flow.md
+docs/technical/adr/use-postgres.md
+docs/game-design/specs/combat-system.md
+docs/analytics/specs/event-dictionary.md
+docs/shared/glossary/mcp.md
+docs/shared/agents/query-first.md
+docs/narrative/wiki/world-lore.md
+```
+
+Each `{domain}/README.md` is the domain index. Each `{domain}/{type-folder}/README.md` optional when the section grows.
+
+## Domain × type matrix (what goes where)
+
+| | `feature-spec` | `adr` | `glossary-term` | `open-question` | `wiki-page` | `agent-instruction` |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|
+| **product** | PRD, feature brief | rare | product terms | prioritization | product wiki | — |
+| **technical** | API, modules | **primary** | tech terms | arch tradeoffs | tech notes | — |
+| **game-design** | systems, balance | design decisions | mechanic terms | tuning open Q | design wiki | — |
+| **analytics** | events, metrics | — | metric defs | experiment Q | analytics wiki | — |
+| **art** | asset specs | style decisions | art terms | — | moodboards wiki | — |
+| **narrative** | quest specs | story decisions | lore terms | plot open Q | lore wiki | — |
+| **ops** | runbook specs | ops decisions | ops terms | process Q | ops wiki | — |
+| **shared** | — | — | **global glossary** | — | general wiki | **agent rules** |
+
+Empty cells mean “unusual — prefer another domain or `wiki-page`”.
+
+## Legacy flat layout (supported)
+
+Pre-domain repos may still use:
+
+```
+docs/adr/foo.md
+docs/specs/bar.md
+```
+
+These infer `domain: shared`. Migrate gradually:
+
+1. Move files under `docs/{domain}/{type-folder}/`
+2. Add `domain:` to frontmatter
+3. Run `repo-mind check`
+
+## Structured files and assets
+
+```
+docs/assets/                    # images referenced from markdown
+docs/analytics/specs/events.yaml  # yaml/json — no frontmatter, domain from path
+```
+
+## Agent routing rules
+
+When creating a page, decide in order:
+
+1. **Domain** — who owns this knowledge? (product vs technical vs game-design …)
+2. **Type** — ADR vs spec vs glossary vs wiki?
+3. **Path** — `docs/{domain}/{type-folder}/{kebab-name}.md`
+4. **Frontmatter** — `type`, `domain`, `slug`, `status`, `title`, `related`, `updated`
+5. **Links** — wikilinks in body; 2–5 strategic slugs in `related:`
+
+Cross-domain links are normal: a game-design spec may `related: [combat-events]` pointing to an analytics spec.

package/dist/cli.js

@@ -3,6 +3,7 @@ import { runAbEval } from './commands/ab-eval.js';
 import { runCheck } from './commands/check.js';
 import { runExport } from './commands/export.js';
 import { runInit } from './commands/init.js';
+import { runInstallSkill } from './commands/install-skill.js';
 import { runPrepare } from './commands/prepare.js';
 import { runPublish } from './commands/publish.js';
 import { runSetup } from './commands/setup.js';
@@ -15,6 +16,7 @@ function printHelp() {
 Usage:
   repo-mind init [--cwd <dir>]
   repo-mind setup [--cursor] [--claude] [--force]
+  repo-mind install-skill [--cwd <dir>] [--global] [--force]
   repo-mind check [--cwd <dir>]
   repo-mind export [--force] [--cwd <dir>]
   repo-mind prepare [--all] [--dry-run] [--cwd <dir>] [relative-path]
@@ -24,9 +26,13 @@ Usage:
   repo-mind mcp
   repo-mind ui [--port <n>] [--cwd <dir>]
 
+Environment:
+  REPOMIND_UI_PASSWORD   When set, protects the UI and API with password login
+
 Commands:
   init    Scaffold docs/ with example structured pages
   setup   Configure Cursor/Claude MCP and CLAUDE.md snippet
+  install-skill  Copy repomind-docs Cursor skill into .cursor/skills/
   check   Validate frontmatter schema and related links
   export  Write agents.md export to repo root
   prepare Add RepoMind frontmatter to markdown files (--all for batch)
@@ -74,6 +80,10 @@ function parseArgs(argv) {
             flags.claude = true;
             continue;
         }
+        if (arg === '--global') {
+            flags.global = true;
+            continue;
+        }
         if (arg === '--cwd' && rest[i + 1]) {
             flags.cwd = rest[i + 1];
             i += 1;
@@ -176,6 +186,13 @@ async function main() {
                 force: flags.force === true,
             }));
             break;
+        case 'install-skill':
+            process.exit(runInstallSkill({
+                cwd,
+                global: flags.global === true,
+                force: flags.force === true,
+            }));
+            break;
         case 'check':
             process.exit(runCheck({ cwd }));
             break;

package/dist/commands/install-skill.d.ts

@@ -0,0 +1,9 @@
+export declare const SKILL_NAME = "repomind-docs";
+export declare function resolveSkillSourceDir(): string;
+export interface InstallSkillOptions {
+    cwd?: string;
+    global?: boolean;
+    force?: boolean;
+}
+export declare function resolveSkillDestDir(options?: InstallSkillOptions): string;
+export declare function runInstallSkill(options?: InstallSkillOptions): number;

package/dist/commands/install-skill.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const SKILL_NAME = 'repomind-docs';
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+export function resolveSkillSourceDir() {
+    return path.join(PACKAGE_ROOT, '.cursor', 'skills', SKILL_NAME);
+}
+export function resolveSkillDestDir(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    if (options.global) {
+        return path.join(os.homedir(), '.cursor', 'skills', SKILL_NAME);
+    }
+    return path.join(cwd, '.cursor', 'skills', SKILL_NAME);
+}
+export function runInstallSkill(options = {}) {
+    const source = resolveSkillSourceDir();
+    const dest = resolveSkillDestDir(options);
+    if (!fs.existsSync(source)) {
+        console.error(`error: skill source not found at ${source}`);
+        return 1;
+    }
+    if (fs.existsSync(dest) && !options.force) {
+        console.warn(`warning: ${dest} already exists (use --force to replace)`);
+        return 0;
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    if (fs.existsSync(dest)) {
+        fs.rmSync(dest, { recursive: true, force: true });
+    }
+    fs.cpSync(source, dest, { recursive: true });
+    console.log(`Installed ${SKILL_NAME} skill: ${dest}`);
+    return 0;
+}

package/dist/commands/ui.js

@@ -5,6 +5,7 @@ import { closeAllDocsEventStreams } from '../ui/api-handlers.js';
 import { DocsWatcher } from '../ui/docs-watcher.js';
 import { openDraftsDb } from '../ui/db/drafts-db.js';
 import { destroyUiServerConnections, resolveUiStaticDir, startUiServer } from '../ui/server.js';
+import { createOptionalUiAuth } from '../ui/auth.js';
 export async function runUi(options = {}) {
     const cwd = path.resolve(options.cwd ?? process.cwd());
     const port = options.port ?? 3847;
@@ -22,6 +23,7 @@ export async function runUi(options = {}) {
         const draftsDb = openDraftsDb(index.getKnowledgeRoot());
         const docsWatcher = new DocsWatcher(index);
         docsWatcher.start(index.getKnowledgeRoot());
+        const auth = createOptionalUiAuth();
         const server = await startUiServer({
             host: '127.0.0.1',
             port,
@@ -29,10 +31,12 @@ export async function runUi(options = {}) {
             staticDir,
             draftsDb,
             docsWatcher,
+            auth,
         });
         const docCount = index.refresh().length;
         const draftCount = draftsDb.listActive().length;
-        console.log(`RepoMind UI at http://127.0.0.1:${port} (${docCount} docs, ${draftCount} drafts)`);
+        const authNote = auth ? ' · password auth enabled' : '';
+        console.log(`RepoMind UI at http://127.0.0.1:${port} (${docCount} docs, ${draftCount} drafts${authNote})`);
         console.log('Press Ctrl+C to stop');
         await new Promise((resolve) => {
             let shuttingDown = false;

package/dist/ui/auth.d.ts

@@ -0,0 +1,21 @@
+import type { IncomingHttpHeaders } from 'node:http';
+export interface UiAuthOptions {
+    password: string;
+}
+export interface UiAuth {
+    isEnabled: () => boolean;
+    isAuthenticated: (headers: IncomingHttpHeaders) => boolean;
+    login: (password: string) => string | null;
+    logout: (headers: IncomingHttpHeaders) => void;
+    createSessionCookie: (token: string) => string;
+    clearSessionCookie: () => string;
+}
+export interface AuthApiResponse {
+    status: number;
+    body: unknown;
+    setCookie?: string;
+    clearCookie?: boolean;
+}
+export declare function createUiAuth(options: UiAuthOptions): UiAuth;
+export declare function createOptionalUiAuth(): UiAuth | null;
+export declare function handleAuthApi(auth: UiAuth, method: string, urlPath: string, bodyRaw: string, headers: IncomingHttpHeaders): AuthApiResponse | null;

package/dist/ui/auth.js

@@ -0,0 +1,117 @@
+import crypto from 'node:crypto';
+const SESSION_COOKIE = 'repomind_session';
+const SESSION_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+function parseCookies(header) {
+    if (!header) {
+        return {};
+    }
+    const cookies = {};
+    for (const part of header.split(';')) {
+        const [key, ...rest] = part.split('=');
+        const name = key?.trim();
+        if (name) {
+            cookies[name] = decodeURIComponent(rest.join('=').trim());
+        }
+    }
+    return cookies;
+}
+function safeEqual(a, b) {
+    const bufA = Buffer.from(a);
+    const bufB = Buffer.from(b);
+    if (bufA.length !== bufB.length) {
+        crypto.timingSafeEqual(bufA, bufA);
+        return false;
+    }
+    return crypto.timingSafeEqual(bufA, bufB);
+}
+export function createUiAuth(options) {
+    const sessions = new Map();
+    function pruneSessions() {
+        const now = Date.now();
+        for (const [token, expiresAt] of sessions) {
+            if (expiresAt <= now) {
+                sessions.delete(token);
+            }
+        }
+    }
+    return {
+        isEnabled: () => true,
+        isAuthenticated(headers) {
+            pruneSessions();
+            const token = parseCookies(headers.cookie)[SESSION_COOKIE];
+            if (!token) {
+                return false;
+            }
+            const expiresAt = sessions.get(token);
+            if (!expiresAt || expiresAt <= Date.now()) {
+                sessions.delete(token);
+                return false;
+            }
+            return true;
+        },
+        login(password) {
+            if (!safeEqual(password, options.password)) {
+                return null;
+            }
+            const token = crypto.randomBytes(32).toString('base64url');
+            sessions.set(token, Date.now() + SESSION_MAX_AGE_MS);
+            return token;
+        },
+        logout(headers) {
+            const token = parseCookies(headers.cookie)[SESSION_COOKIE];
+            if (token) {
+                sessions.delete(token);
+            }
+        },
+        createSessionCookie(token) {
+            const maxAge = Math.floor(SESSION_MAX_AGE_MS / 1000);
+            return `${SESSION_COOKIE}=${encodeURIComponent(token)}; Path=/; HttpOnly; SameSite=Lax; Max-Age=${maxAge}`;
+        },
+        clearSessionCookie() {
+            return `${SESSION_COOKIE}=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0`;
+        },
+    };
+}
+export function createOptionalUiAuth() {
+    const password = process.env.REPOMIND_UI_PASSWORD?.trim();
+    if (!password) {
+        return null;
+    }
+    return createUiAuth({ password });
+}
+export function handleAuthApi(auth, method, urlPath, bodyRaw, headers) {
+    if (urlPath === '/api/auth/session' && method === 'GET') {
+        return {
+            status: 200,
+            body: { authenticated: auth.isAuthenticated(headers), required: true },
+        };
+    }
+    if (urlPath === '/api/auth/login' && method === 'POST') {
+        let password = '';
+        try {
+            const parsed = JSON.parse(bodyRaw);
+            password = typeof parsed.password === 'string' ? parsed.password : '';
+        }
+        catch {
+            return { status: 400, body: { error: 'invalid JSON body' } };
+        }
+        const token = auth.login(password);
+        if (!token) {
+            return { status: 401, body: { error: 'invalid password' } };
+        }
+        return {
+            status: 200,
+            body: { authenticated: true },
+            setCookie: auth.createSessionCookie(token),
+        };
+    }
+    if (urlPath === '/api/auth/logout' && method === 'POST') {
+        auth.logout(headers);
+        return {
+            status: 200,
+            body: { authenticated: false },
+            clearCookie: true,
+        };
+    }
+    return null;
+}

package/dist/ui/fs-operations.d.ts

@@ -49,7 +49,7 @@ export interface PromotePageResult extends FsPageMutationResult {
 }
 export declare function createFolder(index: DocIndex, parentPath: string, name: string): CreateFolderResult;
 export declare function createPageFile(index: DocIndex, parentPath: string, name: string, options?: CreatePageOptions): CreatePageResult;
-/** Creates sibling folder `{parent}/{basename}/` for a leaf page (Confluence-style); page file stays in place. */
+/** Creates `{parent}/{basename}/README.md` from a leaf page file. */
 export declare function promotePageToFolder(index: DocIndex, pagePath: string): PromotePageResult;
 export declare function movePageFile(index: DocIndex, fromPath: string, toDir: string): FsPageMutationResult;
 export declare function renamePageFile(index: DocIndex, pagePath: string, newName: string): FsPageMutationResult;