@runeditrun/rer 0.2.83 → 0.2.84

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 (157) hide show
  1. package/cli/authoring.mjs +1 -0
  2. package/cli/contract.mjs +1 -1
  3. package/cli/demo-host.mjs +5 -1
  4. package/cli/demo.mjs +6 -1
  5. package/cli/export.mjs +1 -1
  6. package/cli/parse.mjs +1 -1
  7. package/edition-authoring/base-copies.mjs +72 -25
  8. package/edition-authoring/copy-checkout.mjs +7 -120
  9. package/edition-authoring/edition-migrations.mjs +41 -0
  10. package/edition-authoring/files.mjs +67 -0
  11. package/edition-authoring/lock.mjs +2 -2
  12. package/edition-authoring/module-closure.mjs +232 -0
  13. package/edition-authoring/module-edges.mjs +100 -0
  14. package/edition-authoring/module-resolution.mjs +66 -0
  15. package/edition-authoring/module-syntax.mjs +57 -0
  16. package/edition-authoring/package-target.mjs +92 -0
  17. package/edition-authoring/runtime-dependencies.mjs +74 -97
  18. package/edition-authoring/vendor/babel-parser/LICENSE +22 -0
  19. package/edition-authoring/vendor/babel-parser/README.md +21 -0
  20. package/edition-authoring/vendor/babel-parser/babel-helper-string-parser/index.mjs +292 -0
  21. package/edition-authoring/vendor/babel-parser/babel-helper-validator-identifier/identifier.mjs +66 -0
  22. package/edition-authoring/vendor/babel-parser/babel-helper-validator-identifier/index.mjs +13 -0
  23. package/edition-authoring/vendor/babel-parser/babel-helper-validator-identifier/keyword.mjs +31 -0
  24. package/edition-authoring/vendor/babel-parser/babel-parser/index.mjs +99 -0
  25. package/edition-authoring/vendor/babel-parser/babel-parser/options.mjs +81 -0
  26. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/bind-operator-errors.mjs +8 -0
  27. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/module-errors.mjs +15 -0
  28. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/parse-expression-errors.mjs +10 -0
  29. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/pipeline-operator-errors.mjs +29 -0
  30. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/standard-errors.mjs +224 -0
  31. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/strict-mode-errors.mjs +17 -0
  32. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error/to-node-description.mjs +31 -0
  33. package/edition-authoring/vendor/babel-parser/babel-parser/parse-error.mjs +114 -0
  34. package/edition-authoring/vendor/babel-parser/babel-parser/parser/base.mjs +34 -0
  35. package/edition-authoring/vendor/babel-parser/babel-parser/parser/comments.mjs +199 -0
  36. package/edition-authoring/vendor/babel-parser/babel-parser/parser/expression.mjs +1794 -0
  37. package/edition-authoring/vendor/babel-parser/babel-parser/parser/index.mjs +76 -0
  38. package/edition-authoring/vendor/babel-parser/babel-parser/parser/lval.mjs +439 -0
  39. package/edition-authoring/vendor/babel-parser/babel-parser/parser/node.mjs +111 -0
  40. package/edition-authoring/vendor/babel-parser/babel-parser/parser/statement.mjs +1962 -0
  41. package/edition-authoring/vendor/babel-parser/babel-parser/parser/util.mjs +244 -0
  42. package/edition-authoring/vendor/babel-parser/babel-parser/plugin-utils.mjs +116 -0
  43. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/estree.mjs +417 -0
  44. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/flow/index.mjs +2412 -0
  45. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/flow/scope.mjs +37 -0
  46. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/jsx/index.mjs +420 -0
  47. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/jsx/xhtml.mjs +261 -0
  48. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/placeholders.mjs +205 -0
  49. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/typescript/index.mjs +2889 -0
  50. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/typescript/scope.mjs +115 -0
  51. package/edition-authoring/vendor/babel-parser/babel-parser/plugins/v8intrinsic.mjs +26 -0
  52. package/edition-authoring/vendor/babel-parser/babel-parser/tokenizer/context.mjs +22 -0
  53. package/edition-authoring/vendor/babel-parser/babel-parser/tokenizer/index.mjs +1037 -0
  54. package/edition-authoring/vendor/babel-parser/babel-parser/tokenizer/state.mjs +178 -0
  55. package/edition-authoring/vendor/babel-parser/babel-parser/tokenizer/types.mjs +583 -0
  56. package/edition-authoring/vendor/babel-parser/babel-parser/types.mjs +1 -0
  57. package/edition-authoring/vendor/babel-parser/babel-parser/util/class-scope.mjs +82 -0
  58. package/edition-authoring/vendor/babel-parser/babel-parser/util/expression-scope.mjs +121 -0
  59. package/edition-authoring/vendor/babel-parser/babel-parser/util/identifier.mjs +23 -0
  60. package/edition-authoring/vendor/babel-parser/babel-parser/util/location.mjs +34 -0
  61. package/edition-authoring/vendor/babel-parser/babel-parser/util/production-parameter.mjs +40 -0
  62. package/edition-authoring/vendor/babel-parser/babel-parser/util/scope.mjs +173 -0
  63. package/edition-authoring/vendor/babel-parser/babel-parser/util/scopeflags.mjs +66 -0
  64. package/edition-authoring/vendor/babel-parser/babel-parser/util/whitespace.mjs +61 -0
  65. package/edition-authoring/vendor/yaml/LICENSE +13 -0
  66. package/edition-authoring/vendor/yaml/README.md +11 -0
  67. package/edition-authoring/vendor/yaml/compose/compose-collection.mjs +88 -0
  68. package/edition-authoring/vendor/yaml/compose/compose-doc.mjs +43 -0
  69. package/edition-authoring/vendor/yaml/compose/compose-node.mjs +110 -0
  70. package/edition-authoring/vendor/yaml/compose/compose-scalar.mjs +86 -0
  71. package/edition-authoring/vendor/yaml/compose/composer.mjs +218 -0
  72. package/edition-authoring/vendor/yaml/compose/resolve-block-map.mjs +115 -0
  73. package/edition-authoring/vendor/yaml/compose/resolve-block-scalar.mjs +198 -0
  74. package/edition-authoring/vendor/yaml/compose/resolve-block-seq.mjs +49 -0
  75. package/edition-authoring/vendor/yaml/compose/resolve-end.mjs +37 -0
  76. package/edition-authoring/vendor/yaml/compose/resolve-flow-collection.mjs +207 -0
  77. package/edition-authoring/vendor/yaml/compose/resolve-flow-scalar.mjs +228 -0
  78. package/edition-authoring/vendor/yaml/compose/resolve-props.mjs +148 -0
  79. package/edition-authoring/vendor/yaml/compose/util-contains-newline.mjs +34 -0
  80. package/edition-authoring/vendor/yaml/compose/util-empty-scalar-position.mjs +27 -0
  81. package/edition-authoring/vendor/yaml/compose/util-flow-indent-check.mjs +15 -0
  82. package/edition-authoring/vendor/yaml/compose/util-map-includes.mjs +13 -0
  83. package/edition-authoring/vendor/yaml/doc/Document.mjs +333 -0
  84. package/edition-authoring/vendor/yaml/doc/anchors.mjs +74 -0
  85. package/edition-authoring/vendor/yaml/doc/applyReviver.mjs +54 -0
  86. package/edition-authoring/vendor/yaml/doc/createNode.mjs +88 -0
  87. package/edition-authoring/vendor/yaml/doc/directives.mjs +176 -0
  88. package/edition-authoring/vendor/yaml/errors.mjs +57 -0
  89. package/edition-authoring/vendor/yaml/index.mjs +17 -0
  90. package/edition-authoring/vendor/yaml/log.mjs +11 -0
  91. package/edition-authoring/vendor/yaml/nodes/Alias.mjs +119 -0
  92. package/edition-authoring/vendor/yaml/nodes/Collection.mjs +147 -0
  93. package/edition-authoring/vendor/yaml/nodes/Node.mjs +38 -0
  94. package/edition-authoring/vendor/yaml/nodes/Pair.mjs +36 -0
  95. package/edition-authoring/vendor/yaml/nodes/Scalar.mjs +24 -0
  96. package/edition-authoring/vendor/yaml/nodes/YAMLMap.mjs +144 -0
  97. package/edition-authoring/vendor/yaml/nodes/YAMLSeq.mjs +113 -0
  98. package/edition-authoring/vendor/yaml/nodes/addPairToJSMap.mjs +62 -0
  99. package/edition-authoring/vendor/yaml/nodes/identity.mjs +36 -0
  100. package/edition-authoring/vendor/yaml/nodes/toJS.mjs +35 -0
  101. package/edition-authoring/vendor/yaml/parse/cst-scalar.mjs +214 -0
  102. package/edition-authoring/vendor/yaml/parse/cst-stringify.mjs +61 -0
  103. package/edition-authoring/vendor/yaml/parse/cst-visit.mjs +97 -0
  104. package/edition-authoring/vendor/yaml/parse/cst.mjs +98 -0
  105. package/edition-authoring/vendor/yaml/parse/lexer.mjs +722 -0
  106. package/edition-authoring/vendor/yaml/parse/line-counter.mjs +39 -0
  107. package/edition-authoring/vendor/yaml/parse/parser.mjs +975 -0
  108. package/edition-authoring/vendor/yaml/public-api.mjs +102 -0
  109. package/edition-authoring/vendor/yaml/schema/Schema.mjs +37 -0
  110. package/edition-authoring/vendor/yaml/schema/common/map.mjs +17 -0
  111. package/edition-authoring/vendor/yaml/schema/common/null.mjs +15 -0
  112. package/edition-authoring/vendor/yaml/schema/common/seq.mjs +17 -0
  113. package/edition-authoring/vendor/yaml/schema/common/string.mjs +14 -0
  114. package/edition-authoring/vendor/yaml/schema/core/bool.mjs +19 -0
  115. package/edition-authoring/vendor/yaml/schema/core/float.mjs +43 -0
  116. package/edition-authoring/vendor/yaml/schema/core/int.mjs +38 -0
  117. package/edition-authoring/vendor/yaml/schema/core/schema.mjs +23 -0
  118. package/edition-authoring/vendor/yaml/schema/json/schema.mjs +62 -0
  119. package/edition-authoring/vendor/yaml/schema/tags.mjs +96 -0
  120. package/edition-authoring/vendor/yaml/schema/yaml-1.1/binary.mjs +59 -0
  121. package/edition-authoring/vendor/yaml/schema/yaml-1.1/bool.mjs +26 -0
  122. package/edition-authoring/vendor/yaml/schema/yaml-1.1/float.mjs +46 -0
  123. package/edition-authoring/vendor/yaml/schema/yaml-1.1/int.mjs +71 -0
  124. package/edition-authoring/vendor/yaml/schema/yaml-1.1/merge.mjs +67 -0
  125. package/edition-authoring/vendor/yaml/schema/yaml-1.1/omap.mjs +74 -0
  126. package/edition-authoring/vendor/yaml/schema/yaml-1.1/pairs.mjs +78 -0
  127. package/edition-authoring/vendor/yaml/schema/yaml-1.1/schema.mjs +39 -0
  128. package/edition-authoring/vendor/yaml/schema/yaml-1.1/set.mjs +93 -0
  129. package/edition-authoring/vendor/yaml/schema/yaml-1.1/timestamp.mjs +101 -0
  130. package/edition-authoring/vendor/yaml/stringify/foldFlowLines.mjs +146 -0
  131. package/edition-authoring/vendor/yaml/stringify/stringify.mjs +130 -0
  132. package/edition-authoring/vendor/yaml/stringify/stringifyCollection.mjs +155 -0
  133. package/edition-authoring/vendor/yaml/stringify/stringifyComment.mjs +20 -0
  134. package/edition-authoring/vendor/yaml/stringify/stringifyDocument.mjs +85 -0
  135. package/edition-authoring/vendor/yaml/stringify/stringifyNumber.mjs +25 -0
  136. package/edition-authoring/vendor/yaml/stringify/stringifyPair.mjs +150 -0
  137. package/edition-authoring/vendor/yaml/stringify/stringifyString.mjs +338 -0
  138. package/edition-authoring/vendor/yaml/util.mjs +11 -0
  139. package/edition-authoring/vendor/yaml/visit.mjs +233 -0
  140. package/edition-authoring/workflow-copies.mjs +125 -0
  141. package/edition-authoring/workflow-scripts.mjs +112 -0
  142. package/foundation/runtime/contract-docs.mjs +753 -0
  143. package/global/CHANGELOG.md +22 -3
  144. package/modules/demo/declaration.mjs +1 -4
  145. package/modules/demo/vite.mjs +1 -1
  146. package/modules/deploy-kit/README.md +1 -1
  147. package/modules/deploy-kit/templates.mjs +3 -3
  148. package/onboarding/operator-installer.mjs +2 -2
  149. package/package.json +1 -1
  150. package/scripts/publish-check/README.md +6 -0
  151. package/scripts/publish-check/history_scan.py +5 -3
  152. package/scripts/publish-check/hygiene_config.py +2 -1
  153. package/scripts/publish-check/report.py +9 -3
  154. package/scripts/publish-check/third-party-notices.json +13 -0
  155. package/scripts/publish-check/third_party_notices.py +38 -0
  156. package/scripts/publish-check/tree_scan.py +6 -0
  157. package/scripts/publish-check.mjs +1 -1
@@ -0,0 +1,125 @@
1
+ // Template adoption is a separate, narrow ownership decision: only tracked
2
+ // copies of known template bytes qualify. Helpers use the ordinary refresh
3
+ // preflight and share the workflow's all-or-nothing write plan.
4
+ import fs from 'node:fs';
5
+ import path from 'node:path';
6
+ import {raw, safe, physicalEntry, requirePhysical} from './files.mjs';
7
+ import {workflowScripts, literalPaths} from './workflow-scripts.mjs';
8
+
9
+ const inside = (name, prefix) => name === prefix || name.startsWith(prefix + '/');
10
+ const mapped = (source, copy) => copy.path + source.slice(copy.originPath.length);
11
+ const templates = [
12
+ ['.github/workflows/verify.yml', ['export/verify.yml', 'default-seed/.github/workflows/verify.yml']],
13
+ ['.github/workflows/verify-nightly.yml', ['export/verify-nightly.yml', 'default-seed/.github/workflows/verify-nightly.yml']],
14
+ ['VERIFY-WORKFLOW.md', ['export/VERIFY-WORKFLOW.md', 'default-seed/VERIFY-WORKFLOW.md']],
15
+ ];
16
+ const tracked = root => new Set(raw(root, 'ls-files', '-z').toString('utf8').split('\0').filter(Boolean));
17
+
18
+ function include(plans, target, source, entry, revision) {
19
+ let plan = plans.find(plan => inside(target, plan.copy.path));
20
+ if (plan && mapped(source, plan.copy) !== target) throw Error(`Workflow dependency ${target} conflicts with its Base copy mapping`);
21
+ if (plan?.removed.includes(target)) throw Error(`Workflow dependency ${target} was removed locally but is still invoked; restore it before refresh-base; no files were refreshed.`);
22
+ if (!plan) {
23
+ if (plans.some(plan => inside(plan.copy.path, target))) throw Error(`Workflow dependency ${target} overlaps an existing Base copy`);
24
+ plan = {copy: {path: target, originPath: source, revision, files: {}, modes: {}}, sources: [], removed: []};
25
+ plans.push(plan);
26
+ }
27
+ if (!plan.sources.some(([name]) => name === source)) plan.sources.push([source, entry]);
28
+ }
29
+
30
+ export function adoptWorkflowTemplates(root, plans, {tree, read, revision, files}) {
31
+ const index = tracked(root), templateAdoptions = [], notices = [];
32
+ for (const [target, historySources] of templates) {
33
+ const [source] = historySources;
34
+ if (!tree.has(source)) continue;
35
+ const owner = plans.find(plan => inside(target, plan.copy.path));
36
+ if (owner && !owner.copy.adapted?.[target]) continue;
37
+ const physical = physicalEntry(root, target);
38
+ if (physical.kind === 'alias') {
39
+ notices.push(`${target}: preserved physical entry ${physical.physical}; indexed spelling differs. Move it aside and restore ${target} before adopting the template.`);
40
+ continue;
41
+ }
42
+ requirePhysical(root, target);
43
+ const file = files.get(target) ?? (physical.stat && {regular: true, read: () => fs.readFileSync(physical.target)});
44
+ if (!file?.regular) continue;
45
+ let match;
46
+ if (!owner && index.has(target)) {
47
+ const bytes = file.read();
48
+ // Full committed history includes the published 0.2.83 runner.temp
49
+ // template as well as earlier default-seed mirrors. No release pins or
50
+ // guessed structural equality can transfer a seed's ownership.
51
+ match = historySources.flatMap(name => read.history(revision, name))
52
+ .find(entry => read.blobs([entry.object]).get(entry.object).equals(bytes));
53
+ }
54
+ if (match) {
55
+ include(plans, target, source, tree.get(source), revision);
56
+ templateAdoptions.push({path: target, originPath: source, from: match.revision});
57
+ } else if (target.endsWith('.yml')) {
58
+ notices.push(`${target}: preserved seed-owned workflow. The current template pins Ubuntu 24.04 and moves browser and apt caches to the runner temporary directory. To adopt, merge export/${path.posix.basename(source)} from Base ${revision} into ${target}, then run node node_modules/@runeditrun/rer/edition-authoring/cli.mjs record-base ${target} ${source} ${revision} --base <base-checkout> and repeat rer refresh-base --ref ${revision} --base <base-checkout>.`);
59
+ }
60
+ }
61
+ return {templateAdoptions, notices};
62
+ }
63
+
64
+ function invocations(text) {
65
+ const {scripts, uses} = workflowScripts(text);
66
+ const paths = scripts.flatMap(literalPaths).flatMap(name => {
67
+ try { return [safe(name)]; }
68
+ catch (error) {
69
+ if (name.startsWith('scripts/') || name.startsWith('.github/workflows/')) throw error;
70
+ return []; // A URL or command option is not a relative helper path.
71
+ }
72
+ });
73
+ return [...new Set([...uses.map(name => safe(name.slice(2))), ...paths])];
74
+ }
75
+
76
+ function candidates(invoked) {
77
+ if (invoked.startsWith('.github/workflows/')) return ['export/' + path.posix.basename(invoked), 'default-seed/' + invoked];
78
+ return ['export/' + invoked.replace(/^scripts\//, ''), 'default-seed/' + invoked,
79
+ ...(invoked.startsWith('scripts/') ? [invoked.slice(8)] : [])]
80
+ .filter(name => !name.startsWith('scripts/') && !name.startsWith('.github/workflows/'));
81
+ }
82
+
83
+ export function completeWorkflowHelpers(root, plans, {tree, read, revision}) {
84
+ const index = tracked(root);
85
+ const queue = plans.flatMap(plan => plan.sources.filter(([source]) => /(?:^|\/)\.github\/workflows\/[^/]+\.ya?ml$/.test(mapped(source, plan.copy)))
86
+ .map(([source, entry]) => ({source, entry, target: mapped(source, plan.copy)})));
87
+ // Preserved and adapted workflows have the same helper requirements as a
88
+ // copied workflow. Parse the bytes that will actually remain in the seed.
89
+ const queued = new Set(queue.map(item => item.target));
90
+ for (const target of index) if (/(?:^|\/)\.github\/workflows\/[^/]+\.ya?ml$/.test(target) && !queued.has(target)) {
91
+ // Template adoption already preserves an unrecorded physical alias with a
92
+ // notice. It cannot become a canonical caller in the helper write plan.
93
+ if (templates.some(([name]) => name === target) && physicalEntry(root, target).kind === 'alias') continue;
94
+ const {stat} = requirePhysical(root, target);
95
+ if (stat) queue.push({target});
96
+ }
97
+ const seen = new Set();
98
+ for (let i = 0; i < queue.length; i++) {
99
+ const {entry, target} = queue[i];
100
+ if (seen.has(target)) continue;
101
+ seen.add(target);
102
+ const destinationRoot = target.includes('.github/workflows/') ? target.slice(0, target.indexOf('.github/workflows/')) : '';
103
+ const text = entry ? read.blobs([entry.object]).get(entry.object).toString('utf8') : fs.readFileSync(path.join(root, target), 'utf8');
104
+ for (const invoked of invocations(text)) {
105
+ const dependency = candidates(invoked).find(name => tree.has(name));
106
+ if (!dependency) continue;
107
+ const destination = safe(destinationRoot + invoked);
108
+ const {stat} = requirePhysical(root, destination);
109
+ const owner = plans.find(plan => inside(destination, plan.copy.path));
110
+ if (owner?.removed.includes(destination)) throw Error(`Workflow dependency ${destination} was removed locally but is still invoked; restore it before refresh-base; no files were refreshed.`);
111
+ const planned = owner?.sources.find(([name]) => mapped(name, owner.copy) === destination);
112
+ if (planned) {
113
+ if (/\.ya?ml$/.test(planned[0])) queue.push({source: planned[0], entry: planned[1], target: destination});
114
+ continue;
115
+ }
116
+ // Tracked, unrecorded helpers and acknowledged adaptations belong to the
117
+ // seed. Equality never transfers that ownership, or untracked ownership.
118
+ if (stat && (index.has(destination) || owner?.copy.adapted?.[destination])) continue;
119
+ if (!stat && index.has(destination)) throw Error(`Workflow dependency ${destination} is tracked but missing; restore it before refresh-base; no files were refreshed.`);
120
+ if (stat) throw Error(`Cannot refresh workflow dependency ${destination}: existing file has no Base copy record or Git index entry. Move it aside or explicitly record-base it before refresh-base; no files were refreshed.`);
121
+ include(plans, destination, dependency, tree.get(dependency), revision);
122
+ if (/\.ya?ml$/.test(dependency)) queue.push({source: dependency, entry: tree.get(dependency), target: destination});
123
+ }
124
+ }
125
+ }
@@ -0,0 +1,112 @@
1
+ import {parseDocument, isMap, isSeq, isScalar} from './vendor/yaml/index.mjs';
2
+
3
+ // YAML owns scalar decoding, folding, indentation, aliases and flow syntax.
4
+ // Only actual workflow job/step nodes contribute commands or local uses.
5
+ export function workflowScripts(text) {
6
+ const document = parseDocument(text, {uniqueKeys: true});
7
+ if (document.errors.length) throw Error(`Cannot parse workflow: ${document.errors.map(error => error.message).join('; ')}`);
8
+ const dereference = node => node?.resolve ? node.resolve(document) : node;
9
+ const scalar = node => {
10
+ const value = dereference(node);
11
+ return isScalar(value) && typeof value.value === 'string' ? value.value : null;
12
+ };
13
+ const result = {scripts: [], uses: []};
14
+ const jobs = dereference(document.get('jobs', true));
15
+ if (!isMap(jobs)) return result;
16
+ for (const {value} of jobs.items) {
17
+ const job = dereference(value);
18
+ if (!isMap(job)) continue;
19
+ const reusable = scalar(job.get('uses', true));
20
+ if (reusable?.startsWith('./')) result.uses.push(reusable);
21
+ const steps = dereference(job.get('steps', true));
22
+ if (!isSeq(steps)) continue;
23
+ for (let step of steps.items) {
24
+ if (step?.resolve) step = step.resolve(document);
25
+ if (!isMap(step)) continue;
26
+ const run = scalar(step.get('run', true)), uses = scalar(step.get('uses', true));
27
+ if (run !== null) result.scripts.push(run);
28
+ if (uses?.startsWith('./')) result.uses.push(uses);
29
+ }
30
+ }
31
+ return result;
32
+ }
33
+
34
+ // Shell lexical words, including adjacent quoted fragments and escaped spaces.
35
+ // Expansions make a word dynamic; their literal subcommands are scanned too.
36
+ // Quoted command strings are scanned recursively, so wrappers need no name list.
37
+ export function shellWords(script) {
38
+ const words = [];
39
+ let value = '', dynamic = false, quote = null, active = false;
40
+ const finish = () => {
41
+ if (active) words.push({value, dynamic});
42
+ value = ''; dynamic = false; active = false;
43
+ };
44
+ for (let i = 0; i < script.length; i++) {
45
+ const character = script[i];
46
+ if (character === '\\' && quote !== "'") {
47
+ const next = script[++i];
48
+ if (next === '\n') continue;
49
+ if (next === undefined) throw Error('Incomplete shell escape in workflow');
50
+ if (quote === '"' && !['$', '`', '"', '\\'].includes(next)) value += '\\';
51
+ value += next; active = true; continue;
52
+ }
53
+ if (quote !== "'" && character === '$' && script[i + 1] === '(') {
54
+ let depth = 1, end = i + 2, innerQuote = null;
55
+ for (; end < script.length; end++) {
56
+ const c = script[end];
57
+ if (c === '\\' && innerQuote !== "'") { end++; continue; }
58
+ if (innerQuote) { if (c === innerQuote) innerQuote = null; continue; }
59
+ if (c === '"' || c === "'") { innerQuote = c; continue; }
60
+ if (c === '(') depth++;
61
+ if (c === ')') { depth--; if (!depth) break; }
62
+ }
63
+ if (depth) throw Error('Unclosed command substitution in workflow');
64
+ words.push(...shellWords(script.slice(i + 2, end)));
65
+ value += '$()'; dynamic = true; active = true; i = end; continue;
66
+ }
67
+ if (quote !== "'" && character === '`') {
68
+ let end = i + 1;
69
+ for (; end < script.length; end++) {
70
+ if (script[end] === '\\') { end++; continue; }
71
+ if (script[end] === '`') break;
72
+ }
73
+ if (end === script.length) throw Error('Unclosed command substitution in workflow');
74
+ words.push(...shellWords(script.slice(i + 1, end)));
75
+ value += '``'; dynamic = true; active = true; i = end; continue;
76
+ }
77
+ if (quote) {
78
+ if (character === quote) { quote = null; continue; }
79
+ if (quote === '"' && ['$','`'].includes(character)) dynamic = true;
80
+ value += character; active = true; continue;
81
+ }
82
+ if (character === '"' || character === "'") { quote = character; active = true; continue; }
83
+ if (character === '#' && !active) {
84
+ while (i + 1 < script.length && script[i + 1] !== '\n') i++;
85
+ continue;
86
+ }
87
+ if (/\s|[;|&()<>]/.test(character)) { finish(); continue; }
88
+ if (['$', '`', '*', '?', '['].includes(character)) dynamic = true;
89
+ value += character; active = true;
90
+ }
91
+ if (quote) throw Error('Unclosed shell quote in workflow');
92
+ finish();
93
+ return words;
94
+ }
95
+
96
+ export function literalPaths(script) {
97
+ const names = new Set();
98
+ function scan(text, ancestors = new Set()) {
99
+ if (ancestors.has(text)) return;
100
+ const nested = new Set([...ancestors, text]);
101
+ for (const {value, dynamic} of shellWords(text)) {
102
+ if (dynamic) continue;
103
+ const relative = value.replace(/^\.\//, '');
104
+ if ((value.startsWith('./') || relative.startsWith('scripts/') || !/\s/.test(value) && (relative.includes('/') || /\.[a-z0-9]+$/i.test(relative))) && !relative.startsWith('/')) names.add(relative);
105
+ // A complete quoted path is one word; only script-like quoted content is
106
+ // recursively tokenized, never a path whose filename contains whitespace.
107
+ else if (/\s/.test(value)) scan(value, nested);
108
+ }
109
+ }
110
+ scan(script);
111
+ return [...names];
112
+ }