@tsfpp/agents 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -10,6 +10,36 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+### Features
+
+- `feat(agents): improve init and bootstrap release workflow` - Installer setup now merges Copilot instructions safely, initializes release manifest metadata, and includes bootstrap scripts in package outputs.
+
+## [1.6.0] - 2026-05-18
+
+### Features
+
+- **agents:** improve init and bootstrap release workflow ([`916cf76`](https://github.com/tsfpp/agents/commit/916cf76c584026df148dacd6507bca6b8c2dfafb))
+- **agents:** improve init and bootstrap release workflow ([`954b4c4`](https://github.com/tsfpp/agents/commit/954b4c454f77c8ce59357dde09f25f74f8c1d19d))
+- **release:** add config/log standards and bump to v1.5.0 ([`71d678b`](https://github.com/tsfpp/agents/commit/71d678b7e10f444082f318921061580f69605c47))
+- add annotation standard skill and align agents ([`8a05614`](https://github.com/tsfpp/agents/commit/8a056145ad5c5d0d50484302f61578c83c64d472))
+- add test backfill agent and tighten guidance ([`14ff506`](https://github.com/tsfpp/agents/commit/14ff506d6f37073e95c7aa65c7c4321ef59eee29))
+- release v1.3.0 with expanded coding and testing guidance ([`65ec6d0`](https://github.com/tsfpp/agents/commit/65ec6d00224f9cb4950b2d672685ae83a7324197))
+- add trunk workflow assets and bump version to 1.2.0 ([`6382624`](https://github.com/tsfpp/agents/commit/6382624b3bc4d8447cfcf6fccb58572897dea956))
+- add Copilot skills deployment and bump to 1.1.0 ([`53f223f`](https://github.com/tsfpp/agents/commit/53f223f57bf9ea4d394aea49969d877fb3582646))
+
+### Bug fixes
+
+- resolve init.mjs duplicate symbol bug ([`083d1f5`](https://github.com/tsfpp/agents/commit/083d1f50e8d19e1dd1675fc29ca4fe467624073c))
+- release v1.3.1 with test skill and init updates ([`eab0c9a`](https://github.com/tsfpp/agents/commit/eab0c9a93698634cd9820cf1de7aca5a1bf065a4))
+- **release:** switch audit update to patch v1.2.3 ([`f75de64`](https://github.com/tsfpp/agents/commit/f75de6413cb6681eeedbef1ffe7825da530304ef))
+- harden init questionnaire idempotency and ctrl-c handling ([`63a99fd`](https://github.com/tsfpp/agents/commit/63a99fd10bf80cd45a30b4b934c460aeac9ee1dc))
+- resolve init eslint declaration idempotency bug ([`e0b2c17`](https://github.com/tsfpp/agents/commit/e0b2c173c136b849718e6c5982e0ca646b30e6c0))
+- bump patch release for bootstrap script packaging ([`3ac6a53`](https://github.com/tsfpp/agents/commit/3ac6a5334c1dc77e7469cd2adea0f278b41fd071))
+- normalize agent names and bump patch release ([`d4e097b`](https://github.com/tsfpp/agents/commit/d4e097bf4221497ecfabf405da66dbc7c6588dcb))
+- **release:** standard spec paths and init eslint/tsconfig setup ([`4193964`](https://github.com/tsfpp/agents/commit/419396451c48e0a226393acc770e5d0b8296c2ee))
+- **release:** prepare 1.0.1 patch ([`96f0d33`](https://github.com/tsfpp/agents/commit/96f0d3343d1b2533109e57fb2ec0055a5fd18ffc))
+- **ci:** quote workflow trigger key ([`47baf47`](https://github.com/tsfpp/agents/commit/47baf4708d6480636083018dd84074a10ec26851))
+
 ## [1.5.0] - 2026-05-18
 
 ### Added
@@ -231,3 +261,6 @@ Versioning follows [Semantic Versioning](https://semver.org/).
   - `.github/workflows/release-please.yml`
   - `release-please-config.json`
   - `.release-please-manifest.json`
+
+[Unreleased]: https://github.com/tsfpp/agents/compare/v1.6.0...HEAD
+[1.6.0]: https://github.com/tsfpp/agents/compare/v1.5.0...v1.6.0

package/bin/bootstrap.sh

@@ -80,11 +80,22 @@ ok "eslint.config.js"
 
 dim "Patching package.json…"
 npm pkg set type="module"                           --silent
+npm pkg set version="0.1.0"                         --silent
 npm pkg set scripts.typecheck="tsc --noEmit"        --silent
 npm pkg set scripts.lint="eslint src"               --silent
 npm pkg set scripts.check="pnpm typecheck && pnpm lint" --silent
 ok "package.json scripts"
 
+# ── 6b. release-please-manifest.json ─────────────────────────────────────────
+
+if [[ ! -f release-please-manifest.json ]]; then
+  dim "Writing release-please-manifest.json…"
+  echo '{ ".": "0.1.0" }' > release-please-manifest.json
+  ok "release-please-manifest.json"
+else
+  ok "release-please-manifest.json already exists — skipping"
+fi
+
 # ── 7. src/index.ts ───────────────────────────────────────────────────────────
 
 dim "Creating src/index.ts…"

package/init.mjs

@@ -10,8 +10,9 @@
  *   node node_modules/@tsfpp/agents/init.mjs --yes    (non-interactive / postinstall)
  *
  * --yes mode: copies all package-managed files (agents, instructions, skills,
- * prompts, copilot-instructions.md) without prompting. Skips eslint.config.js
- * and tsconfig.json — those are workspace-owned and never touched automatically.
+ * prompts) without prompting. Merges TSF++ content into copilot-instructions.md
+ * (preserving existing content). Deploys tsfpp.md into .claude/ (not CLAUDE.md).
+ * Skips eslint.config.js and tsconfig.json — workspace-owned and never touched.
  */
 
 import { copyFile, mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
@@ -34,8 +35,8 @@ const bold   = (s) => `\x1b[1m${s}\x1b[0m`;
 // All entries are package-managed — always overwritten in --yes mode.
 
 const FILES = [
-  // Always-on workspace instructions
-  ['copilot/copilot-instructions.md',                        '.github/copilot-instructions.md'],
+  // Always-on workspace instructions — merged, not overwritten (see mergeCopilotInstructions below)
+  // copilot-instructions.md handled separately
 
   // Scoped instruction files
   ['copilot/instructions/tsfpp-base.instructions.md',        '.github/instructions/tsfpp-base.instructions.md'],
@@ -69,8 +70,8 @@ const FILES = [
   ['copilot/skills/log-standard/SKILL.md',                  '.github/skills/log-standard/SKILL.md'],
   ['copilot/skills/config-standard/SKILL.md',               '.github/skills/config-standard/SKILL.md'],
 
-  // Claude Code
-  ['claude/CLAUDE.md',                                        '.claude/CLAUDE.md'],
+  // Claude Code — deployed as tsfpp.md, not CLAUDE.md, to avoid overwriting project context
+  ['claude/CLAUDE.md',                                        '.claude/tsfpp.md'],
 ];
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────
@@ -272,6 +273,60 @@ async function writeTsConfigs(results) {
   }
 }
 
+
+// ─── Copilot instructions merge ───────────────────────────────────────────────
+
+const TSFPP_BEGIN = '<!-- TSF++ BEGIN — managed by @tsfpp/agents, do not edit manually -->';
+const TSFPP_END   = '<!-- TSF++ END -->';
+
+async function mergeCopilotInstructions(results) {
+  const srcPath  = join(__dirname, 'copilot/copilot-instructions.md');
+  const destPath = join(cwd, '.github/copilot-instructions.md');
+
+  if (!existsSync(srcPath)) {
+    results.skipped.push('.github/copilot-instructions.md');
+    console.log(`  ${dim('–')} ${dim('.github/copilot-instructions.md')} ${dim('(source not found — skipped)')}`);
+    return;
+  }
+
+  const tsfppContent = await readFile(srcPath, 'utf8');
+  const block = `${TSFPP_BEGIN}\n${tsfppContent.trim()}\n${TSFPP_END}`;
+
+  try {
+    await ensureDir(destPath);
+
+    if (!existsSync(destPath)) {
+      // No existing file — create it with the TSF++ block
+      await writeFile(destPath, block + '\n', 'utf8');
+      results.copied.push('.github/copilot-instructions.md');
+      console.log(`  ${green('✓')} .github/copilot-instructions.md ${dim('(created)')}`);
+      return;
+    }
+
+    const existing = await readFile(destPath, 'utf8');
+    const beginIdx = existing.indexOf(TSFPP_BEGIN);
+    const endIdx   = existing.indexOf(TSFPP_END);
+
+    if (beginIdx !== -1 && endIdx !== -1) {
+      // Replace existing TSF++ block
+      const before = existing.slice(0, beginIdx);
+      const after  = existing.slice(endIdx + TSFPP_END.length);
+      await writeFile(destPath, before + block + after, 'utf8');
+      results.copied.push('.github/copilot-instructions.md');
+      console.log(`  ${green('✓')} .github/copilot-instructions.md ${dim('(TSF++ section updated)')}`);
+    } else {
+      // Existing file with no TSF++ block — append
+      const separator = existing.endsWith('\n') ? '\n' : '\n\n';
+      await writeFile(destPath, existing + separator + block + '\n', 'utf8');
+      results.copied.push('.github/copilot-instructions.md');
+      console.log(`  ${green('✓')} .github/copilot-instructions.md ${dim('(TSF++ section appended)')}`);
+    }
+  } catch (err) {
+    results.failed.push('.github/copilot-instructions.md');
+    console.log(`  \x1b[31m✗\x1b[0m .github/copilot-instructions.md ${dim(`(${err.message})`)}`);
+  }
+}
+
 // ─── Main ─────────────────────────────────────────────────────────────────────
 
 async function main() {
@@ -319,6 +374,10 @@ async function main() {
     }
   }
 
+  // ── Copilot instructions merge ───────────────────────────────────────────────
+
+  await mergeCopilotInstructions(results);
+
   // ── ESLint (interactive only) ──────────────────────────────────────────────
 
   if (!YES) {
@@ -355,6 +414,7 @@ async function main() {
 
   if (results.failed.length === 0) {
     console.log('  ' + bold('Done.') + ' Reload VS Code to activate Copilot instructions.');
+    console.log(dim('  Claude Code context available at .claude/tsfpp.md — add @tsfpp to your CLAUDE.md to activate.'));
     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');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsfpp/agents",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Workspace AI tooling for TSF++ projects: scoped instructions, coding agents, and reusable prompts",
   "keywords": [
     "tsfpp",
@@ -29,6 +29,7 @@
     "tsfpp-bootstrap": "./bin/bootstrap.sh"
   },
   "files": [
+    "bin/",
     "copilot/",
     "claude/",
     "init.mjs",