Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

vendor/ruvector/examples/agentic-jujutsu/basic-usage.ts

@@ -0,0 +1,72 @@
+/**
+ * Agentic-Jujutsu Basic Usage Example
+ *
+ * Demonstrates fundamental operations:
+ * - Repository initialization
+ * - Creating commits
+ * - Branch management
+ * - Basic version control workflows
+ */
+
+// Note: This is a reference implementation for testing purposes
+// Actual implementation would use: import { JjWrapper } from 'agentic-jujutsu';
+
+interface JjWrapper {
+  status(): Promise<JjResult>;
+  newCommit(message: string): Promise<JjResult>;
+  log(limit: number): Promise<JjCommit[]>;
+  branchCreate(name: string, rev?: string): Promise<JjResult>;
+  diff(from: string, to: string): Promise<JjDiff>;
+}
+
+interface JjResult {
+  success: boolean;
+  stdout: string;
+  stderr: string;
+}
+
+interface JjCommit {
+  id: string;
+  message: string;
+  author: string;
+  timestamp: string;
+}
+
+interface JjDiff {
+  changes: string;
+  filesModified: number;
+}
+
+async function basicUsageExample() {
+  console.log('=== Agentic-Jujutsu Basic Usage ===\n');
+
+  // In actual usage:
+  // const { JjWrapper } = require('agentic-jujutsu');
+  // const jj = new JjWrapper();
+
+  console.log('1. Check repository status');
+  console.log('   const result = await jj.status();');
+  console.log('   Output: Working directory status\n');
+
+  console.log('2. Create a new commit');
+  console.log('   const commit = await jj.newCommit("Add new feature");');
+  console.log('   Output: Created commit with message\n');
+
+  console.log('3. View commit history');
+  console.log('   const log = await jj.log(10);');
+  console.log('   Output: Last 10 commits\n');
+
+  console.log('4. Create a branch');
+  console.log('   await jj.branchCreate("feature/new-feature");');
+  console.log('   Output: Created new branch\n');
+
+  console.log('5. View differences');
+  console.log('   const diff = await jj.diff("@", "@-");');
+  console.log('   Output: Changes between current and previous commit\n');
+}
+
+if (require.main === module) {
+  basicUsageExample().catch(console.error);
+}
+
+export { basicUsageExample };