joycraft 0.7.12 → 0.7.14

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.
Files changed (54) hide show
  1. package/README.md +30 -16
  2. package/dist/chunk-7BPB2IKY.js +255 -0
  3. package/dist/chunk-7BPB2IKY.js.map +1 -0
  4. package/dist/chunk-B73DPYYC.js +377 -0
  5. package/dist/chunk-B73DPYYC.js.map +1 -0
  6. package/dist/{chunk-DSVGHVYM.js → chunk-JYPBXPGD.js} +117 -90
  7. package/dist/chunk-JYPBXPGD.js.map +1 -0
  8. package/dist/{chunk-OAC5CVHJ.js → chunk-K4AI6FKB.js} +12 -2
  9. package/dist/chunk-K4AI6FKB.js.map +1 -0
  10. package/dist/{chunk-PBOICMDE.js → chunk-KKDKC4FM.js} +11 -73
  11. package/dist/chunk-KKDKC4FM.js.map +1 -0
  12. package/dist/chunk-OMFGDJW4.js +97 -0
  13. package/dist/chunk-OMFGDJW4.js.map +1 -0
  14. package/dist/chunk-PR4QDKPL.js +3755 -0
  15. package/dist/chunk-PR4QDKPL.js.map +1 -0
  16. package/dist/chunk-Z5JFEGWG.js +563 -0
  17. package/dist/chunk-Z5JFEGWG.js.map +1 -0
  18. package/dist/cli.js +389 -56
  19. package/dist/cli.js.map +1 -1
  20. package/dist/index.d.ts +235 -1
  21. package/dist/index.js +691 -1
  22. package/dist/index.js.map +1 -1
  23. package/dist/init-S5JU5BHL.js +60 -0
  24. package/dist/init-S5JU5BHL.js.map +1 -0
  25. package/dist/{init-autofix-YCSDK5ZR.js → init-autofix-WSKUT2HN.js} +4 -3
  26. package/dist/{init-autofix-YCSDK5ZR.js.map → init-autofix-WSKUT2HN.js.map} +1 -1
  27. package/dist/install-manifest-EQHT4474.js +37 -0
  28. package/dist/joycraft-release.json +8 -0
  29. package/dist/release-artifact-4TL5L2ZY.js +14 -0
  30. package/dist/release-resolver-P2H46QTU.js +293 -0
  31. package/dist/release-resolver-P2H46QTU.js.map +1 -0
  32. package/dist/{telemetry-store-X7K5NYWD.js → telemetry-store-IBO5GRTA.js} +2 -2
  33. package/dist/telemetry-store-IBO5GRTA.js.map +1 -0
  34. package/dist/update-HNTXCEKB.js +19 -0
  35. package/dist/update-HNTXCEKB.js.map +1 -0
  36. package/dist/update-check-YT765NE7.js +36 -0
  37. package/dist/update-check-YT765NE7.js.map +1 -0
  38. package/dist/upgrade-LZOND7OZ.js +28 -0
  39. package/dist/upgrade-LZOND7OZ.js.map +1 -0
  40. package/package.json +5 -2
  41. package/dist/chunk-BZW5DR3O.js +0 -91
  42. package/dist/chunk-BZW5DR3O.js.map +0 -1
  43. package/dist/chunk-DSVGHVYM.js.map +0 -1
  44. package/dist/chunk-OAC5CVHJ.js.map +0 -1
  45. package/dist/chunk-PBOICMDE.js.map +0 -1
  46. package/dist/chunk-Q2ZQ6RGD.js +0 -243
  47. package/dist/chunk-Q2ZQ6RGD.js.map +0 -1
  48. package/dist/init-J5Q6RX3K.js +0 -1307
  49. package/dist/init-J5Q6RX3K.js.map +0 -1
  50. package/dist/upgrade-AHUSQZEQ.js +0 -643
  51. package/dist/upgrade-AHUSQZEQ.js.map +0 -1
  52. package/dist/version-B2CCAEMC.js +0 -28
  53. /package/dist/{telemetry-store-X7K5NYWD.js.map → install-manifest-EQHT4474.js.map} +0 -0
  54. /package/dist/{version-B2CCAEMC.js.map → release-artifact-4TL5L2ZY.js.map} +0 -0
@@ -0,0 +1,293 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ fetchVerifiedReleaseArtifact,
4
+ isVerifiedReleaseArtifact
5
+ } from "./chunk-7BPB2IKY.js";
6
+
7
+ // src/release-resolver.ts
8
+ import { spawnSync } from "child_process";
9
+ import { mkdtempSync, rmSync, statSync, writeFileSync } from "fs";
10
+ import { dirname, join } from "path";
11
+ import { tmpdir } from "os";
12
+ var DEFAULT_REGISTRY = "https://registry.npmjs.org";
13
+ var DEFAULT_TIMEOUT_MS = 3e3;
14
+ var EXACT_VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(?:0|[1-9]\d*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
15
+ var PACKAGE_NAME = /^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/i;
16
+ var SHA512_INTEGRITY = /^sha512-([A-Za-z0-9+/]+={0,2})$/;
17
+ function invalid(error) {
18
+ return { ok: false, status: "invalid", error };
19
+ }
20
+ function unknown(error) {
21
+ return { ok: false, status: "unknown", error };
22
+ }
23
+ function assertPackageName(packageName) {
24
+ if (typeof packageName !== "string" || !PACKAGE_NAME.test(packageName)) {
25
+ throw new Error(`Invalid npm package name '${String(packageName)}'.`);
26
+ }
27
+ }
28
+ function assertExactVersion(version) {
29
+ if (typeof version !== "string" || !EXACT_VERSION.test(version)) {
30
+ throw new Error(`Release version must be an exact stable or prerelease semver, received '${String(version)}'.`);
31
+ }
32
+ }
33
+ function assertArgument(value, label) {
34
+ if (typeof value !== "string" || value.includes("\0")) {
35
+ throw new Error(`${label} must contain only NUL-free strings.`);
36
+ }
37
+ }
38
+ function assertIntegrity(integrity) {
39
+ if (typeof integrity !== "string") throw new Error("Release metadata is missing a sha512 integrity value.");
40
+ const match = SHA512_INTEGRITY.exec(integrity);
41
+ if (!match) throw new Error("Release metadata integrity must use npm sha512 SRI.");
42
+ const encoded = match[1];
43
+ const decoded = Buffer.from(encoded, "base64");
44
+ if (decoded.length !== 64 || decoded.toString("base64") !== encoded) {
45
+ throw new Error("Release metadata integrity is not a canonical sha512 SRI value.");
46
+ }
47
+ }
48
+ function assertTarballUrl(tarball) {
49
+ if (typeof tarball !== "string") throw new Error("Release metadata is missing a tarball URL.");
50
+ let parsed;
51
+ try {
52
+ parsed = new URL(tarball);
53
+ } catch {
54
+ throw new Error("Release metadata tarball URL is invalid.");
55
+ }
56
+ if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
57
+ throw new Error("Release metadata tarball URL must use http or https.");
58
+ }
59
+ if (parsed.username || parsed.password) {
60
+ throw new Error("Release metadata tarball URL must not contain credentials.");
61
+ }
62
+ }
63
+ function registryUrl(registry) {
64
+ let parsed;
65
+ try {
66
+ parsed = new URL(registry);
67
+ } catch {
68
+ throw new Error(`Registry URL is invalid: '${registry}'.`);
69
+ }
70
+ if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
71
+ throw new Error("Registry URL must use http or https.");
72
+ }
73
+ if (parsed.username || parsed.password || parsed.search || parsed.hash) {
74
+ throw new Error("Registry URL must not contain credentials, query parameters, or fragments.");
75
+ }
76
+ return parsed.toString().replace(/\/$/, "");
77
+ }
78
+ function metadataVersion(metadata, packageName, version) {
79
+ if (metadata.name !== void 0 && metadata.name !== packageName) {
80
+ throw new Error(`Registry metadata package name '${String(metadata.name)}' does not match '${packageName}'.`);
81
+ }
82
+ const versions = metadata.versions;
83
+ if (!versions || typeof versions !== "object" || Array.isArray(versions)) {
84
+ throw new Error(`Registry metadata has no version '${version}'.`);
85
+ }
86
+ const record = versions[version];
87
+ if (!record || typeof record !== "object" || Array.isArray(record)) {
88
+ throw new Error(`Registry metadata has no version '${version}'.`);
89
+ }
90
+ if (record.name !== void 0 && record.name !== packageName) {
91
+ throw new Error(`Registry metadata package name '${String(record.name)}' does not match '${packageName}'.`);
92
+ }
93
+ if (record.version !== void 0 && record.version !== version) {
94
+ throw new Error(`Registry metadata version '${String(record.version)}' does not match '${version}'.`);
95
+ }
96
+ const dist = record.dist;
97
+ if (!dist || typeof dist !== "object" || Array.isArray(dist)) {
98
+ throw new Error(`Registry metadata for '${packageName}@${version}' has no dist record.`);
99
+ }
100
+ assertIntegrity(dist.integrity);
101
+ assertTarballUrl(dist.tarball);
102
+ return { packageName, version, integrity: dist.integrity, tarballUrl: dist.tarball };
103
+ }
104
+ function validateExactReleaseMetadata(metadata, packageName, version) {
105
+ assertPackageName(packageName);
106
+ assertExactVersion(version);
107
+ return metadataVersion(metadata, packageName, version);
108
+ }
109
+ async function resolveExactRelease(options = {}) {
110
+ const packageName = options.packageName ?? "joycraft";
111
+ try {
112
+ assertPackageName(packageName);
113
+ if (options.version !== void 0) assertExactVersion(options.version);
114
+ const registry = registryUrl(options.registry ?? DEFAULT_REGISTRY);
115
+ const url = `${registry}/${encodeURIComponent(packageName)}`;
116
+ const fetchMetadata = options.fetchMetadata ?? (async (requestUrl, init) => {
117
+ const response = await fetch(requestUrl, init);
118
+ if (!response.ok) throw new Error(`Registry request failed with HTTP ${response.status}.`);
119
+ return response.json();
120
+ });
121
+ const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
122
+ if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) return invalid("Registry timeout must be a positive integer.");
123
+ let metadata;
124
+ try {
125
+ metadata = await fetchMetadata(url, { signal: AbortSignal.timeout(timeoutMs) });
126
+ } catch (error) {
127
+ const message = error instanceof Error ? error.message : String(error);
128
+ return unknown(message);
129
+ }
130
+ if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
131
+ return invalid("Registry returned invalid package metadata.");
132
+ }
133
+ const packageMetadata = metadata;
134
+ let version = options.version;
135
+ if (version === void 0) {
136
+ const latest = packageMetadata["dist-tags"]?.latest;
137
+ try {
138
+ assertExactVersion(latest);
139
+ } catch (error) {
140
+ return invalid(error instanceof Error ? error.message : String(error));
141
+ }
142
+ version = latest;
143
+ }
144
+ return { ok: true, release: validateExactReleaseMetadata(packageMetadata, packageName, version) };
145
+ } catch (error) {
146
+ const message = error instanceof Error ? error.message : String(error);
147
+ return invalid(message);
148
+ }
149
+ }
150
+ function defaultProcessAdapter() {
151
+ return {
152
+ spawn: (command, args, options) => {
153
+ const child = spawnSync(command, args, options);
154
+ return { status: child.status, signal: child.signal, error: child.error };
155
+ }
156
+ };
157
+ }
158
+ function resolveWindowsNpmCliPath(explicit, env) {
159
+ const isRegularNpmCli = (candidate) => {
160
+ const filename = candidate.replaceAll("\\", "/").split("/").pop()?.toLowerCase();
161
+ if (filename !== "npm-cli.js") return false;
162
+ try {
163
+ return statSync(candidate).isFile();
164
+ } catch {
165
+ return false;
166
+ }
167
+ };
168
+ if (explicit !== void 0) {
169
+ if (isRegularNpmCli(explicit)) return explicit;
170
+ throw new Error("npmCliPath must point to a regular npm-cli.js file.");
171
+ }
172
+ const candidates = [];
173
+ const add = (candidate) => {
174
+ if (!candidate || candidate.length === 0) return;
175
+ const filename = candidate.replaceAll("\\", "/").split("/").pop()?.toLowerCase();
176
+ if (filename !== "npm-cli.js") return;
177
+ candidates.push(candidate);
178
+ };
179
+ const addPrefix = (prefix) => {
180
+ if (!prefix) return;
181
+ add(join(prefix, "node_modules", "npm", "bin", "npm-cli.js"));
182
+ };
183
+ add(explicit);
184
+ add(env.npm_execpath);
185
+ add(join(dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js"));
186
+ addPrefix(env.npm_config_prefix);
187
+ addPrefix(env.PREFIX);
188
+ addPrefix(env.APPDATA ? join(env.APPDATA, "npm") : void 0);
189
+ addPrefix(env.ProgramFiles ? join(env.ProgramFiles, "nodejs") : void 0);
190
+ const pathValue = env.Path ?? env.PATH;
191
+ if (pathValue) for (const pathEntry of pathValue.split(";")) addPrefix(pathEntry);
192
+ const found = candidates.find(isRegularNpmCli);
193
+ if (found) return found;
194
+ throw new Error("Unable to locate npm-cli.js for Windows execution; provide npmCliPath or install npm alongside Node.js.");
195
+ }
196
+ function validateArgs(args, label) {
197
+ if (!Array.isArray(args)) throw new Error(`${label} must be an argument array.`);
198
+ for (const value of args) assertArgument(value, label);
199
+ return [...args];
200
+ }
201
+ function validateLocalBundle(bundle) {
202
+ assertArgument(bundle, "Local bundle");
203
+ if (bundle.trim().length === 0) throw new Error("Local bundle must not be empty.");
204
+ }
205
+ function runFailure(error) {
206
+ return { ok: false, status: null, error: error instanceof Error ? error.message : String(error) };
207
+ }
208
+ function runExactRelease(options) {
209
+ try {
210
+ const platform = options.platform ?? process.platform;
211
+ const env = options.env ?? process.env;
212
+ const command = platform === "win32" ? process.execPath : "npm";
213
+ if (options.release && options.localBundle) throw new Error("Specify either a verified release or a local bundle, not both.");
214
+ if (!options.release && !options.localBundle) throw new Error("An exact release or explicit local bundle is required.");
215
+ let packageSpec = options.localBundle;
216
+ if (packageSpec !== void 0) {
217
+ validateLocalBundle(packageSpec);
218
+ } else {
219
+ const release = options.release;
220
+ const validated = validateExactReleaseMetadata({
221
+ name: release.packageName,
222
+ versions: { [release.version]: { name: release.packageName, version: release.version, dist: { integrity: release.integrity, tarball: release.tarballUrl } } }
223
+ }, release.packageName, release.version);
224
+ if (validated.integrity !== release.integrity || validated.tarballUrl !== release.tarballUrl) {
225
+ throw new Error("Release facts failed exact metadata validation.");
226
+ }
227
+ validateLocalBundle(`${release.packageName}@${release.version}`);
228
+ packageSpec = `${release.packageName}@${release.version}`;
229
+ }
230
+ const commandArgs = validateArgs(options.commandArgs ?? ["update"], "Command arguments");
231
+ if (options.projectPath !== void 0) {
232
+ assertArgument(options.projectPath, "Project path");
233
+ commandArgs.push(options.projectPath);
234
+ }
235
+ const npmArgs = ["exec", "--yes", "--", packageSpec, ...commandArgs];
236
+ const args = platform === "win32" ? [resolveWindowsNpmCliPath(options.npmCliPath, env), ...npmArgs] : npmArgs;
237
+ const adapter = options.processAdapter ?? defaultProcessAdapter();
238
+ const processResult = adapter.spawn(command, args, {
239
+ ...options.cwd === void 0 ? {} : { cwd: options.cwd },
240
+ ...options.env === void 0 ? {} : { env: options.env },
241
+ shell: false,
242
+ stdio: "inherit"
243
+ });
244
+ if (processResult.error) {
245
+ return { ok: false, status: processResult.status, command, args, error: processResult.error instanceof Error ? processResult.error.message : String(processResult.error) };
246
+ }
247
+ if (processResult.status !== 0) {
248
+ return { ok: false, status: processResult.status, command, args, error: processResult.signal ? `npm exec terminated by ${processResult.signal}.` : `npm exec exited with status ${String(processResult.status)}.` };
249
+ }
250
+ return { ok: true, status: 0, command, args };
251
+ } catch (error) {
252
+ return runFailure(error);
253
+ }
254
+ }
255
+ function runVerifiedExactRelease(options) {
256
+ if (!isVerifiedReleaseArtifact(options.artifact)) return runFailure(new Error("A verified release artifact is required."));
257
+ const directory = options.retainTarballPath === void 0 ? mkdtempSync(join(tmpdir(), "joycraft-verified-release-")) : void 0;
258
+ const bundlePath = options.retainTarballPath ?? join(directory, "package.tgz");
259
+ try {
260
+ writeFileSync(bundlePath, options.artifact.tarball, { flag: options.retainTarballPath === void 0 ? "w" : "wx", mode: 384 });
261
+ const commandArgs = [...options.commandArgs ?? ["update"]];
262
+ if (options.autoSafe !== false) {
263
+ for (const flag of ["--auto-safe", "--non-interactive", "--json"]) if (!commandArgs.includes(flag)) commandArgs.push(flag);
264
+ }
265
+ return runExactRelease({
266
+ ...options,
267
+ localBundle: bundlePath,
268
+ commandArgs
269
+ });
270
+ } catch (error) {
271
+ return runFailure(error);
272
+ } finally {
273
+ if (directory !== void 0) rmSync(directory, { recursive: true, force: true });
274
+ }
275
+ }
276
+ async function resolveAndRunExactRelease(options = {}) {
277
+ const resolution = await resolveExactRelease(options);
278
+ if (!resolution.ok) return runFailure(new Error(resolution.error));
279
+ try {
280
+ const artifact = await fetchVerifiedReleaseArtifact(resolution.release, options);
281
+ return runVerifiedExactRelease({ ...options, artifact });
282
+ } catch (error) {
283
+ return runFailure(error);
284
+ }
285
+ }
286
+ export {
287
+ resolveAndRunExactRelease,
288
+ resolveExactRelease,
289
+ runExactRelease,
290
+ runVerifiedExactRelease,
291
+ validateExactReleaseMetadata
292
+ };
293
+ //# sourceMappingURL=release-resolver-P2H46QTU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/release-resolver.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { mkdtempSync, rmSync, statSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { tmpdir } from 'node:os';\n\nimport {\n fetchVerifiedReleaseArtifact,\n isVerifiedReleaseArtifact,\n type FetchVerifiedReleaseArtifactOptions,\n type VerifiedReleaseArtifact,\n} from './release-artifact.js';\n\n/** The npm metadata fields needed to run one exact package release. */\nexport interface ReleaseVersionMetadata {\n name?: unknown;\n version?: unknown;\n dist?: {\n integrity?: unknown;\n tarball?: unknown;\n };\n}\n\n/** The subset of npm's package metadata used by the exact resolver. */\nexport interface ReleaseMetadata {\n name?: unknown;\n 'dist-tags'?: Record<string, unknown>;\n versions?: Record<string, ReleaseVersionMetadata>;\n}\n\nexport interface ExactRelease {\n packageName: string;\n version: string;\n /** npm's canonical Subresource Integrity value, e.g. sha512-<base64>. */\n integrity: string;\n tarballUrl: string;\n}\n\nexport interface ReleaseResolutionSuccess {\n ok: true;\n release: ExactRelease;\n}\n\nexport interface ReleaseResolutionFailure {\n ok: false;\n status: 'unknown' | 'invalid';\n error: string;\n}\n\nexport type ReleaseResolution = ReleaseResolutionSuccess | ReleaseResolutionFailure;\n\nexport type MetadataFetcher = (url: string, init?: RequestInit) => Promise<unknown>;\n\nexport interface ResolveExactReleaseOptions {\n packageName?: string;\n /** An exact semver, including an optional prerelease; ranges and tags are rejected. */\n version?: string;\n registry?: string;\n fetchMetadata?: MetadataFetcher;\n timeoutMs?: number;\n}\n\nexport interface ReleaseProcessResult {\n status: number | null;\n signal?: NodeJS.Signals | null;\n error?: Error | string;\n}\n\nexport interface ReleaseProcessAdapter {\n spawn: (\n command: string,\n args: string[],\n options: {\n cwd?: string;\n env?: NodeJS.ProcessEnv;\n shell: false;\n stdio: 'inherit';\n },\n ) => ReleaseProcessResult;\n}\n\nexport interface RunExactReleaseOptions {\n /** Release facts returned by resolveExactRelease. */\n release?: ExactRelease;\n /** Explicit local tarball/path. Supplying this bypasses all registry resolution. */\n localBundle?: string;\n projectPath?: string;\n commandArgs?: readonly string[];\n processAdapter?: ReleaseProcessAdapter;\n platform?: NodeJS.Platform;\n /** Test seam and explicit installation override for Windows npm-cli.js lookup. */\n npmCliPath?: string;\n cwd?: string;\n env?: NodeJS.ProcessEnv;\n}\n\nexport interface RunExactReleaseSuccess {\n ok: true;\n status: 0;\n command: string;\n args: string[];\n}\n\nexport interface RunExactReleaseFailure {\n ok: false;\n status: number | null;\n command?: string;\n args?: string[];\n error: string;\n}\n\nexport type RunExactReleaseResult = RunExactReleaseSuccess | RunExactReleaseFailure;\n\nexport interface RunVerifiedExactReleaseOptions extends Omit<RunExactReleaseOptions, 'release' | 'localBundle'> {\n /** Verifier-issued artifact; caller booleans cannot satisfy this boundary. */\n artifact: VerifiedReleaseArtifact;\n /** Keep a copy at this path instead of using a temporary retained bundle. */\n retainTarballPath?: string;\n /** Add the automatic update gate flags to the exact command. */\n autoSafe?: boolean;\n}\n\nexport interface ResolveAndRunExactReleaseOptions extends Omit<RunVerifiedExactReleaseOptions, 'artifact'>, ResolveExactReleaseOptions, FetchVerifiedReleaseArtifactOptions {\n /** Additional arguments after the updater command. */\n commandArgs?: readonly string[];\n}\n\nconst DEFAULT_REGISTRY = 'https://registry.npmjs.org';\nconst DEFAULT_TIMEOUT_MS = 3_000;\n\n// npm accepts semver identifiers made from ASCII alphanumerics and hyphens.\n// Keep the parser local so a release specifier cannot contain npm operators,\n// whitespace, a shell metacharacter, or an argument separator.\nconst EXACT_VERSION = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/;\nconst PACKAGE_NAME = /^(?:@[a-z0-9._~-]+\\/)?[a-z0-9._~-]+$/i;\nconst SHA512_INTEGRITY = /^sha512-([A-Za-z0-9+/]+={0,2})$/;\n\nfunction invalid(error: string): ReleaseResolutionFailure {\n return { ok: false, status: 'invalid', error };\n}\n\nfunction unknown(error: string): ReleaseResolutionFailure {\n return { ok: false, status: 'unknown', error };\n}\n\nfunction assertPackageName(packageName: unknown): asserts packageName is string {\n if (typeof packageName !== 'string' || !PACKAGE_NAME.test(packageName)) {\n throw new Error(`Invalid npm package name '${String(packageName)}'.`);\n }\n}\n\nfunction assertExactVersion(version: unknown): asserts version is string {\n if (typeof version !== 'string' || !EXACT_VERSION.test(version)) {\n throw new Error(`Release version must be an exact stable or prerelease semver, received '${String(version)}'.`);\n }\n}\n\nfunction assertArgument(value: unknown, label: string): asserts value is string {\n if (typeof value !== 'string' || value.includes('\\0')) {\n throw new Error(`${label} must contain only NUL-free strings.`);\n }\n}\n\nfunction assertIntegrity(integrity: unknown): asserts integrity is string {\n if (typeof integrity !== 'string') throw new Error('Release metadata is missing a sha512 integrity value.');\n const match = SHA512_INTEGRITY.exec(integrity);\n if (!match) throw new Error('Release metadata integrity must use npm sha512 SRI.');\n const encoded = match[1];\n const decoded = Buffer.from(encoded, 'base64');\n if (decoded.length !== 64 || decoded.toString('base64') !== encoded) {\n throw new Error('Release metadata integrity is not a canonical sha512 SRI value.');\n }\n}\n\nfunction assertTarballUrl(tarball: unknown): asserts tarball is string {\n if (typeof tarball !== 'string') throw new Error('Release metadata is missing a tarball URL.');\n let parsed: URL;\n try {\n parsed = new URL(tarball);\n } catch {\n throw new Error('Release metadata tarball URL is invalid.');\n }\n if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n throw new Error('Release metadata tarball URL must use http or https.');\n }\n if (parsed.username || parsed.password) {\n throw new Error('Release metadata tarball URL must not contain credentials.');\n }\n}\n\nfunction registryUrl(registry: string): string {\n let parsed: URL;\n try {\n parsed = new URL(registry);\n } catch {\n throw new Error(`Registry URL is invalid: '${registry}'.`);\n }\n if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {\n throw new Error('Registry URL must use http or https.');\n }\n if (parsed.username || parsed.password || parsed.search || parsed.hash) {\n throw new Error('Registry URL must not contain credentials, query parameters, or fragments.');\n }\n return parsed.toString().replace(/\\/$/, '');\n}\n\nfunction metadataVersion(metadata: ReleaseMetadata, packageName: string, version: string): ExactRelease {\n if (metadata.name !== undefined && metadata.name !== packageName) {\n throw new Error(`Registry metadata package name '${String(metadata.name)}' does not match '${packageName}'.`);\n }\n const versions = metadata.versions;\n if (!versions || typeof versions !== 'object' || Array.isArray(versions)) {\n throw new Error(`Registry metadata has no version '${version}'.`);\n }\n const record = versions[version];\n if (!record || typeof record !== 'object' || Array.isArray(record)) {\n throw new Error(`Registry metadata has no version '${version}'.`);\n }\n if (record.name !== undefined && record.name !== packageName) {\n throw new Error(`Registry metadata package name '${String(record.name)}' does not match '${packageName}'.`);\n }\n if (record.version !== undefined && record.version !== version) {\n throw new Error(`Registry metadata version '${String(record.version)}' does not match '${version}'.`);\n }\n const dist = record.dist;\n if (!dist || typeof dist !== 'object' || Array.isArray(dist)) {\n throw new Error(`Registry metadata for '${packageName}@${version}' has no dist record.`);\n }\n assertIntegrity(dist.integrity);\n assertTarballUrl(dist.tarball);\n return { packageName, version, integrity: dist.integrity, tarballUrl: dist.tarball };\n}\n\n/** Validate an exact npm metadata record without performing a network request. */\nexport function validateExactReleaseMetadata(\n metadata: ReleaseMetadata,\n packageName: string,\n version: string,\n): ExactRelease {\n assertPackageName(packageName);\n assertExactVersion(version);\n return metadataVersion(metadata, packageName, version);\n}\n\n/**\n * Resolve one exact release from one package metadata response.\n *\n * A missing version chooses only the registry's `latest` tag and immediately\n * turns that tag into an exact version. The result contains all facts needed\n * by the runner, so the update engine never needs to resolve `latest` again.\n */\nexport async function resolveExactRelease(options: ResolveExactReleaseOptions = {}): Promise<ReleaseResolution> {\n const packageName = options.packageName ?? 'joycraft';\n try {\n assertPackageName(packageName);\n if (options.version !== undefined) assertExactVersion(options.version);\n const registry = registryUrl(options.registry ?? DEFAULT_REGISTRY);\n const url = `${registry}/${encodeURIComponent(packageName)}`;\n const fetchMetadata = options.fetchMetadata ?? (async (requestUrl: string, init?: RequestInit): Promise<unknown> => {\n const response = await fetch(requestUrl, init);\n if (!response.ok) throw new Error(`Registry request failed with HTTP ${response.status}.`);\n return response.json();\n });\n const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) return invalid('Registry timeout must be a positive integer.');\n let metadata: unknown;\n try {\n metadata = await fetchMetadata(url, { signal: AbortSignal.timeout(timeoutMs) });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n return unknown(message);\n }\n if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {\n return invalid('Registry returned invalid package metadata.');\n }\n const packageMetadata = metadata as ReleaseMetadata;\n let version = options.version;\n if (version === undefined) {\n const latest = packageMetadata['dist-tags']?.latest;\n try { assertExactVersion(latest); } catch (error) {\n return invalid(error instanceof Error ? error.message : String(error));\n }\n version = latest;\n }\n return { ok: true, release: validateExactReleaseMetadata(packageMetadata, packageName, version) };\n } catch (error) {\n // Malformed caller/configuration or registry data is invalid. Transport\n // failures are returned from the fetch boundary above as unknown. No\n // fallback or synthetic version is ever returned.\n const message = error instanceof Error ? error.message : String(error);\n return invalid(message);\n }\n}\n\nfunction defaultProcessAdapter(): ReleaseProcessAdapter {\n return {\n spawn: (command, args, options) => {\n const child = spawnSync(command, args, options);\n return { status: child.status, signal: child.signal, error: child.error };\n },\n };\n}\n\nfunction resolveWindowsNpmCliPath(explicit: string | undefined, env: NodeJS.ProcessEnv): string {\n const isRegularNpmCli = (candidate: string): boolean => {\n const filename = candidate.replaceAll('\\\\', '/').split('/').pop()?.toLowerCase();\n if (filename !== 'npm-cli.js') return false;\n try { return statSync(candidate).isFile(); } catch { return false; }\n };\n if (explicit !== undefined) {\n if (isRegularNpmCli(explicit)) return explicit;\n throw new Error('npmCliPath must point to a regular npm-cli.js file.');\n }\n const candidates: string[] = [];\n const add = (candidate: string | undefined): void => {\n if (!candidate || candidate.length === 0) return;\n // npm_execpath is also set by pnpm and yarn. Only npm's actual JS CLI is\n // safe to pass the npm argument vector intended by this runner.\n const filename = candidate.replaceAll('\\\\', '/').split('/').pop()?.toLowerCase();\n if (filename !== 'npm-cli.js') return;\n candidates.push(candidate);\n };\n const addPrefix = (prefix: string | undefined): void => {\n if (!prefix) return;\n add(join(prefix, 'node_modules', 'npm', 'bin', 'npm-cli.js'));\n };\n\n add(explicit);\n add(env.npm_execpath);\n add(join(dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js'));\n addPrefix(env.npm_config_prefix);\n addPrefix(env.PREFIX);\n addPrefix(env.APPDATA ? join(env.APPDATA, 'npm') : undefined);\n addPrefix(env.ProgramFiles ? join(env.ProgramFiles, 'nodejs') : undefined);\n const pathValue = env.Path ?? env.PATH;\n if (pathValue) for (const pathEntry of pathValue.split(';')) addPrefix(pathEntry);\n\n const found = candidates.find(isRegularNpmCli);\n if (found) return found;\n throw new Error('Unable to locate npm-cli.js for Windows execution; provide npmCliPath or install npm alongside Node.js.');\n}\n\nfunction validateArgs(args: readonly string[], label: string): string[] {\n if (!Array.isArray(args)) throw new Error(`${label} must be an argument array.`);\n for (const value of args) assertArgument(value, label);\n return [...args];\n}\n\nfunction validateLocalBundle(bundle: unknown): asserts bundle is string {\n assertArgument(bundle, 'Local bundle');\n if (bundle.trim().length === 0) throw new Error('Local bundle must not be empty.');\n}\n\nfunction runFailure(error: unknown): RunExactReleaseFailure {\n return { ok: false, status: null, error: error instanceof Error ? error.message : String(error) };\n}\n\n/**\n * Run the exact package bundle selected by the resolver, or an explicit local\n * bundle. npm receives an argv array and shell execution is disabled.\n */\nexport function runExactRelease(options: RunExactReleaseOptions): RunExactReleaseResult {\n try {\n const platform = options.platform ?? process.platform;\n const env = options.env ?? process.env;\n const command = platform === 'win32' ? process.execPath : 'npm';\n if (options.release && options.localBundle) throw new Error('Specify either a verified release or a local bundle, not both.');\n if (!options.release && !options.localBundle) throw new Error('An exact release or explicit local bundle is required.');\n let packageSpec = options.localBundle;\n if (packageSpec !== undefined) {\n validateLocalBundle(packageSpec);\n } else {\n const release = options.release!;\n const validated = validateExactReleaseMetadata({\n name: release.packageName,\n versions: { [release.version]: { name: release.packageName, version: release.version, dist: { integrity: release.integrity, tarball: release.tarballUrl } } },\n }, release.packageName, release.version);\n if (validated.integrity !== release.integrity || validated.tarballUrl !== release.tarballUrl) {\n throw new Error('Release facts failed exact metadata validation.');\n }\n validateLocalBundle(`${release.packageName}@${release.version}`);\n // The npm package spec is assembled only from validated package/version\n // fields and is placed after `--`, so package names cannot become npm flags.\n packageSpec = `${release.packageName}@${release.version}`;\n }\n const commandArgs = validateArgs(options.commandArgs ?? ['update'], 'Command arguments');\n if (options.projectPath !== undefined) {\n assertArgument(options.projectPath, 'Project path');\n commandArgs.push(options.projectPath);\n }\n const npmArgs = ['exec', '--yes', '--', packageSpec, ...commandArgs];\n const args = platform === 'win32' ? [resolveWindowsNpmCliPath(options.npmCliPath, env), ...npmArgs] : npmArgs;\n const adapter = options.processAdapter ?? defaultProcessAdapter();\n const processResult = adapter.spawn(command, args, {\n ...(options.cwd === undefined ? {} : { cwd: options.cwd }),\n ...(options.env === undefined ? {} : { env: options.env }),\n shell: false,\n stdio: 'inherit',\n });\n if (processResult.error) {\n return { ok: false, status: processResult.status, command, args, error: processResult.error instanceof Error ? processResult.error.message : String(processResult.error) };\n }\n if (processResult.status !== 0) {\n return { ok: false, status: processResult.status, command, args, error: processResult.signal ? `npm exec terminated by ${processResult.signal}.` : `npm exec exited with status ${String(processResult.status)}.` };\n }\n return { ok: true, status: 0, command, args };\n } catch (error) {\n return runFailure(error);\n }\n}\n\n/** Execute the exact bytes held by a verifier-issued artifact at a workflow boundary. */\nexport function runVerifiedExactRelease(options: RunVerifiedExactReleaseOptions): RunExactReleaseResult {\n if (!isVerifiedReleaseArtifact(options.artifact)) return runFailure(new Error('A verified release artifact is required.'));\n const directory = options.retainTarballPath === undefined\n ? mkdtempSync(join(tmpdir(), 'joycraft-verified-release-'))\n : undefined;\n const bundlePath = options.retainTarballPath ?? join(directory!, 'package.tgz');\n try {\n writeFileSync(bundlePath, options.artifact.tarball, { flag: options.retainTarballPath === undefined ? 'w' : 'wx', mode: 0o600 });\n const commandArgs = [...(options.commandArgs ?? ['update'])];\n if (options.autoSafe !== false) {\n for (const flag of ['--auto-safe', '--non-interactive', '--json']) if (!commandArgs.includes(flag)) commandArgs.push(flag);\n }\n return runExactRelease({\n ...options,\n localBundle: bundlePath,\n commandArgs,\n });\n } catch (error) {\n return runFailure(error);\n } finally {\n if (directory !== undefined) rmSync(directory, { recursive: true, force: true });\n }\n}\n\n/** Resolve one exact version, download and verify its artifact, then execute it once. */\nexport async function resolveAndRunExactRelease(options: ResolveAndRunExactReleaseOptions = {}): Promise<RunExactReleaseResult> {\n const resolution = await resolveExactRelease(options);\n if (!resolution.ok) return runFailure(new Error(resolution.error));\n try {\n const artifact = await fetchVerifiedReleaseArtifact(resolution.release, options);\n return runVerifiedExactRelease({ ...options, artifact });\n } catch (error) {\n return runFailure(error);\n }\n}\n"],"mappings":"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","names":[]}
@@ -4,11 +4,11 @@ import {
4
4
  formatTelemetrySummary,
5
5
  loadTelemetryStore,
6
6
  runTelemetryScan
7
- } from "./chunk-OAC5CVHJ.js";
7
+ } from "./chunk-K4AI6FKB.js";
8
8
  export {
9
9
  TELEMETRY_PATH,
10
10
  formatTelemetrySummary,
11
11
  loadTelemetryStore,
12
12
  runTelemetryScan
13
13
  };
14
- //# sourceMappingURL=telemetry-store-X7K5NYWD.js.map
14
+ //# sourceMappingURL=telemetry-store-IBO5GRTA.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,19 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ formatUpdateOutcome,
4
+ update,
5
+ updateStatusExitCode
6
+ } from "./chunk-PR4QDKPL.js";
7
+ import "./chunk-JYPBXPGD.js";
8
+ import "./chunk-OMFGDJW4.js";
9
+ import "./chunk-Z5JFEGWG.js";
10
+ import "./chunk-KKDKC4FM.js";
11
+ import "./chunk-B73DPYYC.js";
12
+ import "./chunk-K4AI6FKB.js";
13
+ import "./chunk-7BPB2IKY.js";
14
+ export {
15
+ formatUpdateOutcome,
16
+ update,
17
+ updateStatusExitCode
18
+ };
19
+ //# sourceMappingURL=update-HNTXCEKB.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,36 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ CHECK_CACHE_PATH,
4
+ CHECK_CACHE_TTL_MS,
5
+ CHECK_DEFAULT_DEADLINE_MS,
6
+ CHECK_LOCK_PATH,
7
+ CHECK_LOCK_TTL_MS,
8
+ CHECK_MAX_BACKOFF_MS,
9
+ CHECK_SETTINGS_PATH,
10
+ acknowledgeUpdate,
11
+ checkForUpdate,
12
+ compareStableVersions,
13
+ postponeUpdate,
14
+ readUpdatePolicy,
15
+ resolveCheckSessionId,
16
+ resolveUpdateStatus,
17
+ setUpdatePolicy
18
+ } from "./chunk-B73DPYYC.js";
19
+ export {
20
+ CHECK_CACHE_PATH,
21
+ CHECK_CACHE_TTL_MS,
22
+ CHECK_DEFAULT_DEADLINE_MS,
23
+ CHECK_LOCK_PATH,
24
+ CHECK_LOCK_TTL_MS,
25
+ CHECK_MAX_BACKOFF_MS,
26
+ CHECK_SETTINGS_PATH,
27
+ acknowledgeUpdate,
28
+ checkForUpdate,
29
+ compareStableVersions,
30
+ postponeUpdate,
31
+ readUpdatePolicy,
32
+ resolveCheckSessionId,
33
+ resolveUpdateStatus,
34
+ setUpdatePolicy
35
+ };
36
+ //# sourceMappingURL=update-check-YT765NE7.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,28 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ update
4
+ } from "./chunk-PR4QDKPL.js";
5
+ import "./chunk-JYPBXPGD.js";
6
+ import "./chunk-OMFGDJW4.js";
7
+ import "./chunk-Z5JFEGWG.js";
8
+ import "./chunk-KKDKC4FM.js";
9
+ import "./chunk-B73DPYYC.js";
10
+ import "./chunk-K4AI6FKB.js";
11
+ import "./chunk-7BPB2IKY.js";
12
+
13
+ // src/upgrade.ts
14
+ async function upgrade(dir, opts = {}) {
15
+ return update(dir, {
16
+ harnesses: opts.harnesses,
17
+ yes: opts.yes,
18
+ nonInteractive: opts.nonInteractive,
19
+ replaceCustomized: opts.replaceCustomized,
20
+ gitignore: opts.gitignore,
21
+ bundle: opts.bundle,
22
+ recovery: opts.recovery
23
+ });
24
+ }
25
+ export {
26
+ upgrade
27
+ };
28
+ //# sourceMappingURL=upgrade-LZOND7OZ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/upgrade.ts"],"sourcesContent":["import { update, type ExecutingBundle, type UpdateOutcome } from './update.js';\nimport type { Harness } from './harness.js';\n\n/** Options retained by the legacy upgrade entry point and forwarded to update. */\nexport interface UpgradeOptions {\n yes?: boolean;\n gitignore?: string;\n nonInteractive?: boolean;\n harnesses?: readonly Harness[] | string;\n replaceCustomized?: readonly string[];\n json?: boolean;\n bundle?: ExecutingBundle;\n recovery?: 'recover' | 'rollback';\n}\n\n/** Legacy alias routed through the same planner and transaction as `update`. */\nexport async function upgrade(dir: string, opts: UpgradeOptions = {}): Promise<UpdateOutcome> {\n return update(dir, {\n harnesses: opts.harnesses,\n yes: opts.yes,\n nonInteractive: opts.nonInteractive,\n replaceCustomized: opts.replaceCustomized,\n gitignore: opts.gitignore,\n bundle: opts.bundle,\n recovery: opts.recovery,\n });\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,eAAsB,QAAQ,KAAa,OAAuB,CAAC,GAA2B;AAC5F,SAAO,OAAO,KAAK;AAAA,IACjB,WAAW,KAAK;AAAA,IAChB,KAAK,KAAK;AAAA,IACV,gBAAgB,KAAK;AAAA,IACrB,mBAAmB,KAAK;AAAA,IACxB,WAAW,KAAK;AAAA,IAChB,QAAQ,KAAK;AAAA,IACb,UAAU,KAAK;AAAA,EACjB,CAAC;AACH;","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "joycraft",
3
- "version": "0.7.12",
3
+ "version": "0.7.14",
4
4
  "description": "CLI + Claude Code plugin that scaffolds and upgrades AI development harnesses",
5
5
  "type": "module",
6
6
  "bin": {
@@ -12,7 +12,7 @@
12
12
  "dist"
13
13
  ],
14
14
  "scripts": {
15
- "build": "node scripts/generate-bundled-files.mjs && node scripts/sync-skills.mjs && tsup",
15
+ "build": "node scripts/generate-bundled-files.mjs && node scripts/sync-skills.mjs && tsup && node scripts/release-preparation.mjs emit-descriptor",
16
16
  "sync-skills": "node scripts/generate-bundled-files.mjs && node scripts/sync-skills.mjs",
17
17
  "test": "vitest",
18
18
  "typecheck": "tsc --noEmit",
@@ -27,6 +27,9 @@
27
27
  ],
28
28
  "author": "Maximilian Maksutovic",
29
29
  "license": "MIT",
30
+ "engines": {
31
+ "node": ">=22"
32
+ },
30
33
  "repository": {
31
34
  "type": "git",
32
35
  "url": "https://github.com/maksutovic/joycraft"
@@ -1,91 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- TELEMETRY_PATH
4
- } from "./chunk-OAC5CVHJ.js";
5
- import {
6
- DEFAULT_GITIGNORE_PROFILE,
7
- STATE_PATH,
8
- parseGitignoreProfile
9
- } from "./chunk-PBOICMDE.js";
10
-
11
- // src/gitignore.ts
12
- import { existsSync, readFileSync, writeFileSync } from "fs";
13
- import { join } from "path";
14
- import { createInterface } from "readline";
15
- var PRIVATE_PROFILE_IGNORES = [".claude/", ".agents/", ".pi/", ".github/skills/joycraft-*/"];
16
- var PRIVATE_DIRS_DISPLAY = PRIVATE_PROFILE_IGNORES.join(", ");
17
- var PRIVATE_UNTRACK_COMMAND = `git rm -r --cached ${PRIVATE_PROFILE_IGNORES.map((d) => d.replace(/\/$/, "")).join(" ")}`;
18
- function ensureGitignoreEntries(targetDir, entries) {
19
- const gitignorePath = join(targetDir, ".gitignore");
20
- const current = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
21
- const present = new Set(current.split("\n").map((l) => l.trim()));
22
- const missing = entries.filter((e) => !present.has(e.trim()));
23
- if (missing.length === 0) return [];
24
- const sep = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
25
- writeFileSync(gitignorePath, current + sep + missing.join("\n") + "\n", "utf-8");
26
- return missing;
27
- }
28
- function applyGitignoreProfile(targetDir, profile) {
29
- const machineOwned = [STATE_PATH, TELEMETRY_PATH];
30
- if (profile === "private") {
31
- return ensureGitignoreEntries(targetDir, [...PRIVATE_PROFILE_IGNORES, ...machineOwned]);
32
- }
33
- return ensureGitignoreEntries(targetDir, machineOwned);
34
- }
35
- function validateGitignoreFlag(flag) {
36
- const parsed = parseGitignoreProfile(flag);
37
- if (!parsed) {
38
- throw new Error(`Unknown gitignore profile '${flag}'. Use 'shared' or 'private'.`);
39
- }
40
- return parsed;
41
- }
42
- async function promptGitignoreProfile(intro) {
43
- const rl = createInterface({ input: process.stdin, output: process.stdout });
44
- console.log(intro);
45
- console.log(" shared \u2014 commit skills so your team gets the same workflow (default)");
46
- console.log(` private \u2014 gitignore ${PRIVATE_DIRS_DISPLAY}; track only CLAUDE.md, AGENTS.md, docs/`);
47
- return new Promise((resolve) => {
48
- const ask = () => {
49
- rl.question(`Profile [shared/private] (${DEFAULT_GITIGNORE_PROFILE}): `, (answer) => {
50
- if (answer.trim() === "") {
51
- rl.close();
52
- resolve(DEFAULT_GITIGNORE_PROFILE);
53
- return;
54
- }
55
- const parsed = parseGitignoreProfile(answer);
56
- if (parsed) {
57
- rl.close();
58
- resolve(parsed);
59
- return;
60
- }
61
- console.log(
62
- `Unrecognized answer '${answer.trim()}' \u2014 type 'shared' or 'private', or press Enter for ${DEFAULT_GITIGNORE_PROFILE}.`
63
- );
64
- ask();
65
- });
66
- };
67
- ask();
68
- });
69
- }
70
- async function resolveGitignoreProfile(opts) {
71
- if (opts.flag !== void 0) {
72
- return { profile: validateGitignoreFlag(opts.flag), decided: true };
73
- }
74
- if (opts.persisted) {
75
- return { profile: opts.persisted, decided: true };
76
- }
77
- if (opts.interactive) {
78
- return { profile: await promptGitignoreProfile(opts.promptIntro), decided: true };
79
- }
80
- return { profile: DEFAULT_GITIGNORE_PROFILE, decided: false };
81
- }
82
-
83
- export {
84
- PRIVATE_PROFILE_IGNORES,
85
- PRIVATE_DIRS_DISPLAY,
86
- PRIVATE_UNTRACK_COMMAND,
87
- applyGitignoreProfile,
88
- validateGitignoreFlag,
89
- resolveGitignoreProfile
90
- };
91
- //# sourceMappingURL=chunk-BZW5DR3O.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/gitignore.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createInterface } from 'node:readline';\nimport {\n STATE_PATH,\n parseGitignoreProfile,\n DEFAULT_GITIGNORE_PROFILE,\n type GitignoreProfile,\n} from './version.js';\nimport { TELEMETRY_PATH } from './telemetry-store.js';\n\n/**\n * The harness directories the `private` profile gitignores. Tracking only\n * CLAUDE.md, AGENTS.md, and docs/ means everything under these dirs stays\n * local. `.claude/` already covers the hidden state file.\n *\n * `.github/skills/joycraft-*` is gitignored, NOT `.github/` or\n * `.github/skills/` — `.github/` holds Actions workflows, issue templates,\n * and other non-harness config, and `.github/skills/` may contain the\n * user's own non-Joycraft Copilot skills.\n *\n * Single source of truth: every user-facing string that names these dirs\n * (prompts, summaries, the untrack hint, CLI help) derives from this list via\n * the constants below, so adding a harness dir can't leave stale messages.\n */\nexport const PRIVATE_PROFILE_IGNORES = ['.claude/', '.agents/', '.pi/', '.github/skills/joycraft-*/'];\n\n/** Human-readable list of the private-profile dirs, for prompts and summaries. */\nexport const PRIVATE_DIRS_DISPLAY = PRIVATE_PROFILE_IGNORES.join(', ');\n\n/** Copy-pasteable command to untrack already-committed harness files. */\nexport const PRIVATE_UNTRACK_COMMAND = `git rm -r --cached ${PRIVATE_PROFILE_IGNORES.map((d) => d.replace(/\\/$/, '')).join(' ')}`;\n\n/**\n * Append-only, create-if-absent, idempotent .gitignore writer.\n *\n * Mirrors the \"append over modify when touching user files\" principle: it never\n * rewrites, reorders, or removes existing lines — it only appends the entries\n * not already present (matched exactly, after trimming). One read + at most one\n * write per call. Returns the entries actually added (empty when everything was\n * already present).\n */\nexport function ensureGitignoreEntries(targetDir: string, entries: string[]): string[] {\n const gitignorePath = join(targetDir, '.gitignore');\n const current = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';\n const present = new Set(current.split('\\n').map((l) => l.trim()));\n const missing = entries.filter((e) => !present.has(e.trim()));\n if (missing.length === 0) return [];\n\n // Append on their own lines, tolerating a file that may or may not end in \\n.\n const sep = current.length > 0 && !current.endsWith('\\n') ? '\\n' : '';\n writeFileSync(gitignorePath, current + sep + missing.join('\\n') + '\\n', 'utf-8');\n return missing;\n}\n\n/** Single-entry convenience wrapper around ensureGitignoreEntries. */\nexport function ensureGitignoreEntry(targetDir: string, line: string): boolean {\n return ensureGitignoreEntries(targetDir, [line]).length > 0;\n}\n\n/**\n * Apply a gitignore profile's entries to the project's .gitignore.\n *\n * The hidden upgrade-state file (`STATE_PATH`) is tool-managed, regenerated on\n * every init/upgrade, and must never be committed — under BOTH profiles. It now\n * lives at `docs/.joycraft/state.json`; since `docs/` is always tracked, the\n * state entry is no longer covered transitively by any harness-dir ignore, so\n * both profiles list it explicitly.\n *\n * - `shared` — ignore only the hidden state file (commit the harness dirs).\n * - `private` — ignore the .claude/, .agents/, .pi/, .github/skills/joycraft-* trees AND the state file.\n *\n * Append-only and idempotent (via ensureGitignoreEntries), so re-running\n * init/upgrade never duplicates entries. Returns the list of lines actually\n * added this call.\n */\nexport function applyGitignoreProfile(targetDir: string, profile: GitignoreProfile): string[] {\n // Machine-owned files under docs/.joycraft/ — since docs/ is always tracked,\n // both profiles must list them explicitly (telemetry.json additionally holds\n // per-machine work patterns that must never publish).\n const machineOwned = [STATE_PATH, TELEMETRY_PATH];\n if (profile === 'private') {\n return ensureGitignoreEntries(targetDir, [...PRIVATE_PROFILE_IGNORES, ...machineOwned]);\n }\n // `shared`: only the machine-owned files, matching long-standing behavior.\n return ensureGitignoreEntries(targetDir, machineOwned);\n}\n\n/** A resolved profile plus how it was arrived at. */\nexport interface ResolvedGitignoreProfile {\n profile: GitignoreProfile;\n /**\n * True when the profile is an actual decision: a --gitignore flag, a\n * persisted choice, or an interactive answer. False when it is the\n * non-interactive fallback default — callers must NOT persist a fallback,\n * or the one-time prompt would be permanently suppressed for the project.\n */\n decided: boolean;\n}\n\n/** Validate a raw --gitignore flag value. Throws the user-facing error on unknown values. */\nexport function validateGitignoreFlag(flag: string): GitignoreProfile {\n const parsed = parseGitignoreProfile(flag);\n if (!parsed) {\n throw new Error(`Unknown gitignore profile '${flag}'. Use 'shared' or 'private'.`);\n }\n return parsed;\n}\n\n/**\n * Prompt for a gitignore profile. An empty answer takes the default; an\n * unrecognized answer re-asks instead of being silently coerced — a typo must\n * not get persisted as a permanent choice.\n */\nasync function promptGitignoreProfile(intro: string): Promise<GitignoreProfile> {\n const rl = createInterface({ input: process.stdin, output: process.stdout });\n console.log(intro);\n console.log(' shared — commit skills so your team gets the same workflow (default)');\n console.log(` private — gitignore ${PRIVATE_DIRS_DISPLAY}; track only CLAUDE.md, AGENTS.md, docs/`);\n return new Promise((resolve) => {\n const ask = (): void => {\n rl.question(`Profile [shared/private] (${DEFAULT_GITIGNORE_PROFILE}): `, (answer) => {\n if (answer.trim() === '') {\n rl.close();\n resolve(DEFAULT_GITIGNORE_PROFILE);\n return;\n }\n const parsed = parseGitignoreProfile(answer);\n if (parsed) {\n rl.close();\n resolve(parsed);\n return;\n }\n console.log(\n `Unrecognized answer '${answer.trim()}' — type 'shared' or 'private', or press Enter for ${DEFAULT_GITIGNORE_PROFILE}.`\n );\n ask();\n });\n };\n ask();\n });\n}\n\n/**\n * Resolve the gitignore profile by precedence — the single resolver shared by\n * init and upgrade so the two commands can never drift:\n * 1. --gitignore flag (validated; throws on unknown value)\n * 2. profile persisted in state.json (re-init / upgrade keep the prior choice)\n * 3. interactive prompt (the caller decides when prompting is allowed)\n * 4. fallback default `shared`, reported with decided=false\n */\nexport async function resolveGitignoreProfile(opts: {\n /** Raw --gitignore value from the CLI, if provided. */\n flag?: string;\n /** Profile previously persisted in state.json, if any. */\n persisted?: GitignoreProfile;\n /** Whether prompting is allowed (TTY, and the command permits interaction). */\n interactive: boolean;\n /** First line printed above the prompt; init and upgrade word it differently. */\n promptIntro: string;\n}): Promise<ResolvedGitignoreProfile> {\n if (opts.flag !== undefined) {\n return { profile: validateGitignoreFlag(opts.flag), decided: true };\n }\n if (opts.persisted) {\n return { profile: opts.persisted, decided: true };\n }\n if (opts.interactive) {\n return { profile: await promptGitignoreProfile(opts.promptIntro), decided: true };\n }\n return { profile: DEFAULT_GITIGNORE_PROFILE, decided: false };\n}\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,YAAY;AACrB,SAAS,uBAAuB;AAuBzB,IAAM,0BAA0B,CAAC,YAAY,YAAY,QAAQ,4BAA4B;AAG7F,IAAM,uBAAuB,wBAAwB,KAAK,IAAI;AAG9D,IAAM,0BAA0B,sBAAsB,wBAAwB,IAAI,CAAC,MAAM,EAAE,QAAQ,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC;AAWxH,SAAS,uBAAuB,WAAmB,SAA6B;AACrF,QAAM,gBAAgB,KAAK,WAAW,YAAY;AAClD,QAAM,UAAU,WAAW,aAAa,IAAI,aAAa,eAAe,OAAO,IAAI;AACnF,QAAM,UAAU,IAAI,IAAI,QAAQ,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAChE,QAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5D,MAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAGlC,QAAM,MAAM,QAAQ,SAAS,KAAK,CAAC,QAAQ,SAAS,IAAI,IAAI,OAAO;AACnE,gBAAc,eAAe,UAAU,MAAM,QAAQ,KAAK,IAAI,IAAI,MAAM,OAAO;AAC/E,SAAO;AACT;AAuBO,SAAS,sBAAsB,WAAmB,SAAqC;AAI5F,QAAM,eAAe,CAAC,YAAY,cAAc;AAChD,MAAI,YAAY,WAAW;AACzB,WAAO,uBAAuB,WAAW,CAAC,GAAG,yBAAyB,GAAG,YAAY,CAAC;AAAA,EACxF;AAEA,SAAO,uBAAuB,WAAW,YAAY;AACvD;AAeO,SAAS,sBAAsB,MAAgC;AACpE,QAAM,SAAS,sBAAsB,IAAI;AACzC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,8BAA8B,IAAI,+BAA+B;AAAA,EACnF;AACA,SAAO;AACT;AAOA,eAAe,uBAAuB,OAA0C;AAC9E,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,UAAQ,IAAI,KAAK;AACjB,UAAQ,IAAI,8EAAyE;AACrF,UAAQ,IAAI,8BAAyB,oBAAoB,0CAA0C;AACnG,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,MAAM,MAAY;AACtB,SAAG,SAAS,6BAA6B,yBAAyB,OAAO,CAAC,WAAW;AACnF,YAAI,OAAO,KAAK,MAAM,IAAI;AACxB,aAAG,MAAM;AACT,kBAAQ,yBAAyB;AACjC;AAAA,QACF;AACA,cAAM,SAAS,sBAAsB,MAAM;AAC3C,YAAI,QAAQ;AACV,aAAG,MAAM;AACT,kBAAQ,MAAM;AACd;AAAA,QACF;AACA,gBAAQ;AAAA,UACN,wBAAwB,OAAO,KAAK,CAAC,2DAAsD,yBAAyB;AAAA,QACtH;AACA,YAAI;AAAA,MACN,CAAC;AAAA,IACH;AACA,QAAI;AAAA,EACN,CAAC;AACH;AAUA,eAAsB,wBAAwB,MASR;AACpC,MAAI,KAAK,SAAS,QAAW;AAC3B,WAAO,EAAE,SAAS,sBAAsB,KAAK,IAAI,GAAG,SAAS,KAAK;AAAA,EACpE;AACA,MAAI,KAAK,WAAW;AAClB,WAAO,EAAE,SAAS,KAAK,WAAW,SAAS,KAAK;AAAA,EAClD;AACA,MAAI,KAAK,aAAa;AACpB,WAAO,EAAE,SAAS,MAAM,uBAAuB,KAAK,WAAW,GAAG,SAAS,KAAK;AAAA,EAClF;AACA,SAAO,EAAE,SAAS,2BAA2B,SAAS,MAAM;AAC9D;","names":[]}