@blxzer/pactile 0.5.0

package/dist/commands/update.d.ts

@@ -0,0 +1,139 @@
+import type { ConfigSectionAdded, MigrationItem, TemplateHashes } from "../types/migration.js";
+import { type UpdateRolloutReport } from "../utils/update-rollout-report.js";
+export interface UpdateOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    skipAll?: boolean;
+    createNew?: boolean;
+    allowDowngrade?: boolean;
+    migrate?: boolean;
+    skipReadiness?: boolean;
+    /** Emit a single-line JSON rollout evidence object (dry-run or apply). */
+    json?: boolean;
+    /** Skip post-apply Python script smoke checks (apply mode only). */
+    skipPostUpdateSmoke?: boolean;
+    /**
+     * Maintainer / harness: after one confirm, write artifact B projections.
+     * User default stays dual-read only.
+     */
+    writeArtifacts?: boolean;
+    /** Filled on completion for `pactile rollout` aggregation. */
+    lastReport?: UpdateRolloutReport;
+}
+interface FileChange {
+    path: string;
+    relativePath: string;
+    newContent: string;
+    status: "new" | "unchanged" | "changed";
+}
+interface ChangeAnalysis {
+    newFiles: FileChange[];
+    unchangedFiles: FileChange[];
+    autoUpdateFiles: FileChange[];
+    changedFiles: FileChange[];
+    userDeletedFiles: FileChange[];
+    protectedPaths: string[];
+}
+/**
+ * Load update.skip paths from the canonical config file.
+ *
+ * Parses simple YAML structure:
+ *   update:
+ *     skip:
+ *       - path1
+ *       - path2
+ *
+ * @internal Exported for testing only
+ */
+export declare function loadUpdateSkipPaths(cwd: string): string[];
+/**
+ * File-level `update.skip` entries that no longer protect a fork: the file on
+ * disk already matches the official template (typical after a release that
+ * absorbs a local dogfood patch). Directory skips are never treated as stale.
+ *
+ * @internal Exported for testing only
+ */
+export declare function collectStaleUpdateSkipPaths(cwd: string, skipPaths: readonly string[], officialTemplates: Map<string, string>): string[];
+/**
+ * Drop listed paths from canonical `config.yaml` `update.skip`. If the skip list
+ * becomes empty, remove `skip:` and a now-empty `update:` key. Does not touch
+ * surrounding comments.
+ *
+ * @internal Exported for testing only
+ */
+export declare function removeUpdateSkipPathsFromConfig(cwd: string, pathsToRemove: readonly string[]): string[];
+/**
+ * Extract a "section" from a config.yaml-style template by sectionHeading.
+ *
+ * A section is delimited by `#---...---` separator lines (the same pattern
+ * used in the bundled `config.yaml` template). The first line inside the
+ * separator block whose `# ` content matches `sectionHeading` identifies the
+ * section; the section spans from that opening separator block through the
+ * line preceding the next `#---` separator block (or EOF).
+ *
+ * Returns the extracted text including its leading separator block, or `null`
+ * when no matching section is found.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function extractConfigSection(template: string, sectionHeading: string): string | null;
+/**
+ * Apply additive config.yaml sections introduced between two versions.
+ *
+ * Walks the supplied entries, dedupes by `file+sentinel`, and for each unique
+ * entry: if the user file exists and lacks the sentinel, extracts the named
+ * section from `templateContent` and appends it. Idempotent — re-running the
+ * step on a file that already contains the sentinel is a no-op.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function applyConfigSectionsAdded(entries: ConfigSectionAdded[], cwd: string, bundledTemplates: Map<string, string>): {
+    appended: number;
+};
+/**
+ * Collect all template files that should be managed by update.
+ * Only collects templates for platforms that are already configured (have directories).
+ * Exported so tests can assert the hash set includes canonical modules and
+ * never user middleware.
+ */
+export declare function collectTemplateFiles(cwd: string, 
+/**
+ * Bypass `update.skip` when collecting templates. Enable this for breaking
+ * releases so new files (e.g. `continue.md` added in 0.5.0) and template
+ * updates can land even under skip-protected paths. Without this, users with
+ * `.cursor/commands/` in their skip list would silently miss new commands.
+ * Existing user customizations are still guarded at WRITE time via the
+ * "Modified by you" conflict prompt — they can skip per-file there.
+ */
+bypassUpdateSkip?: boolean): Map<string, string>;
+/**
+ * Unchanged templates with no stored hash (canary hand-copy, first hash
+ * tracking, or a newly shipped canonical module path). Record the
+ * hash so the next real template edit auto-updates instead of prompting
+ * "Modified by you" or listing the path as new.
+ */
+export declare function collectMissingTemplateHashes(changes: Pick<ChangeAnalysis, "unchangedFiles">, hashes: TemplateHashes): Map<string, string>;
+/**
+ * Check if a path should be excluded from backup
+ * @internal Exported for testing only
+ */
+export declare function shouldExcludeFromBackup(relativePath: string): boolean;
+/**
+ * Clean up empty directories after file migration
+ * Recursively remove empty parent directories up to the managed root.
+ */
+/** @internal Exported for testing only */
+export declare function cleanupEmptyDirs(cwd: string, dirPath: string): void;
+/**
+ * Sort migrations for safe execution order
+ * - rename-dir with deeper paths first (to handle nested directories)
+ * - rename-dir before rename/delete
+ */
+/** @internal Exported for testing only */
+export declare function sortMigrationsForExecution(migrations: MigrationItem[]): MigrationItem[];
+/**
+ * Main update command
+ */
+export declare function update(options: UpdateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

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