@agentxm/client-core 0.4.5 → 0.5.0

package/site-content/install.md

@@ -1,4 +1,4 @@
-# Install axm
+# Install AXM
 
 **DONE WHEN:** `axm --version` succeeds and (if the user chose workspace setup)
 `axm setup` has completed.
@@ -14,30 +14,29 @@
 - [ ] Run the chosen installer
 - [ ] Verify `axm --version`
 - [ ] Check sign-in state with `axm whoami --json`
-- [ ] If not signed in: ask the user to choose between signing in to
-      AgentXM.ai or going directly to workspace setup
-- [ ] If the user chose to sign in: hand off signup/login, then re-check
-      `axm whoami`
+- [ ] If not signed in: ask the user to sign in to AgentXM.ai or proceed
+      to workspace setup; on the sign-in choice, hand off signup/login and
+      re-check `axm whoami`
 - [ ] Run `axm setup --yes` to initialize the project workspace
+- [ ] Load pre-req help topics: `axm help getting-started` and
+      `axm help basic-usage`
 
 ---
 
-## What is axm
+## What is AXM
 
-axm is the open extension manager for AI coding agents. It lets you discover,
-install, publish, and manage skills, commands, subagents, MCP servers, and
-extension packs across your AI agents from a single CLI. axm is the CLI;
-[AgentXM.ai](https://agentxm.ai) is the extension registry it connects to —
-accounts, publishing, and extension discovery live there. An AgentXM.ai
-account is only required for publishing extensions or installing private
-extensions; public extensions install without an account.
+AXM (Agent eXtension Manager) is the open extension manager for AI coding
+agents — discover, install, publish, and manage skills, commands, subagents,
+MCP servers, and extension packs from a single CLI.
+[AgentXM.ai](https://agentxm.ai) is the extension registry AXM connects to.
+An AgentXM.ai account is only required for publishing extensions or
+installing private extensions; public extensions install without an account.
 
 ## Detect existing install
 
-Before installing, check whether axm is already on the machine. This is a
-**probe** — "not installed" is an expected outcome, not a failure. Invoke it
-so the shell exits 0 on either branch and the signal lives in stdout (see
-**Probe commands** under Invariants):
+Check whether AXM is already on the machine. This is a **probe** — invoke
+it so the shell exits 0 on either branch and the signal lives in stdout
+(see **Probe commands** under Invariants):
 
 On macOS / Linux:
 
@@ -53,33 +52,30 @@ if (Get-Command axm -ErrorAction SilentlyContinue) { axm --version } else { "NOT
 
 Branch on the output:
 
-- **Prints `X.Y.Z`** → axm is installed. Upgrade it to the latest version
-  and skip the Install section:
+- **Prints `X.Y.Z`** → AXM is installed. Upgrade and skip the Install section:
 
   ```bash
   axm upgrade
   ```
 
-  `axm upgrade` auto-detects how axm was installed. For script installs it
-  downloads and swaps the binary in place. For Homebrew or npm installs it
-  prints the exact command to run (`brew upgrade agentxm/tap/axm` or
-  `npm update -g axm.sh`) — run whichever it emits, then re-run the probe
-  above. Continue to **Verify** when done.
+  `axm upgrade` auto-detects the install method and either swaps the binary
+  in place (script installs) or prints the right `brew`/`npm` command to
+  run. If it prints a command, run it and re-run the probe above. Continue
+  to **Verify** when done.
 
-- **Prints `NOT_INSTALLED`** → axm is not installed. Continue to **Install**.
+- **Prints `NOT_INSTALLED`** → AXM is not installed. Continue to **Install**.
 - **Prints anything else** → treat as not installed and reinstall via the
   Install section.
 
 ## Choose install method
 
-axm can be installed via a standalone binary script, Homebrew, or npm. Pick
+AXM can be installed via a standalone binary script, Homebrew, or npm. Pick
 based on what's already on the machine — don't install a new package manager
-just to install axm.
+just to install AXM.
 
 ### 1. Detect available package managers
 
-Check which package managers are installed. A manager is "available" if the
-`--version` command exits successfully.
+A manager is "available" if `--version` exits successfully.
 
 On macOS / Linux:
 
@@ -111,13 +107,13 @@ fails, retry with Option A or B.
 
 ### 3. Ask the user when multiple managers are available
 
-All three options install the same axm binary. **The main difference is how
+All three options install the same `axm` binary. **The main difference is how
 you'll update it later.** Frame the choice that way when asking.
 
 **STOP HERE AND ASK THE USER:**
 
 > Multiple install methods are available on this machine. The main
-> difference is how you'll update axm later — pick the update path that
+> difference is how you'll update AXM later — pick the update path that
 > matches how you manage other tools.
 >
 > 1. **Install script** (recommended) — Updates via `axm upgrade`
@@ -128,7 +124,7 @@ you'll update it later.** Frame the choice that way when asking.
 >    your other brew packages. Choose this if you already manage most CLIs
 >    with brew.
 > 3. **npm** — Updates via `npm update -g axm.sh`, alongside your other
->    global npm packages. Choose this if axm is part of a Node.js-heavy
+>    global npm packages. Choose this if AXM is part of a Node.js-heavy
 >    environment. Requires Node.js.
 
 Wait for the user's response before continuing. Then run the corresponding
@@ -139,17 +135,15 @@ option below.
 Each option below installs a persistent `axm` binary on the machine. Run the
 option selected in **Choose install method**.
 
+If `axm` is not found after any install option, see **Troubleshooting**.
+
 ### Option A: macOS / Linux (install script)
 
 ```bash
 curl -fsSL https://axm.sh/install.sh | sh
 ```
 
-Installs to `~/.axm/bin/axm`. If `axm` is not found after install, add to PATH:
-
-```bash
-export PATH="$HOME/.axm/bin:$PATH"
-```
+Installs to `~/.axm/bin/axm`.
 
 ### Option B: Windows (PowerShell)
 
@@ -157,8 +151,7 @@ export PATH="$HOME/.axm/bin:$PATH"
 irm https://axm.sh/install.ps1 | iex
 ```
 
-Installs to `%LOCALAPPDATA%\axm\axm.exe`. Follow the printed PATH instructions
-if `axm` is not recognized.
+Installs to `%LOCALAPPDATA%\axm\axm.exe`.
 
 ### Option C: Windows (CMD)
 
@@ -166,8 +159,7 @@ if `axm` is not recognized.
 curl -fsSL -o install.cmd https://axm.sh/install.cmd && install.cmd
 ```
 
-Installs to `%LOCALAPPDATA%\axm\axm.exe`. Follow the printed PATH instructions
-if `axm` is not recognized.
+Installs to `%LOCALAPPDATA%\axm\axm.exe`.
 
 ### Option D: Homebrew (macOS / Linux)
 
@@ -177,19 +169,12 @@ brew install agentxm/tap/axm
 
 ### Option E: npm (any OS with Node.js)
 
-Installs the `axm.sh` package globally. Requires Node.js.
+Requires Node.js. Installs the `axm.sh` package globally.
 
 ```bash
 npm install -g axm.sh
 ```
 
-If `axm` is not found after install, ensure the npm global bin directory is on
-PATH:
-
-```bash
-export PATH="$(npm config get prefix)/bin:$PATH"
-```
-
 ## Verify
 
 ```bash
@@ -210,12 +195,10 @@ probe prints `X.Y.Z`, then proceed to **Check sign-in state**.
 
 ## Check sign-in state
 
-axm is installed. Before continuing, detect whether this machine is already
-signed in to AgentXM.ai — the result decides whether to ask the user about
-signing in or skip straight to workspace setup. This is a **probe** — "not
-signed in" is an expected outcome, not a failure. Invoke it so the shell
-exits 0 on either branch and the signal lives in stdout (see **Probe
-commands** under Invariants):
+Detect whether this machine is signed in to AgentXM.ai — the result decides
+whether to ask the user about signing in or skip to workspace setup. Like
+**Detect existing install**, this is a **probe** — invoke it so the shell
+exits 0 on either branch and the signal lives in stdout:
 
 On macOS / Linux:
 
@@ -245,9 +228,12 @@ needed to publish extensions or install private extensions, so the workspace
 can still be set up without it. The choice is about whether to do that
 sign-in now or defer it.
 
+**Do not run `axm login`, `axm setup`, or any other signed-in command
+until the user has explicitly chosen one of the two options below.**
+
 **STOP HERE AND ASK THE USER:**
 
-> axm is installed. Before setting up the project workspace, would you like
+> AXM is installed. Before setting up the project workspace, would you like
 > to sign in to AgentXM.ai? Signing in is only needed if you plan to
 > publish extensions or install private extensions — public extensions
 > install without an account.
@@ -267,9 +253,7 @@ Wait for the user's response before continuing.
 
 ## Sign up or log in to AgentXM.ai
 
-AgentXM.ai is the extension registry that axm connects to. Accounts live on
-AgentXM.ai, not in the CLI — `axm login` signs this machine in to an
-AgentXM.ai account.
+`axm login` signs this machine in to an AgentXM.ai account.
 
 ### If the user does not have an AgentXM.ai account
 
@@ -277,7 +261,7 @@ You cannot create an account for the user. Hand off:
 
 1. Tell the user to open https://agentxm.ai/signup and create an account —
    explain that this sets up the AgentXM.ai account that `axm login` will
-   later authenticate against, and that axm can't create the account
+   later authenticate against, and that AXM can't create the account
    because signup happens through the web.
 2. Wait for the user to confirm signup is complete.
 3. Continue to **Log in** below.
@@ -292,25 +276,17 @@ Offer both paths and let the user pick:
 
 - **Interactive (recommended):** ask the user to run `axm login` in their
   terminal. Tell them this opens a browser for a one-time OAuth device
-  flow; axm can't run it on their behalf because the browser step requires
+  flow; AXM can't run it on their behalf because the browser step requires
   them to be present.
 - **Non-interactive:** ask the user to export `AXM_TOKEN` in the
-  environment where axm will run. Explain that `AXM_TOKEN` is a
+  environment where AXM will run. Explain that `AXM_TOKEN` is a
   pre-generated credential that skips the browser step; you must not
   paste a token the user has not shared with you.
 
-Wait for the user to confirm sign-in is complete. Tell them you're about to
-re-run the sign-in probe to verify the sign-in succeeded before moving on.
-Use the same wrapper form as **Check sign-in state** so an unfinished
-sign-in doesn't surface as a tool error:
-
-```bash
-axm whoami --json 2>/dev/null || echo '{"type":"error","code":"AUTH_LOGIN_REQUIRED"}'
-```
-
-If the JSON `type` is not `"error"` (identity payload), continue to
-**Workspace setup**. If `type` is `"error"`, the sign-in did not complete —
-explain which check failed and ask the user to retry the same path or
+Wait for the user to confirm sign-in is complete, then re-run the probe
+wrapper from **Check sign-in state** to verify before moving on. If `type`
+is not `"error"`, continue to **Workspace setup**. If `type` is `"error"`,
+the sign-in did not complete — ask the user to retry the same path or
 switch paths.
 
 ---
@@ -328,37 +304,46 @@ Run:
 axm setup --yes
 ```
 
-Once it succeeds, consult the installed `@agentxm/skills/axm` skill for
-day-to-day operations — workspace scenarios (greenfield, brownfield,
-unmanaged skills), extension management, and publishing.
+Once it succeeds, load the two pre-req help topics before doing any other
+AXM work in this session — they cover what `axm setup` produced and the
+files an agent must understand before changing workspace state:
+
+```bash
+axm help getting-started
+axm help basic-usage
+```
+
+`getting-started` covers first-time setup of a workspace; read it so the
+agent understands how the workspace was just initialized. `basic-usage`
+covers the key workspace files (`.axm/settings.json`, `axm-lock.yaml`,
+`.axm/extensions/`), the commit policy (`.axm/` and `axm-lock.yaml` must
+be checked in, not gitignored), and how to act safely in an existing
+workspace.
+
+After reading both topics, consult the installed `@agentxm/skills/axm`
+skill for day-to-day operations — workspace scenarios (greenfield,
+brownfield, unmanaged skills), extension management, and publishing.
 
 ## Invariants
 
 - **Probe commands exit 0.** `axm --version` and `axm whoami --json` have
   expected non-zero exit paths ("not installed", "not signed in") that are
   part of the flow, not failures. Always invoke them using the wrappers in
-  **Detect existing install** and **Check sign-in state** so the shell
-  exits 0 on either branch and the signal lives in stdout; branch on the
-  output, not the exit code. Bare invocations surface expected non-zero
-  exits as tool errors in the agent's transcript, which is jarring and
-  implies something went wrong.
-- **Explain why you're asking.** Whenever you need the user's consent, input,
-  or out-of-band action — picking an install method, running `axm login`,
-  opening a signup URL, approving a command you'd otherwise run yourself —
-  state the purpose first: what you're about to do, why it's needed for
-  this install, and what the user should do next. No yes/no prompts without
-  context; no command handoffs without explaining the effect.
-- **Never** run `axm login` without explicit user consent. The device flow
-  opens a browser and requires the user to be present. When requesting
-  consent, tell the user that `axm login` will open a browser, complete an
-  OAuth device flow with AgentXM.ai, and store a local token so axm can
-  talk to the registry on their behalf.
-- **Never** set or paste an `AXM_TOKEN` the user has not shared. If the
-  user is providing a token, explain that it authenticates the CLI against
-  the user's AgentXM.ai account for the current shell session.
-- **Always** re-run `axm whoami` after any user-driven sign-in step before
-  running `axm setup`. Tell the user you're verifying the sign-in succeeded
-  before moving on.
+  **Detect existing install** and **Check sign-in state**; branch on
+  stdout, not the exit code.
+- **Explain why you're asking.** Every stop-and-ask, command handoff, and
+  consent request states what the action does, why it's needed, and what
+  the user should do next. Bare yes/no prompts and bare command handoffs
+  are non-conforming.
+- **Guide sign-in, do not execute sign-in.** Never run `axm login` without
+  explicit user consent; never set or paste an `AXM_TOKEN` the user has
+  not shared. The device flow requires the user's browser; the token is
+  the user's credential.
+- **Always** re-run the `axm whoami --json` probe after any user-driven
+  sign-in step before running `axm setup`.
+- **Option 2 is legitimate, not a fallback.** If the user chose to defer
+  sign-in, do not re-prompt later in the flow. Signing in is deferred,
+  not required.
 - **Resume, do not restart.** If the user completes sign-in out-of-band and
   returns, skip to **Workspace setup** — do not re-ask which option they
   picked.
@@ -367,23 +352,12 @@ unmanaged skills), extension management, and publishing.
 
 ## Troubleshooting
 
-**`axm: command not found`**
+**`axm: command not found`** — the install bin directory is not on PATH:
 
-The fix depends on how you installed:
-
-- **Install script (macOS/Linux):** Add `~/.axm/bin` to PATH:
-  ```bash
-  export PATH="$HOME/.axm/bin:$PATH"
-  ```
-  Add the line above to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.) to
-  persist across sessions.
-- **Install script (Windows):** Add `%LOCALAPPDATA%\axm` to your PATH via
-  System Environment Variables, or run:
-  ```powershell
-  $env:Path = "$env:LOCALAPPDATA\axm;$env:Path"
-  ```
-- **Homebrew:** Run `brew link axm` or check `brew --prefix axm`.
-- **npm:** Ensure the global npm bin directory is on PATH:
-  ```bash
-  export PATH="$(npm config get prefix)/bin:$PATH"
-  ```
+- **Install script (macOS/Linux):** `export PATH="$HOME/.axm/bin:$PATH"`,
+  then add to `~/.bashrc` / `~/.zshrc` to persist.
+- **Install script (Windows):** Add `%LOCALAPPDATA%\axm` to PATH via
+  System Environment Variables, or run
+  `$env:Path = "$env:LOCALAPPDATA\axm;$env:Path"`.
+- **Homebrew:** `brew link axm`.
+- **npm:** `export PATH="$(npm config get prefix)/bin:$PATH"`.

package/dist/src/unstable/agents/subagent-detection.d.ts

@@ -1,74 +0,0 @@
-/**
- * Subagent file detection for agent directories.
- *
- * Scans agent subagent directories to find existing subagent files and
- * classify them as managed (by axm) or unmanaged (user-created).
- *
- * @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 { AgentDescriptor } from "./types.js";
-/**
- * A detected subagent file with its management status.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export interface DetectedSubagentFile {
-    /** File path relative to the project directory */
-    readonly path: string;
-    /** Whether the file contains an axm managed marker */
-    readonly managed: boolean;
-}
-/**
- * Summary of detected subagent files for an agent.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export interface AgentSubagentSummary {
-    /** Agent identifier */
-    readonly agentId: string;
-    /** Agent display name */
-    readonly agentName: string;
-    /** Subagent directory path relative to project */
-    readonly subagentDir: string;
-    /** Detected subagent files */
-    readonly files: ReadonlyArray<DetectedSubagentFile>;
-}
-/**
- * Scan a single agent's subagent directory for existing files and classify
- * each as managed or unmanaged.
- *
- * Returns `Option.None`-style empty array when the directory does not exist.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const scanAgentSubagentFiles: (agent: AgentDescriptor, projectDir: string) => Effect.Effect<{
-    path: string;
-    managed: boolean;
-}[] | readonly [{
-    readonly path: string;
-    readonly managed: boolean;
-}], import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
-/**
- * Scan all configured agents' subagent directories for existing files.
- *
- * Returns a summary per agent that has a subagents descriptor, including
- * only agents where subagent files were found.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const scanAllSubagentFiles: (agents: ReadonlyArray<AgentDescriptor>, projectDir: string) => Effect.Effect<{
-    agentId: "adal" | "amp" | "antigravity" | "augment" | "claude-code" | "cline" | "codebuddy" | "codex" | "command-code" | "continue" | "crush" | "cursor" | "droid" | "gemini-cli" | "github-copilot" | "goose" | "iflow-cli" | "junie" | "kilo" | "kimi-cli" | "kiro-cli" | "kode" | "mcpjam" | "mistral-vibe" | "mux" | "neovate" | "openclaw" | "opencode" | "openhands" | "pi" | "pochi" | "qoder" | "qwen-code" | "replit" | "roo" | "trae" | "trae-cn" | "windsurf" | "zencoder";
-    agentName: string;
-    subagentDir: string;
-    files: {
-        path: string;
-        managed: boolean;
-    }[] | readonly [{
-        readonly path: string;
-        readonly managed: boolean;
-    }];
-}[], import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
-//# sourceMappingURL=subagent-detection.d.ts.map

package/dist/src/unstable/agents/subagent-detection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"subagent-detection.d.ts","sourceRoot":"","sources":["../../../../src/unstable/agents/subagent-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CACrD;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,eAAe,EAAE,YAAY,MAAM;;;;;;oFAyD9E,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,aAAa,CAAC,eAAe,CAAC,EAAE,YAAY,MAAM;;;;;;;;;;;qFAqB3F,CAAC"}

package/dist/src/unstable/agents/subagent-detection.js

@@ -1,85 +0,0 @@
-/**
- * Subagent file detection for agent directories.
- *
- * Scans agent subagent directories to find existing subagent files and
- * classify them as managed (by axm) or unmanaged (user-created).
- *
- * @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 { isManagedByAxm } from "../extensions/managed-marker.js";
-import { makeAppError } from "../app-error/index.js";
-// -----------------------------------------------------------------------------
-// Detection
-// -----------------------------------------------------------------------------
-/**
- * Scan a single agent's subagent directory for existing files and classify
- * each as managed or unmanaged.
- *
- * Returns `Option.None`-style empty array when the directory does not exist.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const scanAgentSubagentFiles = (agent, projectDir) => Effect.gen(function* () {
-    const subagents = agent.subagents;
-    if (subagents === undefined) {
-        return [];
-    }
-    const fs = yield* FileSystem.FileSystem;
-    const p = yield* Path.Path;
-    const subagentPath = p.resolve(projectDir, subagents.dir);
-    const exists = yield* fs.exists(subagentPath);
-    if (!exists) {
-        return [];
-    }
-    if (subagents.isFile === true) {
-        // Single file (e.g., .roomodes) — read and check for marker
-        const content = yield* fs.readFileString(subagentPath);
-        const managed = isManagedByAxm(content);
-        return [{ path: subagents.dir, managed }];
-    }
-    // Directory — list files and check each for marker
-    const entries = yield* fs.readDirectory(subagentPath);
-    const files = yield* Effect.filter(entries, (entry) => Effect.gen(function* () {
-        const stat = yield* fs.stat(p.join(subagentPath, entry));
-        return stat.type === "File";
-    }), { concurrency: "unbounded" });
-    return yield* Effect.forEach(files, (file) => Effect.gen(function* () {
-        const filePath = p.join(subagentPath, file);
-        const content = yield* fs.readFileString(filePath);
-        const managed = isManagedByAxm(content);
-        return {
-            path: p.join(subagents.dir, file),
-            managed,
-        };
-    }), { concurrency: "unbounded" });
-}).pipe(Effect.mapError((error) => makeAppError({
-    code: "AGENT_DETECTION_FAILED",
-    what: `Failed to scan subagent files for ${agent.name}`,
-    cause: error,
-})));
-/**
- * Scan all configured agents' subagent directories for existing files.
- *
- * Returns a summary per agent that has a subagents descriptor, including
- * only agents where subagent files were found.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const scanAllSubagentFiles = (agents, projectDir) => Effect.gen(function* () {
-    const agentsWithSubagents = agents.filter((a) => a.subagents !== undefined);
-    const results = yield* Effect.forEach(agentsWithSubagents, (agent) => Effect.gen(function* () {
-        const files = yield* scanAgentSubagentFiles(agent, projectDir);
-        return {
-            agentId: agent.id,
-            agentName: agent.name,
-            subagentDir: agent.subagents?.dir ?? "",
-            files,
-        };
-    }), { concurrency: "unbounded" });
-    // Only include agents where files were found
-    return results.filter((r) => r.files.length > 0);
-});
-//# sourceMappingURL=subagent-detection.js.map

package/dist/src/unstable/agents/subagent-detection.js.map

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

package/dist/src/unstable/extensions/conflict-detection.d.ts

@@ -1,40 +0,0 @@
-/**
- * Conflict detection for extension-rendered files.
- *
- * Determines whether a file is absent, owned by axm (has a managed marker),
- * or in conflict (exists without a managed marker). Returns data only —
- * no policy decisions.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import { type AppError } from "../app-error/index.js";
-/**
- * Tagged union representing the result of conflict detection.
- *
- * - `Absent`: file does not exist
- * - `Owned`: file exists with a managed marker (safe to re-render)
- * - `Conflict`: file exists without a managed marker (user-owned)
- *
- * @experimental This API is unstable and may change without notice.
- */
-export type ConflictDetectionResult = {
-    readonly _tag: "Absent";
-} | {
-    readonly _tag: "Owned";
-} | {
-    readonly _tag: "Conflict";
-};
-/**
- * Detect whether a file path is absent, owned by axm, or in conflict.
- *
- * When `fileContent` is provided, it is used directly instead of reading
- * from disk. This is useful when the content is already available.
- *
- * Returns data only — callers decide what policy to apply.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const detectConflict: (filePath: string, fileContent?: string) => Effect.Effect<ConflictDetectionResult, AppError, FileSystem.FileSystem>;
-//# sourceMappingURL=conflict-detection.d.ts.map

package/dist/src/unstable/extensions/conflict-detection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conflict-detection.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/conflict-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAYlC;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,cAAc,MAAM,KACnB,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,CAyBxE,CAAC"}

package/dist/src/unstable/extensions/conflict-detection.js

@@ -1,49 +0,0 @@
-/**
- * Conflict detection for extension-rendered files.
- *
- * Determines whether a file is absent, owned by axm (has a managed marker),
- * or in conflict (exists without a managed marker). Returns data only —
- * no policy decisions.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import * as FileSystem from "effect/FileSystem";
-import { makeAppError } from "../app-error/index.js";
-import { isManagedByAxm } from "./managed-marker.js";
-const Absent = { _tag: "Absent" };
-const Owned = { _tag: "Owned" };
-const Conflict = { _tag: "Conflict" };
-const classifyContent = (content) => isManagedByAxm(content) ? Owned : Conflict;
-const isNotFound = (error) => error.reason._tag === "NotFound";
-/**
- * Detect whether a file path is absent, owned by axm, or in conflict.
- *
- * When `fileContent` is provided, it is used directly instead of reading
- * from disk. This is useful when the content is already available.
- *
- * Returns data only — callers decide what policy to apply.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const detectConflict = (filePath, fileContent) => {
-    if (fileContent !== undefined) {
-        return Effect.succeed(classifyContent(fileContent));
-    }
-    return Effect.gen(function* () {
-        const fs = yield* FileSystem.FileSystem;
-        return yield* fs.readFileString(filePath).pipe(Effect.map(classifyContent), Effect.catch((error) => {
-            if (isNotFound(error)) {
-                return Effect.succeed(Absent);
-            }
-            return Effect.fail(makeAppError({
-                code: "FILE_READ_ERROR",
-                what: `Failed to read file: ${filePath}`,
-                details: [String(error)],
-                howToFix: "Check file permissions and ensure the path is accessible.",
-                cause: error,
-            }));
-        }));
-    });
-};
-//# sourceMappingURL=conflict-detection.js.map

package/dist/src/unstable/extensions/conflict-detection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"conflict-detection.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/conflict-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBrD,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3D,MAAM,KAAK,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACzD,MAAM,QAAQ,GAA4B,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAE/D,MAAM,eAAe,GAAG,CAAC,OAAe,EAA2B,EAAE,CACnE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAE7C,MAAM,UAAU,GAAG,CAAC,KAAkC,EAAW,EAAE,CACjE,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,WAAoB,EACqD,EAAE;IAC3E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QACxC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC5C,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,EAC3B,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;gBACX,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,wBAAwB,QAAQ,EAAE;gBACxC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxB,QAAQ,EAAE,2DAA2D;gBACrE,KAAK,EAAE,KAAK;aACb,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}