aemdm 0.1.3 → 0.2.3

package/README.md

@@ -189,36 +189,19 @@ aemdm search --raw-query @./query.json
 
 ## Publishing
 
-Before publishing a new release, verify the package contents and publish from the repo root:
+The repository includes a `/release` skill for Claude Code that automates the full release process:
 
-```bash
-npm test
-npm run pack:check
-npm publish
 ```
-
-`prepack` builds `dist/`, and `prepublishOnly` runs the test suite during `npm publish`.
-
-### Automated npm publish from GitHub
-
-The repository includes a GitHub Actions workflow that publishes to npm when you push a version tag like `v0.1.3` or publish a GitHub release for that tag.
-
-Required setup:
-
-```bash
-NPM_TOKEN
+/release patch   # 0.2.1 → 0.2.2
+/release minor   # 0.2.1 → 0.3.0
+/release major   # 0.2.1 → 1.0.0
 ```
 
-Add `NPM_TOKEN` as a GitHub repository secret with permission to publish the `aemdm` package on npm.
-
-Release flow:
+The skill bumps the version across all files, builds, tests, commits, pushes, creates a git tag, and creates a GitHub release.
 
-```bash
-git tag v0.1.3
-git push origin v0.1.3
-```
+Publishing to npm is triggered automatically when a GitHub release is created. The workflow uses npm trusted publishing (OIDC) via the `npm` GitHub environment — no token secret is needed.
 
-The workflow verifies that the tag matches the `version` field in `package.json`, runs `lint`, `build`, and `test`, and then publishes the package.
+The workflow verifies that the release tag matches the `version` field in `package.json`, runs `lint`, `build`, and `test`, and then publishes the package with provenance.
 
 ## References
 

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
 import { Command, CommanderError, Option } from "commander";
 import { z } from "zod";
 import { CliError, request, requestJson, resolveBucket, resolveOptionalImsToken, resolveSearchAuth, } from "./lib/client.js";
@@ -7,6 +8,11 @@ import { readProfileConfig, writeProfileConfig, } from "./lib/config.js";
 import { buildAssetUrl, buildMetadataUrl, deliveryFormatSchema, resolveDimensions, } from "./lib/delivery.js";
 import { buildSearchRequest, getAssetIdFromHit, loadRawQuery, } from "./lib/search.js";
 import { formatSearchResults, writeBinaryOutput, writeJson, writeLine, } from "./lib/output.js";
+function verbose(runtime, message) {
+    if (runtime.verbose) {
+        writeLine(runtime.stderr, `[verbose] ${message}`);
+    }
+}
 const numberOption = (flagName) => (value) => {
     const parsed = Number(value);
     if (!Number.isInteger(parsed)) {
@@ -163,6 +169,17 @@ async function handleAssetGet(assetId, options, runtime) {
     const baseUrl = resolveBucket(parsed.bucket, runtime.env, profile.bucket);
     const imsToken = resolveOptionalImsToken(parsed.imsToken, runtime.env);
     const dimensions = resolveDimensions(parsed.size, parsed.width, parsed.height);
+    verbose(runtime, `bucket: ${baseUrl}`);
+    verbose(runtime, `asset:  ${assetId}`);
+    if (imsToken)
+        verbose(runtime, `auth:   IMS token provided`);
+    if (dimensions.width || dimensions.height) {
+        verbose(runtime, `dimensions: ${dimensions.width ?? "auto"}x${dimensions.height ?? "auto"}`);
+    }
+    if (parsed.format)
+        verbose(runtime, `format: ${parsed.format}`);
+    if (parsed.quality)
+        verbose(runtime, `quality: ${parsed.quality}`);
     if (parsed.metadata) {
         const metadata = imsToken
             ? await requestJson(buildMetadataUrl(baseUrl, assetId), {
@@ -213,6 +230,18 @@ async function handleSearch(options, runtime) {
     const { imsToken, apiKey } = resolveSearchAuth(parsed.imsToken, parsed.apiKey, runtime.env);
     const searchBody = await buildSearchBody(parsed);
     const searchUrl = `${baseUrl}/search`;
+    verbose(runtime, `bucket:   ${baseUrl}`);
+    verbose(runtime, `search:   POST ${searchUrl}`);
+    verbose(runtime, `api-key:  ${apiKey}`);
+    verbose(runtime, `auth:     IMS token provided`);
+    if (parsed.text)
+        verbose(runtime, `text:     "${parsed.text}"`);
+    if (parsed.where.length > 0)
+        verbose(runtime, `where:    ${parsed.where.join(", ")}`);
+    if (parsed.limit !== undefined)
+        verbose(runtime, `limit:    ${parsed.limit}`);
+    if (parsed.rawQuery)
+        verbose(runtime, `raw-query: ${parsed.rawQuery}`);
     const response = await requestJson(searchUrl, {
         method: "POST",
         imsToken,
@@ -220,6 +249,9 @@ async function handleSearch(options, runtime) {
         jsonBody: searchBody,
         fetchImpl: runtime.fetchImpl,
     });
+    const resultCount = response.hits?.results?.length ?? 0;
+    const totalCount = response.search_metadata?.totalCount?.total;
+    verbose(runtime, `results:  ${resultCount} returned${totalCount !== undefined ? ` (${totalCount} total)` : ""}`);
     if (parsed.json) {
         writeJson(runtime.stdout, response);
         return;
@@ -315,13 +347,17 @@ function buildProgram(runtime) {
     program
         .name("aemdm")
         .description("CLI for Adobe Dynamic Media with OpenAPI")
-        .version("0.1.0")
+        .version("0.2.3")
         .showHelpAfterError()
+        .option("-v, --verbose", "Show additional diagnostic output")
         .configureOutput({
         writeOut: (text) => runtime.stdout.write(text),
         writeErr: (text) => runtime.stderr.write(text),
     })
-        .exitOverride();
+        .exitOverride()
+        .hook("preAction", () => {
+        runtime.verbose = program.opts().verbose === true;
+    });
     configureCommonDeliveryOptions(program.command("asset").description("Asset operations"))
         .command("get <assetId>")
         .description("Build a delivery URL, fetch metadata, or download a binary for an asset")
@@ -442,6 +478,7 @@ export async function runCli(argv, runtimeOverrides = {}) {
         stdout: process.stdout,
         stderr: process.stderr,
         fetchImpl: fetch,
+        verbose: false,
         ...runtimeOverrides,
     };
     try {
@@ -470,7 +507,7 @@ export async function runCli(argv, runtimeOverrides = {}) {
     }
 }
 const executedDirectly = process.argv[1] !== undefined &&
-    import.meta.url === pathToFileURL(process.argv[1]).href;
+    fileURLToPath(import.meta.url) === realpathSync(process.argv[1]);
 if (executedDirectly) {
     const exitCode = await runCli(process.argv.slice(2));
     process.exitCode = exitCode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aemdm",
-  "version": "0.1.3",
+  "version": "0.2.3",
   "description": "CLI for Adobe Dynamic Media with OpenAPI",
   "license": "Apache-2.0",
   "author": "Chris Pilsworth",