@mclean-capital/neura 3.4.1 → 3.5.0

package/core/version.txt

@@ -1 +1 @@
-3.4.1
+3.5.0

package/dist/commands/skill.d.ts

@@ -0,0 +1,26 @@
+interface Diagnostic {
+    type: 'warning' | 'error';
+    message: string;
+    path?: string;
+}
+/**
+ * Validate a skill or directory of skills against the agentskills.io spec.
+ *
+ * Delegates core spec validation (name / description / character rules /
+ * parent-dir match / frontmatter parse) to pi-coding-agent's loader, then
+ * layers on Neura-specific checks for `license` and `compatibility` that
+ * pi does not inspect.
+ *
+ * Any diagnostic — pi's warnings or Neura's — causes a non-zero exit.
+ * Designed for skill authors who want a pre-commit / CI check that their
+ * SKILL.md will load cleanly in Neura.
+ */
+export declare function skillValidateCommand(pathArg: string): void;
+declare function checkLicense(skillName: string, filePath: string, raw: unknown): Diagnostic[];
+declare function checkCompatibility(skillName: string, filePath: string, raw: unknown): Diagnostic[];
+export declare const __test__: {
+    checkLicense: typeof checkLicense;
+    checkCompatibility: typeof checkCompatibility;
+};
+export {};
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAOA,UAAU,UAAU;IAClB,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA8D1D;AAED,iBAAS,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CAYrF;AAED,iBAAS,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CAqB3F;AAED,eAAO,MAAM,QAAQ;;;CAAuC,CAAC"}

package/dist/commands/skill.js

@@ -0,0 +1,111 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import chalk from 'chalk';
+import { loadSkills, parseFrontmatter } from '@mariozechner/pi-coding-agent';
+const COMPATIBILITY_MAX_LENGTH = 500;
+/**
+ * Validate a skill or directory of skills against the agentskills.io spec.
+ *
+ * Delegates core spec validation (name / description / character rules /
+ * parent-dir match / frontmatter parse) to pi-coding-agent's loader, then
+ * layers on Neura-specific checks for `license` and `compatibility` that
+ * pi does not inspect.
+ *
+ * Any diagnostic — pi's warnings or Neura's — causes a non-zero exit.
+ * Designed for skill authors who want a pre-commit / CI check that their
+ * SKILL.md will load cleanly in Neura.
+ */
+export function skillValidateCommand(pathArg) {
+    const absPath = resolve(pathArg);
+    const result = loadSkills({
+        skillPaths: [absPath],
+        includeDefaults: false,
+    });
+    const diagnostics = result.diagnostics.map((d) => ({
+        type: d.type === 'error' ? 'error' : 'warning',
+        message: d.message,
+        path: d.path,
+    }));
+    for (const skill of result.skills) {
+        try {
+            const raw = readFileSync(skill.filePath, 'utf8');
+            const { frontmatter } = parseFrontmatter(raw);
+            diagnostics.push(...checkLicense(skill.name, skill.filePath, frontmatter.license));
+            diagnostics.push(...checkCompatibility(skill.name, skill.filePath, frontmatter.compatibility));
+        }
+        catch (err) {
+            diagnostics.push({
+                type: 'error',
+                message: `Failed to re-parse frontmatter: ${String(err)}`,
+                path: skill.filePath,
+            });
+        }
+    }
+    console.log(`${result.skills.length} skill(s) found at ${pathArg}`);
+    if (result.skills.length === 0 && diagnostics.length === 0) {
+        console.log(chalk.red('  ✗ No SKILL.md found — nothing to validate'));
+        process.exit(1);
+    }
+    const errors = diagnostics.filter((d) => d.type === 'error');
+    const warnings = diagnostics.filter((d) => d.type === 'warning');
+    if (errors.length === 0 && warnings.length === 0) {
+        console.log(chalk.green('  ✓ All skills pass agentskills.io spec validation'));
+        return;
+    }
+    if (errors.length > 0) {
+        console.log(chalk.red(`\n${errors.length} error(s):`));
+        for (const e of errors) {
+            console.log(chalk.red(`  ✗ ${e.message}`));
+            if (e.path)
+                console.log(chalk.dim(`    ${e.path}`));
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(chalk.yellow(`\n${warnings.length} warning(s):`));
+        for (const w of warnings) {
+            console.log(chalk.yellow(`  ⚠ ${w.message}`));
+            if (w.path)
+                console.log(chalk.dim(`    ${w.path}`));
+        }
+    }
+    process.exit(1);
+}
+function checkLicense(skillName, filePath, raw) {
+    if (raw === undefined)
+        return [];
+    if (typeof raw !== 'string') {
+        return [
+            {
+                type: 'warning',
+                message: `Skill '${skillName}' has 'license' field of type ${typeof raw}; agentskills.io spec requires a string.`,
+                path: filePath,
+            },
+        ];
+    }
+    return [];
+}
+function checkCompatibility(skillName, filePath, raw) {
+    if (raw === undefined)
+        return [];
+    if (typeof raw !== 'string') {
+        return [
+            {
+                type: 'warning',
+                message: `Skill '${skillName}' has 'compatibility' field of type ${typeof raw}; agentskills.io spec requires a string.`,
+                path: filePath,
+            },
+        ];
+    }
+    if (raw.length > COMPATIBILITY_MAX_LENGTH) {
+        return [
+            {
+                type: 'warning',
+                message: `Skill '${skillName}' has 'compatibility' field of ${raw.length} characters; agentskills.io spec caps at ${COMPATIBILITY_MAX_LENGTH}.`,
+                path: filePath,
+            },
+        ];
+    }
+    return [];
+}
+export const __test__ = { checkLicense, checkCompatibility };
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,6 +15,7 @@ import { updateCommand } from './commands/update.js';
 import { backupCommand, restoreCommand } from './commands/backup.js';
 import { chatCommand } from './commands/chat.js';
 import { listenCommand } from './commands/listen.js';
+import { skillValidateCommand } from './commands/skill.js';
 const program = new Command();
 program.name('neura').description('Neura — AI assistant core service manager').version(CLI_VERSION);
 // Install & setup
@@ -71,5 +72,11 @@ program
     .option('-p, --port <port>', 'Core server port (default: config or 3002)')
     .option('--debug', 'Print audio pipeline stats every 2s')
     .action(listenCommand);
+// Skill authoring / validation
+const skillCmd = program.command('skill').description('Skill authoring tools');
+skillCmd
+    .command('validate <path>')
+    .description('Validate skills at <path> against the agentskills.io spec')
+    .action(skillValidateCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mclean-capital/neura",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Neura — CLI for installing and managing the Neura AI assistant core service. Includes text chat and voice listen clients.",
   "keywords": [
     "neura",

package/stores/index.js

@@ -4386,6 +4386,7 @@ var Logger = class _Logger {
 // src/stores/migrations.ts
 var log = new Logger("store");
 async function runMigrations(db, embeddingDimensions = 3072) {
+  await db.exec(`SET TIME ZONE 'UTC'`);
   await db.exec("CREATE EXTENSION IF NOT EXISTS vector;");
   await db.exec(`
     CREATE TABLE IF NOT EXISTS _meta (
@@ -4519,12 +4520,27 @@ async function runMigrations(db, embeddingDimensions = 3072) {
       title TEXT NOT NULL,
       description TEXT,
       status TEXT NOT NULL DEFAULT 'pending'
-        CHECK (status IN ('pending', 'in_progress', 'done', 'cancelled', 'failed')),
+        CHECK (status IN (
+          'pending', 'awaiting_dispatch', 'in_progress',
+          'awaiting_clarification', 'awaiting_approval', 'paused',
+          'done', 'cancelled', 'failed'
+        )),
       priority TEXT NOT NULL DEFAULT 'medium'
         CHECK (priority IN ('low', 'medium', 'high')),
       due_at TIMESTAMP,
       parent_id TEXT REFERENCES work_items(id) ON DELETE SET NULL,
       source_session_id TEXT,
+      -- Phase 6b columns (also added via ALTER for upgrades below)
+      goal TEXT,
+      context JSONB,
+      related_skills JSONB NOT NULL DEFAULT '[]',
+      repo_path TEXT,
+      base_branch TEXT,
+      worker_id TEXT,
+      source TEXT NOT NULL DEFAULT 'user'
+        CHECK (source IN ('user', 'system_proactive', 'discovery_loop')),
+      version INTEGER NOT NULL DEFAULT 0,
+      lease_expires_at TIMESTAMP,
       created_at TIMESTAMP NOT NULL DEFAULT NOW(),
       updated_at TIMESTAMP NOT NULL DEFAULT NOW(),
       completed_at TIMESTAMP
@@ -4532,6 +4548,80 @@ async function runMigrations(db, embeddingDimensions = 3072) {
   `);
   await db.exec("CREATE INDEX IF NOT EXISTS idx_work_items_status ON work_items(status)");
   await db.exec("CREATE INDEX IF NOT EXISTS idx_work_items_due ON work_items(due_at)");
+  await db.exec(`
+    DO $$
+    BEGIN
+      IF NOT EXISTS (
+        SELECT 1 FROM pg_constraint
+        WHERE conname = 'work_items_status_check'
+          AND pg_get_constraintdef(oid) LIKE '%awaiting_clarification%'
+      ) THEN
+        ALTER TABLE work_items DROP CONSTRAINT IF EXISTS work_items_status_check;
+        ALTER TABLE work_items ADD CONSTRAINT work_items_status_check
+          CHECK (status IN (
+            'pending', 'awaiting_dispatch', 'in_progress',
+            'awaiting_clarification', 'awaiting_approval', 'paused',
+            'done', 'cancelled', 'failed'
+          ));
+      END IF;
+    END $$
+  `);
+  await db.exec("ALTER TABLE work_items ADD COLUMN IF NOT EXISTS goal TEXT");
+  await db.exec("ALTER TABLE work_items ADD COLUMN IF NOT EXISTS context JSONB");
+  await db.exec(
+    `ALTER TABLE work_items ADD COLUMN IF NOT EXISTS related_skills JSONB NOT NULL DEFAULT '[]'`
+  );
+  await db.exec("ALTER TABLE work_items ADD COLUMN IF NOT EXISTS repo_path TEXT");
+  await db.exec("ALTER TABLE work_items ADD COLUMN IF NOT EXISTS base_branch TEXT");
+  await db.exec("ALTER TABLE work_items ADD COLUMN IF NOT EXISTS worker_id TEXT");
+  await db.exec(
+    `ALTER TABLE work_items ADD COLUMN IF NOT EXISTS source TEXT NOT NULL DEFAULT 'user'`
+  );
+  await db.exec(
+    `ALTER TABLE work_items ADD COLUMN IF NOT EXISTS version INTEGER NOT NULL DEFAULT 0`
+  );
+  await db.exec("ALTER TABLE work_items ADD COLUMN IF NOT EXISTS lease_expires_at TIMESTAMP");
+  await db.exec(`
+    DO $$
+    BEGIN
+      IF NOT EXISTS (
+        SELECT 1 FROM pg_constraint
+        WHERE conname = 'work_items_source_check'
+      ) THEN
+        ALTER TABLE work_items ADD CONSTRAINT work_items_source_check
+          CHECK (source IN ('user', 'system_proactive', 'discovery_loop'));
+      END IF;
+    END $$
+  `);
+  await db.exec("CREATE INDEX IF NOT EXISTS idx_work_items_worker ON work_items(worker_id)");
+  await db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_work_items_lease ON work_items(lease_expires_at) WHERE lease_expires_at IS NOT NULL"
+  );
+  await db.exec(`
+    CREATE TABLE IF NOT EXISTS task_comments (
+      id TEXT PRIMARY KEY,
+      task_id TEXT NOT NULL REFERENCES work_items(id) ON DELETE CASCADE,
+      type TEXT NOT NULL
+        CHECK (type IN (
+          'progress', 'heartbeat',
+          'clarification_request', 'approval_request',
+          'clarification_response', 'approval_response',
+          'error', 'result', 'system', 'deferred'
+        )),
+      author TEXT NOT NULL,
+      content TEXT NOT NULL,
+      attachment_path TEXT,
+      urgency TEXT
+        CHECK (urgency IS NULL OR urgency IN ('low', 'normal', 'high', 'critical')),
+      metadata JSONB,
+      created_at TIMESTAMP NOT NULL DEFAULT NOW()
+    )
+  `);
+  await db.exec("CREATE INDEX IF NOT EXISTS idx_task_comments_task ON task_comments(task_id)");
+  await db.exec("CREATE INDEX IF NOT EXISTS idx_task_comments_type ON task_comments(type)");
+  await db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_task_comments_created ON task_comments(created_at)"
+  );
   await db.exec("ALTER TABLE facts ADD COLUMN IF NOT EXISTS valid_from TIMESTAMP DEFAULT NOW()");
   await db.exec("ALTER TABLE facts ADD COLUMN IF NOT EXISTS valid_to TIMESTAMP");
   await db.exec("ALTER TABLE facts ADD COLUMN IF NOT EXISTS superseded_by TEXT");
@@ -4778,7 +4868,17 @@ function mapWorkItem(r) {
     sourceSessionId: r.source_session_id,
     createdAt: r.created_at,
     updatedAt: r.updated_at,
-    completedAt: r.completed_at
+    completedAt: r.completed_at,
+    // Phase 6b fields — defaulted when legacy rows lack them.
+    goal: r.goal ?? null,
+    context: r.context ?? null,
+    relatedSkills: r.related_skills ?? [],
+    repoPath: r.repo_path ?? null,
+    baseBranch: r.base_branch ?? null,
+    workerId: r.worker_id ?? null,
+    source: r.source ?? "user",
+    version: r.version ?? 0,
+    leaseExpiresAt: r.lease_expires_at ?? null
   };
 }
 function mapTranscriptChunk(r) {
@@ -5411,7 +5511,7 @@ import crypto6 from "crypto";
 async function getOpenWorkItems(db, limit = 50) {
   const result = await db.query(
     `SELECT * FROM work_items
-     WHERE status IN ('pending', 'in_progress')
+     WHERE status IN ('pending', 'awaiting_dispatch', 'in_progress', 'awaiting_clarification', 'awaiting_approval', 'paused')
      ORDER BY
        CASE priority WHEN 'high' THEN 0 WHEN 'medium' THEN 1 WHEN 'low' THEN 2 END,
        due_at ASC NULLS LAST,
@@ -5445,8 +5545,11 @@ async function getWorkItem(db, id) {
 async function createWorkItem(db, title, priority, options) {
   const id = crypto6.randomUUID();
   await db.query(
-    `INSERT INTO work_items (id, title, priority, description, due_at, parent_id, source_session_id)
-     VALUES ($1, $2, $3, $4, $5, $6, $7)`,
+    `INSERT INTO work_items (
+       id, title, priority, description, due_at, parent_id, source_session_id,
+       goal, context, related_skills, repo_path, base_branch, source
+     )
+     VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13)`,
     [
       id,
       title,
@@ -5454,13 +5557,27 @@ async function createWorkItem(db, title, priority, options) {
       options?.description ?? null,
       options?.dueAt ?? null,
       options?.parentId ?? null,
-      options?.sourceSessionId ?? null
+      options?.sourceSessionId ?? null,
+      options?.goal ?? null,
+      options?.context ? JSON.stringify(options.context) : null,
+      JSON.stringify(options?.relatedSkills ?? []),
+      options?.repoPath ?? null,
+      options?.baseBranch ?? null,
+      options?.source ?? "user"
     ]
   );
   return id;
 }
-async function updateWorkItem(db, id, updates) {
-  const sets = ["updated_at = NOW()"];
+var VersionConflictError = class extends Error {
+  constructor(id, expectedVersion) {
+    super(`version conflict on work_item ${id} (expected ${expectedVersion})`);
+    this.id = id;
+    this.expectedVersion = expectedVersion;
+    this.name = "VersionConflictError";
+  }
+};
+async function updateWorkItem(db, id, updates, opts) {
+  const sets = ["updated_at = NOW()", "version = version + 1"];
   const values = [];
   let paramIdx = 1;
   if (updates.title !== void 0) {
@@ -5486,8 +5603,51 @@ async function updateWorkItem(db, id, updates) {
     sets.push(`due_at = $${paramIdx++}`);
     values.push(updates.dueAt);
   }
+  if (updates.goal !== void 0) {
+    sets.push(`goal = $${paramIdx++}`);
+    values.push(updates.goal);
+  }
+  if (updates.context !== void 0) {
+    sets.push(`context = $${paramIdx++}`);
+    values.push(updates.context === null ? null : JSON.stringify(updates.context));
+  }
+  if (updates.relatedSkills !== void 0) {
+    sets.push(`related_skills = $${paramIdx++}`);
+    values.push(JSON.stringify(updates.relatedSkills));
+  }
+  if (updates.repoPath !== void 0) {
+    sets.push(`repo_path = $${paramIdx++}`);
+    values.push(updates.repoPath);
+  }
+  if (updates.baseBranch !== void 0) {
+    sets.push(`base_branch = $${paramIdx++}`);
+    values.push(updates.baseBranch);
+  }
+  if (updates.workerId !== void 0) {
+    sets.push(`worker_id = $${paramIdx++}`);
+    values.push(updates.workerId);
+  }
+  if (updates.leaseExpiresAt !== void 0) {
+    sets.push(`lease_expires_at = $${paramIdx++}`);
+    values.push(updates.leaseExpiresAt);
+  }
+  let whereClause = `WHERE id = $${paramIdx++}`;
   values.push(id);
-  await db.query(`UPDATE work_items SET ${sets.join(", ")} WHERE id = $${paramIdx}`, values);
+  if (opts?.expectVersion !== void 0) {
+    whereClause += ` AND version = $${paramIdx}`;
+    values.push(opts.expectVersion);
+  }
+  const result = await db.query(
+    `UPDATE work_items SET ${sets.join(", ")} ${whereClause} RETURNING version`,
+    values
+  );
+  if (result.rows.length === 0) {
+    if (opts?.expectVersion !== void 0) {
+      throw new VersionConflictError(id, opts.expectVersion);
+    }
+    throw new Error(`work_item ${id} not found`);
+  }
+  return result.rows[0].version;
 }
 async function deleteWorkItem(db, id) {
   await db.query("DELETE FROM work_items WHERE id = $1", [id]);
@@ -5895,8 +6055,8 @@ var PgliteStore = class _PgliteStore {
   createWorkItem(title, priority, options) {
     return createWorkItem(this.db, title, priority, options);
   }
-  updateWorkItem(id, updates) {
-    return updateWorkItem(this.db, id, updates);
+  updateWorkItem(id, updates, opts) {
+    return updateWorkItem(this.db, id, updates, opts);
   }
   deleteWorkItem(id) {
     return deleteWorkItem(this.db, id);