@tsfpp/agents 1.2.1 → 1.2.3

package/CHANGELOG.md

@@ -10,6 +10,31 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.2.3] - 2026-05-16
+
+### Added
+
+- Added `react` and `data` as supported focus values for `copilot/agents/tsfpp-audit.agent.md`.
+- Added Data profile overlay support via `node_modules/@tsfpp/standard/spec/DATA_CODING_STANDARD.md`.
+
+### Changed
+
+- Updated TSF++ standard reference paths in `copilot/agents/tsfpp-audit.agent.md` to `node_modules/@tsfpp/standard/spec/*.md`.
+- Updated audit startup prompt and argument hints to include React and Data focused targets.
+
+### Removed
+
+- Removed checklist rule `8.x` (prelude ADT/helper reuse enforcement) from the base audit template.
+- Simplified checklist rule `9.x` from broad dependency hygiene checks to a direct `ramda` import guard.
+
+## [1.2.2] - 2026-05-16
+
+### Fixed
+
+- Updated `init.mjs` questionnaire flow to avoid overwriting existing `tsconfig` and ESLint config files.
+- Added `N`/skip escape hatch for existing-file prompts.
+- Added `SIGINT` handling by wrapping execution in `main` so Ctrl+C exits cleanly without hanging awaits.
+
 ## [1.2.1] - 2026-05-16
 
 ### Fixed

package/copilot/agents/tsfpp-audit.agent.md

@@ -1,7 +1,7 @@
 ---
 description: TSF++ standards compliance auditor. Produces a structured markdown report in docs/audits/ with per-slice checkboxes.
 name: tsfpp-audit
-argument-hint: "target=<path|package|layer> focus=<all|types|boundary|complexity|loc|annotations|security>"
+argument-hint: "target=<path|package|layer> focus=<all|types|boundary|complexity|loc|annotations|security|react|data>"
 tools:
   - edit/createFile
   - edit/editFiles
@@ -29,6 +29,7 @@ The canonical standard is at `node_modules/@tsfpp/standard/spec/CODING_STANDARD.
 Profile overlays:
 - API: `node_modules/@tsfpp/standard/spec/API_CODING_STANDARD.md`
 - React: `node_modules/@tsfpp/standard/spec/REACT_CODING_STANDARD.md`
+- Data: `node_modules/@tsfpp/standard/spec/DATA_CODING_STANDARD.md`
 - Security: `node_modules/@tsfpp/standard/spec/SECURITY_CODING_STANDARD.md`
 
 If any referenced file is missing, stop immediately and report the path. Do not proceed.
@@ -42,7 +43,7 @@ If any referenced file is missing, stop immediately and report the path. Do not
 If the user has not provided both `target` and `focus`, ask exactly this:
 
 > **Target** — path, package name, or layer to audit (e.g. `src/domain`, `@tsfpp/prelude`, `api layer`)?
-> **Focus** — `all` · `types` · `boundary` · `complexity` · `loc` · `annotations` · `security` · or comma-separated combination?
+> **Focus** — `all` · `types` · `boundary` · `complexity` · `loc` · `annotations` · `security` · `react` · `data` · or comma-separated combination?
 
 Do not proceed until both are confirmed.
 
@@ -132,8 +133,7 @@ Append each completed slice to the report:
 - [x] 5.1 — Pipelines via `pipe` from prelude
 - [x] 6.x — No `throw` in core
 - [x] 7.x — JSDoc on all exports
-- [x] 8.x — Prefer prelude ADTs/constructors/helpers (no downstream reimplementation in domain code)
-- [x] 9.x — Dependency hygiene (no deprecated dependencies, no banned imports per policy, no layer-violating imports)
+- [x] 9.x — No direct `ramda` import
 
 #### Deviation register
 
@@ -147,10 +147,10 @@ Append each completed slice to the report:
 ## Focus-specific rule sets
 
 ### `types`
-1.4 (no bare interface) · 1.5 (no `any`) · 1.6 (no `!` or `as`) · 3.x (readonly) · branded types on domain primitives · smart constructor completeness · exhaustive sum-type dispatch · prelude ADT/constructor/helper reuse (no downstream reimplementation)
+1.4 (no bare interface) · 1.5 (no `any`) · 1.6 (no `!` or `as`) · 3.x (readonly) · branded types on domain primitives · smart constructor completeness · exhaustive sum-type dispatch
 
 ### `boundary`
-API_CODING_STANDARD.md Rules 1–5 · Zod schema completeness · Result/Option at I/O · `extractContext` usage · `apiErrorToResponse` coverage · no raw `throw` across boundaries · `@tsfpp/boundary` response builders used · avoid boundary-local ADT/helper reinvention when prelude equivalents exist
+API_CODING_STANDARD.md Rules 1–5 · Zod schema completeness · Result/Option at I/O · `extractContext` usage · `apiErrorToResponse` coverage · no raw `throw` across boundaries · `@tsfpp/boundary` response builders used
 
 ### `complexity`
 Function body ≤ 40 lines · cyclomatic complexity ≤ 10 · nesting ≤ 4 · arity ≤ 3 positional params · pipeline depth ≤ 8 stages
@@ -164,6 +164,12 @@ JSDoc on every export · `@param` + `@returns` present · `@law` on combinators
 ### `security`
 SECURITY_CODING_STANDARD.md: input validation at boundaries · no secrets in code · no sensitive data in errors · auth/authz at correct layer · dependency hygiene
 
+### `react`
+REACT_CODING_STANDARD.md: component shape and explicit return types · readonly props contracts · state model quality · effect discipline (`useEffect` only for external sync) · server state via TanStack Query · form and routing standards
+
+### `data`
+DATA_CODING_STANDARD.md: schema-first design · migration safety and reversibility · repository/query boundaries · transaction discipline · index/key correctness · deterministic data transformation and serialization at boundaries
+
 ### `all`
 All focus areas above in sequence.
 

package/init.mjs

@@ -99,7 +99,9 @@ async function askProfile(label) {
   console.log(`  ${dim('1')} base  ${dim('— TypeScript / Node.js')}`);
   console.log(`  ${dim('2')} react ${dim('— React / TSX')}`);
   console.log(`  ${dim('3')} api   ${dim('— HTTP API / Node.js servers')}`);
-  const choice = await ask(`  ${dim('[1/2/3, default: 1]')} `);
+  console.log(`  ${dim('n')} skip  ${dim('— keep existing / do not generate')}`);
+  const choice = await ask(`  ${dim('[1/2/3/n, default: 1]')} `);
+  if (choice === 'n') return null;
   return choice === '2' ? 'react' : choice === '3' ? 'api' : 'base';
 }
 
@@ -146,7 +148,7 @@ function generateSingleConfig(profile) {
   return `${imp}\nexport default [...${spread}]\n`;
 }
 
-async function writeEslintConfig() {
+async function writeEslintConfig(results) {
   const packages = await detectWorkspacePackages();
 
   let content;
@@ -158,12 +160,17 @@ async function writeEslintConfig() {
     for (const pkg of packages) {
       packageProfiles[pkg] = await askProfile(pkg);
     }
-    content     = generateMonorepoConfig(packageProfiles);
+    const activeProfiles = Object.fromEntries(
+      Object.entries(packageProfiles).filter(([, p]) => p !== null)
+    );
+    if (Object.keys(activeProfiles).length === 0) return;
+    content     = generateMonorepoConfig(activeProfiles);
     description = 'monorepo';
   } else {
     const profile = await askProfile('this project');
-    content       = generateSingleConfig(profile);
-    description   = `profile: ${profile}`;
+    if (profile === null) return;
+    content     = generateSingleConfig(profile);
+    description = `profile: ${profile}`;
   }
 
   try {
@@ -199,11 +206,17 @@ async function confirm(question) {
 
 // ─── Main ─────────────────────────────────────────────────────────────────────
 
-console.log();
-console.log(bold('  @tsfpp/agents — init'));
-console.log(dim('  Sets up Copilot agents, instructions, prompts, skills, and ESLint config.\n'));
+process.on('SIGINT', () => {
+  console.log('\n\n  Aborted.\n');
+  process.exit(0);
+});
 
-const results = { copied: [], skipped: [], failed: [] };
+async function main() {
+  console.log();
+  console.log(bold('  @tsfpp/agents — init'));
+  console.log(dim('  Sets up Copilot agents, instructions, prompts, skills, and ESLint config.\n'));
+
+  const results = { copied: [], skipped: [], failed: [] };
 
 // ── Copy files ────────────────────────────────────────────────────────────────
 
@@ -240,17 +253,21 @@ console.log();
 const eslintDest = join(cwd, 'eslint.config.js');
 
 if (existsSync(eslintDest)) {
-  const overwrite = await confirm(
-    `  ${yellow('!')} eslint.config.js already exists. Overwrite? ${dim('[y/N]')} `
-  );
-  if (!overwrite) {
+  if (yes) {
     results.skipped.push('eslint.config.js');
-    console.log(`  ${dim('–')} ${dim('eslint.config.js')} ${dim('(skipped)')}`);
+    console.log(`  ${dim('–')} ${dim('eslint.config.js')} ${dim('(skipped — project-managed)')}`);
   } else {
-    await writeEslintConfig();
+    const overwrite = await confirm(
+      `  ${yellow('!')} eslint.config.js already exists. Overwrite? ${dim('[y/N]')} `
+    );
+    if (overwrite) await writeEslintConfig(results);
+    else {
+      results.skipped.push('eslint.config.js');
+      console.log(`  ${dim('–')} ${dim('eslint.config.js')} ${dim('(skipped)')}`);
+    }
   }
 } else {
-  await writeEslintConfig();
+  await writeEslintConfig(results);
 }
 
 
@@ -259,9 +276,9 @@ if (existsSync(eslintDest)) {
 
 console.log();
 
-await writeTsConfigs(await detectWorkspacePackages());
+await writeTsConfigs(await detectWorkspacePackages(), results);
 
-async function writeTsConfigs(packages) {
+async function writeTsConfigs(packages, results) {
   const PRESETS = {
     app: { extends: '@tsfpp/tsconfig/app', label: 'app — application / tool (noEmit)' },
     lib: { extends: '@tsfpp/tsconfig/lib', label: 'lib — publishable package (declaration, composite)' },
@@ -271,7 +288,9 @@ async function writeTsConfigs(packages) {
     console.log(`\n  tsconfig preset for ${bold(label)}:`);
     console.log(`  ${dim('1')} app ${dim('— application / tool (noEmit: true)')}`);
     console.log(`  ${dim('2')} lib ${dim('— publishable package (declaration, composite)')}`);
-    const choice = await ask(`  ${dim('[1/2, default: 1]')} `);
+    console.log(`  ${dim('n')} skip ${dim('— keep existing / do not generate')}`);
+    const choice = await ask(`  ${dim('[1/2/n, default: 1]')} `);
+    if (choice === 'n') return null;
     return choice === '2' ? 'lib' : 'app';
   }
 
@@ -292,6 +311,11 @@ async function writeTsConfigs(packages) {
 
   async function writeIfConfirmed(destPath, content, label) {
     if (existsSync(destPath)) {
+      if (yes) {
+        results.skipped.push(label);
+        console.log(`  ${dim('–')} ${dim(label)} ${dim('(skipped — project-managed)')}`);
+        return;
+      }
       const overwrite = await confirm(
         `  ${yellow('!')} ${label} already exists. Overwrite? ${dim('[y/N]')} `
       );
@@ -321,6 +345,7 @@ async function writeTsConfigs(packages) {
     }
 
     for (const [pkg, preset] of Object.entries(packagePresets)) {
+      if (preset === null) continue;
       const destPath = join(cwd, pkg, 'tsconfig.json');
       const content  = generateTsConfig(preset);
       await writeIfConfirmed(destPath, content, `${pkg}/tsconfig.json`);
@@ -332,22 +357,26 @@ async function writeTsConfigs(packages) {
     await writeIfConfirmed(rootDest, rootContent, 'tsconfig.json (root references)');
   } else {
     // Single package
-    const preset  = await askPreset('this project');
+    const preset = await askPreset('this project');
+    if (preset === null) return;
     const dest    = join(cwd, 'tsconfig.json');
     const content = generateTsConfig(preset);
     await writeIfConfirmed(dest, content, 'tsconfig.json');
   }
 }
 
-console.log();
-console.log(dim('  ─────────────────────────────────────────'));
-console.log(`  ${green(results.copied.length + ' copied')}  ${yellow(results.skipped.length + ' skipped')}  ${results.failed.length > 0 ? `\x1b[31m${results.failed.length} failed\x1b[0m` : dim('0 failed')}`);
-console.log();
+  console.log();
+  console.log(dim('  ─────────────────────────────────────────'));
+  console.log(`  ${green(results.copied.length + ' copied')}  ${yellow(results.skipped.length + ' skipped')}  ${results.failed.length > 0 ? `\x1b[31m${results.failed.length} failed\x1b[0m` : dim('0 failed')}`);
+  console.log();
 
-if (results.failed.length === 0) {
-  console.log('  ' + bold('Done.') + ' Reload VS Code to activate Copilot instructions.');
-  console.log(dim('  Commit the generated files — they are workspace configuration.\n'));
-} else {
-  console.log('  Some files could not be copied. Check the errors above.\n');
-  process.exit(1);
+  if (results.failed.length === 0) {
+    console.log('  ' + bold('Done.') + ' Reload VS Code to activate Copilot instructions.');
+    console.log(dim('  Commit the generated files — they are workspace configuration.\n'));
+  } else {
+    console.log('  Some files could not be copied. Check the errors above.\n');
+    process.exit(1);
+  }
 }
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsfpp/agents",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Workspace AI tooling for TSF++ projects: scoped instructions, coding agents, and reusable prompts",
   "keywords": [
     "tsfpp",