joycraft 0.7.13 → 0.7.15

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 (49) hide show
  1. package/README.md +25 -11
  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-EFHJI5KD.js → chunk-JYPBXPGD.js} +114 -112
  7. package/dist/chunk-JYPBXPGD.js.map +1 -0
  8. package/dist/{chunk-LKWD25KJ.js → chunk-KKDKC4FM.js} +8 -71
  9. package/dist/chunk-KKDKC4FM.js.map +1 -0
  10. package/dist/chunk-OMFGDJW4.js +97 -0
  11. package/dist/chunk-OMFGDJW4.js.map +1 -0
  12. package/dist/chunk-PR4QDKPL.js +3755 -0
  13. package/dist/chunk-PR4QDKPL.js.map +1 -0
  14. package/dist/chunk-Z5JFEGWG.js +563 -0
  15. package/dist/chunk-Z5JFEGWG.js.map +1 -0
  16. package/dist/cli.js +387 -54
  17. package/dist/cli.js.map +1 -1
  18. package/dist/index.d.ts +235 -1
  19. package/dist/index.js +691 -1
  20. package/dist/index.js.map +1 -1
  21. package/dist/init-S5JU5BHL.js +60 -0
  22. package/dist/init-S5JU5BHL.js.map +1 -0
  23. package/dist/{init-autofix-E7DSPUSC.js → init-autofix-WSKUT2HN.js} +4 -3
  24. package/dist/{init-autofix-E7DSPUSC.js.map → init-autofix-WSKUT2HN.js.map} +1 -1
  25. package/dist/install-manifest-EQHT4474.js +37 -0
  26. package/dist/joycraft-release.json +8 -0
  27. package/dist/release-artifact-4TL5L2ZY.js +14 -0
  28. package/dist/release-artifact-4TL5L2ZY.js.map +1 -0
  29. package/dist/release-resolver-P2H46QTU.js +293 -0
  30. package/dist/release-resolver-P2H46QTU.js.map +1 -0
  31. package/dist/update-HNTXCEKB.js +19 -0
  32. package/dist/update-HNTXCEKB.js.map +1 -0
  33. package/dist/update-check-YT765NE7.js +36 -0
  34. package/dist/update-check-YT765NE7.js.map +1 -0
  35. package/dist/upgrade-LZOND7OZ.js +28 -0
  36. package/dist/upgrade-LZOND7OZ.js.map +1 -0
  37. package/package.json +5 -2
  38. package/dist/chunk-EFHJI5KD.js.map +0 -1
  39. package/dist/chunk-J6GDQ55S.js +0 -91
  40. package/dist/chunk-J6GDQ55S.js.map +0 -1
  41. package/dist/chunk-LKWD25KJ.js.map +0 -1
  42. package/dist/chunk-Q2ZQ6RGD.js +0 -243
  43. package/dist/chunk-Q2ZQ6RGD.js.map +0 -1
  44. package/dist/init-YSFURLGT.js +0 -1330
  45. package/dist/init-YSFURLGT.js.map +0 -1
  46. package/dist/upgrade-PELFI26D.js +0 -650
  47. package/dist/upgrade-PELFI26D.js.map +0 -1
  48. package/dist/version-J7MOKNJR.js +0 -28
  49. /package/dist/{version-J7MOKNJR.js.map → install-manifest-EQHT4474.js.map} +0 -0
@@ -1,10 +1,5 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- // src/version.ts
4
- import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
5
- import { join, dirname } from "path";
6
- import { createHash } from "crypto";
7
-
8
3
  // src/harness.ts
9
4
  import { createInterface } from "readline";
10
5
  var HARNESSES = ["claude", "codex", "pi", "copilot", "omp"];
@@ -69,21 +64,17 @@ async function resolveHarnesses(interactive) {
69
64
  }
70
65
 
71
66
  // src/version.ts
72
- var STATE_PATH = join("docs", ".joycraft", "state.json");
67
+ import { readFileSync, writeFileSync, existsSync, mkdirSync, lstatSync, realpathSync, renameSync, unlinkSync } from "fs";
68
+ import { join, dirname } from "path";
69
+ import { createHash } from "crypto";
70
+ var STATE_PATH = "docs/.joycraft/state.json";
73
71
  var LEGACY_VERSION_FILE = ".joycraft-version";
74
- var LEGACY_CLAUDE_STATE_PATH = join(".claude", ".joycraft", "state.json");
75
- var HASH_LENGTH = 16;
72
+ var LEGACY_CLAUDE_STATE_PATH = ".claude/.joycraft/state.json";
76
73
  var DEFAULT_GITIGNORE_PROFILE = "shared";
77
74
  function parseGitignoreProfile(value) {
78
75
  const v = typeof value === "string" ? value.trim().toLowerCase() : value;
79
76
  return v === "shared" || v === "private" ? v : null;
80
77
  }
81
- function hashContent(content) {
82
- return createHash("sha256").update(content).digest("hex");
83
- }
84
- function truncateHash(hash) {
85
- return hash.slice(0, HASH_LENGTH);
86
- }
87
78
  function readVersion(dir) {
88
79
  const filePath = join(dir, STATE_PATH);
89
80
  if (!existsSync(filePath)) return null;
@@ -108,71 +99,17 @@ function readVersion(dir) {
108
99
  return null;
109
100
  }
110
101
  }
111
- function writeVersion(dir, version, files, gitignoreProfile, harnesses, autoOpen) {
112
- const filePath = join(dir, STATE_PATH);
113
- const existing = readVersion(dir);
114
- const profile = gitignoreProfile ?? existing?.gitignoreProfile;
115
- const selectedHarnesses = harnesses ?? existing?.harnesses;
116
- const openSetting = autoOpen ?? existing?.autoOpen;
117
- let unknownKeys = {};
118
- if (existsSync(filePath)) {
119
- try {
120
- const raw = JSON.parse(readFileSync(filePath, "utf-8"));
121
- if (raw && typeof raw === "object" && !Array.isArray(raw)) {
122
- const {
123
- version: _v,
124
- files: _f,
125
- gitignoreProfile: _g,
126
- harnesses: _h,
127
- autoOpen: _a,
128
- ...rest
129
- } = raw;
130
- unknownKeys = rest;
131
- }
132
- } catch {
133
- }
134
- }
135
- const truncated = {};
136
- for (const [path, hash] of Object.entries(files)) {
137
- truncated[path] = truncateHash(hash);
138
- }
139
- const data = {
140
- version,
141
- files: truncated,
142
- ...profile ? { gitignoreProfile: profile } : {},
143
- ...selectedHarnesses ? { harnesses: selectedHarnesses } : {},
144
- ...openSetting !== void 0 ? { autoOpen: openSetting } : {},
145
- ...unknownKeys
146
- };
147
- mkdirSync(dirname(filePath), { recursive: true });
148
- writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
149
- }
150
- function getAutoOpen(dir) {
151
- return readVersion(dir)?.autoOpen ?? true;
152
- }
153
- function getLevel(dir) {
154
- const hasAutofix = existsSync(join(dir, ".github", "workflows", "autofix.yml"));
155
- if (!hasAutofix) return 4;
156
- const claudeMdPath = join(dir, "CLAUDE.md");
157
- if (!existsSync(claudeMdPath)) return 4;
158
- const content = readFileSync(claudeMdPath, "utf-8");
159
- return content.includes("## External Validation") ? 5 : 4;
160
- }
161
102
 
162
103
  export {
163
104
  HARNESSES,
164
105
  sanitizeHarnesses,
106
+ parseHarnessSelection,
165
107
  resolveHarnesses,
166
108
  STATE_PATH,
167
109
  LEGACY_VERSION_FILE,
168
110
  LEGACY_CLAUDE_STATE_PATH,
169
111
  DEFAULT_GITIGNORE_PROFILE,
170
112
  parseGitignoreProfile,
171
- hashContent,
172
- truncateHash,
173
- readVersion,
174
- writeVersion,
175
- getAutoOpen,
176
- getLevel
113
+ readVersion
177
114
  };
178
- //# sourceMappingURL=chunk-LKWD25KJ.js.map
115
+ //# sourceMappingURL=chunk-KKDKC4FM.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/harness.ts","../src/version.ts"],"sourcesContent":["import { createInterface } from 'node:readline';\n\n/**\n * The AI coding harnesses Joycraft can install into a project. Each maps to a\n * config dir:\n * - claude → .claude/ (Claude Code)\n * - codex → .agents/ (OpenAI Codex)\n * - pi → .pi/ (Pi)\n * - copilot → .github/ (GitHub Copilot)\n * - omp → .omp/ (Oh My Pi)\n *\n * Single source of truth: the menu, the parser, and the install gates in\n * init.ts all derive from this list so a new harness can't leave a path stale.\n */\nexport const HARNESSES = ['claude', 'codex', 'pi', 'copilot', 'omp'] as const;\nexport type Harness = (typeof HARNESSES)[number];\n\n/** Human-readable one-liner per harness, shown in the interactive menu. */\nconst HARNESS_LABELS: Record<Harness, string> = {\n claude: 'Claude Code (.claude/)',\n codex: 'OpenAI Codex (.agents/)',\n pi: 'Pi (.pi/)',\n copilot: 'GitHub Copilot (.github/)',\n omp: 'Oh My Pi (.omp/)',\n};\n\nfunction isHarness(value: string): value is Harness {\n return (HARNESSES as readonly string[]).includes(value);\n}\n\n/**\n * Sanitize an arbitrary value (e.g. parsed from state.json) into a harness list,\n * dropping anything unrecognized rather than rejecting the whole list — old or\n * hand-edited state must degrade gracefully. Returns null when the input isn't\n * an array at all (caller treats null as \"no recorded selection\"). Order follows\n * the canonical HARNESSES order and is deduped.\n */\nexport function sanitizeHarnesses(value: unknown): Harness[] | null {\n if (!Array.isArray(value)) return null;\n const present = new Set(\n value.filter((v): v is string => typeof v === 'string').map((v) => v.trim().toLowerCase())\n );\n return HARNESSES.filter((h) => present.has(h));\n}\n\n/**\n * Parse a comma/space-separated answer into a deduped, validated harness list.\n * Returns null when any token is unrecognized so the caller can re-ask rather\n * than silently dropping a typo. An empty answer yields an empty array (the\n * \"install nothing\" case the caller handles explicitly).\n */\nexport function parseHarnessSelection(answer: string): Harness[] | null {\n const tokens = answer\n .split(/[,\\s]+/)\n .map((t) => t.trim().toLowerCase())\n .filter((t) => t.length > 0);\n\n // \"all\" is a convenience alias for every harness.\n if (tokens.length === 1 && tokens[0] === 'all') {\n return [...HARNESSES];\n }\n\n const selected: Harness[] = [];\n for (const token of tokens) {\n if (!isHarness(token)) return null;\n if (!selected.includes(token)) selected.push(token);\n }\n return selected;\n}\n\n/**\n * Interactive multi-select for which harnesses to install. An empty answer is a\n * deliberate \"none\" — the caller prints the run-again message and bails. An\n * unrecognized token re-asks instead of being coerced.\n */\nasync function promptHarnesses(): Promise<Harness[]> {\n const rl = createInterface({ input: process.stdin, output: process.stdout });\n console.log('\\nWhich AI harnesses should Joycraft install?');\n for (const h of HARNESSES) {\n console.log(` ${h.padEnd(7)} — ${HARNESS_LABELS[h]}`);\n }\n return new Promise((resolve) => {\n const ask = (): void => {\n rl.question('Harnesses [comma-separated, or \"all\"] (none): ', (answer) => {\n const parsed = parseHarnessSelection(answer);\n if (parsed !== null) {\n rl.close();\n resolve(parsed);\n return;\n }\n console.log(\n `Unrecognized harness in '${answer.trim()}' — choose from ${HARNESSES.join(', ')} (comma-separated), or leave empty for none.`\n );\n ask();\n });\n };\n ask();\n });\n}\n\n/**\n * Resolve which harnesses to install:\n * - interactive (TTY): show the multi-select menu; honor an empty \"none\"\n * - non-interactive: install all available harnesses, preserving long-standing init behavior\n * for scripted/CI runs that can't answer a prompt.\n */\nexport async function resolveHarnesses(interactive: boolean): Promise<Harness[]> {\n if (interactive) {\n return promptHarnesses();\n }\n return [...HARNESSES];\n}\n","import { readFileSync, writeFileSync, existsSync, mkdirSync, lstatSync, realpathSync, renameSync, unlinkSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport { createHash } from 'node:crypto';\nimport { sanitizeHarnesses, type Harness } from './harness.js';\nimport { CHECK_SETTINGS_PATH } from './update-check.js';\n\n/**\n * Project-relative path to Joycraft's upgrade-state file.\n *\n * Hidden inside `docs/` — the one directory `init` always creates regardless of\n * which harnesses are selected — so a single-harness install carries no\n * foreign-harness footprint (a Codex-only project has no `.claude/`, etc.). The\n * state is Joycraft's own bookkeeping (version, file hashes, gitignore profile),\n * not a harness artifact, so it lives in a harness-neutral home. Never at the\n * repo root, never committed (init/upgrade gitignore it).\n *\n * Two legacy locations are migrated on upgrade: the original repo-root\n * `.joycraft-version` (see LEGACY_VERSION_FILE) and the later\n * `.claude/.joycraft/state.json` (see LEGACY_CLAUDE_STATE_PATH).\n */\nexport const STATE_PATH = 'docs/.joycraft/state.json';\n\n/** Project-local preferences introduced with the installation manifest. */\nexport const LOCAL_SETTINGS_PATH = CHECK_SETTINGS_PATH;\n\n/** The original repo-root state path. Kept only so `upgrade` can migrate it. */\nexport const LEGACY_VERSION_FILE = '.joycraft-version';\n\n/**\n * The interim `.claude/`-nested state path, used before state moved to a\n * harness-neutral `docs/` home. Kept only so `upgrade` can migrate it (and so a\n * Codex/Pi-only re-init stops leaving a stray `.claude/` behind).\n */\nexport const LEGACY_CLAUDE_STATE_PATH = '.claude/.joycraft/state.json';\n\n/**\n * Length we truncate stored hashes to. Full SHA-256 is 64 hex chars; 16 hex\n * (64 bits) is ample to detect customization across ~100 managed files and\n * shrinks the state ~4×. Compare truncated-on-both-sides (see upgrade.ts).\n */\nconst HASH_LENGTH = 16;\n\n/**\n * How much of the Joycraft harness is tracked in git.\n * - `shared` — commit skills/agents/pi so teammates get the workflow (default).\n * - `private` — gitignore .claude/, .agents/, .pi/; track only CLAUDE.md,\n * AGENTS.md, and docs/.\n */\nexport type GitignoreProfile = 'shared' | 'private';\n\nexport const DEFAULT_GITIGNORE_PROFILE: GitignoreProfile = 'shared';\n\n/**\n * Narrow an arbitrary value to a GitignoreProfile, or null if unrecognized.\n * Strings are normalized (trim + lowercase) here so every call site — flag,\n * prompt, persisted state — gets the same case-insensitivity for free.\n */\nexport function parseGitignoreProfile(value: unknown): GitignoreProfile | null {\n const v = typeof value === 'string' ? value.trim().toLowerCase() : value;\n return v === 'shared' || v === 'private' ? v : null;\n}\n\nexport interface VersionInfo {\n version: string;\n /**\n * The last recorded vendor baseline for each managed file. These values are\n * deliberately independent from the bytes currently on disk: when a user\n * declines a customized replacement, the previous value remains the\n * comparison base. An absent entry means vendor ownership is unknown.\n */\n files: Record<string, string>;\n /**\n * The gitignore profile chosen at init/upgrade. Absent on state written by\n * Joycraft versions before this field existed — treat absent as `shared`.\n */\n gitignoreProfile?: GitignoreProfile;\n /**\n * The harnesses installed at init (claude/codex/pi). `upgrade` reads this so\n * it only refreshes the harnesses the project actually uses. Absent on state\n * written before harness selection existed — callers treat absent as \"all\n * three\" for backward compatibility.\n */\n harnesses?: Harness[];\n /**\n * Whether gate skills auto-open rendered HTML artifacts (`open`/`xdg-open`).\n * Absent means true — auto-open was unconditional before this field existed.\n * Persisted here (not a new file) per D12; tune offers the toggle.\n */\n autoOpen?: boolean;\n}\n\nexport function hashContent(content: string): string {\n return createHash('sha256').update(content).digest('hex');\n}\n\n/** Truncate a (full) content hash to the stored length. Idempotent for already-short input. */\nexport function truncateHash(hash: string): string {\n return hash.slice(0, HASH_LENGTH);\n}\n\nexport function readVersion(dir: string): VersionInfo | null {\n const filePath = join(dir, STATE_PATH);\n if (!existsSync(filePath)) return null;\n try {\n const raw = readFileSync(filePath, 'utf-8');\n const parsed = JSON.parse(raw);\n if (typeof parsed.version === 'string' && typeof parsed.files === 'object') {\n // Sanitize the profile: ignore unknown/legacy values rather than\n // returning them (absent or bogus → undefined, callers default to shared).\n const profile = parseGitignoreProfile(parsed.gitignoreProfile);\n // Sanitize harnesses similarly: drop unknown tokens; null (not an array)\n // means \"no recorded selection\" → callers default to all available.\n const harnesses = sanitizeHarnesses(parsed.harnesses);\n return {\n version: parsed.version,\n files: parsed.files,\n ...(profile ? { gitignoreProfile: profile } : {}),\n ...(harnesses ? { harnesses } : {}),\n // Only a real boolean counts; anything else is treated as absent\n // (and absent means true at every call site).\n ...(typeof parsed.autoOpen === 'boolean' ? { autoOpen: parsed.autoOpen } : {}),\n };\n }\n return null;\n } catch {\n return null;\n }\n}\n\nexport function writeVersion(\n dir: string,\n version: string,\n files: Record<string, string>,\n gitignoreProfile?: GitignoreProfile,\n harnesses?: Harness[],\n autoOpen?: boolean\n): void {\n const filePath = join(dir, STATE_PATH);\n // An omitted profile/harness-list/autoOpen means \"no new decision\", not\n // \"clear it\": preserve whatever is already persisted so call sites that only\n // refresh version/hashes can never silently strip a saved choice.\n const existing = readVersion(dir);\n const profile = gitignoreProfile ?? existing?.gitignoreProfile;\n const selectedHarnesses = harnesses ?? existing?.harnesses;\n const openSetting = autoOpen ?? existing?.autoOpen;\n // Unknown keys survive rewrites (D12): a newer Joycraft may have stamped\n // fields this version doesn't know about. Known keys are stripped from the\n // raw pass-through so the sanitized values above stay authoritative.\n let unknownKeys: Record<string, unknown> = {};\n if (existsSync(filePath)) {\n try {\n const raw = JSON.parse(readFileSync(filePath, 'utf-8'));\n if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n const {\n version: _v,\n files: _f,\n gitignoreProfile: _g,\n harnesses: _h,\n autoOpen: _a,\n ...rest\n } = raw as Record<string, unknown>;\n unknownKeys = rest;\n }\n } catch {\n // Unreadable state is rewritten from scratch — same as readVersion's null.\n }\n }\n // Store truncated hashes — single source of truth for the on-disk shape.\n const truncated: Record<string, string> = {};\n for (const [path, hash] of Object.entries(files)) {\n truncated[path] = truncateHash(hash);\n }\n const data: VersionInfo = {\n version,\n files: truncated,\n ...(profile ? { gitignoreProfile: profile } : {}),\n ...(selectedHarnesses ? { harnesses: selectedHarnesses } : {}),\n ...(openSetting !== undefined ? { autoOpen: openSetting } : {}),\n ...unknownKeys,\n };\n mkdirSync(dirname(filePath), { recursive: true });\n writeFileSync(filePath, JSON.stringify(data, null, 2) + '\\n', 'utf-8');\n}\n\n/**\n * The persisted auto-open setting for gate HTML renders. Missing local settings\n * or a missing/invalid key means true; legacy state is consulted only when the\n * local settings file has not been created yet.\n */\nexport interface LocalSettings {\n autoOpen?: boolean;\n [key: string]: unknown;\n}\n\n/**\n * Resolve the local settings path while rejecting symlinked descendants.\n * The project root itself may be a symlink, matching the checker path policy.\n */\ninterface LocalSettingsPathState {\n path: string;\n present: boolean;\n safe: boolean;\n}\n\nfunction localSettingsPathState(dir: string): LocalSettingsPathState | undefined {\n let current: string;\n try {\n current = realpathSync(dir);\n if (!lstatSync(current).isDirectory()) return undefined;\n } catch {\n return undefined;\n }\n\n const parts = LOCAL_SETTINGS_PATH.split('/');\n const destination = join(current, ...parts);\n for (const [index, part] of parts.entries()) {\n current = join(current, part);\n try {\n const stat = lstatSync(current);\n if (stat.isSymbolicLink() || (index < parts.length - 1 && !stat.isDirectory())) {\n return { path: destination, present: true, safe: false };\n }\n if (index === parts.length - 1) return { path: destination, present: true, safe: stat.isFile() };\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === 'ENOENT') return { path: destination, present: false, safe: true };\n return { path: destination, present: true, safe: false };\n }\n }\n return { path: destination, present: false, safe: true };\n}\n\nfunction readLocalSettings(dir: string): LocalSettings | undefined {\n const state = localSettingsPathState(dir);\n if (!state || !state.safe || !state.present) return undefined;\n try {\n const value: unknown = JSON.parse(readFileSync(state.path, 'utf-8'));\n return value && typeof value === 'object' && !Array.isArray(value)\n ? value as LocalSettings\n : undefined;\n } catch {\n return undefined;\n }\n}\n\n/** Read auto-open from local settings, falling back to legacy state for migration. */\nexport function getAutoOpen(dir: string): boolean {\n const localState = localSettingsPathState(dir);\n // An unsafe or malformed local settings file must not silently authorize a\n // legacy preference; the safe default is the same as a missing key.\n if (localState && (!localState.safe || localState.present)) {\n const local = readLocalSettings(dir);\n return typeof local?.autoOpen === 'boolean' ? local.autoOpen : true;\n }\n return readVersion(dir)?.autoOpen ?? true;\n}\n\n/**\n * Persist auto-open in local settings while preserving every other local key.\n * A malformed or symlinked settings path is left untouched and reports failure.\n */\nexport function writeAutoOpen(dir: string, autoOpen: boolean): boolean {\n const localState = localSettingsPathState(dir);\n if (!localState || !localState.safe) return false;\n const path = localState.path;\n\n let existing: LocalSettings = {};\n if (localState.present) {\n try {\n if (!lstatSync(path).isFile()) return false;\n const value: unknown = JSON.parse(readFileSync(path, 'utf-8'));\n if (!value || typeof value !== 'object' || Array.isArray(value)) return false;\n existing = value as LocalSettings;\n } catch {\n return false;\n }\n }\n\n const parent = dirname(path);\n const temporary = `${path}.tmp-${process.pid}-${Date.now()}`;\n try {\n mkdirSync(parent, { recursive: true });\n // Recheck after creating parents so a concurrent replacement cannot turn\n // this into a write through a symlink.\n const rechecked = localSettingsPathState(dir);\n if (!rechecked || !rechecked.safe || rechecked.path !== path) return false;\n writeFileSync(temporary, JSON.stringify({ ...existing, autoOpen }, null, 2) + '\\n', {\n encoding: 'utf-8',\n flag: 'wx',\n });\n renameSync(temporary, path);\n return true;\n } catch {\n try { unlinkSync(temporary); } catch { /* best effort cleanup */ }\n return false;\n }\n}\n\n/**\n * Detect the current Joycraft harness level for a project directory.\n * Returns 5 if Level 5 artifacts (autofix workflow + External Validation) are present, 4 otherwise.\n */\nexport function getLevel(dir: string): number {\n const hasAutofix = existsSync(join(dir, '.github', 'workflows', 'autofix.yml'));\n if (!hasAutofix) return 4;\n const claudeMdPath = join(dir, 'CLAUDE.md');\n if (!existsSync(claudeMdPath)) return 4;\n const content = readFileSync(claudeMdPath, 'utf-8');\n return content.includes('## External Validation') ? 5 : 4;\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,97 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ normalizeManifestPath
4
+ } from "./chunk-Z5JFEGWG.js";
5
+
6
+ // src/update-paths.ts
7
+ import { lstatSync, realpathSync } from "fs";
8
+ import { isAbsolute, join, relative, sep } from "path";
9
+ var UpdatePathError = class extends Error {
10
+ code;
11
+ path;
12
+ constructor(code, path, message) {
13
+ super(message);
14
+ this.name = "UpdatePathError";
15
+ this.code = code;
16
+ this.path = path;
17
+ }
18
+ };
19
+ function validatePortableComponents(path) {
20
+ for (const component of path.split("/")) {
21
+ if (component.endsWith(".") || component.endsWith(" ")) {
22
+ throw new Error(`Update path component must not end with a dot or space: '${component}'.`);
23
+ }
24
+ if (component.includes(":")) {
25
+ throw new Error(`Update path component must not contain a colon: '${component}'.`);
26
+ }
27
+ if (/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i.test(component)) {
28
+ throw new Error(`Update path component uses a reserved Windows device name: '${component}'.`);
29
+ }
30
+ }
31
+ }
32
+ function resolveUpdatePath(root, relativePath) {
33
+ let portable;
34
+ try {
35
+ portable = normalizeManifestPath(relativePath);
36
+ } catch (error) {
37
+ throw new UpdatePathError(
38
+ "invalid-path",
39
+ relativePath,
40
+ error instanceof Error ? error.message : `Invalid update path '${relativePath}'.`
41
+ );
42
+ }
43
+ try {
44
+ validatePortableComponents(portable);
45
+ } catch (error) {
46
+ throw new UpdatePathError(
47
+ "invalid-path",
48
+ relativePath,
49
+ error instanceof Error ? error.message : `Invalid update path '${relativePath}'.`
50
+ );
51
+ }
52
+ if (isAbsolute(portable)) {
53
+ throw new UpdatePathError("outside-root", portable, `Update path must stay inside the project root: '${portable}'.`);
54
+ }
55
+ let canonicalRoot;
56
+ try {
57
+ canonicalRoot = realpathSync(root);
58
+ if (!lstatSync(canonicalRoot).isDirectory()) {
59
+ throw new Error("root is not a directory");
60
+ }
61
+ } catch (error) {
62
+ throw new UpdatePathError(
63
+ "missing-root",
64
+ root,
65
+ `Unable to resolve project root '${root}': ${error instanceof Error ? error.message : String(error)}`
66
+ );
67
+ }
68
+ const candidate = join(canonicalRoot, ...portable.split("/"));
69
+ const escaped = relative(canonicalRoot, candidate);
70
+ if (escaped === ".." || escaped.startsWith(`..${sep}`) || isAbsolute(escaped)) {
71
+ throw new UpdatePathError("outside-root", portable, `Update path escapes the project root: '${portable}'.`);
72
+ }
73
+ let current = canonicalRoot;
74
+ const parts = portable.split("/");
75
+ for (let index = 0; index < parts.length; index += 1) {
76
+ current = join(current, parts[index]);
77
+ let stat;
78
+ try {
79
+ stat = lstatSync(current);
80
+ } catch (error) {
81
+ if (error.code === "ENOENT") break;
82
+ throw new UpdatePathError("invalid-path", portable, `Unable to inspect update path '${portable}': ${String(error)}`);
83
+ }
84
+ if (stat.isSymbolicLink()) {
85
+ throw new UpdatePathError("symlink", portable, `Update path traverses a symlink: '${portable}'.`);
86
+ }
87
+ if (index < parts.length - 1 && !stat.isDirectory()) {
88
+ throw new UpdatePathError("nondirectory-ancestor", portable, `Update path has a non-directory ancestor: '${portable}'.`);
89
+ }
90
+ }
91
+ return candidate;
92
+ }
93
+
94
+ export {
95
+ resolveUpdatePath
96
+ };
97
+ //# sourceMappingURL=chunk-OMFGDJW4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/update-paths.ts"],"sourcesContent":["import { lstatSync, realpathSync } from 'node:fs';\nimport { isAbsolute, join, relative, sep } from 'node:path';\n\nimport { normalizeManifestPath } from './install-manifest.js';\n\nexport type UpdatePathErrorCode =\n | 'invalid-path'\n | 'outside-root'\n | 'missing-root'\n | 'symlink'\n | 'nondirectory-ancestor';\n\n/** A path rejected before an updater can stage, inspect, or mutate it. */\nexport class UpdatePathError extends Error {\n readonly code: UpdatePathErrorCode;\n readonly path: string;\n\n constructor(code: UpdatePathErrorCode, path: string, message: string) {\n super(message);\n this.name = 'UpdatePathError';\n this.code = code;\n this.path = path;\n }\n}\n\nfunction validatePortableComponents(path: string): void {\n for (const component of path.split('/')) {\n if (component.endsWith('.') || component.endsWith(' ')) {\n throw new Error(`Update path component must not end with a dot or space: '${component}'.`);\n }\n if (component.includes(':')) {\n throw new Error(`Update path component must not contain a colon: '${component}'.`);\n }\n // Windows reserves these device basenames even when an extension is\n // present. Reject them on every host so an update plan remains portable.\n if (/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\\..*)?$/i.test(component)) {\n throw new Error(`Update path component uses a reserved Windows device name: '${component}'.`);\n }\n }\n}\n\n/**\n * Resolve a persisted project-relative path beneath a canonical project root.\n *\n * Every existing descendant is inspected with lstat, so symlinks are rejected\n * even when they point back inside the project. Missing trailing components are\n * allowed for staging and first-time writes; an existing ancestor must remain\n * a directory. Callers should repeat this check immediately before a mutation.\n */\nexport function resolveUpdatePath(root: string, relativePath: string): string {\n let portable: string;\n try {\n portable = normalizeManifestPath(relativePath);\n } catch (error) {\n throw new UpdatePathError(\n 'invalid-path',\n relativePath,\n error instanceof Error ? error.message : `Invalid update path '${relativePath}'.`,\n );\n }\n try {\n validatePortableComponents(portable);\n } catch (error) {\n throw new UpdatePathError(\n 'invalid-path',\n relativePath,\n error instanceof Error ? error.message : `Invalid update path '${relativePath}'.`,\n );\n }\n\n // normalizeManifestPath already rejects absolute paths, but retain an\n // explicit check at this boundary so this function remains safe if the\n // persistence validator changes later.\n if (isAbsolute(portable)) {\n throw new UpdatePathError('outside-root', portable, `Update path must stay inside the project root: '${portable}'.`);\n }\n\n let canonicalRoot: string;\n try {\n canonicalRoot = realpathSync(root);\n if (!lstatSync(canonicalRoot).isDirectory()) {\n throw new Error('root is not a directory');\n }\n } catch (error) {\n throw new UpdatePathError(\n 'missing-root',\n root,\n `Unable to resolve project root '${root}': ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n\n const candidate = join(canonicalRoot, ...portable.split('/'));\n const escaped = relative(canonicalRoot, candidate);\n if (escaped === '..' || escaped.startsWith(`..${sep}`) || isAbsolute(escaped)) {\n throw new UpdatePathError('outside-root', portable, `Update path escapes the project root: '${portable}'.`);\n }\n\n let current = canonicalRoot;\n const parts = portable.split('/');\n for (let index = 0; index < parts.length; index += 1) {\n current = join(current, parts[index]);\n let stat;\n try {\n stat = lstatSync(current);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === 'ENOENT') break;\n throw new UpdatePathError('invalid-path', portable, `Unable to inspect update path '${portable}': ${String(error)}`);\n }\n if (stat.isSymbolicLink()) {\n throw new UpdatePathError('symlink', portable, `Update path traverses a symlink: '${portable}'.`);\n }\n if (index < parts.length - 1 && !stat.isDirectory()) {\n throw new UpdatePathError('nondirectory-ancestor', portable, `Update path has a non-directory ancestor: '${portable}'.`);\n }\n }\n\n return candidate;\n}\n"],"mappings":";;;;;;AAAA,SAAS,WAAW,oBAAoB;AACxC,SAAS,YAAY,MAAM,UAAU,WAAW;AAYzC,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAChC;AAAA,EACA;AAAA,EAET,YAAY,MAA2B,MAAc,SAAiB;AACpE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,2BAA2B,MAAoB;AACtD,aAAW,aAAa,KAAK,MAAM,GAAG,GAAG;AACvC,QAAI,UAAU,SAAS,GAAG,KAAK,UAAU,SAAS,GAAG,GAAG;AACtD,YAAM,IAAI,MAAM,4DAA4D,SAAS,IAAI;AAAA,IAC3F;AACA,QAAI,UAAU,SAAS,GAAG,GAAG;AAC3B,YAAM,IAAI,MAAM,oDAAoD,SAAS,IAAI;AAAA,IACnF;AAGA,QAAI,oDAAoD,KAAK,SAAS,GAAG;AACvE,YAAM,IAAI,MAAM,+DAA+D,SAAS,IAAI;AAAA,IAC9F;AAAA,EACF;AACF;AAUO,SAAS,kBAAkB,MAAc,cAA8B;AAC5E,MAAI;AACJ,MAAI;AACF,eAAW,sBAAsB,YAAY;AAAA,EAC/C,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU,wBAAwB,YAAY;AAAA,IAC/E;AAAA,EACF;AACA,MAAI;AACF,+BAA2B,QAAQ;AAAA,EACrC,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU,wBAAwB,YAAY;AAAA,IAC/E;AAAA,EACF;AAKA,MAAI,WAAW,QAAQ,GAAG;AACxB,UAAM,IAAI,gBAAgB,gBAAgB,UAAU,mDAAmD,QAAQ,IAAI;AAAA,EACrH;AAEA,MAAI;AACJ,MAAI;AACF,oBAAgB,aAAa,IAAI;AACjC,QAAI,CAAC,UAAU,aAAa,EAAE,YAAY,GAAG;AAC3C,YAAM,IAAI,MAAM,yBAAyB;AAAA,IAC3C;AAAA,EACF,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,mCAAmC,IAAI,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IACrG;AAAA,EACF;AAEA,QAAM,YAAY,KAAK,eAAe,GAAG,SAAS,MAAM,GAAG,CAAC;AAC5D,QAAM,UAAU,SAAS,eAAe,SAAS;AACjD,MAAI,YAAY,QAAQ,QAAQ,WAAW,KAAK,GAAG,EAAE,KAAK,WAAW,OAAO,GAAG;AAC7E,UAAM,IAAI,gBAAgB,gBAAgB,UAAU,0CAA0C,QAAQ,IAAI;AAAA,EAC5G;AAEA,MAAI,UAAU;AACd,QAAM,QAAQ,SAAS,MAAM,GAAG;AAChC,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,cAAU,KAAK,SAAS,MAAM,KAAK,CAAC;AACpC,QAAI;AACJ,QAAI;AACF,aAAO,UAAU,OAAO;AAAA,IAC1B,SAAS,OAAO;AACd,UAAK,MAAgC,SAAS,SAAU;AACxD,YAAM,IAAI,gBAAgB,gBAAgB,UAAU,kCAAkC,QAAQ,MAAM,OAAO,KAAK,CAAC,EAAE;AAAA,IACrH;AACA,QAAI,KAAK,eAAe,GAAG;AACzB,YAAM,IAAI,gBAAgB,WAAW,UAAU,qCAAqC,QAAQ,IAAI;AAAA,IAClG;AACA,QAAI,QAAQ,MAAM,SAAS,KAAK,CAAC,KAAK,YAAY,GAAG;AACnD,YAAM,IAAI,gBAAgB,yBAAyB,UAAU,8CAA8C,QAAQ,IAAI;AAAA,IACzH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}