@ryuenn3123/agentic-senior-core 2.0.27 → 2.5.3

package/.agent-context/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-17T03:27:46.024Z",
+  "generatedAt": "2026-04-17T03:41:09.595Z",
   "reportName": "memory-continuity-benchmark",
   "schemaVersion": "1.0.0",
   "passed": true,

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.27
+Generated by Agentic-Senior-Core CLI v2.5.3
 Timestamp: 2026-04-15T00:14:51.184Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.27
+Generated by Agentic-Senior-Core CLI v2.5.3
 Timestamp: 2026-04-15T00:14:51.184Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -235,6 +235,27 @@ npx @ryuenn3123/agentic-senior-core init --no-token-optimize
 When enabled, the CLI writes `.agent-context/state/token-optimization.json`, regenerates compiled rules, and adds compact command guidance to `.cursorrules` and `.windsurfrules`.
 If an external token proxy is available, the CLI prints setup hints. If not, native fallback guidance stays active, so outside users are not forced to install extra tooling.
 
+### Memory Continuity Mode (Enabled by Default on Init)
+
+By default, every `init` flow also enables memory continuity automatically.
+This allows cross-session context carryover through compact index-first retrieval plus selective hydration.
+
+Quick start:
+
+```bash
+# Default behavior (explicit flag optional)
+npx @ryuenn3123/agentic-senior-core init --memory-continuity
+
+# Opt out when needed
+npx @ryuenn3123/agentic-senior-core init --no-memory-continuity
+```
+
+When enabled, the CLI writes `.agent-context/state/memory-continuity.json`, regenerates compiled rules, and injects `MEMORY CONTINUITY PROFILE` guidance into `.cursorrules` and `.windsurfrules`.
+
+Compatibility note:
+- Works for local IDE, CLI, and cloud IDE chat runtimes that support the adapter contract or MCP retrieval path.
+- Generic web chat runtimes without repository tool hooks cannot auto-hydrate memory at runtime and should use manual summary handoff.
+
 ### Token Efficiency Benchmark Snapshot
 
 Latest local benchmark (2026-04-11) from `.agent-context/state/token-optimization-benchmark.json`:

package/lib/cli/commands/init.mjs

@@ -56,6 +56,10 @@ import {
   normalizeAgentName,
   writeTokenOptimizationState,
 } from '../token-optimization.mjs';
+import {
+  createMemoryContinuityState,
+  writeMemoryContinuityState,
+} from '../memory-continuity.mjs';
 import { evaluateSkillDomainCompatibility } from '../compatibility.mjs';
 
 export { REPO_ROOT } from '../constants.mjs';
@@ -71,6 +75,7 @@ export function parseInitArguments(commandArguments) {
     ci: undefined,
     newbie: false,
     tokenOptimize: true,
+    memoryContinuity: true,
     tokenAgent: 'copilot',
     includeMcpTemplate: false,
     scaffoldDocs: undefined,
@@ -166,6 +171,11 @@ export function parseInitArguments(commandArguments) {
       continue;
     }
 
+    if (currentArgument === '--memory-continuity') {
+      parsedInitOptions.memoryContinuity = true;
+      continue;
+    }
+
     if (currentArgument === '--token-agent') {
       parsedInitOptions.tokenAgent = commandArguments[argumentIndex + 1] || 'copilot';
       argumentIndex += 1;
@@ -182,6 +192,11 @@ export function parseInitArguments(commandArguments) {
       continue;
     }
 
+    if (currentArgument === '--no-memory-continuity') {
+      parsedInitOptions.memoryContinuity = false;
+      continue;
+    }
+
     if (currentArgument === '--mcp-template') {
       parsedInitOptions.includeMcpTemplate = true;
       continue;
@@ -408,6 +423,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
   const isTokenOptimizationEnabled = typeof initOptions.tokenOptimize === 'boolean'
     ? initOptions.tokenOptimize
     : true;
+  const isMemoryContinuityEnabled = typeof initOptions.memoryContinuity === 'boolean'
+    ? initOptions.memoryContinuity
+    : true;
   const shouldIncludeMcpTemplate = initOptions.includeMcpTemplate === true;
   const selectedTokenAgentName = normalizeAgentName(initOptions.tokenAgent || 'copilot');
   const isInteractiveSession = Boolean(stdin.isTTY && stdout.isTTY);
@@ -729,9 +747,20 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       includeMcpTemplate: shouldIncludeMcpTemplate,
     });
 
+    let memoryContinuityState = null;
+    if (isMemoryContinuityEnabled) {
+      memoryContinuityState = createMemoryContinuityState({
+        isEnabled: true,
+      });
+
+      await writeMemoryContinuityState(resolvedTargetDirectoryPath, memoryContinuityState);
+      console.log(`Memory continuity policy enabled (${memoryContinuityState.hydrationMode}).`);
+    }
+
+    let tokenOptimizationState = null;
     if (isTokenOptimizationEnabled) {
       const detectedExternalProxy = detectRtkBinary();
-      const tokenOptimizationState = createTokenOptimizationState({
+      tokenOptimizationState = createTokenOptimizationState({
         isEnabled: true,
         selectedAgentName: selectedTokenAgentName,
         rtkDetection: detectedExternalProxy,
@@ -862,6 +891,18 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         detectionSource: detectedRuntimeEnvironment.source,
       },
       operationMode: 'init',
+      tokenOptimization: {
+        enabled: isTokenOptimizationEnabled,
+        selectedAgent: selectedTokenAgentName,
+        preferredShellProxy: tokenOptimizationState?.preferredShellProxy || null,
+        stateFile: isTokenOptimizationEnabled ? '.agent-context/state/token-optimization.json' : null,
+      },
+      memoryContinuity: {
+        enabled: isMemoryContinuityEnabled,
+        hydrationMode: memoryContinuityState?.hydrationMode || null,
+        adapters: memoryContinuityState?.adapters || [],
+        stateFile: isMemoryContinuityEnabled ? '.agent-context/state/memory-continuity.json' : null,
+      },
     });
 
     console.log('\nInitialization complete.');
@@ -892,6 +933,11 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     }
     console.log(`- Repository workflows copied: no (workflows remain source-repo assets)`);
     console.log(`- MCP template file: ${shouldIncludeMcpTemplate ? 'created (.vscode/mcp.json)' : 'not created by default (use --mcp-template)'}`);
+    if (isMemoryContinuityEnabled) {
+      console.log('- Memory continuity policy: enabled (index + selective hydration)');
+    } else {
+      console.log('- Memory continuity policy: disabled (--no-memory-continuity)');
+    }
     if (isTokenOptimizationEnabled) {
       console.log(`- Token optimization policy: enabled for ${selectedTokenAgentName}`);
     } else {

package/lib/cli/compiler.mjs

@@ -25,6 +25,10 @@ import {
   readTokenOptimizationState,
   buildTokenOptimizationGuidanceBlock,
 } from './token-optimization.mjs';
+import {
+  readMemoryContinuityState,
+  buildMemoryContinuityGuidanceBlock,
+} from './memory-continuity.mjs';
 
 export async function writeSelectedPolicy(targetDirectoryPath, selectedProfileName) {
   const policyFilePath = path.join(targetDirectoryPath, '.agent-context', 'policies', POLICY_FILE_NAME);
@@ -49,8 +53,16 @@ export async function writeOnboardingReport({
   compatibilityWarnings = [],
   runtimeEnvironment = null,
   operationMode = 'init',
+  tokenOptimization = undefined,
+  memoryContinuity = undefined,
 }) {
   const onboardingReportPath = path.join(targetDirectoryPath, '.agent-context', 'state', 'onboarding-report.json');
+  const resolvedTokenOptimization = typeof tokenOptimization === 'undefined'
+    ? await readTokenOptimizationState(targetDirectoryPath)
+    : tokenOptimization;
+  const resolvedMemoryContinuity = typeof memoryContinuity === 'undefined'
+    ? await readMemoryContinuityState(targetDirectoryPath)
+    : memoryContinuity;
   const onboardingReport = {
     cliVersion: CLI_VERSION,
     generatedAt: new Date().toISOString(),
@@ -72,6 +84,8 @@ export async function writeOnboardingReport({
     selectedSkillDomains,
     compatibilityWarnings,
     runtimeEnvironment,
+    tokenOptimization: resolvedTokenOptimization,
+    memoryContinuity: resolvedMemoryContinuity,
     autoDetection: {
       recommendedStack: projectDetection.recommendedStackFileName,
       recommendedAdditionalStacks: projectDetection.secondaryStackFileNames || [],
@@ -267,6 +281,14 @@ export async function buildCompiledRulesContent({
       `## TOKEN OPTIMIZATION PROFILE\nSource: .agent-context/state/token-optimization.json\n\n${buildTokenOptimizationGuidanceBlock(tokenOptimizationState).trim()}`
     );
   }
+
+  const memoryContinuityState = await readMemoryContinuityState(resolvedTargetDirectoryPath);
+  if (memoryContinuityState?.enabled) {
+    contextBlocks.push(
+      `## MEMORY CONTINUITY PROFILE\nSource: .agent-context/state/memory-continuity.json\n\n${buildMemoryContinuityGuidanceBlock(memoryContinuityState).trim()}`
+    );
+  }
+
   contextBlocks.push(
     [
       '## LAYER 7: STATE AWARENESS (MANDATORY)',

package/lib/cli/memory-continuity.mjs

@@ -4,6 +4,11 @@
  * lightweight indexing, and selective hydration helpers.
  */
 
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+import { pathExists } from './utils.mjs';
+
 const PRIVATE_BLOCK_PATTERN = /<private>[\s\S]*?<\/private>/gi;
 
 const INLINE_SENSITIVE_PATTERNS = [
@@ -30,6 +35,9 @@ const INLINE_SENSITIVE_PATTERNS = [
 ];
 
 export const MEMORY_SCHEMA_VERSION = '1.0.0';
+export const MEMORY_CONTINUITY_STATE_FILE_NAME = 'memory-continuity.json';
+
+const MEMORY_CONTINUITY_STATE_SCHEMA_VERSION = 'memory-continuity-v1';
 
 export const SUPPORTED_MEMORY_ADAPTER_IDS = Object.freeze([
   'claude-code',
@@ -84,6 +92,32 @@ function normalizeTags(rawTags) {
   return Array.from(tagSet);
 }
 
+function normalizeMemoryAdapterIds(rawAdapterIds) {
+  if (!Array.isArray(rawAdapterIds) || rawAdapterIds.length === 0) {
+    return [...SUPPORTED_MEMORY_ADAPTER_IDS];
+  }
+
+  const normalizedAdapterIdSet = new Set();
+  for (const rawAdapterId of rawAdapterIds) {
+    const normalizedAdapterId = toNonEmptyString(String(rawAdapterId || '')).toLowerCase();
+    if (!normalizedAdapterId) {
+      continue;
+    }
+
+    if (!SUPPORTED_MEMORY_ADAPTER_IDS.includes(normalizedAdapterId)) {
+      continue;
+    }
+
+    normalizedAdapterIdSet.add(normalizedAdapterId);
+  }
+
+  if (normalizedAdapterIdSet.size === 0) {
+    return [...SUPPORTED_MEMORY_ADAPTER_IDS];
+  }
+
+  return Array.from(normalizedAdapterIdSet);
+}
+
 export function estimateTokenUsage(rawText = '') {
   const normalizedText = String(rawText || '');
   return Math.max(1, Math.ceil(normalizedText.length / 4));
@@ -264,3 +298,98 @@ export function hydrateIndexedObservations(indexEntries, normalizedObservations,
     hydrationTokenEstimate,
   };
 }
+
+export function createMemoryContinuityState(options = {}) {
+  const isEnabled = options.isEnabled !== false;
+  const sessionStartIndexLimit = Number.isFinite(Number(options.sessionStartIndexLimit))
+    ? Math.max(1, Number(options.sessionStartIndexLimit))
+    : 8;
+  const fullHydrationLimit = Number.isFinite(Number(options.fullHydrationLimit))
+    ? Math.max(1, Number(options.fullHydrationLimit))
+    : 2;
+
+  return {
+    schemaVersion: MEMORY_CONTINUITY_STATE_SCHEMA_VERSION,
+    enabled: isEnabled,
+    hydrationMode: 'progressive-disclosure',
+    adapters: normalizeMemoryAdapterIds(options.adapterIds),
+    retrieval: {
+      sessionStartIndexLimit,
+      fullHydrationLimit,
+    },
+    privacy: {
+      redactPrivateTags: true,
+      redactInlineSensitivePatterns: true,
+    },
+    generatedAt: new Date().toISOString(),
+  };
+}
+
+export async function readMemoryContinuityState(targetDirectoryPath) {
+  const stateFilePath = path.join(
+    targetDirectoryPath,
+    '.agent-context',
+    'state',
+    MEMORY_CONTINUITY_STATE_FILE_NAME
+  );
+
+  if (!(await pathExists(stateFilePath))) {
+    return null;
+  }
+
+  try {
+    const stateContent = await fs.readFile(stateFilePath, 'utf8');
+    const parsedState = JSON.parse(stateContent);
+    if (typeof parsedState.enabled !== 'boolean') {
+      return null;
+    }
+
+    parsedState.adapters = normalizeMemoryAdapterIds(parsedState.adapters);
+    return parsedState;
+  } catch {
+    return null;
+  }
+}
+
+export async function writeMemoryContinuityState(targetDirectoryPath, memoryContinuityState) {
+  const stateDirectoryPath = path.join(targetDirectoryPath, '.agent-context', 'state');
+  const stateFilePath = path.join(stateDirectoryPath, MEMORY_CONTINUITY_STATE_FILE_NAME);
+
+  await fs.mkdir(stateDirectoryPath, { recursive: true });
+  await fs.writeFile(stateFilePath, JSON.stringify(memoryContinuityState, null, 2) + '\n', 'utf8');
+}
+
+export function buildMemoryContinuityGuidanceBlock(memoryContinuityState) {
+  if (!memoryContinuityState?.enabled) {
+    return [
+      'Memory continuity mode is disabled for this repository.',
+      'Use explicit session summaries when handing off context across tools.',
+    ].join('\n');
+  }
+
+  const adapterGuidanceLine = memoryContinuityState.adapters?.length
+    ? `Supported adapters: ${memoryContinuityState.adapters.join(', ')}.`
+    : `Supported adapters: ${SUPPORTED_MEMORY_ADAPTER_IDS.join(', ')}.`;
+
+  const sessionStartIndexLimit = Number.isFinite(Number(memoryContinuityState.retrieval?.sessionStartIndexLimit))
+    ? Number(memoryContinuityState.retrieval.sessionStartIndexLimit)
+    : 8;
+  const fullHydrationLimit = Number.isFinite(Number(memoryContinuityState.retrieval?.fullHydrationLimit))
+    ? Number(memoryContinuityState.retrieval.fullHydrationLimit)
+    : 2;
+
+  return [
+    'Memory continuity mode is enabled.',
+    'Hydration mode: progressive-disclosure.',
+    adapterGuidanceLine,
+    '',
+    'Session-start retrieval policy:',
+    `- Load compact index first (limit: ${sessionStartIndexLimit} entries).`,
+    `- Hydrate full detail only for highest-value entries (limit: ${fullHydrationLimit}).`,
+    '- Always redact sensitive text before persistence (<private> blocks and inline secret-like fields).',
+    '',
+    'Host compatibility scope:',
+    '- Works for local IDE, CLI, and cloud IDE chat hosts that implement the memory adapter contract or MCP retrieval path.',
+    '- Generic web chat sessions without repository tools cannot auto-hydrate runtime memory and should rely on manual summary export/import.',
+  ].join('\n');
+}

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>] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
+  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>] [--memory-continuity] [--no-memory-continuity] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
   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');
@@ -49,6 +49,8 @@ export function printUsage() {
   console.log('  --token-optimize  Explicitly enable token optimization policy during init (default behavior)');
   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('  --memory-continuity  Explicitly enable cross-session memory continuity policy during init (default behavior)');
+  console.log('  --no-memory-continuity  Disable memory continuity 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');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "2.0.27",
+  "version": "2.5.3",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {