@assethub/cli 0.1.33 → 0.1.36
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 +67 -24
- package/dist/agentSetup.d.ts +35 -40
- package/dist/agentSetup.d.ts.map +1 -1
- package/dist/agentSetup.js +72 -113
- package/dist/hooks/command.d.ts +1 -0
- package/dist/hooks/command.d.ts.map +1 -1
- package/dist/hooks/command.js +2 -1
- package/dist/hooks/save.d.ts +14 -0
- package/dist/hooks/save.d.ts.map +1 -1
- package/dist/hooks/save.js +20 -0
- package/dist/hooks/types.d.ts +2 -0
- package/dist/hooks/types.d.ts.map +1 -1
- package/dist/hooks/upload.d.ts +6 -0
- package/dist/hooks/upload.d.ts.map +1 -1
- package/dist/hooks/upload.js +16 -2
- package/dist/index.d.ts +5 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +156 -30
- package/dist/setupCommand.d.ts +53 -2
- package/dist/setupCommand.d.ts.map +1 -1
- package/dist/setupCommand.js +344 -131
- package/dist/updateNotice.d.ts +71 -0
- package/dist/updateNotice.d.ts.map +1 -0
- package/dist/updateNotice.js +189 -0
- package/package.json +1 -1
- package/skills/assethub/SKILL.md +20 -3
package/dist/setupCommand.d.ts
CHANGED
|
@@ -1,23 +1,44 @@
|
|
|
1
1
|
import { API_KEY_ENV } from './appEnv.js';
|
|
2
|
+
import { type AgentId, type SkillsReport } from './agentSetup.js';
|
|
2
3
|
import type { InstallHooks } from './setupHooksBridge.js';
|
|
3
4
|
export type StepStatus = 'ok' | 'fail' | 'skip';
|
|
5
|
+
/** What a step did to local state: nothing, a write, or (dry run) a write it would make. */
|
|
6
|
+
export type StepChange = 'unchanged' | 'updated' | 'would-update';
|
|
4
7
|
export type SetupStep = {
|
|
5
8
|
name: string;
|
|
6
9
|
status: StepStatus;
|
|
7
10
|
detail: string;
|
|
11
|
+
change?: StepChange;
|
|
12
|
+
/** The config file or folder the step reads and writes. */
|
|
13
|
+
path?: string;
|
|
8
14
|
};
|
|
15
|
+
export declare const SETUP_STEPS: readonly ["login", "workspace", "mcp", "skills", "auto-update", "app-env", "hook", "doctor"];
|
|
16
|
+
export type SetupStepName = (typeof SETUP_STEPS)[number];
|
|
9
17
|
export type SetupResult = {
|
|
10
18
|
ok: boolean;
|
|
11
19
|
dryRun: boolean;
|
|
12
20
|
profile: string;
|
|
13
21
|
baseUrl: string;
|
|
14
22
|
workspaceId?: string;
|
|
23
|
+
/** CLI version, which is also the version of the installed skill. */
|
|
24
|
+
version: string;
|
|
25
|
+
scope: 'global' | 'project';
|
|
26
|
+
agents: AgentId[];
|
|
27
|
+
/** Agents found on this machine, whether or not they were selected. */
|
|
28
|
+
detected: AgentId[];
|
|
29
|
+
/** The skill copy and each agent's link to it, when the skills step ran. */
|
|
30
|
+
skill?: SkillsReport;
|
|
15
31
|
steps: SetupStep[];
|
|
16
32
|
nextStep: string;
|
|
17
33
|
exportLine?: string;
|
|
18
34
|
};
|
|
19
35
|
export type SetupOptions = {
|
|
20
|
-
|
|
36
|
+
/** Agents to configure; undefined means every agent detected on this machine. */
|
|
37
|
+
agents?: AgentId[];
|
|
38
|
+
/** Write MCP config and the skill into the current folder instead of the home folder. */
|
|
39
|
+
project?: boolean;
|
|
40
|
+
/** Steps to leave out (`--skip`, `--only`, `--no-skills`). */
|
|
41
|
+
skip?: SetupStepName[];
|
|
21
42
|
workspace?: string;
|
|
22
43
|
apiKeyStdin: boolean;
|
|
23
44
|
/** An API key given as --api-key (always wins) or found in ASSETHUB_API_KEY (used when no saved key works). */
|
|
@@ -26,6 +47,8 @@ export type SetupOptions = {
|
|
|
26
47
|
noHook: boolean;
|
|
27
48
|
/** `--no-app-env`: leave launchd alone even on macOS. */
|
|
28
49
|
noAppEnv?: boolean;
|
|
50
|
+
/** `--auto-update` / `--no-auto-update`: save that choice; undefined keeps the saved one (default on). */
|
|
51
|
+
autoUpdate?: boolean;
|
|
29
52
|
/** Explicit consent to record and upload agent sessions (`--save-sessions`). */
|
|
30
53
|
saveSessions: boolean;
|
|
31
54
|
dryRun: boolean;
|
|
@@ -63,6 +86,20 @@ export type SetupDeps = {
|
|
|
63
86
|
}) => Promise<void>;
|
|
64
87
|
promptApiKey: () => Promise<string>;
|
|
65
88
|
resolveAuth: () => Promise<SetupAuth>;
|
|
89
|
+
/** Base URL and workspace from flags and the saved profile, without a key or the network (login skipped). */
|
|
90
|
+
resolveTarget: () => Promise<{
|
|
91
|
+
baseUrl: string;
|
|
92
|
+
workspaceId?: string;
|
|
93
|
+
}>;
|
|
94
|
+
/** Agents installed on this machine. */
|
|
95
|
+
detectAgents: () => Promise<AgentId[]>;
|
|
96
|
+
version: () => Promise<string>;
|
|
97
|
+
/** Installs the skill under root and links it into each agent; reports without writing on a dry run. */
|
|
98
|
+
installSkills: (input: {
|
|
99
|
+
root: string;
|
|
100
|
+
agents: AgentId[];
|
|
101
|
+
dryRun: boolean;
|
|
102
|
+
}) => Promise<SkillsReport>;
|
|
66
103
|
discoverWorkspace: (auth: SetupAuth) => Promise<string | undefined>;
|
|
67
104
|
useWorkspace: (id: string) => Promise<void>;
|
|
68
105
|
listWorkspaces: () => Promise<SetupWorkspace[]>;
|
|
@@ -86,6 +123,13 @@ export type SetupDeps = {
|
|
|
86
123
|
home: string;
|
|
87
124
|
/** argv the macOS LaunchAgent runs at login: node, this CLI, `env load --profile <name>`. */
|
|
88
125
|
launchAgentProgram: string[];
|
|
126
|
+
/** The saved auto-update choice (undefined: never set, which means on). */
|
|
127
|
+
readAutoUpdate: () => Promise<boolean | undefined>;
|
|
128
|
+
writeAutoUpdate: (on: boolean) => Promise<void>;
|
|
129
|
+
/** Whether this CLI is an installed package `assethub update` can upgrade (not npx or a source checkout). */
|
|
130
|
+
canSelfUpdate: () => Promise<boolean>;
|
|
131
|
+
/** ASSETHUB_NO_AUTO_UPDATE, ASSETHUB_NO_UPDATE_CHECK or CI turn it off for this environment. */
|
|
132
|
+
autoUpdateBlockedByEnv: boolean;
|
|
89
133
|
};
|
|
90
134
|
export declare const redactKey: (key: string) => string;
|
|
91
135
|
export declare const mergeCodexSection: (existing: string, section: string) => string;
|
|
@@ -99,7 +143,7 @@ export declare const claudeServerConfig: (baseUrl: string, workspaceId?: string)
|
|
|
99
143
|
Authorization: string;
|
|
100
144
|
};
|
|
101
145
|
};
|
|
102
|
-
export declare const claudeAddArgs: (baseUrl: string, workspaceId?: string) => string[];
|
|
146
|
+
export declare const claudeAddArgs: (baseUrl: string, workspaceId?: string, scope?: "user" | "project") => string[];
|
|
103
147
|
export declare const runSetup: (options: SetupOptions, deps: SetupDeps) => Promise<SetupResult>;
|
|
104
148
|
export declare const formatSetupSummary: (result: SetupResult) => string;
|
|
105
149
|
export declare const findOnPath: (name: string, pathValue?: string) => Promise<string | undefined>;
|
|
@@ -114,6 +158,13 @@ export declare const defaultFileDeps: () => {
|
|
|
114
158
|
codexHome: string;
|
|
115
159
|
now: () => Date;
|
|
116
160
|
findBinary: (name: string) => Promise<string | undefined>;
|
|
161
|
+
detectAgents: () => Promise<("cursor" | "codex" | "claude-code")[]>;
|
|
162
|
+
version: () => Promise<string>;
|
|
163
|
+
installSkills: ({ root, agents, dryRun, }: {
|
|
164
|
+
root: string;
|
|
165
|
+
agents: AgentId[];
|
|
166
|
+
dryRun: boolean;
|
|
167
|
+
}) => Promise<SkillsReport>;
|
|
117
168
|
run: (file: string, args: string[]) => Promise<{
|
|
118
169
|
code: number;
|
|
119
170
|
output: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"setupCommand.d.ts","sourceRoot":"","sources":["../src/setupCommand.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"setupCommand.d.ts","sourceRoot":"","sources":["../src/setupCommand.ts"],"names":[],"mappings":"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"}
|