@developerportalsg/docportal-cli 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,109 @@
-# Temporary Holding Version
+# @developerportalsg/docportal-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+CLI tools for Documentation Portal publishers. Validates links against the platform's custom Docsify link resolution rules.
+
+## Install
+
+```bash
+npm install -g @developerportalsg/docportal-cli
+```
+
+Or run without installing:
+
+```bash
+npx @developerportalsg/docportal-cli check-links .
+```
+
+## Usage
+
+### Local check (filesystem)
+
+```bash
+docportal check-links .
+docportal check-links . --base-path docs
+docportal check-links . --verbose
+docportal check-links . --json
+```
+
+### Remote check (HTTP)
+
+```bash
+docportal check-links --url https://docs.developer.tech.gov.sg --slug my-doc
+docportal check-links --url https://docs.developer.tech.gov.sg --slug my-doc --base-path docs
+```
+
+### Options
+
+| Flag | Description |
+|---|---|
+| `--base-path <path>` | Subdirectory serving as docs root (matches docsify `basePath`) |
+| `--url <url>` | Base URL for remote checking (requires `--slug`) |
+| `--slug <slug>` | Document slug for remote checking |
+| `--json` | Output results as JSONL (one JSON object per line) |
+| `--verbose`, `-v` | Show OK links in addition to broken ones |
+
+### Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | All links OK (or all EXPECT annotations match) |
+| 1 | Mismatches found between actual status and EXPECT annotations |
+
+## What it checks
+
+The Documentation Portal uses a custom Docsify fork with non-standard link resolution. This tool encodes those rules:
+
+| Link type | Resolution rule | `../` | `/path` |
+|---|---|---|---|
+| Document links | From doc root | **Broken** | Doc root |
+| Sidebar links | From doc root | **Broken** | Doc root |
+| Images | From current page directory | Works | Doc root |
+| Embeds (`:include`) | From current file directory | Works | **Broken** |
+
+### Checks performed
+
+- Document and sidebar links resolve from doc root (not current file)
+- `../` in document/sidebar links flagged as broken
+- `/path` in `:include` embeds flagged as broken
+- All link targets verified to exist (filesystem or HTTP)
+- Image paths resolve from current page directory
+- Embed paths resolve from current file directory
+- `:disabled` links skipped
+
+## EXPECT annotations
+
+Test documents can annotate links with expected outcomes:
+
+```markdown
+[Link](page-a) <!-- EXPECT:ok -->
+[Link](../page) <!-- EXPECT:broken:dotdot-unsupported -->
+```
+
+The tool reports **mismatches** when actual results differ from annotations — useful for verifying test cases.
+
+## Development
+
+```bash
+cd tools/docportal-cli
+npm install
+npm run build
+npm test
+```
+
+### Project structure
+
+```
+src/
+  cli.ts                  # CLI entry point and subcommand dispatcher
+  commands/
+    check-links.ts        # check-links command (local + remote modes)
+  lib/
+    resolve.ts            # Docsify link resolution rules
+    parse.ts              # Markdown and sidebar link extraction
+    check-local.ts        # Filesystem-based link checking
+    check-remote.ts       # HTTP-based link checking
+tests/
+  resolve.test.ts         # Unit tests for resolution rules
+```
+
+Zero runtime dependencies — uses only Node.js built-ins and native `fetch`.

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { runCheckLinks } from "./commands/check-links.js";
+const VERSION = "0.2.0";
+const HELP = `
+docportal — CLI tools for Documentation Portal publishers
+
+Usage:
+  docportal <command> [options]
+
+Commands:
+  check-links <path>   Check links against Doc Portal resolution rules
+  check-links --url    Check links against a live published doc
+
+Options:
+  --help, -h           Show this help
+  --version            Show version
+
+Examples:
+  docportal check-links .
+  docportal check-links . --base-path docs
+  docportal check-links . --verbose --json
+  docportal check-links --url https://docs.developer.tech.gov.sg --slug my-doc
+`.trim();
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command || command === "--help" || command === "-h") {
+        console.log(HELP);
+        process.exit(0);
+    }
+    if (command === "--version") {
+        console.log(VERSION);
+        process.exit(0);
+    }
+    if (command === "check-links") {
+        const exitCode = await runCheckLinks(args.slice(1));
+        process.exit(exitCode);
+    }
+    console.error(`Unknown command: ${command}`);
+    console.error(`Run 'docportal --help' for usage.`);
+    process.exit(1);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;CAmBZ,CAAC,IAAI,EAAE,CAAC;AAET,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/check-links.d.ts

@@ -0,0 +1,12 @@
+interface CheckLinksOptions {
+    localPath?: string;
+    basePath: string;
+    url?: string;
+    slug?: string;
+    json: boolean;
+    verbose: boolean;
+}
+export declare function parseCheckLinksArgs(args: string[]): CheckLinksOptions;
+export declare function runCheckLinks(args: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=check-links.d.ts.map

package/dist/commands/check-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-links.d.ts","sourceRoot":"","sources":["../../src/commands/check-links.ts"],"names":[],"mappings":"AAKA,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AA6DD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAwBrE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCnE"}

package/dist/commands/check-links.js

@@ -0,0 +1,121 @@
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { checkLocal } from "../lib/check-local.js";
+import { checkRemote } from "../lib/check-remote.js";
+function printResults(results, verbose, json) {
+    if (json) {
+        for (const r of results)
+            console.log(JSON.stringify(r));
+        return;
+    }
+    const broken = results.filter((r) => r.status === "broken");
+    const ok = results.filter((r) => r.status === "ok");
+    const mismatches = results.filter((r) => r.mismatch);
+    console.log(`\n${"=".repeat(70)}`);
+    console.log(`Link Check Results`);
+    console.log(`${"=".repeat(70)}\n`);
+    if (broken.length > 0) {
+        console.log(`BROKEN LINKS (${broken.length}):\n`);
+        for (const r of broken) {
+            const expectTag = r.expect ? ` [EXPECT:${r.expect}]` : "";
+            console.log(`  BROKEN  ${r.file}:${r.line}  [${r.linkText}](${r.href})${expectTag}`);
+            console.log(`          → resolves to: ${r.resolved}`);
+            if (r.reason)
+                console.log(`          → reason: ${r.reason}`);
+            console.log();
+        }
+    }
+    if (verbose && ok.length > 0) {
+        console.log(`OK LINKS (${ok.length}):\n`);
+        for (const r of ok) {
+            const expectTag = r.expect ? ` [EXPECT:${r.expect}]` : "";
+            console.log(`  OK      ${r.file}:${r.line}  [${r.linkText}](${r.href})${expectTag}`);
+            console.log(`          → resolves to: ${r.resolved}`);
+            console.log();
+        }
+    }
+    if (mismatches.length > 0) {
+        console.log(`\nMISMATCHES (${mismatches.length}) — link status doesn't match EXPECT annotation:\n`);
+        for (const r of mismatches) {
+            console.log(`  ${r.status.toUpperCase().padEnd(7)} ${r.file}:${r.line}  [${r.linkText}](${r.href})`);
+            console.log(`          → expected: ${r.expect}${r.expectReason ? ` (${r.expectReason})` : ""}`);
+            console.log(`          → actual: ${r.status}${r.reason ? ` — ${r.reason}` : ""}`);
+            console.log();
+        }
+    }
+    console.log(`${"─".repeat(70)}`);
+    console.log(`Total: ${results.length} links checked`);
+    console.log(`  OK:     ${ok.length}`);
+    console.log(`  Broken: ${broken.length}`);
+    if (mismatches.length > 0)
+        console.log(`  Mismatches: ${mismatches.length}`);
+    const annotated = results.filter((r) => r.expect);
+    if (annotated.length > 0) {
+        const correct = annotated.filter((r) => !r.mismatch);
+        console.log(`  Annotations: ${correct.length}/${annotated.length} correct`);
+    }
+    console.log();
+}
+export function parseCheckLinksArgs(args) {
+    let localPath;
+    let basePath = "";
+    let url;
+    let slug;
+    let json = false;
+    let verbose = false;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--base-path" && args[i + 1]) {
+            basePath = args[++i];
+        }
+        else if (args[i] === "--url" && args[i + 1]) {
+            url = args[++i];
+        }
+        else if (args[i] === "--slug" && args[i + 1]) {
+            slug = args[++i];
+        }
+        else if (args[i] === "--json") {
+            json = true;
+        }
+        else if (args[i] === "--verbose" || args[i] === "-v") {
+            verbose = true;
+        }
+        else if (!args[i].startsWith("-")) {
+            localPath = args[i];
+        }
+    }
+    return { localPath, basePath, url, slug, json, verbose };
+}
+export async function runCheckLinks(args) {
+    const { localPath, basePath, url, slug, json, verbose } = parseCheckLinksArgs(args);
+    if (url) {
+        if (!slug) {
+            console.error("Error: --slug required with --url");
+            return 1;
+        }
+        console.log(`Checking remote: ${url}/docs/${slug}/ (basePath: "${basePath || "(none)"}")`);
+        const results = await checkRemote(url, slug, basePath);
+        printResults(results, verbose, json);
+        return results.some((r) => r.mismatch) ? 1 : 0;
+    }
+    if (!localPath) {
+        console.error("Usage:");
+        console.error("  docportal check-links <path> [--base-path <bp>] [--verbose] [--json]");
+        console.error("  docportal check-links --url <url> --slug <slug> [--base-path <bp>]");
+        return 1;
+    }
+    const absPath = path.resolve(localPath);
+    if (!fs.existsSync(absPath)) {
+        console.error(`Path not found: ${absPath}`);
+        return 1;
+    }
+    if (json) {
+        process.stderr.write(`Checking local: ${absPath} (basePath: "${basePath || "(none)"}")\n`);
+    }
+    else {
+        console.log(`Checking local: ${absPath} (basePath: "${basePath || "(none)"}")`);
+    }
+    const results = checkLocal(absPath, basePath);
+    printResults(results, verbose, json);
+    return results.some((r) => r.mismatch) ? 1 : 0;
+}
+//# sourceMappingURL=check-links.js.map

package/dist/commands/check-links.js.map

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

package/dist/lib/check-local.d.ts

@@ -0,0 +1,15 @@
+export interface CheckResult {
+    file: string;
+    line: number;
+    href: string;
+    linkText: string;
+    kind: string;
+    resolved: string;
+    status: "ok" | "broken";
+    reason: string;
+    expect?: "ok" | "broken";
+    expectReason?: string;
+    mismatch?: boolean;
+}
+export declare function checkLocal(docRootDir: string, basePath: string): CheckResult[];
+//# sourceMappingURL=check-local.d.ts.map

package/dist/lib/check-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-local.d.ts","sourceRoot":"","sources":["../../src/lib/check-local.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsHD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAqG9E"}

package/dist/lib/check-local.js

@@ -0,0 +1,215 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { resolveDocLink, resolveImageLink, resolveEmbedLink, resolveSidebarLink } from "./resolve.js";
+import { extractLinks, parseSidebar } from "./parse.js";
+function walkMdFiles(dir) {
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules" && entry.name !== "tools") {
+            results.push(...walkMdFiles(full));
+        }
+        else if (entry.isFile() && entry.name.endsWith(".md")) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+function findSidebars(dir) {
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules" && entry.name !== "tools" && entry.name !== "assets") {
+            results.push(...findSidebars(full));
+        }
+        else if (entry.isFile() && entry.name === "_sidebar.md") {
+            results.push(full);
+        }
+    }
+    return results;
+}
+function fileExists(docRootAbs, relativePath) {
+    const full = path.join(docRootAbs, relativePath);
+    if (fs.existsSync(full))
+        return true;
+    if (!relativePath.endsWith(".md")) {
+        return fs.existsSync(full + ".md");
+    }
+    return false;
+}
+const EXPECT_RE = /<!--\s*EXPECT:(ok|broken)(?::([^\s>]+))?\s*-->/;
+function findSidebarExpect(content, targetLine) {
+    const lines = content.split("\n");
+    const idx = targetLine - 1;
+    if (idx < 0 || idx >= lines.length)
+        return undefined;
+    const match = lines[idx].match(EXPECT_RE);
+    if (match)
+        return { expect: match[1], expectReason: match[2] };
+    return undefined;
+}
+function resolveFilePath(rootAbs, resolved) {
+    const full = path.join(rootAbs, resolved);
+    if (fs.existsSync(full) && fs.statSync(full).isFile())
+        return resolved;
+    if (!resolved.endsWith(".md")) {
+        const withMd = resolved + ".md";
+        if (fs.existsSync(path.join(rootAbs, withMd)))
+            return withMd;
+        const readme = path.join(resolved, "README.md");
+        if (fs.existsSync(path.join(rootAbs, readme)))
+            return readme;
+    }
+    return null;
+}
+function discoverReachablePages(rootAbs) {
+    const reachable = new Set();
+    const queue = [];
+    // Seed from all _sidebar.md files
+    const sidebars = findSidebars(rootAbs);
+    for (const sidebarPath of sidebars) {
+        const content = fs.readFileSync(sidebarPath, "utf-8");
+        for (const link of parseSidebar(content)) {
+            const resolved = resolveSidebarLink(link.href, "");
+            if (resolved.broken || resolved.type !== "sidebar")
+                continue;
+            const filePath = resolveFilePath(rootAbs, resolved.resolved);
+            if (filePath && !reachable.has(filePath)) {
+                reachable.add(filePath);
+                queue.push(filePath);
+            }
+        }
+    }
+    // Add homepage
+    if (!reachable.has("README.md") && fs.existsSync(path.join(rootAbs, "README.md"))) {
+        reachable.add("README.md");
+        queue.push("README.md");
+    }
+    // BFS: follow internal doc links and embeds from reachable pages
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const fullPath = path.join(rootAbs, current);
+        if (!fs.existsSync(fullPath))
+            continue;
+        const content = fs.readFileSync(fullPath, "utf-8");
+        const relDir = path.dirname(current);
+        const links = extractLinks(content, content);
+        for (const link of links) {
+            let targetPath = null;
+            if (link.kind === "doc") {
+                const resolved = resolveDocLink(link.href, "");
+                if (resolved.broken || resolved.type !== "doc")
+                    continue;
+                targetPath = resolveFilePath(rootAbs, resolved.resolved);
+            }
+            else if (link.kind === "embed") {
+                const resolved = resolveEmbedLink(link.href, relDir);
+                if (resolved.broken)
+                    continue;
+                targetPath = resolveFilePath(rootAbs, resolved.resolved);
+            }
+            if (targetPath && !reachable.has(targetPath)) {
+                reachable.add(targetPath);
+                queue.push(targetPath);
+            }
+        }
+    }
+    return reachable;
+}
+export function checkLocal(docRootDir, basePath) {
+    const rootAbs = basePath ? path.join(docRootDir, basePath) : docRootDir;
+    if (!fs.existsSync(rootAbs)) {
+        console.error(`Doc root not found: ${rootAbs}`);
+        return [];
+    }
+    const results = [];
+    // Phase 1: Check sidebar links
+    const sidebars = findSidebars(rootAbs);
+    for (const sidebarPath of sidebars) {
+        const content = fs.readFileSync(sidebarPath, "utf-8");
+        const links = parseSidebar(content);
+        for (const link of links) {
+            const resolved = resolveSidebarLink(link.href, "");
+            const exists = fileExists(rootAbs, resolved.resolved);
+            const broken = resolved.broken || !exists;
+            const expectMatch = findSidebarExpect(content, link.line);
+            results.push({
+                file: path.relative(docRootDir, sidebarPath),
+                line: link.line,
+                href: link.href,
+                linkText: link.text,
+                kind: "sidebar",
+                resolved: resolved.resolved,
+                status: broken ? "broken" : "ok",
+                reason: resolved.reason || (exists ? "" : `file not found: ${resolved.resolved}`),
+                expect: expectMatch?.expect,
+                expectReason: expectMatch?.expectReason,
+                mismatch: expectMatch?.expect ? (broken ? expectMatch.expect === "ok" : expectMatch.expect === "broken") : undefined,
+            });
+        }
+    }
+    // Phase 2: BFS from sidebar to discover reachable pages
+    const reachable = discoverReachablePages(rootAbs);
+    const allMdFiles = walkMdFiles(rootAbs);
+    const skipped = allMdFiles.filter(f => {
+        const rel = path.relative(rootAbs, f);
+        return !reachable.has(rel) && path.basename(f) !== "_sidebar.md";
+    });
+    if (skipped.length > 0) {
+        console.log(`Skipped ${skipped.length} unreachable file(s) (not linked from sidebar or any reachable page)`);
+    }
+    // Phase 3: Check links in reachable pages only
+    for (const relFile of reachable) {
+        const filePath = path.join(rootAbs, relFile);
+        if (!fs.existsSync(filePath))
+            continue;
+        if (path.basename(relFile) === "_sidebar.md")
+            continue;
+        const content = fs.readFileSync(filePath, "utf-8");
+        const relDir = path.dirname(relFile);
+        const links = extractLinks(content, content);
+        for (const link of links) {
+            let resolved;
+            let exists = false;
+            if (link.kind === "doc") {
+                resolved = resolveDocLink(link.href, "");
+                if (resolved.type === "external" || resolved.type === "anchor" || resolved.type === "mailto")
+                    continue;
+                if (resolved.type === "asset")
+                    continue;
+                exists = !resolved.broken && fileExists(rootAbs, resolved.resolved);
+            }
+            else if (link.kind === "image") {
+                resolved = resolveImageLink(link.href, relDir, "");
+                if (resolved.type === "external")
+                    continue;
+                const imgPath = path.join(rootAbs, resolved.resolved);
+                exists = fs.existsSync(imgPath);
+            }
+            else {
+                resolved = resolveEmbedLink(link.href, relDir);
+                if (resolved.type === "external")
+                    continue;
+                const embedPath = path.join(rootAbs, resolved.resolved);
+                exists = !resolved.broken && fs.existsSync(embedPath);
+            }
+            const broken = resolved.broken || !exists;
+            const reason = resolved.reason || (exists ? "" : `file not found: ${resolved.resolved}`);
+            results.push({
+                file: basePath ? path.join(basePath, relFile) : relFile,
+                line: link.line,
+                href: link.href,
+                linkText: link.text,
+                kind: link.kind,
+                resolved: resolved.resolved,
+                status: broken ? "broken" : "ok",
+                reason,
+                expect: link.expect,
+                expectReason: link.expectReason,
+                mismatch: link.expect ? (broken ? link.expect === "ok" : link.expect === "broken") : undefined,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=check-local.js.map

package/dist/lib/check-local.js.map

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

package/dist/lib/check-remote.d.ts

@@ -0,0 +1,3 @@
+import type { CheckResult } from "./check-local.js";
+export declare function checkRemote(baseUrl: string, slug: string, basePath: string): Promise<CheckResult[]>;
+//# sourceMappingURL=check-remote.d.ts.map

package/dist/lib/check-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-remote.d.ts","sourceRoot":"","sources":["../../src/lib/check-remote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA2BpD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAuGxB"}

package/dist/lib/check-remote.js

@@ -0,0 +1,121 @@
+import { resolveDocLink, resolveSidebarLink } from "./resolve.js";
+import { parseSidebar, extractLinks } from "./parse.js";
+async function fetchText(url) {
+    try {
+        const resp = await fetch(url, { redirect: "follow" });
+        if (!resp.ok)
+            return { text: null, status: resp.status };
+        const text = await resp.text();
+        return { text, status: resp.status };
+    }
+    catch {
+        return { text: null, status: 0 };
+    }
+}
+async function headCheck(url) {
+    try {
+        const resp = await fetch(url, { method: "HEAD", redirect: "follow" });
+        return resp.status;
+    }
+    catch {
+        return 0;
+    }
+}
+function isHtml(text) {
+    const s = text.trimStart().slice(0, 10).toLowerCase();
+    return s.startsWith("<!") || s.startsWith("<html");
+}
+export async function checkRemote(baseUrl, slug, basePath) {
+    const contentRoot = basePath
+        ? `${baseUrl}/docs/${slug}/${basePath}`
+        : `${baseUrl}/docs/${slug}`;
+    const sidebarUrl = `${contentRoot}/_sidebar.md`;
+    console.log(`Fetching sidebar: ${sidebarUrl}`);
+    const { text: sidebarContent, status: sidebarStatus } = await fetchText(sidebarUrl);
+    if (!sidebarContent || isHtml(sidebarContent)) {
+        console.error(`Failed to fetch sidebar (status ${sidebarStatus})`);
+        return [];
+    }
+    const sidebarLinks = parseSidebar(sidebarContent);
+    const results = [];
+    for (const link of sidebarLinks) {
+        const resolved = resolveSidebarLink(link.href, "");
+        if (resolved.broken) {
+            results.push({
+                file: "_sidebar.md",
+                line: link.line,
+                href: link.href,
+                linkText: link.text,
+                kind: "sidebar",
+                resolved: resolved.resolved,
+                status: "broken",
+                reason: resolved.reason || "",
+            });
+            continue;
+        }
+        const pageUrl = `${contentRoot}/${resolved.resolved}`;
+        const status = await headCheck(pageUrl);
+        const ok = status >= 200 && status < 400;
+        results.push({
+            file: "_sidebar.md",
+            line: link.line,
+            href: link.href,
+            linkText: link.text,
+            kind: "sidebar",
+            resolved: resolved.resolved,
+            status: ok ? "ok" : "broken",
+            reason: ok ? "" : `HTTP ${status}`,
+        });
+    }
+    const pageUrls = sidebarLinks
+        .map((l) => {
+        const r = resolveSidebarLink(l.href, "");
+        return r.broken ? null : `${contentRoot}/${r.resolved}`;
+    })
+        .filter(Boolean);
+    const homepageUrl = `${contentRoot}/README.md`;
+    if (!pageUrls.includes(homepageUrl))
+        pageUrls.unshift(homepageUrl);
+    for (const pageUrl of pageUrls) {
+        const { text: pageContent } = await fetchText(pageUrl);
+        if (!pageContent || isHtml(pageContent))
+            continue;
+        const relPath = pageUrl.replace(contentRoot + "/", "");
+        const links = extractLinks(pageContent, pageContent);
+        for (const link of links) {
+            if (link.kind !== "doc")
+                continue;
+            const resolved = resolveDocLink(link.href, "");
+            if (resolved.type === "external" || resolved.type === "anchor" || resolved.type === "mailto" || resolved.type === "asset")
+                continue;
+            if (resolved.broken) {
+                results.push({
+                    file: relPath,
+                    line: link.line,
+                    href: link.href,
+                    linkText: link.text,
+                    kind: "doc",
+                    resolved: resolved.resolved,
+                    status: "broken",
+                    reason: resolved.reason || "",
+                });
+                continue;
+            }
+            const targetUrl = `${contentRoot}/${resolved.resolved}`;
+            const status = await headCheck(targetUrl);
+            const ok = status >= 200 && status < 400;
+            results.push({
+                file: relPath,
+                line: link.line,
+                href: link.href,
+                linkText: link.text,
+                kind: "doc",
+                resolved: resolved.resolved,
+                status: ok ? "ok" : "broken",
+                reason: ok ? "" : `HTTP ${status}`,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=check-remote.js.map

package/dist/lib/check-remote.js.map

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

package/dist/lib/parse.d.ts

@@ -0,0 +1,18 @@
+export interface SidebarLink {
+    text: string;
+    href: string;
+    line: number;
+    depth: number;
+    section: string | null;
+}
+export interface PageLink {
+    text: string;
+    href: string;
+    line: number;
+    kind: "doc" | "image" | "embed";
+    expect?: "ok" | "broken";
+    expectReason?: string;
+}
+export declare function parseSidebar(content: string): SidebarLink[];
+export declare function extractLinks(content: string, originalContent: string): PageLink[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/lib/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/lib/parse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwCD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAoB3D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,QAAQ,EAAE,CAgCjF"}

package/dist/lib/parse.js

@@ -0,0 +1,110 @@
+const MD_LINK_RE = /\[([^\]]*)\]\(([^)]+)\)/g;
+const IMG_LINK_RE = /!\[([^\]]*)\]\(([^)]+)\)/g;
+const HTML_COMMENT_RE = /<!--.*?-->/gs;
+const FENCED_CODE_RE = /^```[^\n]*\n.*?^```/gms;
+const INDENTED_CODE_RE = /^(?: {4}|\t)[^\n]*$/gm;
+const INLINE_CODE_RE = /`[^`\n]+`/g;
+const EXPECT_RE = /<!--\s*EXPECT:(ok|broken)(?::([^\s>]+))?\s*-->/;
+function stripCodeBlocks(content) {
+    return content
+        .replace(FENCED_CODE_RE, (m) => "\n".repeat(countNewlines(m)))
+        .replace(INDENTED_CODE_RE, "")
+        .replace(INLINE_CODE_RE, "");
+}
+function stripHtmlComments(content) {
+    return content.replace(HTML_COMMENT_RE, (m) => "\n".repeat(countNewlines(m)));
+}
+function countNewlines(s) {
+    let n = 0;
+    for (const c of s)
+        if (c === "\n")
+            n++;
+    return n;
+}
+function cleanHref(href) {
+    const i = href.indexOf(" ");
+    return i >= 0 ? href.slice(0, i) : href;
+}
+function lineAt(content, offset) {
+    let n = 1;
+    for (let i = 0; i < offset && i < content.length; i++) {
+        if (content[i] === "\n")
+            n++;
+    }
+    return n;
+}
+export function parseSidebar(content) {
+    const cleaned = content.replace(HTML_COMMENT_RE, (m) => "\n".repeat(countNewlines(m)));
+    const links = [];
+    let currentSection = null;
+    for (const [lineno, line] of cleaned.split("\n").entries()) {
+        const bold = line.match(/\*\*(.+?)\*\*/);
+        if (bold)
+            currentSection = bold[1];
+        for (const m of line.matchAll(MD_LINK_RE)) {
+            const href = cleanHref(m[2].trim());
+            if (href.startsWith("#") || href.startsWith("http://") || href.startsWith("https://"))
+                continue;
+            const stripped = href.split("#")[0].split("?")[0];
+            if (!stripped)
+                continue;
+            const depth = Math.floor((line.length - line.trimStart().length) / 2);
+            links.push({ text: m[1], href: stripped, line: lineno + 1, depth, section: currentSection });
+        }
+    }
+    return links;
+}
+export function extractLinks(content, originalContent) {
+    const forParsing = stripHtmlComments(stripCodeBlocks(content));
+    const links = [];
+    for (const m of forParsing.matchAll(IMG_LINK_RE)) {
+        const href = cleanHref(m[2].trim());
+        if (href.startsWith("http://") || href.startsWith("https://"))
+            continue;
+        const line = lineAt(forParsing, m.index);
+        const expect = findExpect(originalContent, line);
+        links.push({ text: m[1], href, line, kind: "image", ...expect });
+    }
+    for (const m of forParsing.matchAll(MD_LINK_RE)) {
+        if (forParsing[m.index - 1] === "!")
+            continue;
+        const fullHref = m[2].trim();
+        const href = cleanHref(fullHref);
+        if (href.startsWith("#") || href.startsWith("http://") || href.startsWith("https://"))
+            continue;
+        if (href.startsWith("mailto:") || href.startsWith("tel:"))
+            continue;
+        if (fullHref.includes(":disabled"))
+            continue;
+        const line = lineAt(forParsing, m.index);
+        const expect = findExpect(originalContent, line);
+        if (fullHref.includes("':include'") || fullHref.includes('":include"') || fullHref.includes(":include")) {
+            const cleanedHref = href.split("#")[0].split("?")[0];
+            links.push({ text: m[1], href: cleanedHref, line, kind: "embed", ...expect });
+        }
+        else {
+            links.push({ text: m[1], href, line, kind: "doc", ...expect });
+        }
+    }
+    return links;
+}
+function findExpect(originalContent, targetLine) {
+    const lines = originalContent.split("\n");
+    const lineIdx = targetLine - 1;
+    if (lineIdx < 0 || lineIdx >= lines.length)
+        return {};
+    const lineText = lines[lineIdx];
+    const match = lineText.match(EXPECT_RE);
+    if (!match) {
+        if (lineIdx + 1 < lines.length) {
+            const nextLine = lines[lineIdx + 1];
+            const nextMatch = nextLine.match(EXPECT_RE);
+            if (nextMatch) {
+                return { expect: nextMatch[1], expectReason: nextMatch[2] };
+            }
+        }
+        return {};
+    }
+    return { expect: match[1], expectReason: match[2] };
+}
+//# sourceMappingURL=parse.js.map

package/dist/lib/parse.js.map

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

package/dist/lib/resolve.d.ts

@@ -0,0 +1,14 @@
+export type LinkType = "doc" | "image" | "embed" | "sidebar" | "external" | "anchor" | "asset" | "mailto";
+export interface ResolvedLink {
+    href: string;
+    resolved: string;
+    type: LinkType;
+    exists?: boolean;
+    broken?: boolean;
+    reason?: string;
+}
+export declare function resolveDocLink(href: string, basePath: string): ResolvedLink;
+export declare function resolveSidebarLink(href: string, basePath: string): ResolvedLink;
+export declare function resolveImageLink(href: string, currentPageDir: string, docRoot: string): ResolvedLink;
+export declare function resolveEmbedLink(href: string, currentFileDir: string): ResolvedLink;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/lib/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/lib/resolve.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1G,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAoC3E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAG/E;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,YAAY,CAgBd;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,YAAY,CAiBd"}

package/dist/lib/resolve.js

@@ -0,0 +1,98 @@
+import * as path from "node:path";
+const ASSET_EXTENSIONS = new Set([
+    ".png", ".jpg", ".jpeg", ".gif", ".svg", ".webp", ".ico", ".bmp",
+    ".pdf", ".zip", ".tar", ".gz",
+    ".css", ".js", ".json", ".xml", ".yaml", ".yml",
+    ".woff", ".woff2", ".ttf", ".eot",
+    ".mp4", ".webm", ".mp3",
+    ".xls", ".xlsx", ".html", ".txt",
+]);
+function extOf(p) {
+    const dot = p.lastIndexOf(".");
+    return dot >= 0 ? p.slice(dot).toLowerCase() : "";
+}
+function isAsset(href) {
+    return ASSET_EXTENSIONS.has(extOf(href));
+}
+function ensureMd(p) {
+    if (!p.endsWith(".md") && !p.endsWith(".txt"))
+        return p + ".md";
+    return p;
+}
+function cleanHref(href) {
+    const spaceIdx = href.indexOf(" ");
+    return spaceIdx >= 0 ? href.slice(0, spaceIdx) : href;
+}
+function stripFragmentAndQuery(href) {
+    return href.split("#")[0].split("?")[0];
+}
+export function resolveDocLink(href, basePath) {
+    const cleaned = stripFragmentAndQuery(cleanHref(href.trim()));
+    if (!cleaned)
+        return { href, resolved: "", type: "anchor", reason: "empty after strip" };
+    if (cleaned.startsWith("http://") || cleaned.startsWith("https://")) {
+        return { href, resolved: cleaned, type: "external" };
+    }
+    if (cleaned.startsWith("#")) {
+        return { href, resolved: cleaned, type: "anchor" };
+    }
+    if (cleaned.startsWith("mailto:") || cleaned.startsWith("tel:")) {
+        return { href, resolved: cleaned, type: "mailto" };
+    }
+    if (isAsset(cleaned)) {
+        return { href, resolved: cleaned, type: "asset" };
+    }
+    if (cleaned.startsWith("../")) {
+        return {
+            href,
+            resolved: cleaned,
+            type: "doc",
+            broken: true,
+            reason: "../ is not supported by the custom renderer for document links",
+        };
+    }
+    const stripped = cleaned.replace(/^\.\//, "").replace(/^\//, "");
+    if (!stripped) {
+        const resolved = basePath ? path.posix.join(basePath, "README.md") : "README.md";
+        return { href, resolved, type: "doc" };
+    }
+    const withMd = ensureMd(stripped);
+    const resolved = basePath ? path.posix.join(basePath, withMd) : withMd;
+    return { href, resolved, type: "doc" };
+}
+export function resolveSidebarLink(href, basePath) {
+    const result = resolveDocLink(href, basePath);
+    return { ...result, type: result.type === "doc" ? "sidebar" : result.type };
+}
+export function resolveImageLink(href, currentPageDir, docRoot) {
+    const cleaned = stripFragmentAndQuery(cleanHref(href.trim()));
+    if (!cleaned)
+        return { href, resolved: "", type: "image" };
+    if (cleaned.startsWith("http://") || cleaned.startsWith("https://")) {
+        return { href, resolved: cleaned, type: "external" };
+    }
+    if (cleaned.startsWith("/")) {
+        const stripped = cleaned.slice(1);
+        const resolved = docRoot ? path.posix.join(docRoot, stripped) : stripped;
+        return { href, resolved, type: "image" };
+    }
+    const resolved = path.posix.normalize(path.posix.join(currentPageDir, cleaned));
+    return { href, resolved, type: "image" };
+}
+export function resolveEmbedLink(href, currentFileDir) {
+    const cleaned = stripFragmentAndQuery(cleanHref(href.trim()));
+    if (!cleaned)
+        return { href, resolved: "", type: "embed" };
+    if (cleaned.startsWith("/")) {
+        return {
+            href,
+            resolved: cleaned,
+            type: "embed",
+            broken: true,
+            reason: "absolute paths are broken for :include embeds",
+        };
+    }
+    const resolved = path.posix.normalize(path.posix.join(currentFileDir, cleaned));
+    return { href, resolved, type: "embed" };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/lib/resolve.js.map

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

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@developerportalsg/docportal-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "CLI tools for Documentation Portal publishers — link checking, validation, and more",
+  "type": "module",
+  "bin": {
+    "docportal": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx --test tests/**/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "documentation-portal",
+    "docsify",
+    "link-checker",
+    "devportal"
+  ],
+  "author": "Developer Portal Team",
+  "license": "MIT",
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}