studioflow 0.1.5 → 0.2.1

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "studioflow",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "private": false,
-  "description": "Deterministic AI-assisted product demo automation CLI for Screen Studio workflows",
+  "description": "Deterministic AI-assisted product demo automation CLI for QuickTime and Screen Studio workflows",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -15,8 +15,8 @@
   },
   "files": [
     "dist",
-    "skills",
-    "flows",
+    "assets",
+    "bundled",
     "scripts/sync-skills.mjs",
     "scripts/build.mjs",
     "tsconfig.json",
@@ -25,35 +25,37 @@
   "bin": {
     "studioflow": "dist/index.js"
   },
+  "dependencies": {
+    "playwright": "^1.55.0",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.11",
+    "kleur": "^4.1.5",
+    "tsx": "^4.20.5",
+    "@studioflow/adapters-desktop": "0.1.0",
+    "@studioflow/adapters-playwright": "0.1.0",
+    "@studioflow/adapters-screenstudio": "0.1.0",
+    "@studioflow/flow-registry": "0.1.0",
+    "@studioflow/orchestrator": "0.1.0",
+    "@studioflow/contracts": "0.1.0",
+    "@studioflow/artifacts": "0.1.0"
+  },
   "scripts": {
     "prepare:assets": "node scripts/sync-skills.mjs",
     "build": "node scripts/build.mjs",
-    "prepack": "node scripts/sync-skills.mjs && node scripts/build.mjs",
+    "verify:bundled": "node scripts/verify-bundled-assets.mjs",
+    "verify:release-tag": "node scripts/verify-release-tag.mjs",
     "demo": "tsx src/index.ts run",
     "config": "tsx src/index.ts config",
     "setup": "tsx src/index.ts setup",
     "install-skills": "tsx src/index.ts install-skills",
     "discover": "tsx src/index.ts discover",
     "bootstrap": "tsx src/index.ts bootstrap",
+    "quicktime-prep": "tsx src/index.ts quicktime-prep",
     "screenstudio-prep": "tsx src/index.ts screenstudio-prep",
     "validate": "tsx src/index.ts validate",
     "doctor": "tsx src/index.ts doctor",
     "list-flows": "tsx src/index.ts list-flows"
-  },
-  "dependencies": {
-    "playwright": "^1.55.0",
-    "yaml": "^2.8.1"
-  },
-  "devDependencies": {
-    "@studioflow/adapters-desktop": "workspace:*",
-    "@studioflow/adapters-playwright": "workspace:*",
-    "@studioflow/adapters-screenstudio": "workspace:*",
-    "@studioflow/artifacts": "workspace:*",
-    "@studioflow/contracts": "workspace:*",
-    "@studioflow/flow-registry": "workspace:*",
-    "@studioflow/orchestrator": "workspace:*",
-    "esbuild": "^0.25.11",
-    "kleur": "^4.1.5",
-    "tsx": "^4.20.5"
   }
-}
+}

package/scripts/sync-skills.mjs

@@ -6,11 +6,13 @@ import { fileURLToPath } from "node:url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(__dirname, "..");
+// Source-of-truth lives in the workspace; packaged runtime reads from bundled/.
 const sourceSkillsRoot = path.resolve(packageRoot, "../../skills");
-const targetSkillsRoot = path.join(packageRoot, "skills");
+const bundledRoot = path.join(packageRoot, "bundled");
+const targetSkillsRoot = path.join(bundledRoot, "skills");
 const sourceFlowsRoot = path.resolve(packageRoot, "../../packages/flow-registry/flows");
-const targetFlowsRoot = path.join(packageRoot, "flows");
-const skillNames = ["studioflow-cli", "studioflow-investigate"];
+const targetFlowsRoot = path.join(bundledRoot, "flows");
+const skillNames = ["studioflow-cli", "studioflow-investigate", "studioflow-author"];
 const flowNames = ["billing.yaml", "onboarding.yaml", "onboarding_billing.yaml"];
 
 async function listFilesRecursively(rootDir) {
@@ -85,6 +87,8 @@ async function main() {
   await Promise.all(skillNames.map(ensureSkillExists));
   await Promise.all(flowNames.map(ensureFlowExists));
 
+  await fs.mkdir(bundledRoot, { recursive: true });
+
   await fs.rm(targetSkillsRoot, { recursive: true, force: true });
   await fs.mkdir(targetSkillsRoot, { recursive: true });
 
@@ -104,7 +108,7 @@ async function main() {
     await fs.cp(source, target);
   }
 
-  console.log(`Bundled assets synced: skills -> ${targetSkillsRoot}, flows -> ${targetFlowsRoot}`);
+  console.log(`Bundled assets synced: ${bundledRoot}`);
 }
 
 main().catch((error) => {

package/skills/manifest.json

@@ -1,14 +0,0 @@
-{
-  "schemaVersion": 1,
-  "packageName": "studioflow",
-  "packageVersion": "0.1.5",
-  "generatedAt": "2026-02-14T00:24:03.533Z",
-  "skills": {
-    "studioflow-cli": {
-      "hash": "50cb91859a39b682eda7e8defe273eacb6146c49579f7f97328617b842f759c3"
-    },
-    "studioflow-investigate": {
-      "hash": "69850be6246b5bd99633aa0db48eb55f63948e9fc8b47e9f37037455ab9edfcf"
-    }
-  }
-}

package/skills/studioflow-investigate/SKILL.md

@@ -1,98 +0,0 @@
----
-name: studioflow-investigate
-description: Investigate an arbitrary web project and generate deterministic StudioFlow artifacts. Use when the user asks to discover app structure, map routes/components/actions, synthesize artifacts/flow.json from natural-language intent, or clarify open/ambiguous intent before authoring a flow.
----
-
-# StudioFlow Investigate
-
-Generate deterministic demo-planning artifacts for any web app.
-
-## Workflow
-
-1. Inspect project root and identify framework, package manager, and startup command.
-2. Always collect project context artifacts before intent mapping.
-
-Do this automatically in the skill workflow. Do not ask the user to run these commands manually.
-
-```bash
-pnpm bootstrap -- --out artifacts/bootstrap.json
-pnpm discover -- --out artifacts
-```
-
-Fallback if `pnpm` workspace scripts are unavailable:
-
-```bash
-studioflow bootstrap --out artifacts/bootstrap.json
-studioflow discover --out artifacts
-```
-
-3. Review generated artifacts:
-- `artifacts/bootstrap.json`
-- `artifacts/structure-report.json`
-- `artifacts/navigation-graph.json`
-
-4. Resolve intent specificity before authoring `artifacts/flow.json`.
-
-Open-intent detection:
-- Treat intent as open when one or more anchors are missing:
-  - `target_route`: where the flow should navigate
-  - `user_goal`: what user action/outcome to demonstrate
-  - `done_assertion`: what text/element proves completion
-
-Clarification loop:
-- Max 2 rounds.
-- Ask 1-3 questions per round (adaptive; only missing high-impact fields).
-- Question priority: `done_assertion` -> `target_route` -> `user_goal` -> optional inputs/scope.
-- Capture optional run-feel preferences when provided (for example: `fast`, `balanced`, `cinematic`, or explicit timing overrides).
-- If host supports structured question-card requests, emit payloads from `references/question-card-spec.md`.
-- If structured cards are not supported, ask equivalent plain-language questions.
-- Track known/missing fields using `references/clarification-state.md`.
-
-5. Author `artifacts/flow.json` from intent + discovered structure + clarified answers.
-
-Rules for authored flow:
-- Deterministic steps only.
-- Prefer stable selectors (`data-testid`).
-- Include clear step IDs and assertions at key transitions.
-- Include optional pacing fields when useful for recording quality.
-- Add `recorder_export` only when the user explicitly asks for export at run completion.
-- If clarification remains incomplete after 2 rounds, generate best-effort flow with explicit assumptions.
-
-6. Validate candidate flow:
-
-```bash
-pnpm validate -- --flow artifacts/flow.json
-```
-
-7. If validation fails, edit flow actions/selectors and rerun validation.
-
-8. Emit deterministic runtime handoff for `studioflow-cli`.
-
-Write `artifacts/studioflow-cli-handoff.json` using `references/cli-handoff-spec.md`.
-- Include `runtimePacing` in handoff when run-feel preferences or timing overrides are known.
-
-9. Hand off execution to `studioflow-cli` immediately.
-
-- If your host supports explicit skill invocation, invoke `studioflow-cli` in the same turn using the handoff payload.
-- If explicit skill invocation is unavailable, execute the equivalent CLI run workflow directly in the same turn.
-- Do not stop at "here is the command to run" when the user intent is to run/record a demo.
-
-## Output Requirements
-
-Always produce these files for handoff to runtime execution:
-1. `artifacts/bootstrap.json`
-2. `artifacts/structure-report.json`
-3. `artifacts/navigation-graph.json`
-4. `artifacts/flow.json`
-5. `artifacts/studioflow-cli-handoff.json`
-
-Always include a concise handoff summary in the response:
-- resolved intent anchors
-- unresolved assumptions (if any)
-- confidence (`high|medium|low`)
-
-Use references in:
-- `references/artifact-spec.md`
-- `references/question-card-spec.md`
-- `references/clarification-state.md`
-- `references/cli-handoff-spec.md`