phaibel 4.0.7

package/dist/feral/node-code/entity/create-entity-type-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class CreateEntityTypeNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=create-entity-type-node-code.d.ts.map

package/dist/feral/node-code/entity/create-entity-type-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity-type-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/create-entity-type-node-code.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA6B5D,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAa5D;IAEF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAIrD;;IAWI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAiFnD"}

package/dist/feral/node-code/entity/create-entity-type-node-code.js

@@ -0,0 +1,131 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Create Entity Type NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Given a type name and plain-English description, asks the LLM to design the
+// field schema, then registers the new entity type in ~/.phaibel/entity-types.json.
+//
+// Config:
+//   type_name    — singular slug, e.g. "person" or "album"
+//   description  — what this entity represents, e.g. "A music album to remember"
+//
+// Context output:
+//   entity_type  — the full EntityTypeConfig that was created
+// ─────────────────────────────────────────────────────────────────────────────
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+import { addEntityType } from '../../../entities/entity-type-config.js';
+import { getModelForCapability } from '../../../llm/router.js';
+const ALREADY_EXISTS = 'already_exists';
+const SYSTEM_PROMPT = `You are a data modelling assistant for a personal knowledge-management CLI called Phaibel.
+Given a type name and description, produce a JSON object defining the fields for that entity type.
+
+Rules:
+- Return ONLY a valid JSON object — no markdown, no commentary, no code fences.
+- The object must have these top-level keys:
+    plural        : string  (plural form of the type name)
+    description   : string  (short description ≤ 80 chars)
+    fields        : array of field objects (see below)
+    completionField : string | null   (which field tracks done/complete state, or null)
+    completionValue : string | null   (the value that means done, or null)
+- Each field object must have:
+    key      : string  (camelCase identifier, no spaces)
+    label    : string  (human-readable label)
+    type     : one of: string | number | boolean | date | datetime | enum
+    required : boolean
+- Enum fields must also include:
+    values   : string[]  (allowed values)
+    default  : string    (the default value, must be in values)
+- Keep it practical: 2–6 fields is usually right. Do not over-engineer.
+- Only add a completionField/completionValue if the entity genuinely has a done/archived/complete state.`;
+export class CreateEntityTypeNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        {
+            key: 'type_name',
+            name: 'Type Name',
+            description: 'Singular slug for the new entity type (e.g. "album", "person"). Supports {context_key} interpolation.',
+            type: 'string',
+        },
+        {
+            key: 'description',
+            name: 'Description',
+            description: 'Plain-English description of what this entity represents. Supports {context_key} interpolation.',
+            type: 'string',
+        },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'Entity type created successfully.' },
+        { status: ALREADY_EXISTS, description: 'An entity type with this name already exists.' },
+        { status: ResultStatus.ERROR, description: 'Failed to create entity type.' },
+    ];
+    constructor() {
+        super('create_entity_type', 'Create Entity Type', 'Uses the LLM to design a field schema, then registers a new entity type.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const rawName = this.getRequiredConfigValue('type_name');
+        const rawDesc = this.getRequiredConfigValue('description');
+        const typeName = this.interpolate(rawName, context).trim().toLowerCase().replace(/\s+/g, '-');
+        const description = this.interpolate(rawDesc, context).trim();
+        if (!typeName) {
+            context.set('error', 'type_name is required.');
+            return this.result(ResultStatus.ERROR, 'type_name is required.');
+        }
+        // ── Ask LLM to design the schema ────────────────────────────────────
+        const userPrompt = `Design the field schema for a "${typeName}" entity type.\n\nDescription: ${description}`;
+        let schemaJson;
+        try {
+            const llm = await getModelForCapability('reason');
+            schemaJson = await llm.chat([{ role: 'user', content: userPrompt }], { systemPrompt: SYSTEM_PROMPT, temperature: 0.2, maxTokens: 1024 });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            context.set('error', `LLM call failed: ${msg}`);
+            return this.result(ResultStatus.ERROR, `LLM call failed: ${msg}`);
+        }
+        // ── Parse and validate ───────────────────────────────────────────────
+        let schema;
+        try {
+            // Strip any accidental code fences
+            const cleaned = schemaJson.replace(/```[a-z]*\n?/g, '').replace(/```/g, '').trim();
+            schema = JSON.parse(cleaned);
+        }
+        catch {
+            context.set('error', 'LLM returned invalid JSON.');
+            return this.result(ResultStatus.ERROR, `LLM returned invalid JSON: ${schemaJson.slice(0, 200)}`);
+        }
+        if (!Array.isArray(schema.fields)) {
+            context.set('error', 'LLM schema missing "fields" array.');
+            return this.result(ResultStatus.ERROR, 'LLM schema missing "fields" array.');
+        }
+        const plural = (schema.plural ?? typeName + 's').trim();
+        const config = {
+            name: typeName,
+            plural,
+            directory: plural,
+            description: schema.description ?? description,
+            defaultTags: [typeName],
+            fields: schema.fields,
+        };
+        if (schema.completionField) {
+            config.completionField = schema.completionField;
+            config.completionValue = schema.completionValue ?? undefined;
+        }
+        // ── Register ─────────────────────────────────────────────────────────
+        try {
+            await addEntityType(config);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('already exists')) {
+                context.set('error', msg);
+                return this.result(ALREADY_EXISTS, msg);
+            }
+            context.set('error', msg);
+            return this.result(ResultStatus.ERROR, msg);
+        }
+        context.set('entity_type', config);
+        return this.result(ResultStatus.OK, `Created entity type "${typeName}" with ${config.fields.length} field(s).`);
+    }
+}
+//# sourceMappingURL=create-entity-type-node-code.js.map

package/dist/feral/node-code/entity/create-entity-type-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity-type-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/create-entity-type-node-code.ts"],"names":[],"mappings":"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"}

package/dist/feral/node-code/entity/create-recurring-task-node-code.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class CreateRecurringTaskNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+    /**
+     * Resolve a value from config → context → fallback.
+     */
+    private resolveValue;
+}
+//# sourceMappingURL=create-recurring-task-node-code.d.ts.map

package/dist/feral/node-code/entity/create-recurring-task-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-recurring-task-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/create-recurring-task-node-code.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAa5D,qBAAa,2BAA4B,SAAQ,gBAAgB;IAC7D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAS5D;IACF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAGrD;;IAWI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAiHhD;;OAEG;IACH,OAAO,CAAC,YAAY;CAOvB"}

package/dist/feral/node-code/entity/create-recurring-task-node-code.js

@@ -0,0 +1,146 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Create Recurring Task NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Creates a recurrence entity and immediately spawns concrete task/event
+// instances via the spawner system.
+// ─────────────────────────────────────────────────────────────────────────────
+import path from 'path';
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+import { generateEntityId, ensureEntityDir, writeEntity, entityFilename, } from '../../../entities/entity.js';
+import { getEntityType } from '../../../entities/entity-type-config.js';
+import { getEntityIndex } from '../../../entities/entity-index.js';
+import { spawn } from '../../../entities/spawner.js';
+import { ensureRecurrenceType } from '../../../commands/recurrence.js';
+export class CreateRecurringTaskNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'entity_title', name: 'Title', description: 'Title for the recurrence. Falls back to context "title".', type: 'string', isOptional: true },
+        { key: 'cadence', name: 'Cadence', description: 'daily, weekly, or monthly (default: weekly).', type: 'string', isOptional: true },
+        { key: 'priority', name: 'Priority', description: 'Default priority for spawned tasks (default: medium).', type: 'string', isOptional: true },
+        { key: 'day_of_week', name: 'Day of Week', description: 'For weekly cadence: monday–sunday.', type: 'string', isOptional: true },
+        { key: 'day_of_month', name: 'Day of Month', description: 'For monthly cadence: 1–31.', type: 'string', isOptional: true },
+        { key: 'entity_body', name: 'Body', description: 'Template body content for spawned entities.', type: 'string', isOptional: true },
+        { key: 'target_type', name: 'Target Type', description: 'Entity type to spawn: task or event (default: task).', type: 'string', isOptional: true },
+        { key: 'spawn_days', name: 'Spawn Days', description: 'Days ahead to generate instances (default: 60).', type: 'string', isOptional: true },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'Recurrence created and instances spawned.' },
+        { status: ResultStatus.ERROR, description: 'Failed to create recurrence.' },
+    ];
+    constructor() {
+        super('create_recurring_task', 'Create Recurring Task', 'Creates a recurring task/event with a recurrence template and spawns concrete instances.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        // Ensure the recurrence entity type is registered
+        await ensureRecurrenceType();
+        // ── Resolve title ────────────────────────────────────────────────
+        const configTitle = this.getOptionalConfigValue('entity_title');
+        if (configTitle) {
+            context.set('title', this.interpolate(configTitle, context));
+        }
+        const title = context.get('title');
+        if (!title) {
+            context.set('error', 'No title provided in context.');
+            return this.result(ResultStatus.ERROR, 'Missing title in context.');
+        }
+        // ── Resolve config values ────────────────────────────────────────
+        const cadence = this.resolveValue('cadence', context, 'weekly');
+        const priority = this.resolveValue('priority', context, 'medium');
+        const dayOfWeek = this.resolveValue('day_of_week', context, null);
+        const dayOfMonth = this.resolveValue('day_of_month', context, null);
+        const targetType = this.resolveValue('target_type', context, 'task');
+        const spawnDays = Number(this.resolveValue('spawn_days', context, '60')) || 60;
+        const configBody = this.getOptionalConfigValue('entity_body');
+        const body = configBody ? this.interpolate(configBody, context) : (context.get('content') ?? '');
+        // ── Build cadenceDetails ─────────────────────────────────────────
+        const cadenceDetails = {};
+        if (dayOfWeek)
+            cadenceDetails.dayOfWeek = dayOfWeek;
+        if (dayOfMonth)
+            cadenceDetails.dayOfMonth = Number(dayOfMonth);
+        // ── Create recurrence entity file ────────────────────────────────
+        const dir = await ensureEntityDir('recurrence');
+        const id = generateEntityId('recurrence');
+        const filepath = path.join(dir, entityFilename(title, id));
+        const meta = {
+            id,
+            title,
+            entityType: 'recurrence',
+            created: new Date().toISOString(),
+            tags: ['recurring'],
+            cadence,
+            cadenceDetails,
+            targetType,
+            priority,
+            status: 'active',
+            blackoutWindows: [],
+        };
+        await writeEntity(filepath, meta, body);
+        // Update entity index
+        const index = getEntityIndex();
+        if (index.isBuilt) {
+            await index.addOrUpdate('recurrence', id, title, filepath);
+        }
+        // ── Spawn concrete instances ─────────────────────────────────────
+        const recurrenceTypeConfig = await getEntityType('recurrence');
+        // Build a spawner config matching what the spawner expects
+        const spawnerConfig = recurrenceTypeConfig?.spawner ?? {
+            mode: 'date-series',
+            targetTypeField: 'targetType',
+            titlePattern: '{title} — {YYYY-MM-DD}',
+            dedupeFields: ['title', 'dueDate'],
+            scheduling: {
+                cadenceField: 'cadence',
+                cadenceDetailsField: 'cadenceDetails',
+                blackoutField: 'blackoutWindows',
+            },
+            fieldMapping: [
+                { from: 'priority', to: 'priority' },
+                { value: 'open', to: 'status' },
+                { value: '{date}', to: 'dueDate' },
+            ],
+        };
+        const template = {
+            filepath,
+            meta,
+            content: body,
+        };
+        const today = new Date();
+        today.setHours(0, 0, 0, 0);
+        const endDate = new Date(today);
+        endDate.setDate(endDate.getDate() + spawnDays);
+        let spawnResult = { created: 0, skipped: 0 };
+        try {
+            spawnResult = await spawn(template, spawnerConfig, {
+                startDate: today,
+                endDate,
+            });
+        }
+        catch (err) {
+            context.set('error', `Recurrence created but spawning failed: ${err}`);
+            context.set('recurringTask', { id, title, cadence });
+            context.set('spawnResult', { created: 0, skipped: 0, error: String(err) });
+            return this.result(ResultStatus.ERROR, `Recurrence "${title}" created but spawn failed: ${err}`);
+        }
+        // ── Set context for downstream nodes ─────────────────────────────
+        context.set('recurringTask', { id, title, cadence });
+        context.set('spawnResult', spawnResult);
+        context.set('filepath', filepath);
+        return this.result(ResultStatus.OK, `Created recurrence "${title}" (${cadence}) and spawned ${spawnResult.created} ${targetType}(s), ${spawnResult.skipped} skipped.`);
+    }
+    /**
+     * Resolve a value from config → context → fallback.
+     */
+    resolveValue(key, context, fallback) {
+        const configVal = this.getOptionalConfigValue(key);
+        if (configVal)
+            return this.interpolate(configVal, context);
+        const contextVal = context.get(key);
+        if (contextVal)
+            return contextVal;
+        return fallback;
+    }
+}
+//# sourceMappingURL=create-recurring-task-node-code.js.map

package/dist/feral/node-code/entity/create-recurring-task-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-recurring-task-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/create-recurring-task-node-code.ts"],"names":[],"mappings":"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"}

package/dist/feral/node-code/entity/delete-entity-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class DeleteEntityNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=delete-entity-node-code.d.ts.map

package/dist/feral/node-code/entity/delete-entity-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/delete-entity-node-code.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQ5D,qBAAa,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAG5D;IACF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAGrD;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CA4CnD"}

package/dist/feral/node-code/entity/delete-entity-node-code.js

@@ -0,0 +1,60 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Delete Entity NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+import { findEntityByTitle, trashEntity } from '../../../entities/entity.js';
+import { getEntityIndex } from '../../../entities/entity-index.js';
+import { getEmbeddingIndex } from '../../../entities/embedding-index.js';
+const NOT_FOUND = 'not_found';
+export class DeleteEntityNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'entity_type', name: 'Entity Type', description: 'The entity type to delete (any configured entity type, e.g. task, note, event, goal).', type: 'string' },
+        { key: 'entity_title', name: 'Entity Title', description: 'Title of the entity to delete. Supports {context_key} interpolation.', type: 'string', isOptional: true },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'Entity deleted successfully.' },
+        { status: NOT_FOUND, description: 'Entity not found.' },
+    ];
+    constructor() {
+        super('delete_entity', 'Delete Entity', 'Deletes an entity by title.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const entityType = this.getRequiredConfigValue('entity_type');
+        // Read title from config (preferred) or context
+        const configTitle = this.getOptionalConfigValue('entity_title');
+        if (configTitle) {
+            context.set('title', this.interpolate(configTitle, context));
+        }
+        const title = context.get('title');
+        if (!title) {
+            context.set('error', 'No title provided in context.');
+            return this.result(NOT_FOUND, 'Missing title in context.');
+        }
+        const found = await findEntityByTitle(entityType, title);
+        if (!found) {
+            context.set('error', `${entityType} "${title}" not found.`);
+            return this.result(NOT_FOUND, `${entityType} "${title}" not found.`);
+        }
+        await trashEntity(found.filepath);
+        // Update entity index incrementally
+        const index = getEntityIndex();
+        if (index.isBuilt) {
+            index.remove(entityType, found.meta.id);
+        }
+        // Update embedding index
+        const embeddingIndex = getEmbeddingIndex();
+        if (embeddingIndex.isLoaded) {
+            const id = found.meta.id;
+            embeddingIndex.remove(`${entityType}:${id}`);
+        }
+        context.set('deleted', {
+            filepath: found.filepath,
+            title: found.meta.title,
+            deleted: true,
+        });
+        return this.result(ResultStatus.OK, `Deleted ${entityType} "${title}".`);
+    }
+}
+//# sourceMappingURL=delete-entity-node-code.js.map

package/dist/feral/node-code/entity/delete-entity-node-code.js.map

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

package/dist/feral/node-code/entity/delete-entity-type-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class DeleteEntityTypeNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=delete-entity-type-node-code.d.ts.map

package/dist/feral/node-code/entity/delete-entity-type-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity-type-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/delete-entity-type-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAO5D,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAO5D;IAEF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAKrD;;IAWI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAuBnD"}

package/dist/feral/node-code/entity/delete-entity-type-node-code.js

@@ -0,0 +1,51 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Delete Entity Type NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+import { removeEntityType } from '../../../entities/entity-type-config.js';
+const NOT_FOUND = 'not_found';
+const PROTECTED = 'protected';
+export class DeleteEntityTypeNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        {
+            key: 'type_name',
+            name: 'Type Name',
+            description: 'The name of the entity type to delete. Supports {context_key} interpolation.',
+            type: 'string',
+        },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'Entity type deleted successfully.' },
+        { status: NOT_FOUND, description: 'Entity type not found.' },
+        { status: PROTECTED, description: 'Entity type is built-in and cannot be deleted.' },
+        { status: ResultStatus.ERROR, description: 'Failed to delete entity type.' },
+    ];
+    constructor() {
+        super('delete_entity_type', 'Delete Entity Type', 'Removes a custom entity type from the registry. Built-in types (task, note) are protected.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const rawName = this.getRequiredConfigValue('type_name');
+        const typeName = this.interpolate(rawName, context).trim();
+        try {
+            await removeEntityType(typeName);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('built-in')) {
+                context.set('error', msg);
+                return this.result(PROTECTED, msg);
+            }
+            if (msg.includes('not found')) {
+                context.set('error', msg);
+                return this.result(NOT_FOUND, msg);
+            }
+            context.set('error', msg);
+            return this.result(ResultStatus.ERROR, msg);
+        }
+        context.set('deleted_type', typeName);
+        return this.result(ResultStatus.OK, `Deleted entity type "${typeName}".`);
+    }
+}
+//# sourceMappingURL=delete-entity-type-node-code.js.map

package/dist/feral/node-code/entity/delete-entity-type-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-entity-type-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/delete-entity-type-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAIhF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,SAAS,GAAG,WAAW,CAAC;AAE9B,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IAC1D,MAAM,CAAU,kBAAkB,GAA+B;QAC7D;YACI,GAAG,EAAE,WAAW;YAChB,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,8EAA8E;YAC3F,IAAI,EAAE,QAAQ;SACjB;KACJ,CAAC;IAEF,MAAM,CAAU,kBAAkB,GAAwB;QACtD,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,mCAAmC,EAAE;QAC7E,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAC5D,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,gDAAgD,EAAE;QACpF,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,+BAA+B,EAAE;KAC/E,CAAC;IAEF;QACI,KAAK,CACD,oBAAoB,EACpB,oBAAoB,EACpB,4FAA4F,EAC5F,gBAAgB,CAAC,IAAI,CACxB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAW,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAE3D,IAAI,CAAC;YACD,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,wBAAwB,QAAQ,IAAI,CAAC,CAAC;IAC9E,CAAC"}

package/dist/feral/node-code/entity/find-entity-node-code.d.ts

@@ -0,0 +1,13 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class FindEntityNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    /** Accept extra config keys (e.g. LLM putting "title" directly in config) */
+    get allowExtraConfig(): boolean;
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=find-entity-node-code.d.ts.map

package/dist/feral/node-code/entity/find-entity-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-entity-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/find-entity-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAS5D,qBAAa,kBAAmB,SAAQ,gBAAgB;IACpD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAK5D;IACF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAGrD;IAEF,6EAA6E;IAC7E,IAAI,gBAAgB,IAAI,OAAO,CAAiB;;IAM1C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAkCnD"}

package/dist/feral/node-code/entity/find-entity-node-code.js

@@ -0,0 +1,59 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Find Entity NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+import { findEntityByTitle } from '../../../entities/entity.js';
+/**
+ * Custom result status for "not found" branching.
+ */
+const NOT_FOUND = 'not_found';
+export class FindEntityNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'entity_type', name: 'Entity Type', description: 'The entity type to search (any configured entity type, e.g. task, note, event, goal).', type: 'string' },
+        { key: 'entity_title', name: 'Entity Title', description: 'Title/filename to search for. Supports {context_key} interpolation. Sets the title in context.', type: 'string', isOptional: true },
+        { key: 'title_context_key', name: 'Title Context Key', description: 'Context key holding the title/filename to search for.', type: 'string', default: 'title' },
+        { key: 'context_path', name: 'Context Path', description: 'Context key to store the found entity.', type: 'string', default: 'entity' },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'Entity found.' },
+        { status: NOT_FOUND, description: 'Entity not found.' },
+    ];
+    /** Accept extra config keys (e.g. LLM putting "title" directly in config) */
+    get allowExtraConfig() { return true; }
+    constructor() {
+        super('find_entity', 'Find Entity', 'Finds an entity by title or filename.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const entityType = this.getRequiredConfigValue('entity_type');
+        const titleKey = this.getRequiredConfigValue('title_context_key', 'title');
+        const contextPath = this.getRequiredConfigValue('context_path', 'entity');
+        // Bridge config → context: LLMs often put the title in config
+        const configTitle = this.getOptionalConfigValue('entity_title');
+        const configTitleDirect = this.getOptionalConfigValue('title');
+        if (configTitle) {
+            context.set(titleKey, this.interpolate(configTitle, context));
+        }
+        else if (configTitleDirect) {
+            context.set(titleKey, this.interpolate(configTitleDirect, context));
+        }
+        const title = context.get(titleKey);
+        if (!title) {
+            context.set('error', `No title found in context at "${titleKey}".`);
+            return this.result(NOT_FOUND, `No title provided at context key "${titleKey}".`);
+        }
+        const found = await findEntityByTitle(entityType, title);
+        if (!found) {
+            context.set('error', `${entityType} "${title}" not found.`);
+            return this.result(NOT_FOUND, `${entityType} "${title}" not found.`);
+        }
+        context.set(contextPath, {
+            filepath: found.filepath,
+            content: found.content,
+            ...found.meta,
+        });
+        return this.result(ResultStatus.OK, `Found ${entityType} "${title}".`);
+    }
+}
+//# sourceMappingURL=find-entity-node-code.js.map

package/dist/feral/node-code/entity/find-entity-node-code.js.map

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

package/dist/feral/node-code/entity/link-entities-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class LinkEntitiesNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=link-entities-node-code.d.ts.map

package/dist/feral/node-code/entity/link-entities-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-entities-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/entity/link-entities-node-code.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAM5D,qBAAa,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAM5D;IACF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAIrD;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAyCnD"}