@ryuenn3123/agentic-senior-core 2.0.19 → 2.0.20

package/lib/cli/templates/flow-overview.md.tmpl

@@ -0,0 +1,119 @@
+# Flow Overview: {{projectName}}
+
+Generated by Agentic-Senior-Core CLI v{{cliVersion}}
+Generated at: {{generatedAt}}
+Template version: 1.0.0
+
+---
+
+## System Overview
+
+**Project**: {{projectName}}
+**Domain**: {{primaryDomain}}
+**Stack**: {{stackDisplayName}}
+**Blueprint**: {{blueprintDisplayName}}
+
+## High-Level Architecture
+
+```
+┌─────────────┐     ┌──────────────┐     ┌──────────────┐
+│   Client    │────>│  Transport   │────>│   Service    │
+│  (Browser/  │<────│   Layer      │<────│   Layer      │
+│   Mobile/   │     │  (Routes/    │     │  (Business   │
+│   CLI)      │     │   Handlers)  │     │   Logic)     │
+└─────────────┘     └──────────────┘     └──────┬───────┘
+                                                │
+                                         ┌──────▼───────┐
+                                         │  Repository  │
+                                         │   Layer      │
+                                         │  (Data       │
+                                         │   Access)    │
+                                         └──────┬───────┘
+                                                │
+                                         ┌──────▼───────┐
+                                         │  Database    │
+                                         │  {{databaseChoice}}
+                                         └──────────────┘
+```
+
+## Request Flow
+
+### Standard Request Lifecycle
+
+1. **Client** sends HTTP request (or CLI input, or event trigger).
+2. **Transport layer** receives the request, validates input format, and routes to the correct handler.
+3. **Service layer** applies business logic, orchestrates domain operations, and enforces rules.
+4. **Repository layer** performs data access (read/write to database or external service).
+5. **Response** flows back through Service to Transport to Client.
+
+### Layer Responsibilities
+
+| Layer | Does | Does NOT |
+|-------|------|----------|
+| Transport | Parse input, validate shape, route, format response | Contain business logic, access database |
+| Service | Business rules, orchestration, domain validation | Parse HTTP, format responses, run SQL |
+| Repository | Data access, query construction, caching | Business logic, input validation |
+
+{{#if hasAuth}}
+## Authentication Flow
+
+```
+┌────────┐     ┌───────────┐     ┌──────────┐     ┌──────────┐
+│ Client │────>│  Auth     │────>│  Token   │────>│ Protected│
+│        │     │  Endpoint │     │  Verify  │     │ Resource │
+│        │<────│           │<────│  ({{authStrategy}}) │<────│          │
+└────────┘     └───────────┘     └──────────┘     └──────────┘
+```
+
+1. Client sends credentials to auth endpoint.
+2. Service validates credentials against stored data.
+3. On success, service issues a {{authStrategy}} token.
+4. Client includes token in subsequent requests.
+5. Middleware verifies token before forwarding to protected handlers.
+
+{{/if}}
+## Feature Flows
+
+For each key feature, define the data and control flow:
+
+{{#each features}}
+### {{this}}
+
+**Actors**: [define who initiates this flow]
+**Trigger**: [define what starts this flow]
+**Steps**:
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+**Success outcome**: [what happens when the flow completes]
+**Error handling**: [what happens on failure]
+
+---
+
+{{/each}}
+
+## Data Flow Diagram
+
+```
+  Input Data                Processing              Output
+  ──────────              ──────────              ──────────
+                    ┌───────────────────┐
+  User Input ──────>│   Validation      │
+                    │   (Transport)     │
+                    └────────┬──────────┘
+                             │
+                    ┌────────▼──────────┐
+                    │   Business Logic  │
+                    │   (Service)       │
+                    └────────┬──────────┘
+                             │
+                    ┌────────▼──────────┐
+                    │   Data Persist    │───────> Stored Data
+                    │   (Repository)    │
+                    └───────────────────┘
+```
+
+---
+
+This document is a living reference. Update flows as features are implemented and refined.

package/lib/cli/templates/project-brief.md.tmpl

@@ -0,0 +1,53 @@
+# Project Brief: {{projectName}}
+
+Generated by Agentic-Senior-Core CLI v{{cliVersion}}
+Generated at: {{generatedAt}}
+Template version: 1.0.0
+
+---
+
+## Overview
+
+**Project name**: {{projectName}}
+**Description**: {{projectDescription}}
+**Primary domain**: {{primaryDomain}}
+
+## Technology Decisions
+
+**Stack**: {{stackDisplayName}}
+**Blueprint**: {{blueprintDisplayName}}
+**Database**: {{databaseChoice}}
+**Auth strategy**: {{authStrategy}}
+
+## Key Features
+
+{{#each features}}
+- {{this}}
+{{/each}}
+
+## Additional Context
+
+{{additionalContext}}
+
+## Constraints and Assumptions
+
+- This project follows the governance rules defined in `.agent-context/rules/`.
+- Stack conventions are defined in `.agent-context/stacks/{{stackFileName}}`.
+- Architecture patterns follow `.agent-context/blueprints/{{blueprintFileName}}`.
+- All code must pass the review checklist at `.agent-context/review-checklists/pr-checklist.md`.
+
+## Goals
+
+1. Deliver a working {{primaryDomain}} using the {{stackDisplayName}} stack.
+2. Follow production-grade engineering standards from day one.
+3. Keep architecture decisions documented and traceable.
+
+## Non-Goals (Initial Scope)
+
+- Performance optimization beyond sensible defaults.
+- Multi-region deployment.
+- Advanced analytics or reporting.
+
+---
+
+This document is a living reference. Update it as the project scope evolves.

package/lib/cli/utils.mjs

@@ -28,7 +28,7 @@ export function printUsage() {
   console.log('');
   console.log('Usage:');
   console.log('  agentic-senior-core launch');
-  console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--profile <beginner|balanced|strict>] [--profile-pack <name>] [--stack <name>] [--blueprint <name>] [--ci <true|false>] [--newbie] [--token-optimize] [--no-token-optimize] [--token-agent <name>]');
+  console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--profile <beginner|balanced|strict>] [--profile-pack <name>] [--stack <name>] [--blueprint <name>] [--ci <true|false>] [--newbie] [--token-optimize] [--no-token-optimize] [--token-agent <name>] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>]');
   console.log('  agentic-senior-core upgrade [target-directory] [--dry-run] [--yes] [--mcp-template]');
   console.log('  agentic-senior-core optimize [target-directory] [--agent <copilot|claude|cursor|windsurf|gemini|codex|cline>] [--enable|--disable] [--show]');
   console.log('  agentic-senior-core mcp');
@@ -50,6 +50,10 @@ export function printUsage() {
   console.log('  --token-agent     Set token optimization agent target (copilot, claude, cursor, windsurf, gemini, codex, cline)');
   console.log('  --no-token-optimize  Disable token optimization policy during init');
   console.log('  --mcp-template   Create .vscode/mcp.json workspace template (MCP trust/start remains manual in IDE)');
+  console.log('  --scaffold-docs  Force project documentation scaffolding (architecture, database, API, flow)');
+  console.log('  --no-scaffold-docs  Skip project documentation scaffolding');
+  console.log('  --docs-lang      Language for generated project docs (en, id; default: en)');
+  console.log('  --project-config Path to a project config file for non-interactive doc scaffolding');
   console.log('  --dry-run    Preview upgrade without writing files');
   console.log('  --yes        Skip confirmation prompts for upgrade');
   console.log('  --agent      Target agent integration for token optimization mode');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "2.0.19",
+  "version": "2.0.20",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
@@ -57,4 +57,4 @@
     "validate": "node ./scripts/validate.mjs",
     "test": "node --test ./tests/cli-smoke.test.mjs ./tests/mcp-server.test.mjs ./tests/llm-judge.test.mjs ./tests/enterprise-ops.test.mjs ./tests/skill-tier-gate.test.mjs"
   }
-}
+}

package/scripts/bump-version.mjs

@@ -0,0 +1,101 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.resolve(__dirname, '..');
+
+async function fileExists(filePath) {
+  try {
+    await fs.stat(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function readTextFile(filePath) {
+  return fs.readFile(filePath, 'utf8');
+}
+
+async function writeTextFile(filePath, content) {
+  return fs.writeFile(filePath, content, 'utf8');
+}
+
+async function bumpVersion() {
+  const newVersion = process.argv[2];
+  if (!newVersion || !/^\d+\.\d+\.\d+$/.test(newVersion)) {
+    console.error('Usage: node scripts/bump-version.mjs <new-version>');
+    console.error('Example: node scripts/bump-version.mjs 2.1.0');
+    process.exit(1);
+  }
+
+  console.log(`Starting version bump to ${newVersion}...`);
+
+  // 1. Update package.json
+  const packageJsonPath = path.join(ROOT_DIR, 'package.json');
+  const packageJsonContent = await readTextFile(packageJsonPath);
+  const packageJson = JSON.parse(packageJsonContent);
+  const oldVersion = packageJson.version;
+  
+  if (oldVersion === newVersion) {
+    console.log(`Version is already ${newVersion}. Exiting.`);
+    process.exit(0);
+  }
+
+  packageJson.version = newVersion;
+  await writeTextFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+  console.log(`Updated package.json (was ${oldVersion})`);
+
+  // 2. Update docs/deep_analysis_and_roadmap_backlog.md
+  const roadmapPath = path.join(ROOT_DIR, 'docs', 'deep_analysis_and_roadmap_backlog.md');
+  if (await fileExists(roadmapPath)) {
+    let roadmapContent = await readTextFile(roadmapPath);
+    roadmapContent = roadmapContent.replace(`Current Version: ${oldVersion}`, `Current Version: ${newVersion}`);
+    await writeTextFile(roadmapPath, roadmapContent);
+    console.log('Updated docs/deep_analysis_and_roadmap_backlog.md');
+  }
+
+  // 3. Update Rule files (.cursorrules, .windsurfrules)
+  const ruleFiles = ['.cursorrules', '.windsurfrules'];
+  for (const ruleFile of ruleFiles) {
+    const fullPath = path.join(ROOT_DIR, ruleFile);
+    if (await fileExists(fullPath)) {
+      let content = await readTextFile(fullPath);
+      content = content.replace(`Generated by Agentic-Senior-Core CLI v${oldVersion}`, `Generated by Agentic-Senior-Core CLI v${newVersion}`);
+      await writeTextFile(fullPath, content);
+      console.log(`Updated ${ruleFile}`);
+    }
+  }
+
+  // 4. Update CHANGELOG.md
+  const changelogPath = path.join(ROOT_DIR, 'CHANGELOG.md');
+  if (await fileExists(changelogPath)) {
+    let changelogContent = await readTextFile(changelogPath);
+    
+    // Check if new version already has an entry
+    if (!changelogContent.includes(`## ${newVersion}`)) {
+      const today = new Date().toISOString().split('T')[0];
+      const newEntry = `## ${newVersion} - ${today}\n### Added\n- \n\n### Changed\n- \n\n### Fixed\n- \n\n`;
+      
+      // Find the first version heading "## x.x.x"
+      const firstHeadingIndex = changelogContent.search(/^## \d+\.\d+\.\d+/m);
+      if (firstHeadingIndex !== -1) {
+        changelogContent = changelogContent.slice(0, firstHeadingIndex) + newEntry + changelogContent.slice(firstHeadingIndex);
+        await writeTextFile(changelogPath, changelogContent);
+        console.log('Prepended new entry to CHANGELOG.md');
+      }
+    } else {
+      console.log(`CHANGELOG.md already has an entry for ${newVersion}`);
+    }
+  }
+
+  console.log(`\nVersion successfully bumped from ${oldVersion} to ${newVersion}!`);
+  console.log('Remember to fill out your CHANGELOG.md before pushing.');
+}
+
+bumpVersion().catch(e => {
+  console.error('Fatal error:', e);
+  process.exit(1);
+});