Method updatePropertyInFile

src/metaController.ts:577–625

(property: Partial<Property>, newValue: unknown, file: TFile)

    }

    public async updatePropertyInFile(property: Partial<Property>, newValue: unknown, file: TFile): Promise<void> {
        if (!property.key) return;

        // Guard the direct frontmatter key before opening the file. Deeper path
        // segments (a nested `parent.__proto__` write) are refused by
        // `setYamlPath` itself; this catches the top-level `frontmatter[key] = `
        // sink. A reserved `tags`/`tag` key is impossible, so this is harmless
        // for the tags branch.
        if (property.type === MetaType.YAML) this.assertWritableKey(property.key);

        await this.enqueueFileWrite(file, async () => {
            if (property.type === MetaType.YAML) {
                await this.processFrontMatter(file, (frontmatter) => {
                    if (property.path && property.path.length > 1) {
                        setYamlPath(frontmatter, property.path, newValue, {
                            createParents: false,
                            createLeaf: false,
                            expectedValue: property.content,
                            validateExpectedValue: true,
                        });
                    } else if (isTagsKey(property.key)) {
                        // Canonicalise `tags`: strip `#`, drop blanks, store a list.
                        // When the last tag is gone, remove the key (Decision E)
                        // rather than leave a dangling `tags:` / `tags: []`.
                        const tags = splitFrontmatterTags(newValue);
                        if (tags.length === 0) delete frontmatter[property.key!];
                        else frontmatter[property.key!] = tags;
                    } else {
                        frontmatter[property.key!] = newValue;
                    }
                });
                return;
            }

            if (property.type === MetaType.Tag) {
                await this.writeTagOccurrence(property, newValue, file);
                return;
            }

            if (property.type !== MetaType.Dataview || !property.key) return;

            const fileContent = await this.app.vault.read(file);
            const newFileContent = this.parser.replaceInlineFieldValuesInContent(fileContent, [
                {key: property.key, value: String(newValue)},
            ]);

            await this.app.vault.modify(file, newFileContent);
        });
    }

    /**
     * Rewrite one body-tag occurrence in place, by its parsed span. The span is