spike: Experiment with chaining links together

jest.config.js

@@ -16,6 +16,9 @@ module.exports = {
 
     // A list of paths to modules that run some code to configure or
     // set up the testing framework before each test.
-    setupFilesAfterEnv: ['<rootDir>/tests/CustomMatchers/jest.custom_matchers.setup.ts'],
-    globalSetup: "./tests/global-setup.js"
+    setupFilesAfterEnv: [
+        '<rootDir>/tests/CustomMatchers/jest.custom_matchers.setup.ts',
+        '<rootDir>/tests/Task/LinkResolver.setup.ts',
+    ],
+    globalSetup: './tests/global-setup.js',
 };

resources/sample_vaults/Tasks-Demo/Test Data/chain_link1.md

@@ -0,0 +1,7 @@
+---
+link_to_file: "[[chain_link2]]"
+---
+
+# chain_link1
+
+- [ ] #task Task in 'chain_link1'

resources/sample_vaults/Tasks-Demo/Test Data/chain_link2.md

@@ -0,0 +1,7 @@
+---
+link_to_file: "[[chain_link3]]"
+---
+
+# chain_link2
+
+- [ ] #task Task in 'chain_link2'

resources/sample_vaults/Tasks-Demo/Test Data/chain_link3.md

@@ -0,0 +1,7 @@
+---
+link_to_file: "[[chain_link4]]"
+---
+
+# chain_link3
+
+- [ ] #task Task in 'chain_link3'

resources/sample_vaults/Tasks-Demo/Test Data/chain_link4.md

@@ -0,0 +1,7 @@
+---
+link_to_file: "[[chain_link1]]"
+---
+
+# chain_link4
+
+- [ ] #task Task in 'chain_link4'

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Active Project note.md

@@ -0,0 +1,13 @@
+---
+created: 2025-09-22
+project: "[[Active Project]]"
+themes:
+---
+
+# note
+
+# Active Project note
+
+---
+
+- [ ] #task Active task

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Active Project.md

@@ -0,0 +1,17 @@
+---
+created: 2025-09-22
+project: "[[Active Project]]"
+themes:
+status: active
+priority: 5 medium
+due:
+dependencies:
+---
+
+# project #note
+
+# Active Project
+
+---
+
+- [[Active Project note]]

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Chaining links together.md

@@ -0,0 +1,32 @@
+# Chaining links together
+
+## Chaining links together in 'group by' instructions
+
+```tasks
+filename includes chain_link
+
+# TODO Make 'group by' detect if the object is a link, and group by its markdown
+
+group by function 'Level 1 link: ' + \
+    task.file.\
+        propertyAsLink('link_to_file').markdown
+
+group by function 'Level 2 link: ' + \
+    task.file.\
+        propertyAsLink('link_to_file').asFile().\
+        propertyAsLink('link_to_file').markdown
+
+group by function 'Level 3 link: ' + \
+    task.file.\
+        propertyAsLink('link_to_file').asFile().\
+        propertyAsLink('link_to_file').asFile().\
+        propertyAsLink('link_to_file').markdown
+
+group by function 'Level 4 link: ' + \
+    task.file.\
+        propertyAsLink('link_to_file').asFile().\
+        propertyAsLink('link_to_file').asFile().\
+        propertyAsLink('link_to_file').asFile().\
+        propertyAsLink('link_to_file').markdown
+
+```

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Homepage - Bases.md

@@ -0,0 +1,46 @@
+# Homepage - Bases
+
+With Obsidian 1.10.0.
+
+```base
+filters:
+  and:
+    - file.folder == this.file.folder
+formulas:
+  project status: project.asFile().properties.status
+views:
+  - type: table
+    name: All Notes
+    groupBy:
+      property: formula.project status
+      direction: ASC
+    order:
+      - file.name
+      - project
+      - formula.project status
+  - type: table
+    name: Active Project Notes
+    filters:
+      and:
+        - formula["project status"] == "active"
+    groupBy:
+      property: formula.project status
+      direction: ASC
+    order:
+      - file.name
+      - project
+      - formula.project status
+  - type: table
+    name: Ideas
+    filters:
+      and:
+        - formula["project status"] == "idea"
+    groupBy:
+      property: formula.project status
+      direction: ASC
+    order:
+      - file.name
+      - project
+      - formula.project status
+
+```

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Homepage - Dataview.md

@@ -0,0 +1,37 @@
+# Homepage - Dataview
+
+## Dataview - group by project
+
+If **either** note could have inline properties:
+
+```dataview
+task
+WHERE startswith(file.folder, this.file.folder)
+GROUP BY file.frontmatter.project
+```
+
+If **neither** note could have inline properties:
+
+```dataview
+task
+WHERE startswith(file.folder, this.file.folder)
+GROUP BY project
+```
+
+## Dataview - group by project status
+
+If **either** note could have inline properties:
+
+```dataview
+task
+WHERE startswith(file.folder, this.file.folder)
+GROUP BY project.file.frontmatter.status
+```
+
+If **neither** note could have inline properties:
+
+```dataview
+task
+WHERE startswith(file.folder, this.file.folder)
+GROUP BY project.status
+```

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Homepage - Tasks.md

@@ -0,0 +1,55 @@
+# Homepage - Tasks
+
+## Tasks queries to visualise behaviour
+
+### Use 'group by' to visualise behaviour - see raw text
+
+```tasks
+not done
+preset this_folder
+
+group by function '1 `' + JSON.stringify(task.file.property("project")) + '`'
+group by function '2 `' + JSON.stringify(task.file.propertyAsLink("project")?.destinationPath) + '`'
+group by function '3 `' + JSON.stringify(task.file.propertyAsLink("project")?.asFile().property("status")) + '`'
+```
+
+### Use 'group by' to visualise behaviour - see rendered values
+
+```tasks
+not done
+preset this_folder
+
+group by function task.file.propertyAsLink("project")?.markdown ?? ''
+```
+
+## What the user requested
+
+I want to only filter tasks that:
+
+- are in active project (property status), every project has file representing it,
+- but there are also other notes related to that project via project property.
+
+So in the example i provided, i only want Active task to be present.
+
+## Tasks searches
+
+### One instruction
+
+```tasks
+not done
+preset this_folder
+
+filter by function task.file.propertyAsLink("project")?.asFile()?.property("status") === "active"
+```
+
+### Two instructions
+
+Possibly slightly faster version?
+
+```tasks
+not done
+preset this_folder
+
+filter by function task.file.hasProperty("project")
+filter by function task.file.propertyAsLink("project")?.asFile()?.property("status") === "active"
+```

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Inactive Project note.md

@@ -0,0 +1,13 @@
+---
+created: 2025-09-22
+project: "[[Inactive project]]"
+themes:
+---
+
+# note
+
+# Inactive Project note
+
+---
+
+- [ ] #task Inactive task

resources/sample_vaults/Tasks-Demo/discussion-3627-example/Inactive project.md

@@ -0,0 +1,17 @@
+---
+created: 2025-09-22
+project: "[[Inactive project]]"
+themes:
+status: idea
+priority: 5 medium
+due:
+dependencies:
+---
+
+# project #note
+
+# Inactive project
+
+---
+
+- [[Inactive Project note]]

resources/sample_vaults/Tasks-Demo/discussion-3627-example/No project.md

@@ -0,0 +1,12 @@
+---
+created: 2025-09-22
+themes:
+---
+
+# note
+
+# No Project note
+
+---
+
+- [ ] #task No project task

src/Obsidian/CacheReader.ts

@@ -0,0 +1,10 @@
+import { App, type CachedMetadata, TFile } from 'obsidian';
+
+export function globalGetFileCache(app: App, filePath: string) {
+    const tFile = app.vault.getAbstractFileByPath(filePath);
+    let fileCache: CachedMetadata | null = null;
+    if (tFile && tFile instanceof TFile) {
+        fileCache = app.metadataCache.getFileCache(tFile);
+    }
+    return fileCache;
+}

src/Renderer/QueryRenderer.ts

@@ -20,6 +20,7 @@ import type { TasksEvents } from '../Obsidian/TasksEvents';
 import { TasksFile } from '../Scripting/TasksFile';
 import { DateFallback } from '../DateTime/DateFallback';
 import type { Task } from '../Task/Task';
+import { globalGetFileCache } from '../Obsidian/CacheReader';
 import { type BacklinksEventHandler, type EditButtonClickHandler, QueryResultsRenderer } from './QueryResultsRenderer';
 import { createAndAppendElement } from './TaskLineRenderer';
 
@@ -57,17 +58,12 @@ export class QueryRenderer {
         //    not yet available, so empty.
         //  - Multi-line properties are supported, but they cannot contain
         //    continuation lines.
-        const app = this.app;
         const filePath = context.sourcePath;
-        const tFile = app.vault.getAbstractFileByPath(filePath);
-        let fileCache: CachedMetadata | null = null;
-        if (tFile && tFile instanceof TFile) {
-            fileCache = app.metadataCache.getFileCache(tFile);
-        }
+        const fileCache = this.getFileCache(filePath);
         const tasksFile = new TasksFile(filePath, fileCache ?? {});
 
         const queryRenderChild = new QueryRenderChild({
-            app: app,
+            app: this.app,
             plugin: this.plugin,
             events: this.events,
             container: element,
@@ -77,6 +73,10 @@ export class QueryRenderer {
         context.addChild(queryRenderChild);
         queryRenderChild.load();
     }
+
+    private getFileCache(filePath: string) {
+        return globalGetFileCache(this.app, filePath);
+    }
 }
 
 /**