sinapse-ai 1.4.2 → 1.6.0

package/.sinapse-ai/core/orchestration/fast-path-gate.js

@@ -0,0 +1,356 @@
+'use strict';
+
+const DEFAULT_FAST_PATH_CONFIG = Object.freeze({
+  enabled: true,
+  externalExecutorsEnabled: false,
+  minConfidence: 0.58,
+  minBatchItems: 3,
+  externalExecutorThreshold: 0.78,
+});
+
+const STRUCTURED_FILE_EXTENSIONS_FROZEN = Object.freeze([
+  '.csv',
+  '.json',
+  '.jsonl',
+  '.md',
+  '.toml',
+  '.tsv',
+  '.txt',
+  '.yaml',
+  '.yml',
+]);
+
+const STRUCTURED_FILE_EXTENSION_SET = new Set(STRUCTURED_FILE_EXTENSIONS_FROZEN);
+
+const AUTOMATION_PATTERNS_FROZEN = Object.freeze([
+  {
+    id: 'bulk-edit',
+    weight: 3,
+    pattern: /\b(batch|bulk|many files|multiple files|all files|in one shot|one shot)\b/i,
+  },
+  {
+    id: 'structured-transform',
+    weight: 3,
+    pattern: /\b(yaml|json|csv|markdown|frontmatter|schema|variable|variables|field|fields)\b/i,
+  },
+  {
+    id: 'mechanical-edit',
+    weight: 3,
+    pattern: /\b(replace|rename|populate|fill|complete|update|convert|transform|normalize|format)\b/i,
+  },
+  {
+    id: 'map-then-apply',
+    weight: 2,
+    pattern: /\b(map|extract|derive|template|codemod|script)\b/i,
+  },
+  {
+    id: 'repetition',
+    weight: 2,
+    pattern: /\b(repeated|repetitive|same change|similar change|dumb task|tedious)\b/i,
+  },
+  {
+    id: 'parallelizable',
+    weight: 2,
+    pattern: /\b(parallel|independent|per file|per item|per record)\b/i,
+  },
+].map(Object.freeze));
+
+const RISK_PATTERNS_FROZEN = Object.freeze([
+  {
+    id: 'architecture',
+    weight: 3,
+    pattern: /\b(architecture|architectural|design decision|adr|contract)\b/i,
+  },
+  {
+    id: 'security',
+    weight: 3,
+    pattern: /\b(security|secret|token|credential|auth|permission|pii|rls)\b/i,
+  },
+  {
+    id: 'destructive',
+    weight: 3,
+    pattern: /\b(delete|remove data|drop|reset|rewrite history|destructive)\b/i,
+  },
+  {
+    id: 'production',
+    weight: 2,
+    pattern: /\b(production|prod|release|billing|payment|customer)\b/i,
+  },
+  {
+    id: 'migration',
+    weight: 2,
+    pattern: /\b(migration|migrate|schema change|breaking change)\b/i,
+  },
+].map(Object.freeze));
+
+function clonePatternDefinition(patternDefinition) {
+  return {
+    id: patternDefinition.id,
+    weight: patternDefinition.weight,
+    pattern: new RegExp(patternDefinition.pattern.source, patternDefinition.pattern.flags),
+  };
+}
+
+function getStructuredFileExtensions() {
+  return new Set(STRUCTURED_FILE_EXTENSIONS_FROZEN);
+}
+
+function getAutomationPatterns() {
+  return AUTOMATION_PATTERNS_FROZEN.map(clonePatternDefinition);
+}
+
+function getRiskPatterns() {
+  return RISK_PATTERNS_FROZEN.map(clonePatternDefinition);
+}
+
+function parseBoolean(value, fallback) {
+  if (typeof value === 'boolean') {
+    return value;
+  }
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'true') {
+      return true;
+    }
+    if (normalized === 'false') {
+      return false;
+    }
+  }
+  return fallback;
+}
+
+function normalizeConfig(config = {}) {
+  const clamp01 = (value, fallback) => {
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+      return fallback;
+    }
+    return Math.min(1, Math.max(0, numericValue));
+  };
+  const positiveInteger = (value, fallback) => {
+    const numericValue = Number(value);
+    if (!Number.isFinite(numericValue)) {
+      return fallback;
+    }
+    return Math.max(1, Math.floor(numericValue));
+  };
+
+  return {
+    enabled: parseBoolean(config.enabled, DEFAULT_FAST_PATH_CONFIG.enabled),
+    externalExecutorsEnabled: parseBoolean(
+      config.externalExecutorsEnabled ?? config.external_executors_enabled,
+      DEFAULT_FAST_PATH_CONFIG.externalExecutorsEnabled,
+    ),
+    minConfidence: clamp01(
+      config.minConfidence ?? config.min_confidence,
+      DEFAULT_FAST_PATH_CONFIG.minConfidence,
+    ),
+    minBatchItems: positiveInteger(
+      config.minBatchItems ?? config.min_batch_items,
+      DEFAULT_FAST_PATH_CONFIG.minBatchItems,
+    ),
+    externalExecutorThreshold: clamp01(
+      config.externalExecutorThreshold ?? config.external_executor_threshold,
+      DEFAULT_FAST_PATH_CONFIG.externalExecutorThreshold,
+    ),
+  };
+}
+
+function normalizeTask(input = {}) {
+  const task = input.task || input;
+  return {
+    description: String(task.description || task.summary || task.title || ''),
+    files: Array.isArray(task.files) ? task.files : [],
+    acceptanceCriteria: Array.isArray(task.acceptanceCriteria)
+      ? task.acceptanceCriteria
+      : Array.isArray(task.acceptance_criteria)
+        ? task.acceptance_criteria
+        : [],
+    itemCount: Number.isFinite(task.itemCount)
+      ? task.itemCount
+      : Number.isFinite(task.item_count)
+        ? task.item_count
+        : null,
+  };
+}
+
+function normalizePathExtension(filePath) {
+  const match = String(filePath || '').toLowerCase().match(/(\.[a-z0-9]+)$/);
+  return match ? match[1] : '';
+}
+
+function collectSignals(patterns, text) {
+  return patterns
+    .filter(({ pattern }) => pattern.test(text))
+    .map(({ id, weight }) => ({ id, weight }));
+}
+
+function getTaskText(task) {
+  return [
+    task.description,
+    ...task.acceptanceCriteria.map((criterion) => String(criterion || '')),
+    ...task.files.map((file) => String(file || '')),
+  ].join('\n');
+}
+
+function scoreFastPath({ automationSignals, riskSignals, files, structuredFileCount, batchSize }) {
+  const automationWeight = automationSignals.reduce((sum, signal) => sum + signal.weight, 0);
+  const riskWeight = riskSignals.reduce((sum, signal) => sum + signal.weight, 0);
+  const fileWeight = Math.min(files.length, 8) * 0.45;
+  const structuredWeight = Math.min(structuredFileCount, 6) * 0.55;
+  const batchWeight = Math.min(batchSize, 10) * 0.35;
+
+  const rawScore = automationWeight + fileWeight + structuredWeight + batchWeight - riskWeight * 1.35;
+  return Math.max(0, Math.min(1, rawScore / 13));
+}
+
+function chooseMode({
+  confidence,
+  config,
+  externalExecutorsEnabled,
+  parallelizable,
+  structuredFileCount,
+  batchSize,
+}) {
+  if (externalExecutorsEnabled && confidence >= config.externalExecutorThreshold) {
+    return 'external_executor';
+  }
+
+  if (parallelizable && batchSize >= config.minBatchItems) {
+    return 'parallel_batch';
+  }
+
+  if (structuredFileCount > 0 || batchSize >= config.minBatchItems) {
+    return 'deterministic_batch';
+  }
+
+  return 'standard';
+}
+
+function buildActions(mode) {
+  if (mode === 'external_executor') {
+    return [
+      'Prepare a bounded prompt with target files, schema, acceptance criteria, and validation commands.',
+      'Run a dry-run plan first, then delegate with the configured external executor sandbox.',
+      'Review the executor diff before mutating story or issue state.',
+    ];
+  }
+
+  if (mode === 'parallel_batch') {
+    return [
+      'Map target files or records once before editing.',
+      'Group independent changes by file or record and apply them as a batch.',
+      'Run targeted validation on the changed surface before broader checks.',
+    ];
+  }
+
+  if (mode === 'deterministic_batch') {
+    return [
+      'Extract the data shape and replacement rules before editing.',
+      'Use a deterministic transform or structured parser instead of conversational one-by-one edits.',
+      'Validate output syntax and diff size before continuing.',
+    ];
+  }
+
+  return [
+    'Use the standard story/task workflow.',
+    'Keep changes sequential when risk or ambiguity is higher than the automation signal.',
+  ];
+}
+
+function evaluateFastPath(input = {}) {
+  const config = normalizeConfig(input.config || input.fastPath || {});
+  const task = normalizeTask(input);
+  const text = getTaskText(task);
+  const automationSignals = collectSignals(AUTOMATION_PATTERNS_FROZEN, text);
+  const riskSignals = collectSignals(RISK_PATTERNS_FROZEN, text);
+  const structuredFileCount = task.files.filter((file) => (
+    STRUCTURED_FILE_EXTENSION_SET.has(normalizePathExtension(file))
+  )).length;
+  const batchSize = task.itemCount ?? Math.max(task.files.length, structuredFileCount);
+  const parallelizable = (
+    task.files.length >= config.minBatchItems ||
+    automationSignals.some((signal) => signal.id === 'parallelizable')
+  );
+
+  if (!config.enabled) {
+    return {
+      gate: 'fast_path',
+      enabled: false,
+      passed: false,
+      mode: 'standard',
+      confidence: 0,
+      parallelizable: false,
+      riskLevel: 'unknown',
+      reasons: ['fast path gate disabled by configuration'],
+      evidence: { automationSignals: [], riskSignals: [], fileCount: task.files.length, structuredFileCount, batchSize },
+      actions: buildActions('standard'),
+    };
+  }
+
+  const confidence = scoreFastPath({
+    automationSignals,
+    riskSignals,
+    files: task.files,
+    structuredFileCount,
+    batchSize,
+  });
+  const passed = confidence >= config.minConfidence && riskSignals.length === 0;
+  const mode = passed
+    ? chooseMode({
+      confidence,
+      config,
+      externalExecutorsEnabled: parseBoolean(
+        input.externalExecutorsEnabled ?? input.external_executors_enabled,
+        config.externalExecutorsEnabled,
+      ),
+      parallelizable,
+      structuredFileCount,
+      batchSize,
+    })
+    : 'standard';
+  const riskLevel = riskSignals.length >= 2 ? 'high' : riskSignals.length === 1 ? 'medium' : 'low';
+  const reasons = [
+    ...automationSignals.map((signal) => `automation signal: ${signal.id}`),
+    ...riskSignals.map((signal) => `risk signal: ${signal.id}`),
+  ];
+
+  if (structuredFileCount > 0) {
+    reasons.push(`structured files detected: ${structuredFileCount}`);
+  }
+  if (batchSize >= config.minBatchItems) {
+    reasons.push(`batch size meets threshold: ${batchSize}`);
+  }
+  if (!passed && reasons.length === 0) {
+    reasons.push('insufficient automation signal for fast path');
+  }
+
+  return {
+    gate: 'fast_path',
+    enabled: true,
+    passed,
+    mode,
+    confidence,
+    parallelizable: passed && parallelizable,
+    riskLevel,
+    reasons,
+    evidence: {
+      automationSignals,
+      riskSignals,
+      fileCount: task.files.length,
+      structuredFileCount,
+      batchSize,
+    },
+    actions: buildActions(mode),
+  };
+}
+
+module.exports = {
+  DEFAULT_FAST_PATH_CONFIG,
+  evaluateFastPath,
+  getAutomationPatterns,
+  getRiskPatterns,
+  getStructuredFileExtensions,
+  normalizeConfig,
+  normalizeTask,
+};

package/.sinapse-ai/core/orchestration/index.js

@@ -145,6 +145,20 @@ const {
   PHASE_1_SEQUENCE,
 } = require('./greenfield-handler');
 
+// v1.5.0: Fast-Path Gate
+// Heuristic gate to decide when a task can be executed via a faster mode
+// (parallel_batch / deterministic_batch / external_executor) versus the
+// standard sequential workflow. Used as input to orchestrator decisions.
+const {
+  DEFAULT_FAST_PATH_CONFIG,
+  evaluateFastPath,
+  getAutomationPatterns,
+  getRiskPatterns,
+  getStructuredFileExtensions,
+  normalizeConfig: normalizeFastPathConfig,
+  normalizeTask: normalizeFastPathTask,
+} = require('./fast-path-gate');
+
 module.exports = {
   // Main orchestrators
   WorkflowOrchestrator,
@@ -319,5 +333,14 @@ module.exports = {
   GreenfieldPhaseFailureAction,
   DEFAULT_GREENFIELD_INDICATORS,
   PHASE_1_SEQUENCE,
+
+  // v1.5.0: Fast-Path Gate
+  DEFAULT_FAST_PATH_CONFIG,
+  evaluateFastPath,
+  getAutomationPatterns,
+  getRiskPatterns,
+  getStructuredFileExtensions,
+  normalizeFastPathConfig,
+  normalizeFastPathTask,
 };
 

package/.sinapse-ai/data/entity-registry.yaml

@@ -417,7 +417,7 @@ entities:
         constraints: []
         extensionPoints: []
         score: 0.3
-      checksum: sha256:208198d58f3f17bd5766ec6c70928c8ecda3db5645f03d134e2db0014149ee79
+      checksum: sha256:93210b103a23b23a7e1c7687a95cc9739bc264a0543b2a8d5c76fd00f8f1068c
       dependencies: []
       externalDeps: []
       keywords:
@@ -427,7 +427,7 @@ entities:
         - imperator
         - sinapse
         - master
-      lastVerified: '2026-05-07T21:34:53.806Z'
+      lastVerified: '2026-05-25T16:16:10.948Z'
       layer: L2
       lifecycle: orphan
       path: .sinapse-ai/development/agents/snps-orqx.md
@@ -3697,6 +3697,7 @@ entities:
       purpose: '''Let\''s start with the fundamental details about your agent'','
       type: module
       usedBy:
+        - index
         - index.esm
     agent-invoker:
       adaptability:
@@ -4472,6 +4473,7 @@ entities:
       type: module
       usedBy:
         - config-resolver
+        - index
         - index.esm
         - agent-config-loader
     config-loader:
@@ -4495,6 +4497,7 @@ entities:
       purpose: Entity at .sinapse-ai\core\config\config-loader.js
       type: module
       usedBy:
+        - index
         - index.esm
     config-migrator:
       adaptability:
@@ -4661,6 +4664,7 @@ entities:
       type: module
       usedBy:
         - context-loader
+        - index
         - index.esm
         - agent-exit-hooks
         - greeting-builder
@@ -4707,6 +4711,7 @@ entities:
       purpose: Entity at .sinapse-ai\core\session\context-loader.js
       type: module
       usedBy:
+        - index
         - index.esm
         - unified-activation-pipeline
         - context-loading
@@ -5338,8 +5343,7 @@ entities:
       plannedDeps: []
       purpose: Entity at .sinapse-ai\core\doctor\fix-handler.js
       type: module
-      usedBy:
-        - index
+      usedBy: []
     focus-area-recommender:
       adaptability:
         constraints: []
@@ -5939,22 +5943,30 @@ entities:
         constraints: []
         extensionPoints: []
         score: 0.4
-      checksum: sha256:4a1e6dacba9c1fe7866b2b8a0041837a63acbe5c072185e9f73f809b94de22a6
+      checksum: sha256:1096fccecd12c7b7e6219951048c57bbf6a413e965bd80ae677ad1fc4d5ff604
       dependencies:
-        - checks
-        - text
-        - json
-        - fix-handler
+        - config-cache
+        - config-loader
+        - context-detector
+        - context-loader
+        - elicitation-engine
+        - session-manager
+        - agent-elicitation
+        - task-elicitation
+        - workflow-elicitation
+        - output-formatter
+        - yaml-validator
+        - registry-loader
       externalDeps: []
       keywords:
         - index
-      lastVerified: '2026-05-15T01:57:39.086Z'
+      lastVerified: '2026-05-07T21:34:53.711Z'
       layer: L1
       lifecycle: experimental
       path: .sinapse-ai/core/index.js
       plannedDeps:
         - health-check
-      purpose: Entity at .sinapse-ai\core\doctor\index.js
+      purpose: Entity at .sinapse-ai\core\index.js
       type: module
       usedBy: []
     index.esm:
@@ -6004,8 +6016,7 @@ entities:
       plannedDeps: []
       purpose: Entity at .sinapse-ai\core\doctor\formatters\json.js
       type: module
-      usedBy:
-        - index
+      usedBy: []
     json-formatter:
       adaptability:
         constraints: []
@@ -6432,14 +6443,14 @@ entities:
         constraints: []
         extensionPoints: []
         score: 0.4
-      checksum: sha256:ffb698eed47364abccf28ce9d3a07529ac00096f6993a4d03359998b364e8329
+      checksum: sha256:c54afe044aec071ed0939a8cc2b99e9584597d3156d96f20afe57d5b83a05ffa
       dependencies: []
       externalDeps: []
       keywords:
         - manifest
         - version
         - parity
-      lastVerified: '2026-05-15T01:57:39.083Z'
+      lastVerified: '2026-05-07T21:34:53.750Z'
       layer: L1
       lifecycle: orphan
       path: .sinapse-ai/core/doctor/checks/manifest-version-parity.js
@@ -6738,13 +6749,13 @@ entities:
         constraints: []
         extensionPoints: []
         score: 0.4
-      checksum: sha256:b39b767646a65a387752071347fc4316cf5f63f3357915febf7079436e3e89af
+      checksum: sha256:558f8f4388085c5711853f2a6cc9f0e3fcf8c0558cc606ff1fe0ff746693e325
       dependencies: []
       externalDeps: []
       keywords:
         - npm
         - packages
-      lastVerified: '2026-05-15T01:57:39.085Z'
+      lastVerified: '2026-05-07T21:34:53.753Z'
       layer: L1
       lifecycle: orphan
       path: .sinapse-ai/core/doctor/checks/npm-packages.js
@@ -7231,6 +7242,7 @@ entities:
       usedBy:
         - code-intel-source
         - framework-governor
+        - index
         - registry-source
         - registry-syncer
     registry-provider:
@@ -7502,6 +7514,7 @@ entities:
       type: module
       usedBy:
         - elicitation-engine
+        - index
         - index.esm
     session-state:
       adaptability:
@@ -7612,13 +7625,13 @@ entities:
         constraints: []
         extensionPoints: []
         score: 0.4
-      checksum: sha256:2ed67974d87e3b4e4efa84527061f824eb8c79dc3a5925adb149870c6c0faf3c
+      checksum: sha256:4861a2330ce5f3c696d53fc768d1575e03c4efcd5a217185d392556d2b1576cc
       dependencies: []
       externalDeps: []
       keywords:
         - skills
         - count
-      lastVerified: '2026-05-15T01:57:39.085Z'
+      lastVerified: '2026-05-07T21:34:53.753Z'
       layer: L1
       lifecycle: orphan
       path: .sinapse-ai/core/doctor/checks/skills-count.js
@@ -7881,6 +7894,7 @@ entities:
       purpose: '''Define the fundamental details of your task'','
       type: module
       usedBy:
+        - index
         - index.esm
     tech-stack-detector:
       adaptability:
@@ -7961,8 +7975,7 @@ entities:
       plannedDeps: []
       purpose: ${pass} PASS | ${warn} WARN | ${fail} FAIL | ${info} INFO`);
       type: module
-      usedBy:
-        - index
+      usedBy: []
     timing-collector:
       adaptability:
         constraints: []
@@ -8162,6 +8175,7 @@ entities:
       purpose: '''Where should this workflow be created?'','
       type: module
       usedBy:
+        - index
         - index.esm
         - verify-workflow-gaps
     workflow-executor:
@@ -9408,6 +9422,7 @@ entities:
       usedBy:
         - batch-creator
         - component-generator
+        - index
         - index.esm
     elicitation-session-manager:
       adaptability:
@@ -16020,7 +16035,7 @@ entities:
         constraints: []
         extensionPoints: []
         score: 0.5
-      checksum: sha256:b8b0fb255878b246eae503c1cbef53dbcd5b14ed4907ef057eb129d11330c345
+      checksum: sha256:81ae9d16501e01fef5fea1e27fea006f27f262adf4b7394ee0ff52588b86b53b
       dependencies: []
       externalDeps: []
       keywords:
@@ -16029,7 +16044,7 @@ entities:
         - inline
         - greeting
         - template
-      lastVerified: '2026-05-07T21:34:53.663Z'
+      lastVerified: '2026-05-25T16:16:10.950Z'
       layer: L2
       lifecycle: orphan
       path: .sinapse-ai/product/templates/activation-instructions-inline-greeting.yaml
@@ -17052,6 +17067,7 @@ entities:
       purpose: Entity at .sinapse-ai\core\utils\output-formatter.js
       type: util
       usedBy:
+        - index
         - index.esm
         - next
     security-utils:
@@ -17094,6 +17110,7 @@ entities:
       usedBy:
         - component-generator
         - modification-validator
+        - index
         - index.esm
   workflows:
     auto-worktree:
@@ -17472,6 +17489,6 @@ entities:
 metadata:
   checksumAlgorithm: sha256
   entityCount: 756
-  lastUpdated: '2026-05-15T01:57:39.089Z'
+  lastUpdated: '2026-05-25T16:16:10.952Z'
   resolutionRate: 100
   version: 1.0.0

package/.sinapse-ai/data/registry-update-log.jsonl

@@ -2,3 +2,13 @@
 {"timestamp":"2026-05-15T01:57:39.085Z","action":"change","path":".sinapse-ai/core/doctor/checks/npm-packages.js","trigger":"watcher"}
 {"timestamp":"2026-05-15T01:57:39.085Z","action":"change","path":".sinapse-ai/core/doctor/checks/skills-count.js","trigger":"watcher"}
 {"timestamp":"2026-05-15T01:57:39.086Z","action":"change","path":".sinapse-ai/core/doctor/index.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T12:56:10.966Z","action":"add","path":".sinapse-ai/core/external-executors/delegate-cli.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T12:56:10.967Z","action":"add","path":".sinapse-ai/core/external-executors/index.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T12:56:10.968Z","action":"add","path":".sinapse-ai/core/orchestration/fast-path-gate.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T12:56:10.969Z","action":"change","path":".sinapse-ai/core/orchestration/index.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T13:00:14.097Z","action":"add","path":".sinapse-ai/core/external-executors/delegate-cli.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T13:00:14.098Z","action":"add","path":".sinapse-ai/core/external-executors/index.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T13:00:14.099Z","action":"add","path":".sinapse-ai/core/orchestration/fast-path-gate.js","trigger":"watcher"}
+{"timestamp":"2026-05-15T13:00:14.100Z","action":"change","path":".sinapse-ai/core/orchestration/index.js","trigger":"watcher"}
+{"timestamp":"2026-05-25T16:16:10.949Z","action":"change","path":".sinapse-ai/development/agents/snps-orqx.md","trigger":"watcher"}
+{"timestamp":"2026-05-25T16:16:10.950Z","action":"change","path":".sinapse-ai/product/templates/activation-instructions-inline-greeting.yaml","trigger":"watcher"}

package/.sinapse-ai/development/agents/snps-orqx.md

@@ -40,7 +40,7 @@ Then display:
  *help               — Show all commands and squad overview
 ```
 
-After the greeting, HALT and await user input. Do NOT do anything else.
+After the greeting, check if the user already provided briefing/context with the activation. If YES → proceed IMMEDIATELY to the NON-NEGOTIABLE ORCHESTRATION PLAN flow below (Imperator's core function). If NO (bare activation only) → await briefing. On receipt, plan automatically. NEVER ask "do you want me to plan?" — the answer is always YES for Imperator.
 
 If the user asks about SINAPSE, how it works, or how to use it, execute the `*onboard` task from `tasks/onboard-user.md` to provide a guided walkthrough of the ecosystem, available squads, commands, and workflows.