WIKI_RELATED_START_MARKER,

} from "./markdown.js";

import { resolveMemoryWikiTimestamp } from "./time.js";

import { isRegularFileStat, writeGuardedVaultPage } from "./vault-page-write.js";

import { initializeMemoryWikiVault } from "./vault.js";

const OKF_RESERVED_FILENAMES = new Set(["index.md", "log.md"]);

const OKF_VOLATILE_TIMESTAMP_LINE_PATTERN = /^(?:importedAt|updatedAt): .*\n/gm;

const OKF_HASH_CHARS = 8;

type FileStatLike = {

isFile?: unknown;

nlink?: unknown;

};

type OkfConceptDocument = {

conceptId: string;

relativePath: string;

return value.replace(/\.md$/i, "");

}

function isRegularFileStat(value: unknown): value is FileStatLike & { nlink: number } {

if (!value || typeof value !== "object") {

return false;

}

const stat = value as FileStatLike;

const isFile =

typeof stat.isFile === "function"

? (stat.isFile as () => boolean).call(stat)

: stat.isFile === true;

return isFile && typeof stat.nlink === "number";

}

type OkfBundleMetadata = {

key: string;

version?: string;

function getMarkdownDestinationSuffix(destination: string): string {

const queryIndex = destination.indexOf("?");

const fragmentIndex = destination.indexOf("#");

const suffixIndex = queryIndex === -1

? fragmentIndex

: fragmentIndex === -1

? queryIndex

: Math.min(queryIndex, fragmentIndex);

const suffixIndex =

queryIndex === -1

? fragmentIndex

: fragmentIndex === -1

? queryIndex

: Math.min(queryIndex, fragmentIndex);

return suffixIndex === -1 ? "" : destination.slice(suffixIndex);

}

) {

return { changed: false, created: !pageStat };

}

try {

if (isRegularFileStat(pageStat) && pageStat.nlink > 1) {

await vault.remove(params.pagePath);

}

await vault.write(params.pagePath, params.content);

} catch (error) {

if (error instanceof FsSafeError) {

if (error.code !== "symlink" && error.code !== "path-alias") {

throw new Error(

`Refusing to write OKF concept page (${error.code}): ${params.pagePath}: ${error.message}`,

{ cause: error },

);

}

throw new Error(`Refusing to write OKF concept page through symlink: ${params.pagePath}`, {

cause: error,

});

}

throw error;

}

await writeGuardedVaultPage({

vault,

pagePath: params.pagePath,

content: params.content,

pageStat,

pageLabel: "OKF concept page",

});

return { changed: true, created: !pageStat };

}