@runcore-sh/runcore 0.1.2

package/dist/registry/validator.js

@@ -0,0 +1,203 @@
+/**
+ * Registry — Package validation.
+ *
+ * Validates package manifests, skill content, and template content
+ * before publishing to the registry. Checks required fields, format
+ * constraints, and dependency availability.
+ */
+import { validateSkill } from "../skills/validator.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Valid package name pattern: kebab-case, 2–64 chars. */
+const NAME_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+/** Semver pattern (simplified). */
+const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+/** Max description length. */
+const MAX_DESCRIPTION_LENGTH = 500;
+/** Max tags per package. */
+const MAX_TAGS = 20;
+// ---------------------------------------------------------------------------
+// Manifest validation
+// ---------------------------------------------------------------------------
+/** Validate a package manifest's structure and field values. */
+export function validateManifest(manifest) {
+    const errors = [];
+    const warnings = [];
+    // Required fields
+    if (!manifest.name) {
+        errors.push("Missing required field: name");
+    }
+    else if (!NAME_RE.test(manifest.name)) {
+        errors.push(`Invalid package name "${manifest.name}": must be kebab-case, start with a letter, 2+ chars`);
+    }
+    if (!manifest.version) {
+        errors.push("Missing required field: version");
+    }
+    else if (!SEMVER_RE.test(manifest.version)) {
+        errors.push(`Invalid version "${manifest.version}": must be semver (e.g., 1.0.0)`);
+    }
+    if (!manifest.kind) {
+        errors.push("Missing required field: kind");
+    }
+    else if (manifest.kind !== "skill" && manifest.kind !== "template") {
+        errors.push(`Invalid kind "${manifest.kind}": must be "skill" or "template"`);
+    }
+    if (!manifest.description) {
+        errors.push("Missing required field: description");
+    }
+    else if (manifest.description.length > MAX_DESCRIPTION_LENGTH) {
+        warnings.push(`Description is ${manifest.description.length} chars (max ${MAX_DESCRIPTION_LENGTH})`);
+    }
+    if (!manifest.author) {
+        errors.push("Missing required field: author");
+    }
+    // Files
+    if (!manifest.files || manifest.files.length === 0) {
+        errors.push("Package must contain at least one file");
+    }
+    // Tags
+    if (manifest.tags && manifest.tags.length > MAX_TAGS) {
+        warnings.push(`Too many tags (${manifest.tags.length}, max ${MAX_TAGS})`);
+    }
+    // Dependencies
+    if (manifest.dependencies) {
+        for (const dep of manifest.dependencies) {
+            if (!dep.name) {
+                errors.push("Dependency missing name");
+            }
+            if (!dep.version || !SEMVER_RE.test(dep.version)) {
+                errors.push(`Dependency "${dep.name}" has invalid version: "${dep.version}"`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ---------------------------------------------------------------------------
+// Publish input validation
+// ---------------------------------------------------------------------------
+/** Validate a publish input before creating the package. */
+export function validatePublishInput(input) {
+    const errors = [];
+    const warnings = [];
+    // Validate manifest fields
+    const manifestValidation = validateManifest({
+        name: input.name,
+        version: input.version,
+        kind: input.kind,
+        description: input.description,
+        author: input.author,
+        tags: input.tags ?? [],
+        dependencies: input.dependencies ?? [],
+        files: Object.keys(input.files),
+        publishedAt: "",
+        updatedAt: "",
+    });
+    errors.push(...manifestValidation.errors);
+    warnings.push(...manifestValidation.warnings);
+    // Validate file contents based on kind
+    if (input.files && Object.keys(input.files).length > 0) {
+        const contentValidation = validatePackageContent(input.kind, input.files);
+        errors.push(...contentValidation.errors);
+        warnings.push(...contentValidation.warnings);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ---------------------------------------------------------------------------
+// Content validation
+// ---------------------------------------------------------------------------
+/**
+ * Validate package content files based on the package kind.
+ * Skills are validated with the existing skill validator.
+ * Templates are validated for JSON structure.
+ */
+export function validatePackageContent(kind, files) {
+    const errors = [];
+    const warnings = [];
+    for (const [filename, content] of Object.entries(files)) {
+        if (kind === "skill") {
+            // Skills must be .md files with valid frontmatter
+            if (!filename.endsWith(".md")) {
+                warnings.push(`Skill file "${filename}" does not have .md extension`);
+            }
+            const skillValidation = validateSkill(filename, content);
+            for (const err of skillValidation.errors) {
+                errors.push(`${filename}: ${err}`);
+            }
+            for (const warn of skillValidation.warnings) {
+                warnings.push(`${filename}: ${warn}`);
+            }
+        }
+        else if (kind === "template") {
+            // Templates must be valid JSON
+            if (!filename.endsWith(".json") && !filename.endsWith(".md")) {
+                warnings.push(`Template file "${filename}" should have .json or .md extension`);
+            }
+            if (filename.endsWith(".json")) {
+                try {
+                    const parsed = JSON.parse(content);
+                    const templateValidation = validateTemplateJson(parsed);
+                    for (const err of templateValidation.errors) {
+                        errors.push(`${filename}: ${err}`);
+                    }
+                    for (const warn of templateValidation.warnings) {
+                        warnings.push(`${filename}: ${warn}`);
+                    }
+                }
+                catch {
+                    errors.push(`${filename}: Invalid JSON`);
+                }
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/** Validate a parsed template JSON structure. */
+function validateTemplateJson(template) {
+    const errors = [];
+    const warnings = [];
+    if (!template.name) {
+        errors.push("Template missing required field: name");
+    }
+    if (!template.description) {
+        errors.push("Template missing required field: description");
+    }
+    if (!template.promptPattern) {
+        warnings.push("Template has no promptPattern — consider adding one");
+    }
+    if (template.category) {
+        const validCategories = [
+            "code-review",
+            "bug-investigation",
+            "feature-implementation",
+            "testing",
+            "deployment-ops",
+            "integration",
+        ];
+        if (!validCategories.includes(template.category)) {
+            warnings.push(`Unknown template category "${template.category}". Known: ${validCategories.join(", ")}`);
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ---------------------------------------------------------------------------
+// Dependency checking
+// ---------------------------------------------------------------------------
+/**
+ * Check if all dependencies of a package are available in the registry.
+ * Returns the names of missing dependencies.
+ */
+export function checkDependencies(manifest, availablePackages) {
+    const missing = [];
+    for (const dep of manifest.dependencies) {
+        const available = availablePackages.get(dep.name);
+        if (!available) {
+            missing.push(dep.name);
+        }
+        else if (available.version !== dep.version) {
+            missing.push(`${dep.name}@${dep.version} (found ${available.version})`);
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=validator.js.map

package/dist/registry/validator.js.map

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

package/dist/scheduling/index.d.ts

@@ -0,0 +1,4 @@
+export type { BlockType, BlockStatus, SchedulingBlock, DaySchedule, BlockFilter, } from "./types.js";
+export { SchedulingStore, createSchedulingStore, getSchedulingStore, } from "./store.js";
+export { startSchedulingTimer, stopSchedulingTimer, isSchedulingTimerRunning, } from "./timer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scheduling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/scheduling/index.js

@@ -0,0 +1,3 @@
+export { SchedulingStore, createSchedulingStore, getSchedulingStore, } from "./store.js";
+export { startSchedulingTimer, stopSchedulingTimer, isSchedulingTimerRunning, } from "./timer.js";
+//# sourceMappingURL=index.js.map

package/dist/scheduling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/scheduling/store.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Scheduling store — append-only JSONL persistence for SchedulingBlock.
+ * Follows src/queue/store.ts pattern.
+ *
+ * File: brain/scheduling/blocks.jsonl
+ * Update strategy: append full updated block. On load, last occurrence per id wins.
+ */
+import type { SchedulingBlock, BlockFilter, DaySchedule, BlockType } from "./types.js";
+export declare class SchedulingStore {
+    private readonly filePath;
+    private cache;
+    private lastMtime;
+    private lastStaleCheckMs;
+    constructor(brainDir: string);
+    private ensureFile;
+    private checkStale;
+    private load;
+    private invalidate;
+    list(filter?: BlockFilter): Promise<SchedulingBlock[]>;
+    get(id: string): Promise<SchedulingBlock | null>;
+    create(opts: {
+        type: BlockType;
+        title: string;
+        start?: string;
+        end?: string;
+        dueAt?: string;
+        boardItemId?: string;
+        tags?: string[];
+    }): Promise<SchedulingBlock>;
+    update(id: string, changes: Partial<Pick<SchedulingBlock, "title" | "type" | "start" | "end" | "dueAt" | "boardItemId" | "status" | "outcome" | "tags">>): Promise<SchedulingBlock | null>;
+    getToday(): Promise<DaySchedule>;
+    /** Get blocks starting within the next N milliseconds. */
+    getUpcoming(withinMs: number): Promise<SchedulingBlock[]>;
+    /** Get blocks that are overdue (past end time, still planned). */
+    getOverdue(): Promise<SchedulingBlock[]>;
+    /** Get blocks whose start time has arrived but are still planned. */
+    getReadyToActivate(): Promise<SchedulingBlock[]>;
+}
+export declare function createSchedulingStore(brainDir: string): SchedulingStore;
+export declare function getSchedulingStore(): SchedulingStore | null;
+//# sourceMappingURL=store.d.ts.map

package/dist/scheduling/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/scheduling/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAe,SAAS,EAAE,MAAM,YAAY,CAAC;AAWpG,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,QAAQ,EAAE,MAAM;YAMd,UAAU;YAIV,UAAU;YAmBV,IAAI;IA4BlB,OAAO,CAAC,UAAU;IAMZ,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BtD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAKhD,MAAM,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBtB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkB1L,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAwBtC,0DAA0D;IACpD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAmB/D,kEAAkE;IAC5D,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAwB9C,qEAAqE;IAC/D,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAkBvD;AAMD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAIvE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D"}

package/dist/scheduling/store.js

@@ -0,0 +1,237 @@
+/**
+ * Scheduling store — append-only JSONL persistence for SchedulingBlock.
+ * Follows src/queue/store.ts pattern.
+ *
+ * File: brain/scheduling/blocks.jsonl
+ * Update strategy: append full updated block. On load, last occurrence per id wins.
+ */
+import { join } from "node:path";
+import { stat } from "node:fs/promises";
+import { createLogger } from "../utils/logger.js";
+import { readBrainLines, appendBrainLine, ensureBrainJsonl } from "../lib/brain-io.js";
+const log = createLogger("scheduling.store");
+const SCHEMA_LINE = JSON.stringify({ _schema: "scheduling-blocks", _version: "1.0" });
+function generateId() {
+    const hex = Math.random().toString(16).slice(2, 10).padEnd(8, "0");
+    return `blk_${hex}`;
+}
+export class SchedulingStore {
+    filePath;
+    cache = null;
+    lastMtime = 0;
+    lastStaleCheckMs = 0;
+    constructor(brainDir) {
+        this.filePath = join(brainDir, "scheduling", "blocks.jsonl");
+    }
+    // ── File management ──────────────────────────────────────────────────────
+    async ensureFile() {
+        await ensureBrainJsonl(this.filePath, SCHEMA_LINE);
+    }
+    async checkStale() {
+        if (!this.cache)
+            return;
+        const now = Date.now();
+        if (now - this.lastStaleCheckMs < 5000)
+            return;
+        this.lastStaleCheckMs = now;
+        try {
+            const s = await stat(this.filePath);
+            const mtime = s.mtimeMs;
+            if (mtime > this.lastMtime) {
+                this.cache = null; // Force reload
+            }
+        }
+        catch {
+            // File may not exist yet
+        }
+    }
+    // ── Load ──────────────────────────────────────────────────────────────────
+    async load() {
+        await this.checkStale();
+        if (this.cache)
+            return this.cache;
+        await this.ensureFile();
+        const lines = await readBrainLines(this.filePath);
+        const map = new Map();
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                if (!obj.id)
+                    continue;
+                map.set(obj.id, obj);
+            }
+            catch {
+                continue;
+            }
+        }
+        this.cache = map;
+        try {
+            const s = await stat(this.filePath);
+            this.lastMtime = s.mtimeMs;
+        }
+        catch { /* ok */ }
+        return map;
+    }
+    invalidate() {
+        this.cache = null;
+    }
+    // ── CRUD ──────────────────────────────────────────────────────────────────
+    async list(filter) {
+        const map = await this.load();
+        let blocks = Array.from(map.values());
+        if (filter?.date) {
+            const datePrefix = filter.date; // YYYY-MM-DD
+            blocks = blocks.filter((b) => {
+                if (b.start)
+                    return b.start.startsWith(datePrefix);
+                if (b.dueAt)
+                    return b.dueAt.startsWith(datePrefix);
+                return false;
+            });
+        }
+        if (filter?.status) {
+            blocks = blocks.filter((b) => b.status === filter.status);
+        }
+        if (filter?.type) {
+            blocks = blocks.filter((b) => b.type === filter.type);
+        }
+        // Sort by start time / dueAt
+        blocks.sort((a, b) => {
+            const aTime = a.start || a.dueAt || a.createdAt;
+            const bTime = b.start || b.dueAt || b.createdAt;
+            return aTime.localeCompare(bTime);
+        });
+        return blocks;
+    }
+    async get(id) {
+        const map = await this.load();
+        return map.get(id) ?? null;
+    }
+    async create(opts) {
+        const now = new Date().toISOString();
+        const block = {
+            id: generateId(),
+            type: opts.type,
+            title: opts.title,
+            start: opts.start,
+            end: opts.end,
+            dueAt: opts.dueAt,
+            boardItemId: opts.boardItemId,
+            status: "planned",
+            tags: opts.tags,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await appendBrainLine(this.filePath, JSON.stringify(block));
+        this.invalidate();
+        log.info(`Created block ${block.id}: ${block.title}`);
+        return block;
+    }
+    async update(id, changes) {
+        const existing = await this.get(id);
+        if (!existing)
+            return null;
+        const updated = {
+            ...existing,
+            ...changes,
+            updatedAt: new Date().toISOString(),
+        };
+        await appendBrainLine(this.filePath, JSON.stringify(updated));
+        this.invalidate();
+        log.info(`Updated block ${id}: status=${updated.status}`);
+        return updated;
+    }
+    // ── Day schedule ──────────────────────────────────────────────────────────
+    async getToday() {
+        const today = new Date().toISOString().slice(0, 10);
+        const blocks = await this.list({ date: today });
+        const stats = {
+            total: blocks.length,
+            planned: 0,
+            active: 0,
+            completed: 0,
+            skipped: 0,
+            cancelled: 0,
+        };
+        for (const b of blocks) {
+            if (b.status in stats) {
+                stats[b.status]++;
+            }
+        }
+        return { date: today, blocks, stats };
+    }
+    // ── Timer helpers ─────────────────────────────────────────────────────────
+    /** Get blocks starting within the next N milliseconds. */
+    async getUpcoming(withinMs) {
+        const map = await this.load();
+        const now = Date.now();
+        const horizon = now + withinMs;
+        const results = [];
+        for (const block of map.values()) {
+            if (block.status !== "planned")
+                continue;
+            if (!block.start)
+                continue;
+            const startTime = new Date(block.start).getTime();
+            if (startTime > now && startTime <= horizon) {
+                results.push(block);
+            }
+        }
+        return results;
+    }
+    /** Get blocks that are overdue (past end time, still planned). */
+    async getOverdue() {
+        const map = await this.load();
+        const now = Date.now();
+        const results = [];
+        for (const block of map.values()) {
+            if (block.status !== "planned")
+                continue;
+            if (block.end) {
+                const endTime = new Date(block.end).getTime();
+                if (endTime < now) {
+                    results.push(block);
+                }
+            }
+            else if (block.dueAt) {
+                const dueTime = new Date(block.dueAt).getTime();
+                if (dueTime < now) {
+                    results.push(block);
+                }
+            }
+        }
+        return results;
+    }
+    /** Get blocks whose start time has arrived but are still planned. */
+    async getReadyToActivate() {
+        const map = await this.load();
+        const now = Date.now();
+        const results = [];
+        for (const block of map.values()) {
+            if (block.status !== "planned")
+                continue;
+            if (!block.start)
+                continue;
+            const startTime = new Date(block.start).getTime();
+            const endTime = block.end ? new Date(block.end).getTime() : Infinity;
+            if (startTime <= now && endTime > now) {
+                results.push(block);
+            }
+        }
+        return results;
+    }
+}
+// ── Singleton ──────────────────────────────────────────────────────────────
+let _store = null;
+export function createSchedulingStore(brainDir) {
+    if (_store)
+        return _store;
+    _store = new SchedulingStore(brainDir);
+    return _store;
+}
+export function getSchedulingStore() {
+    return _store;
+}
+//# sourceMappingURL=store.js.map

package/dist/scheduling/store.js.map

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

package/dist/scheduling/timer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Background scheduling timer.
+ * Checks for upcoming/overdue blocks every 5 minutes.
+ * Follows src/google/calendar-timer.ts pattern: module-level state, idempotent start/stop.
+ *
+ * Behavior:
+ * 1. Blocks starting within 15 min → push notification
+ * 2. Blocks past end time + still planned → log activity (creates voltage)
+ * 3. Blocks 2+ hours overdue → auto-transition to skipped
+ * 4. Blocks whose start has arrived → auto-transition to active
+ */
+import type { SchedulingStore } from "./store.js";
+/**
+ * Start the scheduling timer. Idempotent.
+ */
+export declare function startSchedulingTimer(store: SchedulingStore, intervalMs?: number): void;
+/**
+ * Stop the scheduling timer.
+ */
+export declare function stopSchedulingTimer(): void;
+/**
+ * Check if the scheduling timer is running.
+ */
+export declare function isSchedulingTimerRunning(): boolean;
+//# sourceMappingURL=timer.d.ts.map

package/dist/scheduling/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/scheduling/timer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWlD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAgBtF;AAwED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD"}