@warpgogol/forge 0.27.0 → 0.28.0

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":"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"}

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":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAmB1C,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,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAEnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE;gBACJ,OAAO,EAAE,oBAAoB;gBAC7B,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,CAAC;aACT;YACD,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,2DAA2D;SACrE,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,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC;IACvC,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,IAAI,KAA6B,CAAC;YAClC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;YACxB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClD,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;gBAC/D,IAAI,CAAC,UAAU;oBAAE,SAAS;gBAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC3C,IAAI,UAAU,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBACtC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACzC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,YAAY,EAAE,CAAC;gBACf,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,oBAAoB;YAC7B,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;SACtB;QACD,QAAQ,EAAE,CAAC;QACX,OAAO,EACL,OAAO,CAAC,MAAM,GAAG,CAAC;YAChB,CAAC,CAAC,uBAAuB,OAAO,CAAC,MAAM,kBAAkB;YACzD,CAAC,CAAC,oCAAoC;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -124,6 +124,14 @@
     "./os/exploration-module": {
       "types": "./os/exploration/exploration.module.ts",
       "default": "./os/exploration/exploration.module.ts"
+    },
+    "./os/notes": {
+      "types": "./os/notes/index.ts",
+      "default": "./os/notes/index.ts"
+    },
+    "./os/notes-module": {
+      "types": "./os/notes/notes.module.ts",
+      "default": "./os/notes/notes.module.ts"
     }
   },
   "files": [
@@ -268,6 +276,14 @@
       "./os/exploration-module": {
         "types": "./dist/os/exploration/exploration.module.d.ts",
         "default": "./dist/os/exploration/exploration.module.js"
+      },
+      "./os/notes": {
+        "types": "./dist/os/notes/index.d.ts",
+        "default": "./dist/os/notes/index.js"
+      },
+      "./os/notes-module": {
+        "types": "./dist/os/notes/notes.module.d.ts",
+        "default": "./dist/os/notes/notes.module.js"
       }
     }
   },

package/profiles/obsidian-vault.yaml

@@ -0,0 +1,103 @@
+schema: forge/stack-profile@1
+id: obsidian-vault
+displayName: Obsidian Knowledge Base
+detect:
+  anyOf:
+    - .obsidian/app.json
+    - vault/**/*.md
+domain: knowledge-base
+register: creative
+terminology:
+  artifact: note
+  artifactPlural: notes
+  module: folder
+  source: markdown file
+  output: export
+  verify: link-check
+  operator: author
+scriptDir: scripts
+artifacts:
+  - id: note
+    extensions:
+      - .md
+    validate:
+      command: note.link.validate
+  - id: canvas
+    extensions:
+      - .canvas
+  - id: attachment
+    extensions:
+      - .png
+      - .jpg
+      - .jpeg
+      - .webp
+      - .svg
+      - .pdf
+      - .mp4
+      - .webm
+workspaceTypes:
+  - id: vault
+    detect:
+      glob: "**/*.md"
+      contains: "---"
+invariants:
+  - id: NOTE-01
+    rule: All [[wikilinks]] must resolve to an existing note file
+    severity: error
+    check:
+      kind: link-resolution
+      glob: "vault/**/*.md"
+  - id: NOTE-02
+    rule: Every note must have a title in frontmatter (title or first H1)
+    severity: warning
+    check:
+      kind: frontmatter-required
+      glob: "vault/**/*.md"
+      fields: [title]
+  - id: NOTE-03
+    rule: No executable code files in vault/ (scripts go to scripts/ per ADR-0043)
+    severity: error
+    check:
+      kind: path-exclusion
+      glob: "vault/**/*.{ts,mjs,js,py,sh}"
+  - id: NOTE-04
+    rule: Note filenames must use kebab-case (lowercase letters, digits, hyphens)
+    severity: warning
+    check:
+      kind: filename-pattern
+      glob: "vault/**/*.md"
+      pattern: "^[a-z0-9]+(-[a-z0-9]+)*\\.md$"
+workspace:
+  dirs:
+    - vault
+    - scripts
+    - .forge
+  files:
+    - path: .gitignore
+      content: |
+        node_modules
+        .obsidian/workspace
+        .obsidian/workspace.json
+        .cache
+        operator-profile.md
+    - path: forge.yaml
+      content: |
+        schema: forge/config@1
+        project:
+          name: __PROJECT_NAME__
+          stack:
+            - obsidian-vault
+          packageManager: pnpm
+        paths:
+          rfcsDir: docs/rfcs
+          adrsDir: docs/adrs
+    - path: package.json
+      content: |
+        {
+          "name": "__PROJECT_NAME__",
+          "version": "0.1.0",
+          "private": true,
+          "type": "module"
+        }
+install:
+  - pnpm add -D @warpgogol/forge