dixi-spec-kit 1.5.0__tar.gz

dixi_spec_kit-1.5.0/MANIFEST.in

@@ -0,0 +1,15 @@
+global-exclude *
+include pyproject.toml MANIFEST.in packaging/README.md
+include src/dixi_spec_kit/__init__.py src/dixi_spec_kit/__main__.py
+include src/dixi_spec_kit/cli.py src/dixi_spec_kit/core.py src/dixi_spec_kit/filesystem.py
+include src/dixi_spec_kit/locales/es.json src/dixi_spec_kit/locales/en.json
+include src/dixi_spec_kit/resources/project.es.json src/dixi_spec_kit/resources/project.en.json
+include src/dixi_spec_kit/workflows.py src/dixi_spec_kit/upgrade.py
+include src/dixi_spec_kit/LICENSE
+include src/dixi_spec_kit/resources/claude/es/*.md src/dixi_spec_kit/resources/claude/en/*.md
+include src/dixi_spec_kit/resources/codex/es/*.md src/dixi_spec_kit/resources/codex/en/*.md
+include src/dixi_spec_kit/resources/profiles.json
+include src/dixi_spec_kit/resources/hooks/*.py
+include src/dixi_spec_kit/resources/claude/es/agents/*.md src/dixi_spec_kit/resources/claude/en/agents/*.md
+recursive-include src/dixi_spec_kit/resources/templates *.md *.yaml *.json
+include src/dixi_spec_kit/resources/workflows.json src/dixi_spec_kit/resources/workflows.es.json src/dixi_spec_kit/resources/workflows.en.json

dixi_spec_kit-1.5.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: dixi-spec-kit
+Version: 1.5.0
+Summary: Specification-driven development kit with traceability, verification and Claude Code commands
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dixi-project/dixi-spec-kit
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: src/dixi_spec_kit/LICENSE
+Dynamic: license-file
+
+# DIXI Spec Kit
+
+## Purpose / Propósito
+
+Specification-driven development (SDD) kit by Dixi Project: traceable specs, tests first, verified code and human review. Ships the `dixi` CLI (standard library only, no network, no AI calls) and optional Claude Code commands.
+
+Kit de desarrollo guiado por especificaciones de Dixi Project: specs trazables, pruebas primero, código verificado y revisión humana.
+
+## Quickstart
+
+```text
+dixi init my-project --agent claude   # or --agent none
+cd my-project
+dixi doctor
+dixi check
+make verify
+```
+
+In Claude Code: `/dixi.discover`, `/dixi.specify`, `/dixi.clarify`, `/dixi.plan`, `/dixi.tasks`, `/dixi.build`, `/dixi.verify`, `/dixi.review`, `/dixi.analyze`, `/dixi.status`, `/dixi.domain`, `/dixi.architecture`, `/dixi.contract`, `/dixi.threat-model`, `/dixi.handoff`, `/dixi.change`.
+
+Codex (preview): `dixi init my-project --agent codex` installs the same operations as skills, invoked as `$dixi-specify`, `$dixi-plan`, etc.
+
+Preview what a newer kit version would change, without writing: `dixi upgrade --dry-run`.
+
+Terminal: `dixi init`, `dixi doctor`, `dixi check`, `dixi workflow list|show|prepare`. Global options `--lang es|en` and `--json` go before the command. Exit codes: 0 success, 1 invalid content, 2 usage, 3 occupied or unsafe destination, 4 unsupported version or platform, 5 I/O.
+
+`dixi check` and the generated `make verify` check documentary structure and traceability; connect your application's real tests to `make verify`. The Claude Code adapter installs commands and instructions, not hooks or permissions.
+
+Requirements: Python 3.11+, macOS or Linux. Windows is not supported.
+
+## Related / Relacionados
+
+Source, documentation, support matrix and contribution guide: https://github.com/dixi-project/dixi-spec-kit. License: MIT.

dixi_spec_kit-1.5.0/packaging/README.md

@@ -0,0 +1,33 @@
+# DIXI Spec Kit
+
+## Purpose / Propósito
+
+Specification-driven development (SDD) kit by Dixi Project: traceable specs, tests first, verified code and human review. Ships the `dixi` CLI (standard library only, no network, no AI calls) and optional Claude Code commands.
+
+Kit de desarrollo guiado por especificaciones de Dixi Project: specs trazables, pruebas primero, código verificado y revisión humana.
+
+## Quickstart
+
+```text
+dixi init my-project --agent claude   # or --agent none
+cd my-project
+dixi doctor
+dixi check
+make verify
+```
+
+In Claude Code: `/dixi.discover`, `/dixi.specify`, `/dixi.clarify`, `/dixi.plan`, `/dixi.tasks`, `/dixi.build`, `/dixi.verify`, `/dixi.review`, `/dixi.analyze`, `/dixi.status`, `/dixi.domain`, `/dixi.architecture`, `/dixi.contract`, `/dixi.threat-model`, `/dixi.handoff`, `/dixi.change`.
+
+Codex (preview): `dixi init my-project --agent codex` installs the same operations as skills, invoked as `$dixi-specify`, `$dixi-plan`, etc.
+
+Preview what a newer kit version would change, without writing: `dixi upgrade --dry-run`.
+
+Terminal: `dixi init`, `dixi doctor`, `dixi check`, `dixi workflow list|show|prepare`. Global options `--lang es|en` and `--json` go before the command. Exit codes: 0 success, 1 invalid content, 2 usage, 3 occupied or unsafe destination, 4 unsupported version or platform, 5 I/O.
+
+`dixi check` and the generated `make verify` check documentary structure and traceability; connect your application's real tests to `make verify`. The Claude Code adapter installs commands and instructions, not hooks or permissions.
+
+Requirements: Python 3.11+, macOS or Linux. Windows is not supported.
+
+## Related / Relacionados
+
+Source, documentation, support matrix and contribution guide: https://github.com/dixi-project/dixi-spec-kit. License: MIT.

dixi_spec_kit-1.5.0/pyproject.toml

@@ -0,0 +1,129 @@
+[build-system]
+requires = ["setuptools==84.2.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dixi-spec-kit"
+version = "1.5.0"
+description = "Specification-driven development kit with traceability, verification and Claude Code commands"
+readme = "packaging/README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["src/dixi_spec_kit/LICENSE"]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/dixi-project/dixi-spec-kit"
+
+[project.scripts]
+dixi = "dixi_spec_kit.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["dixi_spec_kit"]
+include-package-data = false
+
+[tool.setuptools.package-data]
+dixi_spec_kit = ["locales/es.json", "locales/en.json", "resources/project.es.json", "resources/project.en.json", "resources/workflows.json", "resources/profiles.json", "resources/templates/**/*", "resources/hooks/*.py", "resources/claude/*/agents/*.md", "resources/claude/*/dixi.interview.md", "resources/claude/*/dixi.risk-review.md", "resources/codex/*/dixi-interview.md", "resources/codex/*/dixi-risk-review.md", "resources/workflows.es.json", "resources/workflows.en.json",
+    "resources/claude/es/CLAUDE.md",
+    "resources/claude/es/dixi.discover.md",
+    "resources/claude/es/dixi.specify.md",
+    "resources/claude/es/dixi.clarify.md",
+    "resources/claude/es/dixi.plan.md",
+    "resources/claude/es/dixi.tasks.md",
+    "resources/claude/es/dixi.build.md",
+    "resources/claude/es/dixi.verify.md",
+    "resources/claude/es/dixi.review.md",
+    "resources/claude/es/dixi.analyze.md",
+    "resources/claude/es/dixi.status.md",
+    "resources/claude/en/CLAUDE.md",
+    "resources/claude/en/dixi.discover.md",
+    "resources/claude/en/dixi.specify.md",
+    "resources/claude/en/dixi.clarify.md",
+    "resources/claude/en/dixi.plan.md",
+    "resources/claude/en/dixi.tasks.md",
+    "resources/claude/en/dixi.build.md",
+    "resources/claude/en/dixi.verify.md",
+    "resources/claude/en/dixi.review.md",
+    "resources/claude/en/dixi.analyze.md",
+    "resources/claude/en/dixi.status.md",
+    "resources/claude/es/dixi.domain.md",
+    "resources/claude/es/dixi.architecture.md",
+    "resources/claude/es/dixi.contract.md",
+    "resources/claude/es/dixi.threat-model.md",
+    "resources/claude/es/dixi.handoff.md",
+    "resources/claude/es/dixi.change.md",
+    "resources/claude/en/dixi.domain.md",
+    "resources/claude/en/dixi.architecture.md",
+    "resources/claude/en/dixi.contract.md",
+    "resources/claude/en/dixi.threat-model.md",
+    "resources/claude/en/dixi.handoff.md",
+    "resources/claude/en/dixi.change.md",
+    "resources/codex/es/dixi-discover.md",
+    "resources/codex/es/dixi-specify.md",
+    "resources/codex/es/dixi-clarify.md",
+    "resources/codex/es/dixi-plan.md",
+    "resources/codex/es/dixi-tasks.md",
+    "resources/codex/es/dixi-build.md",
+    "resources/codex/es/dixi-verify.md",
+    "resources/codex/es/dixi-review.md",
+    "resources/codex/es/dixi-analyze.md",
+    "resources/codex/es/dixi-status.md",
+    "resources/codex/es/dixi-domain.md",
+    "resources/codex/es/dixi-architecture.md",
+    "resources/codex/es/dixi-contract.md",
+    "resources/codex/es/dixi-threat-model.md",
+    "resources/codex/es/dixi-handoff.md",
+    "resources/codex/es/dixi-change.md",
+    "resources/codex/en/dixi-discover.md",
+    "resources/codex/en/dixi-specify.md",
+    "resources/codex/en/dixi-clarify.md",
+    "resources/codex/en/dixi-plan.md",
+    "resources/codex/en/dixi-tasks.md",
+    "resources/codex/en/dixi-build.md",
+    "resources/codex/en/dixi-verify.md",
+    "resources/codex/en/dixi-review.md",
+    "resources/codex/en/dixi-analyze.md",
+    "resources/codex/en/dixi-status.md",
+    "resources/codex/en/dixi-domain.md",
+    "resources/codex/en/dixi-architecture.md",
+    "resources/codex/en/dixi-contract.md",
+    "resources/codex/en/dixi-threat-model.md",
+    "resources/codex/en/dixi-handoff.md",
+    "resources/codex/en/dixi-change.md",
+    "resources/claude/es/dixi.data.md",
+    "resources/claude/es/dixi.quality.md",
+    "resources/claude/es/dixi.ai.md",
+    "resources/claude/es/dixi.release.md",
+    "resources/claude/es/dixi.promote.md",
+    "resources/claude/es/dixi.operate.md",
+    "resources/claude/es/dixi.finops.md",
+    "resources/claude/es/dixi.compliance.md",
+    "resources/claude/es/dixi.duediligence.md",
+    "resources/claude/en/dixi.data.md",
+    "resources/claude/en/dixi.quality.md",
+    "resources/claude/en/dixi.ai.md",
+    "resources/claude/en/dixi.release.md",
+    "resources/claude/en/dixi.promote.md",
+    "resources/claude/en/dixi.operate.md",
+    "resources/claude/en/dixi.finops.md",
+    "resources/claude/en/dixi.compliance.md",
+    "resources/claude/en/dixi.duediligence.md",
+    "resources/codex/es/dixi-data.md",
+    "resources/codex/es/dixi-quality.md",
+    "resources/codex/es/dixi-ai.md",
+    "resources/codex/es/dixi-release.md",
+    "resources/codex/es/dixi-promote.md",
+    "resources/codex/es/dixi-operate.md",
+    "resources/codex/es/dixi-finops.md",
+    "resources/codex/es/dixi-compliance.md",
+    "resources/codex/es/dixi-duediligence.md",
+    "resources/codex/en/dixi-data.md",
+    "resources/codex/en/dixi-quality.md",
+    "resources/codex/en/dixi-ai.md",
+    "resources/codex/en/dixi-release.md",
+    "resources/codex/en/dixi-promote.md",
+    "resources/codex/en/dixi-operate.md",
+    "resources/codex/en/dixi-finops.md",
+    "resources/codex/en/dixi-compliance.md",
+    "resources/codex/en/dixi-duediligence.md"]

dixi_spec_kit-1.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dixi_spec_kit-1.5.0/src/dixi_spec_kit/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dixi Project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dixi_spec_kit-1.5.0/src/dixi_spec_kit/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.5.0"

dixi_spec_kit-1.5.0/src/dixi_spec_kit/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

dixi_spec_kit-1.5.0/src/dixi_spec_kit/cli.py

@@ -0,0 +1,190 @@
+import argparse
+from importlib.resources import files
+import json
+from pathlib import Path
+import sys
+
+from . import __version__
+from .core import METADATA, PROFILES, check_project, doctor, initialize, message, placeholders, pr_size
+from .filesystem import Issue, read_json, root_directory
+from .upgrade import STATUSES, plan as upgrade_plan
+from .workflows import OPERATIONS, workflow_result
+
+
+class Parser(argparse.ArgumentParser):
+    def error(self, message):
+        raise Issue("invalid_arguments", 2)
+
+
+def parser_for(catalog):
+    class Formatter(argparse.HelpFormatter):
+        def _format_usage(self, usage, actions, groups, prefix):
+            return super()._format_usage(usage, actions, groups, prefix or catalog["usage"])
+
+    parser = Parser(prog="dixi", description=catalog["description"], add_help=False, formatter_class=Formatter)
+    parser._positionals.title = catalog["arguments"]
+    parser._optionals.title = catalog["options"]
+    parser.add_argument("--help", "-h", action="help", help=catalog["help"])
+    parser.add_argument("--version", action="version", version=f"dixi {__version__}", help=catalog["version"])
+    parser.add_argument("--lang", choices=("es", "en"), default=None, help=catalog["lang"])
+    parser.add_argument("--json", action="store_true", help=catalog["json"])
+    commands = parser.add_subparsers(dest="command", required=True, title=catalog["commands"])
+    for command in ("init", "doctor", "check", "workflow", "upgrade", "placeholders", "pr-size"):
+        child = commands.add_parser(command, help=catalog[command], description=catalog[command],
+                                    add_help=False, formatter_class=Formatter)
+        child._positionals.title = catalog["arguments"]
+        child._optionals.title = catalog["options"]
+        child.add_argument("--help", "-h", action="help", help=catalog["help"])
+        if command == "init":
+            child.add_argument("directory", help=catalog["directory"])
+            child.add_argument("--agent", choices=("none", "claude", "codex"), default="none", help=catalog["agent"])
+            child.add_argument("--profile", choices=PROFILES, default="minimal", help=catalog["profile_option"])
+            child.add_argument("--regulated", action="store_true", help=catalog["regulated_option"])
+            child.add_argument("--controls", action="store_true", help=catalog["controls_option"])
+        elif command == "placeholders":
+            child.add_argument("--strict", action="store_true", help=catalog["placeholders_strict"])
+        elif command == "pr-size":
+            child.add_argument("--base", default="main", help=catalog["pr_size_base"])
+            child.add_argument("--max", type=int, default=1500, dest="limit", help=catalog["pr_size_max"])
+        elif command == "upgrade":
+            child.add_argument("--dry-run", action="store_true", help=catalog["upgrade_dry_run"])
+            child.add_argument("--profile", choices=PROFILES, default=None, help=catalog["profile_option"])
+            child.add_argument("--regulated", action="store_true", default=None, help=catalog["regulated_option"])
+            child.add_argument("--controls", action="store_true", default=None, help=catalog["controls_option"])
+        elif command == "workflow":
+            actions = child.add_subparsers(dest="workflow_action", required=True, title=catalog["commands"])
+            for action in ("list", "show", "prepare"):
+                operation = actions.add_parser(action, help=catalog[f"workflow_{action}"], add_help=False,
+                                               description=catalog[f"workflow_{action}"], formatter_class=Formatter)
+                operation._positionals.title = catalog["arguments"]
+                operation._optionals.title = catalog["options"]
+                operation.add_argument("--help", "-h", action="help", help=catalog["help"])
+                if action != "list":
+                    operation.add_argument("operation", choices=OPERATIONS, help=catalog["workflow_operation"])
+                if action == "prepare":
+                    operation.add_argument("--target", required=True, help=catalog["workflow_target"])
+                    operation.add_argument("--request", required=True, help=catalog["workflow_request"])
+    return parser
+
+
+def project_language():
+    try:
+        with root_directory(Path.cwd()) as root:
+            language = read_json(root, METADATA).get("language")
+    except (Issue, OSError, AttributeError):
+        return None
+    return language if language in ("es", "en") else None
+
+
+def subcommand(argv):
+    skip = False
+    for arg in argv:
+        if skip:
+            skip = False
+        elif arg == "--lang":
+            skip = True
+        elif not arg.startswith("-"):
+            return arg
+    return None
+
+
+def main(argv=None):
+    argv = list(sys.argv[1:] if argv is None else argv)
+    language = None
+    for index, arg in enumerate(argv):
+        if arg == "--lang" and index + 1 < len(argv) and argv[index + 1] in ("es", "en"):
+            language = argv[index + 1]
+        elif arg in ("--lang=es", "--lang=en"):
+            language = arg.split("=", 1)[1]
+    if language is None and subcommand(argv) != "init":
+        language = project_language()
+    language = language or "en"
+    catalog = json.loads(files("dixi_spec_kit").joinpath("locales", f"{language}.json").read_text(encoding="utf-8"))
+    code = 0
+    workflow = None
+    upgrade = None
+    extra = {}
+    try:
+        args = parser_for(catalog).parse_args(argv)
+        args.lang = args.lang or language
+        if args.command == "init":
+            messages = initialize(args.directory, args.lang, args.agent, args.profile, args.regulated, args.controls)
+        elif args.command == "doctor":
+            messages = doctor(Path.cwd(), args.lang)
+        elif args.command == "workflow":
+            workflow = workflow_result(args, Path.cwd())
+            messages = [message("workflow_scope")]
+        elif args.command == "upgrade":
+            if not args.dry_run:
+                raise Issue("upgrade_requires_dry_run", 2)
+            upgrade = upgrade_plan(Path.cwd(), args.profile, args.regulated, args.controls)
+            messages = [message("upgrade_planned", source=upgrade["from"], target=upgrade["to"]),
+                        message("upgrade_no_changes")]
+        elif args.command == "placeholders":
+            counts = placeholders(Path.cwd())
+            total = sum(counts.values())
+            extra = {"placeholders": counts, "total": total}
+            messages = [message("placeholders_found", total=total, files=len(counts))]
+            code = 1 if args.strict and total else 0
+        elif args.command == "pr-size":
+            size = pr_size(Path.cwd(), args.base, args.limit)
+            extra = {"pr_size": size}
+            messages = [message("pr_size_result", **size)]
+            if size["counted"] > size["max"]:
+                code = 1
+                messages.append(message("pr_size_exceeded", counted=size["counted"], max=size["max"]))
+        else:
+            code, messages = check_project(Path.cwd())
+    except Issue as error:
+        code, messages = error.code, [message(error.key, **error.params)]
+    except OSError:
+        code, messages = 5, [message("io_error")]
+    for entry in messages:
+        entry["message"] = catalog[entry["key"]].format(**entry["params"])
+    result = {"status": "completed" if code == 0 else "failed", "code": code, "messages": messages}
+    if workflow is not None:
+        result["workflow"] = workflow
+    if upgrade is not None:
+        result["upgrade"] = upgrade
+    result.update(extra)
+    if "--json" in argv:
+        print(json.dumps(result, ensure_ascii=False))
+    else:
+        for entry in messages:
+            print(entry["message"], file=sys.stderr if code else sys.stdout)
+        if workflow is not None:
+            print(format_workflow(workflow, catalog))
+        if upgrade is not None:
+            print(format_upgrade(upgrade, catalog))
+        for name, count in extra.get("placeholders", {}).items():
+            print(f"  {count:4d}  {name}")
+    return code
+
+
+def format_upgrade(upgrade, catalog):
+    lines = []
+    for status in STATUSES:
+        names = upgrade["files"][status]
+        lines.append(f"\n{catalog['upgrade_heading_' + status]} ({len(names)}):")
+        if status != "unchanged":
+            lines += [f"- {name}" for name in names]
+    return "\n".join(lines)
+
+
+def format_workflow(workflow, catalog):
+    if "operations" in workflow:
+        return "\n".join(f"{op['id']} — {op['title']}\n  {op['purpose']}" for op in workflow["operations"])
+    packet = workflow.get("packet")
+    recipe = packet["recipe"] if packet else workflow["recipe"]
+    lines = [f"\n{recipe['id']} — {recipe['title']}", recipe["purpose"]]
+    if packet:
+        lines += [catalog["workflow_prepared"].format(target=packet["target"]["id"], mode=packet["mode"],
+                                                      language=packet["project_language"]),
+                  catalog["workflow_request"] + ": " + json.dumps(packet["request"], ensure_ascii=False)]
+    for key in ("target_kinds", "inputs", "steps", "outputs", "gates", "checks", "guards", "next_operations"):
+        lines += ["\n" + catalog[f"workflow_heading_{key}"] + ":"]
+        lines += [f"- {item}" for item in recipe[key]] or [catalog["workflow_no_next"]]
+    if packet:
+        lines += ["\n" + catalog["workflow_heading_sources"] + ":"]
+        lines += [f"- {s['path']} · SHA-256 {s['sha256']} · {s['bytes']} B" for s in packet["sources"]]
+    return "\n".join(lines)