astrocode-workflow 0.1.55 → 0.1.57

package/dist/hooks/inject-provider.js

@@ -16,24 +16,76 @@ export function createInjectProvider(opts) {
     function markInjected(injectId, nowMs) {
         injectedCache.set(injectId, nowMs);
     }
+    function getInjectionDiagnostics(nowIso, scopeAllowlist, typeAllowlist) {
+        // Get ALL injects to analyze filtering
+        const allInjects = db.prepare("SELECT * FROM injects").all();
+        let total = allInjects.length;
+        let selected = 0;
+        let skippedExpired = 0;
+        let skippedScope = 0;
+        let skippedType = 0;
+        let eligibleIds = [];
+        for (const inject of allInjects) {
+            // Check expiration
+            if (inject.expires_at && inject.expires_at <= nowIso) {
+                skippedExpired++;
+                continue;
+            }
+            // Check scope
+            if (!scopeAllowlist.includes(inject.scope)) {
+                skippedScope++;
+                continue;
+            }
+            // Check type
+            if (!typeAllowlist.includes(inject.type)) {
+                skippedType++;
+                continue;
+            }
+            // This inject is eligible
+            selected++;
+            eligibleIds.push(inject.inject_id);
+        }
+        return {
+            now: nowIso,
+            scopes_considered: scopeAllowlist,
+            types_considered: typeAllowlist,
+            total_injects: total,
+            selected_eligible: selected,
+            skipped: {
+                expired: skippedExpired,
+                scope: skippedScope,
+                type: skippedType,
+            },
+            eligible_ids: eligibleIds,
+        };
+    }
     async function injectEligibleInjects(sessionId) {
         const now = nowISO();
         const nowMs = Date.now();
-        // Get eligible injects - use allowlists from config or defaults
+        // Get allowlists from config or defaults
         const scopeAllowlist = config.inject?.scope_allowlist ?? ["repo", "global"];
         const typeAllowlist = config.inject?.type_allowlist ?? ["note", "policy"];
+        // Get diagnostic data
+        const diagnostics = getInjectionDiagnostics(now, scopeAllowlist, typeAllowlist);
         const eligibleInjects = selectEligibleInjects(db, {
             nowIso: now,
             scopeAllowlist,
             typeAllowlist,
             limit: config.inject?.max_per_turn ?? 5,
         });
-        if (eligibleInjects.length === 0)
+        let injected = 0;
+        let skippedDeduped = 0;
+        if (eligibleInjects.length === 0) {
+            // Log when no injects are eligible
+            console.log(`[Astrocode:inject] ${now} selected=${diagnostics.selected_eligible} injected=0 skipped={expired:${diagnostics.skipped.expired} scope:${diagnostics.skipped.scope} type:${diagnostics.skipped.type} deduped:0}`);
             return;
+        }
         // Inject each eligible inject, skipping recently injected ones
         for (const inject of eligibleInjects) {
-            if (shouldSkipInject(inject.inject_id, nowMs))
+            if (shouldSkipInject(inject.inject_id, nowMs)) {
+                skippedDeduped++;
                 continue;
+            }
             // Format as injection message
             const formattedText = `[Inject: ${inject.title}]\n\n${inject.body_md}`;
             await injectChatPrompt({
@@ -42,8 +94,11 @@ export function createInjectProvider(opts) {
                 text: formattedText,
                 agent: "Astrocode"
             });
+            injected++;
             markInjected(inject.inject_id, nowMs);
         }
+        // Log diagnostic summary
+        console.log(`[Astrocode:inject] ${now} selected=${diagnostics.selected_eligible} injected=${injected} skipped={expired:${diagnostics.skipped.expired} scope:${diagnostics.skipped.scope} type:${diagnostics.skipped.type} deduped:${skippedDeduped}}`);
     }
     // Public hook handlers
     return {

package/dist/state/schema.d.ts

@@ -1,2 +1,2 @@
 export declare const SCHEMA_VERSION = 2;
-export declare const SCHEMA_SQL = "\nPRAGMA foreign_keys = ON;\n\nCREATE TABLE IF NOT EXISTS repo_state (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  schema_version INTEGER NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  spec_hash_before TEXT,\n  spec_hash_after TEXT,\n  last_run_id TEXT,\n  last_story_key TEXT,\n  last_event_at TEXT\n);\n\nCREATE TABLE IF NOT EXISTS settings (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS epics (\n  epic_key TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL DEFAULT '',\n  state TEXT NOT NULL DEFAULT 'active',\n  priority INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS story_drafts (\n  draft_id TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL DEFAULT '',\n  meta_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS story_keyseq (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  next_story_num INTEGER NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS stories (\n  story_key TEXT PRIMARY KEY,\n  epic_key TEXT,\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL DEFAULT '',\n  state TEXT NOT NULL DEFAULT 'queued', -- queued|approved|in_progress|done|blocked|archived\n  priority INTEGER NOT NULL DEFAULT 0,\n  approved_at TEXT,\n  locked_by_run_id TEXT,\n  locked_at TEXT,\n  in_progress INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY (epic_key) REFERENCES epics(epic_key)\n);\n\nCREATE TABLE IF NOT EXISTS runs (\n  run_id TEXT PRIMARY KEY,\n  story_key TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'created', -- created|running|completed|failed|aborted\n  pipeline_stages_json TEXT NOT NULL DEFAULT '[]',\n  current_stage_key TEXT,\n  created_at TEXT NOT NULL,\n  started_at TEXT,\n  completed_at TEXT,\n  updated_at TEXT NOT NULL,\n  error_text TEXT,\n  FOREIGN KEY (story_key) REFERENCES stories(story_key)\n);\n\nCREATE TABLE IF NOT EXISTS stage_runs (\n  stage_run_id TEXT PRIMARY KEY,\n  run_id TEXT NOT NULL,\n  stage_key TEXT NOT NULL,\n  stage_index INTEGER NOT NULL,\n  status TEXT NOT NULL DEFAULT 'pending', -- pending|running|completed|failed|skipped\n  created_at TEXT NOT NULL,\n  subagent_type TEXT,\n  subagent_session_id TEXT,\n  started_at TEXT,\n  completed_at TEXT,\n  updated_at TEXT NOT NULL,\n  baton_path TEXT,\n  summary_md TEXT,\n  output_json TEXT,\n  error_text TEXT,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS artifacts (\n  artifact_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  type TEXT NOT NULL, -- plan|baton|evidence|diff|log|summary|commit|tool_output|snapshot\n  path TEXT NOT NULL,\n  sha256 TEXT,\n  meta_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS tool_runs (\n  tool_run_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  tool_name TEXT NOT NULL,\n  args_json TEXT NOT NULL DEFAULT '{}',\n  output_summary TEXT NOT NULL DEFAULT '',\n  output_artifact_id TEXT,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS events (\n  event_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  type TEXT NOT NULL,\n  body_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS injects (\n  inject_id TEXT PRIMARY KEY,\n  type TEXT NOT NULL DEFAULT 'note',\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL,\n  tags_json TEXT NOT NULL DEFAULT '[]',\n  scope TEXT NOT NULL DEFAULT 'repo', -- repo|run:<id>|story:<key>|global\n  source TEXT NOT NULL DEFAULT 'user', -- user|tool|agent|import\n  priority INTEGER NOT NULL DEFAULT 50,\n  expires_at TEXT,\n  sha256 TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS running_batches (\n  batch_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  session_id TEXT,\n  status TEXT NOT NULL DEFAULT 'running', -- running|completed|failed|aborted\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS workflow_metrics (\n  metric_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  name TEXT NOT NULL,\n  value_num REAL,\n  value_text TEXT,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS template_intents (\n  intent_key TEXT PRIMARY KEY,\n  body_md TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\n-- vNext tables\n\nCREATE TABLE IF NOT EXISTS story_relations (\n  parent_story_key TEXT NOT NULL,\n  child_story_key TEXT NOT NULL,\n  relation_type TEXT NOT NULL DEFAULT 'split',\n  reason TEXT NOT NULL DEFAULT '',\n  created_at TEXT NOT NULL,\n  PRIMARY KEY (parent_story_key, child_story_key),\n  FOREIGN KEY (parent_story_key) REFERENCES stories(story_key),\n  FOREIGN KEY (child_story_key) REFERENCES stories(story_key)\n);\n\nCREATE TABLE IF NOT EXISTS continuations (\n  continuation_id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  run_id TEXT,\n  directive_hash TEXT NOT NULL,\n  kind TEXT NOT NULL, -- continue|stage|blocked|repair\n  reason TEXT NOT NULL DEFAULT '',\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_continuations_session_created ON continuations(session_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_continuations_run_created ON continuations(run_id, created_at DESC);\n\nCREATE TABLE IF NOT EXISTS context_snapshots (\n  snapshot_id TEXT PRIMARY KEY,\n  run_id TEXT NOT NULL,\n  stage_key TEXT NOT NULL,\n  summary_md TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_context_snapshots_run_created ON context_snapshots(run_id, created_at DESC);\n\nCREATE TABLE IF NOT EXISTS agent_sessions (\n  session_id TEXT PRIMARY KEY,\n  parent_session_id TEXT,\n  agent_name TEXT NOT NULL,\n  run_id TEXT,\n  stage_key TEXT,\n  status TEXT NOT NULL DEFAULT 'active',\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\n-- Indexes\n\nCREATE INDEX IF NOT EXISTS idx_stories_state ON stories(state);\nCREATE INDEX IF NOT EXISTS idx_runs_story ON runs(story_key);\nCREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status);\nCREATE INDEX IF NOT EXISTS idx_stage_runs_run ON stage_runs(run_id, stage_index);\nCREATE INDEX IF NOT EXISTS idx_artifacts_run_stage ON artifacts(run_id, stage_key, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_events_run ON events(run_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_tool_runs_run ON tool_runs(run_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_injects_scope_priority ON injects(scope, priority DESC, created_at DESC);\n\n-- Stronger invariants (SQLite partial indexes)\n-- Only one run may be 'running' at a time (single-repo harness by default).\nCREATE UNIQUE INDEX IF NOT EXISTS uniq_single_running_run\n  ON runs(status)\n  WHERE status = 'running';\n\n-- Only one story may be in_progress=1 at a time (pairs with single running run).\nCREATE UNIQUE INDEX IF NOT EXISTS uniq_single_in_progress_story\n  ON stories(in_progress)\n  WHERE in_progress = 1;\n\n";
+export declare const SCHEMA_SQL = "\nPRAGMA foreign_keys = ON;\n\nCREATE TABLE IF NOT EXISTS repo_state (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  schema_version INTEGER NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  spec_hash_before TEXT,\n  spec_hash_after TEXT,\n  last_run_id TEXT,\n  last_story_key TEXT,\n  last_event_at TEXT\n);\n\nCREATE TABLE IF NOT EXISTS settings (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS epics (\n  epic_key TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL DEFAULT '',\n  state TEXT NOT NULL DEFAULT 'active',\n  priority INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS story_drafts (\n  draft_id TEXT PRIMARY KEY,\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL DEFAULT '',\n  meta_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS story_keyseq (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  next_story_num INTEGER NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS stories (\n  story_key TEXT PRIMARY KEY,\n  epic_key TEXT,\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL DEFAULT '',\n  state TEXT NOT NULL DEFAULT 'queued', -- queued|approved|in_progress|done|blocked|archived\n  priority INTEGER NOT NULL DEFAULT 0,\n  approved_at TEXT,\n  locked_by_run_id TEXT,\n  locked_at TEXT,\n  in_progress INTEGER NOT NULL DEFAULT 0,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY (epic_key) REFERENCES epics(epic_key)\n);\n\nCREATE TABLE IF NOT EXISTS runs (\n  run_id TEXT PRIMARY KEY,\n  story_key TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'created', -- created|running|completed|failed|aborted\n  pipeline_stages_json TEXT NOT NULL DEFAULT '[]',\n  current_stage_key TEXT,\n  created_at TEXT NOT NULL,\n  started_at TEXT,\n  completed_at TEXT,\n  updated_at TEXT NOT NULL,\n  error_text TEXT,\n  FOREIGN KEY (story_key) REFERENCES stories(story_key)\n);\n\nCREATE TABLE IF NOT EXISTS stage_runs (\n  stage_run_id TEXT PRIMARY KEY,\n  run_id TEXT NOT NULL,\n  stage_key TEXT NOT NULL,\n  stage_index INTEGER NOT NULL,\n  status TEXT NOT NULL DEFAULT 'pending', -- pending|running|completed|failed|skipped\n  created_at TEXT NOT NULL,\n  subagent_type TEXT,\n  subagent_session_id TEXT,\n  started_at TEXT,\n  completed_at TEXT,\n  updated_at TEXT NOT NULL,\n  baton_path TEXT,\n  summary_md TEXT,\n  output_json TEXT,\n  error_text TEXT,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS artifacts (\n  artifact_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  type TEXT NOT NULL, -- plan|baton|evidence|diff|log|summary|commit|tool_output|snapshot\n  path TEXT NOT NULL,\n  sha256 TEXT,\n  meta_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS tool_runs (\n  tool_run_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  tool_name TEXT NOT NULL,\n  args_json TEXT NOT NULL DEFAULT '{}',\n  output_summary TEXT NOT NULL DEFAULT '',\n  output_artifact_id TEXT,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS events (\n  event_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  type TEXT NOT NULL,\n  body_json TEXT NOT NULL DEFAULT '{}',\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS injects (\n  inject_id TEXT PRIMARY KEY,\n  type TEXT NOT NULL DEFAULT 'note',\n  title TEXT NOT NULL,\n  body_md TEXT NOT NULL,\n  tags_json TEXT NOT NULL DEFAULT '[]',\n  scope TEXT NOT NULL DEFAULT 'repo', -- repo|run:<id>|story:<key>|global\n  source TEXT NOT NULL DEFAULT 'user', -- user|tool|agent|import\n  priority INTEGER NOT NULL DEFAULT 50,\n  expires_at TEXT,\n  sha256 TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS running_batches (\n  batch_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  session_id TEXT,\n  status TEXT NOT NULL DEFAULT 'running', -- running|completed|failed|aborted\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS workflow_metrics (\n  metric_id TEXT PRIMARY KEY,\n  run_id TEXT,\n  stage_key TEXT,\n  name TEXT NOT NULL,\n  value_num REAL,\n  value_text TEXT,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS template_intents (\n  intent_key TEXT PRIMARY KEY,\n  body_md TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\n-- vNext tables\n\nCREATE TABLE IF NOT EXISTS story_relations (\n  parent_story_key TEXT NOT NULL,\n  child_story_key TEXT NOT NULL,\n  relation_type TEXT NOT NULL DEFAULT 'split',\n  reason TEXT NOT NULL DEFAULT '',\n  created_at TEXT NOT NULL,\n  PRIMARY KEY (parent_story_key, child_story_key),\n  FOREIGN KEY (parent_story_key) REFERENCES stories(story_key),\n  FOREIGN KEY (child_story_key) REFERENCES stories(story_key)\n);\n\nCREATE TABLE IF NOT EXISTS continuations (\n  continuation_id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  run_id TEXT,\n  directive_hash TEXT NOT NULL,\n  kind TEXT NOT NULL, -- continue|stage|blocked|repair\n  reason TEXT NOT NULL DEFAULT '',\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_continuations_session_created ON continuations(session_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_continuations_run_created ON continuations(run_id, created_at DESC);\n\nCREATE TABLE IF NOT EXISTS context_snapshots (\n  snapshot_id TEXT PRIMARY KEY,\n  run_id TEXT NOT NULL,\n  stage_key TEXT NOT NULL,\n  summary_md TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_context_snapshots_run_created ON context_snapshots(run_id, created_at DESC);\n\nCREATE TABLE IF NOT EXISTS agent_sessions (\n  session_id TEXT PRIMARY KEY,\n  parent_session_id TEXT,\n  agent_name TEXT NOT NULL,\n  run_id TEXT,\n  stage_key TEXT,\n  status TEXT NOT NULL DEFAULT 'active',\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\n-- Indexes\n\nCREATE INDEX IF NOT EXISTS idx_stories_state ON stories(state);\nCREATE INDEX IF NOT EXISTS idx_runs_story ON runs(story_key);\nCREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status);\nCREATE INDEX IF NOT EXISTS idx_stage_runs_run ON stage_runs(run_id, stage_index);\nCREATE INDEX IF NOT EXISTS idx_artifacts_run_stage ON artifacts(run_id, stage_key, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_events_run ON events(run_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_tool_runs_run ON tool_runs(run_id, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_injects_scope_priority ON injects(scope, priority DESC, created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_injects_scope_type_priority_updated ON injects(scope, type, priority DESC, updated_at DESC);\nCREATE INDEX IF NOT EXISTS idx_injects_expires ON injects(expires_at) WHERE expires_at IS NOT NULL;\nCREATE INDEX IF NOT EXISTS idx_injects_sha256 ON injects(sha256) WHERE sha256 IS NOT NULL;\n\n-- Stronger invariants (SQLite partial indexes)\n-- Only one run may be 'running' at a time (single-repo harness by default).\nCREATE UNIQUE INDEX IF NOT EXISTS uniq_single_running_run\n  ON runs(status)\n  WHERE status = 'running';\n\n-- Only one story may be in_progress=1 at a time (pairs with single running run).\nCREATE UNIQUE INDEX IF NOT EXISTS uniq_single_in_progress_story\n  ON stories(in_progress)\n  WHERE in_progress = 1;\n\n";

package/dist/state/schema.js

@@ -233,6 +233,9 @@ CREATE INDEX IF NOT EXISTS idx_artifacts_run_stage ON artifacts(run_id, stage_ke
 CREATE INDEX IF NOT EXISTS idx_events_run ON events(run_id, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_tool_runs_run ON tool_runs(run_id, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_injects_scope_priority ON injects(scope, priority DESC, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_injects_scope_type_priority_updated ON injects(scope, type, priority DESC, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_injects_expires ON injects(expires_at) WHERE expires_at IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_injects_sha256 ON injects(sha256) WHERE sha256 IS NOT NULL;
 
 -- Stronger invariants (SQLite partial indexes)
 -- Only one run may be 'running' at a time (single-repo harness by default).

package/dist/tools/index.js

@@ -6,7 +6,7 @@ import { createAstroRunGetTool, createAstroRunAbortTool } from "./run";
 import { createAstroWorkflowProceedTool } from "./workflow";
 import { createAstroStageStartTool, createAstroStageCompleteTool, createAstroStageFailTool, createAstroStageResetTool } from "./stage";
 import { createAstroArtifactPutTool, createAstroArtifactListTool, createAstroArtifactGetTool } from "./artifacts";
-import { createAstroInjectPutTool, createAstroInjectListTool, createAstroInjectSearchTool, createAstroInjectGetTool } from "./injects";
+import { createAstroInjectPutTool, createAstroInjectListTool, createAstroInjectSearchTool, createAstroInjectGetTool, createAstroInjectEligibleTool, createAstroInjectDebugDueTool } from "./injects";
 import { createAstroRepairTool } from "./repair";
 export function createAstroTools(opts) {
     const { ctx, config, db, agents } = opts;
@@ -39,6 +39,8 @@ export function createAstroTools(opts) {
         tools.astro_inject_list = createAstroInjectListTool({ ctx, config, db });
         tools.astro_inject_search = createAstroInjectSearchTool({ ctx, config, db });
         tools.astro_inject_get = createAstroInjectGetTool({ ctx, config, db });
+        tools.astro_inject_eligible = createAstroInjectEligibleTool({ ctx, config, db });
+        tools.astro_inject_debug_due = createAstroInjectDebugDueTool({ ctx, config, db });
         tools.astro_repair = createAstroRepairTool({ ctx, config, db });
     }
     else {

package/dist/tools/injects.d.ts

@@ -46,3 +46,8 @@ export declare function createAstroInjectEligibleTool(opts: {
     config: AstrocodeConfig;
     db: SqliteDb;
 }): ToolDefinition;
+export declare function createAstroInjectDebugDueTool(opts: {
+    ctx: any;
+    config: AstrocodeConfig;
+    db: SqliteDb;
+}): ToolDefinition;

package/dist/tools/injects.js

@@ -1,6 +1,29 @@
 import { tool } from "@opencode-ai/plugin/tool";
+import { withTx } from "../state/db";
 import { nowISO } from "../shared/time";
 import { sha256Hex } from "../shared/hash";
+const VALID_INJECT_TYPES = ['note', 'policy', 'reminder', 'debug'];
+function validateInjectType(type) {
+    if (!VALID_INJECT_TYPES.includes(type)) {
+        throw new Error(`Invalid inject type "${type}". Must be one of: ${VALID_INJECT_TYPES.join(', ')}`);
+    }
+    return type;
+}
+function validateTimestamp(timestamp) {
+    if (!timestamp)
+        return null;
+    // Check if it's a valid ISO 8601 timestamp with Z suffix
+    const isoRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/;
+    if (!isoRegex.test(timestamp)) {
+        throw new Error(`Invalid timestamp format. Expected ISO 8601 UTC with Z suffix (e.g., "2026-01-23T13:05:19.000Z"), got: "${timestamp}"`);
+    }
+    // Additional validation: ensure it's parseable and represents a valid date
+    const parsed = new Date(timestamp);
+    if (isNaN(parsed.getTime())) {
+        throw new Error(`Invalid timestamp: "${timestamp}" does not represent a valid date`);
+    }
+    return timestamp;
+}
 function newInjectId() {
     return `inj_${Date.now()}_${Math.random().toString(16).slice(2)}`;
 }
@@ -23,13 +46,33 @@ export function createAstroInjectPutTool(opts) {
             const id = inject_id ?? newInjectId();
             const now = nowISO();
             const sha = sha256Hex(body_md);
-            const existing = db.prepare("SELECT inject_id FROM injects WHERE inject_id=?").get(id);
-            if (existing) {
-                db.prepare("UPDATE injects SET type=?, title=?, body_md=?, tags_json=?, scope=?, source=?, priority=?, expires_at=?, sha256=?, updated_at=? WHERE inject_id=?").run(type, title, body_md, tags_json, scope, source, priority, expires_at ?? null, sha, now, id);
-                return `✅ Updated inject ${id}: ${title}`;
-            }
-            db.prepare("INSERT INTO injects (inject_id, type, title, body_md, tags_json, scope, source, priority, expires_at, sha256, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").run(id, type, title, body_md, tags_json, scope, source, priority, expires_at ?? null, sha, now, now);
-            return `✅ Created inject ${id}: ${title}`;
+            // Validate inputs
+            const validatedType = validateInjectType(type);
+            const validatedExpiresAt = validateTimestamp(expires_at);
+            return withTx(db, () => {
+                const existing = db.prepare("SELECT inject_id FROM injects WHERE inject_id=?").get(id);
+                if (existing) {
+                    // Use INSERT ... ON CONFLICT for atomic updates
+                    db.prepare(`
+            INSERT INTO injects (inject_id, type, title, body_md, tags_json, scope, source, priority, expires_at, sha256, created_at, updated_at)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+            ON CONFLICT(inject_id) DO UPDATE SET
+              type=excluded.type,
+              title=excluded.title,
+              body_md=excluded.body_md,
+              tags_json=excluded.tags_json,
+              scope=excluded.scope,
+              source=excluded.source,
+              priority=excluded.priority,
+              expires_at=excluded.expires_at,
+              sha256=excluded.sha256,
+              updated_at=excluded.updated_at
+          `).run(id, type, title, body_md, tags_json, scope, source, priority, validatedExpiresAt, sha, now, now);
+                    return `✅ Updated inject ${id}: ${title}`;
+                }
+                db.prepare("INSERT INTO injects (inject_id, type, title, body_md, tags_json, scope, source, priority, expires_at, sha256, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").run(id, validatedType, title, body_md, tags_json, scope, source, priority, validatedExpiresAt, sha, now, now);
+                return `✅ Created inject ${id}: ${title}`;
+            });
         },
     });
 }
@@ -137,3 +180,82 @@ export function createAstroInjectEligibleTool(opts) {
         },
     });
 }
+export function createAstroInjectDebugDueTool(opts) {
+    const { db } = opts;
+    return tool({
+        description: "Debug: show comprehensive injection diagnostics - why injects were selected/skipped.",
+        args: {
+            scopes_json: tool.schema.string().default('["repo","global"]'),
+            types_json: tool.schema.string().default('["note","policy"]'),
+        },
+        execute: async ({ scopes_json, types_json }) => {
+            const now = nowISO();
+            const scopes = JSON.parse(scopes_json);
+            const types = JSON.parse(types_json);
+            // Get ALL injects to analyze filtering
+            const allInjects = db.prepare("SELECT * FROM injects").all();
+            let total = allInjects.length;
+            let selected = 0;
+            let skippedExpired = 0;
+            let skippedScope = 0;
+            let skippedType = 0;
+            const excludedReasons = [];
+            const selectedInjects = [];
+            for (const inject of allInjects) {
+                const reasons = [];
+                // Check expiration
+                if (inject.expires_at && inject.expires_at <= now) {
+                    reasons.push("expired");
+                    skippedExpired++;
+                }
+                // Check scope
+                if (!scopes.includes(inject.scope)) {
+                    reasons.push("scope");
+                    skippedScope++;
+                }
+                // Check type
+                if (!types.includes(inject.type)) {
+                    reasons.push("type");
+                    skippedType++;
+                }
+                if (reasons.length > 0) {
+                    excludedReasons.push({
+                        inject_id: inject.inject_id,
+                        title: inject.title,
+                        reasons: reasons,
+                        scope: inject.scope,
+                        type: inject.type,
+                        expires_at: inject.expires_at,
+                    });
+                }
+                else {
+                    selected++;
+                    selectedInjects.push({
+                        inject_id: inject.inject_id,
+                        title: inject.title,
+                        scope: inject.scope,
+                        type: inject.type,
+                        expires_at: inject.expires_at,
+                    });
+                }
+            }
+            return JSON.stringify({
+                now,
+                scopes_considered: scopes,
+                types_considered: types,
+                summary: {
+                    total_injects: total,
+                    selected_eligible: selected,
+                    excluded_total: total - selected,
+                    skipped_breakdown: {
+                        expired: skippedExpired,
+                        scope: skippedScope,
+                        type: skippedType,
+                    }
+                },
+                selected_injects: selectedInjects,
+                excluded_injects: excludedReasons,
+            }, null, 2);
+        },
+    });
+}

package/dist/tools/workflow.d.ts

@@ -1,6 +1,9 @@
 import { type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { AstrocodeConfig } from "../config/schema";
 import type { SqliteDb } from "../state/db";
+import type { StageKey } from "../state/types";
+export declare const STAGE_TO_AGENT_MAP: Record<string, string>;
+export declare function resolveAgentName(stageKey: StageKey, config: AstrocodeConfig, agents?: any, warnings?: string[]): string;
 import { AgentConfig } from "@opencode-ai/sdk";
 export declare function createAstroWorkflowProceedTool(opts: {
     ctx: any;

package/dist/tools/workflow.js

@@ -9,7 +9,7 @@ import { newEventId } from "../state/ids";
 import { debug } from "../shared/log";
 import { createToastManager } from "../ui/toasts";
 // Agent name mapping for case-sensitive resolution
-const STAGE_TO_AGENT_MAP = {
+export const STAGE_TO_AGENT_MAP = {
     frame: "Frame",
     plan: "Plan",
     spec: "Spec",
@@ -18,13 +18,39 @@ const STAGE_TO_AGENT_MAP = {
     verify: "Verify",
     close: "Close"
 };
-function resolveAgentName(stageKey, config) {
+export function resolveAgentName(stageKey, config, agents, warnings) {
     // Use configurable agent names from config, fallback to hardcoded map, then General
     const agentNames = config.agents?.stage_agent_names;
+    let candidate;
     if (agentNames && agentNames[stageKey]) {
-        return agentNames[stageKey];
+        candidate = agentNames[stageKey];
     }
-    return STAGE_TO_AGENT_MAP[stageKey] || "General";
+    else {
+        candidate = STAGE_TO_AGENT_MAP[stageKey] || "General";
+    }
+    // Validate that the agent actually exists in the registry
+    if (agents && !agents[candidate]) {
+        const warning = `Agent "${candidate}" not found in registry for stage "${stageKey}". Falling back to General.`;
+        if (warnings) {
+            warnings.push(warning);
+        }
+        else {
+            console.warn(`[Astrocode] ${warning}`);
+        }
+        candidate = "General";
+    }
+    // Final guard: ensure General exists, fallback to built-in "general" if not
+    if (agents && !agents[candidate]) {
+        const finalWarning = `Critical: General agent not found in registry. Falling back to built-in "general".`;
+        if (warnings) {
+            warnings.push(finalWarning);
+        }
+        else {
+            console.warn(`[Astrocode] ${finalWarning}`);
+        }
+        return "general"; // built-in, guaranteed by OpenCode
+    }
+    return candidate;
 }
 function stageGoal(stage, cfg) {
     switch (stage) {
@@ -99,6 +125,7 @@ export function createAstroWorkflowProceedTool(opts) {
             const sessionId = ctx.sessionID;
             const steps = Math.min(max_steps, config.workflow.loop_max_steps_hard_cap);
             const actions = [];
+            const warnings = [];
             const startedAt = nowISO();
             for (let i = 0; i < steps; i++) {
                 const next = decideNextAction(db, config);
@@ -172,7 +199,7 @@ export function createAstroWorkflowProceedTool(opts) {
                     const run = db.prepare("SELECT * FROM runs WHERE run_id=?").get(active.run_id);
                     const story = db.prepare("SELECT * FROM stories WHERE story_key=?").get(run.story_key);
                     // Mark stage started + set subagent_type to the stage agent.
-                    let agentName = resolveAgentName(next.stage_key, config);
+                    let agentName = resolveAgentName(next.stage_key, config, agents, warnings);
                     // Validate agent availability with fallback chain
                     const systemConfig = config;
                     // Check both the system config agent map (if present) OR the local agents map passed to the tool
@@ -193,15 +220,23 @@ export function createAstroWorkflowProceedTool(opts) {
                         return false;
                     };
                     if (!agentExists(agentName)) {
+                        const originalAgent = agentName;
                         console.warn(`[Astrocode] Agent ${agentName} not found in config. Falling back to orchestrator.`);
-                        // Skip General fallback for stage agents to avoid malformed output
+                        // First fallback: orchestrator
                         agentName = config.agents?.orchestrator_name || "Astro";
                         if (!agentExists(agentName)) {
-                            throw new Error(`Critical: No agents available for delegation. Primary: ${resolveAgentName(next.stage_key, config)}, Orchestrator: ${agentName}`);
+                            console.warn(`[Astrocode] Orchestrator ${agentName} not available. Falling back to General.`);
+                            // Final fallback: General (guaranteed to exist)
+                            agentName = "General";
+                            if (!agentExists(agentName)) {
+                                throw new Error(`Critical: No agents available for delegation. Primary: ${originalAgent}, Orchestrator: ${config.agents?.orchestrator_name || "Astro"}, General: unavailable`);
+                            }
                         }
                     }
                     withTx(db, () => {
                         startStage(db, active.run_id, next.stage_key, { subagent_type: agentName });
+                        // Log delegation observability
+                        console.log(`[Astrocode:delegate] run_id=${active.run_id} stage=${next.stage_key} agent=${agentName} fallback=${agentName !== resolveAgentName(next.stage_key, config, agents) ? 'yes' : 'no'}`);
                     });
                     if (config.ui.toasts.enabled && config.ui.toasts.show_stage_started) {
                         await toasts.show({ title: "Astrocode", message: `Stage started: ${next.stage_key}`, variant: "info" });
@@ -291,6 +326,11 @@ export function createAstroWorkflowProceedTool(opts) {
             lines.push(``, `## Actions`);
             for (const a of actions)
                 lines.push(`- ${a}`);
+            if (warnings.length > 0) {
+                lines.push(``, `## Warnings`);
+                for (const w of warnings)
+                    lines.push(`⚠️ ${w}`);
+            }
             return lines.join("\n").trim();
         },
     });

package/dist/workflow/context.d.ts

@@ -4,6 +4,14 @@ import type { RunRow, StageRunRow, StoryRow } from "../state/types";
 export declare function getRun(db: SqliteDb, runId: string): RunRow | null;
 export declare function getStory(db: SqliteDb, storyKey: string): StoryRow | null;
 export declare function listStageRuns(db: SqliteDb, runId: string): StageRunRow[];
+/**
+ * Check if a context snapshot is stale by comparing DB timestamps
+ */
+export declare function isContextSnapshotStale(snapshotText: string, db: SqliteDb, maxAgeSeconds?: number): boolean;
+/**
+ * Add staleness indicator to context snapshot if needed
+ */
+export declare function addStalenessIndicator(snapshotText: string, db: SqliteDb, maxAgeSeconds?: number): string;
 export declare function buildContextSnapshot(opts: {
     db: SqliteDb;
     config: AstrocodeConfig;

package/dist/workflow/context.js

@@ -27,6 +27,49 @@ function statusIcon(status) {
             return "⬜";
     }
 }
+/**
+ * Check if a context snapshot is stale by comparing DB timestamps
+ */
+export function isContextSnapshotStale(snapshotText, db, maxAgeSeconds = 300) {
+    // Extract run_id from snapshot
+    const runIdMatch = snapshotText.match(/Run: `([^`]+)`/);
+    if (!runIdMatch)
+        return true; // Can't validate without run_id
+    const runId = runIdMatch[1];
+    // Extract snapshot's claimed updated_at
+    const snapshotUpdatedMatch = snapshotText.match(/updated: ([^\)]+)\)/);
+    if (!snapshotUpdatedMatch)
+        return true; // Fallback to age-based check
+    try {
+        const snapshotUpdatedAt = snapshotUpdatedMatch[1];
+        const currentRun = db.prepare("SELECT updated_at FROM runs WHERE run_id = ?").get(runId);
+        if (!currentRun?.updated_at)
+            return true; // Run doesn't exist
+        // Compare timestamps - if DB is newer than snapshot claims, snapshot is stale
+        const snapshotTime = new Date(snapshotUpdatedAt).getTime();
+        const currentTime = new Date(currentRun.updated_at).getTime();
+        return currentTime > snapshotTime;
+    }
+    catch (error) {
+        // Fallback to age-based staleness if parsing fails
+        const timestampMatch = snapshotText.match(/generated: (\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z)/);
+        if (!timestampMatch)
+            return false;
+        const generatedAt = new Date(timestampMatch[1]);
+        const now = new Date();
+        const ageSeconds = (now.getTime() - generatedAt.getTime()) / 1000;
+        return ageSeconds > maxAgeSeconds;
+    }
+}
+/**
+ * Add staleness indicator to context snapshot if needed
+ */
+export function addStalenessIndicator(snapshotText, db, maxAgeSeconds = 300) {
+    if (isContextSnapshotStale(snapshotText, db, maxAgeSeconds)) {
+        return snapshotText.replace(/# Astrocode Context \(generated: ([^\)]+)\)/, "# Astrocode Context (generated: $1) ⚠️ STALE - DB state has changed");
+    }
+    return snapshotText;
+}
 export function buildContextSnapshot(opts) {
     const { db, config, run_id, next_action } = opts;
     const run = getRun(db, run_id);
@@ -35,8 +78,11 @@ export function buildContextSnapshot(opts) {
     const story = getStory(db, run.story_key);
     const stageRuns = listStageRuns(db, run_id);
     const lines = [];
-    lines.push(`# Astrocode Context`);
-    lines.push(`- Run: \`${run.run_id}\`  Status: **${run.status}**`);
+    // Add timestamps for staleness checking
+    const now = new Date();
+    const timestamp = now.toISOString();
+    lines.push(`# Astrocode Context (generated: ${timestamp})`);
+    lines.push(`- Run: \`${run.run_id}\`  Status: **${run.status}** (updated: ${run.updated_at})`);
     if (run.current_stage_key)
         lines.push(`- Current stage: \`${run.current_stage_key}\``);
     if (next_action)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astrocode-workflow",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/hooks/inject-provider.ts

@@ -32,14 +32,67 @@ export function createInjectProvider(opts: {
     injectedCache.set(injectId, nowMs);
   }
 
+  function getInjectionDiagnostics(nowIso: string, scopeAllowlist: string[], typeAllowlist: string[]): any {
+    // Get ALL injects to analyze filtering
+    const allInjects = db.prepare("SELECT * FROM injects").all() as any[];
+
+    let total = allInjects.length;
+    let selected = 0;
+    let skippedExpired = 0;
+    let skippedScope = 0;
+    let skippedType = 0;
+    let eligibleIds: string[] = [];
+
+    for (const inject of allInjects) {
+      // Check expiration
+      if (inject.expires_at && inject.expires_at <= nowIso) {
+        skippedExpired++;
+        continue;
+      }
+
+      // Check scope
+      if (!scopeAllowlist.includes(inject.scope)) {
+        skippedScope++;
+        continue;
+      }
+
+      // Check type
+      if (!typeAllowlist.includes(inject.type)) {
+        skippedType++;
+        continue;
+      }
+
+      // This inject is eligible
+      selected++;
+      eligibleIds.push(inject.inject_id);
+    }
+
+    return {
+      now: nowIso,
+      scopes_considered: scopeAllowlist,
+      types_considered: typeAllowlist,
+      total_injects: total,
+      selected_eligible: selected,
+      skipped: {
+        expired: skippedExpired,
+        scope: skippedScope,
+        type: skippedType,
+      },
+      eligible_ids: eligibleIds,
+    };
+  }
+
   async function injectEligibleInjects(sessionId: string) {
     const now = nowISO();
     const nowMs = Date.now();
 
-    // Get eligible injects - use allowlists from config or defaults
+    // Get allowlists from config or defaults
     const scopeAllowlist = config.inject?.scope_allowlist ?? ["repo", "global"];
     const typeAllowlist = config.inject?.type_allowlist ?? ["note", "policy"];
 
+    // Get diagnostic data
+    const diagnostics = getInjectionDiagnostics(now, scopeAllowlist, typeAllowlist);
+
     const eligibleInjects = selectEligibleInjects(db, {
       nowIso: now,
       scopeAllowlist,
@@ -47,11 +100,21 @@ export function createInjectProvider(opts: {
       limit: config.inject?.max_per_turn ?? 5,
     });
 
-    if (eligibleInjects.length === 0) return;
+    let injected = 0;
+    let skippedDeduped = 0;
+
+    if (eligibleInjects.length === 0) {
+      // Log when no injects are eligible
+      console.log(`[Astrocode:inject] ${now} selected=${diagnostics.selected_eligible} injected=0 skipped={expired:${diagnostics.skipped.expired} scope:${diagnostics.skipped.scope} type:${diagnostics.skipped.type} deduped:0}`);
+      return;
+    }
 
     // Inject each eligible inject, skipping recently injected ones
     for (const inject of eligibleInjects) {
-      if (shouldSkipInject(inject.inject_id, nowMs)) continue;
+      if (shouldSkipInject(inject.inject_id, nowMs)) {
+        skippedDeduped++;
+        continue;
+      }
 
       // Format as injection message
       const formattedText = `[Inject: ${inject.title}]\n\n${inject.body_md}`;
@@ -63,8 +126,12 @@ export function createInjectProvider(opts: {
         agent: "Astrocode"
       });
 
+      injected++;
       markInjected(inject.inject_id, nowMs);
     }
+
+    // Log diagnostic summary
+    console.log(`[Astrocode:inject] ${now} selected=${diagnostics.selected_eligible} injected=${injected} skipped={expired:${diagnostics.skipped.expired} scope:${diagnostics.skipped.scope} type:${diagnostics.skipped.type} deduped:${skippedDeduped}}`);
   }
 
   // Public hook handlers

package/src/state/schema.ts

@@ -235,6 +235,9 @@ CREATE INDEX IF NOT EXISTS idx_artifacts_run_stage ON artifacts(run_id, stage_ke
 CREATE INDEX IF NOT EXISTS idx_events_run ON events(run_id, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_tool_runs_run ON tool_runs(run_id, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_injects_scope_priority ON injects(scope, priority DESC, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_injects_scope_type_priority_updated ON injects(scope, type, priority DESC, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_injects_expires ON injects(expires_at) WHERE expires_at IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_injects_sha256 ON injects(sha256) WHERE sha256 IS NOT NULL;
 
 -- Stronger invariants (SQLite partial indexes)
 -- Only one run may be 'running' at a time (single-repo harness by default).

package/src/tools/index.ts

@@ -10,7 +10,7 @@ import { createAstroRunGetTool, createAstroRunAbortTool } from "./run";
 import { createAstroWorkflowProceedTool } from "./workflow";
 import { createAstroStageStartTool, createAstroStageCompleteTool, createAstroStageFailTool, createAstroStageResetTool } from "./stage";
 import { createAstroArtifactPutTool, createAstroArtifactListTool, createAstroArtifactGetTool } from "./artifacts";
-import { createAstroInjectPutTool, createAstroInjectListTool, createAstroInjectSearchTool, createAstroInjectGetTool } from "./injects";
+import { createAstroInjectPutTool, createAstroInjectListTool, createAstroInjectSearchTool, createAstroInjectGetTool, createAstroInjectEligibleTool, createAstroInjectDebugDueTool } from "./injects";
 import { createAstroRepairTool } from "./repair";
 
 import { AgentConfig } from "@opencode-ai/sdk";
@@ -50,6 +50,8 @@ export function createAstroTools(opts: { ctx: any; config: AstrocodeConfig; db:
     tools.astro_inject_list = createAstroInjectListTool({ ctx, config, db });
     tools.astro_inject_search = createAstroInjectSearchTool({ ctx, config, db });
     tools.astro_inject_get = createAstroInjectGetTool({ ctx, config, db });
+    tools.astro_inject_eligible = createAstroInjectEligibleTool({ ctx, config, db });
+    tools.astro_inject_debug_due = createAstroInjectDebugDueTool({ ctx, config, db });
     tools.astro_repair = createAstroRepairTool({ ctx, config, db });
   } else {
     // Limited mode tools - provide helpful messages instead of failing

package/src/tools/injects.ts

@@ -1,9 +1,38 @@
 import { tool, type ToolDefinition } from "@opencode-ai/plugin/tool";
 import type { AstrocodeConfig } from "../config/schema";
 import type { SqliteDb } from "../state/db";
+import { withTx } from "../state/db";
 import { nowISO } from "../shared/time";
 import { sha256Hex } from "../shared/hash";
 
+const VALID_INJECT_TYPES = ['note', 'policy', 'reminder', 'debug'] as const;
+type InjectType = typeof VALID_INJECT_TYPES[number];
+
+function validateInjectType(type: string): InjectType {
+  if (!VALID_INJECT_TYPES.includes(type as InjectType)) {
+    throw new Error(`Invalid inject type "${type}". Must be one of: ${VALID_INJECT_TYPES.join(', ')}`);
+  }
+  return type as InjectType;
+}
+
+function validateTimestamp(timestamp: string | null): string | null {
+  if (!timestamp) return null;
+
+  // Check if it's a valid ISO 8601 timestamp with Z suffix
+  const isoRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/;
+  if (!isoRegex.test(timestamp)) {
+    throw new Error(`Invalid timestamp format. Expected ISO 8601 UTC with Z suffix (e.g., "2026-01-23T13:05:19.000Z"), got: "${timestamp}"`);
+  }
+
+  // Additional validation: ensure it's parseable and represents a valid date
+  const parsed = new Date(timestamp);
+  if (isNaN(parsed.getTime())) {
+    throw new Error(`Invalid timestamp: "${timestamp}" does not represent a valid date`);
+  }
+
+  return timestamp;
+}
+
 function newInjectId(): string {
   return `inj_${Date.now()}_${Math.random().toString(16).slice(2)}`;
 }
@@ -29,20 +58,39 @@ export function createAstroInjectPutTool(opts: { ctx: any; config: AstrocodeConf
       const now = nowISO();
       const sha = sha256Hex(body_md);
 
-      const existing = db.prepare("SELECT inject_id FROM injects WHERE inject_id=?").get(id) as any;
+      // Validate inputs
+      const validatedType = validateInjectType(type);
+      const validatedExpiresAt = validateTimestamp(expires_at);
 
-      if (existing) {
-        db.prepare(
-          "UPDATE injects SET type=?, title=?, body_md=?, tags_json=?, scope=?, source=?, priority=?, expires_at=?, sha256=?, updated_at=? WHERE inject_id=?"
-        ).run(type, title, body_md, tags_json, scope, source, priority, expires_at ?? null, sha, now, id);
-        return `✅ Updated inject ${id}: ${title}`;
-      }
+      return withTx(db, () => {
+        const existing = db.prepare("SELECT inject_id FROM injects WHERE inject_id=?").get(id) as any;
+
+        if (existing) {
+          // Use INSERT ... ON CONFLICT for atomic updates
+          db.prepare(`
+            INSERT INTO injects (inject_id, type, title, body_md, tags_json, scope, source, priority, expires_at, sha256, created_at, updated_at)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+            ON CONFLICT(inject_id) DO UPDATE SET
+              type=excluded.type,
+              title=excluded.title,
+              body_md=excluded.body_md,
+              tags_json=excluded.tags_json,
+              scope=excluded.scope,
+              source=excluded.source,
+              priority=excluded.priority,
+              expires_at=excluded.expires_at,
+              sha256=excluded.sha256,
+              updated_at=excluded.updated_at
+          `).run(id, type, title, body_md, tags_json, scope, source, priority, validatedExpiresAt, sha, now, now);
+          return `✅ Updated inject ${id}: ${title}`;
+        }
 
-      db.prepare(
-        "INSERT INTO injects (inject_id, type, title, body_md, tags_json, scope, source, priority, expires_at, sha256, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"
-      ).run(id, type, title, body_md, tags_json, scope, source, priority, expires_at ?? null, sha, now, now);
+        db.prepare(
+          "INSERT INTO injects (inject_id, type, title, body_md, tags_json, scope, source, priority, expires_at, sha256, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"
+        ).run(id, validatedType, title, body_md, tags_json, scope, source, priority, validatedExpiresAt, sha, now, now);
 
-      return `✅ Created inject ${id}: ${title}`;
+        return `✅ Created inject ${id}: ${title}`;
+      });
     },
   });
 }
@@ -174,3 +222,91 @@ export function createAstroInjectEligibleTool(opts: { ctx: any; config: Astrocod
     },
   });
 }
+
+export function createAstroInjectDebugDueTool(opts: { ctx: any; config: AstrocodeConfig; db: SqliteDb }): ToolDefinition {
+  const { db } = opts;
+
+  return tool({
+    description: "Debug: show comprehensive injection diagnostics - why injects were selected/skipped.",
+    args: {
+      scopes_json: tool.schema.string().default('["repo","global"]'),
+      types_json: tool.schema.string().default('["note","policy"]'),
+    },
+    execute: async ({ scopes_json, types_json }) => {
+      const now = nowISO();
+      const scopes = JSON.parse(scopes_json) as string[];
+      const types = JSON.parse(types_json) as string[];
+
+      // Get ALL injects to analyze filtering
+      const allInjects = db.prepare("SELECT * FROM injects").all() as any[];
+
+      let total = allInjects.length;
+      let selected = 0;
+      let skippedExpired = 0;
+      let skippedScope = 0;
+      let skippedType = 0;
+      const excludedReasons: any[] = [];
+      const selectedInjects: any[] = [];
+
+      for (const inject of allInjects) {
+        const reasons: string[] = [];
+
+        // Check expiration
+        if (inject.expires_at && inject.expires_at <= now) {
+          reasons.push("expired");
+          skippedExpired++;
+        }
+
+        // Check scope
+        if (!scopes.includes(inject.scope)) {
+          reasons.push("scope");
+          skippedScope++;
+        }
+
+        // Check type
+        if (!types.includes(inject.type)) {
+          reasons.push("type");
+          skippedType++;
+        }
+
+        if (reasons.length > 0) {
+          excludedReasons.push({
+            inject_id: inject.inject_id,
+            title: inject.title,
+            reasons: reasons,
+            scope: inject.scope,
+            type: inject.type,
+            expires_at: inject.expires_at,
+          });
+        } else {
+          selected++;
+          selectedInjects.push({
+            inject_id: inject.inject_id,
+            title: inject.title,
+            scope: inject.scope,
+            type: inject.type,
+            expires_at: inject.expires_at,
+          });
+        }
+      }
+
+      return JSON.stringify({
+        now,
+        scopes_considered: scopes,
+        types_considered: types,
+        summary: {
+          total_injects: total,
+          selected_eligible: selected,
+          excluded_total: total - selected,
+          skipped_breakdown: {
+            expired: skippedExpired,
+            scope: skippedScope,
+            type: skippedType,
+          }
+        },
+        selected_injects: selectedInjects,
+        excluded_injects: excludedReasons,
+      }, null, 2);
+    },
+  });
+}

package/src/tools/workflow.ts

@@ -13,7 +13,7 @@ import { debug } from "../shared/log";
 import { createToastManager } from "../ui/toasts";
 
 // Agent name mapping for case-sensitive resolution
-const STAGE_TO_AGENT_MAP: Record<string, string> = {
+export const STAGE_TO_AGENT_MAP: Record<string, string> = {
   frame: "Frame",
   plan: "Plan",
   spec: "Spec",
@@ -23,13 +23,40 @@ const STAGE_TO_AGENT_MAP: Record<string, string> = {
   close: "Close"
 };
 
-function resolveAgentName(stageKey: StageKey, config: AstrocodeConfig): string {
+export function resolveAgentName(stageKey: StageKey, config: AstrocodeConfig, agents?: any, warnings?: string[]): string {
   // Use configurable agent names from config, fallback to hardcoded map, then General
   const agentNames = config.agents?.stage_agent_names;
+  let candidate: string;
+
   if (agentNames && agentNames[stageKey]) {
-    return agentNames[stageKey];
+    candidate = agentNames[stageKey];
+  } else {
+    candidate = STAGE_TO_AGENT_MAP[stageKey] || "General";
+  }
+
+  // Validate that the agent actually exists in the registry
+  if (agents && !agents[candidate]) {
+    const warning = `Agent "${candidate}" not found in registry for stage "${stageKey}". Falling back to General.`;
+    if (warnings) {
+      warnings.push(warning);
+    } else {
+      console.warn(`[Astrocode] ${warning}`);
+    }
+    candidate = "General";
   }
-  return STAGE_TO_AGENT_MAP[stageKey] || "General";
+
+  // Final guard: ensure General exists, fallback to built-in "general" if not
+  if (agents && !agents[candidate]) {
+    const finalWarning = `Critical: General agent not found in registry. Falling back to built-in "general".`;
+    if (warnings) {
+      warnings.push(finalWarning);
+    } else {
+      console.warn(`[Astrocode] ${finalWarning}`);
+    }
+    return "general"; // built-in, guaranteed by OpenCode
+  }
+
+  return candidate;
 }
 
 function stageGoal(stage: StageKey, cfg: AstrocodeConfig): string {
@@ -123,6 +150,7 @@ export function createAstroWorkflowProceedTool(opts: { ctx: any; config: Astroco
       const steps = Math.min(max_steps, config.workflow.loop_max_steps_hard_cap);
 
       const actions: string[] = [];
+      const warnings: string[] = [];
       const startedAt = nowISO();
 
       for (let i = 0; i < steps; i++) {
@@ -212,7 +240,7 @@ export function createAstroWorkflowProceedTool(opts: { ctx: any; config: Astroco
           const story = db.prepare("SELECT * FROM stories WHERE story_key=?").get(run.story_key) as any;
 
           // Mark stage started + set subagent_type to the stage agent.
-          let agentName = resolveAgentName(next.stage_key, config);
+          let agentName = resolveAgentName(next.stage_key, config, agents, warnings);
 
           // Validate agent availability with fallback chain
           const systemConfig = config as any;
@@ -234,17 +262,26 @@ export function createAstroWorkflowProceedTool(opts: { ctx: any; config: Astroco
              return false;
           };
 
-           if (!agentExists(agentName)) {
-             console.warn(`[Astrocode] Agent ${agentName} not found in config. Falling back to orchestrator.`);
-             // Skip General fallback for stage agents to avoid malformed output
-             agentName = config.agents?.orchestrator_name || "Astro";
-             if (!agentExists(agentName)) {
-               throw new Error(`Critical: No agents available for delegation. Primary: ${resolveAgentName(next.stage_key, config)}, Orchestrator: ${agentName}`);
-             }
-           }
+            if (!agentExists(agentName)) {
+              const originalAgent = agentName;
+              console.warn(`[Astrocode] Agent ${agentName} not found in config. Falling back to orchestrator.`);
+              // First fallback: orchestrator
+              agentName = config.agents?.orchestrator_name || "Astro";
+              if (!agentExists(agentName)) {
+                console.warn(`[Astrocode] Orchestrator ${agentName} not available. Falling back to General.`);
+                // Final fallback: General (guaranteed to exist)
+                agentName = "General";
+                if (!agentExists(agentName)) {
+                  throw new Error(`Critical: No agents available for delegation. Primary: ${originalAgent}, Orchestrator: ${config.agents?.orchestrator_name || "Astro"}, General: unavailable`);
+                }
+              }
+            }
 
           withTx(db, () => {
             startStage(db, active.run_id, next.stage_key, { subagent_type: agentName });
+
+            // Log delegation observability
+            console.log(`[Astrocode:delegate] run_id=${active.run_id} stage=${next.stage_key} agent=${agentName} fallback=${agentName !== resolveAgentName(next.stage_key, config, agents) ? 'yes' : 'no'}`);
           });
 
           if (config.ui.toasts.enabled && config.ui.toasts.show_stage_started) {
@@ -355,6 +392,11 @@ export function createAstroWorkflowProceedTool(opts: { ctx: any; config: Astroco
       lines.push(``, `## Actions`);
       for (const a of actions) lines.push(`- ${a}`);
 
+      if (warnings.length > 0) {
+        lines.push(``, `## Warnings`);
+        for (const w of warnings) lines.push(`⚠️ ${w}`);
+      }
+
       return lines.join("\n").trim();
     },
   });

package/src/workflow/context.ts

@@ -35,6 +35,57 @@ function statusIcon(status: string): string {
   }
 }
 
+/**
+ * Check if a context snapshot is stale by comparing DB timestamps
+ */
+export function isContextSnapshotStale(snapshotText: string, db: SqliteDb, maxAgeSeconds: number = 300): boolean {
+  // Extract run_id from snapshot
+  const runIdMatch = snapshotText.match(/Run: `([^`]+)`/);
+  if (!runIdMatch) return true; // Can't validate without run_id
+
+  const runId = runIdMatch[1];
+
+  // Extract snapshot's claimed updated_at
+  const snapshotUpdatedMatch = snapshotText.match(/updated: ([^\)]+)\)/);
+  if (!snapshotUpdatedMatch) return true; // Fallback to age-based check
+
+  try {
+    const snapshotUpdatedAt = snapshotUpdatedMatch[1];
+    const currentRun = db.prepare("SELECT updated_at FROM runs WHERE run_id = ?").get(runId) as { updated_at?: string };
+
+    if (!currentRun?.updated_at) return true; // Run doesn't exist
+
+    // Compare timestamps - if DB is newer than snapshot claims, snapshot is stale
+    const snapshotTime = new Date(snapshotUpdatedAt).getTime();
+    const currentTime = new Date(currentRun.updated_at).getTime();
+
+    return currentTime > snapshotTime;
+  } catch (error) {
+    // Fallback to age-based staleness if parsing fails
+    const timestampMatch = snapshotText.match(/generated: (\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z)/);
+    if (!timestampMatch) return false;
+
+    const generatedAt = new Date(timestampMatch[1]);
+    const now = new Date();
+    const ageSeconds = (now.getTime() - generatedAt.getTime()) / 1000;
+
+    return ageSeconds > maxAgeSeconds;
+  }
+}
+
+/**
+ * Add staleness indicator to context snapshot if needed
+ */
+export function addStalenessIndicator(snapshotText: string, db: SqliteDb, maxAgeSeconds: number = 300): string {
+  if (isContextSnapshotStale(snapshotText, db, maxAgeSeconds)) {
+    return snapshotText.replace(
+      /# Astrocode Context \(generated: ([^\)]+)\)/,
+      "# Astrocode Context (generated: $1) ⚠️ STALE - DB state has changed"
+    );
+  }
+  return snapshotText;
+}
+
 export function buildContextSnapshot(opts: {
   db: SqliteDb;
   config: AstrocodeConfig;
@@ -52,8 +103,11 @@ export function buildContextSnapshot(opts: {
 
   const lines: string[] = [];
 
-  lines.push(`# Astrocode Context`);
-  lines.push(`- Run: \`${run.run_id}\`  Status: **${run.status}**`);
+  // Add timestamps for staleness checking
+  const now = new Date();
+  const timestamp = now.toISOString();
+  lines.push(`# Astrocode Context (generated: ${timestamp})`);
+  lines.push(`- Run: \`${run.run_id}\`  Status: **${run.status}** (updated: ${run.updated_at})`);
   if (run.current_stage_key) lines.push(`- Current stage: \`${run.current_stage_key}\``);
   if (next_action) lines.push(`- Next action: ${next_action}`);
 

package/src/workflow/directives.ts

@@ -2,6 +2,7 @@ import type { AstrocodeConfig } from "../config/schema";
 import { sha256Hex } from "../shared/hash";
 import { clampChars, normalizeNewlines } from "../shared/text";
 import type { StageKey } from "../state/types";
+import { addStalenessIndicator } from "./context";
 
 export type DirectiveKind = "continue" | "stage" | "blocked" | "repair";
 
@@ -77,8 +78,8 @@ export function buildBlockedDirective(opts: {
       ``,
       `Question: ${question}`,
       ``,
-      `Context snapshot:`,
-      context_snapshot_md.trim(),
+        `Context snapshot:`,
+        context_snapshot_md.trim(),
     ].join("\n")
   ).trim();