@spekn/cli 1.0.0 → 1.0.2

package/dist/tui/prompts/spec-creation-system.prompt.md

@@ -0,0 +1,47 @@
+You are a specification creation assistant for Spekn (Spec-Driven Development).
+
+## Communication Style
+
+You are running inside a terminal UI (TUI). You do NOT have WebMCP or browser tools.
+Communicate with the user through:
+- **Interactive prompts** (the bridge will send interaction_request events for selections and questions)
+- **Plain text responses** that stream to the terminal
+
+Keep responses concise — the terminal has limited width.
+
+## Available Context
+
+Read these MCP resources for spec state:
+- `spec://content` — Current specification content
+- `spec://frontmatter` — Parsed YAML frontmatter
+- `spec://health` — Quick health check (has frontmatter, anchors, hints, relationships)
+- `spec://quality` — Quality score, grade, and issues
+- `spec://anchors` — Anchor paths in the spec
+
+Call these MCP prompts for detailed guidance:
+- `spec-creation-workflow` — Step-by-step creation workflow
+- `spec-rules` — Frontmatter schema, body structure, quality scoring rules
+- `available-actions` — Available tools and when to use them
+
+## High-Level Workflow
+
+1. Analyze the user's request (1-2 sentences)
+2. Confirm spec type (capability, architectural, workflow, operational, decision, intent)
+3. Confirm spec depth (memo, standard, full)
+4. Gather requirements — batch related questions (2-4 per interaction). Allow multiple selections where appropriate.
+5. Generate the specification with proper YAML frontmatter and markdown body. For **capability** specs, include a `capability` block with `module`, `feature`, and an `anchors` record matching body anchor headings (each with at least `status: "draft"`).
+6. Present the full specification content as your final response
+
+Execute ALL workflow steps in a SINGLE turn when possible. After each interaction response, immediately proceed to the next step. The user should not need to type "continue".
+
+The final specification MUST include:
+- YAML frontmatter with title, type, status: draft, generation: 1, and relevant hints/relationships
+- Structured markdown body with proper heading hierarchy and anchor paths (### #anchor.path)
+- Acceptance criteria, constraints, and technical context sections as appropriate
+
+Spec type hint: {{SPEC_TYPE}}
+Spec depth hint: {{SPEC_DEPTH}}
+
+## User Request
+
+{{USER_MESSAGE}}

package/dist/tui/prompts/spec-refinement-system.prompt.md

@@ -0,0 +1,72 @@
+You are a specification refinement assistant for Spekn (Spec-Driven Development).
+Your goal is to help the user reach a quality score of 70+ (grade B or higher).
+
+## Communication Style
+
+You are running inside a terminal UI (TUI). You do NOT have WebMCP or browser tools.
+Communicate with the user through:
+- **Interactive prompts** (the bridge will send interaction_request events for selections and questions)
+- **Plain text responses** that stream to the terminal
+
+Keep responses concise — the terminal has limited width.
+
+## Available Context
+
+Read these MCP resources for spec state:
+- `spec://content` — Current specification content (always read before proposing changes)
+- `spec://frontmatter` — Parsed YAML frontmatter
+- `spec://health` — Quick health check
+- `spec://quality` — Quality score, grade, breakdown, and issues
+- `spec://anchors` — Anchor paths in the spec
+
+Call these MCP prompts for detailed guidance:
+- `spec-refinement-workflow` — Step-by-step refinement workflow
+- `spec-rules` — Frontmatter schema, body structure, quality scoring rules
+- `available-actions` (flow=refinement) — Available tools and when to use them
+
+## Frontmatter Enrichment
+
+If the spec's frontmatter is missing `hints` (constraints, requirements, technical, guidance) or `aiContext` (priorityAnchors), propose changes to populate them. Extract:
+- `hints.constraints` from constraint sections and protected sections
+- `hints.requirements` from acceptance criteria
+- `hints.technical` from technical context sections
+- `aiContext.priorityAnchors` from the most critical anchor paths (max 5)
+
+## Capability Block Enrichment
+
+For **capability** specs, check whether the `capability` frontmatter block is present and complete:
+
+1. **Missing `capability` block**: If the spec type is `capability` but has no `capability` block, propose one with:
+   - `module`: inferred from the first segment of anchor paths (e.g., `auth` from `auth.login.validation`)
+   - `feature`: inferred from the second segment (e.g., `login`)
+   - `anchors`: record mapping each body anchor path to `{ status: "draft" }`
+
+2. **Populate rich metadata**: For each anchor in `capability.anchors`, propose adding:
+   - `hint`: one-sentence summary of the anchor's purpose
+   - `complexity`: trivial | low | medium | high | critical
+   - `status`: draft | ready | implemented | tested
+
+3. **Anchor drift**: Detect mismatches between body anchor headings, `frontmatter.anchors`, and `capability.anchors` keys. Propose fixes to bring all three in sync.
+
+## Critical Rules
+
+- Start by analyzing the current spec quality and presenting key issues
+- Lead with critical issues (most score impact)
+- Provide EXACT before/after diffs when proposing changes
+- Do NOT re-propose fixes the user has skipped
+- Present the updated specification as your final response when refinement is complete
+
+## Current Specification
+
+Title: {{SPEC_TITLE}}
+{{QUALITY_SCORE_LINE}}
+
+### Issues Found:
+{{ISSUES_SUMMARY}}
+
+### Spec Content:
+```markdown
+{{SPEC_CONTENT}}
+```
+
+Begin by analyzing the specification and presenting the key quality issues to address.

package/dist/tui/use-session-store-63YUGUFA.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-OXXZ3O5L.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-ACO2SMJC.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-GTFTFDY4.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-BVFDAWOB.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-X2XP5ACW.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-DJIZ3FQZ.mjs

@@ -0,0 +1,9 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-V4SNDRUS.mjs";
+import "./chunk-JKFOY4IF.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-EAIQA4UG.mjs

@@ -0,0 +1,9 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-VXVHNZST.mjs";
+import "./chunk-BZKKMGFB.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-EFBAXC3G.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-ZM3EI5IA.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-FJOR4KTG.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-BUJQVTY5.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-IJE5KVOC.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-DJYOBCNM.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-KGAFXCKI.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-4WEASLXY.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-KS4DPNDY.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-755CADEG.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-MMHJENNL.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-IMEBD2KA.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-OZ6HC4I2.mjs

@@ -0,0 +1,9 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-ZYOX64HP.mjs";
+import "./chunk-BZKKMGFB.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-PTMWISNJ.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-WCTSFKTA.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-VCDECQMW.mjs

@@ -0,0 +1,8 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-IX6DR5SW.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/dist/tui/use-session-store-VOK5ML5J.mjs

@@ -0,0 +1,9 @@
+import {
+  buildOnboardingState,
+  useSessionStore
+} from "./chunk-SHJNIAAJ.mjs";
+import "./chunk-YUYJ7VBG.mjs";
+export {
+  buildOnboardingState,
+  useSessionStore
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spekn/cli",
-  "version": "1.0.0",
-  "description": "Spekn CLI — Spec-Driven Development toolchain",
+  "version": "1.0.2",
+  "description": "Spekn CLI — Spec-Driven Development toolchain. Installs the `spekn` command.",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,8 +9,17 @@
     "spekn": "dist/main.js"
   },
   "files": [
-    "dist"
+    "dist/main.js",
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/tui/",
+    "dist/resources/prompts/",
+    "dist/prompts/",
+    "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "node": ">=22",
     "npm": ">=10"
@@ -20,40 +29,51 @@
     "url": "https://github.com/spekn/spekn.git",
     "directory": "packages/cli"
   },
+  "homepage": "https://spekn.dev",
+  "bugs": {
+    "url": "https://github.com/spekn/spekn/issues"
+  },
   "keywords": [
     "spekn",
     "sdd",
     "spec-driven-development",
     "cli",
     "specifications",
-    "ai-agents"
+    "ai-agents",
+    "governance",
+    "context-engineering"
   ],
   "scripts": {
-    "build": "npm -w @spekn/tui run build && tsc --build && tsup && mkdir -p dist/tui && cp ../tui/dist/index.mjs dist/tui/index.mjs && mkdir -p dist/resources/prompts && cp -R src/resources/prompts/. dist/resources/prompts/",
+    "build": "npm -w @spekn/check run build && npm -w @spekn/bridge run build && npm -w @spekn/tui run build && tsc --build && tsup && mkdir -p dist/tui && cp ../tui/dist/index.mjs ../tui/dist/chunk-*.mjs ../tui/dist/use-session-store-*.mjs dist/tui/ && mkdir -p dist/tui/prompts && cp ../tui/dist/prompts/*.prompt.md dist/tui/prompts/ && mkdir -p dist/resources/prompts && cp -R src/resources/prompts/. dist/resources/prompts/ && mkdir -p dist/prompts && cp -R ../check/dist/prompts/. dist/prompts/",
     "dev": "tsc --build --watch",
     "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
     "project-delete": "ts-node src/commands/project-clean.ts"
   },
   "dependencies": {
-    "@inkjs/ui": "^2.0.0",
-    "@trpc/client": "^10.45.4",
+    "@openpanel/sdk": "^1.0.0",
+    "@spekn/analytics": "*",
     "commander": "^14.0.3",
-    "ink": "^6.8.0",
     "js-yaml": "^4.1.0",
     "open": "^10.2.0",
-    "pg": "^8.18.0",
-    "react": "^19.2.0",
-    "typeorm": "^0.3.28",
-    "zustand": "^5.0.8",
     "zod": "^4.3.6"
   },
+  "optionalDependencies": {
+    "pg": "^8.18.0",
+    "typeorm": "^0.3.28"
+  },
   "devDependencies": {
+    "@inkjs/ui": "^2.0.0",
     "@spekn/agents": "*",
     "@spekn/bridge": "*",
     "@spekn/check": "*",
     "@spekn/shared": "*",
     "@spekn/tui": "*",
+    "@trpc/client": "^10.45.4",
+    "ink": "^6.8.0",
+    "react": "^19.2.0",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "zustand": "^5.0.8"
   }
 }

package/dist/__tests__/export-cli.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/export-cli.test.js

@@ -1,70 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const strict_1 = __importDefault(require("node:assert/strict"));
-const export_1 = require("../export");
-function createDeps() {
-    const state = {
-        stdout: '',
-        stderr: '',
-        writes: [],
-    };
-    const deps = {
-        createClient: () => ({
-            export: {
-                generate: {
-                    mutate: async () => ({
-                        content: 'GENERATED CONTENT\n',
-                        anchorCount: 2,
-                    }),
-                },
-            },
-        }),
-        writeFile: (filePath, content) => {
-            state.writes.push({ path: filePath, content });
-        },
-        stdout: (content) => {
-            state.stdout += content;
-        },
-        stderr: (content) => {
-            state.stderr += content;
-        },
-    };
-    return { state, deps };
-}
-async function testStdoutMode() {
-    const { state, deps } = createDeps();
-    const code = await (0, export_1.runExportCli)(['--project', '11111111-1111-4111-8111-111111111111', '--format', 'claude-md'], deps);
-    strict_1.default.equal(code, 0);
-    strict_1.default.equal(state.stdout, 'GENERATED CONTENT\n');
-    strict_1.default.equal(state.writes.length, 0);
-}
-async function testOutputMode() {
-    const { state, deps } = createDeps();
-    const code = await (0, export_1.runExportCli)([
-        '--project',
-        '11111111-1111-4111-8111-111111111111',
-        '--format',
-        'cursorrules',
-        '--output',
-        'tmp-export.txt',
-    ], deps);
-    strict_1.default.equal(code, 0);
-    strict_1.default.equal(state.writes.length, 1);
-    strict_1.default.ok(state.stdout.includes('Exported 2 anchors'));
-}
-async function testMissingRequiredArgs() {
-    const { state, deps } = createDeps();
-    const code = await (0, export_1.runExportCli)(['--format', 'claude-md'], deps);
-    strict_1.default.equal(code, 1);
-    strict_1.default.ok(state.stderr.includes('Missing required argument'));
-}
-async function main() {
-    await testStdoutMode();
-    await testOutputMode();
-    await testMissingRequiredArgs();
-    process.stdout.write('export-cli.test.ts passed\n');
-}
-void main();

package/dist/__tests__/tui-args-policy.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/tui-args-policy.test.js

@@ -1,50 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const strict_1 = __importDefault(require("node:assert/strict"));
-const shared_1 = require("@spekn/shared");
-const args_1 = require("../tui/args");
-const policy_1 = require("../tui/capabilities/policy");
-function testParseArgs() {
-    const parsed = (0, args_1.parseTuiArgs)([
-        '--project-id',
-        '11111111-1111-4111-8111-111111111111',
-        '--api-url',
-        'http://localhost:9999',
-        '--view',
-        'export',
-        '--no-color',
-    ]);
-    strict_1.default.equal(parsed.projectId, '11111111-1111-4111-8111-111111111111');
-    strict_1.default.equal(parsed.apiUrl, 'http://localhost:9999');
-    strict_1.default.equal(parsed.initialView, 'export');
-    strict_1.default.equal(parsed.noColor, true);
-}
-function testTierLocks() {
-    const freePolicy = (0, policy_1.resolveNavPolicy)({
-        plan: shared_1.OrganizationPlan.FREE,
-        role: 'member',
-        workflowPhase: null,
-        permissions: [],
-    });
-    const bridge = freePolicy.find((item) => item.id === 'bridge');
-    const teamFeature = freePolicy.find((item) => item.id === 'active-runs');
-    strict_1.default.equal(bridge?.state, 'locked');
-    strict_1.default.equal(teamFeature?.state, 'locked');
-    const teamPolicy = (0, policy_1.resolveNavPolicy)({
-        plan: shared_1.OrganizationPlan.TEAM,
-        role: 'viewer',
-        workflowPhase: 'plan',
-        permissions: [],
-    });
-    const gates = teamPolicy.find((item) => item.id === 'phase-gates');
-    strict_1.default.equal(gates?.state, 'disabled');
-}
-function main() {
-    testParseArgs();
-    testTierLocks();
-    process.stdout.write('tui-args-policy.test.ts passed\n');
-}
-main();

package/dist/acp-S2MHZOAD.mjs

@@ -1,23 +0,0 @@
-// Bundled TUI entry (ESM) — loaded via dynamic import() from CJS main.js
-import {
-  AGENT_METHODS,
-  AgentSideConnection,
-  CLIENT_METHODS,
-  ClientSideConnection,
-  PROTOCOL_VERSION,
-  RequestError,
-  TerminalHandle,
-  init_acp,
-  ndJsonStream
-} from "./chunk-M4CS3A25.mjs";
-init_acp();
-export {
-  AGENT_METHODS,
-  AgentSideConnection,
-  CLIENT_METHODS,
-  ClientSideConnection,
-  PROTOCOL_VERSION,
-  RequestError,
-  TerminalHandle,
-  ndJsonStream
-};

package/dist/acp-UCCI44JY.mjs

@@ -1,25 +0,0 @@
-// Bundled TUI entry (ESM) — loaded via dynamic import() from CJS main.js
-import { createRequire as __createRequire } from 'module';
-const require = __createRequire(import.meta.url);
-import {
-  AGENT_METHODS,
-  AgentSideConnection,
-  CLIENT_METHODS,
-  ClientSideConnection,
-  PROTOCOL_VERSION,
-  RequestError,
-  TerminalHandle,
-  init_acp,
-  ndJsonStream
-} from "./chunk-3PAYRI4G.mjs";
-init_acp();
-export {
-  AGENT_METHODS,
-  AgentSideConnection,
-  CLIENT_METHODS,
-  ClientSideConnection,
-  PROTOCOL_VERSION,
-  RequestError,
-  TerminalHandle,
-  ndJsonStream
-};

package/dist/auth/credentials-store.d.ts

@@ -1,2 +0,0 @@
-export { CredentialsStore } from "@spekn/shared";
-export type { CliCredentials } from "@spekn/shared";

package/dist/auth/credentials-store.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CredentialsStore = void 0;
-var shared_1 = require("@spekn/shared");
-Object.defineProperty(exports, "CredentialsStore", { enumerable: true, get: function () { return shared_1.CredentialsStore; } });

package/dist/auth/device-flow.d.ts

@@ -1,36 +0,0 @@
-/**
- * RFC 8628 Device Authorization Grant (Device Flow)
- *
- * Implements the OAuth 2.0 Device Authorization Grant for CLI authentication
- * against a Keycloak realm.
- *
- * @see https://www.rfc-editor.org/rfc/rfc8628
- */
-export interface DeviceFlowResult {
-    accessToken: string;
-    refreshToken: string;
-    expiresIn: number;
-    idToken?: string;
-}
-export interface DeviceFlowDeps {
-    stdout: {
-        write(s: string): void;
-    };
-    stderr: {
-        write(s: string): void;
-    };
-    openBrowser: (url: string) => Promise<void>;
-}
-/** Default browser opener — dynamically imports the `open` package. */
-declare const defaultOpenBrowser: (url: string) => Promise<void>;
-/**
- * Perform the RFC 8628 Device Authorization Grant against a Keycloak realm.
- *
- * @param keycloakUrl - Base Keycloak URL, e.g. `https://auth.example.com`
- * @param realm       - Keycloak realm name
- * @param clientId    - OAuth2 client ID (must be a public client)
- * @param deps        - Optional dependency overrides for testing / custom I/O
- * @returns Resolved tokens once the user authorises the device
- */
-export declare function performDeviceFlow(keycloakUrl: string, realm: string, clientId: string, deps?: Partial<DeviceFlowDeps>): Promise<DeviceFlowResult>;
-export { defaultOpenBrowser };