@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.
Files changed (186) hide show
  1. package/.github/workflows/build.yml +88 -0
  2. package/.github/workflows/security.yml +24 -0
  3. package/.gitleaks.toml +15 -0
  4. package/README.md +472 -0
  5. package/bin/cli.js +47 -0
  6. package/lib/README.md +27 -0
  7. package/lib/hooks/README.md +316 -0
  8. package/lib/hooks/env-file-guard.js +45 -0
  9. package/lib/hooks/git-protected-ops-block.js +77 -0
  10. package/lib/hooks/lib/serena-languages.js +158 -0
  11. package/lib/hooks/lib/serena.js +787 -0
  12. package/lib/hooks/mv-absolute-path-block.js +53 -0
  13. package/lib/hooks/serena-bash-grep-block.js +501 -0
  14. package/lib/hooks/serena-edit-guard.js +74 -0
  15. package/lib/hooks/serena-first-glob-guard.js +94 -0
  16. package/lib/hooks/serena-first-guard.js +74 -0
  17. package/lib/hooks/serena-first-read-guard.js +167 -0
  18. package/lib/hooks/serena-pre-delegation.js +117 -0
  19. package/lib/hooks/serena-session-reset.js +45 -0
  20. package/lib/hooks/serena-usage-tracker.js +186 -0
  21. package/lib/hooks/serena-write-guard.js +58 -0
  22. package/lib/prompts/README.md +16 -0
  23. package/lib/prompts/migrate-wiki.md +111 -0
  24. package/lib/prompts/setup-deployment.md +322 -0
  25. package/lib/prompts/setup-design-system.md +162 -0
  26. package/lib/prompts/setup-strict-typechecks.md +139 -0
  27. package/lib/scripts/README.md +49 -0
  28. package/lib/scripts/bootstrap-serena.sh +145 -0
  29. package/lib/scripts/build-mcp-guide.sh +108 -0
  30. package/lib/scripts/install-global.sh +78 -0
  31. package/lib/scripts/install-mcps.sh +131 -0
  32. package/lib/scripts/lib.sh +154 -0
  33. package/lib/scripts/merge-gitignore.sh +65 -0
  34. package/lib/scripts/migrate-project.sh +273 -0
  35. package/lib/scripts/setup-deployment.sh +104 -0
  36. package/lib/scripts/setup-project.sh +55 -0
  37. package/lib/scripts/setup-runner.sh +99 -0
  38. package/lib/scripts/setup-strict-typechecks.sh +29 -0
  39. package/lib/scripts/startup.sh +42 -0
  40. package/lib/scripts/sync-wiki-scaffold.sh +104 -0
  41. package/lib/scripts/templates/CLAUDE-env-safety.md +3 -0
  42. package/lib/scripts/templates/CLAUDE-wiki.md +60 -0
  43. package/lib/scripts/templates/gitignore +136 -0
  44. package/lib/scripts/templates/guides/stubs/00-header.md +15 -0
  45. package/lib/scripts/templates/guides/stubs/brave-search.md +20 -0
  46. package/lib/scripts/templates/guides/stubs/context7.md +26 -0
  47. package/lib/scripts/templates/guides/stubs/playwright.md +26 -0
  48. package/lib/scripts/templates/guides/stubs/serena.md +219 -0
  49. package/lib/scripts/templates/wiki/conventions.md +100 -0
  50. package/lib/scripts/templates/wiki/dashboard.html +1733 -0
  51. package/lib/scripts/templates/wiki/hot.md +21 -0
  52. package/lib/scripts/templates/wiki/index.md +46 -0
  53. package/lib/scripts/templates/wiki/knowledge/concepts/.gitkeep +0 -0
  54. package/lib/scripts/templates/wiki/knowledge/entities/components/.gitkeep +0 -0
  55. package/lib/scripts/templates/wiki/knowledge/entities/organisations/.gitkeep +0 -0
  56. package/lib/scripts/templates/wiki/knowledge/entities/people/.gitkeep +0 -0
  57. package/lib/scripts/templates/wiki/knowledge/entities/tools/.gitkeep +0 -0
  58. package/lib/scripts/templates/wiki/knowledge/sources/.gitkeep +0 -0
  59. package/lib/scripts/templates/wiki/log.md +14 -0
  60. package/lib/scripts/templates/wiki/work/bugs/.gitkeep +0 -0
  61. package/lib/scripts/templates/wiki/work/bugs/archive/index.md +6 -0
  62. package/lib/scripts/templates/wiki/work/bugs/index.md +12 -0
  63. package/lib/scripts/templates/wiki/work/bugs/lifecycle.md +39 -0
  64. package/lib/scripts/templates/wiki/work/decisions/.gitkeep +0 -0
  65. package/lib/scripts/templates/wiki/work/decisions/archive/index.md +6 -0
  66. package/lib/scripts/templates/wiki/work/decisions/index.md +12 -0
  67. package/lib/scripts/templates/wiki/work/decisions/lifecycle.md +42 -0
  68. package/lib/scripts/templates/wiki/work/requirements/.gitkeep +0 -0
  69. package/lib/scripts/templates/wiki/work/requirements/archive/index.md +6 -0
  70. package/lib/scripts/templates/wiki/work/requirements/index.md +12 -0
  71. package/lib/scripts/templates/wiki/work/requirements/lifecycle.md +34 -0
  72. package/lib/scripts/templates/wiki/work/roadmaps/.gitkeep +0 -0
  73. package/lib/scripts/templates/wiki/work/roadmaps/archive/index.md +6 -0
  74. package/lib/scripts/templates/wiki/work/roadmaps/index.md +12 -0
  75. package/lib/scripts/templates/wiki/work/roadmaps/lifecycle.md +32 -0
  76. package/lib/scripts/templates/wiki/work/tasks/.gitkeep +0 -0
  77. package/lib/scripts/templates/wiki/work/tasks/archive/index.md +6 -0
  78. package/lib/scripts/templates/wiki/work/tasks/index.md +12 -0
  79. package/lib/scripts/templates/wiki/work/tasks/lifecycle.md +39 -0
  80. package/lib/scripts/templates/wiki/work/uat/.gitkeep +0 -0
  81. package/lib/scripts/templates/wiki/work/uat/archive/index.md +6 -0
  82. package/lib/scripts/templates/wiki/work/uat/index.md +12 -0
  83. package/lib/scripts/templates/wiki/work/uat/lifecycle.md +48 -0
  84. package/lib/scripts/templates/wiki/work/uat/screenshots/.gitkeep +0 -0
  85. package/lib/scripts/update-project.sh +75 -0
  86. package/lib/scripts/wiki-dashboard-server.js +146 -0
  87. package/lib/skills/README.md +146 -0
  88. package/lib/skills/anti-slop/SKILL.md +183 -0
  89. package/lib/skills/bug-close/SKILL.md +136 -0
  90. package/lib/skills/bug-file/SKILL.md +114 -0
  91. package/lib/skills/bug-triage/SKILL.md +140 -0
  92. package/lib/skills/company-align/SKILL.md +203 -0
  93. package/lib/skills/debug-logs/SKILL.md +129 -0
  94. package/lib/skills/decision-create/SKILL.md +220 -0
  95. package/lib/skills/decision-finalize/SKILL.md +181 -0
  96. package/lib/skills/decision-next/SKILL.md +129 -0
  97. package/lib/skills/decision-walkthrough/SKILL.md +169 -0
  98. package/lib/skills/demo/SKILL.md +183 -0
  99. package/lib/skills/elevator-pitch/SKILL.md +125 -0
  100. package/lib/skills/eval-create/SKILL.md +344 -0
  101. package/lib/skills/eval-gap/SKILL.md +150 -0
  102. package/lib/skills/eval-run/SKILL.md +214 -0
  103. package/lib/skills/extract-feature/SKILL.md +344 -0
  104. package/lib/skills/flashcard/SKILL.md +513 -0
  105. package/lib/skills/frontend-taste/SKILL.md +184 -0
  106. package/lib/skills/gap-assess/SKILL.md +97 -0
  107. package/lib/skills/git-commit/SKILL.md +164 -0
  108. package/lib/skills/lint/SKILL.md +99 -0
  109. package/lib/skills/marp-slideshow/SKILL.md +212 -0
  110. package/lib/skills/mermaid-flowchart/SKILL.md +194 -0
  111. package/lib/skills/now/SKILL.md +36 -0
  112. package/lib/skills/port-feature/SKILL.md +315 -0
  113. package/lib/skills/power-mode/SKILL.md +184 -0
  114. package/lib/skills/primer/SKILL.md +84 -0
  115. package/lib/skills/project-readme/SKILL.md +166 -0
  116. package/lib/skills/req-compile/SKILL.md +131 -0
  117. package/lib/skills/req-create/SKILL.md +124 -0
  118. package/lib/skills/req-extract-decisions/SKILL.md +241 -0
  119. package/lib/skills/req-finalize/SKILL.md +251 -0
  120. package/lib/skills/req-retire/SKILL.md +185 -0
  121. package/lib/skills/req-update/SKILL.md +265 -0
  122. package/lib/skills/research/SKILL.md +250 -0
  123. package/lib/skills/research-company/SKILL.md +345 -0
  124. package/lib/skills/roadmap-add/SKILL.md +238 -0
  125. package/lib/skills/roadmap-create/SKILL.md +223 -0
  126. package/lib/skills/roadmap-next/SKILL.md +132 -0
  127. package/lib/skills/security-audit/SKILL.md +246 -0
  128. package/lib/skills/serena-config/SKILL.md +92 -0
  129. package/lib/skills/simplify/SKILL.md +227 -0
  130. package/lib/skills/tackle/SKILL.md +156 -0
  131. package/lib/skills/task-add/SKILL.md +208 -0
  132. package/lib/skills/task-audit/SKILL.md +294 -0
  133. package/lib/skills/task-trash/SKILL.md +115 -0
  134. package/lib/skills/task-update/SKILL.md +136 -0
  135. package/lib/skills/uat-auto/SKILL.md +69 -0
  136. package/lib/skills/uat-auto-plus/SKILL.md +115 -0
  137. package/lib/skills/uat-generate/SKILL.md +289 -0
  138. package/lib/skills/uat-skip/SKILL.md +169 -0
  139. package/lib/skills/uat-walk/SKILL.md +164 -0
  140. package/lib/skills/uat-walk/UAT-CORE.md +140 -0
  141. package/lib/skills/update-docs/SKILL.md +75 -0
  142. package/lib/skills/wiki-archive/SKILL.md +96 -0
  143. package/lib/skills/wiki-ingest/SKILL.md +139 -0
  144. package/lib/skills/wiki-lint/SKILL.md +131 -0
  145. package/lib/skills/wiki-query/SKILL.md +71 -0
  146. package/lib/skills/wiki-rotate-log/SKILL.md +90 -0
  147. package/lib/skills/wiki-tidy/SKILL.md +107 -0
  148. package/package.json +32 -0
  149. package/raw/.gitkeep +0 -0
  150. package/raw/design-principles.md +65 -0
  151. package/raw/guides/command-anti-patterns.md +79 -0
  152. package/raw/guides/deployment-strategy.md +448 -0
  153. package/raw/guides/evals-framework.md +452 -0
  154. package/raw/guides/mcp-tools.md +335 -0
  155. package/raw/guides/task-spec.md +79 -0
  156. package/raw/guides/type-checking-templates/README.md +112 -0
  157. package/raw/guides/type-checking-templates/eslint/eslint.config.ts +105 -0
  158. package/raw/guides/type-checking-templates/python/mypy.ini +69 -0
  159. package/raw/guides/type-checking-templates/python/pyproject.toml +164 -0
  160. package/raw/guides/type-checking-templates/python/pyrightconfig.json +67 -0
  161. package/raw/guides/type-checking-templates/tsconfig/tsconfig.app.jsonc +45 -0
  162. package/raw/guides/type-checking-templates/tsconfig/tsconfig.lib.jsonc +44 -0
  163. package/raw/guides/type-checking-templates/tsconfig/tsconfig.node-esm.jsonc +40 -0
  164. package/raw/guides/type-checking-templates/tsconfig/tsconfig.node.jsonc +34 -0
  165. package/raw/guides/type-checking-templates/tsconfig/tsconfig.vite-root.json +8 -0
  166. package/raw/harness-notes.md +20 -0
  167. package/raw/house-style/components/Badge.tsx +16 -0
  168. package/raw/house-style/components/Button.tsx +32 -0
  169. package/raw/house-style/components/Card.tsx +26 -0
  170. package/raw/house-style/components/Chip.tsx +57 -0
  171. package/raw/house-style/components/IconButton.tsx +67 -0
  172. package/raw/house-style/components/Modal.tsx +18 -0
  173. package/raw/house-style/components/Stepper.tsx +141 -0
  174. package/raw/house-style/components/icons.tsx +128 -0
  175. package/raw/house-style/preview/src/index.css +46 -0
  176. package/raw/house-style/tokens/tailwind.preset.ts +49 -0
  177. package/raw/house-style/tokens/tokens.json +62 -0
  178. package/raw/llm-wiki-2.md +162 -0
  179. package/raw/llm-wiki.md +75 -0
  180. package/raw/research/dark-mode-theme/index.md +85 -0
  181. package/raw/research/dark-mode-theme/sources.md +49 -0
  182. package/raw/research/serena-mcp-disconnect/index.md +81 -0
  183. package/raw/research/serena-mcp-disconnect/sources.md +87 -0
  184. package/raw/research/wiki-tooling-improvements/index.md +126 -0
  185. package/raw/research/wiki-tooling-improvements/sources.md +73 -0
  186. 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,8 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/tsconfig",
3
+ "files": [],
4
+ "references": [
5
+ { "path": "./tsconfig.app.json" },
6
+ { "path": "./tsconfig.node.json" }
7
+ ]
8
+ }
@@ -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
+ }