@ryuenn3123/agentic-senior-core 3.0.36 → 3.0.38

package/AGENTS.md

@@ -2,45 +2,42 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 06e3f81d1df0e86bad6c3fe2a4623da640a1ea88b3124aecf1c10214cdc178e6
+Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
 
-This file is an adapter entrypoint for agent discovery.
-The canonical policy source is [.instructions.md](.instructions.md).
-
-If your host stops at this file instead of following the full chain, obey the Critical Bootstrap Floor below before coding.
+This repository is governed by a strict instruction contract.
+Use [.instructions.md](.instructions.md) as the canonical policy source.
+Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
+Treat README.md as overview/install/user context only when governance files conflict.
 
 ## Critical Bootstrap Floor
 
-- If `.agent-instructions.md` exists, prefer it immediately after this file because it is the compiled project-specific snapshot.
-- Memory continuity does not replace bootstrap loading. It is host-dependent project memory, not a guarantee that instructions were reloaded for this session.
-- For UI, UX, layout, screen, tailwind, frontend, or redesign requests: load [.agent-context/prompts/bootstrap-design.md](.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](.agent-context/rules/frontend-architecture.md) before editing code.
+- If your host stops at this file, continue the chain manually before coding.
+- Read `.agent-instructions.md` next when it exists.
+- Memory continuity does not replace bootstrap loading.
+- For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](.agent-context/rules/frontend-architecture.md) before code edits.
 - For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
-- For UI scope: if `docs/DESIGN.md` or `docs/design-intent.json` is missing, materialize or refine them before implementing UI changes.
-- For documentation-first requests: create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
-- For backend, API, data, auth, error, event, queue, worker, or distributed-system requests: load the relevant global rules from [.agent-context/rules/](.agent-context/rules); do not create stack-specific governance adapters.
-- For refactor, improve, clean up, or fix requests: inspect the active rules and propose a plan before editing.
-- For new project or module requests: clarify constraints, runtime decisions, and required docs before generating code.
-- For ecosystem, framework, dependency, or Docker claims: perform live web research instead of relying on stale local heuristics.
+- For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
+- For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
+- For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](.agent-context/rules)).
+- For ecosystem, framework, dependency, or Docker claims, perform live web research.
+- Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
 
 ## Mandatory Bootstrap Chain
 
-1. Load [.instructions.md](.instructions.md) first as the canonical baseline.
-2. If `.agent-instructions.md` exists, read it next as the compiled project-specific snapshot.
-3. Read baseline governance from [.agent-context/rules/](.agent-context/rules).
-4. Apply request templates from [.agent-context/prompts/](.agent-context/prompts).
-5. Enforce review contracts from [.agent-context/review-checklists/](.agent-context/review-checklists).
-6. Read change-risk maps and continuity state from [.agent-context/state/](.agent-context/state).
-7. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
-8. Use runtime evidence, structure, and live research signals from project context docs.
+1. Load [.instructions.md](.instructions.md).
+2. Load `.agent-instructions.md` when present.
+3. Load only relevant files from .agent-context/rules/ ([link](.agent-context/rules)).
+4. Apply matching prompts from .agent-context/prompts/ ([link](.agent-context/prompts)).
+5. Enforce .agent-context/review-checklists/ ([link](.agent-context/review-checklists/pr-checklist.md)).
+6. Use .agent-context/state/ ([link](.agent-context/state)) and .agent-context/policies/ ([link](.agent-context/policies)) only when relevant.
+7. Use project docs and live evidence for runtime, dependency, and architecture claims.
 
 ## Bootstrap Receipt
 
 For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
 
-## Trigger Rules
+## Completion Gate
 
-- New project or module requests: propose scope, constraints, and required docs first, then wait for approval.
-- Refactor or fix requests: propose plan first, then execute safely.
-- Completion: run [.agent-context/review-checklists/pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring done.
+Run [pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
 
 If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.

package/CLAUDE.md

@@ -0,0 +1,43 @@
+# CLAUDE.md - Thin Adapter
+
+Adapter Mode: thin
+Adapter Source: .instructions.md
+Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
+
+This repository is governed by a strict instruction contract.
+Use [.instructions.md](.instructions.md) as the canonical policy source.
+Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
+Treat README.md as overview/install/user context only when governance files conflict.
+
+## Critical Bootstrap Floor
+
+- If your host stops at this file, continue the chain manually before coding.
+- Read `.agent-instructions.md` next when it exists.
+- Memory continuity does not replace bootstrap loading.
+- For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](.agent-context/rules/frontend-architecture.md) before code edits.
+- For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
+- For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
+- For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
+- For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](.agent-context/rules)).
+- For ecosystem, framework, dependency, or Docker claims, perform live web research.
+- Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
+
+## Mandatory Bootstrap Chain
+
+1. Load [.instructions.md](.instructions.md).
+2. Load `.agent-instructions.md` when present.
+3. Load only relevant files from .agent-context/rules/ ([link](.agent-context/rules)).
+4. Apply matching prompts from .agent-context/prompts/ ([link](.agent-context/prompts)).
+5. Enforce .agent-context/review-checklists/ ([link](.agent-context/review-checklists/pr-checklist.md)).
+6. Use .agent-context/state/ ([link](.agent-context/state)) and .agent-context/policies/ ([link](.agent-context/policies)) only when relevant.
+7. Use project docs and live evidence for runtime, dependency, and architecture claims.
+
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
+
+## Completion Gate
+
+Run [pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
+
+If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.

package/CONTRIBUTING.md

@@ -63,7 +63,7 @@ If all three are "yes", it belongs here.
    - Core principle (1-2 sentences)
    - BANNED / REQUIRED sections with enforceable boundaries
    - Decision tree or quick ruleset when it reduces ambiguity
-3. Update `AGENTS.md` rules manifest table
+3. Update `.instructions.md` or `.agent-context/` as the source, then regenerate thin adapters with `npm run sync:adapters`
 4. Update `review-checklists/pr-checklist.md` when the rule is part of review scope
 5. Validate and PR
 
@@ -89,7 +89,7 @@ If all three are "yes", it belongs here.
 - Rules without concrete enforcement boundaries
 - Stack profiles for languages the author doesn't actually use in production
 - Blueprints that are just folder structures without code patterns
-- PRs that don't update the relevant manifest files (AGENTS.md, checklists)
+- PRs that don't update the relevant source files, generated adapters, and checklists
 
 ---
 
@@ -103,6 +103,9 @@ cd Agentic-Senior-Core
 # Validate
 npm run validate
 
+# Clean ignored local reports/backups when the workspace gets noisy
+npm run clean:local
+
 # Test interactive CLI
 node ./bin/agentic-senior-core.js init /tmp/test-project
 ```

package/GEMINI.md

@@ -0,0 +1,43 @@
+# GEMINI.md - Thin Adapter
+
+Adapter Mode: thin
+Adapter Source: .instructions.md
+Canonical Snapshot SHA256: 75652106d1fc453e9407eb9301e7f38de2e0159190dc47fb0b6e377859d91a46
+
+This repository is governed by a strict instruction contract.
+Use [.instructions.md](.instructions.md) as the canonical policy source.
+Use .agent-context/ for technical rules, prompts, checklists, policies, and state.
+Treat README.md as overview/install/user context only when governance files conflict.
+
+## Critical Bootstrap Floor
+
+- If your host stops at this file, continue the chain manually before coding.
+- Read `.agent-instructions.md` next when it exists.
+- Memory continuity does not replace bootstrap loading.
+- For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](.agent-context/prompts/bootstrap-design.md) and [frontend-architecture.md](.agent-context/rules/frontend-architecture.md) before code edits.
+- For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.
+- For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.
+- For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.
+- For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](.agent-context/rules)).
+- For ecosystem, framework, dependency, or Docker claims, perform live web research.
+- Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.
+
+## Mandatory Bootstrap Chain
+
+1. Load [.instructions.md](.instructions.md).
+2. Load `.agent-instructions.md` when present.
+3. Load only relevant files from .agent-context/rules/ ([link](.agent-context/rules)).
+4. Apply matching prompts from .agent-context/prompts/ ([link](.agent-context/prompts)).
+5. Enforce .agent-context/review-checklists/ ([link](.agent-context/review-checklists/pr-checklist.md)).
+6. Use .agent-context/state/ ([link](.agent-context/state)) and .agent-context/policies/ ([link](.agent-context/policies)) only when relevant.
+7. Use project docs and live evidence for runtime, dependency, and architecture claims.
+
+## Bootstrap Receipt
+
+For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.
+
+## Completion Gate
+
+Run [pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring work complete.
+
+If this adapter drifts from canonical behavior, refresh from [.instructions.md](.instructions.md) and update the hash metadata.

package/README.md

@@ -10,12 +10,12 @@
 **Production-grade Rules Engine (Governance Engine) for AI coding agents.**
 Works with Cursor, Windsurf, GitHub Copilot, Claude Code, Gemini, and other LLM-powered IDE workflows.
 
-Latest release: 3.0.30 (2026-04-25).
+Latest release: 3.0.38 (2026-04-30).
 
-Highlights in 3.0.30:
-- Root `mcp.json` now reflects the current 9-layer governance model instead of the old 8-layer metadata.
-- MCP knowledge metadata now includes 15 rules, 4 prompts including `bootstrap-design`, and the project-context layer.
-- MCP workflow wording now reinforces scope-first relevant-layer injection instead of eager load-all context.
+Highlights in 3.0.38:
+- Phase 11 cleanup removes stale skill-marketplace artifacts and generated report snapshots from the shipped package.
+- Large init, utility, design-contract, and design/detection smoke surfaces are split into smaller modules.
+- UI governance keeps anti-generic drift checks while preserving product-derived, non-prescriptive palette decisions.
 
 </div>
 
@@ -29,7 +29,7 @@ Highlights in 3.0.30:
 npx @ryuenn3123/agentic-senior-core init
 ```
 
-One command to initialize rules, checklists, and strict AI coding guidelines context for your project.
+One command to initialize rules, checklists, thin discovery adapters, and a compiled AI rulebook for your project.
 
 > **See [docs/deep-dive.md](docs/deep-dive.md) and [docs/roadmap.md](docs/roadmap.md) for advanced configuration, planning mode, snapshot, and realtime options.**
 
@@ -73,10 +73,11 @@ If you see `Property $schema is not allowed`, keep `.vscode/mcp.json` without `$
 
 | Command | Purpose |
 |---------|---------|
-| `agentic-senior-core init` | Initialize the project guidance pack and compiled AI rulebook |
+| `agentic-senior-core init` | Initialize the project guidance pack, thin adapters, and compiled AI rulebook |
 | `agentic-senior-core upgrade --dry-run` | Preview safe upgrades |
 | `agentic-senior-core optimize --show` | Show token optimization state |
 | `npm run audit:v3-purge` | Run deep purge readiness audit (no deletion) |
+| `npm run clean:local` | Remove ignored local reports, backups, benchmarks, and active-memory state |
 | `agentic-senior-core mcp` | Start local MCP stdio runtime |
 
 ---
@@ -93,6 +94,22 @@ Use `--dry-run` first to preview changes safely, then apply with `--yes`.
 Upgrade now performs managed-surface synchronization by default: obsolete governance files under managed paths are pruned so the pack stays aligned with the latest release.
 Use `--no-prune` if you want to keep legacy managed files.
 
+## Instruction Entrypoints
+
+The canonical source is `.instructions.md`.
+
+Generated bridge files stay small:
+- `AGENTS.md`
+- `CLAUDE.md`
+- `GEMINI.md`
+- `.cursor/rules/agentic-senior-core.mdc`
+- `.windsurf/rules/agentic-senior-core.md`
+- `.github/copilot-instructions.md`
+- `.github/instructions/agentic-senior-core.instructions.md`
+- `.gemini/instructions.md`
+
+Legacy root files `.cursorrules`, `.windsurfrules`, and `.clauderc` are thin compatibility adapters. They point to `.agent-instructions.md` when the compiled rulebook exists, with `.instructions.md` as the fallback source.
+
 ---
 
 ## Terminology Mapping (Final)

package/lib/cli/backup.mjs

@@ -2,6 +2,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import crypto from 'node:crypto';
 import { pathExists, ensureDirectory } from './utils.mjs';
+import { entryPointFiles } from './constants.mjs';
 
 const BACKUP_DIR_NAME = '.agentic-backup';
 
@@ -44,7 +45,7 @@ async function getFilesInDirectory(dirPath) {
 
 /**
  * Creates a backup of specific paths in the target directory.
- * Currently backs up: .cursorrules, .windsurfrules, and the entire .agent-context directory.
+ * Currently backs up: managed entrypoint files and the entire .agent-context directory.
  * @param {string} targetDirectoryPath 
  */
 export async function createBackup(targetDirectoryPath) {
@@ -55,9 +56,8 @@ export async function createBackup(targetDirectoryPath) {
   await ensureDirectory(objectsDir);
 
   const pathsToTrack = [
-    path.join(targetDirectoryPath, '.cursorrules'),
-    path.join(targetDirectoryPath, '.windsurfrules'),
-    path.join(targetDirectoryPath, '.agent-context')
+    ...entryPointFiles.map((entryPointFileName) => path.join(targetDirectoryPath, entryPointFileName)),
+    path.join(targetDirectoryPath, '.agent-context'),
   ];
 
   const resolvedFilesToTrack = [];

package/lib/cli/commands/init/project-context.mjs

@@ -0,0 +1,101 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+import { buildDesignIntentSeedFromSignals } from '../../project-scaffolder.mjs';
+
+function normalizeContextLine(rawText) {
+  return String(rawText || '')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+async function readTextIfExists(filePath) {
+  try {
+    return await fs.readFile(filePath, 'utf8');
+  } catch {
+    return '';
+  }
+}
+
+function extractMarkdownContext(rawMarkdown) {
+  return String(rawMarkdown || '')
+    .split(/\r?\n/)
+    .map((line) => normalizeContextLine(line.replace(/^#+\s*/, '')))
+    .filter((line) => line && !line.startsWith('---') && !line.startsWith('```'))
+    .slice(0, 3)
+    .join(' ');
+}
+
+export async function inferExistingProjectDescriptionHint(targetDirectoryPath) {
+  const evidence = [];
+  const packageJsonContent = await readTextIfExists(path.join(targetDirectoryPath, 'package.json'));
+
+  if (packageJsonContent) {
+    try {
+      const packageManifest = JSON.parse(packageJsonContent);
+      const packageSummary = [
+        normalizeContextLine(packageManifest.name),
+        normalizeContextLine(packageManifest.description),
+      ].filter(Boolean).join(': ');
+
+      if (packageSummary) {
+        evidence.push(`package.json: ${packageSummary}`);
+      }
+    } catch {
+      // Invalid package metadata should not block init; other files can still provide context.
+    }
+  }
+
+  for (const relativeDocPath of ['docs/project-brief.md', 'docs/README.md', 'README.md']) {
+    const docContext = extractMarkdownContext(
+      await readTextIfExists(path.join(targetDirectoryPath, relativeDocPath))
+    );
+
+    if (docContext) {
+      evidence.push(`${relativeDocPath}: ${docContext}`);
+    }
+  }
+
+  return evidence.slice(0, 3).join(' | ');
+}
+
+export function buildInitExistingProjectDesignIntentSeed({
+  targetDirectoryPath,
+  packageManifest,
+  selectedStackFileName,
+  selectedBlueprintFileName,
+  uiScopeSignals,
+  projectDescriptionHint,
+}) {
+  const projectName = String(packageManifest?.name || path.basename(targetDirectoryPath)).trim() || 'existing-ui-project';
+  const isMobileUiProject = String(selectedStackFileName || '').toLowerCase().includes('react-native')
+    || String(selectedStackFileName || '').toLowerCase().includes('flutter')
+    || uiScopeSignals.signalReasons.some((signalReason) => signalReason.includes('android') || signalReason.includes('ios'));
+  const resolvedDomain = isMobileUiProject ? 'Mobile app' : 'Web application';
+  const projectDescription = String(packageManifest?.description || projectDescriptionHint || '').trim()
+    || `Existing ${resolvedDomain.toLowerCase()} detected during init. Create a project-specific dynamic design contract before shipping new UI work.`;
+
+  return buildDesignIntentSeedFromSignals({
+    projectName,
+    projectDescription,
+    primaryDomain: resolvedDomain,
+    features: [],
+    initContext: {
+      stackFileName: selectedStackFileName,
+      blueprintFileName: selectedBlueprintFileName,
+    },
+    status: 'seed-generated-during-init',
+    supplementalFields: {
+      initSignals: {
+        detectedFrom: uiScopeSignals.signalReasons,
+        generatedBy: 'init-existing-project-seed',
+      },
+      repoEvidence: {
+        uiSignalReasons: uiScopeSignals.signalReasons,
+        frontendMetrics: uiScopeSignals.frontendEvidenceMetrics || null,
+        designEvidenceSummary: uiScopeSignals.designEvidenceSummary || null,
+        workspaceUiEntries: uiScopeSignals.workspaceUiEntries || [],
+      },
+    },
+  });
+}

package/lib/cli/commands/init/runtime-environment.mjs

@@ -0,0 +1,59 @@
+import { RUNTIME_ENVIRONMENT_CHOICES } from '../../constants.mjs';
+
+export function resolveRuntimeEnvironmentKeyFromLabel(selectedRuntimeEnvironmentLabel) {
+  const runtimeEnvironmentEntry = RUNTIME_ENVIRONMENT_CHOICES.find(
+    (runtimeEnvironmentChoice) => runtimeEnvironmentChoice.label === selectedRuntimeEnvironmentLabel
+  );
+
+  return runtimeEnvironmentEntry?.key || null;
+}
+
+export function resolveRuntimeEnvironmentLabelFromKey(runtimeEnvironmentKey) {
+  const runtimeEnvironmentEntry = RUNTIME_ENVIRONMENT_CHOICES.find(
+    (runtimeEnvironmentChoice) => runtimeEnvironmentChoice.key === runtimeEnvironmentKey
+  );
+
+  return runtimeEnvironmentEntry?.label || runtimeEnvironmentKey;
+}
+
+export function detectRuntimeEnvironment() {
+  const isWslEnvironment = Boolean(process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP || process.env.__IS_WSL_TEST__);
+
+  if (isWslEnvironment) {
+    return {
+      key: 'linux-wsl',
+      label: resolveRuntimeEnvironmentLabelFromKey('linux-wsl'),
+      shellFamily: 'bash',
+      isAutoDetected: true,
+      source: 'WSL environment markers',
+    };
+  }
+
+  if (process.platform === 'win32') {
+    return {
+      key: 'windows',
+      label: resolveRuntimeEnvironmentLabelFromKey('windows'),
+      shellFamily: 'powershell',
+      isAutoDetected: true,
+      source: 'process.platform',
+    };
+  }
+
+  if (process.platform === 'darwin') {
+    return {
+      key: 'macos',
+      label: resolveRuntimeEnvironmentLabelFromKey('macos'),
+      shellFamily: 'bash',
+      isAutoDetected: true,
+      source: 'process.platform',
+    };
+  }
+
+  return {
+    key: 'linux',
+    label: resolveRuntimeEnvironmentLabelFromKey('linux'),
+    shellFamily: 'bash',
+    isAutoDetected: true,
+    source: 'process.platform',
+  };
+}

package/lib/cli/commands/init/setup-decisions.mjs

@@ -0,0 +1,83 @@
+import { PROJECT_SCOPE_CHOICES } from '../../constants.mjs';
+import { matchFileNameFromInput, normalizeChoiceInput } from '../../utils.mjs';
+
+export function resolveProjectScopeLabelFromKey(projectScopeKey) {
+  return PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.key === projectScopeKey)?.label
+    || PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.key === 'both')?.label
+    || 'Both (frontend + backend)';
+}
+
+export function inferProjectScopeFromDiscoveryAnswers(discoveryAnswers) {
+  const normalizedDomain = String(discoveryAnswers?.primaryDomain || '').trim().toLowerCase();
+  const normalizedDescription = [
+    discoveryAnswers?.projectDescription,
+    ...(Array.isArray(discoveryAnswers?.features) ? discoveryAnswers.features : []),
+  ].join(' ').toLowerCase();
+
+  if (
+    normalizedDomain.includes('api service')
+    || normalizedDomain.includes('cli tool')
+    || normalizedDomain.includes('library')
+  ) {
+    return 'backend-only';
+  }
+
+  if (normalizedDomain.includes('mobile app')) {
+    return 'frontend-only';
+  }
+
+  if (normalizedDomain.includes('web application')) {
+    if (/(landing page|marketing site|showcase|portfolio|brochure|company profile)/.test(normalizedDescription)) {
+      return 'frontend-only';
+    }
+
+    return 'both';
+  }
+
+  return 'both';
+}
+
+export function resolveSilentCiGuardrailsDefault({
+  initOptions,
+  selectedPreset,
+  selectedPolicyProfile,
+}) {
+  if (typeof initOptions.ci === 'boolean') {
+    return {
+      value: initOptions.ci,
+      shouldAsk: false,
+    };
+  }
+
+  if (typeof selectedPreset?.ci === 'boolean') {
+    return {
+      value: selectedPreset.ci,
+      shouldAsk: false,
+    };
+  }
+
+  if (selectedPolicyProfile.lockCi) {
+    return {
+      value: selectedPolicyProfile.defaultCi,
+      shouldAsk: false,
+    };
+  }
+
+  return {
+    value: selectedPolicyProfile.defaultCi,
+    shouldAsk: true,
+  };
+}
+
+export function normalizeExplicitProfileFileName(rawInput, discoveredFileNames) {
+  const matchedFileName = Array.isArray(discoveredFileNames) && discoveredFileNames.length > 0
+    ? matchFileNameFromInput(rawInput, discoveredFileNames)
+    : null;
+
+  if (matchedFileName) {
+    return matchedFileName;
+  }
+
+  const normalizedBaseName = normalizeChoiceInput(String(rawInput || '').replace(/\.md$/i, ''));
+  return normalizedBaseName ? `${normalizedBaseName}.md` : null;
+}