@ryuenn3123/agentic-senior-core 4.2.2 → 4.2.4

package/AGENTS.md

@@ -18,7 +18,7 @@ Write instructions as imperative gates:
 - Add validation when a rule can drift.
 
 ## Bootstrap Receipt
-For non-trivial coding, review, planning, or governance work, run `agentic-senior-core context` first if available, or `npx @ryuenn3123/agentic-senior-core context` when only the package is available, then emit a concise Bootstrap Receipt before implementation output or file edits:
+For non-trivial work, run `agentic-senior-core context "<task_description>"` (or `npx @ryuenn3123/agentic-senior-core context "<task_description>"`) and emit a concise Bootstrap Receipt before implementation output or file edits:
 - `loaded_files`: files actually read
 - `selected_rules`: files selected for this scope and why
 - `skipped_rules`: out-of-scope categories left unloaded
@@ -28,7 +28,7 @@ For non-trivial coding, review, planning, or governance work, run `agentic-senio
 Keep it short. Do not load every rule just to fill it out.
 
 ## Default Activation And Command Economy
-Before any non-trivial task, run `agentic-senior-core context` and emit the Bootstrap Receipt. Skip only for trivial tasks: version bumps, typo fixes, single-line commits.
+Before any non-trivial task, run `agentic-senior-core context "<task_description>"` and emit the Bootstrap Receipt. Skip only for trivial tasks: version bumps, typo fixes, single-line commits.
 Always prefix noisy shell commands: `ascx git status`, `ascx git diff`, `ascx npm test`, `ascx rg` searches. Use raw commands only for pipes, redirects, or commands not supported by ascx.
 Always read and apply `.agent-context/prompts/compact-natural-mode.md` for every final user-facing reply. Never repeat full command output; reference tee file paths when truncated.
 

package/README.md

@@ -26,6 +26,7 @@ Options:
 - Add `--mcp-template` to generate VS Code MCP workspace config.
 - Default init keeps MCP files opt-in.
 - Add `--no-token-optimize` only when you do not want ASCX command guidance enabled.
+- Add `--local-only` to ignore instructions (AGENTS.md, .agent-context/, and bridges) in .gitignore so they are not pushed to GitHub.
 - Local backup snapshots are written under `.agentic-backup/` and excluded from version control.
 
 ## Upgrade

package/lib/cli/backup.mjs

@@ -12,6 +12,15 @@ const RUNTIME_ARTIFACT_GITIGNORE_ENTRIES = [
 ];
 const RUNTIME_ARTIFACT_GITIGNORE_COMMENT = '# agentic-senior-core: local runtime artifacts';
 
+const GOVERNANCE_GITIGNORE_ENTRIES = [
+  '.agent-context/',
+  'AGENTS.md',
+  'CLAUDE.md',
+  'GEMINI.md',
+  'mcp.json',
+];
+const GOVERNANCE_GITIGNORE_COMMENT = '# agentic-senior-core: local-only governance files';
+
 /**
  * Calculates a SHA-256 hash of a file's contents.
  */
@@ -192,3 +201,10 @@ export async function ensureRuntimeArtifactGitignoreEntries(targetDirectoryPath)
     entries: RUNTIME_ARTIFACT_GITIGNORE_ENTRIES,
   });
 }
+
+export async function ensureLocalGovernanceGitignoreEntries(targetDirectoryPath) {
+  return ensureGitignoreEntries(targetDirectoryPath, {
+    comment: GOVERNANCE_GITIGNORE_COMMENT,
+    entries: GOVERNANCE_GITIGNORE_ENTRIES,
+  });
+}

package/lib/cli/commands/init.mjs

@@ -49,6 +49,7 @@ import {
   createBackup,
   ensureBackupGitignoreEntry,
   ensureRuntimeArtifactGitignoreEntries,
+  ensureLocalGovernanceGitignoreEntries,
 } from '../backup.mjs';
 import {
   runProjectDiscovery,
@@ -384,6 +385,25 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       );
     }
 
+    const shouldKeepLocalOnly = typeof initOptions.localOnly === 'boolean'
+      ? initOptions.localOnly
+      : isInteractiveSession
+        ? await askYesNo(
+            'Add AI instructions and governance files to .gitignore? (Prevents pushing them to GitHub/Git)',
+            userInterface,
+            false
+          )
+        : false;
+
+    if (shouldKeepLocalOnly) {
+      const localGovernanceGitignoreResult = await ensureLocalGovernanceGitignoreEntries(resolvedTargetDirectoryPath);
+      if (localGovernanceGitignoreResult.status !== 'unchanged') {
+        console.log(
+          `AI governance files ignored in .gitignore (${localGovernanceGitignoreResult.addedEntries.join(', ')}).`
+        );
+      }
+    }
+
     await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
       includeMcpTemplate: shouldIncludeMcpTemplate,
     });
@@ -523,6 +543,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       selectedBlueprintFileName: selectedResolvedBlueprintFileName,
       selectedAdditionalBlueprintFileNames,
       includeCiGuardrails,
+      localOnly: shouldKeepLocalOnly,
       setupDurationMs,
       projectDetection,
       runtimeEnvironment: {

package/lib/cli/compiler.mjs

@@ -145,6 +145,7 @@ export async function writeOnboardingReport({
   selectedBlueprintFileName,
   selectedAdditionalBlueprintFileNames = [],
   includeCiGuardrails,
+  localOnly = false,
   setupDurationMs,
   projectDetection,
   runtimeEnvironment = null,
@@ -197,6 +198,7 @@ export async function writeOnboardingReport({
       agentDecisionRequired: !hasExplicitRuntimeDecision,
     },
     ciGuardrailsEnabled: includeCiGuardrails,
+    localOnly,
     setupDurationMs,
     runtimeEnvironment,
     containerizationStrategy: buildContainerizationStrategySnapshot(dockerStrategy),

package/lib/cli/init-options.mjs

@@ -24,6 +24,7 @@ export function parseInitArguments(commandArguments) {
     memoryContinuity: true,
     tokenAgent: 'copilot',
     includeMcpTemplate: false,
+    localOnly: undefined,
     scaffoldDocs: undefined,
     docsLang: 'en',
     docsLangProvided: false,
@@ -143,6 +144,16 @@ export function parseInitArguments(commandArguments) {
       continue;
     }
 
+    if (currentArgument === '--local-only') {
+      parsedInitOptions.localOnly = true;
+      continue;
+    }
+
+    if (currentArgument === '--no-local-only') {
+      parsedInitOptions.localOnly = false;
+      continue;
+    }
+
     if (currentArgument === '--scaffold-docs') {
       parsedInitOptions.scaffoldDocs = true;
       continue;

package/package.json

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