feat: ease scaffolding inputs with hub configuration

Author: gblanc-1a

docs/reference/hub-schema.md

@@ -224,6 +224,52 @@ configuration:
   strictMode: true
 ```
 
+## Scaffold Defaults Object (Optional)
+
+Default values for project scaffolding prompts. Each organization-level field is individually skipped when its default is present. Fields like `githubOrg` and `githubRunner` are always shown but pre-filled from defaults.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `githubOrg` | string | GitHub organization name (pre-fills the prompt; always shown) |
+| `githubRunner` | string | GitHub Actions runner label or pattern. Supports `{githubOrg}` placeholder (e.g., `gmsshr-core-{githubOrg}`). Always shown, pre-filled with resolved value. |
+| `organizationName` | string | Organization name for LICENSE (skipped when present — value used directly) |
+| `internalContact` | string | Internal contact email for security/support (skipped when present) |
+| `legalContact` | string | Legal contact email for licensing questions (skipped when present) |
+| `organizationPolicyLink` | string | Organization policy URL (skipped when present) |
+
+**Note:** `author`, `description`, and `tags` are NOT part of scaffold defaults. The author field is pre-filled from the user's GitHub identity instead.
+
+### Runner Pattern
+
+The `githubRunner` field supports a `{githubOrg}` placeholder that is resolved at scaffold time using the selected GitHub organization. Only `{githubOrg}` is supported.
+
+**Example:** `gmsshr-core-{githubOrg}` with org `myorg` → `gmsshr-core-myorg`
+
+### Prompt Behavior
+
+| Field | Hub Default Present | Hub Default Absent |
+|-------|--------------------|--------------------|
+| `projectName` | Always asked | Always asked |
+| `author` | Prefilled from GitHub identity | Prefilled from GitHub identity |
+| `githubOrg` | Prefilled from default | Shown empty |
+| `githubRunner` | Prefilled with resolved pattern | Quick pick (ubuntu-latest / self-hosted / custom) |
+| `organizationName` | **Skipped** — hub value used | Asked |
+| `internalContact` | **Skipped** — hub value used | Asked |
+| `legalContact` | **Skipped** — hub value used | Asked |
+| `organizationPolicyLink` | **Skipped** — hub value used | Asked |
+
+### Example
+
+```yaml
+scaffoldDefaults:
+  githubOrg: "myorg"
+  githubRunner: "gmsshr-core-{githubOrg}"
+  organizationName: "My Organization Inc."
+  internalContact: "security@myorg.com"
+  legalContact: "legal@myorg.com"
+  organizationPolicyLink: "https://myorg.com/policies"
+```
+
 ## Complete Example
 
 ```yaml
@@ -269,6 +315,14 @@ profiles:
 configuration:
   autoSync: true
   syncInterval: 3600
+
+scaffoldDefaults:
+  githubOrg: "myorg"
+  githubRunner: "gmsshr-core-{githubOrg}"
+  organizationName: "My Organization"
+  internalContact: "security@myorg.com"
+  legalContact: "legal@myorg.com"
+  organizationPolicyLink: "https://myorg.com/policies"
 ```
 
 ## Validation

schemas/hub-config.schema.json

@@ -285,6 +285,51 @@
         }
       }
     },
+    "scaffoldDefaults": {
+      "type": "object",
+      "description": "Default values for project scaffolding prompts. When present, organization-level fields are applied automatically without prompting the user.",
+      "additionalProperties": false,
+      "properties": {
+        "githubOrg": {
+          "type": "string",
+          "description": "GitHub organization name (pre-fills the githubOrg prompt)",
+          "minLength": 1,
+          "maxLength": 100,
+          "pattern": "^[a-zA-Z0-9_-]+$"
+        },
+        "githubRunner": {
+          "type": "string",
+          "description": "GitHub Actions runner label or pattern. Supports {githubOrg} placeholder (e.g., 'gmsshr-core-{githubOrg}')",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "organizationName": {
+          "type": "string",
+          "description": "Organization name for LICENSE and documentation",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "internalContact": {
+          "type": "string",
+          "description": "Internal contact email for security/support inquiries",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "legalContact": {
+          "type": "string",
+          "description": "Legal contact email for licensing questions",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "organizationPolicyLink": {
+          "type": "string",
+          "description": "URL to organization policy page",
+          "minLength": 1,
+          "maxLength": 500,
+          "format": "uri"
+        }
+      }
+    },
     "engagement": {
       "type": "object",
       "description": "Engagement features configuration (telemetry, ratings, feedback)",

src/commands/ScaffoldCommand.ts

@@ -5,6 +5,9 @@ import { Logger } from '../utils/logger';
 import { TemplateEngine, TemplateContext } from '../services/TemplateEngine';
 import { FileUtils } from '../utils/fileUtils';
 import { generateSanitizedId } from '../utils/bundleNameUtils';
+import { ScaffoldDefaults } from '../types/hub';
+import { HubManager } from '../services/HubManager';
+import { resolveRunnerPattern } from '../utils/scaffoldUtils';
 import { NpmCliWrapper } from '../utils/NpmCliWrapper';
 
 
@@ -232,28 +235,39 @@ export class ScaffoldCommand {
     /**
      * Run the scaffold command with full UI flow
      */
-    static async runWithUI(): Promise<void> {
+    static async runWithUI(hubManager?: HubManager): Promise<void> {
         const logger = Logger.getInstance();
 
         try {
             // Step 1: Select scaffold type
             const scaffoldType = await ScaffoldCommand.promptForScaffoldType();
             if (!scaffoldType) {return;}
 
-            // Step 2: Handle skill creation in existing project
+            // Step 2: Load scaffold defaults from active hub
+            let scaffoldDefaults: ScaffoldDefaults | undefined;
+            if (hubManager) {
+                try {
+                    const activeHub = await hubManager.getActiveHub();
+                    scaffoldDefaults = activeHub?.config?.scaffoldDefaults;
+                } catch {
+                    // No active hub or hub load failed — proceed without defaults
+                }
+            }
+
+            // Step 3: Handle skill creation in existing project
             if (scaffoldType.value === ScaffoldType.Skill && await ScaffoldCommand.handleSkillInExistingProject()) {
                 return;
             }
 
-            // Step 3: Select target directory
+            // Step 4: Select target directory
             const targetPath = await ScaffoldCommand.promptForTargetDirectory(scaffoldType.label);
             if (!targetPath) {return;}
 
-            // Step 4: Collect project details
-            const options = await ScaffoldCommand.promptForProjectDetails(scaffoldType.value);
+            // Step 5: Collect project details
+            const options = await ScaffoldCommand.promptForProjectDetails(scaffoldType.value, scaffoldDefaults);
             if (!options) {return;}
 
-            // Step 5: Execute scaffold with progress
+            // Step 6: Execute scaffold with progress
             await vscode.window.withProgress(
                 { location: vscode.ProgressLocation.Notification, title: `Scaffolding ${scaffoldType.label}...` },
                 async () => {
@@ -262,7 +276,7 @@ export class ScaffoldCommand {
                 }
             );
 
-            // Step 6: Post-scaffold actions
+            // Step 7: Post-scaffold actions
             await ScaffoldCommand.handlePostScaffoldActions(scaffoldType.label, targetPath);
         } catch (error) {
             logger.error('Scaffold failed', error as Error);
@@ -338,7 +352,7 @@ export class ScaffoldCommand {
     /**
      * Collect project details from user input
      */
-    private static async promptForProjectDetails(type: ScaffoldType): Promise<ScaffoldOptions | undefined> {
+    private static async promptForProjectDetails(type: ScaffoldType, scaffoldDefaults?: ScaffoldDefaults): Promise<ScaffoldOptions | undefined> {
         // Get project name
         const projectName = await vscode.window.showInputBox({
             prompt: 'Enter project name (optional)',
@@ -347,13 +361,11 @@ export class ScaffoldCommand {
             ignoreFocusOut: true
         });
 
-        // Get GitHub runner choice
-        const githubRunner = await ScaffoldCommand.promptForGitHubRunner();
         let details: { description?: string; author?: string; tags?: string[] } = {};
-        let orgDetails: { organizationName?: string; internalContact?: string; legalContact?: string; organizationPolicyLink?: string } = {};
-        
+        let orgDetails: { author?: string; githubOrg?: string; organizationName?: string; internalContact?: string; legalContact?: string; organizationPolicyLink?: string } = {};
+
         // Collect additional details if needed
-        
+
         if (type === ScaffoldType.Apm) {
             const apmDetails = await ScaffoldCommand.promptForApmDetails();
             if (apmDetails) {
@@ -370,9 +382,12 @@ export class ScaffoldCommand {
 
         // For GitHub type, collect organization details for InnerSource LICENSE
         if (type === ScaffoldType.GitHub) {
-            orgDetails = await ScaffoldCommand.promptForOrganizationDetails();
+            orgDetails = await ScaffoldCommand.promptForOrganizationDetails(scaffoldDefaults);
         }
 
+        // Get GitHub runner choice (always asked, prefilled from hub defaults)
+        const githubRunner = await ScaffoldCommand.promptForGitHubRunner(scaffoldDefaults, orgDetails.githubOrg);
+
         return {
             projectName,
             githubRunner,
@@ -384,7 +399,29 @@ export class ScaffoldCommand {
     /**
      * Prompt for GitHub Actions runner configuration
      */
-    private static async promptForGitHubRunner(): Promise<string> {
+    private static async promptForGitHubRunner(scaffoldDefaults?: ScaffoldDefaults, githubOrg?: string): Promise<string> {
+        // If hub provides a runner default, resolve the pattern and pre-fill
+        if (scaffoldDefaults?.githubRunner) {
+            const resolvedRunner = githubOrg
+                ? resolveRunnerPattern(scaffoldDefaults.githubRunner, githubOrg)
+                : scaffoldDefaults.githubRunner;
+            const customRunner = await vscode.window.showInputBox({
+                prompt: 'Enter GitHub Actions runner label',
+                placeHolder: 'my-runner or [self-hosted, linux, x64]',
+                value: resolvedRunner,
+                validateInput: (value) => {
+                    if (!value || value.trim().length === 0) {
+                        return 'Runner label cannot be empty';
+                    }
+                    return undefined;
+                },
+                ignoreFocusOut: true
+            });
+            // undefined means the user pressed Escape — use resolved default
+            // empty string is prevented by validateInput
+            return customRunner ?? resolvedRunner;
+        }
+
         const runnerChoice = await vscode.window.showQuickPick(
             [
                 {
@@ -484,56 +521,63 @@ export class ScaffoldCommand {
     }
 
     /**
-     * Prompt for organization details for InnerSource LICENSE and docs
+     * Prompt for organization details for InnerSource LICENSE and docs.
+     * When hub scaffoldDefaults are present, individual org-level fields are
+     * skipped (hub value used directly). Fields without a hub default are still prompted.
      */
-    private static async promptForOrganizationDetails(): Promise<{ 
+    private static async promptForOrganizationDetails(
+        scaffoldDefaults?: ScaffoldDefaults
+    ): Promise<{
         author?: string;
         githubOrg?: string;
-        organizationName?: string; 
-        internalContact?: string; 
-        legalContact?: string; 
-        organizationPolicyLink?: string 
+        organizationName?: string;
+        internalContact?: string;
+        legalContact?: string;
+        organizationPolicyLink?: string
     }> {
         const author = await vscode.window.showInputBox({
             prompt: 'Enter author name (for package.json)',
             placeHolder: 'Your Name or Team Name',
             ignoreFocusOut: true
         });
 
+        // githubOrg: always asked, prefilled from hub defaults if present
         const githubOrg = await vscode.window.showInputBox({
             prompt: 'Enter GitHub organization/username (for repository URLs)',
             placeHolder: 'your-org',
+            value: scaffoldDefaults?.githubOrg || '',
             ignoreFocusOut: true
         });
 
-        const organizationName = await vscode.window.showInputBox({
+        // Each org field: use hub default if present, otherwise prompt
+        const organizationName = scaffoldDefaults?.organizationName ?? await vscode.window.showInputBox({
             prompt: 'Enter organization name (for LICENSE)',
             placeHolder: 'Your Organization Name',
             value: 'Your Organization',
             ignoreFocusOut: true
         });
 
-        const internalContact = await vscode.window.showInputBox({
+        const internalContact = scaffoldDefaults?.internalContact ?? await vscode.window.showInputBox({
             prompt: 'Enter internal contact email (for security/support inquiries)',
             placeHolder: 'security@yourorg.com',
             value: 'security@yourorg.com',
             ignoreFocusOut: true
         });
 
-        const legalContact = await vscode.window.showInputBox({
+        const legalContact = scaffoldDefaults?.legalContact ?? await vscode.window.showInputBox({
             prompt: 'Enter legal contact email (for licensing questions)',
             placeHolder: 'legal@yourorg.com',
             value: 'legal@yourorg.com',
             ignoreFocusOut: true
         });
 
-        const organizationPolicyLink = await vscode.window.showInputBox({
+        const organizationPolicyLink = scaffoldDefaults?.organizationPolicyLink ?? await vscode.window.showInputBox({
             prompt: 'Enter organization policy URL (optional)',
             placeHolder: 'https://yourorg.com/policies',
             ignoreFocusOut: true
         });
 
-        return { 
+        return {
             author,
             githubOrg,
             organizationName, 

src/extension.ts

@@ -377,7 +377,7 @@ export class PromptRegistryExtension {
             vscode.commands.registerCommand('promptRegistry.cleanupStaleLockfileEntries', () => this.bundleCommands!.cleanupStaleLockfileEntries()),
 
             // Scaffold Command - Create project structure
-            vscode.commands.registerCommand('promptRegistry.scaffoldProject', () => ScaffoldCommand.runWithUI()),
+            vscode.commands.registerCommand('promptRegistry.scaffoldProject', () => ScaffoldCommand.runWithUI(this.hubManager)),
 
 
             // Add Resource Command - Add individual resources

src/types/hub.ts

@@ -23,6 +23,24 @@ export interface HubReference {
   autoSync?: boolean;
 }
 
+/**
+ * Default values for scaffold prompts, provided by hub configuration
+ */
+export interface ScaffoldDefaults {
+  /** GitHub organization name (prefills githubOrg prompt) */
+  githubOrg?: string;
+  /** GitHub Actions runner label or pattern (supports {githubOrg} placeholder) */
+  githubRunner?: string;
+  /** Organization name for LICENSE (skips prompt when present) */
+  organizationName?: string;
+  /** Internal contact email (skips prompt when present) */
+  internalContact?: string;
+  /** Legal contact email (skips prompt when present) */
+  legalContact?: string;
+  /** Organization policy URL (skips prompt when present) */
+  organizationPolicyLink?: string;
+}
+
 /**
  * Hub configuration structure
  */
@@ -41,6 +59,9 @@ export interface HubConfig {
 
   /** Optional registry configuration */
   configuration?: RegistryConfiguration;
+
+  /** Optional scaffold defaults for pre-filling project scaffolding prompts */
+  scaffoldDefaults?: ScaffoldDefaults;
 }
 
 /**

src/utils/scaffoldUtils.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve a runner pattern by replacing {githubOrg} with the actual org value.
+ * Only the {githubOrg} placeholder is supported.
+ */
+export function resolveRunnerPattern(pattern: string, githubOrg: string): string {
+    return pattern.replace(/\{githubOrg\}/g, githubOrg);
+}