@iwsdk/cli 0.4.2 → 0.5.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/README.md CHANGED
@@ -7,6 +7,26 @@ It owns:
7
7
 
8
8
  - dev server lifecycle commands
9
9
  - adapter sync and status
10
- - explicit reference status and warmup commands
10
+ - reference status and recovery warmup commands (fresh installed scaffolds warm
11
+ the shared cache automatically)
11
12
  - runtime-resolved MCP stdio access
12
13
  - direct runtime control commands
14
+
15
+ ## Coding-agent adapters
16
+
17
+ `iwsdk adapter sync` preserves unrelated settings while configuring the native
18
+ repository surfaces for Claude Code, Cursor, GitHub Copilot, Codex, and
19
+ OpenCode. Use `--tools claude,codex` to limit the selection.
20
+
21
+ Generated starters give Claude Code its native `CLAUDE.md`, scoped rules, and
22
+ skill tree. Codex, Cursor, Copilot, and OpenCode share byte-identical Agent
23
+ Skills under `.agents/skills`; Cursor and Copilot receive native scoped rules,
24
+ while Codex and OpenCode receive nested `AGENTS.md` files. Where a harness
25
+ supports repository-scoped permissions, sync preapproves only IWSDK-managed MCP
26
+ namespaces and skill loading. Copilot tool approval remains an explicit VS Code
27
+ action because it has no supported repository config for that choice.
28
+
29
+ - `iwsdk adapter status` reports MCP, instruction, and permission state.
30
+ - `iwsdk adapter prune` removes managed MCP/permission entries and preserves
31
+ editable instruction files.
32
+ - `iwsdk adapter prompt` prints exact setup instructions for another harness.
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ import { type AiTool } from './runtime-contract.js';
8
+ export interface AdapterSupportStatus {
9
+ instruction: {
10
+ file: string;
11
+ status: 'configured' | 'missing';
12
+ };
13
+ permissions: {
14
+ file: string | null;
15
+ status: 'configured' | 'manual' | 'missing';
16
+ note?: string;
17
+ };
18
+ }
19
+ export interface SyncAgentAdaptersOptions {
20
+ workspaceRoot: string;
21
+ tools?: AiTool[];
22
+ command?: string;
23
+ args?: string[];
24
+ }
25
+ export declare function syncAgentAdapters({ workspaceRoot, tools, command, args, }: SyncAgentAdaptersOptions): Promise<{
26
+ workspaceRoot: string;
27
+ tools: AiTool[];
28
+ serverNames: string[];
29
+ createdInstructions: string[];
30
+ }>;
31
+ export declare function pruneAgentAdapters({ workspaceRoot, tools, }: {
32
+ workspaceRoot: string;
33
+ tools?: AiTool[];
34
+ }): Promise<void>;
35
+ export declare function getAdapterSupportStatus(workspaceRoot: string, tool: AiTool, serverNames: string[]): Promise<AdapterSupportStatus>;
36
+ export declare function buildGenericAdapterPrompt(workspaceRoot: string): string;
37
+ //# sourceMappingURL=agent-adapters.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-adapters.d.ts","sourceRoot":"","sources":["../src/agent-adapters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EAAsB,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAaxE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;KAClC,CAAC;IACF,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AA6SD,wBAAsB,iBAAiB,CAAC,EACtC,aAAa,EACb,KAAK,EACL,OAAO,EACP,IAAI,GACL,EAAE,wBAAwB,GAAG,OAAO,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC,CAyBD;AAED,wBAAsB,kBAAkB,CAAC,EACvC,aAAa,EACb,KAAK,GACN,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AA8FD,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,oBAAoB,CAAC,CA0C/B;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA0BvE"}
package/dist/argv.d.ts CHANGED
@@ -8,4 +8,5 @@ import type { CliOptionValue, ParsedArgv } from './cli-types.js';
8
8
  export declare function parseArgv(argv: string[]): ParsedArgv;
9
9
  export declare function safeJsonParse<T = unknown>(raw: string, label: string): T;
10
10
  export declare function parseIntegerOption(value: CliOptionValue | undefined, label: string, fallback: number): number;
11
+ export declare function parseOptionalPositiveIntegerOption(value: CliOptionValue | undefined, label: string): number | undefined;
11
12
  //# sourceMappingURL=argv.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyBpD;AAED,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAMxE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAWR"}
1
+ {"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyBpD;AAED,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAMxE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAWR;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAapB"}