@jayjiang/byoao 0.3.3 → 0.5.0

package/dist/vault/upgrade.js

@@ -0,0 +1,266 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { readManifest, writeManifest, getPackageVersion, } from "./manifest.js";
+import { loadPreset, getCommonDir } from "./preset.js";
+import { detectVaultContext } from "./vault-detect.js";
+// ── Constants ───────────────────────────────────────────────────
+const OBSIDIAN_CONFIG_FILES = [
+    "core-plugins.json",
+    "daily-notes.json",
+    "templates.json",
+];
+// ── Scanning ────────────────────────────────────────────────────
+/** Scan vault for installed infrastructure files. Returns relative paths. */
+export async function scanInstalledAssets(vaultPath) {
+    const skills = await scanDir(vaultPath, ".opencode/skills", ".md");
+    const commands = await scanDir(vaultPath, ".opencode/commands", ".md");
+    const templates = await scanDir(vaultPath, "Knowledge/templates", ".md");
+    const obsidianConfig = [];
+    for (const file of OBSIDIAN_CONFIG_FILES) {
+        const abs = path.join(vaultPath, ".obsidian", file);
+        if (await fs.pathExists(abs)) {
+            obsidianConfig.push(`.obsidian/${file}`);
+        }
+    }
+    return { skills, commands, obsidianConfig, templates };
+}
+async function scanDir(vaultPath, relDir, ext) {
+    const absDir = path.join(vaultPath, relDir);
+    if (!(await fs.pathExists(absDir)))
+        return [];
+    const files = await fs.readdir(absDir);
+    return files
+        .filter((f) => f.endsWith(ext))
+        .map((f) => `${relDir}/${f}`);
+}
+// ── Bootstrap ───────────────────────────────────────────────────
+const DEFAULT_PRESET = "pm-tpm";
+/** Bootstrap a manifest for vaults created before the manifest existed. */
+export async function bootstrapManifest(vaultPath, preset) {
+    const installedFiles = await scanInstalledAssets(vaultPath);
+    await writeManifest(vaultPath, preset ?? DEFAULT_PRESET, installedFiles, "0.0.0");
+    const manifest = await readManifest(vaultPath);
+    return manifest;
+}
+// ── Plan Building ───────────────────────────────────────────────
+/** Build an upgrade plan by comparing package assets against vault state. */
+export function buildUpgradePlan(vaultPath, manifest, packageAssets) {
+    const items = [];
+    const pkgVersion = getPackageVersion();
+    const categories = [
+        { key: "skills", category: "skills" },
+        { key: "commands", category: "commands" },
+        { key: "obsidianConfig", category: "obsidianConfig" },
+        { key: "templates", category: "templates" },
+    ];
+    for (const { key, category } of categories) {
+        const shipped = packageAssets[key];
+        const installed = new Set(manifest.infrastructure[key]);
+        const shippedPaths = new Set(shipped.map((s) => s.relativePath));
+        for (const entry of shipped) {
+            const onDisk = fs.existsSync(path.join(vaultPath, entry.relativePath));
+            items.push({
+                file: entry.relativePath,
+                action: onDisk ? "update" : "add",
+                category,
+            });
+        }
+        for (const installedPath of installed) {
+            if (!shippedPaths.has(installedPath)) {
+                items.push({
+                    file: installedPath,
+                    action: "deprecated",
+                    category,
+                });
+            }
+        }
+    }
+    return {
+        fromVersion: manifest.version,
+        toVersion: pkgVersion,
+        items,
+    };
+}
+// ── Asset Resolution ────────────────────────────────────────────
+function resolveAssetsDir() {
+    const srcAssets = path.resolve(import.meta.dirname, "..", "assets");
+    const distAssets = path.resolve(import.meta.dirname, "..", "..", "src", "assets");
+    if (fs.existsSync(srcAssets))
+        return srcAssets;
+    if (fs.existsSync(distAssets))
+        return distAssets;
+    return srcAssets;
+}
+function resolveSkillsDir() {
+    const srcSkills = path.resolve(import.meta.dirname, "..", "skills");
+    const distSkills = path.resolve(import.meta.dirname, "..", "..", "src", "skills");
+    if (fs.existsSync(srcSkills))
+        return srcSkills;
+    if (fs.existsSync(distSkills))
+        return distSkills;
+    return srcSkills;
+}
+/** Resolve package assets for a given preset. */
+function resolvePackageAssets(preset) {
+    const assetsDir = resolveAssetsDir();
+    const skillsDir = resolveSkillsDir();
+    const commonDir = getCommonDir();
+    const skills = [];
+    const commands = [];
+    const obsidianConfig = [];
+    const templates = [];
+    // 1. Obsidian skills → .opencode/skills/
+    const obsidianSkillsDir = path.join(assetsDir, "obsidian-skills");
+    if (fs.existsSync(obsidianSkillsDir)) {
+        for (const file of fs.readdirSync(obsidianSkillsDir)) {
+            if (file.endsWith(".md")) {
+                skills.push({
+                    relativePath: `.opencode/skills/${file}`,
+                    sourcePath: path.join(obsidianSkillsDir, file),
+                });
+            }
+        }
+    }
+    // 2. BYOAO commands (src/skills/) → .opencode/commands/
+    if (fs.existsSync(skillsDir)) {
+        for (const file of fs.readdirSync(skillsDir)) {
+            if (file.endsWith(".md")) {
+                commands.push({
+                    relativePath: `.opencode/commands/${file}`,
+                    sourcePath: path.join(skillsDir, file),
+                });
+            }
+        }
+    }
+    // 3. Obsidian config from common
+    const obsidianSrcDir = path.join(commonDir, "obsidian");
+    if (fs.existsSync(obsidianSrcDir)) {
+        for (const file of OBSIDIAN_CONFIG_FILES) {
+            const srcPath = path.join(obsidianSrcDir, file);
+            if (fs.existsSync(srcPath)) {
+                obsidianConfig.push({
+                    relativePath: `.obsidian/${file}`,
+                    sourcePath: srcPath,
+                });
+            }
+        }
+    }
+    // 4. Templates: common + preset
+    const commonTemplatesDir = path.join(commonDir, "templates");
+    if (fs.existsSync(commonTemplatesDir)) {
+        for (const file of fs.readdirSync(commonTemplatesDir)) {
+            if (file.endsWith(".md")) {
+                templates.push({
+                    relativePath: `Knowledge/templates/${file}`,
+                    sourcePath: path.join(commonTemplatesDir, file),
+                });
+            }
+        }
+    }
+    try {
+        const { presetsDir } = loadPreset(preset);
+        const presetTemplatesDir = path.join(presetsDir, preset, "templates");
+        if (fs.existsSync(presetTemplatesDir)) {
+            for (const file of fs.readdirSync(presetTemplatesDir)) {
+                if (file.endsWith(".md")) {
+                    templates.push({
+                        relativePath: `Knowledge/templates/${file}`,
+                        sourcePath: path.join(presetTemplatesDir, file),
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        /* Preset not found — use common templates only */
+    }
+    return { skills, commands, obsidianConfig, templates };
+}
+// ── Upgrade Execution ───────────────────────────────────────────
+/** Upgrade a BYOAO vault's infrastructure files to the current package version. */
+export async function upgradeVault(vaultPath, options) {
+    const { preset, dryRun = false, force = false } = options ?? {};
+    // 1. Validate this is a BYOAO vault
+    const detectedPath = detectVaultContext(vaultPath);
+    if (!detectedPath) {
+        throw new Error(`No BYOAO vault detected at "${vaultPath}". ` +
+            "Expected .obsidian/ and AGENT.md or Knowledge/Glossary.md.");
+    }
+    // 2. Read or bootstrap manifest
+    let manifest = await readManifest(vaultPath);
+    if (!manifest) {
+        manifest = await bootstrapManifest(vaultPath, preset);
+    }
+    const pkgVersion = getPackageVersion();
+    const fromVersion = manifest.version;
+    // 3. Check if upgrade needed
+    if (fromVersion === pkgVersion && !force) {
+        return {
+            fromVersion,
+            toVersion: pkgVersion,
+            added: [],
+            updated: [],
+            deprecated: [],
+            errors: [],
+            dryRun,
+        };
+    }
+    // 4. Resolve package assets and build plan
+    const effectivePreset = preset ?? manifest.preset;
+    const packageAssets = resolvePackageAssets(effectivePreset);
+    const plan = buildUpgradePlan(vaultPath, manifest, packageAssets);
+    // 5. Execute plan (or dry run)
+    const added = [];
+    const updated = [];
+    const deprecated = [];
+    const errors = [];
+    if (!dryRun) {
+        // Build lookup from relativePath → sourcePath
+        const sourceMap = new Map();
+        for (const category of ["skills", "commands", "obsidianConfig", "templates"]) {
+            for (const entry of packageAssets[category]) {
+                sourceMap.set(entry.relativePath, entry.sourcePath);
+            }
+        }
+        for (const item of plan.items) {
+            try {
+                if (item.action === "add" || item.action === "update") {
+                    const source = sourceMap.get(item.file);
+                    if (source) {
+                        const dest = path.join(vaultPath, item.file);
+                        await fs.ensureDir(path.dirname(dest));
+                        await fs.copy(source, dest, { overwrite: true });
+                        if (item.action === "add") {
+                            added.push(item.file);
+                        }
+                        else {
+                            updated.push(item.file);
+                        }
+                    }
+                }
+                else if (item.action === "deprecated") {
+                    deprecated.push(item.file);
+                }
+            }
+            catch (err) {
+                errors.push({
+                    file: item.file,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        // 6. Update manifest with new version and current file list
+        const installedFiles = await scanInstalledAssets(vaultPath);
+        await writeManifest(vaultPath, effectivePreset, installedFiles);
+    }
+    return {
+        fromVersion,
+        toVersion: pkgVersion,
+        added,
+        updated,
+        deprecated,
+        errors,
+        dryRun,
+    };
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/vault/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/vault/upgrade.ts"],"names":[],"mappings":"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"}

package/dist/vault/vault-detect.js

@@ -0,0 +1,29 @@
+import fs from "fs-extra";
+import path from "node:path";
+/**
+ * Detect whether a directory is (or is inside) a BYOAO vault.
+ * Returns the vault root path if detected, null otherwise.
+ *
+ * A directory is a BYOAO vault if:
+ * - .obsidian/ exists AND AGENT.md exists, OR
+ * - .obsidian/ exists AND Knowledge/Glossary.md exists
+ *
+ * Checks the given directory and its immediate parent.
+ */
+export function detectVaultContext(dir) {
+    const candidates = [dir, path.dirname(dir)];
+    for (const candidate of candidates) {
+        if (!fs.existsSync(candidate))
+            continue;
+        const hasObsidian = fs.existsSync(path.join(candidate, ".obsidian"));
+        if (!hasObsidian)
+            continue;
+        const hasAgentMd = fs.existsSync(path.join(candidate, "AGENT.md"));
+        const hasGlossary = fs.existsSync(path.join(candidate, "Knowledge", "Glossary.md"));
+        if (hasAgentMd || hasGlossary) {
+            return candidate;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=vault-detect.js.map

package/dist/vault/vault-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-detect.js","sourceRoot":"","sources":["../../src/vault/vault-detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS;QAExC,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,CACjD,CAAC;QAEF,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayjiang/byoao",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "Build Your Own AI OS — Obsidian + AI Agent",
   "type": "module",
   "engines": {
@@ -50,12 +50,14 @@
     "gray-matter": "^4.0.0",
     "handlebars": "^4.7.0",
     "inquirer": "^9.0.0",
+    "semver": "^7.7.4",
     "zod": "^3.23.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.0",
     "@types/inquirer": "^9.0.0",
     "@types/node": "^20.0.0",
+    "@types/semver": "^7.7.1",
     "tsx": "^4.21.0",
     "typescript": "^5.4.0",
     "vitest": "^4.1.0"