cronus-ui 0.6.0

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,51 @@
+/** Where the human/agent-readable conflict report is written (project root). */
+export declare const REPORT_FILE = "CRONUS-UPGRADE.md";
+export interface UpgradeOptions {
+    cwd: string;
+    registry?: string;
+    /** Upgrade every item recorded in the install manifest. */
+    all?: boolean;
+    /** Print the per-file plan without writing anything (not even the report). */
+    dryRun?: boolean;
+    /** Assume "yes" for every confirmation (conflict markers, overwrites). */
+    yes?: boolean;
+    /** Legacy items (no manifest entry): allow replacing local files with upstream. */
+    overwrite?: boolean;
+    /** Reload composed apps from this manifest file (same flag as add-page/compose). */
+    manifestPath?: string;
+    /** Test seam — replaces the interactive stdin confirmation when provided. */
+    confirm?: (question: string) => Promise<boolean>;
+}
+/** Outcome of planning one file of one item. */
+export type FileStatus = "up-to-date" | "fast-forward" | "new-file" | "local-edits" | "merged" | "conflict" | "manual" | "removed-upstream" | "locally-deleted" | "legacy-match" | "legacy-differs";
+export type MergeResult = {
+    status: "clean" | "conflict";
+    content: string;
+} | {
+    status: "unavailable";
+};
+/**
+ * 3-way merge via `git merge-file -p --diff3`. Exit code 0 = clean merge,
+ * 1..127 = that many conflicts (stdout still holds the marked-up result),
+ * anything else (or no git at all) = unavailable → caller falls back to a
+ * whole-file "manual merge needed" report.
+ */
+export declare function mergeThreeWay(base: string, local: string, target: string, labels: {
+    base: string;
+    target: string;
+}): Promise<MergeResult>;
+/**
+ * Unified diff (a→b) via `git diff --no-index`, with the temp-file headers
+ * replaced by the given labels. Returns undefined when git is unavailable or
+ * errors (exit 1 just means "files differ" and is expected).
+ */
+export declare function unifiedDiff(a: string, b: string, labelA: string, labelB: string): Promise<string | undefined>;
+/**
+ * `cronus-ui upgrade` — pull upstream component (and, with `--all`, composed
+ * page) updates WITHOUT losing local edits. For every target it 3-way merges
+ * base, local, and upstream via `git merge-file --diff3`. Conflicts are never
+ * silently clobbered: markers are only written with consent, and
+ * CRONUS-UPGRADE.md gets a ready-to-paste agent prompt per unresolved file.
+ */
+export declare function upgrade(names: string[], options: UpgradeOptions): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map