@locusai/cli 0.17.4 → 0.17.5

package/bin/locus.js

@@ -8532,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
@@ -8564,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;
   }
@@ -8578,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);
 }
@@ -8657,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();
@@ -8746,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 { existsSync as existsSync16, readFileSync as readFileSync13 } from "node:fs";
-import { join as join17 } from "node:path";
+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;
@@ -8849,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
 
@@ -8866,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
@@ -8902,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);
@@ -8913,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 {}
@@ -8934,7 +9172,7 @@ async function main() {
     printVersionNotice = startVersionCheck2(VERSION);
   }
   if (!command) {
-    printHelp5();
+    printHelp6();
     process.exit(0);
   }
   if (command === "init") {
@@ -9047,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.4",
+  "version": "0.17.5",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {