@aipm-registry/cli 0.1.2 → 0.1.5

package/README.md

@@ -38,6 +38,9 @@ Search the registry:
 aipm search sentry
 ```
 
+Search results include package version, supported targets, description,
+publisher identity when available, license, and package size.
+
 Update installed skills:
 
 ```bash
@@ -47,19 +50,23 @@ aipm update
 This package is bundled. Installing `@aipm-registry/cli` gives you the `aipm`
 command without needing to install any other AIPM npm packages manually.
 
-Publishing is currently approval-only:
+Publish a public skill:
 
 ```bash
-aipm publish init --name @team/review-helper
-aipm publish explain
+aipm publish init --name @team/review-helper --template code-review
+cd review-helper
+aipm publish explain # (optional)
 aipm publish add .
-aipm publish status
-aipm publish preview
-aipm publish validate
-aipm publish token --package @team/review-helper
+aipm publish status # (optional)
+aipm publish preview # (optional)
+aipm publish validate # (optional)
+aipm publish token --package @team/review-helper # (optional)
 AIPM_TOKEN=<5-minute-token> aipm publish push --yes
 ```
 
+Create an account on `https://aipm-registry.com`, create an org, reserve the
+package name, and generate the 5-minute token from the package dashboard.
+
 Use `.aipmignore` to exclude local-only files from publishing. AIPM also
 rejects common private key, env, Azure connection string, publish profile, and
 large package mistakes before upload.
@@ -67,9 +74,24 @@ large package mistakes before upload.
 Helpful publishing commands:
 
 ```bash
-aipm publish open --docs
-aipm publish open --package @team/review-helper
-aipm doctor --publish
+aipm publish init --name @team/issue-summary --template issue-summary
+aipm publish init --name @team/release-notes --template release-notes
+aipm publish open --docs # (optional)
+aipm publish open --package @team/review-helper # (optional)
+aipm doctor --publish # (optional)
+```
+
+Starter templates are `blank`, `code-review`, `issue-summary`, and
+`release-notes`. They only change the starter `SKILL.md`; you can edit every
+file before staging and publishing.
+
+If your AI tool already generated a skill or rule file, import it into an AIPM package folder:
+
+```bash
+aipm publish import ~/.codex/skills/review-helper --name @team/review-helper
+cd review-helper
+aipm publish add .
+aipm publish preview # (optional)
 ```
 
 The default registry API is `https://api.aipm-registry.com`. Use `--registry <url>`,

package/dist/bin.cjs

@@ -8360,7 +8360,7 @@ var DEFAULT_REGISTRY = "https://api.aipm-registry.com";
 var SITE_URL = "https://aipm-registry.com";
 var PUBLISH_DOC_URL = "https://aipm-registry.com/publish";
 var DASHBOARD_URL = "https://aipm-registry.com/dashboard";
-program2.name("aipm").description("AI package manager").version("0.1.2", "-v, --version", "output the current version").option("--verbose", "Print extra diagnostic output").option("--quiet", "Reduce non-essential output").addHelpText(
+program2.name("aipm").description("AI package manager").enablePositionalOptions().version("0.1.4", "-v, --version", "output the current version").option("--verbose", "Print extra diagnostic output").option("--quiet", "Reduce non-essential output").addHelpText(
   "after",
   `
 
@@ -8371,6 +8371,7 @@ Examples:
   $ aipm search sentry
   $ aipm add @scope/name@1.0.0 --target cursor --ci
   $ aipm publish init --name @org/skill
+  $ cd skill
   $ aipm publish add .
   $ AIPM_TOKEN=<token> aipm publish push
 `
@@ -8385,6 +8386,23 @@ function parsePackageArg(value) {
   if (!isValidScopeName(name)) throw new Error("Invalid @scope/name");
   return { name, version: match[2] };
 }
+function skillFolderName(name) {
+  const parsed = parsePackageArg(name);
+  const folder = parsed.name.split("/").pop();
+  if (!folder) throw new Error("Invalid @scope/name");
+  return folder;
+}
+async function writeStarterFile(path2, content) {
+  await (0, import_promises9.writeFile)(path2, content, { encoding: "utf8", flag: "wx" });
+}
+async function inferEntryFromSource(source, fallback) {
+  const sourceInfo = await (0, import_promises9.stat)(source);
+  if (sourceInfo.isFile()) return (0, import_node_path9.basename)(source);
+  if (!sourceInfo.isDirectory()) return fallback;
+  const entries = await (0, import_promises9.readdir)(source);
+  if (entries.includes(fallback)) return fallback;
+  return entries.find((entry) => entry.endsWith(".md")) ?? entries.find((entry) => entry.endsWith(".mdc")) ?? fallback;
+}
 async function latestVersionForPackage(registry, name) {
   const packages = await searchPackages(registry, name, 20);
   const exact = packages.find((pkg) => pkg.name === name);
@@ -8396,6 +8414,19 @@ function printPublishGuide(done, next) {
   console.log(`Next: ${next}`);
   console.log(`Guide: ${PUBLISH_DOC_URL}`);
 }
+function formatBytes(bytes) {
+  if (bytes === void 0 || !Number.isFinite(bytes) || bytes < 0) return null;
+  if (bytes < 1024) return `${bytes} B`;
+  const units = ["KB", "MB", "GB"];
+  let value = bytes / 1024;
+  let unit = units[0] ?? "KB";
+  for (const nextUnit of units.slice(1)) {
+    if (value < 1024) break;
+    value /= 1024;
+    unit = nextUnit;
+  }
+  return `${value.toFixed(value >= 10 ? 1 : 2)} ${unit}`;
+}
 function packageDashboardUrl(name) {
   if (!name) return DASHBOARD_URL;
   return `${DASHBOARD_URL}/packages/${name.replace(/^@/, "")}`;
@@ -8412,14 +8443,15 @@ function printPublishFlow() {
   console.log("AIPM publish flow");
   console.log("1. Create an account and organization in the dashboard.");
   console.log("2. Reserve a package name such as @team/review-helper.");
-  console.log("3. Create local skill files: aipm publish init --name @team/review-helper");
-  console.log("4. Edit SKILL.md and any files the skill needs.");
-  console.log("5. Stage files: aipm publish add .");
-  console.log("6. Review files: aipm publish status");
-  console.log("7. Preview package: aipm publish preview");
-  console.log("8. Validate package: aipm publish validate");
-  console.log("9. Generate a 5-minute token from the dashboard.");
-  console.log("10. Push: AIPM_TOKEN=<token> aipm publish push --yes");
+  console.log("3. Create a package folder: aipm publish init --name @team/review-helper");
+  console.log("4. Move into it: cd review-helper");
+  console.log("5. Edit SKILL.md and any files the skill needs.");
+  console.log("6. Stage files: aipm publish add .");
+  console.log("7. Review files: aipm publish status (optional)");
+  console.log("8. Preview package: aipm publish preview (optional)");
+  console.log("9. Validate package: aipm publish validate (optional)");
+  console.log("10. Open the dashboard token page: aipm publish token --package @team/review-helper (optional)");
+  console.log("11. Push: AIPM_TOKEN=<token> aipm publish push --yes");
   console.log(`Guide: ${PUBLISH_DOC_URL}`);
 }
 async function printPublishPreview(root, json) {
@@ -8472,30 +8504,99 @@ function parseTargets(value) {
   }
   return [...new Set(targets)];
 }
+var SKILL_TEMPLATES = {
+  blank: (name) => `# ${name}
+
+Describe what this skill does and how an AI assistant should use it.
+`,
+  "code-review": (name) => `# ${name}
+
+Use this skill to review code changes in this project.
+
+## Goal
+- Identify correctness, security, reliability, and maintainability issues.
+- Point to specific files or code when possible.
+- Prioritize actionable findings over broad style feedback.
+
+## Review checklist
+- Confirm the change matches the requested behavior.
+- Look for edge cases, missing validation, and risky assumptions.
+- Check whether tests cover the changed behavior.
+- Call out secrets, credentials, or private data if they appear in files.
+
+## Output
+Return findings first, ordered by severity. If there are no findings, say that clearly and mention any remaining test gaps.
+`,
+  "issue-summary": (name) => `# ${name}
+
+Use this skill to summarize product, support, or error-tracking issues for triage.
+
+## Goal
+- Turn raw issue notes into a concise engineering summary.
+- Separate known facts from guesses.
+- Identify owner, impact, urgency, and next debugging steps.
+
+## Inputs to look for
+- Error messages, stack traces, user reports, screenshots, logs, and recent deploys.
+- Reproduction steps and affected environments.
+
+## Output
+Include summary, impact, likely cause, evidence, open questions, and recommended next action.
+`,
+  "release-notes": (name) => `# ${name}
+
+Use this skill to draft release notes from project changes.
+
+## Goal
+- Explain what changed in user-facing language.
+- Separate features, fixes, operational notes, and breaking changes.
+- Keep internal implementation details out unless users need them.
+
+## Output
+Create a concise release note with sections for highlights, fixes, upgrade notes, and known issues.
+`
+};
+function parseSkillTemplate(value) {
+  if (value in SKILL_TEMPLATES) return value;
+  throw new Error(`Unknown template "${value}". Use one of: ${Object.keys(SKILL_TEMPLATES).join(", ")}`);
+}
 async function initSkill(opts) {
   if (!isValidScopeName(opts.name)) throw new Error("Invalid @scope/name");
-  const root = (0, import_node_process3.cwd)();
+  const root = opts.here ? (0, import_node_process3.cwd)() : (0, import_node_path9.resolve)((0, import_node_process3.cwd)(), opts.dir ?? skillFolderName(opts.name));
+  const cdTarget = opts.here ? null : opts.dir ?? skillFolderName(opts.name);
+  await (0, import_promises9.mkdir)(root, { recursive: true });
+  const source = opts.from ? (0, import_node_path9.resolve)(opts.from) : null;
+  const entry = source ? await inferEntryFromSource(source, opts.entry) : opts.entry;
   const manifest = {
     schemaVersion: "0.1",
     name: opts.name,
     version: opts.version,
     type: "skill",
     description: opts.description,
-    entry: opts.entry,
+    entry,
     targets: parseTargets(opts.targets),
     license: "Apache-2.0"
   };
   PackageManifestSchema.parse(manifest);
-  await (0, import_promises9.writeFile)((0, import_node_path9.join)(root, "aipm.manifest.json"), JSON.stringify(manifest, null, 2) + "\n", "utf8");
-  await (0, import_promises9.writeFile)(
-    (0, import_node_path9.join)(root, opts.entry),
-    `# ${opts.name}
-
-Describe what this skill does and how an AI assistant should use it.
-`,
-    "utf8"
-  );
-  await (0, import_promises9.writeFile)(
+  if (source) {
+    const sourceInfo = await (0, import_promises9.stat)(source);
+    if (sourceInfo.isDirectory()) {
+      await (0, import_promises9.cp)(source, root, { recursive: true, force: false, errorOnExist: true });
+    } else if (sourceInfo.isFile()) {
+      await (0, import_promises9.cp)(source, (0, import_node_path9.join)(root, (0, import_node_path9.basename)(source)), { force: false, errorOnExist: true });
+    } else {
+      throw new Error(`Unsupported source path: ${opts.from}`);
+    }
+  }
+  await writeStarterFile((0, import_node_path9.join)(root, "aipm.manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+  if (!opts.from) {
+    const template = parseSkillTemplate(opts.template ?? "blank");
+    await writeStarterFile(
+      (0, import_node_path9.join)(root, entry),
+      SKILL_TEMPLATES[template](opts.name)
+    );
+  }
+  await writeStarterFile(
     (0, import_node_path9.join)(root, ".aipmignore"),
     [
       "# Files that should never be published with this skill",
@@ -8512,14 +8613,13 @@ Describe what this skill does and how an AI assistant should use it.
       "*.p12",
       "*.publishsettings",
       ""
-    ].join("\n"),
-    "utf8"
+    ].join("\n")
   );
   await (0, import_promises9.mkdir)((0, import_node_path9.join)(root, ".aipm"), { recursive: true });
-  console.log(`Created ${opts.name} skill files.`);
+  console.log(`Created ${opts.name} skill folder: ${root}`);
   printPublishGuide(
-    `Created aipm.manifest.json, ${opts.entry}, .aipmignore, and the local publish state folder.`,
-    "Edit the skill files, then run aipm publish add ."
+    opts.from ? `Copied ${opts.from} into ${root} and created aipm.manifest.json, .aipmignore, and the local publish state folder.` : `Created ${root} with aipm.manifest.json, ${entry}, .aipmignore, and the local publish state folder.`,
+    cdTarget ? `Run cd ${cdTarget}, edit/review the files, then run aipm publish add .` : "Edit/review the files, then run aipm publish add ."
   );
 }
 program2.command("init").description("Create aipm.package.json in the current project").option("--registry <url>", "Default registry URL").action(async (opts) => {
@@ -8557,7 +8657,7 @@ program2.command("config").description("Show resolved AIPM CLI and project confi
   const lock = await readLockfile(root);
   const registry = resolveRegistryUrl(project, opts.registry, DEFAULT_REGISTRY);
   const data = {
-    cliVersion: "0.1.2",
+    cliVersion: "0.1.4",
     nodeVersion: process.versions.node,
     cwd: root,
     registry,
@@ -8620,6 +8720,9 @@ program2.command("search [query]").description("Search public registry packages"
   for (const pkg of packages) {
     console.log(`${pkg.name}@${pkg.version} [${pkg.targets.join(", ")}]`);
     if (pkg.description) console.log(`  ${pkg.description}`);
+    const publisher = pkg.publisher ? `${pkg.publisher.user.name ?? `@${pkg.publisher.user.githubLogin}`} in @${pkg.publisher.org.slug}` : "publisher unavailable";
+    const meta = [publisher, pkg.license ? `license ${pkg.license}` : null, formatBytes(pkg.sizeBytes)].filter(Boolean).join(" | ");
+    console.log(`  ${meta}`);
   }
 });
 program2.command("install").description("Install all packages from aipm.package.json").option("--registry <url>", "Registry base URL").option("--target <tool>", "cursor or claude").option("--ci", "Non-interactive").action(async (opts) => {
@@ -8640,7 +8743,7 @@ program2.command("install").description("Install all packages from aipm.package.
     });
   }
 });
-program2.command("skill").description("Create and manage local skill packages").command("init").description("Create aipm.manifest.json and SKILL.md").requiredOption("--name <name>", "Package name, e.g. @org/skill").option("--version <version>", "Initial version", "1.0.0").option("--description <description>", "Skill description", "AIPM skill").option("--targets <targets>", "Comma-separated targets", "cursor").option("--entry <entry>", "Entry file", "SKILL.md").action(
+program2.command("skill").description("Create and manage local skill packages").command("init").description("Create aipm.manifest.json and SKILL.md").requiredOption("--name <name>", "Package name, e.g. @org/skill").option("--version <version>", "Initial version", "1.0.0").option("--description <description>", "Skill description", "AIPM skill").option("--targets <targets>", "Comma-separated targets", "cursor").option("--entry <entry>", "Entry file", "SKILL.md").option("--template <template>", "Starter SKILL.md template: blank, code-review, issue-summary, release-notes", "blank").option("--dir <dir>", "Create files in this folder").option("--here", "Create files in the current folder instead of a skill-named folder").option("--from <path>", "Copy an existing AI-tool skill file or folder into the package folder").action(
   async (opts) => initSkill(opts)
 );
 var publish = program2.command("publish [dir]").description("Stage, validate, and publish a skill package").option("--registry <url>", "Registry base URL").option("--token <token>", "Publish token").action(async (dir, opts) => {
@@ -8662,7 +8765,10 @@ var publish = program2.command("publish [dir]").description("Stage, validate, an
     "Share the install command or open the package page to confirm the listing."
   );
 });
-publish.command("init").description("Alias for aipm skill init").requiredOption("--name <name>", "Package name, e.g. @org/skill").option("--version <version>", "Initial version", "1.0.0").option("--description <description>", "Skill description", "AIPM skill").option("--targets <targets>", "Comma-separated targets", "cursor").option("--entry <entry>", "Entry file", "SKILL.md").action(initSkill);
+publish.command("init").description("Alias for aipm skill init").requiredOption("--name <name>", "Package name, e.g. @org/skill").option("--version <version>", "Initial version", "1.0.0").option("--description <description>", "Skill description", "AIPM skill").option("--targets <targets>", "Comma-separated targets", "cursor").option("--entry <entry>", "Entry file", "SKILL.md").option("--template <template>", "Starter SKILL.md template: blank, code-review, issue-summary, release-notes", "blank").option("--dir <dir>", "Create files in this folder").option("--here", "Create files in the current folder instead of a skill-named folder").option("--from <path>", "Copy an existing AI-tool skill file or folder into the package folder").action(initSkill);
+publish.command("import <source>").description("Create a package folder from an existing AI-tool skill file or folder").requiredOption("--name <name>", "Package name, e.g. @org/skill").option("--version <version>", "Initial version", "1.0.0").option("--description <description>", "Skill description", "AIPM skill").option("--targets <targets>", "Comma-separated targets", "cursor").option("--entry <entry>", "Entry file", "SKILL.md").option("--dir <dir>", "Create files in this folder").option("--here", "Create files in the current folder instead of a skill-named folder").action(
+  async (source, opts) => initSkill({ ...opts, from: source })
+);
 publish.command("add [files...]").description("Stage files for publishing").action(async (files) => {
   const state = await addPublishFiles((0, import_node_process3.cwd)(), files);
   console.log(`Staged ${state.files.length} file${state.files.length === 1 ? "" : "s"}.`);