@tantawowa/hosanna-tools 3.19.0 → 3.21.0

package/README.md

@@ -435,9 +435,33 @@ npm run apple:build-code
 ```
 
 ### CI Commands (`ci:*`) - Continuous Integration
+- `ci:project-actions --base <ref> [--head <ref>]` - Select `hst.json` `prScopeRules` actions for changed files; add `--run` to execute matched npm scripts
 - `ci:extract-pkg-key` - Extract signing key from an existing signed Roku package as base64
 - `config set --git-url` - Configure hosanna.json git-url from argument or environment
 
+Project-specific PR rules belong in `hst.json`; SDK source/version settings
+remain in `hosanna.json`:
+
+```json
+{
+  "prScopeRules": [
+    {
+      "name": "collection view performance check",
+      "globs": ["src/hosanna-list/**", "src/hosanna-ui/views/lib/BaseView.ts"],
+      "actions": [
+        { "kind": "npm", "command": "regression:collectionView" }
+      ]
+    }
+  ]
+}
+```
+
+Rules and actions run in declaration order. Repeated identical actions are run
+once. The command emits `matched`, `matched_rules`, and `actions` through
+`GITHUB_OUTPUT` when that environment variable is present. This first version
+supports npm actions; the action object is intentionally extensible for future
+consumers.
+
 ### Build Config Commands (`build-config:*`) - Build/runtime config
 - `build-config:resolve` - Merge build config overlays into `assets/meta/build-config.json`
 - `build-config:restore-secrets` - Restore ignored `secrets/*.json` overlays from `BUILD_CONFIG_SECRETS_*_BASE64`

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-08-17T09:27:29+00:00",
-  "buildDateISO": "2026-08-17T09:27:29.656Z",
+  "buildDate": "2026-08-20T11:42:47+00:00",
+  "buildDateISO": "2026-08-20T11:42:47.262Z",
   "timeZone": "UTC",
-  "gitHash": "3a0ec15"
+  "gitHash": "78ab335"
 }

package/dist/cli.js

@@ -947,6 +947,38 @@ async function runEnvironmentCommand(action, verbose) {
         console.error(`❌ Failed to map Roku stack trace: ${msg}`);
         process.exit(1);
     }
+})
+    .command('ci:project-actions', 'Select config-driven project actions for files changed between two Git revisions', yargs => yargs
+    .option('base', { type: 'string', demandOption: true, describe: 'Base Git revision' })
+    .option('head', { type: 'string', default: 'HEAD', describe: 'Candidate Git revision' })
+    .option('section', { type: 'string', default: 'prScopeRules', describe: 'hst.json rule-array property to evaluate' })
+    .option('run', { type: 'boolean', default: false, describe: 'Run selected npm actions sequentially' })
+    .option('format', { type: 'string', choices: ['text', 'json'], default: 'text', describe: 'Output format' })
+    .example('$0 ci:project-actions --base origin/main --head HEAD', 'Show PR-scoped actions from hst.json')
+    .example('$0 ci:project-actions --base origin/main --run', 'Run matched npm actions'), async (args) => {
+    try {
+        const mod = await Promise.resolve().then(() => __importStar(require('./support-tools/project-actions.js')));
+        const cwd = process.cwd();
+        const selection = mod.selectProjectActions(mod.loadProjectActionConfig(cwd), args.section, mod.changedProjectFiles(args.base, args.head, cwd));
+        mod.writeProjectActionGitHubOutputs(process.env.GITHUB_OUTPUT, selection);
+        if (args.format === 'json') {
+            console.info(JSON.stringify(selection, null, 2));
+        }
+        else {
+            console.info(`Changed files (${selection.changedFiles.length}):`);
+            for (const file of selection.changedFiles)
+                console.info(`  ${file}`);
+            console.info(`Matched ${args.section} rules: ${selection.matchedRules.map(rule => rule.name).join(', ') || '(none)'}`);
+            console.info(`Selected actions: ${selection.actions.map(action => `npm run ${action.command}`).join(', ') || '(none)'}`);
+        }
+        if (args.run)
+            mod.runSelectedNpmActions(selection, cwd);
+        process.exit(0);
+    }
+    catch (err) {
+        console.error('❌ ci:project-actions failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
 })
     .command('ci:extract-pkg-key <input-pkg>', 'Extract signing key from an existing signed Roku package as base64 for CI use', yargs => yargs
     .positional('input-pkg', { type: 'string', describe: 'Path to existing signed Roku package (.pkg) file to extract key from' })