npm - @git-stunts/git-warp - Versions diffs - 10.7.0 → 11.2.1 - Mend

@git-stunts/git-warp 10.7.0 → 11.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (71) hide show

package/README.md +53 -32
package/SECURITY.md +64 -0
package/bin/cli/commands/check.js +168 -0
package/bin/cli/commands/doctor/checks.js +422 -0
package/bin/cli/commands/doctor/codes.js +46 -0
package/bin/cli/commands/doctor/index.js +239 -0
package/bin/cli/commands/doctor/types.js +89 -0
package/bin/cli/commands/history.js +73 -0
package/bin/cli/commands/info.js +139 -0
package/bin/cli/commands/install-hooks.js +128 -0
package/bin/cli/commands/materialize.js +99 -0
package/bin/cli/commands/path.js +88 -0
package/bin/cli/commands/query.js +194 -0
package/bin/cli/commands/registry.js +28 -0
package/bin/cli/commands/seek.js +592 -0
package/bin/cli/commands/trust.js +154 -0
package/bin/cli/commands/verify-audit.js +113 -0
package/bin/cli/commands/view.js +45 -0
package/bin/cli/infrastructure.js +336 -0
package/bin/cli/schemas.js +177 -0
package/bin/cli/shared.js +244 -0
package/bin/cli/types.js +85 -0
package/bin/presenters/index.js +214 -0
package/bin/presenters/json.js +66 -0
package/bin/presenters/text.js +543 -0
package/bin/warp-graph.js +19 -2824
package/index.d.ts +32 -2
package/index.js +2 -0
package/package.json +9 -7
package/src/domain/WarpGraph.js +106 -3252
package/src/domain/errors/QueryError.js +2 -2
package/src/domain/errors/TrustError.js +29 -0
package/src/domain/errors/index.js +1 -0
package/src/domain/services/AuditMessageCodec.js +137 -0
package/src/domain/services/AuditReceiptService.js +471 -0
package/src/domain/services/AuditVerifierService.js +693 -0
package/src/domain/services/HttpSyncServer.js +36 -22
package/src/domain/services/MessageCodecInternal.js +3 -0
package/src/domain/services/MessageSchemaDetector.js +2 -2
package/src/domain/services/SyncAuthService.js +69 -3
package/src/domain/services/WarpMessageCodec.js +4 -1
package/src/domain/trust/TrustCanonical.js +42 -0
package/src/domain/trust/TrustCrypto.js +111 -0
package/src/domain/trust/TrustEvaluator.js +180 -0
package/src/domain/trust/TrustRecordService.js +274 -0
package/src/domain/trust/TrustStateBuilder.js +209 -0
package/src/domain/trust/canonical.js +68 -0
package/src/domain/trust/reasonCodes.js +64 -0
package/src/domain/trust/schemas.js +160 -0
package/src/domain/trust/verdict.js +42 -0
package/src/domain/types/git-cas.d.ts +20 -0
package/src/domain/utils/RefLayout.js +59 -0
package/src/domain/warp/PatchSession.js +18 -0
package/src/domain/warp/Writer.js +18 -3
package/src/domain/warp/_internal.js +26 -0
package/src/domain/warp/_wire.js +58 -0
package/src/domain/warp/_wiredMethods.d.ts +100 -0
package/src/domain/warp/checkpoint.methods.js +397 -0
package/src/domain/warp/fork.methods.js +323 -0
package/src/domain/warp/materialize.methods.js +188 -0
package/src/domain/warp/materializeAdvanced.methods.js +339 -0
package/src/domain/warp/patch.methods.js +529 -0
package/src/domain/warp/provenance.methods.js +284 -0
package/src/domain/warp/query.methods.js +279 -0
package/src/domain/warp/subscribe.methods.js +272 -0
package/src/domain/warp/sync.methods.js +549 -0
package/src/infrastructure/adapters/GitGraphAdapter.js +67 -1
package/src/infrastructure/adapters/InMemoryGraphAdapter.js +36 -0
package/src/ports/CommitPort.js +10 -0
package/src/ports/RefPort.js +17 -0
package/src/hooks/post-merge.sh +0 -60

package/bin/presenters/index.js ADDED Viewed

@@ -0,0 +1,214 @@
+/**
+ * Unified output dispatcher for CLI commands.
+ *
+ * Replaces the 112-line emit() function in warp-graph.js with clean
+ * format dispatch: text, json, ndjson — plus view mode handling.
+ */
+import fs from 'node:fs';
+import process from 'node:process';
+import { stripAnsi } from '../../src/visualization/utils/ansi.js';
+import { renderInfoView } from '../../src/visualization/renderers/ascii/info.js';
+import { renderCheckView } from '../../src/visualization/renderers/ascii/check.js';
+import { renderHistoryView } from '../../src/visualization/renderers/ascii/history.js';
+import { renderPathView } from '../../src/visualization/renderers/ascii/path.js';
+import { renderMaterializeView } from '../../src/visualization/renderers/ascii/materialize.js';
+import { renderSeekView } from '../../src/visualization/renderers/ascii/seek.js';
+import { stableStringify, compactStringify, sanitizePayload } from './json.js';
+import {
+  renderInfo,
+  renderQuery,
+  renderPath,
+  renderCheck,
+  renderDoctor,
+  renderHistory,
+  renderError,
+  renderMaterialize,
+  renderInstallHooks,
+  renderSeek,
+  renderVerifyAudit,
+  renderTrust,
+} from './text.js';
+// ── Color control ────────────────────────────────────────────────────────────
+/**
+ * Determines whether ANSI color codes should be stripped from output.
+ *
+ * Precedence: FORCE_COLOR=0 (strip) > FORCE_COLOR!='' (keep) > NO_COLOR > !isTTY > CI.
+ * @returns {boolean}
+ */
+export function shouldStripColor() {
+  if (process.env.FORCE_COLOR === '0') {
+    return true;
+  }
+  if (process.env.FORCE_COLOR !== undefined && process.env.FORCE_COLOR !== '') {
+    return false;
+  }
+  if (process.env.NO_COLOR !== undefined) {
+    return true;
+  }
+  if (!process.stdout.isTTY) {
+    return true;
+  }
+  if (process.env.CI !== undefined) {
+    return true;
+  }
+  return false;
+}
+// ── Text renderer map ────────────────────────────────────────────────────────
+/** @type {Map<string, function(*): string>} */
+const TEXT_RENDERERS = new Map(/** @type {[string, function(*): string][]} */ ([
+  ['info', renderInfo],
+  ['query', renderQuery],
+  ['path', renderPath],
+  ['check', renderCheck],
+  ['doctor', renderDoctor],
+  ['history', renderHistory],
+  ['materialize', renderMaterialize],
+  ['seek', renderSeek],
+  ['verify-audit', renderVerifyAudit],
+  ['trust', renderTrust],
+  ['install-hooks', renderInstallHooks],
+]));
+/** @type {Map<string, function(*): string>} */
+const VIEW_RENDERERS = new Map(/** @type {[string, function(*): string][]} */ ([
+  ['info', renderInfoView],
+  ['check', renderCheckView],
+  ['history', renderHistoryView],
+  ['path', renderPathView],
+  ['materialize', renderMaterializeView],
+  ['seek', renderSeekView],
+]));
+// ── HTML export ──────────────────────────────────────────────────────────────
+/**
+ * Wraps SVG content in a minimal HTML document and writes it to disk.
+ * @param {string} filePath
+ * @param {string} svgContent
+ */
+function writeHtmlExport(filePath, svgContent) {
+  const html = `<!DOCTYPE html>\n<html><head><meta charset="utf-8"><title>git-warp</title></head><body>\n${svgContent}\n</body></html>`;
+  fs.writeFileSync(filePath, html);
+}
+// ── SVG / HTML file export ───────────────────────────────────────────────────
+/**
+ * Handles svg:PATH and html:PATH view modes for commands that carry _renderedSvg.
+ * @param {*} payload
+ * @param {string} view
+ * @returns {boolean} true if handled
+ */
+function handleFileExport(payload, view) {
+  if (typeof view === 'string' && view.startsWith('svg:')) {
+    const svgPath = view.slice(4);
+    if (!payload._renderedSvg) {
+      process.stderr.write('No graph data — skipping SVG export.\n');
+    } else {
+      fs.writeFileSync(svgPath, payload._renderedSvg);
+      process.stderr.write(`SVG written to ${svgPath}\n`);
+    }
+    return true;
+  }
+  if (typeof view === 'string' && view.startsWith('html:')) {
+    const htmlPath = view.slice(5);
+    if (!payload._renderedSvg) {
+      process.stderr.write('No graph data — skipping HTML export.\n');
+    } else {
+      writeHtmlExport(htmlPath, payload._renderedSvg);
+      process.stderr.write(`HTML written to ${htmlPath}\n`);
+    }
+    return true;
+  }
+  return false;
+}
+// ── Output helpers ───────────────────────────────────────────────────────────
+/**
+ * Writes text to stdout, optionally stripping ANSI codes.
+ * @param {string} text
+ * @param {boolean} strip
+ */
+function writeText(text, strip) {
+  process.stdout.write(strip ? stripAnsi(text) : text);
+}
+// ── Main dispatcher ──────────────────────────────────────────────────────────
+/**
+ * Writes a command result to stdout/stderr in the requested format.
+ *
+ * @param {*} payload - Command result payload
+ * @param {{format: string, command: string, view: string|null|boolean}} options
+ */
+export function present(payload, { format, command, view }) {
+  // Error payloads always go to stderr as plain text
+  if (payload?.error) {
+    process.stderr.write(renderError(payload));
+    return;
+  }
+  // JSON: sanitize + pretty-print
+  if (format === 'json') {
+    process.stdout.write(`${stableStringify(sanitizePayload(payload))}\n`);
+    return;
+  }
+  // NDJSON: sanitize + compact single line
+  if (format === 'ndjson') {
+    process.stdout.write(`${compactStringify(sanitizePayload(payload))}\n`);
+    return;
+  }
+  // Text with view mode
+  if (view) {
+    presentView(payload, command, view);
+    return;
+  }
+  // Plain text
+  const renderer = TEXT_RENDERERS.get(command);
+  if (renderer) {
+    writeText(renderer(payload), shouldStripColor());
+  } else {
+    // Fallback for unknown commands
+    process.stdout.write(`${stableStringify(sanitizePayload(payload))}\n`);
+  }
+}
+/**
+ * Handles --view output dispatch (ASCII view, SVG file, HTML file).
+ * @param {*} payload
+ * @param {string} command
+ * @param {string|boolean} view
+ */
+function presentView(payload, command, view) {
+  const strip = shouldStripColor();
+  // File exports: svg:PATH, html:PATH
+  if (handleFileExport(payload, /** @type {string} */ (view))) {
+    return;
+  }
+  // query is special: uses pre-rendered _renderedAscii
+  if (command === 'query') {
+    writeText(`${payload._renderedAscii ?? ''}\n`, strip);
+    return;
+  }
+  // Dispatch to view renderer
+  const viewRenderer = VIEW_RENDERERS.get(command);
+  if (viewRenderer) {
+    writeText(viewRenderer(payload), strip);
+  } else {
+    writeText(`${stableStringify(sanitizePayload(payload))}\n`, strip);
+  }
+}

package/bin/presenters/json.js ADDED Viewed

@@ -0,0 +1,66 @@
+/**
+ * JSON / NDJSON serialization utilities for CLI output.
+ *
+ * - stableStringify: pretty-printed, sorted-key JSON (--json)
+ * - compactStringify: single-line, sorted-key JSON (--ndjson)
+ * - sanitizePayload: strips internal _-prefixed keys before serialization
+ */
+/**
+ * Recursively sorts object keys for deterministic JSON output.
+ * @param {*} input
+ * @returns {*}
+ */
+function normalize(input) {
+  if (Array.isArray(input)) {
+    return input.map(normalize);
+  }
+  if (input && typeof input === 'object') {
+    /** @type {Record<string, *>} */
+    const sorted = {};
+    for (const key of Object.keys(input).sort()) {
+      sorted[key] = normalize(input[key]);
+    }
+    return sorted;
+  }
+  return input;
+}
+/**
+ * Pretty-printed JSON with sorted keys (2-space indent).
+ * @param {*} value
+ * @returns {string}
+ */
+export function stableStringify(value) {
+  return JSON.stringify(normalize(value), null, 2);
+}
+/**
+ * Single-line JSON with sorted keys (no indent).
+ * @param {*} value
+ * @returns {string}
+ */
+export function compactStringify(value) {
+  return JSON.stringify(normalize(value));
+}
+/**
+ * Shallow-clones a payload, removing all top-level underscore-prefixed keys.
+ * These are internal rendering artifacts (e.g. _renderedSvg, _renderedAscii)
+ * that should not leak into JSON/NDJSON output.
+ * @param {*} payload
+ * @returns {*}
+ */
+export function sanitizePayload(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    return payload;
+  }
+  /** @type {Record<string, *>} */
+  const clean = {};
+  for (const key of Object.keys(payload)) {
+    if (!key.startsWith('_')) {
+      clean[key] = payload[key];
+    }
+  }
+  return clean;
+}