@blxzer/cursor-trellis 0.1.0

package/dist/utils/uninstall-scrubbers.js

@@ -0,0 +1,342 @@
+/**
+ * Scrubbers for structured config files during `trellis uninstall`.
+ *
+ * Each scrubber takes the file content (and any context it needs) and returns
+ * `{ content, fullyEmpty }`:
+ * - `content` is the post-scrub text to write back if the file should remain.
+ * - `fullyEmpty` is true when, after stripping every trellis-managed value,
+ *   nothing meaningful is left. The caller deletes the file in that case.
+ *
+ * Manifest path matching (for hooks.json scrubbers) uses substring containment
+ * on the resolved `command` string. The leading `python3 ` / `python ` prefix
+ * does not matter — we just look for the manifest-relative file path.
+ */
+/**
+ * Test whether a hook command string references any of the given manifest paths.
+ *
+ * Trellis-emitted hook commands always have the shape
+ *   `<python-cmd> <manifest-path>`
+ * so the trailing whitespace-delimited token is the script path. We compare
+ * that last token (with surrounding quotes stripped) against the manifest
+ * delete-set. This is intentionally stricter than substring matching: a
+ * user-added hook whose body merely mentions a deleted path inside an `echo`
+ * or comment argument (`echo "see .claude/hooks/session-start.py"`) does NOT
+ * match, because the trailing token is `inspiration"` (or similar) — not the
+ * path. We also accept absolute-path variants like
+ * `/Users/me/proj/.claude/hooks/session-start.py` via `endsWith("/" + p)`.
+ */
+function commandMatchesDeletedPath(command, deletedPaths) {
+    const trimmed = command.trim();
+    if (trimmed.length === 0)
+        return false;
+    const tokens = trimmed.split(/\s+/);
+    const lastToken = tokens[tokens.length - 1].replace(/^["']|["']$/g, "");
+    if (lastToken.length === 0)
+        return false;
+    for (const p of deletedPaths) {
+        if (lastToken === p || lastToken.endsWith("/" + p)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Read the `command` (or fallback `bash` / `powershell`) string out of an
+ * arbitrary hook entry. Copilot's flat schema uses `bash` + `powershell`
+ * instead of `command` for some events.
+ */
+function getEntryCommand(entry) {
+    if (entry === null || typeof entry !== "object") {
+        return null;
+    }
+    const obj = entry;
+    if (typeof obj.command === "string")
+        return obj.command;
+    if (typeof obj.bash === "string")
+        return obj.bash;
+    if (typeof obj.powershell === "string")
+        return obj.powershell;
+    return null;
+}
+/**
+ * Scrub a hooks-shaped settings JSON file.
+ *
+ * `mode = "nested"` → `hooks.{Event}.[ {matcher?, hooks: [ {command,...} ]} ]`
+ * `mode = "flat"`   → `hooks.{Event}.[ {command,...} ]`
+ *
+ * Strips every entry whose command references a path in `deletedPaths`,
+ * then bottom-up cleans empty containers (matcher block, event array, hooks
+ * object). Any user-defined keys outside `hooks` (e.g. `env`, `model`,
+ * `permissions`, `version`) are preserved verbatim.
+ */
+export function scrubHooksJson(content, deletedPaths, mode) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        // Malformed JSON — leave it untouched, caller will skip.
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    const hooks = root.hooks;
+    if (hooks === undefined) {
+        // No hooks block — nothing to scrub. Treat as fully empty only if the
+        // entire file has no other keys.
+        const fullyEmpty = Object.keys(root).length === 0;
+        return { content: JSON.stringify(root, null, 2) + "\n", fullyEmpty };
+    }
+    if (hooks === null || typeof hooks !== "object" || Array.isArray(hooks)) {
+        // hooks is some unexpected shape — leave it alone.
+        return { content, fullyEmpty: false };
+    }
+    const hooksObj = hooks;
+    for (const eventName of Object.keys(hooksObj)) {
+        const eventArr = hooksObj[eventName];
+        if (!Array.isArray(eventArr))
+            continue;
+        const filteredEvent = [];
+        for (const entry of eventArr) {
+            if (mode === "flat") {
+                const cmd = getEntryCommand(entry);
+                if (cmd !== null && commandMatchesDeletedPath(cmd, deletedPaths)) {
+                    continue; // drop trellis entry
+                }
+                filteredEvent.push(entry);
+            }
+            else {
+                // nested: entry is { matcher?, hooks: [...] }
+                if (entry === null || typeof entry !== "object") {
+                    filteredEvent.push(entry);
+                    continue;
+                }
+                const matcherBlock = entry;
+                const inner = matcherBlock.hooks;
+                if (!Array.isArray(inner)) {
+                    filteredEvent.push(entry);
+                    continue;
+                }
+                const filteredInner = inner.filter((sub) => {
+                    const cmd = getEntryCommand(sub);
+                    return !(cmd !== null && commandMatchesDeletedPath(cmd, deletedPaths));
+                });
+                if (filteredInner.length === 0) {
+                    // Whole matcher block is now empty → drop the block.
+                    continue;
+                }
+                // Reconstruct the block with the filtered inner list.
+                const rebuilt = { ...matcherBlock };
+                rebuilt.hooks = filteredInner;
+                filteredEvent.push(rebuilt);
+            }
+        }
+        if (filteredEvent.length === 0) {
+            // Drop the whole event array.
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+            delete hooksObj[eventName];
+        }
+        else {
+            hooksObj[eventName] = filteredEvent;
+        }
+    }
+    // If hooks is empty → drop the key.
+    if (Object.keys(hooksObj).length === 0) {
+        delete root.hooks;
+    }
+    else {
+        root.hooks = hooksObj;
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+/**
+ * Scrub `.opencode/package.json`:
+ * - remove `dependencies["@opencode-ai/plugin"]`
+ * - if `dependencies` ends up empty → drop the field
+ * - fully empty when nothing is left in the object
+ */
+export function scrubOpencodePackageJson(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    const deps = root.dependencies;
+    if (deps !== null && typeof deps === "object" && !Array.isArray(deps)) {
+        const depsObj = deps;
+        if ("@opencode-ai/plugin" in depsObj) {
+            delete depsObj["@opencode-ai/plugin"];
+        }
+        if (Object.keys(depsObj).length === 0) {
+            delete root.dependencies;
+        }
+        else {
+            root.dependencies = depsObj;
+        }
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+/**
+ * Trellis-specific values written by the Pi configurator.
+ *
+ * The `extensions`/`skills`/`prompts` arrays are paths relative to `.pi/`. We
+ * remove the exact entries that the Pi configurator emits.
+ */
+const PI_TRELLIS_EXTENSION = "./extensions/trellis/index.ts";
+const PI_TRELLIS_SKILLS = "./skills";
+const PI_TRELLIS_PROMPTS = "./prompts";
+const PI_SUBAGENTS_PACKAGE = "npm:pi-subagents";
+function isTrellisPiEntry(value, target) {
+    return typeof value === "string" && value === target;
+}
+/**
+ * Scrub `.pi/settings.json`:
+ * - drop `enableSkillCommands` (trellis-flagged)
+ * - remove trellis entries from `extensions`/`skills`/`prompts` arrays
+ * - remove trellis-managed `packages["npm:pi-subagents"]` isolation override
+ * - drop arrays that become empty
+ */
+export function scrubPiSettings(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    if ("enableSkillCommands" in root) {
+        delete root.enableSkillCommands;
+    }
+    const arrayCleanups = [
+        ["extensions", PI_TRELLIS_EXTENSION],
+        ["skills", PI_TRELLIS_SKILLS],
+        ["prompts", PI_TRELLIS_PROMPTS],
+    ];
+    for (const [key, target] of arrayCleanups) {
+        const arr = root[key];
+        if (!Array.isArray(arr))
+            continue;
+        const filtered = arr.filter((v) => !isTrellisPiEntry(v, target));
+        if (filtered.length === 0) {
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+            delete root[key];
+        }
+        else {
+            root[key] = filtered;
+        }
+    }
+    const packagesValue = root.packages;
+    if (Array.isArray(packagesValue)) {
+        const filtered = packagesValue.filter((entry) => {
+            if (entry !== null &&
+                typeof entry === "object" &&
+                !Array.isArray(entry)) {
+                const obj = entry;
+                return obj.source !== PI_SUBAGENTS_PACKAGE;
+            }
+            // String entries — keep unless they exactly match the package name
+            return entry !== PI_SUBAGENTS_PACKAGE;
+        });
+        if (filtered.length === 0) {
+            delete root.packages;
+        }
+        else {
+            root.packages = filtered;
+        }
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+/**
+ * Scrub `.codex/config.toml`.
+ *
+ * The current trellis-emitted file has two distinct chunks:
+ * 1. The line `project_doc_fallback_filenames = ["AGENTS.md"]`
+ * 2. A multi-line comment block that begins with the marker
+ *    `# NOTE: Trellis's SessionStart + UserPromptSubmit hooks require opt-in.`
+ *    and continues through `# be injected into Codex sessions.`
+ *
+ * Plus the leading "Project-scoped Codex defaults" header comments.
+ *
+ * Strategy: line-based removal. We strip:
+ *  - the `project_doc_fallback_filenames = ...` line
+ *  - any line that is *only* a comment introduced by trellis (the entire file
+ *    as shipped is comments + that one assignment)
+ *  - blank lines that surrounded those removals
+ *
+ * If the user added their own non-trellis lines, they are preserved as-is.
+ * "Fully empty" = post-scrub content has no non-whitespace characters.
+ */
+export function scrubCodexConfigToml(content) {
+    const trellisCommentMarkers = [
+        "Project-scoped Codex defaults for Trellis workflows.",
+        "Codex loads this after ~/.codex/config.toml when you work in this project.",
+        "Keep AGENTS.md as the primary project instruction file.",
+        "NOTE: Trellis's SessionStart + UserPromptSubmit hooks require opt-in.",
+        "Add the following to your USER-level config at ~/.codex/config.toml",
+        "(not this project file — features.* must be enabled globally):",
+        "[features]",
+        "hooks = true",
+        "codex_hooks = true",
+        "Without this flag, hooks.json is ignored and Trellis context won't",
+        "be injected into Codex sessions.",
+    ];
+    // A comment line is "trellis-known" if its content (after `#` and spaces)
+    // matches one of the known marker strings exactly OR is an empty `#` line.
+    function isTrellisCommentLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("#"))
+            return false;
+        const inner = trimmed.replace(/^#+\s?/, "").trim();
+        if (inner.length === 0)
+            return true; // bare `#` line inside trellis block
+        return trellisCommentMarkers.some((m) => inner === m);
+    }
+    function isTrellisAssignment(line) {
+        return /^\s*project_doc_fallback_filenames\s*=/.test(line);
+    }
+    const out = [];
+    let prevWasBlank = true; // start-of-file counts as blank for collapsing
+    for (const rawLine of content.split(/\r?\n/)) {
+        if (isTrellisAssignment(rawLine) || isTrellisCommentLine(rawLine)) {
+            continue; // drop
+        }
+        const isBlank = rawLine.trim().length === 0;
+        if (isBlank && prevWasBlank) {
+            continue; // collapse runs of blanks created by removals
+        }
+        out.push(rawLine);
+        prevWasBlank = isBlank;
+    }
+    // Trim trailing blank lines.
+    while (out.length > 0 && out[out.length - 1].trim().length === 0) {
+        out.pop();
+    }
+    const result = out.length > 0 ? out.join("\n") + "\n" : "";
+    const fullyEmpty = result.trim().length === 0;
+    return { content: result, fullyEmpty };
+}
+//# sourceMappingURL=uninstall-scrubbers.js.map

package/dist/utils/uninstall-scrubbers.js.map

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

package/dist/utils/update-rollout-report.d.ts

@@ -0,0 +1,137 @@
+import type { ClassifiedMigrations, MigrationResult } from "../types/migration.js";
+export declare const UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION: 1;
+export type UpdateRolloutMode = "dry-run" | "apply";
+export type UpdateRolloutOutcome = "no_changes" | "would_apply" | "applied" | "cancelled" | "blocked_downgrade" | "blocked_migration_required" | "blocked_not_initialized" | "error";
+export interface UpdateFileActions {
+    added: string[];
+    autoUpdated: string[];
+    overwritten: string[];
+    skipped: string[];
+    createdNew: string[];
+    unchanged: string[];
+    userDeleted: string[];
+    safeDeleted: string[];
+}
+export interface UpdateMigrationPlanSummary {
+    pendingCount: number;
+    auto: number;
+    confirm: number;
+    conflict: number;
+    safeDeleteCandidates: number;
+}
+export interface UpdateMigrationApplySummary {
+    renamed: number;
+    deleted: number;
+    skipped: number;
+    conflicts: number;
+}
+export interface UpdateReadinessProbeSnapshot {
+    id: string;
+    ok: boolean;
+    failures: string[];
+    warnings: string[];
+    smokeCommands: string[];
+}
+export interface UpdateReadinessSnapshot {
+    skipped: boolean;
+    smartSearch: {
+        command: string;
+        ok: boolean;
+        details: string[];
+    };
+    capabilities: UpdateReadinessProbeSnapshot[];
+}
+export interface UpdateSmokeCheckResult {
+    command: string;
+    ok: boolean;
+    detail?: string;
+}
+export interface UpdateReleaseBlocker {
+    code: string;
+    message: string;
+    recovery?: string[];
+}
+export interface UpdateRolloutReport {
+    schemaVersion: typeof UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION;
+    generatedAt: string;
+    mode: UpdateRolloutMode;
+    outcome: UpdateRolloutOutcome;
+    projectPath: string;
+    trellis: {
+        cliVersion: string;
+        packageName: string;
+        projectVersionBefore: string;
+        projectVersionAfter: string | null;
+        latestNpmVersion: string | null;
+        cliBehindNpm: boolean;
+    };
+    options: {
+        dryRun: boolean;
+        force: boolean;
+        skipAll: boolean;
+        createNew: boolean;
+        migrate: boolean;
+        allowDowngrade: boolean;
+        skipReadiness: boolean;
+    };
+    plan: {
+        upgradeDirection: "upgrade" | "downgrade" | "same" | "unknown";
+        breakingMigrationGateRequired: boolean;
+        files: UpdateFileActions;
+        conflictsPending: string[];
+        migrations: UpdateMigrationPlanSummary;
+        backupPath: string | null;
+    };
+    apply?: {
+        backupPath: string | null;
+        migrations: UpdateMigrationApplySummary | null;
+        safeDeleted: number;
+        configSectionsAppended: number;
+    };
+    readiness: UpdateReadinessSnapshot;
+    postUpdateSmoke: UpdateSmokeCheckResult[];
+    releaseBlockers: UpdateReleaseBlocker[];
+}
+export interface BuildFilePlanInput {
+    newFiles: {
+        relativePath: string;
+    }[];
+    unchangedFiles: {
+        relativePath: string;
+    }[];
+    autoUpdateFiles: {
+        relativePath: string;
+    }[];
+    changedFiles: {
+        relativePath: string;
+    }[];
+    userDeletedFiles: {
+        relativePath: string;
+    }[];
+    safeDeletePaths?: string[];
+}
+export declare function buildFilePlanFromChanges(input: BuildFilePlanInput): UpdateFileActions;
+export declare function summarizeMigrationPlan(classified: ClassifiedMigrations | null, safeDeleteCandidateCount: number): UpdateMigrationPlanSummary;
+export declare function migrationResultToSummary(result: MigrationResult | null): UpdateMigrationApplySummary | null;
+export declare function createBaseRolloutReport(input: {
+    mode: UpdateRolloutMode;
+    outcome: UpdateRolloutOutcome;
+    projectPath: string;
+    projectVersionBefore: string;
+    projectVersionAfter?: string | null;
+    latestNpmVersion: string | null;
+    cliBehindNpm: boolean;
+    options: UpdateRolloutReport["options"];
+    readiness: UpdateReadinessSnapshot;
+    upgradeDirection: UpdateRolloutReport["plan"]["upgradeDirection"];
+    files: UpdateFileActions;
+    conflictsPending: string[];
+    migrations: UpdateMigrationPlanSummary;
+    backupPath?: string | null;
+    breakingMigrationGateRequired?: boolean;
+    apply?: UpdateRolloutReport["apply"];
+    postUpdateSmoke?: UpdateSmokeCheckResult[];
+    releaseBlockers?: UpdateReleaseBlocker[];
+}): UpdateRolloutReport;
+export declare function emitRolloutReport(report: UpdateRolloutReport, json: boolean | undefined): void;
+//# sourceMappingURL=update-rollout-report.d.ts.map

package/dist/utils/update-rollout-report.d.ts.map

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

package/dist/utils/update-rollout-report.js

@@ -0,0 +1,108 @@
+import { VERSION, PACKAGE_NAME } from "../constants/version.js";
+export const UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION = 1;
+export function buildFilePlanFromChanges(input) {
+    return {
+        added: input.newFiles.map((f) => f.relativePath),
+        autoUpdated: input.autoUpdateFiles.map((f) => f.relativePath),
+        overwritten: [],
+        skipped: [],
+        createdNew: [],
+        unchanged: input.unchangedFiles.map((f) => f.relativePath),
+        userDeleted: input.userDeletedFiles.map((f) => f.relativePath),
+        safeDeleted: input.safeDeletePaths ?? [],
+    };
+}
+export function summarizeMigrationPlan(classified, safeDeleteCandidateCount) {
+    if (!classified) {
+        return {
+            pendingCount: 0,
+            auto: 0,
+            confirm: 0,
+            conflict: 0,
+            safeDeleteCandidates: safeDeleteCandidateCount,
+        };
+    }
+    return {
+        pendingCount: classified.auto.length +
+            classified.confirm.length +
+            classified.conflict.length,
+        auto: classified.auto.length,
+        confirm: classified.confirm.length,
+        conflict: classified.conflict.length,
+        safeDeleteCandidates: safeDeleteCandidateCount,
+    };
+}
+export function migrationResultToSummary(result) {
+    if (!result)
+        return null;
+    return {
+        renamed: result.renamed,
+        deleted: result.deleted,
+        skipped: result.skipped,
+        conflicts: result.conflicts,
+    };
+}
+export function createBaseRolloutReport(input) {
+    return {
+        schemaVersion: UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION,
+        generatedAt: new Date().toISOString(),
+        mode: input.mode,
+        outcome: input.outcome,
+        projectPath: input.projectPath,
+        trellis: {
+            cliVersion: VERSION,
+            packageName: PACKAGE_NAME,
+            projectVersionBefore: input.projectVersionBefore,
+            projectVersionAfter: input.projectVersionAfter ?? null,
+            latestNpmVersion: input.latestNpmVersion,
+            cliBehindNpm: input.cliBehindNpm,
+        },
+        options: input.options,
+        plan: {
+            upgradeDirection: input.upgradeDirection,
+            breakingMigrationGateRequired: input.breakingMigrationGateRequired ?? false,
+            files: input.files,
+            conflictsPending: input.conflictsPending,
+            migrations: input.migrations,
+            backupPath: input.backupPath ?? null,
+        },
+        apply: input.apply,
+        readiness: input.readiness,
+        postUpdateSmoke: input.postUpdateSmoke ?? [],
+        releaseBlockers: input.releaseBlockers ?? [],
+    };
+}
+export function emitRolloutReport(report, json) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify(report)}\n`);
+        return;
+    }
+    const relBackup = report.plan.backupPath ?? report.apply?.backupPath;
+    console.log("");
+    console.log("--- Rollout evidence (machine-readable) ---");
+    console.log(`  outcome: ${report.outcome}`);
+    console.log(`  mode: ${report.mode}`);
+    console.log(`  versions: ${report.trellis.projectVersionBefore} → ${report.trellis.projectVersionAfter ?? "(unchanged)"} (cli ${report.trellis.cliVersion})`);
+    if (relBackup) {
+        console.log(`  backup: ${relBackup}`);
+    }
+    const f = report.plan.files;
+    const pending = f.added.length +
+        f.autoUpdated.length +
+        report.plan.conflictsPending.length +
+        f.safeDeleted.length;
+    if (pending > 0 || report.mode === "dry-run") {
+        console.log(`  files: +${f.added.length} auto↑${f.autoUpdated.length} conflicts=${report.plan.conflictsPending.length} skip=${f.skipped.length} overwrite=${f.overwritten.length}`);
+    }
+    if (report.postUpdateSmoke.length > 0) {
+        const failed = report.postUpdateSmoke.filter((s) => !s.ok);
+        console.log(`  post-update smoke: ${report.postUpdateSmoke.length - failed.length}/${report.postUpdateSmoke.length} passed`);
+    }
+    if (report.releaseBlockers.length > 0) {
+        for (const b of report.releaseBlockers) {
+            console.log(`  release blocker: ${b.code} — ${b.message}`);
+        }
+    }
+    console.log("  Tip: re-run with --json for full structured evidence.");
+}
+//# sourceMappingURL=update-rollout-report.js.map

package/dist/utils/update-rollout-report.js.map

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