@blulotus/trellis 0.7.0

package/dist/utils/manifest-prune.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Self-heal poisoned `.template-hashes.json` manifests.
+ *
+ * Versions before this fix walked `.codex/`, `.claude/`, etc. with a blind
+ * recursive scan when computing the manifest, so they hashed user-owned
+ * runtime data (`.codex/sessions/*`, `.claude/projects/*.jsonl`, pre-existing
+ * `AGENTS.md`, user-added `.codex/skills/<custom>/`, …). On uninstall, every
+ * manifest entry is unlinked, which silently deletes user data.
+ *
+ * `pruneOrphanManifestKeys` removes any manifest entry that no current
+ * platform configurator owns. The two entry points that consume it are
+ * `trellis update` (before migration classification) and `trellis uninstall`
+ * (before plan building). Together they ensure existing poisoned manifests
+ * self-correct on the next routine command.
+ *
+ * Rules:
+ *   - `.trellis/*` entries are ALWAYS kept. `trellis uninstall` removes
+ *     `.trellis/` wholesale via `fs.rmSync(..., { recursive: true })`, so
+ *     manifest accuracy there doesn't affect uninstall data-loss. `update`
+ *     also relies on these entries to detect user-modified workflow files.
+ *   - Root-level `AGENTS.md` is kept only when it still looks Trellis-managed
+ *     (contains the managed block markers) or is missing on disk. This
+ *     self-heals old poisoned manifests for user-owned AGENTS.md files that
+ *     predated init and were skipped.
+ *   - Paths referenced by `from`/`to` of any migration manifest entry
+ *     (rename, rename-dir, delete, safe-file-delete) are preserved. Pruning
+ *     them would prevent legitimate pending migrations from finding their
+ *     source/target.
+ *   - Everything else: if the path is not in the union of
+ *     `collectPlatformTemplates()` for currently-configured platforms, it is
+ *     pruned. This matches "files trellis actually wrote during init/update".
+ */
+import type { AITool } from "../types/ai-tools.js";
+import type { TemplateHashes } from "../types/migration.js";
+export interface PruneResult {
+    /** Manifest keys removed (POSIX-style relative paths). */
+    pruned: string[];
+    /** The post-prune manifest (saved to disk only when `pruned.length > 0`). */
+    hashes: TemplateHashes;
+}
+export interface PruneOptions {
+    /**
+     * Save the pruned manifest to `.template-hashes.json`. Defaults to true.
+     * Callers can pass `false` to compute the prune without mutating disk
+     * (dry-run, change-analysis passes).
+     */
+    persist?: boolean;
+}
+/**
+ * Walk the manifest and split it into kept vs pruned entries.
+ *
+ * @param cwd  Project root — used to save the rewritten manifest.
+ * @param configuredPlatforms Output of `getConfiguredPlatforms(cwd)` — caller
+ *   resolves this so we don't have to re-walk the filesystem.
+ * @param hashes Already-loaded manifest contents. Passing it in (vs reading
+ *   from disk) lets the caller chain `loadHashes` → prune → use the result.
+ * @param options.persist When true (default), saves the pruned manifest to
+ *   disk. Pass `false` for dry-run flows.
+ */
+export declare function pruneOrphanManifestKeys(cwd: string, configuredPlatforms: readonly AITool[], hashes: TemplateHashes, options?: PruneOptions): PruneResult;
+//# sourceMappingURL=manifest-prune.d.ts.map

package/dist/utils/manifest-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-prune.d.ts","sourceRoot":"","sources":["../../src/utils/manifest-prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAUH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,MAAM,EAAE,cAAc,CAAC;CACxB;AAoDD,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,mBAAmB,EAAE,SAAS,MAAM,EAAE,EACtC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,YAAiB,GACzB,WAAW,CAmCb"}

package/dist/utils/manifest-prune.js

@@ -0,0 +1,136 @@
+/**
+ * Self-heal poisoned `.template-hashes.json` manifests.
+ *
+ * Versions before this fix walked `.codex/`, `.claude/`, etc. with a blind
+ * recursive scan when computing the manifest, so they hashed user-owned
+ * runtime data (`.codex/sessions/*`, `.claude/projects/*.jsonl`, pre-existing
+ * `AGENTS.md`, user-added `.codex/skills/<custom>/`, …). On uninstall, every
+ * manifest entry is unlinked, which silently deletes user data.
+ *
+ * `pruneOrphanManifestKeys` removes any manifest entry that no current
+ * platform configurator owns. The two entry points that consume it are
+ * `trellis update` (before migration classification) and `trellis uninstall`
+ * (before plan building). Together they ensure existing poisoned manifests
+ * self-correct on the next routine command.
+ *
+ * Rules:
+ *   - `.trellis/*` entries are ALWAYS kept. `trellis uninstall` removes
+ *     `.trellis/` wholesale via `fs.rmSync(..., { recursive: true })`, so
+ *     manifest accuracy there doesn't affect uninstall data-loss. `update`
+ *     also relies on these entries to detect user-modified workflow files.
+ *   - Root-level `AGENTS.md` is kept only when it still looks Trellis-managed
+ *     (contains the managed block markers) or is missing on disk. This
+ *     self-heals old poisoned manifests for user-owned AGENTS.md files that
+ *     predated init and were skipped.
+ *   - Paths referenced by `from`/`to` of any migration manifest entry
+ *     (rename, rename-dir, delete, safe-file-delete) are preserved. Pruning
+ *     them would prevent legitimate pending migrations from finding their
+ *     source/target.
+ *   - Everything else: if the path is not in the union of
+ *     `collectPlatformTemplates()` for currently-configured platforms, it is
+ *     pruned. This matches "files trellis actually wrote during init/update".
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { collectPlatformTemplates } from "../configurators/index.js";
+import { FILE_NAMES } from "../constants/paths.js";
+import { getAllMigrations } from "../migrations/index.js";
+import { saveHashes } from "./template-hash.js";
+import { toPosix } from "./posix.js";
+const TRELLIS_BLOCK_START = "<!-- TRELLIS:START -->";
+const TRELLIS_BLOCK_END = "<!-- TRELLIS:END -->";
+/**
+ * Compute the union of "what trellis writes" across:
+ *   - every configured platform's collectTemplates() output
+ *   - root-level AGENTS.md when it still carries Trellis managed-block markers
+ *   - every migration manifest's from/to path (preserve so legitimate
+ *     pending migrations can find their source/target)
+ */
+function buildKnownKeys(configuredPlatforms) {
+    const known = new Set();
+    for (const id of configuredPlatforms) {
+        const templates = collectPlatformTemplates(id);
+        if (!templates)
+            continue;
+        for (const key of templates.keys()) {
+            known.add(toPosix(key));
+        }
+    }
+    // Preserve any path referenced by a migration: legitimate pending
+    // rename/delete operations need to resolve their `from` (and the target's
+    // hash record for `to`) even if the current registry doesn't list it.
+    for (const migration of getAllMigrations()) {
+        if (migration.from)
+            known.add(toPosix(migration.from));
+        if (migration.to)
+            known.add(toPosix(migration.to));
+    }
+    return known;
+}
+/**
+ * Root-level AGENTS.md needs special handling because it has no platform
+ * registry owner. New fixed inits record it only when written, but old
+ * manifests may contain a user-owned AGENTS.md that init skipped. The
+ * managed block markers are the least destructive ownership signal: no
+ * markers means preserve the user's file by pruning the stale manifest key.
+ */
+function shouldKeepAgentsMd(cwd) {
+    const fullPath = path.join(cwd, FILE_NAMES.AGENTS);
+    if (!fs.existsSync(fullPath)) {
+        return true;
+    }
+    try {
+        const content = fs.readFileSync(fullPath, "utf-8");
+        return (content.includes(TRELLIS_BLOCK_START) &&
+            content.includes(TRELLIS_BLOCK_END));
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Walk the manifest and split it into kept vs pruned entries.
+ *
+ * @param cwd  Project root — used to save the rewritten manifest.
+ * @param configuredPlatforms Output of `getConfiguredPlatforms(cwd)` — caller
+ *   resolves this so we don't have to re-walk the filesystem.
+ * @param hashes Already-loaded manifest contents. Passing it in (vs reading
+ *   from disk) lets the caller chain `loadHashes` → prune → use the result.
+ * @param options.persist When true (default), saves the pruned manifest to
+ *   disk. Pass `false` for dry-run flows.
+ */
+export function pruneOrphanManifestKeys(cwd, configuredPlatforms, hashes, options = {}) {
+    const persist = options.persist ?? true;
+    const known = buildKnownKeys(configuredPlatforms);
+    const pruned = [];
+    const kept = {};
+    for (const [rawKey, value] of Object.entries(hashes)) {
+        const key = toPosix(rawKey);
+        // Always preserve .trellis/ entries — they're for the workflow tree
+        // which uninstall removes wholesale and which update needs for
+        // modified-file detection.
+        if (key.startsWith(".trellis/") || key === ".trellis") {
+            kept[key] = value;
+            continue;
+        }
+        if (key === FILE_NAMES.AGENTS) {
+            if (shouldKeepAgentsMd(cwd)) {
+                kept[key] = value;
+            }
+            else {
+                pruned.push(key);
+            }
+            continue;
+        }
+        if (known.has(key)) {
+            kept[key] = value;
+            continue;
+        }
+        pruned.push(key);
+    }
+    if (persist && pruned.length > 0) {
+        saveHashes(cwd, kept);
+    }
+    return { pruned, hashes: kept };
+}
+//# sourceMappingURL=manifest-prune.js.map

package/dist/utils/manifest-prune.js.map

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

package/dist/utils/posix.d.ts

@@ -0,0 +1,13 @@
+/**
+ * POSIX path normalization utility
+ *
+ * Single source of truth for converting OS-native path separators to POSIX `/`.
+ * Use ONLY for logical path strings used as cross-platform persistence keys
+ * (e.g. hash dictionary keys, JSON-stored paths). Do NOT use for paths passed
+ * to filesystem APIs — those must remain OS-native via `path.join`.
+ */
+/**
+ * Convert any path string's `\` separators to POSIX `/`.
+ */
+export declare function toPosix(p: string): string;
+//# sourceMappingURL=posix.d.ts.map

package/dist/utils/posix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.d.ts","sourceRoot":"","sources":["../../src/utils/posix.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC"}

package/dist/utils/posix.js

@@ -0,0 +1,15 @@
+/**
+ * POSIX path normalization utility
+ *
+ * Single source of truth for converting OS-native path separators to POSIX `/`.
+ * Use ONLY for logical path strings used as cross-platform persistence keys
+ * (e.g. hash dictionary keys, JSON-stored paths). Do NOT use for paths passed
+ * to filesystem APIs — those must remain OS-native via `path.join`.
+ */
+/**
+ * Convert any path string's `\` separators to POSIX `/`.
+ */
+export function toPosix(p) {
+    return p.replace(/\\/g, "/");
+}
+//# sourceMappingURL=posix.js.map

package/dist/utils/posix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix.js","sourceRoot":"","sources":["../../src/utils/posix.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/utils/project-detector.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Project type detected by analyzing project files
+ */
+export type ProjectType = "frontend" | "backend" | "fullstack" | "unknown";
+/**
+ * Detect project type by analyzing project files
+ *
+ * @param cwd - Current working directory to analyze
+ * @returns Detected project type
+ */
+export declare function detectProjectType(cwd: string): ProjectType;
+/**
+ * Get human-readable description of project type
+ */
+export declare function getProjectTypeDescription(type: ProjectType): string;
+/**
+ * Detected package in a monorepo workspace
+ */
+export interface DetectedPackage {
+    /** Package name (from package.json, Cargo.toml, go.mod, etc.) */
+    name: string;
+    /** Relative path from cwd, normalized (no ./ prefix or trailing /) */
+    path: string;
+    /** Project type detected via detectProjectType() */
+    type: ProjectType;
+    /** Whether this package is a git submodule */
+    isSubmodule: boolean;
+    /** Whether this package has its own .git (independent repo, e.g. polyrepo sibling) */
+    isGitRepo: boolean;
+}
+/**
+ * Sanitize a package name for use as a directory name.
+ * Strips npm scope prefix (@scope/) so "@zhubao/desktop" becomes "desktop".
+ */
+export declare function sanitizePkgName(name: string): string;
+/**
+ * Detect monorepo workspace configuration and enumerate packages.
+ *
+ * Checks workspace managers in priority order (pnpm → npm/yarn/bun → Cargo → Go → uv),
+ * merges results, and marks git submodules. Returns null if no monorepo detected.
+ *
+ * @param cwd - Repository root to analyze
+ * @returns Array of detected packages, null if not a monorepo, empty array if config exists but no packages found
+ */
+export declare function detectMonorepo(cwd: string): DetectedPackage[] | null;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/utils/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAiK3E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAqB1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAWnE;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAsYD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,IAAI,CAyHpE"}