@locusai/cli 0.17.3 → 0.17.5

package/bin/locus.js

@@ -1598,7 +1598,8 @@ ${bold("Initializing Locus...")}
   const entriesToAdd = GITIGNORE_ENTRIES.filter((entry) => entry && !gitignoreContent.includes(entry.trim()));
   if (entriesToAdd.length > 0) {
     const newContent = `${gitignoreContent.trimEnd()}
-${GITIGNORE_ENTRIES.join(`
+
+${entriesToAdd.join(`
 `)}
 `;
     writeFileSync4(gitignorePath, newContent, "utf-8");
@@ -1672,8 +1673,8 @@ var init_init = __esm(() => {
     ".locus/sessions/",
     ".locus/logs/",
     ".locus/worktrees/",
-    ".locus/artifacts",
-    ".locus/discussions"
+    ".locus/artifacts/",
+    ".locus/discussions/"
   ];
 });
 
@@ -5117,7 +5118,7 @@ ${gitLog}
 function buildExecutionRules(config) {
   return `# Execution Rules
 
-1. **Commit format:** Use conventional commits: \`feat: <title> (#<issue>)\`, \`fix: ...\`, \`chore: ...\`
+1. **Commit format:** Use conventional commits: \`feat: <title> (#<issue>)\`, \`fix: ...\`, \`chore: ...\`. Always include a blank line followed by \`Co-Authored-By: LocusAgent <agent@locusai.team>\` as a trailer in every commit message.
 2. **Code quality:** Follow existing code style. Run linters/formatters if available.
 3. **Testing:** If test files exist for modified code, update them accordingly.
 4. **Do NOT:**
@@ -5261,6 +5262,100 @@ class JsonStream {
   }
 }
 
+// src/display/diff-renderer.ts
+function renderDiff(diff, options = {}) {
+  const { maxLines, lineNumbers = true } = options;
+  const lines = diff.split(`
+`);
+  const output = [];
+  let lineCount = 0;
+  let oldLine = 0;
+  let newLine = 0;
+  for (const line of lines) {
+    if (maxLines && lineCount >= maxLines) {
+      const remaining = lines.length - lineCount;
+      if (remaining > 0) {
+        output.push(dim(`  ... +${remaining} more lines`));
+      }
+      break;
+    }
+    if (line.startsWith("diff --git")) {
+      const filePath = extractFilePath(line);
+      output.push("");
+      output.push(bold(cyan(`── ${filePath} ──`)));
+      lineCount += 2;
+      continue;
+    }
+    if (line.startsWith("index ") || line.startsWith("---") || line.startsWith("+++")) {
+      continue;
+    }
+    if (line.startsWith("@@")) {
+      const match = line.match(/@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@(.*)/);
+      if (match) {
+        oldLine = Number.parseInt(match[1], 10);
+        newLine = Number.parseInt(match[2], 10);
+        const context = match[3] ?? "";
+        output.push(dim(`  ${line.slice(0, 60)}${context ? ` ${context.trim()}` : ""}`));
+        lineCount++;
+      }
+      continue;
+    }
+    if (line.startsWith("+")) {
+      const gutter = lineNumbers ? `${dim(padNum(newLine))} ` : "";
+      output.push(`${gutter}${green("+")} ${green(line.slice(1))}`);
+      newLine++;
+      lineCount++;
+      continue;
+    }
+    if (line.startsWith("-")) {
+      const gutter = lineNumbers ? `${dim(padNum(oldLine))} ` : "";
+      output.push(`${gutter}${red("-")} ${red(line.slice(1))}`);
+      oldLine++;
+      lineCount++;
+      continue;
+    }
+    if (line.startsWith(" ")) {
+      const gutter = lineNumbers ? `${dim(padNum(newLine))} ` : "";
+      output.push(`${gutter}${dim("|")} ${dim(line.slice(1))}`);
+      oldLine++;
+      newLine++;
+      lineCount++;
+      continue;
+    }
+    if (line.trim()) {
+      output.push(dim(`  ${line}`));
+      lineCount++;
+    }
+  }
+  return output;
+}
+function countDiffChanges(diff) {
+  const lines = diff.split(`
+`);
+  let additions = 0;
+  let deletions = 0;
+  let files = 0;
+  for (const line of lines) {
+    if (line.startsWith("diff --git"))
+      files++;
+    else if (line.startsWith("+") && !line.startsWith("+++"))
+      additions++;
+    else if (line.startsWith("-") && !line.startsWith("---"))
+      deletions++;
+  }
+  return { additions, deletions, files };
+}
+function extractFilePath(diffLine) {
+  const match = diffLine.match(/diff --git a\/(.+) b\//);
+  return match?.[1] ?? diffLine;
+}
+function padNum(n) {
+  return String(n).padStart(4);
+}
+var init_diff_renderer = __esm(() => {
+  init_terminal();
+});
+
 // src/repl/commands.ts
 import { execSync as execSync7 } from "node:child_process";
 function getSlashCommands() {
@@ -5431,12 +5526,30 @@ function cmdDiff(_args, ctx) {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
-    if (diff.trim()) {
-      process.stdout.write(diff);
-    } else {
+    if (!diff.trim()) {
       process.stderr.write(`${dim("No changes.")}
+`);
+      return;
+    }
+    const { additions, deletions, files } = countDiffChanges(diff);
+    const filesLabel = files === 1 ? "file" : "files";
+    process.stderr.write(`
+`);
+    process.stderr.write(`${bold("Changes:")}  ${cyan(`${files} ${filesLabel}`)}  ${green(`+${additions}`)}  ${red(`-${deletions}`)}
+`);
+    process.stderr.write(`${dim("─".repeat(60))}
+`);
+    const lines = renderDiff(diff);
+    for (const line of lines) {
+      process.stderr.write(`${line}
 `);
     }
+    process.stderr.write(`${dim("─".repeat(60))}
+`);
+    process.stderr.write(dim(`${yellow("tip:")} use ${cyan("/undo")} to revert all unstaged changes
+`));
+    process.stderr.write(`
+`);
   } catch {
     process.stderr.write(`${red("✗")} Could not get diff.
 `);
@@ -5476,6 +5589,7 @@ function cmdExit(_args, ctx) {
 }
 var init_commands = __esm(() => {
   init_ai_models();
+  init_diff_renderer();
   init_terminal();
 });
 
@@ -7384,7 +7498,9 @@ function ensureTaskCommit(projectRoot, issueNumber, issueTitle) {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
-    const message = `chore: complete #${issueNumber} - ${issueTitle}`;
+    const message = `chore: complete #${issueNumber} - ${issueTitle}
+
+Co-Authored-By: LocusAgent <agent@locusai.team>`;
     execSync12(`git commit -m ${JSON.stringify(message)}`, {
       cwd: projectRoot,
       encoding: "utf-8",
@@ -8416,6 +8532,7 @@ import {
   writeFileSync as writeFileSync8
 } from "node:fs";
 import { join as join16 } from "node:path";
+import { createInterface as createInterface2 } from "node:readline";
 function printHelp4() {
   process.stderr.write(`
 ${bold("locus discuss")} — AI-powered architectural discussions
@@ -8448,7 +8565,7 @@ function generateId() {
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 }
 async function discussCommand(projectRoot, args, flags = {}) {
-  if (args[0] === "help" || args.length === 0) {
+  if (args[0] === "help") {
     printHelp4();
     return;
   }
@@ -8462,6 +8579,14 @@ async function discussCommand(projectRoot, args, flags = {}) {
   if (subcommand === "delete") {
     return deleteDiscussion(projectRoot, args[1]);
   }
+  if (args.length === 0) {
+    const topic2 = await promptForTopic();
+    if (!topic2) {
+      printHelp4();
+      return;
+    }
+    return startDiscussion(projectRoot, topic2, flags);
+  }
   const topic = args.join(" ").trim();
   return startDiscussion(projectRoot, topic, flags);
 }
@@ -8541,6 +8666,21 @@ function deleteDiscussion(projectRoot, id) {
   process.stderr.write(`${green("✓")} Deleted discussion: ${match.replace(".md", "")}
 `);
 }
+async function promptForTopic() {
+  return new Promise((resolve2) => {
+    const rl = createInterface2({
+      input: process.stdin,
+      output: process.stderr,
+      terminal: true
+    });
+    process.stderr.write(`${bold("Discussion topic:")} `);
+    rl.once("line", (line) => {
+      rl.close();
+      resolve2(line.trim());
+    });
+    rl.once("close", () => resolve2(""));
+  });
+}
 async function startDiscussion(projectRoot, topic, flags) {
   const config = loadConfig(projectRoot);
   const timer = createTimer();
@@ -8630,23 +8770,236 @@ var init_discuss = __esm(() => {
   init_terminal();
 });
 
+// src/commands/artifacts.ts
+var exports_artifacts = {};
+__export(exports_artifacts, {
+  readArtifact: () => readArtifact,
+  listArtifacts: () => listArtifacts,
+  formatSize: () => formatSize,
+  formatDate: () => formatDate2,
+  artifactsCommand: () => artifactsCommand
+});
+import { existsSync as existsSync16, readdirSync as readdirSync8, readFileSync as readFileSync13, statSync as statSync4 } from "node:fs";
+import { join as join17 } from "node:path";
+function printHelp5() {
+  process.stderr.write(`
+${bold("locus artifacts")} — View and manage AI-generated artifacts
+
+${bold("Usage:")}
+  locus artifacts              ${dim("# List all artifacts")}
+  locus artifacts show <name>  ${dim("# Show artifact content")}
+  locus artifacts plan <name>  ${dim("# Convert artifact to a plan")}
+
+${bold("Examples:")}
+  locus artifacts
+  locus artifacts show reduce-cli-terminal-output
+  locus artifacts plan aws-instance-orchestration-prd
+
+${dim("Artifact names support partial matching.")}
+
+`);
+}
+function getArtifactsDir(projectRoot) {
+  return join17(projectRoot, ".locus", "artifacts");
+}
+function listArtifacts(projectRoot) {
+  const dir = getArtifactsDir(projectRoot);
+  if (!existsSync16(dir))
+    return [];
+  return readdirSync8(dir).filter((f) => f.endsWith(".md")).map((fileName) => {
+    const filePath = join17(dir, fileName);
+    const stat = statSync4(filePath);
+    return {
+      name: fileName.replace(/\.md$/, ""),
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    };
+  }).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+}
+function readArtifact(projectRoot, name) {
+  const dir = getArtifactsDir(projectRoot);
+  const fileName = name.endsWith(".md") ? name : `${name}.md`;
+  const filePath = join17(dir, fileName);
+  if (!existsSync16(filePath))
+    return null;
+  const stat = statSync4(filePath);
+  return {
+    content: readFileSync13(filePath, "utf-8"),
+    info: {
+      name: fileName.replace(/\.md$/, ""),
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    }
+  };
+}
+function formatSize(bytes) {
+  if (bytes < 1024)
+    return `${bytes}B`;
+  const kb = bytes / 1024;
+  if (kb < 1024)
+    return `${kb.toFixed(1)}KB`;
+  return `${(kb / 1024).toFixed(1)}MB`;
+}
+function formatDate2(date) {
+  return date.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+async function artifactsCommand(projectRoot, args) {
+  if (args[0] === "help") {
+    printHelp5();
+    return;
+  }
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "show":
+    case "view": {
+      const name = args.slice(1).join(" ").trim();
+      if (!name) {
+        process.stderr.write(`${red("✗")} Please provide an artifact name.
+`);
+        process.stderr.write(`  Usage: ${bold("locus artifacts show <name>")}
+`);
+        return;
+      }
+      showArtifact(projectRoot, name);
+      break;
+    }
+    case "plan": {
+      const name = args.slice(1).join(" ").trim();
+      if (!name) {
+        process.stderr.write(`${red("✗")} Please provide an artifact name.
+`);
+        process.stderr.write(`  Usage: ${bold("locus artifacts plan <name>")}
+`);
+        return;
+      }
+      await convertToPlan(projectRoot, name);
+      break;
+    }
+    default:
+      listArtifactsCommand(projectRoot);
+      break;
+  }
+}
+function listArtifactsCommand(projectRoot) {
+  const artifacts = listArtifacts(projectRoot);
+  if (artifacts.length === 0) {
+    process.stderr.write(`${dim("No artifacts found.")}
+`);
+    return;
+  }
+  process.stderr.write(`
+${bold("Artifacts")} ${dim(`(${artifacts.length} total)`)}
+
+`);
+  for (let i = 0;i < artifacts.length; i++) {
+    const a = artifacts[i];
+    const idx = dim(`${String(i + 1).padStart(2)}.`);
+    process.stderr.write(`  ${idx} ${cyan(a.name)}
+`);
+    process.stderr.write(`      ${dim(`${formatDate2(a.createdAt)} • ${formatSize(a.size)}`)}
+`);
+  }
+  process.stderr.write(`
+  ${dim("Use")} ${bold("locus artifacts show <name>")} ${dim("to view content")}
+`);
+  process.stderr.write(`  ${dim("Use")} ${bold("locus artifacts plan <name>")} ${dim("to convert to a plan")}
+
+`);
+}
+function showArtifact(projectRoot, name) {
+  const result = readArtifact(projectRoot, name);
+  if (!result) {
+    const artifacts = listArtifacts(projectRoot);
+    const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (matches.length === 1) {
+      const match = readArtifact(projectRoot, matches[0].name);
+      if (match) {
+        printArtifact(match.info, match.content);
+        return;
+      }
+    }
+    if (matches.length > 1) {
+      process.stderr.write(`${red("✗")} Multiple artifacts match "${name}":
+`);
+      for (const m of matches) {
+        process.stderr.write(`  ${cyan(m.name)}
+`);
+      }
+      return;
+    }
+    process.stderr.write(`${red("✗")} Artifact "${name}" not found.
+`);
+    process.stderr.write(`  Run ${bold("locus artifacts")} to see available artifacts.
+`);
+    return;
+  }
+  printArtifact(result.info, result.content);
+}
+function printArtifact(info, content) {
+  const line = dim("─".repeat(50));
+  process.stderr.write(`
+${bold(info.name)}
+${dim(`${formatDate2(info.createdAt)} • ${formatSize(info.size)}`)}
+${line}
+
+`);
+  process.stdout.write(`${content}
+`);
+}
+async function convertToPlan(projectRoot, name) {
+  const result = readArtifact(projectRoot, name);
+  if (!result) {
+    const artifacts = listArtifacts(projectRoot);
+    const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (matches.length === 1) {
+      await runPlanConversion(projectRoot, matches[0].name);
+      return;
+    }
+    process.stderr.write(`${red("✗")} Artifact "${name}" not found.
+`);
+    process.stderr.write(`  Run ${bold("locus artifacts")} to see available artifacts.
+`);
+    return;
+  }
+  await runPlanConversion(projectRoot, result.info.name);
+}
+async function runPlanConversion(projectRoot, artifactName) {
+  const { execCommand: execCommand2 } = await Promise.resolve().then(() => (init_exec(), exports_exec));
+  process.stderr.write(`
+${bold("Converting artifact to plan:")} ${cyan(artifactName)}
+
+`);
+  await execCommand2(projectRoot, [`Create a plan according to ${artifactName}`], {});
+}
+var init_artifacts = __esm(() => {
+  init_terminal();
+});
+
 // src/cli.ts
 init_config();
 init_context();
 init_logger();
 init_rate_limiter();
 init_terminal();
-import { join as join17 } from "node:path";
-import { existsSync as existsSync16, readFileSync as readFileSync13 } from "node:fs";
+import { existsSync as existsSync17, readFileSync as readFileSync14 } from "node:fs";
+import { join as join18 } from "node:path";
 import { fileURLToPath } from "node:url";
 function getCliVersion() {
   const fallbackVersion = "0.0.0";
-  const packageJsonPath = join17(fileURLToPath(new URL(".", import.meta.url)), "..", "package.json");
-  if (!existsSync16(packageJsonPath)) {
+  const packageJsonPath = join18(fileURLToPath(new URL(".", import.meta.url)), "..", "package.json");
+  if (!existsSync17(packageJsonPath)) {
     return fallbackVersion;
   }
   try {
-    const parsed = JSON.parse(readFileSync13(packageJsonPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync14(packageJsonPath, "utf-8"));
     return parsed.version ?? fallbackVersion;
   } catch {
     return fallbackVersion;
@@ -8733,7 +9086,7 @@ function parseArgs(argv) {
   const args = positional.slice(1);
   return { command, args, flags };
 }
-function printHelp5() {
+function printHelp6() {
   process.stderr.write(`
 ${bold("Locus")} ${dim(`v${VERSION}`)} — GitHub-native AI engineering assistant
 
@@ -8750,6 +9103,7 @@ ${bold("Commands:")}
   ${cyan("review")}            AI-powered code review on PRs
   ${cyan("iterate")}           Re-execute tasks with PR feedback
   ${cyan("discuss")}           AI-powered architectural discussions
+  ${cyan("artifacts")}         View and manage AI-generated artifacts
   ${cyan("status")}            Dashboard view of current state
   ${cyan("config")}            View and manage settings
   ${cyan("logs")}              View, tail, and manage execution logs
@@ -8786,7 +9140,7 @@ async function main() {
     process.exit(0);
   }
   if (parsed.flags.help && !parsed.command) {
-    printHelp5();
+    printHelp6();
     process.exit(0);
   }
   const command = resolveAlias(parsed.command);
@@ -8797,7 +9151,7 @@ async function main() {
     try {
       const root = getGitRoot(cwd);
       if (isInitialized(root)) {
-        logDir = join17(root, ".locus", "logs");
+        logDir = join18(root, ".locus", "logs");
         getRateLimiter(root);
       }
     } catch {}
@@ -8818,7 +9172,7 @@ async function main() {
     printVersionNotice = startVersionCheck2(VERSION);
   }
   if (!command) {
-    printHelp5();
+    printHelp6();
     process.exit(0);
   }
   if (command === "init") {
@@ -8931,6 +9285,12 @@ async function main() {
       });
       break;
     }
+    case "artifacts": {
+      const { artifactsCommand: artifactsCommand2 } = await Promise.resolve().then(() => (init_artifacts(), exports_artifacts));
+      const artifactsArgs = parsed.flags.help ? ["help"] : parsed.args;
+      await artifactsCommand2(projectRoot, artifactsArgs);
+      break;
+    }
     case "upgrade": {
       const { upgradeCommand: upgradeCommand2 } = await Promise.resolve().then(() => (init_upgrade(), exports_upgrade));
       await upgradeCommand2(projectRoot, parsed.args, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.17.3",
+  "version": "0.17.5",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {