@ryuenn3123/agentic-senior-core 4.3.4 → 4.3.5

package/AGENTS.md

@@ -137,8 +137,8 @@ Load `pr-checklist.md` and `architecture-review.md`, then report defects, risks,
 Trigger: ui, ux, layout, screen, tailwind, frontend, redesign.
 
 1. Read `bootstrap-design.md` and `frontend-architecture.md`. Read UI-relevant repo evidence from state, current UI code, and `docs/*`.
-2. Follow the three-step direction process in `bootstrap-design.md`: name defaults, choose anchor, commit to creative direction. If `docs/design-intent.json` has an anti-repeat ledger, load previous directions as blocklist.
-3. Generate or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation. Keep context isolated; do not eagerly load unrelated backend-only rules.
+2. Follow the three-step direction process in `bootstrap-design.md`: name defaults, choose anchor, commit to creative direction. If `docs/DESIGN.md` has an anti-repeat ledger, load previous directions as blocklist.
+3. Generate or refine `docs/DESIGN.md` before UI implementation. Keep context isolated; do not eagerly load unrelated backend-only rules.
 4. External websites are evidence for constraints and mechanics only. Do not copy layout rhythm, palette, component skin, or brand posture without explicit user approval.
 
 ## Bounded Reflection
@@ -156,7 +156,7 @@ Use valid rule IDs only; do not quote full rule prose, expose hidden chain-of-th
 Never claim done without:
 1. Relevant rules applied.
 2. PR and architecture checklists considered.
-3. Universal SOP gates satisfied: public and developer root `README.md`; `docs/doc-index.md` when `docs/` exists; `docs/project-brief.md`; `docs/architecture-decision-record.md`; `docs/flow-overview.md`; `docs/database-schema.md` when persistent data exists; `docs/api-contract.md` when API or web application flows exist; plus `docs/DESIGN.md` and `docs/design-intent.json` for UI scope.
+3. Universal SOP gates satisfied: public and developer root `README.md`; `docs/doc-index.md` when `docs/` exists; `docs/project-brief.md`; `docs/architecture-decision-record.md`; `docs/flow-overview.md`; `docs/database-schema.md` when persistent data exists; `docs/api-contract.md` when API or web application flows exist; plus `docs/DESIGN.md` for UI scope.
 4. If `.agent-context/state/active-memory.json` exists and material project progress happened, refresh it while preserving privacy rules and user-owned entries.
 5. Project validation passed through `npm run validate`.
 

package/lib/cli/commands/audit-design-anti-repeat.mjs

@@ -3,196 +3,37 @@
 /**
  * `agentic-senior-core audit:design-anti-repeat`
  *
- * User-facing CLI subcommand that runs the typography/palette anti-repeat
- * audit against a user project's working directory. The default scan root is
- * `process.cwd()` so `npx @ryuenn3123/agentic-senior-core audit:design-anti-repeat`
- * inside a user project scans that project (not the package install).
- *
- * Skip behavior is friendly: missing design-intent.json or missing ledger
- * print actionable next steps and exit 0. Typography violations and palette
- * findings (when palette is blocking, which is the default) exit 1.
+ * [DEPRECATED in 2026 Context Ops Paradigm]
+ * This script is retired because the anti-repeat ledger is now maintained
+ * as plain-text inside docs/DESIGN.md. The Adaptive Context AI agent enforces
+ * this naturally without needing regex-based JSON compliance theater.
  */
 
-import { resolve } from 'node:path';
-
-import { runTypographyPaletteAntiRepeatAudit } from '../audits/typography-palette-anti-repeat-audit.mjs';
-
-const HELP_TEXT_LINES = [
-  'agentic-senior-core audit:design-anti-repeat',
-  '',
-  'Scan CSS, SCSS, SASS, LESS, and Tailwind/theme/design-token config files in',
-  'the current project for typography or palette values that match the',
-  'anti-repeat ledger in docs/design-intent.json. Catches redesigns that leak',
-  "the previous direction's font trio or palette through CSS implementation",
-  'even when the JSON design contract claims a fresh anchor.',
-  '',
-  'Usage:',
-  '  agentic-senior-core audit:design-anti-repeat',
-  '  agentic-senior-core audit:design-anti-repeat [target-directory]',
-  '  agentic-senior-core audit:design-anti-repeat --json',
-  '  agentic-senior-core audit:design-anti-repeat --palette-advisory',
-  '  agentic-senior-core audit:design-anti-repeat --threshold 0.05',
-  '',
-  'Defaults:',
-  '  Target directory:    current working directory',
-  '  Typography matches:  blocking (BOUNDARY_TYPOGRAPHY_LEDGER_VIOLATION)',
-  '  Palette matches:     blocking (BOUNDARY_PALETTE_LEDGER_VIOLATION)',
-  '  OKLCH distance:      0.04 in L*C*H space',
-  '',
-  'Options:',
-  '  --json               Print the full report as JSON only (no human summary).',
-  '  --palette-advisory   Opt out of blocking palette severity. Findings still',
-  '                       print but do not fail the run. Typography stays blocking.',
-  '  --threshold <num>    Override the OKLCH perceptual distance threshold.',
-  '                       Higher values are more permissive.',
-  '  --help               Show this help.',
-  '',
-  'Skip behavior (exit 0):',
-  '  - docs/design-intent.json absent. Run `npx @ryuenn3123/agentic-senior-core init`',
-  '    in a fresh project, or `... upgrade` in an existing project to seed the',
-  '    design contract.',
-  '  - docs/design-intent.json present but researchDossier metadata absent.',
-  "    Run `... upgrade` to migrate the contract, then run `.agent-context/prompts/research-design.md`",
-  '    so the dossier and anti-repeat ledger get populated before the next UI work.',
-  '',
-  'Exit codes:',
-  '  0 = no blocking violations (or audit skipped with a friendly note).',
-  '  1 = at least one BOUNDARY_TYPOGRAPHY_LEDGER_VIOLATION or, in default mode,',
-  '      BOUNDARY_PALETTE_LEDGER_VIOLATION.',
-];
-
-function buildHelpText() {
-  return HELP_TEXT_LINES.join('\n');
-}
-
-function readNumericFlag(commandLineArgs, flagName) {
-  const flagIndex = commandLineArgs.indexOf(flagName);
-  if (flagIndex === -1) {
-    return null;
-  }
-  const flagValue = commandLineArgs[flagIndex + 1];
-  if (typeof flagValue !== 'string' || flagValue.length === 0) {
-    return null;
-  }
-  const numericValue = Number(flagValue);
-  return Number.isFinite(numericValue) ? numericValue : null;
-}
-
-const VALUE_FLAGS = new Set(['--threshold']);
-
-function extractTargetDirectoryArgument(commandLineArgs) {
-  for (let argumentIndex = 0; argumentIndex < commandLineArgs.length; argumentIndex += 1) {
-    const candidateArgument = commandLineArgs[argumentIndex];
-    if (VALUE_FLAGS.has(candidateArgument)) {
-      argumentIndex += 1;
-      continue;
-    }
-    if (!candidateArgument.startsWith('--')) {
-      return candidateArgument;
-    }
-  }
-  return null;
-}
-
-function buildSkipMessage(reason) {
-  if (reason === 'design-intent-file-absent') {
-    return [
-      'Audit skipped: docs/design-intent.json is missing.',
-      'Next step:',
-      '  - Fresh project: run `npx @ryuenn3123/agentic-senior-core init` to seed the design contract.',
-      '  - Existing project: run `npx @ryuenn3123/agentic-senior-core upgrade` to seed it without touching app code.',
-      'Then re-run this audit.',
-    ];
-  }
-  if (reason === 'anti-repeat-ledger-absent') {
-    return [
-      'Audit skipped: docs/design-intent.json is present but researchDossier metadata is absent.',
-      'Next step:',
-      '  - Run `npx @ryuenn3123/agentic-senior-core upgrade` to migrate the contract; the upgrade injects',
-      '    `researchDossier.metadata` and seeds the anti-repeat ledger from existing anchor, palette,',
-      '    motion, and typography fields without overwriting them.',
-      "  - Then run the design-research dossier prompt at `.agent-context/prompts/research-design.md`",
-      '    so the ledger and `researchVerifiedAt` get populated before the next UI work.',
-      'After that, re-run this audit to enforce the ledger against your CSS.',
-    ];
-  }
-  if (typeof reason === 'string' && reason.startsWith('design-intent-file-not-valid-json')) {
-    return [
-      'Audit skipped: docs/design-intent.json is present but cannot be parsed as JSON.',
-      `  ${reason}`,
-      'Next step: fix the JSON syntax, then re-run this audit.',
-    ];
+export async function runDesignAntiRepeatAuditCommand(commandLineArgs = []) {
+  if (commandLineArgs.includes('--json')) {
+    process.stdout.write(JSON.stringify({
+      passed: true,
+      skipped: true,
+      reason: 'audit-design-anti-repeat is deprecated in Context Ops 2026. Plain text ledgers in DESIGN.md are handled by the agent contextually.',
+      targetDirectoryPath: process.cwd(),
+      filesScanned: 0,
+      typographyViolationCount: 0,
+      paletteFindingCount: 0,
+      paletteSeverity: 'advisory',
+      oklchDistanceThreshold: 0.04,
+      typographyViolations: [],
+      paletteFindings: []
+    }, null, 2) + '\n');
+    return 0;
   }
-  return [`Audit skipped: ${reason || 'unknown reason'}`];
-}
 
-function printHumanReport(auditReport) {
   console.log('===============================================');
-  console.log('  audit:design-anti-repeat');
+  console.log('  audit:design-anti-repeat (DEPRECATED)');
   console.log('===============================================');
-  console.log(`  Target directory:            ${auditReport.targetDirectoryPath}`);
-  console.log(`  Files scanned:               ${auditReport.filesScanned}`);
-  console.log(`  Typography violations:       ${auditReport.typographyViolationCount} (blocking)`);
-  console.log(`  Palette findings:            ${auditReport.paletteFindingCount} (${auditReport.paletteSeverity})`);
-  console.log(`  OKLCH distance threshold:    ${auditReport.oklchDistanceThreshold}`);
+  console.log('  Audit skipped: audit-design-anti-repeat is retired in Context Ops 2026.');
+  console.log('  Plain text ledgers in docs/DESIGN.md are handled by the agent contextually.');
+  console.log('  You can safely remove this check from your CI pipeline.');
   console.log('');
-
-  if (auditReport.skipped) {
-    for (const skipLine of buildSkipMessage(auditReport.reason)) {
-      console.log(`  ${skipLine}`);
-    }
-    return;
-  }
-
-  if (auditReport.typographyViolations.length > 0) {
-    console.log('  Typography violations (blocking):');
-    for (const violation of auditReport.typographyViolations) {
-      console.log(`    [${violation.kind}] ${violation.file}:${violation.line} ${violation.detail}`);
-    }
-    console.log('');
-  }
-
-  if (auditReport.paletteFindings.length > 0) {
-    console.log(`  Palette findings (${auditReport.paletteSeverity}):`);
-    for (const finding of auditReport.paletteFindings) {
-      console.log(`    [${finding.kind}] ${finding.file}:${finding.line} ${finding.detail}`);
-    }
-    console.log('');
-  }
-
-  if (auditReport.passed) {
-    console.log('  No blocking violations against the anti-repeat ledger.');
-    return;
-  }
-
-  const blockingPaletteCount = auditReport.paletteSeverity === 'blocking' ? auditReport.paletteFindingCount : 0;
-  console.log(`  ${auditReport.typographyViolationCount} typography violation(s) and ${blockingPaletteCount} palette violation(s) found; release blocked.`);
-}
-
-export async function runDesignAntiRepeatAuditCommand(commandLineArgs = []) {
-  if (commandLineArgs.includes('--help') || commandLineArgs.includes('-h')) {
-    console.log(buildHelpText());
-    return 0;
-  }
-
-  const shouldOutputJsonOnly = commandLineArgs.includes('--json');
-  const shouldTreatPaletteAsAdvisory = commandLineArgs.includes('--palette-advisory');
-  const oklchDistanceThreshold = readNumericFlag(commandLineArgs, '--threshold');
-  const targetDirectoryArgument = extractTargetDirectoryArgument(commandLineArgs);
-  const targetDirectoryPath = resolve(targetDirectoryArgument || process.cwd());
-
-  const auditReport = runTypographyPaletteAntiRepeatAudit({
-    repositoryRootPath: targetDirectoryPath,
-    treatPaletteAsAdvisory: shouldTreatPaletteAsAdvisory,
-    ...(typeof oklchDistanceThreshold === 'number' ? { oklchDistanceThreshold } : {}),
-  });
-  const auditReportWithRoot = { ...auditReport, targetDirectoryPath };
-
-  if (shouldOutputJsonOnly) {
-    process.stdout.write(`${JSON.stringify(auditReportWithRoot, null, 2)}\n`);
-    return auditReportWithRoot.passed ? 0 : 1;
-  }
-
-  printHumanReport(auditReportWithRoot);
-  return auditReportWithRoot.passed ? 0 : 1;
+  
+  return 0;
 }

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

@@ -1,7 +1,6 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
-import { buildDesignIntentSeedFromSignals } from '../../project-scaffolder.mjs';
 
 function normalizeContextLine(rawText) {
   return String(rawText || '')
@@ -59,43 +58,3 @@ export async function inferExistingProjectDescriptionHint(targetDirectoryPath) {
   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.mjs

@@ -59,7 +59,6 @@ import {
   loadProjectConfig,
   normalizeDocsLanguage,
 } from '../project-scaffolder.mjs';
-import { migrateExistingDesignIntentToResearchDossierSchema } from '../project-scaffolder/design-contract/research-dossier-migration.mjs';
 import { performRollback } from '../rollback.mjs';
 import {
   createTokenOptimizationState,
@@ -72,10 +71,7 @@ import {
   ensureActiveMemorySnapshot,
   writeMemoryContinuityState,
 } from '../memory-continuity.mjs';
-import {
-  buildInitExistingProjectDesignIntentSeed,
-  inferExistingProjectDescriptionHint,
-} from './init/project-context.mjs';
+
 import {
   detectRuntimeEnvironment,
   resolveRuntimeEnvironmentKeyFromLabel,
@@ -87,6 +83,7 @@ import {
   resolveProjectScopeLabelFromKey,
   resolveSilentCiGuardrailsDefault,
 } from './init/setup-decisions.mjs';
+import { inferExistingProjectDescriptionHint } from './init/project-context.mjs';
 
 export { REPOSITORY_ROOT } from '../constants.mjs';
 export {
@@ -493,36 +490,14 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         selectedBlueprintFileName: selectedResolvedBlueprintFileName,
       })
       : null;
-    const designIntentTargetPath = path.join(resolvedTargetDirectoryPath, 'docs', 'design-intent.json');
-    const shouldSeedExistingUiDesignIntent = projectDetection.hasExistingProjectFiles
-      && existingProjectUiScopeSignals?.isUiScopeLikely === true
-      && !(await pathExists(designIntentTargetPath));
-
-    if (shouldSeedExistingUiDesignIntent) {
-      const docsDirectoryPath = path.join(resolvedTargetDirectoryPath, 'docs');
-      const designIntentSeedContent = buildInitExistingProjectDesignIntentSeed({
-        targetDirectoryPath: resolvedTargetDirectoryPath,
-        packageManifest: existingProjectUiScopeSignals.packageManifest,
-        selectedStackFileName: selectedResolvedStackFileName,
-        selectedBlueprintFileName: selectedResolvedBlueprintFileName,
-        uiScopeSignals: existingProjectUiScopeSignals,
-        projectDescriptionHint,
-      });
-
-      await ensureDirectory(docsDirectoryPath);
-      await fs.writeFile(designIntentTargetPath, designIntentSeedContent, 'utf8');
-      supplementalMaterializedDocFileNames.push('design-intent.json');
-
-      console.log('\nExisting UI/frontend scope detected. Seeded docs/design-intent.json so the machine-readable design contract exists before UI implementation work continues.');
-    } else if (projectDetection.hasExistingProjectFiles && (await pathExists(designIntentTargetPath))) {
-      // Scenario E: existing project being initialized for the first time
-      // already has docs/design-intent.json. Migrate it to carry researchDossier.metadata
-      // so the anti-repeat ledger and freshness gate become available without
-      // touching existing tokens, anchor, or palette.
-      const migrationResult = await migrateExistingDesignIntentToResearchDossierSchema(designIntentTargetPath);
-      if (migrationResult.migrated) {
-        supplementalMaterializedDocFileNames.push('design-intent.json (research-dossier metadata migrated)');
-        console.log('\n[MIGRATED] docs/design-intent.json now carries researchDossier.metadata. Run research-design.md before next UI implementation to populate the dossier and refresh researchVerifiedAt.');
+    const obsoleteDesignIntentPath = path.join(resolvedTargetDirectoryPath, 'docs', 'design-intent.json');
+    if (await pathExists(obsoleteDesignIntentPath)) {
+      try {
+        await fs.unlink(obsoleteDesignIntentPath);
+        supplementalMaterializedDocFileNames.push('design-intent.json (DELETED - Obsolete Compliance Theater)');
+        console.log('\n[CLEANUP] Removed obsolete docs/design-intent.json. The 2026 Context Ops Paradigm uses plain-text DESIGN.md only.');
+      } catch (err) {
+        // ignore error
       }
     }
 
@@ -644,7 +619,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log('\nPrompt starter examples (copy and adapt in your IDE):');
       console.log('- If docs/project-brief.md is missing, execute .agent-context/prompts/bootstrap-project-context.md now and create all required docs files.');
       if ((scaffoldingResult.generatedPromptFileNames || []).includes('bootstrap-design.md')) {
-        console.log('- If docs/DESIGN.md or docs/design-intent.json is missing, execute .agent-context/prompts/bootstrap-design.md now before building UI components.');
+        console.log('- If docs/DESIGN.md is missing, execute .agent-context/prompts/bootstrap-design.md now before building UI components.');
       }
       console.log(`- Build an MVP for ${promptProjectName} using the newly synthesized docs as strict project context.`);
       console.log('- When scope changes, update docs/* in the same change so future prompts stay aligned.');
@@ -656,12 +631,8 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log(`- Build an MVP for ${promptProjectName}. Follow Layer 9 docs and keep the current stack, database, and auth constraints.`);
       console.log('- Add [new feature] and update docs/project-brief.md plus docs/flow-overview.md in the same change.');
       console.log('- If this change needs architecture migration, propose a migration plan first, then implement after approval.');
-    } else if (supplementalMaterializedDocFileNames.includes('design-intent.json')) {
-      console.log('I also seeded docs/design-intent.json for this existing UI repository so future UI work starts from a machine-readable design contract without forcing a canned visual concept.');
-      console.log('\nPrompt starter examples (copy and adapt in your IDE):');
-      console.log('- If docs/DESIGN.md is missing, execute .agent-context/prompts/bootstrap-design.md now and refine docs/design-intent.json into a complete design contract before building UI components.');
-      console.log('- Keep docs/design-intent.json and docs/DESIGN.md synchronized whenever the UI direction changes.');
     }
+
     console.log('Your AI tools will now receive AGENTS.md, native import bridges, and the lazy-loaded .agent-context rule library. Your review threshold is stored in .agent-context/policies/llm-judge-threshold.json.');
     console.log('MCP server registration is manual inside your IDE settings, even when mcp.json exists.');
   } catch (error) {

package/lib/cli/commands/upgrade.mjs

@@ -46,10 +46,8 @@ import {
 } from '../backup.mjs';
 import { performRollback } from '../rollback.mjs';
 import { detectProjectDocTemplateStaleness } from '../project-scaffolder.mjs';
-import { migrateExistingDesignIntentToResearchDossierSchema } from '../project-scaffolder/design-contract/research-dossier-migration.mjs';
 import { ensureActiveMemorySnapshot } from '../memory-continuity.mjs';
 import { buildExistingProjectMajorConstraints } from '../init-detection-flow.mjs';
-import { buildUpgradeDesignIntentSeed } from './upgrade/design-intent-seed.mjs';
 import {
   applyUpgradeTokenOptimizationPlan,
   resolveUpgradeTokenOptimizationPlan,
@@ -184,7 +182,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       projectScopeSourceLabel: 'onboarding project scope',
     });
     const packageManifest = uiScopeSignals.packageManifest;
-    const designContractPaths = ['docs/DESIGN.md', 'docs/design-intent.json'];
+    const designContractPaths = ['docs/DESIGN.md'];
     const missingDesignContractPaths = [];
 
     for (const designContractPath of designContractPaths) {
@@ -193,17 +191,6 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         missingDesignContractPaths.push(designContractPath);
       }
     }
-    const shouldSeedDesignIntentOnApply = uiScopeSignals.isUiScopeLikely
-      && missingDesignContractPaths.includes('docs/design-intent.json');
-    const designIntentSeedContent = shouldSeedDesignIntentOnApply
-      ? buildUpgradeDesignIntentSeed({
-        targetDirectoryPath: resolvedTargetDirectoryPath,
-        packageManifest,
-        selectedStackFileName,
-        selectedBlueprintFileName,
-        uiScopeSignals,
-      })
-      : null;
 
     const detectionMajorConstraints = buildExistingProjectMajorConstraints({ mode: 'upgrade' });
     const detectionTransparency = {
@@ -320,11 +307,8 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       if (Array.isArray(uiScopeSignals.workspaceUiEntries) && uiScopeSignals.workspaceUiEntries.length > 0) {
         console.log(`- Nested UI workspaces: ${uiScopeSignals.workspaceUiEntries.map((workspaceUiEntry) => workspaceUiEntry.relativePath).join(', ')}`);
       }
-      if (shouldSeedDesignIntentOnApply) {
-        console.log('- Planned seed on apply: docs/design-intent.json');
-      }
-      console.log('Required action: create or refresh docs/DESIGN.md and docs/design-intent.json before allowing UI implementation work.');
-      console.log('Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.');
+      console.log('Required action: create or refresh docs/DESIGN.md before allowing UI implementation work.');
+      console.log('Upgrade synchronizes governance assets, but it does not author project-specific docs/DESIGN.md automatically.');
     }
 
     if (upgradeOptions.dryRun) {
@@ -369,21 +353,14 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         supplementalCreatedFileNames.push(tokenOptimizationApplyResult.createdFileName);
       }
 
-      if (shouldSeedDesignIntentOnApply && designIntentSeedContent) {
-        const docsDirectoryPath = path.join(resolvedTargetDirectoryPath, 'docs');
-        const designIntentTargetPath = path.join(docsDirectoryPath, 'design-intent.json');
-        await ensureDirectory(docsDirectoryPath);
-        await fs.writeFile(designIntentTargetPath, designIntentSeedContent, 'utf8');
-        supplementalCreatedFileNames.push('docs/design-intent.json');
-      } else {
-        // Scenario D: existing project already has docs/design-intent.json.
-        // Inject researchDossier.metadata when absent so the anti-repeat ledger
-        // becomes available and active validation can enforce freshness.
-        const existingDesignIntentPath = path.join(resolvedTargetDirectoryPath, 'docs', 'design-intent.json');
-        const migrationResult = await migrateExistingDesignIntentToResearchDossierSchema(existingDesignIntentPath);
-        if (migrationResult.migrated) {
-          supplementalCreatedFileNames.push('docs/design-intent.json (research-dossier metadata migrated)');
-          console.log('\n[MIGRATED] docs/design-intent.json now carries researchDossier.metadata. Run research-design.md before next UI implementation to populate the dossier and refresh researchVerifiedAt.');
+      const obsoleteDesignIntentPath = path.join(resolvedTargetDirectoryPath, 'docs', 'design-intent.json');
+      if (await pathExists(obsoleteDesignIntentPath)) {
+        try {
+          await fs.unlink(obsoleteDesignIntentPath);
+          supplementalCreatedFileNames.push('docs/design-intent.json (DELETED - Obsolete Compliance Theater)');
+          console.log('\n[CLEANUP] Removed obsolete docs/design-intent.json. The 2026 Context Ops Paradigm uses plain-text DESIGN.md only.');
+        } catch (err) {
+          // ignore error
         }
       }
 
@@ -453,7 +430,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       console.log('\nRefreshed files: AGENTS.md, CLAUDE.md, GEMINI.md, .agent-context/, and .agent-context/state/onboarding-report.json');
       console.log('Default activation cues remain Adaptive Context bootstrap, ASCX command wrappers, and Compact Natural final replies.');
       console.log('Default response mode remains Compact Natural Mode through .agent-context/prompts/compact-natural-mode.md.');
-      console.log('\nNext-step suggestion (UI scope): run `npx @ryuenn3123/agentic-senior-core audit:design-anti-repeat` to scan CSS, SCSS, SASS, LESS, Tailwind config, and design-token files in this project for typography or palette values that match the anti-repeat ledger in docs/design-intent.json. Add it to your CI alongside `npm test` once the design dossier is populated.');
+
     } catch (error) {
       console.error('\n[FATAL] An error occurred during upgrade. Attempting automatic rollback...');
       try {

package/lib/cli/compiler.mjs

@@ -32,78 +32,8 @@ function toSingleLine(value, fallbackValue) {
   return normalizedValue || fallbackValue;
 }
 
-async function readDesignIntentIfExists(targetDirectoryPath) {
-  const designIntentPath = path.join(targetDirectoryPath, 'docs', 'design-intent.json');
-  if (!(await pathExists(designIntentPath))) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(await fs.readFile(designIntentPath, 'utf8'));
-  } catch {
-    return {
-      parseError: true,
-    };
-  }
-}
-
 function buildAnchorCommitmentHeader(designIntent) {
-  if (!designIntent || typeof designIntent !== 'object') {
-    return null;
-  }
-
-  if (designIntent.parseError) {
-    return [
-      '## [UI TASK ANCHOR - READ FIRST]',
-      'Source: docs/design-intent.json',
-      'Status: design-intent.json could not be parsed.',
-      'Required action: fix docs/design-intent.json before UI implementation so the creative commitment can be loaded.',
-    ].join('\n');
-  }
-
-  const conceptualAnchor = designIntent.conceptualAnchor || {};
-  const derivedTokenLogic = designIntent.derivedTokenLogic || {};
-  const creativeCommitment = designIntent.designExecutionHandoff?.creativeCommitment || {};
-  const designFlexibilityPolicy = designIntent.designFlexibilityPolicy || {};
-  const expressionFlexibility = designIntent.designExecutionHandoff?.expressionFlexibility || {};
-  const anchorReference = conceptualAnchor.anchorReference || derivedTokenLogic.anchorReference;
-  const conceptualAnchorName = conceptualAnchor.name || anchorReference;
-  const signatureMove = conceptualAnchor.signatureMove
-    || designIntent.designExecutionHandoff?.signatureMoveRationale;
-  const signatureMotion = conceptualAnchor.signatureMotion
-    || creativeCommitment.signatureMotion
-    || derivedTokenLogic.motionDerivationSource;
-  const typographicDecision = conceptualAnchor.typographicDecision
-    || creativeCommitment.typographicDecision
-    || derivedTokenLogic.typographyDerivationSource;
-  const flexibleAxes = Array.isArray(designFlexibilityPolicy.flexibleExpressionAxes)
-    ? designFlexibilityPolicy.flexibleExpressionAxes
-    : expressionFlexibility.flexibleAxes;
-  const lockedOutcomes = Array.isArray(expressionFlexibility.lockedOutcomes)
-    ? expressionFlexibility.lockedOutcomes
-    : designFlexibilityPolicy.lockedOutcomeTypes;
-
-  if (!conceptualAnchorName && !anchorReference) {
-    return [
-      '## [UI TASK ANCHOR - READ FIRST]',
-      'Source: docs/design-intent.json',
-      'Status: Creative commitment is missing.',
-      'Required action: define conceptualAnchor.anchorReference, a concrete real-world anchor, signature motion, typographic decision, derivedTokenLogic, and libraryDecisions before UI implementation.',
-    ].join('\n');
-  }
-
-  return [
-    '## [UI TASK ANCHOR - READ FIRST]',
-    'Source: docs/design-intent.json',
-    `Conceptual Anchor: ${toSingleLine(conceptualAnchorName, 'MISSING - complete Creative Commitment Gate before UI implementation')}`,
-    `Anchor Reference: ${toSingleLine(anchorReference, 'MISSING - required for deterministic token validation')}`,
-    `Signature Move: ${toSingleLine(signatureMove, 'MISSING - define one concrete authored move before UI implementation')}`,
-    `Motion Signature: ${toSingleLine(signatureMotion, 'MISSING - define timing/easing/choreography before UI implementation')}`,
-    `Typographic Decision: ${toSingleLine(typographicDecision, 'MISSING - define role contrast before UI implementation')}`,
-    `Locked Outcomes: ${toSingleLine(Array.isArray(lockedOutcomes) ? lockedOutcomes.join(', ') : '', 'user goals, accessibility, production readiness, forbidden patterns')}`,
-    `Flexible Expression: ${toSingleLine(Array.isArray(flexibleAxes) ? flexibleAxes.join(', ') : '', 'exact primitives, typeface, surface treatment, component skin, candidate moves')}`,
-    'If the UI output does not reflect these lines, stop and revise the design contract before continuing.',
-  ].join('\n');
+  return null;
 }
 
 function buildContainerizationStrategySnapshot(dockerStrategy) {
@@ -400,7 +330,7 @@ export async function buildCompiledRulesContent({
       '3. .agent-context/prompts/review-code.md -> review, audit, check, analyze',
       '4. .agent-context/prompts/bootstrap-design.md -> ui, ux, layout, screen, tailwind, frontend, redesign',
       'Documentation-first policy:',
-      '- Create or refine required project docs before implementation: README.md for every fresh or existing project; docs/doc-index.md whenever docs/ exists; docs/project-brief.md; docs/architecture-decision-record.md; docs/flow-overview.md; docs/api-contract.md when APIs, firmware endpoints, CLI commands, or web application flows exist; docs/database-schema.md when persistent data exists; and docs/DESIGN.md plus docs/design-intent.json for UI scope.',
+      '- Create or refine required project docs before implementation: README.md for every fresh or existing project; docs/doc-index.md whenever docs/ exists; docs/project-brief.md; docs/architecture-decision-record.md; docs/flow-overview.md; docs/api-contract.md when APIs, firmware endpoints, CLI commands, or web application flows exist; docs/database-schema.md when persistent data exists; and docs/DESIGN.md for UI scope.',
       '- Keep README.md public and developer friendly, including for private projects: explain what the project is, who it is for, setup, usage, configuration, and links to deeper docs. Do not put secrets, internal agent notes, private reasoning, or governance policy dumps in it.',
       '- Use docs/doc-index.md as the compact read-routing map before selecting deeper docs. Do not broad-read docs/*.md by default.',
       '- Add PRD, SRS, technical-design, or separate ERD only when project evidence justifies them.',
@@ -566,7 +496,7 @@ export async function buildCompiledRulesContent({
         '- Stop implementation if docs/flow-overview.md is missing.',
         '- If the product uses persistent data, docs/database-schema.md must exist before coding continues.',
         '- If the product exposes API or web application flows, docs/api-contract.md must exist before coding continues.',
-        '- For UI scope, stop implementation if docs/DESIGN.md or docs/design-intent.json is missing.',
+        '- For UI scope, stop implementation if docs/DESIGN.md is missing.',
         '- Keep README.md overview-level, public, and developer friendly; do not put secrets, internal agent notes, private reasoning, or governance policy dumps in it.',
         '- Use README.md plus docs/doc-index.md to choose the smallest relevant read set before loading deeper docs.',
         '- Add PRD, SRS, technical-design, or separate ERD only when project evidence justifies them.',
@@ -611,7 +541,7 @@ export async function buildCompiledRulesContent({
         '- For docs-only/docs-first requests, stop after docs unless the user asks for implementation or approves an implementation plan.',
         '- If docs/project-brief.md is missing, execute bootstrap-project-context prompt immediately.',
         hasBootstrapDesignPrompt
-          ? '- For UI scope: if docs/DESIGN.md or docs/design-intent.json is missing, execute bootstrap-design prompt before implementing UI surfaces.'
+          ? '- For UI scope: if docs/DESIGN.md is missing, execute bootstrap-design prompt before implementing UI surfaces.'
           : '- For UI scope: add a design bootstrap prompt before implementing UI surfaces.',
         '- Bootstrap docs from repo evidence and the latest user request. Do not use generic placeholder templates.',
         '- Separate confirmed facts from assumptions, include an Assumptions to Validate section when context is incomplete, and end with the next validation action.',
@@ -622,11 +552,6 @@ export async function buildCompiledRulesContent({
     );
   }
 
-  const designIntent = await readDesignIntentIfExists(resolvedTargetDirectoryPath);
-  const anchorCommitmentHeader = buildAnchorCommitmentHeader(designIntent);
-  if (anchorCommitmentHeader) {
-    contextBlocks.unshift(anchorCommitmentHeader);
-  }
 
   return [
     '# AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET',

package/lib/cli/preflight.mjs

@@ -71,27 +71,6 @@ export async function runPreflightChecks(targetDirectoryPath, operationMode) {
      result.checks.push(`Skipping disk space check due to standard library limitation: ${error.message}`);
   }
 
-  // Check 4: Conflicting Files
-  if (operationMode === 'init') {
-      const potentiallyConflictingPaths = [
-          ...entryPointFiles.map((entryPointFileName) => path.join(targetDirectoryPath, entryPointFileName)),
-          path.join(targetDirectoryPath, '.agent-context'),
-      ];
-
-      const conflictingFound = [];
-      for (const conflictPath of potentiallyConflictingPaths) {
-          if (await pathExists(conflictPath)) {
-              conflictingFound.push(path.relative(targetDirectoryPath, conflictPath).replace(/\\/g, '/'));
-          }
-      }
-
-      if (conflictingFound.length > 0) {
-           result.passed = false;
-           result.errors.push(`Conflicting governance files already exist during init: ${conflictingFound.join(', ')}. Use upgrade instead.`);
-      } else {
-           result.checks.push('No conflicting governance files found.');
-      }
-  }
 
   return result;
 }

package/lib/cli/project-scaffolder/constants.mjs

@@ -7,7 +7,7 @@ export const PROJECT_DOC_FILE_NAMES = [
   'flow-overview.md',
 ];
 export const DOC_INDEX_FILE_NAME = 'doc-index.md';
-export const UI_DESIGN_CONTRACT_FILE_NAMES = ['DESIGN.md', 'design-intent.json'];
+export const UI_DESIGN_CONTRACT_FILE_NAMES = ['DESIGN.md'];
 
 // Legacy project docs may still carry this version header; keep for upgrade staleness checks.
 export const PROJECT_DOC_TEMPLATE_VERSION = '1.2.0';

package/lib/cli/project-scaffolder/design-contract.mjs

@@ -23,7 +23,6 @@ import {
 import { buildStructureFirstSeedSignals, shouldBootstrapDesignDocument } from './design-contract/seed-signals.mjs';
 import { FORBIDDEN_PATTERN_SIGNALS } from './design-contract/signal-vocab.mjs';
 import { buildConceptualAnchorSection } from './design-contract/sections/conceptual-anchor.mjs';
-import { buildResearchDossierMetadata } from './design-contract/research-dossier-migration.mjs';
 import {
   buildAccessibilityPolicySection,
   buildAiSafeUiAuditSection,
@@ -135,7 +134,7 @@ function buildDesignIntentContractObject({
     },
     designFlexibilityPolicy: {
       mode: 'locked-outcomes-flexible-expression',
-      contractRole: 'Use docs/design-intent.json as review invariants and handoff structure, not as a frozen visual recipe unless the user explicitly locks a decision.',
+      contractRole: 'Use docs/DESIGN.md as review invariants and handoff structure, not as a frozen visual recipe unless the user explicitly locks a decision.',
       lockedOutcomeTypes: [
         'confirmed-user-goals',
         'repo-evidence-and-runtime-constraints',
@@ -161,7 +160,6 @@ function buildDesignIntentContractObject({
     },
     conceptualAnchor: buildConceptualAnchorSection(),
     researchDossier: {
-      metadata: buildResearchDossierMetadata(),
       sourceFreshness: {
         status: 'agent-must-complete-before-ui-implementation',
         freshnessAnchorDate: 'session-current-date',
@@ -241,7 +239,7 @@ function buildDesignIntentContractObject({
       seedValuesRequireCalibration: true,
     },
     tokenSystem: {
-      sourceOfTruth: 'docs/design-intent.json',
+      sourceOfTruth: 'docs/DESIGN.md',
       taxonomyOrder: ['primitive', 'semantic', 'component'],
       primitiveColorSpace: 'OKLCH',
       requireSemanticAliases: true,
@@ -343,7 +341,7 @@ function buildDesignIntentContractObject({
     ],
     requiredDesignSections: DESIGN_REQUIRED_SECTIONS,
     implementation: {
-      requiredDeliverables: ['docs/DESIGN.md', 'docs/design-intent.json'],
+      requiredDeliverables: ['docs/DESIGN.md'],
       requireDesignRationale: true,
       requireDistinctVisualDirection: true,
       requireMachineReadableContract: true,
@@ -367,46 +365,6 @@ function buildDesignIntentContractObject({
   };
 }
 
-export function buildDesignIntentSeedFromSignals({
-  projectName,
-  projectDescription,
-  primaryDomain,
-  features = [],
-  initContext,
-  status = 'seed-needs-design-synthesis',
-  supplementalFields = {},
-}) {
-  const designIntentContract = buildDesignIntentContractObject({
-    projectName,
-    projectDescription,
-    primaryDomain,
-    features,
-    initContext,
-    status,
-    supplementalFields,
-  });
-  const validationErrors = validateDesignIntentContract(designIntentContract);
-
-  if (validationErrors.length > 0) {
-    throw new Error(`Invalid design intent contract seed: ${validationErrors.join(' ')}`);
-  }
-
-  return `${JSON.stringify(designIntentContract, null, 2)}\n`;
-}
-
-export function buildDesignIntentSeed({
-  discoveryAnswers,
-  initContext,
-}) {
-  return buildDesignIntentSeedFromSignals({
-    projectName: discoveryAnswers.projectName,
-    projectDescription: discoveryAnswers.projectDescription,
-    primaryDomain: discoveryAnswers.primaryDomain,
-    features: discoveryAnswers.features,
-    initContext,
-    status: 'seed-needs-design-synthesis',
-  });
-}
 
 /**
  * Public schema index. Lists the field and signal names that this aggregator

package/lib/cli/project-scaffolder/prompt-builders.mjs

@@ -2,7 +2,6 @@ import { toTitleCase } from '../utils.mjs';
 import {
   PROJECT_DOC_SYNTHESIS_PROMPT_VERSION,
 } from './constants.mjs';
-import { buildDesignIntentSeed } from './design-contract.mjs';
 
 function buildDockerStrategyExecutionBlock(dockerStrategy) {
   const selectedDockerStrategy = String(dockerStrategy || '').trim();
@@ -124,10 +123,6 @@ export function buildDesignBootstrapPrompt({
   initContext,
   docsLanguage,
 }) {
-  const designIntentSeed = buildDesignIntentSeed({
-    discoveryAnswers,
-    initContext,
-  });
 
   return [
     '# Bootstrap Prompt: Dynamic Design Contract Synthesis',
@@ -139,11 +134,9 @@ export function buildDesignBootstrapPrompt({
     '',
     '## Mission',
     `Author docs/DESIGN.md in ${docsLanguage.toUpperCase()} language with strong art direction and engineering-ready guidance.`,
-    'Keep docs/design-intent.json synchronized as the machine-readable source of design intent.',
     '',
     '## Deliverables',
     '1. docs/DESIGN.md',
-    '2. docs/design-intent.json',
     '',
     '## Design Direction Process',
     'Follow `.agent-context/prompts/bootstrap-design.md` for the three-step design direction:',
@@ -169,19 +162,11 @@ export function buildDesignBootstrapPrompt({
     `- Runtime constraint: ${initContext.stackFileName === 'agent-decision-runtime.md' ? 'agent recommendation required before coding' : toTitleCase(initContext.stackFileName)}`,
     `- Architecture constraint: ${initContext.blueprintFileName === 'agent-decision-architecture.md' ? 'agent recommendation required before coding' : toTitleCase(initContext.blueprintFileName)}`,
     '',
-    '## Seed Machine Contract',
-    'Refine this scaffold seed instead of discarding it. Replace placeholder direction with agent-chosen decisions grounded in repo evidence and the active brief.',
-    '```json',
-    designIntentSeed.trim(),
-    '```',
-    '',
     '## Required Execution',
     '1. Create or update docs/DESIGN.md with complete content covering: design intent, audience signals, visual direction, color/typography/spacing decisions, responsive strategy, motion rules, component language, accessibility non-negotiables, and anti-patterns.',
-    '2. Create or update docs/design-intent.json with machine-readable design intent including conceptualAnchor, creative commitments, and anti-repeat ledger.',
-    '3. Keep both files synchronized.',
-    '4. Make the contract executable without screenshot dependency.',
-    '5. Preserve repoEvidence.designEvidenceSummary when onboarding or detector evidence exists.',
-    '6. After the contract exists, use it as a first-class source for future UI tasks.',
+    '2. Make the contract executable without screenshot dependency.',
+    '3. Preserve repoEvidence.designEvidenceSummary when onboarding or detector evidence exists.',
+    '4. After the contract exists, use it as a first-class source for future UI tasks.',
     '',
   ].join('\n');
 }

package/lib/cli/project-scaffolder/storage.mjs

@@ -14,7 +14,6 @@ import {
   resolveProjectDocTargets,
 } from './discovery.mjs';
 import {
-  buildDesignIntentSeed,
   shouldBootstrapDesignDocument,
 } from './design-contract.mjs';
 import {
@@ -76,14 +75,6 @@ export async function generateProjectDocumentation(
     });
     await fs.writeFile(path.join(promptsDirectoryPath, designPromptFileName), designPromptContent, 'utf8');
     generatedPromptFileNames.push(designPromptFileName);
-
-    const designIntentSeedFileName = 'design-intent.json';
-    const designIntentSeedContent = buildDesignIntentSeed({
-      discoveryAnswers,
-      initContext: synthesisContext,
-    });
-    await fs.writeFile(path.join(docsDirectoryPath, designIntentSeedFileName), designIntentSeedContent, 'utf8');
-    materializedFileNames.push(designIntentSeedFileName);
   }
 
   return {

package/lib/cli/project-scaffolder.mjs

@@ -21,7 +21,6 @@ export {
   shouldBootstrapDesignDocument,
   validateDesignIntentContract,
   validateDesignContractCompleteness,
-  buildDesignIntentSeedFromSignals,
 } from './project-scaffolder/design-contract.mjs';
 
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "4.3.4",
+  "version": "4.3.5",
   "type": "module",
   "description": "Change your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {

package/scripts/release-gate/static-checks.mjs

@@ -15,10 +15,6 @@ import {
   VERSION_PATTERN,
 } from './constants.mjs';
 import { pushResult, readText } from './runtime.mjs';
-import {
-  buildDesignIntentSeedFromSignals,
-  validateDesignContractCompleteness,
-} from '../../lib/cli/project-scaffolder.mjs';
 
 export function runStaticReleaseChecks(results, diagnostics) {
   const packageJsonPath = 'package.json';
@@ -70,38 +66,6 @@ export function runStaticReleaseChecks(results, diagnostics) {
     pushResult(results, true, 'history-v18', 'Project history includes V1.8 release track');
   }
 
-  try {
-    const designIntentSeed = JSON.parse(buildDesignIntentSeedFromSignals({
-      projectName: 'Release Gate UI Contract',
-      projectDescription: 'Validates deterministic UI design contract completeness before release',
-      primaryDomain: 'Web application',
-      initContext: {
-        stackFileName: 'agent-decision-runtime.md',
-        blueprintFileName: 'agent-decision-architecture.md',
-      },
-      // Seed status so `tokenContinuityClassification: pending-research`
-      // is a valid placeholder. This probe asserts seed-shape completeness,
-      // not active-contract behavior; an agent or user fills the contract
-      // with anchor-derived / continuity-retained / newly-introduced once
-      // the dossier is filled.
-      status: 'seed-needs-design-synthesis',
-    }));
-    const designContractIssues = validateDesignContractCompleteness(designIntentSeed);
-
-    if (designContractIssues.length === 0) {
-      pushResult(results, true, 'ui-design-contract-completeness', 'Design intent seed includes deterministic token derivation and library verification gates');
-    } else {
-      pushResult(
-        results,
-        false,
-        'ui-design-contract-completeness',
-        `Design intent seed completeness issues: ${designContractIssues.join('; ')}`
-      );
-    }
-  } catch (designContractError) {
-    const designContractMessage = designContractError instanceof Error ? designContractError.message : 'Unknown design contract error';
-    pushResult(results, false, 'ui-design-contract-completeness', `Cannot validate design intent seed: ${designContractMessage}`);
-  }
 
   const requiredOperationsFiles = [
     '.agent-context/review-checklists/architecture-review.md',

package/scripts/validate/config.mjs

@@ -267,18 +267,9 @@ export const REQUIRED_UPGRADE_UI_CONTRACT_WARNING_SNIPPETS = [
     path: 'lib/cli/commands/upgrade.mjs',
     snippets: [
       'UI/frontend scope was detected, but the dynamic design contract is incomplete:',
-      'docs/design-intent.json',
-      'Planned seed on apply: docs/design-intent.json',
-      'Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.',
       'detectUiScopeSignals',
     ],
   },
-  {
-    path: 'lib/cli/commands/upgrade/design-intent-seed.mjs',
-    snippets: [
-      'seed-generated-during-upgrade',
-    ],
-  },
 ];
 export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
@@ -288,7 +279,6 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'bootstrap-design.md',
       'frontend-architecture.md',
       'docs/DESIGN.md',
-      'docs/design-intent.json',
       'Documentation-First Mode',
       'English by default',
       'do not write application, firmware, or UI code',

package/lib/cli/commands/upgrade/design-intent-seed.mjs

@@ -1,46 +0,0 @@
-import path from 'node:path';
-
-import { buildDesignIntentSeedFromSignals } from '../../project-scaffolder.mjs';
-
-export function buildUpgradeDesignIntentSeed({
-  targetDirectoryPath,
-  packageManifest,
-  selectedStackFileName,
-  selectedBlueprintFileName,
-  uiScopeSignals,
-}) {
-  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) => {
-      return signalReason.includes('android') || signalReason.includes('ios');
-    });
-  const resolvedDomain = isMobileUiProject ? 'Mobile app' : 'Web application';
-  const projectDescription = String(packageManifest?.description || '').trim()
-    || `Existing ${resolvedDomain.toLowerCase()} detected during upgrade. 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-upgrade',
-    supplementalFields: {
-      upgradeSignals: {
-        detectedFrom: uiScopeSignals.signalReasons,
-        generatedBy: 'upgrade-seed',
-      },
-      repoEvidence: {
-        uiSignalReasons: uiScopeSignals.signalReasons,
-        frontendMetrics: uiScopeSignals.frontendEvidenceMetrics || null,
-        designEvidenceSummary: uiScopeSignals.designEvidenceSummary || null,
-        workspaceUiEntries: uiScopeSignals.workspaceUiEntries || [],
-      },
-    },
-  });
-}

package/lib/cli/project-scaffolder/design-contract/research-dossier-migration.mjs

@@ -1,190 +0,0 @@
-/**
- * Research-dossier migration helper.
- *
- * Adds the `researchDossier.metadata` block to existing `docs/design-intent.json`
- * files when it is absent, populating `antiRepeatLedger` from the existing
- * conceptual anchor, palette, and motion fields so future UI work cannot
- * unknowingly repeat shipped direction.
- *
- * Idempotent: if the metadata block already exists, the file is left untouched.
- * Additive: never overwrites existing fields.
- */
-
-import fs from 'node:fs/promises';
-
-import { pathExists } from '../../utils.mjs';
-
-const FRESHNESS_WINDOW_DAYS = 90;
-const FRESHNESS_RULE = 'Research dossier is stale when researchVerifiedAt is null or older than freshnessWindowDays. Stale dossiers must run research-design.md before UI implementation. User-explicit redesign requests bypass freshness and force fresh research regardless of age.';
-
-function takeFirstNonEmpty(...candidateValues) {
-  for (const candidateValue of candidateValues) {
-    if (typeof candidateValue === 'string' && candidateValue.trim().length > 0) {
-      return candidateValue.trim();
-    }
-  }
-  return null;
-}
-
-function buildPreviousAnchorEntry(designIntentContract) {
-  const conceptualAnchor = designIntentContract?.conceptualAnchor;
-  if (!conceptualAnchor || typeof conceptualAnchor !== 'object') {
-    return [];
-  }
-  const anchorReference = takeFirstNonEmpty(conceptualAnchor.anchorReference);
-  if (!anchorReference || anchorReference === 'agent-defined-anchor-reference') {
-    return [];
-  }
-  const specificReferencePoint = takeFirstNonEmpty(conceptualAnchor.specificReferencePoint);
-  const summary = specificReferencePoint
-    ? `${anchorReference} (${specificReferencePoint})`
-    : anchorReference;
-  return [{
-    summary,
-    source: 'migrated-from-existing-design-intent',
-    blockedBecause: 'previously-shipped-direction',
-  }];
-}
-
-function buildPreviousPaletteEntry(designIntentContract) {
-  const derivedTokenLogic = designIntentContract?.derivedTokenLogic;
-  const colorTruth = designIntentContract?.colorTruth;
-  const colorDerivationSummary = takeFirstNonEmpty(derivedTokenLogic?.colorDerivationSource);
-  const colorIntent = takeFirstNonEmpty(colorTruth?.intent);
-  const summary = takeFirstNonEmpty(colorIntent, colorDerivationSummary);
-  if (!summary) {
-    return [];
-  }
-  return [{
-    summary,
-    source: 'migrated-from-existing-design-intent',
-    blockedBecause: 'previously-shipped-palette-behavior',
-  }];
-}
-
-function buildPreviousMotionEntry(designIntentContract) {
-  const motionPaletteDecision = designIntentContract?.motionPaletteDecision;
-  const motionSystem = designIntentContract?.motionSystem;
-  const derivedTokenLogic = designIntentContract?.derivedTokenLogic;
-
-  const motionSignature = takeFirstNonEmpty(
-    motionPaletteDecision?.signatureMotion,
-    motionPaletteDecision?.motion,
-    motionSystem?.signature,
-    motionSystem?.purpose,
-    derivedTokenLogic?.motionBudget,
-  );
-  if (!motionSignature) {
-    return [];
-  }
-  return [{
-    summary: motionSignature,
-    source: 'migrated-from-existing-design-intent',
-    blockedBecause: 'previously-shipped-motion-signature',
-  }];
-}
-
-function buildPreviousTypographyEntry(designIntentContract) {
-  if (!designIntentContract || typeof designIntentContract !== 'object') {
-    return [];
-  }
-  const tokenSystem = designIntentContract?.tokenSystem;
-  const typographyTokens = tokenSystem && typeof tokenSystem === 'object' ? tokenSystem.typographyTokens : null;
-  if (!typographyTokens || typeof typographyTokens !== 'object') {
-    return [];
-  }
-  const tokenEntries = Object.entries(typographyTokens)
-    .filter(([, value]) => typeof value === 'string' && value.trim().length > 0)
-    .map(([role, value]) => `${role}: ${value.trim()}`);
-  if (tokenEntries.length === 0) {
-    return [];
-  }
-  return [{
-    summary: tokenEntries.join('; '),
-    source: 'migrated-from-existing-design-intent',
-    blockedBecause: 'previously-shipped-typography-trio',
-  }];
-}
-
-export function buildResearchDossierMetadata({
-  designIntentContract = null,
-  populateLedgerFromExistingContract = false,
-} = {}) {
-  const metadata = {
-    researchVerifiedAt: null,
-    freshnessWindowDays: FRESHNESS_WINDOW_DAYS,
-    freshnessRule: FRESHNESS_RULE,
-    antiRepeatLedger: {
-      blocklistFromHistory: true,
-      ledgerScope: 'signature-level-descriptors-only',
-      ledgerMaxEntriesPerCategory: 3,
-      previousAnchors: [],
-      previousPalettes: [],
-      previousMotionSignatures: [],
-      previousTypographyChoices: [],
-      previousStructuralFingerprints: [],
-    },
-    userExplicitRedesignBypassesFreshness: true,
-    statusAwareValidation: {
-      seedStatuses: [
-        'seed-needs-design-synthesis',
-        'seed-generated-during-init',
-        'seed-generated-during-upgrade',
-      ],
-      seedSkipsDossierShape: true,
-      activeRequiresFreshOrExplicitRedesign: true,
-    },
-  };
-
-  if (populateLedgerFromExistingContract && designIntentContract && typeof designIntentContract === 'object') {
-    metadata.antiRepeatLedger.previousAnchors = buildPreviousAnchorEntry(designIntentContract).slice(0, metadata.antiRepeatLedger.ledgerMaxEntriesPerCategory);
-    metadata.antiRepeatLedger.previousPalettes = buildPreviousPaletteEntry(designIntentContract).slice(0, metadata.antiRepeatLedger.ledgerMaxEntriesPerCategory);
-    metadata.antiRepeatLedger.previousMotionSignatures = buildPreviousMotionEntry(designIntentContract).slice(0, metadata.antiRepeatLedger.ledgerMaxEntriesPerCategory);
-    metadata.antiRepeatLedger.previousTypographyChoices = buildPreviousTypographyEntry(designIntentContract).slice(0, metadata.antiRepeatLedger.ledgerMaxEntriesPerCategory);
-  }
-
-  return metadata;
-}
-
-/**
- * Migrates an existing design-intent.json file in place by adding
- * `researchDossier.metadata` when absent. Idempotent.
- *
- * @param {string} designIntentFilePath
- * @returns {Promise<{ migrated: boolean, reason: string }>}
- */
-export async function migrateExistingDesignIntentToResearchDossierSchema(designIntentFilePath) {
-  if (!(await pathExists(designIntentFilePath))) {
-    return { migrated: false, reason: 'design-intent-file-absent' };
-  }
-
-  const fileContent = await fs.readFile(designIntentFilePath, 'utf8');
-  let designIntentContract;
-  try {
-    designIntentContract = JSON.parse(fileContent);
-  } catch {
-    return { migrated: false, reason: 'design-intent-file-not-valid-json' };
-  }
-
-  if (!designIntentContract || typeof designIntentContract !== 'object') {
-    return { migrated: false, reason: 'design-intent-file-not-an-object' };
-  }
-
-  const existingResearchDossier = designIntentContract.researchDossier;
-  if (existingResearchDossier && typeof existingResearchDossier === 'object' && existingResearchDossier.metadata) {
-    return { migrated: false, reason: 'research-dossier-metadata-already-present' };
-  }
-
-  const populatedMetadata = buildResearchDossierMetadata({
-    designIntentContract,
-    populateLedgerFromExistingContract: true,
-  });
-
-  designIntentContract.researchDossier = {
-    ...(existingResearchDossier && typeof existingResearchDossier === 'object' ? existingResearchDossier : {}),
-    metadata: populatedMetadata,
-  };
-
-  await fs.writeFile(designIntentFilePath, `${JSON.stringify(designIntentContract, null, 2)}\n`, 'utf8');
-  return { migrated: true, reason: 'research-dossier-metadata-injected' };
-}