@yawlabs/ansible-mcp 0.1.0 → 0.1.1

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/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 {