naive-framework 0.0.0-stage → 0.1.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/publication-policy.schema.json

@@ -0,0 +1,293 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "publication-policy.schema.json",
+  "title": "Publication policy",
+  "description": "Where a venture publishes and who may publish what there, at <venture>/governance/publication-policy.json (EE-025). Every publication passes the gate: it runs as a handoff under the public-commitment decision class, names its channel, passes the channel's checks and preview, and is approved by a person. Agents may draft and check; they never approve.",
+  "type": "object",
+  "required": [
+    "venture",
+    "channels"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "venture": {
+      "type": "string"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date"
+    },
+    "note": {
+      "type": "string"
+    },
+    "teams": {
+      "type": "array",
+      "description": "Groups that draft or approve, such as a marketing team or a governance team. Members are role ids from the role registry.",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "members"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "pillar": {
+            "enum": [
+              "product",
+              "brand",
+              "business"
+            ]
+          },
+          "members": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "guidelines": {
+      "type": "array",
+      "description": "The rules a publication must follow: the venture's own (brand guidelines, editorial guidelines) and outside ones (a platform's rules, advertising or disclosure law).",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "title",
+          "kind"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "brand",
+              "editorial",
+              "legal",
+              "platform",
+              "disclosure",
+              "security",
+              "other"
+            ]
+          },
+          "owner": {
+            "type": "string",
+            "description": "Pillar or role that keeps it"
+          },
+          "path": {
+            "type": "string",
+            "description": "Relative to the venture folder"
+          },
+          "url": {
+            "type": "string"
+          },
+          "checked": {
+            "type": "string",
+            "format": "date",
+            "description": "When an outside guideline's URL was last checked"
+          }
+        }
+      }
+    },
+    "channels": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "name",
+          "kind",
+          "destination",
+          "rules",
+          "checks",
+          "preview"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "kind": {
+            "enum": [
+              "website",
+              "docs-site",
+              "blog",
+              "social",
+              "newsletter",
+              "email",
+              "app-store",
+              "press",
+              "investor-update",
+              "regulatory-filing",
+              "open-source-repository",
+              "other"
+            ]
+          },
+          "destination": {
+            "type": "string",
+            "description": "Where it lands: a URL, an account, a repository or a recipient list"
+          },
+          "audience": {
+            "type": "string"
+          },
+          "guidelines": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Guideline ids that apply here"
+          },
+          "rules": {
+            "type": "array",
+            "minItems": 1,
+            "description": "Who may publish what on this channel",
+            "items": {
+              "type": "object",
+              "required": [
+                "content",
+                "approvers"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "content": {
+                  "type": "string",
+                  "description": "The kind of content, e.g. methodology pages, release notes, a funding announcement"
+                },
+                "from_layers": {
+                  "type": "array",
+                  "items": {
+                    "enum": [
+                      "purpose",
+                      "knowledge",
+                      "operations",
+                      "evidence",
+                      "governance",
+                      "interface"
+                    ]
+                  },
+                  "description": "The layers whose records it may publish"
+                },
+                "drafters": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Role or team ids; agents may draft"
+                },
+                "approvers": {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Role or team ids; at least one is a person, and no agent approves"
+                }
+              }
+            }
+          },
+          "checks": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": [
+                "id",
+                "check"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "check": {
+                  "type": "string",
+                  "description": "A command run from the repository root; for a review, what the reviewer checks"
+                },
+                "kind": {
+                  "enum": [
+                    "conformance",
+                    "review"
+                  ]
+                }
+              }
+            }
+          },
+          "preview": {
+            "type": "string",
+            "description": "How to see exactly what would go out before it does, e.g. a dry run"
+          },
+          "config": {
+            "type": "string",
+            "description": "The channel's tool configuration, relative to the venture folder (e.g. the publisher's allowlist)"
+          },
+          "platform": {
+            "enum": [
+              "substack",
+              "medium",
+              "x",
+              "facebook",
+              "instagram",
+              "threads",
+              "linkedin",
+              "youtube",
+              "tiktok",
+              "reddit",
+              "bluesky",
+              "mastodon",
+              "discord",
+              "app-store",
+              "google-play",
+              "github",
+              "other"
+            ],
+            "description": "The third-party platform the channel runs on, if any. A channel on a platform cites that platform's rules (a guideline of kind platform)"
+          },
+          "replies": {
+            "type": "object",
+            "required": [
+              "mode"
+            ],
+            "additionalProperties": false,
+            "description": "Required on social, newsletter and blog channels: replies, comments and direct messages speak for the venture in public. gated means each reply passes the gate like any publication; delegated means named people may reply within the guidelines without a handoff each time; none means the venture does not reply there",
+            "properties": {
+              "mode": {
+                "enum": [
+                  "gated",
+                  "delegated",
+                  "none"
+                ]
+              },
+              "delegates": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Role or team ids, when delegated; each must include a person"
+              },
+              "note": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schema/raw-source.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "raw-source.schema.json",
+  "title": "Raw source",
+  "description": "Where a founder-supplied source came from, at raw/sources/<id>/source.json (EE-070). text.md is the text. original.* stays out of git. Raw is immutable.",
+  "type": "object",
+  "required": ["id", "origin"],
+  "additionalProperties": false,
+  "properties": {
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+    "origin": { "type": "string", "description": "Where this source came from: a url, a person, or a note such as founder-supplied" },
+    "title": { "type": "string" },
+    "fetched": { "type": "string", "format": "date" }
+  }
+}