@yawlabs/ansible-mcp 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -18,7 +18,7 @@ Your checkout has `community.general 9.5.2`; the model's training data has whate
18
18
  - **Installed, not latest** -- the source of truth is `ansible-doc --json` run against your collections paths, with redirects (`ufw` -> `community.general.ufw`) and tombstones resolved.
19
19
  - **Checks what lint skips** -- `ansible-lint`'s `args` rule skips modules with action plugins (`copy`, `template`); `ansible_check_task_args` catches their unknown options and bad values, and says plainly which cross-option rules ansible-doc cannot express.
20
20
  - **YAML 1.1 aware** -- Ansible parses YAML 1.1, so unquoted `off` is `false` and `0755` is the integer 493. The server reads YAML the same way and says when that is probably a bug.
21
- - **Read-only by construction** -- configured vault password scripts never run (a server-owned dummy password file replaces them), script and plugin inventory sources are off by default, and play-level lookups are refused before Ansible parses a playbook.
21
+ - **Read-only by construction** -- configured vault password scripts never run (a server-owned dummy password file replaces them), script and plugin inventory sources are off by default, and play-level lookups are refused before Ansible parses a playbook (as is any playbook or lint target the pre-scan cannot fully read).
22
22
  - **Collection upgrade impact** -- downloads only the target version into its own cache and diffs the arg specs of the modules your tasks actually use, tied to file:line.
23
23
  - **macOS, Linux, and Windows through WSL** -- Ansible has no Windows control node; on Windows the server spawns it through `wsl.exe --exec` (no shell anywhere).
24
24
 
package/dist/context.d.ts CHANGED
@@ -43,6 +43,7 @@ export declare class AnsibleContext {
43
43
  private readonly configCache;
44
44
  private versionCache;
45
45
  private readonly fingerprints;
46
+ /** Per-name doc results; `deprecations` replays the batch's warnings naming that entry on a hit. */
46
47
  private readonly docCache;
47
48
  private readonly listCache;
48
49
  /** Serializes ansible_upgrade_impact calls in this process. */
@@ -91,6 +92,9 @@ export declare class AnsibleContext {
91
92
  * tombstone retry (F2: one tombstone fails the whole batch, so it is recorded
92
93
  * and the batch re-run without it). `collectionsPath` overrides
93
94
  * ANSIBLE_COLLECTIONS_PATH (upgrade targets); those results are not cached.
95
+ * A name starting with `-` is never a plugin name: it is reported missing and
96
+ * never reaches argv (task keys are user data; `-M x` would be an option), and
97
+ * the names follow `--` besides.
94
98
  */
95
99
  docs(p: Project, names: string[], opts?: {
96
100
  type?: string;
package/dist/exec.d.ts CHANGED
@@ -124,7 +124,11 @@ export declare class AnsibleRunner {
124
124
  displaySide(p: string, label?: boolean): string;
125
125
  /** Ansible-side path -> a path this process can read with fs, or null. */
126
126
  serverPathOf(p: string): string | null;
127
- /** The Ansible side's environment (prefix mode; learned once per process). */
127
+ /**
128
+ * The Ansible side's environment (prefix mode; learned once per process). A
129
+ * spawn failure, a non-zero exit or an empty listing rejects and is not
130
+ * cached, so the next call asks again.
131
+ */
128
132
  sideEnv(): Promise<Record<string, string>>;
129
133
  /** Ansible-side cache root: ANSIBLE_MCP_REMOTE_CACHE, else $HOME/.cache/ansible-mcp (never /tmp, F24). */
130
134
  sideCacheRoot(): Promise<string>;
@@ -149,7 +153,11 @@ export declare class AnsibleRunner {
149
153
  sideWriteFile(p: string, content: string): Promise<void>;
150
154
  /** Rename a directory; false when the target already exists (another process won). */
151
155
  sideRename(from: string, to: string): Promise<boolean>;
152
- /** Recursive delete of a `.tmp-*` dir, only under `guardRoot` (asserted). */
156
+ /**
157
+ * Recursive delete of a `.tmp-*` dir, only under `guardRoot` (asserted): the
158
+ * last segment must start with `.tmp-`, and no segment of either path may be
159
+ * `.` or `..` (a plain prefix test would accept `<root>/../x/.tmp-y`).
160
+ */
153
161
  sideRemoveTemp(p: string, guardRoot: string): Promise<void>;
154
162
  }
155
163
  export interface SafetyOptions {