@ryuenn3123/agentic-senior-core 4.3.0 → 4.3.2

package/.agent-context/prompts/bootstrap-design.md

@@ -87,6 +87,18 @@ Before UI code, record:
 - one morphology or composition choice that avoids interchangeable card stacks when the product allows it
 - at least three at-a-glance product-specific signals for new screens or broad redesigns
 Do not ship AI-safe UI. Record exact drift signals in `reviewRubric`; at minimum reject decorative grid wallpaper, default line backgrounds, calibration-mark wallpaper, soft glow backgrounds, generic abstract marks, testing/demo/placeholder UI copy, terminal-only user flows, and first-output composition with only local copy swapped in when they have no product function. Treat measurement, calibration, crop, route, timeline, and inspection marks as task overlays or control affordances only; never promote them to the page background, hero backdrop, or first-output visual texture. If a conceptual anchor suggests a forbidden motif, the forbidden motif wins; express the anchor through workflow, hierarchy, density, typography, material behavior, state design, and interaction grammar instead of literal wallpaper.
+## Pre-Emit Identity Check
+
+Before outputting any UI code, mockup, or design direction, answer:
+
+1. **Specificity test**: If the product name and all text were removed from this UI, would a designer still identify what product category and what specific product this was built for? If the answer is "no" or "only category, not this specific product" -- revise the concept, not the details.
+
+2. **Structural variety test**: Does the hero or primary viewport avoid the centred-everything composition (large name centered, subtitle below, CTA below that)? If yes, pass. If no, name the product reason for centred composition or revise.
+
+3. **Default detection test**: Name the one design default you were most tempted to use. Confirm it was rejected or adapted with a product-specific reason, not merely avoided.
+
+Failure on any test requires revision before output. This check is not optional and applies to both new designs and additive UI tasks that change composition.
+
 ## Brave Redesign Default
 For UI design work, the agent owns the ambition decision. For broad screens, redesigns, or new visual systems, treat expressive motion, spatial hierarchy, distinctive composition, and product-specific interaction as the baseline even when the user did not say "rich". Do not reduce the request to a safer version of the existing UI, a static implementation, or a component-kit rearrangement because research or dependency selection feels inconvenient.
 

package/.agent-context/prompts/research-design.md

@@ -44,7 +44,7 @@ Research vocabulary is internal-only. Use `sourceFreshness`, `evidenceTable[]`,
 
 ## Anti-Repeat Ledger Gate (read first)
 
-If `docs/design-intent.json` already exists and carries `researchDossier.metadata.antiRepeatLedger`, treat every entry under `previousAnchors`, `previousPalettes`, and `previousMotionSignatures` as a hard blocklist before producing any candidate in Sections 3-5.
+If `docs/design-intent.json` already exists and carries `researchDossier.metadata.antiRepeatLedger`, treat every entry under `previousAnchors`, `previousPalettes`, `previousMotionSignatures`, and `previousStructuralFingerprints` as a hard blocklist before producing any candidate in Sections 3-5.
 
 Rules:
 
@@ -69,49 +69,25 @@ Before any visual choice, write a structured product reading:
 
 Output: `productReading` block. Each field must be one sentence, evidence-backed from repo or brief. Speculation is not allowed; if a field is unknown, name it as such and stop until the user resolves it.
 
-## Reference Routing
+## Default Detection Protocol
 
-After Section 1, identify the product category. Then run web_search 
-and web_fetch on the matching domains below (or other modern, highly-regarded digital product equivalents) before picking any anchor.
+Before fetching any reference, use the `productReading` output to derive search direction. Do not self-select from a fixed category list.
 
-Developer tool / CLI / AI infrastructure:
-→ Linear, Raycast, Vercel, Warp, Resend, Railway (or equivalents)
+1. **Name defaults.** Name three design directions the agent is most tempted to use for this brief. For each, write one sentence naming the specific visual pattern (layout, palette, density, motion, typography, composition).
 
-SaaS / B2B productivity:
-→ Notion, Loom, Cron, Superhuman, Intercom (or equivalents)
+2. **Argue against each default.** For each default, write one sentence on why it would flatten what is specific about THIS product's core verb, data shape, or context of use. The argument must reference a `productReading` field, not a generic aesthetic opinion.
 
-AI product / API:
-→ Anthropic, Perplexity, ElevenLabs, Replicate, Mistral (or equivalents)
+3. **Derive search direction from the argument.** The rejection argument reveals what the product needs that the default cannot provide. Use that need as the search query for `web_search` and `web_fetch`. Search by the product's core characteristic pair (medium x intent), not by product category name. Example: core verb "demonstrate" + data shape "narrative" -> search "editorial portfolio interaction design" not "portfolio sites."
 
-Ecommerce:
-→ SSENSE, Allbirds, Represent, Shopify examples (or equivalents)
+4. **Cross-domain pull.** Identify one domain that shares the same interaction model but a different visual vocabulary. Pull one reference from there. Example: portfolio -> scientific publication, exhibition catalog, film press kit -- anything with "demonstrate body of work" as the core verb but a different surface expectation.
 
-Design tool / creative:
-→ Framer, Spline, Rive, Penpot (or equivalents)
+5. **Gallery check.** Find state-of-the-art quality references for the derived direction by searching the web. CRITICAL: DO NOT use gallery homepages or discovery platforms as references. You must drill down to find a specific featured product/website, fetch THAT specific product's URL, and use it as evidence.
 
-Consumer / mobile:
-→ Arc browser, Craft, Things, Bear (or equivalents)
+DO NOT fetch: Wikipedia, Dribbble templates, or generic blog posts about "best UI design practices."
 
-Data / analytics:
-→ Retool, Posthog, Metabase, Grafana (or equivalents)
+For each reference: fetch the actual product page this session, record what mechanic or hierarchy is borrowed, and explicitly state what is NOT borrowed (palette, component skin, layout rhythm).
 
-For every product category:
-→ Also check galleries like Awwwards, Godly.website, and Layers.to to find 
-  state-of-the-art quality references. 
-  CRITICAL: DO NOT use the gallery homepage itself as a reference. You must 
-  find a specific featured product/website from those galleries, fetch THAT 
-  specific product's URL, and use it as your anchor.
-
-DO NOT fetch: Wikipedia, Dribbble templates, or generic blog posts 
-about "best UI design practices."
-
-For each reference: fetch the actual product page this session, record what 
-mechanic or hierarchy is borrowed, and explicitly state what is NOT 
-borrowed (palette, component skin, layout rhythm).
-
-If the anchor concept you're considering would make sense to someone 
-from 1920, it's too archival. The anchor must be legible to someone 
-who uses the web today.
+If the anchor concept you're considering would make sense to someone from 1920, it's too archival. The anchor must be legible to someone who uses the web today.
 
 ## Section 2 — Reference Intake
 

package/AGENTS.md

@@ -29,7 +29,7 @@ Keep it short. Do not load every rule just to fill it out.
 
 ## Default Activation And Command Economy
 Before any non-trivial task, run `agentic-senior-core context "<task_description>"` and emit the Bootstrap Receipt. Skip only for trivial tasks: version bumps, typo fixes, single-line commits.
-Always prefix noisy shell commands: `ascx git status`, `ascx git diff`, `ascx npm test`, `ascx rg` searches. Use raw commands only for pipes, redirects, or commands not supported by ascx.
+Always prefix noisy shell commands: `ascx git status`, `ascx git diff`, `ascx npm test`, `ascx npm install`, `ascx npm run build`, `ascx tsc`, `ascx rg` searches. Use raw commands only for pipes, redirects, or commands not supported by ascx.
 Always read and apply `.agent-context/prompts/compact-natural-mode.md` for every final user-facing reply. Never repeat full command output; reference tee file paths when truncated.
 
 ## Layer Index

package/benchmarks/runtime-token-saver/fixtures.mjs

@@ -711,4 +711,126 @@ export const ASCX_RUNTIME_TOKEN_SAVER_FIXTURES = [
       },
     ],
   },
+  {
+    id: 'npm-install-success',
+    commandArguments: ['npm', 'install'],
+    capture: {
+      exitCode: 0,
+      stdout: [
+        'npm WARN deprecated package...',
+        'added 142 packages in 12s',
+      ].join('\n'),
+      stderr: '',
+    },
+    expectCompressed: true,
+    expectTee: false,
+    requiredSubstrings: [
+      'npm install summary:',
+      'added 142 packages in 12s',
+      'exit: 0',
+    ],
+    continuationChecks: [
+      {
+        id: 'npm-install-success-compacts-noise',
+        action: 'Recognize the install passed and avoid reading raw noise.',
+        requiredSubstrings: [
+          'added 142 packages in 12s',
+          'exit: 0',
+        ],
+        expectTee: false,
+      },
+    ],
+  },
+  {
+    id: 'npm-install-failure',
+    commandArguments: ['npm', 'install'],
+    capture: {
+      exitCode: 1,
+      stdout: '',
+      stderr: [
+        'npm WARN deprecated package...',
+        'npm ERR! code ERESOLVE',
+        'npm ERR! ERESOLVE unable to resolve dependency tree',
+      ].join('\n'),
+    },
+    expectCompressed: true,
+    expectTee: true,
+    requiredSubstrings: [
+      'npm install summary:',
+      'failures:',
+      'npm ERR! code ERESOLVE',
+      'exit: 1',
+    ],
+    continuationChecks: [
+      {
+        id: 'npm-install-failure-preserves-error',
+        action: 'Identify the installation error.',
+        requiredSubstrings: [
+          'failures:',
+          'npm ERR! code ERESOLVE',
+        ],
+        expectTee: true,
+      },
+    ],
+  },
+  {
+    id: 'tsc-success',
+    commandArguments: ['tsc'],
+    capture: {
+      exitCode: 0,
+      stdout: '',
+      stderr: '',
+    },
+    expectCompressed: true,
+    expectTee: false,
+    requiredSubstrings: [
+      'tsc summary:',
+      'result: passed',
+      'exit: 0',
+    ],
+    continuationChecks: [
+      {
+        id: 'tsc-success-compacts-noise',
+        action: 'Recognize the typecheck passed.',
+        requiredSubstrings: [
+          'result: passed',
+          'exit: 0',
+        ],
+        expectTee: false,
+      },
+    ],
+  },
+  {
+    id: 'tsc-failure',
+    commandArguments: ['tsc'],
+    capture: {
+      exitCode: 1,
+      stdout: [
+        'src/components/Header.tsx:15:10 - error TS2322: Type \'string\' is not assignable to type \'number\'.',
+        '15   const age: number = "25";',
+      ].join('\n'),
+      stderr: '',
+    },
+    expectCompressed: true,
+    expectTee: true,
+    requiredSubstrings: [
+      'tsc summary:',
+      'failures:',
+      'error TS2322',
+      'Header.tsx:15:10',
+      'exit: 1',
+    ],
+    continuationChecks: [
+      {
+        id: 'tsc-failure-preserves-error',
+        action: 'Identify the typecheck error and file path.',
+        requiredSubstrings: [
+          'failures:',
+          'error TS2322',
+          'Header.tsx:15:10',
+        ],
+        expectTee: true,
+      },
+    ],
+  },
 ];

package/lib/cli/ascx/adapters/npm-install.mjs

@@ -0,0 +1,94 @@
+const FAILURE_LINE_PATTERN = /(?:^npm error|^npm ERR!|^error\b|^ERESOLVE\b|^Failed to)/iu;
+const SUMMARY_LINE_PATTERN = /(?:added \d+ packages|up to date in|Done in \d+|Packages: \+\d+)/iu;
+
+function pushUniqueLine(lines, nextLine) {
+  const normalizedLine = String(nextLine || '').trimEnd();
+  if (normalizedLine && !lines.includes(normalizedLine)) {
+    lines.push(normalizedLine);
+  }
+}
+
+export function compressNpmInstallOutput({ stdout, stderr, exitCode }) {
+  const rawOutput = [stdout, stderr].filter(Boolean).join('\n');
+  const lines = rawOutput.split(/\r?\n/u);
+  
+  if (exitCode === 0) {
+    let summaryLine = 'result: passed';
+    for (const line of lines) {
+      if (SUMMARY_LINE_PATTERN.test(line)) {
+        summaryLine = line.trim();
+        break;
+      }
+    }
+
+    return {
+      filterName: 'npm-install-summary',
+      confident: true,
+      truncated: false,
+      output: `npm install summary:\n${summaryLine}`,
+      preservedFields: {
+        exitCode: true,
+      },
+    };
+  }
+
+  const keptLines = [];
+  let contextBuffer = [];
+
+  for (const line of lines) {
+    const trimmedLine = line.trim();
+
+    if (!trimmedLine) {
+      if (contextBuffer.length > 0) {
+        contextBuffer.push(line);
+      }
+      continue;
+    }
+
+    if (FAILURE_LINE_PATTERN.test(trimmedLine)) {
+      for (const ctxLine of contextBuffer) {
+        pushUniqueLine(keptLines, ctxLine);
+      }
+      contextBuffer = [];
+      pushUniqueLine(keptLines, line);
+    } else {
+      contextBuffer.push(line);
+      if (contextBuffer.length > 2) {
+        contextBuffer.shift();
+      }
+    }
+  }
+
+  const outputLines = ['npm install summary:'];
+
+  if (keptLines.length > 0) {
+    outputLines.push('failures:');
+    outputLines.push(...keptLines.slice(0, 50));
+  }
+
+  const truncated = keptLines.length > 50;
+  if (truncated) {
+    outputLines.push(`... truncated ${keptLines.length - 50} more failure evidence lines`);
+  }
+
+  if (keptLines.length === 0) {
+    return {
+      filterName: 'npm-install-raw-parse-uncertain',
+      confident: false,
+      truncated: false,
+      output: rawOutput,
+      preservedFields: {},
+    };
+  }
+
+  return {
+    filterName: 'npm-install-summary',
+    confident: true,
+    truncated,
+    output: outputLines.join('\n'),
+    preservedFields: {
+      rootError: keptLines.length > 0,
+      exitCode: true,
+    },
+  };
+}

package/lib/cli/ascx/adapters/tsc.mjs

@@ -0,0 +1,70 @@
+const ERROR_LINE_PATTERN = /(?:error TS\d+:|Error:)/iu;
+const FILE_LINE_PATTERN = /(?:[A-Za-z]:)?[^:\s]+?\.(?:ts|tsx|js|jsx):\d+,\d+/u;
+
+function pushUniqueLine(lines, nextLine) {
+  const normalizedLine = String(nextLine || '').trimEnd();
+  if (normalizedLine && !lines.includes(normalizedLine)) {
+    lines.push(normalizedLine);
+  }
+}
+
+export function compressTscOutput({ stdout, stderr, exitCode }) {
+  const rawOutput = [stdout, stderr].filter(Boolean).join('\n');
+  const lines = rawOutput.split(/\r?\n/u);
+  
+  if (exitCode === 0) {
+    return {
+      filterName: 'tsc-summary',
+      confident: true,
+      truncated: false,
+      output: 'tsc summary:\nresult: passed',
+      preservedFields: {
+        exitCode: true,
+      },
+    };
+  }
+
+  const keptLines = [];
+  
+  for (const line of lines) {
+    const trimmedLine = line.trim();
+    if (!trimmedLine) continue;
+
+    if (ERROR_LINE_PATTERN.test(trimmedLine) || FILE_LINE_PATTERN.test(trimmedLine)) {
+      pushUniqueLine(keptLines, line);
+    }
+  }
+
+  const outputLines = ['tsc summary:'];
+
+  if (keptLines.length > 0) {
+    outputLines.push('failures:');
+    outputLines.push(...keptLines.slice(0, 50));
+  }
+
+  const truncated = keptLines.length > 50;
+  if (truncated) {
+    outputLines.push(`... truncated ${keptLines.length - 50} more failure evidence lines`);
+  }
+
+  if (keptLines.length === 0) {
+    return {
+      filterName: 'tsc-raw-parse-uncertain',
+      confident: false,
+      truncated: false,
+      output: rawOutput,
+      preservedFields: {},
+    };
+  }
+
+  return {
+    filterName: 'tsc-summary',
+    confident: true,
+    truncated,
+    output: outputLines.join('\n'),
+    preservedFields: {
+      rootError: keptLines.length > 0,
+      exitCode: true,
+    },
+  };
+}

package/lib/cli/ascx/lexer.mjs

@@ -121,6 +121,26 @@ export function classifyAscxInvocation(parsedCommand) {
     };
   }
 
+  const isNpmInstall = parsedCommand.executable === 'npm' && ['install', 'i', 'ci'].includes(parsedCommand.args[0]);
+  const isYarnInstall = parsedCommand.executable === 'yarn' && (parsedCommand.args.length === 0 || parsedCommand.args[0] === 'install');
+  const isPnpmInstall = parsedCommand.executable === 'pnpm' && ['install', 'i'].includes(parsedCommand.args[0]);
+
+  if (isNpmInstall || isYarnInstall || isPnpmInstall) {
+    return {
+      kind: 'compressible',
+      adapterName: 'npm-install',
+      reason: 'supported dependency installation adapter',
+    };
+  }
+
+  if (parsedCommand.executable === 'tsc' || (parsedCommand.executable === 'npx' && parsedCommand.args[0] === 'tsc')) {
+    return {
+      kind: 'compressible',
+      adapterName: 'tsc',
+      reason: 'supported tsc adapter',
+    };
+  }
+
   return {
     kind: 'passthrough',
     adapterName: null,

package/lib/cli/ascx/runtime.mjs

@@ -4,6 +4,8 @@ import { compressGitDiffOutput } from './adapters/git-diff.mjs';
 import { compressGitStatusOutput } from './adapters/git-status.mjs';
 import { compressNpmTestOutput } from './adapters/npm-test.mjs';
 import { compressNpmRunBuildOutput } from './adapters/npm-run-build.mjs';
+import { compressNpmInstallOutput } from './adapters/npm-install.mjs';
+import { compressTscOutput } from './adapters/tsc.mjs';
 import { compressRgOutput } from './adapters/rg.mjs';
 import { buildAscxFooter, shouldWriteSafetyTee } from './formatter.mjs';
 import { classifyAscxInvocation, parseAscxCommand } from './lexer.mjs';
@@ -14,6 +16,8 @@ const ADAPTERS = {
   'git-status': compressGitStatusOutput,
   'npm-test': compressNpmTestOutput,
   'npm-run-build': compressNpmRunBuildOutput,
+  'npm-install': compressNpmInstallOutput,
+  'tsc': compressTscOutput,
   'rg': compressRgOutput,
 };
 

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

@@ -122,6 +122,7 @@ export function buildResearchDossierMetadata({
       previousPalettes: [],
       previousMotionSignatures: [],
       previousTypographyChoices: [],
+      previousStructuralFingerprints: [],
     },
     userExplicitRedesignBypassesFreshness: true,
     statusAwareValidation: {

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

@@ -12,7 +12,7 @@ const REQUIRED_SEED_STATUSES = [
   'seed-generated-during-init',
   'seed-generated-during-upgrade',
 ];
-const ANTI_REPEAT_LEDGER_CATEGORIES = ['previousAnchors', 'previousPalettes', 'previousMotionSignatures', 'previousTypographyChoices'];
+const ANTI_REPEAT_LEDGER_CATEGORIES = ['previousAnchors', 'previousPalettes', 'previousMotionSignatures', 'previousTypographyChoices', 'previousStructuralFingerprints'];
 
 function validateMetadataBaseShape(metadata, validationErrors) {
   if (

package/package.json

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

package/scripts/validate/config.mjs

@@ -393,6 +393,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'genericity findings that cannot name the exact drift signal',
       'research-design.md',
       'Section 3 gate from `research-design.md`',
+      'Pre-Emit Identity Check',
     ],
   },
   {

package/scripts/validate/coverage-checks.mjs

@@ -366,7 +366,7 @@ export async function validateInstructionAdapters(context) {
   ];
   const instructionFootprintLimits = [
     { path: 'AGENTS.md', maxLines: 180 },
-    { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 220 },
+    { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 235 },
     { path: '.agent-context/rules/frontend-architecture.md', maxLines: 180 },
   ];