dotdog 0.1.0 → 0.1.1
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/README.md +76 -0
- package/package.json +13 -5
package/README.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# spec-platform
|
|
2
|
+
|
|
3
|
+
Monorepo for the Spec Platform — a knowledge graph system where specs ARE the database and LLMs ARE the query engine.
|
|
4
|
+
|
|
5
|
+
## The Flywheel
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
spec → validate → app → data → better spec → better app → ...
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
The spec describes the platform. The platform validates the spec. The validation report improves the spec. Each cycle adds granularity.
|
|
12
|
+
|
|
13
|
+
## Structure
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
spec-platform/
|
|
17
|
+
├── packages/
|
|
18
|
+
│ ├── spec-engine/ # Core types and ontology (shared by everything)
|
|
19
|
+
│ ├── spec-mcp/ # MCP Server — AI agents query specs via stdio
|
|
20
|
+
│ └── spec-cli/ # CLI — spec validate, init, simulate, list
|
|
21
|
+
├── projects/ # Spec genomes (dogfooding)
|
|
22
|
+
│ └── spec-platform/
|
|
23
|
+
│ └── specs/
|
|
24
|
+
│ ├── SPEC.dog # Product spec — screens, flows, stories
|
|
25
|
+
│ ├── constitution.dog # Immutable rules
|
|
26
|
+
│ └── data-model.dog # Graph ontology — nodes, edges, tasks, predictions, vectors
|
|
27
|
+
├── templates/ # Spec genome templates for new projects
|
|
28
|
+
└── package.json # Bun workspace root
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Quick Start
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
bun install
|
|
35
|
+
cd projects/spec-platform/specs
|
|
36
|
+
|
|
37
|
+
# Validate our own spec (dogfood)
|
|
38
|
+
bun ../../../packages/spec-cli/src/index.ts validate ../..
|
|
39
|
+
|
|
40
|
+
# List projects
|
|
41
|
+
bun ../../../packages/spec-cli/src/index.ts list
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## $0 Stack
|
|
45
|
+
|
|
46
|
+
| Component | Technology | Cost |
|
|
47
|
+
|-----------|-----------|------|
|
|
48
|
+
| Runtime | Bun | $0 |
|
|
49
|
+
| Database | bun:sqlite (embedded) | $0 |
|
|
50
|
+
| Types | TypeScript (strict) | $0 |
|
|
51
|
+
| CLI | Commander.js + chalk | $0 |
|
|
52
|
+
| MCP Server | @modelcontextprotocol/sdk (stdio) | $0 |
|
|
53
|
+
| Embeddings | all-MiniLM-L6-v2 (local) | $0 |
|
|
54
|
+
| Hosting | None needed (local-first) | $0 |
|
|
55
|
+
|
|
56
|
+
## The Spec Graph
|
|
57
|
+
|
|
58
|
+
The spec is not a document. It's a knowledge graph.
|
|
59
|
+
|
|
60
|
+
- **Nodes**: entities, tasks, predictions, screens, constraints, user stories
|
|
61
|
+
- **Edges**: contains, depends_on, implements, references, calls, precedes
|
|
62
|
+
- **Vectors**: every section embedded for semantic search, contradiction detection, staleness checks
|
|
63
|
+
- **Predictions**: forecasts with triggers, timeframes, confidence, and actual outcome tracking
|
|
64
|
+
|
|
65
|
+
LLMs traverse the graph at query time. They don't read prose and guess — they get exact typed values.
|
|
66
|
+
|
|
67
|
+
## Score
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
spec validate → 43% complete
|
|
71
|
+
|
|
72
|
+
✓ SPEC.dog
|
|
73
|
+
✓ constitution.dog
|
|
74
|
+
✓ data-model.dog
|
|
75
|
+
⚠ COPY.dog, DESIGN-SYSTEM.dog, plan.dog, INDEX.dog
|
|
76
|
+
```
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dotdog",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "The spec dog
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "The spec dog \u2014 validate, analyze, parse, and generate .dog spec genome files",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/cli.js",
|
|
7
7
|
"bin": {
|
|
@@ -10,11 +10,19 @@
|
|
|
10
10
|
},
|
|
11
11
|
"files": [
|
|
12
12
|
"dist/",
|
|
13
|
-
"LICENSE",
|
|
14
13
|
"README.md",
|
|
15
|
-
"CHANGELOG.md"
|
|
14
|
+
"CHANGELOG.md",
|
|
15
|
+
"LICENSE"
|
|
16
|
+
],
|
|
17
|
+
"keywords": [
|
|
18
|
+
"spec",
|
|
19
|
+
"dogfood",
|
|
20
|
+
"specification",
|
|
21
|
+
"ai",
|
|
22
|
+
"documentation",
|
|
23
|
+
"dotdog",
|
|
24
|
+
"dog"
|
|
16
25
|
],
|
|
17
|
-
"keywords": ["spec", "dogfood", "specification", "ai", "documentation", "dotdog", "dog"],
|
|
18
26
|
"license": "MIT",
|
|
19
27
|
"author": "specdog",
|
|
20
28
|
"repository": "github:specdog/spec",
|