@elmundi/ship-cli 0.14.2 → 0.15.4

package/lib/commands/docs.mjs

@@ -1,90 +0,0 @@
-import { apiPost } from "../http.mjs";
-
-/**
- * Documentation files only: fetch markdown by repo path, retro feedback.
- * @param {{ baseUrl: string; json: boolean }} ctx
- * @param {string[]} args
- */
-export async function docsCommand(ctx, args) {
-  const [sub, ...rest] = args;
-  if (!sub || sub === "help") {
-    console.log(`Usage:
-  shipctl docs fetch <repo-relative-path>
-  shipctl docs feedback --title "..." --summary "..." [--recommendation "line"]... [--source-context "..."]
-
-Vector search:  shipctl search <query>
-Catalog bodies: shipctl pattern|tool|collection fetch <id>
-
-Global flags: --base-url URL  --json`);
-    return;
-  }
-
-  if (sub === "fetch") {
-    const p = rest.join(" ").trim();
-    if (!p) {
-      console.error("fetch: repo-relative path required (markdown/text under the Ship tree).");
-      process.exit(1);
-    }
-    const data = await apiPost(ctx.baseUrl, "/fetch", { path: p });
-    if (ctx.json) console.log(JSON.stringify(data, null, 2));
-    else {
-      const title = data.path ?? data.id ?? "document";
-      console.log(`# ${title}\n`);
-      console.log(data.content);
-    }
-    return;
-  }
-
-  if (sub === "feedback") {
-    const opts = parseFeedbackArgs(rest);
-    if (opts.title.length < 5 || opts.summary.length < 10) {
-      console.error("feedback: --title (min 5) and --summary (min 10) are required.");
-      process.exit(1);
-    }
-    const body = {
-      title: opts.title,
-      summary: opts.summary,
-      recommendations: opts.recommendations,
-      source_context: opts.sourceContext || null,
-    };
-    const data = await apiPost(ctx.baseUrl, "/feedback", body);
-    if (ctx.json) console.log(JSON.stringify(data, null, 2));
-    else {
-      console.log(`Created: ${data.issue_url} (#${data.issue_number})`);
-      if (data.redactions_applied) console.log(`Redactions applied: ${data.redactions_applied}`);
-    }
-    return;
-  }
-
-  console.error(`Unknown docs subcommand: ${sub}`);
-  process.exit(1);
-}
-
-/** @param {string[]} rest */
-function parseFeedbackArgs(rest) {
-  let title = "";
-  let summary = "";
-  /** @type {string[]} */
-  const recommendations = [];
-  let sourceContext = "";
-  for (let i = 0; i < rest.length; i++) {
-    const a = rest[i];
-    if (a === "--title" && rest[i + 1]) {
-      title = rest[++i];
-      continue;
-    }
-    if (a === "--summary" && rest[i + 1]) {
-      summary = rest[++i];
-      continue;
-    }
-    if (a === "--recommendation" && rest[i + 1]) {
-      recommendations.push(rest[++i]);
-      continue;
-    }
-    if (a === "--source-context" && rest[i + 1]) {
-      sourceContext = rest[++i];
-      continue;
-    }
-  }
-  return { title, summary, recommendations, sourceContext };
-}

package/lib/commands/kickoff.mjs

@@ -1,192 +0,0 @@
-/**
- * `shipctl kickoff` — print the markdown body of the `kickoff` pattern
- * (or another pattern id) for piping into the customer’s agent in CI.
- *
- * Resolution order for the methodology host:
- *   1. Global `--base-url` (methodology API root, same as `pattern fetch`).
- *   2. `.ship/config.yml` → `api.base_url` with `/api/methodology` appended
- *      when absent.
- *   3. `SHIP_API_BASE` / default public host.
- *
- * When the process cwd (or `--cwd`) is inside the Ship monorepo, we read
- * `artifacts/patterns/<id>/ARTIFACT.md` from disk so local dev matches prod.
- */
-
-import path from "node:path";
-import { fetchArtifact } from "../http.mjs";
-import { readConfig, findShipRoot } from "../config/io.mjs";
-import { resolveShipRepoRootForCatalog } from "../find-ship-root.mjs";
-import { readArtifactFile } from "../artifacts/fs-index.mjs";
-
-function printKickoffHelp() {
-  console.log(`shipctl kickoff — print a pattern body for piping into your agent (CI).
-
-USAGE
-  shipctl kickoff [--pattern <id>] [--version <semver>] [--raw] [--json] [--cwd <dir>]
-
-DEFAULTS
-  --pattern common-kickoff
-
-FLAGS
-  --pattern   Catalog pattern id (folder under artifacts/patterns/).
-  --version   Optional pinned version (POST /fetch).
-  --raw       Print the full ARTIFACT.md including YAML front matter.
-  --json      Emit { pattern_id, body, agent_provider? } JSON.
-  --cwd       Repo root to find .ship/config.yml (default: search upward).
-
-The default output is markdown body only (front matter stripped) on stdout.
-When .ship/config.yml sets stack.agent.provider, a one-line hint is written
-to stderr so logs show which agent the repo is wired for — unless --json.
-
-EXAMPLE (workflow step)
-  shipctl kickoff --pattern common-kickoff > kickoff.md
-  # …concatenate workload pattern + kickoff.md into your agent invocation…
-`);
-}
-
-function stripFrontmatter(full) {
-  if (!full || !full.startsWith("---\n")) return full;
-  const end = full.indexOf("\n---\n", 4);
-  if (end === -1) return full;
-  return full.slice(end + "\n---\n".length);
-}
-
-/** @param {string} methodologyBase */
-function resolveMethodologyBase(ctx, config) {
-  const fromFlag = ctx.baseUrl;
-  const raw = config?.api?.base_url;
-  if (typeof raw === "string" && raw.trim()) {
-    const u = raw.replace(/\/$/, "");
-    return u.includes("/api/methodology") ? u : `${u}/api/methodology`;
-  }
-  return fromFlag;
-}
-
-function parseKickoffArgs(rest) {
-  const out = {
-    patternId: "common-kickoff",
-    version: null,
-    raw: false,
-    json: false,
-    help: false,
-    cwd: process.cwd(),
-  };
-  const copy = [...rest];
-  while (copy.length) {
-    const a = copy[0];
-    if (a === "--help" || a === "-h") {
-      out.help = true;
-      copy.shift();
-      continue;
-    }
-    if (a === "--raw") {
-      out.raw = true;
-      copy.shift();
-      continue;
-    }
-    if (a === "--json") {
-      out.json = true;
-      copy.shift();
-      continue;
-    }
-    if (a === "--pattern" && copy[1]) {
-      copy.shift();
-      out.patternId = String(copy.shift());
-      continue;
-    }
-    if (a.startsWith("--pattern=")) {
-      out.patternId = a.slice("--pattern=".length);
-      copy.shift();
-      continue;
-    }
-    if (a === "--version" && copy[1]) {
-      copy.shift();
-      out.version = String(copy.shift());
-      continue;
-    }
-    if (a.startsWith("--version=")) {
-      out.version = a.slice("--version=".length);
-      copy.shift();
-      continue;
-    }
-    if (a === "--cwd" && copy[1]) {
-      copy.shift();
-      out.cwd = path.resolve(String(copy.shift()));
-      continue;
-    }
-    if (a.startsWith("--cwd=")) {
-      out.cwd = path.resolve(a.slice("--cwd=".length));
-      copy.shift();
-      continue;
-    }
-    console.error(`unknown argument: ${a}\nRun: shipctl kickoff --help`);
-    process.exit(2);
-  }
-  return out;
-}
-
-export async function kickoffCommand(ctx, rest) {
-  const args = parseKickoffArgs(rest);
-  if (args.help) {
-    printKickoffHelp();
-    return;
-  }
-
-  const ctx2 = ctx;
-
-  /** @type {object|null} */
-  let config = null;
-  const root = findShipRoot(args.cwd);
-  if (root) {
-    try {
-      config = readConfig(root).config;
-    } catch {
-      config = null;
-    }
-  }
-
-  const methodologyBase = resolveMethodologyBase(ctx2, config);
-  const agentProvider =
-    config?.stack?.agent && typeof config.stack.agent === "object"
-      ? config.stack.agent.provider
-      : null;
-
-  /** @type {string|undefined} */
-  let fullText;
-  const shipRepo = resolveShipRepoRootForCatalog();
-  if (shipRepo) {
-    const file = readArtifactFile(shipRepo, "pattern", args.patternId);
-    if (file) fullText = file.content;
-  }
-  if (fullText === undefined) {
-    const { content } = await fetchArtifact(
-      methodologyBase,
-      "pattern",
-      args.patternId,
-      args.version || undefined,
-    );
-    fullText = content;
-  }
-
-  const body = args.raw ? fullText : stripFrontmatter(fullText);
-
-  if (args.json) {
-    console.log(
-      JSON.stringify(
-        {
-          pattern_id: args.patternId,
-          body,
-          agent_provider: agentProvider || null,
-        },
-        null,
-        2,
-      ),
-    );
-    return;
-  }
-
-  if (agentProvider && typeof agentProvider === "string") {
-    console.error(`# ship: stack.agent.provider=${agentProvider}`);
-  }
-  process.stdout.write(body.endsWith("\n") ? body : `${body}\n`);
-}