@devtrack-solution/codesdd 1.2.2

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@devtrack-solution/codesdd",
+  "version": "1.2.2",
+  "description": "AI-native system for spec-driven development",
+  "keywords": [
+    "codesdd",
+    "specs",
+    "cli",
+    "ai",
+    "development"
+  ],
+  "homepage": "https://github.com/devtrack-solution/opensdd-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devtrack-solution/opensdd-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/devtrack-solution/opensdd-cli/issues"
+  },
+  "license": "MIT",
+  "author": "CodeSDD Contributors",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "pnpm": {
+    "overrides": {
+      "basic-ftp": "5.3.1",
+      "ip-address": "10.1.1",
+      "mermaid": "11.15.0",
+      "uuid": "^14.0.0"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "codesdd": "bin/codesdd.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "schemas",
+    ".sdd/skills/curated/api-clean-flask-langgraph/SKILL.md",
+    ".sdd/skills/curated/devtrack-api/SKILL.md",
+    ".sdd/skills/curated/devtrack-api/agents/*.yaml",
+    ".sdd/skills/curated/devtrack-api/references/*.md",
+    "!dist/**/*.test.js",
+    "!dist/**/__tests__",
+    "!dist/**/*.map"
+  ],
+  "scripts": {
+    "cleanup": "node scripts/cleanup.mjs",
+    "cleanup:install": "node scripts/cleanup.mjs install && pnpm install",
+    "hooks:install": "node scripts/install-git-hooks.mjs",
+    "lint": "eslint src/",
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "dev:cli": "pnpm build && node bin/codesdd.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run test/e2e",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "coverage": "vitest run --coverage",
+    "quality": "pnpm run cleanup:install && pnpm run build && pnpm run lint && pnpm run test && pnpm run test:e2e && pnpm run coverage",
+    "prepublishOnly": "node build.js",
+    "prepare": "node scripts/install-git-hooks.mjs",
+    "check:pack-version": "node scripts/pack-version-check.mjs",
+    "sdd:schema:export": "node scripts/export-sdd-schemas.mjs",
+    "sdd:schema:check": "node scripts/export-sdd-schemas.mjs --check",
+    "sdd:scan-naming": "node bin/codesdd.js sdd scan-naming",
+    "sdd:scan-naming:strict": "node bin/codesdd.js sdd scan-naming --strict",
+    "sdd:precommit:fast": "node scripts/pre-commit-sdd-fast.mjs",
+    "sdd:validate:no-build": "node bin/codesdd.js sdd check --render --strict && node bin/codesdd.js sdd diagnose --strict && node bin/codesdd.js sdd scan-naming",
+    "sdd:validate": "pnpm run build && pnpm run sdd:schema:check && pnpm run sdd:validate:no-build",
+    "release": "pnpm run release:ci",
+    "release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
+    "changeset": "changeset"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
+    "@mermaid-js/mermaid-cli": "^11.15.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.39.2",
+    "ts-morph": "^28.0.0",
+    "typescript-eslint": "^8.58.2",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@inquirer/core": "^11.1.8",
+    "@inquirer/prompts": "^8.4.1",
+    "@types/node": "^25.6.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fast-glob": "^3.3.3",
+    "ora": "^9.3.0",
+    "posthog-node": "^5.29.2",
+    "typescript": "^6.0.2",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  }
+}

package/schemas/sdd/1-spec.schema.json

@@ -0,0 +1,221 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 10
+    },
+    "origin": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "epic",
+            "radar",
+            "direct",
+            "fgap",
+            "td"
+          ]
+        },
+        "ref": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "ref"
+      ],
+      "additionalProperties": false
+    },
+    "objective": {
+      "type": "string",
+      "minLength": 100
+    },
+    "expected_outcome": {
+      "type": "string",
+      "minLength": 50
+    },
+    "system_impact": {
+      "type": "string",
+      "minLength": 30
+    },
+    "acceptance_refs": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "gates": {
+      "type": "object",
+      "properties": {
+        "proposta": {
+          "type": "object",
+          "properties": {
+            "status": {
+              "default": "rascunho",
+              "type": "string",
+              "enum": [
+                "nao_exigida",
+                "rascunho",
+                "pronta",
+                "aprovada"
+              ]
+            },
+            "approved_at": {
+              "type": "string"
+            },
+            "approved_by": {
+              "type": "string"
+            },
+            "note": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "status"
+          ],
+          "additionalProperties": false
+        },
+        "planejamento": {
+          "type": "object",
+          "properties": {
+            "status": {
+              "default": "rascunho",
+              "type": "string",
+              "enum": [
+                "nao_exigida",
+                "rascunho",
+                "pronta",
+                "aprovada"
+              ]
+            },
+            "approved_at": {
+              "type": "string"
+            },
+            "approved_by": {
+              "type": "string"
+            },
+            "note": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "status"
+          ],
+          "additionalProperties": false
+        },
+        "tarefas": {
+          "type": "object",
+          "properties": {
+            "status": {
+              "default": "rascunho",
+              "type": "string",
+              "enum": [
+                "nao_exigida",
+                "rascunho",
+                "pronta",
+                "aprovada"
+              ]
+            },
+            "approved_at": {
+              "type": "string"
+            },
+            "approved_by": {
+              "type": "string"
+            },
+            "note": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "status"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "proposta",
+        "planejamento",
+        "tarefas"
+      ],
+      "additionalProperties": false
+    },
+    "compliance_context": {
+      "type": "object",
+      "properties": {
+        "jurisdictions": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "data_classes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "source_refs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "legal_review_required": {
+          "default": false,
+          "type": "boolean"
+        },
+        "legal_review_notes": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "jurisdictions",
+        "data_classes",
+        "source_refs",
+        "legal_review_required"
+      ],
+      "additionalProperties": false
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    }
+  },
+  "required": [
+    "schema_version",
+    "feature_id",
+    "title",
+    "origin",
+    "objective",
+    "expected_outcome",
+    "system_impact",
+    "acceptance_refs",
+    "gates",
+    "created_at",
+    "updated_at"
+  ],
+  "additionalProperties": false,
+  "title": "OpenSDD Workspace Spec",
+  "description": "Machine-readable contract for the active/planned/archived FEAT spec workspace document."
+}

package/schemas/sdd/2-plan.schema.json

@@ -0,0 +1,199 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "architectural_impact": {
+      "type": "object",
+      "properties": {
+        "description": {
+          "type": "string"
+        },
+        "affected_modules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "description",
+        "affected_modules"
+      ],
+      "additionalProperties": false
+    },
+    "frontend_impact": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "unknown",
+            "none",
+            "required"
+          ]
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "status",
+        "description"
+      ],
+      "additionalProperties": false
+    },
+    "affected_contracts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "change_type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "change_type"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "quality_strategy": {
+      "type": "object",
+      "properties": {
+        "unit_target": {
+          "type": "number"
+        },
+        "integration_target": {
+          "type": "number"
+        },
+        "approach": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "unit_target",
+        "integration_target",
+        "approach"
+      ],
+      "additionalProperties": false
+    },
+    "suggested_skills": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "privacy_controls": {
+      "type": "object",
+      "properties": {
+        "source_registry_refs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "jurisdiction_profiles": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "control_ids": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "legal_review_gate": {
+          "default": "conditional",
+          "type": "string",
+          "enum": [
+            "required",
+            "conditional",
+            "not_required"
+          ]
+        },
+        "unresolved_legal_questions": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "source_registry_refs",
+        "jurisdiction_profiles",
+        "control_ids",
+        "legal_review_gate",
+        "unresolved_legal_questions"
+      ],
+      "additionalProperties": false
+    },
+    "skill_conformance": {
+      "type": "object",
+      "properties": {
+        "selected_skills": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "required_skills": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "detected_conflicts": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "resolution_adr_ref": {
+          "type": "string"
+        },
+        "architecture_tree_ascii": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "selected_skills",
+        "required_skills",
+        "detected_conflicts"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "feature_id",
+    "architectural_impact",
+    "frontend_impact",
+    "affected_contracts",
+    "quality_strategy",
+    "suggested_skills"
+  ],
+  "additionalProperties": false,
+  "title": "OpenSDD Workspace Plan",
+  "description": "Machine-readable contract for the FEAT execution plan workspace document."
+}

package/schemas/sdd/3-tasks.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "tasks": {
+      "minItems": 5,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "phase": {
+            "type": "string",
+            "enum": [
+              "preparation",
+              "implementation",
+              "testing",
+              "documentation",
+              "finalization"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "files_touched": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "test_scripts": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "command": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string"
+                },
+                "expected": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "command",
+                "type",
+                "expected"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "acceptance": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "in_progress",
+              "done",
+              "skipped"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "phase",
+          "title",
+          "description",
+          "files_touched",
+          "test_scripts",
+          "acceptance",
+          "status"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "feature_id",
+    "tasks"
+  ],
+  "additionalProperties": false,
+  "title": "OpenSDD Workspace Tasks",
+  "description": "Machine-readable contract for the phased FEAT task roadmap workspace document."
+}

package/schemas/sdd/4-changelog.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "feature_id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "action": {
+            "type": "string"
+          },
+          "details": {
+            "type": "string"
+          },
+          "refs": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "timestamp",
+          "action",
+          "details",
+          "refs"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "feature_id",
+    "entries"
+  ],
+  "additionalProperties": false,
+  "title": "OpenSDD Workspace Changelog",
+  "description": "Machine-readable contract for the FEAT execution changelog workspace document."
+}