@cleocode/lafs 2026.4.10 → 2026.4.12

package/dist/src/operation-gates.js

@@ -0,0 +1,227 @@
+/**
+ * Static gate table for CLEO CLI operations.
+ *
+ * @remarks
+ * Gates are preconditions that an operation enforces at runtime — typically
+ * encoded as `new CleoError(...)` throws inside core task-engine handlers.
+ * Until a dynamic gate-registry lands (future work), this file provides a
+ * curated static table for the 3 most-called operations so that
+ * `describeOperation()` can surface them to agents without a trial-and-error
+ * call.
+ *
+ * **Limitation**: only `tasks.add`, `tasks.complete`, and `tasks.show` are
+ * seeded here.  Every other operation returns `gates: []`.  When gate-registry
+ * work lands, replace this table with a registry walk and remove this note.
+ *
+ * @module
+ */
+/**
+ * Mapping from `"<domain>.<operation>"` to extended parameter descriptors.
+ *
+ * @remarks
+ * Used by `describeOperation()` to supplement registry operations whose
+ * `params` array is absent or incomplete.  Only the 3 most-used operations
+ * are seeded here.
+ */
+export const STATIC_PARAMS_TABLE = {
+    'tasks.add': [
+        {
+            name: 'title',
+            type: 'string',
+            required: true,
+            description: 'Task title (3–500 characters)',
+            cli: { positional: true },
+        },
+        {
+            name: 'parent',
+            type: 'string',
+            required: false,
+            description: 'Parent task ID (makes this task a subtask)',
+            cli: { flag: 'parent' },
+        },
+        {
+            name: 'priority',
+            type: 'string',
+            required: false,
+            description: 'Task priority',
+            enum: ['low', 'medium', 'high', 'critical'],
+            cli: { short: '-p', flag: 'priority' },
+        },
+        {
+            name: 'type',
+            type: 'string',
+            required: false,
+            description: 'Task type',
+            enum: ['epic', 'task', 'subtask', 'bug'],
+            cli: { short: '-t', flag: 'type' },
+        },
+        {
+            name: 'size',
+            type: 'string',
+            required: false,
+            description: 'Scope size estimate',
+            enum: ['small', 'medium', 'large'],
+            cli: { flag: 'size' },
+        },
+        {
+            name: 'description',
+            type: 'string',
+            required: false,
+            description: 'Detailed task description (must differ meaningfully from title)',
+            cli: { short: '-d', flag: 'description' },
+        },
+        {
+            name: 'acceptance',
+            type: 'array',
+            required: false,
+            description: 'Pipe-separated acceptance criteria (e.g. "AC1|AC2|AC3")',
+            cli: { flag: 'acceptance' },
+        },
+        {
+            name: 'labels',
+            type: 'array',
+            required: false,
+            description: 'Comma-separated labels',
+            cli: { short: '-l', flag: 'labels' },
+        },
+        {
+            name: 'depends',
+            type: 'array',
+            required: false,
+            description: 'Comma-separated dependency task IDs',
+            cli: { short: '-D', flag: 'depends' },
+        },
+        {
+            name: 'phase',
+            type: 'string',
+            required: false,
+            description: 'Phase slug to assign the task to',
+            cli: { short: '-P', flag: 'phase' },
+        },
+        {
+            name: 'notes',
+            type: 'string',
+            required: false,
+            description: 'Initial note entry for the task',
+            cli: { flag: 'notes' },
+        },
+    ],
+    'tasks.complete': [
+        {
+            name: 'taskId',
+            type: 'string',
+            required: true,
+            description: 'ID of the task to complete',
+            cli: { positional: true },
+        },
+        {
+            name: 'force',
+            type: 'boolean',
+            required: false,
+            description: 'Force completion even when children are not done or dependencies unresolved',
+            cli: { flag: 'force' },
+        },
+        {
+            name: 'verificationNote',
+            type: 'string',
+            required: false,
+            description: 'Evidence that acceptance criteria were met',
+            cli: { flag: 'verification-note' },
+        },
+    ],
+    'tasks.show': [
+        {
+            name: 'taskId',
+            type: 'string',
+            required: true,
+            description: 'ID of the task to retrieve',
+            cli: { positional: true },
+        },
+    ],
+};
+// ---------------------------------------------------------------------------
+// Static gate table (operation key = "<domain>.<operation>")
+// ---------------------------------------------------------------------------
+/**
+ * Mapping from `"<domain>.<operation>"` to its declared gates.
+ *
+ * @remarks
+ * Only the 3 most-used operations are seeded.  All other operations should
+ * return an empty array.  See module-level note on the static-table limitation.
+ */
+export const STATIC_GATE_TABLE = {
+    'tasks.add': [
+        {
+            name: 'anti-hallucination',
+            errorCode: 'E_VALIDATION_FAILED',
+            description: 'Title and description must be meaningfully different',
+            triggers: [
+                'title and description are identical strings',
+                'description is a substring of the title',
+                'title is a substring of the description',
+            ],
+        },
+        {
+            name: 'acceptance-criteria-format',
+            errorCode: 'E_VALIDATION_FAILED',
+            description: 'Acceptance criteria must be pipe-separated checklist items',
+            triggers: [
+                'acceptance criteria contains fewer than 1 non-empty item after splitting on pipe (|)',
+                'individual acceptance item exceeds 500 characters',
+            ],
+        },
+        {
+            name: 'parent-exists',
+            errorCode: 'E_NOT_FOUND',
+            description: 'Parent task must exist if --parent is specified',
+            triggers: ['--parent <id> is specified but no task with that ID exists in the database'],
+        },
+        {
+            name: 'title-length',
+            errorCode: 'E_VALIDATION_FAILED',
+            description: 'Title must be between 3 and 500 characters',
+            triggers: ['title is shorter than 3 characters', 'title is longer than 500 characters'],
+        },
+    ],
+    'tasks.complete': [
+        {
+            name: 'task-exists',
+            errorCode: 'E_NOT_FOUND',
+            description: 'Task must exist before it can be completed',
+            triggers: ['no task with the given taskId exists in the database'],
+        },
+        {
+            name: 'children-completion',
+            errorCode: 'E_INCOMPLETE_CHILDREN',
+            description: 'All direct children must be done/cancelled before parent can be completed',
+            triggers: [
+                'task has at least one child with status pending, active, or blocked',
+                '--force flag is absent',
+            ],
+        },
+        {
+            name: 'dependency-check',
+            errorCode: 'E_BLOCKED',
+            description: 'All blocking dependencies must be resolved before completion',
+            triggers: ['task has at least one unresolved blocking dependency', '--force flag is absent'],
+        },
+        {
+            name: 'verification-required',
+            errorCode: 'E_VERIFICATION_REQUIRED',
+            description: 'Task completion requires verification evidence when acceptance criteria exist',
+            triggers: [
+                'task has acceptance criteria defined',
+                'no --verification-note or --verify flag was supplied',
+            ],
+        },
+    ],
+    'tasks.show': [
+        {
+            name: 'task-exists',
+            errorCode: 'E_NOT_FOUND',
+            description: 'Task must exist to be shown',
+            triggers: ['no task with the given taskId exists in the database'],
+        },
+    ],
+};
+//# sourceMappingURL=operation-gates.js.map

package/dist/src/operation-gates.js.map

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