@formigio/fazemos-cli 0.10.11 → 0.10.13

package/dist/manifest/schema.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Permissive structural schema for Architecture Design Manifests
+ * (e.g., specs/tech/<area>/<feature>-manifest.yaml).
+ *
+ * Philosophy: require manifest_version + a feature block with id/title.
+ * Type top-level sections when present; do NOT reject unknown keys.
+ * Real defect-detection lives in checks.ts (audit math, AC traceability,
+ * duplicate IDs). The schema's job is to catch shape errors and missing
+ * load-bearing identifiers, not to prescribe every legitimate variation.
+ *
+ * Bumped together with the CLI version. Manifest authors pin
+ * manifest_version per-file; the CLI tolerates any version it knows about.
+ */
+export declare const KNOWN_MANIFEST_VERSIONS: readonly ["0.1"];
+export declare const manifestSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://fazemos/schemas/manifest.json";
+    readonly type: "object";
+    readonly required: readonly ["feature"];
+    readonly additionalProperties: true;
+    readonly properties: {
+        readonly manifest_version: {
+            readonly type: "string";
+        };
+        readonly feature: {
+            readonly type: "object";
+            readonly required: readonly ["id", "title"];
+            readonly additionalProperties: true;
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly title: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly priority: {
+                    readonly type: "string";
+                };
+                readonly area: {
+                    readonly type: "string";
+                };
+                readonly status: {
+                    readonly type: "string";
+                };
+                readonly effort: {
+                    readonly type: "string";
+                };
+                readonly estimated_hours: {
+                    readonly type: "string";
+                };
+                readonly depends_on: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly related: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly repos_affected: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly phase_1_gate: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+            readonly properties: {
+                readonly questions: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["id"];
+                        readonly additionalProperties: true;
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                            };
+                            readonly title: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly schema: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly api: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly permissions: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly frontend: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly agent_runner: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly cli: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly states: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly rules: {
+            readonly anyOf: readonly [{
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            }];
+        };
+        readonly entry_points: {
+            readonly anyOf: readonly [{
+                readonly type: "object";
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly added: {
+                        readonly type: "array";
+                    };
+                    readonly modified: {
+                        readonly type: "array";
+                    };
+                    readonly replaced: {
+                        readonly type: "array";
+                    };
+                    readonly unchanged: {
+                        readonly type: "array";
+                    };
+                    readonly audit_summary: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                        readonly properties: {
+                            readonly added: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly modified: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly replaced: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly unchanged: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly total_in_this_manifest: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                        };
+                    };
+                };
+            }, {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+            }];
+        };
+        readonly edge_cases: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["id"];
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly risks: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly excluded: {
+            readonly type: readonly ["array", "object"];
+        };
+        readonly implementation: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+            readonly properties: {
+                readonly sequencing: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+                readonly phase_1_gate: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+                readonly api: {
+                    readonly $ref: "#/$defs/taskBucket";
+                };
+                readonly agent: {
+                    readonly $ref: "#/$defs/taskBucket";
+                };
+                readonly frontend: {
+                    readonly $ref: "#/$defs/taskBucket";
+                };
+                readonly cli: {
+                    readonly $ref: "#/$defs/taskBucket";
+                };
+                readonly docs: {
+                    readonly $ref: "#/$defs/taskBucket";
+                };
+            };
+        };
+        readonly traceability: {
+            readonly type: "object";
+            readonly additionalProperties: {
+                readonly anyOf: readonly [{
+                    readonly type: "string";
+                }, {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                }, {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                }];
+            };
+        };
+        readonly nexo: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+    };
+    readonly $defs: {
+        readonly taskBucket: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+            readonly properties: {
+                readonly repo: {
+                    readonly type: "string";
+                };
+                readonly tasks: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["id"];
+                        readonly additionalProperties: true;
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly title: {
+                                readonly type: "string";
+                            };
+                            readonly file: {
+                                readonly type: "string";
+                            };
+                            readonly effort: {
+                                readonly type: "string";
+                            };
+                            readonly depends_on: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};

package/dist/manifest/schema.js

@@ -0,0 +1,208 @@
+/**
+ * Permissive structural schema for Architecture Design Manifests
+ * (e.g., specs/tech/<area>/<feature>-manifest.yaml).
+ *
+ * Philosophy: require manifest_version + a feature block with id/title.
+ * Type top-level sections when present; do NOT reject unknown keys.
+ * Real defect-detection lives in checks.ts (audit math, AC traceability,
+ * duplicate IDs). The schema's job is to catch shape errors and missing
+ * load-bearing identifiers, not to prescribe every legitimate variation.
+ *
+ * Bumped together with the CLI version. Manifest authors pin
+ * manifest_version per-file; the CLI tolerates any version it knows about.
+ */
+export const KNOWN_MANIFEST_VERSIONS = ['0.1'];
+export const manifestSchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    $id: 'https://fazemos/schemas/manifest.json',
+    type: 'object',
+    // manifest_version is enforced as a separate rule (see checks.ts) so older
+    // manifests still validate the rest of their structure rather than failing
+    // up-front. Missing version surfaces as a warning, not a hard error.
+    required: ['feature'],
+    additionalProperties: true,
+    properties: {
+        manifest_version: { type: 'string' },
+        feature: {
+            type: 'object',
+            required: ['id', 'title'],
+            additionalProperties: true,
+            properties: {
+                id: { type: 'string', minLength: 1 },
+                title: { type: 'string', minLength: 1 },
+                priority: { type: 'string' },
+                area: { type: 'string' },
+                status: { type: 'string' },
+                effort: { type: 'string' },
+                estimated_hours: { type: 'string' },
+                depends_on: { type: 'array', items: { type: 'string' } },
+                related: { type: 'array', items: { type: 'string' } },
+                repos_affected: { type: 'array', items: { type: 'string' } },
+            },
+        },
+        phase_1_gate: {
+            type: 'object',
+            additionalProperties: true,
+            properties: {
+                questions: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        required: ['id'],
+                        additionalProperties: true,
+                        properties: {
+                            id: { type: 'string' },
+                            title: { type: 'string' },
+                        },
+                    },
+                },
+            },
+        },
+        schema: { type: 'object', additionalProperties: true },
+        api: { type: 'object', additionalProperties: true },
+        permissions: { type: 'object', additionalProperties: true },
+        frontend: { type: 'object', additionalProperties: true },
+        agent_runner: { type: 'object', additionalProperties: true },
+        cli: { type: 'object', additionalProperties: true },
+        states: { type: 'object', additionalProperties: true },
+        // `rules` appears as either a map (rule_id: { ... }) or a list of
+        // {id, name, description, ...} entries depending on author convention.
+        // Permissive: accept both. Duplicate-id check still enforces uniqueness
+        // when shape is array-of-objects.
+        rules: {
+            anyOf: [
+                {
+                    type: 'object',
+                    additionalProperties: {
+                        type: 'object',
+                        additionalProperties: true,
+                    },
+                },
+                {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        additionalProperties: true,
+                        properties: { id: { type: 'string' } },
+                    },
+                },
+            ],
+        },
+        // entry_points has two legitimate shapes in the wild:
+        //   (a) Map: { added: [...], modified: [...], replaced: [...], unchanged: [...], audit_summary: {...} }
+        //   (b) Flat list: [ { name|location, disposition, file, ... }, ... ]
+        // Both are accepted. The audit_summary numeric checks only fire on shape (a).
+        entry_points: {
+            anyOf: [
+                {
+                    type: 'object',
+                    additionalProperties: true,
+                    properties: {
+                        added: { type: 'array' },
+                        modified: { type: 'array' },
+                        replaced: { type: 'array' },
+                        unchanged: { type: 'array' },
+                        audit_summary: {
+                            type: 'object',
+                            additionalProperties: true,
+                            properties: {
+                                added: { type: 'integer', minimum: 0 },
+                                modified: { type: 'integer', minimum: 0 },
+                                replaced: { type: 'integer', minimum: 0 },
+                                unchanged: { type: 'integer', minimum: 0 },
+                                total_in_this_manifest: { type: 'integer', minimum: 0 },
+                            },
+                        },
+                    },
+                },
+                {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        additionalProperties: true,
+                    },
+                },
+            ],
+        },
+        edge_cases: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['id'],
+                additionalProperties: true,
+                properties: { id: { type: 'string' } },
+            },
+        },
+        risks: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: true,
+                properties: { id: { type: 'string' } },
+            },
+        },
+        excluded: { type: ['array', 'object'] },
+        implementation: {
+            type: 'object',
+            additionalProperties: true,
+            properties: {
+                sequencing: { type: 'object', additionalProperties: true },
+                phase_1_gate: { type: 'object', additionalProperties: true },
+                api: { $ref: '#/$defs/taskBucket' },
+                agent: { $ref: '#/$defs/taskBucket' },
+                frontend: { $ref: '#/$defs/taskBucket' },
+                cli: { $ref: '#/$defs/taskBucket' },
+                docs: { $ref: '#/$defs/taskBucket' },
+            },
+        },
+        // traceability values come in three legitimate shapes:
+        //   - string (a single source pointer; e.g. requirements_source: "...")
+        //   - object (a single AC block: { manifest, task, test, note })
+        //   - array of objects (multi-row criterion: [{ req, manifest, task }, ...])
+        traceability: {
+            type: 'object',
+            additionalProperties: {
+                anyOf: [
+                    { type: 'string' },
+                    {
+                        type: 'object',
+                        additionalProperties: true,
+                    },
+                    {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            additionalProperties: true,
+                        },
+                    },
+                ],
+            },
+        },
+        nexo: { type: 'object', additionalProperties: true },
+    },
+    $defs: {
+        taskBucket: {
+            type: 'object',
+            additionalProperties: true,
+            properties: {
+                repo: { type: 'string' },
+                tasks: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        required: ['id'],
+                        additionalProperties: true,
+                        properties: {
+                            id: { type: 'string', minLength: 1 },
+                            title: { type: 'string' },
+                            file: { type: 'string' },
+                            effort: { type: 'string' },
+                            depends_on: { type: 'array', items: { type: 'string' } },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/manifest/schema.js.map

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

package/dist/yaml/format.d.ts

@@ -0,0 +1,5 @@
+import type { Finding, FindingSummary } from './load.js';
+export declare function formatFinding(f: Finding): string;
+export declare function formatSummary(s: FindingSummary): string;
+export declare function printFindings(source: string, findings: Finding[], summary: FindingSummary): void;
+export declare function printJson(source: string, findings: Finding[], summary: FindingSummary): void;

package/dist/yaml/format.js

@@ -0,0 +1,41 @@
+import chalk from 'chalk';
+const ICONS = {
+    error: chalk.red('✗'),
+    warning: chalk.yellow('⚠'),
+    info: chalk.dim('ℹ'),
+};
+export function formatFinding(f) {
+    const icon = ICONS[f.severity];
+    const loc = f.line !== undefined ? chalk.dim(`:${f.line}${f.column !== undefined ? `:${f.column}` : ''}`) : '';
+    const rule = chalk.dim(`[${f.rule}]`);
+    return `  ${icon} ${rule} ${f.message}${loc}`;
+}
+export function formatSummary(s) {
+    const parts = [];
+    if (s.errors)
+        parts.push(chalk.red(`${s.errors} error${s.errors !== 1 ? 's' : ''}`));
+    if (s.warnings)
+        parts.push(chalk.yellow(`${s.warnings} warning${s.warnings !== 1 ? 's' : ''}`));
+    if (s.infos)
+        parts.push(chalk.dim(`${s.infos} info`));
+    if (!parts.length)
+        return chalk.green('All checks passed');
+    return parts.join(', ');
+}
+export function printFindings(source, findings, summary) {
+    console.log(`Validating: ${chalk.cyan(source)}\n`);
+    if (!findings.length) {
+        console.log(chalk.green('  ✓ No issues found'));
+    }
+    else {
+        for (const f of findings) {
+            console.log(formatFinding(f));
+        }
+    }
+    console.log(`\n${formatSummary(summary)}`);
+}
+export function printJson(source, findings, summary) {
+    const ok = summary.errors === 0;
+    console.log(JSON.stringify({ source, ok, summary, findings }, null, 2));
+}
+//# sourceMappingURL=format.js.map

package/dist/yaml/format.js.map

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

package/dist/yaml/load.d.ts

@@ -0,0 +1,28 @@
+export interface Finding {
+    severity: 'error' | 'warning' | 'info';
+    rule: string;
+    message: string;
+    path?: string;
+    line?: number;
+    column?: number;
+}
+export interface LoadResult {
+    ok: boolean;
+    value?: unknown;
+    source: string;
+    findings: Finding[];
+}
+/**
+ * Load and parse a YAML file. Returns a LoadResult; non-throwing.
+ *
+ * On parse failure, populates `findings` with a single error carrying the
+ * line/column from js-yaml's mark when available. On read failure (missing
+ * file, not a regular file), returns ok: false with a `read.*` rule.
+ */
+export declare function loadYaml(filePath: string): LoadResult;
+export interface FindingSummary {
+    errors: number;
+    warnings: number;
+    infos: number;
+}
+export declare function summarize(findings: Finding[]): FindingSummary;