@codewizard-dt/bootstrap 2.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/build.yml +88 -0
- package/.github/workflows/security.yml +24 -0
- package/.gitleaks.toml +15 -0
- package/README.md +472 -0
- package/bin/cli.js +47 -0
- package/lib/README.md +27 -0
- package/lib/hooks/README.md +316 -0
- package/lib/hooks/env-file-guard.js +45 -0
- package/lib/hooks/git-protected-ops-block.js +77 -0
- package/lib/hooks/lib/serena-languages.js +158 -0
- package/lib/hooks/lib/serena.js +787 -0
- package/lib/hooks/mv-absolute-path-block.js +53 -0
- package/lib/hooks/serena-bash-grep-block.js +501 -0
- package/lib/hooks/serena-edit-guard.js +74 -0
- package/lib/hooks/serena-first-glob-guard.js +94 -0
- package/lib/hooks/serena-first-guard.js +74 -0
- package/lib/hooks/serena-first-read-guard.js +167 -0
- package/lib/hooks/serena-pre-delegation.js +117 -0
- package/lib/hooks/serena-session-reset.js +45 -0
- package/lib/hooks/serena-usage-tracker.js +186 -0
- package/lib/hooks/serena-write-guard.js +58 -0
- package/lib/prompts/README.md +16 -0
- package/lib/prompts/migrate-wiki.md +111 -0
- package/lib/prompts/setup-deployment.md +322 -0
- package/lib/prompts/setup-design-system.md +162 -0
- package/lib/prompts/setup-strict-typechecks.md +139 -0
- package/lib/scripts/README.md +49 -0
- package/lib/scripts/bootstrap-serena.sh +145 -0
- package/lib/scripts/build-mcp-guide.sh +108 -0
- package/lib/scripts/install-global.sh +78 -0
- package/lib/scripts/install-mcps.sh +131 -0
- package/lib/scripts/lib.sh +154 -0
- package/lib/scripts/merge-gitignore.sh +65 -0
- package/lib/scripts/migrate-project.sh +273 -0
- package/lib/scripts/setup-deployment.sh +104 -0
- package/lib/scripts/setup-project.sh +55 -0
- package/lib/scripts/setup-runner.sh +99 -0
- package/lib/scripts/setup-strict-typechecks.sh +29 -0
- package/lib/scripts/startup.sh +42 -0
- package/lib/scripts/sync-wiki-scaffold.sh +104 -0
- package/lib/scripts/templates/CLAUDE-env-safety.md +3 -0
- package/lib/scripts/templates/CLAUDE-wiki.md +60 -0
- package/lib/scripts/templates/gitignore +136 -0
- package/lib/scripts/templates/guides/stubs/00-header.md +15 -0
- package/lib/scripts/templates/guides/stubs/brave-search.md +20 -0
- package/lib/scripts/templates/guides/stubs/context7.md +26 -0
- package/lib/scripts/templates/guides/stubs/playwright.md +26 -0
- package/lib/scripts/templates/guides/stubs/serena.md +219 -0
- package/lib/scripts/templates/wiki/conventions.md +100 -0
- package/lib/scripts/templates/wiki/dashboard.html +1733 -0
- package/lib/scripts/templates/wiki/hot.md +21 -0
- package/lib/scripts/templates/wiki/index.md +46 -0
- package/lib/scripts/templates/wiki/knowledge/concepts/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/components/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/organisations/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/people/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/entities/tools/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/knowledge/sources/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/log.md +14 -0
- package/lib/scripts/templates/wiki/work/bugs/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/bugs/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/bugs/index.md +12 -0
- package/lib/scripts/templates/wiki/work/bugs/lifecycle.md +39 -0
- package/lib/scripts/templates/wiki/work/decisions/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/decisions/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/decisions/index.md +12 -0
- package/lib/scripts/templates/wiki/work/decisions/lifecycle.md +42 -0
- package/lib/scripts/templates/wiki/work/requirements/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/requirements/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/requirements/index.md +12 -0
- package/lib/scripts/templates/wiki/work/requirements/lifecycle.md +34 -0
- package/lib/scripts/templates/wiki/work/roadmaps/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/roadmaps/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/roadmaps/index.md +12 -0
- package/lib/scripts/templates/wiki/work/roadmaps/lifecycle.md +32 -0
- package/lib/scripts/templates/wiki/work/tasks/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/tasks/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/tasks/index.md +12 -0
- package/lib/scripts/templates/wiki/work/tasks/lifecycle.md +39 -0
- package/lib/scripts/templates/wiki/work/uat/.gitkeep +0 -0
- package/lib/scripts/templates/wiki/work/uat/archive/index.md +6 -0
- package/lib/scripts/templates/wiki/work/uat/index.md +12 -0
- package/lib/scripts/templates/wiki/work/uat/lifecycle.md +48 -0
- package/lib/scripts/templates/wiki/work/uat/screenshots/.gitkeep +0 -0
- package/lib/scripts/update-project.sh +75 -0
- package/lib/scripts/wiki-dashboard-server.js +146 -0
- package/lib/skills/README.md +146 -0
- package/lib/skills/anti-slop/SKILL.md +183 -0
- package/lib/skills/bug-close/SKILL.md +136 -0
- package/lib/skills/bug-file/SKILL.md +114 -0
- package/lib/skills/bug-triage/SKILL.md +140 -0
- package/lib/skills/company-align/SKILL.md +203 -0
- package/lib/skills/debug-logs/SKILL.md +129 -0
- package/lib/skills/decision-create/SKILL.md +220 -0
- package/lib/skills/decision-finalize/SKILL.md +181 -0
- package/lib/skills/decision-next/SKILL.md +129 -0
- package/lib/skills/decision-walkthrough/SKILL.md +169 -0
- package/lib/skills/demo/SKILL.md +183 -0
- package/lib/skills/elevator-pitch/SKILL.md +125 -0
- package/lib/skills/eval-create/SKILL.md +344 -0
- package/lib/skills/eval-gap/SKILL.md +150 -0
- package/lib/skills/eval-run/SKILL.md +214 -0
- package/lib/skills/extract-feature/SKILL.md +344 -0
- package/lib/skills/flashcard/SKILL.md +513 -0
- package/lib/skills/frontend-taste/SKILL.md +184 -0
- package/lib/skills/gap-assess/SKILL.md +97 -0
- package/lib/skills/git-commit/SKILL.md +164 -0
- package/lib/skills/lint/SKILL.md +99 -0
- package/lib/skills/marp-slideshow/SKILL.md +212 -0
- package/lib/skills/mermaid-flowchart/SKILL.md +194 -0
- package/lib/skills/now/SKILL.md +36 -0
- package/lib/skills/port-feature/SKILL.md +315 -0
- package/lib/skills/power-mode/SKILL.md +184 -0
- package/lib/skills/primer/SKILL.md +84 -0
- package/lib/skills/project-readme/SKILL.md +166 -0
- package/lib/skills/req-compile/SKILL.md +131 -0
- package/lib/skills/req-create/SKILL.md +124 -0
- package/lib/skills/req-extract-decisions/SKILL.md +241 -0
- package/lib/skills/req-finalize/SKILL.md +251 -0
- package/lib/skills/req-retire/SKILL.md +185 -0
- package/lib/skills/req-update/SKILL.md +265 -0
- package/lib/skills/research/SKILL.md +250 -0
- package/lib/skills/research-company/SKILL.md +345 -0
- package/lib/skills/roadmap-add/SKILL.md +238 -0
- package/lib/skills/roadmap-create/SKILL.md +223 -0
- package/lib/skills/roadmap-next/SKILL.md +132 -0
- package/lib/skills/security-audit/SKILL.md +246 -0
- package/lib/skills/serena-config/SKILL.md +92 -0
- package/lib/skills/simplify/SKILL.md +227 -0
- package/lib/skills/tackle/SKILL.md +156 -0
- package/lib/skills/task-add/SKILL.md +208 -0
- package/lib/skills/task-audit/SKILL.md +294 -0
- package/lib/skills/task-trash/SKILL.md +115 -0
- package/lib/skills/task-update/SKILL.md +136 -0
- package/lib/skills/uat-auto/SKILL.md +69 -0
- package/lib/skills/uat-auto-plus/SKILL.md +115 -0
- package/lib/skills/uat-generate/SKILL.md +289 -0
- package/lib/skills/uat-skip/SKILL.md +169 -0
- package/lib/skills/uat-walk/SKILL.md +164 -0
- package/lib/skills/uat-walk/UAT-CORE.md +140 -0
- package/lib/skills/update-docs/SKILL.md +75 -0
- package/lib/skills/wiki-archive/SKILL.md +96 -0
- package/lib/skills/wiki-ingest/SKILL.md +139 -0
- package/lib/skills/wiki-lint/SKILL.md +131 -0
- package/lib/skills/wiki-query/SKILL.md +71 -0
- package/lib/skills/wiki-rotate-log/SKILL.md +90 -0
- package/lib/skills/wiki-tidy/SKILL.md +107 -0
- package/package.json +32 -0
- package/raw/.gitkeep +0 -0
- package/raw/design-principles.md +65 -0
- package/raw/guides/command-anti-patterns.md +79 -0
- package/raw/guides/deployment-strategy.md +448 -0
- package/raw/guides/evals-framework.md +452 -0
- package/raw/guides/mcp-tools.md +335 -0
- package/raw/guides/task-spec.md +79 -0
- package/raw/guides/type-checking-templates/README.md +112 -0
- package/raw/guides/type-checking-templates/eslint/eslint.config.ts +105 -0
- package/raw/guides/type-checking-templates/python/mypy.ini +69 -0
- package/raw/guides/type-checking-templates/python/pyproject.toml +164 -0
- package/raw/guides/type-checking-templates/python/pyrightconfig.json +67 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.app.jsonc +45 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.lib.jsonc +44 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.node-esm.jsonc +40 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.node.jsonc +34 -0
- package/raw/guides/type-checking-templates/tsconfig/tsconfig.vite-root.json +8 -0
- package/raw/harness-notes.md +20 -0
- package/raw/house-style/components/Badge.tsx +16 -0
- package/raw/house-style/components/Button.tsx +32 -0
- package/raw/house-style/components/Card.tsx +26 -0
- package/raw/house-style/components/Chip.tsx +57 -0
- package/raw/house-style/components/IconButton.tsx +67 -0
- package/raw/house-style/components/Modal.tsx +18 -0
- package/raw/house-style/components/Stepper.tsx +141 -0
- package/raw/house-style/components/icons.tsx +128 -0
- package/raw/house-style/preview/src/index.css +46 -0
- package/raw/house-style/tokens/tailwind.preset.ts +49 -0
- package/raw/house-style/tokens/tokens.json +62 -0
- package/raw/llm-wiki-2.md +162 -0
- package/raw/llm-wiki.md +75 -0
- package/raw/research/dark-mode-theme/index.md +85 -0
- package/raw/research/dark-mode-theme/sources.md +49 -0
- package/raw/research/serena-mcp-disconnect/index.md +81 -0
- package/raw/research/serena-mcp-disconnect/sources.md +87 -0
- package/raw/research/wiki-tooling-improvements/index.md +126 -0
- package/raw/research/wiki-tooling-improvements/sources.md +73 -0
- package/raw/software-factory-case-study.pdf +0 -0
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
; mypy.ini
|
|
2
|
+
; Use this file when pyproject.toml is owned by another tool or when you
|
|
3
|
+
; prefer a standalone mypy config. If using pyproject.toml, put these
|
|
4
|
+
; settings under [tool.mypy] instead and delete this file.
|
|
5
|
+
|
|
6
|
+
[mypy]
|
|
7
|
+
; --- Target Python version (keep in sync with pyproject.toml + pyrightconfig) ---
|
|
8
|
+
python_version = 3.12
|
|
9
|
+
|
|
10
|
+
; --- Strictness floor ---
|
|
11
|
+
; Use `strict` as one source of truth. Never approximate it with manual flags —
|
|
12
|
+
; you'll miss flags added in future mypy releases.
|
|
13
|
+
strict = True
|
|
14
|
+
|
|
15
|
+
; Enable progressively once strict = True is stable:
|
|
16
|
+
; disallow_any_explicit = True ; Forbids explicit `x: Any` annotations
|
|
17
|
+
; warn_unreachable = True ; Flags dead code after early returns / raises
|
|
18
|
+
|
|
19
|
+
; --- Plugin integrations (add only what the project uses) ---
|
|
20
|
+
plugins = pydantic.mypy
|
|
21
|
+
; plugins = pydantic.mypy, sqlalchemy.ext.mypy.plugin
|
|
22
|
+
|
|
23
|
+
; --- Scope ---
|
|
24
|
+
; Explicitly list source directories; prevents mypy from crawling .venv, dist, etc.
|
|
25
|
+
; files = src, tests
|
|
26
|
+
; exclude = (^|/)(\.venv|tmp|__pycache__|build|dist|alembic)(/|$)
|
|
27
|
+
|
|
28
|
+
; --- Reporting ---
|
|
29
|
+
show_error_codes = True ; Show [error-code] in each diagnostic line
|
|
30
|
+
pretty = True ; Colour + context lines in terminal output
|
|
31
|
+
warn_unused_configs = True ; Warn if a per-module override matches nothing
|
|
32
|
+
|
|
33
|
+
; ---------------------------------------------------------------------------
|
|
34
|
+
; Third-party stub overrides
|
|
35
|
+
; RULE: ignore_missing_imports ONLY — never ignore_errors for first-party code.
|
|
36
|
+
; ignore_errors = True suppresses ALL diagnostics (syntax errors, real type
|
|
37
|
+
; errors, everything). It should only appear for generated/vendor code.
|
|
38
|
+
; ---------------------------------------------------------------------------
|
|
39
|
+
|
|
40
|
+
; [mypy-authlib]
|
|
41
|
+
; ignore_missing_imports = True
|
|
42
|
+
|
|
43
|
+
; [mypy-authlib.*]
|
|
44
|
+
; ignore_missing_imports = True
|
|
45
|
+
|
|
46
|
+
; [mypy-lxml]
|
|
47
|
+
; ignore_missing_imports = True
|
|
48
|
+
|
|
49
|
+
; [mypy-lxml.*]
|
|
50
|
+
; ignore_missing_imports = True
|
|
51
|
+
|
|
52
|
+
; [mypy-pgvector]
|
|
53
|
+
; ignore_missing_imports = True
|
|
54
|
+
|
|
55
|
+
; [mypy-pgvector.*]
|
|
56
|
+
; ignore_missing_imports = True
|
|
57
|
+
|
|
58
|
+
; ---------------------------------------------------------------------------
|
|
59
|
+
; Legacy / generated module overrides
|
|
60
|
+
; Use targeted flag relaxations. Only use ignore_errors for truly unmaintainable
|
|
61
|
+
; code (generated outputs, vendor code) — never for first-party modules.
|
|
62
|
+
; ---------------------------------------------------------------------------
|
|
63
|
+
|
|
64
|
+
; [mypy-my_project.legacy.*]
|
|
65
|
+
; disallow_untyped_defs = False
|
|
66
|
+
; warn_return_any = False
|
|
67
|
+
|
|
68
|
+
; [mypy-my_project.generated.*]
|
|
69
|
+
; ignore_errors = True ; Last resort: generated code only
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
# pyproject.toml — type checking & linting sections only
|
|
2
|
+
# Replace all MY_PROJECT / my_project placeholders with your package name.
|
|
3
|
+
# Remove sections that don't apply (e.g. FastAPI B008 block for non-FastAPI projects).
|
|
4
|
+
|
|
5
|
+
# =============================================================================
|
|
6
|
+
# TYPE CHECKING — mypy (primary)
|
|
7
|
+
# =============================================================================
|
|
8
|
+
|
|
9
|
+
[tool.mypy]
|
|
10
|
+
python_version = "3.12"
|
|
11
|
+
strict = true # Enables the full strict flag set:
|
|
12
|
+
# disallow_untyped_defs, disallow_untyped_calls,
|
|
13
|
+
# disallow_any_generics, disallow_subclassing_any,
|
|
14
|
+
# warn_return_any, warn_unused_ignores,
|
|
15
|
+
# no_implicit_reexport, strict_equality, etc.
|
|
16
|
+
# Never approximate strict mode with manual flags —
|
|
17
|
+
# `strict = true` is one source of truth and auto-
|
|
18
|
+
# benefits from mypy upgrades.
|
|
19
|
+
|
|
20
|
+
# Plugins — add only what the project uses
|
|
21
|
+
plugins = [
|
|
22
|
+
"pydantic.mypy", # Required if using Pydantic models (v1 or v2)
|
|
23
|
+
# "sqlalchemy.ext.mypy.plugin", # Required if using SQLAlchemy ORM
|
|
24
|
+
]
|
|
25
|
+
|
|
26
|
+
# Scope — tell mypy exactly where to look; avoids crawling .venv / build artifacts
|
|
27
|
+
files = ["src", "tests"]
|
|
28
|
+
exclude = '(^|/)(\.(venv|git)|tmp|__pycache__|build|dist|alembic)(/|$)'
|
|
29
|
+
|
|
30
|
+
# Reporting quality-of-life
|
|
31
|
+
show_error_codes = true # Show [error-code] in each diagnostic line
|
|
32
|
+
pretty = true # Colour + context lines in terminal output
|
|
33
|
+
warn_unreachable = true # Flag dead code after early returns / raises
|
|
34
|
+
warn_unused_configs = true # Warn if a per-module override matches nothing
|
|
35
|
+
|
|
36
|
+
# ---------------------------------------------------------------------------
|
|
37
|
+
# Stub overrides — list every library that doesn't ship py.typed or stubs.
|
|
38
|
+
# RULE: Use ignore_missing_imports (not ignore_errors) to stay blind only to the
|
|
39
|
+
# missing stub, not to real type errors in your own code.
|
|
40
|
+
# ANTI-PATTERN: ignore_errors = true on whole modules — silences real bugs.
|
|
41
|
+
# ---------------------------------------------------------------------------
|
|
42
|
+
|
|
43
|
+
# [[tool.mypy.overrides]]
|
|
44
|
+
# module = ["boto3", "boto3.*", "botocore", "botocore.*"]
|
|
45
|
+
# ignore_missing_imports = true
|
|
46
|
+
|
|
47
|
+
# [[tool.mypy.overrides]]
|
|
48
|
+
# module = ["some_untyped_lib", "some_untyped_lib.*"]
|
|
49
|
+
# ignore_missing_imports = true
|
|
50
|
+
|
|
51
|
+
# [[tool.mypy.overrides]]
|
|
52
|
+
# # For truly unmaintainable generated / vendor code ONLY:
|
|
53
|
+
# module = ["my_project.generated.*"]
|
|
54
|
+
# ignore_errors = true # Never use for first-party code
|
|
55
|
+
|
|
56
|
+
# =============================================================================
|
|
57
|
+
# TYPE CHECKING — basedpyright (companion; covers mypy gaps only)
|
|
58
|
+
# =============================================================================
|
|
59
|
+
# Mypy is the primary type checker. basedpyright runs alongside it ONLY to
|
|
60
|
+
# catch the handful of checks mypy currently lacks:
|
|
61
|
+
# - TypedDict NotRequired access (mypy gap: python/mypy#9408)
|
|
62
|
+
# - Unhashable dict keys
|
|
63
|
+
# - Unused parameters
|
|
64
|
+
# Keep typeCheckingMode = "off" to avoid double-reporting everything mypy
|
|
65
|
+
# already covers; opt in to specific rules only.
|
|
66
|
+
|
|
67
|
+
[tool.basedpyright]
|
|
68
|
+
include = ["src"]
|
|
69
|
+
exclude = ["**/__pycache__", ".venv", "tmp", "build", "dist"]
|
|
70
|
+
pythonVersion = "3.12"
|
|
71
|
+
typeCheckingMode = "off"
|
|
72
|
+
reportTypedDictNotRequiredAccess = "error"
|
|
73
|
+
reportUnusedParameter = "error"
|
|
74
|
+
reportUnhashable = "error"
|
|
75
|
+
reportAttributeAccessIssue = "error"
|
|
76
|
+
|
|
77
|
+
# =============================================================================
|
|
78
|
+
# LINTING & FORMATTING — ruff
|
|
79
|
+
# =============================================================================
|
|
80
|
+
|
|
81
|
+
[tool.ruff]
|
|
82
|
+
target-version = "py312" # Minimum Python version for syntax transforms
|
|
83
|
+
line-length = 100 # Consistent across projects; adjust only if team has strong opinions
|
|
84
|
+
|
|
85
|
+
[tool.ruff.lint]
|
|
86
|
+
select = [
|
|
87
|
+
"E", # pycodestyle errors
|
|
88
|
+
"W", # pycodestyle warnings
|
|
89
|
+
"F", # pyflakes (undefined names, unused imports)
|
|
90
|
+
"I", # isort (import ordering)
|
|
91
|
+
"N", # pep8-naming (class/function/variable naming conventions)
|
|
92
|
+
"UP", # pyupgrade (modernise syntax to target Python version)
|
|
93
|
+
"B", # flake8-bugbear (likely bugs and design issues)
|
|
94
|
+
"C4", # flake8-comprehensions (simplify list/dict/set comprehensions)
|
|
95
|
+
"SIM", # flake8-simplify (simplifiable if/return/with patterns)
|
|
96
|
+
"RUF", # ruff-native rules (opinionated, fast, no external dep)
|
|
97
|
+
# "C90", # mccabe complexity — add for complex control-flow codebases
|
|
98
|
+
]
|
|
99
|
+
ignore = [
|
|
100
|
+
# Add project-specific silences here with a comment justifying each one.
|
|
101
|
+
# Example: "N802", # Allow lowercase function names in test fixtures
|
|
102
|
+
]
|
|
103
|
+
|
|
104
|
+
[tool.ruff.lint.mccabe]
|
|
105
|
+
# Only relevant if "C90" is in select above.
|
|
106
|
+
# 10 is the default; raise to 15 only for agent loops / multi-provider routing
|
|
107
|
+
# and document the reason.
|
|
108
|
+
max-complexity = 10
|
|
109
|
+
|
|
110
|
+
[tool.ruff.lint.isort]
|
|
111
|
+
known-first-party = ["my_project"] # Replace with your package name(s)
|
|
112
|
+
split-on-trailing-comma = true
|
|
113
|
+
|
|
114
|
+
[tool.ruff.lint.flake8-bugbear]
|
|
115
|
+
# FastAPI's Depends() / Query() / Path() / Body() etc. are evaluated at
|
|
116
|
+
# request time, not standard mutable defaults — B008 is a false positive here.
|
|
117
|
+
# REMOVE this block entirely for non-FastAPI projects.
|
|
118
|
+
extend-immutable-calls = [
|
|
119
|
+
"fastapi.Depends",
|
|
120
|
+
"fastapi.Query",
|
|
121
|
+
"fastapi.Path",
|
|
122
|
+
"fastapi.Body",
|
|
123
|
+
"fastapi.Header",
|
|
124
|
+
"fastapi.Cookie",
|
|
125
|
+
"fastapi.Form",
|
|
126
|
+
"fastapi.File",
|
|
127
|
+
]
|
|
128
|
+
|
|
129
|
+
[tool.ruff.lint.per-file-ignores]
|
|
130
|
+
# Test files: long assertion messages legitimately exceed line limits
|
|
131
|
+
"tests/**/*.py" = ["E501"]
|
|
132
|
+
# Generated / vendor code: suppress everything
|
|
133
|
+
# "src/my_project/generated/**" = ["E", "W", "F", "I", "UP", "B"]
|
|
134
|
+
|
|
135
|
+
# =============================================================================
|
|
136
|
+
# TEST RUNNER — pytest
|
|
137
|
+
# =============================================================================
|
|
138
|
+
|
|
139
|
+
[tool.pytest.ini_options]
|
|
140
|
+
asyncio_mode = "auto"
|
|
141
|
+
testpaths = ["tests"]
|
|
142
|
+
addopts = "-ra --strict-markers"
|
|
143
|
+
markers = [
|
|
144
|
+
"unit: fast hermetic tests with no external services",
|
|
145
|
+
"integration: requires live database or external service",
|
|
146
|
+
"e2e: full end-to-end scenario",
|
|
147
|
+
"live: makes real LLM / API calls (skipped in CI unless --live is passed)",
|
|
148
|
+
]
|
|
149
|
+
|
|
150
|
+
# =============================================================================
|
|
151
|
+
# COVERAGE
|
|
152
|
+
# =============================================================================
|
|
153
|
+
|
|
154
|
+
[tool.coverage.run]
|
|
155
|
+
source = ["src"]
|
|
156
|
+
branch = true # Measure branch (arc) coverage, not just line
|
|
157
|
+
omit = ["*/__pycache__/*", "*/examples/*", "*/generated/*"]
|
|
158
|
+
|
|
159
|
+
[tool.coverage.report]
|
|
160
|
+
show_missing = true
|
|
161
|
+
skip_empty = true
|
|
162
|
+
precision = 1
|
|
163
|
+
fail_under = 80 # CI hard-failure threshold; lower only with a
|
|
164
|
+
# dated comment explaining the gap and a target date
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
{
|
|
2
|
+
// pyrightconfig.json
|
|
3
|
+
// For basedpyright (recommended) or pyright.
|
|
4
|
+
// If you use pyproject.toml with [tool.basedpyright] / [tool.pyright],
|
|
5
|
+
// you can omit this file and put all settings there. Prefer one source of truth.
|
|
6
|
+
|
|
7
|
+
// --- Scope: explicit include/exclude keeps analysis fast and avoids noise ---
|
|
8
|
+
"include": [
|
|
9
|
+
"src", // production source
|
|
10
|
+
"tests", // test code should be checked
|
|
11
|
+
"scripts" // utility scripts
|
|
12
|
+
],
|
|
13
|
+
"exclude": [
|
|
14
|
+
"**/node_modules",
|
|
15
|
+
"**/.venv",
|
|
16
|
+
"**/__pycache__",
|
|
17
|
+
"**/.mypy_cache",
|
|
18
|
+
"**/.ruff_cache",
|
|
19
|
+
"**/.pytest_cache",
|
|
20
|
+
"**/dist",
|
|
21
|
+
"**/build",
|
|
22
|
+
"**/*.egg-info"
|
|
23
|
+
],
|
|
24
|
+
|
|
25
|
+
// --- Virtual environment ---
|
|
26
|
+
// venvPath: directory CONTAINING the venv folder (usually ".")
|
|
27
|
+
// venv: name of the venv folder itself (usually ".venv")
|
|
28
|
+
"venvPath": ".",
|
|
29
|
+
"venv": ".venv",
|
|
30
|
+
|
|
31
|
+
// --- Python version (keep in sync with mypy.ini + pyproject.toml) ---
|
|
32
|
+
"pythonVersion": "3.12",
|
|
33
|
+
|
|
34
|
+
// --- Type-checking mode ---
|
|
35
|
+
// ANTI-PATTERN: omitting typeCheckingMode defaults to "off" — no type checking at all.
|
|
36
|
+
// "basic" → lightweight checks, good starting point for legacy codebases
|
|
37
|
+
// "standard" → recommended floor for active projects
|
|
38
|
+
// "strict" → all checks; use for greenfield or fully-annotated code
|
|
39
|
+
"typeCheckingMode": "standard",
|
|
40
|
+
|
|
41
|
+
// --- Companion mode (when running alongside mypy) ---
|
|
42
|
+
// If mypy is your primary checker, set typeCheckingMode = "off" and only
|
|
43
|
+
// opt in to rules mypy currently lacks. See pyproject.toml [tool.basedpyright].
|
|
44
|
+
|
|
45
|
+
// --- Diagnostic overrides ---
|
|
46
|
+
// Missing imports should always be errors: broken resolution is always a problem.
|
|
47
|
+
"reportMissingImports": "error",
|
|
48
|
+
// Many popular libraries still lack stubs; keep as warning.
|
|
49
|
+
"reportMissingTypeStubs": "warning",
|
|
50
|
+
// Free correctness wins — flag unused imports and variables
|
|
51
|
+
"reportUnusedImports": "warning",
|
|
52
|
+
"reportUnusedVariables": "warning",
|
|
53
|
+
// Flag access to __-prefixed members from outside the class
|
|
54
|
+
"reportPrivateUsage": "warning",
|
|
55
|
+
|
|
56
|
+
// --- Strict overrides to add even in "standard" mode ---
|
|
57
|
+
// Uncomment as the codebase matures:
|
|
58
|
+
// "reportReturnType": "error",
|
|
59
|
+
// "reportOperatorIssue": "error",
|
|
60
|
+
// "reportIndexIssue": "error",
|
|
61
|
+
// "reportTypedDictNotRequiredAccess": "error", // mypy gap: python/mypy#9408
|
|
62
|
+
|
|
63
|
+
// --- Import resolution ---
|
|
64
|
+
// Only add extraPaths to fix legitimate src-layout issues.
|
|
65
|
+
// Do NOT use to paper over packaging problems.
|
|
66
|
+
// "extraPaths": ["src"]
|
|
67
|
+
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
// tsconfig.app.jsonc
|
|
2
|
+
// Use for: Vite + React browser app code
|
|
3
|
+
// This is ONE of THREE files in the Vite three-file split (root / app / node).
|
|
4
|
+
{
|
|
5
|
+
"$schema": "https://json.schemastore.org/tsconfig",
|
|
6
|
+
"compilerOptions": {
|
|
7
|
+
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
|
|
8
|
+
|
|
9
|
+
// --- Language ---
|
|
10
|
+
"target": "ES2022", // Safe floor for all evergreen browsers
|
|
11
|
+
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
|
12
|
+
"useDefineForClassFields": true,
|
|
13
|
+
|
|
14
|
+
// --- Modules ---
|
|
15
|
+
// bundler = correct for Vite; understands package.json `exports`, .ts imports
|
|
16
|
+
"module": "ESNext",
|
|
17
|
+
"moduleResolution": "bundler",
|
|
18
|
+
"allowImportingTsExtensions": true, // Allow `.ts` and `.tsx` import extensions
|
|
19
|
+
"verbatimModuleSyntax": true, // TS 5.0+: enforces `import type` where needed
|
|
20
|
+
"moduleDetection": "force", // Treat all files as modules (avoids global-script mode)
|
|
21
|
+
"resolveJsonModule": true,
|
|
22
|
+
|
|
23
|
+
// --- Emit ---
|
|
24
|
+
// Vite handles the actual emit; TypeScript is a checker only here
|
|
25
|
+
"noEmit": true,
|
|
26
|
+
|
|
27
|
+
// --- JSX ---
|
|
28
|
+
"jsx": "react-jsx", // React 17+ automatic transform; no `import React` needed
|
|
29
|
+
"types": ["vite/client"], // Exposes `import.meta.env`, asset imports, etc.
|
|
30
|
+
|
|
31
|
+
// --- Strict type checking ---
|
|
32
|
+
"strict": true,
|
|
33
|
+
"noUncheckedIndexedAccess": true, // array[i] → T|undefined, catches most index bugs
|
|
34
|
+
"noImplicitReturns": true,
|
|
35
|
+
"noFallthroughCasesInSwitch": true,
|
|
36
|
+
"noImplicitOverride": true,
|
|
37
|
+
"noUnusedLocals": true,
|
|
38
|
+
"noUnusedParameters": true,
|
|
39
|
+
"exactOptionalPropertyTypes": true, // Distinguishes `{x?: string}` from `{x: string|undefined}`
|
|
40
|
+
|
|
41
|
+
// --- Housekeeping ---
|
|
42
|
+
"skipLibCheck": true
|
|
43
|
+
},
|
|
44
|
+
"include": ["src"]
|
|
45
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
// tsconfig.lib.jsonc
|
|
2
|
+
// Use for: React/TypeScript library that emits .d.ts for npm publishing
|
|
3
|
+
// Key differences from app config: declaration emit enabled, no noEmit
|
|
4
|
+
{
|
|
5
|
+
"$schema": "https://json.schemastore.org/tsconfig",
|
|
6
|
+
"compilerOptions": {
|
|
7
|
+
// --- Output ---
|
|
8
|
+
"outDir": "./dist",
|
|
9
|
+
"declaration": true, // Emit .d.ts declaration files
|
|
10
|
+
"declarationMap": true, // Source maps for declaration files (enables "go to source")
|
|
11
|
+
"emitDeclarationOnly": true, // Bundler (Rollup/Vite lib mode) handles JS; TS emits types only
|
|
12
|
+
"sourceMap": true,
|
|
13
|
+
|
|
14
|
+
// --- Language ---
|
|
15
|
+
"target": "ES2020", // Safe floor for modern bundled library consumers
|
|
16
|
+
"lib": ["ES2020", "DOM", "DOM.Iterable"],
|
|
17
|
+
|
|
18
|
+
// --- Modules ---
|
|
19
|
+
"module": "ESNext",
|
|
20
|
+
"moduleResolution": "bundler",
|
|
21
|
+
"verbatimModuleSyntax": true,
|
|
22
|
+
"resolveJsonModule": true,
|
|
23
|
+
|
|
24
|
+
// --- JSX ---
|
|
25
|
+
"jsx": "react-jsx", // React 17+ automatic transform; never use "react" (old style)
|
|
26
|
+
|
|
27
|
+
// --- Strict type checking ---
|
|
28
|
+
"strict": true,
|
|
29
|
+
"noUncheckedIndexedAccess": true,
|
|
30
|
+
"noImplicitReturns": true,
|
|
31
|
+
"noFallthroughCasesInSwitch": true,
|
|
32
|
+
"noImplicitOverride": true,
|
|
33
|
+
"noUnusedLocals": true,
|
|
34
|
+
"noUnusedParameters": true,
|
|
35
|
+
|
|
36
|
+
// --- Interop ---
|
|
37
|
+
"esModuleInterop": true,
|
|
38
|
+
"forceConsistentCasingInFileNames": true,
|
|
39
|
+
"skipLibCheck": true
|
|
40
|
+
},
|
|
41
|
+
"include": ["src/**/*.ts", "src/**/*.tsx"],
|
|
42
|
+
// Exclude tests and spec files from the published declaration output
|
|
43
|
+
"exclude": ["node_modules", "dist", "**/*.test.*", "**/*.spec.*"]
|
|
44
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
// tsconfig.node-esm.jsonc
|
|
2
|
+
// Use for: Node.js services, CLIs, MCP servers using native ESM
|
|
3
|
+
// Key: NodeNext is the ONLY correct module/moduleResolution pair for native Node.js ESM.
|
|
4
|
+
{
|
|
5
|
+
"$schema": "https://json.schemastore.org/tsconfig",
|
|
6
|
+
"compilerOptions": {
|
|
7
|
+
// --- Output ---
|
|
8
|
+
"outDir": "./dist",
|
|
9
|
+
"rootDir": "./src",
|
|
10
|
+
"sourceMap": true,
|
|
11
|
+
|
|
12
|
+
// --- Language ---
|
|
13
|
+
"target": "ES2023", // Match your actual minimum Node version
|
|
14
|
+
"lib": ["ES2023"], // No DOM — this is a Node-only project
|
|
15
|
+
|
|
16
|
+
// --- Modules ---
|
|
17
|
+
// NodeNext is the only correct pair for native ESM in Node.
|
|
18
|
+
// "node" resolution doesn't understand package.json `exports` field or .js extensions.
|
|
19
|
+
"module": "NodeNext",
|
|
20
|
+
"moduleResolution": "NodeNext",
|
|
21
|
+
"resolveJsonModule": true,
|
|
22
|
+
"verbatimModuleSyntax": true, // TS 5.0+: enforces `import type` where needed; prevents runtime import bugs
|
|
23
|
+
|
|
24
|
+
// --- Strict type checking ---
|
|
25
|
+
"strict": true,
|
|
26
|
+
"noUncheckedIndexedAccess": true, // Highest-value strict add-on: array[i] returns T|undefined, not T
|
|
27
|
+
"noImplicitReturns": true,
|
|
28
|
+
"noFallthroughCasesInSwitch": true,
|
|
29
|
+
"noImplicitOverride": true,
|
|
30
|
+
"noUnusedLocals": true,
|
|
31
|
+
"noUnusedParameters": true,
|
|
32
|
+
|
|
33
|
+
// --- Interop ---
|
|
34
|
+
"esModuleInterop": true,
|
|
35
|
+
"forceConsistentCasingInFileNames": true,
|
|
36
|
+
"skipLibCheck": true // Avoid noise from third-party .d.ts files
|
|
37
|
+
},
|
|
38
|
+
"include": ["src/**/*"],
|
|
39
|
+
"exclude": ["node_modules", "dist"]
|
|
40
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
// tsconfig.node.jsonc
|
|
2
|
+
// Use for: Compiling vite.config.ts (and similar Node-context config files)
|
|
3
|
+
// This is ONE of THREE files in the Vite three-file split (root / app / node).
|
|
4
|
+
{
|
|
5
|
+
"$schema": "https://json.schemastore.org/tsconfig",
|
|
6
|
+
"compilerOptions": {
|
|
7
|
+
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
|
|
8
|
+
|
|
9
|
+
// --- Language ---
|
|
10
|
+
"target": "ES2023",
|
|
11
|
+
"lib": ["ES2023"], // No DOM — vite.config.ts runs in Node
|
|
12
|
+
|
|
13
|
+
// --- Modules ---
|
|
14
|
+
"module": "ESNext",
|
|
15
|
+
"moduleResolution": "bundler",
|
|
16
|
+
"allowImportingTsExtensions": true,
|
|
17
|
+
"verbatimModuleSyntax": true,
|
|
18
|
+
"moduleDetection": "force",
|
|
19
|
+
|
|
20
|
+
// --- Emit ---
|
|
21
|
+
"noEmit": true,
|
|
22
|
+
"types": ["node"], // Node.js globals (process, __dirname, etc.)
|
|
23
|
+
|
|
24
|
+
// --- Strict ---
|
|
25
|
+
"strict": true,
|
|
26
|
+
"noUnusedLocals": true,
|
|
27
|
+
"noUnusedParameters": true,
|
|
28
|
+
"noImplicitReturns": true,
|
|
29
|
+
"noFallthroughCasesInSwitch": true,
|
|
30
|
+
|
|
31
|
+
"skipLibCheck": true
|
|
32
|
+
},
|
|
33
|
+
"include": ["vite.config.ts"] // Cover ONLY the vite config; nothing else
|
|
34
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
HARNESS
|
|
2
|
+
|
|
3
|
+
1) context
|
|
4
|
+
2) memory
|
|
5
|
+
3) tools
|
|
6
|
+
4) evals
|
|
7
|
+
|
|
8
|
+
Software factory is the same agent with different harnesses
|
|
9
|
+
|
|
10
|
+
Marketing example
|
|
11
|
+
- CMO
|
|
12
|
+
- Performance marketer
|
|
13
|
+
- Content strategist
|
|
14
|
+
|
|
15
|
+
Build a brownfield legacy
|
|
16
|
+
|
|
17
|
+
organization
|
|
18
|
+
hand offs
|
|
19
|
+
reviews
|
|
20
|
+
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
|
|
3
|
+
// Compact pill label. Neutral by default; pass accent classes for semantic state.
|
|
4
|
+
export default function Badge({ children, className = "" }: { children: ReactNode; className?: string }) {
|
|
5
|
+
return (
|
|
6
|
+
<span
|
|
7
|
+
className={
|
|
8
|
+
"inline-flex items-center rounded-pill border border-line bg-card px-2.5 py-[5px] text-[11.5px] font-medium text-ink-2 " +
|
|
9
|
+
"transition hover:border-accent/40 hover:bg-surface " +
|
|
10
|
+
className
|
|
11
|
+
}
|
|
12
|
+
>
|
|
13
|
+
{children}
|
|
14
|
+
</span>
|
|
15
|
+
);
|
|
16
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type ButtonHTMLAttributes, type ReactNode } from "react";
|
|
2
|
+
|
|
3
|
+
// Primary dark CTA. Inset highlight + press-scale + dark focus ring.
|
|
4
|
+
// Optional leading icon gets a playful tilt-and-grow on hover (the "group"
|
|
5
|
+
// drives it) — the small delight that makes the button feel alive.
|
|
6
|
+
export default function Button({
|
|
7
|
+
className = "",
|
|
8
|
+
icon,
|
|
9
|
+
children,
|
|
10
|
+
...props
|
|
11
|
+
}: ButtonHTMLAttributes<HTMLButtonElement> & { icon?: ReactNode }) {
|
|
12
|
+
return (
|
|
13
|
+
<button
|
|
14
|
+
className={
|
|
15
|
+
"group inline-flex h-9 items-center justify-center gap-1.5 rounded-lg bg-ink px-3 text-[13px] font-medium text-white " +
|
|
16
|
+
"shadow-[0_1px_2px_0_rgb(16_17_26/0.06),inset_0_1px_0_0_rgb(255_255_255/0.1)] " +
|
|
17
|
+
"transition hover:bg-[#1c1c22] active:scale-[0.985] " +
|
|
18
|
+
"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ink/25 " +
|
|
19
|
+
"disabled:pointer-events-none disabled:opacity-50 " +
|
|
20
|
+
className
|
|
21
|
+
}
|
|
22
|
+
{...props}
|
|
23
|
+
>
|
|
24
|
+
{icon && (
|
|
25
|
+
<span className="transition-transform duration-300 group-hover:rotate-[16deg] group-hover:scale-110">
|
|
26
|
+
{icon}
|
|
27
|
+
</span>
|
|
28
|
+
)}
|
|
29
|
+
{children}
|
|
30
|
+
</button>
|
|
31
|
+
);
|
|
32
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
|
|
3
|
+
export default function Card({
|
|
4
|
+
children,
|
|
5
|
+
className = "",
|
|
6
|
+
padded = true,
|
|
7
|
+
bare = false,
|
|
8
|
+
}: {
|
|
9
|
+
children: ReactNode;
|
|
10
|
+
className?: string;
|
|
11
|
+
padded?: boolean;
|
|
12
|
+
bare?: boolean;
|
|
13
|
+
}) {
|
|
14
|
+
return (
|
|
15
|
+
<div
|
|
16
|
+
className={
|
|
17
|
+
"rounded-card border border-line bg-card " +
|
|
18
|
+
(bare ? "" : "shadow-card ") +
|
|
19
|
+
(padded ? "p-5 " : "") +
|
|
20
|
+
className
|
|
21
|
+
}
|
|
22
|
+
>
|
|
23
|
+
{children}
|
|
24
|
+
</div>
|
|
25
|
+
);
|
|
26
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { type ButtonHTMLAttributes, type ReactNode } from "react";
|
|
2
|
+
|
|
3
|
+
// The example/seed chip: a pill that lifts on hover (-translate-y-px + shadow)
|
|
4
|
+
// and presses in on click (scale-95). Two tones:
|
|
5
|
+
// - "neutral": hairline pill, hover gains an accent edge + surface fill
|
|
6
|
+
// - "highlight": amber-tinted to flag a special/ready item, with a leading dot
|
|
7
|
+
// `dot` adds a small status dot (auto-on for highlight). Disabled freezes the
|
|
8
|
+
// lift/press and dims — the same restraint the source uses while busy.
|
|
9
|
+
type Tone = "neutral" | "highlight";
|
|
10
|
+
|
|
11
|
+
const TONE: Record<Tone, string> = {
|
|
12
|
+
neutral:
|
|
13
|
+
"border-line bg-card text-ink-2 hover:border-accent/40 hover:bg-surface hover:text-ink " +
|
|
14
|
+
"disabled:hover:border-line disabled:hover:bg-card disabled:hover:text-ink-2",
|
|
15
|
+
highlight:
|
|
16
|
+
"border-accent-amber/50 bg-accent-amber/10 text-ink-2 hover:border-accent-amber hover:bg-accent-amber/20 hover:text-ink " +
|
|
17
|
+
"disabled:hover:border-accent-amber/50 disabled:hover:bg-accent-amber/10 disabled:hover:text-ink-2",
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
export default function Chip({
|
|
21
|
+
children,
|
|
22
|
+
tone = "neutral",
|
|
23
|
+
dot,
|
|
24
|
+
className = "",
|
|
25
|
+
...props
|
|
26
|
+
}: ButtonHTMLAttributes<HTMLButtonElement> & {
|
|
27
|
+
children: ReactNode;
|
|
28
|
+
tone?: Tone;
|
|
29
|
+
dot?: boolean;
|
|
30
|
+
}) {
|
|
31
|
+
const showDot = dot ?? tone === "highlight";
|
|
32
|
+
return (
|
|
33
|
+
<button
|
|
34
|
+
type="button"
|
|
35
|
+
className={
|
|
36
|
+
"inline-flex items-center rounded-pill border px-2.5 py-[5px] text-[11.5px] font-medium " +
|
|
37
|
+
"transition-all hover:-translate-y-px hover:shadow-card active:scale-95 " +
|
|
38
|
+
"disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:translate-y-0 disabled:hover:shadow-none " +
|
|
39
|
+
TONE[tone] +
|
|
40
|
+
" " +
|
|
41
|
+
className
|
|
42
|
+
}
|
|
43
|
+
{...props}
|
|
44
|
+
>
|
|
45
|
+
{showDot && (
|
|
46
|
+
<span
|
|
47
|
+
className={
|
|
48
|
+
"mr-1.5 h-1.5 w-1.5 rounded-full " +
|
|
49
|
+
(tone === "highlight" ? "bg-accent-amber" : "bg-accent")
|
|
50
|
+
}
|
|
51
|
+
aria-hidden
|
|
52
|
+
/>
|
|
53
|
+
)}
|
|
54
|
+
{children}
|
|
55
|
+
</button>
|
|
56
|
+
);
|
|
57
|
+
}
|