@aefree/pi-plastic 0.7.6 → 0.8.0

package/src/presentation/results.ts

@@ -0,0 +1,84 @@
+import { tool } from "../tool-definition";
+import { analyzeMergeStatusOutput } from "../domain/merge-output";
+import { getCmVersion } from "../execution/cli-version";
+
+export const formatStatusText = (output: string, mergeState: ReturnType<typeof analyzeMergeStatusOutput>): string =>
+{
+    return mergeState.hasMergeInProgress || mergeState.hasPendingMergeLinks
+    ? [
+        output,
+        "",
+        "## Merge State",
+        `- Pending merge links: ${mergeState.pendingMergeLinks.length}`,
+        `- Merge-in-progress hints: ${mergeState.mergeInProgressHints.length}`,
+        ...(mergeState.hasMergeInProgress ? ["- Checkin may be blocked until merge metadata is finalized. If files are resolved, run plastic_finalizeMerge(...)."] : []),
+    ].join("\n")
+    : output;
+};
+
+export const TOOL_VERSION = "v2.0.0";
+
+export type OutputFormat = "text" | "json";
+
+export const outputFormatArg = tool.schema.enum(["text", "json"]).optional().describe("Output format. Defaults to text.");
+
+export const formatPreflightText = (title: string, lines: string[]): string =>
+{
+    return [title, "", ...lines].join("\n");
+};
+
+export const toStructuredResult = async (
+    action: string,
+    format: OutputFormat,
+    text: string,
+    data: Record<string, unknown>,
+    workdir?: string,
+    warnings?: string[],
+    nextSuggestedAction?: string,
+): Promise<string> =>
+{
+    if (format !== "json")
+    {
+        return text;
+    }
+
+    const payload: Record<string, unknown> = {
+        ok: true,
+        action,
+        toolVersion: TOOL_VERSION,
+        cliVersion: await getCmVersion(workdir),
+        data,
+    };
+
+    if (warnings && warnings.length > 0)
+    {
+        payload.warnings = warnings;
+    }
+
+    if (nextSuggestedAction)
+    {
+        payload.nextSuggestedAction = nextSuggestedAction;
+    }
+
+    return `## ${action}\n\n\`\`\`json\n${JSON.stringify(payload, null, 2)}\n\`\`\``;
+};
+
+export const formatServerMergeResult = async (
+    format: OutputFormat,
+    outcome: "preflight" | "analyzed" | "completed" | "no-op" | "conflict" | "uncertain" | "unsupported" | "failed",
+    text: string,
+    data: Record<string, unknown>,
+): Promise<string> =>
+{
+    if (format === "text")
+    {
+        return text;
+    }
+    return `## merge-branches\n\n\`\`\`json\n${JSON.stringify({
+        ok: outcome === "completed" || outcome === "preflight" || outcome === "no-op",
+        action: "merge-branches",
+        outcome,
+        toolVersion: TOOL_VERSION,
+        data,
+    }, null, 2)}\n\`\`\``;
+};

package/src/presentation/switch-results.ts

@@ -0,0 +1,7 @@
+import type { SwitchReceipt } from "../domain/switch-contract";
+export function presentSwitchReceipt(dto: SwitchReceipt, format: "text" | "json" = "text"): string {
+    const summary = dto.ok ? `Switch ${dto.outcome}. Strategy: ${dto.data.strategy}. Effect: ${dto.data.effect}.` : `Switch ${dto.outcome}. ${dto.error.message} Effect: ${dto.data.effect}.`;
+    if (format === "text") return summary;
+    // Core JSON compatibility is a view of the same observation, not a source for native data.
+    return "```json\n" + JSON.stringify({ action: "switch-branch", ok: dto.ok, outcome: dto.outcome, data: { strategy: dto.data.strategy, branchBefore: dto.data.branchBefore?.branch ?? null, branchAfter: dto.data.branchAfter?.branch ?? null, branchTarget: dto.data.requestedTarget, pendingSummaryDetailed: dto.data.pendingBefore, pendingPolicy: dto.data.pendingPolicy, defaultedPolicy: dto.data.defaultedPolicy, usedNoChangesShelveRecovery: dto.data.usedNoChangesShelveRecovery, effect: dto.data.effect, wouldRun: dto.data.wouldRun }, ...(!dto.ok ? {error:dto.error} : {}) }, null, 2) + "\n```";
+}

package/src/presentation/undo-results.ts

@@ -0,0 +1,5 @@
+import type { UndoReceipt } from "../domain/undo-contract";
+export function presentUndoReceipt(dto: UndoReceipt): string {
+    return dto.ok ? `Undo command completed for ${dto.data.requestedOperandCount} requested operands, not a verified undone-item count. Workspace identity, undone items, restored content, expanded scope and preservation remain unverified.` :
+        `Undo ${dto.outcome}: ${dto.error.message} Effects: ${dto.data.effect}. Do not retry automatically.`;
+}

package/src/presentation/update-results.ts

@@ -0,0 +1,5 @@
+import type { UpdateReceipt } from "../domain/update-contract";
+export function presentUpdateReceipt(dto: UpdateReceipt): string {
+    return dto.ok ? "Update command completed. Workspace identity, changed items, preservation, cleanliness and merge readiness remain unverified." :
+        `Update ${dto.outcome}: ${dto.error.message} Effects: ${dto.data.effect}. Do not retry automatically.`;
+}

package/src/presentation/workspace-merge-results.ts

@@ -0,0 +1,6 @@
+import type { WorkspaceMergeReceipt } from "../domain/workspace-merge-contract";
+export function presentWorkspaceMergeReceipt(dto:WorkspaceMergeReceipt):string {
+ if(dto.data.outputFormatRequested==="json")return JSON.stringify(dto,null,2);
+ const title=dto.action==="merge"?"Workspace Merge":"Merge Finalization";
+ return dto.ok?dto.outcome==="preflight"?title+" command-only preview; no readiness analysis or command executed.\ncm "+dto.data.intendedArgv.join(" "):title+" command completed; admitted observations contain no unresolved signals. Conflict resolution/finalized metadata/preservation and complete affected scope remain unverified.":title+" "+dto.outcome+": "+dto.error.message+" Applying command completed: "+dto.data.commandCompleted+". No automatic retry, checkin, rollback or strategy change.";
+}