prjct-cli 1.6.4 → 1.6.6

package/CHANGELOG.md

@@ -1,11 +1,24 @@
 # Changelog
 
-## [1.6.4] - 2026-02-07
+## [1.6.6] - 2026-02-07
 
-### Bug Fixes
+### Refactoring
+
+- extract hardcoded values to constants (PRJ-71) (#129)
+
+
+## [1.6.8] - 2026-02-07
+
+### Refactor
+
+- **Extract hardcoded values to constants (PRJ-71)**: Added `OUTPUT_LIMITS`, `STORAGE_LIMITS`, `EVENT_LIMITS` to `core/constants/index.ts`. Replaced 16 magic numbers across `output.ts` (11 truncation lengths), `bus.ts` (history limit), and `jsonl-helper.ts` (max lines, rotation size, warning threshold). All limits now configurable from one place with `as const` typing.
+
+
+## [1.6.7] - 2026-02-07
 
-- add type guards for error handling (PRJ-79) (#127)
+### Refactor
 
+- **Extract common agent-base.md template (PRJ-95)**: Created `templates/subagents/agent-base.md` with shared project context (path resolution, storage locations, rules). Added `{{> partial }}` include resolution in `sync-service.ts` that resolves partials during agent generation. Updated all 9 agent templates (5 domain + 4 workflow) to use `{{> agent-base }}` instead of duplicated content. Saves ~200 tokens per additional agent template.
 
 ## [1.6.6] - 2026-02-07
 

package/core/bus/bus.ts

@@ -9,6 +9,7 @@
 
 import fs from 'node:fs/promises'
 import path from 'node:path'
+import { EVENT_LIMITS } from '../constants'
 import { getErrorMessage } from '../errors'
 import pathManager from '../infrastructure/path-manager'
 import {
@@ -45,7 +46,7 @@ class EventBus {
     this.listeners = new Map()
     this.onceListeners = new Map()
     this.history = []
-    this.historyLimit = 100
+    this.historyLimit = EVENT_LIMITS.HISTORY_MAX
     this.projectId = null
   }
 

package/core/constants/index.ts

@@ -264,6 +264,65 @@ export function getTimeout(key: TimeoutKey): number {
   return TIMEOUTS[key]
 }
 
+// =============================================================================
+// Output Limits (PRJ-71)
+// =============================================================================
+
+/**
+ * Truncation lengths for CLI output messages.
+ * Centralizes magic numbers from output.ts.
+ */
+export const OUTPUT_LIMITS = {
+  /** Spinner message truncation */
+  SPINNER_MSG: 45,
+  /** Done/success message truncation */
+  DONE_MSG: 50,
+  /** Fail message truncation */
+  FAIL_MSG: 65,
+  /** Warn message truncation */
+  WARN_MSG: 65,
+  /** Step counter message truncation */
+  STEP_MSG: 35,
+  /** Progress bar text truncation */
+  PROGRESS_TEXT: 25,
+  /** Issue title truncation in lists */
+  ISSUE_TITLE: 50,
+  /** Fallback truncation when tier config is 0 */
+  FALLBACK_TRUNCATE: 50,
+  /** Terminal clear width */
+  CLEAR_WIDTH: 80,
+} as const
+
+// =============================================================================
+// Storage Limits (PRJ-71)
+// =============================================================================
+
+/**
+ * File size and line limits for JSONL/storage operations.
+ * Centralizes magic numbers from jsonl-helper.ts.
+ */
+export const STORAGE_LIMITS = {
+  /** Default max lines for streaming JSONL reads */
+  JSONL_MAX_LINES: 1000,
+  /** File rotation threshold in MB */
+  ROTATION_SIZE_MB: 10,
+  /** Warning threshold for large files in MB */
+  LARGE_FILE_WARN_MB: 50,
+} as const
+
+// =============================================================================
+// Event Bus Limits (PRJ-71)
+// =============================================================================
+
+/**
+ * Event bus configuration limits.
+ * Centralizes magic numbers from bus.ts.
+ */
+export const EVENT_LIMITS = {
+  /** Max events kept in history */
+  HISTORY_MAX: 100,
+} as const
+
 // =============================================================================
 // Combined Exports
 // =============================================================================

package/core/services/sync-service.ts

@@ -666,6 +666,39 @@ class SyncService {
     return agents
   }
 
+  /**
+   * Resolve {{> partial-name }} includes in template content.
+   * Loads partials from templates/subagents/.
+   */
+  private async resolveTemplateIncludes(content: string): Promise<string> {
+    const includePattern = /\{\{>\s*([\w-]+)\s*\}\}/g
+    const matches = [...content.matchAll(includePattern)]
+
+    if (matches.length === 0) return content
+
+    let resolved = content
+    for (const match of matches) {
+      const partialName = match[1]
+      const partialPath = path.join(
+        __dirname,
+        '..',
+        '..',
+        'templates',
+        'subagents',
+        `${partialName}.md`
+      )
+      try {
+        const partialContent = await fs.readFile(partialPath, 'utf-8')
+        resolved = resolved.replace(match[0], partialContent.trim())
+      } catch {
+        // Partial not found — leave marker for debugging
+        resolved = resolved.replace(match[0], `<!-- partial "${partialName}" not found -->`)
+      }
+    }
+
+    return resolved
+  }
+
   private async generateWorkflowAgent(name: string, agentsPath: string): Promise<void> {
     // Try to read template
     let content = ''
@@ -680,6 +713,7 @@ class SyncService {
         `${name}.md`
       )
       content = await fs.readFile(templatePath, 'utf-8')
+      content = await this.resolveTemplateIncludes(content)
     } catch {
       // Generate minimal agent
       content = this.generateMinimalWorkflowAgent(name)
@@ -708,6 +742,9 @@ class SyncService {
       )
       content = await fs.readFile(templatePath, 'utf-8')
 
+      // Resolve includes before variable replacement
+      content = await this.resolveTemplateIncludes(content)
+
       // Inject project-specific context
       content = content.replace('{projectName}', stats.name)
       content = content.replace('{frameworks}', stack.frameworks.join(', ') || 'None detected')

package/core/utils/jsonl-helper.ts

@@ -2,6 +2,7 @@ import fsSync from 'node:fs'
 import fs from 'node:fs/promises'
 import path from 'node:path'
 import readline from 'node:readline'
+import { STORAGE_LIMITS } from '../constants'
 import { isNotFoundError } from '../types/fs'
 
 /**
@@ -171,7 +172,7 @@ export async function isJsonLinesEmpty(filePath: string): Promise<boolean> {
  */
 export async function readJsonLinesStreaming<T = Record<string, unknown>>(
   filePath: string,
-  maxLines = 1000
+  maxLines: number = STORAGE_LIMITS.JSONL_MAX_LINES
 ): Promise<T[]> {
   try {
     const fileStream = fsSync.createReadStream(filePath)
@@ -225,7 +226,10 @@ export async function getFileSizeMB(filePath: string): Promise<number> {
  * Rotate JSONL file if it exceeds size limit
  * Moves large file to archive with timestamp
  */
-export async function rotateJsonLinesIfNeeded(filePath: string, maxSizeMB = 10): Promise<boolean> {
+export async function rotateJsonLinesIfNeeded(
+  filePath: string,
+  maxSizeMB: number = STORAGE_LIMITS.ROTATION_SIZE_MB
+): Promise<boolean> {
   const sizeMB = await getFileSizeMB(filePath)
 
   if (sizeMB < maxSizeMB) {
@@ -256,7 +260,7 @@ export async function rotateJsonLinesIfNeeded(filePath: string, maxSizeMB = 10):
 export async function appendJsonLineWithRotation(
   filePath: string,
   object: unknown,
-  maxSizeMB = 10
+  maxSizeMB: number = STORAGE_LIMITS.ROTATION_SIZE_MB
 ): Promise<void> {
   // Rotate if needed (before appending)
   await rotateJsonLinesIfNeeded(filePath, maxSizeMB)
@@ -271,7 +275,7 @@ export async function appendJsonLineWithRotation(
  */
 export async function checkFileSizeWarning(
   filePath: string,
-  warnThresholdMB = 50
+  warnThresholdMB: number = STORAGE_LIMITS.LARGE_FILE_WARN_MB
 ): Promise<FileSizeWarning> {
   const sizeMB = await getFileSizeMB(filePath)
   const isLarge = sizeMB > warnThresholdMB

package/core/utils/output.ts

@@ -10,6 +10,7 @@
  */
 
 import chalk from 'chalk'
+import { OUTPUT_LIMITS } from '../constants'
 import branding from './branding'
 import type { ErrorCode, ErrorWithHint } from './error-messages'
 import { getError } from './error-messages'
@@ -100,7 +101,7 @@ export function isQuietMode(): boolean {
  * Truncate string to max chars (uses tier config if no max specified)
  */
 const truncate = (s: string | undefined | null, max?: number): string => {
-  const limit = max ?? (getTierConfig().maxCharsPerLine || 50)
+  const limit = max ?? (getTierConfig().maxCharsPerLine || OUTPUT_LIMITS.FALLBACK_TRUNCATE)
   return s && s.length > limit ? `${s.slice(0, limit - 1)}…` : s || ''
 }
 
@@ -156,7 +157,7 @@ export function formatForHuman(data: unknown): string {
     const issues = obj.issues as Array<Record<string, unknown>>
     const lines = issues.slice(0, tier.maxLines).map((i) => {
       const priority = i.priority && i.priority !== 'none' ? ` [${i.priority}]` : ''
-      return `${i.identifier}  ${truncate(String(i.title), 50)}${priority}`
+      return `${i.identifier}  ${truncate(String(i.title), OUTPUT_LIMITS.ISSUE_TITLE)}${priority}`
     })
     if (issues.length > tier.maxLines) {
       lines.push(chalk.dim(`...${issues.length - tier.maxLines} more`))
@@ -181,7 +182,7 @@ export function formatForHuman(data: unknown): string {
 }
 
 const clear = (): boolean =>
-  process.stdout.isTTY ? process.stdout.write(`\r${' '.repeat(80)}\r`) : true
+  process.stdout.isTTY ? process.stdout.write(`\r${' '.repeat(OUTPUT_LIMITS.CLEAR_WIDTH)}\r`) : true
 
 /**
  * Metrics to display after command completion
@@ -232,11 +233,13 @@ const out: Output = {
     if (quietMode) return this
     this.stop()
     if (!process.stdout.isTTY) {
-      process.stdout.write(`${branding.cli.spin(0, truncate(msg, 45))}\n`)
+      process.stdout.write(`${branding.cli.spin(0, truncate(msg, OUTPUT_LIMITS.SPINNER_MSG))}\n`)
       return this
     }
     interval = setInterval(() => {
-      process.stdout.write(`\r${branding.cli.spin(frame++, truncate(msg, 45))}`)
+      process.stdout.write(
+        `\r${branding.cli.spin(frame++, truncate(msg, OUTPUT_LIMITS.SPINNER_MSG))}`
+      )
     }, SPEED)
     return this
   },
@@ -255,7 +258,7 @@ const out: Output = {
           suffix = chalk.dim(` [${parts.join(' | ')}]`)
         }
       }
-      console.log(`${ICONS.success} ${truncate(msg, 50)}${suffix}`)
+      console.log(`${ICONS.success} ${truncate(msg, OUTPUT_LIMITS.DONE_MSG)}${suffix}`)
     }
     return this
   },
@@ -263,7 +266,7 @@ const out: Output = {
   // Errors go to stderr even in quiet mode
   fail(msg: string) {
     this.stop()
-    console.error(`${ICONS.fail} ${truncate(msg, 65)}`)
+    console.error(`${ICONS.fail} ${truncate(msg, OUTPUT_LIMITS.FAIL_MSG)}`)
     return this
   },
 
@@ -288,7 +291,7 @@ const out: Output = {
 
   warn(msg: string) {
     this.stop()
-    if (!quietMode) console.log(`${ICONS.warn} ${truncate(msg, 65)}`)
+    if (!quietMode) console.log(`${ICONS.warn} ${truncate(msg, OUTPUT_LIMITS.WARN_MSG)}`)
     return this
   },
 
@@ -400,11 +403,15 @@ const out: Output = {
     this.stop()
     const counter = chalk.dim(`[${current}/${total}]`)
     if (!process.stdout.isTTY) {
-      process.stdout.write(`${branding.cli.spin(0, `${counter} ${truncate(msg, 35)}`)}\n`)
+      process.stdout.write(
+        `${branding.cli.spin(0, `${counter} ${truncate(msg, OUTPUT_LIMITS.STEP_MSG)}`)}\n`
+      )
       return this
     }
     interval = setInterval(() => {
-      process.stdout.write(`\r${branding.cli.spin(frame++, `${counter} ${truncate(msg, 35)}`)}`)
+      process.stdout.write(
+        `\r${branding.cli.spin(frame++, `${counter} ${truncate(msg, OUTPUT_LIMITS.STEP_MSG)}`)}`
+      )
     }, SPEED)
     return this
   },
@@ -417,7 +424,7 @@ const out: Output = {
     const filled = Math.round(percent / 10)
     const empty = 10 - filled
     const bar = chalk.cyan('█'.repeat(filled)) + chalk.dim('░'.repeat(empty))
-    const text = msg ? ` ${truncate(msg, 25)}` : ''
+    const text = msg ? ` ${truncate(msg, OUTPUT_LIMITS.PROGRESS_TEXT)}` : ''
     if (!process.stdout.isTTY) {
       process.stdout.write(`${branding.cli.spin(0, `[${bar}] ${percent}%${text}`)}\n`)
       return this

package/dist/bin/prjct.mjs

@@ -2148,6 +2148,109 @@ var init_logger = __esm({
   }
 });
 
+// core/constants/index.ts
+function getTimeout(key) {
+  const envVar = `PRJCT_TIMEOUT_${key}`;
+  const envValue = process.env[envVar];
+  if (envValue) {
+    const parsed = Number.parseInt(envValue, 10);
+    if (!Number.isNaN(parsed) && parsed > 0) {
+      return parsed;
+    }
+  }
+  return TIMEOUTS[key];
+}
+var PLAN_STATUS, PLAN_REQUIRED_COMMANDS, DESTRUCTIVE_COMMANDS, PLANNING_TOOLS, TIMEOUTS, OUTPUT_LIMITS, STORAGE_LIMITS;
+var init_constants = __esm({
+  "core/constants/index.ts"() {
+    "use strict";
+    PLAN_STATUS = {
+      GATHERING: "gathering",
+      ANALYZING: "analyzing",
+      PROPOSING: "proposing",
+      PENDING_APPROVAL: "awaiting_approval",
+      APPROVED: "approved",
+      REJECTED: "rejected",
+      EXECUTING: "executing",
+      COMPLETED: "completed",
+      ABORTED: "aborted"
+    };
+    PLAN_REQUIRED_COMMANDS = [
+      "feature",
+      // New features need planning
+      "spec",
+      // Specs are planning by definition
+      "design",
+      // Architecture needs planning
+      "refactor",
+      // Refactoring needs impact analysis
+      "migrate"
+      // Migrations are high-risk
+    ];
+    DESTRUCTIVE_COMMANDS = [
+      "ship",
+      // Commits and pushes
+      "cleanup",
+      // Deletes files/code
+      "git",
+      // Git operations
+      "migrate"
+      // Database/schema changes
+    ];
+    PLANNING_TOOLS = [
+      "Read",
+      "Glob",
+      "Grep",
+      "GetTimestamp",
+      "GetDate",
+      "GetDateTime"
+    ];
+    TIMEOUTS = {
+      /** Tool availability checks (git --version, npm --version) */
+      TOOL_CHECK: 5e3,
+      /** Standard git operations (status, add, commit) */
+      GIT_OPERATION: 1e4,
+      /** Git clone with --depth 1 */
+      GIT_CLONE: 6e4,
+      /** HTTP fetch/API requests */
+      API_REQUEST: 3e4,
+      /** npm install -g (CLI installation) - 2 minutes */
+      NPM_INSTALL: 12e4,
+      /** User-defined workflow hooks */
+      WORKFLOW_HOOK: 6e4
+    };
+    __name(getTimeout, "getTimeout");
+    OUTPUT_LIMITS = {
+      /** Spinner message truncation */
+      SPINNER_MSG: 45,
+      /** Done/success message truncation */
+      DONE_MSG: 50,
+      /** Fail message truncation */
+      FAIL_MSG: 65,
+      /** Warn message truncation */
+      WARN_MSG: 65,
+      /** Step counter message truncation */
+      STEP_MSG: 35,
+      /** Progress bar text truncation */
+      PROGRESS_TEXT: 25,
+      /** Issue title truncation in lists */
+      ISSUE_TITLE: 50,
+      /** Fallback truncation when tier config is 0 */
+      FALLBACK_TRUNCATE: 50,
+      /** Terminal clear width */
+      CLEAR_WIDTH: 80
+    };
+    STORAGE_LIMITS = {
+      /** Default max lines for streaming JSONL reads */
+      JSONL_MAX_LINES: 1e3,
+      /** File rotation threshold in MB */
+      ROTATION_SIZE_MB: 10,
+      /** Warning threshold for large files in MB */
+      LARGE_FILE_WARN_MB: 50
+    };
+  }
+});
+
 // core/utils/branding.ts
 import chalk from "chalk";
 var SPINNER_FRAMES, SPINNER_SPEED, branding, branding_default;
@@ -2387,7 +2490,7 @@ function formatForHuman(data) {
     const issues = obj.issues;
     const lines = issues.slice(0, tier.maxLines).map((i) => {
       const priority = i.priority && i.priority !== "none" ? ` [${i.priority}]` : "";
-      return `${i.identifier}  ${truncate(String(i.title), 50)}${priority}`;
+      return `${i.identifier}  ${truncate(String(i.title), OUTPUT_LIMITS.ISSUE_TITLE)}${priority}`;
     });
     if (issues.length > tier.maxLines) {
       lines.push(chalk2.dim(`...${issues.length - tier.maxLines} more`));
@@ -2408,6 +2511,7 @@ var _FRAMES, SPEED, OUTPUT_TIERS, currentTier, ICONS, interval, frame, quietMode
 var init_output = __esm({
   "core/utils/output.ts"() {
     "use strict";
+    init_constants();
     init_branding();
     init_error_messages();
     init_error_messages();
@@ -2441,12 +2545,12 @@ var init_output = __esm({
     __name(setQuietMode, "setQuietMode");
     __name(isQuietMode, "isQuietMode");
     truncate = /* @__PURE__ */ __name((s, max) => {
-      const limit = max ?? (getTierConfig().maxCharsPerLine || 50);
+      const limit = max ?? (getTierConfig().maxCharsPerLine || OUTPUT_LIMITS.FALLBACK_TRUNCATE);
       return s && s.length > limit ? `${s.slice(0, limit - 1)}\u2026` : s || "";
     }, "truncate");
     __name(limitLines, "limitLines");
     __name(formatForHuman, "formatForHuman");
-    clear = /* @__PURE__ */ __name(() => process.stdout.isTTY ? process.stdout.write(`\r${" ".repeat(80)}\r`) : true, "clear");
+    clear = /* @__PURE__ */ __name(() => process.stdout.isTTY ? process.stdout.write(`\r${" ".repeat(OUTPUT_LIMITS.CLEAR_WIDTH)}\r`) : true, "clear");
     out = {
       // Branding: Show header at start
       start() {
@@ -2464,12 +2568,14 @@ var init_output = __esm({
         if (quietMode) return this;
         this.stop();
         if (!process.stdout.isTTY) {
-          process.stdout.write(`${branding_default.cli.spin(0, truncate(msg, 45))}
+          process.stdout.write(`${branding_default.cli.spin(0, truncate(msg, OUTPUT_LIMITS.SPINNER_MSG))}
 `);
           return this;
         }
         interval = setInterval(() => {
-          process.stdout.write(`\r${branding_default.cli.spin(frame++, truncate(msg, 45))}`);
+          process.stdout.write(
+            `\r${branding_default.cli.spin(frame++, truncate(msg, OUTPUT_LIMITS.SPINNER_MSG))}`
+          );
         }, SPEED);
         return this;
       },
@@ -2486,14 +2592,14 @@ var init_output = __esm({
               suffix = chalk2.dim(` [${parts.join(" | ")}]`);
             }
           }
-          console.log(`${ICONS.success} ${truncate(msg, 50)}${suffix}`);
+          console.log(`${ICONS.success} ${truncate(msg, OUTPUT_LIMITS.DONE_MSG)}${suffix}`);
         }
         return this;
       },
       // Errors go to stderr even in quiet mode
       fail(msg) {
         this.stop();
-        console.error(`${ICONS.fail} ${truncate(msg, 65)}`);
+        console.error(`${ICONS.fail} ${truncate(msg, OUTPUT_LIMITS.FAIL_MSG)}`);
         return this;
       },
       // Rich error with context and recovery hint
@@ -2516,7 +2622,7 @@ var init_output = __esm({
       },
       warn(msg) {
         this.stop();
-        if (!quietMode) console.log(`${ICONS.warn} ${truncate(msg, 65)}`);
+        if (!quietMode) console.log(`${ICONS.warn} ${truncate(msg, OUTPUT_LIMITS.WARN_MSG)}`);
         return this;
       },
       // Informational message
@@ -2612,12 +2718,16 @@ ${chalk2.bold(title)}`);
         this.stop();
         const counter = chalk2.dim(`[${current}/${total}]`);
         if (!process.stdout.isTTY) {
-          process.stdout.write(`${branding_default.cli.spin(0, `${counter} ${truncate(msg, 35)}`)}
-`);
+          process.stdout.write(
+            `${branding_default.cli.spin(0, `${counter} ${truncate(msg, OUTPUT_LIMITS.STEP_MSG)}`)}
+`
+          );
           return this;
         }
         interval = setInterval(() => {
-          process.stdout.write(`\r${branding_default.cli.spin(frame++, `${counter} ${truncate(msg, 35)}`)}`);
+          process.stdout.write(
+            `\r${branding_default.cli.spin(frame++, `${counter} ${truncate(msg, OUTPUT_LIMITS.STEP_MSG)}`)}`
+          );
         }, SPEED);
         return this;
       },
@@ -2629,7 +2739,7 @@ ${chalk2.bold(title)}`);
         const filled = Math.round(percent / 10);
         const empty = 10 - filled;
         const bar = chalk2.cyan("\u2588".repeat(filled)) + chalk2.dim("\u2591".repeat(empty));
-        const text = msg ? ` ${truncate(msg, 25)}` : "";
+        const text = msg ? ` ${truncate(msg, OUTPUT_LIMITS.PROGRESS_TEXT)}` : "";
         if (!process.stdout.isTTY) {
           process.stdout.write(`${branding_default.cli.spin(0, `[${bar}] ${percent}%${text}`)}
 `);
@@ -9589,7 +9699,7 @@ async function isJsonLinesEmpty(filePath) {
   const count = await countJsonLines(filePath);
   return count === 0;
 }
-async function readJsonLinesStreaming(filePath, maxLines = 1e3) {
+async function readJsonLinesStreaming(filePath, maxLines = STORAGE_LIMITS.JSONL_MAX_LINES) {
   try {
     const fileStream = fsSync.createReadStream(filePath);
     const rl = readline.createInterface({
@@ -9627,7 +9737,7 @@ async function getFileSizeMB(filePath) {
     throw error;
   }
 }
-async function rotateJsonLinesIfNeeded(filePath, maxSizeMB = 10) {
+async function rotateJsonLinesIfNeeded(filePath, maxSizeMB = STORAGE_LIMITS.ROTATION_SIZE_MB) {
   const sizeMB = await getFileSizeMB(filePath);
   if (sizeMB < maxSizeMB) {
     return false;
@@ -9643,11 +9753,11 @@ async function rotateJsonLinesIfNeeded(filePath, maxSizeMB = 10) {
   );
   return true;
 }
-async function appendJsonLineWithRotation(filePath, object, maxSizeMB = 10) {
+async function appendJsonLineWithRotation(filePath, object, maxSizeMB = STORAGE_LIMITS.ROTATION_SIZE_MB) {
   await rotateJsonLinesIfNeeded(filePath, maxSizeMB);
   await appendJsonLine(filePath, object);
 }
-async function checkFileSizeWarning(filePath, warnThresholdMB = 50) {
+async function checkFileSizeWarning(filePath, warnThresholdMB = STORAGE_LIMITS.LARGE_FILE_WARN_MB) {
   const sizeMB = await getFileSizeMB(filePath);
   const isLarge = sizeMB > warnThresholdMB;
   if (isLarge) {
@@ -9661,6 +9771,7 @@ var jsonl_helper_default;
 var init_jsonl_helper = __esm({
   "core/utils/jsonl-helper.ts"() {
     "use strict";
+    init_constants();
     init_fs();
     __name(parseJsonLines, "parseJsonLines");
     __name(stringifyJsonLines, "stringifyJsonLines");
@@ -12843,81 +12954,6 @@ var init_orchestrator_executor = __esm({
   }
 });
 
-// core/constants/index.ts
-function getTimeout(key) {
-  const envVar = `PRJCT_TIMEOUT_${key}`;
-  const envValue = process.env[envVar];
-  if (envValue) {
-    const parsed = Number.parseInt(envValue, 10);
-    if (!Number.isNaN(parsed) && parsed > 0) {
-      return parsed;
-    }
-  }
-  return TIMEOUTS[key];
-}
-var PLAN_STATUS, PLAN_REQUIRED_COMMANDS, DESTRUCTIVE_COMMANDS, PLANNING_TOOLS, TIMEOUTS;
-var init_constants = __esm({
-  "core/constants/index.ts"() {
-    "use strict";
-    PLAN_STATUS = {
-      GATHERING: "gathering",
-      ANALYZING: "analyzing",
-      PROPOSING: "proposing",
-      PENDING_APPROVAL: "awaiting_approval",
-      APPROVED: "approved",
-      REJECTED: "rejected",
-      EXECUTING: "executing",
-      COMPLETED: "completed",
-      ABORTED: "aborted"
-    };
-    PLAN_REQUIRED_COMMANDS = [
-      "feature",
-      // New features need planning
-      "spec",
-      // Specs are planning by definition
-      "design",
-      // Architecture needs planning
-      "refactor",
-      // Refactoring needs impact analysis
-      "migrate"
-      // Migrations are high-risk
-    ];
-    DESTRUCTIVE_COMMANDS = [
-      "ship",
-      // Commits and pushes
-      "cleanup",
-      // Deletes files/code
-      "git",
-      // Git operations
-      "migrate"
-      // Database/schema changes
-    ];
-    PLANNING_TOOLS = [
-      "Read",
-      "Glob",
-      "Grep",
-      "GetTimestamp",
-      "GetDate",
-      "GetDateTime"
-    ];
-    TIMEOUTS = {
-      /** Tool availability checks (git --version, npm --version) */
-      TOOL_CHECK: 5e3,
-      /** Standard git operations (status, add, commit) */
-      GIT_OPERATION: 1e4,
-      /** Git clone with --depth 1 */
-      GIT_CLONE: 6e4,
-      /** HTTP fetch/API requests */
-      API_REQUEST: 3e4,
-      /** npm install -g (CLI installation) - 2 minutes */
-      NPM_INSTALL: 12e4,
-      /** User-defined workflow hooks */
-      WORKFLOW_HOOK: 6e4
-    };
-    __name(getTimeout, "getTimeout");
-  }
-});
-
 // core/agentic/plan-mode.ts
 function generateApprovalPrompt(commandName, context2) {
   const prompts3 = {
@@ -22761,6 +22797,34 @@ var init_sync_service = __esm({
         }
         return agents;
       }
+      /**
+       * Resolve {{> partial-name }} includes in template content.
+       * Loads partials from templates/subagents/.
+       */
+      async resolveTemplateIncludes(content) {
+        const includePattern = /\{\{>\s*([\w-]+)\s*\}\}/g;
+        const matches = [...content.matchAll(includePattern)];
+        if (matches.length === 0) return content;
+        let resolved = content;
+        for (const match of matches) {
+          const partialName = match[1];
+          const partialPath = path49.join(
+            __dirname,
+            "..",
+            "..",
+            "templates",
+            "subagents",
+            `${partialName}.md`
+          );
+          try {
+            const partialContent = await fs45.readFile(partialPath, "utf-8");
+            resolved = resolved.replace(match[0], partialContent.trim());
+          } catch {
+            resolved = resolved.replace(match[0], `<!-- partial "${partialName}" not found -->`);
+          }
+        }
+        return resolved;
+      }
       async generateWorkflowAgent(name, agentsPath) {
         let content = "";
         try {
@@ -22774,6 +22838,7 @@ var init_sync_service = __esm({
             `${name}.md`
           );
           content = await fs45.readFile(templatePath, "utf-8");
+          content = await this.resolveTemplateIncludes(content);
         } catch {
           content = this.generateMinimalWorkflowAgent(name);
         }
@@ -22792,6 +22857,7 @@ var init_sync_service = __esm({
             `${name}.md`
           );
           content = await fs45.readFile(templatePath, "utf-8");
+          content = await this.resolveTemplateIncludes(content);
           content = content.replace("{projectName}", stats.name);
           content = content.replace("{frameworks}", stack.frameworks.join(", ") || "None detected");
           content = content.replace("{ecosystem}", stats.ecosystem);
@@ -28653,7 +28719,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "1.6.4",
+      version: "1.6.6",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {

package/templates/subagents/agent-base.md

@@ -0,0 +1,20 @@
+## prjct Project Context
+
+### Setup
+1. Read `.prjct/prjct.config.json` → extract `projectId`
+2. Set `globalPath = ~/.prjct-cli/projects/{projectId}`
+
+### Available Storage
+
+| File | Contents |
+|------|----------|
+| `{globalPath}/storage/state.json` | Current task & subtasks |
+| `{globalPath}/storage/queue.json` | Task queue |
+| `{globalPath}/storage/shipped.json` | Shipping history |
+| `{globalPath}/storage/roadmap.json` | Feature roadmap |
+
+### Rules
+- Storage (JSON) is **SOURCE OF TRUTH**
+- Context (MD) is **GENERATED** from storage
+- NEVER hardcode timestamps — use system time
+- Log significant actions to `{globalPath}/memory/events.jsonl`

package/templates/subagents/domain/backend.md

@@ -16,7 +16,9 @@ You are a backend specialist agent for this project.
 - **APIs**: REST, GraphQL, gRPC, WebSockets
 - **Auth**: JWT, OAuth, Sessions, API Keys
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's backend stack:
 1. Read `package.json`, `go.mod`, `requirements.txt`, or `Cargo.toml`

package/templates/subagents/domain/database.md

@@ -15,7 +15,9 @@ You are a database specialist agent for this project.
 - **ORMs**: Prisma, Drizzle, TypeORM, Sequelize, GORM
 - **Migrations**: Schema changes, data migrations
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's database setup:
 1. Check for ORM config (prisma/schema.prisma, drizzle.config.ts)

package/templates/subagents/domain/devops.md

@@ -16,7 +16,9 @@ You are a DevOps specialist agent for this project.
 - **CI/CD**: GitHub Actions, GitLab CI, Jenkins
 - **Cloud**: AWS, GCP, Azure, Vercel, Railway
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's DevOps setup:
 1. Check for Dockerfile, docker-compose.yml

package/templates/subagents/domain/frontend.md

@@ -16,7 +16,9 @@ You are a frontend specialist agent for this project.
 - **State**: Redux, Zustand, Pinia, Context API
 - **Build**: Vite, webpack, esbuild, Turbopack
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's frontend stack:
 1. Read `package.json` for dependencies

package/templates/subagents/domain/testing.md

@@ -17,7 +17,9 @@ You are a testing specialist agent for this project.
 - **Go**: testing package, testify
 - **E2E**: Playwright, Cypress, Puppeteer
 
-## Project Context
+{{> agent-base }}
+
+## Domain Analysis
 
 When invoked, analyze the project's testing setup:
 1. Check for test config (bunfig.toml, jest.config.js, pytest.ini)

package/templates/subagents/workflow/chief-architect.md

@@ -13,13 +13,12 @@ You are the Chief Architect agent, the expert in creating Product Requirement Do
 
 You are responsible for ensuring every significant feature is properly documented BEFORE implementation begins. You follow a formal 8-phase methodology adapted from industry best practices.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/roadmap.json` → existing features
-3. Read `~/.prjct-cli/projects/{projectId}/storage/prds.json` → existing PRDs
-4. Read `~/.prjct-cli/projects/{projectId}/analysis/repo-analysis.json` → project tech stack
+When invoked, load these storage files:
+- `roadmap.json` → existing features
+- `prds.json` → existing PRDs
+- `analysis/repo-analysis.json` → project tech stack
 
 ## Commands You Handle
 

package/templates/subagents/workflow/prjct-planner.md

@@ -9,13 +9,12 @@ skills: [feature-dev]
 
 You are the prjct planning agent, specializing in feature planning and task breakdown.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
-3. Read `~/.prjct-cli/projects/{projectId}/storage/queue.json` → task queue
-4. Read `~/.prjct-cli/projects/{projectId}/storage/roadmap.json` → feature roadmap
+When invoked, load these storage files:
+- `state.json` → current task state
+- `queue.json` → task queue
+- `roadmap.json` → feature roadmap
 
 ## Commands You Handle
 

package/templates/subagents/workflow/prjct-shipper.md

@@ -9,12 +9,11 @@ skills: [code-review]
 
 You are the prjct shipper agent, specializing in shipping features safely.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
-3. Read `~/.prjct-cli/projects/{projectId}/storage/shipped.json` → shipping history
+When invoked, load these storage files:
+- `state.json` → current task state
+- `shipped.json` → shipping history
 
 ## Commands You Handle
 

package/templates/subagents/workflow/prjct-workflow.md

@@ -8,12 +8,11 @@ effort: low
 
 You are the prjct workflow executor, specializing in task lifecycle management.
 
-## Project Context
+{{> agent-base }}
 
-When invoked, FIRST load context:
-1. Read `.prjct/prjct.config.json` → extract `projectId`
-2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
-3. Read `~/.prjct-cli/projects/{projectId}/storage/queue.json` → task queue
+When invoked, load these storage files:
+- `state.json` → current task state
+- `queue.json` → task queue
 
 ## Commands You Handle