sneakoscope 7.0.0 → 7.0.3

package/dist/core/skills/core-skill-scorer.js

@@ -2,11 +2,6 @@ import path from 'node:path';
 import { ensureDir, nowIso, writeJsonAtomic } from '../fsx.js';
 import { CORE_SKILL_SCORE_SCHEMA } from './core-skill-types.js';
 export const DEFAULT_LATENCY_BUDGET_MS = 60_000;
-/**
- * Score a rollout trace. A side-effect-zero violation (mutations beyond requested
- * scope) is a HARD fail: the score is driven negative so the candidate can never
- * be accepted regardless of task success. Proof-less success scores low.
- */
 export function scoreRollout(trace, opts = {}) {
     const latencyBudget = Math.max(1, opts.latencyBudgetMs ?? DEFAULT_LATENCY_BUDGET_MS);
     const hadSideEffect = trace.side_effect_ledger.length > 0;
@@ -25,7 +20,6 @@ export function scoreRollout(trace, opts = {}) {
         components.latency_budget +
         components.rollback_ready +
         components.requested_scope_compliance;
-    // Hard fail: any requested-scope violation forces a negative score.
     const score = sideEffectViolation ? -1 : raw;
     return {
         schema: CORE_SKILL_SCORE_SCHEMA,
@@ -36,7 +30,6 @@ export function scoreRollout(trace, opts = {}) {
         skill_version: trace.skill_version
     };
 }
-/** Aggregate score across a set of rollouts (mean), preserving any violation as a hard fail. */
 export function scoreRollouts(traces, opts = {}) {
     if (!traces.length) {
         return {

package/dist/core/skills/core-skill-trainer.js

@@ -1,12 +1,3 @@
-// SKS Core Skill Engine — SkillOpt-style multi-epoch trainer.
-//
-// Closes the SkillOpt training loop over the existing primitives: per epoch a
-// rollout batch is reflected on (reflect → aggregate → select), the selected
-// bounded edit goes through the strict held-out gate (runSkillEpoch), and the
-// textual learning rate is meta-updated from the outcome. The best held-out
-// accepted card is exported as the deployable best-skill artifact (SkillOpt's
-// best_skill.md analogue). Pure/deterministic: the caller supplies the held-out
-// evaluator; no model call is made here. Forbidden in deployment context.
 import path from 'node:path';
 import { ensureDir, nowIso, writeJsonAtomic } from '../fsx.js';
 import { assertNotInDeployment } from './core-skill-deployment.js';
@@ -16,7 +7,6 @@ import { applyPatch } from './core-skill-patch-apply.js';
 import { aggregateReflections, reflectOnTrace, selectPatchOperations } from './core-skill-reflection.js';
 import { CORE_SKILL_PATCH_SCHEMA } from './core-skill-types.js';
 export const CORE_SKILL_TRAINING_REPORT_SCHEMA = 'sks.core-skill-training-report.v1';
-/** Run the SkillOpt training loop in a TRAINING/EVALUATION context. */
 export async function trainSkill(root, input) {
     assertNotInDeployment('trainSkill');
     let current = input.card;
@@ -41,7 +31,6 @@ export async function trainSkill(root, input) {
             operations,
             textual_learning_rate: { ...learningRate }
         };
-        // Probe the candidate's held-out score BEFORE the gated update.
         const preview = applyPatch(current, patch);
         const candidateProbe = preview.ok && preview.candidate ? input.evaluateHeldout(preview.candidate) : currentProbe;
         const result = await runSkillEpoch(root, {

package/dist/core/skills/core-skill-types.js

@@ -1,15 +1,6 @@
-// SKS Core Skill Engine — shared type contract (SkillOpt-derived).
-//
-// Skills are the frozen agent's external, versioned state. An optimizer proposes
-// bounded edits to a single skill document; edits are accepted ONLY on strict
-// held-out improvement; deployment reads an immutable accepted snapshot and never
-// calls the optimizer. None of this mutates code/config/global files.
 export const CORE_SKILL_CARD_SCHEMA = 'sks.core-skill-card.v1';
 export const CORE_SKILL_PATCH_SCHEMA = 'sks.core-skill-patch.v1';
 export const CORE_ROLLOUT_TRACE_SCHEMA = 'sks.core-rollout-trace.v1';
 export const CORE_SKILL_SCORE_SCHEMA = 'sks.core-skill-rollout-score.v1';
-// Targets a SkillPatch may address. Anything else (code/config/global files) is
-// rejected — patches only ever edit the single skill document.
 export const SKILL_PATCH_TARGET_RE = /^(section|sentence|paragraph):[A-Za-z0-9 _.-]+$/;
-// Targets that look like filesystem/code/config paths are explicitly forbidden.
 export const FORBIDDEN_PATCH_TARGET_RE = /[/\\]|\.(ts|js|mjs|json|toml|rs|md|lock)\b|^~|^\.{1,2}\//i;

package/dist/core/skills/core-skill-validation.js

@@ -1,8 +1,3 @@
-/**
- * Strict held-out acceptance. A candidate skill is accepted ONLY when its held-out
- * score strictly improves AND no safety/quality dimension regresses. Train-only
- * improvement with worse held-out is rejected.
- */
 export function validateHeldout(input) {
     const delta = input.candidateHeldout - input.baselineHeldout;
     const result = (accept, reason) => ({

package/dist/core/skills/rejected-skill-patch-buffer.js

@@ -10,7 +10,6 @@ export async function recordRejectedPatch(root, entry) {
     await appendJsonl(file, full);
     return full;
 }
-/** Has this exact patch (by hash) already been rejected? Used to skip repeated failed edits. */
 export async function isPatchRejected(root, patchHash) {
     const text = await readText(rejectedBufferPath(root), '');
     if (!text.trim())
@@ -24,7 +23,6 @@ export async function isPatchRejected(root, patchHash) {
                 return true;
         }
         catch {
-            // tolerate malformed lines
         }
     }
     return false;

package/dist/core/stop-gate/stop-gate-check.js

@@ -14,9 +14,6 @@ function normalizeRoute(route) {
 function rawGateToV1(raw, gatePath, route) {
     if (!raw)
         return null;
-    // Canonical input still needs runtime normalization. Older or hand-written
-    // gate files can omit optional arrays; malformed types must fail closed
-    // rather than throwing or being treated as empty.
     if (raw.schema === 'sks.stop-gate.v1') {
         return {
             ...raw,
@@ -37,7 +34,6 @@ function rawGateToV1(raw, gatePath, route) {
             created_at: String(raw.created_at || raw.updated_at || nowIso()),
         };
     }
-    // Normalize from legacy naruto-gate.json / glm-naruto termination
     const passed = raw.passed === true;
     const status = passed ? 'passed' : (raw.status || 'blocked');
     const terminalState = raw.terminal_state || (passed ? 'completed' : 'blocked');
@@ -102,7 +98,6 @@ export async function checkStopGate(input) {
     const route = normalizeRoute(resolution.route) ?? normalizeRoute(input.route ?? null) ?? 'Naruto';
     const missionId = resolution.mission_id;
     const statInfo = resolution.gate_path ? await gateStatInfo(resolution.gate_path) : { mtime: null, sha256: null };
-    // Check hard blocker first
     const hardBlocker = await checkHardBlocker(root, missionId);
     if (hardBlocker.hardBlocked) {
         const action = 'hard_blocked';
@@ -216,7 +211,6 @@ export async function checkStopGate(input) {
                 : `Stop allowed: gate passed at ${resolution.gate_path}`,
         };
     }
-    // Gate not passed
     const action = 'continue';
     const diagnostics = {
         schema: 'sks.stop-gate-diagnostics.v1',
@@ -248,11 +242,9 @@ export async function checkStopGate(input) {
     };
 }
 async function writeDiagnostics(root, missionId, diagnostics) {
-    // Global report
     const reportsDir = path.join(root, '.sneakoscope', 'reports');
     await ensureDir(reportsDir);
     await writeJsonAtomic(path.join(reportsDir, 'stop-gate-last-check.json'), diagnostics);
-    // Mission-local
     if (missionId) {
         const dir = missionDir(root, missionId);
         await ensureDir(dir);

package/dist/core/stop-gate/stop-gate-resolver.js

@@ -18,7 +18,6 @@ export async function resolveStopGate(input) {
     const root = path.resolve(input.root);
     const checkedPaths = [];
     const route = input.route ?? null;
-    // 1. explicit absolute path
     if (input.explicitGatePath) {
         const abs = path.isAbsolute(input.explicitGatePath) ? input.explicitGatePath : path.resolve(root, input.explicitGatePath);
         checkedPaths.push(abs);
@@ -27,7 +26,6 @@ export async function resolveStopGate(input) {
             return makeResolution(root, route, null, abs, raw, checkedPaths, null, null, 'explicit_gate_path');
         }
     }
-    // 2. current.json → mission_id + stop_gate_abs_path
     const statePath = stateFile(root);
     let state = {};
     let stateMissionId = null;
@@ -37,7 +35,6 @@ export async function resolveStopGate(input) {
         stateMissionId = typeof state.mission_id === 'string' ? state.mission_id : null;
     }
     const missionId = input.missionId ?? stateMissionId;
-    // 2a. stop_gate_abs_path from current state
     if (typeof state.stop_gate_abs_path === 'string' && state.stop_gate_abs_path) {
         const abs = path.isAbsolute(state.stop_gate_abs_path) ? state.stop_gate_abs_path : path.resolve(root, state.stop_gate_abs_path);
         checkedPaths.push(abs);
@@ -46,7 +43,6 @@ export async function resolveStopGate(input) {
             return makeResolution(root, route, missionId, abs, raw, checkedPaths, statePath, stateMissionId, 'state.stop_gate_abs_path');
         }
     }
-    // 3. mission dir candidates
     if (missionId) {
         const dir = missionDir(root, missionId);
         for (const file of GATE_FILE_CANDIDATES) {
@@ -57,7 +53,6 @@ export async function resolveStopGate(input) {
                 return makeResolution(root, route, missionId, p, raw, checkedPaths, statePath, stateMissionId, 'mission_dir');
             }
         }
-        // GLM Naruto termination / mission-result
         const glmDir = path.join(root, GLM_NARUTO_DIR, missionId);
         for (const file of ['termination.json', 'mission-result.json']) {
             const p = path.join(glmDir, file);
@@ -68,8 +63,6 @@ export async function resolveStopGate(input) {
             }
         }
     }
-    // 4. latest mission fallback. Interactive hooks disable this path so a stale
-    // mission cannot satisfy the current session's stop gate by accident.
     const latest = input.allowLatestFallback === false ? null : await findLatestMission(root);
     if (latest) {
         const dir = missionDir(root, latest);

package/dist/core/stop-gate/stop-gate-writer.js

@@ -42,7 +42,6 @@ export async function writeGateOwned(input) {
         gate_owner: gateOwner,
         created_at: nowIso(),
     };
-    // 1. Write route-native gate file (backwards compat), preserving detailed native fields by default.
     const preserveNativeGate = input.preserveNativeGate !== false;
     if (preserveNativeGate && await exists(nativeGatePath)) {
         const existing = await readJson(nativeGatePath, {});
@@ -84,11 +83,8 @@ export async function writeGateOwned(input) {
             ...(input.nativeGatePatch ?? {})
         });
     }
-    // 2. Write canonical stop-gate.json
     await writeJsonAtomic(canonicalGatePath, gate);
-    // 3. Write stop-gate.latest.json
     await writeJsonAtomic(latestGatePath, gate);
-    // 4. Update current state with absolute path
     await setCurrent(input.root, {
         mission_id: input.missionId,
         route: input.route,
@@ -104,7 +100,6 @@ export async function writeGateOwned(input) {
         terminal: gate.terminal,
         terminal_state: gate.terminal_state,
     }, { sessionKey: input.sessionKey || undefined });
-    // 5. Re-read and verify
     const verifyResult = {
         schema: 'sks.stop-gate-write-verify.v1',
         verified: false,

package/dist/core/subagents/model-policy.js

@@ -7,8 +7,6 @@ export const LUNA_SUBAGENT_EFFORT = 'max';
 export const TERRA_SUBAGENT_EFFORT = 'medium';
 export const DEFAULT_SUBAGENT_EFFORT = 'high';
 export const SOL_MAX_SUBAGENT_EFFORT = 'max';
-// Compatibility exports retained for research and older callers. New code
-// should select a policy profile instead of combining model/effort constants.
 export const DEFAULT_SUBAGENT_MODEL = SOL_SUBAGENT_MODEL;
 export const THINKING_SUBAGENT_MODEL = SOL_SUBAGENT_MODEL;
 export const SUBAGENT_EFFORT = SOL_MAX_SUBAGENT_EFFORT;
@@ -229,9 +227,6 @@ export function decideSubagentModel(input = {}) {
         input.role,
         input.expectedOutput
     ].filter(Boolean).join(' ');
-    // Explicit phase/task classification is authoritative. Free-form prompts
-    // often mention review, risk, architecture, or debugging as incidental
-    // context for an otherwise clear implementation or exploration slice.
     if (input.taskClass === 'judgment')
         return decision('sol_max_judgment');
     if (input.taskClass === 'context_tools')
@@ -270,8 +265,6 @@ export function decideSubagentModel(input = {}) {
     const judgment = JUDGMENT_TASK_RE.test(text);
     if (judgment)
         return decision('sol_max_judgment');
-    // Ambiguous work defaults to the trust-first lane. Sol High is reserved for
-    // clearly identified implementation, not for underspecified judgment.
     return decision('sol_max_judgment');
 }
 const FOCUSED_JUDGMENT_TASK_RE = new RegExp([

package/dist/core/subagents/naruto-help-contract.js

@@ -10,7 +10,7 @@ export function buildNarutoHelpResult() {
         workflow: 'official_codex_subagent',
         description: '$sks-naruto is the canonical SKS execution route for the Codex official subagent workflow; $sks-work is its intended execution alias.',
         usage: [
-            'sks naruto run "<task>" [--agents N] [--max-threads N] [--json]',
+            'sks naruto run "<task>" [--agents N] [--max-threads N] [--trusted-project] [--json]',
             'sks naruto status [latest|M-...] [--json]',
             'sks naruto subagents [latest|M-...] [--json]',
             'sks naruto proof [latest|M-...] [--json]'