@axm.sh/cli 0.0.12 → 0.0.14

package/dist/src/cli-commands/packs/install/handler.js

@@ -0,0 +1,182 @@
+/**
+ * Install command handler - Effect-based orchestration for `axm packs install`.
+ *
+ * Packs are registry-only. Flow:
+ * 1. Parse source (must be registry)
+ * 2. Registry guard (ensure registry configured)
+ * 3. Fetch pack archive from registry
+ * 4. Extract to managed location
+ * 5. Read manifest to discover referenced extensions
+ * 6. Build cascading install plan (pack + referenced extensions)
+ * 7. Execute plan
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import { resolveSource, registryGuard, printSourceInput, SourceProviders, } from "../../../sources/index.js";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { makeCliError } from "../../../cli-error/index.js";
+import { Log, Spinner } from "../../../tui/index.js";
+import { Workspace } from "../../../workspace/index.js";
+import { PackManifestSchema } from "../../../extensions/packs/manifest-schema.js";
+import { buildInstallPlan } from "./build-plan.js";
+import { installPack } from "./install-pack.js";
+import { copySkillDirectory } from "../../skills/copy-skill-directory.js";
+import { REGISTRY_EXTENSIONS_DIR } from "../../skills/constants.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const PACK_MANIFEST_FILENAME = "axm-pack.json";
+// -----------------------------------------------------------------------------
+// Main Handler
+// -----------------------------------------------------------------------------
+/**
+ * Handles the `axm packs install` command.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const handleInstallPack = (args) => {
+    const scopeLabel = args.global ? "global" : "project";
+    return Effect.gen(function* () {
+        const ws = yield* Workspace;
+        const sources = yield* SourceProviders;
+        const log = yield* Log;
+        const spinnerSvc = yield* Spinner;
+        const path = yield* Path.Path;
+        const fs = yield* FileSystem.FileSystem;
+        yield* log.info(`axm packs install (${scopeLabel})`);
+        // Step 1: Parse source (must be registry)
+        const parseHandle = yield* spinnerSvc.start("Parsing source...");
+        const source = yield* resolveSource(args.source).pipe(Effect.mapError((error) => makeCliError({
+            code: "INVALID_SOURCE",
+            what: `Invalid source: ${error.message}`,
+            details: [`Provided: ${args.source || "(empty)"}`],
+            howToFix: "Packs must be installed from a registry. Use format: @scope/pack-name or @scope/pack-name@version",
+            cause: error,
+        })));
+        if (source.type !== "registry") {
+            yield* parseHandle.stop("Failed");
+            return yield* Effect.fail(makeCliError({
+                code: "PACK_SOURCE_NOT_REGISTRY",
+                what: "Packs can only be installed from a registry",
+                details: [`Provided source type: ${source.type}`],
+                howToFix: "Use a registry source: @scope/pack-name or @scope/pack-name@version",
+            }));
+        }
+        yield* parseHandle.stop(`Source: ${printSourceInput(source)} (registry)`);
+        // Step 2: Check if already installed (unless --force)
+        if (!args.force) {
+            const lockedPack = yield* ws.getLockedPack(source.name);
+            if (Option.isSome(lockedPack)) {
+                yield* log.warn(`Pack "${source.name}" is already installed. Use --force to overwrite.`);
+                yield* log.success("Nothing to install.");
+                return;
+            }
+        }
+        // Step 3: Registry guard
+        yield* registryGuard;
+        // Step 4: Discover and fetch pack from registry
+        const discoverHandle = yield* spinnerSvc.start("Fetching pack from registry...");
+        const findOptions = {
+            names: [source.name],
+            agents: [],
+            type: "pack",
+        };
+        const refs = yield* sources.resolveExtension(source, findOptions).pipe(Effect.mapError((error) => makeCliError({
+            code: "PACK_FETCH_FAILED",
+            what: `Failed to fetch pack from registry: ${error.message}`,
+            details: [`Pack: ${printSourceInput(source)}`],
+            howToFix: "Verify the pack name and registry configuration.",
+            cause: error,
+        })), Effect.tapError(() => discoverHandle.stop("Failed")));
+        if (refs.length === 0) {
+            yield* discoverHandle.stop("Not found");
+            return yield* Effect.fail(makeCliError({
+                code: "PACK_NOT_FOUND",
+                what: `Pack "${source.name}" not found in registry`,
+                howToFix: "Verify the pack name and check available packs.",
+            }));
+        }
+        // Fetch the pack archive
+        const packRef = refs[0];
+        const fetched = yield* sources.fetch(packRef).pipe(Effect.mapError((error) => makeCliError({
+            code: "PACK_FETCH_FAILED",
+            what: `Failed to download pack: ${error.message}`,
+            cause: error,
+        })), Effect.tapError(() => discoverHandle.stop("Failed")));
+        yield* discoverHandle.stop("Fetched pack");
+        // Step 5: Extract to managed location
+        const extractHandle = yield* spinnerSvc.start("Extracting pack...");
+        const base = path.dirname(ws.path);
+        const packDir = path.join(base, REGISTRY_EXTENSIONS_DIR, source.scope, "packs", source.name);
+        yield* copySkillDirectory(fetched.directory, packDir).pipe(Effect.mapError((e) => makeCliError({
+            code: "PACK_EXTRACT_FAILED",
+            what: `Failed to extract pack to ${packDir}`,
+            cause: e,
+        })), Effect.tapError(() => extractHandle.stop("Failed")));
+        yield* extractHandle.stop("Extracted");
+        // Step 6: Read manifest to discover referenced extensions
+        const manifestPath = path.join(packDir, PACK_MANIFEST_FILENAME);
+        const manifestExists = yield* fs
+            .exists(manifestPath)
+            .pipe(Effect.catchAll(() => Effect.succeed(false)));
+        if (!manifestExists) {
+            return yield* Effect.fail(makeCliError({
+                code: "PACK_MISSING_MANIFEST",
+                what: `Pack archive does not contain ${PACK_MANIFEST_FILENAME}`,
+                details: [`Expected at: ${manifestPath}`],
+                howToFix: "The pack archive may be corrupted. Try reinstalling.",
+            }));
+        }
+        const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((e) => makeCliError({
+            code: "PACK_MANIFEST_READ_FAILED",
+            what: `Failed to read pack manifest: ${manifestPath}`,
+            cause: e,
+        })));
+        const manifestJson = yield* Effect.try({
+            try: () => JSON.parse(manifestContent),
+            catch: (e) => makeCliError({
+                code: "PACK_MANIFEST_PARSE_FAILED",
+                what: "Failed to parse pack manifest JSON",
+                cause: e,
+            }),
+        });
+        const manifest = yield* Schema.decodeUnknown(PackManifestSchema)(manifestJson).pipe(Effect.mapError((e) => makeCliError({
+            code: "PACK_MANIFEST_PARSE_FAILED",
+            what: "Pack manifest is invalid",
+            details: [e.message],
+            cause: e,
+        })));
+        // Build resolved extension maps from manifest
+        const resolvedSkills = { ...(manifest.skills ?? {}) };
+        const resolvedCommands = { ...(manifest.commands ?? {}) };
+        const resolvedMcpServers = { ...(manifest["mcp-servers"] ?? {}) };
+        // Resolve version from pack ref
+        const resolvedVersion = Option.getOrElse(packRef.version, () => manifest.version);
+        // Step 7: Build install plan
+        const op = {
+            name: "install-pack",
+            args: {
+                packName: source.name,
+                scope: source.scope,
+                source: `registry:${source.scope}/${source.name}@${resolvedVersion}`,
+                resolvedVersion,
+                checksum: "",
+                sourceName: "default",
+                resolvedSkills,
+                resolvedCommands,
+                resolvedMcpServers,
+            },
+        };
+        const lockedPacks = yield* ws.getLockedPacks();
+        const lockedSkills = yield* ws.getLockedSkills();
+        const lockfile = { lockfileVersion: 1, skills: lockedSkills, packs: lockedPacks };
+        const plan = buildInstallPlan([op], lockfile, "Install pack", Option.some(`Install pack ${printSourceInput(source)}`));
+        yield* ws.resolvePlan(plan, { "install-pack": installPack });
+        yield* log.success("Done");
+    }).pipe(Effect.withSpan("InstallPack.handle"));
+};
+//# sourceMappingURL=handler.js.map

package/dist/src/cli-commands/packs/install/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/install/handler.ts"],"names":[],"mappings":"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"}

package/dist/src/cli-commands/packs/install/install-pack.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Install-pack operation handler.
+ *
+ * Writes pack metadata to settings and lockfile. The actual pack files
+ * are already extracted by the handler before plan execution.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { Log } from "../../../tui/index.js";
+import { Workspace } from "../../../workspace/service.js";
+import type { OperationHandler } from "../../../workspace/apply-plan.js";
+import type { InstallPackOperation } from "../operations.js";
+/**
+ * Install-pack operation handler.
+ *
+ * Records the pack in settings (source string) and lockfile (lock entry
+ * with resolved extensions). Pack files are already on disk by this point.
+ */
+export declare const installPack: OperationHandler<InstallPackOperation, Workspace | Log>;
+//# sourceMappingURL=install-pack.d.ts.map

package/dist/src/cli-commands/packs/install/install-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-pack.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/install/install-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,oBAAoB,EAAE,SAAS,GAAG,GAAG,CA2B5E,CAAC"}

package/dist/src/cli-commands/packs/install/install-pack.js

@@ -0,0 +1,42 @@
+/**
+ * Install-pack operation handler.
+ *
+ * Writes pack metadata to settings and lockfile. The actual pack files
+ * are already extracted by the handler before plan execution.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { Log } from "../../../tui/index.js";
+import { Workspace } from "../../../workspace/service.js";
+/**
+ * Install-pack operation handler.
+ *
+ * Records the pack in settings (source string) and lockfile (lock entry
+ * with resolved extensions). Pack files are already on disk by this point.
+ */
+export const installPack = (op) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const log = yield* Log;
+    const sourceString = `registry:${op.args.scope}/${op.args.packName}@${op.args.resolvedVersion}`;
+    yield* ws
+        .setPack(op.args.packName, sourceString, {
+        type: "registry",
+        scope: op.args.scope,
+        name: op.args.packName,
+        resolvedVersion: op.args.resolvedVersion,
+        checksum: op.args.checksum,
+        sourceName: op.args.sourceName,
+        installedAt: new Date(),
+        updatedAt: new Date(),
+        resolvedSkills: { ...op.args.resolvedSkills },
+        resolvedCommands: { ...op.args.resolvedCommands },
+        resolvedMcpServers: { ...op.args.resolvedMcpServers },
+    })
+        .pipe(Effect.catchAll((e) => log.warn(`Pack metadata update failed: ${String(e)}`)));
+    return {
+        result: "success",
+        message: `Installed pack ${op.args.packName}`,
+    };
+});
+//# sourceMappingURL=install-pack.js.map

package/dist/src/cli-commands/packs/install/install-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-pack.js","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/install/install-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAK1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAA4D,CAAC,EAAE,EAAE,EAAE,CACzF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC;IAEvB,MAAM,YAAY,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;IAEhG,KAAK,CAAC,CAAC,EAAE;SACN,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE;QACvC,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;QACpB,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ;QACtB,eAAe,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe;QACxC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ;QAC1B,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU;QAC9B,WAAW,EAAE,IAAI,IAAI,EAAE;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;QAC7C,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE;QACjD,kBAAkB,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE;KACtD,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvF,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,kBAAkB,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;KACpB,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/src/cli-commands/packs/new/command.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Packs new command yargs definition — wires handler to `axm packs new`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { CommandModule } from "yargs";
+export interface PacksNewCommandArgs {
+    name: string;
+    scope: string | undefined;
+    yes: boolean;
+    "non-interactive": boolean | undefined;
+}
+export declare const packsNewCommand: CommandModule<{}, PacksNewCommandArgs>;
+//# sourceMappingURL=command.d.ts.map

package/dist/src/cli-commands/packs/new/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/new/command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAK3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,iBAAiB,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAGD,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,EAAE,EAAE,mBAAmB,CA4ClE,CAAC"}

package/dist/src/cli-commands/packs/new/command.js

@@ -0,0 +1,51 @@
+/**
+ * Packs new command yargs definition — wires handler to `axm packs new`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Option from "effect/Option";
+import { run } from "../../../runtime/index.js";
+import { handlePacksNew } from "./handler.js";
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- yargs convention
+export const packsNewCommand = {
+    command: "new <name>",
+    describe: "Create a new empty extension pack",
+    builder: (yargs) => yargs
+        .positional("name", {
+        type: "string",
+        describe: "Name of the pack (without scope)",
+        demandOption: true,
+    })
+        .option("scope", {
+        type: "string",
+        describe: "Override the workspace scope (e.g., @acme)",
+    })
+        .option("yes", {
+        alias: "y",
+        type: "boolean",
+        describe: "Skip all confirmation prompts",
+        default: false,
+    })
+        .option("non-interactive", {
+        type: "boolean",
+        describe: "Disable all interactive prompts",
+    })
+        .example("$0 packs new frontend-tools", "Create @<scope>/frontend-tools")
+        .example("$0 packs new frontend-tools --scope @co", "Create @co/frontend-tools"),
+    handler: async (argv) => {
+        await run(handlePacksNew({
+            name: argv.name,
+            scope: Option.fromNullable(argv.scope),
+            yes: argv.yes,
+        }), {
+            workspace: {
+                global: false,
+                yes: argv.yes,
+                nonInteractive: Option.fromNullable(argv["non-interactive"]),
+                preview: false,
+                agents: Option.none(),
+            },
+        });
+    },
+};
+//# sourceMappingURL=command.js.map

package/dist/src/cli-commands/packs/new/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/new/command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAS9C,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,mCAAmC;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,UAAU,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,kCAAkC;QAC5C,YAAY,EAAE,IAAI;KACnB,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,4CAA4C;KACvD,CAAC;SACD,MAAM,CAAC,KAAK,EAAE;QACb,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,+BAA+B;QACzC,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,iBAAiB,EAAE;QACzB,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,iCAAiC;KAC5C,CAAC;SACD,OAAO,CAAC,6BAA6B,EAAE,gCAAgC,CAAC;SACxE,OAAO,CAAC,yCAAyC,EAAE,2BAA2B,CAAC;IACpF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,GAAG,CACP,cAAc,CAAC;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,EACF;YACE,SAAS,EAAE;gBACT,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC5D,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;aACtB;SACF,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/cli-commands/packs/new/handler.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Packs new handler — scaffolds a new empty pack with `axm-pack.json`.
+ *
+ * Creates the pack directory and manifest, then registers the pack in settings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { Log } from "../../../tui/index.js";
+import { Workspace } from "../../../workspace/index.js";
+export interface PacksNewHandlerArgs {
+    /** Name of the pack (without scope). */
+    readonly name: string;
+    /** Optional scope override. */
+    readonly scope: Option.Option<string>;
+    /** Skip confirmations. */
+    readonly yes: boolean;
+}
+export declare const handlePacksNew: (args: PacksNewHandlerArgs) => Effect.Effect<undefined, import("../../../cli-error/cli-error.js").CliError, Log | FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/src/cli-commands/packs/new/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/new/handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAcxD,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAMD,eAAO,MAAM,cAAc,GAAI,MAAM,mBAAmB,sIAoGX,CAAC"}

package/dist/src/cli-commands/packs/new/handler.js

@@ -0,0 +1,94 @@
+/**
+ * Packs new handler — scaffolds a new empty pack with `axm-pack.json`.
+ *
+ * Creates the pack directory and manifest, then registers the pack in settings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { makeCliError } from "../../../cli-error/index.js";
+import { Log } from "../../../tui/index.js";
+import { Workspace } from "../../../workspace/index.js";
+import { computePackPaths } from "../pack-paths.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+const PACK_MANIFEST_FILENAME = "axm-pack.json";
+// -----------------------------------------------------------------------------
+// Main Handler
+// -----------------------------------------------------------------------------
+export const handlePacksNew = (args) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const log = yield* Log;
+    yield* log.info("axm packs new");
+    // Resolve scope
+    const normalizeScope = (s) => (s.startsWith("@") ? s : `@${s}`);
+    const scope = Option.isSome(args.scope)
+        ? normalizeScope(args.scope.value)
+        : yield* ws.getConfiguredScope().pipe(Effect.flatMap((s) => s === "@community"
+            ? Effect.fail(makeCliError({
+                code: "SCOPE_REQUIRED",
+                what: "No scope configured for pack creation",
+                howToFix: "Configure a scope in settings.json with `axm init`, or use --scope",
+            }))
+            : Effect.succeed(s)));
+    const fqn = `${scope}/${args.name}`;
+    const base = path.dirname(ws.path);
+    // Compute pack directory path
+    const packDir = computePackPaths(path.join, base, scope, args.name);
+    const manifestPath = path.join(packDir.canonicalPath, PACK_MANIFEST_FILENAME);
+    // Check if pack already exists
+    const exists = yield* fs.exists(manifestPath).pipe(Effect.mapError((e) => makeCliError({
+        code: "PACK_CHECK_FAILED",
+        what: `Failed to check if pack exists: ${manifestPath}`,
+        cause: e,
+    })));
+    if (exists) {
+        return yield* makeCliError({
+            code: "PACK_ALREADY_EXISTS",
+            what: `Pack '${fqn}' already exists at ${packDir.canonicalPath}`,
+            howToFix: "Choose a different name or remove the existing pack first",
+        });
+    }
+    // Create pack directory
+    yield* fs.makeDirectory(packDir.canonicalPath, { recursive: true }).pipe(Effect.mapError((e) => makeCliError({
+        code: "PACK_CREATE_FAILED",
+        what: `Failed to create pack directory: ${packDir.canonicalPath}`,
+        cause: e,
+    })));
+    // Write manifest
+    const manifest = {
+        name: fqn,
+        version: "0.0.1",
+        skills: {},
+        commands: {},
+        "mcp-servers": {},
+    };
+    yield* fs.writeFileString(manifestPath, JSON.stringify(manifest, null, 2) + "\n").pipe(Effect.mapError((e) => makeCliError({
+        code: "PACK_CREATE_FAILED",
+        what: `Failed to write pack manifest: ${manifestPath}`,
+        cause: e,
+    })));
+    // Register in settings
+    const now = new Date();
+    yield* ws.setPack(args.name, fqn, {
+        type: "registry",
+        scope,
+        name: args.name,
+        resolvedVersion: "0.0.1",
+        checksum: "",
+        sourceName: "",
+        installedAt: now,
+        updatedAt: now,
+        resolvedSkills: {},
+        resolvedCommands: {},
+        resolvedMcpServers: {},
+    });
+    yield* log.success(`Created pack ${fqn}`);
+}).pipe(Effect.withSpan("PacksNew.handle"));
+//# sourceMappingURL=handler.js.map

package/dist/src/cli-commands/packs/new/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/cli-commands/packs/new/handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAe/C,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAyB,EAAE,EAAE,CAC1D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC;IAEvB,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAEjC,gBAAgB;IAChB,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QACrC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAClC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,IAAI,CACjC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACnB,CAAC,KAAK,YAAY;YAChB,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,YAAY,CAAC;gBACX,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,uCAAuC;gBAC7C,QAAQ,EAAE,oEAAoE;aAC/E,CAAC,CACH;YACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CACtB,CACF,CAAC;IAEN,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAEnC,8BAA8B;IAC9B,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IAE9E,+BAA+B;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAChD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,mCAAmC,YAAY,EAAE;QACvD,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,SAAS,GAAG,uBAAuB,OAAO,CAAC,aAAa,EAAE;YAChE,QAAQ,EAAE,2DAA2D;SACtE,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACtE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,oCAAoC,OAAO,CAAC,aAAa,EAAE;QACjE,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEF,iBAAiB;IACjB,MAAM,QAAQ,GAAiB;QAC7B,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,aAAa,EAAE,EAAE;KAClB,CAAC;IAEF,KAAK,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CACpF,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,kCAAkC,YAAY,EAAE;QACtD,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEF,uBAAuB;IACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE;QAChC,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,eAAe,EAAE,OAAO;QACxB,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,GAAG;QACd,cAAc,EAAE,EAAE;QAClB,gBAAgB,EAAE,EAAE;QACpB,kBAAkB,EAAE,EAAE;KACvB,CAAC,CAAC;IAEH,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC"}

package/dist/src/cli-commands/packs/operations.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Pack operation types and references.
+ *
+ * Shared across pack operations (install, uninstall, publish).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { Operation } from "../../workspace/plan.js";
+/**
+ * Args for the install-pack operation.
+ */
+export interface InstallPackOperationArgs {
+    /** Pack name (e.g., "my-pack") */
+    readonly packName: string;
+    /** Pack scope (e.g., "@acme") */
+    readonly scope: string;
+    /** Source string for settings (e.g., "registry:@acme/my-pack@^1.0.0") */
+    readonly source: string;
+    /** Exact resolved version */
+    readonly resolvedVersion: string;
+    /** Content hash */
+    readonly checksum: string;
+    /** Registry source name */
+    readonly sourceName: string;
+    /** Resolved skill FQNs to exact versions */
+    readonly resolvedSkills: Readonly<Record<string, string>>;
+    /** Resolved command FQNs to exact versions */
+    readonly resolvedCommands: Readonly<Record<string, string>>;
+    /** Resolved MCP server FQNs to exact versions */
+    readonly resolvedMcpServers: Readonly<Record<string, string>>;
+}
+/**
+ * Add a pack to the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type InstallPackOperation = Operation<"install-pack", InstallPackOperationArgs>;
+/**
+ * Args for the uninstall-pack operation.
+ */
+export interface UninstallPackOperationArgs {
+    /** Pack name to uninstall */
+    readonly packName: string;
+}
+/**
+ * Remove a pack from the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type UninstallPackOperation = Operation<"uninstall-pack", UninstallPackOperationArgs>;
+/**
+ * Args for the publish-pack operation.
+ */
+export interface PublishPackOperationArgs {
+    /** Extension identity in `@scope/name` format. */
+    readonly name: string;
+    /** Named source to publish to (e.g., "local"). */
+    readonly registryName: string;
+}
+/**
+ * Publish a pack to a registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PublishPackOperation = Operation<"publish-pack", PublishPackOperationArgs>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/src/cli-commands/packs/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../../src/cli-commands/packs/operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMzD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,iDAAiD;IACjD,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;AAMvF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,CAAC;AAM7F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC"}

package/dist/src/cli-commands/packs/operations.js

@@ -0,0 +1,10 @@
+/**
+ * Pack operation types and references.
+ *
+ * Shared across pack operations (install, uninstall, publish).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=operations.js.map

package/dist/src/cli-commands/packs/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../../src/cli-commands/packs/operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/cli-commands/packs/pack-paths.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Centralized pack path computation.
+ *
+ * Provides types and a pure function for computing pack directory paths.
+ * Packs are always registry-sourced, so there is no non-registry branch.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Computed path for an installed pack directory.
+ *
+ * `canonicalPath` = `<base>/.axm/extensions/<scope>/packs/<name>/`
+ *
+ * No `src/` subdirectory for packs.
+ */
+export interface PackDirPath {
+    readonly canonicalPath: string;
+}
+/**
+ * Pure function to compute pack directory path.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param scope - Pack scope (e.g., "@acme")
+ * @param name - Pack name for filesystem use
+ */
+export declare const computePackPaths: (join: (...paths: string[]) => string, base: string, scope: string, name: string) => PackDirPath;
+//# sourceMappingURL=pack-paths.d.ts.map

package/dist/src/cli-commands/packs/pack-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-paths.d.ts","sourceRoot":"","sources":["../../../../src/cli-commands/packs/pack-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EACpC,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,MAAM,MAAM,KACX,WAGF,CAAC"}

package/dist/src/cli-commands/packs/pack-paths.js

@@ -0,0 +1,22 @@
+/**
+ * Centralized pack path computation.
+ *
+ * Provides types and a pure function for computing pack directory paths.
+ * Packs are always registry-sourced, so there is no non-registry branch.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { REGISTRY_EXTENSIONS_DIR } from "../skills/constants.js";
+/**
+ * Pure function to compute pack directory path.
+ *
+ * @param join - Path join function (e.g., `path.join`)
+ * @param base - Workspace root (parent of `.axm`)
+ * @param scope - Pack scope (e.g., "@acme")
+ * @param name - Pack name for filesystem use
+ */
+export const computePackPaths = (join, base, scope, name) => {
+    const canonicalPath = join(base, REGISTRY_EXTENSIONS_DIR, scope, "packs", name);
+    return { canonicalPath };
+};
+//# sourceMappingURL=pack-paths.js.map

package/dist/src/cli-commands/packs/pack-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-paths.js","sourceRoot":"","sources":["../../../../src/cli-commands/packs/pack-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAajE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAoC,EACpC,IAAY,EACZ,KAAa,EACb,IAAY,EACC,EAAE;IACf,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAChF,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC,CAAC"}

package/dist/src/cli-commands/packs/publish/command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Publish command yargs definition -- wires handler to `axm packs publish`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { CommandModule } from "yargs";
+export interface PublishPackCommandArgs {
+    pack: string;
+    registry: string | undefined;
+    yes: boolean;
+    preview: boolean;
+    "non-interactive": boolean | undefined;
+}
+export declare const publishPackCommand: CommandModule<{}, PublishPackCommandArgs>;
+//# sourceMappingURL=command.d.ts.map