specforge-mcp 0.1.0

package/dist/tools/design-schema-sql/tables.js

@@ -0,0 +1,215 @@
+// -- Table generation ---------------------------------------------------------
+export function generateTables(entities, engine) {
+    const tables = [];
+    for (const entity of entities) {
+        const columns = [
+            {
+                name: 'id',
+                type: engine === 'mongodb' ? 'ObjectId' : 'uuid',
+                nullable: false,
+                default: engine === 'postgresql' || engine === 'supabase' ? 'gen_random_uuid()' : null,
+                comment: 'Primary key',
+            },
+        ];
+        for (const field of entity.fields) {
+            columns.push({
+                name: field,
+                type: inferColumnType(field),
+                nullable: !isRequiredField(field),
+                default: null,
+                comment: '',
+            });
+        }
+        const foreignKeys = [];
+        for (const related of entity.relatesTo) {
+            const fkColumn = `${related}_id`;
+            columns.push({
+                name: fkColumn,
+                type: engine === 'mongodb' ? 'ObjectId' : 'uuid',
+                nullable: true,
+                default: null,
+                comment: `FK to ${related}`,
+            });
+            foreignKeys.push({
+                column: fkColumn,
+                references: `${related}(id)`,
+                onDelete: 'SET NULL',
+                onUpdate: 'CASCADE',
+            });
+        }
+        columns.push({
+            name: 'created_at',
+            type: 'timestamp',
+            nullable: false,
+            default: engine === 'mongodb' ? null : 'now()',
+            comment: 'Creation timestamp',
+        }, {
+            name: 'updated_at',
+            type: 'timestamp',
+            nullable: false,
+            default: engine === 'mongodb' ? null : 'now()',
+            comment: 'Last update timestamp',
+        });
+        tables.push({
+            name: entity.name,
+            columns,
+            primaryKey: 'id',
+            foreignKeys,
+            uniqueConstraints: detectUniqueConstraints(entity),
+            checkConstraints: detectCheckConstraints(entity),
+        });
+    }
+    return tables;
+}
+function inferColumnType(fieldName) {
+    const lower = fieldName.toLowerCase();
+    if (lower.includes('email') || lower.includes('url') || lower.includes('link')) {
+        return 'text';
+    }
+    if (lower.includes('price') || lower.includes('amount') || lower.includes('cost')) {
+        return 'decimal(10,2)';
+    }
+    if (lower.includes('count') || lower.includes('quantity') || lower.includes('order')) {
+        return 'integer';
+    }
+    if (lower.includes('is_') ||
+        lower.includes('has_') ||
+        lower.includes('active') ||
+        lower.includes('enabled')) {
+        return 'boolean';
+    }
+    if (lower.includes('date') || lower.includes('_at')) {
+        return 'timestamp';
+    }
+    if (lower.includes('description') || lower.includes('content') || lower.includes('body')) {
+        return 'text';
+    }
+    if (lower.includes('status')) {
+        return 'varchar(50)';
+    }
+    if (lower.includes('name') || lower.includes('title') || lower.includes('label')) {
+        return 'varchar(255)';
+    }
+    if (lower.includes('json') || lower.includes('metadata') || lower.includes('config')) {
+        return 'jsonb';
+    }
+    return 'varchar(255)';
+}
+function isRequiredField(fieldName) {
+    const required = ['name', 'title', 'status', 'email', 'type'];
+    return required.some((r) => fieldName.toLowerCase().includes(r));
+}
+function detectUniqueConstraints(entity) {
+    const uniques = [];
+    for (const field of entity.fields) {
+        if (field.toLowerCase().includes('email') || field.toLowerCase() === 'slug') {
+            uniques.push(field);
+        }
+    }
+    return uniques;
+}
+function detectCheckConstraints(entity) {
+    const checks = [];
+    for (const field of entity.fields) {
+        if (field.toLowerCase().includes('status')) {
+            checks.push(`${field} IN ('active', 'inactive', 'pending', 'archived')`);
+        }
+        if (field.toLowerCase().includes('price') || field.toLowerCase().includes('amount')) {
+            checks.push(`${field} >= 0`);
+        }
+    }
+    return checks;
+}
+// -- Index generation ---------------------------------------------------------
+export function generateIndexes(tables, _engine) {
+    const indexes = [];
+    for (const table of tables) {
+        for (const fk of table.foreignKeys) {
+            indexes.push({
+                name: `idx_${table.name}_${fk.column}`,
+                table: table.name,
+                columns: [fk.column],
+                type: 'btree',
+                unique: false,
+                justification: `Foreign key lookup optimization for ${fk.column}`,
+            });
+        }
+        const statusCol = table.columns.find((c) => c.name.includes('status'));
+        if (statusCol) {
+            indexes.push({
+                name: `idx_${table.name}_${statusCol.name}`,
+                table: table.name,
+                columns: [statusCol.name],
+                type: 'btree',
+                unique: false,
+                justification: 'Status-based filtering is a common query pattern',
+            });
+        }
+        indexes.push({
+            name: `idx_${table.name}_created_at`,
+            table: table.name,
+            columns: ['created_at'],
+            type: 'btree',
+            unique: false,
+            justification: 'Efficient ordering by creation date',
+        });
+        for (const unique of table.uniqueConstraints) {
+            indexes.push({
+                name: `idx_${table.name}_${unique}_unique`,
+                table: table.name,
+                columns: [unique],
+                type: 'btree',
+                unique: true,
+                justification: `Enforce uniqueness on ${unique}`,
+            });
+        }
+    }
+    return indexes;
+}
+// -- RLS policies -------------------------------------------------------------
+export function generateRLSPolicies(tables) {
+    const policies = [];
+    for (const table of tables) {
+        policies.push({
+            name: `${table.name}_select_authenticated`,
+            table: table.name,
+            operation: 'SELECT',
+            using: "auth.role() = 'authenticated'",
+            justification: 'Only authenticated users can read records',
+        });
+        const ownerCol = table.columns.find((c) => c.name === 'user_id' || c.name === 'owner_id' || c.name === 'created_by');
+        if (ownerCol) {
+            policies.push({
+                name: `${table.name}_insert_owner`,
+                table: table.name,
+                operation: 'INSERT',
+                using: 'true',
+                withCheck: `auth.uid() = ${ownerCol.name}`,
+                justification: 'Users can only insert records they own',
+            }, {
+                name: `${table.name}_update_owner`,
+                table: table.name,
+                operation: 'UPDATE',
+                using: `auth.uid() = ${ownerCol.name}`,
+                justification: 'Users can only update their own records',
+            }, {
+                name: `${table.name}_delete_owner`,
+                table: table.name,
+                operation: 'DELETE',
+                using: `auth.uid() = ${ownerCol.name}`,
+                justification: 'Users can only delete their own records',
+            });
+        }
+        else {
+            policies.push({
+                name: `${table.name}_all_authenticated`,
+                table: table.name,
+                operation: 'ALL',
+                using: "auth.role() = 'authenticated'",
+                justification: 'All CRUD operations require authentication',
+            });
+        }
+    }
+    return policies;
+}
+//# sourceMappingURL=tables.js.map

package/dist/tools/design-schema-sql/tables.js.map

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

package/dist/tools/design-schema-sql.d.ts

@@ -0,0 +1,3 @@
+export { generateTables, generateIndexes, generateRLSPolicies, } from './design-schema-sql/tables.js';
+export { generateMigrations, buildRelationships, buildDataIntegrityRules, } from './design-schema-sql/migrations.js';
+//# sourceMappingURL=design-schema-sql.d.ts.map

package/dist/tools/design-schema-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-schema-sql.d.ts","sourceRoot":"","sources":["../../src/tools/design-schema-sql.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC"}

package/dist/tools/design-schema-sql.js

@@ -0,0 +1,5 @@
+// tools/design-schema-sql.ts — Barrel: SQL schema generation (tables, indexes, RLS, migrations)
+// Split into subdirectory for SOLID compliance.
+export { generateTables, generateIndexes, generateRLSPolicies, } from './design-schema-sql/tables.js';
+export { generateMigrations, buildRelationships, buildDataIntegrityRules, } from './design-schema-sql/migrations.js';
+//# sourceMappingURL=design-schema-sql.js.map

package/dist/tools/design-schema-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-schema-sql.js","sourceRoot":"","sources":["../../src/tools/design-schema-sql.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,gDAAgD;AAEhD,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC"}

package/dist/tools/design-schema.d.ts

@@ -0,0 +1,4 @@
+import type { DesignSchemaInput, DatabaseEngine, ToolResult } from '../types/index.js';
+export declare function handleDesignSchema(args: DesignSchemaInput): Promise<ToolResult>;
+export type { DatabaseEngine };
+//# sourceMappingURL=design-schema.d.ts.map

package/dist/tools/design-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-schema.d.ts","sourceRoot":"","sources":["../../src/tools/design-schema.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,iBAAiB,EAGjB,cAAc,EACd,UAAU,EACX,MAAM,mBAAmB,CAAC;AAyB3B,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqNrF;AA2BD,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/design-schema.js

@@ -0,0 +1,219 @@
+// tools/design-schema.ts — Data-first schema design
+// Analyzes a spec to generate database schema recommendations including
+// tables, indexes, RLS policies, migrations, and relationships.
+import { readFile } from 'node:fs/promises';
+import { specStore, knowledgeStore } from '../storage/index.js';
+import { t, ti } from '../i18n/index.js';
+import { isMobileSchema, generateMobileSchema } from './design-schema-mobile.js';
+import { isGameSchema, generateGameSchema } from './design-schema-games.js';
+import { extractEntities, injectPrivacyAuditFields, isMcpSchema, generateMcpSchema, isSmartContractSchema, isMLSchema, isDbtSchema, generateSmartContractSchema, generateMLSchema, generateDbtSchema, } from './design-schema/index.js';
+import { generateTables, generateIndexes, generateRLSPolicies, generateMigrations, buildRelationships, buildDataIntegrityRules, } from './design-schema-sql.js';
+import { detectPIIInSpec } from '../engine/pii-detector.js';
+export async function handleDesignSchema(args) {
+    const { specId, projectId, description } = args;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+            isError: true,
+        };
+    }
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [{ type: 'text', text: t('project.notFound') }],
+            isError: true,
+        };
+    }
+    const specContent = await readSpecContent(spec, description);
+    const entities = extractEntities(specContent);
+    const dbEngine = knowledge.database;
+    // SPEC-043: Server-side rendering projects don't use SPA schema patterns
+    const rendering = knowledge.rendering;
+    if (rendering === 'server-side') {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        '## Schema Design \u2014 Backend-First Project',
+                        '',
+                        '**Rendering mode:** Server-Side \u2014 SPA schema patterns excluded.',
+                        '',
+                        'For hypermedia/backend-first projects, schema design follows server-side conventions:',
+                        '- No client-side state schemas (Redux/Zustand/Pinia stores)',
+                        '- No GraphQL client cache schemas',
+                        '- Data models are defined server-side (ORM models, database tables)',
+                        '',
+                        'Use `design_schema` for database table design if your project uses a relational DB.',
+                        'The following entities were detected from the spec:',
+                        ...entities.map((e) => `- **${e.name}** (fields: ${e.fields.join(', ')})`),
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    // SPEC-016b: MCP server schema (TypeScript interfaces per tool)
+    if (isMcpSchema(knowledge)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('tools.design_schema.success', {
+                        tableCount: String(entities.length),
+                        indexCount: '0',
+                    }),
+                },
+                {
+                    type: 'text',
+                    text: generateMcpSchema(entities.map((e) => e.name), knowledge),
+                },
+            ],
+        };
+    }
+    if (isMobileSchema(knowledge)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('tools.design_schema.success', {
+                        tableCount: String(entities.length),
+                        indexCount: '0',
+                    }),
+                },
+                { type: 'text', text: generateMobileSchema(entities, knowledge) },
+            ],
+        };
+    }
+    if (isGameSchema(knowledge)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('tools.design_schema.success', {
+                        tableCount: String(entities.length),
+                        indexCount: '0',
+                    }),
+                },
+                {
+                    type: 'text',
+                    text: generateGameSchema(entities.map((e) => e.name), knowledge),
+                },
+            ],
+        };
+    }
+    // SPEC-015a: Smart contract schema (criterion 7)
+    if (isSmartContractSchema(knowledge)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('tools.design_schema.success', {
+                        tableCount: String(entities.length),
+                        indexCount: '0',
+                    }),
+                },
+                {
+                    type: 'text',
+                    text: generateSmartContractSchema(entities.map((e) => e.name), knowledge),
+                },
+            ],
+        };
+    }
+    // SPEC-015b: dbt schema
+    if (isDbtSchema(knowledge)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('tools.design_schema.success', {
+                        tableCount: String(entities.length),
+                        indexCount: '0',
+                    }),
+                },
+                {
+                    type: 'text',
+                    text: generateDbtSchema(entities.map((e) => e.name), knowledge),
+                },
+            ],
+        };
+    }
+    // SPEC-015a: ML schema (criterion 8)
+    if (isMLSchema(knowledge)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('tools.design_schema.success', {
+                        tableCount: String(entities.length),
+                        indexCount: '0',
+                    }),
+                },
+                {
+                    type: 'text',
+                    text: generateMLSchema(entities.map((e) => e.name), knowledge),
+                },
+            ],
+        };
+    }
+    const tables = generateTables(entities, dbEngine);
+    // SPEC-030: Inject privacy audit fields for entities with PII context
+    const piiResult = detectPIIInSpec(spec.title, specContent, specContent);
+    if (piiResult.hasPII) {
+        injectPrivacyAuditFields(tables, dbEngine);
+    }
+    const indexes = generateIndexes(tables, dbEngine);
+    const rlsPolicies = dbEngine === 'supabase' || dbEngine === 'postgresql' ? generateRLSPolicies(tables) : [];
+    const migrations = generateMigrations(tables, indexes, rlsPolicies, dbEngine);
+    const relationships = buildRelationships(tables);
+    const dataIntegrity = buildDataIntegrityRules(tables, dbEngine);
+    const schema = {
+        engine: dbEngine,
+        tables,
+        indexes,
+        rlsPolicies,
+        migrations,
+        relationships,
+        dataIntegrity,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.design_schema.success', {
+                    tableCount: String(tables.length),
+                    indexCount: String(indexes.length),
+                }),
+            },
+            {
+                type: 'text',
+                text: JSON.stringify(schema, null, 2),
+            },
+        ],
+    };
+}
+// -- I/O helpers --------------------------------------------------------------
+async function readSpecContent(spec, additionalDescription) {
+    let content = `${spec.title} ${spec.type} ${spec.scope} ${spec.target}`;
+    if (additionalDescription) {
+        content += ' ' + additionalDescription;
+    }
+    try {
+        if (spec.huPath) {
+            content += ' ' + (await readFile(spec.huPath, 'utf-8'));
+        }
+    }
+    catch {
+        /* file not available */
+    }
+    try {
+        if (spec.fichaTecnicaPath) {
+            content += ' ' + (await readFile(spec.fichaTecnicaPath, 'utf-8'));
+        }
+    }
+    catch {
+        /* file not available */
+    }
+    return content;
+}
+//# sourceMappingURL=design-schema.js.map

package/dist/tools/design-schema.js.map

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

package/dist/tools/design-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=design-schema.test.d.ts.map

package/dist/tools/design-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-schema.test.d.ts","sourceRoot":"","sources":["../../src/tools/design-schema.test.ts"],"names":[],"mappings":""}