@iwsdk/cli 0.4.1 → 0.5.0
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 +21 -1
- package/dist/agent-adapters.d.ts +37 -0
- package/dist/agent-adapters.d.ts.map +1 -0
- package/dist/argv.d.ts +1 -0
- package/dist/argv.d.ts.map +1 -1
- package/dist/cli.js +3801 -572
- package/dist/cli.js.map +1 -1
- package/dist/commands/adapter.d.ts +3 -0
- package/dist/commands/adapter.d.ts.map +1 -1
- package/dist/commands/dev.d.ts +27 -0
- package/dist/commands/dev.d.ts.map +1 -1
- package/dist/commands/runtime.d.ts.map +1 -1
- package/dist/contract.js +1741 -113
- package/dist/contract.js.map +1 -1
- package/dist/help.d.ts +2 -0
- package/dist/help.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3801 -572
- package/dist/index.js.map +1 -1
- package/dist/mcp-adapters.d.ts +2 -0
- package/dist/mcp-adapters.d.ts.map +1 -1
- package/dist/mcp-stdio.d.ts.map +1 -1
- package/dist/{hzdb-telemetry.d.ts → metavr-telemetry.d.ts} +1 -1
- package/dist/metavr-telemetry.d.ts.map +1 -0
- package/dist/runtime-contract.d.ts +30 -3
- package/dist/runtime-contract.d.ts.map +1 -1
- package/dist/runtime-state.d.ts.map +1 -1
- package/dist/runtime-transport.d.ts +6 -2
- package/dist/runtime-transport.d.ts.map +1 -1
- package/guidance/AGENTS.md +151 -0
- package/package.json +12 -11
- package/LICENSE +0 -21
- package/dist/hzdb-telemetry.d.ts.map +0 -1
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
|
-
-
|
|
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
|
package/dist/argv.d.ts.map
CHANGED
|
@@ -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"}
|