@agentxm/client-core 0.1.6

package/dist/src/unstable/commands/operations/enable.js

@@ -0,0 +1,120 @@
+/**
+ * Enable command executor — re-renders command to agents for a previously disabled command.
+ *
+ * Two paths:
+ * - Lock entry present: full enable (re-render to agents + update lock + settings)
+ * - No lock entry: settings-only toggle (configured command with no lock backing)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+import { makeAppError } from "../../app-error/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR, computeSourceHash, } from "../../extensions/index.js";
+import { RenderedFilesMapSchema } from "../../extensions/rendered-files.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { readCommandContent, renderToAgents } from "./shared-command-helpers.js";
+const decodeRenderedFilesMap = Schema.decodeUnknownSync(RenderedFilesMapSchema);
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Enable-command operation handler.
+ *
+ * Lock-backed path:
+ * 1. Read lock entry, determine canonical path
+ * 2. Verify canonical directory exists
+ * 3. Read COMMAND.md and command.json
+ * 4. Render to all configured agents concurrently
+ * 5. Update lock entry with agents and renderedFiles
+ * 6. Update settings entry to set enabled: true
+ *
+ * Settings-only path (no lock entry):
+ * 1. Update settings entry to set enabled: true
+ */
+export const enableCommand = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const base = ws.baseDir;
+    // Check for lock entry to determine path
+    const lockEntryOption = yield* ws.getLockedCommand(op.args.commandName).pipe(Effect.mapError((e) => makeAppError({
+        code: "ENABLE_COMMAND_LOCKFILE_READ_FAILED",
+        what: `Failed to read lockfile: ${e.what}`,
+        cause: e,
+    })));
+    // Settings-only path: no lock entry, just toggle enabled flag
+    if (Option.isNone(lockEntryOption)) {
+        yield* ws
+            .updateCommandEntry(op.args.commandName, (entry) => ({
+            ...entry,
+            enabled: true,
+        }))
+            .pipe(Effect.catch(() => Effect.void));
+        return {
+            result: "success",
+            message: `Enabled ${op.args.commandName}`,
+        };
+    }
+    // Lock-backed path: full enable with re-rendering
+    const lockEntry = lockEntryOption.value;
+    // Determine canonical path from lock entry
+    let canonicalPath;
+    if (lockEntry.type === "registry") {
+        canonicalPath = path.join(base, REGISTRY_EXTENSIONS_DIR, lockEntry.owner, "commands", lockEntry.name);
+    }
+    else {
+        canonicalPath = path.join(base, EXTERNAL_EXTENSIONS_DIR, "commands", op.args.commandName);
+    }
+    const exists = yield* fs.exists(canonicalPath).pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!exists) {
+        return yield* makeAppError({
+            code: "ENABLE_COMMAND_MISSING_FILES",
+            what: `Command files for "${op.args.commandName}" not found at ${canonicalPath}`,
+            howToFix: "Try reinstalling the command with `axm commands install`",
+        });
+    }
+    // Read COMMAND.md and command.json
+    const { frontmatter, body, manifest } = yield* readCommandContent(canonicalPath, "ENABLE_COMMAND");
+    // Render to agents concurrently
+    const { successfulAgents, rawRenderedFiles } = yield* renderToAgents({
+        commandName: op.args.commandName,
+        frontmatter,
+        body,
+        manifest,
+        owner: "@community",
+        workspaceRoot: base,
+        force: false,
+    });
+    // Update lock entry with agents and renderedFiles
+    const now = new Date();
+    const sourceHash = computeSourceHash(body);
+    const renderedFiles = decodeRenderedFilesMap(rawRenderedFiles);
+    const updatedLockEntry = {
+        ...lockEntry,
+        agents: successfulAgents,
+        sourceHash,
+        renderedFiles,
+        updatedAt: now,
+    };
+    // Update lockfile only (preserve existing settings source)
+    yield* ws
+        .setCommandLock({ name: op.args.commandName, lockEntry: updatedLockEntry })
+        .pipe(Effect.catch(() => Effect.void));
+    // Update settings entry to enabled (collapsed to string form)
+    yield* ws
+        .updateCommandEntry(op.args.commandName, (entry) => ({
+        ...entry,
+        enabled: true,
+    }))
+        .pipe(Effect.catch(() => Effect.void));
+    return {
+        result: "success",
+        message: `Enabled ${op.args.commandName}`,
+    };
+});
+//# sourceMappingURL=enable.js.map

package/dist/src/unstable/commands/operations/enable.js.map

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

package/dist/src/unstable/commands/operations/install.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Install command executor — orchestrates the per-command installation pipeline.
+ *
+ * Supports all ref types (registry, git-hosted, local). After materialization,
+ * reads COMMAND.md and command.json, renders to all configured agents
+ * concurrently, and writes lockfile entries with agents, sourceHash, and
+ * renderedFiles.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import type { CommandExtensionRef } from "../refs.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+/**
+ * Args for the install-command operation.
+ */
+export type InstallCommandOperationArgs = {
+    readonly ref: CommandExtensionRef;
+    readonly force: boolean;
+    readonly versionConstraint: Option.Option<string>;
+    /** When true, write to lockfile only (skip settings). Used for pack dependencies. */
+    readonly skipSettings: Option.Option<boolean>;
+};
+/**
+ * Add a command to the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type InstallCommandOperation = Operation<"install-command", InstallCommandOperationArgs>;
+/**
+ * Install-command operation handler.
+ *
+ * Supports all ref types: registry, git-hosted, local.
+ * After materialization:
+ * 1. Reads COMMAND.md and command.json
+ * 2. Renders to all configured agents concurrently
+ * 3. Writes lockfile entries with agents, sourceHash, renderedFiles
+ */
+export declare const installCommand: (op: InstallCommandOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path | Workspace | CliRenderer | CodingAgentRepository>;
+//# sourceMappingURL=install.d.ts.map

package/dist/src/unstable/commands/operations/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGvE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAQjE,OAAO,KAAK,EACV,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAU9D;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC,iBAAiB,EAAE,2BAA2B,CAAC,CAAC;AAgMhG;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,CAC3B,EAAE,EAAE,uBAAuB,KACxB,MAAM,CAAC,MAAM,CAChB,aAAa,EACb,QAAQ,EACR,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,qBAAqB,CAyGjF,CAAC"}

package/dist/src/unstable/commands/operations/install.js

@@ -0,0 +1,235 @@
+/**
+ * Install command executor — orchestrates the per-command installation pipeline.
+ *
+ * Supports all ref types (registry, git-hosted, local). After materialization,
+ * reads COMMAND.md and command.json, renders to all configured agents
+ * concurrently, and writes lockfile entries with agents, sourceHash, and
+ * renderedFiles.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { CliRenderer } from "../../cli-renderer/index.js";
+import { computeIntegrity, isPathSafe, stripFileProtocol } from "../../utils/index.js";
+import { makeAppError } from "../../app-error/index.js";
+import { validateExactResolvedVersion } from "../../lockfile/index.js";
+import { createRegistryClient, extractZip } from "../../registry/index.js";
+import { Workspace } from "../../workspace/service-interface.js";
+import { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR, computeSourceHash, } from "../../extensions/index.js";
+import { RenderedFilesMapSchema } from "../../extensions/rendered-files.js";
+import { copyExtensionDirectory, validatePathSafety } from "../../extensions/utils.js";
+import { CodingAgentRepository } from "../../agents/index.js";
+import { buildLockEntryFromRef } from "../manager.js";
+import { readCommandContent, renderToAgents } from "./shared-command-helpers.js";
+const decodeRenderedFilesMap = Schema.decodeUnknownSync(RenderedFilesMapSchema);
+// -----------------------------------------------------------------------------
+// Registry install
+// -----------------------------------------------------------------------------
+const installFromRegistry = (ref) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const canonicalPath = path.join(ws.baseDir, REGISTRY_EXTENSIONS_DIR, ref.owner, "commands", ref.name);
+    if (!isPathSafe(ws.baseDir, canonicalPath)) {
+        return yield* makeAppError({
+            code: "INSTALL_COMMAND_PATH_TRAVERSAL",
+            what: `Path traversal detected: ${canonicalPath}`,
+        });
+    }
+    // Empty integrity with existing canonical → skip fetch (synthetic refs from fork/publish)
+    const canonicalExists = yield* fs.exists(canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "INSTALL_COMMAND_PATH_CHECK_FAILED",
+        what: `Failed to check if canonical path exists: ${canonicalPath}`,
+        cause: e,
+    })));
+    const useExisting = Option.isNone(ref.integrity) && canonicalExists;
+    if (!useExisting) {
+        const locationStr = ref.source.location.protocol === "file:"
+            ? ref.source.location.pathname
+            : ref.source.location.href;
+        const client = yield* createRegistryClient(locationStr);
+        const { archive } = yield* client.getExtensionPackage({
+            owner: ref.owner,
+            type: "command",
+            name: ref.name,
+            version: Option.some(ref.version),
+        });
+        if (Option.isSome(ref.integrity)) {
+            const actualIntegrity = yield* computeIntegrity(archive);
+            if (actualIntegrity !== ref.integrity.value) {
+                return yield* makeAppError({
+                    code: "INSTALL_COMMAND_INTEGRITY_MISMATCH",
+                    what: `Integrity mismatch for ${ref.name}@${ref.version}`,
+                    details: [`Expected ${ref.integrity.value}, got ${actualIntegrity}`],
+                });
+            }
+        }
+        const tmpDir = yield* fs.makeTempDirectory().pipe(Effect.mapError((e) => makeAppError({
+            code: "INSTALL_COMMAND_TEMP_DIR_FAILED",
+            what: `Failed to create temporary directory for registry install`,
+            cause: e,
+        })));
+        yield* Effect.ensuring(Effect.gen(function* () {
+            yield* extractZip(archive, tmpDir);
+            // Remove existing canonical and copy fresh
+            yield* fs.remove(canonicalPath, { recursive: true }).pipe(Effect.ignore);
+            yield* fs.makeDirectory(canonicalPath, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+                code: "INSTALL_COMMAND_COPY_FAILED",
+                what: `Failed to create canonical directory: ${canonicalPath}`,
+                cause: e,
+            })));
+            // Copy extracted files to canonical
+            const entries = yield* fs.readDirectory(tmpDir).pipe(Effect.mapError((e) => makeAppError({
+                code: "INSTALL_COMMAND_COPY_FAILED",
+                what: `Failed to read extracted directory`,
+                cause: e,
+            })));
+            yield* Effect.forEach(entries, (entry) => {
+                const src = path.join(tmpDir, entry);
+                const dest = path.join(canonicalPath, entry);
+                return fs.copy(src, dest).pipe(Effect.ignore);
+            }, { concurrency: "unbounded" });
+        }), fs.remove(tmpDir, { recursive: true }).pipe(Effect.ignore));
+    }
+    return canonicalPath;
+});
+// --- Git-hosted install ---
+const installFromGitHosted = (ref) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const canonicalPath = path.join(ws.baseDir, EXTERNAL_EXTENSIONS_DIR, "commands", ref.command.name);
+    yield* validatePathSafety(ws.baseDir, canonicalPath, "INSTALL_COMMAND_PATH_TRAVERSAL");
+    const sourcePath = stripFileProtocol(ref.location);
+    yield* fs.remove(canonicalPath, { recursive: true }).pipe(Effect.ignore);
+    yield* copyExtensionDirectory(sourcePath, canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+        code: "INSTALL_COMMAND_COPY_FAILED",
+        what: `Failed to copy command files to ${canonicalPath}`,
+        cause: e,
+    })));
+    return canonicalPath;
+});
+// --- Local install ---
+const installFromLocal = (ref) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const ws = yield* Workspace;
+    const canonicalPath = path.join(ws.baseDir, EXTERNAL_EXTENSIONS_DIR, "commands", ref.command.name);
+    yield* validatePathSafety(ws.baseDir, canonicalPath, "INSTALL_COMMAND_PATH_TRAVERSAL");
+    const sourcePath = stripFileProtocol(ref.location);
+    const isSelfCopy = path.resolve(sourcePath) === path.resolve(canonicalPath);
+    if (!isSelfCopy) {
+        const fs = yield* FileSystem.FileSystem;
+        yield* fs.remove(canonicalPath, { recursive: true }).pipe(Effect.ignore);
+        yield* copyExtensionDirectory(sourcePath, canonicalPath).pipe(Effect.mapError((e) => makeAppError({
+            code: "INSTALL_COMMAND_COPY_FAILED",
+            what: `Failed to copy command files to ${canonicalPath}`,
+            cause: e,
+        })));
+    }
+    return canonicalPath;
+});
+// --- Materialization dispatcher ---
+const materializeCommand = (ref) => {
+    switch (ref.refType) {
+        case "registry":
+            return installFromRegistry(ref);
+        case "git-hosted":
+            return installFromGitHosted(ref);
+        case "local":
+            return installFromLocal(ref);
+    }
+};
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * Install-command operation handler.
+ *
+ * Supports all ref types: registry, git-hosted, local.
+ * After materialization:
+ * 1. Reads COMMAND.md and command.json
+ * 2. Renders to all configured agents concurrently
+ * 3. Writes lockfile entries with agents, sourceHash, renderedFiles
+ */
+export const installCommand = (op) => Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const renderer = yield* CliRenderer;
+    const { ref } = op.args;
+    // --- Materialize ---
+    const canonicalPath = yield* materializeCommand(ref);
+    // --- Read command content ---
+    const { frontmatter, body, manifest } = yield* readCommandContent(canonicalPath, "INSTALL_COMMAND");
+    // --- Render to agents concurrently ---
+    const { outcomes, successfulAgents, rawRenderedFiles } = yield* renderToAgents({
+        commandName: ref.command.name,
+        frontmatter,
+        body,
+        manifest,
+        owner: ref.refType === "registry" ? ref.owner : "@community",
+        workspaceRoot: ws.baseDir,
+        force: op.args.force,
+    });
+    // --- Report lossy rendering warnings grouped by agent ---
+    const warningsByAgent = Object.fromEntries(outcomes
+        .map(({ agentId, outcome, warnings }) => {
+        const agentWarnings = [
+            ...(outcome._tag === "success" ? Array.from(outcome.warnings) : []),
+            ...(outcome._tag === "conflict" ? [`conflict - ${outcome.reason}`] : []),
+            ...warnings
+                .filter((w) => w.feature && w.message)
+                .map((w) => `${w.feature} - ${w.message}`),
+        ];
+        return [agentId, agentWarnings];
+    })
+        .filter(([, ws]) => ws.length > 0));
+    const agentIds = Object.keys(warningsByAgent);
+    if (agentIds.length > 0) {
+        const grouped = agentIds
+            .map((id) => {
+            const agentWarnings = warningsByAgent[id] ?? [];
+            return `  ${id}:\n${agentWarnings.map((w) => `    - ${w}`).join("\n")}`;
+        })
+            .join("\n");
+        yield* renderer.warn(`Rendering warnings:\n${grouped}`);
+    }
+    // --- Compute source hash ---
+    const sourceHash = computeSourceHash(body);
+    // --- Validate version before building lock entry (registry only) ---
+    if (ref.refType === "registry") {
+        yield* validateExactResolvedVersion(`commands.${ref.command.name}.resolvedVersion`, ref.version);
+    }
+    // --- Build lock entry with agents, sourceHash, renderedFiles ---
+    const now = new Date();
+    const baseLockEntry = buildLockEntryFromRef(ref, now);
+    const renderedFiles = decodeRenderedFilesMap(rawRenderedFiles);
+    const lockEntry = {
+        ...baseLockEntry,
+        agents: successfulAgents,
+        sourceHash,
+        renderedFiles,
+    };
+    const writeEffect = Option.getOrElse(op.args.skipSettings, () => false)
+        ? ws.setCommandLock({ name: ref.command.name, lockEntry })
+        : ws.setCommand({ name: ref.command.name, lockEntry });
+    const writeSucceeded = yield* writeEffect.pipe(Effect.as(true), Effect.tapError((e) => Effect.logWarning("Command write failed", { error: e })), Effect.catch((e) => renderer.warn(`Command update failed (${e.code}): ${e.what}`).pipe(Effect.as(false))));
+    if (!writeSucceeded) {
+        return {
+            result: "error",
+            message: `Installed ${ref.command.name} but failed to write workspace state`,
+            error: makeAppError({
+                code: "INSTALL_COMMAND_WRITE_FAILED",
+                what: `Installed ${ref.command.name} but failed to persist lockfile/settings`,
+                howToFix: "Try running the install again",
+            }),
+        };
+    }
+    return {
+        result: "success",
+        message: `Installed ${ref.command.name}`,
+    };
+});
+//# sourceMappingURL=install.js.map

package/dist/src/unstable/commands/operations/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAiB,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAEjF,MAAM,sBAAsB,GAAG,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;AAwBhF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,mBAAmB,GAAG,CAAC,GAAuB,EAAE,EAAE,CACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAC7B,EAAE,CAAC,OAAO,EACV,uBAAuB,EACvB,GAAG,CAAC,KAAK,EACT,UAAU,EACV,GAAG,CAAC,IAAI,CACT,CAAC;IAEF,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,gCAAgC;YACtC,IAAI,EAAE,4BAA4B,aAAa,EAAE;SAClD,CAAC,CAAC;IACL,CAAC;IAED,0FAA0F;IAC1F,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAC1D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,mCAAmC;QACzC,IAAI,EAAE,6CAA6C,aAAa,EAAE;QAClE,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC;IAEpE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,WAAW,GACf,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,OAAO;YACtC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACpD,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,eAAe,KAAK,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC5C,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;oBACzB,IAAI,EAAE,oCAAoC;oBAC1C,IAAI,EAAE,0BAA0B,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE;oBACzD,OAAO,EAAE,CAAC,YAAY,GAAG,CAAC,SAAS,CAAC,KAAK,SAAS,eAAe,EAAE,CAAC;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;YACX,IAAI,EAAE,iCAAiC;YACvC,IAAI,EAAE,2DAA2D;YACjE,KAAK,EAAE,CAAC;SACT,CAAC,CACH,CACF,CAAC;QACF,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CACpB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACnC,2CAA2C;YAC3C,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzE,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC9D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;gBACX,IAAI,EAAE,6BAA6B;gBACnC,IAAI,EAAE,yCAAyC,aAAa,EAAE;gBAC9D,KAAK,EAAE,CAAC;aACT,CAAC,CACH,CACF,CAAC;YACF,oCAAoC;YACpC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAClD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;gBACX,IAAI,EAAE,6BAA6B;gBACnC,IAAI,EAAE,oCAAoC;gBAC1C,KAAK,EAAE,CAAC;aACT,CAAC,CACH,CACF,CAAC;YACF,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,OAAO,EACP,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;gBAC7C,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChD,CAAC,EACD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;QACJ,CAAC,CAAC,EACF,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC,CAAC;AAEL,6BAA6B;AAC7B,MAAM,oBAAoB,GAAG,CAAC,GAAwB,EAAE,EAAE,CACxD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAC7B,EAAE,CAAC,OAAO,EACV,uBAAuB,EACvB,UAAU,EACV,GAAG,CAAC,OAAO,CAAC,IAAI,CACjB,CAAC;IACF,KAAK,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,gCAAgC,CAAC,CAAC;IAEvF,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzE,KAAK,CAAC,CAAC,sBAAsB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,6BAA6B;QACnC,IAAI,EAAE,mCAAmC,aAAa,EAAE;QACxD,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEF,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC,CAAC;AAEL,wBAAwB;AACxB,MAAM,gBAAgB,GAAG,CAAC,GAAoB,EAAE,EAAE,CAChD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAC7B,EAAE,CAAC,OAAO,EACV,uBAAuB,EACvB,UAAU,EACV,GAAG,CAAC,OAAO,CAAC,IAAI,CACjB,CAAC;IACF,KAAK,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,gCAAgC,CAAC,CAAC;IAEvF,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QACxC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzE,KAAK,CAAC,CAAC,sBAAsB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;YACX,IAAI,EAAE,6BAA6B;YACnC,IAAI,EAAE,mCAAmC,aAAa,EAAE;YACxD,KAAK,EAAE,CAAC;SACT,CAAC,CACH,CACF,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC,CAAC;AAEL,qCAAqC;AACrC,MAAM,kBAAkB,GAAG,CAAC,GAAwB,EAAE,EAAE;IACtD,QAAQ,GAAG,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAClC,KAAK,YAAY;YACf,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAEF,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAMvB,CAAC,EAAE,EAAE,EAAE,CACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;IACpC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;IAExB,sBAAsB;IACtB,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAErD,+BAA+B;IAC/B,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAC/D,aAAa,EACb,iBAAiB,CAClB,CAAC;IAEF,wCAAwC;IACxC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;QAC7E,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;QAC7B,WAAW;QACX,IAAI;QACJ,QAAQ;QACR,KAAK,EAAE,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY;QAC5D,aAAa,EAAE,EAAE,CAAC,OAAO;QACzB,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,2DAA2D;IAC3D,MAAM,eAAe,GAAkC,MAAM,CAAC,WAAW,CACvE,QAAQ;SACL,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QACtC,MAAM,aAAa,GAAkB;YACnC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,QAAQ;iBACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC;iBACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;SAC7C,CAAC;QACF,OAAO,CAAC,OAAO,EAAE,aAAa,CAAU,CAAC;IAC3C,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CACrC,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,QAAQ;aACrB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACV,MAAM,aAAa,GAAG,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAChD,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1E,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,8BAA8B;IAC9B,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE3C,sEAAsE;IACtE,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC/B,KAAK,CAAC,CAAC,4BAA4B,CACjC,YAAY,GAAG,CAAC,OAAO,CAAC,IAAI,kBAAkB,EAC9C,GAAG,CAAC,OAAO,CACZ,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,aAAa,GAAG,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEtD,MAAM,aAAa,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAE/D,MAAM,SAAS,GAAqB;QAClC,GAAG,aAAa;QAChB,MAAM,EAAE,gBAAgB;QACxB,UAAU;QACV,aAAa;KACd,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC;QACrE,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1D,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,CAC5C,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EACf,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/E,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACjB,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CACrF,CACF,CAAC;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,sCAAsC;YAC5E,KAAK,EAAE,YAAY,CAAC;gBAClB,IAAI,EAAE,8BAA8B;gBACpC,IAAI,EAAE,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,0CAA0C;gBAC7E,QAAQ,EAAE,+BAA+B;aAC1C,CAAC;SACqB,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;KACjB,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/src/unstable/commands/operations/new-command.d.ts

@@ -0,0 +1,38 @@
+/**
+ * New command operation -- scaffolds a new command directory with manifest and COMMAND.md.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { Handle } from "../../extensions/handle.js";
+import type { OperationHandler } from "../../workspace/apply-plan.js";
+import type { Operation } from "../../workspace/plan.js";
+/**
+ * Args for the new-command operation.
+ */
+export interface NewCommandOperationArgs {
+    /** Command name (validated, lowercase with hyphens). */
+    readonly name: string;
+    /** Profile (e.g., "@myorg"). */
+    readonly owner: Handle;
+    /** Description for the command. */
+    readonly description: string;
+}
+/**
+ * Scaffold a new command in the workspace.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type NewCommandOperation = Operation<"new-command", NewCommandOperationArgs>;
+/**
+ * New-command operation handler.
+ *
+ * 1. Compute managed extension directory path
+ * 2. Check if directory already exists
+ * 3. Create the managed extension + src directories
+ * 4. Write command.json manifest
+ * 5. Write starter COMMAND.md in src/
+ */
+export declare const newCommand: OperationHandler<NewCommandOperation, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=new-command.d.ts.map

package/dist/src/unstable/commands/operations/new-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-command.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/new-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAIpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAazD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;AAqBpF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,gBAAgB,CACvC,mBAAmB,EACnB,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAkF/B,CAAC"}

package/dist/src/unstable/commands/operations/new-command.js

@@ -0,0 +1,87 @@
+/**
+ * New command operation -- scaffolds a new command directory with manifest and COMMAND.md.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../../app-error/index.js";
+import { decodeExtensionNameSync, REGISTRY_EXTENSIONS_DIR } from "../../extensions/index.js";
+import { COMMAND_MANIFEST_FILENAME, COMMAND_MANIFEST_SCHEMA_URL, } from "../manifest-schema.js";
+import { decodeExactSemverVersionSync } from "../../version-constraints/version-constraints.js";
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+const makeCommandMd = (name, description) => `---
+name: ${name}
+description: ${description || "A new command"}
+---
+
+Describe what this command does and how to use it.
+`;
+const INITIAL_COMMAND_VERSION = decodeExactSemverVersionSync("0.1.0");
+// -----------------------------------------------------------------------------
+// Public API
+// -----------------------------------------------------------------------------
+/**
+ * New-command operation handler.
+ *
+ * 1. Compute managed extension directory path
+ * 2. Check if directory already exists
+ * 3. Create the managed extension + src directories
+ * 4. Write command.json manifest
+ * 5. Write starter COMMAND.md in src/
+ */
+export const newCommand = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const { name, owner, description } = op.args;
+    // 1. Compute managed extension directory
+    const targetDir = path.join(path.resolve("."), REGISTRY_EXTENSIONS_DIR, owner, "commands", name);
+    const srcDir = path.join(targetDir, "src");
+    // 2. Check if directory already exists
+    const dirExists = yield* fs.exists(targetDir).pipe(Effect.orElseSucceed(() => false));
+    if (dirExists) {
+        return yield* makeAppError({
+            code: "COMMAND_DIR_EXISTS",
+            what: `Directory "${name}" already exists`,
+            howToFix: "Choose a different name or remove the existing directory first",
+        });
+    }
+    // 3. Create managed extension directories
+    yield* fs.makeDirectory(srcDir, { recursive: true }).pipe(Effect.mapError((e) => makeAppError({
+        code: "COMMAND_CREATE_FAILED",
+        what: `Failed to create command directory: ${targetDir}`,
+        cause: e,
+    })));
+    // 4. Write manifest
+    const manifest = {
+        $schema: COMMAND_MANIFEST_SCHEMA_URL,
+        owner,
+        type: "command",
+        name: decodeExtensionNameSync(name),
+        version: INITIAL_COMMAND_VERSION,
+        description: description || undefined,
+    };
+    yield* fs
+        .writeFileString(path.join(targetDir, COMMAND_MANIFEST_FILENAME), JSON.stringify(manifest, null, 2) + "\n")
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "COMMAND_CREATE_FAILED",
+        what: `Failed to write command manifest`,
+        cause: e,
+    })));
+    // 5. Write starter COMMAND.md in src/
+    yield* fs
+        .writeFileString(path.join(srcDir, "COMMAND.md"), makeCommandMd(name, description))
+        .pipe(Effect.mapError((e) => makeAppError({
+        code: "COMMAND_CREATE_FAILED",
+        what: `Failed to write COMMAND.md`,
+        cause: e,
+    })));
+    return {
+        result: "success",
+        message: `Created command ${owner}/commands/${name}`,
+    };
+});
+//# sourceMappingURL=new-command.js.map

package/dist/src/unstable/commands/operations/new-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-command.js","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/new-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAK7F,OAAO,EACL,yBAAyB,EACzB,2BAA2B,GAE5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAyBhG,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAE,EAAE,CAC1D;QACM,IAAI;eACG,WAAW,IAAI,eAAe;;;;CAI5C,CAAC;AAEF,MAAM,uBAAuB,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;AAEtE,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAGnB,CAAC,EAAE,EAAE,EAAE,CACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAE9B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;IAE7C,yCAAyC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EACjB,uBAAuB,EACvB,KAAK,EACL,UAAU,EACV,IAAI,CACL,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE3C,uCAAuC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,cAAc,IAAI,kBAAkB;YAC1C,QAAQ,EAAE,gEAAgE;SAC3E,CAAC,CAAC;IACL,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,uCAAuC,SAAS,EAAE;QACxD,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEF,oBAAoB;IACpB,MAAM,QAAQ,GAAoB;QAChC,OAAO,EAAE,2BAA2B;QACpC,KAAK;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC;QACnC,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,WAAW,IAAI,SAAS;KACtC,CAAC;IAEF,KAAK,CAAC,CAAC,EAAE;SACN,eAAe,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,EAC/C,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACzC;SACA,IAAI,CACH,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEJ,sCAAsC;IACtC,KAAK,CAAC,CAAC,EAAE;SACN,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;SAClF,IAAI,CACH,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,YAAY,CAAC;QACX,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,4BAA4B;QAClC,KAAK,EAAE,CAAC;KACT,CAAC,CACH,CACF,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,mBAAmB,KAAK,aAAa,IAAI,EAAE;KAC7B,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/src/unstable/commands/operations/publish.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Publish command executor — reads a command's manifest, builds a zip
+ * archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * Pipeline: validate manifest -> build archive -> compute integrity ->
+ * resolve registry provider -> publish version (idempotent).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../workspace/plan.js";
+import { Workspace } from "../../workspace/service-interface.js";
+/**
+ * Args for the publish-command operation.
+ */
+export type PublishCommandOperationArgs = {
+    /** Extension identity in `@owner/commands/name` FQN format. */
+    readonly name: string;
+    /** Named source to publish to (e.g. "local"). */
+    readonly registryName: string;
+};
+/**
+ * Publish a command extension to a registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type PublishCommandOperation = Operation<"publish-command", PublishCommandOperationArgs>;
+/**
+ * Publish-command operation handler.
+ *
+ * 1. Read and validate `command.json` manifest
+ * 2. Build zip archive of extension directory
+ * 3. Compute SRI integrity hash
+ * 4. Resolve target registry provider by source name
+ * 5. Publish version (idempotent: same integrity = no-op, different integrity = error)
+ */
+export declare const publishCommand: (op: PublishCommandOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path | Workspace>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/src/unstable/commands/operations/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/commands/operations/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAWpC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAMjE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC,iBAAiB,EAAE,2BAA2B,CAAC,CAAC;AAMhG;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,CAC3B,EAAE,EAAE,uBAAuB,KACxB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAuHrF,CAAC"}