sneakoscope 0.6.87 → 0.6.89

package/README.md

@@ -90,6 +90,8 @@ sks bootstrap
 
 `sks` commands work even when no project root is present. Project-aware commands use the nearest `.sneakoscope`, `.dcodex`, or `.git` root; if none exists, SKS uses a per-user global runtime root. `sks bootstrap` still initializes the current project when you want project-local hooks, skills, and TriWiki state.
 
+Project setup writes shared `.gitignore` entries for generated SKS files: `.sneakoscope/`, `.codex/`, `.agents/`, and managed `AGENTS.md`. Use `sks setup --local-only` when you want those excludes kept only in `.git/info/exclude`.
+
 ### One-Shot Install
 
 Use this when you do not want to keep a global install:
@@ -256,6 +258,8 @@ Generated app files include:
 | `.codex/config.toml` | Codex profiles, agents, and MCP configuration. |
 | `.sneakoscope/` | Runtime state, missions, wiki packs, policies, and artifacts. |
 
+Default setup adds these generated SKS paths to the project `.gitignore`; `--local-only` uses `.git/info/exclude` instead.
+
 Use `sks dollar-commands` to confirm that terminal discovery and Codex App prompt commands agree.
 
 TriWiki is intentionally sparse: `sks wiki sweep` records demote, soft-forget, archive, delete, promote-to-skill, and promote-to-rule candidates instead of injecting every old claim into future prompts. `sks harness fixture` validates the broader Harness Growth Factory contract: deliberate forgetting fixtures, skill card metadata, experiment schema, tool-error taxonomy, permission profiles, MultiAgentV2 defaults, and Warp cockpit view coverage. `sks code-structure scan` flags handwritten files above 1000/2000/3000-line thresholds so new logic can be extracted before command files become harder to maintain.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "ㅅㅋㅅ",
-  "version": "0.6.87",
+  "version": "0.6.89",
   "description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team, Goal, AutoResearch, TriWiki, and Honest Mode.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",

package/src/cli/main.mjs

@@ -1385,6 +1385,7 @@ async function codexAppHelp(args = []) {
     `Skills: project=${skills.project.ok ? 'ok' : `missing ${skills.project.missing.length}`} global=${skills.global.ok ? 'ok' : `missing ${skills.global.missing.length}`}`, '',
     'Setup:', '  sks bootstrap', '  sks deps check', '  sks codex-app check', '  sks warp check', '',
     'Generated files:', '  .codex/config.toml', '  .codex/hooks.json', '  .agents/skills/', '  .codex/agents/', '  .codex/SNEAKOSCOPE.md', '  AGENTS.md', '',
+    'Git ignore:', '  default setup writes .gitignore entries for .sneakoscope/, .codex/, .agents/, AGENTS.md', '  --local-only writes those patterns to .git/info/exclude instead', '',
     'Prompt routes:', formatDollarCommandsCompact('  ')
   ].join('\n'));
 }
@@ -1564,6 +1565,7 @@ async function setup(args) {
   console.log(`Hooks:     ${path.relative(root, hooksPath)}`);
   console.log(`Version:   ${versioningInfo.enabled ? (versioningInfo.hook_installed ? 'auto-bump enabled' : 'auto-bump hook missing') : 'not enabled'}${versioningInfo.package_version ? ` (${versioningInfo.package_version})` : ''}`);
   if (localOnly) console.log('Git:       local-only (.git/info/exclude; user AGENTS preserved, SKS managed block refreshed)');
+  else console.log('Git:       .gitignore ignores SKS generated files');
   console.log(`Codex App: .codex/config.toml, .codex/hooks.json, .agents/skills, .codex/agents, .codex/SNEAKOSCOPE.md`);
   console.log(`Global $:  ${globalSkills.status === 'installed' ? 'ok' : globalSkills.status} ${globalSkills.root || ''}`.trimEnd());
   console.log(`App tools: ${appRuntime.ok ? 'ok' : 'needs setup'} Codex App=${appRuntime.app.installed ? 'ok' : 'missing'} Browser Use=${appRuntime.mcp.has_browser_use ? 'ok' : 'missing'} Computer Use=${appRuntime.mcp.has_computer_use ? 'ok' : 'missing'}`);
@@ -1759,6 +1761,7 @@ async function init(args) {
   console.log(`Initialized ㅅㅋㅅ in ${root}`);
   console.log(`Install scope: ${installScope} (${sksCommandPrefix(installScope, { globalCommand })})`);
   if (localOnly) console.log('Git mode: local-only (.git/info/exclude)');
+  else console.log('Git mode: shared .gitignore');
   for (const x of res.created) console.log(`- ${x}`);
 }
 
@@ -1967,9 +1970,11 @@ async function selftest() {
   await writeJsonAtomic(path.join(postinstallBootstrapTmp, 'package.json'), { name: 'postinstall-bootstrap-smoke', version: '0.0.0' });
   const postinstallBootstrap = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'postinstall'], { cwd: postinstallBootstrapTmp, input: 'y\n', env: { INIT_CWD: postinstallBootstrapTmp, HOME: path.join(postinstallBootstrapTmp, 'home'), SKS_SKIP_POSTINSTALL_SHIM: '1', SKS_SKIP_POSTINSTALL_CONTEXT7: '1', SKS_SKIP_POSTINSTALL_GLOBAL_SKILLS: '1', SKS_SKIP_CLI_TOOLS: '1', SKS_POSTINSTALL_PROMPT: '1' }, timeoutMs: 30000, maxOutputBytes: 256 * 1024 });
   if (postinstallBootstrap.code !== 0 || !String(postinstallBootstrap.stdout || '').includes('SKS Ready')) throw new Error(`selftest failed: approved postinstall bootstrap did not run: ${postinstallBootstrap.stderr}`);
-  for (const rel of ['.agents/skills/team/SKILL.md', '.codex/config.toml', '.codex/hooks.json', '.sneakoscope/harness-guard.json', '.codex/SNEAKOSCOPE.md', 'AGENTS.md']) {
+  for (const rel of ['.agents/skills/team/SKILL.md', '.codex/config.toml', '.codex/hooks.json', '.sneakoscope/harness-guard.json', '.codex/SNEAKOSCOPE.md', 'AGENTS.md', '.gitignore']) {
     if (!(await exists(path.join(postinstallBootstrapTmp, rel)))) throw new Error(`selftest failed: bootstrap did not create ${rel}`);
   }
+  const postinstallBootstrapGitignore = await safeReadText(path.join(postinstallBootstrapTmp, '.gitignore'));
+  if (!postinstallBootstrapGitignore.includes('.sneakoscope/') || !postinstallBootstrapGitignore.includes('.codex/') || !postinstallBootstrapGitignore.includes('.agents/') || !postinstallBootstrapGitignore.includes('AGENTS.md')) throw new Error('selftest failed: bootstrap did not ignore SKS generated files');
   const bootstrapJsonTmp = tmpdir();
   await writeJsonAtomic(path.join(bootstrapJsonTmp, 'package.json'), { name: 'bootstrap-json-smoke', version: '0.0.0' });
   const bootstrapJson = await runProcess(process.execPath, [path.join(packageRoot(), 'bin', 'sks.mjs'), 'bootstrap', '--json'], { cwd: bootstrapJsonTmp, env: { HOME: path.join(bootstrapJsonTmp, 'home'), SKS_SKIP_POSTINSTALL_GLOBAL_SKILLS: '1', SKS_SKIP_CLI_TOOLS: '1' }, timeoutMs: 30000, maxOutputBytes: 256 * 1024 });
@@ -2090,10 +2095,19 @@ async function selftest() {
   await initProject(localOnlyTmp, { localOnly: true });
   const localExclude = await safeReadText(path.join(localOnlyTmp, '.git', 'info', 'exclude'));
   if (!localExclude.includes('.codex/') || !localExclude.includes('AGENTS.md')) throw new Error('selftest failed: local-only git excludes missing');
+  if (await exists(path.join(localOnlyTmp, '.gitignore'))) throw new Error('selftest failed: local-only wrote shared .gitignore');
   const localAgents = await safeReadText(path.join(localOnlyTmp, 'AGENTS.md'));
   if (localAgents.trim() !== 'existing local rules') throw new Error('selftest failed: local-only modified existing AGENTS.md');
   const localManifest = await readJson(path.join(localOnlyTmp, '.sneakoscope', 'manifest.json'));
   if (!localManifest.git?.local_only) throw new Error('selftest failed: local-only manifest missing');
+  const gitignoreTmp = tmpdir();
+  await writeTextAtomic(path.join(gitignoreTmp, '.gitignore'), 'node_modules/\n.sneakoscope/\n');
+  await initProject(gitignoreTmp, {});
+  const gitignoreText = await safeReadText(path.join(gitignoreTmp, '.gitignore'));
+  if (!gitignoreText.includes('node_modules/') || !gitignoreText.includes('# BEGIN Sneakoscope Codex generated files') || !gitignoreText.includes('.codex/') || !gitignoreText.includes('.agents/') || !gitignoreText.includes('AGENTS.md')) throw new Error('selftest failed: shared .gitignore did not preserve existing entries and add SKS patterns');
+  await initProject(gitignoreTmp, {});
+  const gitignoreTextSecond = await safeReadText(path.join(gitignoreTmp, '.gitignore'));
+  if ((gitignoreTextSecond.match(/BEGIN Sneakoscope Codex generated files/g) || []).length !== 1) throw new Error('selftest failed: shared .gitignore managed block duplicated');
   const managedAgentsTmp = tmpdir();
   await ensureDir(path.join(managedAgentsTmp, '.git'));
   await writeTextAtomic(path.join(managedAgentsTmp, 'AGENTS.md'), '<!-- BEGIN Sneakoscope Codex GX MANAGED BLOCK -->\nold managed rules\n<!-- END Sneakoscope Codex GX MANAGED BLOCK -->\n');

package/src/cli/maintenance-commands.mjs

@@ -89,6 +89,8 @@ Local-only install artifacts:
   # writes generated SKS files but excludes .sneakoscope/, .codex/, .agents/, AGENTS.md through .git/info/exclude
   # user-owned AGENTS.md is preserved; an existing SKS managed block is refreshed
 
+Default project setup writes the same SKS generated-file patterns into the project .gitignore.
+
 GitHub install for unreleased commits:
   npm i -g git+${REPOSITORY_URL}
   sks bootstrap

package/src/core/fsx.mjs

@@ -5,7 +5,7 @@ import os from 'node:os';
 import crypto from 'node:crypto';
 import { spawn } from 'node:child_process';
 
-export const PACKAGE_VERSION = '0.6.87';
+export const PACKAGE_VERSION = '0.6.89';
 export const DEFAULT_PROCESS_TAIL_BYTES = 256 * 1024;
 export const DEFAULT_PROCESS_TIMEOUT_MS = 30 * 60 * 1000;
 

package/src/core/init.mjs

@@ -9,6 +9,8 @@ import { installVersionGitHook } from './version-manager.mjs';
 import { CODEX_COMPUTER_USE_ONLY_POLICY, DOLLAR_COMMANDS, DOLLAR_COMMAND_ALIASES, DOLLAR_SKILL_NAMES, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS, RECOMMENDED_MCP_SERVERS, RECOMMENDED_SKILLS, chatCaptureIntakeText, context7ConfigToml, stackCurrentDocsPolicyText, triwikiContextTracking, triwikiContextTrackingText, triwikiStagePolicyText } from './routes.mjs';
 
 const REFLECTION_MEMORY_PATH = '.sneakoscope/memory/q2_facts/post-route-reflection.md';
+const SKS_GENERATED_GIT_PATTERNS = ['.sneakoscope/', '.codex/', '.agents/', 'AGENTS.md'];
+
 function reflectionInstructionText(commandPrefix = 'sks') {
   return `Post-route reflection: full routes load \`reflection\` after work/tests and before final; DFix/Answer/Help/Wiki/SKS discovery are exempt. Write reflection.md; record only real misses/gaps, or no_issue_acknowledged. For lessons, append TriWiki claim rows to ${REFLECTION_MEMORY_PATH}. Run "${commandPrefix} wiki refresh" or pack, validate, then pass reflection-gate.json.`;
 }
@@ -107,7 +109,9 @@ export async function initProject(root, opts = {}) {
   ];
   for (const d of dirs) await ensureDir(path.join(root, d));
   const localExclude = localOnly ? await ensureLocalOnlyGitExclude(root) : null;
+  const sharedIgnore = localOnly ? null : await ensureSharedGitIgnore(root);
   if (localExclude?.path) created.push(`${path.relative(root, localExclude.path)} local-only excludes`);
+  if (sharedIgnore?.changed) created.push(`${path.relative(root, sharedIgnore.path)} SKS generated files ignore`);
 
   await writeJsonAtomic(path.join(sine, 'manifest.json'), {
     package: 'sneakoscope',
@@ -165,6 +169,8 @@ export async function initProject(root, opts = {}) {
     },
     git: {
       local_only: localOnly,
+      ignore_path: sharedIgnore?.path ? path.relative(root, sharedIgnore.path) : null,
+      ignored_patterns: sharedIgnore?.patterns || [],
       exclude_path: localExclude?.path ? path.relative(root, localExclude.path) : null,
       excluded_patterns: localExclude?.patterns || [],
       versioning: {
@@ -198,6 +204,8 @@ export async function initProject(root, opts = {}) {
       git: {
         ...(policy.git || {}),
         local_only: localOnly || Boolean(policy.git?.local_only),
+        ignore_path: sharedIgnore?.path ? path.relative(root, sharedIgnore.path) : policy.git?.ignore_path || null,
+        ignored_patterns: sharedIgnore?.patterns || policy.git?.ignored_patterns || [],
         exclude_path: localExclude?.path ? path.relative(root, localExclude.path) : policy.git?.exclude_path || null,
         excluded_patterns: localExclude?.patterns || policy.git?.excluded_patterns || [],
         versioning: {
@@ -267,6 +275,8 @@ export async function initProject(root, opts = {}) {
       installation: installPolicy(scope, commandPrefix),
       git: {
         local_only: localOnly,
+        ignore_path: sharedIgnore?.path ? path.relative(root, sharedIgnore.path) : null,
+        ignored_patterns: sharedIgnore?.patterns || [],
         exclude_path: localExclude?.path ? path.relative(root, localExclude.path) : null,
         excluded_patterns: localExclude?.patterns || [],
         versioning: {
@@ -445,10 +455,33 @@ policy = "Deny destructive database operations, credential exfiltration, persist
   return { created };
 }
 
+async function ensureSharedGitIgnore(root) {
+  const patterns = SKS_GENERATED_GIT_PATTERNS;
+  const ignorePath = path.join(root, '.gitignore');
+  const markerStart = '# BEGIN Sneakoscope Codex generated files';
+  const markerEnd = '# END Sneakoscope Codex generated files';
+  const managedBlock = `${markerStart}\n${patterns.join('\n')}\n${markerEnd}\n`;
+  const current = await readText(ignorePath, '');
+  if (current.includes(markerStart)) {
+    const re = new RegExp(`${escapeRegExp(markerStart)}[\\s\\S]*?${escapeRegExp(markerEnd)}\\n?`);
+    const next = current.replace(re, managedBlock);
+    if (next !== current) await writeTextAtomic(ignorePath, next.endsWith('\n') ? next : `${next}\n`);
+    return { path: ignorePath, patterns, changed: next !== current };
+  }
+  const existing = new Set(current.split(/\r?\n/).map((line) => line.trim()).filter(Boolean));
+  const missing = patterns.filter((pattern) => !existing.has(pattern));
+  if (!missing.length) return { path: ignorePath, patterns, changed: false };
+  const block = missing.length === patterns.length
+    ? managedBlock
+    : `${markerStart}\n${missing.join('\n')}\n${markerEnd}\n`;
+  await writeTextAtomic(ignorePath, `${current.trimEnd()}${current.trim() ? '\n\n' : ''}${block}`);
+  return { path: ignorePath, patterns, changed: true };
+}
+
 async function ensureLocalOnlyGitExclude(root) {
   const gitDir = await resolveGitDir(root);
   if (!gitDir) return { path: null, patterns: [] };
-  const patterns = ['.sneakoscope/', '.codex/', '.agents/', 'AGENTS.md'];
+  const patterns = SKS_GENERATED_GIT_PATTERNS;
   const excludePath = path.join(gitDir, 'info', 'exclude');
   await ensureDir(path.dirname(excludePath));
   const markerStart = '# Sneakoscope Codex local-only generated files';