nikos 0.0.7 → 0.1.1

package/dist/commands/bet.js

@@ -1,97 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { Document, parse } from "yaml";
-import { STORY_ID, findIntentDir, read } from "../lib/project.js";
-export const BET_ID = /^[a-z0-9]+(-[a-z0-9]+)*$/;
-/** Story ids in any release of storymap.yaml, or undefined if there is no story map. */
-function mapStories(intentDir) {
-    const path = join(intentDir, "storymap.yaml");
-    if (!existsSync(path))
-        return undefined;
-    const map = parse(read(path));
-    return new Set((map?.releases ?? []).flatMap((r) => r?.stories ?? []));
-}
-/** Split a bet card into its front matter and body. */
-export function parseBet(text) {
-    const m = /^---\n([\s\S]*?)\n---\n?/.exec(text);
-    if (!m)
-        return undefined;
-    return { meta: parse(m[1]), body: text.slice(m[0].length) };
-}
-/** Write intent/bets/<id>.md with every field filled in, linked to stories that exist. */
-export function newBet(input, dir) {
-    if (!BET_ID.test(input.id))
-        throw new Error(`'${input.id}' is not a bet id (lowercase words joined by hyphens, e.g. faster-payment)`);
-    const fields = [
-        ["hypothesis", input.hypothesis],
-        ["key result (--kr)", input.keyResult],
-        ["expected uplift (--uplift)", input.expectedUplift],
-    ];
-    for (const [name, value] of fields)
-        if (!value?.trim())
-            throw new Error(`A bet needs a ${name}`);
-    if (!/^\d{4}-\d{2}-\d{2}$/.test(input.timeBox ?? ""))
-        throw new Error("A bet needs a time box end date (--time-box YYYY-MM-DD)");
-    if (!input.stories.length)
-        throw new Error("A bet needs at least one story (--story <id>)");
-    const bad = input.stories.filter((s) => !STORY_ID.test(s));
-    if (bad.length)
-        throw new Error(`Not story ids: ${bad.join(", ")} (expected e.g. HT-1)`);
-    const intentDir = findIntentDir(dir);
-    const known = mapStories(intentDir);
-    const unknown = known ? input.stories.filter((s) => !known.has(s)) : [];
-    if (unknown.length)
-        throw new Error(`Not in storymap.yaml: ${unknown.join(", ")}`);
-    const meta = {
-        id: input.id,
-        hypothesis: input.hypothesis.trim(),
-        key_result: input.keyResult.trim(),
-        expected_uplift: input.expectedUplift.trim(),
-        time_box: input.timeBox,
-        blockers: input.blockers ?? [],
-        stories: [...new Set(input.stories)],
-        status: "open",
-    };
-    const body = "\n## Why we think so\nThe evidence behind the hypothesis.\n\n## Outcome\nFilled in when the time box ends: the key result as measured, and won, lost or killed.\n";
-    const path = join(intentDir, "bets", `${input.id}.md`);
-    mkdirSync(dirname(path), { recursive: true });
-    // "wx" fails if the file exists, so an existing bet is never overwritten.
-    try {
-        const doc = new Document(meta);
-        for (const key of ["blockers", "stories"])
-            doc.get(key, true).flow = true;
-        writeFileSync(path, `---\n${doc.toString({ flowCollectionPadding: false, lineWidth: 0 })}---\n${body}`, { flag: "wx" });
-    }
-    catch (err) {
-        if (err.code === "EEXIST")
-            throw new Error(`A bet called '${input.id}' already exists`);
-        throw err;
-    }
-    return path;
-}
-export function runBet(args) {
-    const [sub, id, ...rest] = args;
-    const all = (n) => rest.flatMap((a, i) => (a === `--${n}` && rest[i + 1] !== undefined ? [rest[i + 1]] : []));
-    const opt = (n) => all(n)[0];
-    if (sub !== "new" || !id || id.startsWith("--")) {
-        console.error('Usage: nikos bet new <bet-id> --hypothesis "<…>" --kr "<key result>" --uplift "<expected uplift>" --time-box YYYY-MM-DD --story <id> [--story <id>] [--blocker "<…>"]');
-        return 1;
-    }
-    try {
-        const path = newBet({
-            id,
-            hypothesis: opt("hypothesis") ?? "",
-            keyResult: opt("kr") ?? "",
-            expectedUplift: opt("uplift") ?? "",
-            timeBox: opt("time-box") ?? "",
-            stories: all("story"),
-            blockers: all("blocker"),
-        }, opt("dir") ?? process.cwd());
-        console.log(`Created ${path}`);
-        return 0;
-    }
-    catch (err) {
-        console.error(`✗ ${err.message}`);
-        return 1;
-    }
-}

package/docs/intentdocs-mapping.md

@@ -1,117 +0,0 @@
-# Mapping intent/ to intentdocs
-
-`intentdocs push` and `intentdocs pull` translate between the local
-`intent/` folder and an intentdocs project. This table is the contract: every
-local field maps to an intentdocs field, or is marked **local-only**.
-Fields that exist only in intentdocs are listed at the end.
-
-## Project and vision
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| `constitution.md` front matter `name` | project name | |
-| `constitution.md` front matter `idea` | project idea | |
-| `## Users` | vision `users` | |
-| `## Problem` | vision `problem` | |
-| `## Switch` | vision `switch` | |
-| `## First` | vision `first` | |
-| `## Proof` | vision `proof` | |
-| extra `##` sections (e.g. `## Validation`) | **local-only** | pushed as a project note in a later format version |
-| `storymap.yaml` `key` | project story key prefix | e.g. `HT` → `HT-1` |
-| `storymap.yaml` `project` | **local-only** | slug used for paths |
-| `storymap.yaml` `format_version` | **local-only** | |
-
-## Activities and releases
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| `activities[].title` | story `activity` | intentdocs groups by activity name |
-| `activities[].id` | **local-only** | folder slug under `features/` |
-| `releases[].number` | release order | |
-| `releases[].title` | release label | |
-| `releases[].stories` order | build sequence within the release | |
-
-## Stories (feature files)
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| story id tag, e.g. `@HT-1` | story `key` | |
-| `Feature:` title | story `title` | |
-| description `As a …` | `as_a` | |
-| description `I want …` | `i_want` | |
-| description `So that …` | `so_that` | |
-| `@must` / `@should` / `@could` on the Feature | story `priority` | |
-| `@release-N` | story `release` | must agree with `storymap.yaml` |
-| `@activity-<id>` | story `activity` | resolved to the activity title |
-| `@effort-XS` … `@effort-XL` (optional) | story `effort` | |
-| file path | **local-only** | |
-
-## Acceptance criteria (scenarios)
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| `@AC<n>` tag and scenario title prefix | criterion `label` | |
-| scenario title after the label + its steps | criterion `text` | pushed as one Given/When/Then sentence |
-| `@must` / `@should` / `@could` on the Scenario | criterion `priority` | |
-| scenario pass/fail from `nikos verify` | criterion `last_result` | sent via report_criteria |
-| step definition file and test name | linked tests | sent via save_tests |
-
-## Plans
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| file `plans/<id>.v<N>.md` | plan `version` N | |
-| front matter `summary` | plan `summary` | |
-| `## <n>. <title>` | step `title` | |
-| `**Why:**` | step `why` | |
-| `**Criteria:**` | step `criteria` | labels resolved to criterion ids |
-| `**Files:**` | step `files` | |
-| `**Tests:**` (optional) | step `tests` | |
-| `**Needs you:**` (optional) | step `needs_you.question` | |
-| body text | step `agent_notes` | |
-| front matter `risk` (optional) | plan `risk` | |
-| front matter `introduces` (optional) | plan `introduces` | new dependencies |
-| front matter `supersedes`, `created` | **local-only** | intentdocs keeps its own history |
-
-## Decisions
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| entry heading title | decision `title` | |
-| entry body | decision `description` | |
-| `**Category:**` | decision `category` | |
-| entry date | decision created date | |
-| story id in heading | decision linked story | |
-| `**Supersedes:**` | **local-only** | intentdocs amends instead |
-
-## State
-
-Status isn't pushed: intentdocs sets it. New stories start as To do,
-existing ones keep theirs, and they move through build and acceptance in
-intentdocs. `intentdocs push` still sends the local status, and says how
-many it ignored.
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| `status: todo` | **not pushed** | intentdocs sets status |
-| `status: in_progress` | **not pushed** | intentdocs sets status |
-| `status: needs_rework` | **not pushed** | intentdocs sets status |
-| `status: done` | **not pushed** | intentdocs sets status; its own done needs acceptance after build |
-| `blockers` | raised blockers | |
-| `plan_version` | current plan version | |
-| `claimed_by` | story claim | |
-| `run.queue` | build run story order | |
-| `updated` | **local-only** | |
-
-## Bets
-
-| Local | intentdocs | Notes |
-|---|---|---|
-| `outreach/*.md`, `## Validation` | **local-only** | intentdocs keeps the vision answers, not outreach drafts or results |
-| `bets/*.md` | **local-only** | intentdocs has no bet object yet |
-
-## intentdocs-only (not pulled into files)
-
-Comments, design references, plan approvals, story approval after build,
-founder to-dos, releases readiness checks, collaborators and workspace
-settings stay in intentdocs. `intentdocs pull` never writes them to the repo.

package/schemas/bet.schema.json

@@ -1,23 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://nikos.tools/schemas/bet.schema.json",
-  "title": "nikOS bet card front matter",
-  "type": "object",
-  "required": ["id", "hypothesis", "key_result", "expected_uplift", "time_box", "blockers", "stories", "status"],
-  "additionalProperties": false,
-  "properties": {
-    "id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
-    "hypothesis": { "type": "string", "minLength": 1 },
-    "key_result": { "type": "string", "minLength": 1 },
-    "expected_uplift": { "type": "string", "minLength": 1 },
-    "time_box": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
-    "blockers": { "type": "array", "items": { "type": "string", "minLength": 1 } },
-    "stories": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9]{0,9}-[0-9]+$" }
-    },
-    "status": { "enum": ["open", "won", "lost", "killed"] }
-  }
-}

package/skills/nikos-mode/playbooks/bet.md

@@ -1,14 +0,0 @@
-# bet
-
-Frame work as a time-boxed bet you can judge: what you believe, how you'll
-measure it, how much you expect it to move, by when, and which stories
-deliver it. The person decides the bet and calls the outcome.
-
-1. Ask what the person wants to move and why they think this work will move it, and read Proof, Founding hypothesis and Validation in `intent/constitution.md` and the related entries in `intent/decisions.md`.
-2. Frame the bet with the person and confirm it: a hypothesis ("We believe <change> will <effect> for <users> because <evidence>"), a key result (one measure with a number), the expected uplift (from what to what), a time box end date, and any known blockers.
-3. Pick the stories that deliver it from `intent/storymap.yaml`; if one is missing, propose it and add it only once the person agrees, following the story conventions in the idea-to-blueprint playbook.
-4. Run `nikos bet new <bet-id> --hypothesis "<…>" --kr "<…>" --uplift "<…>" --time-box <yyyy-mm-dd> --story <id>` (one `--story` per story, one `--blocker` per blocker).
-5. Fill in the card's `## Why we think so` with the evidence from step 1, quoting where it came from.
-6. Run `nikos validate` and fix every error.
-7. When the time box ends, or the person asks to close the bet: measure the key result, write it under `## Outcome`, propose won, lost or killed, set `status` once the person agrees, and record it with `nikos decide "<title>" --why "<why>" --category product`.
-8. Report every step with its evidence or its skip reason.