naive-framework 0.0.0-stage → 0.2.0

package/schema/product.schema.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "product.schema.json",
+  "title": "Product",
+  "description": "One product of a venture, stored as a card at products/<id>.json (EE-011). It holds the product's own market, job, technology, offering and business model; Product Anatomy judges it against the venture's core and assigns its portfolio role per phase.",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "description"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "market": {
+      "description": "Who is served (Abell: customer groups). One market, or several with one marked primary.",
+      "oneOf": [
+        {
+          "type": "object",
+          "description": "Who is served (Abell: customer groups).",
+          "properties": {
+            "customer": {
+              "enum": [
+                "b2c",
+                "b2b",
+                "b2g",
+                "b2b2c"
+              ]
+            },
+            "relationship": {
+              "enum": [
+                "customer",
+                "client",
+                "user",
+                "member",
+                "audience",
+                "partner"
+              ],
+              "description": "How the people in this market stand to the product (EE-021): customer buys, client is served under a professional relationship, user uses (may not pay), member belongs, audience reads, watches or listens, partner works with the venture"
+            },
+            "segment": {
+              "type": "string"
+            },
+            "geography": {
+              "type": "string"
+            },
+            "vertical": {
+              "type": "boolean",
+              "description": "true: one industry; false: across many (horizontal)"
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "array",
+          "minItems": 2,
+          "items": {
+            "type": "object",
+            "description": "Who is served (Abell: customer groups).",
+            "properties": {
+              "customer": {
+                "enum": [
+                  "b2c",
+                  "b2b",
+                  "b2g",
+                  "b2b2c"
+                ]
+              },
+              "segment": {
+                "type": "string"
+              },
+              "geography": {
+                "type": "string"
+              },
+              "vertical": {
+                "type": "boolean",
+                "description": "true: one industry; false: across many (horizontal)"
+              },
+              "primary": {
+                "type": "boolean",
+                "description": "The market the product is mainly built for; exactly one when several are listed"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      ]
+    },
+    "job": {
+      "type": "string",
+      "description": "The need it meets (Abell: customer function; jobs to be done)"
+    },
+    "technology": {
+      "type": "string",
+      "description": "How it meets the need (Abell: alternative technologies)"
+    },
+    "ai": {
+      "enum": [
+        "none",
+        "feature",
+        "ai-harness",
+        "agent-harness"
+      ],
+      "description": "What AI is to the product. feature: the product works without the model. ai-harness: the product is the software around a model (a chatbot); remove the model and nothing is left. agent-harness: an AI harness where the model directs its own steps and tool use toward a goal. Tests in docs/ontology.md."
+    },
+    "offering": {
+      "enum": [
+        "product",
+        "service",
+        "platform",
+        "content",
+        "marketplace"
+      ]
+    },
+    "scope": {
+      "type": "object",
+      "description": "Where in the system the product works: the whole system, one layer, or one tier of the operations layer. Kits use it most (a knowledge-layer kit, a delivery-tier kit).",
+      "required": [
+        "level"
+      ],
+      "properties": {
+        "level": {
+          "enum": [
+            "system",
+            "layer",
+            "tier"
+          ]
+        },
+        "layer": {
+          "enum": [
+            "purpose",
+            "knowledge",
+            "operations",
+            "evidence",
+            "governance",
+            "interface"
+          ]
+        },
+        "tier": {
+          "enum": [
+            "governance",
+            "delivery",
+            "software-engineering",
+            "automation"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "part_of": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "description": "Kits this product is bundled into, by product id in the same venture. A part can still be its own product with its own market and portfolio role."
+    },
+    "business_model": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "description": "Pattern ids from schema/vocab/business-models.json: the St. Gallen Business Model Navigator's 55 (subscription, freemium, add-on and so on) plus named extras such as open-core"
+    },
+    "allowed_from": {
+      "enum": [
+        "validation",
+        "beachhead",
+        "scale",
+        "platform"
+      ],
+      "description": "The first phase in which it may lead (a standing decision can hold a product back)"
+    },
+    "flows_to": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Products this one sends users, data or revenue to; Product Anatomy computes spillover from these"
+    },
+    "status": {
+      "enum": [
+        "idea",
+        "building",
+        "live",
+        "retired"
+      ]
+    },
+    "software": {
+      "type": "boolean",
+      "description": "The product is, or contains, software the venture builds. Such a product needs a repository, so its venture (or a parent) lists one in repos (EE-020)"
+    },
+    "repo": {
+      "type": "string",
+      "description": "The id of the repository in the venture's (or a parent's) repos that holds its code"
+    },
+    "offered_to": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "The ICP profiles (purpose/icp.json ids) the product is offered to: who buys or adopts it, and so whom its marketing addresses first (EE-064). In a B2B2C or partner-led venture these are the partners, not the partners' customers."
+    },
+    "serves": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "ICP profiles the product ultimately serves through those it is offered to, such as a partner's own customers (EE-064)"
+    }
+  },
+  "additionalProperties": false
+}

package/schema/provenance-entry.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "provenance-entry.schema.json",
+  "title": "Provenance entry",
+  "description": "One line of a venture's provenance log (<venture>/provenance.jsonl, EE-031), after W3C PROV: the entity (a record file) was generated by an activity, attributed to an agent (a person or an AI agent), derived from other entities, under a decision. The log is append-only: each line carries the hash of the line before, so an edited or deleted line breaks the chain. Git history is the implicit provenance for anything written outside the log. schema/check-provenance.mjs checks it.",
+  "type": "object",
+  "required": [
+    "at",
+    "entity",
+    "activity",
+    "agent",
+    "sha256",
+    "prev",
+    "hash"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the activity ended (prov:endedAtTime)"
+    },
+    "entity": {
+      "type": "string",
+      "pattern": "^(?!/)(?!.*\\.\\./).+$",
+      "description": "The file written, relative to the venture folder (prov:Entity); for a record kept in another source (EE-037), its address <source>://<path>"
+    },
+    "route": {
+      "type": "string",
+      "description": "The route the write went through, when it went through the router"
+    },
+    "activity": {
+      "enum": [
+        "write",
+        "draft",
+        "accept",
+        "baseline",
+        "confirm",
+        "move",
+        "release"
+      ],
+      "description": "write: written in place. draft: an agent's write to a gated record, held in _drafts/, or any write to a source that takes writes by pull request, held there until the pull request is merged. accept: a person accepted a draft. baseline: a record that existed before the log, adopted with its current content (prov:Activity). confirm: a person confirmed one guiding statement in the record, by typing its id (EE-051); the content is unchanged. move: a file moved to a new path; derived_from names the old path. release: a set of moves recorded as one release"
+    },
+    "agent": {
+      "type": "object",
+      "required": [
+        "kind",
+        "via"
+      ],
+      "additionalProperties": false,
+      "description": "Who acted (prov:wasAttributedTo / prov:wasAssociatedWith)",
+      "properties": {
+        "kind": {
+          "enum": [
+            "person",
+            "agent"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "description": "A person's name or handle, or an agent's role id from the team plan"
+        },
+        "model": {
+          "type": "string",
+          "description": "An AI agent's model"
+        },
+        "session": {
+          "type": "string",
+          "description": "A link or id for the session that acted"
+        },
+        "harness": {
+          "type": "string",
+          "description": "The agent harness, such as Claude Code or Cursor, as it named itself"
+        },
+        "via": {
+          "enum": [
+            "cli",
+            "mcp",
+            "api",
+            "router"
+          ],
+          "description": "The interface the write came through"
+        }
+      }
+    },
+    "derived_from": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "What the content came from: venture-relative paths, URLs or decision ids (prov:wasDerivedFrom)"
+    },
+    "decision": {
+      "type": "string",
+      "description": "The decision or decision class the activity acted under, such as EE-026 or ownership-or-control"
+    },
+    "note": {
+      "type": "string"
+    },
+    "source": {
+      "type": "object",
+      "required": [
+        "id",
+        "connector",
+        "version"
+      ],
+      "additionalProperties": false,
+      "description": "For a record kept outside the venture folder (EE-037): the source it was written to, its version there, and the commit or pull request that holds it",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "The source id from the venture's knowledge/sources.json"
+        },
+        "connector": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$",
+          "description": "The git blob SHA-1 of the content as written"
+        },
+        "commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        },
+        "pull_request": {
+          "type": "string",
+          "format": "uri",
+          "description": "The pull request that accepts the write when it is merged"
+        }
+      }
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$",
+      "description": "Hash of the file's content as written"
+    },
+    "prev": {
+      "type": "string",
+      "pattern": "^([0-9a-f]{64}|genesis)$",
+      "description": "The previous line's hash, or genesis for the first line"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$",
+      "description": "sha256 of prev followed by this line without its hash field, as JSON with sorted keys"
+    },
+    "statement": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "confirm only: the id of the guiding statement confirmed (purpose/guiding-statements.json)"
+    }
+  }
+}

package/schema/public-assets.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "public-assets.schema.json",
+  "title": "Public assets",
+  "description": "The register of what the venture ships as it is, at public/assets.json (I-23, J-2, J-3, J-4): each file in public/ with its source, license and credit, facts read by code from its bytes, and alt text with who wrote it; remote images as links with a note in raw/sources/<id>/; and remote_hosts, the hosts an agent may fetch from. Checked by schema/check-assets.mjs. Version 0.x, unevaluated.",
+  "type": "object",
+  "required": ["version", "assets"],
+  "additionalProperties": false,
+  "$defs": {
+    "alt": {
+      "type": "object",
+      "required": ["text", "by"],
+      "additionalProperties": false,
+      "properties": {
+        "text": { "type": "string", "minLength": 1 },
+        "by": { "enum": ["agent", "person"], "description": "Who wrote it. An agent's alt text stays pending until a person confirms it in provenance" }
+      }
+    },
+    "facts": {
+      "type": "object",
+      "required": ["type", "bytes", "sha256"],
+      "additionalProperties": false,
+      "description": "Read from the bytes by code (schema/assets.mjs), never written by hand",
+      "properties": {
+        "type": { "type": "string" },
+        "width": { "type": "integer" },
+        "height": { "type": "integer" },
+        "sizes": { "type": "array", "items": { "type": "string" } },
+        "bytes": { "type": "integer" },
+        "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "filled_at": { "type": "string" }
+      }
+    }
+  },
+  "properties": {
+    "version": { "type": "string" },
+    "remote_hosts": { "type": "array", "items": { "type": "string" }, "description": "Hosts an agent may fetch images from (exact, or *.example.com); the platform fetcher refuses any other" },
+    "assets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "source", "license"],
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string", "pattern": "^public/(?!.*\\.\\./).+" },
+          "source": { "type": "string", "description": "Where it came from: who made it, or a URL" },
+          "license": { "type": "string", "description": "An SPDX id (CC-BY-4.0, OFL-1.1), owned (made by or for the venture), licensed (bought), or the restriction (all-rights-reserved)" },
+          "credit": { "type": "string", "description": "Who to credit; a missing credit fails the check" },
+          "alt": { "$ref": "#/$defs/alt" },
+          "decorative": { "type": "boolean", "description": "An image that says nothing, so it needs no alt text" },
+          "origin_url": { "type": "string", "description": "The remote work this is a copy of" },
+          "design_system": { "type": "string", "description": "The design system (brand design_systems id) this came from" },
+          "facts": { "$ref": "#/$defs/facts" }
+        }
+      }
+    },
+    "remote": {
+      "type": "array",
+      "description": "Remote images the venture links to rather than ships",
+      "items": {
+        "type": "object",
+        "required": ["id", "url", "license"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$", "description": "The raw source holding the note: raw/sources/<id>/" },
+          "url": { "type": "string" },
+          "license": { "type": "string" },
+          "credit": { "type": "string" },
+          "alt": { "$ref": "#/$defs/alt" },
+          "fetched": { "$ref": "#/$defs/facts", "description": "Facts from a fetch by the platform; the original stays private in raw/sources/<id>/original.*" },
+          "copy": { "type": "string", "pattern": "^public/", "description": "Where a full copy was kept, only when the license allows it" }
+        }
+      }
+    }
+  }
+}