markform 0.1.6 → 0.1.7

package/README.md

@@ -38,20 +38,22 @@ informal Markdown doc describing a process to a precise Markform process easily.
 ## Quick Start
 
 ```bash
-# Try filling in one of a few example forms without installing.
-# First set OPENAI_API_KEY or ANTHROPIC_API_KEY in environment or .env file
-# to try the research examples.
-npx markform examples
+# Copy example forms to ./forms/ and run one interactively
+# Set OPENAI_API_KEY or ANTHROPIC_API_KEY (or put in .env) for research examples
+npx markform examples  # Copy examples to ./forms/, then offers to run one
 
-# Read the docs
+# Or run forms directly
+npx markform run  # Browse and run forms interactively
+
+# Read the docs (tell your agents to run these; they are agent-friendly!)
 npx markform  # CLI help
 npx markform readme   # This file
-npx markform docs  # Quick start for humans or agents to write Markforms
+npx markform docs  # Quick reference for writing Markforms
 npx markform spec  # Read the full spec
 ```
 
-This lets you walk through a form interactively from the CLI, with the option to have an
-agent fill in parts of the form.
+The `markform examples` command copies sample forms locally and prompts you to run one.
+Pick `movie-research-demo.form.md` for a quick example.
 
 ## Installation
 
@@ -76,7 +78,7 @@ It combines YAML frontmatter with Markdoc-tagged content:
 ---
 markform:
   spec: MF/0.1
-  title: Movie Research (Minimal)
+  title: Movie Research (Demo)
   description: Quick movie lookup with just the essentials (title, year, ratings, summary).
   roles:
     - user
@@ -85,9 +87,9 @@ markform:
     user: "Enter the movie title."
     agent: |
       Quickly identify the movie and fill in basic info from IMDB.
-      This is a minimal lookup - just get the core facts.
+      This is a demo lookup - just get the core facts.
 ---
-{% form id="movie_research_minimal" title="Movie Research (Minimal)" %}
+{% form id="movie_research_demo" title="Movie Research (Demo)" %}
 
 ## Movie Research Example
 
@@ -145,11 +147,12 @@ What movie do you want to research? \[*This field is filled in by the user (`rol
 
 ### Form Report Output
 
-Run the `npx markform examples` and select the `Movie Research (Minimal)` example and
-view the report:
+Run `npx markform examples` to copy examples, then `npx markform run` and select `Movie
+Research (Demo)` to fill it.
+The report output looks like:
 
 ```markdown
-# Movie Research (Minimal)
+# Movie Research (Demo)
 
 ## Movie Identification
 
@@ -180,12 +183,13 @@ Convicted banker Andy Dufresne is sent to Shawshank State Penitentiary, where he
 ### More Example Forms
 
 The package includes example forms.
-View them with `markform examples --list` or try these interactively:
+View them with `markform examples --list`, copy with `markform examples`, and run with
+`markform run`:
 
 - [`simple.form.md`](https://github.com/jlevy/markform/blob/main/packages/markform/examples/simple/simple.form.md)
   \- Basic form demonstrating all field kinds.
 
-- [`movie-research-minimal.form.md`](https://github.com/jlevy/markform/blob/main/packages/markform/examples/movie-research/movie-research-minimal.form.md)
+- [`movie-research-demo.form.md`](https://github.com/jlevy/markform/blob/main/packages/markform/examples/movie-research/movie-research-demo.form.md)
   \- The quick example above.
 
 - [`movie-research-basic.form.md`](https://github.com/jlevy/markform/blob/main/packages/markform/examples/movie-research/movie-research-basic.form.md)
@@ -199,17 +203,34 @@ View them with `markform examples --list` or try these interactively:
 
 ## CLI Commands
 
-### Explore Examples
+### Copy and Run Examples
 
 ```bash
-# Interactive: select an example, fill it, optionally run agent
+# Copy all bundled examples to ./forms/
 markform examples
 
 # List available examples
 markform examples --list
 
-# Start with a specific example
-markform examples --name political-research
+# Copy a specific example
+markform examples --name movie-research-demo
+```
+
+### Browse and Run Forms
+
+```bash
+# Browse forms in ./forms/ and run one interactively
+markform run
+
+# Run a specific form directly
+markform run forms/movie-research-demo.form.md
+```
+
+### Check Form Status
+
+```bash
+# Show fill progress with per-role breakdown
+markform status my-form.form.md
 ```
 
 ### Inspect Forms
@@ -445,10 +466,24 @@ But it’s been useful for me already.
 
 ### Was it Vibe Coded?
 
-It’s all written by LLMs but using a strongly spec-driven process, using rules from
-[Speculate](https://github.com/jlevy/speculate).
-See [the spec](docs/markform-spec.md) and the architecture docs and specs in
-[docs/](docs/).
+This is 100% agent-written code and the planning specs are also 100% agent written,
+using a mix of Opus 4.5, GPT 5.2, GPT-5 Pro, Gemini 3, and occasionally others.
+
+But it’s not slop. It is written via a strongly spec-driven process, using rules from my
+[Speculate](https://github.com/jlevy/speculate) repo and Steve Yegge’s
+[beads](https://github.com/steveyegge/beads) for tracking work.
+
+See
+[my post](https://github.com/jlevy/speculate/blob/main/about/lessons_in_spec_coding.md)
+for more thoughts on how this works.
+And see [the complete history of
+specs](https://github.com/jlevy/markform/tree/main/docs/project/specs/done) for examples
+of how everything is done with specs and with
+
+Although I didn’t have to write much there was a *lot* of management and review by me
+and a lot of thought and iteration for all design decisions.
+And this doc is written by me.
+:)
 
 ### What are the goals of Markform?
 

package/dist/ai-sdk.d.mts

@@ -1,6 +1,5 @@
-#!/usr/bin/env node
 
-import { Dt as PatchSchema, Et as Patch, G as FormSchema, Tt as ParsedForm, X as Id, ar as ValidatorRegistry, r as ApplyResult, tt as InspectResult, z as FieldResponse } from "./coreTypes-9XZSNOv6.mjs";
+import { Dt as ParsedForm, Ot as Patch, Q as Id, V as FieldResponse, kt as PatchSchema, lr as ValidatorRegistry, q as FormSchema, r as ApplyResult, rt as InspectResult } from "./coreTypes-DCvD7feM.mjs";
 import { z } from "zod";
 
 //#region src/integrations/toolTypes.d.ts

package/dist/ai-sdk.mjs

@@ -1,5 +1,6 @@
-import { L as PatchSchema } from "./coreTypes-pyctKRgc.mjs";
-import { r as inspect, t as applyPatches, u as serialize } from "./apply-DMQl-VVd.mjs";
+
+import { L as PatchSchema } from "./coreTypes-__Cwxz5q.mjs";
+import { d as serialize, i as inspect, t as applyPatches } from "./apply-g23rRn7p.mjs";
 import { z } from "zod";
 
 //#region src/integrations/vercelAiSdkTools.ts

package/dist/{apply-DMQl-VVd.mjs → apply-g23rRn7p.mjs}

@@ -1,3 +1,4 @@
+
 //#region src/llms.ts
 /**
 * Parse a model ID string into provider and model components for display.
@@ -161,6 +162,11 @@ const DEFAULT_PRIORITY = "medium";
 */
 const DEFAULT_FORMS_DIR = "./forms";
 /**
+* Maximum forms to display in 'markform run' menu.
+* Additional forms are not shown but can be run directly by path.
+*/
+const MAX_FORMS_IN_MENU = 30;
+/**
 * The default port for the serve command.
 */
 const DEFAULT_PORT = 3344;
@@ -203,12 +209,18 @@ const EXPORT_EXTENSIONS = {
 */
 const REPORT_EXTENSION = ".report.md";
 /**
+* Schema extension - generated JSON Schema for form structure.
+* Used for validation, code generation, and LLM tooling.
+*/
+const SCHEMA_EXTENSION = ".schema.json";
+/**
 * All recognized markform file extensions.
-* Combines export formats with report format.
+* Combines export formats with report and schema formats.
 */
 const ALL_EXTENSIONS = {
 	...EXPORT_EXTENSIONS,
-	report: REPORT_EXTENSION
+	report: REPORT_EXTENSION,
+	schema: SCHEMA_EXTENSION
 };
 /**
 * Detect file type from path based on extension.
@@ -219,6 +231,7 @@ function detectFileType(filePath) {
 	if (filePath.endsWith(ALL_EXTENSIONS.raw)) return "raw";
 	if (filePath.endsWith(ALL_EXTENSIONS.report)) return "report";
 	if (filePath.endsWith(ALL_EXTENSIONS.yaml)) return "yaml";
+	if (filePath.endsWith(ALL_EXTENSIONS.schema)) return "schema";
 	if (filePath.endsWith(ALL_EXTENSIONS.json)) return "json";
 	if (filePath.endsWith(".md")) return "raw";
 	return "unknown";
@@ -247,6 +260,18 @@ function deriveReportPath(basePath) {
 	}
 	return base + REPORT_EXTENSION;
 }
+/**
+* Derive schema path from any markform file path.
+* Strips known extensions and appends .schema.json.
+*/
+function deriveSchemaPath(basePath) {
+	let base = basePath;
+	for (const ext of Object.values(ALL_EXTENSIONS)) if (base.endsWith(ext)) {
+		base = base.slice(0, -ext.length);
+		break;
+	}
+	return base + SCHEMA_EXTENSION;
+}
 
 //#endregion
 //#region src/utils/keySort.ts
@@ -2804,4 +2829,4 @@ function applyPatches(form, patches) {
 }
 
 //#endregion
-export { SUGGESTED_LLMS as A, DEFAULT_ROLE_INSTRUCTIONS as C, deriveReportPath as D, deriveExportPath as E, parseModelIdForDisplay as F, formatSuggestedLlms as M, getWebSearchConfig as N, detectFileType as O, hasWebSearchSupport as P, DEFAULT_ROLES as S, USER_ROLE as T, DEFAULT_MAX_TURNS as _, computeAllSummaries as a, DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN as b, computeStructureSummary as c, serializeRawMarkdown as d, serializeReportMarkdown as f, DEFAULT_MAX_PATCHES_PER_TURN as g, DEFAULT_MAX_ISSUES_PER_TURN as h, validate as i, WEB_SEARCH_CONFIG as j, parseRolesFlag as k, isFormComplete as l, DEFAULT_FORMS_DIR as m, getFieldsForRoles as n, computeFormState as o, AGENT_ROLE as p, inspect as r, computeProgressSummary as s, applyPatches as t, serialize as u, DEFAULT_PORT as v, REPORT_EXTENSION as w, DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN as x, DEFAULT_PRIORITY as y };
+export { deriveSchemaPath as A, DEFAULT_ROLES as C, USER_ROLE as D, REPORT_EXTENSION as E, formatSuggestedLlms as F, getWebSearchConfig as I, hasWebSearchSupport as L, parseRolesFlag as M, SUGGESTED_LLMS as N, deriveExportPath as O, WEB_SEARCH_CONFIG as P, parseModelIdForDisplay as R, DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN as S, MAX_FORMS_IN_MENU as T, DEFAULT_MAX_PATCHES_PER_TURN as _, validate as a, DEFAULT_PRIORITY as b, computeProgressSummary as c, serialize as d, serializeRawMarkdown as f, DEFAULT_MAX_ISSUES_PER_TURN as g, DEFAULT_FORMS_DIR as h, inspect as i, detectFileType as j, deriveReportPath as k, computeStructureSummary as l, AGENT_ROLE as m, getAllFields as n, computeAllSummaries as o, serializeReportMarkdown as p, getFieldsForRoles as r, computeFormState as s, applyPatches as t, isFormComplete as u, DEFAULT_MAX_TURNS as v, DEFAULT_ROLE_INSTRUCTIONS as w, DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN as x, DEFAULT_PORT as y };

package/dist/bin.d.mts

@@ -1,3 +1,2 @@
-#!/usr/bin/env node
 
 export { };

package/dist/bin.mjs

@@ -1,10 +1,7 @@
 #!/usr/bin/env node
-import "./coreTypes-pyctKRgc.mjs";
-import "./apply-DMQl-VVd.mjs";
-import "./src-o_5TSoHQ.mjs";
-import "./session-uF0e6m6k.mjs";
-import { t as runCli } from "./cli-CXjkdym_.mjs";
-import "./shared-DRlgu2ZJ.mjs";
+
+
+import { t as runCli } from "./cli-Bqlm-WWw.mjs";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { config } from "dotenv";