[Eng-928] Shift + Click to open discourse node

.github/workflows/ci.yaml

@@ -12,18 +12,24 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v4
 
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        with:
+          version: 10.15.1
+          run_install: false
+
       - name: Setup Node.js environment
         uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install Dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Check TypeScript Types
         run: npx turbo check-types
 
         # TODO: Add future linting, testing, style checks, etc.
         # name: Lint
-        # run: npm run lint
+        # run: pnpm run lint

.github/workflows/database-deploy.yaml

@@ -12,12 +12,25 @@ jobs:
       SUPABASE_PROJECT_ID: ${{ secrets.SUPABASE_PROJECT_ID_PROD }}
       SUPABASE_DB_PASSWORD: ${{ secrets.SUPABASE_DB_PASSWORD_PROD }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v3
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.15.1
+          run_install: false
+
+      - uses: actions/setup-node@v4
         with:
           node-version: "20"
-      - run: npm ci
+          cache: "pnpm"
+
+      - name: Install Dependencies
+        run: pnpm install --frozen-lockfile
+
       - uses: supabase/setup-cli@v1
         with:
           version: latest
+
       - run: npx turbo deploy -F @repo/database

.github/workflows/roam-main.yaml

@@ -2,14 +2,19 @@ name: Main - Roam To Blob Storage
 on:
   workflow_dispatch:
   push:
-    branches: main
+    branches:
+      - main
     paths:
       - "apps/roam/**"
       - "packages/tailwind-config/**"
+      - "packages/utils/**"
+      - "packages/database/**"
       - "packages/ui/**"
 
 env:
   BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
+  SUPABASE_ANON_KEY: ${{ secrets.SUPABASE_ANON_KEY }}
+  SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
 
 jobs:
   deploy:
@@ -18,14 +23,20 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.15.1
+          run_install: false
+
       - name: Setup Node.js environment
         uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install Dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Deploy
         run: npx turbo run deploy --filter=roam

.github/workflows/roam-pr.yaml

@@ -7,6 +7,8 @@ on:
     paths:
       - "apps/roam/**"
       - "packages/tailwind-config/**"
+      - "packages/utils/**"
+      - "packages/database/**"
       - "packages/ui/**"
 env:
   BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
@@ -22,14 +24,20 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.15.1
+          run_install: false
+
       - name: Setup Node.js environment
         uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install Dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Deploy
         run: npx turbo run deploy --filter=roam

.github/workflows/roam-release.yaml

@@ -17,14 +17,20 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.15.1
+          run_install: false
+
       - name: Setup Node.js environment
         uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install Dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Update Roam Depot Extension
         run: npx turbo run publish --filter=roam

.zed/settings.json

@@ -0,0 +1,11 @@
+{
+  "lsp": {
+    "eslint": {
+      "settings": {
+        "experimental": {
+          "useFlatConfig": true
+        }
+      }
+    }
+  }
+}

CONTRIBUTING.md

@@ -21,3 +21,62 @@ Here’s how to contribute:
 4. Write tests that validate your change and/or fix.
 <!-- 5. Run `turbo build` followed by `turbo test` to confirm everything works. -->
 5. Push your branch and open a pull request. 🚀
+
+## Adding Documentation to the Website
+
+The Discourse Graphs website hosts documentation for plugins and general information. Here's how to add or edit documentation:
+
+### Blog Posts
+
+Blog posts are located in `/apps/website/app/(home)/blog/posts/`
+
+1. **Create your post file**: Copy `EXAMPLE.md` as a starting template and rename it to your desired URL slug (e.g., `my-new-post.md`)
+
+2. **Required metadata**: Every blog post must start with YAML frontmatter (reference `EXAMPLE.md` for the exact format):
+
+   ```yaml
+   ---
+   title: "Your Post Title"
+   date: "YYYY-MM-DD"
+   author: "Author's name"
+   published: true # Set to true to make the post visible
+   ---
+   ```
+
+3. **Content**: Write your content below the frontmatter using standard Markdown
+
+### Plugin Documentation
+
+Plugin documentation is organized in `/apps/website/app/(docs)/docs/` with separate folders:
+
+- `/obsidian/pages/` - Obsidian plugin documentation
+- `/roam/pages/` - Roam Research extension documentation
+- `/sharedPages/` - Documentation shared between platforms
+
+1. **Create your documentation file**: Add a new `.md` file in the appropriate platform's `pages/` folder
+2. **Use standard Markdown**: No special frontmatter is required for documentation files
+3. **Update navigation**: You may need to update the corresponding `navigation.ts` file to include your new page in the sidebar
+
+### Documentation Images
+
+All documentation images should be placed in `/apps/website/public/docs/[platform]/` following this structure:
+
+- **Platform-specific images**: `/public/docs/[platform]/` (e.g., `/public/docs/roam/`, `/public/docs/obsidian/`)
+- **General documentation images**: `/public/docs/`
+
+When referencing images in your documentation, use relative paths from the public folder:
+
+```markdown
+![Alt text](/docs/roam/my-image.png)
+```
+
+### Running the Website Locally
+
+To preview your changes locally:
+
+1. **Environment setup**: Copy `/apps/website/.env.example` to `/apps/website/.env` and configure any necessary environment variables
+2. **Install dependencies**: Run `npm install` from the project root
+3. **Start development server**: Run `npm run dev` or `npx turbo dev` to start the website locally
+4. **View your changes**: Navigate to `http://localhost:3000` to see your documentation
+
+The website uses Next.js with the App Router, so changes to Markdown files should be reflected automatically during development.

README.md

@@ -50,7 +50,8 @@ git clone https://github.com/DiscourseGraphs/discourse-graph.git
 
 ```bash
 cd discourse-graph
-npm install
+npm install -g pnpm@10
+pnpm install
 ```
 
 3. Run all applications in development mode:

apps/obsidian/package.json

@@ -9,29 +9,40 @@
     "build": "tsx scripts/build.ts",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "publish": "tsx scripts/publish-obsidian.ts",
+    "publish": "tsx scripts/publish.ts --version 0.1.0",
     "check-types": "tsc --noEmit --skipLibCheck"
   },
   "keywords": [],
   "author": "",
   "license": "Apache-2.0",
   "devDependencies": {
     "@octokit/core": "^6.1.2",
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
     "@types/node": "^20",
+    "@types/react": "catalog:obsidian",
+    "@types/react-dom": "catalog:obsidian",
     "autoprefixer": "^10.4.21",
     "builtin-modules": "3.3.0",
     "dotenv": "^16.4.5",
     "esbuild": "0.17.3",
+    "eslint": "catalog:",
     "obsidian": "^1.7.2",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
     "tslib": "2.5.1",
     "tsx": "^4.19.2",
-    "typescript": "5.5.4"
+    "typescript": "5.5.4",
+    "zod": "^3.24.1"
   },
   "dependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwindcss-animate": "^1.0.7"
+    "date-fns": "^4.1.0",
+    "tldraw": "^3.14.2",
+    "nanoid": "^4.0.2",
+    "react": "catalog:obsidian",
+    "react-dom": "catalog:obsidian",
+    "date-fns": "^4.1.0",
+    "tailwindcss-animate": "^1.0.7",
+    "tldraw": "3.14.2"
   }
 }

apps/obsidian/scripts/README.md

@@ -9,7 +9,7 @@ This directory contains a script for publishing the Discourse Graph Obsidian plu
 
 ## Prerequisites
 
-1. **Node.js and npm** - Ensure you have Node.js 18+ installed
+1. **Node.js and pnpm** - Ensure you have Node.js 20+ installed, with pnpm@10 installed globally (`npm install -g pnpm`)
 2. **Git** - For repository operations
 3. **GitHub Token** - For authentication (see Authentication section)
 
@@ -42,7 +42,7 @@ The script automatically determines release type based on version format and alw
 ### BRAT Version Priority
 
 BRAT uses alphabetical ordering for pre-release identifiers. This is why we enforce:
-- **Internal**: `alpha-*` (comes first alphabetically) 
+- **Internal**: `alpha-*` (comes first alphabetically)
 - **External**: `beta-*` (comes after alpha, gets higher priority)
 
 This ensures that external beta releases always take precedence over internal alpha releases for BRAT auto-updates.
@@ -53,7 +53,7 @@ The script automatically determines the release type based on version format:
 
 **🧪 Pre-release** (automatic detection)
 - **Triggers**: Any version with `alpha` or `beta` suffixes
-- **GitHub**: Marked as "Pre-release" 
+- **GitHub**: Marked as "Pre-release"
 - **Main Branch**: Not updated (keeps stable code in main)
 - **Use Case**: Testing, beta versions, internal releases
 
@@ -122,7 +122,7 @@ tsx scripts/publish.ts --version 0.1.0-alpha-canvas-feature --release-name "Canv
 tsx scripts/publish.ts --version 0.1.0-canvas-feature
 ```
 
-### Beta Release for Public Testing  
+### Beta Release for Public Testing
 ```bash
 # ✅ Correct format with beta prefix - creates pre-release automatically
 tsx scripts/publish.ts --version 1.0.0-beta.1 --release-name "Beta: New Graph View"
@@ -137,18 +137,18 @@ tsx scripts/publish.ts --version 1.0.0-test.1
 tsx scripts/publish.ts --version 1.0.0
 ```
 
-### Using npm script from obsidian directory
+### Using pnpm script from obsidian directory
 ```bash
 cd apps/obsidian
-npm run publish -- --version 1.0.0-beta.1
+pnpm run publish -- --version 1.0.0-beta.1
 ```
 
 ## What the Script Does
 
 ### For All Releases:
 1. **Validates input** - Checks version format and arguments
 2. **Detects release type** - Internal vs External based on version format
-3. **Builds the plugin** - Runs `npm run build` to create distribution files
+3. **Builds the plugin** - Runs `pnpm run build` to create distribution files
 4. **Copies source files** - Copies plugin source (excluding build artifacts)
 5. **Creates GitHub release** - Always creates a release with:
    - Custom or default release name
@@ -184,7 +184,7 @@ Publishes to: `DiscourseGraphs/discourse-graph-obsidian`
 ### Repository State by Release Type:
 
 **Internal Release**: Repository unchanged, GitHub pre-release created
-**External Pre-release**: Repository unchanged, GitHub pre-release created  
+**External Pre-release**: Repository unchanged, GitHub pre-release created
 **External Stable**: Repository main branch updated + GitHub stable release created
 
 ## Troubleshooting
@@ -195,16 +195,16 @@ Publishes to: `DiscourseGraphs/discourse-graph-obsidian`
    ```bash
    # ❌ Wrong
    tsx scripts/publish.ts
-   
-   # ✅ Correct  
+
+   # ✅ Correct
    tsx scripts/publish.ts --version 1.0.0
    ```
 
 2. **"Invalid version format"**
    ```bash
    # ❌ Wrong
    tsx scripts/publish.ts --version "beta-1"
-   
+
    # ✅ Correct
    tsx scripts/publish.ts --version 1.0.0-beta.1
    ```
@@ -219,7 +219,7 @@ Publishes to: `DiscourseGraphs/discourse-graph-obsidian`
    - Verify repository exists and is accessible
 
 5. **"Required build files missing"**
-   - Run `npm run build` manually to check for build errors
+   - Run `pnpm run build` manually to check for build errors
    - Ensure TypeScript compiles without errors
 
 6. **BRAT picking wrong version**
@@ -247,10 +247,10 @@ This is why the naming convention is critical for ensuring the right version get
 
 ### Key Functions:
 - `isExternalRelease()` - Determines if version is external (stable/beta) or internal (alpha)
-- `updateMainBranch()` - Uses GitHub API to create proper commits  
+- `updateMainBranch()` - Uses GitHub API to create proper commits
 - `createGithubRelease()` - Creates releases with assets and automatic pre-release detection
 - `updateManifest()` - Updates version in manifest.json
 
 ### Security:
 - Uses GitHub API instead of git commands for better security
-- Never commits tokens to repository
+- Never commits tokens to repository