@abarcenas/ai-workflow-template 1.39.0 → 1.40.0

package/bin/setup.js

@@ -13,6 +13,9 @@
 //   2 — Fatal error (discovery failure or unexpected exception)
 // ═════════════════════════════════════════════════════════════════════════════
 
+// Load consumer's .env into process.env before any phase runs
+import 'dotenv/config'
+
 try {
   const { main } = await import('../scripts/setup/index.js')
   const exitCode = await main(process.argv.slice(2))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abarcenas/ai-workflow-template",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "description": "A comprehensive template repository for AI-assisted development workflows using GitHub Copilot. This template provides a structured approach to leveraging AI assistance through pre-configured skills, prompts, agents, and coding standards.",
   "main": "index.js",
   "bin": {
@@ -57,14 +57,14 @@
   "devDependencies": {
     "@playwright/test": "^1.59.1",
     "@vitest/coverage-v8": "^4.1.8",
-    "dotenv": "^17.4.2",
     "husky": "^9.0.0",
     "vitest": "^4.1.8"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "better-sqlite3": "^12.11.0",
-    "sqlite-vec": "^0.1.9"
+    "sqlite-vec": "^0.1.9",
+    "dotenv": "^17.4.2"
   },
   "optionalDependencies": {
     "@xenova/transformers": "^2.17.0",

package/scripts/setup/constants.js

@@ -139,6 +139,7 @@ export const SUPPORTED_FLAGS = {
   '--skip-prepare': 'skipPrepare',
   '--skip-sync': 'skipSync',
   '--skip-knowledgebase': 'skipKnowledgebase',
+  '--knowledgebase': 'knowledgebase',
   '--help': 'help',
   '-h': 'help',
   '--version': 'version',

package/scripts/setup/index.js

@@ -141,6 +141,14 @@ export async function main(argv) {
     return EXIT_CODES.SUCCESS
   }
 
+  // When --knowledgebase is passed, run ONLY the knowledgebase phase
+  if (flags.knowledgebase) {
+    flags.skipHooks = true
+    flags.skipPrepare = true
+    flags.skipSync = true
+    flags.skipKnowledgebase = false
+  }
+
   // ── 3. Display header banner ────────────────────────────────────────────
   if (!flags.quiet) {
     header()

package/scripts/setup/index.test.js

@@ -116,6 +116,7 @@ const defaultFlags = {
   skipPrepare: false,
   skipSync: false,
   skipKnowledgebase: false,
+  knowledgebase: false,
   help: false,
   version: false,
   quiet: false,
@@ -549,6 +550,48 @@ describe('main() — setup orchestrator', () => {
     expect(registerKnowledgebase).toHaveBeenCalledTimes(1)
   })
 
+  // ── 16b. --knowledgebase flag (T6: run ONLY the knowledgebase phase) ─────
+
+  it('--knowledgebase: runs only discovery + knowledgebase phases, exits 0', async () => {
+    parseCliArgs.mockReturnValue({ ...defaultFlags, knowledgebase: true })
+
+    const code = await main(['--knowledgebase'])
+
+    expect(code).toBe(EXIT_CODES.SUCCESS)
+    expect(parseCliArgs).toHaveBeenCalledWith(['--knowledgebase'])
+    // Discovery always runs
+    expect(discover).toHaveBeenCalledTimes(1)
+    // All other phases are skipped by the --knowledgebase shortcut
+    expect(installHooks).not.toHaveBeenCalled()
+    expect(handlePrepare).not.toHaveBeenCalled()
+    expect(initHusky).not.toHaveBeenCalled()
+    expect(runSyncPhase).not.toHaveBeenCalled()
+    // Knowledgebase phase runs
+    expect(registerKnowledgebase).toHaveBeenCalledTimes(1)
+    // Header and summary shown (not quiet)
+    expect(header).toHaveBeenCalledTimes(1)
+    expect(summary).toHaveBeenCalledTimes(1)
+  })
+
+  it('--knowledgebase: still runs knowledgebase phase when skipKnowledgebase was also passed', async () => {
+    // --knowledgebase forces skipKnowledgebase back to false so the phase runs
+    parseCliArgs.mockReturnValue({
+      ...defaultFlags,
+      knowledgebase: true,
+      skipKnowledgebase: true,
+    })
+
+    const code = await main(['--knowledgebase', '--skip-knowledgebase'])
+
+    expect(code).toBe(EXIT_CODES.SUCCESS)
+    expect(discover).toHaveBeenCalledTimes(1)
+    expect(installHooks).not.toHaveBeenCalled()
+    expect(handlePrepare).not.toHaveBeenCalled()
+    expect(initHusky).not.toHaveBeenCalled()
+    expect(runSyncPhase).not.toHaveBeenCalled()
+    expect(registerKnowledgebase).toHaveBeenCalledTimes(1)
+  })
+
   // ── 17. Verify parseCliArgs receives the argv ───────────────────────────
 
   it('passes argv array to parseCliArgs unchanged', async () => {

package/scripts/setup/knowledgebase.js

@@ -63,8 +63,8 @@ export async function registerKnowledgebase(context) {
   // ── DATABASE_URL check ───────────────────────────────────────────────
   if (!process.env.DATABASE_URL) {
     const message =
-      'DATABASE_URL not configured. Set up later with: ' +
-      'npx ai-workflow-template setup --knowledgebase'
+      'DATABASE_URL not configured. Set DATABASE_URL in your .env file, ' +
+      'then re-run: npx @abarcenas/ai-workflow-template --knowledgebase'
     logWarn(
       `[knowledgebase] Skipping Phase 6 \u2014 ${message}`,
     )

package/scripts/setup/knowledgebase.test.js

@@ -161,8 +161,12 @@ describe('registerKnowledgebase', () => {
 
     expect(result).toEqual({
       action: 'skipped',
-      message: expect.stringContaining('DATABASE_URL'),
+      message: expect.stringContaining('DATABASE_URL not configured'),
     })
+    // The warning must guide the consumer to set DATABASE_URL and re-run
+    // with the scoped package name and the --knowledgebase flag.
+    expect(result.message).toContain('@abarcenas/ai-workflow-template')
+    expect(result.message).toContain('--knowledgebase')
     expect(spawn).not.toHaveBeenCalled()
   })
 

package/scripts/setup/ui.js

@@ -422,6 +422,8 @@ export function help() {
     skipHooks: 'Skip git hook installation phase',
     skipPrepare: 'Skip prepare script modification phase',
     skipSync: 'Skip file sync phase',
+    skipKnowledgebase: 'Skip knowledgebase registration phase',
+    knowledgebase: 'Run ONLY the knowledgebase registration phase',
     help: 'Show this help message and exit',
     version: 'Show the version number and exit',
     quiet: 'Suppress non-error output (quiet mode)',
@@ -435,6 +437,8 @@ export function help() {
     'skipHooks',
     'skipPrepare',
     'skipSync',
+    'skipKnowledgebase',
+    'knowledgebase',
     'help',
     'version',
     'quiet',
@@ -446,7 +450,7 @@ export function help() {
   write(`${BLD}${PACKAGE_NAME}${RST} ${GRN}v${version}${RST}`)
   write()
   write(`  ${BLD}Usage:${RST}`)
-  write(`    npx ${PACKAGE_NAME} setup [options]`)
+  write(`    npx ${PACKAGE_NAME} [options]`)
   write(`    ${BIN_NAME} [options]`)
   write()
   write(`  ${BLD}Description:${RST}`)
@@ -468,9 +472,10 @@ export function help() {
 
   write()
   write(`  ${BLD}Examples:${RST}`)
-  write(`    npx ${PACKAGE_NAME} setup`)
-  write(`    npx ${PACKAGE_NAME} setup --dry-run --verbose`)
-  write(`    npx ${PACKAGE_NAME} setup --force --skip-hooks`)
+  write(`    npx ${PACKAGE_NAME}`)
+  write(`    npx ${PACKAGE_NAME} --dry-run --verbose`)
+  write(`    npx ${PACKAGE_NAME} --knowledgebase`)
+  write(`    npx ${PACKAGE_NAME} --force --skip-hooks`)
   write(`    ${BIN_NAME} --help`)
   write()
 }