@camstack/develop 0.1.2 → 0.1.4

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.
@@ -0,0 +1,67 @@
1
+ /**
2
+ * TLS trust for hub calls: a pinned certificate or the hub's CA — never
3
+ * `NODE_TLS_REJECT_UNAUTHORIZED=0`, never `rejectUnauthorized: false`.
4
+ *
5
+ * A hub on the LAN serves a self-signed (or privately issued) certificate. The
6
+ * operator tells the tools to trust it by dropping a PEM next to the session
7
+ * cache as `~/.camstack/<host>_<port>.ca.pem` (or naming another file in
8
+ * `$CAMSTACK_HUB_CA_FILE`): the hub's own certificate when it is self-signed,
9
+ * or the CA that issued it (e.g. mkcert's `rootCA.pem`, never its key). The PEM
10
+ * is a trust anchor for THAT hub only: standard verification still runs against
11
+ * it — chain, expiry and host name. A leaf issued by a CA cannot be pinned on
12
+ * its own (Node does not accept a partial chain); give the CA. A hub with a
13
+ * publicly trusted certificate needs nothing at all.
14
+ */
15
+ import * as fs from 'node:fs';
16
+ import * as https from 'node:https';
17
+ import * as path from 'node:path';
18
+ import { defaultSessionDir, slugForServer } from './session-store.js';
19
+ /** `~/.camstack/<host>.ca.pem` — the default pin file for a hub. */
20
+ export function hubCaFileForServer(serverUrl, dir = defaultSessionDir()) {
21
+ return path.join(dir, `${slugForServer(serverUrl)}.ca.pem`);
22
+ }
23
+ /** The trust configuration for `serverUrl`; empty when the system store should decide. */
24
+ export function resolveHubTls(serverUrl, env = process.env, dir = defaultSessionDir()) {
25
+ if (!serverUrl.startsWith('https:'))
26
+ return {};
27
+ const named = env['CAMSTACK_HUB_CA_FILE']?.trim();
28
+ const candidate = named && named !== '' ? named : hubCaFileForServer(serverUrl, dir);
29
+ try {
30
+ return { ca: fs.readFileSync(candidate, 'utf8'), caFile: candidate };
31
+ }
32
+ catch (err) {
33
+ if (named && named !== '') {
34
+ throw new Error(`Cannot read the hub CA file named by CAMSTACK_HUB_CA_FILE: ${candidate}`, {
35
+ cause: err,
36
+ });
37
+ }
38
+ return {};
39
+ }
40
+ }
41
+ /** A TLS failure, with the one fix that applies. */
42
+ export function explainTlsFailure(serverUrl, err) {
43
+ const code = err instanceof Error ? Reflect.get(err, 'code') : undefined;
44
+ const tlsCodes = [
45
+ 'DEPTH_ZERO_SELF_SIGNED_CERT',
46
+ 'SELF_SIGNED_CERT_IN_CHAIN',
47
+ 'UNABLE_TO_VERIFY_LEAF_SIGNATURE',
48
+ 'UNABLE_TO_GET_ISSUER_CERT_LOCALLY',
49
+ 'CERT_HAS_EXPIRED',
50
+ 'ERR_TLS_CERT_ALTNAME_INVALID',
51
+ ];
52
+ if (typeof code !== 'string' || !tlsCodes.includes(code))
53
+ return null;
54
+ return [
55
+ `TLS verification of ${serverUrl} failed (${code}). Verification is never switched off.`,
56
+ ` Trust this hub: save the PEM of its certificate (when self-signed) or of the CA that`,
57
+ ` issued it (e.g. mkcert's rootCA.pem — never its key) to ${hubCaFileForServer(serverUrl)},`,
58
+ ' or point $CAMSTACK_HUB_CA_FILE at that PEM. A leaf issued by a CA needs the CA, not the leaf.',
59
+ ].join('\n');
60
+ }
61
+ /** The https agent for hub traffic: the pinned PEM when there is one, else defaults. */
62
+ export function createHubAgent(tls) {
63
+ return new https.Agent({
64
+ keepAlive: false,
65
+ ...(tls.ca ? { ca: tls.ca } : {}),
66
+ });
67
+ }
@@ -0,0 +1,17 @@
1
+ export interface HubUrlInputs {
2
+ readonly explicit?: string;
3
+ readonly env?: Readonly<Record<string, string | undefined>>;
4
+ /** The checkout whose `scratchpad/.hub-url` may name the hub. */
5
+ readonly workspaceRoot?: string;
6
+ readonly session?: {
7
+ readonly server: string;
8
+ } | null;
9
+ }
10
+ export type HubUrlSource = 'flag' | 'env' | 'scratchpad' | 'session';
11
+ export interface ResolvedHubUrl {
12
+ readonly url: string;
13
+ readonly source: HubUrlSource;
14
+ }
15
+ /** The hub URL, or `undefined` when no source names one. */
16
+ export declare function resolveHubUrl(inputs: HubUrlInputs): ResolvedHubUrl | undefined;
17
+ //# sourceMappingURL=hub-url.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub-url.d.ts","sourceRoot":"","sources":["../../src/hub/hub-url.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC3D,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACtD;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CAAA;AAEpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC9B;AAiBD,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAW9E"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Which hub a tool talks to. Never a literal address in code: the hub URL is
3
+ * the operator's, found in this order (first hit wins).
4
+ *
5
+ * 1. an explicit value (a `--server` flag)
6
+ * 2. `$CAMSTACK_HUB_URL`
7
+ * 3. `$CAMSTACK_SERVER` (the CLI's name for the same thing)
8
+ * 4. `<workspace>/scratchpad/.hub-url` (gitignored, one line)
9
+ * 5. the cached `camstack login` session's server
10
+ */
11
+ import * as fs from 'node:fs';
12
+ import * as path from 'node:path';
13
+ function clean(value) {
14
+ const trimmed = value?.trim().replace(/\/+$/, '');
15
+ return trimmed ? trimmed : undefined;
16
+ }
17
+ function readScratchpadHubUrl(workspaceRoot) {
18
+ if (!workspaceRoot)
19
+ return undefined;
20
+ const file = path.join(workspaceRoot, 'scratchpad', '.hub-url');
21
+ try {
22
+ return clean(fs.readFileSync(file, 'utf8'));
23
+ }
24
+ catch {
25
+ return undefined;
26
+ }
27
+ }
28
+ /** The hub URL, or `undefined` when no source names one. */
29
+ export function resolveHubUrl(inputs) {
30
+ const env = inputs.env ?? process.env;
31
+ const explicit = clean(inputs.explicit);
32
+ if (explicit)
33
+ return { url: explicit, source: 'flag' };
34
+ const fromEnv = clean(env['CAMSTACK_HUB_URL']) ?? clean(env['CAMSTACK_SERVER']);
35
+ if (fromEnv)
36
+ return { url: fromEnv, source: 'env' };
37
+ const scratch = readScratchpadHubUrl(inputs.workspaceRoot);
38
+ if (scratch)
39
+ return { url: scratch, source: 'scratchpad' };
40
+ const session = clean(inputs.session?.server);
41
+ if (session)
42
+ return { url: session, source: 'session' };
43
+ return undefined;
44
+ }
@@ -0,0 +1,38 @@
1
+ export interface SessionFile {
2
+ readonly server: string;
3
+ readonly username: string;
4
+ readonly tokenId: string;
5
+ readonly token: string;
6
+ readonly scopes: readonly {
7
+ type: string;
8
+ target: string;
9
+ }[];
10
+ readonly createdAt: number;
11
+ }
12
+ /** Where the cache lives; injectable so a test never touches the real home. */
13
+ export declare function defaultSessionDir(): string;
14
+ /** Slug a server URL into a single filesystem-safe filename component. */
15
+ export declare function slugForServer(serverUrl: string): string;
16
+ export declare function sessionFileForServer(serverUrl: string, dir?: string): string;
17
+ /**
18
+ * Where an operator drops a `csa_` admin token for a hub (owner-only file,
19
+ * D816). The extension is not `.json`, so the newest-session fallback below
20
+ * never mistakes it for a session.
21
+ */
22
+ export declare function adminTokenFileForServer(serverUrl: string, dir?: string): string;
23
+ /**
24
+ * The admin token file to use, or `undefined` when none exists: the path named
25
+ * by `$CAMSTACK_ADMIN_TOKEN_FILE` (a PATH, never the token), else the default
26
+ * file for `serverUrl`.
27
+ */
28
+ export declare function findAdminTokenFile(serverUrl: string | undefined, env?: Readonly<Record<string, string | undefined>>, dir?: string): string | undefined;
29
+ /**
30
+ * Shape check for a cached session blob. A partial or corrupted cache file
31
+ * (e.g. after a crashed login) is treated as "no session" instead of crashing
32
+ * a later `.slice` on undefined.
33
+ */
34
+ export declare function isSessionFile(value: unknown): value is SessionFile;
35
+ export declare function loadSession(serverUrl?: string, dir?: string): SessionFile | null;
36
+ export declare function saveSession(session: SessionFile, dir?: string): string;
37
+ export declare function clearSession(serverUrl: string, dir?: string): boolean;
38
+ //# sourceMappingURL=session-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/hub/session-store.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAA4B,GAChC,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,EAC/D,GAAG,GAAE,MAA4B,GAChC,MAAM,GAAG,SAAS,CAMpB;AAuBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAUlE;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,GAAE,MAA4B,GAChC,WAAW,GAAG,IAAI,CASpB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAK3F;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,OAAO,CAK1F"}
@@ -0,0 +1,117 @@
1
+ /**
2
+ * The `camstack login` session cache — `~/.camstack/<host>.json` (0600), one
3
+ * file per hub. Moved here from the CLI so every hub-talking tool (CLI,
4
+ * `scripts/hub/hub.mjs`, the operator MCP) reads the SAME cache through the
5
+ * SAME code. The cache holds a long-lived scoped token (`cst_`), never a
6
+ * password and never a JWT.
7
+ */
8
+ import * as fs from 'node:fs';
9
+ import * as os from 'node:os';
10
+ import * as path from 'node:path';
11
+ /** Where the cache lives; injectable so a test never touches the real home. */
12
+ export function defaultSessionDir() {
13
+ return path.join(os.homedir(), '.camstack');
14
+ }
15
+ /** Slug a server URL into a single filesystem-safe filename component. */
16
+ export function slugForServer(serverUrl) {
17
+ return serverUrl
18
+ .replace(/^https?:\/\//, '')
19
+ .replace(/[:/?#]+/g, '_')
20
+ .replace(/_+$/, '');
21
+ }
22
+ export function sessionFileForServer(serverUrl, dir = defaultSessionDir()) {
23
+ return path.join(dir, `${slugForServer(serverUrl)}.json`);
24
+ }
25
+ /**
26
+ * Where an operator drops a `csa_` admin token for a hub (owner-only file,
27
+ * D816). The extension is not `.json`, so the newest-session fallback below
28
+ * never mistakes it for a session.
29
+ */
30
+ export function adminTokenFileForServer(serverUrl, dir = defaultSessionDir()) {
31
+ return path.join(dir, `${slugForServer(serverUrl)}.admin-token`);
32
+ }
33
+ /**
34
+ * The admin token file to use, or `undefined` when none exists: the path named
35
+ * by `$CAMSTACK_ADMIN_TOKEN_FILE` (a PATH, never the token), else the default
36
+ * file for `serverUrl`.
37
+ */
38
+ export function findAdminTokenFile(serverUrl, env = process.env, dir = defaultSessionDir()) {
39
+ const named = env['CAMSTACK_ADMIN_TOKEN_FILE'];
40
+ if (named && named.trim() !== '')
41
+ return named;
42
+ if (!serverUrl)
43
+ return undefined;
44
+ const candidate = adminTokenFileForServer(serverUrl, dir);
45
+ return fs.existsSync(candidate) ? candidate : undefined;
46
+ }
47
+ /**
48
+ * Resolve the right session file for the operator-supplied server URL.
49
+ * With no server, fall back to the most recently touched session — an
50
+ * operator typically works with one hub at a time.
51
+ */
52
+ function resolveSessionFile(serverUrl, dir) {
53
+ if (serverUrl) {
54
+ const p = sessionFileForServer(serverUrl, dir);
55
+ return fs.existsSync(p) ? p : null;
56
+ }
57
+ if (!fs.existsSync(dir))
58
+ return null;
59
+ const files = fs
60
+ .readdirSync(dir)
61
+ .filter((f) => f.endsWith('.json'))
62
+ .map((f) => path.join(dir, f));
63
+ if (files.length === 0)
64
+ return null;
65
+ return files
66
+ .map((f) => ({ f, mtime: fs.statSync(f).mtimeMs }))
67
+ .toSorted((a, b) => b.mtime - a.mtime)[0].f;
68
+ }
69
+ /**
70
+ * Shape check for a cached session blob. A partial or corrupted cache file
71
+ * (e.g. after a crashed login) is treated as "no session" instead of crashing
72
+ * a later `.slice` on undefined.
73
+ */
74
+ export function isSessionFile(value) {
75
+ if (value === null || typeof value !== 'object')
76
+ return false;
77
+ const v = value;
78
+ if (typeof v.server !== 'string')
79
+ return false;
80
+ if (typeof v.username !== 'string')
81
+ return false;
82
+ if (typeof v.token !== 'string')
83
+ return false;
84
+ if (typeof v.tokenId !== 'string')
85
+ return false;
86
+ if (typeof v.createdAt !== 'number')
87
+ return false;
88
+ if (!Array.isArray(v.scopes))
89
+ return false;
90
+ return true;
91
+ }
92
+ export function loadSession(serverUrl, dir = defaultSessionDir()) {
93
+ const file = resolveSessionFile(serverUrl, dir);
94
+ if (!file)
95
+ return null;
96
+ try {
97
+ const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
98
+ return isSessionFile(parsed) ? parsed : null;
99
+ }
100
+ catch {
101
+ return null;
102
+ }
103
+ }
104
+ export function saveSession(session, dir = defaultSessionDir()) {
105
+ if (!fs.existsSync(dir))
106
+ fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
107
+ const file = sessionFileForServer(session.server, dir);
108
+ fs.writeFileSync(file, JSON.stringify(session, null, 2), { mode: 0o600 });
109
+ return file;
110
+ }
111
+ export function clearSession(serverUrl, dir = defaultSessionDir()) {
112
+ const file = sessionFileForServer(serverUrl, dir);
113
+ if (!fs.existsSync(file))
114
+ return false;
115
+ fs.unlinkSync(file);
116
+ return true;
117
+ }
package/dist/index.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  /** @camstack/develop — shared developer tooling for CLI + MCP. */
2
2
  export type { AddonCapabilityRef, AddonManifestEntry, AddonPackageSummary, CapabilitySummary, ExampleEntry, ExampleHit, ExtendAddonOptions, ExtendAddonResult, ScaffoldAddonOptions, ScaffoldAddonResult, ScaffoldCapOptions, ScaffoldCapResult, SkillInfo, ValidationFinding, ValidationResult, WorkspacePaths, } from './types.js';
3
3
  export { findWorkspaceRoot, requireWorkspaceRoot, resolveWorkspacePaths, } from './workspace.js';
4
- export { toCamelName, toCapExportName, toClassName, toFileName } from './naming.js';
5
- export { findAddonPackage, listAddonPackages, whoProvides } from './catalogue/addons.js';
4
+ export { toCamelName, toCapExportName, toClassName, toFileName, } from './naming.js';
5
+ export { findAddonPackage, listAddonPackages, whoProvides, } from './catalogue/addons.js';
6
6
  export { getCapability, listCapabilities } from './catalogue/capabilities.js';
7
7
  export { CORE_EXAMPLES } from './examples/catalogue.js';
8
8
  export { findExample, listExamples } from './examples/find.js';
@@ -12,4 +12,16 @@ export { scaffoldAddon } from './scaffold/addon.js';
12
12
  export { scaffoldCapStub } from './scaffold/cap-stub.js';
13
13
  export { extendAddon } from './scaffold/extend.js';
14
14
  export { listSkills, readSkill, resolveSkillsDir } from './skills.js';
15
+ export { ADMIN_TOKEN_PREFIX, authRejectedHint, credentialTier, MissingCredentialsError, readTokenFile, resolveCredentials, withAuthHint, } from './hub/credentials.js';
16
+ export type { CachedSessionLike, CredentialInputs, CredentialSource, CredentialTier, ResolvedCredentials, TokenFileContents, } from './hub/credentials.js';
17
+ export { adminTokenFileForServer, clearSession, defaultSessionDir, findAdminTokenFile, isSessionFile, loadSession, saveSession, sessionFileForServer, slugForServer, } from './hub/session-store.js';
18
+ export type { SessionFile } from './hub/session-store.js';
19
+ export { adminCredentialHint, adminLoginCommand, adminRejectedHint, adminTokenMetaFileForServer, adminTokenStatus, readPreviousAdminToken, REPO_LOCAL_LOGIN_ADMIN, saveAdminToken, } from './hub/admin-token-store.js';
20
+ export type { AdminTokenMeta, AdminTokenStatus, PreviousAdminToken, } from './hub/admin-token-store.js';
21
+ export { resolveHubUrl } from './hub/hub-url.js';
22
+ export type { HubUrlInputs, HubUrlSource, ResolvedHubUrl, } from './hub/hub-url.js';
23
+ export { createHubAgent, explainTlsFailure, hubCaFileForServer, resolveHubTls, } from './hub/hub-tls.js';
24
+ export type { HubTlsConfig } from './hub/hub-tls.js';
25
+ export { createHubClient, encodeTrpcInput, HubHttpError, HubRpcError, nodeHubTransport, } from './hub/hub-client.js';
26
+ export type { HubClient, HubClientOptions, HubHttpMethod, HubTransport, HubTransportRequest, HubTransportResponse, } from './hub/hub-client.js';
15
27
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEnF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAIrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,YAAY,GACb,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,GACf,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACd,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA"}
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /** @camstack/develop — shared developer tooling for CLI + MCP. */
2
2
  export { findWorkspaceRoot, requireWorkspaceRoot, resolveWorkspacePaths, } from './workspace.js';
3
- export { toCamelName, toCapExportName, toClassName, toFileName } from './naming.js';
4
- export { findAddonPackage, listAddonPackages, whoProvides } from './catalogue/addons.js';
3
+ export { toCamelName, toCapExportName, toClassName, toFileName, } from './naming.js';
4
+ export { findAddonPackage, listAddonPackages, whoProvides, } from './catalogue/addons.js';
5
5
  export { getCapability, listCapabilities } from './catalogue/capabilities.js';
6
6
  export { CORE_EXAMPLES } from './examples/catalogue.js';
7
7
  export { findExample, listExamples } from './examples/find.js';
@@ -11,3 +11,11 @@ export { scaffoldAddon } from './scaffold/addon.js';
11
11
  export { scaffoldCapStub } from './scaffold/cap-stub.js';
12
12
  export { extendAddon } from './scaffold/extend.js';
13
13
  export { listSkills, readSkill, resolveSkillsDir } from './skills.js';
14
+ // Hub access — the one credential chain, session cache, address and TLS trust
15
+ // shared by the CLI, scripts/hub/hub.mjs and the operator MCP (D835).
16
+ export { ADMIN_TOKEN_PREFIX, authRejectedHint, credentialTier, MissingCredentialsError, readTokenFile, resolveCredentials, withAuthHint, } from './hub/credentials.js';
17
+ export { adminTokenFileForServer, clearSession, defaultSessionDir, findAdminTokenFile, isSessionFile, loadSession, saveSession, sessionFileForServer, slugForServer, } from './hub/session-store.js';
18
+ export { adminCredentialHint, adminLoginCommand, adminRejectedHint, adminTokenMetaFileForServer, adminTokenStatus, readPreviousAdminToken, REPO_LOCAL_LOGIN_ADMIN, saveAdminToken, } from './hub/admin-token-store.js';
19
+ export { resolveHubUrl } from './hub/hub-url.js';
20
+ export { createHubAgent, explainTlsFailure, hubCaFileForServer, resolveHubTls, } from './hub/hub-tls.js';
21
+ export { createHubClient, encodeTrpcInput, HubHttpError, HubRpcError, nodeHubTransport, } from './hub/hub-client.js';
@@ -1 +1 @@
1
- {"version":3,"file":"addon.d.ts","sourceRoot":"","sources":["../../src/scaffold/addon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAW5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAoFhF"}
1
+ {"version":3,"file":"addon.d.ts","sourceRoot":"","sources":["../../src/scaffold/addon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAa5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAwFhF"}
@@ -9,6 +9,8 @@ const KIND_EXAMPLE = {
9
9
  notifier: 'notifiers',
10
10
  osd: 'osd-manager',
11
11
  'post-analysis': 'post-analysis',
12
+ 'model-studio': 'model-studio',
13
+ 'admin-ui': 'admin-ui',
12
14
  };
13
15
  /**
14
16
  * Scaffold a new addon package under `packages/addon-<name>/`.
@@ -83,6 +85,10 @@ export function scaffoldAddon(options) {
83
85
  packageDir: projectRoot,
84
86
  relativeDir: path.relative(options.workspaceRoot, projectRoot),
85
87
  filesWritten: written,
88
+ contents: files.map((file) => ({
89
+ path: path.join(path.relative(options.workspaceRoot, projectRoot), file.relative),
90
+ content: file.content,
91
+ })),
86
92
  nextSteps: [
87
93
  `cd ${path.relative(options.workspaceRoot, projectRoot)}`,
88
94
  'Implement providers in onInitialize and declare caps in package.json',
@@ -2,7 +2,7 @@ import type { ScaffoldCapOptions, ScaffoldCapResult } from '../types.js';
2
2
  /**
3
3
  * Write a minimal `*.cap.ts` stub under packages/types. Does NOT edit
4
4
  * `capabilities/index.ts` or run codegen — those remain explicit next steps
5
- * (see add-capability skill).
5
+ * (see camstack-capability skill).
6
6
  */
7
7
  export declare function scaffoldCapStub(options: ScaffoldCapOptions): ScaffoldCapResult;
8
8
  //# sourceMappingURL=cap-stub.d.ts.map
@@ -4,7 +4,7 @@ import { toCapExportName, toClassName, toFileName } from '../naming.js';
4
4
  /**
5
5
  * Write a minimal `*.cap.ts` stub under packages/types. Does NOT edit
6
6
  * `capabilities/index.ts` or run codegen — those remain explicit next steps
7
- * (see add-capability skill).
7
+ * (see camstack-capability skill).
8
8
  */
9
9
  export function scaffoldCapStub(options) {
10
10
  const fileName = toFileName(options.name);
@@ -1 +1 @@
1
- {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI3C,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAaD,wBAAgB,UAAU,IAAI,SAAS,SAAS,EAAE,CAQjD;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKjF"}
1
+ {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI3C,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AA4BD,wBAAgB,UAAU,IAAI,SAAS,SAAS,EAAE,CAQjD;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMjF"}
package/dist/skills.js CHANGED
@@ -11,15 +11,29 @@ export function resolveSkillsDir() {
11
11
  return candidates[0];
12
12
  }
13
13
  const SKILL_FILES = [
14
- { id: 'add-addon', file: 'add-addon.md', title: 'Add or extend an addon' },
15
- { id: 'add-capability', file: 'add-capability.md', title: 'Add or change a capability' },
16
- { id: 'sync-docs', file: 'sync-docs.md', title: 'Keep documentation true' },
14
+ { id: 'camstack-addon', file: 'camstack-addon.md', title: 'Add or extend an addon' },
15
+ {
16
+ id: 'camstack-capability',
17
+ file: 'camstack-capability.md',
18
+ title: 'Add or change a capability',
19
+ },
20
+ { id: 'camstack-secrets', file: 'camstack-secrets.md', title: 'Secrets in an addon' },
21
+ { id: 'camstack-docs', file: 'camstack-docs.md', title: 'Keep documentation true' },
17
22
  {
18
23
  id: 'architecture',
19
24
  file: 'architecture.md',
20
25
  title: 'Architecture pointers for plugin authors',
21
26
  },
22
27
  ];
28
+ /**
29
+ * The ids before the 2026-10-09 rename to the server repository's skill names.
30
+ * Still accepted by `readSkill`, so a pinned agent prompt keeps working.
31
+ */
32
+ const SKILL_ALIASES = {
33
+ 'add-addon': 'camstack-addon',
34
+ 'add-capability': 'camstack-capability',
35
+ 'sync-docs': 'camstack-docs',
36
+ };
23
37
  export function listSkills() {
24
38
  const dir = resolveSkillsDir();
25
39
  return SKILL_FILES.map((s) => ({
@@ -30,7 +44,8 @@ export function listSkills() {
30
44
  }));
31
45
  }
32
46
  export function readSkill(id) {
33
- const info = listSkills().find((s) => s.id === id);
47
+ const canonical = SKILL_ALIASES[id] ?? id;
48
+ const info = listSkills().find((s) => s.id === canonical);
34
49
  if (!info)
35
50
  return null;
36
51
  if (!fs.existsSync(info.absolutePath))
package/dist/types.d.ts CHANGED
@@ -62,13 +62,18 @@ export interface ScaffoldAddonOptions {
62
62
  readonly description?: string;
63
63
  readonly directory?: string;
64
64
  /** Template flavour — empty skeleton, or a stub pointing at a core example. */
65
- readonly kind?: 'empty' | 'provider' | 'notifier' | 'osd' | 'post-analysis';
65
+ readonly kind?: 'empty' | 'provider' | 'notifier' | 'osd' | 'post-analysis' | 'model-studio' | 'admin-ui';
66
66
  readonly dryRun?: boolean;
67
67
  }
68
68
  export interface ScaffoldAddonResult {
69
69
  readonly packageDir: string;
70
70
  readonly relativeDir: string;
71
71
  readonly filesWritten: readonly string[];
72
+ /** Every file's content (workspace-relative path), written or not — for a dry-run diff. */
73
+ readonly contents?: readonly {
74
+ readonly path: string;
75
+ readonly content: string;
76
+ }[];
72
77
  readonly nextSteps: readonly string[];
73
78
  }
74
79
  export interface ScaffoldCapOptions {
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/develop",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "CamStack developer tooling — catalogue, scaffold, validate, and example lookup shared by the CLI and MCP server.",
5
5
  "keywords": [
6
6
  "camstack",
package/skills/README.md CHANGED
@@ -6,11 +6,19 @@ third-party use (no private hostnames, no hub-specific ops).
6
6
 
7
7
  | Skill | File | Job |
8
8
  | --- | --- | --- |
9
- | `add-addon` | [add-addon.md](./add-addon.md) | New or extended addon |
10
- | `add-capability` | [add-capability.md](./add-capability.md) | New or changed `*.cap.ts` |
11
- | `sync-docs` | [sync-docs.md](./sync-docs.md) | Generated vs prose docs |
9
+ | `camstack-addon` | [camstack-addon.md](./camstack-addon.md) | New or extended addon |
10
+ | `camstack-capability` | [camstack-capability.md](./camstack-capability.md) | New or changed `*.cap.ts` |
11
+ | `camstack-secrets` | [camstack-secrets.md](./camstack-secrets.md) | Password / token / key fields |
12
+ | `camstack-docs` | [camstack-docs.md](./camstack-docs.md) | Generated vs prose docs |
12
13
  | `architecture` | [architecture.md](./architecture.md) | Plugin-author architecture pointers |
13
14
 
15
+ These files are the canonical public text. In the server repository the
16
+ matching `.claude/skills/<id>/SKILL.md` is an overlay that points here and keeps
17
+ only repository rules (`scripts/check-skill-pack-sync.ts` enforces it, D837).
18
+ The ids match the server repository's `.claude/skills/<id>/` skills (renamed
19
+ on 2026-10-09); the old ids `add-addon`, `add-capability` and `sync-docs` still
20
+ resolve as aliases.
21
+
14
22
  ## How to use
15
23
 
16
24
  ### CLI
@@ -18,7 +26,7 @@ third-party use (no private hostnames, no hub-specific ops).
18
26
  ```bash
19
27
  # From a camstack-server checkout:
20
28
  camstack develop skills
21
- camstack develop skill add-addon
29
+ camstack develop skill camstack-addon
22
30
 
23
31
  # Scaffold / validate with the same tooling agents should call:
24
32
  camstack develop scaffold addon my-feature --kind provider