@warpgogol/forge 2.1.0 → 2.2.0

package/dist/src/utils/generated-marker.js.map

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

package/dist/src/utils/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function byteHash(bytes: Uint8Array | string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/src/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAeA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAG3D"}

package/dist/src/utils/hash.js

@@ -0,0 +1,18 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Trivial hash utility — inlined from @warpgogol/fingerprint to avoid dependency.</purpose>
+<non-goals>
+  <item>Do not add non-hash utilities here — use dedicated utility modules.</item>
+  <item>Do not introduce @warpgogol/* imports — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial inline of byteHash from @warpgogol/fingerprint/primitives.</item>
+</CHANGE_SUMMARY>
+*/
+import { createHash } from "node:crypto";
+export function byteHash(bytes) {
+    const input = typeof bytes === "string" ? Buffer.from(bytes, "utf8") : bytes;
+    return `sha256:${createHash("sha256").update(input).digest("hex")}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/src/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,KAA0B;IACjD,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7E,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { writeFileAtomic, type WriteFileAtomicOptions } from "./fs-atomic.ts";
+export { writeFileIfChanged } from "./fs-idempotent.ts";
+export { GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, type GeneratedHeaderInput, type StripGeneratedMarkerResult, } from "./generated-marker.ts";
+export { toKebabCase } from "./string-utils.ts";
+export { collectFiles, fileExists, type CollectFilesOptions } from "./fs.ts";
+export { byteHash } from "./hash.ts";
+export { trashPath } from "./fs-trash.ts";
+export { trashSync } from "./fs-trash-sync.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,21 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for forge utilities — canonical, autonomous, no @warpgogol/* dependencies.</purpose>
+<non-goals>
+  <item>Do not add non-utility exports here — use the appropriate forge module.</item>
+  <item>Do not re-export from @warpgogol/* packages — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial utility barrel: fs-atomic, generated-marker, string-utils, fs, hash.</item>
+</CHANGE_SUMMARY>
+*/
+export { writeFileAtomic } from "./fs-atomic.js";
+export { writeFileIfChanged } from "./fs-idempotent.js";
+export { GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, } from "./generated-marker.js";
+export { toKebabCase } from "./string-utils.js";
+export { collectFiles, fileExists } from "./fs.js";
+export { byteHash } from "./hash.js";
+export { trashPath } from "./fs-trash.js";
+export { trashSync } from "./fs-trash-sync.js";
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/utils/string-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function toKebabCase(value: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/src/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/string-utils.ts"],"names":[],"mappings":"AAaA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/src/utils/string-utils.js

@@ -0,0 +1,19 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Trivial string utilities — inlined from @warpgogol/share to avoid dependency.</purpose>
+<non-goals>
+  <item>Do not add non-string utilities here — use dedicated utility modules.</item>
+  <item>Do not introduce @warpgogol/* imports — this package must remain dependency-free.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Initial inline of toKebabCase from @warpgogol/werkstatt-shared/share/string-utils.</item>
+</CHANGE_SUMMARY>
+*/
+export function toKebabCase(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/src/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/src/validators/note-frontmatter-validate.d.ts

@@ -0,0 +1,20 @@
+import type { ForgeCommandResult } from "../types.ts";
+interface NoteFrontmatterValidateInput {
+    flags: Record<string, unknown>;
+}
+export interface FrontmatterViolation {
+    file: string;
+    field: string;
+    rule: "NOTE-02";
+    message: string;
+}
+export interface NoteFrontmatterValidateResult {
+    command: "note.frontmatter.validate";
+    violations: FrontmatterViolation[];
+    count: number;
+}
+export declare function runNoteFrontmatterValidate(input: NoteFrontmatterValidateInput, context: {
+    workspaceRoot?: string;
+}): ForgeCommandResult<NoteFrontmatterValidateResult>;
+export {};
+//# sourceMappingURL=note-frontmatter-validate.d.ts.map

package/dist/src/validators/note-frontmatter-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-frontmatter-validate.d.ts","sourceRoot":"","sources":["../../../src/validators/note-frontmatter-validate.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,4BAA4B;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,2BAA2B,CAAC;IACrC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,kBAAkB,CAAC,6BAA6B,CAAC,CAwFnD"}

package/dist/src/validators/note-frontmatter-validate.js

@@ -0,0 +1,117 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Validate frontmatter consistency across an Obsidian vault — checks for required fields in YAML frontmatter.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not implement domain-specific logic beyond frontmatter validation.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0808: initial note.frontmatter.validate command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+function collectMarkdownFiles(dir, baseDir, results) {
+    const SKIP_DIRS = new Set(["node_modules", ".git", ".turbo", "dist", ".cache", ".obsidian"]);
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && SKIP_DIRS.has(entry.name))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, "/");
+        if (entry.isDirectory()) {
+            collectMarkdownFiles(fullPath, baseDir, results);
+        }
+        else if (entry.name.endsWith(".md")) {
+            results.push(relPath);
+        }
+    }
+}
+export function runNoteFrontmatterValidate(input, context) {
+    const workspaceRoot = context.workspaceRoot ?? process.cwd();
+    const vaultDir = input.flags["vault-dir"] ?? "vault";
+    const requiredFields = (input.flags["fields"] ?? "title")
+        .split(",")
+        .map((f) => f.trim())
+        .filter(Boolean);
+    const scanDir = path.join(workspaceRoot, vaultDir);
+    if (!fs.existsSync(scanDir)) {
+        return {
+            data: {
+                command: "note.frontmatter.validate",
+                violations: [],
+                count: 0,
+            },
+            exitCode: 0,
+            summary: "note.frontmatter.validate: vault directory not found — 0 violations",
+        };
+    }
+    const allMdFiles = [];
+    collectMarkdownFiles(scanDir, workspaceRoot, allMdFiles);
+    const violations = [];
+    for (const file of allMdFiles) {
+        const fullPath = path.join(workspaceRoot, file);
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (!fmMatch) {
+                for (const field of requiredFields) {
+                    violations.push({
+                        file,
+                        field,
+                        rule: "NOTE-02",
+                        message: `File '${file}' has no frontmatter — missing field '${field}'`,
+                    });
+                }
+                continue;
+            }
+            let fm = {};
+            try {
+                fm = parseYaml(fmMatch[1]);
+            }
+            catch {
+                for (const field of requiredFields) {
+                    violations.push({
+                        file,
+                        field,
+                        rule: "NOTE-02",
+                        message: `File '${file}' has malformed frontmatter — missing field '${field}'`,
+                    });
+                }
+                continue;
+            }
+            for (const field of requiredFields) {
+                if (!(field in fm) || fm[field] == null || fm[field] === "") {
+                    if (field === "title") {
+                        const hasH1 = /^\s*#\s+\S/.test(content.slice(fmMatch[0].length));
+                        if (hasH1)
+                            continue;
+                    }
+                    violations.push({
+                        file,
+                        field,
+                        rule: "NOTE-02",
+                        message: `File '${file}' missing required field '${field}'`,
+                    });
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return {
+        data: {
+            command: "note.frontmatter.validate",
+            violations,
+            count: violations.length,
+        },
+        exitCode: violations.length > 0 ? 1 : 0,
+        summary: violations.length > 0
+            ? `note.frontmatter.validate: ${violations.length} violation(s) found`
+            : "note.frontmatter.validate: OK — 0 violations",
+    };
+}
+//# sourceMappingURL=note-frontmatter-validate.js.map

package/dist/src/validators/note-frontmatter-validate.js.map

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

package/dist/src/validators/note-link-validate.d.ts

@@ -0,0 +1,21 @@
+import type { ForgeCommandResult } from "../types.ts";
+interface NoteLinkValidateInput {
+    flags: Record<string, unknown>;
+}
+export interface NoteLinkViolation {
+    file: string;
+    line: number;
+    link: string;
+    rule: "NOTE-01";
+    message: string;
+}
+export interface NoteLinkValidateResult {
+    command: "note.link.validate";
+    violations: NoteLinkViolation[];
+    count: number;
+}
+export declare function runNoteLinkValidate(input: NoteLinkValidateInput, context: {
+    workspaceRoot?: string;
+}): ForgeCommandResult<NoteLinkValidateResult>;
+export {};
+//# sourceMappingURL=note-link-validate.d.ts.map

package/dist/src/validators/note-link-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-link-validate.d.ts","sourceRoot":"","sources":["../../../src/validators/note-link-validate.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,qBAAqB;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,kBAAkB,CAAC,sBAAsB,CAAC,CA0F5C"}

package/dist/src/validators/note-link-validate.js

@@ -0,0 +1,121 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Validate wikilink integrity across an Obsidian vault — scans [[wikilinks]] and resolves each against the note graph.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not implement domain-specific logic beyond wikilink resolution.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0808: initial note.link.validate command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+function collectMarkdownFiles(dir, baseDir, results) {
+    const SKIP_DIRS = new Set(["node_modules", ".git", ".turbo", "dist", ".cache", ".obsidian"]);
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && SKIP_DIRS.has(entry.name))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, "/");
+        if (entry.isDirectory()) {
+            collectMarkdownFiles(fullPath, baseDir, results);
+        }
+        else if (entry.name.endsWith(".md")) {
+            results.push(relPath);
+        }
+    }
+}
+export function runNoteLinkValidate(input, context) {
+    const workspaceRoot = context.workspaceRoot ?? process.cwd();
+    const vaultDir = input.flags["vault-dir"] ?? "vault";
+    const pathFilter = input.flags["path"];
+    const scanDir = pathFilter
+        ? path.join(workspaceRoot, vaultDir, pathFilter)
+        : path.join(workspaceRoot, vaultDir);
+    if (!fs.existsSync(scanDir)) {
+        return {
+            data: {
+                command: "note.link.validate",
+                violations: [],
+                count: 0,
+            },
+            exitCode: 0,
+            summary: "note.link.validate: vault directory not found — 0 violations",
+        };
+    }
+    const allMdFiles = [];
+    collectMarkdownFiles(scanDir, workspaceRoot, allMdFiles);
+    const noteMap = new Map();
+    for (const mdFile of allMdFiles) {
+        const basename = path.basename(mdFile, ".md");
+        noteMap.set(basename, mdFile);
+        const fullPath = path.join(workspaceRoot, mdFile);
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (fmMatch) {
+                try {
+                    const fm = parseYaml(fmMatch[1]);
+                    if (fm.aliases && Array.isArray(fm.aliases)) {
+                        for (const alias of fm.aliases) {
+                            if (typeof alias === "string")
+                                noteMap.set(alias, mdFile);
+                        }
+                    }
+                }
+                catch {
+                    // skip malformed frontmatter
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    const linkRegex = /\[\[([^\]]+?)\]\]/g;
+    const violations = [];
+    for (const file of allMdFiles) {
+        const fullPath = path.join(workspaceRoot, file);
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            const lines = content.split(/\r?\n/);
+            for (let i = 0; i < lines.length; i++) {
+                let match;
+                linkRegex.lastIndex = 0;
+                while ((match = linkRegex.exec(lines[i])) !== null) {
+                    const linkTarget = match[1].split("|")[0].split("#")[0].trim();
+                    if (!linkTarget)
+                        continue;
+                    if (!noteMap.has(linkTarget)) {
+                        violations.push({
+                            file,
+                            line: i + 1,
+                            link: match[0],
+                            rule: "NOTE-01",
+                            message: `Wikilink target '${linkTarget}' not found in vault`,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return {
+        data: {
+            command: "note.link.validate",
+            violations,
+            count: violations.length,
+        },
+        exitCode: violations.length > 0 ? 1 : 0,
+        summary: violations.length > 0
+            ? `note.link.validate: ${violations.length} violation(s) found`
+            : "note.link.validate: OK — 0 violations",
+    };
+}
+//# sourceMappingURL=note-link-validate.js.map

package/dist/src/validators/note-link-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-link-validate.js","sourceRoot":"","sources":["../../../src/validators/note-link-validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAqB1C,SAAS,oBAAoB,CAAC,GAAW,EAAE,OAAe,EAAE,OAAiB;IAC3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAA4B,EAC5B,OAAmC;IAEnC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAY,IAAI,OAAO,CAAC;IACjE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAuB,CAAC;IAC7D,MAAM,OAAO,GAAG,UAAU;QACxB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAEvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,oBAAoB;gBAC7B,UAAU,EAAE,EAAE;gBACd,KAAK,EAAE,CAAC;aACT;YACD,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,8DAA8D;SACxE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAA4B,CAAC;oBAC5D,IAAI,EAAE,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC5C,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;4BAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;gCAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;wBAC5D,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,6BAA6B;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC;IACvC,MAAM,UAAU,GAAwB,EAAE,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,KAA6B,CAAC;gBAClC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;gBACxB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBACnD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC/D,IAAI,CAAC,UAAU;wBAAE,SAAS;oBAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC7B,UAAU,CAAC,IAAI,CAAC;4BACd,IAAI;4BACJ,IAAI,EAAE,CAAC,GAAG,CAAC;4BACX,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;4BACd,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,oBAAoB,UAAU,sBAAsB;yBAC9D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,oBAAoB;YAC7B,UAAU;YACV,KAAK,EAAE,UAAU,CAAC,MAAM;SACzB;QACD,QAAQ,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,EACL,UAAU,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,uBAAuB,UAAU,CAAC,MAAM,qBAAqB;YAC/D,CAAC,CAAC,uCAAuC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/src/validators/note-orphan-detect.d.ts

@@ -0,0 +1,19 @@
+import type { ForgeCommandResult } from "../types.ts";
+interface NoteOrphanDetectInput {
+    flags: Record<string, unknown>;
+}
+export interface OrphanReport {
+    file: string;
+    inboundLinks: 0;
+    severity: "warning";
+}
+export interface NoteOrphanDetectResult {
+    command: "note.orphan.detect";
+    orphans: OrphanReport[];
+    count: number;
+}
+export declare function runNoteOrphanDetect(input: NoteOrphanDetectInput, context: {
+    workspaceRoot?: string;
+}): ForgeCommandResult<NoteOrphanDetectResult>;
+export {};
+//# sourceMappingURL=note-orphan-detect.d.ts.map

package/dist/src/validators/note-orphan-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-orphan-detect.d.ts","sourceRoot":"","sources":["../../../src/validators/note-orphan-detect.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,qBAAqB;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,kBAAkB,CAAC,sBAAsB,CAAC,CA6F5C"}

package/dist/src/validators/note-orphan-detect.js

@@ -0,0 +1,123 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Detect orphan notes in an Obsidian vault — notes with zero inbound wikilinks.</purpose>
+<non-goals>
+  <item>Do not import from @warpgogol/* — this module is portable.</item>
+  <item>Do not implement domain-specific logic beyond orphan detection.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0808: initial note.orphan.detect command handler.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+function collectMarkdownFiles(dir, baseDir, results) {
+    const SKIP_DIRS = new Set(["node_modules", ".git", ".turbo", "dist", ".cache", ".obsidian"]);
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && SKIP_DIRS.has(entry.name))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        const relPath = path.relative(baseDir, fullPath).replace(/\\/g, "/");
+        if (entry.isDirectory()) {
+            collectMarkdownFiles(fullPath, baseDir, results);
+        }
+        else if (entry.name.endsWith(".md")) {
+            results.push(relPath);
+        }
+    }
+}
+export function runNoteOrphanDetect(input, context) {
+    const workspaceRoot = context.workspaceRoot ?? process.cwd();
+    const vaultDir = input.flags["vault-dir"] ?? "vault";
+    const scanDir = path.join(workspaceRoot, vaultDir);
+    if (!fs.existsSync(scanDir)) {
+        return {
+            data: {
+                command: "note.orphan.detect",
+                orphans: [],
+                count: 0,
+            },
+            exitCode: 0,
+            summary: "note.orphan.detect: vault directory not found — 0 orphans",
+        };
+    }
+    const allMdFiles = [];
+    collectMarkdownFiles(scanDir, workspaceRoot, allMdFiles);
+    const noteMap = new Map();
+    for (const mdFile of allMdFiles) {
+        const basename = path.basename(mdFile, ".md");
+        noteMap.set(basename, mdFile);
+        const fullPath = path.join(workspaceRoot, mdFile);
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+            if (fmMatch) {
+                try {
+                    const fm = parseYaml(fmMatch[1]);
+                    if (fm.aliases && Array.isArray(fm.aliases)) {
+                        for (const alias of fm.aliases) {
+                            if (typeof alias === "string")
+                                noteMap.set(alias, mdFile);
+                        }
+                    }
+                }
+                catch {
+                    // skip malformed frontmatter
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    const inboundLinks = new Map();
+    for (const mdFile of allMdFiles) {
+        inboundLinks.set(mdFile, 0);
+    }
+    const linkRegex = /\[\[([^\]]+?)\]\]/g;
+    for (const file of allMdFiles) {
+        const fullPath = path.join(workspaceRoot, file);
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            let match;
+            linkRegex.lastIndex = 0;
+            while ((match = linkRegex.exec(content)) !== null) {
+                const linkTarget = match[1].split("|")[0].split("#")[0].trim();
+                if (!linkTarget)
+                    continue;
+                const targetFile = noteMap.get(linkTarget);
+                if (targetFile && targetFile !== file) {
+                    inboundLinks.set(targetFile, (inboundLinks.get(targetFile) ?? 0) + 1);
+                }
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    const orphans = [];
+    for (const [file, count] of inboundLinks) {
+        if (count === 0) {
+            orphans.push({
+                file,
+                inboundLinks: 0,
+                severity: "warning",
+            });
+        }
+    }
+    return {
+        data: {
+            command: "note.orphan.detect",
+            orphans,
+            count: orphans.length,
+        },
+        exitCode: 0,
+        summary: orphans.length > 0
+            ? `note.orphan.detect: ${orphans.length} orphan(s) found`
+            : "note.orphan.detect: OK — 0 orphans",
+    };
+}
+//# sourceMappingURL=note-orphan-detect.js.map

package/dist/src/validators/note-orphan-detect.js.map

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

package/dist/src/validators/port-validate.d.ts

@@ -0,0 +1,12 @@
+interface PortValidateResult {
+    command: string;
+    status: "pass" | "fail";
+    violations: string[];
+}
+export declare function runPortValidate(input: {
+    flags: {
+        name?: string;
+    };
+}, context: unknown): PortValidateResult;
+export {};
+//# sourceMappingURL=port-validate.d.ts.map

package/dist/src/validators/port-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-validate.d.ts","sourceRoot":"","sources":["../../../src/validators/port-validate.ts"],"names":[],"mappings":"AAgBA,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAYD,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACnC,OAAO,EAAE,OAAO,GACf,kBAAkB,CA0CpB"}