naive-framework 0.1.0 → 0.3.0

package/schema/venture-types.json

@@ -0,0 +1,346 @@
+{
+  "version": "0.1.0",
+  "note": "Venture types create-venture scaffolds (EE-082). The type decides the starting packages, first decisions, imported functions and the roles a person can hold. Start from a list, or describe the venture and let a model choose.",
+  "types": [
+    {
+      "id": "software-startup",
+      "label": "Software startup",
+      "description": "A company building a software product: an app, a SaaS, a developer tool or an AI product.",
+      "examples": [
+        "SaaS",
+        "app",
+        "startup",
+        "developer tool",
+        "AI product",
+        "platform",
+        "marketplace"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor",
+        "board-member"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "products",
+        "marketing-and-sales",
+        "customer-service",
+        "human-capital",
+        "it",
+        "finance"
+      ],
+      "packages": [
+        "foundation",
+        "validation",
+        "product",
+        "marketing",
+        "finance",
+        "people",
+        "customers",
+        "investors",
+        "money"
+      ],
+      "decisions": "product-foundation"
+    },
+    {
+      "id": "vc-fund",
+      "label": "VC fund or firm",
+      "description": "An investment fund or firm that raises from limited partners and invests in companies: a thesis, fund terms, a deal pipeline and a portfolio.",
+      "examples": [
+        "venture fund",
+        "VC firm",
+        "angel syndicate",
+        "seed fund",
+        "micro VC",
+        "rolling fund",
+        "investment firm"
+      ],
+      "roles": [
+        "general-partner",
+        "limited-partner",
+        "operator",
+        "advisor",
+        "board-member"
+      ],
+      "default_role": "general-partner",
+      "departments": [
+        "strategy",
+        "finance",
+        "external-relationships",
+        "risk-and-compliance",
+        "human-capital"
+      ],
+      "packages": [
+        "foundation",
+        "fund",
+        "deals",
+        "portfolio",
+        "investors",
+        "people",
+        "finance",
+        "money"
+      ],
+      "decisions": "fund-foundation",
+      "funding": "mixed",
+      "layers": [
+        "purpose",
+        "knowledge",
+        "governance"
+      ]
+    },
+    {
+      "id": "services-business",
+      "label": "Services business",
+      "description": "A business selling expertise or labor: an agency, consultancy, studio or freelance practice.",
+      "examples": [
+        "agency",
+        "consultancy",
+        "studio",
+        "freelance",
+        "professional services"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "service-delivery",
+        "marketing-and-sales",
+        "customer-service",
+        "finance"
+      ],
+      "packages": [
+        "foundation",
+        "validation",
+        "product",
+        "marketing",
+        "finance",
+        "people",
+        "customers",
+        "money"
+      ],
+      "decisions": "product-foundation"
+    },
+    {
+      "id": "local-business",
+      "label": "Local business",
+      "description": "A business serving customers in one place: a cafe, a shop, a clinic, a gym or a trade.",
+      "examples": [
+        "cafe",
+        "restaurant",
+        "shop",
+        "clinic",
+        "gym",
+        "salon",
+        "trade"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "service-delivery",
+        "marketing-and-sales",
+        "customer-service",
+        "supply-chain",
+        "finance",
+        "assets"
+      ],
+      "packages": [
+        "foundation",
+        "validation",
+        "product",
+        "marketing",
+        "finance",
+        "people",
+        "customers",
+        "money"
+      ],
+      "decisions": "product-foundation"
+    },
+    {
+      "id": "ecommerce",
+      "label": "E-commerce or physical product",
+      "description": "A business making or selling physical goods, online or wholesale.",
+      "examples": [
+        "e-commerce",
+        "online store",
+        "DTC brand",
+        "hardware",
+        "consumer product"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor",
+        "board-member"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "products",
+        "marketing-and-sales",
+        "supply-chain",
+        "customer-service",
+        "finance"
+      ],
+      "packages": [
+        "foundation",
+        "validation",
+        "product",
+        "marketing",
+        "finance",
+        "people",
+        "customers",
+        "investors",
+        "money"
+      ],
+      "decisions": "product-foundation"
+    },
+    {
+      "id": "creator-media",
+      "label": "Creator or media",
+      "description": "A venture built on content and an audience: a newsletter, channel, podcast or publication.",
+      "examples": [
+        "newsletter",
+        "YouTube channel",
+        "podcast",
+        "publication",
+        "creator"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "products",
+        "marketing-and-sales",
+        "finance"
+      ],
+      "packages": [
+        "foundation",
+        "validation",
+        "product",
+        "marketing",
+        "finance",
+        "people",
+        "customers",
+        "money"
+      ],
+      "decisions": "product-foundation"
+    },
+    {
+      "id": "nonprofit",
+      "label": "Nonprofit",
+      "description": "A mission-driven organization funded by donations and grants rather than profit.",
+      "examples": [
+        "nonprofit",
+        "charity",
+        "foundation",
+        "NGO",
+        "community organization"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor",
+        "board-member"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "service-delivery",
+        "external-relationships",
+        "finance",
+        "risk-and-compliance"
+      ],
+      "packages": [
+        "foundation",
+        "validation",
+        "product",
+        "marketing",
+        "finance",
+        "people",
+        "money"
+      ],
+      "decisions": "product-foundation",
+      "funding": "grant"
+    },
+    {
+      "id": "holding-company",
+      "label": "Holding company",
+      "description": "A company that owns and governs other ventures; each one it holds is a nested venture.",
+      "examples": [
+        "holding company",
+        "venture studio",
+        "parent company",
+        "portfolio of businesses"
+      ],
+      "roles": [
+        "founder",
+        "co-founder",
+        "operator",
+        "advisor",
+        "board-member"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "finance",
+        "risk-and-compliance",
+        "human-capital"
+      ],
+      "packages": [
+        "foundation",
+        "portfolio",
+        "finance",
+        "people",
+        "investors",
+        "money"
+      ],
+      "decisions": "none"
+    },
+    {
+      "id": "side-project",
+      "label": "Side project",
+      "description": "Something you build for its own sake, with no plan to make it a business yet.",
+      "examples": [
+        "side project",
+        "hobby",
+        "experiment",
+        "open source project"
+      ],
+      "roles": [
+        "founder",
+        "co-founder"
+      ],
+      "default_role": "founder",
+      "departments": [
+        "strategy",
+        "products"
+      ],
+      "packages": [
+        "foundation",
+        "product"
+      ],
+      "decisions": "product-foundation"
+    }
+  ]
+}

package/schema/venture-types.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "venture-types.schema.json",
+  "title": "Venture types",
+  "description": "The kinds of venture create-venture scaffolds (schema/venture-types.json). A venture's type decides its starting packages, its first decisions, the functions it imports and the roles a person can hold in it. venture.json names its type.",
+  "type": "object",
+  "required": [
+    "version",
+    "types"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "version": {
+      "type": "string"
+    },
+    "note": {
+      "type": "string"
+    },
+    "types": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "label",
+          "description",
+          "examples",
+          "roles",
+          "default_role",
+          "departments",
+          "packages",
+          "decisions"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "label": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "examples": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Words a founder might use for it; the classifier reads them"
+          },
+          "roles": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            },
+            "description": "Role ids from governance/venture-template/roles/venture-roles.json a person can hold in this type"
+          },
+          "default_role": {
+            "type": "string"
+          },
+          "departments": {
+            "type": "array",
+            "items": {
+              "enum": [
+                "strategy",
+                "products",
+                "marketing-and-sales",
+                "supply-chain",
+                "service-delivery",
+                "customer-service",
+                "human-capital",
+                "it",
+                "finance",
+                "assets",
+                "risk-and-compliance",
+                "external-relationships",
+                "capabilities"
+              ]
+            },
+            "description": "Functions the type imports from the start (operations/departments.json); a solo founder owns them all"
+          },
+          "packages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Package directories created at the venture root"
+          },
+          "decisions": {
+            "enum": [
+              "product-foundation",
+              "fund-foundation",
+              "none"
+            ],
+            "description": "The first questions the venture answers, written as open decisions by the scaffold"
+          },
+          "funding": {
+            "enum": [
+              "bootstrapped",
+              "grant",
+              "angel",
+              "venture-capital",
+              "debt",
+              "mixed"
+            ]
+          },
+          "layers": {
+            "type": "array",
+            "items": {
+              "enum": [
+                "purpose",
+                "knowledge",
+                "operations",
+                "evidence",
+                "governance",
+                "interface"
+              ]
+            },
+            "description": "Layers on from the start, when the phase's defaults would leave a layer the type needs off"
+          }
+        }
+      }
+    }
+  }
+}

package/schema/venture.schema.json

@@ -29,6 +29,36 @@
       "default": "venture",
       "description": "venture: building a venture, whose root and strategic foundation fail closed. product: a product without a venture, which fails open (EE-054)."
     },
+    "type": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "The venture type, an id from schema/venture-types.json: what kind of venture this is (a software startup, a VC fund), which decides its starting packages, first decisions, functions and roles (EE-082)"
+    },
+    "layout": {
+      "enum": [
+        "flat",
+        "structured"
+      ],
+      "default": "flat",
+      "description": "Where the venture's files sit (EE-086). structured: venture.json, README.md and AGENTS.md at the top, the knowledge base in knowledge/, sources.json, naive.config.json, the provenance log and releases in meta/, and code in an optional repo/. flat: every venture made before EE-086, with packages at the top."
+    },
+    "functions": {
+      "type": "object",
+      "description": "The venture's functions and their one accountable owner each (EE-071), keyed by function id from operations/departments.json. A solo founder owns them all, which is what the manifest assumes when this is left out.",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "owner"
+        ],
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "A role or a person's name; no personal details"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
     "parent": {
       "type": [
         "string",
@@ -145,6 +175,37 @@
       },
       "uniqueItems": true
     },
+    "packages": {
+      "type": "array",
+      "description": "The Naive packages this venture uses, by name from packages/ (EE-071), the way package.json lists dependencies (Next.js translation P-3). Left out, the manifest derives them: the core packages that fit the phase now plus any package holding records. Checked by schema/structure.mjs.",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "uniqueItems": true
+    },
+    "kits": {
+      "type": "array",
+      "description": "The Mentura kits this venture uses (EE-071). Each names the one package it extends, which the venture must use; the kit itself lives on the platform.",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "extends"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "extends": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
     "brand": {
       "type": "object",
       "description": "The venture's verbal brand elements, owned by the brand pillar. Visual identity (tokens, logos) is a separate record.",

package/schema/workspace.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "workspace.schema.json",
   "title": "Workspace",
-  "description": "A builder's workspace: one instance of the system. A workspace.json at its top says which schema version it follows, where its vault is and where its repositories are (EE-002, EE-011, EE-020). A workspace always has a vault; it has a code folder of repositories once any venture builds software.",
+  "description": "A builder's workspace: one instance of the system. A naive-workspace.json (earlier workspace.json) at its top says which schema version it follows, where its vault is and where its repositories are (EE-002, EE-011, EE-020). A workspace always has a vault; it has a code folder of repositories once any venture builds software.",
   "type": "object",
   "required": [
     "schema",
@@ -18,6 +18,10 @@
       "pattern": "^\\d+\\.\\d+\\.\\d+$",
       "description": "The version in schema/VERSION that this workspace follows"
     },
+    "name": {
+      "type": "string",
+      "description": "The workspace's name, shown to the founder. create-venture names a new workspace \"Naive workspace\"; the founder can rename it"
+    },
     "ventures": {
       "type": "array",
       "items": {