@fiale-plus/repo-arch 0.1.0 → 0.3.0

package/pi/extensions/repo-arch.ts

@@ -0,0 +1,53 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+
+const COMMANDS = [
+  { label: 'Initialize config', command: 'repo-arch init', hint: 'write repo-arch.config.json' },
+  { label: 'Run prepare flow', command: 'repo-arch flow run --repo .', hint: 'history → cards → dataset → train plan' },
+  { label: 'Run full flow', command: 'repo-arch flow run full --repo .', hint: 'includes embeddings and eval' },
+  { label: 'Inspect run', command: 'repo-arch flow inspect --repo .', hint: 'show artifacts and next steps' },
+  { label: 'Review cards', command: 'repo-arch review list', hint: 'accept/reject before training' },
+  { label: 'Train plan', command: 'repo-arch train prepare --repo .', hint: 'prepare LoRA training' },
+  { label: 'Train cycle', command: 'repo-arch train cycle --repo .', hint: 'continue the persistent loop' },
+  { label: 'Train resume', command: 'repo-arch train resume --repo .', hint: 'resume from latest checkpoint' },
+  { label: 'Train status', command: 'repo-arch train status --repo .', hint: 'inspect the current session' },
+  { label: 'Train list', command: 'repo-arch train list --repo .', hint: 'show all training sessions' },
+  { label: 'Train adapter', command: 'repo-arch train run --repo .', hint: 'execute one-shot LoRA training' },
+  { label: 'Explain a file', command: 'repo-arch why src/core.ts --json', hint: 'history for one file' },
+  { label: 'Find similar history', command: 'repo-arch similar "why auth middleware token-only?" --json', hint: 'semantic search over cards' },
+];
+
+function findConfigFile(cwd: string): string | null {
+  const candidates = [
+    path.join(cwd, 'repo-arch.config.json'),
+    path.join(cwd, '.repo-arch', 'config.json'),
+  ];
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+
+export default function repoArchExtension(pi: ExtensionAPI) {
+  pi.registerCommand('repo-arch', {
+    description: 'Show the self-contained repo-arch CLI workflow',
+    getArgumentCompletions: (prefix) => {
+      const options = ['init', 'flow', 'review', 'train', 'eval', 'why', 'similar'];
+      const filtered = options.filter((option) => option.startsWith(prefix));
+      return filtered.length > 0 ? filtered.map((value) => ({ value, label: value })) : null;
+    },
+    handler: async (_args, ctx) => {
+      const cwd = process.cwd();
+      const configFile = findConfigFile(cwd);
+      const withConfig = (cmd: string) => (configFile ? cmd.replace(' --repo .', ` --repo . --config ${path.relative(cwd, configFile)}`) : cmd);
+      const choices = COMMANDS.map((entry) => `${entry.label} — ${withConfig(entry.command)} — ${entry.hint}`);
+
+      const selected = await ctx.ui.select('repo-arch workflow', choices);
+      if (!selected) return;
+
+      const command = selected.split(' — ')[1] ?? selected;
+      ctx.ui.notify(command, 'info');
+    },
+  });
+}

package/pi/skills/repo-arch/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: repo-arch
+description: Self-contained repo-arch workflow for turning git history into cards, embeddings, datasets, and training runs. Use when you want the CLI flow, run inspection, or guided repo-memory setup.
+---
+
+# Repo-Arch
+
+## Quick start
+
+```bash
+repo-arch init
+repo-arch flow run --repo .
+repo-arch flow run full --repo .
+repo-arch flow inspect --repo .
+```
+
+## Core workflow
+
+1. `repo-arch init` — write a starter `repo-arch.config.json`
+2. `repo-arch flow run` — build history, cards, dataset, and train plan
+3. `repo-arch flow run full` — also build embeddings and evaluation
+4. `repo-arch flow inspect` — see run status, artifacts, and next steps
+5. `repo-arch review list` — curate accepted/rejected cards
+6. `repo-arch eval` — compare retrieval strategies
+7. `repo-arch train prepare` — export training plan
+8. `repo-arch train cycle` — continue the persistent training loop
+9. `repo-arch train resume` — resume from the latest checkpoint
+10. `repo-arch train run` — execute training directly
+
+## Investigation commands
+
+```bash
+repo-arch why src/core.ts --json
+repo-arch check-diff --base main --json
+repo-arch check-stale --json
+repo-arch similar "why auth middleware token-only?" --json
+```
+
+## What to suggest next
+
+- First-time user: `repo-arch init`
+- Want the happy path: `repo-arch flow run full`
+- Need run details: `repo-arch flow inspect`
+- Need curation: `repo-arch review list`
+- Need training: `repo-arch train cycle`
+- Need to resume: `repo-arch train resume`
+- Need status: `repo-arch train status`
+- Need the history: `repo-arch train list`
+
+Keep the CLI as the source of truth; use this skill only as a guide to the flow.